it.po 286 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259
  1. # Translation of apt package man pages
  2. # Copyright (C) 2000 Debian Italian l10n team <debian-l10n-italian@lists.debian.org>
  3. # This file is distributed under the same license as the apt package.
  4. #
  5. # Translators:
  6. # Eugenia Franzoni <eugenia@linuxcare.com>, 2000
  7. #
  8. #, fuzzy
  9. msgid ""
  10. msgstr ""
  11. "Project-Id-Version: \n"
  12. "Report-Msgid-Bugs-To: APT Development Team <deity@lists.debian.org>\n"
  13. "POT-Creation-Date: 2012-05-25 13:12+0300\n"
  14. "PO-Revision-Date: 2003-04-26 23:26+0100\n"
  15. "Last-Translator: Traduzione di Eugenia Franzoni <eugenia@linuxcare.com>\n"
  16. "Language-Team: <debian-l10n-italian@lists.debian.org>\n"
  17. "Language: \n"
  18. "MIME-Version: 1.0\n"
  19. "Content-Type: text/plain; charset=UTF-8\n"
  20. "Content-Transfer-Encoding: 8bit\n"
  21. #. type: TH
  22. #: apt.8:17
  23. #, no-wrap
  24. msgid "apt"
  25. msgstr "apt"
  26. #. type: TH
  27. #: apt.8:17
  28. #, no-wrap
  29. msgid "16 June 1998"
  30. msgstr ""
  31. #. type: TH
  32. #: apt.8:17
  33. #, no-wrap
  34. msgid "Debian"
  35. msgstr ""
  36. #. type: SH
  37. #: apt.8:18
  38. #, no-wrap
  39. msgid "NAME"
  40. msgstr ""
  41. #. type: Plain text
  42. #: apt.8:20
  43. msgid "apt - Advanced Package Tool"
  44. msgstr ""
  45. #. type: SH
  46. #: apt.8:20
  47. #, no-wrap
  48. msgid "SYNOPSIS"
  49. msgstr ""
  50. #. type: Plain text
  51. #: apt.8:22
  52. msgid "B<apt>"
  53. msgstr ""
  54. #. type: SH
  55. #: apt.8:22
  56. #, no-wrap
  57. msgid "DESCRIPTION"
  58. msgstr ""
  59. #. type: Plain text
  60. #: apt.8:31
  61. msgid ""
  62. "APT is a management system for software packages. For normal day to day "
  63. "package management there are several frontends available, such as B<aptitude>"
  64. "(8) for the command line or B<synaptic>(8) for the X Window System. Some "
  65. "options are only implemented in B<apt-get>(8) though."
  66. msgstr ""
  67. #. type: SH
  68. #: apt.8:31
  69. #, no-wrap
  70. msgid "SEE ALSO"
  71. msgstr ""
  72. #. type: Plain text
  73. #: apt.8:38
  74. msgid ""
  75. "B<apt-cache>(8), B<apt-get>(8), B<apt.conf>(5), B<sources.list>(5), "
  76. "B<apt_preferences>(5), B<apt-secure>(8)"
  77. msgstr ""
  78. #. type: SH
  79. #: apt.8:38
  80. #, no-wrap
  81. msgid "DIAGNOSTICS"
  82. msgstr ""
  83. #. type: Plain text
  84. #: apt.8:40
  85. msgid "apt returns zero on normal operation, decimal 100 on error."
  86. msgstr ""
  87. #. type: SH
  88. #: apt.8:40
  89. #, no-wrap
  90. msgid "BUGS"
  91. msgstr ""
  92. #. type: Plain text
  93. #: apt.8:42
  94. msgid "This manpage isn't even started."
  95. msgstr ""
  96. #. type: Plain text
  97. #: apt.8:51
  98. msgid ""
  99. "See E<lt>http://bugs.debian.org/aptE<gt>. If you wish to report a bug in "
  100. "B<apt>, please see I</usr/share/doc/debian/bug-reporting.txt> or the "
  101. "B<reportbug>(1) command."
  102. msgstr ""
  103. #. type: SH
  104. #: apt.8:51
  105. #, no-wrap
  106. msgid "AUTHOR"
  107. msgstr ""
  108. #. type: Plain text
  109. #: apt.8:52
  110. msgid "apt was written by the APT team E<lt>apt@packages.debian.orgE<gt>."
  111. msgstr ""
  112. #. type: Plain text
  113. #: apt.ent:7
  114. #, no-wrap
  115. msgid ""
  116. "<!ENTITY apt-author.team \"\n"
  117. " <author>\n"
  118. " <othername>APT team</othername>\n"
  119. " <contrib></contrib>\n"
  120. " </author>\n"
  121. "\">\n"
  122. msgstr ""
  123. #. type: Plain text
  124. #: apt.ent:13
  125. #, no-wrap
  126. msgid ""
  127. "<!ENTITY apt-qapage \"\n"
  128. "\t<para>\n"
  129. "\t\t<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>\n"
  130. "\t</para>\n"
  131. "\">\n"
  132. msgstr ""
  133. #. type: Plain text
  134. #: apt.ent:24
  135. #, no-wrap
  136. msgid ""
  137. "<!-- Boiler plate Bug reporting section -->\n"
  138. "<!ENTITY manbugs \"\n"
  139. " <refsect1><title>Bugs</title>\n"
  140. " <para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>.\n"
  141. " If you wish to report a bug in APT, please see\n"
  142. " <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the\n"
  143. " &reportbug; command.\n"
  144. " </para>\n"
  145. " </refsect1>\n"
  146. "\">\n"
  147. msgstr ""
  148. #. type: Plain text
  149. #: apt.ent:32
  150. #, no-wrap
  151. msgid ""
  152. "<!-- Boiler plate Author section -->\n"
  153. "<!ENTITY manauthor \"\n"
  154. " <refsect1><title>Author</title>\n"
  155. " <para>APT was written by the APT team <email>apt@packages.debian.org</email>.\n"
  156. " </para>\n"
  157. " </refsect1>\n"
  158. "\">\n"
  159. msgstr ""
  160. #. type: Plain text
  161. #: apt.ent:42
  162. #, no-wrap
  163. msgid ""
  164. "<!-- Should be used within the option section of the text to\n"
  165. " put in the blurb about -h, -v, -c and -o -->\n"
  166. "<!ENTITY apt-commonoptions \"\n"
  167. " <varlistentry><term><option>-h</option></term>\n"
  168. " <term><option>--help</option></term>\n"
  169. " <listitem><para>Show a short usage summary.\n"
  170. " </para>\n"
  171. " </listitem>\n"
  172. " </varlistentry>\n"
  173. msgstr ""
  174. #. type: Plain text
  175. #: apt.ent:50
  176. #, no-wrap
  177. msgid ""
  178. " <varlistentry>\n"
  179. " <term><option>-v</option></term>\n"
  180. " <term><option>--version</option></term>\n"
  181. " <listitem><para>Show the program version.\n"
  182. " </para>\n"
  183. " </listitem>\n"
  184. " </varlistentry>\n"
  185. msgstr ""
  186. #. type: Plain text
  187. #: apt.ent:62
  188. #, no-wrap
  189. msgid ""
  190. " <varlistentry>\n"
  191. " <term><option>-c</option></term>\n"
  192. " <term><option>--config-file</option></term>\n"
  193. " <listitem><para>Configuration File; Specify a configuration file to use. \n"
  194. " The program will read the default configuration file and then this \n"
  195. " configuration file. If configuration settings need to be set before the\n"
  196. " default configuration files are parsed specify a file with the <envar>APT_CONFIG</envar>\n"
  197. " environment variable. See &apt-conf; for syntax information.\n"
  198. " </para>\n"
  199. " </listitem>\n"
  200. " </varlistentry>\n"
  201. msgstr ""
  202. #. type: Plain text
  203. #: apt.ent:74
  204. #, no-wrap
  205. msgid ""
  206. " <varlistentry>\n"
  207. " <term><option>-o</option></term>\n"
  208. " <term><option>--option</option></term>\n"
  209. " <listitem><para>Set a Configuration Option; This will set an arbitrary\n"
  210. " configuration option. The syntax is <option>-o Foo::Bar=bar</option>.\n"
  211. " <option>-o</option> and <option>--option</option> can be used multiple\n"
  212. " times to set different options.\n"
  213. " </para>\n"
  214. " </listitem>\n"
  215. " </varlistentry>\n"
  216. "\">\n"
  217. msgstr ""
  218. #. type: Plain text
  219. #: apt.ent:85
  220. #, no-wrap
  221. msgid ""
  222. "<!-- Should be used within the option section of the text to\n"
  223. " put in the blurb about -h, -v, -c and -o -->\n"
  224. "<!ENTITY apt-cmdblurb \"\n"
  225. " <para>All command line options may be set using the configuration file, the\n"
  226. " descriptions indicate the configuration option to set. For boolean\n"
  227. " options you can override the config file by using something like \n"
  228. " <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>\n"
  229. " or several other variations.\n"
  230. " </para>\n"
  231. "\">\n"
  232. msgstr ""
  233. #. type: Plain text
  234. #: apt.ent:91
  235. #, no-wrap
  236. msgid ""
  237. "<!ENTITY file-aptconf \"\n"
  238. " <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>\n"
  239. " <listitem><para>APT configuration file.\n"
  240. " Configuration Item: <literal>Dir::Etc::Main</literal>.</para></listitem>\n"
  241. " </varlistentry>\n"
  242. msgstr ""
  243. #. type: Plain text
  244. #: apt.ent:97
  245. #, no-wrap
  246. msgid ""
  247. " <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>\n"
  248. " <listitem><para>APT configuration file fragments.\n"
  249. " Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem>\n"
  250. " </varlistentry>\n"
  251. "\">\n"
  252. msgstr ""
  253. #. type: Plain text
  254. #: apt.ent:103
  255. #, no-wrap
  256. msgid ""
  257. "<!ENTITY file-cachearchives \"\n"
  258. " <varlistentry><term><filename>&cachedir;/archives/</filename></term>\n"
  259. " <listitem><para>Storage area for retrieved package files.\n"
  260. " Configuration Item: <literal>Dir::Cache::Archives</literal>.</para></listitem>\n"
  261. " </varlistentry>\n"
  262. msgstr ""
  263. #. type: Plain text
  264. #: apt.ent:109
  265. #, no-wrap
  266. msgid ""
  267. " <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>\n"
  268. " <listitem><para>Storage area for package files in transit.\n"
  269. " Configuration Item: <literal>Dir::Cache::Archives</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem>\n"
  270. " </varlistentry>\n"
  271. "\">\n"
  272. msgstr ""
  273. #. type: Plain text
  274. #: apt.ent:119
  275. #, no-wrap
  276. msgid ""
  277. "<!ENTITY file-preferences \"\n"
  278. " <varlistentry><term><filename>/etc/apt/preferences</filename></term>\n"
  279. " <listitem><para>Version preferences file.\n"
  280. " This is where you would specify &quot;pinning&quot;,\n"
  281. " i.e. a preference to get certain packages\n"
  282. " from a separate source\n"
  283. " or from a different version of a distribution.\n"
  284. " Configuration Item: <literal>Dir::Etc::Preferences</literal>.</para></listitem>\n"
  285. " </varlistentry>\n"
  286. msgstr ""
  287. #. type: Plain text
  288. #: apt.ent:125
  289. #, no-wrap
  290. msgid ""
  291. " <varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>\n"
  292. " <listitem><para>File fragments for the version preferences.\n"
  293. " Configuration Item: <literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>\n"
  294. " </varlistentry>\n"
  295. "\">\n"
  296. msgstr ""
  297. #. type: Plain text
  298. #: apt.ent:131
  299. #, no-wrap
  300. msgid ""
  301. "<!ENTITY file-sourceslist \"\n"
  302. " <varlistentry><term><filename>/etc/apt/sources.list</filename></term>\n"
  303. " <listitem><para>Locations to fetch packages from.\n"
  304. " Configuration Item: <literal>Dir::Etc::SourceList</literal>.</para></listitem>\n"
  305. " </varlistentry>\n"
  306. msgstr ""
  307. #. type: Plain text
  308. #: apt.ent:137
  309. #, no-wrap
  310. msgid ""
  311. " <varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>\n"
  312. " <listitem><para>File fragments for locations to fetch packages from.\n"
  313. " Configuration Item: <literal>Dir::Etc::SourceParts</literal>.</para></listitem>\n"
  314. " </varlistentry>\n"
  315. "\">\n"
  316. msgstr ""
  317. #. type: Plain text
  318. #: apt.ent:144
  319. #, no-wrap
  320. msgid ""
  321. "<!ENTITY file-statelists \"\n"
  322. " <varlistentry><term><filename>&statedir;/lists/</filename></term>\n"
  323. " <listitem><para>Storage area for state information for each package resource specified in\n"
  324. " &sources-list;\n"
  325. " Configuration Item: <literal>Dir::State::Lists</literal>.</para></listitem>\n"
  326. " </varlistentry>\n"
  327. msgstr ""
  328. #. type: Plain text
  329. #: apt.ent:150
  330. #, no-wrap
  331. msgid ""
  332. " <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>\n"
  333. " <listitem><para>Storage area for state information in transit.\n"
  334. " Configuration Item: <literal>Dir::State::Lists</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem>\n"
  335. " </varlistentry>\n"
  336. "\">\n"
  337. msgstr ""
  338. #. type: Plain text
  339. #: apt.ent:156
  340. #, no-wrap
  341. msgid ""
  342. "<!ENTITY file-trustedgpg \"\n"
  343. " <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>\n"
  344. " <listitem><para>Keyring of local trusted keys, new keys will be added here.\n"
  345. " Configuration Item: <literal>Dir::Etc::Trusted</literal>.</para></listitem>\n"
  346. " </varlistentry>\n"
  347. msgstr ""
  348. #. type: Plain text
  349. #: apt.ent:163
  350. #, no-wrap
  351. msgid ""
  352. " <varlistentry><term><filename>/etc/apt/trusted.gpg.d/</filename></term>\n"
  353. " <listitem><para>File fragments for the trusted keys, additional keyrings can\n"
  354. " be stored here (by other packages or the administrator).\n"
  355. " Configuration Item <literal>Dir::Etc::TrustedParts</literal>.</para></listitem>\n"
  356. " </varlistentry>\n"
  357. "\">\n"
  358. msgstr ""
  359. #. type: Plain text
  360. #: apt.ent:171
  361. #, no-wrap
  362. msgid ""
  363. "<!ENTITY file-extended_states \"\n"
  364. " <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term>\n"
  365. " <listitem><para>Status list of auto-installed packages.\n"
  366. " Configuration Item: <literal>Dir::State::extended_states</literal>.\n"
  367. " </para></listitem>\n"
  368. " </varlistentry>\n"
  369. "\">\n"
  370. msgstr ""
  371. #. type: Plain text
  372. #: apt.ent:175
  373. #, no-wrap
  374. msgid ""
  375. "<!-- TRANSLATOR: This is the section header for the following paragraphs - comparable\n"
  376. " to the other headers like NAME and DESCRIPTION and should therefore be uppercase. -->\n"
  377. "<!ENTITY translation-title \"TRANSLATION\">\n"
  378. msgstr ""
  379. #. type: Plain text
  380. #: apt.ent:184
  381. #, no-wrap
  382. msgid ""
  383. "<!-- TRANSLATOR: This is a placeholder. You should write here who has contributed\n"
  384. " to the translation in the past, who is responsible now and maybe further information\n"
  385. " specially related to your translation. -->\n"
  386. "<!ENTITY translation-holder \"\n"
  387. " The english translation was done by John Doe <email>john@doe.org</email> in 2009,\n"
  388. " 2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together with the\n"
  389. " Debian Dummy l10n Team <email>debian-l10n-dummy@lists.debian.org</email>.\n"
  390. "\">\n"
  391. msgstr ""
  392. #. type: Plain text
  393. #: apt.ent:195
  394. #, no-wrap
  395. msgid ""
  396. "<!-- TRANSLATOR: As a translation is allowed to have 20% of untranslated/fuzzy strings\n"
  397. " in a shipped manpage newer/modified paragraphs will maybe appear in english in\n"
  398. " the generated manpage. This sentence is therefore here to tell the reader that this\n"
  399. " is not a mistake by the translator - obviously the target is that at least for stable\n"
  400. " releases this sentence is not needed. :) -->\n"
  401. "<!ENTITY translation-english \"\n"
  402. " Note that this translated document may contain untranslated parts.\n"
  403. " This is done on purpose, to avoid losing content when the\n"
  404. " translation is lagging behind the original content.\n"
  405. "\">\n"
  406. msgstr ""
  407. #. type: Plain text
  408. #: apt.ent:198
  409. msgid ""
  410. "<!-- TRANSLATOR: used as in -o=config_string e.g. -o=Debug::"
  411. "pkgProblemResolver=1 --> <!ENTITY synopsis-config-string \"config_string\">"
  412. msgstr ""
  413. #. type: Plain text
  414. #: apt.ent:201
  415. msgid ""
  416. "<!-- TRANSLATOR: used as in -c=config_file e.g. -c=./apt.conf --> <!ENTITY "
  417. "synopsis-config-file \"config_file\">"
  418. msgstr ""
  419. #. type: Plain text
  420. #: apt.ent:204
  421. msgid ""
  422. "<!-- TRANSLATOR: used as in -t=target_release or pkg/target_release e.g. -"
  423. "t=squeeze apt/experimental --> <!ENTITY synopsis-target-release "
  424. "\"target_release\">"
  425. msgstr ""
  426. #. type: Plain text
  427. #: apt.ent:207
  428. msgid ""
  429. "<!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> <!ENTITY "
  430. "synopsis-architecture \"architecture\">"
  431. msgstr ""
  432. #. type: Plain text
  433. #: apt.ent:210
  434. msgid ""
  435. "<!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome "
  436. "--> <!ENTITY synopsis-pkg \"pkg\">"
  437. msgstr ""
  438. #. type: Plain text
  439. #: apt.ent:213
  440. msgid ""
  441. "<!-- TRANSLATOR: used as in pkg=pkg_version_number e.g. apt=0.8.15 --> <!"
  442. "ENTITY synopsis-pkg-ver-number \"pkg_version_number\">"
  443. msgstr ""
  444. #. type: Plain text
  445. #: apt.ent:216
  446. msgid ""
  447. "<!-- TRANSLATOR: used as in apt-cache pkgnames prefix e.g. apt-cache "
  448. "pkgnames apt --> <!ENTITY synopsis-prefix \"prefix\">"
  449. msgstr ""
  450. #. type: Plain text
  451. #: apt.ent:219
  452. msgid ""
  453. "<!-- TRANSLATOR: used as in apt-cache search regex e.g. apt-cache search "
  454. "awesome --> <!ENTITY synopsis-regex \"regex\">"
  455. msgstr ""
  456. #. type: Plain text
  457. #: apt.ent:222
  458. msgid ""
  459. "<!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point e.g. apt-cdrom -"
  460. "d=/media/cdrom --> <!ENTITY synopsis-cdrom-mount \"cdrom_mount_point\">"
  461. msgstr ""
  462. #. type: Plain text
  463. #: apt.ent:225
  464. msgid ""
  465. "<!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory e.g. "
  466. "apt-extracttemplates -t=/tmp --> <!ENTITY synopsis-tmp-directory "
  467. "\"temporary_directory\">"
  468. msgstr ""
  469. #. type: Plain text
  470. #: apt.ent:228
  471. msgid ""
  472. "<!-- TRANSLATOR: used as in apt-extracttemplates filename --> <!ENTITY "
  473. "synopsis-filename \"filename\">"
  474. msgstr ""
  475. #. type: Plain text
  476. #: apt.ent:231
  477. msgid ""
  478. "<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
  479. "packages path override-file pathprefix --> <!ENTITY synopsis-path \"path\">"
  480. msgstr ""
  481. #. type: Plain text
  482. #: apt.ent:234
  483. msgid ""
  484. "<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
  485. "packages path override-file pathprefix --> <!ENTITY synopsis-override "
  486. "\"override-file\">"
  487. msgstr ""
  488. #. type: Plain text
  489. #: apt.ent:237
  490. msgid ""
  491. "<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
  492. "packages path override-file pathprefix --> <!ENTITY synopsis-pathprefix "
  493. "\"pathprefix\">"
  494. msgstr ""
  495. #. type: Plain text
  496. #: apt.ent:240
  497. msgid ""
  498. "<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive "
  499. "generate section --> <!ENTITY synopsis-section \"section\">"
  500. msgstr ""
  501. #. type: Plain text
  502. #: apt.ent:243
  503. msgid ""
  504. "<!-- TRANSLATOR: used as in apt-key export keyid e.g. apt-key export "
  505. "473041FA --> <!ENTITY synopsis-keyid \"keyid\">"
  506. msgstr ""
  507. #. type: Content of: <refentry><refmeta><manvolnum>
  508. #: apt-cache.8.xml:26 apt-cdrom.8.xml:25 apt-config.8.xml:26 apt-get.8.xml:26
  509. #: apt-key.8.xml:25 apt-mark.8.xml:26 apt-secure.8.xml:25
  510. msgid "8"
  511. msgstr ""
  512. #. type: Content of: <refentry><refmeta><refmiscinfo>
  513. #: apt-cache.8.xml:27 apt-cdrom.8.xml:26 apt-config.8.xml:27
  514. #: apt-extracttemplates.1.xml:27 apt-ftparchive.1.xml:27 apt-get.8.xml:27
  515. #: apt-key.8.xml:26 apt-mark.8.xml:27 apt-secure.8.xml:26
  516. #: apt-sortpkgs.1.xml:27 apt.conf.5.xml:32 apt_preferences.5.xml:26
  517. #: sources.list.5.xml:27
  518. msgid "APT"
  519. msgstr ""
  520. #. type: Content of: <refentry><refnamediv><refpurpose>
  521. #: apt-cache.8.xml:33
  522. msgid "query the APT cache"
  523. msgstr ""
  524. #. type: Content of: <refentry><refsect1><title>
  525. #: apt-cache.8.xml:38 apt-cdrom.8.xml:37 apt-config.8.xml:38
  526. #: apt-extracttemplates.1.xml:38 apt-ftparchive.1.xml:38 apt-get.8.xml:38
  527. #: apt-key.8.xml:37 apt-mark.8.xml:38 apt-secure.8.xml:50
  528. #: apt-sortpkgs.1.xml:38 apt.conf.5.xml:41 apt_preferences.5.xml:36
  529. #: sources.list.5.xml:36
  530. msgid "Description"
  531. msgstr ""
  532. #. type: Content of: <refentry><refsect1><para>
  533. #: apt-cache.8.xml:39
  534. msgid ""
  535. "<command>apt-cache</command> performs a variety of operations on APT's "
  536. "package cache. <command>apt-cache</command> does not manipulate the state of "
  537. "the system but does provide operations to search and generate interesting "
  538. "output from the package metadata."
  539. msgstr ""
  540. #. type: Content of: <refentry><refsect1><para>
  541. #: apt-cache.8.xml:44 apt-cdrom.8.xml:51 apt-config.8.xml:44
  542. #: apt-ftparchive.1.xml:54 apt-get.8.xml:44
  543. msgid ""
  544. "Unless the <option>-h</option>, or <option>--help</option> option is given, "
  545. "one of the commands below must be present."
  546. msgstr ""
  547. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  548. #: apt-cache.8.xml:49
  549. msgid ""
  550. "<literal>gencaches</literal> creates APT's package cache. This is done "
  551. "implicitly by all commands needing this cache if it is missing or outdated."
  552. msgstr ""
  553. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable>
  554. #: apt-cache.8.xml:53 apt-cache.8.xml:142 apt-cache.8.xml:163
  555. #: apt-cache.8.xml:185 apt-cache.8.xml:190 apt-cache.8.xml:206
  556. #: apt-cache.8.xml:224 apt-cache.8.xml:236
  557. msgid "&synopsis-pkg;"
  558. msgstr ""
  559. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  560. #: apt-cache.8.xml:54
  561. msgid ""
  562. "<literal>showpkg</literal> displays information about the packages listed on "
  563. "the command line. Remaining arguments are package names. The available "
  564. "versions and reverse dependencies of each package listed are listed, as well "
  565. "as forward dependencies for each version. Forward (normal) dependencies are "
  566. "those packages upon which the package in question depends; reverse "
  567. "dependencies are those packages that depend upon the package in question. "
  568. "Thus, forward dependencies must be satisfied for a package, but reverse "
  569. "dependencies need not be. For instance, <command>apt-cache showpkg "
  570. "libreadline2</command> would produce output similar to the following:"
  571. msgstr ""
  572. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
  573. #: apt-cache.8.xml:66
  574. #, no-wrap
  575. msgid ""
  576. "Package: libreadline2\n"
  577. "Versions: 2.1-12(/var/state/apt/lists/foo_Packages),\n"
  578. "Reverse Depends: \n"
  579. " libreadlineg2,libreadline2\n"
  580. " libreadline2-altdev,libreadline2\n"
  581. "Dependencies:\n"
  582. "2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))\n"
  583. "Provides:\n"
  584. "2.1-12 - \n"
  585. "Reverse Provides: \n"
  586. msgstr ""
  587. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  588. #: apt-cache.8.xml:78
  589. msgid ""
  590. "Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and "
  591. "ncurses3.0 which must be installed for libreadline2 to work. In turn, "
  592. "libreadlineg2 and libreadline2-altdev depend on libreadline2. If "
  593. "libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be "
  594. "installed; libreadlineg2 and libreadline2-altdev do not have to be "
  595. "installed. For the specific meaning of the remainder of the output it is "
  596. "best to consult the apt source code."
  597. msgstr ""
  598. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  599. #: apt-cache.8.xml:87
  600. msgid ""
  601. "<literal>stats</literal> displays some statistics about the cache. No "
  602. "further arguments are expected. Statistics reported are:"
  603. msgstr ""
  604. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  605. #: apt-cache.8.xml:90
  606. msgid ""
  607. "<literal>Total package names</literal> is the number of package names found "
  608. "in the cache."
  609. msgstr ""
  610. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  611. #: apt-cache.8.xml:94
  612. msgid ""
  613. "<literal>Normal packages</literal> is the number of regular, ordinary "
  614. "package names; these are packages that bear a one-to-one correspondence "
  615. "between their names and the names used by other packages for them in "
  616. "dependencies. The majority of packages fall into this category."
  617. msgstr ""
  618. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  619. #: apt-cache.8.xml:100
  620. msgid ""
  621. "<literal>Pure virtual packages</literal> is the number of packages that "
  622. "exist only as a virtual package name; that is, packages only \"provide\" the "
  623. "virtual package name, and no package actually uses the name. For instance, "
  624. "\"mail-transport-agent\" in the Debian system is a pure virtual package; "
  625. "several packages provide \"mail-transport-agent\", but there is no package "
  626. "named \"mail-transport-agent\"."
  627. msgstr ""
  628. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  629. #: apt-cache.8.xml:108
  630. msgid ""
  631. "<literal>Single virtual packages</literal> is the number of packages with "
  632. "only one package providing a particular virtual package. For example, in the "
  633. "Debian system, \"X11-text-viewer\" is a virtual package, but only one "
  634. "package, xless, provides \"X11-text-viewer\"."
  635. msgstr ""
  636. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  637. #: apt-cache.8.xml:114
  638. msgid ""
  639. "<literal>Mixed virtual packages</literal> is the number of packages that "
  640. "either provide a particular virtual package or have the virtual package name "
  641. "as the package name. For instance, in the Debian system, \"debconf\" is both "
  642. "an actual package, and provided by the debconf-tiny package."
  643. msgstr ""
  644. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  645. #: apt-cache.8.xml:121
  646. msgid ""
  647. "<literal>Missing</literal> is the number of package names that were "
  648. "referenced in a dependency but were not provided by any package. Missing "
  649. "packages may be an evidence if a full distribution is not accessed, or if a "
  650. "package (real or virtual) has been dropped from the distribution. Usually "
  651. "they are referenced from Conflicts or Breaks statements."
  652. msgstr ""
  653. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  654. #: apt-cache.8.xml:128
  655. msgid ""
  656. "<literal>Total distinct</literal> versions is the number of package versions "
  657. "found in the cache; this value is therefore at least equal to the number of "
  658. "total package names. If more than one distribution is being accessed (for "
  659. "instance, \"stable\" and \"unstable\"), this value can be considerably "
  660. "larger than the number of total package names."
  661. msgstr ""
  662. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  663. #: apt-cache.8.xml:135
  664. msgid ""
  665. "<literal>Total dependencies</literal> is the number of dependency "
  666. "relationships claimed by all of the packages in the cache."
  667. msgstr ""
  668. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  669. #: apt-cache.8.xml:143
  670. msgid ""
  671. "<literal>showsrc</literal> displays all the source package records that "
  672. "match the given package names. All versions are shown, as well as all "
  673. "records that declare the name to be a binary package."
  674. msgstr ""
  675. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  676. #: apt-cache.8.xml:149
  677. msgid ""
  678. "<literal>dump</literal> shows a short listing of every package in the cache. "
  679. "It is primarily for debugging."
  680. msgstr ""
  681. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  682. #: apt-cache.8.xml:154
  683. msgid ""
  684. "<literal>dumpavail</literal> prints out an available list to stdout. This is "
  685. "suitable for use with &dpkg; and is used by the &dselect; method."
  686. msgstr ""
  687. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  688. #: apt-cache.8.xml:159
  689. msgid ""
  690. "<literal>unmet</literal> displays a summary of all unmet dependencies in the "
  691. "package cache."
  692. msgstr ""
  693. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  694. #: apt-cache.8.xml:164
  695. msgid ""
  696. "<literal>show</literal> performs a function similar to <command>dpkg --print-"
  697. "avail</command>; it displays the package records for the named packages."
  698. msgstr ""
  699. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable>
  700. #: apt-cache.8.xml:169
  701. msgid "&synopsis-regex;"
  702. msgstr ""
  703. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  704. #: apt-cache.8.xml:170
  705. msgid ""
  706. "<literal>search</literal> performs a full text search on all available "
  707. "package lists for the POSIX regex pattern given, see &regex;. It searches "
  708. "the package names and the descriptions for an occurrence of the regular "
  709. "expression and prints out the package name and the short description, "
  710. "including virtual package names. If <option>--full</option> is given then "
  711. "output identical to <literal>show</literal> is produced for each matched "
  712. "package, and if <option>--names-only</option> is given then the long "
  713. "description is not searched, only the package name is."
  714. msgstr ""
  715. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  716. #: apt-cache.8.xml:181
  717. msgid ""
  718. "Separate arguments can be used to specify multiple search patterns that are "
  719. "and'ed together."
  720. msgstr ""
  721. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  722. #: apt-cache.8.xml:186
  723. msgid ""
  724. "<literal>depends</literal> shows a listing of each dependency a package has "
  725. "and all the possible other packages that can fulfill that dependency."
  726. msgstr ""
  727. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  728. #: apt-cache.8.xml:191
  729. msgid ""
  730. "<literal>rdepends</literal> shows a listing of each reverse dependency a "
  731. "package has."
  732. msgstr ""
  733. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  734. #: apt-cache.8.xml:195
  735. msgid "<optional><replaceable>&synopsis-prefix;</replaceable></optional>"
  736. msgstr ""
  737. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  738. #: apt-cache.8.xml:196
  739. msgid ""
  740. "This command prints the name of each package APT knows. The optional "
  741. "argument is a prefix match to filter the name list. The output is suitable "
  742. "for use in a shell tab complete function and the output is generated "
  743. "extremely quickly. This command is best used with the <option>--generate</"
  744. "option> option."
  745. msgstr ""
  746. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  747. #: apt-cache.8.xml:201
  748. msgid ""
  749. "Note that a package which APT knows of is not necessarily available to "
  750. "download, installable or installed, e.g. virtual packages are also listed in "
  751. "the generated list."
  752. msgstr ""
  753. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  754. #: apt-cache.8.xml:207
  755. msgid ""
  756. "<literal>dotty</literal> takes a list of packages on the command line and "
  757. "generates output suitable for use by dotty from the <ulink url=\"http://www."
  758. "research.att.com/sw/tools/graphviz/\">GraphViz</ulink> package. The result "
  759. "will be a set of nodes and edges representing the relationships between the "
  760. "packages. By default the given packages will trace out all dependent "
  761. "packages; this can produce a very large graph. To limit the output to only "
  762. "the packages listed on the command line, set the <literal>APT::Cache::"
  763. "GivenOnly</literal> option."
  764. msgstr ""
  765. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  766. #: apt-cache.8.xml:216
  767. msgid ""
  768. "The resulting nodes will have several shapes; normal packages are boxes, "
  769. "pure virtual packages are triangles, mixed virtual packages are diamonds, "
  770. "missing packages are hexagons. Orange boxes mean recursion was stopped (leaf "
  771. "packages), blue lines are pre-depends, green lines are conflicts."
  772. msgstr ""
  773. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  774. #: apt-cache.8.xml:221
  775. msgid "Caution, dotty cannot graph larger sets of packages."
  776. msgstr ""
  777. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  778. #: apt-cache.8.xml:225
  779. msgid ""
  780. "The same as <literal>dotty</literal>, only for xvcg from the <ulink url="
  781. "\"http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html\">VCG tool</ulink>."
  782. msgstr ""
  783. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  784. #: apt-cache.8.xml:229
  785. msgid "<optional><replaceable>&synopsis-pkg;</replaceable>…</optional>"
  786. msgstr ""
  787. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  788. #: apt-cache.8.xml:230
  789. msgid ""
  790. "<literal>policy</literal> is meant to help debug issues relating to the "
  791. "preferences file. With no arguments it will print out the priorities of each "
  792. "source. Otherwise it prints out detailed information about the priority "
  793. "selection of the named package."
  794. msgstr ""
  795. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  796. #: apt-cache.8.xml:237
  797. msgid ""
  798. "<literal>apt-cache</literal>'s <literal>madison</literal> command attempts "
  799. "to mimic the output format and a subset of the functionality of the Debian "
  800. "archive management tool, <literal>madison</literal>. It displays available "
  801. "versions of a package in a tabular format. Unlike the original "
  802. "<literal>madison</literal>, it can only display information for the "
  803. "architecture for which APT has retrieved package lists (<literal>APT::"
  804. "Architecture</literal>)."
  805. msgstr ""
  806. #. type: Content of: <refentry><refsect1><title>
  807. #: apt-cache.8.xml:248 apt-config.8.xml:84 apt-extracttemplates.1.xml:52
  808. #: apt-ftparchive.1.xml:504 apt-get.8.xml:259 apt-mark.8.xml:108
  809. #: apt-sortpkgs.1.xml:48
  810. msgid "options"
  811. msgstr ""
  812. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  813. #: apt-cache.8.xml:253
  814. msgid ""
  815. "Select the file to store the package cache. The package cache is the primary "
  816. "cache used by all operations. Configuration Item: <literal>Dir::Cache::"
  817. "pkgcache</literal>."
  818. msgstr ""
  819. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  820. #: apt-cache.8.xml:259
  821. msgid ""
  822. "Select the file to store the source cache. The source is used only by "
  823. "<literal>gencaches</literal> and it stores a parsed version of the package "
  824. "information from remote sources. When building the package cache the source "
  825. "cache is used to avoid reparsing all of the package files. Configuration "
  826. "Item: <literal>Dir::Cache::srcpkgcache</literal>."
  827. msgstr ""
  828. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  829. #: apt-cache.8.xml:267
  830. msgid ""
  831. "Quiet; produces output suitable for logging, omitting progress indicators. "
  832. "More q's will produce more quietness up to a maximum of 2. You can also use "
  833. "<option>-q=#</option> to set the quietness level, overriding the "
  834. "configuration file. Configuration Item: <literal>quiet</literal>."
  835. msgstr ""
  836. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  837. #: apt-cache.8.xml:274
  838. msgid ""
  839. "Print only important dependencies; for use with <literal>unmet</literal> and "
  840. "<literal>depends</literal>. Causes only Depends and Pre-Depends relations to "
  841. "be printed. Configuration Item: <literal>APT::Cache::Important</literal>."
  842. msgstr ""
  843. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  844. #: apt-cache.8.xml:288
  845. msgid ""
  846. "Per default the <literal>depends</literal> and <literal>rdepends</literal> "
  847. "print all dependencies. This can be tweaked with these flags which will omit "
  848. "the specified dependency type. Configuration Item: <literal>APT::Cache::"
  849. "Show<replaceable>DependencyType</replaceable></literal> e.g. <literal>APT::"
  850. "Cache::ShowRecommends</literal>."
  851. msgstr ""
  852. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  853. #: apt-cache.8.xml:295
  854. msgid ""
  855. "Print full package records when searching. Configuration Item: "
  856. "<literal>APT::Cache::ShowFull</literal>."
  857. msgstr ""
  858. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  859. #: apt-cache.8.xml:300
  860. msgid ""
  861. "Print full records for all available versions. This is the default; to turn "
  862. "it off, use <option>--no-all-versions</option>. If <option>--no-all-"
  863. "versions</option> is specified, only the candidate version will be displayed "
  864. "(the one which would be selected for installation). This option is only "
  865. "applicable to the <literal>show</literal> command. Configuration Item: "
  866. "<literal>APT::Cache::AllVersions</literal>."
  867. msgstr ""
  868. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  869. #: apt-cache.8.xml:309
  870. msgid ""
  871. "Perform automatic package cache regeneration, rather than use the cache as "
  872. "it is. This is the default; to turn it off, use <option>--no-generate</"
  873. "option>. Configuration Item: <literal>APT::Cache::Generate</literal>."
  874. msgstr ""
  875. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  876. #: apt-cache.8.xml:315
  877. msgid ""
  878. "Only search on the package names, not the long descriptions. Configuration "
  879. "Item: <literal>APT::Cache::NamesOnly</literal>."
  880. msgstr ""
  881. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  882. #: apt-cache.8.xml:320
  883. msgid ""
  884. "Make <literal>pkgnames</literal> print all names, including virtual packages "
  885. "and missing dependencies. Configuration Item: <literal>APT::Cache::"
  886. "AllNames</literal>."
  887. msgstr ""
  888. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  889. #: apt-cache.8.xml:326
  890. msgid ""
  891. "Make <literal>depends</literal> and <literal>rdepends</literal> recursive so "
  892. "that all packages mentioned are printed once. Configuration Item: "
  893. "<literal>APT::Cache::RecurseDepends</literal>."
  894. msgstr ""
  895. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  896. #: apt-cache.8.xml:333
  897. msgid ""
  898. "Limit the output of <literal>depends</literal> and <literal>rdepends</"
  899. "literal> to packages which are currently installed. Configuration Item: "
  900. "<literal>APT::Cache::Installed</literal>."
  901. msgstr ""
  902. #. type: Content of: <refentry><refsect1><title>
  903. #: apt-cache.8.xml:343 apt-get.8.xml:519 apt-key.8.xml:174 apt-mark.8.xml:125
  904. #: apt.conf.5.xml:1118 apt_preferences.5.xml:698
  905. msgid "Files"
  906. msgstr ""
  907. #. type: Content of: <refentry><refsect1><title>
  908. #: apt-cache.8.xml:350 apt-cdrom.8.xml:144 apt-config.8.xml:109
  909. #: apt-extracttemplates.1.xml:70 apt-ftparchive.1.xml:607 apt-get.8.xml:529
  910. #: apt-key.8.xml:195 apt-mark.8.xml:131 apt-secure.8.xml:192
  911. #: apt-sortpkgs.1.xml:63 apt.conf.5.xml:1124 apt_preferences.5.xml:705
  912. #: sources.list.5.xml:252
  913. msgid "See Also"
  914. msgstr ""
  915. #. type: Content of: <refentry><refsect1><para>
  916. #: apt-cache.8.xml:351
  917. msgid "&apt-conf;, &sources-list;, &apt-get;"
  918. msgstr ""
  919. #. type: Content of: <refentry><refsect1><title>
  920. #: apt-cache.8.xml:355 apt-cdrom.8.xml:149 apt-config.8.xml:114
  921. #: apt-extracttemplates.1.xml:74 apt-ftparchive.1.xml:611 apt-get.8.xml:535
  922. #: apt-mark.8.xml:135 apt-sortpkgs.1.xml:67
  923. msgid "Diagnostics"
  924. msgstr ""
  925. #. type: Content of: <refentry><refsect1><para>
  926. #: apt-cache.8.xml:356
  927. msgid ""
  928. "<command>apt-cache</command> returns zero on normal operation, decimal 100 "
  929. "on error."
  930. msgstr ""
  931. #. type: Content of: <refentry><refnamediv><refpurpose>
  932. #: apt-cdrom.8.xml:32
  933. msgid "APT CD-ROM management utility"
  934. msgstr ""
  935. #. type: Content of: <refentry><refsect1><para>
  936. #: apt-cdrom.8.xml:38
  937. msgid ""
  938. "<command>apt-cdrom</command> is used to add a new CD-ROM to APT's list of "
  939. "available sources. <command>apt-cdrom</command> takes care of determining "
  940. "the structure of the disc as well as correcting for several possible mis-"
  941. "burns and verifying the index files."
  942. msgstr ""
  943. #. type: Content of: <refentry><refsect1><para>
  944. #: apt-cdrom.8.xml:45
  945. msgid ""
  946. "It is necessary to use <command>apt-cdrom</command> to add CDs to the APT "
  947. "system; it cannot be done by hand. Furthermore each disc in a multi-CD set "
  948. "must be inserted and scanned separately to account for possible mis-burns."
  949. msgstr ""
  950. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  951. #: apt-cdrom.8.xml:56
  952. msgid ""
  953. "<literal>add</literal> is used to add a new disc to the source list. It will "
  954. "unmount the CD-ROM device, prompt for a disc to be inserted and then proceed "
  955. "to scan it and copy the index files. If the disc does not have a proper "
  956. "<filename>.disk</filename> directory you will be prompted for a descriptive "
  957. "title."
  958. msgstr ""
  959. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  960. #: apt-cdrom.8.xml:64
  961. msgid ""
  962. "APT uses a CD-ROM ID to track which disc is currently in the drive and "
  963. "maintains a database of these IDs in <filename>&statedir;/cdroms.list</"
  964. "filename>"
  965. msgstr ""
  966. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  967. #: apt-cdrom.8.xml:72
  968. msgid ""
  969. "A debugging tool to report the identity of the current disc as well as the "
  970. "stored file name"
  971. msgstr ""
  972. #. type: Content of: <refentry><refsect1><title>
  973. #: apt-cdrom.8.xml:80 apt-key.8.xml:160
  974. msgid "Options"
  975. msgstr ""
  976. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  977. #: apt-cdrom.8.xml:85
  978. msgid ""
  979. "Mount point; specify the location to mount the CD-ROM. This mount point must "
  980. "be listed in <filename>/etc/fstab</filename> and properly configured. "
  981. "Configuration Item: <literal>Acquire::cdrom::mount</literal>."
  982. msgstr ""
  983. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  984. #: apt-cdrom.8.xml:94
  985. msgid ""
  986. "Rename a disc; change the label of a disc or override the disc's given "
  987. "label. This option will cause <command>apt-cdrom</command> to prompt for a "
  988. "new label. Configuration Item: <literal>APT::CDROM::Rename</literal>."
  989. msgstr ""
  990. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  991. #: apt-cdrom.8.xml:103
  992. msgid ""
  993. "No mounting; prevent <command>apt-cdrom</command> from mounting and "
  994. "unmounting the mount point. Configuration Item: <literal>APT::CDROM::"
  995. "NoMount</literal>."
  996. msgstr ""
  997. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  998. #: apt-cdrom.8.xml:111
  999. msgid ""
  1000. "Fast Copy; Assume the package files are valid and do not check every "
  1001. "package. This option should be used only if <command>apt-cdrom</command> has "
  1002. "been run on this disc before and did not detect any errors. Configuration "
  1003. "Item: <literal>APT::CDROM::Fast</literal>."
  1004. msgstr ""
  1005. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1006. #: apt-cdrom.8.xml:121
  1007. msgid ""
  1008. "Thorough Package Scan; This option may be needed with some old Debian "
  1009. "1.1/1.2 discs that have Package files in strange places. It takes much "
  1010. "longer to scan the CD but will pick them all up."
  1011. msgstr ""
  1012. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1013. #: apt-cdrom.8.xml:132
  1014. msgid ""
  1015. "No Changes; Do not change the &sources-list; file and do not write index "
  1016. "files. Everything is still checked however. Configuration Item: "
  1017. "<literal>APT::CDROM::NoAct</literal>."
  1018. msgstr ""
  1019. #. type: Content of: <refentry><refsect1><para>
  1020. #: apt-cdrom.8.xml:145
  1021. msgid "&apt-conf;, &apt-get;, &sources-list;"
  1022. msgstr ""
  1023. #. type: Content of: <refentry><refsect1><para>
  1024. #: apt-cdrom.8.xml:150
  1025. msgid ""
  1026. "<command>apt-cdrom</command> returns zero on normal operation, decimal 100 "
  1027. "on error."
  1028. msgstr ""
  1029. #. type: Content of: <refentry><refnamediv><refpurpose>
  1030. #: apt-config.8.xml:33
  1031. msgid "APT Configuration Query program"
  1032. msgstr ""
  1033. #. type: Content of: <refentry><refsect1><para>
  1034. #: apt-config.8.xml:39
  1035. msgid ""
  1036. "<command>apt-config</command> is an internal program used by various "
  1037. "portions of the APT suite to provide consistent configurability. It accesses "
  1038. "the main configuration file <filename>/etc/apt/apt.conf</filename> in a "
  1039. "manner that is easy to use for scripted applications."
  1040. msgstr ""
  1041. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1042. #: apt-config.8.xml:51
  1043. msgid ""
  1044. "shell is used to access the configuration information from a shell script. "
  1045. "It is given pairs of arguments, the first being a shell variable and the "
  1046. "second the configuration value to query. As output it lists shell assignment "
  1047. "commands for each value present. In a shell script it should be used as "
  1048. "follows:"
  1049. msgstr ""
  1050. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
  1051. #: apt-config.8.xml:59
  1052. #, no-wrap
  1053. msgid ""
  1054. "OPTS=\"-f\"\n"
  1055. "RES=`apt-config shell OPTS MyApp::options`\n"
  1056. "eval $RES\n"
  1057. msgstr ""
  1058. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1059. #: apt-config.8.xml:64
  1060. msgid ""
  1061. "This will set the shell environment variable $OPTS to the value of MyApp::"
  1062. "options with a default of <option>-f</option>."
  1063. msgstr ""
  1064. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1065. #: apt-config.8.xml:68
  1066. msgid ""
  1067. "The configuration item may be postfixed with a /[fdbi]. f returns file "
  1068. "names, d returns directories, b returns true or false and i returns an "
  1069. "integer. Each of the returns is normalized and verified internally."
  1070. msgstr ""
  1071. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1072. #: apt-config.8.xml:77
  1073. msgid "Just show the contents of the configuration space."
  1074. msgstr ""
  1075. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1076. #: apt-config.8.xml:90
  1077. msgid ""
  1078. "Include options which have an empty value. This is the default, so use --no-"
  1079. "empty to remove them from the output."
  1080. msgstr ""
  1081. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term><option><replaceable>
  1082. #: apt-config.8.xml:95
  1083. msgid "&percnt;f &#x0022;&percnt;v&#x0022;;&percnt;n"
  1084. msgstr ""
  1085. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1086. #: apt-config.8.xml:96
  1087. msgid ""
  1088. "Defines the output of each config option. &percnt;t will be replaced with "
  1089. "its individual name, &percnt;f with its full hierarchical name and &percnt;v "
  1090. "with its value. Use uppercase letters and special characters in the value "
  1091. "will be encoded to ensure that it can e.g. be safely used in a quoted-string "
  1092. "as defined by RFC822. Additionally &percnt;n will be replaced by a newline, "
  1093. "and &percnt;N by a tab. A &percnt; can be printed by using &percnt;&percnt;."
  1094. msgstr ""
  1095. #. type: Content of: <refentry><refsect1><para>
  1096. #: apt-config.8.xml:110 apt-extracttemplates.1.xml:71 apt-ftparchive.1.xml:608
  1097. #: apt-sortpkgs.1.xml:64
  1098. msgid "&apt-conf;"
  1099. msgstr ""
  1100. #. type: Content of: <refentry><refsect1><para>
  1101. #: apt-config.8.xml:115
  1102. msgid ""
  1103. "<command>apt-config</command> returns zero on normal operation, decimal 100 "
  1104. "on error."
  1105. msgstr ""
  1106. #. type: Content of: <refentry><refmeta><manvolnum>
  1107. #: apt-extracttemplates.1.xml:26 apt-ftparchive.1.xml:26 apt-sortpkgs.1.xml:26
  1108. msgid "1"
  1109. msgstr ""
  1110. #. type: Content of: <refentry><refnamediv><refpurpose>
  1111. #: apt-extracttemplates.1.xml:33
  1112. msgid "Utility to extract DebConf config and templates from Debian packages"
  1113. msgstr ""
  1114. #. type: Content of: <refentry><refsect1><para>
  1115. #: apt-extracttemplates.1.xml:39
  1116. msgid ""
  1117. "<command>apt-extracttemplates</command> will take one or more Debian package "
  1118. "files as input and write out (to a temporary directory) all associated "
  1119. "config scripts and template files. For each passed in package that contains "
  1120. "config scripts and templates, one line of output will be generated in the "
  1121. "format:"
  1122. msgstr ""
  1123. #. type: Content of: <refentry><refsect1><para>
  1124. #: apt-extracttemplates.1.xml:44
  1125. msgid "package version template-file config-script"
  1126. msgstr ""
  1127. #. type: Content of: <refentry><refsect1><para>
  1128. #: apt-extracttemplates.1.xml:45
  1129. msgid ""
  1130. "template-file and config-script are written to the temporary directory "
  1131. "specified by the <option>-t</option> or <option>--tempdir</option> "
  1132. "(<literal>APT::ExtractTemplates::TempDir</literal>) directory, with "
  1133. "filenames of the form <filename>package.template.XXXX</filename> and "
  1134. "<filename>package.config.XXXX</filename>"
  1135. msgstr ""
  1136. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1137. #: apt-extracttemplates.1.xml:58
  1138. msgid ""
  1139. "Temporary directory in which to write extracted debconf template files and "
  1140. "config scripts. Configuration Item: <literal>APT::ExtractTemplates::"
  1141. "TempDir</literal>"
  1142. msgstr ""
  1143. #. type: Content of: <refentry><refsect1><para>
  1144. #: apt-extracttemplates.1.xml:75
  1145. msgid ""
  1146. "<command>apt-extracttemplates</command> returns zero on normal operation, "
  1147. "decimal 100 on error."
  1148. msgstr ""
  1149. #. type: Content of: <refentry><refnamediv><refpurpose>
  1150. #: apt-ftparchive.1.xml:33
  1151. msgid "Utility to generate index files"
  1152. msgstr ""
  1153. #. type: Content of: <refentry><refsect1><para>
  1154. #: apt-ftparchive.1.xml:39
  1155. msgid ""
  1156. "<command>apt-ftparchive</command> is the command line tool that generates "
  1157. "the index files that APT uses to access a distribution source. The index "
  1158. "files should be generated on the origin site based on the content of that "
  1159. "site."
  1160. msgstr ""
  1161. #. type: Content of: <refentry><refsect1><para>
  1162. #: apt-ftparchive.1.xml:43
  1163. msgid ""
  1164. "<command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; "
  1165. "program, incorporating its entire functionality via the <literal>packages</"
  1166. "literal> command. It also contains a contents file generator, "
  1167. "<literal>contents</literal>, and an elaborate means to 'script' the "
  1168. "generation process for a complete archive."
  1169. msgstr ""
  1170. #. type: Content of: <refentry><refsect1><para>
  1171. #: apt-ftparchive.1.xml:49
  1172. msgid ""
  1173. "Internally <command>apt-ftparchive</command> can make use of binary "
  1174. "databases to cache the contents of a .deb file and it does not rely on any "
  1175. "external programs aside from &gzip;. When doing a full generate it "
  1176. "automatically performs file-change checks and builds the desired compressed "
  1177. "output files."
  1178. msgstr ""
  1179. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1180. #: apt-ftparchive.1.xml:60
  1181. msgid ""
  1182. "The packages command generates a package file from a directory tree. It "
  1183. "takes the given directory and recursively searches it for .deb files, "
  1184. "emitting a package record to stdout for each. This command is approximately "
  1185. "equivalent to &dpkg-scanpackages;."
  1186. msgstr ""
  1187. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1188. #: apt-ftparchive.1.xml:65 apt-ftparchive.1.xml:89
  1189. msgid ""
  1190. "The option <option>--db</option> can be used to specify a binary caching DB."
  1191. msgstr ""
  1192. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1193. #: apt-ftparchive.1.xml:70
  1194. msgid ""
  1195. "The <literal>sources</literal> command generates a source index file from a "
  1196. "directory tree. It takes the given directory and recursively searches it "
  1197. "for .dsc files, emitting a source record to stdout for each. This command is "
  1198. "approximately equivalent to &dpkg-scansources;."
  1199. msgstr ""
  1200. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1201. #: apt-ftparchive.1.xml:75
  1202. msgid ""
  1203. "If an override file is specified then a source override file will be looked "
  1204. "for with an extension of .src. The --source-override option can be used to "
  1205. "change the source override file that will be used."
  1206. msgstr ""
  1207. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1208. #: apt-ftparchive.1.xml:82
  1209. msgid ""
  1210. "The <literal>contents</literal> command generates a contents file from a "
  1211. "directory tree. It takes the given directory and recursively searches it "
  1212. "for .deb files, and reads the file list from each file. It then sorts and "
  1213. "writes to stdout the list of files matched to packages. Directories are not "
  1214. "written to the output. If multiple packages own the same file then each "
  1215. "package is separated by a comma in the output."
  1216. msgstr ""
  1217. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1218. #: apt-ftparchive.1.xml:94
  1219. msgid ""
  1220. "The <literal>release</literal> command generates a Release file from a "
  1221. "directory tree. It recursively searches the given directory for uncompressed "
  1222. "<filename>Packages</filename> and <filename>Sources</filename> files and the "
  1223. "ones compressed with <command>gzip</command>, <command>bzip2</command> or "
  1224. "<command>lzma</command> as well as <filename>Release</filename> and "
  1225. "<filename>md5sum.txt</filename> files by default (<literal>APT::FTPArchive::"
  1226. "Release::Default-Patterns</literal>). Additional filename patterns can be "
  1227. "added by listing them in <literal>APT::FTPArchive::Release::Patterns</"
  1228. "literal>. It then writes to stdout a Release file containing a MD5, SHA1 "
  1229. "and SHA256 digest for each file."
  1230. msgstr ""
  1231. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1232. #: apt-ftparchive.1.xml:104
  1233. msgid ""
  1234. "Values for the additional metadata fields in the Release file are taken from "
  1235. "the corresponding variables under <literal>APT::FTPArchive::Release</"
  1236. "literal>, e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The "
  1237. "supported fields are: <literal>Origin</literal>, <literal>Label</literal>, "
  1238. "<literal>Suite</literal>, <literal>Version</literal>, <literal>Codename</"
  1239. "literal>, <literal>Date</literal>, <literal>Valid-Until</literal>, "
  1240. "<literal>Architectures</literal>, <literal>Components</literal>, "
  1241. "<literal>Description</literal>."
  1242. msgstr ""
  1243. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1244. #: apt-ftparchive.1.xml:117
  1245. msgid ""
  1246. "The <literal>generate</literal> command is designed to be runnable from a "
  1247. "cron script and builds indexes according to the given config file. The "
  1248. "config language provides a flexible means of specifying which index files "
  1249. "are built from which directories, as well as providing a simple means of "
  1250. "maintaining the required settings."
  1251. msgstr ""
  1252. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1253. #: apt-ftparchive.1.xml:126
  1254. msgid ""
  1255. "The <literal>clean</literal> command tidies the databases used by the given "
  1256. "configuration file by removing any records that are no longer necessary."
  1257. msgstr ""
  1258. #. type: Content of: <refentry><refsect1><title>
  1259. #: apt-ftparchive.1.xml:132
  1260. msgid "The Generate Configuration"
  1261. msgstr ""
  1262. #. type: Content of: <refentry><refsect1><para>
  1263. #: apt-ftparchive.1.xml:134
  1264. msgid ""
  1265. "The <literal>generate</literal> command uses a configuration file to "
  1266. "describe the archives that are going to be generated. It follows the typical "
  1267. "ISC configuration format as seen in ISC tools like bind 8 and dhcpd. &apt-"
  1268. "conf; contains a description of the syntax. Note that the generate "
  1269. "configuration is parsed in sectional manner, but &apt-conf; is parsed in a "
  1270. "tree manner. This only effects how the scope tag is handled."
  1271. msgstr ""
  1272. #. type: Content of: <refentry><refsect1><para>
  1273. #: apt-ftparchive.1.xml:142
  1274. msgid ""
  1275. "The generate configuration has 4 separate sections, each described below."
  1276. msgstr ""
  1277. #. type: Content of: <refentry><refsect1><refsect2><title>
  1278. #: apt-ftparchive.1.xml:144
  1279. msgid "<literal>Dir</literal> Section"
  1280. msgstr ""
  1281. #. type: Content of: <refentry><refsect1><refsect2><para>
  1282. #: apt-ftparchive.1.xml:146
  1283. msgid ""
  1284. "The <literal>Dir</literal> section defines the standard directories needed "
  1285. "to locate the files required during the generation process. These "
  1286. "directories are prepended certain relative paths defined in later sections "
  1287. "to produce a complete an absolute path."
  1288. msgstr ""
  1289. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1290. #: apt-ftparchive.1.xml:153
  1291. msgid ""
  1292. "Specifies the root of the FTP archive, in a standard Debian configuration "
  1293. "this is the directory that contains the <filename>ls-LR</filename> and dist "
  1294. "nodes."
  1295. msgstr ""
  1296. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1297. #: apt-ftparchive.1.xml:160
  1298. msgid "Specifies the location of the override files."
  1299. msgstr ""
  1300. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1301. #: apt-ftparchive.1.xml:165
  1302. msgid "Specifies the location of the cache files"
  1303. msgstr ""
  1304. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1305. #: apt-ftparchive.1.xml:170
  1306. msgid ""
  1307. "Specifies the location of the file list files, if the <literal>FileList</"
  1308. "literal> setting is used below."
  1309. msgstr ""
  1310. #. type: Content of: <refentry><refsect1><refsect2><title>
  1311. #: apt-ftparchive.1.xml:176
  1312. msgid "<literal>Default</literal> Section"
  1313. msgstr ""
  1314. #. type: Content of: <refentry><refsect1><refsect2><para>
  1315. #: apt-ftparchive.1.xml:178
  1316. msgid ""
  1317. "The <literal>Default</literal> section specifies default values, and "
  1318. "settings that control the operation of the generator. Other sections may "
  1319. "override these defaults with a per-section setting."
  1320. msgstr ""
  1321. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1322. #: apt-ftparchive.1.xml:184
  1323. msgid ""
  1324. "Sets the default compression schemes to use for the Package index files. It "
  1325. "is a string that contains a space separated list of at least one of: '.' (no "
  1326. "compression), 'gzip' and 'bzip2'. The default for all compression schemes is "
  1327. "'. gzip'."
  1328. msgstr ""
  1329. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1330. #: apt-ftparchive.1.xml:192
  1331. msgid ""
  1332. "Sets the default list of file extensions that are package files. This "
  1333. "defaults to '.deb'."
  1334. msgstr ""
  1335. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1336. #: apt-ftparchive.1.xml:198
  1337. msgid ""
  1338. "This is similar to <literal>Packages::Compress</literal> except that it "
  1339. "controls the compression for the Sources files."
  1340. msgstr ""
  1341. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1342. #: apt-ftparchive.1.xml:204
  1343. msgid ""
  1344. "Sets the default list of file extensions that are source files. This "
  1345. "defaults to '.dsc'."
  1346. msgstr ""
  1347. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1348. #: apt-ftparchive.1.xml:210
  1349. msgid ""
  1350. "This is similar to <literal>Packages::Compress</literal> except that it "
  1351. "controls the compression for the Contents files."
  1352. msgstr ""
  1353. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1354. #: apt-ftparchive.1.xml:216
  1355. msgid ""
  1356. "This is similar to <literal>Packages::Compress</literal> except that it "
  1357. "controls the compression for the Translation-en master file."
  1358. msgstr ""
  1359. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1360. #: apt-ftparchive.1.xml:222
  1361. msgid ""
  1362. "Specifies the number of kilobytes to delink (and replace with hard links) "
  1363. "per run. This is used in conjunction with the per-section <literal>External-"
  1364. "Links</literal> setting."
  1365. msgstr ""
  1366. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1367. #: apt-ftparchive.1.xml:229
  1368. msgid ""
  1369. "Specifies the mode of all created index files. It defaults to 0644. All "
  1370. "index files are set to this mode with no regard to the umask."
  1371. msgstr ""
  1372. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1373. #: apt-ftparchive.1.xml:236 apt-ftparchive.1.xml:382
  1374. msgid ""
  1375. "Sets if long descriptions should be included in the Packages file or split "
  1376. "out into a master Translation-en file."
  1377. msgstr ""
  1378. #. type: Content of: <refentry><refsect1><refsect2><title>
  1379. #: apt-ftparchive.1.xml:242
  1380. msgid "<literal>TreeDefault</literal> Section"
  1381. msgstr ""
  1382. #. type: Content of: <refentry><refsect1><refsect2><para>
  1383. #: apt-ftparchive.1.xml:244
  1384. msgid ""
  1385. "Sets defaults specific to <literal>Tree</literal> sections. All of these "
  1386. "variables are substitution variables and have the strings $(DIST), "
  1387. "$(SECTION) and $(ARCH) replaced with their respective values."
  1388. msgstr ""
  1389. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1390. #: apt-ftparchive.1.xml:251
  1391. msgid ""
  1392. "Sets the number of kilobytes of contents files that are generated each day. "
  1393. "The contents files are round-robined so that over several days they will all "
  1394. "be rebuilt."
  1395. msgstr ""
  1396. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1397. #: apt-ftparchive.1.xml:258
  1398. msgid ""
  1399. "Controls the number of days a contents file is allowed to be checked without "
  1400. "changing. If this limit is passed the mtime of the contents file is updated. "
  1401. "This case can occur if the package file is changed in such a way that does "
  1402. "not result in a new contents file [override edit for instance]. A hold off "
  1403. "is allowed in hopes that new .debs will be installed, requiring a new file "
  1404. "anyhow. The default is 10, the units are in days."
  1405. msgstr ""
  1406. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1407. #: apt-ftparchive.1.xml:269
  1408. msgid ""
  1409. "Sets the top of the .deb directory tree. Defaults to <filename>$(DIST)/"
  1410. "$(SECTION)/binary-$(ARCH)/</filename>"
  1411. msgstr ""
  1412. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1413. #: apt-ftparchive.1.xml:275
  1414. msgid ""
  1415. "Sets the top of the source package directory tree. Defaults to <filename>"
  1416. "$(DIST)/$(SECTION)/source/</filename>"
  1417. msgstr ""
  1418. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1419. #: apt-ftparchive.1.xml:281
  1420. msgid ""
  1421. "Sets the output Packages file. Defaults to <filename>$(DIST)/$(SECTION)/"
  1422. "binary-$(ARCH)/Packages</filename>"
  1423. msgstr ""
  1424. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1425. #: apt-ftparchive.1.xml:287
  1426. msgid ""
  1427. "Sets the output Sources file. Defaults to <filename>$(DIST)/$(SECTION)/"
  1428. "source/Sources</filename>"
  1429. msgstr ""
  1430. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1431. #: apt-ftparchive.1.xml:293
  1432. msgid ""
  1433. "Set the output Translation-en master file with the long descriptions if they "
  1434. "should be not included in the Packages file. Defaults to <filename>$(DIST)/"
  1435. "$(SECTION)/i18n/Translation-en</filename>"
  1436. msgstr ""
  1437. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1438. #: apt-ftparchive.1.xml:300
  1439. msgid ""
  1440. "Sets the path prefix that causes a symlink to be considered an internal link "
  1441. "instead of an external link. Defaults to <filename>$(DIST)/$(SECTION)/</"
  1442. "filename>"
  1443. msgstr ""
  1444. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1445. #: apt-ftparchive.1.xml:307
  1446. msgid ""
  1447. "Sets the output Contents file. Defaults to <filename>$(DIST)/Contents-$(ARCH)"
  1448. "</filename>. If this setting causes multiple Packages files to map onto a "
  1449. "single Contents file (such as the default) then <command>apt-ftparchive</"
  1450. "command> will integrate those package files together automatically."
  1451. msgstr ""
  1452. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1453. #: apt-ftparchive.1.xml:316
  1454. msgid "Sets header file to prepend to the contents output."
  1455. msgstr ""
  1456. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1457. #: apt-ftparchive.1.xml:321
  1458. msgid ""
  1459. "Sets the binary cache database to use for this section. Multiple sections "
  1460. "can share the same database."
  1461. msgstr ""
  1462. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1463. #: apt-ftparchive.1.xml:327
  1464. msgid ""
  1465. "Specifies that instead of walking the directory tree, <command>apt-"
  1466. "ftparchive</command> should read the list of files from the given file. "
  1467. "Relative files names are prefixed with the archive directory."
  1468. msgstr ""
  1469. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1470. #: apt-ftparchive.1.xml:334
  1471. msgid ""
  1472. "Specifies that instead of walking the directory tree, <command>apt-"
  1473. "ftparchive</command> should read the list of files from the given file. "
  1474. "Relative files names are prefixed with the archive directory. This is used "
  1475. "when processing source indexes."
  1476. msgstr ""
  1477. #. type: Content of: <refentry><refsect1><refsect2><title>
  1478. #: apt-ftparchive.1.xml:342
  1479. msgid "<literal>Tree</literal> Section"
  1480. msgstr ""
  1481. #. type: Content of: <refentry><refsect1><refsect2><para>
  1482. #: apt-ftparchive.1.xml:344
  1483. msgid ""
  1484. "The <literal>Tree</literal> section defines a standard Debian file tree "
  1485. "which consists of a base directory, then multiple sections in that base "
  1486. "directory and finally multiple Architectures in each section. The exact "
  1487. "pathing used is defined by the <literal>Directory</literal> substitution "
  1488. "variable."
  1489. msgstr ""
  1490. #. type: Content of: <refentry><refsect1><refsect2><para>
  1491. #: apt-ftparchive.1.xml:349
  1492. msgid ""
  1493. "The <literal>Tree</literal> section takes a scope tag which sets the "
  1494. "<literal>$(DIST)</literal> variable and defines the root of the tree (the "
  1495. "path is prefixed by <literal>ArchiveDir</literal>). Typically this is a "
  1496. "setting such as <filename>dists/&stable-codename;</filename>."
  1497. msgstr ""
  1498. #. type: Content of: <refentry><refsect1><refsect2><para>
  1499. #: apt-ftparchive.1.xml:354
  1500. msgid ""
  1501. "All of the settings defined in the <literal>TreeDefault</literal> section "
  1502. "can be use in a <literal>Tree</literal> section as well as three new "
  1503. "variables."
  1504. msgstr ""
  1505. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  1506. #: apt-ftparchive.1.xml:360
  1507. #, no-wrap
  1508. msgid ""
  1509. "for i in Sections do \n"
  1510. " for j in Architectures do\n"
  1511. " Generate for DIST=scope SECTION=i ARCH=j\n"
  1512. " "
  1513. msgstr ""
  1514. #. type: Content of: <refentry><refsect1><refsect2><para>
  1515. #: apt-ftparchive.1.xml:357
  1516. msgid ""
  1517. "When processing a <literal>Tree</literal> section <command>apt-ftparchive</"
  1518. "command> performs an operation similar to: <placeholder type=\"programlisting"
  1519. "\" id=\"0\"/>"
  1520. msgstr ""
  1521. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1522. #: apt-ftparchive.1.xml:368
  1523. msgid ""
  1524. "This is a space separated list of sections which appear under the "
  1525. "distribution, typically this is something like <literal>main contrib non-"
  1526. "free</literal>"
  1527. msgstr ""
  1528. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1529. #: apt-ftparchive.1.xml:375
  1530. msgid ""
  1531. "This is a space separated list of all the architectures that appear under "
  1532. "search section. The special architecture 'source' is used to indicate that "
  1533. "this tree has a source archive."
  1534. msgstr ""
  1535. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1536. #: apt-ftparchive.1.xml:388
  1537. msgid ""
  1538. "Sets the binary override file. The override file contains section, priority "
  1539. "and maintainer address information."
  1540. msgstr ""
  1541. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1542. #: apt-ftparchive.1.xml:394
  1543. msgid ""
  1544. "Sets the source override file. The override file contains section "
  1545. "information."
  1546. msgstr ""
  1547. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1548. #: apt-ftparchive.1.xml:400 apt-ftparchive.1.xml:446
  1549. msgid "Sets the binary extra override file."
  1550. msgstr ""
  1551. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1552. #: apt-ftparchive.1.xml:405 apt-ftparchive.1.xml:451
  1553. msgid "Sets the source extra override file."
  1554. msgstr ""
  1555. #. type: Content of: <refentry><refsect1><refsect2><title>
  1556. #: apt-ftparchive.1.xml:410
  1557. msgid "<literal>BinDirectory</literal> Section"
  1558. msgstr ""
  1559. #. type: Content of: <refentry><refsect1><refsect2><para>
  1560. #: apt-ftparchive.1.xml:412
  1561. msgid ""
  1562. "The <literal>bindirectory</literal> section defines a binary directory tree "
  1563. "with no special structure. The scope tag specifies the location of the "
  1564. "binary directory and the settings are similar to the <literal>Tree</literal> "
  1565. "section with no substitution variables or <literal>Section</"
  1566. "literal><literal>Architecture</literal> settings."
  1567. msgstr ""
  1568. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1569. #: apt-ftparchive.1.xml:420
  1570. msgid "Sets the Packages file output."
  1571. msgstr ""
  1572. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1573. #: apt-ftparchive.1.xml:425
  1574. msgid ""
  1575. "Sets the Sources file output. At least one of <literal>Packages</literal> or "
  1576. "<literal>Sources</literal> is required."
  1577. msgstr ""
  1578. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1579. #: apt-ftparchive.1.xml:431
  1580. msgid "Sets the Contents file output. (optional)"
  1581. msgstr ""
  1582. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1583. #: apt-ftparchive.1.xml:436
  1584. msgid "Sets the binary override file."
  1585. msgstr ""
  1586. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1587. #: apt-ftparchive.1.xml:441
  1588. msgid "Sets the source override file."
  1589. msgstr ""
  1590. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1591. #: apt-ftparchive.1.xml:456
  1592. msgid "Sets the cache DB."
  1593. msgstr ""
  1594. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1595. #: apt-ftparchive.1.xml:461
  1596. msgid "Appends a path to all the output paths."
  1597. msgstr ""
  1598. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1599. #: apt-ftparchive.1.xml:466
  1600. msgid "Specifies the file list file."
  1601. msgstr ""
  1602. #. type: Content of: <refentry><refsect1><title>
  1603. #: apt-ftparchive.1.xml:473
  1604. msgid "The Binary Override File"
  1605. msgstr ""
  1606. #. type: Content of: <refentry><refsect1><para>
  1607. #: apt-ftparchive.1.xml:474
  1608. msgid ""
  1609. "The binary override file is fully compatible with &dpkg-scanpackages;. It "
  1610. "contains 4 fields separated by spaces. The first field is the package name, "
  1611. "the second is the priority to force that package to, the third is the the "
  1612. "section to force that package to and the final field is the maintainer "
  1613. "permutation field."
  1614. msgstr ""
  1615. #. type: Content of: <refentry><refsect1><para><literallayout>
  1616. #: apt-ftparchive.1.xml:480
  1617. #, no-wrap
  1618. msgid "old [// oldn]* => new"
  1619. msgstr ""
  1620. #. type: Content of: <refentry><refsect1><para><literallayout>
  1621. #: apt-ftparchive.1.xml:482
  1622. #, no-wrap
  1623. msgid "new"
  1624. msgstr ""
  1625. #. type: Content of: <refentry><refsect1><para>
  1626. #: apt-ftparchive.1.xml:479
  1627. msgid ""
  1628. "The general form of the maintainer field is: <placeholder type="
  1629. "\"literallayout\" id=\"0\"/> or simply, <placeholder type=\"literallayout\" "
  1630. "id=\"1\"/> The first form allows a double-slash separated list of old email "
  1631. "addresses to be specified. If any of those are found then new is substituted "
  1632. "for the maintainer field. The second form unconditionally substitutes the "
  1633. "maintainer field."
  1634. msgstr ""
  1635. #. type: Content of: <refentry><refsect1><title>
  1636. #: apt-ftparchive.1.xml:490
  1637. msgid "The Source Override File"
  1638. msgstr ""
  1639. #. type: Content of: <refentry><refsect1><para>
  1640. #: apt-ftparchive.1.xml:492
  1641. msgid ""
  1642. "The source override file is fully compatible with &dpkg-scansources;. It "
  1643. "contains 2 fields separated by spaces. The first fields is the source "
  1644. "package name, the second is the section to assign it."
  1645. msgstr ""
  1646. #. type: Content of: <refentry><refsect1><title>
  1647. #: apt-ftparchive.1.xml:497
  1648. msgid "The Extra Override File"
  1649. msgstr ""
  1650. #. type: Content of: <refentry><refsect1><para>
  1651. #: apt-ftparchive.1.xml:499
  1652. msgid ""
  1653. "The extra override file allows any arbitrary tag to be added or replaced in "
  1654. "the output. It has 3 columns, the first is the package, the second is the "
  1655. "tag and the remainder of the line is the new value."
  1656. msgstr ""
  1657. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1658. #: apt-ftparchive.1.xml:510
  1659. msgid ""
  1660. "Generate the given checksum. These options default to on, when turned off "
  1661. "the generated index files will not have the checksum fields where possible. "
  1662. "Configuration Items: <literal>APT::FTPArchive::<replaceable>Checksum</"
  1663. "replaceable></literal> and <literal>APT::FTPArchive::<replaceable>Index</"
  1664. "replaceable>::<replaceable>Checksum</replaceable></literal> where "
  1665. "<literal><replaceable>Index</replaceable></literal> can be "
  1666. "<literal>Packages</literal>, <literal>Sources</literal> or <literal>Release</"
  1667. "literal> and <literal><replaceable>Checksum</replaceable></literal> can be "
  1668. "<literal>MD5</literal>, <literal>SHA1</literal> or <literal>SHA256</literal>."
  1669. msgstr ""
  1670. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1671. #: apt-ftparchive.1.xml:521
  1672. msgid ""
  1673. "Use a binary caching DB. This has no effect on the generate command. "
  1674. "Configuration Item: <literal>APT::FTPArchive::DB</literal>."
  1675. msgstr ""
  1676. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1677. #: apt-ftparchive.1.xml:527
  1678. msgid ""
  1679. "Quiet; produces output suitable for logging, omitting progress indicators. "
  1680. "More q's will produce more quiet up to a maximum of 2. You can also use "
  1681. "<option>-q=#</option> to set the quiet level, overriding the configuration "
  1682. "file. Configuration Item: <literal>quiet</literal>."
  1683. msgstr ""
  1684. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1685. #: apt-ftparchive.1.xml:535
  1686. msgid ""
  1687. "Perform Delinking. If the <literal>External-Links</literal> setting is used "
  1688. "then this option actually enables delinking of the files. It defaults to on "
  1689. "and can be turned off with <option>--no-delink</option>. Configuration "
  1690. "Item: <literal>APT::FTPArchive::DeLinkAct</literal>."
  1691. msgstr ""
  1692. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1693. #: apt-ftparchive.1.xml:543
  1694. msgid ""
  1695. "Perform contents generation. When this option is set and package indexes are "
  1696. "being generated with a cache DB then the file listing will also be extracted "
  1697. "and stored in the DB for later use. When using the generate command this "
  1698. "option also allows the creation of any Contents files. The default is on. "
  1699. "Configuration Item: <literal>APT::FTPArchive::Contents</literal>."
  1700. msgstr ""
  1701. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1702. #: apt-ftparchive.1.xml:553
  1703. msgid ""
  1704. "Select the source override file to use with the <literal>sources</literal> "
  1705. "command. Configuration Item: <literal>APT::FTPArchive::SourceOverride</"
  1706. "literal>."
  1707. msgstr ""
  1708. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1709. #: apt-ftparchive.1.xml:559
  1710. msgid ""
  1711. "Make the caching databases read only. Configuration Item: <literal>APT::"
  1712. "FTPArchive::ReadOnlyDB</literal>."
  1713. msgstr ""
  1714. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1715. #: apt-ftparchive.1.xml:564
  1716. msgid ""
  1717. "Accept in the <literal>packages</literal> and <literal>contents</literal> "
  1718. "commands only package files matching <literal>*_arch.deb</literal> or "
  1719. "<literal>*_all.deb</literal> instead of all package files in the given "
  1720. "path. Configuration Item: <literal>APT::FTPArchive::Architecture</literal>."
  1721. msgstr ""
  1722. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1723. #: apt-ftparchive.1.xml:572
  1724. msgid ""
  1725. "&apt-ftparchive; caches as much as possible of metadata in a cachedb. If "
  1726. "packages are recompiled and/or republished with the same version again, this "
  1727. "will lead to problems as the now outdated cached metadata like size and "
  1728. "checksums will be used. With this option enabled this will no longer happen "
  1729. "as it will be checked if the file was changed. Note that this option is set "
  1730. "to \"<literal>false</literal>\" by default as it is not recommend to upload "
  1731. "multiply versions/builds of a package with the same versionnumber, so in "
  1732. "theory nobody will have these problems and therefore all these extra checks "
  1733. "are useless."
  1734. msgstr ""
  1735. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1736. #: apt-ftparchive.1.xml:584
  1737. msgid ""
  1738. "This configuration option defaults to \"<literal>true</literal>\" and should "
  1739. "only be set to <literal>\"false\"</literal> if the Archive generated with "
  1740. "&apt-ftparchive; also provides <filename>Translation</filename> files. Note "
  1741. "that the <filename>Translation-en</filename> master file can only be created "
  1742. "in the generate command."
  1743. msgstr ""
  1744. #. type: Content of: <refentry><refsect1><title>
  1745. #: apt-ftparchive.1.xml:596 apt.conf.5.xml:1112 apt_preferences.5.xml:545
  1746. #: sources.list.5.xml:211
  1747. msgid "Examples"
  1748. msgstr ""
  1749. #. type: Content of: <refentry><refsect1><para><programlisting>
  1750. #: apt-ftparchive.1.xml:602
  1751. #, no-wrap
  1752. msgid "<command>apt-ftparchive</command> packages <replaceable>directory</replaceable> | <command>gzip</command> > <filename>Packages.gz</filename>\n"
  1753. msgstr ""
  1754. #. type: Content of: <refentry><refsect1><para>
  1755. #: apt-ftparchive.1.xml:598
  1756. msgid ""
  1757. "To create a compressed Packages file for a directory containing binary "
  1758. "packages (.deb): <placeholder type=\"programlisting\" id=\"0\"/>"
  1759. msgstr ""
  1760. #. type: Content of: <refentry><refsect1><para>
  1761. #: apt-ftparchive.1.xml:612
  1762. msgid ""
  1763. "<command>apt-ftparchive</command> returns zero on normal operation, decimal "
  1764. "100 on error."
  1765. msgstr ""
  1766. #. type: Content of: <refentry><refnamediv><refpurpose>
  1767. #: apt-get.8.xml:33
  1768. msgid "APT package handling utility -- command-line interface"
  1769. msgstr ""
  1770. #. type: Content of: <refentry><refsect1><para>
  1771. #: apt-get.8.xml:39
  1772. msgid ""
  1773. "<command>apt-get</command> is the command-line tool for handling packages, "
  1774. "and may be considered the user's \"back-end\" to other tools using the APT "
  1775. "library. Several \"front-end\" interfaces exist, such as &dselect;, "
  1776. "&aptitude;, &synaptic; and &wajig;."
  1777. msgstr ""
  1778. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1779. #: apt-get.8.xml:49
  1780. msgid ""
  1781. "<literal>update</literal> is used to resynchronize the package index files "
  1782. "from their sources. The indexes of available packages are fetched from the "
  1783. "location(s) specified in <filename>/etc/apt/sources.list</filename>. For "
  1784. "example, when using a Debian archive, this command retrieves and scans the "
  1785. "<filename>Packages.gz</filename> files, so that information about new and "
  1786. "updated packages is available. An <literal>update</literal> should always be "
  1787. "performed before an <literal>upgrade</literal> or <literal>dist-upgrade</"
  1788. "literal>. Please be aware that the overall progress meter will be incorrect "
  1789. "as the size of the package files cannot be known in advance."
  1790. msgstr ""
  1791. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1792. #: apt-get.8.xml:61
  1793. msgid ""
  1794. "<literal>upgrade</literal> is used to install the newest versions of all "
  1795. "packages currently installed on the system from the sources enumerated in "
  1796. "<filename>/etc/apt/sources.list</filename>. Packages currently installed "
  1797. "with new versions available are retrieved and upgraded; under no "
  1798. "circumstances are currently installed packages removed, or packages not "
  1799. "already installed retrieved and installed. New versions of currently "
  1800. "installed packages that cannot be upgraded without changing the install "
  1801. "status of another package will be left at their current version. An "
  1802. "<literal>update</literal> must be performed first so that <command>apt-get</"
  1803. "command> knows that new versions of packages are available."
  1804. msgstr ""
  1805. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1806. #: apt-get.8.xml:74
  1807. msgid ""
  1808. "<literal>dselect-upgrade</literal> is used in conjunction with the "
  1809. "traditional Debian packaging front-end, &dselect;. <literal>dselect-upgrade</"
  1810. "literal> follows the changes made by &dselect; to the <literal>Status</"
  1811. "literal> field of available packages, and performs the actions necessary to "
  1812. "realize that state (for instance, the removal of old and the installation of "
  1813. "new packages)."
  1814. msgstr ""
  1815. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1816. #: apt-get.8.xml:84
  1817. msgid ""
  1818. "<literal>dist-upgrade</literal> in addition to performing the function of "
  1819. "<literal>upgrade</literal>, also intelligently handles changing dependencies "
  1820. "with new versions of packages; <command>apt-get</command> has a \"smart\" "
  1821. "conflict resolution system, and it will attempt to upgrade the most "
  1822. "important packages at the expense of less important ones if necessary. So, "
  1823. "<literal>dist-upgrade</literal> command may remove some packages. The "
  1824. "<filename>/etc/apt/sources.list</filename> file contains a list of locations "
  1825. "from which to retrieve desired package files. See also &apt-preferences; "
  1826. "for a mechanism for overriding the general settings for individual packages."
  1827. msgstr ""
  1828. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1829. #: apt-get.8.xml:98
  1830. msgid ""
  1831. "<literal>install</literal> is followed by one or more packages desired for "
  1832. "installation or upgrading. Each package is a package name, not a fully "
  1833. "qualified filename (for instance, in a Debian system, libc6 would be the "
  1834. "argument provided, not <literal>libc6_1.9.6-2.deb</literal>). All packages "
  1835. "required by the package(s) specified for installation will also be retrieved "
  1836. "and installed. The <filename>/etc/apt/sources.list</filename> file is used "
  1837. "to locate the desired packages. If a hyphen is appended to the package name "
  1838. "(with no intervening space), the identified package will be removed if it is "
  1839. "installed. Similarly a plus sign can be used to designate a package to "
  1840. "install. These latter features may be used to override decisions made by apt-"
  1841. "get's conflict resolution system."
  1842. msgstr ""
  1843. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1844. #: apt-get.8.xml:116
  1845. msgid ""
  1846. "A specific version of a package can be selected for installation by "
  1847. "following the package name with an equals and the version of the package to "
  1848. "select. This will cause that version to be located and selected for install. "
  1849. "Alternatively a specific distribution can be selected by following the "
  1850. "package name with a slash and the version of the distribution or the Archive "
  1851. "name (stable, testing, unstable)."
  1852. msgstr ""
  1853. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1854. #: apt-get.8.xml:123
  1855. msgid ""
  1856. "Both of the version selection mechanisms can downgrade packages and must be "
  1857. "used with care."
  1858. msgstr ""
  1859. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1860. #: apt-get.8.xml:126
  1861. msgid ""
  1862. "This is also the target to use if you want to upgrade one or more already-"
  1863. "installed packages without upgrading every package you have on your system. "
  1864. "Unlike the \"upgrade\" target, which installs the newest version of all "
  1865. "currently installed packages, \"install\" will install the newest version of "
  1866. "only the package(s) specified. Simply provide the name of the package(s) "
  1867. "you wish to upgrade, and if a newer version is available, it (and its "
  1868. "dependencies, as described above) will be downloaded and installed."
  1869. msgstr ""
  1870. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1871. #: apt-get.8.xml:137
  1872. msgid ""
  1873. "Finally, the &apt-preferences; mechanism allows you to create an alternative "
  1874. "installation policy for individual packages."
  1875. msgstr ""
  1876. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1877. #: apt-get.8.xml:141
  1878. msgid ""
  1879. "If no package matches the given expression and the expression contains one "
  1880. "of '.', '?' or '*' then it is assumed to be a POSIX regular expression, and "
  1881. "it is applied to all package names in the database. Any matches are then "
  1882. "installed (or removed). Note that matching is done by substring so 'lo.*' "
  1883. "matches 'how-lo' and 'lowest'. If this is undesired, anchor the regular "
  1884. "expression with a '^' or '$' character, or create a more specific regular "
  1885. "expression."
  1886. msgstr ""
  1887. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1888. #: apt-get.8.xml:151
  1889. msgid ""
  1890. "<literal>remove</literal> is identical to <literal>install</literal> except "
  1891. "that packages are removed instead of installed. Note the removing a package "
  1892. "leaves its configuration files in system. If a plus sign is appended to the "
  1893. "package name (with no intervening space), the identified package will be "
  1894. "installed instead of removed."
  1895. msgstr ""
  1896. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1897. #: apt-get.8.xml:159
  1898. msgid ""
  1899. "<literal>purge</literal> is identical to <literal>remove</literal> except "
  1900. "that packages are removed and purged (any configuration files are deleted "
  1901. "too)."
  1902. msgstr ""
  1903. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1904. #: apt-get.8.xml:164
  1905. msgid ""
  1906. "<literal>source</literal> causes <command>apt-get</command> to fetch source "
  1907. "packages. APT will examine the available packages to decide which source "
  1908. "package to fetch. It will then find and download into the current directory "
  1909. "the newest available version of that source package while respecting the "
  1910. "default release, set with the option <literal>APT::Default-Release</"
  1911. "literal>, the <option>-t</option> option or per package with the "
  1912. "<literal>pkg/release</literal> syntax, if possible."
  1913. msgstr ""
  1914. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1915. #: apt-get.8.xml:172
  1916. msgid ""
  1917. "Source packages are tracked separately from binary packages via <literal>deb-"
  1918. "src</literal> type lines in the &sources-list; file. This means that you "
  1919. "will need to add such a line for each repository you want to get sources "
  1920. "from. If you don't do this you will properly get another (newer, older or "
  1921. "none) source version than the one you have installed or could install."
  1922. msgstr ""
  1923. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1924. #: apt-get.8.xml:179
  1925. msgid ""
  1926. "If the <option>--compile</option> option is specified then the package will "
  1927. "be compiled to a binary .deb using <command>dpkg-buildpackage</command> for "
  1928. "the architecture as defined by the <command>--host-architecture</command> "
  1929. "option. If <option>--download-only</option> is specified then the source "
  1930. "package will not be unpacked."
  1931. msgstr ""
  1932. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1933. #: apt-get.8.xml:186
  1934. msgid ""
  1935. "A specific source version can be retrieved by postfixing the source name "
  1936. "with an equals and then the version to fetch, similar to the mechanism used "
  1937. "for the package files. This enables exact matching of the source package "
  1938. "name and version, implicitly enabling the <literal>APT::Get::Only-Source</"
  1939. "literal> option."
  1940. msgstr ""
  1941. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1942. #: apt-get.8.xml:192
  1943. msgid ""
  1944. "Note that source packages are not tracked like binary packages, they exist "
  1945. "only in the current directory and are similar to downloading source tar "
  1946. "balls."
  1947. msgstr ""
  1948. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1949. #: apt-get.8.xml:198
  1950. msgid ""
  1951. "<literal>build-dep</literal> causes apt-get to install/remove packages in an "
  1952. "attempt to satisfy the build dependencies for a source package. By default "
  1953. "the dependencies are satisfied to build the package natively. If desired a "
  1954. "host-architecture can be specified with the <option>--host-architecture</"
  1955. "option> option instead."
  1956. msgstr ""
  1957. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1958. #: apt-get.8.xml:205
  1959. msgid ""
  1960. "<literal>check</literal> is a diagnostic tool; it updates the package cache "
  1961. "and checks for broken dependencies."
  1962. msgstr ""
  1963. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1964. #: apt-get.8.xml:210
  1965. msgid ""
  1966. "<literal>download</literal> will download the given binary package into the "
  1967. "current directory."
  1968. msgstr ""
  1969. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1970. #: apt-get.8.xml:216
  1971. msgid ""
  1972. "<literal>clean</literal> clears out the local repository of retrieved "
  1973. "package files. It removes everything but the lock file from "
  1974. "<filename>&cachedir;/archives/</filename> and <filename>&cachedir;/archives/"
  1975. "partial/</filename>. When APT is used as a &dselect; method, <literal>clean</"
  1976. "literal> is run automatically. Those who do not use dselect will likely "
  1977. "want to run <literal>apt-get clean</literal> from time to time to free up "
  1978. "disk space."
  1979. msgstr ""
  1980. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1981. #: apt-get.8.xml:226
  1982. msgid ""
  1983. "Like <literal>clean</literal>, <literal>autoclean</literal> clears out the "
  1984. "local repository of retrieved package files. The difference is that it only "
  1985. "removes package files that can no longer be downloaded, and are largely "
  1986. "useless. This allows a cache to be maintained over a long period without it "
  1987. "growing out of control. The configuration option <literal>APT::Clean-"
  1988. "Installed</literal> will prevent installed packages from being erased if it "
  1989. "is set to off."
  1990. msgstr ""
  1991. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1992. #: apt-get.8.xml:236
  1993. msgid ""
  1994. "<literal>autoremove</literal> is used to remove packages that were "
  1995. "automatically installed to satisfy dependencies for other packages and are "
  1996. "now no longer needed."
  1997. msgstr ""
  1998. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1999. #: apt-get.8.xml:241
  2000. msgid ""
  2001. "<literal>changelog</literal> downloads a package changelog and displays it "
  2002. "through <command>sensible-pager</command>. The server name and base "
  2003. "directory is defined in the <literal>APT::Changelogs::Server</literal> "
  2004. "variable (e. g. <ulink url=\"http://packages.debian.org/changelogs"
  2005. "\">packages.debian.org/changelogs</ulink> for Debian or <ulink url=\"http://"
  2006. "changelogs.ubuntu.com/changelogs\">changelogs.ubuntu.com/changelogs</ulink> "
  2007. "for Ubuntu). By default it displays the changelog for the version that is "
  2008. "installed. However, you can specify the same options as for the "
  2009. "<option>install</option> command."
  2010. msgstr ""
  2011. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2012. #: apt-get.8.xml:264
  2013. msgid ""
  2014. "Do not consider recommended packages as a dependency for installing. "
  2015. "Configuration Item: <literal>APT::Install-Recommends</literal>."
  2016. msgstr ""
  2017. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2018. #: apt-get.8.xml:269
  2019. msgid ""
  2020. "Consider suggested packages as a dependency for installing. Configuration "
  2021. "Item: <literal>APT::Install-Suggests</literal>."
  2022. msgstr ""
  2023. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2024. #: apt-get.8.xml:274
  2025. msgid ""
  2026. "Download only; package files are only retrieved, not unpacked or installed. "
  2027. "Configuration Item: <literal>APT::Get::Download-Only</literal>."
  2028. msgstr ""
  2029. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2030. #: apt-get.8.xml:279
  2031. msgid ""
  2032. "Fix; attempt to correct a system with broken dependencies in place. This "
  2033. "option, when used with install/remove, can omit any packages to permit APT "
  2034. "to deduce a likely solution. If packages are specified, these have to "
  2035. "completely correct the problem. The option is sometimes necessary when "
  2036. "running APT for the first time; APT itself does not allow broken package "
  2037. "dependencies to exist on a system. It is possible that a system's dependency "
  2038. "structure can be so corrupt as to require manual intervention (which usually "
  2039. "means using &dselect; or <command>dpkg --remove</command> to eliminate some "
  2040. "of the offending packages). Use of this option together with <option>-m</"
  2041. "option> may produce an error in some situations. Configuration Item: "
  2042. "<literal>APT::Get::Fix-Broken</literal>."
  2043. msgstr ""
  2044. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2045. #: apt-get.8.xml:294
  2046. msgid ""
  2047. "Ignore missing packages; If packages cannot be retrieved or fail the "
  2048. "integrity check after retrieval (corrupted package files), hold back those "
  2049. "packages and handle the result. Use of this option together with <option>-f</"
  2050. "option> may produce an error in some situations. If a package is selected "
  2051. "for installation (particularly if it is mentioned on the command line) and "
  2052. "it could not be downloaded then it will be silently held back. "
  2053. "Configuration Item: <literal>APT::Get::Fix-Missing</literal>."
  2054. msgstr ""
  2055. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2056. #: apt-get.8.xml:305
  2057. msgid ""
  2058. "Disables downloading of packages. This is best used with <option>--ignore-"
  2059. "missing</option> to force APT to use only the .debs it has already "
  2060. "downloaded. Configuration Item: <literal>APT::Get::Download</literal>."
  2061. msgstr ""
  2062. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2063. #: apt-get.8.xml:312
  2064. msgid ""
  2065. "Quiet; produces output suitable for logging, omitting progress indicators. "
  2066. "More q's will produce more quiet up to a maximum of 2. You can also use "
  2067. "<option>-q=#</option> to set the quiet level, overriding the configuration "
  2068. "file. Note that quiet level 2 implies <option>-y</option>, you should never "
  2069. "use -qq without a no-action modifier such as -d, --print-uris or -s as APT "
  2070. "may decided to do something you did not expect. Configuration Item: "
  2071. "<literal>quiet</literal>."
  2072. msgstr ""
  2073. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2074. #: apt-get.8.xml:327
  2075. msgid ""
  2076. "No action; perform a simulation of events that would occur but do not "
  2077. "actually change the system. Configuration Item: <literal>APT::Get::"
  2078. "Simulate</literal>."
  2079. msgstr ""
  2080. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2081. #: apt-get.8.xml:331
  2082. msgid ""
  2083. "Simulation run as user will deactivate locking (<literal>Debug::NoLocking</"
  2084. "literal>) automatic. Also a notice will be displayed indicating that this "
  2085. "is only a simulation, if the option <literal>APT::Get::Show-User-Simulation-"
  2086. "Note</literal> is set (Default: true). Neither NoLocking nor the notice "
  2087. "will be triggered if run as root (root should know what he is doing without "
  2088. "further warnings by <literal>apt-get</literal>)."
  2089. msgstr ""
  2090. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2091. #: apt-get.8.xml:337
  2092. msgid ""
  2093. "Simulate prints out a series of lines each one representing a dpkg "
  2094. "operation, Configure (Conf), Remove (Remv), Unpack (Inst). Square brackets "
  2095. "indicate broken packages and empty set of square brackets meaning breaks "
  2096. "that are of no consequence (rare)."
  2097. msgstr ""
  2098. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2099. #: apt-get.8.xml:346
  2100. msgid ""
  2101. "Automatic yes to prompts; assume \"yes\" as answer to all prompts and run "
  2102. "non-interactively. If an undesirable situation, such as changing a held "
  2103. "package, trying to install a unauthenticated package or removing an "
  2104. "essential package occurs then <literal>apt-get</literal> will abort. "
  2105. "Configuration Item: <literal>APT::Get::Assume-Yes</literal>."
  2106. msgstr ""
  2107. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2108. #: apt-get.8.xml:354
  2109. msgid ""
  2110. "Automatic \"no\" to all prompts. Configuration Item: <literal>APT::Get::"
  2111. "Assume-No</literal>."
  2112. msgstr ""
  2113. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2114. #: apt-get.8.xml:359
  2115. msgid ""
  2116. "Show upgraded packages; Print out a list of all packages that are to be "
  2117. "upgraded. Configuration Item: <literal>APT::Get::Show-Upgraded</literal>."
  2118. msgstr ""
  2119. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2120. #: apt-get.8.xml:365
  2121. msgid ""
  2122. "Show full versions for upgraded and installed packages. Configuration Item: "
  2123. "<literal>APT::Get::Show-Versions</literal>."
  2124. msgstr ""
  2125. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2126. #: apt-get.8.xml:371
  2127. msgid ""
  2128. "This option controls the architecture packages are built for by <command>apt-"
  2129. "get source --compile</command> and how cross-builddependencies are "
  2130. "satisfied. By default is it not set which means that the host architecture "
  2131. "is the same as the build architecture (which is defined by <literal>APT::"
  2132. "Architecture</literal>). Configuration Item: <literal>APT::Get::Host-"
  2133. "Architecture</literal>"
  2134. msgstr ""
  2135. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2136. #: apt-get.8.xml:381
  2137. msgid ""
  2138. "Compile source packages after downloading them. Configuration Item: "
  2139. "<literal>APT::Get::Compile</literal>."
  2140. msgstr ""
  2141. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2142. #: apt-get.8.xml:386
  2143. msgid ""
  2144. "Ignore package Holds; This causes <command>apt-get</command> to ignore a "
  2145. "hold placed on a package. This may be useful in conjunction with "
  2146. "<literal>dist-upgrade</literal> to override a large number of undesired "
  2147. "holds. Configuration Item: <literal>APT::Ignore-Hold</literal>."
  2148. msgstr ""
  2149. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2150. #: apt-get.8.xml:393
  2151. msgid ""
  2152. "Do not upgrade packages; When used in conjunction with <literal>install</"
  2153. "literal>, <literal>no-upgrade</literal> will prevent packages on the command "
  2154. "line from being upgraded if they are already installed. Configuration Item: "
  2155. "<literal>APT::Get::Upgrade</literal>."
  2156. msgstr ""
  2157. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2158. #: apt-get.8.xml:400
  2159. msgid ""
  2160. "Do not install new packages; When used in conjunction with <literal>install</"
  2161. "literal>, <literal>only-upgrade</literal> will install upgrades for already "
  2162. "installed packages only and ignore requests to install new packages. "
  2163. "Configuration Item: <literal>APT::Get::Only-Upgrade</literal>."
  2164. msgstr ""
  2165. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2166. #: apt-get.8.xml:408
  2167. msgid ""
  2168. "Force yes; This is a dangerous option that will cause apt to continue "
  2169. "without prompting if it is doing something potentially harmful. It should "
  2170. "not be used except in very special situations. Using <literal>force-yes</"
  2171. "literal> can potentially destroy your system! Configuration Item: "
  2172. "<literal>APT::Get::force-yes</literal>."
  2173. msgstr ""
  2174. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2175. #: apt-get.8.xml:416
  2176. msgid ""
  2177. "Instead of fetching the files to install their URIs are printed. Each URI "
  2178. "will have the path, the destination file name, the size and the expected md5 "
  2179. "hash. Note that the file name to write to will not always match the file "
  2180. "name on the remote site! This also works with the <literal>source</literal> "
  2181. "and <literal>update</literal> commands. When used with the <literal>update</"
  2182. "literal> command the MD5 and size are not included, and it is up to the user "
  2183. "to decompress any compressed files. Configuration Item: <literal>APT::Get::"
  2184. "Print-URIs</literal>."
  2185. msgstr ""
  2186. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2187. #: apt-get.8.xml:427
  2188. msgid ""
  2189. "Use purge instead of remove for anything that would be removed. An asterisk "
  2190. "(\"*\") will be displayed next to packages which are scheduled to be purged. "
  2191. "<option>remove --purge</option> is equivalent to the <option>purge</option> "
  2192. "command. Configuration Item: <literal>APT::Get::Purge</literal>."
  2193. msgstr ""
  2194. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2195. #: apt-get.8.xml:435
  2196. msgid ""
  2197. "Re-Install packages that are already installed and at the newest version. "
  2198. "Configuration Item: <literal>APT::Get::ReInstall</literal>."
  2199. msgstr ""
  2200. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2201. #: apt-get.8.xml:440
  2202. msgid ""
  2203. "This option defaults to on, use <literal>--no-list-cleanup</literal> to turn "
  2204. "it off. When on <command>apt-get</command> will automatically manage the "
  2205. "contents of <filename>&statedir;/lists</filename> to ensure that obsolete "
  2206. "files are erased. The only reason to turn it off is if you frequently "
  2207. "change your source list. Configuration Item: <literal>APT::Get::List-"
  2208. "Cleanup</literal>."
  2209. msgstr ""
  2210. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2211. #: apt-get.8.xml:451
  2212. msgid ""
  2213. "This option controls the default input to the policy engine, it creates a "
  2214. "default pin at priority 990 using the specified release string. This "
  2215. "overrides the general settings in <filename>/etc/apt/preferences</"
  2216. "filename>. Specifically pinned packages are not affected by the value of "
  2217. "this option. In short, this option lets you have simple control over which "
  2218. "distribution packages will be retrieved from. Some common examples might be "
  2219. "<option>-t '2.1*'</option>, <option>-t unstable</option> or <option>-t sid</"
  2220. "option>. Configuration Item: <literal>APT::Default-Release</literal>; see "
  2221. "also the &apt-preferences; manual page."
  2222. msgstr ""
  2223. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2224. #: apt-get.8.xml:466
  2225. msgid ""
  2226. "Only perform operations that are 'trivial'. Logically this can be considered "
  2227. "related to <option>--assume-yes</option>, where <option>--assume-yes</"
  2228. "option> will answer yes to any prompt, <option>--trivial-only</option> will "
  2229. "answer no. Configuration Item: <literal>APT::Get::Trivial-Only</literal>."
  2230. msgstr ""
  2231. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2232. #: apt-get.8.xml:473
  2233. msgid ""
  2234. "If any packages are to be removed apt-get immediately aborts without "
  2235. "prompting. Configuration Item: <literal>APT::Get::Remove</literal>."
  2236. msgstr ""
  2237. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2238. #: apt-get.8.xml:479
  2239. msgid ""
  2240. "If the command is either <literal>install</literal> or <literal>remove</"
  2241. "literal>, then this option acts like running <literal>autoremove</literal> "
  2242. "command, removing the unused dependency packages. Configuration Item: "
  2243. "<literal>APT::Get::AutomaticRemove</literal>."
  2244. msgstr ""
  2245. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2246. #: apt-get.8.xml:486
  2247. msgid ""
  2248. "Only has meaning for the <literal>source</literal> and <literal>build-dep</"
  2249. "literal> commands. Indicates that the given source names are not to be "
  2250. "mapped through the binary table. This means that if this option is "
  2251. "specified, these commands will only accept source package names as "
  2252. "arguments, rather than accepting binary package names and looking up the "
  2253. "corresponding source package. Configuration Item: <literal>APT::Get::Only-"
  2254. "Source</literal>."
  2255. msgstr ""
  2256. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2257. #: apt-get.8.xml:497
  2258. msgid ""
  2259. "Download only the diff, dsc, or tar file of a source archive. Configuration "
  2260. "Item: <literal>APT::Get::Diff-Only</literal>, <literal>APT::Get::Dsc-Only</"
  2261. "literal>, and <literal>APT::Get::Tar-Only</literal>."
  2262. msgstr ""
  2263. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2264. #: apt-get.8.xml:503
  2265. msgid ""
  2266. "Only process architecture-dependent build-dependencies. Configuration Item: "
  2267. "<literal>APT::Get::Arch-Only</literal>."
  2268. msgstr ""
  2269. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2270. #: apt-get.8.xml:508
  2271. msgid ""
  2272. "Ignore if packages can't be authenticated and don't prompt about it. This "
  2273. "is useful for tools like pbuilder. Configuration Item: <literal>APT::Get::"
  2274. "AllowUnauthenticated</literal>."
  2275. msgstr ""
  2276. #. type: Content of: <refentry><refsect1><para>
  2277. #: apt-get.8.xml:530
  2278. msgid ""
  2279. "&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, "
  2280. "&apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, &apt-"
  2281. "preferences;, the APT Howto."
  2282. msgstr ""
  2283. #. type: Content of: <refentry><refsect1><para>
  2284. #: apt-get.8.xml:536
  2285. msgid ""
  2286. "<command>apt-get</command> returns zero on normal operation, decimal 100 on "
  2287. "error."
  2288. msgstr ""
  2289. #. type: Content of: <refentry><refnamediv><refpurpose>
  2290. #: apt-key.8.xml:32
  2291. msgid "APT key management utility"
  2292. msgstr ""
  2293. #. type: Content of: <refentry><refsect1><para>
  2294. #: apt-key.8.xml:39
  2295. msgid ""
  2296. "<command>apt-key</command> is used to manage the list of keys used by apt to "
  2297. "authenticate packages. Packages which have been authenticated using these "
  2298. "keys will be considered trusted."
  2299. msgstr ""
  2300. #. type: Content of: <refentry><refsect1><title>
  2301. #: apt-key.8.xml:45
  2302. msgid "Commands"
  2303. msgstr ""
  2304. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2305. #: apt-key.8.xml:50
  2306. msgid ""
  2307. "Add a new key to the list of trusted keys. The key is read from the "
  2308. "filename given with the parameter &synopsis-param-filename; or if the "
  2309. "filename is <literal>-</literal> from standard input."
  2310. msgstr ""
  2311. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2312. #: apt-key.8.xml:63
  2313. msgid "Remove a key from the list of trusted keys."
  2314. msgstr ""
  2315. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2316. #: apt-key.8.xml:74
  2317. msgid "Output the key &synopsis-param-keyid; to standard output."
  2318. msgstr ""
  2319. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2320. #: apt-key.8.xml:85
  2321. msgid "Output all trusted keys to standard output."
  2322. msgstr ""
  2323. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2324. #: apt-key.8.xml:96
  2325. msgid "List trusted keys."
  2326. msgstr ""
  2327. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2328. #: apt-key.8.xml:107
  2329. msgid "List fingerprints of trusted keys."
  2330. msgstr ""
  2331. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2332. #: apt-key.8.xml:118
  2333. msgid ""
  2334. "Pass advanced options to gpg. With adv --recv-key you can download the "
  2335. "public key."
  2336. msgstr ""
  2337. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2338. #: apt-key.8.xml:130
  2339. msgid ""
  2340. "Update the local keyring with the archive keyring and remove from the local "
  2341. "keyring the archive keys which are no longer valid. The archive keyring is "
  2342. "shipped in the <literal>archive-keyring</literal> package of your "
  2343. "distribution, e.g. the <literal>debian-archive-keyring</literal> package in "
  2344. "Debian."
  2345. msgstr ""
  2346. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2347. #: apt-key.8.xml:144
  2348. msgid ""
  2349. "Work similar to the <command>update</command> command above, but get the "
  2350. "archive keyring from an URI instead and validate it against a master key. "
  2351. "This requires an installed &wget; and an APT build configured to have a "
  2352. "server to fetch from and a master keyring to validate. APT in Debian does "
  2353. "not support this command and relies on <command>update</command> instead, "
  2354. "but Ubuntu's APT does."
  2355. msgstr ""
  2356. #. type: Content of: <refentry><refsect1><para>
  2357. #: apt-key.8.xml:161
  2358. msgid ""
  2359. "Note that options need to be defined before the commands described in the "
  2360. "previous section."
  2361. msgstr ""
  2362. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2363. #: apt-key.8.xml:164
  2364. msgid ""
  2365. "With this option it is possible to specify a specific keyring file the "
  2366. "command should operate on. The default is that a command is executed on the "
  2367. "<filename>trusted.gpg</filename> file as well as on all parts in the "
  2368. "<filename>trusted.gpg.d</filename> directory, though <filename>trusted.gpg</"
  2369. "filename> is the primary keyring which means that e.g. new keys are added to "
  2370. "this one."
  2371. msgstr ""
  2372. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2373. #: apt-key.8.xml:179
  2374. msgid "<filename>/etc/apt/trustdb.gpg</filename>"
  2375. msgstr ""
  2376. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2377. #: apt-key.8.xml:180
  2378. msgid "Local trust database of archive keys."
  2379. msgstr ""
  2380. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2381. #: apt-key.8.xml:183
  2382. msgid "<filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename>"
  2383. msgstr ""
  2384. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2385. #: apt-key.8.xml:184
  2386. msgid "Keyring of Debian archive trusted keys."
  2387. msgstr ""
  2388. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2389. #: apt-key.8.xml:187
  2390. msgid ""
  2391. "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>"
  2392. msgstr ""
  2393. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2394. #: apt-key.8.xml:188
  2395. msgid "Keyring of Debian archive removed trusted keys."
  2396. msgstr ""
  2397. #. type: Content of: <refentry><refsect1><para>
  2398. #: apt-key.8.xml:197
  2399. msgid "&apt-get;, &apt-secure;"
  2400. msgstr ""
  2401. #. type: Content of: <refentry><refnamediv><refpurpose>
  2402. #: apt-mark.8.xml:33
  2403. msgid "mark/unmark a package as being automatically-installed"
  2404. msgstr ""
  2405. #. type: Content of: <refentry><refsect1><para>
  2406. #: apt-mark.8.xml:39
  2407. msgid ""
  2408. "<command>apt-mark</command> will change whether a package has been marked as "
  2409. "being automatically installed."
  2410. msgstr ""
  2411. #. type: Content of: <refentry><refsect1><para>
  2412. #: apt-mark.8.xml:43
  2413. msgid ""
  2414. "When you request that a package is installed, and as a result other packages "
  2415. "are installed to satisfy its dependencies, the dependencies are marked as "
  2416. "being automatically installed. Once these automatically installed packages "
  2417. "are no longer depended on by any manually installed packages, they will be "
  2418. "removed by e.g. <command>apt-get</command> or <command>aptitude</command>."
  2419. msgstr ""
  2420. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2421. #: apt-mark.8.xml:52
  2422. msgid ""
  2423. "<literal>auto</literal> is used to mark a package as being automatically "
  2424. "installed, which will cause the package to be removed when no more manually "
  2425. "installed packages depend on this package."
  2426. msgstr ""
  2427. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2428. #: apt-mark.8.xml:60
  2429. msgid ""
  2430. "<literal>manual</literal> is used to mark a package as being manually "
  2431. "installed, which will prevent the package from being automatically removed "
  2432. "if no other packages depend on it."
  2433. msgstr ""
  2434. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2435. #: apt-mark.8.xml:68
  2436. msgid ""
  2437. "<literal>hold</literal> is used to mark a package as hold back, which will "
  2438. "prevent the package from being automatically installed, upgraded or "
  2439. "removed. The command is only a wrapper around <command>dpkg --set-"
  2440. "selections</command> and the state is therefore maintained by &dpkg; and not "
  2441. "effected by the <option>--filename</option> option."
  2442. msgstr ""
  2443. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2444. #: apt-mark.8.xml:78
  2445. msgid ""
  2446. "<literal>unhold</literal> is used to cancel a previously set hold on a "
  2447. "package to allow all actions again."
  2448. msgstr ""
  2449. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2450. #: apt-mark.8.xml:84
  2451. msgid ""
  2452. "<literal>showauto</literal> is used to print a list of automatically "
  2453. "installed packages with each package on a new line. All automatically "
  2454. "installed packages will be listed if no package is given. If packages are "
  2455. "given only those which are automatically installed will be shown."
  2456. msgstr ""
  2457. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2458. #: apt-mark.8.xml:92
  2459. msgid ""
  2460. "<literal>showmanual</literal> can be used in the same way as "
  2461. "<literal>showauto</literal> except that it will print a list of manually "
  2462. "installed packages instead."
  2463. msgstr ""
  2464. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2465. #: apt-mark.8.xml:99
  2466. msgid ""
  2467. "<literal>showhold</literal> is used to print a list of packages on hold in "
  2468. "the same way as for the other show commands."
  2469. msgstr ""
  2470. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2471. #: apt-mark.8.xml:115
  2472. msgid ""
  2473. "Read/Write package stats from the filename given with the parameter "
  2474. "&synopsis-param-filename; instead of from the default location, which is "
  2475. "<filename>extended_status</filename> in the directory defined by the "
  2476. "Configuration Item: <literal>Dir::State</literal>."
  2477. msgstr ""
  2478. #. type: Content of: <refentry><refsect1><para>
  2479. #: apt-mark.8.xml:136
  2480. msgid ""
  2481. "<command>apt-mark</command> returns zero on normal operation, non-zero on "
  2482. "error."
  2483. msgstr ""
  2484. #. type: Content of: <refentry><refnamediv><refpurpose>
  2485. #: apt-secure.8.xml:47
  2486. msgid "Archive authentication support for APT"
  2487. msgstr ""
  2488. #. type: Content of: <refentry><refsect1><para>
  2489. #: apt-secure.8.xml:52
  2490. msgid ""
  2491. "Starting with version 0.6, <command>apt</command> contains code that does "
  2492. "signature checking of the Release file for all archives. This ensures that "
  2493. "packages in the archive can't be modified by people who have no access to "
  2494. "the Release file signing key."
  2495. msgstr ""
  2496. #. type: Content of: <refentry><refsect1><para>
  2497. #: apt-secure.8.xml:60
  2498. msgid ""
  2499. "If a package comes from a archive without a signature or with a signature "
  2500. "that apt does not have a key for that package is considered untrusted and "
  2501. "installing it will result in a big warning. <command>apt-get</command> will "
  2502. "currently only warn for unsigned archives, future releases might force all "
  2503. "sources to be verified before downloading packages from them."
  2504. msgstr ""
  2505. #. type: Content of: <refentry><refsect1><para>
  2506. #: apt-secure.8.xml:69
  2507. msgid ""
  2508. "The package frontends &apt-get;, &aptitude; and &synaptic; support this new "
  2509. "authentication feature."
  2510. msgstr ""
  2511. #. type: Content of: <refentry><refsect1><title>
  2512. #: apt-secure.8.xml:74
  2513. msgid "Trusted archives"
  2514. msgstr ""
  2515. #. type: Content of: <refentry><refsect1><para>
  2516. #: apt-secure.8.xml:77
  2517. msgid ""
  2518. "The chain of trust from an apt archive to the end user is made up of "
  2519. "different steps. <command>apt-secure</command> is the last step in this "
  2520. "chain, trusting an archive does not mean that the packages that you trust it "
  2521. "do not contain malicious code but means that you trust the archive "
  2522. "maintainer. It's the archive maintainer responsibility to ensure that the "
  2523. "archive integrity is correct."
  2524. msgstr ""
  2525. #. type: Content of: <refentry><refsect1><para>
  2526. #: apt-secure.8.xml:85
  2527. msgid ""
  2528. "apt-secure does not review signatures at a package level. If you require "
  2529. "tools to do this you should look at <command>debsig-verify</command> and "
  2530. "<command>debsign</command> (provided in the debsig-verify and devscripts "
  2531. "packages respectively)."
  2532. msgstr ""
  2533. #. type: Content of: <refentry><refsect1><para>
  2534. #: apt-secure.8.xml:92
  2535. msgid ""
  2536. "The chain of trust in Debian starts when a maintainer uploads a new package "
  2537. "or a new version of a package to the Debian archive. This upload in order to "
  2538. "become effective needs to be signed by a key of a maintainer within the "
  2539. "Debian maintainer's keyring (available in the debian-keyring package). "
  2540. "Maintainer's keys are signed by other maintainers following pre-established "
  2541. "procedures to ensure the identity of the key holder."
  2542. msgstr ""
  2543. #. type: Content of: <refentry><refsect1><para>
  2544. #: apt-secure.8.xml:102
  2545. msgid ""
  2546. "Once the uploaded package is verified and included in the archive, the "
  2547. "maintainer signature is stripped off, an MD5 sum of the package is computed "
  2548. "and put in the Packages file. The MD5 sum of all of the packages files are "
  2549. "then computed and put into the Release file. The Release file is then signed "
  2550. "by the archive key (which is created once a year) and distributed through "
  2551. "the FTP server. This key is also on the Debian keyring."
  2552. msgstr ""
  2553. #. type: Content of: <refentry><refsect1><para>
  2554. #: apt-secure.8.xml:112
  2555. msgid ""
  2556. "Any end user can check the signature of the Release file, extract the MD5 "
  2557. "sum of a package from it and compare it with the MD5 sum of the package he "
  2558. "downloaded. Prior to version 0.6 only the MD5 sum of the downloaded Debian "
  2559. "package was checked. Now both the MD5 sum and the signature of the Release "
  2560. "file are checked."
  2561. msgstr ""
  2562. #. type: Content of: <refentry><refsect1><para>
  2563. #: apt-secure.8.xml:119
  2564. msgid ""
  2565. "Notice that this is distinct from checking signatures on a per package "
  2566. "basis. It is designed to prevent two possible attacks:"
  2567. msgstr ""
  2568. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  2569. #: apt-secure.8.xml:124
  2570. msgid ""
  2571. "<literal>Network \"man in the middle\" attacks</literal>. Without signature "
  2572. "checking, a malicious agent can introduce himself in the package download "
  2573. "process and provide malicious software either by controlling a network "
  2574. "element (router, switch, etc.) or by redirecting traffic to a rogue server "
  2575. "(through arp or DNS spoofing attacks)."
  2576. msgstr ""
  2577. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  2578. #: apt-secure.8.xml:132
  2579. msgid ""
  2580. "<literal>Mirror network compromise</literal>. Without signature checking, a "
  2581. "malicious agent can compromise a mirror host and modify the files in it to "
  2582. "propagate malicious software to all users downloading packages from that "
  2583. "host."
  2584. msgstr ""
  2585. #. type: Content of: <refentry><refsect1><para>
  2586. #: apt-secure.8.xml:139
  2587. msgid ""
  2588. "However, it does not defend against a compromise of the Debian master server "
  2589. "itself (which signs the packages) or against a compromise of the key used to "
  2590. "sign the Release files. In any case, this mechanism can complement a per-"
  2591. "package signature."
  2592. msgstr ""
  2593. #. type: Content of: <refentry><refsect1><title>
  2594. #: apt-secure.8.xml:145
  2595. msgid "User configuration"
  2596. msgstr ""
  2597. #. type: Content of: <refentry><refsect1><para>
  2598. #: apt-secure.8.xml:147
  2599. msgid ""
  2600. "<command>apt-key</command> is the program that manages the list of keys used "
  2601. "by apt. It can be used to add or remove keys although an installation of "
  2602. "this release will automatically provide the default Debian archive signing "
  2603. "keys used in the Debian package repositories."
  2604. msgstr ""
  2605. #. type: Content of: <refentry><refsect1><para>
  2606. #: apt-secure.8.xml:154
  2607. msgid ""
  2608. "In order to add a new key you need to first download it (you should make "
  2609. "sure you are using a trusted communication channel when retrieving it), add "
  2610. "it with <command>apt-key</command> and then run <command>apt-get update</"
  2611. "command> so that apt can download and verify the <filename>InRelease</"
  2612. "filename> or <filename>Release.gpg</filename> files from the archives you "
  2613. "have configured."
  2614. msgstr ""
  2615. #. type: Content of: <refentry><refsect1><title>
  2616. #: apt-secure.8.xml:163
  2617. msgid "Archive configuration"
  2618. msgstr ""
  2619. #. type: Content of: <refentry><refsect1><para>
  2620. #: apt-secure.8.xml:165
  2621. msgid ""
  2622. "If you want to provide archive signatures in an archive under your "
  2623. "maintenance you have to:"
  2624. msgstr ""
  2625. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  2626. #: apt-secure.8.xml:170
  2627. msgid ""
  2628. "<emphasis>Create a toplevel Release file</emphasis>, if it does not exist "
  2629. "already. You can do this by running <command>apt-ftparchive release</"
  2630. "command> (provided in apt-utils)."
  2631. msgstr ""
  2632. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  2633. #: apt-secure.8.xml:175
  2634. msgid ""
  2635. "<emphasis>Sign it</emphasis>. You can do this by running <command>gpg --"
  2636. "clearsign -o InRelease Release</command> and <command>gpg -abs -o Release."
  2637. "gpg Release</command>."
  2638. msgstr ""
  2639. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  2640. #: apt-secure.8.xml:179
  2641. msgid ""
  2642. "<emphasis>Publish the key fingerprint</emphasis>, that way your users will "
  2643. "know what key they need to import in order to authenticate the files in the "
  2644. "archive."
  2645. msgstr ""
  2646. #. type: Content of: <refentry><refsect1><para>
  2647. #: apt-secure.8.xml:186
  2648. msgid ""
  2649. "Whenever the contents of the archive changes (new packages are added or "
  2650. "removed) the archive maintainer has to follow the first two steps previously "
  2651. "outlined."
  2652. msgstr ""
  2653. #. type: Content of: <refentry><refsect1><para>
  2654. #: apt-secure.8.xml:194
  2655. msgid ""
  2656. "&apt-conf;, &apt-get;, &sources-list;, &apt-key;, &apt-ftparchive;, "
  2657. "&debsign; &debsig-verify;, &gpg;"
  2658. msgstr ""
  2659. #. type: Content of: <refentry><refsect1><para>
  2660. #: apt-secure.8.xml:198
  2661. msgid ""
  2662. "For more background information you might want to review the <ulink url="
  2663. "\"http://www.debian.org/doc/manuals/securing-debian-howto/ch7\">Debian "
  2664. "Security Infrastructure</ulink> chapter of the Securing Debian Manual "
  2665. "(available also in the harden-doc package) and the <ulink url=\"http://www."
  2666. "cryptnet.net/fdp/crypto/strong_distro.html\" >Strong Distribution HOWTO</"
  2667. "ulink> by V. Alex Brennen."
  2668. msgstr ""
  2669. #. type: Content of: <refentry><refsect1><title>
  2670. #: apt-secure.8.xml:211
  2671. msgid "Manpage Authors"
  2672. msgstr ""
  2673. #. type: Content of: <refentry><refsect1><para>
  2674. #: apt-secure.8.xml:213
  2675. msgid ""
  2676. "This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac "
  2677. "Jones, Colin Walters, Florian Weimer and Michael Vogt."
  2678. msgstr ""
  2679. #. type: Content of: <refentry><refnamediv><refpurpose>
  2680. #: apt-sortpkgs.1.xml:33
  2681. msgid "Utility to sort package index files"
  2682. msgstr ""
  2683. #. type: Content of: <refentry><refsect1><para>
  2684. #: apt-sortpkgs.1.xml:39
  2685. msgid ""
  2686. "<command>apt-sortpkgs</command> will take an index file (Source index or "
  2687. "Package index) and sort the records so that they are ordered by the package "
  2688. "name. It will also sort the internal fields of each record according to the "
  2689. "internal sorting rules."
  2690. msgstr ""
  2691. #. type: Content of: <refentry><refsect1><para>
  2692. #: apt-sortpkgs.1.xml:45
  2693. msgid "All output is sent to stdout, the input must be a seekable file."
  2694. msgstr ""
  2695. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2696. #: apt-sortpkgs.1.xml:54
  2697. msgid ""
  2698. "Use Source index field ordering. Configuration Item: <literal>APT::"
  2699. "SortPkgs::Source</literal>."
  2700. msgstr ""
  2701. #. type: Content of: <refentry><refsect1><para>
  2702. #: apt-sortpkgs.1.xml:68
  2703. msgid ""
  2704. "<command>apt-sortpkgs</command> returns zero on normal operation, decimal "
  2705. "100 on error."
  2706. msgstr ""
  2707. #. type: Content of: <refentry><refentryinfo><author><contrib>
  2708. #: apt.conf.5.xml:20
  2709. msgid "Initial documentation of Debug::*."
  2710. msgstr ""
  2711. #. type: Content of: <refentry><refentryinfo><author><email>
  2712. #: apt.conf.5.xml:21
  2713. msgid "dburrows@debian.org"
  2714. msgstr ""
  2715. #. type: Content of: <refentry><refmeta><manvolnum>
  2716. #: apt.conf.5.xml:31 apt_preferences.5.xml:25 sources.list.5.xml:26
  2717. msgid "5"
  2718. msgstr ""
  2719. #. type: Content of: <refentry><refnamediv><refpurpose>
  2720. #: apt.conf.5.xml:38
  2721. msgid "Configuration file for APT"
  2722. msgstr ""
  2723. #. type: Content of: <refentry><refsect1><para>
  2724. #: apt.conf.5.xml:42
  2725. msgid ""
  2726. "<filename>apt.conf</filename> is the main configuration file for the APT "
  2727. "suite of tools, but by far not the only place changes to options can be "
  2728. "made. All tools therefore share the configuration files and also use a "
  2729. "common command line parser to provide a uniform environment."
  2730. msgstr ""
  2731. #. type: Content of: <refentry><refsect1><orderedlist><para>
  2732. #: apt.conf.5.xml:47
  2733. msgid ""
  2734. "When an APT tool starts up it will read the configuration files in the "
  2735. "following order:"
  2736. msgstr ""
  2737. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  2738. #: apt.conf.5.xml:49
  2739. msgid ""
  2740. "the file specified by the <envar>APT_CONFIG</envar> environment variable (if "
  2741. "any)"
  2742. msgstr ""
  2743. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  2744. #: apt.conf.5.xml:51
  2745. msgid ""
  2746. "all files in <literal>Dir::Etc::Parts</literal> in alphanumeric ascending "
  2747. "order which have either no or \"<literal>conf</literal>\" as filename "
  2748. "extension and which only contain alphanumeric, hyphen (-), underscore (_) "
  2749. "and period (.) characters. Otherwise APT will print a notice that it has "
  2750. "ignored a file if the file doesn't match a pattern in the <literal>Dir::"
  2751. "Ignore-Files-Silently</literal> configuration list - in this case it will be "
  2752. "silently ignored."
  2753. msgstr ""
  2754. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  2755. #: apt.conf.5.xml:58
  2756. msgid ""
  2757. "the main configuration file specified by <literal>Dir::Etc::main</literal>"
  2758. msgstr ""
  2759. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  2760. #: apt.conf.5.xml:60
  2761. msgid ""
  2762. "the command line options are applied to override the configuration "
  2763. "directives or to load even more configuration files."
  2764. msgstr ""
  2765. #. type: Content of: <refentry><refsect1><title>
  2766. #: apt.conf.5.xml:64
  2767. msgid "Syntax"
  2768. msgstr ""
  2769. #. type: Content of: <refentry><refsect1><para>
  2770. #: apt.conf.5.xml:65
  2771. msgid ""
  2772. "The configuration file is organized in a tree with options organized into "
  2773. "functional groups. Option specification is given with a double colon "
  2774. "notation, for instance <literal>APT::Get::Assume-Yes</literal> is an option "
  2775. "within the APT tool group, for the Get tool. Options do not inherit from "
  2776. "their parent groups."
  2777. msgstr ""
  2778. #. type: Content of: <refentry><refsect1><para>
  2779. #: apt.conf.5.xml:71
  2780. msgid ""
  2781. "Syntactically the configuration language is modeled after what the ISC tools "
  2782. "such as bind and dhcp use. Lines starting with <literal>//</literal> are "
  2783. "treated as comments (ignored), as well as all text between <literal>/*</"
  2784. "literal> and <literal>*/</literal>, just like C/C++ comments. Each line is "
  2785. "of the form <literal>APT::Get::Assume-Yes \"true\";</literal>. The trailing "
  2786. "semicolon and the quotes are required. The value must be on one line, and "
  2787. "there is no kind of string concatenation. It must not include inside "
  2788. "quotes. The behavior of the backslash \"\\\" and escaped characters inside "
  2789. "a value is undefined and it should not be used. An option name may include "
  2790. "alphanumerical characters and the \"/-:._+\" characters. A new scope can be "
  2791. "opened with curly braces, like:"
  2792. msgstr ""
  2793. #. type: Content of: <refentry><refsect1><informalexample><programlisting>
  2794. #: apt.conf.5.xml:85
  2795. #, no-wrap
  2796. msgid ""
  2797. "APT {\n"
  2798. " Get {\n"
  2799. " Assume-Yes \"true\";\n"
  2800. " Fix-Broken \"true\";\n"
  2801. " };\n"
  2802. "};\n"
  2803. msgstr ""
  2804. #. type: Content of: <refentry><refsect1><para>
  2805. #: apt.conf.5.xml:93
  2806. msgid ""
  2807. "with newlines placed to make it more readable. Lists can be created by "
  2808. "opening a scope and including a single string enclosed in quotes followed by "
  2809. "a semicolon. Multiple entries can be included, each separated by a semicolon."
  2810. msgstr ""
  2811. #. type: Content of: <refentry><refsect1><informalexample><programlisting>
  2812. #: apt.conf.5.xml:98
  2813. #, no-wrap
  2814. msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n"
  2815. msgstr ""
  2816. #. type: Content of: <refentry><refsect1><para>
  2817. #: apt.conf.5.xml:101
  2818. msgid ""
  2819. "In general the sample configuration file in <filename>&docdir;examples/apt."
  2820. "conf</filename> &configureindex; is a good guide for how it should look."
  2821. msgstr ""
  2822. #. type: Content of: <refentry><refsect1><para>
  2823. #: apt.conf.5.xml:105
  2824. msgid ""
  2825. "The names of the configuration items are not case-sensitive. So in the "
  2826. "previous example you could use <literal>dpkg::pre-install-pkgs</literal>."
  2827. msgstr ""
  2828. #. type: Content of: <refentry><refsect1><para>
  2829. #: apt.conf.5.xml:108
  2830. msgid ""
  2831. "Names for the configuration items are optional if a list is defined as it "
  2832. "can be see in the <literal>DPkg::Pre-Install-Pkgs</literal> example above. "
  2833. "If you don't specify a name a new entry will simply add a new option to the "
  2834. "list. If you specify a name you can override the option as every other "
  2835. "option by reassigning a new value to the option."
  2836. msgstr ""
  2837. #. type: Content of: <refentry><refsect1><para>
  2838. #: apt.conf.5.xml:113
  2839. msgid ""
  2840. "Two specials are allowed, <literal>#include</literal> (which is deprecated "
  2841. "and not supported by alternative implementations) and <literal>#clear</"
  2842. "literal>: <literal>#include</literal> will include the given file, unless "
  2843. "the filename ends in a slash, then the whole directory is included. "
  2844. "<literal>#clear</literal> is used to erase a part of the configuration tree. "
  2845. "The specified element and all its descendants are erased. (Note that these "
  2846. "lines also need to end with a semicolon.)"
  2847. msgstr ""
  2848. #. type: Content of: <refentry><refsect1><para>
  2849. #: apt.conf.5.xml:121
  2850. msgid ""
  2851. "The #clear command is the only way to delete a list or a complete scope. "
  2852. "Reopening a scope or the ::-style described below will <emphasis>not</"
  2853. "emphasis> override previously written entries. Only options can be "
  2854. "overridden by addressing a new value to it - lists and scopes can't be "
  2855. "overridden, only cleared."
  2856. msgstr ""
  2857. #. type: Content of: <refentry><refsect1><para>
  2858. #: apt.conf.5.xml:126
  2859. msgid ""
  2860. "All of the APT tools take a -o option which allows an arbitrary "
  2861. "configuration directive to be specified on the command line. The syntax is a "
  2862. "full option name (<literal>APT::Get::Assume-Yes</literal> for instance) "
  2863. "followed by an equals sign then the new value of the option. To append a new "
  2864. "element to a list, add a trailing :: to the name of the list. (As you might "
  2865. "suspect: The scope syntax can't be used on the command line.)"
  2866. msgstr ""
  2867. #. type: Content of: <refentry><refsect1><para>
  2868. #: apt.conf.5.xml:133
  2869. msgid ""
  2870. "Note that you can use :: only for appending one item per line to a list and "
  2871. "that you should not use it in combination with the scope syntax. (The scope "
  2872. "syntax implicit insert ::) Using both syntaxes together will trigger a bug "
  2873. "which some users unfortunately depend on: An option with the unusual name "
  2874. "\"<literal>::</literal>\" which acts like every other option with a name. "
  2875. "These introduces many problems including that a user who writes multiple "
  2876. "lines in this <emphasis>wrong</emphasis> syntax in the hope to append to a "
  2877. "list will gain the opposite as only the last assignment for this option "
  2878. "\"<literal>::</literal>\" will be used. Upcoming APT versions will raise "
  2879. "errors and will stop working if they encounter this misuse, so please "
  2880. "correct such statements now as long as APT doesn't complain explicit about "
  2881. "them."
  2882. msgstr ""
  2883. #. type: Content of: <refentry><refsect1><title>
  2884. #: apt.conf.5.xml:145
  2885. msgid "The APT Group"
  2886. msgstr ""
  2887. #. type: Content of: <refentry><refsect1><para>
  2888. #: apt.conf.5.xml:146
  2889. msgid ""
  2890. "This group of options controls general APT behavior as well as holding the "
  2891. "options for all of the tools."
  2892. msgstr ""
  2893. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2894. #: apt.conf.5.xml:151
  2895. msgid ""
  2896. "System Architecture; sets the architecture to use when fetching files and "
  2897. "parsing package lists. The internal default is the architecture apt was "
  2898. "compiled for."
  2899. msgstr ""
  2900. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2901. #: apt.conf.5.xml:157
  2902. msgid ""
  2903. "All Architectures the system supports. Processors implementing the "
  2904. "<literal>amd64</literal> (also called <literal>x86-64</literal>) instruction "
  2905. "set are e.g. also able to execute binaries compiled for the <literal>i386</"
  2906. "literal> (<literal>x86</literal>) instruction set; This list is use when "
  2907. "fetching files and parsing package lists. The internal default is always the "
  2908. "native architecture (<literal>APT::Architecture</literal>) and all foreign "
  2909. "architectures it can retrieve by calling <command>dpkg --print-foreign-"
  2910. "architectures</command>."
  2911. msgstr ""
  2912. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2913. #: apt.conf.5.xml:167
  2914. msgid ""
  2915. "Default release to install packages from if more than one version available. "
  2916. "Contains release name, codename or release version. Examples: 'stable', "
  2917. "'testing', 'unstable', '&stable-codename;', '&testing-codename;', '4.0', "
  2918. "'5.0*'. See also &apt-preferences;."
  2919. msgstr ""
  2920. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2921. #: apt.conf.5.xml:173
  2922. msgid ""
  2923. "Ignore Held packages; This global option causes the problem resolver to "
  2924. "ignore held packages in its decision making."
  2925. msgstr ""
  2926. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2927. #: apt.conf.5.xml:178
  2928. msgid ""
  2929. "Defaults to on. When turned on the autoclean feature will remove any "
  2930. "packages which can no longer be downloaded from the cache. If turned off "
  2931. "then packages that are locally installed are also excluded from cleaning - "
  2932. "but note that APT provides no direct means to reinstall them."
  2933. msgstr ""
  2934. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2935. #: apt.conf.5.xml:185
  2936. msgid ""
  2937. "Defaults to on which will cause APT to install essential and important "
  2938. "packages as fast as possible in the install/upgrade operation. This is done "
  2939. "to limit the effect of a failing &dpkg; call: If this option is disabled APT "
  2940. "does treat an important package in the same way as an extra package: Between "
  2941. "the unpacking of the important package A and his configuration can then be "
  2942. "many other unpack or configuration calls, e.g. for package B which has no "
  2943. "relation to A, but causes the dpkg call to fail (e.g. because maintainer "
  2944. "script of package B generates an error) which results in a system state in "
  2945. "which package A is unpacked but unconfigured - each package depending on A "
  2946. "is now no longer guaranteed to work as their dependency on A is not longer "
  2947. "satisfied. The immediate configuration marker is also applied to all "
  2948. "dependencies which can generate a problem if the dependencies e.g. form a "
  2949. "circle as a dependency with the immediate flag is comparable with a Pre-"
  2950. "Dependency. So in theory it is possible that APT encounters a situation in "
  2951. "which it is unable to perform immediate configuration, errors out and refers "
  2952. "to this option so the user can deactivate the immediate configuration "
  2953. "temporarily to be able to perform an install/upgrade again. Note the use of "
  2954. "the word \"theory\" here as this problem was only encountered by now in real "
  2955. "world a few times in non-stable distribution versions and was caused by "
  2956. "wrong dependencies of the package in question or by a system in an already "
  2957. "broken state, so you should not blindly disable this option as the mentioned "
  2958. "scenario above is not the only problem immediate configuration can help to "
  2959. "prevent in the first place. Before a big operation like <literal>dist-"
  2960. "upgrade</literal> is run with this option disabled it should be tried to "
  2961. "explicitly <literal>install</literal> the package APT is unable to configure "
  2962. "immediately, but please make sure to report your problem also to your "
  2963. "distribution and to the APT team with the buglink below so they can work on "
  2964. "improving or correcting the upgrade process."
  2965. msgstr ""
  2966. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2967. #: apt.conf.5.xml:208
  2968. msgid ""
  2969. "Never Enable this option unless you -really- know what you are doing. It "
  2970. "permits APT to temporarily remove an essential package to break a Conflicts/"
  2971. "Conflicts or Conflicts/Pre-Depend loop between two essential packages. SUCH "
  2972. "A LOOP SHOULD NEVER EXIST AND IS A GRAVE BUG. This option will work if the "
  2973. "essential packages are not tar, gzip, libc, dpkg, bash or anything that "
  2974. "those packages depend on."
  2975. msgstr ""
  2976. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2977. #: apt.conf.5.xml:217
  2978. msgid ""
  2979. "APT uses since version 0.7.26 a resizable memory mapped cache file to store "
  2980. "the 'available' information. <literal>Cache-Start</literal> acts as a hint "
  2981. "to which size the Cache will grow and is therefore the amount of memory APT "
  2982. "will request at startup. The default value is 20971520 bytes (~20 MB). Note "
  2983. "that this amount of space needs to be available for APT otherwise it will "
  2984. "likely fail ungracefully, so for memory restricted devices this value should "
  2985. "be lowered while on systems with a lot of configured sources it should be "
  2986. "increased. <literal>Cache-Grow</literal> defines in bytes with the default "
  2987. "of 1048576 (~1 MB) how much the Cache size will be increased in the event "
  2988. "the space defined by <literal>Cache-Start</literal> is not enough. These "
  2989. "value will be applied again and again until either the cache is big enough "
  2990. "to store all information or the size of the cache reaches the <literal>Cache-"
  2991. "Limit</literal>. The default of <literal>Cache-Limit</literal> is 0 which "
  2992. "stands for no limit. If <literal>Cache-Grow</literal> is set to 0 the "
  2993. "automatic grow of the cache is disabled."
  2994. msgstr ""
  2995. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2996. #: apt.conf.5.xml:233
  2997. msgid "Defines which package(s) are considered essential build dependencies."
  2998. msgstr ""
  2999. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3000. #: apt.conf.5.xml:237
  3001. msgid ""
  3002. "The Get subsection controls the &apt-get; tool, please see its documentation "
  3003. "for more information about the options here."
  3004. msgstr ""
  3005. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3006. #: apt.conf.5.xml:242
  3007. msgid ""
  3008. "The Cache subsection controls the &apt-cache; tool, please see its "
  3009. "documentation for more information about the options here."
  3010. msgstr ""
  3011. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3012. #: apt.conf.5.xml:247
  3013. msgid ""
  3014. "The CDROM subsection controls the &apt-cdrom; tool, please see its "
  3015. "documentation for more information about the options here."
  3016. msgstr ""
  3017. #. type: Content of: <refentry><refsect1><title>
  3018. #: apt.conf.5.xml:253
  3019. msgid "The Acquire Group"
  3020. msgstr ""
  3021. #. type: Content of: <refentry><refsect1><para>
  3022. #: apt.conf.5.xml:254
  3023. msgid ""
  3024. "The <literal>Acquire</literal> group of options controls the download of "
  3025. "packages and the URI handlers."
  3026. msgstr ""
  3027. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3028. #: apt.conf.5.xml:259
  3029. msgid ""
  3030. "Security related option defaulting to true as an expiring validation for a "
  3031. "Release file prevents longtime replay attacks and can e.g. also help users "
  3032. "to identify no longer updated mirrors - but the feature depends on the "
  3033. "correctness of the time on the user system. Archive maintainers are "
  3034. "encouraged to create Release files with the <literal>Valid-Until</literal> "
  3035. "header, but if they don't or a stricter value is volitional the following "
  3036. "<literal>Max-ValidTime</literal> option can be used."
  3037. msgstr ""
  3038. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3039. #: apt.conf.5.xml:270
  3040. msgid ""
  3041. "Seconds the Release file should be considered valid after it was created "
  3042. "(indicated by the <literal>Date</literal> header). If the Release file "
  3043. "itself includes a <literal>Valid-Until</literal> header the earlier date of "
  3044. "the two is used as the expiration date. The default value is <literal>0</"
  3045. "literal> which stands for \"for ever valid\". Archive specific settings can "
  3046. "be made by appending the label of the archive to the option name."
  3047. msgstr ""
  3048. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3049. #: apt.conf.5.xml:281
  3050. msgid ""
  3051. "Minimum of seconds the Release file should be considered valid after it was "
  3052. "created (indicated by the <literal>Date</literal> header). Use this if you "
  3053. "need to use a seldomly updated (local) mirror of a more regular updated "
  3054. "archive with a <literal>Valid-Until</literal> header instead of completely "
  3055. "disabling the expiration date checking. Archive specific settings can and "
  3056. "should be used by appending the label of the archive to the option name."
  3057. msgstr ""
  3058. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3059. #: apt.conf.5.xml:292
  3060. msgid ""
  3061. "Try to download deltas called <literal>PDiffs</literal> for Packages or "
  3062. "Sources files instead of downloading whole ones. True by default."
  3063. msgstr ""
  3064. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3065. #: apt.conf.5.xml:295
  3066. msgid ""
  3067. "Two sub-options to limit the use of PDiffs are also available: With "
  3068. "<literal>FileLimit</literal> can be specified how many PDiff files are "
  3069. "downloaded at most to update a file. <literal>SizeLimit</literal> on the "
  3070. "other hand is the maximum percentage of the size of all patches compared to "
  3071. "the size of the targeted file. If one of these limits is exceeded the "
  3072. "complete file is downloaded instead of the patches."
  3073. msgstr ""
  3074. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3075. #: apt.conf.5.xml:305
  3076. msgid ""
  3077. "Queuing mode; <literal>Queue-Mode</literal> can be one of <literal>host</"
  3078. "literal> or <literal>access</literal> which determines how APT parallelizes "
  3079. "outgoing connections. <literal>host</literal> means that one connection per "
  3080. "target host will be opened, <literal>access</literal> means that one "
  3081. "connection per URI type will be opened."
  3082. msgstr ""
  3083. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3084. #: apt.conf.5.xml:313
  3085. msgid ""
  3086. "Number of retries to perform. If this is non-zero APT will retry failed "
  3087. "files the given number of times."
  3088. msgstr ""
  3089. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3090. #: apt.conf.5.xml:318
  3091. msgid ""
  3092. "Use symlinks for source archives. If set to true then source archives will "
  3093. "be symlinked when possible instead of copying. True is the default."
  3094. msgstr ""
  3095. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3096. #: apt.conf.5.xml:323
  3097. msgid ""
  3098. "HTTP URIs; http::Proxy is the default http proxy to use. It is in the "
  3099. "standard form of <literal>http://[[user][:pass]@]host[:port]/</literal>. Per "
  3100. "host proxies can also be specified by using the form <literal>http::Proxy::"
  3101. "&lt;host&gt;</literal> with the special keyword <literal>DIRECT</literal> "
  3102. "meaning to use no proxies. If no one of the above settings is specified, "
  3103. "<envar>http_proxy</envar> environment variable will be used."
  3104. msgstr ""
  3105. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3106. #: apt.conf.5.xml:331
  3107. msgid ""
  3108. "Three settings are provided for cache control with HTTP/1.1 compliant proxy "
  3109. "caches. <literal>No-Cache</literal> tells the proxy to not use its cached "
  3110. "response under any circumstances, <literal>Max-Age</literal> is sent only "
  3111. "for index files and tells the cache to refresh its object if it is older "
  3112. "than the given number of seconds. Debian updates its index files daily so "
  3113. "the default is 1 day. <literal>No-Store</literal> specifies that the cache "
  3114. "should never store this request, it is only set for archive files. This may "
  3115. "be useful to prevent polluting a proxy cache with very large .deb files. "
  3116. "Note: Squid 2.0.2 does not support any of these options."
  3117. msgstr ""
  3118. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3119. #: apt.conf.5.xml:341 apt.conf.5.xml:407
  3120. msgid ""
  3121. "The option <literal>timeout</literal> sets the timeout timer used by the "
  3122. "method, this applies to all things including connection timeout and data "
  3123. "timeout."
  3124. msgstr ""
  3125. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3126. #: apt.conf.5.xml:344
  3127. msgid ""
  3128. "The setting <literal>Acquire::http::Pipeline-Depth</literal> can be used to "
  3129. "enabled HTTP pipeling (RFC 2616 section 8.1.2.2) which can be beneficial e."
  3130. "g. on high-latency connections. It specifies how many requests are send in a "
  3131. "pipeline. Previous APT versions had a default of 10 for this setting, but "
  3132. "the default value is now 0 (= disabled) to avoid problems with the ever-"
  3133. "growing amount of webservers and proxies which choose to not conform to the "
  3134. "HTTP/1.1 specification."
  3135. msgstr ""
  3136. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3137. #: apt.conf.5.xml:351
  3138. msgid ""
  3139. "<literal>Acquire::http::AllowRedirect</literal> controls if APT will follow "
  3140. "redirects, which is enabled by default."
  3141. msgstr ""
  3142. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3143. #: apt.conf.5.xml:354
  3144. msgid ""
  3145. "The used bandwidth can be limited with <literal>Acquire::http::Dl-Limit</"
  3146. "literal> which accepts integer values in kilobyte. The default value is 0 "
  3147. "which deactivates the limit and tries uses as much as possible of the "
  3148. "bandwidth (Note that this option implicit deactivates the download from "
  3149. "multiple servers at the same time.)"
  3150. msgstr ""
  3151. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3152. #: apt.conf.5.xml:359
  3153. msgid ""
  3154. "<literal>Acquire::http::User-Agent</literal> can be used to set a different "
  3155. "User-Agent for the http download method as some proxies allow access for "
  3156. "clients only if the client uses a known identifier."
  3157. msgstr ""
  3158. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3159. #: apt.conf.5.xml:366
  3160. msgid ""
  3161. "HTTPS URIs. Cache-control, Timeout, AllowRedirect, Dl-Limit and proxy "
  3162. "options are the same as for <literal>http</literal> method and will also "
  3163. "default to the options from the <literal>http</literal> method if they are "
  3164. "not explicitly set for https. <literal>Pipeline-Depth</literal> option is "
  3165. "not supported yet."
  3166. msgstr ""
  3167. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3168. #: apt.conf.5.xml:372
  3169. msgid ""
  3170. "<literal>CaInfo</literal> suboption specifies place of file that holds info "
  3171. "about trusted certificates. <literal>&lt;host&gt;::CaInfo</literal> is "
  3172. "corresponding per-host option. <literal>Verify-Peer</literal> boolean "
  3173. "suboption determines whether verify server's host certificate against "
  3174. "trusted certificates or not. <literal>&lt;host&gt;::Verify-Peer</literal> "
  3175. "is corresponding per-host option. <literal>Verify-Host</literal> boolean "
  3176. "suboption determines whether verify server's hostname or not. <literal>&lt;"
  3177. "host&gt;::Verify-Host</literal> is corresponding per-host option. "
  3178. "<literal>SslCert</literal> determines what certificate to use for client "
  3179. "authentication. <literal>&lt;host&gt;::SslCert</literal> is corresponding "
  3180. "per-host option. <literal>SslKey</literal> determines what private key to "
  3181. "use for client authentication. <literal>&lt;host&gt;::SslKey</literal> is "
  3182. "corresponding per-host option. <literal>SslForceVersion</literal> overrides "
  3183. "default SSL version to use. Can contain 'TLSv1' or 'SSLv3' string. "
  3184. "<literal>&lt;host&gt;::SslForceVersion</literal> is corresponding per-host "
  3185. "option."
  3186. msgstr ""
  3187. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3188. #: apt.conf.5.xml:391
  3189. msgid ""
  3190. "FTP URIs; ftp::Proxy is the default ftp proxy to use. It is in the standard "
  3191. "form of <literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per host "
  3192. "proxies can also be specified by using the form <literal>ftp::Proxy::&lt;"
  3193. "host&gt;</literal> with the special keyword <literal>DIRECT</literal> "
  3194. "meaning to use no proxies. If no one of the above settings is specified, "
  3195. "<envar>ftp_proxy</envar> environment variable will be used. To use a ftp "
  3196. "proxy you will have to set the <literal>ftp::ProxyLogin</literal> script in "
  3197. "the configuration file. This entry specifies the commands to send to tell "
  3198. "the proxy server what to connect to. Please see &configureindex; for an "
  3199. "example of how to do this. The substitution variables available are <literal>"
  3200. "$(PROXY_USER)</literal> <literal>$(PROXY_PASS)</literal> <literal>"
  3201. "$(SITE_USER)</literal> <literal>$(SITE_PASS)</literal> <literal>$(SITE)</"
  3202. "literal> and <literal>$(SITE_PORT)</literal> Each is taken from it's "
  3203. "respective URI component."
  3204. msgstr ""
  3205. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3206. #: apt.conf.5.xml:410
  3207. msgid ""
  3208. "Several settings are provided to control passive mode. Generally it is safe "
  3209. "to leave passive mode on, it works in nearly every environment. However "
  3210. "some situations require that passive mode be disabled and port mode ftp used "
  3211. "instead. This can be done globally, for connections that go through a proxy "
  3212. "or for a specific host (See the sample config file for examples)."
  3213. msgstr ""
  3214. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3215. #: apt.conf.5.xml:417
  3216. msgid ""
  3217. "It is possible to proxy FTP over HTTP by setting the <envar>ftp_proxy</"
  3218. "envar> environment variable to a http url - see the discussion of the http "
  3219. "method above for syntax. You cannot set this in the configuration file and "
  3220. "it is not recommended to use FTP over HTTP due to its low efficiency."
  3221. msgstr ""
  3222. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3223. #: apt.conf.5.xml:422
  3224. msgid ""
  3225. "The setting <literal>ForceExtended</literal> controls the use of RFC2428 "
  3226. "<literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is "
  3227. "false, which means these commands are only used if the control connection is "
  3228. "IPv6. Setting this to true forces their use even on IPv4 connections. Note "
  3229. "that most FTP servers do not support RFC2428."
  3230. msgstr ""
  3231. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout>
  3232. #: apt.conf.5.xml:435
  3233. #, no-wrap
  3234. msgid "/cdrom/::Mount \"foo\";"
  3235. msgstr ""
  3236. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3237. #: apt.conf.5.xml:430
  3238. msgid ""
  3239. "CD-ROM URIs; the only setting for CD-ROM URIs is the mount point, "
  3240. "<literal>cdrom::Mount</literal> which must be the mount point for the CD-ROM "
  3241. "drive as specified in <filename>/etc/fstab</filename>. It is possible to "
  3242. "provide alternate mount and unmount commands if your mount point cannot be "
  3243. "listed in the fstab (such as an SMB mount and old mount packages). The "
  3244. "syntax is to put <placeholder type=\"literallayout\" id=\"0\"/> within the "
  3245. "cdrom block. It is important to have the trailing slash. Unmount commands "
  3246. "can be specified using UMount."
  3247. msgstr ""
  3248. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3249. #: apt.conf.5.xml:441
  3250. msgid ""
  3251. "GPGV URIs; the only option for GPGV URIs is the option to pass additional "
  3252. "parameters to gpgv. <literal>gpgv::Options</literal> Additional options "
  3253. "passed to gpgv."
  3254. msgstr ""
  3255. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  3256. #: apt.conf.5.xml:452
  3257. #, no-wrap
  3258. msgid "Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> \"<replaceable>Methodname</replaceable>\";"
  3259. msgstr ""
  3260. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3261. #: apt.conf.5.xml:447
  3262. msgid ""
  3263. "List of compression types which are understood by the acquire methods. "
  3264. "Files like <filename>Packages</filename> can be available in various "
  3265. "compression formats. Per default the acquire methods can decompress "
  3266. "<command>bzip2</command>, <command>lzma</command> and <command>gzip</"
  3267. "command> compressed files, with this setting more formats can be added on "
  3268. "the fly or the used method can be changed. The syntax for this is: "
  3269. "<placeholder type=\"synopsis\" id=\"0\"/>"
  3270. msgstr ""
  3271. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  3272. #: apt.conf.5.xml:457
  3273. #, no-wrap
  3274. msgid "Acquire::CompressionTypes::Order:: \"gz\";"
  3275. msgstr ""
  3276. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  3277. #: apt.conf.5.xml:460
  3278. #, no-wrap
  3279. msgid "Acquire::CompressionTypes::Order { \"lzma\"; \"gz\"; };"
  3280. msgstr ""
  3281. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3282. #: apt.conf.5.xml:453
  3283. msgid ""
  3284. "Also the <literal>Order</literal> subgroup can be used to define in which "
  3285. "order the acquire system will try to download the compressed files. The "
  3286. "acquire system will try the first and proceed with the next compression type "
  3287. "in this list on error, so to prefer one over the other type simple add the "
  3288. "preferred type at first - not already added default types will be added at "
  3289. "run time to the end of the list, so e.g. <placeholder type=\"synopsis\" id="
  3290. "\"0\"/> can be used to prefer <command>gzip</command> compressed files over "
  3291. "<command>bzip2</command> and <command>lzma</command>. If <command>lzma</"
  3292. "command> should be preferred over <command>gzip</command> and "
  3293. "<command>bzip2</command> the configure setting should look like this "
  3294. "<placeholder type=\"synopsis\" id=\"1\"/> It is not needed to add "
  3295. "<literal>bz2</literal> explicit to the list as it will be added automatic."
  3296. msgstr ""
  3297. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout>
  3298. #: apt.conf.5.xml:464
  3299. #, no-wrap
  3300. msgid "Dir::Bin::bzip2 \"/bin/bzip2\";"
  3301. msgstr ""
  3302. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3303. #: apt.conf.5.xml:462
  3304. msgid ""
  3305. "Note that at run time the <literal>Dir::Bin::<replaceable>Methodname</"
  3306. "replaceable></literal> will be checked: If this setting exists the method "
  3307. "will only be used if this file exists, e.g. for the bzip2 method (the "
  3308. "inbuilt) setting is: <placeholder type=\"literallayout\" id=\"0\"/> Note "
  3309. "also that list entries specified on the command line will be added at the "
  3310. "end of the list specified in the configuration files, but before the default "
  3311. "entries. To prefer a type in this case over the ones specified in the "
  3312. "configuration files you can set the option direct - not in list style. This "
  3313. "will not override the defined list, it will only prefix the list with this "
  3314. "type."
  3315. msgstr ""
  3316. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3317. #: apt.conf.5.xml:469
  3318. msgid ""
  3319. "The special type <literal>uncompressed</literal> can be used to give "
  3320. "uncompressed files a preference, but note that most archives don't provide "
  3321. "uncompressed files so this is mostly only useable for local mirrors."
  3322. msgstr ""
  3323. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3324. #: apt.conf.5.xml:476
  3325. msgid ""
  3326. "When downloading <literal>gzip</literal> compressed indexes (Packages, "
  3327. "Sources, or Translations), keep them gzip compressed locally instead of "
  3328. "unpacking them. This saves quite a lot of disk space at the expense of more "
  3329. "CPU requirements when building the local package caches. False by default."
  3330. msgstr ""
  3331. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3332. #: apt.conf.5.xml:484
  3333. msgid ""
  3334. "The Languages subsection controls which <filename>Translation</filename> "
  3335. "files are downloaded and in which order APT tries to display the Description-"
  3336. "Translations. APT will try to display the first available Description in the "
  3337. "Language which is listed at first. Languages can be defined with their short "
  3338. "or long Languagecodes. Note that not all archives provide "
  3339. "<filename>Translation</filename> files for every Language - especially the "
  3340. "long Languagecodes are rare, so please inform you which ones are available "
  3341. "before you set here impossible values."
  3342. msgstr ""
  3343. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><programlisting>
  3344. #: apt.conf.5.xml:500
  3345. #, no-wrap
  3346. msgid "Acquire::Languages { \"environment\"; \"de\"; \"en\"; \"none\"; \"fr\"; };"
  3347. msgstr ""
  3348. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3349. #: apt.conf.5.xml:490
  3350. msgid ""
  3351. "The default list includes \"environment\" and \"en\". "
  3352. "\"<literal>environment</literal>\" has a special meaning here: It will be "
  3353. "replaced at runtime with the languagecodes extracted from the "
  3354. "<literal>LC_MESSAGES</literal> environment variable. It will also ensure "
  3355. "that these codes are not included twice in the list. If "
  3356. "<literal>LC_MESSAGES</literal> is set to \"C\" only the "
  3357. "<filename>Translation-en</filename> file (if available) will be used. To "
  3358. "force apt to use no Translation file use the setting <literal>Acquire::"
  3359. "Languages=none</literal>. \"<literal>none</literal>\" is another special "
  3360. "meaning code which will stop the search for a fitting <filename>Translation</"
  3361. "filename> file. This can be used by the system administrator to let APT "
  3362. "know that it should download also this files without actually use them if "
  3363. "the environment doesn't specify this languages. So the following example "
  3364. "configuration will result in the order \"en, de\" in an english and in \"de, "
  3365. "en\" in a german localization. Note that \"fr\" is downloaded, but not used "
  3366. "if APT is not used in a french localization, in such an environment the "
  3367. "order would be \"fr, de, en\". <placeholder type=\"programlisting\" id="
  3368. "\"0\"/>"
  3369. msgstr ""
  3370. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3371. #: apt.conf.5.xml:501
  3372. msgid ""
  3373. "Note: To prevent problems resulting from APT being executed in different "
  3374. "environments (e.g. by different users or by other programs) all Translation "
  3375. "files which are found in <filename>/var/lib/apt/lists/</filename> will be "
  3376. "added to the end of the list (after an implicit \"<literal>none</literal>\")."
  3377. msgstr ""
  3378. #. type: Content of: <refentry><refsect1><title>
  3379. #: apt.conf.5.xml:512
  3380. msgid "Directories"
  3381. msgstr ""
  3382. #. type: Content of: <refentry><refsect1><para>
  3383. #: apt.conf.5.xml:514
  3384. msgid ""
  3385. "The <literal>Dir::State</literal> section has directories that pertain to "
  3386. "local state information. <literal>lists</literal> is the directory to place "
  3387. "downloaded package lists in and <literal>status</literal> is the name of the "
  3388. "dpkg status file. <literal>preferences</literal> is the name of the APT "
  3389. "<filename>preferences</filename> file. <literal>Dir::State</literal> "
  3390. "contains the default directory to prefix on all sub items if they do not "
  3391. "start with <filename>/</filename> or <filename>./</filename>."
  3392. msgstr ""
  3393. #. type: Content of: <refentry><refsect1><para>
  3394. #: apt.conf.5.xml:521
  3395. msgid ""
  3396. "<literal>Dir::Cache</literal> contains locations pertaining to local cache "
  3397. "information, such as the two package caches <literal>srcpkgcache</literal> "
  3398. "and <literal>pkgcache</literal> as well as the location to place downloaded "
  3399. "archives, <literal>Dir::Cache::archives</literal>. Generation of caches can "
  3400. "be turned off by setting their names to be blank. This will slow down "
  3401. "startup but save disk space. It is probably preferred to turn off the "
  3402. "pkgcache rather than the srcpkgcache. Like <literal>Dir::State</literal> the "
  3403. "default directory is contained in <literal>Dir::Cache</literal>"
  3404. msgstr ""
  3405. #. type: Content of: <refentry><refsect1><para>
  3406. #: apt.conf.5.xml:530
  3407. msgid ""
  3408. "<literal>Dir::Etc</literal> contains the location of configuration files, "
  3409. "<literal>sourcelist</literal> gives the location of the sourcelist and "
  3410. "<literal>main</literal> is the default configuration file (setting has no "
  3411. "effect, unless it is done from the config file specified by "
  3412. "<envar>APT_CONFIG</envar>)."
  3413. msgstr ""
  3414. #. type: Content of: <refentry><refsect1><para>
  3415. #: apt.conf.5.xml:536
  3416. msgid ""
  3417. "The <literal>Dir::Parts</literal> setting reads in all the config fragments "
  3418. "in lexical order from the directory specified. After this is done then the "
  3419. "main config file is loaded."
  3420. msgstr ""
  3421. #. type: Content of: <refentry><refsect1><para>
  3422. #: apt.conf.5.xml:540
  3423. msgid ""
  3424. "Binary programs are pointed to by <literal>Dir::Bin</literal>. <literal>Dir::"
  3425. "Bin::Methods</literal> specifies the location of the method handlers and "
  3426. "<literal>gzip</literal>, <literal>bzip2</literal>, <literal>lzma</literal>, "
  3427. "<literal>dpkg</literal>, <literal>apt-get</literal> <literal>dpkg-source</"
  3428. "literal> <literal>dpkg-buildpackage</literal> and <literal>apt-cache</"
  3429. "literal> specify the location of the respective programs."
  3430. msgstr ""
  3431. #. type: Content of: <refentry><refsect1><para>
  3432. #: apt.conf.5.xml:548
  3433. msgid ""
  3434. "The configuration item <literal>RootDir</literal> has a special meaning. If "
  3435. "set, all paths in <literal>Dir::</literal> will be relative to "
  3436. "<literal>RootDir</literal>, <emphasis>even paths that are specified "
  3437. "absolutely</emphasis>. So, for instance, if <literal>RootDir</literal> is "
  3438. "set to <filename>/tmp/staging</filename> and <literal>Dir::State::status</"
  3439. "literal> is set to <filename>/var/lib/dpkg/status</filename>, then the "
  3440. "status file will be looked up in <filename>/tmp/staging/var/lib/dpkg/status</"
  3441. "filename>."
  3442. msgstr ""
  3443. #. type: Content of: <refentry><refsect1><para>
  3444. #: apt.conf.5.xml:561
  3445. msgid ""
  3446. "The <literal>Ignore-Files-Silently</literal> list can be used to specify "
  3447. "which files APT should silently ignore while parsing the files in the "
  3448. "fragment directories. Per default a file which end with <literal>.disabled</"
  3449. "literal>, <literal>~</literal>, <literal>.bak</literal> or <literal>.dpkg-[a-"
  3450. "z]+</literal> is silently ignored. As seen in the last default value these "
  3451. "patterns can use regular expression syntax."
  3452. msgstr ""
  3453. #. type: Content of: <refentry><refsect1><title>
  3454. #: apt.conf.5.xml:570
  3455. #, fuzzy
  3456. msgid "APT in DSelect"
  3457. msgstr "DSelect"
  3458. #. type: Content of: <refentry><refsect1><para>
  3459. #: apt.conf.5.xml:572
  3460. msgid ""
  3461. "When APT is used as a &dselect; method several configuration directives "
  3462. "control the default behaviour. These are in the <literal>DSelect</literal> "
  3463. "section."
  3464. msgstr ""
  3465. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3466. #: apt.conf.5.xml:577
  3467. msgid ""
  3468. "Cache Clean mode; this value may be one of always, prompt, auto, pre-auto "
  3469. "and never. always and prompt will remove all packages from the cache after "
  3470. "upgrading, prompt (the default) does so conditionally. auto removes only "
  3471. "those packages which are no longer downloadable (replaced with a new version "
  3472. "for instance). pre-auto performs this action before downloading new "
  3473. "packages."
  3474. msgstr ""
  3475. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3476. #: apt.conf.5.xml:586
  3477. msgid ""
  3478. "The contents of this variable is passed to &apt-get; as command line options "
  3479. "when it is run for the install phase."
  3480. msgstr ""
  3481. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3482. #: apt.conf.5.xml:591
  3483. msgid ""
  3484. "The contents of this variable is passed to &apt-get; as command line options "
  3485. "when it is run for the update phase."
  3486. msgstr ""
  3487. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3488. #: apt.conf.5.xml:596
  3489. msgid ""
  3490. "If true the [U]pdate operation in &dselect; will always prompt to continue. "
  3491. "The default is to prompt only on error."
  3492. msgstr ""
  3493. #. type: Content of: <refentry><refsect1><title>
  3494. #: apt.conf.5.xml:602
  3495. msgid "How APT calls dpkg"
  3496. msgstr ""
  3497. #. type: Content of: <refentry><refsect1><para>
  3498. #: apt.conf.5.xml:603
  3499. msgid ""
  3500. "Several configuration directives control how APT invokes &dpkg;. These are "
  3501. "in the <literal>DPkg</literal> section."
  3502. msgstr ""
  3503. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3504. #: apt.conf.5.xml:608
  3505. msgid ""
  3506. "This is a list of options to pass to dpkg. The options must be specified "
  3507. "using the list notation and each list item is passed as a single argument to "
  3508. "&dpkg;."
  3509. msgstr ""
  3510. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3511. #: apt.conf.5.xml:614
  3512. msgid ""
  3513. "This is a list of shell commands to run before/after invoking &dpkg;. Like "
  3514. "<literal>options</literal> this must be specified in list notation. The "
  3515. "commands are invoked in order using <filename>/bin/sh</filename>, should any "
  3516. "fail APT will abort."
  3517. msgstr ""
  3518. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3519. #: apt.conf.5.xml:621
  3520. msgid ""
  3521. "This is a list of shell commands to run before invoking dpkg. Like "
  3522. "<literal>options</literal> this must be specified in list notation. The "
  3523. "commands are invoked in order using <filename>/bin/sh</filename>, should any "
  3524. "fail APT will abort. APT will pass to the commands on standard input the "
  3525. "filenames of all .deb files it is going to install, one per line."
  3526. msgstr ""
  3527. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3528. #: apt.conf.5.xml:627
  3529. msgid ""
  3530. "Version 2 of this protocol dumps more information, including the protocol "
  3531. "version, the APT configuration space and the packages, files and versions "
  3532. "being changed. Version 2 is enabled by setting <literal>DPkg::Tools::"
  3533. "options::cmd::Version</literal> to 2. <literal>cmd</literal> is a command "
  3534. "given to <literal>Pre-Install-Pkgs</literal>."
  3535. msgstr ""
  3536. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3537. #: apt.conf.5.xml:635
  3538. msgid ""
  3539. "APT chdirs to this directory before invoking dpkg, the default is <filename>/"
  3540. "</filename>."
  3541. msgstr ""
  3542. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3543. #: apt.conf.5.xml:640
  3544. msgid ""
  3545. "These options are passed to &dpkg-buildpackage; when compiling packages, the "
  3546. "default is to disable signing and produce all binaries."
  3547. msgstr ""
  3548. #. type: Content of: <refentry><refsect1><refsect2><title>
  3549. #: apt.conf.5.xml:645
  3550. msgid "dpkg trigger usage (and related options)"
  3551. msgstr ""
  3552. #. type: Content of: <refentry><refsect1><refsect2><para>
  3553. #: apt.conf.5.xml:646
  3554. msgid ""
  3555. "APT can call dpkg in a way so it can make aggressive use of triggers over "
  3556. "multiple calls of dpkg. Without further options dpkg will use triggers only "
  3557. "in between his own run. Activating these options can therefore decrease the "
  3558. "time needed to perform the install / upgrade. Note that it is intended to "
  3559. "activate these options per default in the future, but as it changes the way "
  3560. "APT calling dpkg drastically it needs a lot more testing. <emphasis>These "
  3561. "options are therefore currently experimental and should not be used in "
  3562. "productive environments.</emphasis> Also it breaks the progress reporting so "
  3563. "all frontends will currently stay around half (or more) of the time in the "
  3564. "100% state while it actually configures all packages."
  3565. msgstr ""
  3566. #. type: Content of: <refentry><refsect1><refsect2><para><literallayout>
  3567. #: apt.conf.5.xml:661
  3568. #, no-wrap
  3569. msgid ""
  3570. "DPkg::NoTriggers \"true\";\n"
  3571. "PackageManager::Configure \"smart\";\n"
  3572. "DPkg::ConfigurePending \"true\";\n"
  3573. "DPkg::TriggersPending \"true\";"
  3574. msgstr ""
  3575. #. type: Content of: <refentry><refsect1><refsect2><para>
  3576. #: apt.conf.5.xml:655
  3577. msgid ""
  3578. "Note that it is not guaranteed that APT will support these options or that "
  3579. "these options will not cause (big) trouble in the future. If you have "
  3580. "understand the current risks and problems with these options, but are brave "
  3581. "enough to help testing them create a new configuration file and test a "
  3582. "combination of options. Please report any bugs, problems and improvements "
  3583. "you encounter and make sure to note which options you have used in your "
  3584. "reports. Asking dpkg for help could also be useful for debugging proposes, "
  3585. "see e.g. <command>dpkg --audit</command>. A defensive option combination "
  3586. "would be <placeholder type=\"literallayout\" id=\"0\"/>"
  3587. msgstr ""
  3588. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  3589. #: apt.conf.5.xml:668
  3590. msgid ""
  3591. "Add the no triggers flag to all dpkg calls (except the ConfigurePending "
  3592. "call). See &dpkg; if you are interested in what this actually means. In "
  3593. "short: dpkg will not run the triggers when this flag is present unless it is "
  3594. "explicitly called to do so in an extra call. Note that this option exists "
  3595. "(undocumented) also in older apt versions with a slightly different meaning: "
  3596. "Previously these option only append --no-triggers to the configure calls to "
  3597. "dpkg - now apt will add these flag also to the unpack and remove calls."
  3598. msgstr ""
  3599. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  3600. #: apt.conf.5.xml:676
  3601. msgid ""
  3602. "Valid values are \"<literal>all</literal>\", \"<literal>smart</literal>\" "
  3603. "and \"<literal>no</literal>\". \"<literal>all</literal>\" is the default "
  3604. "value and causes APT to configure all packages explicit. The "
  3605. "\"<literal>smart</literal>\" way is it to configure only packages which need "
  3606. "to be configured before another package can be unpacked (Pre-Depends) and "
  3607. "let the rest configure by dpkg with a call generated by the next option. "
  3608. "\"<literal>no</literal>\" on the other hand will not configure anything and "
  3609. "totally rely on dpkg for configuration (which will at the moment fail if a "
  3610. "Pre-Depends is encountered). Setting this option to another than the all "
  3611. "value will implicitly activate also the next option per default as otherwise "
  3612. "the system could end in an unconfigured status which could be unbootable!"
  3613. msgstr ""
  3614. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  3615. #: apt.conf.5.xml:687
  3616. msgid ""
  3617. "If this option is set apt will call <command>dpkg --configure --pending</"
  3618. "command> to let dpkg handle all required configurations and triggers. This "
  3619. "option is activated automatic per default if the previous option is not set "
  3620. "to <literal>all</literal>, but deactivating could be useful if you want to "
  3621. "run APT multiple times in a row - e.g. in an installer. In these sceneries "
  3622. "you could deactivate this option in all but the last run."
  3623. msgstr ""
  3624. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  3625. #: apt.conf.5.xml:694
  3626. msgid ""
  3627. "Useful for <literal>smart</literal> configuration as a package which has "
  3628. "pending triggers is not considered as <literal>installed</literal> and dpkg "
  3629. "treats them as <literal>unpacked</literal> currently which is a dealbreaker "
  3630. "for Pre-Dependencies (see debbugs #526774). Note that this will process all "
  3631. "triggers, not only the triggers needed to configure this package."
  3632. msgstr ""
  3633. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  3634. #: apt.conf.5.xml:700
  3635. msgid ""
  3636. "As the configuration can be deferred to be done at the end by dpkg it can be "
  3637. "tried to order the unpack series only by critical needs, e.g. by Pre-"
  3638. "Depends. Default is true and therefore the \"old\" method of ordering in "
  3639. "various steps by everything. While both method were present in earlier APT "
  3640. "versions the <literal>OrderCritical</literal> method was unused, so this "
  3641. "method is very experimental and needs further improvements before becoming "
  3642. "really useful."
  3643. msgstr ""
  3644. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para><literallayout>
  3645. #: apt.conf.5.xml:715
  3646. #, no-wrap
  3647. msgid ""
  3648. "OrderList::Score {\n"
  3649. "\tDelete 500;\n"
  3650. "\tEssential 200;\n"
  3651. "\tImmediate 10;\n"
  3652. "\tPreDepends 50;\n"
  3653. "};"
  3654. msgstr ""
  3655. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  3656. #: apt.conf.5.xml:708
  3657. msgid ""
  3658. "Essential packages (and there dependencies) should be configured immediately "
  3659. "after unpacking. It will be a good idea to do this quite early in the "
  3660. "upgrade process as these these configure calls require currently also "
  3661. "<literal>DPkg::TriggersPending</literal> which will run quite a few triggers "
  3662. "(which maybe not needed). Essentials get per default a high score but the "
  3663. "immediate flag is relatively low (a package which has a Pre-Depends is "
  3664. "higher rated). These option and the others in the same group can be used to "
  3665. "change the scoring. The following example shows the settings with there "
  3666. "default values. <placeholder type=\"literallayout\" id=\"0\"/>"
  3667. msgstr ""
  3668. #. type: Content of: <refentry><refsect1><title>
  3669. #: apt.conf.5.xml:728
  3670. msgid "Periodic and Archives options"
  3671. msgstr ""
  3672. #. type: Content of: <refentry><refsect1><para>
  3673. #: apt.conf.5.xml:729
  3674. msgid ""
  3675. "<literal>APT::Periodic</literal> and <literal>APT::Archives</literal> groups "
  3676. "of options configure behavior of apt periodic updates, which is done by "
  3677. "<literal>/etc/cron.daily/apt</literal> script. See header of this script for "
  3678. "the brief documentation of these options."
  3679. msgstr ""
  3680. #. type: Content of: <refentry><refsect1><title>
  3681. #: apt.conf.5.xml:737
  3682. msgid "Debug options"
  3683. msgstr ""
  3684. #. type: Content of: <refentry><refsect1><para>
  3685. #: apt.conf.5.xml:739
  3686. msgid ""
  3687. "Enabling options in the <literal>Debug::</literal> section will cause "
  3688. "debugging information to be sent to the standard error stream of the program "
  3689. "utilizing the <literal>apt</literal> libraries, or enable special program "
  3690. "modes that are primarily useful for debugging the behavior of <literal>apt</"
  3691. "literal>. Most of these options are not interesting to a normal user, but a "
  3692. "few may be:"
  3693. msgstr ""
  3694. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  3695. #: apt.conf.5.xml:750
  3696. msgid ""
  3697. "<literal>Debug::pkgProblemResolver</literal> enables output about the "
  3698. "decisions made by <literal>dist-upgrade, upgrade, install, remove, purge</"
  3699. "literal>."
  3700. msgstr ""
  3701. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  3702. #: apt.conf.5.xml:758
  3703. msgid ""
  3704. "<literal>Debug::NoLocking</literal> disables all file locking. This can be "
  3705. "used to run some operations (for instance, <literal>apt-get -s install</"
  3706. "literal>) as a non-root user."
  3707. msgstr ""
  3708. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  3709. #: apt.conf.5.xml:767
  3710. msgid ""
  3711. "<literal>Debug::pkgDPkgPM</literal> prints out the actual command line each "
  3712. "time that <literal>apt</literal> invokes &dpkg;."
  3713. msgstr ""
  3714. #. TODO: provide a
  3715. #. motivating example, except I haven't a clue why you'd want
  3716. #. to do this.
  3717. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  3718. #: apt.conf.5.xml:775
  3719. msgid ""
  3720. "<literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data "
  3721. "in CD-ROM IDs."
  3722. msgstr ""
  3723. #. type: Content of: <refentry><refsect1><para>
  3724. #: apt.conf.5.xml:785
  3725. msgid "A full list of debugging options to apt follows."
  3726. msgstr ""
  3727. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3728. #: apt.conf.5.xml:794
  3729. msgid ""
  3730. "Print information related to accessing <literal>cdrom://</literal> sources."
  3731. msgstr ""
  3732. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3733. #: apt.conf.5.xml:805
  3734. msgid "Print information related to downloading packages using FTP."
  3735. msgstr ""
  3736. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3737. #: apt.conf.5.xml:816
  3738. msgid "Print information related to downloading packages using HTTP."
  3739. msgstr ""
  3740. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3741. #: apt.conf.5.xml:827
  3742. msgid "Print information related to downloading packages using HTTPS."
  3743. msgstr ""
  3744. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3745. #: apt.conf.5.xml:838
  3746. msgid ""
  3747. "Print information related to verifying cryptographic signatures using "
  3748. "<literal>gpg</literal>."
  3749. msgstr ""
  3750. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3751. #: apt.conf.5.xml:849
  3752. msgid ""
  3753. "Output information about the process of accessing collections of packages "
  3754. "stored on CD-ROMs."
  3755. msgstr ""
  3756. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3757. #: apt.conf.5.xml:859
  3758. msgid "Describes the process of resolving build-dependencies in &apt-get;."
  3759. msgstr ""
  3760. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3761. #: apt.conf.5.xml:869
  3762. msgid ""
  3763. "Output each cryptographic hash that is generated by the <literal>apt</"
  3764. "literal> libraries."
  3765. msgstr ""
  3766. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3767. #: apt.conf.5.xml:879
  3768. msgid ""
  3769. "Do not include information from <literal>statfs</literal>, namely the number "
  3770. "of used and free blocks on the CD-ROM filesystem, when generating an ID for "
  3771. "a CD-ROM."
  3772. msgstr ""
  3773. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3774. #: apt.conf.5.xml:890
  3775. msgid ""
  3776. "Disable all file locking. For instance, this will allow two instances of "
  3777. "<quote><literal>apt-get update</literal></quote> to run at the same time."
  3778. msgstr ""
  3779. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3780. #: apt.conf.5.xml:902
  3781. msgid "Log when items are added to or removed from the global download queue."
  3782. msgstr ""
  3783. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3784. #: apt.conf.5.xml:912
  3785. msgid ""
  3786. "Output status messages and errors related to verifying checksums and "
  3787. "cryptographic signatures of downloaded files."
  3788. msgstr ""
  3789. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3790. #: apt.conf.5.xml:922
  3791. msgid ""
  3792. "Output information about downloading and applying package index list diffs, "
  3793. "and errors relating to package index list diffs."
  3794. msgstr ""
  3795. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3796. #: apt.conf.5.xml:934
  3797. msgid ""
  3798. "Output information related to patching apt package lists when downloading "
  3799. "index diffs instead of full indices."
  3800. msgstr ""
  3801. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3802. #: apt.conf.5.xml:945
  3803. msgid ""
  3804. "Log all interactions with the sub-processes that actually perform downloads."
  3805. msgstr ""
  3806. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3807. #: apt.conf.5.xml:956
  3808. msgid ""
  3809. "Log events related to the automatically-installed status of packages and to "
  3810. "the removal of unused packages."
  3811. msgstr ""
  3812. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3813. #: apt.conf.5.xml:966
  3814. msgid ""
  3815. "Generate debug messages describing which packages are being automatically "
  3816. "installed to resolve dependencies. This corresponds to the initial auto-"
  3817. "install pass performed in, e.g., <literal>apt-get install</literal>, and not "
  3818. "to the full <literal>apt</literal> dependency resolver; see <literal>Debug::"
  3819. "pkgProblemResolver</literal> for that."
  3820. msgstr ""
  3821. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3822. #: apt.conf.5.xml:980
  3823. msgid ""
  3824. "Generate debug messages describing which package is marked as keep/install/"
  3825. "remove while the ProblemResolver does his work. Each addition or deletion "
  3826. "may trigger additional actions; they are shown indented two additional space "
  3827. "under the original entry. The format for each line is <literal>MarkKeep</"
  3828. "literal>, <literal>MarkDelete</literal> or <literal>MarkInstall</literal> "
  3829. "followed by <literal>package-name &lt;a.b.c -&gt; d.e.f | x.y.z&gt; (section)"
  3830. "</literal> where <literal>a.b.c</literal> is the current version of the "
  3831. "package, <literal>d.e.f</literal> is the version considered for installation "
  3832. "and <literal>x.y.z</literal> is a newer version, but not considered for "
  3833. "installation (because of a low pin score). The later two can be omitted if "
  3834. "there is none or if it is the same version as the installed. "
  3835. "<literal>section</literal> is the name of the section the package appears in."
  3836. msgstr ""
  3837. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3838. #: apt.conf.5.xml:1002
  3839. msgid "Dump the default configuration to standard error on startup."
  3840. msgstr ""
  3841. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3842. #: apt.conf.5.xml:1012
  3843. msgid ""
  3844. "When invoking &dpkg;, output the precise command line with which it is being "
  3845. "invoked, with arguments separated by a single space character."
  3846. msgstr ""
  3847. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3848. #: apt.conf.5.xml:1023
  3849. msgid ""
  3850. "Output all the data received from &dpkg; on the status file descriptor and "
  3851. "any errors encountered while parsing it."
  3852. msgstr ""
  3853. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3854. #: apt.conf.5.xml:1034
  3855. msgid ""
  3856. "Generate a trace of the algorithm that decides the order in which "
  3857. "<literal>apt</literal> should pass packages to &dpkg;."
  3858. msgstr ""
  3859. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3860. #: apt.conf.5.xml:1046
  3861. msgid ""
  3862. "Output status messages tracing the steps performed when invoking &dpkg;."
  3863. msgstr ""
  3864. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3865. #: apt.conf.5.xml:1057
  3866. msgid "Output the priority of each package list on startup."
  3867. msgstr ""
  3868. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3869. #: apt.conf.5.xml:1067
  3870. msgid ""
  3871. "Trace the execution of the dependency resolver (this applies only to what "
  3872. "happens when a complex dependency problem is encountered)."
  3873. msgstr ""
  3874. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3875. #: apt.conf.5.xml:1078
  3876. msgid ""
  3877. "Display a list of all installed packages with their calculated score used by "
  3878. "the pkgProblemResolver. The description of the package is the same as "
  3879. "described in <literal>Debug::pkgDepCache::Marker</literal>"
  3880. msgstr ""
  3881. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3882. #: apt.conf.5.xml:1090
  3883. msgid ""
  3884. "Print information about the vendors read from <filename>/etc/apt/vendors."
  3885. "list</filename>."
  3886. msgstr ""
  3887. #. type: Content of: <refentry><refsect1><para>
  3888. #: apt.conf.5.xml:1113
  3889. msgid ""
  3890. "&configureindex; is a configuration file showing example values for all "
  3891. "possible options."
  3892. msgstr ""
  3893. #. ? reading apt.conf
  3894. #. type: Content of: <refentry><refsect1><para>
  3895. #: apt.conf.5.xml:1125
  3896. msgid "&apt-cache;, &apt-config;, &apt-preferences;."
  3897. msgstr ""
  3898. #. type: Content of: <refentry><refnamediv><refpurpose>
  3899. #: apt_preferences.5.xml:32
  3900. msgid "Preference control file for APT"
  3901. msgstr ""
  3902. #. type: Content of: <refentry><refsect1><para>
  3903. #: apt_preferences.5.xml:37
  3904. msgid ""
  3905. "The APT preferences file <filename>/etc/apt/preferences</filename> and the "
  3906. "fragment files in the <filename>/etc/apt/preferences.d/</filename> folder "
  3907. "can be used to control which versions of packages will be selected for "
  3908. "installation."
  3909. msgstr ""
  3910. #. type: Content of: <refentry><refsect1><para>
  3911. #: apt_preferences.5.xml:42
  3912. msgid ""
  3913. "Several versions of a package may be available for installation when the "
  3914. "&sources-list; file contains references to more than one distribution (for "
  3915. "example, <literal>stable</literal> and <literal>testing</literal>). APT "
  3916. "assigns a priority to each version that is available. Subject to dependency "
  3917. "constraints, <command>apt-get</command> selects the version with the highest "
  3918. "priority for installation. The APT preferences file overrides the "
  3919. "priorities that APT assigns to package versions by default, thus giving the "
  3920. "user control over which one is selected for installation."
  3921. msgstr ""
  3922. #. type: Content of: <refentry><refsect1><para>
  3923. #: apt_preferences.5.xml:52
  3924. msgid ""
  3925. "Several instances of the same version of a package may be available when the "
  3926. "&sources-list; file contains references to more than one source. In this "
  3927. "case <command>apt-get</command> downloads the instance listed earliest in "
  3928. "the &sources-list; file. The APT preferences file does not affect the "
  3929. "choice of instance, only the choice of version."
  3930. msgstr ""
  3931. #. type: Content of: <refentry><refsect1><para>
  3932. #: apt_preferences.5.xml:59
  3933. msgid ""
  3934. "Preferences are a strong power in the hands of a system administrator but "
  3935. "they can become also their biggest nightmare if used without care! APT will "
  3936. "not questioning the preferences so wrong settings will therefore lead to "
  3937. "uninstallable packages or wrong decisions while upgrading packages. Even "
  3938. "more problems will arise if multiply distribution releases are mixed without "
  3939. "a good understanding of the following paragraphs. Packages included in a "
  3940. "specific release aren't tested in and therefore doesn't always work as "
  3941. "expected in older or newer releases or together with other packages from "
  3942. "different releases. You have been warned."
  3943. msgstr ""
  3944. #. type: Content of: <refentry><refsect1><para>
  3945. #: apt_preferences.5.xml:70
  3946. msgid ""
  3947. "Note that the files in the <filename>/etc/apt/preferences.d</filename> "
  3948. "directory are parsed in alphanumeric ascending order and need to obey the "
  3949. "following naming convention: The files have either no or \"<literal>pref</"
  3950. "literal>\" as filename extension and only contain alphanumeric, hyphen (-), "
  3951. "underscore (_) and period (.) characters. Otherwise APT will print a notice "
  3952. "that it has ignored a file if the file doesn't match a pattern in the "
  3953. "<literal>Dir::Ignore-Files-Silently</literal> configuration list - in this "
  3954. "case it will be silently ignored."
  3955. msgstr ""
  3956. #. type: Content of: <refentry><refsect1><refsect2><title>
  3957. #: apt_preferences.5.xml:79
  3958. msgid "APT's Default Priority Assignments"
  3959. msgstr ""
  3960. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  3961. #: apt_preferences.5.xml:94
  3962. #, no-wrap
  3963. msgid "<command>apt-get install -t testing <replaceable>some-package</replaceable></command>\n"
  3964. msgstr ""
  3965. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  3966. #: apt_preferences.5.xml:97
  3967. #, no-wrap
  3968. msgid "APT::Default-Release \"stable\";\n"
  3969. msgstr ""
  3970. #. type: Content of: <refentry><refsect1><refsect2><para>
  3971. #: apt_preferences.5.xml:81
  3972. msgid ""
  3973. "If there is no preferences file or if there is no entry in the file that "
  3974. "applies to a particular version then the priority assigned to that version "
  3975. "is the priority of the distribution to which that version belongs. It is "
  3976. "possible to single out a distribution, \"the target release\", which "
  3977. "receives a higher priority than other distributions do by default. The "
  3978. "target release can be set on the <command>apt-get</command> command line or "
  3979. "in the APT configuration file <filename>/etc/apt/apt.conf</filename>. Note "
  3980. "that this has precedence over any general priority you set in the <filename>/"
  3981. "etc/apt/preferences</filename> file described later, but not over "
  3982. "specifically pinned packages. For example, <placeholder type="
  3983. "\"programlisting\" id=\"0\"/> <placeholder type=\"programlisting\" id=\"1\"/>"
  3984. msgstr ""
  3985. #. type: Content of: <refentry><refsect1><refsect2><para>
  3986. #: apt_preferences.5.xml:101
  3987. msgid ""
  3988. "If the target release has been specified then APT uses the following "
  3989. "algorithm to set the priorities of the versions of a package. Assign:"
  3990. msgstr ""
  3991. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  3992. #: apt_preferences.5.xml:106
  3993. msgid "priority 1"
  3994. msgstr ""
  3995. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  3996. #: apt_preferences.5.xml:107
  3997. msgid ""
  3998. "to the versions coming from archives which in their <filename>Release</"
  3999. "filename> files are marked as \"NotAutomatic: yes\" but <emphasis>not</"
  4000. "emphasis> as \"ButAutomaticUpgrades: yes\" like the debian "
  4001. "<literal>experimental</literal> archive."
  4002. msgstr ""
  4003. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4004. #: apt_preferences.5.xml:113
  4005. msgid "priority 100"
  4006. msgstr ""
  4007. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4008. #: apt_preferences.5.xml:114
  4009. msgid ""
  4010. "to the version that is already installed (if any) and to the versions coming "
  4011. "from archives which in their <filename>Release</filename> files are marked "
  4012. "as \"NotAutomatic: yes\" and \"ButAutomaticUpgrades: yes\" like the debian "
  4013. "backports archive since <literal>squeeze-backports</literal>."
  4014. msgstr ""
  4015. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4016. #: apt_preferences.5.xml:121
  4017. msgid "priority 500"
  4018. msgstr ""
  4019. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4020. #: apt_preferences.5.xml:122
  4021. msgid ""
  4022. "to the versions that are not installed and do not belong to the target "
  4023. "release."
  4024. msgstr ""
  4025. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4026. #: apt_preferences.5.xml:126
  4027. msgid "priority 990"
  4028. msgstr ""
  4029. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4030. #: apt_preferences.5.xml:127
  4031. msgid ""
  4032. "to the versions that are not installed and belong to the target release."
  4033. msgstr ""
  4034. #. type: Content of: <refentry><refsect1><refsect2><para>
  4035. #: apt_preferences.5.xml:132
  4036. msgid ""
  4037. "If the target release has not been specified then APT simply assigns "
  4038. "priority 100 to all installed package versions and priority 500 to all "
  4039. "uninstalled package versions, except versions coming from archives which in "
  4040. "their <filename>Release</filename> files are marked as \"NotAutomatic: yes\" "
  4041. "- these versions get the priority 1 or priority 100 if it is additionally "
  4042. "marked as \"ButAutomaticUpgrades: yes\"."
  4043. msgstr ""
  4044. #. type: Content of: <refentry><refsect1><refsect2><para>
  4045. #: apt_preferences.5.xml:139
  4046. msgid ""
  4047. "APT then applies the following rules, listed in order of precedence, to "
  4048. "determine which version of a package to install."
  4049. msgstr ""
  4050. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4051. #: apt_preferences.5.xml:142
  4052. msgid ""
  4053. "Never downgrade unless the priority of an available version exceeds 1000. "
  4054. "(\"Downgrading\" is installing a less recent version of a package in place "
  4055. "of a more recent version. Note that none of APT's default priorities "
  4056. "exceeds 1000; such high priorities can only be set in the preferences file. "
  4057. "Note also that downgrading a package can be risky.)"
  4058. msgstr ""
  4059. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4060. #: apt_preferences.5.xml:148
  4061. msgid "Install the highest priority version."
  4062. msgstr ""
  4063. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4064. #: apt_preferences.5.xml:149
  4065. msgid ""
  4066. "If two or more versions have the same priority, install the most recent one "
  4067. "(that is, the one with the higher version number)."
  4068. msgstr ""
  4069. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4070. #: apt_preferences.5.xml:152
  4071. msgid ""
  4072. "If two or more versions have the same priority and version number but either "
  4073. "the packages differ in some of their metadata or the <literal>--reinstall</"
  4074. "literal> option is given, install the uninstalled one."
  4075. msgstr ""
  4076. #. type: Content of: <refentry><refsect1><refsect2><para>
  4077. #: apt_preferences.5.xml:158
  4078. msgid ""
  4079. "In a typical situation, the installed version of a package (priority 100) "
  4080. "is not as recent as one of the versions available from the sources listed in "
  4081. "the &sources-list; file (priority 500 or 990). Then the package will be "
  4082. "upgraded when <command>apt-get install <replaceable>some-package</"
  4083. "replaceable></command> or <command>apt-get upgrade</command> is executed."
  4084. msgstr ""
  4085. #. type: Content of: <refentry><refsect1><refsect2><para>
  4086. #: apt_preferences.5.xml:165
  4087. msgid ""
  4088. "More rarely, the installed version of a package is <emphasis>more</emphasis> "
  4089. "recent than any of the other available versions. The package will not be "
  4090. "downgraded when <command>apt-get install <replaceable>some-package</"
  4091. "replaceable></command> or <command>apt-get upgrade</command> is executed."
  4092. msgstr ""
  4093. #. type: Content of: <refentry><refsect1><refsect2><para>
  4094. #: apt_preferences.5.xml:170
  4095. msgid ""
  4096. "Sometimes the installed version of a package is more recent than the version "
  4097. "belonging to the target release, but not as recent as a version belonging to "
  4098. "some other distribution. Such a package will indeed be upgraded when "
  4099. "<command>apt-get install <replaceable>some-package</replaceable></command> "
  4100. "or <command>apt-get upgrade</command> is executed, because at least "
  4101. "<emphasis>one</emphasis> of the available versions has a higher priority "
  4102. "than the installed version."
  4103. msgstr ""
  4104. #. type: Content of: <refentry><refsect1><refsect2><title>
  4105. #: apt_preferences.5.xml:179
  4106. msgid "The Effect of APT Preferences"
  4107. msgstr ""
  4108. #. type: Content of: <refentry><refsect1><refsect2><para>
  4109. #: apt_preferences.5.xml:181
  4110. msgid ""
  4111. "The APT preferences file allows the system administrator to control the "
  4112. "assignment of priorities. The file consists of one or more multi-line "
  4113. "records separated by blank lines. Records can have one of two forms, a "
  4114. "specific form and a general form."
  4115. msgstr ""
  4116. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4117. #: apt_preferences.5.xml:187
  4118. msgid ""
  4119. "The specific form assigns a priority (a \"Pin-Priority\") to one or more "
  4120. "specified packages and specified version or version range. For example, the "
  4121. "following record assigns a high priority to all versions of the "
  4122. "<filename>perl</filename> package whose version number begins with "
  4123. "\"<literal>5.8</literal>\". Multiple packages can be separated by spaces."
  4124. msgstr ""
  4125. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  4126. #: apt_preferences.5.xml:194
  4127. #, no-wrap
  4128. msgid ""
  4129. "Package: perl\n"
  4130. "Pin: version 5.8*\n"
  4131. "Pin-Priority: 1001\n"
  4132. msgstr ""
  4133. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4134. #: apt_preferences.5.xml:200
  4135. msgid ""
  4136. "The general form assigns a priority to all of the package versions in a "
  4137. "given distribution (that is, to all the versions of packages that are listed "
  4138. "in a certain <filename>Release</filename> file) or to all of the package "
  4139. "versions coming from a particular Internet site, as identified by the site's "
  4140. "fully qualified domain name."
  4141. msgstr ""
  4142. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4143. #: apt_preferences.5.xml:206
  4144. msgid ""
  4145. "This general-form entry in the APT preferences file applies only to groups "
  4146. "of packages. For example, the following record assigns a high priority to "
  4147. "all package versions available from the local site."
  4148. msgstr ""
  4149. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  4150. #: apt_preferences.5.xml:211
  4151. #, no-wrap
  4152. msgid ""
  4153. "Package: *\n"
  4154. "Pin: origin \"\"\n"
  4155. "Pin-Priority: 999\n"
  4156. msgstr ""
  4157. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4158. #: apt_preferences.5.xml:216
  4159. msgid ""
  4160. "A note of caution: the keyword used here is \"<literal>origin</literal>\" "
  4161. "which can be used to match a hostname. The following record will assign a "
  4162. "high priority to all versions available from the server identified by the "
  4163. "hostname \"ftp.de.debian.org\""
  4164. msgstr ""
  4165. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  4166. #: apt_preferences.5.xml:220
  4167. #, no-wrap
  4168. msgid ""
  4169. "Package: *\n"
  4170. "Pin: origin \"ftp.de.debian.org\"\n"
  4171. "Pin-Priority: 999\n"
  4172. msgstr ""
  4173. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4174. #: apt_preferences.5.xml:224
  4175. msgid ""
  4176. "This should <emphasis>not</emphasis> be confused with the Origin of a "
  4177. "distribution as specified in a <filename>Release</filename> file. What "
  4178. "follows the \"Origin:\" tag in a <filename>Release</filename> file is not an "
  4179. "Internet address but an author or vendor name, such as \"Debian\" or \"Ximian"
  4180. "\"."
  4181. msgstr ""
  4182. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4183. #: apt_preferences.5.xml:229
  4184. msgid ""
  4185. "The following record assigns a low priority to all package versions "
  4186. "belonging to any distribution whose Archive name is \"<literal>unstable</"
  4187. "literal>\"."
  4188. msgstr ""
  4189. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  4190. #: apt_preferences.5.xml:233
  4191. #, no-wrap
  4192. msgid ""
  4193. "Package: *\n"
  4194. "Pin: release a=unstable\n"
  4195. "Pin-Priority: 50\n"
  4196. msgstr ""
  4197. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4198. #: apt_preferences.5.xml:238
  4199. msgid ""
  4200. "The following record assigns a high priority to all package versions "
  4201. "belonging to any distribution whose Codename is \"<literal>&testing-codename;"
  4202. "</literal>\"."
  4203. msgstr ""
  4204. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  4205. #: apt_preferences.5.xml:242
  4206. #, no-wrap
  4207. msgid ""
  4208. "Package: *\n"
  4209. "Pin: release n=&testing-codename;\n"
  4210. "Pin-Priority: 900\n"
  4211. msgstr ""
  4212. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4213. #: apt_preferences.5.xml:247
  4214. msgid ""
  4215. "The following record assigns a high priority to all package versions "
  4216. "belonging to any release whose Archive name is \"<literal>stable</literal>\" "
  4217. "and whose release Version number is \"<literal>3.0</literal>\"."
  4218. msgstr ""
  4219. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  4220. #: apt_preferences.5.xml:252
  4221. #, no-wrap
  4222. msgid ""
  4223. "Package: *\n"
  4224. "Pin: release a=stable, v=3.0\n"
  4225. "Pin-Priority: 500\n"
  4226. msgstr ""
  4227. #. type: Content of: <refentry><refsect1><refsect2><title>
  4228. #: apt_preferences.5.xml:262
  4229. msgid "Regular expressions and glob() syntax"
  4230. msgstr ""
  4231. #. type: Content of: <refentry><refsect1><refsect2><para>
  4232. #: apt_preferences.5.xml:264
  4233. msgid ""
  4234. "APT also supports pinning by glob() expressions and regular expressions "
  4235. "surrounded by /. For example, the following example assigns the priority 500 "
  4236. "to all packages from experimental where the name starts with gnome (as a glob"
  4237. "()-like expression) or contains the word kde (as a POSIX extended regular "
  4238. "expression surrounded by slashes)."
  4239. msgstr ""
  4240. #. type: Content of: <refentry><refsect1><refsect2><programlisting>
  4241. #: apt_preferences.5.xml:273
  4242. #, no-wrap
  4243. msgid ""
  4244. "Package: gnome* /kde/\n"
  4245. "Pin: release n=experimental\n"
  4246. "Pin-Priority: 500\n"
  4247. msgstr ""
  4248. #. type: Content of: <refentry><refsect1><refsect2><para>
  4249. #: apt_preferences.5.xml:279
  4250. msgid ""
  4251. "The rule for those expressions is that they can occur anywhere where a "
  4252. "string can occur. Thus, the following pin assigns the priority 990 to all "
  4253. "packages from a release starting with karmic."
  4254. msgstr ""
  4255. #. type: Content of: <refentry><refsect1><refsect2><programlisting>
  4256. #: apt_preferences.5.xml:285
  4257. #, no-wrap
  4258. msgid ""
  4259. "Package: *\n"
  4260. "Pin: release n=karmic*\n"
  4261. "Pin-Priority: 990\n"
  4262. msgstr ""
  4263. #. type: Content of: <refentry><refsect1><refsect2><para>
  4264. #: apt_preferences.5.xml:291
  4265. msgid ""
  4266. "If a regular expression occurs in a <literal>Package</literal> field, the "
  4267. "behavior is the same as if this regular expression were replaced with a list "
  4268. "of all package names it matches. It is undecided whether this will change in "
  4269. "the future, thus you should always list wild-card pins first, so later "
  4270. "specific pins override it. The pattern \"<literal>*</literal>\" in a "
  4271. "Package field is not considered a glob() expression in itself."
  4272. msgstr ""
  4273. #. type: Content of: <refentry><refsect1><refsect2><title>
  4274. #: apt_preferences.5.xml:307
  4275. msgid "How APT Interprets Priorities"
  4276. msgstr ""
  4277. #. type: Content of: <refentry><refsect1><refsect2><para>
  4278. #: apt_preferences.5.xml:310
  4279. msgid ""
  4280. "Priorities (P) assigned in the APT preferences file must be positive or "
  4281. "negative integers. They are interpreted as follows (roughly speaking):"
  4282. msgstr ""
  4283. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4284. #: apt_preferences.5.xml:315
  4285. msgid "P &gt; 1000"
  4286. msgstr ""
  4287. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4288. #: apt_preferences.5.xml:316
  4289. msgid ""
  4290. "causes a version to be installed even if this constitutes a downgrade of the "
  4291. "package"
  4292. msgstr ""
  4293. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4294. #: apt_preferences.5.xml:320
  4295. msgid "990 &lt; P &lt;=1000"
  4296. msgstr ""
  4297. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4298. #: apt_preferences.5.xml:321
  4299. msgid ""
  4300. "causes a version to be installed even if it does not come from the target "
  4301. "release, unless the installed version is more recent"
  4302. msgstr ""
  4303. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4304. #: apt_preferences.5.xml:326
  4305. msgid "500 &lt; P &lt;=990"
  4306. msgstr ""
  4307. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4308. #: apt_preferences.5.xml:327
  4309. msgid ""
  4310. "causes a version to be installed unless there is a version available "
  4311. "belonging to the target release or the installed version is more recent"
  4312. msgstr ""
  4313. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4314. #: apt_preferences.5.xml:332
  4315. msgid "100 &lt; P &lt;=500"
  4316. msgstr ""
  4317. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4318. #: apt_preferences.5.xml:333
  4319. msgid ""
  4320. "causes a version to be installed unless there is a version available "
  4321. "belonging to some other distribution or the installed version is more recent"
  4322. msgstr ""
  4323. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4324. #: apt_preferences.5.xml:338
  4325. msgid "0 &lt; P &lt;=100"
  4326. msgstr ""
  4327. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4328. #: apt_preferences.5.xml:339
  4329. msgid ""
  4330. "causes a version to be installed only if there is no installed version of "
  4331. "the package"
  4332. msgstr ""
  4333. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4334. #: apt_preferences.5.xml:343
  4335. msgid "P &lt; 0"
  4336. msgstr ""
  4337. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4338. #: apt_preferences.5.xml:344
  4339. msgid "prevents the version from being installed"
  4340. msgstr ""
  4341. #. type: Content of: <refentry><refsect1><refsect2><para>
  4342. #: apt_preferences.5.xml:349
  4343. msgid ""
  4344. "If any specific-form records match an available package version then the "
  4345. "first such record determines the priority of the package version. Failing "
  4346. "that, if any general-form records match an available package version then "
  4347. "the first such record determines the priority of the package version."
  4348. msgstr ""
  4349. #. type: Content of: <refentry><refsect1><refsect2><para>
  4350. #: apt_preferences.5.xml:355
  4351. msgid ""
  4352. "For example, suppose the APT preferences file contains the three records "
  4353. "presented earlier:"
  4354. msgstr ""
  4355. #. type: Content of: <refentry><refsect1><refsect2><programlisting>
  4356. #: apt_preferences.5.xml:359
  4357. #, no-wrap
  4358. msgid ""
  4359. "Package: perl\n"
  4360. "Pin: version 5.8*\n"
  4361. "Pin-Priority: 1001\n"
  4362. "\n"
  4363. "Package: *\n"
  4364. "Pin: origin \"\"\n"
  4365. "Pin-Priority: 999\n"
  4366. "\n"
  4367. "Package: *\n"
  4368. "Pin: release unstable\n"
  4369. "Pin-Priority: 50\n"
  4370. msgstr ""
  4371. #. type: Content of: <refentry><refsect1><refsect2><para>
  4372. #: apt_preferences.5.xml:372
  4373. msgid "Then:"
  4374. msgstr ""
  4375. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4376. #: apt_preferences.5.xml:374
  4377. msgid ""
  4378. "The most recent available version of the <literal>perl</literal> package "
  4379. "will be installed, so long as that version's version number begins with "
  4380. "\"<literal>5.8</literal>\". If <emphasis>any</emphasis> 5.8* version of "
  4381. "<literal>perl</literal> is available and the installed version is 5.9*, then "
  4382. "<literal>perl</literal> will be downgraded."
  4383. msgstr ""
  4384. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4385. #: apt_preferences.5.xml:379
  4386. msgid ""
  4387. "A version of any package other than <literal>perl</literal> that is "
  4388. "available from the local system has priority over other versions, even "
  4389. "versions belonging to the target release."
  4390. msgstr ""
  4391. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4392. #: apt_preferences.5.xml:383
  4393. msgid ""
  4394. "A version of a package whose origin is not the local system but some other "
  4395. "site listed in &sources-list; and which belongs to an <literal>unstable</"
  4396. "literal> distribution is only installed if it is selected for installation "
  4397. "and no version of the package is already installed."
  4398. msgstr ""
  4399. #. type: Content of: <refentry><refsect1><refsect2><title>
  4400. #: apt_preferences.5.xml:393
  4401. msgid "Determination of Package Version and Distribution Properties"
  4402. msgstr ""
  4403. #. type: Content of: <refentry><refsect1><refsect2><para>
  4404. #: apt_preferences.5.xml:395
  4405. msgid ""
  4406. "The locations listed in the &sources-list; file should provide "
  4407. "<filename>Packages</filename> and <filename>Release</filename> files to "
  4408. "describe the packages available at that location."
  4409. msgstr ""
  4410. #. type: Content of: <refentry><refsect1><refsect2><para>
  4411. #: apt_preferences.5.xml:399
  4412. msgid ""
  4413. "The <filename>Packages</filename> file is normally found in the directory "
  4414. "<filename>.../dists/<replaceable>dist-name</replaceable>/"
  4415. "<replaceable>component</replaceable>/<replaceable>arch</replaceable></"
  4416. "filename>: for example, <filename>.../dists/stable/main/binary-i386/"
  4417. "Packages</filename>. It consists of a series of multi-line records, one for "
  4418. "each package available in that directory. Only two lines in each record are "
  4419. "relevant for setting APT priorities:"
  4420. msgstr ""
  4421. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4422. #: apt_preferences.5.xml:407
  4423. msgid "the <literal>Package:</literal> line"
  4424. msgstr ""
  4425. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4426. #: apt_preferences.5.xml:408
  4427. msgid "gives the package name"
  4428. msgstr ""
  4429. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4430. #: apt_preferences.5.xml:411 apt_preferences.5.xml:461
  4431. msgid "the <literal>Version:</literal> line"
  4432. msgstr ""
  4433. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4434. #: apt_preferences.5.xml:412
  4435. msgid "gives the version number for the named package"
  4436. msgstr ""
  4437. #. type: Content of: <refentry><refsect1><refsect2><para>
  4438. #: apt_preferences.5.xml:417
  4439. msgid ""
  4440. "The <filename>Release</filename> file is normally found in the directory "
  4441. "<filename>.../dists/<replaceable>dist-name</replaceable></filename>: for "
  4442. "example, <filename>.../dists/stable/Release</filename>, or <filename>.../"
  4443. "dists/&stable-codename;/Release</filename>. It consists of a single multi-"
  4444. "line record which applies to <emphasis>all</emphasis> of the packages in the "
  4445. "directory tree below its parent. Unlike the <filename>Packages</filename> "
  4446. "file, nearly all of the lines in a <filename>Release</filename> file are "
  4447. "relevant for setting APT priorities:"
  4448. msgstr ""
  4449. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4450. #: apt_preferences.5.xml:428
  4451. msgid "the <literal>Archive:</literal> or <literal>Suite:</literal> line"
  4452. msgstr ""
  4453. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4454. #: apt_preferences.5.xml:429
  4455. msgid ""
  4456. "names the archive to which all the packages in the directory tree belong. "
  4457. "For example, the line \"Archive: stable\" or \"Suite: stable\" specifies "
  4458. "that all of the packages in the directory tree below the parent of the "
  4459. "<filename>Release</filename> file are in a <literal>stable</literal> "
  4460. "archive. Specifying this value in the APT preferences file would require "
  4461. "the line:"
  4462. msgstr ""
  4463. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  4464. #: apt_preferences.5.xml:439
  4465. #, no-wrap
  4466. msgid "Pin: release a=stable\n"
  4467. msgstr ""
  4468. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4469. #: apt_preferences.5.xml:445
  4470. msgid "the <literal>Codename:</literal> line"
  4471. msgstr ""
  4472. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4473. #: apt_preferences.5.xml:446
  4474. msgid ""
  4475. "names the codename to which all the packages in the directory tree belong. "
  4476. "For example, the line \"Codename: &testing-codename;\" specifies that all of "
  4477. "the packages in the directory tree below the parent of the "
  4478. "<filename>Release</filename> file belong to a version named "
  4479. "<literal>&testing-codename;</literal>. Specifying this value in the APT "
  4480. "preferences file would require the line:"
  4481. msgstr ""
  4482. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  4483. #: apt_preferences.5.xml:455
  4484. #, no-wrap
  4485. msgid "Pin: release n=&testing-codename;\n"
  4486. msgstr ""
  4487. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4488. #: apt_preferences.5.xml:462
  4489. msgid ""
  4490. "names the release version. For example, the packages in the tree might "
  4491. "belong to Debian release version 3.0. Note that there is normally no "
  4492. "version number for the <literal>testing</literal> and <literal>unstable</"
  4493. "literal> distributions because they have not been released yet. Specifying "
  4494. "this in the APT preferences file would require one of the following lines."
  4495. msgstr ""
  4496. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  4497. #: apt_preferences.5.xml:471
  4498. #, no-wrap
  4499. msgid ""
  4500. "Pin: release v=3.0\n"
  4501. "Pin: release a=stable, v=3.0\n"
  4502. "Pin: release 3.0\n"
  4503. msgstr ""
  4504. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4505. #: apt_preferences.5.xml:480
  4506. msgid "the <literal>Component:</literal> line"
  4507. msgstr ""
  4508. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4509. #: apt_preferences.5.xml:481
  4510. msgid ""
  4511. "names the licensing component associated with the packages in the directory "
  4512. "tree of the <filename>Release</filename> file. For example, the line "
  4513. "\"Component: main\" specifies that all the packages in the directory tree "
  4514. "are from the <literal>main</literal> component, which entails that they are "
  4515. "licensed under terms listed in the Debian Free Software Guidelines. "
  4516. "Specifying this component in the APT preferences file would require the line:"
  4517. msgstr ""
  4518. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  4519. #: apt_preferences.5.xml:490
  4520. #, no-wrap
  4521. msgid "Pin: release c=main\n"
  4522. msgstr ""
  4523. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4524. #: apt_preferences.5.xml:496
  4525. msgid "the <literal>Origin:</literal> line"
  4526. msgstr ""
  4527. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4528. #: apt_preferences.5.xml:497
  4529. msgid ""
  4530. "names the originator of the packages in the directory tree of the "
  4531. "<filename>Release</filename> file. Most commonly, this is <literal>Debian</"
  4532. "literal>. Specifying this origin in the APT preferences file would require "
  4533. "the line:"
  4534. msgstr ""
  4535. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  4536. #: apt_preferences.5.xml:503
  4537. #, no-wrap
  4538. msgid "Pin: release o=Debian\n"
  4539. msgstr ""
  4540. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4541. #: apt_preferences.5.xml:509
  4542. msgid "the <literal>Label:</literal> line"
  4543. msgstr ""
  4544. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4545. #: apt_preferences.5.xml:510
  4546. msgid ""
  4547. "names the label of the packages in the directory tree of the "
  4548. "<filename>Release</filename> file. Most commonly, this is <literal>Debian</"
  4549. "literal>. Specifying this label in the APT preferences file would require "
  4550. "the line:"
  4551. msgstr ""
  4552. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  4553. #: apt_preferences.5.xml:516
  4554. #, no-wrap
  4555. msgid "Pin: release l=Debian\n"
  4556. msgstr ""
  4557. #. type: Content of: <refentry><refsect1><refsect2><para>
  4558. #: apt_preferences.5.xml:523
  4559. msgid ""
  4560. "All of the <filename>Packages</filename> and <filename>Release</filename> "
  4561. "files retrieved from locations listed in the &sources-list; file are stored "
  4562. "in the directory <filename>/var/lib/apt/lists</filename>, or in the file "
  4563. "named by the variable <literal>Dir::State::Lists</literal> in the "
  4564. "<filename>apt.conf</filename> file. For example, the file <filename>debian."
  4565. "lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> "
  4566. "contains the <filename>Release</filename> file retrieved from the site "
  4567. "<literal>debian.lcs.mit.edu</literal> for <literal>binary-i386</literal> "
  4568. "architecture files from the <literal>contrib</literal> component of the "
  4569. "<literal>unstable</literal> distribution."
  4570. msgstr ""
  4571. #. type: Content of: <refentry><refsect1><refsect2><title>
  4572. #: apt_preferences.5.xml:536
  4573. msgid "Optional Lines in an APT Preferences Record"
  4574. msgstr ""
  4575. #. type: Content of: <refentry><refsect1><refsect2><para>
  4576. #: apt_preferences.5.xml:538
  4577. msgid ""
  4578. "Each record in the APT preferences file can optionally begin with one or "
  4579. "more lines beginning with the word <literal>Explanation:</literal>. This "
  4580. "provides a place for comments."
  4581. msgstr ""
  4582. #. type: Content of: <refentry><refsect1><refsect2><title>
  4583. #: apt_preferences.5.xml:547
  4584. msgid "Tracking Stable"
  4585. msgstr ""
  4586. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4587. #: apt_preferences.5.xml:555
  4588. #, no-wrap
  4589. msgid ""
  4590. "Explanation: Uninstall or do not install any Debian-originated\n"
  4591. "Explanation: package versions other than those in the stable distro\n"
  4592. "Package: *\n"
  4593. "Pin: release a=stable\n"
  4594. "Pin-Priority: 900\n"
  4595. "\n"
  4596. "Package: *\n"
  4597. "Pin: release o=Debian\n"
  4598. "Pin-Priority: -10\n"
  4599. msgstr ""
  4600. #. type: Content of: <refentry><refsect1><refsect2><para>
  4601. #: apt_preferences.5.xml:549
  4602. msgid ""
  4603. "The following APT preferences file will cause APT to assign a priority "
  4604. "higher than the default (500) to all package versions belonging to a "
  4605. "<literal>stable</literal> distribution and a prohibitively low priority to "
  4606. "package versions belonging to other <literal>Debian</literal> "
  4607. "distributions. <placeholder type=\"programlisting\" id=\"0\"/>"
  4608. msgstr ""
  4609. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4610. #: apt_preferences.5.xml:572 apt_preferences.5.xml:618
  4611. #: apt_preferences.5.xml:676
  4612. #, no-wrap
  4613. msgid ""
  4614. "apt-get install <replaceable>package-name</replaceable>\n"
  4615. "apt-get upgrade\n"
  4616. "apt-get dist-upgrade\n"
  4617. msgstr ""
  4618. #. type: Content of: <refentry><refsect1><refsect2><para>
  4619. #: apt_preferences.5.xml:567
  4620. msgid ""
  4621. "With a suitable &sources-list; file and the above preferences file, any of "
  4622. "the following commands will cause APT to upgrade to the latest "
  4623. "<literal>stable</literal> version(s). <placeholder type=\"programlisting\" "
  4624. "id=\"0\"/>"
  4625. msgstr ""
  4626. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4627. #: apt_preferences.5.xml:584
  4628. #, no-wrap
  4629. msgid "apt-get install <replaceable>package</replaceable>/testing\n"
  4630. msgstr ""
  4631. #. type: Content of: <refentry><refsect1><refsect2><para>
  4632. #: apt_preferences.5.xml:578
  4633. msgid ""
  4634. "The following command will cause APT to upgrade the specified package to the "
  4635. "latest version from the <literal>testing</literal> distribution; the package "
  4636. "will not be upgraded again unless this command is given again. <placeholder "
  4637. "type=\"programlisting\" id=\"0\"/>"
  4638. msgstr ""
  4639. #. type: Content of: <refentry><refsect1><refsect2><title>
  4640. #: apt_preferences.5.xml:590
  4641. msgid "Tracking Testing or Unstable"
  4642. msgstr ""
  4643. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4644. #: apt_preferences.5.xml:599
  4645. #, no-wrap
  4646. msgid ""
  4647. "Package: *\n"
  4648. "Pin: release a=testing\n"
  4649. "Pin-Priority: 900\n"
  4650. "\n"
  4651. "Package: *\n"
  4652. "Pin: release a=unstable\n"
  4653. "Pin-Priority: 800\n"
  4654. "\n"
  4655. "Package: *\n"
  4656. "Pin: release o=Debian\n"
  4657. "Pin-Priority: -10\n"
  4658. msgstr ""
  4659. #. type: Content of: <refentry><refsect1><refsect2><para>
  4660. #: apt_preferences.5.xml:592
  4661. msgid ""
  4662. "The following APT preferences file will cause APT to assign a high priority "
  4663. "to package versions from the <literal>testing</literal> distribution, a "
  4664. "lower priority to package versions from the <literal>unstable</literal> "
  4665. "distribution, and a prohibitively low priority to package versions from "
  4666. "other <literal>Debian</literal> distributions. <placeholder type="
  4667. "\"programlisting\" id=\"0\"/>"
  4668. msgstr ""
  4669. #. type: Content of: <refentry><refsect1><refsect2><para>
  4670. #: apt_preferences.5.xml:613
  4671. msgid ""
  4672. "With a suitable &sources-list; file and the above preferences file, any of "
  4673. "the following commands will cause APT to upgrade to the latest "
  4674. "<literal>testing</literal> version(s). <placeholder type=\"programlisting\" "
  4675. "id=\"0\"/>"
  4676. msgstr ""
  4677. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4678. #: apt_preferences.5.xml:633
  4679. #, no-wrap
  4680. msgid "apt-get install <replaceable>package</replaceable>/unstable\n"
  4681. msgstr ""
  4682. #. type: Content of: <refentry><refsect1><refsect2><para>
  4683. #: apt_preferences.5.xml:624
  4684. msgid ""
  4685. "The following command will cause APT to upgrade the specified package to the "
  4686. "latest version from the <literal>unstable</literal> distribution. "
  4687. "Thereafter, <command>apt-get upgrade</command> will upgrade the package to "
  4688. "the most recent <literal>testing</literal> version if that is more recent "
  4689. "than the installed version, otherwise, to the most recent <literal>unstable</"
  4690. "literal> version if that is more recent than the installed version. "
  4691. "<placeholder type=\"programlisting\" id=\"0\"/>"
  4692. msgstr ""
  4693. #. type: Content of: <refentry><refsect1><refsect2><title>
  4694. #: apt_preferences.5.xml:640
  4695. msgid "Tracking the evolution of a codename release"
  4696. msgstr ""
  4697. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4698. #: apt_preferences.5.xml:654
  4699. #, no-wrap
  4700. msgid ""
  4701. "Explanation: Uninstall or do not install any Debian-originated package versions\n"
  4702. "Explanation: other than those in the distribution codenamed with &testing-codename; or sid\n"
  4703. "Package: *\n"
  4704. "Pin: release n=&testing-codename;\n"
  4705. "Pin-Priority: 900\n"
  4706. "\n"
  4707. "Explanation: Debian unstable is always codenamed with sid\n"
  4708. "Package: *\n"
  4709. "Pin: release n=sid\n"
  4710. "Pin-Priority: 800\n"
  4711. "\n"
  4712. "Package: *\n"
  4713. "Pin: release o=Debian\n"
  4714. "Pin-Priority: -10\n"
  4715. msgstr ""
  4716. #. type: Content of: <refentry><refsect1><refsect2><para>
  4717. #: apt_preferences.5.xml:642
  4718. msgid ""
  4719. "The following APT preferences file will cause APT to assign a priority "
  4720. "higher than the default (500) to all package versions belonging to a "
  4721. "specified codename of a distribution and a prohibitively low priority to "
  4722. "package versions belonging to other <literal>Debian</literal> distributions, "
  4723. "codenames and archives. Note that with this APT preference APT will follow "
  4724. "the migration of a release from the archive <literal>testing</literal> to "
  4725. "<literal>stable</literal> and later <literal>oldstable</literal>. If you "
  4726. "want to follow for example the progress in <literal>testing</literal> "
  4727. "notwithstanding the codename changes you should use the example "
  4728. "configurations above. <placeholder type=\"programlisting\" id=\"0\"/>"
  4729. msgstr ""
  4730. #. type: Content of: <refentry><refsect1><refsect2><para>
  4731. #: apt_preferences.5.xml:671
  4732. msgid ""
  4733. "With a suitable &sources-list; file and the above preferences file, any of "
  4734. "the following commands will cause APT to upgrade to the latest version(s) in "
  4735. "the release codenamed with <literal>&testing-codename;</literal>. "
  4736. "<placeholder type=\"programlisting\" id=\"0\"/>"
  4737. msgstr ""
  4738. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4739. #: apt_preferences.5.xml:691
  4740. #, no-wrap
  4741. msgid "apt-get install <replaceable>package</replaceable>/sid\n"
  4742. msgstr ""
  4743. #. type: Content of: <refentry><refsect1><refsect2><para>
  4744. #: apt_preferences.5.xml:682
  4745. msgid ""
  4746. "The following command will cause APT to upgrade the specified package to the "
  4747. "latest version from the <literal>sid</literal> distribution. Thereafter, "
  4748. "<command>apt-get upgrade</command> will upgrade the package to the most "
  4749. "recent <literal>&testing-codename;</literal> version if that is more recent "
  4750. "than the installed version, otherwise, to the most recent <literal>sid</"
  4751. "literal> version if that is more recent than the installed version. "
  4752. "<placeholder type=\"programlisting\" id=\"0\"/>"
  4753. msgstr ""
  4754. #. type: Content of: <refentry><refsect1><para>
  4755. #: apt_preferences.5.xml:706
  4756. msgid "&apt-get; &apt-cache; &apt-conf; &sources-list;"
  4757. msgstr ""
  4758. #. type: Content of: <refentry><refnamediv><refpurpose>
  4759. #: sources.list.5.xml:33
  4760. msgid "Package resource list for APT"
  4761. msgstr ""
  4762. #. type: Content of: <refentry><refsect1><para>
  4763. #: sources.list.5.xml:37
  4764. msgid ""
  4765. "The package resource list is used to locate archives of the package "
  4766. "distribution system in use on the system. At this time, this manual page "
  4767. "documents only the packaging system used by the Debian system. This control "
  4768. "file is <filename>/etc/apt/sources.list</filename>."
  4769. msgstr ""
  4770. #. type: Content of: <refentry><refsect1><para>
  4771. #: sources.list.5.xml:42
  4772. msgid ""
  4773. "The source list is designed to support any number of active sources and a "
  4774. "variety of source media. The file lists one source per line, with the most "
  4775. "preferred source listed first. The format of each line is: <literal>type uri "
  4776. "args</literal> The first item, <literal>type</literal> determines the format "
  4777. "for <literal>args</literal>. <literal>uri</literal> is a Universal Resource "
  4778. "Identifier (URI), which is a superset of the more specific and well-known "
  4779. "Universal Resource Locator, or URL. The rest of the line can be marked as a "
  4780. "comment by using a #."
  4781. msgstr ""
  4782. #. type: Content of: <refentry><refsect1><title>
  4783. #: sources.list.5.xml:53
  4784. msgid "sources.list.d"
  4785. msgstr ""
  4786. #. type: Content of: <refentry><refsect1><para>
  4787. #: sources.list.5.xml:54
  4788. msgid ""
  4789. "The <filename>/etc/apt/sources.list.d</filename> directory provides a way to "
  4790. "add sources.list entries in separate files. The format is the same as for "
  4791. "the regular <filename>sources.list</filename> file. File names need to end "
  4792. "with <filename>.list</filename> and may only contain letters (a-z and A-Z), "
  4793. "digits (0-9), underscore (_), hyphen (-) and period (.) characters. "
  4794. "Otherwise APT will print a notice that it has ignored a file if the file "
  4795. "doesn't match a pattern in the <literal>Dir::Ignore-Files-Silently</literal> "
  4796. "configuration list - in this case it will be silently ignored."
  4797. msgstr ""
  4798. #. type: Content of: <refentry><refsect1><title>
  4799. #: sources.list.5.xml:65
  4800. msgid "The deb and deb-src types"
  4801. msgstr ""
  4802. #. type: Content of: <refentry><refsect1><para>
  4803. #: sources.list.5.xml:66
  4804. msgid ""
  4805. "The <literal>deb</literal> type describes a typical two-level Debian "
  4806. "archive, <filename>distribution/component</filename>. Typically, "
  4807. "<literal>distribution</literal> is generally an archivename like "
  4808. "<literal>stable</literal> or <literal>testing</literal> or a codename like "
  4809. "<literal>&stable-codename;</literal> or <literal>&testing-codename;</"
  4810. "literal> while component is one of <literal>main</literal> <literal>contrib</"
  4811. "literal> or <literal>non-free</literal>. The <literal>deb-src</literal> type "
  4812. "describes a debian distribution's source code in the same form as the "
  4813. "<literal>deb</literal> type. A <literal>deb-src</literal> line is required "
  4814. "to fetch source indexes."
  4815. msgstr ""
  4816. #. type: Content of: <refentry><refsect1><para>
  4817. #: sources.list.5.xml:78
  4818. msgid ""
  4819. "The format for a <filename>sources.list</filename> entry using the "
  4820. "<literal>deb</literal> and <literal>deb-src</literal> types is:"
  4821. msgstr ""
  4822. #. type: Content of: <refentry><refsect1><literallayout>
  4823. #: sources.list.5.xml:81
  4824. #, no-wrap
  4825. msgid "deb [ options ] uri distribution [component1] [component2] [...]"
  4826. msgstr ""
  4827. #. type: Content of: <refentry><refsect1><para>
  4828. #: sources.list.5.xml:83
  4829. msgid ""
  4830. "The URI for the <literal>deb</literal> type must specify the base of the "
  4831. "Debian distribution, from which APT will find the information it needs. "
  4832. "<literal>distribution</literal> can specify an exact path, in which case the "
  4833. "components must be omitted and <literal>distribution</literal> must end with "
  4834. "a slash (/). This is useful for when the case only a particular sub-section "
  4835. "of the archive denoted by the URI is of interest. If <literal>distribution</"
  4836. "literal> does not specify an exact path, at least one <literal>component</"
  4837. "literal> must be present."
  4838. msgstr ""
  4839. #. type: Content of: <refentry><refsect1><para>
  4840. #: sources.list.5.xml:92
  4841. msgid ""
  4842. "<literal>distribution</literal> may also contain a variable, <literal>$(ARCH)"
  4843. "</literal> which expands to the Debian architecture (i386, m68k, "
  4844. "powerpc, ...) used on the system. This permits architecture-independent "
  4845. "<filename>sources.list</filename> files to be used. In general this is only "
  4846. "of interest when specifying an exact path, <literal>APT</literal> will "
  4847. "automatically generate a URI with the current architecture otherwise."
  4848. msgstr ""
  4849. #. type: Content of: <refentry><refsect1><para>
  4850. #: sources.list.5.xml:100
  4851. msgid ""
  4852. "Since only one distribution can be specified per line it may be necessary to "
  4853. "have multiple lines for the same URI, if a subset of all available "
  4854. "distributions or components at that location is desired. APT will sort the "
  4855. "URI list after it has generated a complete set internally, and will collapse "
  4856. "multiple references to the same Internet host, for instance, into a single "
  4857. "connection, so that it does not inefficiently establish an FTP connection, "
  4858. "close it, do something else, and then re-establish a connection to that same "
  4859. "host. This feature is useful for accessing busy FTP sites with limits on the "
  4860. "number of simultaneous anonymous users. APT also parallelizes connections to "
  4861. "different hosts to more effectively deal with sites with low bandwidth."
  4862. msgstr ""
  4863. #. type: Content of: <refentry><refsect1><para>
  4864. #: sources.list.5.xml:112
  4865. msgid ""
  4866. "<literal>options</literal> is always optional and needs to be surounded by "
  4867. "square brackets. It can consist of multiple settings in the form "
  4868. "<literal><replaceable>setting</replaceable>=<replaceable>value</"
  4869. "replaceable></literal>. Multiple settings are separated by spaces. The "
  4870. "following settings are supported by APT, note though that unsupported "
  4871. "settings will be ignored silently:"
  4872. msgstr ""
  4873. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4874. #: sources.list.5.xml:117
  4875. msgid ""
  4876. "<literal>arch=<replaceable>arch1</replaceable>,<replaceable>arch2</"
  4877. "replaceable>,…</literal> can be used to specify for which architectures "
  4878. "packages information should be downloaded. If this option is not set all "
  4879. "architectures defined by the <literal>APT::Architectures</literal> option "
  4880. "will be downloaded."
  4881. msgstr ""
  4882. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4883. #: sources.list.5.xml:121
  4884. msgid ""
  4885. "<literal>trusted=yes</literal> can be set to indicate that packages from "
  4886. "this source are always authenticated even if the <filename>Release</"
  4887. "filename> file is not signed or the signature can't be checked. This "
  4888. "disables parts of &apt-secure; and should therefore only be used in a local "
  4889. "and trusted context. <literal>trusted=no</literal> is the opposite which "
  4890. "handles even correctly authenticated sources as not authenticated."
  4891. msgstr ""
  4892. #. type: Content of: <refentry><refsect1><para>
  4893. #: sources.list.5.xml:128
  4894. msgid ""
  4895. "It is important to list sources in order of preference, with the most "
  4896. "preferred source listed first. Typically this will result in sorting by "
  4897. "speed from fastest to slowest (CD-ROM followed by hosts on a local network, "
  4898. "followed by distant Internet hosts, for example)."
  4899. msgstr ""
  4900. #. type: Content of: <refentry><refsect1><para>
  4901. #: sources.list.5.xml:133
  4902. msgid "Some examples:"
  4903. msgstr ""
  4904. #. type: Content of: <refentry><refsect1><literallayout>
  4905. #: sources.list.5.xml:135
  4906. #, no-wrap
  4907. msgid ""
  4908. "deb http://ftp.debian.org/debian &stable-codename; main contrib non-free\n"
  4909. "deb http://security.debian.org/ &stable-codename;/updates main contrib non-free\n"
  4910. " "
  4911. msgstr ""
  4912. #. type: Content of: <refentry><refsect1><title>
  4913. #: sources.list.5.xml:141
  4914. msgid "URI specification"
  4915. msgstr ""
  4916. #. type: Content of: <refentry><refsect1><para>
  4917. #: sources.list.5.xml:143
  4918. msgid "The currently recognized URI types are:"
  4919. msgstr ""
  4920. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4921. #: sources.list.5.xml:147
  4922. msgid ""
  4923. "The file scheme allows an arbitrary directory in the file system to be "
  4924. "considered an archive. This is useful for NFS mounts and local mirrors or "
  4925. "archives."
  4926. msgstr ""
  4927. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4928. #: sources.list.5.xml:154
  4929. msgid ""
  4930. "The cdrom scheme allows APT to use a local CD-ROM drive with media swapping. "
  4931. "Use the &apt-cdrom; program to create cdrom entries in the source list."
  4932. msgstr ""
  4933. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4934. #: sources.list.5.xml:161
  4935. msgid ""
  4936. "The http scheme specifies an HTTP server for the archive. If an environment "
  4937. "variable <envar>http_proxy</envar> is set with the format http://server:"
  4938. "port/, the proxy server specified in <envar>http_proxy</envar> will be used. "
  4939. "Users of authenticated HTTP/1.1 proxies may use a string of the format "
  4940. "http://user:pass@server:port/. Note that this is an insecure method of "
  4941. "authentication."
  4942. msgstr ""
  4943. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4944. #: sources.list.5.xml:172
  4945. msgid ""
  4946. "The ftp scheme specifies an FTP server for the archive. APT's FTP behavior "
  4947. "is highly configurable; for more information see the &apt-conf; manual page. "
  4948. "Please note that a ftp proxy can be specified by using the <envar>ftp_proxy</"
  4949. "envar> environment variable. It is possible to specify a http proxy (http "
  4950. "proxy servers often understand ftp urls) using this method and ONLY this "
  4951. "method. ftp proxies using http specified in the configuration file will be "
  4952. "ignored."
  4953. msgstr ""
  4954. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4955. #: sources.list.5.xml:183
  4956. msgid ""
  4957. "The copy scheme is identical to the file scheme except that packages are "
  4958. "copied into the cache directory instead of used directly at their location. "
  4959. "This is useful for people using a zip disk to copy files around with APT."
  4960. msgstr ""
  4961. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4962. #: sources.list.5.xml:190
  4963. msgid ""
  4964. "The rsh/ssh method invokes rsh/ssh to connect to a remote host as a given "
  4965. "user and access the files. It is a good idea to do prior arrangements with "
  4966. "RSA keys or rhosts. Access to files on the remote uses standard "
  4967. "<command>find</command> and <command>dd</command> commands to perform the "
  4968. "file transfers from the remote."
  4969. msgstr ""
  4970. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4971. #: sources.list.5.xml:198
  4972. msgid "adding more recognizable URI types"
  4973. msgstr ""
  4974. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4975. #: sources.list.5.xml:200
  4976. msgid ""
  4977. "APT can be extended with more methods shipped in other optional packages "
  4978. "which should follow the nameing scheme <package>apt-transport-"
  4979. "<replaceable>method</replaceable></package>. The APT team e.g. maintains "
  4980. "also the <package>apt-transport-https</package> package which provides "
  4981. "access methods for https-URIs with features similar to the http method, but "
  4982. "other methods for using e.g. debtorrent are also available, see &apt-"
  4983. "transport-debtorrent;."
  4984. msgstr ""
  4985. #. type: Content of: <refentry><refsect1><para>
  4986. #: sources.list.5.xml:212
  4987. msgid ""
  4988. "Uses the archive stored locally (or NFS mounted) at /home/jason/debian for "
  4989. "stable/main, stable/contrib, and stable/non-free."
  4990. msgstr ""
  4991. #. type: Content of: <refentry><refsect1><literallayout>
  4992. #: sources.list.5.xml:214
  4993. #, no-wrap
  4994. msgid "deb file:/home/jason/debian stable main contrib non-free"
  4995. msgstr ""
  4996. #. type: Content of: <refentry><refsect1><para>
  4997. #: sources.list.5.xml:216
  4998. msgid "As above, except this uses the unstable (development) distribution."
  4999. msgstr ""
  5000. #. type: Content of: <refentry><refsect1><literallayout>
  5001. #: sources.list.5.xml:217
  5002. #, no-wrap
  5003. msgid "deb file:/home/jason/debian unstable main contrib non-free"
  5004. msgstr ""
  5005. #. type: Content of: <refentry><refsect1><para>
  5006. #: sources.list.5.xml:219
  5007. msgid "Source line for the above"
  5008. msgstr ""
  5009. #. type: Content of: <refentry><refsect1><literallayout>
  5010. #: sources.list.5.xml:220
  5011. #, no-wrap
  5012. msgid "deb-src file:/home/jason/debian unstable main contrib non-free"
  5013. msgstr ""
  5014. #. type: Content of: <refentry><refsect1><para>
  5015. #: sources.list.5.xml:222
  5016. msgid ""
  5017. "The first line gets package information for the architectures in "
  5018. "<literal>APT::Architectures</literal> while the second always retrieves "
  5019. "<literal>amd64</literal> and <literal>armel</literal>."
  5020. msgstr ""
  5021. #. type: Content of: <refentry><refsect1><literallayout>
  5022. #: sources.list.5.xml:224
  5023. #, no-wrap
  5024. msgid ""
  5025. "deb http://ftp.debian.org/debian &stable-codename; main\n"
  5026. "deb [ arch=amd64,armel ] http://ftp.debian.org/debian &stable-codename; main"
  5027. msgstr ""
  5028. #. type: Content of: <refentry><refsect1><para>
  5029. #: sources.list.5.xml:227
  5030. msgid ""
  5031. "Uses HTTP to access the archive at archive.debian.org, and uses only the "
  5032. "hamm/main area."
  5033. msgstr ""
  5034. #. type: Content of: <refentry><refsect1><literallayout>
  5035. #: sources.list.5.xml:229
  5036. #, no-wrap
  5037. msgid "deb http://archive.debian.org/debian-archive hamm main"
  5038. msgstr ""
  5039. #. type: Content of: <refentry><refsect1><para>
  5040. #: sources.list.5.xml:231
  5041. msgid ""
  5042. "Uses FTP to access the archive at ftp.debian.org, under the debian "
  5043. "directory, and uses only the &stable-codename;/contrib area."
  5044. msgstr ""
  5045. #. type: Content of: <refentry><refsect1><literallayout>
  5046. #: sources.list.5.xml:233
  5047. #, no-wrap
  5048. msgid "deb ftp://ftp.debian.org/debian &stable-codename; contrib"
  5049. msgstr ""
  5050. #. type: Content of: <refentry><refsect1><para>
  5051. #: sources.list.5.xml:235
  5052. msgid ""
  5053. "Uses FTP to access the archive at ftp.debian.org, under the debian "
  5054. "directory, and uses only the unstable/contrib area. If this line appears as "
  5055. "well as the one in the previous example in <filename>sources.list</filename> "
  5056. "a single FTP session will be used for both resource lines."
  5057. msgstr ""
  5058. #. type: Content of: <refentry><refsect1><literallayout>
  5059. #: sources.list.5.xml:239
  5060. #, no-wrap
  5061. msgid "deb ftp://ftp.debian.org/debian unstable contrib"
  5062. msgstr ""
  5063. #. type: Content of: <refentry><refsect1><para><literallayout>
  5064. #: sources.list.5.xml:248
  5065. #, no-wrap
  5066. msgid "deb http://ftp.tlh.debian.org/universe unstable/binary-$(ARCH)/"
  5067. msgstr ""
  5068. #. type: Content of: <refentry><refsect1><para>
  5069. #: sources.list.5.xml:241
  5070. msgid ""
  5071. "Uses HTTP to access the archive at ftp.tlh.debian.org, under the universe "
  5072. "directory, and uses only files found under <filename>unstable/binary-i386</"
  5073. "filename> on i386 machines, <filename>unstable/binary-amd64</filename> on "
  5074. "amd64, and so forth for other supported architectures. [Note this example "
  5075. "only illustrates how to use the substitution variable; official debian "
  5076. "archives are not structured like this] <placeholder type=\"literallayout\" "
  5077. "id=\"0\"/>"
  5078. msgstr ""
  5079. #. type: Content of: <refentry><refsect1><para>
  5080. #: sources.list.5.xml:253
  5081. msgid "&apt-cache; &apt-conf;"
  5082. msgstr ""
  5083. #. type: <title></title>
  5084. #: guide.sgml:4
  5085. #, fuzzy
  5086. msgid "APT User's Guide"
  5087. msgstr "Guida dell'utente di APT"
  5088. #. type: <author></author>
  5089. #: guide.sgml:6 offline.sgml:6
  5090. #, fuzzy
  5091. msgid "<name>Jason Gunthorpe </name><email>jgg@debian.org</email>"
  5092. msgstr "<name>Jason Gunthorpe </name><email>jgg@debian.org</email>"
  5093. #. type: <version></version>
  5094. #: guide.sgml:7
  5095. #, fuzzy
  5096. msgid "$Id: guide.sgml,v 1.7 2003/04/26 23:26:13 doogie Exp $"
  5097. msgstr "$Id: guide.it.sgml,v 1.5 2003/04/26 23:26:13 doogie Exp $"
  5098. #. type: <abstract></abstract>
  5099. #: guide.sgml:11
  5100. #, fuzzy
  5101. msgid ""
  5102. "This document provides an overview of how to use the the APT package manager."
  5103. msgstr "Guida per l'uso del gestore di pacchetti APT."
  5104. #. type: <copyrightsummary></copyrightsummary>
  5105. #: guide.sgml:15
  5106. #, fuzzy
  5107. msgid "Copyright &copy; Jason Gunthorpe, 1998."
  5108. msgstr "Copyright &copy; Jason Gunthorpe, 1998."
  5109. #. type: <p></p>
  5110. #: guide.sgml:21 offline.sgml:22
  5111. #, fuzzy
  5112. msgid ""
  5113. "\"APT\" and this document are free software; you can redistribute them and/"
  5114. "or modify them under the terms of the GNU General Public License as "
  5115. "published by the Free Software Foundation; either version 2 of the License, "
  5116. "or (at your option) any later version."
  5117. msgstr ""
  5118. "\"APT\" e questo documento sono software libero, e li si può ridistribuire e/"
  5119. "o modificare secondo i termini della Licenza Pubblica Generica GNU (GPL), "
  5120. "pubblicata dalla Free Software Foundation, nella versione 2 o (se preferite) "
  5121. "qualsiasi versione successiva."
  5122. #. type: <p></p>
  5123. #: guide.sgml:24 offline.sgml:25
  5124. #, fuzzy
  5125. msgid ""
  5126. "For more details, on Debian systems, see the file /usr/share/common-licenses/"
  5127. "GPL for the full license."
  5128. msgstr ""
  5129. "Per ulteriori dettagli sui sistemi si veda il testo completo della licenza "
  5130. "nel file /usr/share/common-licenses/GPL."
  5131. #. type: <heading></heading>
  5132. #: guide.sgml:32
  5133. #, fuzzy
  5134. msgid "General"
  5135. msgstr "Descrizione generale"
  5136. #. type: <p></p>
  5137. #: guide.sgml:38
  5138. #, fuzzy
  5139. msgid ""
  5140. "The APT package currently contains two sections, the APT <prgn>dselect</"
  5141. "prgn> method and the <prgn>apt-get</prgn> command line user interface. Both "
  5142. "provide a way to install and remove packages as well as download new "
  5143. "packages from the Internet."
  5144. msgstr ""
  5145. "Il pacchetto APT al momento contiene due sezioni, il metodo APT "
  5146. "<prgn>dselect</prgn> e l'interfaccia utente a linea di comando <prgn>apt-"
  5147. "get</prgn>; entrambi danno modo di installare e rimuovere pacchetti, e di "
  5148. "scaricarne altri da Internet."
  5149. #. type: <heading></heading>
  5150. #: guide.sgml:39
  5151. #, fuzzy
  5152. msgid "Anatomy of the Package System"
  5153. msgstr "Anatomia del sistema di pacchettizzazione"
  5154. #. type: <p></p>
  5155. #: guide.sgml:44
  5156. #, fuzzy
  5157. msgid ""
  5158. "The Debian packaging system has a large amount of information associated "
  5159. "with each package to help assure that it integrates cleanly and easily into "
  5160. "the system. The most prominent of its features is the dependency system."
  5161. msgstr ""
  5162. "Il sistema di pacchettizzazione di Debian contiene un gran numero di "
  5163. "informazioni associate a ciascun pacchetto, per assicurarsi che si integri "
  5164. "facilmente ed in maniera pulita nel sistema; la più importante di esse è il "
  5165. "sistema di dipendenze."
  5166. #. type: <p></p>
  5167. #: guide.sgml:52
  5168. #, fuzzy
  5169. msgid ""
  5170. "The dependency system allows individual programs to make use of shared "
  5171. "elements in the system such as libraries. It simplifies placing infrequently "
  5172. "used portions of a program in separate packages to reduce the number of "
  5173. "things the average user is required to install. Also, it allows for choices "
  5174. "in mail transport agents, X servers and so on."
  5175. msgstr ""
  5176. "Il sistema di dipendenze permette ai singoli programmi di fare uso degli "
  5177. "elementi condivisi del sistema, quali le librerie; per ridurre il numero di "
  5178. "elementi che l'utente medio debba installare, le porzioni di programmi che "
  5179. "non vengono usate spesso vengono poste in pacchetti separati. Inoltre, è "
  5180. "possibile avere più di una scelta per cose quali i programmi di posta "
  5181. "elettronica, i server X e così via."
  5182. #. type: <p></p>
  5183. #: guide.sgml:57
  5184. #, fuzzy
  5185. msgid ""
  5186. "The first step to understanding the dependency system is to grasp the "
  5187. "concept of a simple dependency. The meaning of a simple dependency is that a "
  5188. "package requires another package to be installed at the same time to work "
  5189. "properly."
  5190. msgstr ""
  5191. "Il primo passo per capire il sistema di dipendenze è la comprensione del "
  5192. "concetto di dipendenza semplice: un pacchetto richiede che un altro sia "
  5193. "installato insieme ad esso per poter funzionare."
  5194. #. type: <p></p>
  5195. #: guide.sgml:63
  5196. #, fuzzy
  5197. msgid ""
  5198. "For instance, mailcrypt is an emacs extension that aids in encrypting email "
  5199. "with GPG. Without GPGP installed mailcrypt is useless, so mailcrypt has a "
  5200. "simple dependency on GPG. Also, because it is an emacs extension it has a "
  5201. "simple dependency on emacs, without emacs it is completely useless."
  5202. msgstr ""
  5203. "Ad esempio, mail-crypt è un'estensione di emacs che aiuta a criptare le mail "
  5204. "con PGP. Se PGP non è installato, mail-crypt è inutile, quindi mail-crypt ha "
  5205. "una dipendenza semplice da PGP. Inoltre, dato che si tratta di un'estensione "
  5206. "di emacs, mail-crypt dipende anche da emacs, senza il quale è totalmente "
  5207. "inutile."
  5208. #. type: <p></p>
  5209. #: guide.sgml:73
  5210. #, fuzzy
  5211. msgid ""
  5212. "The other important dependency to understand is a conflicting dependency. It "
  5213. "means that a package, when installed with another package, will not work and "
  5214. "may possibly be extremely harmful to the system. As an example consider a "
  5215. "mail transport agent such as sendmail, exim or qmail. It is not possible to "
  5216. "have two mail transport agents installed because both need to listen to the "
  5217. "network to receive mail. Attempting to install two will seriously damage the "
  5218. "system so all mail transport agents have a conflicting dependency with all "
  5219. "other mail transport agents."
  5220. msgstr ""
  5221. "L'altro tipo di dipendenza importante da capire è la dipendenza di "
  5222. "conflitto; con questa, un pacchetto che venga installato insieme ad un altro "
  5223. "pacchetto non funziona, e si hanno seri problemi al sistema. Come esempio, "
  5224. "si consideri un programma di trasporto della posta, quale sendmail, exim o "
  5225. "qmail: non è possibile averne due contemporaneamente, perché entrambi hanno "
  5226. "bisogno di restare in ascolto sulla stessa porta di rete per ricevere la "
  5227. "posta. Tentare di installarne due danneggerebbe seriamente il sistema, "
  5228. "quindi ciascun programma di trasporto della posta ha una dipendenza di "
  5229. "conflitto con tutti gli altri."
  5230. #. type: <p></p>
  5231. #: guide.sgml:83
  5232. #, fuzzy
  5233. msgid ""
  5234. "As an added complication there is the possibility for a package to pretend "
  5235. "to be another package. Consider that exim and sendmail for many intents are "
  5236. "identical, they both deliver mail and understand a common interface. Hence, "
  5237. "the package system has a way for them to declare that they are both mail-"
  5238. "transport-agents. So, exim and sendmail both declare that they provide a "
  5239. "mail-transport-agent and other packages that need a mail transport agent "
  5240. "depend on mail-transport-agent. This can add a great deal of confusion when "
  5241. "trying to manually fix packages."
  5242. msgstr ""
  5243. "Come ulteriore complicazione, c'è la possibilità che un pacchetto voglia "
  5244. "prendere il posto di un altro; ad esempio, exim e sendmail per molte cose "
  5245. "sono identici, dato che entrambi gestiscono la posta e comprendono "
  5246. "un'interfaccia comune, quindi il sistema di pacchettizzazione deve "
  5247. "dichiarare che sono entrambi agenti di trasporto della posta, e che gli "
  5248. "altri pacchetti a cui serve uno dei due devono dipendere da un pacchetto "
  5249. "fittizio agente-di-trasporto-della-posta. Quando si modificano a mano i "
  5250. "pacchetti, questo può portare a moltissima confusione."
  5251. #. type: <p></p>
  5252. #: guide.sgml:88
  5253. #, fuzzy
  5254. msgid ""
  5255. "At any given time a single dependency may be met by packages that are "
  5256. "already installed or it may not be. APT attempts to help resolve dependency "
  5257. "issues by providing a number of automatic algorithms that help in selecting "
  5258. "packages for installation."
  5259. msgstr ""
  5260. "In ciascun momento una singola dipendenza può essere soddisfatta o meno dai "
  5261. "pacchetti già installati; APT cerca di risolvere i problemi di dipendenze "
  5262. "con un buon numero di algoritmi automatici, che aiutano a selezionare i "
  5263. "pacchetti da installare."
  5264. #. type: <heading></heading>
  5265. #: guide.sgml:96
  5266. #, fuzzy
  5267. msgid "apt-get"
  5268. msgstr "apt-get"
  5269. #. type: <p></p>
  5270. #: guide.sgml:102
  5271. #, fuzzy
  5272. msgid ""
  5273. "<prgn>apt-get</prgn> provides a simple way to install packages from the "
  5274. "command line. Unlike <prgn>dpkg</prgn>, <prgn>apt-get</prgn> does not "
  5275. "understand .deb files, it works with the package's proper name and can only "
  5276. "install .deb archives from a <em>Source</em>."
  5277. msgstr ""
  5278. "<prgn>apt-get</prgn> fornisce un modo semplice di installare i pacchetti "
  5279. "dalla linea di comando. Diversamente da <prgn>dpkg</prgn>, <prgn>apt-get</"
  5280. "prgn> non capisce i nomi dei file .deb, ma utilizza il vero nome dei "
  5281. "pacchetti, e può installare archivi .deb solo da una fonte."
  5282. #. type: <p></p>
  5283. #: guide.sgml:109
  5284. #, fuzzy
  5285. msgid ""
  5286. "The first <footnote><p>If you are using an http proxy server you must set "
  5287. "the http_proxy environment variable first, see sources.list(5)</p></"
  5288. "footnote> thing that should be done before using <prgn>apt-get</prgn> is to "
  5289. "fetch the package lists from the <em>Sources</em> so that it knows what "
  5290. "packages are available. This is done with <tt>apt-get update</tt>. For "
  5291. "instance,"
  5292. msgstr ""
  5293. "La prima <footnote><p>Se state usando un proxy server http, dovete prima "
  5294. "ancora impostare la variabile d'ambiente http_proxy; vedere sources.list(5)."
  5295. "</p></footnote> cosa da fare prima di usare <prgn>apt-get</prgn> è impostare "
  5296. "l'elenco dei pacchetti dalle fonti in modo che il programma sappia quali "
  5297. "pacchetti sono disponibili. Lo si fa con <tt>apt-get update</tt>. Ad esempio,"
  5298. #. type: <example></example>
  5299. #: guide.sgml:116
  5300. #, fuzzy, no-wrap
  5301. msgid ""
  5302. "# apt-get update\n"
  5303. "Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages\n"
  5304. "Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n"
  5305. "Reading Package Lists... Done\n"
  5306. "Building Dependency Tree... Done"
  5307. msgstr ""
  5308. "# apt-get update\n"
  5309. "Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages\n"
  5310. "Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n"
  5311. "Reading Package Lists... Done\n"
  5312. "Building Dependency Tree... Done"
  5313. #. type: <p><taglist>
  5314. #: guide.sgml:120
  5315. #, fuzzy
  5316. msgid "Once updated there are several commands that can be used:"
  5317. msgstr "Dopo aver aggiornato l'elenco si possono usare molti comandi:"
  5318. #. type: <tag></tag>
  5319. #: guide.sgml:121
  5320. #, fuzzy
  5321. msgid "upgrade"
  5322. msgstr "upgrade"
  5323. #. type: <p></p>
  5324. #: guide.sgml:131
  5325. #, fuzzy
  5326. msgid ""
  5327. "Upgrade will attempt to gently upgrade the whole system. Upgrade will never "
  5328. "install a new package or remove an existing package, nor will it ever "
  5329. "upgrade a package that might cause some other package to break. This can be "
  5330. "used daily to relatively safely upgrade the system. Upgrade will list all of "
  5331. "the packages that it could not upgrade, this usually means that they depend "
  5332. "on new packages or conflict with some other package. <prgn>dselect</prgn> or "
  5333. "<tt>apt-get install</tt> can be used to force these packages to install."
  5334. msgstr ""
  5335. "Upgrade tenterà di fare un aggiornamento indolore del sistema completo, "
  5336. "senza installare nuovi pacchetti o rimuoverne di esistenti, e senza "
  5337. "aggiornare un pacchetto che possa rovinarne altri. Upgrade farà un elenco di "
  5338. "tutti i pacchetti che non avrà potuto aggiornare, cosa che in genere "
  5339. "significa che questi dipendono da nuovi pacchetti o vanno in conflitto con "
  5340. "altri. Per forzare la loro installazione si può usare <prgn>dselect</prgn> o "
  5341. "<tt>apt-get install</tt>."
  5342. #. type: <tag></tag>
  5343. #: guide.sgml:131
  5344. #, fuzzy
  5345. msgid "install"
  5346. msgstr "install"
  5347. #. type: <p></p>
  5348. #: guide.sgml:140
  5349. #, fuzzy
  5350. msgid ""
  5351. "Install is used to install packages by name. The package is automatically "
  5352. "fetched and installed. This can be useful if you already know the name of "
  5353. "the package to install and do not want to go into a GUI to select it. Any "
  5354. "number of packages may be passed to install, they will all be fetched. "
  5355. "Install automatically attempts to resolve dependency problems with the "
  5356. "listed packages and will print a summary and ask for confirmation if "
  5357. "anything other than its arguments are changed."
  5358. msgstr ""
  5359. "Install viene usato per installare i singoli pacchetti dando il loro nome. "
  5360. "Il pacchetto viene automaticamente scaricato ed installato, cosa molto utile "
  5361. "se già se ne conosce il nome e non si vuole entrare in grafica per "
  5362. "selezionarlo. Al comando si possono passare anche più pacchetti, che saranno "
  5363. "tutti scaricati. L'installazione automatica cerca di risolvere i problemi di "
  5364. "dipendenze con gli altri pacchetti elencati, stampa un riassunto e chiede "
  5365. "conferma se si devono modificare altri pacchetti che non siano quelli sulla "
  5366. "linea di comando."
  5367. #. type: <tag></tag>
  5368. #: guide.sgml:140
  5369. #, fuzzy
  5370. msgid "dist-upgrade"
  5371. msgstr "dist-upgrade"
  5372. #. type: <p></p>
  5373. #: guide.sgml:149
  5374. #, fuzzy
  5375. msgid ""
  5376. "Dist-upgrade is a complete upgrader designed to simplify upgrading between "
  5377. "releases of Debian. It uses a sophisticated algorithm to determine the best "
  5378. "set of packages to install, upgrade and remove to get as much of the system "
  5379. "to the newest release. In some situations it may be desired to use dist-"
  5380. "upgrade rather than spend the time manually resolving dependencies in "
  5381. "<prgn>dselect</prgn>. Once dist-upgrade has completed then <prgn>dselect</"
  5382. "prgn> can be used to install any packages that may have been left out."
  5383. msgstr ""
  5384. "Dist-upgrade fa un aggiornamento completo, progettato in modo da rendere "
  5385. "semplici gli aggiornamenti tra versioni di Debian. Usa un algoritmo "
  5386. "sofisticato per determinare il miglior insieme di pacchetti da installare, "
  5387. "aggiornare e rimuovere per arrivare alla versione più aggiornata del sistema "
  5388. "possibile. In alcune situazioni può essere vantaggioso usare dist-upgrade "
  5389. "invece che sprecare tempo a risolvere manualmente le dipendenze con "
  5390. "<prgn>dselect</prgn>. Una volta completato dist-upgrade, si può usare "
  5391. "<prgn>dselect</prgn> per installare eventuali pacchetti che sono stati "
  5392. "tralasciati."
  5393. #. type: <p></p>
  5394. #: guide.sgml:152
  5395. #, fuzzy
  5396. msgid ""
  5397. "It is important to closely look at what dist-upgrade is going to do, its "
  5398. "decisions may sometimes be quite surprising."
  5399. msgstr ""
  5400. "È importante controllare attentamente cosa intende fare dist-upgrade, dato "
  5401. "che le sue decisioni a volte possono essere abbastanza sorprendenti."
  5402. #. type: <p></p>
  5403. #: guide.sgml:163
  5404. #, fuzzy
  5405. msgid ""
  5406. "<prgn>apt-get</prgn> has several command line options that are detailed in "
  5407. "its man page, <manref section=\"8\" name=\"apt-get\">. The most useful "
  5408. "option is <tt>-d</tt> which does not install the fetched files. If the "
  5409. "system has to download a large number of package it would be undesired to "
  5410. "start installing them in case something goes wrong. When <tt>-d</tt> is used "
  5411. "the downloaded archives can be installed by simply running the command that "
  5412. "caused them to be downloaded again without <tt>-d</tt>."
  5413. msgstr ""
  5414. "<prgn>apt-get</prgn> ha diverse opzioni a linea di comando, che vengono "
  5415. "documentate dettagliatamente nella sua pagina man, <manref section=\"8\" "
  5416. "name=\"apt-get\">. L'opzione più utile è <tt>-d</tt>, che non installa i "
  5417. "file scaricati: se il sistema deve scaricare un gran numero di pacchetti, "
  5418. "non è bene farglieli installare subito, in caso dovesse andare male "
  5419. "qualcosa. Dopo aver usato <tt>-d</tt>, gli archivi scaricati possono essere "
  5420. "installati semplicemente dando di nuovo lo stesso comando senza l'opzione "
  5421. "<tt>-d</tt>."
  5422. #. type: <heading></heading>
  5423. #: guide.sgml:168
  5424. #, fuzzy
  5425. msgid "DSelect"
  5426. msgstr "DSelect"
  5427. #. type: <p></p>
  5428. #: guide.sgml:173
  5429. #, fuzzy
  5430. msgid ""
  5431. "The APT <prgn>dselect</prgn> method provides the complete APT system with "
  5432. "the <prgn>dselect</prgn> package selection GUI. <prgn>dselect</prgn> is used "
  5433. "to select the packages to be installed or removed and APT actually installs "
  5434. "them."
  5435. msgstr ""
  5436. "Il metodo APT di <prgn>dselect</prgn> fornisce tutte le funzionalità di APT "
  5437. "all'interno dell'interfaccia grafica di selezione dei pacchetti "
  5438. "<prgn>dselect</prgn>. <prgn>dselect</prgn> viene usato per selezionare i "
  5439. "pacchetti da installare o rimuovere, ed APT li installa."
  5440. #. type: <p></p>
  5441. #: guide.sgml:184
  5442. #, fuzzy
  5443. msgid ""
  5444. "To enable the APT method you need to select [A]ccess in <prgn>dselect</prgn> "
  5445. "and then choose the APT method. You will be prompted for a set of "
  5446. "<em>Sources</em> which are places to fetch archives from. These can be "
  5447. "remote Internet sites, local Debian mirrors or CD-ROMs. Each source can "
  5448. "provide a fragment of the total Debian archive, APT will automatically "
  5449. "combine them to form a complete set of packages. If you have a CD-ROM then "
  5450. "it is a good idea to specify it first and then specify a mirror so that you "
  5451. "have access to the latest bug fixes. APT will automatically use packages on "
  5452. "your CD-ROM before downloading from the Internet."
  5453. msgstr ""
  5454. "Per abilitare il metodo APT dovete selezionare [A]ccess in <prgn>dselect</"
  5455. "prgn> e scegliere il metodo APT; vi verrà chiesto un insieme di fonti "
  5456. "(<em>Sources</em>), cioè di posti da cui scaricare gli archivi. Tali fonti "
  5457. "possono essere siti Internet remoti, mirror locali di Debian o CDROM; "
  5458. "ciascuna di esse può fornire una parte dell'archivio Debian, ed APT le "
  5459. "combinerà insieme in un set completo di pacchetti. Se avete un CDROM è una "
  5460. "buona idea indicare quello per primo, e poi i mirror, in modo da avere "
  5461. "accesso alle ultime versioni; APT userà in questo modo automaticamente i "
  5462. "pacchetti sul CDROM prima di scaricarli da Internet."
  5463. #. type: <example></example>
  5464. #: guide.sgml:198
  5465. #, fuzzy, no-wrap
  5466. msgid ""
  5467. " Set up a list of distribution source locations\n"
  5468. "\t \n"
  5469. " Please give the base URL of the debian distribution.\n"
  5470. " The access schemes I know about are: http file\n"
  5471. "\t \n"
  5472. " For example:\n"
  5473. " file:/mnt/debian,\n"
  5474. " ftp://ftp.debian.org/debian,\n"
  5475. " http://ftp.de.debian.org/debian,\n"
  5476. " \n"
  5477. " \n"
  5478. " URL [http://llug.sep.bnl.gov/debian]:"
  5479. msgstr ""
  5480. " Set up a list of distribution source locations\n"
  5481. "\t \n"
  5482. " Please give the base URL of the debian distribution.\n"
  5483. " The access schemes I know about are: http file\n"
  5484. "\t \n"
  5485. " For example:\n"
  5486. " file:/mnt/debian,\n"
  5487. " ftp://ftp.debian.org/debian,\n"
  5488. " http://ftp.de.debian.org/debian,\n"
  5489. " \n"
  5490. " \n"
  5491. " URL [http://llug.sep.bnl.gov/debian]:"
  5492. #. type: <p></p>
  5493. #: guide.sgml:205
  5494. #, fuzzy
  5495. msgid ""
  5496. "The <em>Sources</em> setup starts by asking for the base of the Debian "
  5497. "archive, defaulting to a HTTP mirror. Next it asks for the distribution to "
  5498. "get."
  5499. msgstr ""
  5500. "La configurazione delle fonti inizia chiedendo la base dell'archivio Debian, "
  5501. "propone come default un mirror HTTP, e poi chiede la distribuzione da "
  5502. "scaricare."
  5503. #. type: <example></example>
  5504. #: guide.sgml:212
  5505. #, fuzzy, no-wrap
  5506. msgid ""
  5507. " Please give the distribution tag to get or a path to the\n"
  5508. " package file ending in a /. The distribution\n"
  5509. " tags are typically something like: stable unstable testing non-US\n"
  5510. " \n"
  5511. " Distribution [stable]:"
  5512. msgstr ""
  5513. " Please give the distribution tag to get or a path to the\n"
  5514. " package file ending in a /. The distribution\n"
  5515. " tags are typically something like: stable unstable testing non-US\n"
  5516. " \n"
  5517. " Distribution [stable]:"
  5518. #. type: <p></p>
  5519. #: guide.sgml:222
  5520. #, fuzzy
  5521. msgid ""
  5522. "The distribution refers to the Debian version in the archive, <em>stable</"
  5523. "em> refers to the latest released version and <em>unstable</em> refers to "
  5524. "the developmental version. <em>non-US</em> is only available on some mirrors "
  5525. "and refers to packages that contain encryption technology or other things "
  5526. "that cannot be exported from the United States. Importing these packages "
  5527. "into the US is legal however."
  5528. msgstr ""
  5529. "La distribuzione (``distribution'') fa riferimento alla versione Debian "
  5530. "dell'archivio: <em>stable</em> è l'ultima rilasciata, ed <em>unstable</em> è "
  5531. "quella di sviluppo. <em>non-US</em> è disponibile solo su alcuni mirror, e "
  5532. "contiene dei pacchetti in cui viene usata della tecnologia di criptazione o "
  5533. "altre cose che non possano essere esportate dagli Stati Uniti; importare "
  5534. "questi pacchetti negli US è però legale."
  5535. #. type: <example></example>
  5536. #: guide.sgml:228
  5537. #, fuzzy, no-wrap
  5538. msgid ""
  5539. " Please give the components to get\n"
  5540. " The components are typically something like: main contrib non-free\n"
  5541. " \n"
  5542. " Components [main contrib non-free]:"
  5543. msgstr ""
  5544. " Please give the components to get\n"
  5545. " The components are typically something like: main contrib non-free\n"
  5546. " \n"
  5547. " Components [main contrib non-free]:"
  5548. #. type: <p></p>
  5549. #: guide.sgml:236
  5550. #, fuzzy
  5551. msgid ""
  5552. "The components list refers to the list of sub distributions to fetch. The "
  5553. "distribution is split up based on software licenses, main being DFSG free "
  5554. "packages while contrib and non-free contain things that have various "
  5555. "restrictions placed on their use and distribution."
  5556. msgstr ""
  5557. "L'elenco dei componenti (``components'') si riferisce alla lista di sotto-"
  5558. "distribuzioni da scaricare. Ciascuna distribuzione viene divisa in base al "
  5559. "copyright del software: la main contiene pacchetti la cui licenza soddisfa "
  5560. "le DFSG, mentre contrib e non-free contengono software che ha diverse "
  5561. "restrizioni sull'uso e sulla distribuzione."
  5562. #. type: <p></p>
  5563. #: guide.sgml:240
  5564. #, fuzzy
  5565. msgid ""
  5566. "Any number of sources can be added, the setup script will continue to prompt "
  5567. "until you have specified all that you want."
  5568. msgstr ""
  5569. "Si possono inserire un qualsiasi numero di fonti, e lo script di "
  5570. "configurazione continuerà a chiedere fino a che abbiate specificato tutti "
  5571. "gli elementi che volete."
  5572. #. type: <p></p>
  5573. #: guide.sgml:247
  5574. #, fuzzy
  5575. msgid ""
  5576. "Before starting to use <prgn>dselect</prgn> it is necessary to update the "
  5577. "available list by selecting [U]pdate from the menu. This is a superset of "
  5578. "<tt>apt-get update</tt> that makes the fetched information available to "
  5579. "<prgn>dselect</prgn>. [U]pdate must be performed even if <tt>apt-get update</"
  5580. "tt> has been run before."
  5581. msgstr ""
  5582. "Prima di cominciare ad usare <prgn>dselect</prgn> è necessario aggiornare "
  5583. "l'elenco dei pacchetti disponibili selezionando [U]pdate dal menù: si tratta "
  5584. "di un sovrainsieme di ciò che fa <tt>apt-get update</tt>, che rende "
  5585. "l'informazione scaricata disponibile a <prgn>dselect</prgn>. [U]pdate deve "
  5586. "essere fatto anche se prima è stato dato <tt>apt-get update</tt>."
  5587. #. type: <p></p>
  5588. #: guide.sgml:253
  5589. #, fuzzy
  5590. msgid ""
  5591. "You can then go on and make your selections using [S]elect and then perform "
  5592. "the installation using [I]nstall. When using the APT method the [C]onfig and "
  5593. "[R]emove commands have no meaning, the [I]nstall command performs both of "
  5594. "them together."
  5595. msgstr ""
  5596. "Si può a questo punto continuare selezionando i pacchetti desiderati usando "
  5597. "[S]elect e poi installando con [I]nstall. Se si usa il metodo APT, i comandi "
  5598. "[C]onfig e [R]emove non hanno significato, dato che entrambe le fasi sono "
  5599. "contenute in [I]nstall."
  5600. #. type: <p></p>
  5601. #: guide.sgml:258
  5602. #, fuzzy
  5603. msgid ""
  5604. "By default APT will automatically remove the package (.deb) files once they "
  5605. "have been successfully installed. To change this behavior place <tt>Dselect::"
  5606. "clean \"prompt\";</tt> in /etc/apt/apt.conf."
  5607. msgstr ""
  5608. "Per default APT rimuoverà automaticamente i pacchetti che sono stati "
  5609. "installati con successo. Per modificare questo comportamento, si inserisca "
  5610. "<tt>Dselect::clean \"prompt\";</tt> in /etc/apt/apt.conf."
  5611. #. type: <heading></heading>
  5612. #: guide.sgml:264
  5613. #, fuzzy
  5614. msgid "The Interface"
  5615. msgstr "L'interfaccia"
  5616. #. type: <p></p>
  5617. #: guide.sgml:278
  5618. #, fuzzy
  5619. msgid ""
  5620. "Both that APT <prgn>dselect</prgn> method and <prgn>apt-get</prgn> share the "
  5621. "same interface. It is a simple system that generally tells you what it will "
  5622. "do and then goes and does it. <footnote><p>The <prgn>dselect</prgn> method "
  5623. "actually is a set of wrapper scripts to <prgn>apt-get</prgn>. The method "
  5624. "actually provides more functionality than is present in <prgn>apt-get</prgn> "
  5625. "alone.</p></footnote> After printing out a summary of what will happen APT "
  5626. "then will print out some informative status messages so that you can "
  5627. "estimate how far along it is and how much is left to do."
  5628. msgstr ""
  5629. "Entrambi i metodi, <prgn>dselect</prgn> APT ed <prgn>apt-get</prgn>, "
  5630. "condividono la stessa interfaccia; si tratta di un sistema semplice che "
  5631. "indica in genere cosa sta per fare, e poi lo fa. <footnote><p>Il metodo "
  5632. "<prgn>dselect</prgn> è in realtà un insieme di script di wrapper ad "
  5633. "<prgn>apt-get</prgn>. Il metodo fornisce delle funzionalità maggiori del "
  5634. "solo <prgn>apt-get</prgn>.</p></footnote> Dopo la stampa di un riassunto "
  5635. "delle operazioni che saranno fatte, APT stampa dei messaggi informativi "
  5636. "sullo stato del sistema, in modo che possiate avere davanti agli occhi a "
  5637. "quale punto dell'operazione si trova, e quanto ancora si deve aspettare."
  5638. #. type: <heading></heading>
  5639. #: guide.sgml:280
  5640. #, fuzzy
  5641. msgid "Startup"
  5642. msgstr "Avvio"
  5643. #. type: <p></p>
  5644. #: guide.sgml:284
  5645. #, fuzzy
  5646. msgid ""
  5647. "Before all operations except update, APT performs a number of actions to "
  5648. "prepare its internal state. It also does some checks of the system's state. "
  5649. "At any time these operations can be performed by running <tt>apt-get check</"
  5650. "tt>."
  5651. msgstr ""
  5652. "Prima di ciascuna operazione, eccetto l'aggiornamento della lista, APT "
  5653. "compie alcune operazioni per prepararsi, oltre a dei controlli dello stato "
  5654. "del sistema. In qualsiasi momento le stesse operazioni possono essere fatte "
  5655. "con <tt>apt-get check</tt>"
  5656. #. type: <example></example>
  5657. #: guide.sgml:289
  5658. #, fuzzy, no-wrap
  5659. msgid ""
  5660. "# apt-get check\n"
  5661. "Reading Package Lists... Done\n"
  5662. "Building Dependency Tree... Done"
  5663. msgstr ""
  5664. "# apt-get check\n"
  5665. "Reading Package Lists... Done\n"
  5666. "Building Dependancy Tree... Done"
  5667. #. type: <p></p>
  5668. #: guide.sgml:297
  5669. #, fuzzy
  5670. msgid ""
  5671. "The first thing it does is read all the package files into memory. APT uses "
  5672. "a caching scheme so this operation will be faster the second time it is run. "
  5673. "If some of the package files are not found then they will be ignored and a "
  5674. "warning will be printed when apt-get exits."
  5675. msgstr ""
  5676. "La prima cosa che fa è leggere tutti i file dei pacchetti in memoria, usando "
  5677. "uno schema di caching in modo da rendere la stessa operazione più veloce la "
  5678. "seconda volta che la si fa. Se alcuni dei file dei pacchetti non vengono "
  5679. "trovati, sono ignorati e viene stampato un avvertimento all'uscita di apt-"
  5680. "get."
  5681. #. type: <p></p>
  5682. #: guide.sgml:303
  5683. #, fuzzy
  5684. msgid ""
  5685. "The final operation performs a detailed analysis of the system's "
  5686. "dependencies. It checks every dependency of every installed or unpacked "
  5687. "package and considers if it is OK. Should this find a problem then a report "
  5688. "will be printed out and <prgn>apt-get</prgn> will refuse to run."
  5689. msgstr ""
  5690. "L'operazione finale consiste in un'analisi dettagliata delle dipendenze del "
  5691. "sistema: viene controllato che tutte le dipendenze dei singoli pacchetti "
  5692. "installati o non scompattati siano soddisfatte. Se vengono individuati dei "
  5693. "problemi, viene stampato un resoconto, ed <prgn>apt-get</prgn> esce senza "
  5694. "eseguire alcuna operazione."
  5695. #. type: <example></example>
  5696. #: guide.sgml:320
  5697. #, fuzzy, no-wrap
  5698. msgid ""
  5699. "# apt-get check\n"
  5700. "Reading Package Lists... Done\n"
  5701. "Building Dependency Tree... Done\n"
  5702. "You might want to run apt-get -f install' to correct these.\n"
  5703. "Sorry, but the following packages have unmet dependencies:\n"
  5704. " 9fonts: Depends: xlib6g but it is not installed\n"
  5705. " uucp: Depends: mailx but it is not installed\n"
  5706. " blast: Depends: xlib6g (>= 3.3-5) but it is not installed\n"
  5707. " adduser: Depends: perl-base but it is not installed\n"
  5708. " aumix: Depends: libgpmg1 but it is not installed\n"
  5709. " debiandoc-sgml: Depends: sgml-base but it is not installed\n"
  5710. " bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed\n"
  5711. " cthugha: Depends: svgalibg1 but it is not installed\n"
  5712. " Depends: xlib6g (>= 3.3-5) but it is not installed\n"
  5713. " libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1)"
  5714. msgstr ""
  5715. "# apt-get check\n"
  5716. "Reading Package Lists... Done\n"
  5717. "Building Dependancy Tree... Done\n"
  5718. "You might want to run apt-get -f install' to correct these.\n"
  5719. "Sorry, but the following packages have unmet dependencies:\n"
  5720. " 9fonts: Depends: xlib6g but it is not installed\n"
  5721. " uucp: Depends: mailx but it is not installed\n"
  5722. " blast: Depends: xlib6g (>= 3.3-5) but it is not installed\n"
  5723. " adduser: Depends: perl-base but it is not installed\n"
  5724. " aumix: Depends: libgpmg1 but it is not installed\n"
  5725. " debiandoc-sgml: Depends: sgml-base but it is not installed\n"
  5726. " bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed\n"
  5727. " cthugha: Depends: svgalibg1 but it is not installed\n"
  5728. " Depends: xlib6g (>= 3.3-5) but it is not installed\n"
  5729. " libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1)"
  5730. #. type: <p></p>
  5731. #: guide.sgml:329
  5732. #, fuzzy
  5733. msgid ""
  5734. "In this example the system has many problems, including a serious problem "
  5735. "with libreadlineg2. For each package that has unmet dependencies a line is "
  5736. "printed out indicating the package with the problem and the dependencies "
  5737. "that are unmet. A short explanation of why the package has a dependency "
  5738. "problem is also included."
  5739. msgstr ""
  5740. "In questo esempio il sistema ha molti problemi, tra cui uno piuttosto serio "
  5741. "con la libreadlineg2. Per ciascun pacchetto che ha dipendenze non "
  5742. "soddisfatte, viene stampata una linea che indica il pacchetto che crea il "
  5743. "problema e quali problemi ci sono. Viene inclusa inoltre una breve "
  5744. "spiegazione del perché il pacchetto ha un problema di dipendenze."
  5745. #. type: <p></p>
  5746. #: guide.sgml:337
  5747. #, fuzzy
  5748. msgid ""
  5749. "There are two ways a system can get into a broken state like this. The first "
  5750. "is caused by <prgn>dpkg</prgn> missing some subtle relationships between "
  5751. "packages when performing upgrades. <footnote><p>APT however considers all "
  5752. "known dependencies and attempts to prevent broken packages</p></footnote>. "
  5753. "The second is if a package installation fails during an operation. In this "
  5754. "situation a package may have been unpacked without its dependents being "
  5755. "installed."
  5756. msgstr ""
  5757. "Ci sono due modi in cui un sistema possa arrivare in uno stato problematico "
  5758. "di questo genere: il primo è causato dal fatto che <prgn>dpkg</prgn> possa "
  5759. "mancare alcune relazioni sottili tra pacchetti durante un aggiornamento del "
  5760. "sistema<footnote><p>APT considera comunque tutte le dipendenze note, e cerca "
  5761. "di prevenire problemi ai pacchetti</p></footnote>; il secondo è possibile se "
  5762. "l'installazione di un pacchetto fallisce, ed in questo caso è possibile che "
  5763. "un pacchetto venga scompattato senza che tutti quelli da cui dipende siano "
  5764. "stati installati."
  5765. #. type: <p></p>
  5766. #: guide.sgml:345
  5767. #, fuzzy
  5768. msgid ""
  5769. "The second situation is much less serious than the first because APT places "
  5770. "certain constraints on the order that packages are installed. In both cases "
  5771. "supplying the <tt>-f</tt> option to <prgn>apt-get</prgn> will cause APT to "
  5772. "deduce a possible solution to the problem and then continue on. The APT "
  5773. "<prgn>dselect</prgn> method always supplies the <tt>-f</tt> option to allow "
  5774. "for easy continuation of failed maintainer scripts."
  5775. msgstr ""
  5776. "La seconda possibilità è meno seria della prima, dato che APT gestisce "
  5777. "l'ordine di installazione dei pacchetti; in entrambi i casi l'opzione <tt>-"
  5778. "f</tt> di <prgn>apt-get</prgn> gli farà trovare una soluzione e lo farà "
  5779. "continuare. Il metodo APT di <prgn>dselect</prgn> comprende sempre l'opzione "
  5780. "<tt>-f</tt> per permettere di configurare facilmente anche i pacchetti con "
  5781. "script errati."
  5782. #. type: <p></p>
  5783. #: guide.sgml:351
  5784. #, fuzzy
  5785. msgid ""
  5786. "However, if the <tt>-f</tt> option is used to correct a seriously broken "
  5787. "system caused by the first case then it is possible that it will either fail "
  5788. "immediately or the installation sequence will fail. In either case it is "
  5789. "necessary to manually use dpkg (possibly with forcing options) to correct "
  5790. "the situation enough to allow APT to proceed."
  5791. msgstr ""
  5792. "Se viene usata però l'opzione <tt>-f</tt> per correggere un sistema in uno "
  5793. "stato molto problematico, è possibile che anche con l'opzione il programma "
  5794. "fallisca, subito o durante la sequenza di installazione. In entrambi i casi "
  5795. "è necessario usare dpkg a mano (probabilmente usando delle opzioni di "
  5796. "forzatura) per correggere quanto basta per poter fare continuare APT."
  5797. #. type: <heading></heading>
  5798. #: guide.sgml:356
  5799. #, fuzzy
  5800. msgid "The Status Report"
  5801. msgstr "Il resoconto sullo stato"
  5802. #. type: <p></p>
  5803. #: guide.sgml:363
  5804. #, fuzzy
  5805. msgid ""
  5806. "Before proceeding <prgn>apt-get</prgn> will present a report on what will "
  5807. "happen. Generally the report reflects the type of operation being performed "
  5808. "but there are several common elements. In all cases the lists reflect the "
  5809. "final state of things, taking into account the <tt>-f</tt> option and any "
  5810. "other relevant activities to the command being executed."
  5811. msgstr ""
  5812. "Prima di procedere, <prgn>apt-get</prgn> presenterà un resoconto delle "
  5813. "operazioni che sta per fare. In genere tale resoconto varierà con il tipo di "
  5814. "operazioni da fare, ma ci sono alcuni elementi comuni: in tutti i casi gli "
  5815. "elenchi dipendono dallo stato finale delle cose, e tengono conto "
  5816. "dell'opzione <tt>-f</tt> e di altre attività rilevanti per il comando da "
  5817. "eseguire."
  5818. #. type: <heading></heading>
  5819. #: guide.sgml:364
  5820. #, fuzzy
  5821. msgid "The Extra Package list"
  5822. msgstr "L'elenco dei pacchetti Extra"
  5823. #. type: <example></example>
  5824. #: guide.sgml:372
  5825. #, fuzzy, no-wrap
  5826. msgid ""
  5827. "The following extra packages will be installed:\n"
  5828. " libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl\n"
  5829. " mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base\n"
  5830. " bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy\n"
  5831. " squake pgp-i python-base debmake ldso perl libreadlineg2\n"
  5832. " ssh"
  5833. msgstr ""
  5834. "The following extra packages will be installed:\n"
  5835. " libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl\n"
  5836. " mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base\n"
  5837. " bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy\n"
  5838. " squake pgp-i python-base debmake ldso perl libreadlineg2\n"
  5839. " ssh"
  5840. #. type: <p></p>
  5841. #: guide.sgml:379
  5842. #, fuzzy
  5843. msgid ""
  5844. "The Extra Package list shows all of the packages that will be installed or "
  5845. "upgraded in excess of the ones mentioned on the command line. It is only "
  5846. "generated for an <tt>install</tt> command. The listed packages are often the "
  5847. "result of an Auto Install."
  5848. msgstr ""
  5849. "L'elenco dei pacchetti Extra mostra tutti i pacchetti che verranno "
  5850. "installati o aggiornati oltre a quelli indicati sulla linea di comando. "
  5851. "Viene generato solo per il comando <tt>install</tt>. I pacchetti elencati "
  5852. "sono spesso il risultato di un'operazione di auto installazione (Auto "
  5853. "Install)."
  5854. #. type: <heading></heading>
  5855. #: guide.sgml:382
  5856. #, fuzzy
  5857. msgid "The Packages to Remove"
  5858. msgstr "I pacchetti da rimuovere"
  5859. #. type: <example></example>
  5860. #: guide.sgml:389
  5861. #, fuzzy, no-wrap
  5862. msgid ""
  5863. "The following packages will be REMOVED:\n"
  5864. " xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix\n"
  5865. " xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel\n"
  5866. " xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid\n"
  5867. " nas xpilot xfig"
  5868. msgstr ""
  5869. "The following packages will be REMOVED:\n"
  5870. " xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix\n"
  5871. " xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel\n"
  5872. " xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid\n"
  5873. " nas xpilot xfig"
  5874. #. type: <p></p>
  5875. #: guide.sgml:399
  5876. #, fuzzy
  5877. msgid ""
  5878. "The Packages to Remove list shows all of the packages that will be removed "
  5879. "from the system. It can be shown for any of the operations and should be "
  5880. "given a careful inspection to ensure nothing important is to be taken off. "
  5881. "The <tt>-f</tt> option is especially good at generating packages to remove "
  5882. "so extreme care should be used in that case. The list may contain packages "
  5883. "that are going to be removed because they are only partially installed, "
  5884. "possibly due to an aborted installation."
  5885. msgstr ""
  5886. "L'elenco dei pacchetti da rimuovere (Remove) indica tutti i pacchetti che "
  5887. "verranno rimossi dal sistema. Può essere mostrato per una qualsiasi delle "
  5888. "operazioni, e deve sempre essere esaminato attentamente per assicurarsi che "
  5889. "non venga eliminato qualcosa di importante. Con l'opzione <tt>-f</tt> è "
  5890. "particolarmente probabile che vengano eliminati dei pacchetti, ed in questo "
  5891. "caso va fatta estrema attenzione. La lista può contenere dei pacchetti che "
  5892. "verranno rimossi perché sono già rimossi parzialmente, forse a causa di "
  5893. "un'installazione non terminata correttamente."
  5894. #. type: <heading></heading>
  5895. #: guide.sgml:402
  5896. #, fuzzy
  5897. msgid "The New Packages list"
  5898. msgstr "L'elenco dei nuovi pacchetti installati"
  5899. #. type: <example></example>
  5900. #: guide.sgml:406
  5901. #, fuzzy, no-wrap
  5902. msgid ""
  5903. "The following NEW packages will installed:\n"
  5904. " zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base"
  5905. msgstr ""
  5906. "The following NEW packages will installed:\n"
  5907. " zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base"
  5908. #. type: <p></p>
  5909. #: guide.sgml:411
  5910. #, fuzzy
  5911. msgid ""
  5912. "The New Packages list is simply a reminder of what will happen. The packages "
  5913. "listed are not presently installed in the system but will be when APT is "
  5914. "done."
  5915. msgstr ""
  5916. "L'elenco dei nuovi pacchetti installati (New) è semplicemente un appunto su "
  5917. "quello che accadrà. I pacchetti nell'elenco non sono al momento installati "
  5918. "nel sistema, ma lo saranno alla fine delle operazioni di APT."
  5919. #. type: <heading></heading>
  5920. #: guide.sgml:414
  5921. #, fuzzy
  5922. msgid "The Kept Back list"
  5923. msgstr "L'elenco dei pacchetti trattenuti"
  5924. #. type: <example></example>
  5925. #: guide.sgml:419
  5926. #, fuzzy, no-wrap
  5927. msgid ""
  5928. "The following packages have been kept back\n"
  5929. " compface man-db tetex-base msql libpaper svgalib1\n"
  5930. " gs snmp arena lynx xpat2 groff xscreensaver"
  5931. msgstr ""
  5932. "The following packages have been kept back\n"
  5933. " compface man-db tetex-base msql libpaper svgalib1\n"
  5934. " gs snmp arena lynx xpat2 groff xscreensaver"
  5935. #. type: <p></p>
  5936. #: guide.sgml:428
  5937. #, fuzzy
  5938. msgid ""
  5939. "Whenever the whole system is being upgraded there is the possibility that "
  5940. "new versions of packages cannot be installed because they require new things "
  5941. "or conflict with already installed things. In this case the package will "
  5942. "appear in the Kept Back list. The best way to convince packages listed there "
  5943. "to install is with <tt>apt-get install</tt> or by using <prgn>dselect</prgn> "
  5944. "to resolve their problems."
  5945. msgstr ""
  5946. "In ogni caso in cui il sistema viene aggiornato nel suo insieme, c'è la "
  5947. "possibilità che non possano venire installate nuove versioni di alcuni "
  5948. "pacchetti, dato che potrebbero richiedere l'installazione di pacchetti non "
  5949. "presenti nel sistema, o entrare in conflitto con altri già presenti. In "
  5950. "questo caso, il pacchetto viene elencato nella lista di quelli trattenuti "
  5951. "(Kept Back). Il miglior modo per convincere i pacchetti elencati in questa "
  5952. "lista è di installarli con <tt>apt-get install</tt> o usare <prgn>dselect</"
  5953. "prgn> per risolvere i problemi."
  5954. #. type: <heading></heading>
  5955. #: guide.sgml:431
  5956. #, fuzzy
  5957. msgid "Held Packages warning"
  5958. msgstr "Messaggi di attenzione sui pacchetti trattenuti"
  5959. #. type: <example></example>
  5960. #: guide.sgml:435
  5961. #, fuzzy, no-wrap
  5962. msgid ""
  5963. "The following held packages will be changed:\n"
  5964. " cvs"
  5965. msgstr ""
  5966. "The following held packages will be changed:\n"
  5967. " cvs"
  5968. #. type: <p></p>
  5969. #: guide.sgml:441
  5970. #, fuzzy
  5971. msgid ""
  5972. "Sometimes you can ask APT to install a package that is on hold, in such a "
  5973. "case it prints out a warning that the held package is going to be changed. "
  5974. "This should only happen during dist-upgrade or install."
  5975. msgstr ""
  5976. "A volte si può richiedere ad APT di installare un pacchetto che è stato "
  5977. "trattenuto; in questi casi viene stampato un messaggio di attenzione, che "
  5978. "avverte che il pacchetto verrà modificato. Questo dovrebbe accadere solo "
  5979. "durante operazioni di dist-upgrade o di install."
  5980. #. type: <heading></heading>
  5981. #: guide.sgml:444
  5982. #, fuzzy
  5983. msgid "Final summary"
  5984. msgstr "Resoconto finale"
  5985. #. type: <p></p>
  5986. #: guide.sgml:447
  5987. #, fuzzy
  5988. msgid ""
  5989. "Finally, APT will print out a summary of all the changes that will occur."
  5990. msgstr ""
  5991. "Infine, APT stamperà un riassunto di tutte le modifiche che accadranno."
  5992. #. type: <example></example>
  5993. #: guide.sgml:452
  5994. #, fuzzy, no-wrap
  5995. msgid ""
  5996. "206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded.\n"
  5997. "12 packages not fully installed or removed.\n"
  5998. "Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used."
  5999. msgstr ""
  6000. "206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded.\n"
  6001. "12 packages not fully installed or removed.\n"
  6002. "Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used."
  6003. #. type: <p></p>
  6004. #: guide.sgml:470
  6005. #, fuzzy
  6006. msgid ""
  6007. "The first line of the summary simply is a reduced version of all of the "
  6008. "lists and includes the number of upgrades - that is packages already "
  6009. "installed that have new versions available. The second line indicates the "
  6010. "number of poorly configured packages, possibly the result of an aborted "
  6011. "installation. The final line shows the space requirements that the "
  6012. "installation needs. The first pair of numbers refer to the size of the "
  6013. "archive files. The first number indicates the number of bytes that must be "
  6014. "fetched from remote locations and the second indicates the total size of all "
  6015. "the archives required. The next number indicates the size difference between "
  6016. "the presently installed packages and the newly installed packages. It is "
  6017. "roughly equivalent to the space required in /usr after everything is done. "
  6018. "If a large number of packages are being removed then the value may indicate "
  6019. "the amount of space that will be freed."
  6020. msgstr ""
  6021. "La prima linea del riassunto è semplicemente una versione ridotta di tutte "
  6022. "le liste, ed include il numero di aggiornamenti -- cioè dei pacchetti già "
  6023. "installati per cui sono disponibili nuove versioni. La seconda linea indica "
  6024. "il numero di pacchetti con problemi di configurazione, probabilmente in "
  6025. "conseguenza di un'installazione non andata a buon fine. La linea finale "
  6026. "indica i requisiti di spazio dell'installazione: i primi due numeri indicano "
  6027. "rispettivamente il numero di byte che devono essere trasferiti da posizioni "
  6028. "remote, ed il secondo la dimensione totale di tutti gli archivi necessari "
  6029. "per l'installazione. Il numero successivo indica la differenza in dimensione "
  6030. "tra i pacchetti già installati e quelli che lo saranno, ed è "
  6031. "approssimativamente equivalente allo spazio richiesto in /usr dopo "
  6032. "l'installazione. Se si stanno rimuovendo dei pacchetti, il valore può "
  6033. "indicare lo spazio che verrà liberato."
  6034. #. type: <p></p>
  6035. #: guide.sgml:473
  6036. #, fuzzy
  6037. msgid ""
  6038. "Some other reports can be generated by using the -u option to show packages "
  6039. "to upgrade, they are similar to the previous examples."
  6040. msgstr ""
  6041. "Si possono generare altri resoconti usando l'opzione -u per mostrare i "
  6042. "pacchetti da aggiornare, ma sono simili all'esempio precedente."
  6043. #. type: <heading></heading>
  6044. #: guide.sgml:477
  6045. #, fuzzy
  6046. msgid "The Status Display"
  6047. msgstr "La visualizzazione dello stato"
  6048. #. type: <p></p>
  6049. #: guide.sgml:481
  6050. #, fuzzy
  6051. msgid ""
  6052. "During the download of archives and package files APT prints out a series of "
  6053. "status messages."
  6054. msgstr ""
  6055. "Durante il download degli archivi e dei file dei pacchetti, APT stampa una "
  6056. "serie di messaggi di stato."
  6057. #. type: <example></example>
  6058. #: guide.sgml:490
  6059. #, fuzzy, no-wrap
  6060. msgid ""
  6061. "# apt-get update\n"
  6062. "Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages\n"
  6063. "Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n"
  6064. "Hit http://llug.sep.bnl.gov/debian/ testing/main Packages\n"
  6065. "Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages\n"
  6066. "Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages\n"
  6067. "11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s"
  6068. msgstr ""
  6069. "# apt-get update\n"
  6070. "Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages\n"
  6071. "Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n"
  6072. "Hit http://llug.sep.bnl.gov/debian/ testing/main Packages\n"
  6073. "Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages\n"
  6074. "Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages\n"
  6075. "11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s"
  6076. #. type: <p></p>
  6077. #: guide.sgml:500
  6078. #, fuzzy
  6079. msgid ""
  6080. "The lines starting with <em>Get</em> are printed out when APT begins to "
  6081. "fetch a file while the last line indicates the progress of the download. The "
  6082. "first percent value on the progress line indicates the total percent done of "
  6083. "all files. Unfortunately since the size of the Package files is unknown "
  6084. "<tt>apt-get update</tt> estimates the percent done which causes some "
  6085. "inaccuracies."
  6086. msgstr ""
  6087. "Le linee che cominciano con <em>Get</em> vengono stampate quando APT inizia "
  6088. "a scaricare un file, e l'ultima linea indica il progresso dell'operazione. "
  6089. "Il primo valore in percentuale indica la percentuale totale di tutti i file; "
  6090. "dato che la dimensione dei file Package non è nota, purtroppo a volte "
  6091. "<tt>apt-get update</tt> fa una stima poco accurata."
  6092. #. type: <p></p>
  6093. #: guide.sgml:509
  6094. #, fuzzy
  6095. msgid ""
  6096. "The next section of the status line is repeated once for each download "
  6097. "thread and indicates the operation being performed and some useful "
  6098. "information about what is happening. Sometimes this section will simply read "
  6099. "<em>Forking</em> which means the OS is loading the download module. The "
  6100. "first word after the [ is the fetch number as shown on the history lines. "
  6101. "The next word is the short form name of the object being downloaded. For "
  6102. "archives it will contain the name of the package that is being fetched."
  6103. msgstr ""
  6104. "La sezione successiva della linea di stato viene ripetuta una volta per "
  6105. "ciascuna fase del download, ed indica l'operazione in corso, insieme ad "
  6106. "alcune informazioni utili su cosa stia accadendo. A volte questa sezione "
  6107. "contiene solamente <em>Forking</em>, che significa che il sistema operativo "
  6108. "sta caricando il modulo. La prima parola dopo la parentesi quadra aperta è "
  6109. "il nome breve dell'oggetto che si sta scaricando, che per gli archivi è il "
  6110. "nome del pacchetto."
  6111. #. type: <p></p>
  6112. #: guide.sgml:524
  6113. #, fuzzy
  6114. msgid ""
  6115. "Inside of the single quote is an informative string indicating the progress "
  6116. "of the negotiation phase of the download. Typically it progresses from "
  6117. "<em>Connecting</em> to <em>Waiting for file</em> to <em>Downloading</em> or "
  6118. "<em>Resuming</em>. The final value is the number of bytes downloaded from "
  6119. "the remote site. Once the download begins this is represented as "
  6120. "<tt>102/10.2k</tt> indicating that 102 bytes have been fetched and 10.2 "
  6121. "kilobytes is expected. The total size is always shown in 4 figure notation "
  6122. "to preserve space. After the size display is a percent meter for the file "
  6123. "itself. The second last element is the instantaneous average speed. This "
  6124. "values is updated every 5 seconds and reflects the rate of data transfer for "
  6125. "that period. Finally is shown the estimated transfer time. This is updated "
  6126. "regularly and reflects the time to complete everything at the shown transfer "
  6127. "rate."
  6128. msgstr ""
  6129. "All'interno delle virgolette c'è una stringa informativa, che indica il "
  6130. "progresso della fase di negoziazione del download. Tipicamente comincia con "
  6131. "<em>Connecting</em>, procede con <em>Waiting for file</em> e poi con "
  6132. "<em>Downloading</em> o <em>Resuming</em>. Il valore finale è il numero di "
  6133. "byte che sono stati scaricati dal sito remoto: una volta cominciato il "
  6134. "download viene rappresentato come <tt>102/10.2k</tt>, che indica che sono "
  6135. "stati scaricati 102 byte di 10.2 kilobyte. La dimensione totale viene sempre "
  6136. "espressa in notazione a quattro cifre, per risparmiare spazio. Dopo la "
  6137. "dimensione viene indicato un indicatore progressivo della percentuale del "
  6138. "file. Il penultimo elemento è la velocità istantanea media, che viene "
  6139. "aggiornata ogni 5 secondi, e riflette la velocità di trasferimento dei dati "
  6140. "in quel periodo. Infine, viene visualizzato il tempo stimato per il "
  6141. "trasferimento, che viene aggiornato periodicamente e riflette il tempo "
  6142. "necessario per completare tutte le operazioni alla velocità di trasferimento "
  6143. "mostrata."
  6144. #. type: <p></p>
  6145. #: guide.sgml:530
  6146. #, fuzzy
  6147. msgid ""
  6148. "The status display updates every half second to provide a constant feedback "
  6149. "on the download progress while the Get lines scroll back whenever a new file "
  6150. "is started. Since the status display is constantly updated it is unsuitable "
  6151. "for logging to a file, use the <tt>-q</tt> option to remove the status "
  6152. "display."
  6153. msgstr ""
  6154. "La visualizzazione dello stato viene aggiornata ogni mezzo secondo per "
  6155. "fornire un feedback costante del processo di download, e le linee Get "
  6156. "scorrono indietro quando viene cominciato il download di un nuovo file. Dato "
  6157. "che la visualizzazione dello stato viene costantemente aggiornata, non è "
  6158. "adatta per essere registrata in un file; per non visualizzarla si può usare "
  6159. "l'opzione <tt>-q</tt>."
  6160. #. type: <heading></heading>
  6161. #: guide.sgml:535
  6162. #, fuzzy
  6163. msgid "Dpkg"
  6164. msgstr "Dpkg"
  6165. #. type: <p></p>
  6166. #: guide.sgml:542
  6167. #, fuzzy
  6168. msgid ""
  6169. "APT uses <prgn>dpkg</prgn> for installing the archives and will switch over "
  6170. "to the <prgn>dpkg</prgn> interface once downloading is completed. "
  6171. "<prgn>dpkg</prgn> will also ask a number of questions as it processes the "
  6172. "packages and the packages themselves may also ask several questions. Before "
  6173. "each question there is usually a description of what it is asking and the "
  6174. "questions are too varied to discuss completely here."
  6175. msgstr ""
  6176. "APT usa <prgn>dpkg</prgn> per installare gli archivi e passerà "
  6177. "all'interfaccia <prgn>dpkg</prgn> una volta finito il download. <prgn>dpkg</"
  6178. "prgn> porrà anche alcune domande durante la manipolazione dei pacchetti, ed "
  6179. "i pacchetti stessi potranno farne altre. Prima di ciascuna domanda viene "
  6180. "proposta una descrizione di quello che sta per chiedere, e le domande sono "
  6181. "troppo diverse per poter essere discusse in maniera completa in questa "
  6182. "occasione."
  6183. #. type: <title></title>
  6184. #: offline.sgml:4
  6185. msgid "Using APT Offline"
  6186. msgstr ""
  6187. #. type: <version></version>
  6188. #: offline.sgml:7
  6189. #, fuzzy
  6190. msgid "$Id: offline.sgml,v 1.8 2003/02/12 15:06:41 doogie Exp $"
  6191. msgstr "$Id: guide.it.sgml,v 1.5 2003/04/26 23:26:13 doogie Exp $"
  6192. #. type: <abstract></abstract>
  6193. #: offline.sgml:12
  6194. msgid ""
  6195. "This document describes how to use APT in a non-networked environment, "
  6196. "specifically a 'sneaker-net' approach for performing upgrades."
  6197. msgstr ""
  6198. #. type: <copyrightsummary></copyrightsummary>
  6199. #: offline.sgml:16
  6200. #, fuzzy
  6201. msgid "Copyright &copy; Jason Gunthorpe, 1999."
  6202. msgstr "Copyright &copy; Jason Gunthorpe, 1998."
  6203. #. type: <heading></heading>
  6204. #: offline.sgml:32
  6205. msgid "Introduction"
  6206. msgstr ""
  6207. #. type: <heading></heading>
  6208. #: offline.sgml:34 offline.sgml:65 offline.sgml:180
  6209. msgid "Overview"
  6210. msgstr ""
  6211. #. type: <p></p>
  6212. #: offline.sgml:40
  6213. msgid ""
  6214. "Normally APT requires direct access to a Debian archive, either from a local "
  6215. "media or through a network. Another common complaint is that a Debian "
  6216. "machine is on a slow link, such as a modem and another machine has a very "
  6217. "fast connection but they are physically distant."
  6218. msgstr ""
  6219. #. type: <p></p>
  6220. #: offline.sgml:51
  6221. msgid ""
  6222. "The solution to this is to use large removable media such as a Zip disc or a "
  6223. "SuperDisk disc. These discs are not large enough to store the entire Debian "
  6224. "archive but can easily fit a subset large enough for most users. The idea is "
  6225. "to use APT to generate a list of packages that are required and then fetch "
  6226. "them onto the disc using another machine with good connectivity. It is even "
  6227. "possible to use another Debian machine with APT or to use a completely "
  6228. "different OS and a download tool like wget. Let <em>remote host</em> mean "
  6229. "the machine downloading the packages, and <em>target host</em> the one with "
  6230. "bad or no connection."
  6231. msgstr ""
  6232. #. type: <p></p>
  6233. #: offline.sgml:57
  6234. msgid ""
  6235. "This is achieved by creatively manipulating the APT configuration file. The "
  6236. "essential premise to tell APT to look on a disc for it's archive files. Note "
  6237. "that the disc should be formated with a filesystem that can handle long file "
  6238. "names such as ext2, fat32 or vfat."
  6239. msgstr ""
  6240. #. type: <heading></heading>
  6241. #: offline.sgml:63
  6242. msgid "Using APT on both machines"
  6243. msgstr ""
  6244. #. type: <p><example>
  6245. #: offline.sgml:71
  6246. msgid ""
  6247. "APT being available on both machines gives the simplest configuration. The "
  6248. "basic idea is to place a copy of the status file on the disc and use the "
  6249. "remote machine to fetch the latest package files and decide which packages "
  6250. "to download. The disk directory structure should look like:"
  6251. msgstr ""
  6252. #. type: <example></example>
  6253. #: offline.sgml:80
  6254. #, no-wrap
  6255. msgid ""
  6256. " /disc/\n"
  6257. " archives/\n"
  6258. " partial/\n"
  6259. " lists/\n"
  6260. " partial/\n"
  6261. " status\n"
  6262. " sources.list\n"
  6263. " apt.conf"
  6264. msgstr ""
  6265. #. type: <heading></heading>
  6266. #: offline.sgml:88
  6267. msgid "The configuration file"
  6268. msgstr ""
  6269. #. type: <p></p>
  6270. #: offline.sgml:96
  6271. msgid ""
  6272. "The configuration file should tell APT to store its files on the disc and to "
  6273. "use the configuration files on the disc as well. The sources.list should "
  6274. "contain the proper sites that you wish to use from the remote machine, and "
  6275. "the status file should be a copy of <em>/var/lib/dpkg/status</em> from the "
  6276. "<em>target host</em>. Please note, if you are using a local archive you must "
  6277. "use copy URIs, the syntax is identical to file URIs."
  6278. msgstr ""
  6279. #. type: <p><example>
  6280. #: offline.sgml:100
  6281. msgid ""
  6282. "<em>apt.conf</em> must contain the necessary information to make APT use the "
  6283. "disc:"
  6284. msgstr ""
  6285. #. type: <example></example>
  6286. #: offline.sgml:124
  6287. #, no-wrap
  6288. msgid ""
  6289. " APT\n"
  6290. " {\n"
  6291. " /* This is not necessary if the two machines are the same arch, it tells\n"
  6292. " the remote APT what architecture the target machine is */\n"
  6293. " Architecture \"i386\";\n"
  6294. " \n"
  6295. " Get::Download-Only \"true\";\n"
  6296. " };\n"
  6297. " \n"
  6298. " Dir\n"
  6299. " {\n"
  6300. " /* Use the disc for state information and redirect the status file from\n"
  6301. " the /var/lib/dpkg default */\n"
  6302. " State \"/disc/\";\n"
  6303. " State::status \"status\";\n"
  6304. "\n"
  6305. " // Binary caches will be stored locally\n"
  6306. " Cache::archives \"/disc/archives/\";\n"
  6307. " Cache \"/tmp/\";\n"
  6308. " \n"
  6309. " // Location of the source list.\n"
  6310. " Etc \"/disc/\";\n"
  6311. " };"
  6312. msgstr ""
  6313. #. type: </example></p>
  6314. #: offline.sgml:129
  6315. msgid ""
  6316. "More details can be seen by examining the apt.conf man page and the sample "
  6317. "configuration file in <em>/usr/share/doc/apt/examples/apt.conf</em>."
  6318. msgstr ""
  6319. #. type: <p><example>
  6320. #: offline.sgml:136
  6321. msgid ""
  6322. "On the target machine the first thing to do is mount the disc and copy <em>/"
  6323. "var/lib/dpkg/status</em> to it. You will also need to create the directories "
  6324. "outlined in the Overview, <em>archives/partial/</em> and <em>lists/partial/</"
  6325. "em>. Then take the disc to the remote machine and configure the sources."
  6326. "list. On the remote machine execute the following:"
  6327. msgstr ""
  6328. #. type: <example></example>
  6329. #: offline.sgml:142
  6330. #, no-wrap
  6331. msgid ""
  6332. " # export APT_CONFIG=\"/disc/apt.conf\"\n"
  6333. " # apt-get update\n"
  6334. " [ APT fetches the package files ]\n"
  6335. " # apt-get dist-upgrade\n"
  6336. " [ APT fetches all the packages needed to upgrade the target machine ]"
  6337. msgstr ""
  6338. #. type: </example></p>
  6339. #: offline.sgml:149
  6340. msgid ""
  6341. "The dist-upgrade command can be replaced with any other standard APT "
  6342. "commands, particularly dselect-upgrade. You can even use an APT front end "
  6343. "such as <em>dselect</em>. However this presents a problem in communicating "
  6344. "your selections back to the local computer."
  6345. msgstr ""
  6346. #. type: <p><example>
  6347. #: offline.sgml:153
  6348. msgid ""
  6349. "Now the disc contains all of the index files and archives needed to upgrade "
  6350. "the target machine. Take the disc back and run:"
  6351. msgstr ""
  6352. #. type: <example></example>
  6353. #: offline.sgml:159
  6354. #, no-wrap
  6355. msgid ""
  6356. " # export APT_CONFIG=\"/disc/apt.conf\"\n"
  6357. " # apt-get check\n"
  6358. " [ APT generates a local copy of the cache files ]\n"
  6359. " # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade\n"
  6360. " [ Or any other APT command ]"
  6361. msgstr ""
  6362. #. type: <p></p>
  6363. #: offline.sgml:165
  6364. msgid ""
  6365. "It is necessary for proper function to re-specify the status file to be the "
  6366. "local one. This is very important!"
  6367. msgstr ""
  6368. #. type: <p></p>
  6369. #: offline.sgml:172
  6370. msgid ""
  6371. "If you are using dselect you can do the very risky operation of copying disc/"
  6372. "status to /var/lib/dpkg/status so that any selections you made on the remote "
  6373. "machine are updated. I highly recommend that people only make selections on "
  6374. "the local machine - but this may not always be possible. DO NOT copy the "
  6375. "status file if dpkg or APT have been run in the mean time!!"
  6376. msgstr ""
  6377. #. type: <heading></heading>
  6378. #: offline.sgml:178
  6379. msgid "Using APT and wget"
  6380. msgstr ""
  6381. #. type: <p></p>
  6382. #: offline.sgml:185
  6383. msgid ""
  6384. "<em>wget</em> is a popular and portable download tool that can run on nearly "
  6385. "any machine. Unlike the method above this requires that the Debian machine "
  6386. "already has a list of available packages."
  6387. msgstr ""
  6388. #. type: <p></p>
  6389. #: offline.sgml:190
  6390. msgid ""
  6391. "The basic idea is to create a disc that has only the archive files "
  6392. "downloaded from the remote site. This is done by using the --print-uris "
  6393. "option to apt-get and then preparing a wget script to actually fetch the "
  6394. "packages."
  6395. msgstr ""
  6396. #. type: <heading></heading>
  6397. #: offline.sgml:196
  6398. msgid "Operation"
  6399. msgstr ""
  6400. #. type: <p><example>
  6401. #: offline.sgml:200
  6402. msgid ""
  6403. "Unlike the previous technique no special configuration files are required. "
  6404. "We merely use the standard APT commands to generate the file list."
  6405. msgstr ""
  6406. #. type: <example></example>
  6407. #: offline.sgml:205
  6408. #, no-wrap
  6409. msgid ""
  6410. " # apt-get dist-upgrade \n"
  6411. " [ Press no when prompted, make sure you are happy with the actions ]\n"
  6412. " # apt-get -qq --print-uris dist-upgrade > uris\n"
  6413. " # awk '{print \"wget -O \" $2 \" \" $1}' < uris > /disc/wget-script"
  6414. msgstr ""
  6415. #. type: </example></p>
  6416. #: offline.sgml:210
  6417. msgid ""
  6418. "Any command other than dist-upgrade could be used here, including dselect-"
  6419. "upgrade."
  6420. msgstr ""
  6421. #. type: <p></p>
  6422. #: offline.sgml:216
  6423. msgid ""
  6424. "The /disc/wget-script file will now contain a list of wget commands to "
  6425. "execute in order to fetch the necessary archives. This script should be run "
  6426. "with the current directory as the disc's mount point so as to save the "
  6427. "output on the disc."
  6428. msgstr ""
  6429. #. type: <p><example>
  6430. #: offline.sgml:219
  6431. msgid "The remote machine would do something like"
  6432. msgstr ""
  6433. #. type: <example></example>
  6434. #: offline.sgml:223
  6435. #, no-wrap
  6436. msgid ""
  6437. " # cd /disc\n"
  6438. " # sh -x ./wget-script\n"
  6439. " [ wait.. ]"
  6440. msgstr ""
  6441. #. type: </example><example>
  6442. #: offline.sgml:228
  6443. msgid ""
  6444. "Once the archives are downloaded and the disc returned to the Debian machine "
  6445. "installation can proceed using,"
  6446. msgstr ""
  6447. #. type: <example></example>
  6448. #: offline.sgml:230
  6449. #, no-wrap
  6450. msgid " # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade"
  6451. msgstr ""
  6452. #. type: </example></p>
  6453. #: offline.sgml:234
  6454. msgid "Which will use the already fetched archives on the disc."
  6455. msgstr ""