apt-doc.pot 294 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234
  1. # SOME DESCRIPTIVE TITLE
  2. # Copyright (C) YEAR Free Software Foundation, Inc.
  3. # This file is distributed under the same license as the PACKAGE package.
  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
  5. #
  6. #, fuzzy
  7. msgid ""
  8. msgstr ""
  9. "Project-Id-Version: PACKAGE VERSION\n"
  10. "POT-Creation-Date: 2010-02-18 20:53+0100\n"
  11. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13. "Language-Team: LANGUAGE <LL@li.org>\n"
  14. "MIME-Version: 1.0\n"
  15. "Content-Type: text/plain; charset=utf-8\n"
  16. "Content-Transfer-Encoding: ENCODING"
  17. #. type: TH
  18. #: apt.8:17
  19. #, no-wrap
  20. msgid "apt"
  21. msgstr ""
  22. #. type: TH
  23. #: apt.8:17
  24. #, no-wrap
  25. msgid "16 June 1998"
  26. msgstr ""
  27. #. type: TH
  28. #: apt.8:17
  29. #, no-wrap
  30. msgid "Debian GNU/Linux"
  31. msgstr ""
  32. #. type: SH
  33. #: apt.8:18
  34. #, no-wrap
  35. msgid "NAME"
  36. msgstr ""
  37. #. type: Plain text
  38. #: apt.8:20
  39. msgid "apt - Advanced Package Tool"
  40. msgstr ""
  41. #. type: SH
  42. #: apt.8:20
  43. #, no-wrap
  44. msgid "SYNOPSIS"
  45. msgstr ""
  46. #. type: Plain text
  47. #: apt.8:22
  48. msgid "B<apt>"
  49. msgstr ""
  50. #. type: SH
  51. #: apt.8:22
  52. #, no-wrap
  53. msgid "DESCRIPTION"
  54. msgstr ""
  55. #. type: Plain text
  56. #: apt.8:31
  57. msgid ""
  58. "APT is a management system for software packages. For normal day to day "
  59. "package management there are several frontends available, such as "
  60. "B<aptitude>(8) for the command line or B<synaptic>(8) for the X Window "
  61. "System. Some options are only implemented in B<apt-get>(8) though."
  62. msgstr ""
  63. #. type: SH
  64. #: apt.8:31
  65. #, no-wrap
  66. msgid "OPTIONS"
  67. msgstr ""
  68. #. type: Plain text
  69. #: apt.8:33 apt.8:35
  70. msgid "None."
  71. msgstr ""
  72. #. type: SH
  73. #: apt.8:33
  74. #, no-wrap
  75. msgid "FILES"
  76. msgstr ""
  77. #. type: SH
  78. #: apt.8:35
  79. #, no-wrap
  80. msgid "SEE ALSO"
  81. msgstr ""
  82. #. type: Plain text
  83. #: apt.8:42
  84. msgid ""
  85. "B<apt-cache>(8), B<apt-get>(8), B<apt.conf>(5), B<sources.list>(5), "
  86. "B<apt_preferences>(5), B<apt-secure>(8)"
  87. msgstr ""
  88. #. type: SH
  89. #: apt.8:42
  90. #, no-wrap
  91. msgid "DIAGNOSTICS"
  92. msgstr ""
  93. #. type: Plain text
  94. #: apt.8:44
  95. msgid "apt returns zero on normal operation, decimal 100 on error."
  96. msgstr ""
  97. #. type: SH
  98. #: apt.8:44
  99. #, no-wrap
  100. msgid "BUGS"
  101. msgstr ""
  102. #. type: Plain text
  103. #: apt.8:46
  104. msgid "This manpage isn't even started."
  105. msgstr ""
  106. #. type: Plain text
  107. #: apt.8:55
  108. msgid ""
  109. "See E<lt>http://bugs.debian.org/aptE<gt>. If you wish to report a bug in "
  110. "B<apt>, please see I</usr/share/doc/debian/bug-reporting.txt> or the "
  111. "B<reportbug>(1) command."
  112. msgstr ""
  113. #. type: SH
  114. #: apt.8:55
  115. #, no-wrap
  116. msgid "AUTHOR"
  117. msgstr ""
  118. #. type: Plain text
  119. #: apt.8:56
  120. msgid "apt was written by the APT team E<lt>apt@packages.debian.orgE<gt>."
  121. msgstr ""
  122. #. type: Plain text
  123. #: apt.ent:2
  124. msgid "<!-- -*- mode: sgml; mode: fold -*- -->"
  125. msgstr ""
  126. #. type: Plain text
  127. #: apt.ent:10
  128. msgid ""
  129. "<!-- Some common paths.. --> <!ENTITY docdir \"/usr/share/doc/apt/\"> "
  130. "<!ENTITY guidesdir \"/usr/share/doc/apt-doc/\"> <!ENTITY configureindex "
  131. "\"<filename>&docdir;examples/configure-index.gz</filename>\"> <!ENTITY "
  132. "aptconfdir \"<filename>/etc/apt.conf</filename>\"> <!ENTITY statedir "
  133. "\"/var/lib/apt\"> <!ENTITY cachedir \"/var/cache/apt\">"
  134. msgstr ""
  135. #. type: Plain text
  136. #: apt.ent:17
  137. #, no-wrap
  138. msgid ""
  139. "<!-- Cross references to other man pages -->\n"
  140. "<!ENTITY apt-conf \"<citerefentry>\n"
  141. " <refentrytitle><filename>apt.conf</filename></refentrytitle>\n"
  142. " <manvolnum>5</manvolnum>\n"
  143. " </citerefentry>\"\n"
  144. ">\n"
  145. msgstr ""
  146. #. type: Plain text
  147. #: apt.ent:23
  148. #, no-wrap
  149. msgid ""
  150. "<!ENTITY apt-get \"<citerefentry>\n"
  151. " <refentrytitle><command>apt-get</command></refentrytitle>\n"
  152. " <manvolnum>8</manvolnum>\n"
  153. " </citerefentry>\"\n"
  154. ">\n"
  155. msgstr ""
  156. #. type: Plain text
  157. #: apt.ent:29
  158. #, no-wrap
  159. msgid ""
  160. "<!ENTITY apt-config \"<citerefentry>\n"
  161. " <refentrytitle><command>apt-config</command></refentrytitle>\n"
  162. " <manvolnum>8</manvolnum>\n"
  163. " </citerefentry>\"\n"
  164. ">\n"
  165. msgstr ""
  166. #. type: Plain text
  167. #: apt.ent:35
  168. #, no-wrap
  169. msgid ""
  170. "<!ENTITY apt-cdrom \"<citerefentry>\n"
  171. " <refentrytitle><command>apt-cdrom</command></refentrytitle>\n"
  172. " <manvolnum>8</manvolnum>\n"
  173. " </citerefentry>\"\n"
  174. ">\n"
  175. msgstr ""
  176. #. type: Plain text
  177. #: apt.ent:41
  178. #, no-wrap
  179. msgid ""
  180. "<!ENTITY apt-cache \"<citerefentry>\n"
  181. " <refentrytitle><command>apt-cache</command></refentrytitle>\n"
  182. " <manvolnum>8</manvolnum>\n"
  183. " </citerefentry>\"\n"
  184. ">\n"
  185. msgstr ""
  186. #. type: Plain text
  187. #: apt.ent:47
  188. #, no-wrap
  189. msgid ""
  190. "<!ENTITY apt-preferences \"<citerefentry>\n"
  191. " <refentrytitle><command>apt_preferences</command></refentrytitle>\n"
  192. " <manvolnum>5</manvolnum>\n"
  193. " </citerefentry>\"\n"
  194. ">\n"
  195. msgstr ""
  196. #. type: Plain text
  197. #: apt.ent:53
  198. #, no-wrap
  199. msgid ""
  200. "<!ENTITY apt-key \"<citerefentry>\n"
  201. " <refentrytitle><command>apt-key</command></refentrytitle>\n"
  202. " <manvolnum>8</manvolnum>\n"
  203. " </citerefentry>\"\n"
  204. ">\n"
  205. msgstr ""
  206. #. type: Plain text
  207. #: apt.ent:59
  208. #, no-wrap
  209. msgid ""
  210. "<!ENTITY apt-secure \"<citerefentry>\n"
  211. " <refentrytitle>apt-secure</refentrytitle>\n"
  212. " <manvolnum>8</manvolnum>\n"
  213. " </citerefentry>\"\n"
  214. ">\n"
  215. msgstr ""
  216. #. type: Plain text
  217. #: apt.ent:65
  218. #, no-wrap
  219. msgid ""
  220. "<!ENTITY apt-ftparchive \"<citerefentry>\n"
  221. " <refentrytitle><filename>apt-ftparchive</filename></refentrytitle>\n"
  222. " <manvolnum>1</manvolnum>\n"
  223. " </citerefentry>\"\n"
  224. ">\n"
  225. msgstr ""
  226. #. type: Plain text
  227. #: apt.ent:72
  228. #, no-wrap
  229. msgid ""
  230. "<!ENTITY sources-list \"<citerefentry>\n"
  231. " <refentrytitle><filename>sources.list</filename></refentrytitle>\n"
  232. " <manvolnum>5</manvolnum>\n"
  233. " </citerefentry>\"\n"
  234. ">\n"
  235. msgstr ""
  236. #. type: Plain text
  237. #: apt.ent:78
  238. #, no-wrap
  239. msgid ""
  240. "<!ENTITY reportbug \"<citerefentry>\n"
  241. " <refentrytitle><command>reportbug</command></refentrytitle>\n"
  242. " <manvolnum>1</manvolnum>\n"
  243. " </citerefentry>\"\n"
  244. ">\n"
  245. msgstr ""
  246. #. type: Plain text
  247. #: apt.ent:84
  248. #, no-wrap
  249. msgid ""
  250. "<!ENTITY dpkg \"<citerefentry>\n"
  251. " <refentrytitle><command>dpkg</command></refentrytitle>\n"
  252. " <manvolnum>1</manvolnum>\n"
  253. " </citerefentry>\"\n"
  254. ">\n"
  255. msgstr ""
  256. #. type: Plain text
  257. #: apt.ent:90
  258. #, no-wrap
  259. msgid ""
  260. "<!ENTITY dpkg-buildpackage \"<citerefentry>\n"
  261. " <refentrytitle><command>dpkg-buildpackage</command></refentrytitle>\n"
  262. " <manvolnum>1</manvolnum>\n"
  263. " </citerefentry>\"\n"
  264. ">\n"
  265. msgstr ""
  266. #. type: Plain text
  267. #: apt.ent:96
  268. #, no-wrap
  269. msgid ""
  270. "<!ENTITY gzip \"<citerefentry>\n"
  271. " <refentrytitle><command>gzip</command></refentrytitle>\n"
  272. " <manvolnum>1</manvolnum>\n"
  273. " </citerefentry>\"\n"
  274. ">\n"
  275. msgstr ""
  276. #. type: Plain text
  277. #: apt.ent:102
  278. #, no-wrap
  279. msgid ""
  280. "<!ENTITY dpkg-scanpackages \"<citerefentry>\n"
  281. " <refentrytitle><command>dpkg-scanpackages</command></refentrytitle>\n"
  282. " <manvolnum>1</manvolnum>\n"
  283. " </citerefentry>\"\n"
  284. ">\n"
  285. msgstr ""
  286. #. type: Plain text
  287. #: apt.ent:108
  288. #, no-wrap
  289. msgid ""
  290. "<!ENTITY dpkg-scansources \"<citerefentry>\n"
  291. " <refentrytitle><command>dpkg-scansources</command></refentrytitle>\n"
  292. " <manvolnum>1</manvolnum>\n"
  293. " </citerefentry>\"\n"
  294. ">\n"
  295. msgstr ""
  296. #. type: Plain text
  297. #: apt.ent:114
  298. #, no-wrap
  299. msgid ""
  300. "<!ENTITY dselect \"<citerefentry>\n"
  301. " <refentrytitle><command>dselect</command></refentrytitle>\n"
  302. " <manvolnum>1</manvolnum>\n"
  303. " </citerefentry>\"\n"
  304. ">\n"
  305. msgstr ""
  306. #. type: Plain text
  307. #: apt.ent:120
  308. #, no-wrap
  309. msgid ""
  310. "<!ENTITY aptitude \"<citerefentry>\n"
  311. " <refentrytitle><command>aptitude</command></refentrytitle>\n"
  312. " <manvolnum>8</manvolnum>\n"
  313. " </citerefentry>\"\n"
  314. ">\n"
  315. msgstr ""
  316. #. type: Plain text
  317. #: apt.ent:126
  318. #, no-wrap
  319. msgid ""
  320. "<!ENTITY synaptic \"<citerefentry>\n"
  321. " <refentrytitle><command>synaptic</command></refentrytitle>\n"
  322. " <manvolnum>8</manvolnum>\n"
  323. " </citerefentry>\"\n"
  324. ">\n"
  325. msgstr ""
  326. #. type: Plain text
  327. #: apt.ent:132
  328. #, no-wrap
  329. msgid ""
  330. "<!ENTITY debsign \"<citerefentry>\n"
  331. " <refentrytitle><command>debsign</command></refentrytitle>\n"
  332. " <manvolnum>1</manvolnum>\n"
  333. " </citerefentry>\"\n"
  334. ">\n"
  335. msgstr ""
  336. #. type: Plain text
  337. #: apt.ent:138
  338. #, no-wrap
  339. msgid ""
  340. "<!ENTITY debsig-verify \"<citerefentry>\n"
  341. " <refentrytitle><command>debsig-verify</command></refentrytitle>\n"
  342. " <manvolnum>1</manvolnum>\n"
  343. " </citerefentry>\"\n"
  344. ">\n"
  345. msgstr ""
  346. #. type: Plain text
  347. #: apt.ent:144
  348. #, no-wrap
  349. msgid ""
  350. "<!ENTITY gpg \"<citerefentry>\n"
  351. " <refentrytitle><command>gpg</command></refentrytitle>\n"
  352. " <manvolnum>1</manvolnum>\n"
  353. " </citerefentry>\"\n"
  354. ">\n"
  355. msgstr ""
  356. #. type: Plain text
  357. #: apt.ent:150
  358. #, no-wrap
  359. msgid ""
  360. "<!ENTITY gnome-apt \"<citerefentry>\n"
  361. " <refentrytitle><command>gnome-apt</command></refentrytitle>\n"
  362. " <manvolnum>1</manvolnum>\n"
  363. " </citerefentry>\"\n"
  364. ">\n"
  365. msgstr ""
  366. #. type: Plain text
  367. #: apt.ent:156
  368. #, no-wrap
  369. msgid ""
  370. "<!ENTITY wajig \"<citerefentry>\n"
  371. " <refentrytitle><command>wajig</command></refentrytitle>\n"
  372. " <manvolnum>1</manvolnum>\n"
  373. " </citerefentry>\"\n"
  374. ">\n"
  375. msgstr ""
  376. #. type: Plain text
  377. #: apt.ent:168
  378. #, no-wrap
  379. msgid ""
  380. "<!-- Boiler plate docinfo section -->\n"
  381. "<!ENTITY apt-docinfo \"\n"
  382. " <refentryinfo>\n"
  383. " <address><email>apt@packages.debian.org</email></address>\n"
  384. " <author>\n"
  385. " <firstname>Jason</firstname> <surname>Gunthorpe</surname>\n"
  386. " <contrib></contrib>\n"
  387. " </author>\n"
  388. " <copyright><year>1998-2001</year> <holder>Jason "
  389. "Gunthorpe</holder></copyright>\n"
  390. " <date>28 October 2008</date>\n"
  391. " <productname>Linux</productname>\n"
  392. msgstr ""
  393. #. type: Plain text
  394. #: apt.ent:171
  395. #, no-wrap
  396. msgid ""
  397. " </refentryinfo>\n"
  398. "\"> \n"
  399. msgstr ""
  400. #. type: Plain text
  401. #: apt.ent:177
  402. #, no-wrap
  403. msgid ""
  404. "<!ENTITY apt-email \"\n"
  405. " <address>\n"
  406. " <email>apt@packages.debian.org</email>\n"
  407. " </address>\n"
  408. "\">\n"
  409. msgstr ""
  410. #. type: Plain text
  411. #: apt.ent:185
  412. #, no-wrap
  413. msgid ""
  414. "<!ENTITY apt-author.jgunthorpe \"\n"
  415. " <author>\n"
  416. " <firstname>Jason</firstname>\n"
  417. " <surname>Gunthorpe</surname>\n"
  418. " <contrib></contrib>\n"
  419. " </author>\n"
  420. "\">\n"
  421. msgstr ""
  422. #. type: Plain text
  423. #: apt.ent:193
  424. #, no-wrap
  425. msgid ""
  426. "<!ENTITY apt-author.moconnor \"\n"
  427. " <author>\n"
  428. " <firstname>Mike</firstname>\n"
  429. " <surname>O'Connor</surname>\n"
  430. " <contrib></contrib>\n"
  431. " </author>\n"
  432. "\">\n"
  433. msgstr ""
  434. #. type: Plain text
  435. #: apt.ent:200
  436. #, no-wrap
  437. msgid ""
  438. "<!ENTITY apt-author.team \"\n"
  439. " <author>\n"
  440. " <othername>APT team</othername>\n"
  441. " <contrib></contrib>\n"
  442. " </author>\n"
  443. "\">\n"
  444. msgstr ""
  445. #. type: Plain text
  446. #: apt.ent:204 apt.ent:215
  447. #, no-wrap
  448. msgid ""
  449. "<!ENTITY apt-product \"\n"
  450. " <productname>Linux</productname>\n"
  451. "\">\n"
  452. msgstr ""
  453. #. type: Plain text
  454. #: apt.ent:211
  455. #, no-wrap
  456. msgid ""
  457. "<!ENTITY apt-copyright \"\n"
  458. " <copyright>\n"
  459. " <holder>Jason Gunthorpe</holder>\n"
  460. " <year>1998-2001</year>\n"
  461. " </copyright>\n"
  462. "\">\n"
  463. msgstr ""
  464. #. type: Plain text
  465. #: apt.ent:221
  466. #, no-wrap
  467. msgid ""
  468. "<!ENTITY apt-qapage \"\n"
  469. "\t<para>\n"
  470. "\t\t<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>\n"
  471. "\t</para>\n"
  472. "\">\n"
  473. msgstr ""
  474. #. type: Plain text
  475. #: apt.ent:232
  476. #, no-wrap
  477. msgid ""
  478. "<!-- Boiler plate Bug reporting section -->\n"
  479. "<!ENTITY manbugs \"\n"
  480. " <refsect1><title>Bugs</title>\n"
  481. " <para><ulink url='http://bugs.debian.org/src:apt'>APT bug "
  482. "page</ulink>. \n"
  483. " If you wish to report a bug in APT, please see\n"
  484. " <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the\n"
  485. " &reportbug; command.\n"
  486. " </para>\n"
  487. " </refsect1>\n"
  488. "\">\n"
  489. msgstr ""
  490. #. type: Plain text
  491. #: apt.ent:240
  492. #, no-wrap
  493. msgid ""
  494. "<!-- Boiler plate Author section -->\n"
  495. "<!ENTITY manauthor \"\n"
  496. " <refsect1><title>Author</title>\n"
  497. " <para>APT was written by the APT team "
  498. "<email>apt@packages.debian.org</email>.\n"
  499. " </para>\n"
  500. " </refsect1>\n"
  501. "\">\n"
  502. msgstr ""
  503. #. type: Plain text
  504. #: apt.ent:250
  505. #, no-wrap
  506. msgid ""
  507. "<!-- Should be used within the option section of the text to\n"
  508. " put in the blurb about -h, -v, -c and -o -->\n"
  509. "<!ENTITY apt-commonoptions \"\n"
  510. " <varlistentry><term><option>-h</option></term>\n"
  511. " <term><option>--help</option></term>\n"
  512. " <listitem><para>Show a short usage summary.\n"
  513. " </para>\n"
  514. " </listitem>\n"
  515. " </varlistentry>\n"
  516. msgstr ""
  517. #. type: Plain text
  518. #: apt.ent:258
  519. #, no-wrap
  520. msgid ""
  521. " <varlistentry>\n"
  522. " <term><option>-v</option></term>\n"
  523. " <term><option>--version</option></term>\n"
  524. " <listitem><para>Show the program version.\n"
  525. " </para>\n"
  526. " </listitem>\n"
  527. " </varlistentry>\n"
  528. msgstr ""
  529. #. type: Plain text
  530. #: apt.ent:268
  531. #, no-wrap
  532. msgid ""
  533. " <varlistentry>\n"
  534. " <term><option>-c</option></term>\n"
  535. " <term><option>--config-file</option></term>\n"
  536. " <listitem><para>Configuration File; Specify a configuration file to "
  537. "use. \n"
  538. " The program will read the default configuration file and then this \n"
  539. " configuration file. See &apt-conf; for syntax information. \n"
  540. " </para>\n"
  541. " </listitem>\n"
  542. " </varlistentry>\n"
  543. msgstr ""
  544. #. type: Plain text
  545. #: apt.ent:280
  546. #, no-wrap
  547. msgid ""
  548. " <varlistentry>\n"
  549. " <term><option>-o</option></term>\n"
  550. " <term><option>--option</option></term>\n"
  551. " <listitem><para>Set a Configuration Option; This will set an "
  552. "arbitrary\n"
  553. " configuration option. The syntax is <option>-o "
  554. "Foo::Bar=bar</option>.\n"
  555. " <option>-o</option> and <option>--option</option> can be used "
  556. "multiple\n"
  557. " times to set different options.\n"
  558. " </para>\n"
  559. " </listitem>\n"
  560. " </varlistentry>\n"
  561. "\">\n"
  562. msgstr ""
  563. #. type: Plain text
  564. #: apt.ent:291
  565. #, no-wrap
  566. msgid ""
  567. "<!-- Should be used within the option section of the text to\n"
  568. " put in the blurb about -h, -v, -c and -o -->\n"
  569. "<!ENTITY apt-cmdblurb \"\n"
  570. " <para>All command line options may be set using the configuration file, "
  571. "the\n"
  572. " descriptions indicate the configuration option to set. For boolean\n"
  573. " options you can override the config file by using something like \n"
  574. " <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>\n"
  575. " or several other variations.\n"
  576. " </para>\n"
  577. "\">\n"
  578. msgstr ""
  579. #. type: Plain text
  580. #: apt.ent:297
  581. #, no-wrap
  582. msgid ""
  583. "<!ENTITY file-aptconf \"\n"
  584. " <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>\n"
  585. " <listitem><para>APT configuration file.\n"
  586. " Configuration Item: "
  587. "<literal>Dir::Etc::Main</literal>.</para></listitem>\n"
  588. " </varlistentry>\n"
  589. msgstr ""
  590. #. type: Plain text
  591. #: apt.ent:303
  592. #, no-wrap
  593. msgid ""
  594. " <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>\n"
  595. " <listitem><para>APT configuration file fragments.\n"
  596. " Configuration Item: "
  597. "<literal>Dir::Etc::Parts</literal>.</para></listitem>\n"
  598. " </varlistentry>\n"
  599. "\">\n"
  600. msgstr ""
  601. #. type: Plain text
  602. #: apt.ent:309
  603. #, no-wrap
  604. msgid ""
  605. "<!ENTITY file-cachearchives \"\n"
  606. " <varlistentry><term><filename>&cachedir;/archives/</filename></term>\n"
  607. " <listitem><para>Storage area for retrieved package files.\n"
  608. " Configuration Item: "
  609. "<literal>Dir::Cache::Archives</literal>.</para></listitem>\n"
  610. " </varlistentry>\n"
  611. msgstr ""
  612. #. type: Plain text
  613. #: apt.ent:315
  614. #, no-wrap
  615. msgid ""
  616. " "
  617. "<varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>\n"
  618. " <listitem><para>Storage area for package files in transit.\n"
  619. " Configuration Item: <literal>Dir::Cache::Archives</literal> (implicit "
  620. "partial). </para></listitem>\n"
  621. " </varlistentry>\n"
  622. "\">\n"
  623. msgstr ""
  624. #. type: Plain text
  625. #: apt.ent:325
  626. #, no-wrap
  627. msgid ""
  628. "<!ENTITY file-preferences \"\n"
  629. " <varlistentry><term><filename>/etc/apt/preferences</filename></term>\n"
  630. " <listitem><para>Version preferences file.\n"
  631. " This is where you would specify &quot;pinning&quot;,\n"
  632. " i.e. a preference to get certain packages\n"
  633. " from a separate source\n"
  634. " or from a different version of a distribution.\n"
  635. " Configuration Item: "
  636. "<literal>Dir::Etc::Preferences</literal>.</para></listitem>\n"
  637. " </varlistentry>\n"
  638. msgstr ""
  639. #. type: Plain text
  640. #: apt.ent:331
  641. #, no-wrap
  642. msgid ""
  643. " "
  644. "<varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>\n"
  645. " <listitem><para>File fragments for the version preferences.\n"
  646. " Configuration Item: "
  647. "<literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>\n"
  648. " </varlistentry>\n"
  649. "\">\n"
  650. msgstr ""
  651. #. type: Plain text
  652. #: apt.ent:337
  653. #, no-wrap
  654. msgid ""
  655. "<!ENTITY file-sourceslist \"\n"
  656. " <varlistentry><term><filename>/etc/apt/sources.list</filename></term>\n"
  657. " <listitem><para>Locations to fetch packages from.\n"
  658. " Configuration Item: "
  659. "<literal>Dir::Etc::SourceList</literal>.</para></listitem>\n"
  660. " </varlistentry>\n"
  661. msgstr ""
  662. #. type: Plain text
  663. #: apt.ent:343
  664. #, no-wrap
  665. msgid ""
  666. " "
  667. "<varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>\n"
  668. " <listitem><para>File fragments for locations to fetch packages from.\n"
  669. " Configuration Item: "
  670. "<literal>Dir::Etc::SourceParts</literal>.</para></listitem>\n"
  671. " </varlistentry>\n"
  672. "\">\n"
  673. msgstr ""
  674. #. type: Plain text
  675. #: apt.ent:350
  676. #, no-wrap
  677. msgid ""
  678. "<!ENTITY file-statelists \"\n"
  679. " <varlistentry><term><filename>&statedir;/lists/</filename></term>\n"
  680. " <listitem><para>Storage area for state information for each package "
  681. "resource specified in\n"
  682. " &sources-list;\n"
  683. " Configuration Item: "
  684. "<literal>Dir::State::Lists</literal>.</para></listitem>\n"
  685. " </varlistentry>\n"
  686. msgstr ""
  687. #. type: Plain text
  688. #: apt.ent:356
  689. #, no-wrap
  690. msgid ""
  691. " "
  692. "<varlistentry><term><filename>&statedir;/lists/partial/</filename></term>\n"
  693. " <listitem><para>Storage area for state information in transit.\n"
  694. " Configuration Item: <literal>Dir::State::Lists</literal> (implicit "
  695. "partial).</para></listitem>\n"
  696. " </varlistentry>\n"
  697. "\">\n"
  698. msgstr ""
  699. #. type: Plain text
  700. #: apt.ent:362
  701. #, no-wrap
  702. msgid ""
  703. "<!ENTITY file-trustedgpg \"\n"
  704. " <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>\n"
  705. " <listitem><para>Keyring of local trusted keys, new keys will be added "
  706. "here.\n"
  707. " Configuration Item: "
  708. "<literal>Dir::Etc::Trusted</literal>.</para></listitem>\n"
  709. " </varlistentry>\n"
  710. msgstr ""
  711. #. type: Plain text
  712. #: apt.ent:369
  713. #, no-wrap
  714. msgid ""
  715. " "
  716. "<varlistentry><term><filename>/etc/apt/trusted.gpg.d/</filename></term>\n"
  717. " <listitem><para>File fragments for the trusted keys, additional "
  718. "keyrings can\n"
  719. " be stored here (by other packages or the administrator).\n"
  720. " Configuration Item "
  721. "<literal>Dir::Etc::TrustedParts</literal>.</para></listitem>\n"
  722. " </varlistentry>\n"
  723. "\">\n"
  724. msgstr ""
  725. #. type: Plain text
  726. #: apt.ent:371
  727. msgid "<!ENTITY translation-title \"TRANSLATION\">"
  728. msgstr ""
  729. #. type: Plain text
  730. #: apt.ent:380
  731. #, no-wrap
  732. msgid ""
  733. "<!-- TRANSLATOR: This is a placeholder. You should write here who has "
  734. "constributed\n"
  735. " to the translation in the past, who is responsible now and maybe "
  736. "further information\n"
  737. " specially related to your translation. -->\n"
  738. "<!ENTITY translation-holder \"\n"
  739. " The english translation was done by John Doe "
  740. "<email>john@doe.org</email> in 2009,\n"
  741. " 2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together "
  742. "with the\n"
  743. " Debian Dummy l10n Team "
  744. "<email>debian-l10n-dummy@lists.debian.org</email>.\n"
  745. "\">\n"
  746. msgstr ""
  747. #. type: Plain text
  748. #: apt.ent:387
  749. #, no-wrap
  750. msgid ""
  751. "<!-- TRANSLATOR: As a translation is allowed to have 20% of "
  752. "untranslated/fuzzy strings\n"
  753. " in a shipped manpage will maybe appear english parts. -->\n"
  754. "<!ENTITY translation-english \"\n"
  755. " Note that this translated document may contain untranslated parts.\n"
  756. " This is done on purpose, to avoid losing content when the\n"
  757. " translation is lagging behind the original content.\n"
  758. "\">\n"
  759. msgstr ""
  760. #. The last update date
  761. #. type: Content of: <refentry><refentryinfo>
  762. #: apt-cache.8.xml:13 apt-config.8.xml:13 apt-extracttemplates.1.xml:13 apt-sortpkgs.1.xml:13 sources.list.5.xml:13
  763. msgid ""
  764. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>29 "
  765. "February 2004</date>"
  766. msgstr ""
  767. #. type: Content of: <refentry><refnamediv><refname>
  768. #: apt-cache.8.xml:22 apt-cache.8.xml:29
  769. msgid "apt-cache"
  770. msgstr ""
  771. #. type: Content of: <refentry><refmeta><manvolnum>
  772. #: apt-cache.8.xml:23 apt-cdrom.8.xml:22 apt-config.8.xml:23 apt-get.8.xml:23 apt-key.8.xml:15 apt-mark.8.xml:23 apt-secure.8.xml:15
  773. msgid "8"
  774. msgstr ""
  775. #. type: Content of: <refentry><refmeta><refmiscinfo>
  776. #: apt-cache.8.xml:24 apt-cdrom.8.xml:23 apt-config.8.xml:24 apt-extracttemplates.1.xml:24 apt-ftparchive.1.xml:24 apt-get.8.xml:24 apt-key.8.xml:16 apt-mark.8.xml:24 apt-secure.8.xml:16 apt-sortpkgs.1.xml:24 apt.conf.5.xml:30 apt_preferences.5.xml:23 sources.list.5.xml:24
  777. msgid "APT"
  778. msgstr ""
  779. #. type: Content of: <refentry><refnamediv><refpurpose>
  780. #: apt-cache.8.xml:30
  781. msgid "APT package handling utility -- cache manipulator"
  782. msgstr ""
  783. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  784. #: apt-cache.8.xml:36
  785. msgid ""
  786. "<command>apt-cache</command> <arg><option>-hvsn</option></arg> "
  787. "<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
  788. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
  789. "choice=\"req\"> <arg>add <arg choice=\"plain\" "
  790. "rep=\"repeat\"><replaceable>file</replaceable></arg></arg> "
  791. "<arg>gencaches</arg> <arg>showpkg <arg choice=\"plain\" "
  792. "rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>showsrc <arg "
  793. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  794. "<arg>stats</arg> <arg>dump</arg> <arg>dumpavail</arg> <arg>unmet</arg> "
  795. "<arg>search <arg "
  796. "choice=\"plain\"><replaceable>regex</replaceable></arg></arg> <arg>show <arg "
  797. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  798. "<arg>depends <arg choice=\"plain\" "
  799. "rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>rdepends <arg "
  800. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  801. "<arg>pkgnames <arg "
  802. "choice=\"plain\"><replaceable>prefix</replaceable></arg></arg> <arg>dotty "
  803. "<arg choice=\"plain\" "
  804. "rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>xvcg <arg "
  805. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  806. "<arg>policy <arg choice=\"plain\" "
  807. "rep=\"repeat\"><replaceable>pkgs</replaceable></arg></arg> <arg>madison <arg "
  808. "choice=\"plain\" rep=\"repeat\"><replaceable>pkgs</replaceable></arg></arg> "
  809. "</group>"
  810. msgstr ""
  811. #. type: Content of: <refentry><refsect1><title>
  812. #: apt-cache.8.xml:62 apt-cdrom.8.xml:47 apt-config.8.xml:47 apt-extracttemplates.1.xml:43 apt-ftparchive.1.xml:56 apt-get.8.xml:125 apt-key.8.xml:35 apt-mark.8.xml:52 apt-secure.8.xml:40 apt-sortpkgs.1.xml:44 apt.conf.5.xml:39 apt_preferences.5.xml:33 sources.list.5.xml:33
  813. msgid "Description"
  814. msgstr ""
  815. #. type: Content of: <refentry><refsect1><para>
  816. #: apt-cache.8.xml:63
  817. msgid ""
  818. "<command>apt-cache</command> performs a variety of operations on APT's "
  819. "package cache. <command>apt-cache</command> does not manipulate the state of "
  820. "the system but does provide operations to search and generate interesting "
  821. "output from the package metadata."
  822. msgstr ""
  823. #. type: Content of: <refentry><refsect1><para>
  824. #: apt-cache.8.xml:68 apt-get.8.xml:131
  825. msgid ""
  826. "Unless the <option>-h</option>, or <option>--help</option> option is given, "
  827. "one of the commands below must be present."
  828. msgstr ""
  829. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  830. #: apt-cache.8.xml:72
  831. msgid "add <replaceable>file(s)</replaceable>"
  832. msgstr ""
  833. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  834. #: apt-cache.8.xml:73
  835. msgid ""
  836. "<literal>add</literal> adds the named package index files to the package "
  837. "cache. This is for debugging only."
  838. msgstr ""
  839. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  840. #: apt-cache.8.xml:77
  841. msgid "gencaches"
  842. msgstr ""
  843. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  844. #: apt-cache.8.xml:78
  845. msgid ""
  846. "<literal>gencaches</literal> performs the same operation as <command>apt-get "
  847. "check</command>. It builds the source and package caches from the sources in "
  848. "&sources-list; and from <filename>/var/lib/dpkg/status</filename>."
  849. msgstr ""
  850. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  851. #: apt-cache.8.xml:84
  852. msgid "showpkg <replaceable>pkg(s)</replaceable>"
  853. msgstr ""
  854. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  855. #: apt-cache.8.xml:85
  856. msgid ""
  857. "<literal>showpkg</literal> displays information about the packages listed on "
  858. "the command line. Remaining arguments are package names. The available "
  859. "versions and reverse dependencies of each package listed are listed, as well "
  860. "as forward dependencies for each version. Forward (normal) dependencies are "
  861. "those packages upon which the package in question depends; reverse "
  862. "dependencies are those packages that depend upon the package in "
  863. "question. Thus, forward dependencies must be satisfied for a package, but "
  864. "reverse dependencies need not be. For instance, <command>apt-cache showpkg "
  865. "libreadline2</command> would produce output similar to the following:"
  866. msgstr ""
  867. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
  868. #: apt-cache.8.xml:97
  869. #, no-wrap
  870. msgid ""
  871. "Package: libreadline2\n"
  872. "Versions: 2.1-12(/var/state/apt/lists/foo_Packages),\n"
  873. "Reverse Depends: \n"
  874. " libreadlineg2,libreadline2\n"
  875. " libreadline2-altdev,libreadline2\n"
  876. "Dependencies:\n"
  877. "2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))\n"
  878. "Provides:\n"
  879. "2.1-12 - \n"
  880. "Reverse Provides: \n"
  881. msgstr ""
  882. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  883. #: apt-cache.8.xml:109
  884. msgid ""
  885. "Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and "
  886. "ncurses3.0 which must be installed for libreadline2 to work. In turn, "
  887. "libreadlineg2 and libreadline2-altdev depend on libreadline2. If "
  888. "libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be "
  889. "installed; libreadlineg2 and libreadline2-altdev do not have to be "
  890. "installed. For the specific meaning of the remainder of the output it is "
  891. "best to consult the apt source code."
  892. msgstr ""
  893. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  894. #: apt-cache.8.xml:118
  895. msgid "stats"
  896. msgstr ""
  897. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  898. #: apt-cache.8.xml:118
  899. msgid ""
  900. "<literal>stats</literal> displays some statistics about the cache. No "
  901. "further arguments are expected. Statistics reported are:"
  902. msgstr ""
  903. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  904. #: apt-cache.8.xml:121
  905. msgid ""
  906. "<literal>Total package names</literal> is the number of package names found "
  907. "in the cache."
  908. msgstr ""
  909. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  910. #: apt-cache.8.xml:125
  911. msgid ""
  912. "<literal>Normal packages</literal> is the number of regular, ordinary "
  913. "package names; these are packages that bear a one-to-one correspondence "
  914. "between their names and the names used by other packages for them in "
  915. "dependencies. The majority of packages fall into this category."
  916. msgstr ""
  917. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  918. #: apt-cache.8.xml:131
  919. msgid ""
  920. "<literal>Pure virtual packages</literal> is the number of packages that "
  921. "exist only as a virtual package name; that is, packages only \"provide\" the "
  922. "virtual package name, and no package actually uses the name. For instance, "
  923. "\"mail-transport-agent\" in the Debian GNU/Linux system is a pure virtual "
  924. "package; several packages provide \"mail-transport-agent\", but there is no "
  925. "package named \"mail-transport-agent\"."
  926. msgstr ""
  927. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  928. #: apt-cache.8.xml:139
  929. msgid ""
  930. "<literal>Single virtual packages</literal> is the number of packages with "
  931. "only one package providing a particular virtual package. For example, in the "
  932. "Debian GNU/Linux system, \"X11-text-viewer\" is a virtual package, but only "
  933. "one package, xless, provides \"X11-text-viewer\"."
  934. msgstr ""
  935. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  936. #: apt-cache.8.xml:145
  937. msgid ""
  938. "<literal>Mixed virtual packages</literal> is the number of packages that "
  939. "either provide a particular virtual package or have the virtual package name "
  940. "as the package name. For instance, in the Debian GNU/Linux system, "
  941. "\"debconf\" is both an actual package, and provided by the debconf-tiny "
  942. "package."
  943. msgstr ""
  944. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  945. #: apt-cache.8.xml:152
  946. msgid ""
  947. "<literal>Missing</literal> is the number of package names that were "
  948. "referenced in a dependency but were not provided by any package. Missing "
  949. "packages may be an evidence if a full distribution is not accessed, or if a "
  950. "package (real or virtual) has been dropped from the distribution. Usually "
  951. "they are referenced from Conflicts or Breaks statements."
  952. msgstr ""
  953. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  954. #: apt-cache.8.xml:159
  955. msgid ""
  956. "<literal>Total distinct</literal> versions is the number of package versions "
  957. "found in the cache; this value is therefore at least equal to the number of "
  958. "total package names. If more than one distribution (both \"stable\" and "
  959. "\"unstable\", for instance), is being accessed, this value can be "
  960. "considerably larger than the number of total package names."
  961. msgstr ""
  962. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  963. #: apt-cache.8.xml:166
  964. msgid ""
  965. "<literal>Total dependencies</literal> is the number of dependency "
  966. "relationships claimed by all of the packages in the cache."
  967. msgstr ""
  968. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  969. #: apt-cache.8.xml:173
  970. msgid "showsrc <replaceable>pkg(s)</replaceable>"
  971. msgstr ""
  972. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  973. #: apt-cache.8.xml:174
  974. msgid ""
  975. "<literal>showsrc</literal> displays all the source package records that "
  976. "match the given package names. All versions are shown, as well as all "
  977. "records that declare the name to be a Binary."
  978. msgstr ""
  979. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  980. #: apt-cache.8.xml:179 apt-config.8.xml:84
  981. msgid "dump"
  982. msgstr ""
  983. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  984. #: apt-cache.8.xml:180
  985. msgid ""
  986. "<literal>dump</literal> shows a short listing of every package in the "
  987. "cache. It is primarily for debugging."
  988. msgstr ""
  989. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  990. #: apt-cache.8.xml:184
  991. msgid "dumpavail"
  992. msgstr ""
  993. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  994. #: apt-cache.8.xml:185
  995. msgid ""
  996. "<literal>dumpavail</literal> prints out an available list to stdout. This is "
  997. "suitable for use with &dpkg; and is used by the &dselect; method."
  998. msgstr ""
  999. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1000. #: apt-cache.8.xml:189
  1001. msgid "unmet"
  1002. msgstr ""
  1003. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1004. #: apt-cache.8.xml:190
  1005. msgid ""
  1006. "<literal>unmet</literal> displays a summary of all unmet dependencies in the "
  1007. "package cache."
  1008. msgstr ""
  1009. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1010. #: apt-cache.8.xml:194
  1011. msgid "show <replaceable>pkg(s)</replaceable>"
  1012. msgstr ""
  1013. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1014. #: apt-cache.8.xml:195
  1015. msgid ""
  1016. "<literal>show</literal> performs a function similar to <command>dpkg "
  1017. "--print-avail</command>; it displays the package records for the named "
  1018. "packages."
  1019. msgstr ""
  1020. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1021. #: apt-cache.8.xml:200
  1022. msgid "search <replaceable>regex [ regex ... ]</replaceable>"
  1023. msgstr ""
  1024. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1025. #: apt-cache.8.xml:201
  1026. msgid ""
  1027. "<literal>search</literal> performs a full text search on all available "
  1028. "package lists for the POSIX regex pattern given, see "
  1029. "<citerefentry><refentrytitle><command>regex</command></refentrytitle> "
  1030. "<manvolnum>7</manvolnum></citerefentry>. It searches the package names and "
  1031. "the descriptions for an occurrence of the regular expression and prints out "
  1032. "the package name and the short description, including virtual package "
  1033. "names. If <option>--full</option> is given then output identical to "
  1034. "<literal>show</literal> is produced for each matched package, and if "
  1035. "<option>--names-only</option> is given then the long description is not "
  1036. "searched, only the package name is."
  1037. msgstr ""
  1038. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1039. #: apt-cache.8.xml:214
  1040. msgid ""
  1041. "Separate arguments can be used to specify multiple search patterns that are "
  1042. "and'ed together."
  1043. msgstr ""
  1044. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1045. #: apt-cache.8.xml:218
  1046. msgid "depends <replaceable>pkg(s)</replaceable>"
  1047. msgstr ""
  1048. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1049. #: apt-cache.8.xml:219
  1050. msgid ""
  1051. "<literal>depends</literal> shows a listing of each dependency a package has "
  1052. "and all the possible other packages that can fulfill that dependency."
  1053. msgstr ""
  1054. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1055. #: apt-cache.8.xml:223
  1056. msgid "rdepends <replaceable>pkg(s)</replaceable>"
  1057. msgstr ""
  1058. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1059. #: apt-cache.8.xml:224
  1060. msgid ""
  1061. "<literal>rdepends</literal> shows a listing of each reverse dependency a "
  1062. "package has."
  1063. msgstr ""
  1064. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1065. #: apt-cache.8.xml:228
  1066. msgid "pkgnames <replaceable>[ prefix ]</replaceable>"
  1067. msgstr ""
  1068. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1069. #: apt-cache.8.xml:229
  1070. msgid ""
  1071. "This command prints the name of each package APT knows. The optional "
  1072. "argument is a prefix match to filter the name list. The output is suitable "
  1073. "for use in a shell tab complete function and the output is generated "
  1074. "extremely quickly. This command is best used with the "
  1075. "<option>--generate</option> option."
  1076. msgstr ""
  1077. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1078. #: apt-cache.8.xml:234
  1079. msgid ""
  1080. "Note that a package which APT knows of is not necessarily available to "
  1081. "download, installable or installed, e.g. virtual packages are also listed in "
  1082. "the generated list."
  1083. msgstr ""
  1084. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1085. #: apt-cache.8.xml:239
  1086. msgid "dotty <replaceable>pkg(s)</replaceable>"
  1087. msgstr ""
  1088. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1089. #: apt-cache.8.xml:240
  1090. msgid ""
  1091. "<literal>dotty</literal> takes a list of packages on the command line and "
  1092. "generates output suitable for use by dotty from the <ulink "
  1093. "url=\"http://www.research.att.com/sw/tools/graphviz/\">GraphViz</ulink> "
  1094. "package. The result will be a set of nodes and edges representing the "
  1095. "relationships between the packages. By default the given packages will trace "
  1096. "out all dependent packages; this can produce a very large graph. To limit "
  1097. "the output to only the packages listed on the command line, set the "
  1098. "<literal>APT::Cache::GivenOnly</literal> option."
  1099. msgstr ""
  1100. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1101. #: apt-cache.8.xml:249
  1102. msgid ""
  1103. "The resulting nodes will have several shapes; normal packages are boxes, "
  1104. "pure provides are triangles, mixed provides are diamonds, missing packages "
  1105. "are hexagons. Orange boxes mean recursion was stopped [leaf packages], blue "
  1106. "lines are pre-depends, green lines are conflicts."
  1107. msgstr ""
  1108. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1109. #: apt-cache.8.xml:254
  1110. msgid "Caution, dotty cannot graph larger sets of packages."
  1111. msgstr ""
  1112. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1113. #: apt-cache.8.xml:257
  1114. msgid "xvcg <replaceable>pkg(s)</replaceable>"
  1115. msgstr ""
  1116. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1117. #: apt-cache.8.xml:258
  1118. msgid ""
  1119. "The same as <literal>dotty</literal>, only for xvcg from the <ulink "
  1120. "url=\"http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html\">VCG "
  1121. "tool</ulink>."
  1122. msgstr ""
  1123. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1124. #: apt-cache.8.xml:262
  1125. msgid "policy <replaceable>[ pkg(s) ]</replaceable>"
  1126. msgstr ""
  1127. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1128. #: apt-cache.8.xml:263
  1129. msgid ""
  1130. "<literal>policy</literal> is meant to help debug issues relating to the "
  1131. "preferences file. With no arguments it will print out the priorities of each "
  1132. "source. Otherwise it prints out detailed information about the priority "
  1133. "selection of the named package."
  1134. msgstr ""
  1135. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1136. #: apt-cache.8.xml:269
  1137. msgid "madison <replaceable>/[ pkg(s) ]</replaceable>"
  1138. msgstr ""
  1139. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1140. #: apt-cache.8.xml:270
  1141. msgid ""
  1142. "<literal>apt-cache</literal>'s <literal>madison</literal> command attempts "
  1143. "to mimic the output format and a subset of the functionality of the Debian "
  1144. "archive management tool, <literal>madison</literal>. It displays available "
  1145. "versions of a package in a tabular format. Unlike the original "
  1146. "<literal>madison</literal>, it can only display information for the "
  1147. "architecture for which APT has retrieved package lists "
  1148. "(<literal>APT::Architecture</literal>)."
  1149. msgstr ""
  1150. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1151. #: apt-cache.8.xml:281 apt-config.8.xml:93 apt-extracttemplates.1.xml:56 apt-ftparchive.1.xml:493 apt-get.8.xml:319 apt-mark.8.xml:89 apt-sortpkgs.1.xml:54 apt.conf.5.xml:502 apt.conf.5.xml:524
  1152. msgid "options"
  1153. msgstr ""
  1154. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1155. #: apt-cache.8.xml:285
  1156. msgid "<option>-p</option>"
  1157. msgstr ""
  1158. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1159. #: apt-cache.8.xml:285
  1160. msgid "<option>--pkg-cache</option>"
  1161. msgstr ""
  1162. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1163. #: apt-cache.8.xml:286
  1164. msgid ""
  1165. "Select the file to store the package cache. The package cache is the primary "
  1166. "cache used by all operations. Configuration Item: "
  1167. "<literal>Dir::Cache::pkgcache</literal>."
  1168. msgstr ""
  1169. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1170. #: apt-cache.8.xml:291 apt-ftparchive.1.xml:536 apt-get.8.xml:376 apt-sortpkgs.1.xml:58
  1171. msgid "<option>-s</option>"
  1172. msgstr ""
  1173. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1174. #: apt-cache.8.xml:291
  1175. msgid "<option>--src-cache</option>"
  1176. msgstr ""
  1177. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1178. #: apt-cache.8.xml:292
  1179. msgid ""
  1180. "Select the file to store the source cache. The source is used only by "
  1181. "<literal>gencaches</literal> and it stores a parsed version of the package "
  1182. "information from remote sources. When building the package cache the source "
  1183. "cache is used to avoid reparsing all of the package files. Configuration "
  1184. "Item: <literal>Dir::Cache::srcpkgcache</literal>."
  1185. msgstr ""
  1186. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1187. #: apt-cache.8.xml:299 apt-ftparchive.1.xml:510 apt-get.8.xml:366
  1188. msgid "<option>-q</option>"
  1189. msgstr ""
  1190. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1191. #: apt-cache.8.xml:299 apt-ftparchive.1.xml:510 apt-get.8.xml:366
  1192. msgid "<option>--quiet</option>"
  1193. msgstr ""
  1194. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1195. #: apt-cache.8.xml:300
  1196. msgid ""
  1197. "Quiet; produces output suitable for logging, omitting progress indicators. "
  1198. "More q's will produce more quietness up to a maximum of 2. You can also use "
  1199. "<option>-q=#</option> to set the quietness level, overriding the "
  1200. "configuration file. Configuration Item: <literal>quiet</literal>."
  1201. msgstr ""
  1202. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1203. #: apt-cache.8.xml:306
  1204. msgid "<option>-i</option>"
  1205. msgstr ""
  1206. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1207. #: apt-cache.8.xml:306
  1208. msgid "<option>--important</option>"
  1209. msgstr ""
  1210. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1211. #: apt-cache.8.xml:307
  1212. msgid ""
  1213. "Print only important dependencies; for use with unmet and depends. Causes "
  1214. "only Depends and Pre-Depends relations to be printed. Configuration Item: "
  1215. "<literal>APT::Cache::Important</literal>."
  1216. msgstr ""
  1217. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1218. #: apt-cache.8.xml:312 apt-cdrom.8.xml:121 apt-get.8.xml:333
  1219. msgid "<option>-f</option>"
  1220. msgstr ""
  1221. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1222. #: apt-cache.8.xml:312
  1223. msgid "<option>--full</option>"
  1224. msgstr ""
  1225. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1226. #: apt-cache.8.xml:313
  1227. msgid ""
  1228. "Print full package records when searching. Configuration Item: "
  1229. "<literal>APT::Cache::ShowFull</literal>."
  1230. msgstr ""
  1231. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1232. #: apt-cache.8.xml:317 apt-cdrom.8.xml:131 apt-ftparchive.1.xml:548
  1233. msgid "<option>-a</option>"
  1234. msgstr ""
  1235. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1236. #: apt-cache.8.xml:317
  1237. msgid "<option>--all-versions</option>"
  1238. msgstr ""
  1239. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1240. #: apt-cache.8.xml:318
  1241. msgid ""
  1242. "Print full records for all available versions. This is the default; to turn "
  1243. "it off, use <option>--no-all-versions</option>. If "
  1244. "<option>--no-all-versions</option> is specified, only the candidate version "
  1245. "will displayed (the one which would be selected for installation). This "
  1246. "option is only applicable to the <literal>show</literal> command. "
  1247. "Configuration Item: <literal>APT::Cache::AllVersions</literal>."
  1248. msgstr ""
  1249. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1250. #: apt-cache.8.xml:326
  1251. msgid "<option>-g</option>"
  1252. msgstr ""
  1253. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1254. #: apt-cache.8.xml:326
  1255. msgid "<option>--generate</option>"
  1256. msgstr ""
  1257. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1258. #: apt-cache.8.xml:327
  1259. msgid ""
  1260. "Perform automatic package cache regeneration, rather than use the cache as "
  1261. "it is. This is the default; to turn it off, use "
  1262. "<option>--no-generate</option>. Configuration Item: "
  1263. "<literal>APT::Cache::Generate</literal>."
  1264. msgstr ""
  1265. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1266. #: apt-cache.8.xml:332
  1267. msgid "<option>--names-only</option>"
  1268. msgstr ""
  1269. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1270. #: apt-cache.8.xml:332 apt-cdrom.8.xml:139
  1271. msgid "<option>-n</option>"
  1272. msgstr ""
  1273. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1274. #: apt-cache.8.xml:333
  1275. msgid ""
  1276. "Only search on the package names, not the long descriptions. Configuration "
  1277. "Item: <literal>APT::Cache::NamesOnly</literal>."
  1278. msgstr ""
  1279. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1280. #: apt-cache.8.xml:337
  1281. msgid "<option>--all-names</option>"
  1282. msgstr ""
  1283. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1284. #: apt-cache.8.xml:338
  1285. msgid ""
  1286. "Make <literal>pkgnames</literal> print all names, including virtual packages "
  1287. "and missing dependencies. Configuration Item: "
  1288. "<literal>APT::Cache::AllNames</literal>."
  1289. msgstr ""
  1290. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1291. #: apt-cache.8.xml:343
  1292. msgid "<option>--recurse</option>"
  1293. msgstr ""
  1294. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1295. #: apt-cache.8.xml:344
  1296. msgid ""
  1297. "Make <literal>depends</literal> and <literal>rdepends</literal> recursive so "
  1298. "that all packages mentioned are printed once. Configuration Item: "
  1299. "<literal>APT::Cache::RecurseDepends</literal>."
  1300. msgstr ""
  1301. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1302. #: apt-cache.8.xml:349
  1303. msgid "<option>--installed</option>"
  1304. msgstr ""
  1305. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1306. #: apt-cache.8.xml:351
  1307. msgid ""
  1308. "Limit the output of <literal>depends</literal> and "
  1309. "<literal>rdepends</literal> to packages which are currently installed. "
  1310. "Configuration Item: <literal>APT::Cache::Installed</literal>."
  1311. msgstr ""
  1312. #. type: Content of: <refentry><refsect1><variablelist>
  1313. #: apt-cache.8.xml:356 apt-cdrom.8.xml:150 apt-config.8.xml:98 apt-extracttemplates.1.xml:67 apt-ftparchive.1.xml:576 apt-get.8.xml:554 apt-sortpkgs.1.xml:64
  1314. msgid "&apt-commonoptions;"
  1315. msgstr ""
  1316. #. type: Content of: <refentry><refsect1><title>
  1317. #: apt-cache.8.xml:361 apt-get.8.xml:559 apt-key.8.xml:153 apt-mark.8.xml:122 apt.conf.5.xml:1035 apt_preferences.5.xml:630
  1318. msgid "Files"
  1319. msgstr ""
  1320. #. type: Content of: <refentry><refsect1><variablelist>
  1321. #: apt-cache.8.xml:363
  1322. msgid "&file-sourceslist; &file-statelists;"
  1323. msgstr ""
  1324. #. type: Content of: <refentry><refsect1><title>
  1325. #: apt-cache.8.xml:368 apt-cdrom.8.xml:155 apt-config.8.xml:103 apt-extracttemplates.1.xml:74 apt-ftparchive.1.xml:592 apt-get.8.xml:569 apt-key.8.xml:174 apt-mark.8.xml:133 apt-secure.8.xml:181 apt-sortpkgs.1.xml:69 apt.conf.5.xml:1041 apt_preferences.5.xml:637 sources.list.5.xml:233
  1326. msgid "See Also"
  1327. msgstr ""
  1328. #. type: Content of: <refentry><refsect1><para>
  1329. #: apt-cache.8.xml:369
  1330. msgid "&apt-conf;, &sources-list;, &apt-get;"
  1331. msgstr ""
  1332. #. type: Content of: <refentry><refsect1><title>
  1333. #: apt-cache.8.xml:373 apt-cdrom.8.xml:160 apt-config.8.xml:108 apt-extracttemplates.1.xml:78 apt-ftparchive.1.xml:596 apt-get.8.xml:575 apt-mark.8.xml:137 apt-sortpkgs.1.xml:73
  1334. msgid "Diagnostics"
  1335. msgstr ""
  1336. #. type: Content of: <refentry><refsect1><para>
  1337. #: apt-cache.8.xml:374
  1338. msgid ""
  1339. "<command>apt-cache</command> returns zero on normal operation, decimal 100 "
  1340. "on error."
  1341. msgstr ""
  1342. #. type: Content of: <refentry><refentryinfo>
  1343. #: apt-cdrom.8.xml:13
  1344. msgid ""
  1345. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>14 "
  1346. "February 2004</date>"
  1347. msgstr ""
  1348. #. type: Content of: <refentry><refnamediv><refname>
  1349. #: apt-cdrom.8.xml:21 apt-cdrom.8.xml:28
  1350. msgid "apt-cdrom"
  1351. msgstr ""
  1352. #. type: Content of: <refentry><refnamediv><refpurpose>
  1353. #: apt-cdrom.8.xml:29
  1354. msgid "APT CDROM management utility"
  1355. msgstr ""
  1356. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1357. #: apt-cdrom.8.xml:35
  1358. msgid ""
  1359. "<command>apt-cdrom</command> <arg><option>-hvrmfan</option></arg> "
  1360. "<arg><option>-d=<replaceable>cdrom mount point</replaceable></option></arg> "
  1361. "<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
  1362. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <group> "
  1363. "<arg>add</arg> <arg>ident</arg> </group>"
  1364. msgstr ""
  1365. #. type: Content of: <refentry><refsect1><para>
  1366. #: apt-cdrom.8.xml:48
  1367. msgid ""
  1368. "<command>apt-cdrom</command> is used to add a new CDROM to APTs list of "
  1369. "available sources. <command>apt-cdrom</command> takes care of determining "
  1370. "the structure of the disc as well as correcting for several possible "
  1371. "mis-burns and verifying the index files."
  1372. msgstr ""
  1373. #. type: Content of: <refentry><refsect1><para>
  1374. #: apt-cdrom.8.xml:55
  1375. msgid ""
  1376. "It is necessary to use <command>apt-cdrom</command> to add CDs to the APT "
  1377. "system, it cannot be done by hand. Furthermore each disk in a multi-cd set "
  1378. "must be inserted and scanned separately to account for possible mis-burns."
  1379. msgstr ""
  1380. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  1381. #: apt-cdrom.8.xml:65
  1382. msgid "add"
  1383. msgstr ""
  1384. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  1385. #: apt-cdrom.8.xml:66
  1386. msgid ""
  1387. "<literal>add</literal> is used to add a new disc to the source list. It will "
  1388. "unmount the CDROM device, prompt for a disk to be inserted and then proceed "
  1389. "to scan it and copy the index files. If the disc does not have a proper "
  1390. "<filename>disk</filename> directory you will be prompted for a descriptive "
  1391. "title."
  1392. msgstr ""
  1393. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  1394. #: apt-cdrom.8.xml:74
  1395. msgid ""
  1396. "APT uses a CDROM ID to track which disc is currently in the drive and "
  1397. "maintains a database of these IDs in "
  1398. "<filename>&statedir;/cdroms.list</filename>"
  1399. msgstr ""
  1400. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  1401. #: apt-cdrom.8.xml:81
  1402. msgid "ident"
  1403. msgstr ""
  1404. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  1405. #: apt-cdrom.8.xml:82
  1406. msgid ""
  1407. "A debugging tool to report the identity of the current disc as well as the "
  1408. "stored file name"
  1409. msgstr ""
  1410. #. type: Content of: <refentry><refsect1><para>
  1411. #: apt-cdrom.8.xml:61
  1412. msgid ""
  1413. "Unless the <option>-h</option>, or <option>--help</option> option is given "
  1414. "one of the commands below must be present. <placeholder "
  1415. "type=\"variablelist\" id=\"0\"/>"
  1416. msgstr ""
  1417. #. type: Content of: <refentry><refsect1><title>
  1418. #: apt-cdrom.8.xml:91 apt-key.8.xml:139
  1419. msgid "Options"
  1420. msgstr ""
  1421. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1422. #: apt-cdrom.8.xml:95 apt-ftparchive.1.xml:504 apt-get.8.xml:328
  1423. msgid "<option>-d</option>"
  1424. msgstr ""
  1425. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1426. #: apt-cdrom.8.xml:95
  1427. msgid "<option>--cdrom</option>"
  1428. msgstr ""
  1429. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1430. #: apt-cdrom.8.xml:96
  1431. msgid ""
  1432. "Mount point; specify the location to mount the cdrom. This mount point must "
  1433. "be listed in <filename>/etc/fstab</filename> and properly configured. "
  1434. "Configuration Item: <literal>Acquire::cdrom::mount</literal>."
  1435. msgstr ""
  1436. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1437. #: apt-cdrom.8.xml:104
  1438. msgid "<option>-r</option>"
  1439. msgstr ""
  1440. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1441. #: apt-cdrom.8.xml:104
  1442. msgid "<option>--rename</option>"
  1443. msgstr ""
  1444. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1445. #: apt-cdrom.8.xml:105
  1446. msgid ""
  1447. "Rename a disc; change the label of a disk or override the disks given "
  1448. "label. This option will cause <command>apt-cdrom</command> to prompt for a "
  1449. "new label. Configuration Item: <literal>APT::CDROM::Rename</literal>."
  1450. msgstr ""
  1451. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1452. #: apt-cdrom.8.xml:113 apt-get.8.xml:347
  1453. msgid "<option>-m</option>"
  1454. msgstr ""
  1455. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1456. #: apt-cdrom.8.xml:113
  1457. msgid "<option>--no-mount</option>"
  1458. msgstr ""
  1459. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1460. #: apt-cdrom.8.xml:114
  1461. msgid ""
  1462. "No mounting; prevent <command>apt-cdrom</command> from mounting and "
  1463. "unmounting the mount point. Configuration Item: "
  1464. "<literal>APT::CDROM::NoMount</literal>."
  1465. msgstr ""
  1466. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1467. #: apt-cdrom.8.xml:121
  1468. msgid "<option>--fast</option>"
  1469. msgstr ""
  1470. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1471. #: apt-cdrom.8.xml:122
  1472. msgid ""
  1473. "Fast Copy; Assume the package files are valid and do not check every "
  1474. "package. This option should be used only if <command>apt-cdrom</command> has "
  1475. "been run on this disc before and did not detect any errors. Configuration "
  1476. "Item: <literal>APT::CDROM::Fast</literal>."
  1477. msgstr ""
  1478. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1479. #: apt-cdrom.8.xml:131
  1480. msgid "<option>--thorough</option>"
  1481. msgstr ""
  1482. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1483. #: apt-cdrom.8.xml:132
  1484. msgid ""
  1485. "Thorough Package Scan; This option may be needed with some old Debian "
  1486. "1.1/1.2 discs that have Package files in strange places. It takes much "
  1487. "longer to scan the CD but will pick them all up."
  1488. msgstr ""
  1489. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1490. #: apt-cdrom.8.xml:140 apt-get.8.xml:378
  1491. msgid "<option>--just-print</option>"
  1492. msgstr ""
  1493. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1494. #: apt-cdrom.8.xml:141 apt-get.8.xml:380
  1495. msgid "<option>--recon</option>"
  1496. msgstr ""
  1497. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1498. #: apt-cdrom.8.xml:142 apt-get.8.xml:381
  1499. msgid "<option>--no-act</option>"
  1500. msgstr ""
  1501. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1502. #: apt-cdrom.8.xml:143
  1503. msgid ""
  1504. "No Changes; Do not change the &sources-list; file and do not write index "
  1505. "files. Everything is still checked however. Configuration Item: "
  1506. "<literal>APT::CDROM::NoAct</literal>."
  1507. msgstr ""
  1508. #. type: Content of: <refentry><refsect1><para>
  1509. #: apt-cdrom.8.xml:156
  1510. msgid "&apt-conf;, &apt-get;, &sources-list;"
  1511. msgstr ""
  1512. #. type: Content of: <refentry><refsect1><para>
  1513. #: apt-cdrom.8.xml:161
  1514. msgid ""
  1515. "<command>apt-cdrom</command> returns zero on normal operation, decimal 100 "
  1516. "on error."
  1517. msgstr ""
  1518. #. type: Content of: <refentry><refnamediv><refname>
  1519. #: apt-config.8.xml:22 apt-config.8.xml:29
  1520. msgid "apt-config"
  1521. msgstr ""
  1522. #. type: Content of: <refentry><refnamediv><refpurpose>
  1523. #: apt-config.8.xml:30
  1524. msgid "APT Configuration Query program"
  1525. msgstr ""
  1526. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1527. #: apt-config.8.xml:36
  1528. msgid ""
  1529. "<command>apt-config</command> <arg><option>-hv</option></arg> "
  1530. "<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
  1531. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
  1532. "choice=\"req\"> <arg>shell</arg> <arg>dump</arg> </group>"
  1533. msgstr ""
  1534. #. type: Content of: <refentry><refsect1><para>
  1535. #: apt-config.8.xml:48
  1536. msgid ""
  1537. "<command>apt-config</command> is an internal program used by various "
  1538. "portions of the APT suite to provide consistent configurability. It accesses "
  1539. "the main configuration file <filename>/etc/apt/apt.conf</filename> in a "
  1540. "manner that is easy to use by scripted applications."
  1541. msgstr ""
  1542. #. type: Content of: <refentry><refsect1><para>
  1543. #: apt-config.8.xml:53 apt-ftparchive.1.xml:72
  1544. msgid ""
  1545. "Unless the <option>-h</option>, or <option>--help</option> option is given "
  1546. "one of the commands below must be present."
  1547. msgstr ""
  1548. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1549. #: apt-config.8.xml:58
  1550. msgid "shell"
  1551. msgstr ""
  1552. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1553. #: apt-config.8.xml:60
  1554. msgid ""
  1555. "shell is used to access the configuration information from a shell "
  1556. "script. It is given pairs of arguments, the first being a shell variable and "
  1557. "the second the configuration value to query. As output it lists a series of "
  1558. "shell assignments commands for each present value. In a shell script it "
  1559. "should be used like:"
  1560. msgstr ""
  1561. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
  1562. #: apt-config.8.xml:68
  1563. #, no-wrap
  1564. msgid ""
  1565. "OPTS=\"-f\"\n"
  1566. "RES=`apt-config shell OPTS MyApp::options`\n"
  1567. "eval $RES\n"
  1568. msgstr ""
  1569. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1570. #: apt-config.8.xml:73
  1571. msgid ""
  1572. "This will set the shell environment variable $OPTS to the value of "
  1573. "MyApp::options with a default of <option>-f</option>."
  1574. msgstr ""
  1575. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1576. #: apt-config.8.xml:77
  1577. msgid ""
  1578. "The configuration item may be postfixed with a /[fdbi]. f returns file "
  1579. "names, d returns directories, b returns true or false and i returns an "
  1580. "integer. Each of the returns is normalized and verified internally."
  1581. msgstr ""
  1582. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1583. #: apt-config.8.xml:86
  1584. msgid "Just show the contents of the configuration space."
  1585. msgstr ""
  1586. #. type: Content of: <refentry><refsect1><para>
  1587. #: apt-config.8.xml:104 apt-extracttemplates.1.xml:75 apt-ftparchive.1.xml:593 apt-sortpkgs.1.xml:70
  1588. msgid "&apt-conf;"
  1589. msgstr ""
  1590. #. type: Content of: <refentry><refsect1><para>
  1591. #: apt-config.8.xml:109
  1592. msgid ""
  1593. "<command>apt-config</command> returns zero on normal operation, decimal 100 "
  1594. "on error."
  1595. msgstr ""
  1596. #. type: Content of: <refentry><refnamediv><refname>
  1597. #: apt-extracttemplates.1.xml:22 apt-extracttemplates.1.xml:29
  1598. msgid "apt-extracttemplates"
  1599. msgstr ""
  1600. #. type: Content of: <refentry><refmeta><manvolnum>
  1601. #: apt-extracttemplates.1.xml:23 apt-ftparchive.1.xml:23 apt-sortpkgs.1.xml:23
  1602. msgid "1"
  1603. msgstr ""
  1604. #. type: Content of: <refentry><refnamediv><refpurpose>
  1605. #: apt-extracttemplates.1.xml:30
  1606. msgid "Utility to extract DebConf config and templates from Debian packages"
  1607. msgstr ""
  1608. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1609. #: apt-extracttemplates.1.xml:36
  1610. msgid ""
  1611. "<command>apt-extracttemplates</command> <arg><option>-hv</option></arg> "
  1612. "<arg><option>-t=<replaceable>temporary "
  1613. "directory</replaceable></option></arg> <arg choice=\"plain\" "
  1614. "rep=\"repeat\"><replaceable>file</replaceable></arg>"
  1615. msgstr ""
  1616. #. type: Content of: <refentry><refsect1><para>
  1617. #: apt-extracttemplates.1.xml:44
  1618. msgid ""
  1619. "<command>apt-extracttemplates</command> will take one or more Debian package "
  1620. "files as input and write out (to a temporary directory) all associated "
  1621. "config scripts and template files. For each passed in package that contains "
  1622. "config scripts and templates, one line of output will be generated in the "
  1623. "format:"
  1624. msgstr ""
  1625. #. type: Content of: <refentry><refsect1><para>
  1626. #: apt-extracttemplates.1.xml:49
  1627. msgid "package version template-file config-script"
  1628. msgstr ""
  1629. #. type: Content of: <refentry><refsect1><para>
  1630. #: apt-extracttemplates.1.xml:50
  1631. msgid ""
  1632. "template-file and config-script are written to the temporary directory "
  1633. "specified by the -t or --tempdir "
  1634. "(<literal>APT::ExtractTemplates::TempDir</literal>) directory, with "
  1635. "filenames of the form <filename>package.template.XXXX</filename> and "
  1636. "<filename>package.config.XXXX</filename>"
  1637. msgstr ""
  1638. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1639. #: apt-extracttemplates.1.xml:60 apt-get.8.xml:488
  1640. msgid "<option>-t</option>"
  1641. msgstr ""
  1642. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1643. #: apt-extracttemplates.1.xml:60
  1644. msgid "<option>--tempdir</option>"
  1645. msgstr ""
  1646. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1647. #: apt-extracttemplates.1.xml:62
  1648. msgid ""
  1649. "Temporary directory in which to write extracted debconf template files and "
  1650. "config scripts. Configuration Item: "
  1651. "<literal>APT::ExtractTemplates::TempDir</literal>"
  1652. msgstr ""
  1653. #. type: Content of: <refentry><refsect1><para>
  1654. #: apt-extracttemplates.1.xml:79
  1655. msgid ""
  1656. "<command>apt-extracttemplates</command> returns zero on normal operation, "
  1657. "decimal 100 on error."
  1658. msgstr ""
  1659. #. The last update date
  1660. #. type: Content of: <refentry><refentryinfo>
  1661. #: apt-ftparchive.1.xml:13
  1662. msgid ""
  1663. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>17 "
  1664. "August 2009</date>"
  1665. msgstr ""
  1666. #. type: Content of: <refentry><refnamediv><refname>
  1667. #: apt-ftparchive.1.xml:22 apt-ftparchive.1.xml:29
  1668. msgid "apt-ftparchive"
  1669. msgstr ""
  1670. #. type: Content of: <refentry><refnamediv><refpurpose>
  1671. #: apt-ftparchive.1.xml:30
  1672. msgid "Utility to generate index files"
  1673. msgstr ""
  1674. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1675. #: apt-ftparchive.1.xml:36
  1676. msgid ""
  1677. "<command>apt-ftparchive</command> <arg><option>-hvdsq</option></arg> "
  1678. "<arg><option>--md5</option></arg> <arg><option>--delink</option></arg> "
  1679. "<arg><option>--readonly</option></arg> "
  1680. "<arg><option>--contents</option></arg> <arg><option>--arch "
  1681. "<replaceable>architecture</replaceable></option></arg> <arg><option>-o "
  1682. "<replaceable>config</replaceable>=<replaceable>string</replaceable></option></arg> "
  1683. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
  1684. "choice=\"req\"> <arg>packages<arg choice=\"plain\" "
  1685. "rep=\"repeat\"><replaceable>path</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>pathprefix</replaceable></arg></arg></arg> "
  1686. "<arg>sources<arg choice=\"plain\" "
  1687. "rep=\"repeat\"><replaceable>path</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>pathprefix</replaceable></arg></arg></arg> "
  1688. "<arg>contents <arg "
  1689. "choice=\"plain\"><replaceable>path</replaceable></arg></arg> <arg>release "
  1690. "<arg choice=\"plain\"><replaceable>path</replaceable></arg></arg> "
  1691. "<arg>generate <arg "
  1692. "choice=\"plain\"><replaceable>config-file</replaceable></arg> <arg "
  1693. "choice=\"plain\" "
  1694. "rep=\"repeat\"><replaceable>section</replaceable></arg></arg> <arg>clean "
  1695. "<arg choice=\"plain\"><replaceable>config-file</replaceable></arg></arg> "
  1696. "</group>"
  1697. msgstr ""
  1698. #. type: Content of: <refentry><refsect1><para>
  1699. #: apt-ftparchive.1.xml:57
  1700. msgid ""
  1701. "<command>apt-ftparchive</command> is the command line tool that generates "
  1702. "the index files that APT uses to access a distribution source. The index "
  1703. "files should be generated on the origin site based on the content of that "
  1704. "site."
  1705. msgstr ""
  1706. #. type: Content of: <refentry><refsect1><para>
  1707. #: apt-ftparchive.1.xml:61
  1708. msgid ""
  1709. "<command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; "
  1710. "program, incorporating its entire functionality via the "
  1711. "<literal>packages</literal> command. It also contains a contents file "
  1712. "generator, <literal>contents</literal>, and an elaborate means to 'script' "
  1713. "the generation process for a complete archive."
  1714. msgstr ""
  1715. #. type: Content of: <refentry><refsect1><para>
  1716. #: apt-ftparchive.1.xml:67
  1717. msgid ""
  1718. "Internally <command>apt-ftparchive</command> can make use of binary "
  1719. "databases to cache the contents of a .deb file and it does not rely on any "
  1720. "external programs aside from &gzip;. When doing a full generate it "
  1721. "automatically performs file-change checks and builds the desired compressed "
  1722. "output files."
  1723. msgstr ""
  1724. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1725. #: apt-ftparchive.1.xml:76
  1726. msgid "packages"
  1727. msgstr ""
  1728. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1729. #: apt-ftparchive.1.xml:78
  1730. msgid ""
  1731. "The packages command generates a package file from a directory tree. It "
  1732. "takes the given directory and recursively searches it for .deb files, "
  1733. "emitting a package record to stdout for each. This command is approximately "
  1734. "equivalent to &dpkg-scanpackages;."
  1735. msgstr ""
  1736. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1737. #: apt-ftparchive.1.xml:83 apt-ftparchive.1.xml:107
  1738. msgid "The option <option>--db</option> can be used to specify a binary caching DB."
  1739. msgstr ""
  1740. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1741. #: apt-ftparchive.1.xml:86
  1742. msgid "sources"
  1743. msgstr ""
  1744. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1745. #: apt-ftparchive.1.xml:88
  1746. msgid ""
  1747. "The <literal>sources</literal> command generates a source index file from a "
  1748. "directory tree. It takes the given directory and recursively searches it "
  1749. "for .dsc files, emitting a source record to stdout for each. This command is "
  1750. "approximately equivalent to &dpkg-scansources;."
  1751. msgstr ""
  1752. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1753. #: apt-ftparchive.1.xml:93
  1754. msgid ""
  1755. "If an override file is specified then a source override file will be looked "
  1756. "for with an extension of .src. The --source-override option can be used to "
  1757. "change the source override file that will be used."
  1758. msgstr ""
  1759. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1760. #: apt-ftparchive.1.xml:98
  1761. msgid "contents"
  1762. msgstr ""
  1763. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1764. #: apt-ftparchive.1.xml:100
  1765. msgid ""
  1766. "The <literal>contents</literal> command generates a contents file from a "
  1767. "directory tree. It takes the given directory and recursively searches it for "
  1768. ".deb files, and reads the file list from each file. It then sorts and writes "
  1769. "to stdout the list of files matched to packages. Directories are not written "
  1770. "to the output. If multiple packages own the same file then each package is "
  1771. "separated by a comma in the output."
  1772. msgstr ""
  1773. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1774. #: apt-ftparchive.1.xml:110
  1775. msgid "release"
  1776. msgstr ""
  1777. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1778. #: apt-ftparchive.1.xml:112
  1779. msgid ""
  1780. "The <literal>release</literal> command generates a Release file from a "
  1781. "directory tree. It recursively searches the given directory for Packages, "
  1782. "Packages.gz, Packages.bz2, Sources, Sources.gz, Sources.bz2, Release and "
  1783. "md5sum.txt files. It then writes to stdout a Release file containing an MD5 "
  1784. "digest and SHA1 digest for each file."
  1785. msgstr ""
  1786. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1787. #: apt-ftparchive.1.xml:119
  1788. msgid ""
  1789. "Values for the additional metadata fields in the Release file are taken from "
  1790. "the corresponding variables under "
  1791. "<literal>APT::FTPArchive::Release</literal>, "
  1792. "e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The supported "
  1793. "fields are: <literal>Origin</literal>, <literal>Label</literal>, "
  1794. "<literal>Suite</literal>, <literal>Version</literal>, "
  1795. "<literal>Codename</literal>, <literal>Date</literal>, "
  1796. "<literal>Architectures</literal>, <literal>Components</literal>, "
  1797. "<literal>Description</literal>."
  1798. msgstr ""
  1799. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1800. #: apt-ftparchive.1.xml:129
  1801. msgid "generate"
  1802. msgstr ""
  1803. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1804. #: apt-ftparchive.1.xml:131
  1805. msgid ""
  1806. "The <literal>generate</literal> command is designed to be runnable from a "
  1807. "cron script and builds indexes according to the given config file. The "
  1808. "config language provides a flexible means of specifying which index files "
  1809. "are built from which directories, as well as providing a simple means of "
  1810. "maintaining the required settings."
  1811. msgstr ""
  1812. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1813. #: apt-ftparchive.1.xml:138 apt-get.8.xml:292
  1814. msgid "clean"
  1815. msgstr ""
  1816. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1817. #: apt-ftparchive.1.xml:140
  1818. msgid ""
  1819. "The <literal>clean</literal> command tidies the databases used by the given "
  1820. "configuration file by removing any records that are no longer necessary."
  1821. msgstr ""
  1822. #. type: Content of: <refentry><refsect1><title>
  1823. #: apt-ftparchive.1.xml:146
  1824. msgid "The Generate Configuration"
  1825. msgstr ""
  1826. #. type: Content of: <refentry><refsect1><para>
  1827. #: apt-ftparchive.1.xml:148
  1828. msgid ""
  1829. "The <literal>generate</literal> command uses a configuration file to "
  1830. "describe the archives that are going to be generated. It follows the typical "
  1831. "ISC configuration format as seen in ISC tools like bind 8 and dhcpd. "
  1832. "&apt-conf; contains a description of the syntax. Note that the generate "
  1833. "configuration is parsed in sectional manner, but &apt-conf; is parsed in a "
  1834. "tree manner. This only effects how the scope tag is handled."
  1835. msgstr ""
  1836. #. type: Content of: <refentry><refsect1><para>
  1837. #: apt-ftparchive.1.xml:156
  1838. msgid "The generate configuration has 4 separate sections, each described below."
  1839. msgstr ""
  1840. #. type: Content of: <refentry><refsect1><refsect2><title>
  1841. #: apt-ftparchive.1.xml:158
  1842. msgid "Dir Section"
  1843. msgstr ""
  1844. #. type: Content of: <refentry><refsect1><refsect2><para>
  1845. #: apt-ftparchive.1.xml:160
  1846. msgid ""
  1847. "The <literal>Dir</literal> section defines the standard directories needed "
  1848. "to locate the files required during the generation process. These "
  1849. "directories are prepended certain relative paths defined in later sections "
  1850. "to produce a complete an absolute path."
  1851. msgstr ""
  1852. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1853. #: apt-ftparchive.1.xml:165
  1854. msgid "ArchiveDir"
  1855. msgstr ""
  1856. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1857. #: apt-ftparchive.1.xml:167
  1858. msgid ""
  1859. "Specifies the root of the FTP archive, in a standard Debian configuration "
  1860. "this is the directory that contains the <filename>ls-LR</filename> and dist "
  1861. "nodes."
  1862. msgstr ""
  1863. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1864. #: apt-ftparchive.1.xml:172
  1865. msgid "OverrideDir"
  1866. msgstr ""
  1867. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1868. #: apt-ftparchive.1.xml:174
  1869. msgid "Specifies the location of the override files."
  1870. msgstr ""
  1871. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1872. #: apt-ftparchive.1.xml:177
  1873. msgid "CacheDir"
  1874. msgstr ""
  1875. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1876. #: apt-ftparchive.1.xml:179
  1877. msgid "Specifies the location of the cache files"
  1878. msgstr ""
  1879. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1880. #: apt-ftparchive.1.xml:182
  1881. msgid "FileListDir"
  1882. msgstr ""
  1883. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1884. #: apt-ftparchive.1.xml:184
  1885. msgid ""
  1886. "Specifies the location of the file list files, if the "
  1887. "<literal>FileList</literal> setting is used below."
  1888. msgstr ""
  1889. #. type: Content of: <refentry><refsect1><refsect2><title>
  1890. #: apt-ftparchive.1.xml:190
  1891. msgid "Default Section"
  1892. msgstr ""
  1893. #. type: Content of: <refentry><refsect1><refsect2><para>
  1894. #: apt-ftparchive.1.xml:192
  1895. msgid ""
  1896. "The <literal>Default</literal> section specifies default values, and "
  1897. "settings that control the operation of the generator. Other sections may "
  1898. "override these defaults with a per-section setting."
  1899. msgstr ""
  1900. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1901. #: apt-ftparchive.1.xml:196
  1902. msgid "Packages::Compress"
  1903. msgstr ""
  1904. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1905. #: apt-ftparchive.1.xml:198
  1906. msgid ""
  1907. "Sets the default compression schemes to use for the Package index files. It "
  1908. "is a string that contains a space separated list of at least one of: '.' (no "
  1909. "compression), 'gzip' and 'bzip2'. The default for all compression schemes is "
  1910. "'. gzip'."
  1911. msgstr ""
  1912. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1913. #: apt-ftparchive.1.xml:204
  1914. msgid "Packages::Extensions"
  1915. msgstr ""
  1916. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1917. #: apt-ftparchive.1.xml:206
  1918. msgid ""
  1919. "Sets the default list of file extensions that are package files. This "
  1920. "defaults to '.deb'."
  1921. msgstr ""
  1922. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1923. #: apt-ftparchive.1.xml:210
  1924. msgid "Sources::Compress"
  1925. msgstr ""
  1926. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1927. #: apt-ftparchive.1.xml:212
  1928. msgid ""
  1929. "This is similar to <literal>Packages::Compress</literal> except that it "
  1930. "controls the compression for the Sources files."
  1931. msgstr ""
  1932. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1933. #: apt-ftparchive.1.xml:216
  1934. msgid "Sources::Extensions"
  1935. msgstr ""
  1936. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1937. #: apt-ftparchive.1.xml:218
  1938. msgid ""
  1939. "Sets the default list of file extensions that are source files. This "
  1940. "defaults to '.dsc'."
  1941. msgstr ""
  1942. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1943. #: apt-ftparchive.1.xml:222
  1944. msgid "Contents::Compress"
  1945. msgstr ""
  1946. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1947. #: apt-ftparchive.1.xml:224
  1948. msgid ""
  1949. "This is similar to <literal>Packages::Compress</literal> except that it "
  1950. "controls the compression for the Contents files."
  1951. msgstr ""
  1952. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1953. #: apt-ftparchive.1.xml:228
  1954. msgid "DeLinkLimit"
  1955. msgstr ""
  1956. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1957. #: apt-ftparchive.1.xml:230
  1958. msgid ""
  1959. "Specifies the number of kilobytes to delink (and replace with hard links) "
  1960. "per run. This is used in conjunction with the per-section "
  1961. "<literal>External-Links</literal> setting."
  1962. msgstr ""
  1963. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1964. #: apt-ftparchive.1.xml:235
  1965. msgid "FileMode"
  1966. msgstr ""
  1967. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1968. #: apt-ftparchive.1.xml:237
  1969. msgid ""
  1970. "Specifies the mode of all created index files. It defaults to 0644. All "
  1971. "index files are set to this mode with no regard to the umask."
  1972. msgstr ""
  1973. #. type: Content of: <refentry><refsect1><refsect2><title>
  1974. #: apt-ftparchive.1.xml:244
  1975. msgid "TreeDefault Section"
  1976. msgstr ""
  1977. #. type: Content of: <refentry><refsect1><refsect2><para>
  1978. #: apt-ftparchive.1.xml:246
  1979. msgid ""
  1980. "Sets defaults specific to <literal>Tree</literal> sections. All of these "
  1981. "variables are substitution variables and have the strings $(DIST), "
  1982. "$(SECTION) and $(ARCH) replaced with their respective values."
  1983. msgstr ""
  1984. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1985. #: apt-ftparchive.1.xml:251
  1986. msgid "MaxContentsChange"
  1987. msgstr ""
  1988. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1989. #: apt-ftparchive.1.xml:253
  1990. msgid ""
  1991. "Sets the number of kilobytes of contents files that are generated each "
  1992. "day. The contents files are round-robined so that over several days they "
  1993. "will all be rebuilt."
  1994. msgstr ""
  1995. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1996. #: apt-ftparchive.1.xml:258
  1997. msgid "ContentsAge"
  1998. msgstr ""
  1999. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2000. #: apt-ftparchive.1.xml:260
  2001. msgid ""
  2002. "Controls the number of days a contents file is allowed to be checked without "
  2003. "changing. If this limit is passed the mtime of the contents file is "
  2004. "updated. This case can occur if the package file is changed in such a way "
  2005. "that does not result in a new contents file [override edit for instance]. A "
  2006. "hold off is allowed in hopes that new .debs will be installed, requiring a "
  2007. "new file anyhow. The default is 10, the units are in days."
  2008. msgstr ""
  2009. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2010. #: apt-ftparchive.1.xml:269
  2011. msgid "Directory"
  2012. msgstr ""
  2013. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2014. #: apt-ftparchive.1.xml:271
  2015. msgid ""
  2016. "Sets the top of the .deb directory tree. Defaults to "
  2017. "<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>"
  2018. msgstr ""
  2019. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2020. #: apt-ftparchive.1.xml:275
  2021. msgid "SrcDirectory"
  2022. msgstr ""
  2023. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2024. #: apt-ftparchive.1.xml:277
  2025. msgid ""
  2026. "Sets the top of the source package directory tree. Defaults to "
  2027. "<filename>$(DIST)/$(SECTION)/source/</filename>"
  2028. msgstr ""
  2029. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2030. #: apt-ftparchive.1.xml:281 apt-ftparchive.1.xml:407
  2031. msgid "Packages"
  2032. msgstr ""
  2033. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2034. #: apt-ftparchive.1.xml:283
  2035. msgid ""
  2036. "Sets the output Packages file. Defaults to "
  2037. "<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>"
  2038. msgstr ""
  2039. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2040. #: apt-ftparchive.1.xml:287 apt-ftparchive.1.xml:412
  2041. msgid "Sources"
  2042. msgstr ""
  2043. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2044. #: apt-ftparchive.1.xml:289
  2045. msgid ""
  2046. "Sets the output Sources file. Defaults to "
  2047. "<filename>$(DIST)/$(SECTION)/source/Sources</filename>"
  2048. msgstr ""
  2049. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2050. #: apt-ftparchive.1.xml:293
  2051. msgid "InternalPrefix"
  2052. msgstr ""
  2053. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2054. #: apt-ftparchive.1.xml:295
  2055. msgid ""
  2056. "Sets the path prefix that causes a symlink to be considered an internal link "
  2057. "instead of an external link. Defaults to "
  2058. "<filename>$(DIST)/$(SECTION)/</filename>"
  2059. msgstr ""
  2060. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2061. #: apt-ftparchive.1.xml:300 apt-ftparchive.1.xml:418
  2062. msgid "Contents"
  2063. msgstr ""
  2064. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2065. #: apt-ftparchive.1.xml:302
  2066. msgid ""
  2067. "Sets the output Contents file. Defaults to "
  2068. "<filename>$(DIST)/Contents-$(ARCH)</filename>. If this setting causes "
  2069. "multiple Packages files to map onto a single Contents file (such as the "
  2070. "default) then <command>apt-ftparchive</command> will integrate those "
  2071. "package files together automatically."
  2072. msgstr ""
  2073. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2074. #: apt-ftparchive.1.xml:309
  2075. msgid "Contents::Header"
  2076. msgstr ""
  2077. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2078. #: apt-ftparchive.1.xml:311
  2079. msgid "Sets header file to prepend to the contents output."
  2080. msgstr ""
  2081. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2082. #: apt-ftparchive.1.xml:314 apt-ftparchive.1.xml:443
  2083. msgid "BinCacheDB"
  2084. msgstr ""
  2085. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2086. #: apt-ftparchive.1.xml:316
  2087. msgid ""
  2088. "Sets the binary cache database to use for this section. Multiple sections "
  2089. "can share the same database."
  2090. msgstr ""
  2091. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2092. #: apt-ftparchive.1.xml:320
  2093. msgid "FileList"
  2094. msgstr ""
  2095. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2096. #: apt-ftparchive.1.xml:322
  2097. msgid ""
  2098. "Specifies that instead of walking the directory tree, "
  2099. "<command>apt-ftparchive</command> should read the list of files from the "
  2100. "given file. Relative files names are prefixed with the archive directory."
  2101. msgstr ""
  2102. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2103. #: apt-ftparchive.1.xml:327
  2104. msgid "SourceFileList"
  2105. msgstr ""
  2106. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2107. #: apt-ftparchive.1.xml:329
  2108. msgid ""
  2109. "Specifies that instead of walking the directory tree, "
  2110. "<command>apt-ftparchive</command> should read the list of files from the "
  2111. "given file. Relative files names are prefixed with the archive directory. "
  2112. "This is used when processing source indexes."
  2113. msgstr ""
  2114. #. type: Content of: <refentry><refsect1><refsect2><title>
  2115. #: apt-ftparchive.1.xml:337
  2116. msgid "Tree Section"
  2117. msgstr ""
  2118. #. type: Content of: <refentry><refsect1><refsect2><para>
  2119. #: apt-ftparchive.1.xml:339
  2120. msgid ""
  2121. "The <literal>Tree</literal> section defines a standard Debian file tree "
  2122. "which consists of a base directory, then multiple sections in that base "
  2123. "directory and finally multiple Architectures in each section. The exact "
  2124. "pathing used is defined by the <literal>Directory</literal> substitution "
  2125. "variable."
  2126. msgstr ""
  2127. #. type: Content of: <refentry><refsect1><refsect2><para>
  2128. #: apt-ftparchive.1.xml:344
  2129. msgid ""
  2130. "The <literal>Tree</literal> section takes a scope tag which sets the "
  2131. "<literal>$(DIST)</literal> variable and defines the root of the tree (the "
  2132. "path is prefixed by <literal>ArchiveDir</literal>). Typically this is a "
  2133. "setting such as <filename>dists/woody</filename>."
  2134. msgstr ""
  2135. #. type: Content of: <refentry><refsect1><refsect2><para>
  2136. #: apt-ftparchive.1.xml:349
  2137. msgid ""
  2138. "All of the settings defined in the <literal>TreeDefault</literal> section "
  2139. "can be use in a <literal>Tree</literal> section as well as three new "
  2140. "variables."
  2141. msgstr ""
  2142. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  2143. #: apt-ftparchive.1.xml:355
  2144. #, no-wrap
  2145. msgid ""
  2146. "for i in Sections do \n"
  2147. " for j in Architectures do\n"
  2148. " Generate for DIST=scope SECTION=i ARCH=j\n"
  2149. " "
  2150. msgstr ""
  2151. #. type: Content of: <refentry><refsect1><refsect2><para>
  2152. #: apt-ftparchive.1.xml:352
  2153. msgid ""
  2154. "When processing a <literal>Tree</literal> section "
  2155. "<command>apt-ftparchive</command> performs an operation similar to: "
  2156. "<placeholder type=\"programlisting\" id=\"0\"/>"
  2157. msgstr ""
  2158. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2159. #: apt-ftparchive.1.xml:361
  2160. msgid "Sections"
  2161. msgstr ""
  2162. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2163. #: apt-ftparchive.1.xml:363
  2164. msgid ""
  2165. "This is a space separated list of sections which appear under the "
  2166. "distribution, typically this is something like <literal>main contrib "
  2167. "non-free</literal>"
  2168. msgstr ""
  2169. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2170. #: apt-ftparchive.1.xml:368
  2171. msgid "Architectures"
  2172. msgstr ""
  2173. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2174. #: apt-ftparchive.1.xml:370
  2175. msgid ""
  2176. "This is a space separated list of all the architectures that appear under "
  2177. "search section. The special architecture 'source' is used to indicate that "
  2178. "this tree has a source archive."
  2179. msgstr ""
  2180. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2181. #: apt-ftparchive.1.xml:375 apt-ftparchive.1.xml:423
  2182. msgid "BinOverride"
  2183. msgstr ""
  2184. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2185. #: apt-ftparchive.1.xml:377
  2186. msgid ""
  2187. "Sets the binary override file. The override file contains section, priority "
  2188. "and maintainer address information."
  2189. msgstr ""
  2190. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2191. #: apt-ftparchive.1.xml:381 apt-ftparchive.1.xml:428
  2192. msgid "SrcOverride"
  2193. msgstr ""
  2194. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2195. #: apt-ftparchive.1.xml:383
  2196. msgid ""
  2197. "Sets the source override file. The override file contains section "
  2198. "information."
  2199. msgstr ""
  2200. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2201. #: apt-ftparchive.1.xml:387 apt-ftparchive.1.xml:433
  2202. msgid "ExtraOverride"
  2203. msgstr ""
  2204. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2205. #: apt-ftparchive.1.xml:389 apt-ftparchive.1.xml:435
  2206. msgid "Sets the binary extra override file."
  2207. msgstr ""
  2208. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2209. #: apt-ftparchive.1.xml:392 apt-ftparchive.1.xml:438
  2210. msgid "SrcExtraOverride"
  2211. msgstr ""
  2212. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2213. #: apt-ftparchive.1.xml:394 apt-ftparchive.1.xml:440
  2214. msgid "Sets the source extra override file."
  2215. msgstr ""
  2216. #. type: Content of: <refentry><refsect1><refsect2><title>
  2217. #: apt-ftparchive.1.xml:399
  2218. msgid "BinDirectory Section"
  2219. msgstr ""
  2220. #. type: Content of: <refentry><refsect1><refsect2><para>
  2221. #: apt-ftparchive.1.xml:401
  2222. msgid ""
  2223. "The <literal>bindirectory</literal> section defines a binary directory tree "
  2224. "with no special structure. The scope tag specifies the location of the "
  2225. "binary directory and the settings are similar to the <literal>Tree</literal> "
  2226. "section with no substitution variables or "
  2227. "<literal>Section</literal><literal>Architecture</literal> settings."
  2228. msgstr ""
  2229. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2230. #: apt-ftparchive.1.xml:409
  2231. msgid "Sets the Packages file output."
  2232. msgstr ""
  2233. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2234. #: apt-ftparchive.1.xml:414
  2235. msgid ""
  2236. "Sets the Sources file output. At least one of <literal>Packages</literal> or "
  2237. "<literal>Sources</literal> is required."
  2238. msgstr ""
  2239. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2240. #: apt-ftparchive.1.xml:420
  2241. msgid "Sets the Contents file output. (optional)"
  2242. msgstr ""
  2243. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2244. #: apt-ftparchive.1.xml:425
  2245. msgid "Sets the binary override file."
  2246. msgstr ""
  2247. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2248. #: apt-ftparchive.1.xml:430
  2249. msgid "Sets the source override file."
  2250. msgstr ""
  2251. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2252. #: apt-ftparchive.1.xml:445
  2253. msgid "Sets the cache DB."
  2254. msgstr ""
  2255. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2256. #: apt-ftparchive.1.xml:448
  2257. msgid "PathPrefix"
  2258. msgstr ""
  2259. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2260. #: apt-ftparchive.1.xml:450
  2261. msgid "Appends a path to all the output paths."
  2262. msgstr ""
  2263. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2264. #: apt-ftparchive.1.xml:453
  2265. msgid "FileList, SourceFileList"
  2266. msgstr ""
  2267. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2268. #: apt-ftparchive.1.xml:455
  2269. msgid "Specifies the file list file."
  2270. msgstr ""
  2271. #. type: Content of: <refentry><refsect1><title>
  2272. #: apt-ftparchive.1.xml:462
  2273. msgid "The Binary Override File"
  2274. msgstr ""
  2275. #. type: Content of: <refentry><refsect1><para>
  2276. #: apt-ftparchive.1.xml:463
  2277. msgid ""
  2278. "The binary override file is fully compatible with &dpkg-scanpackages;. It "
  2279. "contains 4 fields separated by spaces. The first field is the package name, "
  2280. "the second is the priority to force that package to, the third is the the "
  2281. "section to force that package to and the final field is the maintainer "
  2282. "permutation field."
  2283. msgstr ""
  2284. #. type: Content of: <refentry><refsect1><para><literallayout>
  2285. #: apt-ftparchive.1.xml:469
  2286. #, no-wrap
  2287. msgid "old [// oldn]* => new"
  2288. msgstr ""
  2289. #. type: Content of: <refentry><refsect1><para><literallayout>
  2290. #: apt-ftparchive.1.xml:471
  2291. #, no-wrap
  2292. msgid "new"
  2293. msgstr ""
  2294. #. type: Content of: <refentry><refsect1><para>
  2295. #: apt-ftparchive.1.xml:468
  2296. msgid ""
  2297. "The general form of the maintainer field is: <placeholder "
  2298. "type=\"literallayout\" id=\"0\"/> or simply, <placeholder "
  2299. "type=\"literallayout\" id=\"1\"/> The first form allows a double-slash "
  2300. "separated list of old email addresses to be specified. If any of those are "
  2301. "found then new is substituted for the maintainer field. The second form "
  2302. "unconditionally substitutes the maintainer field."
  2303. msgstr ""
  2304. #. type: Content of: <refentry><refsect1><title>
  2305. #: apt-ftparchive.1.xml:479
  2306. msgid "The Source Override File"
  2307. msgstr ""
  2308. #. type: Content of: <refentry><refsect1><para>
  2309. #: apt-ftparchive.1.xml:481
  2310. msgid ""
  2311. "The source override file is fully compatible with &dpkg-scansources;. It "
  2312. "contains 2 fields separated by spaces. The first fields is the source "
  2313. "package name, the second is the section to assign it."
  2314. msgstr ""
  2315. #. type: Content of: <refentry><refsect1><title>
  2316. #: apt-ftparchive.1.xml:486
  2317. msgid "The Extra Override File"
  2318. msgstr ""
  2319. #. type: Content of: <refentry><refsect1><para>
  2320. #: apt-ftparchive.1.xml:488
  2321. msgid ""
  2322. "The extra override file allows any arbitrary tag to be added or replaced in "
  2323. "the output. It has 3 columns, the first is the package, the second is the "
  2324. "tag and the remainder of the line is the new value."
  2325. msgstr ""
  2326. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2327. #: apt-ftparchive.1.xml:497
  2328. msgid "<option>--md5</option>"
  2329. msgstr ""
  2330. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2331. #: apt-ftparchive.1.xml:499
  2332. msgid ""
  2333. "Generate MD5 sums. This defaults to on, when turned off the generated index "
  2334. "files will not have MD5Sum fields where possible. Configuration Item: "
  2335. "<literal>APT::FTPArchive::MD5</literal>"
  2336. msgstr ""
  2337. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2338. #: apt-ftparchive.1.xml:504
  2339. msgid "<option>--db</option>"
  2340. msgstr ""
  2341. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2342. #: apt-ftparchive.1.xml:506
  2343. msgid ""
  2344. "Use a binary caching DB. This has no effect on the generate command. "
  2345. "Configuration Item: <literal>APT::FTPArchive::DB</literal>."
  2346. msgstr ""
  2347. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2348. #: apt-ftparchive.1.xml:512
  2349. msgid ""
  2350. "Quiet; produces output suitable for logging, omitting progress indicators. "
  2351. "More q's will produce more quiet up to a maximum of 2. You can also use "
  2352. "<option>-q=#</option> to set the quiet level, overriding the configuration "
  2353. "file. Configuration Item: <literal>quiet</literal>."
  2354. msgstr ""
  2355. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2356. #: apt-ftparchive.1.xml:518
  2357. msgid "<option>--delink</option>"
  2358. msgstr ""
  2359. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2360. #: apt-ftparchive.1.xml:520
  2361. msgid ""
  2362. "Perform Delinking. If the <literal>External-Links</literal> setting is used "
  2363. "then this option actually enables delinking of the files. It defaults to on "
  2364. "and can be turned off with <option>--no-delink</option>. Configuration "
  2365. "Item: <literal>APT::FTPArchive::DeLinkAct</literal>."
  2366. msgstr ""
  2367. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2368. #: apt-ftparchive.1.xml:526
  2369. msgid "<option>--contents</option>"
  2370. msgstr ""
  2371. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2372. #: apt-ftparchive.1.xml:528
  2373. msgid ""
  2374. "Perform contents generation. When this option is set and package indexes are "
  2375. "being generated with a cache DB then the file listing will also be extracted "
  2376. "and stored in the DB for later use. When using the generate command this "
  2377. "option also allows the creation of any Contents files. The default is on. "
  2378. "Configuration Item: <literal>APT::FTPArchive::Contents</literal>."
  2379. msgstr ""
  2380. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2381. #: apt-ftparchive.1.xml:536
  2382. msgid "<option>--source-override</option>"
  2383. msgstr ""
  2384. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2385. #: apt-ftparchive.1.xml:538
  2386. msgid ""
  2387. "Select the source override file to use with the <literal>sources</literal> "
  2388. "command. Configuration Item: "
  2389. "<literal>APT::FTPArchive::SourceOverride</literal>."
  2390. msgstr ""
  2391. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2392. #: apt-ftparchive.1.xml:542
  2393. msgid "<option>--readonly</option>"
  2394. msgstr ""
  2395. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2396. #: apt-ftparchive.1.xml:544
  2397. msgid ""
  2398. "Make the caching databases read only. Configuration Item: "
  2399. "<literal>APT::FTPArchive::ReadOnlyDB</literal>."
  2400. msgstr ""
  2401. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2402. #: apt-ftparchive.1.xml:548
  2403. msgid "<option>--arch</option>"
  2404. msgstr ""
  2405. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2406. #: apt-ftparchive.1.xml:549
  2407. msgid ""
  2408. "Accept in the <literal>packages</literal> and <literal>contents</literal> "
  2409. "commands only package files matching <literal>*_arch.deb</literal> or "
  2410. "<literal>*_all.deb</literal> instead of all package files in the given "
  2411. "path. Configuration Item: <literal>APT::FTPArchive::Architecture</literal>."
  2412. msgstr ""
  2413. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2414. #: apt-ftparchive.1.xml:555
  2415. msgid "<option>APT::FTPArchive::AlwaysStat</option>"
  2416. msgstr ""
  2417. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2418. #: apt-ftparchive.1.xml:557
  2419. msgid ""
  2420. "&apt-ftparchive; caches as much as possible of metadata in a cachedb. If "
  2421. "packages are recompiled and/or republished with the same version again, this "
  2422. "will lead to problems as the now outdated cached metadata like size and "
  2423. "checksums will be used. With this option enabled this will no longer happen "
  2424. "as it will be checked if the file was changed. Note that this option is set "
  2425. "to \"<literal>false</literal>\" by default as it is not recommend to upload "
  2426. "multiply versions/builds of a package with the same versionnumber, so in "
  2427. "theory nobody will have these problems and therefore all these extra checks "
  2428. "are useless."
  2429. msgstr ""
  2430. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2431. #: apt-ftparchive.1.xml:567
  2432. msgid "<option>APT::FTPArchive::LongDescription</option>"
  2433. msgstr ""
  2434. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2435. #: apt-ftparchive.1.xml:569
  2436. msgid ""
  2437. "This configuration option defaults to \"<literal>true</literal>\" and should "
  2438. "only be set to <literal>\"false\"</literal> if the Archive generated with "
  2439. "&apt-ftparchive; also provides <filename>Translation</filename> files. Note "
  2440. "that it is currently not possible to create these files with "
  2441. "<command>apt-ftparchive</command>."
  2442. msgstr ""
  2443. #. type: Content of: <refentry><refsect1><title>
  2444. #: apt-ftparchive.1.xml:581 apt.conf.5.xml:1029 apt_preferences.5.xml:477 sources.list.5.xml:193
  2445. msgid "Examples"
  2446. msgstr ""
  2447. #. type: Content of: <refentry><refsect1><para><programlisting>
  2448. #: apt-ftparchive.1.xml:587
  2449. #, no-wrap
  2450. msgid ""
  2451. "<command>apt-ftparchive</command> packages "
  2452. "<replaceable>directory</replaceable> | <command>gzip</command> > "
  2453. "<filename>Packages.gz</filename>\n"
  2454. msgstr ""
  2455. #. type: Content of: <refentry><refsect1><para>
  2456. #: apt-ftparchive.1.xml:583
  2457. msgid ""
  2458. "To create a compressed Packages file for a directory containing binary "
  2459. "packages (.deb): <placeholder type=\"programlisting\" id=\"0\"/>"
  2460. msgstr ""
  2461. #. type: Content of: <refentry><refsect1><para>
  2462. #: apt-ftparchive.1.xml:597
  2463. msgid ""
  2464. "<command>apt-ftparchive</command> returns zero on normal operation, decimal "
  2465. "100 on error."
  2466. msgstr ""
  2467. #. The last update date
  2468. #. type: Content of: <refentry><refentryinfo>
  2469. #: apt-get.8.xml:13
  2470. msgid ""
  2471. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>08 "
  2472. "November 2008</date>"
  2473. msgstr ""
  2474. #. type: <heading></heading>
  2475. #: apt-get.8.xml:22 apt-get.8.xml:29 guide.sgml:96
  2476. msgid "apt-get"
  2477. msgstr ""
  2478. #. type: Content of: <refentry><refnamediv><refpurpose>
  2479. #: apt-get.8.xml:30
  2480. msgid "APT package handling utility -- command-line interface"
  2481. msgstr ""
  2482. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  2483. #: apt-get.8.xml:36
  2484. msgid ""
  2485. "<command>apt-get</command> <arg><option>-sqdyfmubV</option></arg> <arg> "
  2486. "<option>-o= <replaceable>config_string</replaceable> </option> </arg> <arg> "
  2487. "<option>-c= <replaceable>config_file</replaceable> </option> </arg> <arg> "
  2488. "<option>-t=</option> <group choice='req'> <arg choice='plain'> "
  2489. "<replaceable>target_release_name</replaceable> </arg> <arg choice='plain'> "
  2490. "<replaceable>target_release_number_expression</replaceable> </arg> <arg "
  2491. "choice='plain'> <replaceable>target_release_codename</replaceable> </arg> "
  2492. "</group> </arg> <group choice=\"req\"> <arg choice='plain'>update</arg> <arg "
  2493. "choice='plain'>upgrade</arg> <arg choice='plain'>dselect-upgrade</arg> <arg "
  2494. "choice='plain'>dist-upgrade</arg> <arg choice='plain'>install <arg "
  2495. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable> <arg> <group "
  2496. "choice='req'> <arg choice='plain'> "
  2497. "=<replaceable>pkg_version_number</replaceable> </arg> <arg choice='plain'> "
  2498. "/<replaceable>target_release_name</replaceable> </arg> <arg choice='plain'> "
  2499. "/<replaceable>target_release_codename</replaceable> </arg> </group> </arg> "
  2500. "</arg> </arg> <arg choice='plain'>remove <arg choice=\"plain\" "
  2501. "rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg "
  2502. "choice='plain'>purge <arg choice=\"plain\" "
  2503. "rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg "
  2504. "choice='plain'>source <arg choice=\"plain\" "
  2505. "rep=\"repeat\"><replaceable>pkg</replaceable> <arg> <group choice='req'> "
  2506. "<arg choice='plain'> =<replaceable>pkg_version_number</replaceable> </arg> "
  2507. "<arg choice='plain'> /<replaceable>target_release_name</replaceable> </arg> "
  2508. "<arg choice='plain'> /<replaceable>target_release_codename</replaceable> "
  2509. "</arg> </group> </arg> </arg> </arg> <arg choice='plain'>build-dep <arg "
  2510. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  2511. "<arg choice='plain'>check</arg> <arg choice='plain'>clean</arg> <arg "
  2512. "choice='plain'>autoclean</arg> <arg choice='plain'>autoremove</arg> <arg "
  2513. "choice='plain'> <group choice='req'> <arg choice='plain'>-v</arg> <arg "
  2514. "choice='plain'>--version</arg> </group> </arg> <arg choice='plain'> <group "
  2515. "choice='req'> <arg choice='plain'>-h</arg> <arg choice='plain'>--help</arg> "
  2516. "</group> </arg> </group>"
  2517. msgstr ""
  2518. #. type: Content of: <refentry><refsect1><para>
  2519. #: apt-get.8.xml:126
  2520. msgid ""
  2521. "<command>apt-get</command> is the command-line tool for handling packages, "
  2522. "and may be considered the user's \"back-end\" to other tools using the APT "
  2523. "library. Several \"front-end\" interfaces exist, such as &dselect;, "
  2524. "&aptitude;, &synaptic;, &gnome-apt; and &wajig;."
  2525. msgstr ""
  2526. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2527. #: apt-get.8.xml:135 apt-key.8.xml:124
  2528. msgid "update"
  2529. msgstr ""
  2530. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2531. #: apt-get.8.xml:136
  2532. msgid ""
  2533. "<literal>update</literal> is used to resynchronize the package index files "
  2534. "from their sources. The indexes of available packages are fetched from the "
  2535. "location(s) specified in <filename>/etc/apt/sources.list</filename>. For "
  2536. "example, when using a Debian archive, this command retrieves and scans the "
  2537. "<filename>Packages.gz</filename> files, so that information about new and "
  2538. "updated packages is available. An <literal>update</literal> should always be "
  2539. "performed before an <literal>upgrade</literal> or "
  2540. "<literal>dist-upgrade</literal>. Please be aware that the overall progress "
  2541. "meter will be incorrect as the size of the package files cannot be known in "
  2542. "advance."
  2543. msgstr ""
  2544. #. type: <tag></tag>
  2545. #: apt-get.8.xml:147 guide.sgml:121
  2546. msgid "upgrade"
  2547. msgstr ""
  2548. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2549. #: apt-get.8.xml:148
  2550. msgid ""
  2551. "<literal>upgrade</literal> is used to install the newest versions of all "
  2552. "packages currently installed on the system from the sources enumerated in "
  2553. "<filename>/etc/apt/sources.list</filename>. Packages currently installed "
  2554. "with new versions available are retrieved and upgraded; under no "
  2555. "circumstances are currently installed packages removed, or packages not "
  2556. "already installed retrieved and installed. New versions of currently "
  2557. "installed packages that cannot be upgraded without changing the install "
  2558. "status of another package will be left at their current version. An "
  2559. "<literal>update</literal> must be performed first so that "
  2560. "<command>apt-get</command> knows that new versions of packages are "
  2561. "available."
  2562. msgstr ""
  2563. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2564. #: apt-get.8.xml:160
  2565. msgid "dselect-upgrade"
  2566. msgstr ""
  2567. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2568. #: apt-get.8.xml:161
  2569. msgid ""
  2570. "<literal>dselect-upgrade</literal> is used in conjunction with the "
  2571. "traditional Debian packaging front-end, "
  2572. "&dselect;. <literal>dselect-upgrade</literal> follows the changes made by "
  2573. "&dselect; to the <literal>Status</literal> field of available packages, and "
  2574. "performs the actions necessary to realize that state (for instance, the "
  2575. "removal of old and the installation of new packages)."
  2576. msgstr ""
  2577. #. type: <tag></tag>
  2578. #: apt-get.8.xml:170 guide.sgml:140
  2579. msgid "dist-upgrade"
  2580. msgstr ""
  2581. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2582. #: apt-get.8.xml:171
  2583. msgid ""
  2584. "<literal>dist-upgrade</literal> in addition to performing the function of "
  2585. "<literal>upgrade</literal>, also intelligently handles changing dependencies "
  2586. "with new versions of packages; <command>apt-get</command> has a \"smart\" "
  2587. "conflict resolution system, and it will attempt to upgrade the most "
  2588. "important packages at the expense of less important ones if necessary. So, "
  2589. "<literal>dist-upgrade</literal> command may remove some packages. The "
  2590. "<filename>/etc/apt/sources.list</filename> file contains a list of locations "
  2591. "from which to retrieve desired package files. See also &apt-preferences; "
  2592. "for a mechanism for overriding the general settings for individual packages."
  2593. msgstr ""
  2594. #. type: <tag></tag>
  2595. #: apt-get.8.xml:183 guide.sgml:131
  2596. msgid "install"
  2597. msgstr ""
  2598. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2599. #: apt-get.8.xml:185
  2600. msgid ""
  2601. "<literal>install</literal> is followed by one or more packages desired for "
  2602. "installation or upgrading. Each package is a package name, not a fully "
  2603. "qualified filename (for instance, in a Debian GNU/Linux system, libc6 would "
  2604. "be the argument provided, not <literal>libc6_1.9.6-2.deb</literal>). All "
  2605. "packages required by the package(s) specified for installation will also be "
  2606. "retrieved and installed. The <filename>/etc/apt/sources.list</filename> "
  2607. "file is used to locate the desired packages. If a hyphen is appended to the "
  2608. "package name (with no intervening space), the identified package will be "
  2609. "removed if it is installed. Similarly a plus sign can be used to designate "
  2610. "a package to install. These latter features may be used to override "
  2611. "decisions made by apt-get's conflict resolution system."
  2612. msgstr ""
  2613. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2614. #: apt-get.8.xml:203
  2615. msgid ""
  2616. "A specific version of a package can be selected for installation by "
  2617. "following the package name with an equals and the version of the package to "
  2618. "select. This will cause that version to be located and selected for "
  2619. "install. Alternatively a specific distribution can be selected by following "
  2620. "the package name with a slash and the version of the distribution or the "
  2621. "Archive name (stable, testing, unstable)."
  2622. msgstr ""
  2623. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2624. #: apt-get.8.xml:210
  2625. msgid ""
  2626. "Both of the version selection mechanisms can downgrade packages and must be "
  2627. "used with care."
  2628. msgstr ""
  2629. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2630. #: apt-get.8.xml:213
  2631. msgid ""
  2632. "This is also the target to use if you want to upgrade one or more "
  2633. "already-installed packages without upgrading every package you have on your "
  2634. "system. Unlike the \"upgrade\" target, which installs the newest version of "
  2635. "all currently installed packages, \"install\" will install the newest "
  2636. "version of only the package(s) specified. Simply provide the name of the "
  2637. "package(s) you wish to upgrade, and if a newer version is available, it (and "
  2638. "its dependencies, as described above) will be downloaded and installed."
  2639. msgstr ""
  2640. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2641. #: apt-get.8.xml:224
  2642. msgid ""
  2643. "Finally, the &apt-preferences; mechanism allows you to create an alternative "
  2644. "installation policy for individual packages."
  2645. msgstr ""
  2646. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2647. #: apt-get.8.xml:228
  2648. msgid ""
  2649. "If no package matches the given expression and the expression contains one "
  2650. "of '.', '?' or '*' then it is assumed to be a POSIX regular expression, and "
  2651. "it is applied to all package names in the database. Any matches are then "
  2652. "installed (or removed). Note that matching is done by substring so 'lo.*' "
  2653. "matches 'how-lo' and 'lowest'. If this is undesired, anchor the regular "
  2654. "expression with a '^' or '$' character, or create a more specific regular "
  2655. "expression."
  2656. msgstr ""
  2657. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2658. #: apt-get.8.xml:237
  2659. msgid "remove"
  2660. msgstr ""
  2661. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2662. #: apt-get.8.xml:238
  2663. msgid ""
  2664. "<literal>remove</literal> is identical to <literal>install</literal> except "
  2665. "that packages are removed instead of installed. Note the removing a package "
  2666. "leaves its configuration files in system. If a plus sign is appended to the "
  2667. "package name (with no intervening space), the identified package will be "
  2668. "installed instead of removed."
  2669. msgstr ""
  2670. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2671. #: apt-get.8.xml:245
  2672. msgid "purge"
  2673. msgstr ""
  2674. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2675. #: apt-get.8.xml:246
  2676. msgid ""
  2677. "<literal>purge</literal> is identical to <literal>remove</literal> except "
  2678. "that packages are removed and purged (any configuration files are deleted "
  2679. "too)."
  2680. msgstr ""
  2681. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2682. #: apt-get.8.xml:250
  2683. msgid "source"
  2684. msgstr ""
  2685. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2686. #: apt-get.8.xml:251
  2687. msgid ""
  2688. "<literal>source</literal> causes <command>apt-get</command> to fetch source "
  2689. "packages. APT will examine the available packages to decide which source "
  2690. "package to fetch. It will then find and download into the current directory "
  2691. "the newest available version of that source package while respect the "
  2692. "default release, set with the option "
  2693. "<literal>APT::Default-Release</literal>, the <option>-t</option> option or "
  2694. "per package with the <literal>pkg/release</literal> syntax, if possible."
  2695. msgstr ""
  2696. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2697. #: apt-get.8.xml:259
  2698. msgid ""
  2699. "Source packages are tracked separately from binary packages via "
  2700. "<literal>deb-src</literal> type lines in the &sources-list; file. This means "
  2701. "that you will need to add such a line for each repository you want to get "
  2702. "sources from. If you don't do this you will properly get another (newer, "
  2703. "older or none) source version than the one you have installed or could "
  2704. "install."
  2705. msgstr ""
  2706. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2707. #: apt-get.8.xml:266
  2708. msgid ""
  2709. "If the <option>--compile</option> option is specified then the package will "
  2710. "be compiled to a binary .deb using <command>dpkg-buildpackage</command>, if "
  2711. "<option>--download-only</option> is specified then the source package will "
  2712. "not be unpacked."
  2713. msgstr ""
  2714. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2715. #: apt-get.8.xml:271
  2716. msgid ""
  2717. "A specific source version can be retrieved by postfixing the source name "
  2718. "with an equals and then the version to fetch, similar to the mechanism used "
  2719. "for the package files. This enables exact matching of the source package "
  2720. "name and version, implicitly enabling the "
  2721. "<literal>APT::Get::Only-Source</literal> option."
  2722. msgstr ""
  2723. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2724. #: apt-get.8.xml:277
  2725. msgid ""
  2726. "Note that source packages are not tracked like binary packages, they exist "
  2727. "only in the current directory and are similar to downloading source tar "
  2728. "balls."
  2729. msgstr ""
  2730. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2731. #: apt-get.8.xml:282
  2732. msgid "build-dep"
  2733. msgstr ""
  2734. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2735. #: apt-get.8.xml:283
  2736. msgid ""
  2737. "<literal>build-dep</literal> causes apt-get to install/remove packages in an "
  2738. "attempt to satisfy the build dependencies for a source package."
  2739. msgstr ""
  2740. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2741. #: apt-get.8.xml:287
  2742. msgid "check"
  2743. msgstr ""
  2744. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2745. #: apt-get.8.xml:288
  2746. msgid ""
  2747. "<literal>check</literal> is a diagnostic tool; it updates the package cache "
  2748. "and checks for broken dependencies."
  2749. msgstr ""
  2750. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2751. #: apt-get.8.xml:293
  2752. msgid ""
  2753. "<literal>clean</literal> clears out the local repository of retrieved "
  2754. "package files. It removes everything but the lock file from "
  2755. "<filename>&cachedir;/archives/</filename> and "
  2756. "<filename>&cachedir;/archives/partial/</filename>. When APT is used as a "
  2757. "&dselect; method, <literal>clean</literal> is run automatically. Those who "
  2758. "do not use dselect will likely want to run <literal>apt-get clean</literal> "
  2759. "from time to time to free up disk space."
  2760. msgstr ""
  2761. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2762. #: apt-get.8.xml:302
  2763. msgid "autoclean"
  2764. msgstr ""
  2765. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2766. #: apt-get.8.xml:303
  2767. msgid ""
  2768. "Like <literal>clean</literal>, <literal>autoclean</literal> clears out the "
  2769. "local repository of retrieved package files. The difference is that it only "
  2770. "removes package files that can no longer be downloaded, and are largely "
  2771. "useless. This allows a cache to be maintained over a long period without it "
  2772. "growing out of control. The configuration option "
  2773. "<literal>APT::Clean-Installed</literal> will prevent installed packages from "
  2774. "being erased if it is set to off."
  2775. msgstr ""
  2776. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2777. #: apt-get.8.xml:312
  2778. msgid "autoremove"
  2779. msgstr ""
  2780. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2781. #: apt-get.8.xml:313
  2782. msgid ""
  2783. "<literal>autoremove</literal> is used to remove packages that were "
  2784. "automatically installed to satisfy dependencies for some package and that "
  2785. "are no more needed."
  2786. msgstr ""
  2787. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2788. #: apt-get.8.xml:323 apt-get.8.xml:429
  2789. msgid "<option>--no-install-recommends</option>"
  2790. msgstr ""
  2791. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2792. #: apt-get.8.xml:324
  2793. msgid ""
  2794. "Do not consider recommended packages as a dependency for installing. "
  2795. "Configuration Item: <literal>APT::Install-Recommends</literal>."
  2796. msgstr ""
  2797. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2798. #: apt-get.8.xml:328
  2799. msgid "<option>--download-only</option>"
  2800. msgstr ""
  2801. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2802. #: apt-get.8.xml:329
  2803. msgid ""
  2804. "Download only; package files are only retrieved, not unpacked or installed. "
  2805. "Configuration Item: <literal>APT::Get::Download-Only</literal>."
  2806. msgstr ""
  2807. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2808. #: apt-get.8.xml:333
  2809. msgid "<option>--fix-broken</option>"
  2810. msgstr ""
  2811. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2812. #: apt-get.8.xml:334
  2813. msgid ""
  2814. "Fix; attempt to correct a system with broken dependencies in place. This "
  2815. "option, when used with install/remove, can omit any packages to permit APT "
  2816. "to deduce a likely solution. If packages are specified, these have to "
  2817. "completely correct the problem. The option is sometimes necessary when "
  2818. "running APT for the first time; APT itself does not allow broken package "
  2819. "dependencies to exist on a system. It is possible that a system's dependency "
  2820. "structure can be so corrupt as to require manual intervention (which usually "
  2821. "means using &dselect; or <command>dpkg --remove</command> to eliminate some "
  2822. "of the offending packages). Use of this option together with "
  2823. "<option>-m</option> may produce an error in some situations. Configuration "
  2824. "Item: <literal>APT::Get::Fix-Broken</literal>."
  2825. msgstr ""
  2826. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2827. #: apt-get.8.xml:347
  2828. msgid "<option>--ignore-missing</option>"
  2829. msgstr ""
  2830. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2831. #: apt-get.8.xml:348
  2832. msgid "<option>--fix-missing</option>"
  2833. msgstr ""
  2834. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2835. #: apt-get.8.xml:349
  2836. msgid ""
  2837. "Ignore missing packages; If packages cannot be retrieved or fail the "
  2838. "integrity check after retrieval (corrupted package files), hold back those "
  2839. "packages and handle the result. Use of this option together with "
  2840. "<option>-f</option> may produce an error in some situations. If a package is "
  2841. "selected for installation (particularly if it is mentioned on the command "
  2842. "line) and it could not be downloaded then it will be silently held back. "
  2843. "Configuration Item: <literal>APT::Get::Fix-Missing</literal>."
  2844. msgstr ""
  2845. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2846. #: apt-get.8.xml:359
  2847. msgid "<option>--no-download</option>"
  2848. msgstr ""
  2849. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2850. #: apt-get.8.xml:360
  2851. msgid ""
  2852. "Disables downloading of packages. This is best used with "
  2853. "<option>--ignore-missing</option> to force APT to use only the .debs it has "
  2854. "already downloaded. Configuration Item: "
  2855. "<literal>APT::Get::Download</literal>."
  2856. msgstr ""
  2857. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2858. #: apt-get.8.xml:367
  2859. msgid ""
  2860. "Quiet; produces output suitable for logging, omitting progress indicators. "
  2861. "More q's will produce more quiet up to a maximum of 2. You can also use "
  2862. "<option>-q=#</option> to set the quiet level, overriding the configuration "
  2863. "file. Note that quiet level 2 implies <option>-y</option>, you should never "
  2864. "use -qq without a no-action modifier such as -d, --print-uris or -s as APT "
  2865. "may decided to do something you did not expect. Configuration Item: "
  2866. "<literal>quiet</literal>."
  2867. msgstr ""
  2868. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2869. #: apt-get.8.xml:377
  2870. msgid "<option>--simulate</option>"
  2871. msgstr ""
  2872. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2873. #: apt-get.8.xml:379
  2874. msgid "<option>--dry-run</option>"
  2875. msgstr ""
  2876. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2877. #: apt-get.8.xml:382
  2878. msgid ""
  2879. "No action; perform a simulation of events that would occur but do not "
  2880. "actually change the system. Configuration Item: "
  2881. "<literal>APT::Get::Simulate</literal>."
  2882. msgstr ""
  2883. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2884. #: apt-get.8.xml:386
  2885. msgid ""
  2886. "Simulation run as user will deactivate locking "
  2887. "(<literal>Debug::NoLocking</literal>) automatic. Also a notice will be "
  2888. "displayed indicating that this is only a simulation, if the option "
  2889. "<literal>APT::Get::Show-User-Simulation-Note</literal> is set (Default: "
  2890. "true). Neither NoLocking nor the notice will be triggered if run as root "
  2891. "(root should know what he is doing without further warnings by "
  2892. "<literal>apt-get</literal>)."
  2893. msgstr ""
  2894. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2895. #: apt-get.8.xml:392
  2896. msgid ""
  2897. "Simulate prints out a series of lines each one representing a dpkg "
  2898. "operation, Configure (Conf), Remove (Remv), Unpack (Inst). Square brackets "
  2899. "indicate broken packages and empty set of square brackets meaning breaks "
  2900. "that are of no consequence (rare)."
  2901. msgstr ""
  2902. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2903. #: apt-get.8.xml:399
  2904. msgid "<option>-y</option>"
  2905. msgstr ""
  2906. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2907. #: apt-get.8.xml:399
  2908. msgid "<option>--yes</option>"
  2909. msgstr ""
  2910. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2911. #: apt-get.8.xml:400
  2912. msgid "<option>--assume-yes</option>"
  2913. msgstr ""
  2914. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2915. #: apt-get.8.xml:401
  2916. msgid ""
  2917. "Automatic yes to prompts; assume \"yes\" as answer to all prompts and run "
  2918. "non-interactively. If an undesirable situation, such as changing a held "
  2919. "package, trying to install a unauthenticated package or removing an "
  2920. "essential package occurs then <literal>apt-get</literal> will abort. "
  2921. "Configuration Item: <literal>APT::Get::Assume-Yes</literal>."
  2922. msgstr ""
  2923. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2924. #: apt-get.8.xml:408
  2925. msgid "<option>-u</option>"
  2926. msgstr ""
  2927. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2928. #: apt-get.8.xml:408
  2929. msgid "<option>--show-upgraded</option>"
  2930. msgstr ""
  2931. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2932. #: apt-get.8.xml:409
  2933. msgid ""
  2934. "Show upgraded packages; Print out a list of all packages that are to be "
  2935. "upgraded. Configuration Item: <literal>APT::Get::Show-Upgraded</literal>."
  2936. msgstr ""
  2937. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2938. #: apt-get.8.xml:414
  2939. msgid "<option>-V</option>"
  2940. msgstr ""
  2941. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2942. #: apt-get.8.xml:414
  2943. msgid "<option>--verbose-versions</option>"
  2944. msgstr ""
  2945. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2946. #: apt-get.8.xml:415
  2947. msgid ""
  2948. "Show full versions for upgraded and installed packages. Configuration Item: "
  2949. "<literal>APT::Get::Show-Versions</literal>."
  2950. msgstr ""
  2951. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2952. #: apt-get.8.xml:419
  2953. msgid "<option>-b</option>"
  2954. msgstr ""
  2955. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2956. #: apt-get.8.xml:419
  2957. msgid "<option>--compile</option>"
  2958. msgstr ""
  2959. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2960. #: apt-get.8.xml:420
  2961. msgid "<option>--build</option>"
  2962. msgstr ""
  2963. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2964. #: apt-get.8.xml:421
  2965. msgid ""
  2966. "Compile source packages after downloading them. Configuration Item: "
  2967. "<literal>APT::Get::Compile</literal>."
  2968. msgstr ""
  2969. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2970. #: apt-get.8.xml:425
  2971. msgid "<option>--install-recommends</option>"
  2972. msgstr ""
  2973. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2974. #: apt-get.8.xml:426
  2975. msgid "Also install recommended packages."
  2976. msgstr ""
  2977. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2978. #: apt-get.8.xml:430
  2979. msgid "Do not install recommended packages."
  2980. msgstr ""
  2981. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2982. #: apt-get.8.xml:433
  2983. msgid "<option>--ignore-hold</option>"
  2984. msgstr ""
  2985. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2986. #: apt-get.8.xml:434
  2987. msgid ""
  2988. "Ignore package Holds; This causes <command>apt-get</command> to ignore a "
  2989. "hold placed on a package. This may be useful in conjunction with "
  2990. "<literal>dist-upgrade</literal> to override a large number of undesired "
  2991. "holds. Configuration Item: <literal>APT::Ignore-Hold</literal>."
  2992. msgstr ""
  2993. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2994. #: apt-get.8.xml:440
  2995. msgid "<option>--no-upgrade</option>"
  2996. msgstr ""
  2997. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2998. #: apt-get.8.xml:441
  2999. msgid ""
  3000. "Do not upgrade packages; When used in conjunction with "
  3001. "<literal>install</literal>, <literal>no-upgrade</literal> will prevent "
  3002. "packages on the command line from being upgraded if they are already "
  3003. "installed. Configuration Item: <literal>APT::Get::Upgrade</literal>."
  3004. msgstr ""
  3005. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3006. #: apt-get.8.xml:447
  3007. msgid "<option>--force-yes</option>"
  3008. msgstr ""
  3009. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3010. #: apt-get.8.xml:448
  3011. msgid ""
  3012. "Force yes; This is a dangerous option that will cause apt to continue "
  3013. "without prompting if it is doing something potentially harmful. It should "
  3014. "not be used except in very special situations. Using "
  3015. "<literal>force-yes</literal> can potentially destroy your system! "
  3016. "Configuration Item: <literal>APT::Get::force-yes</literal>."
  3017. msgstr ""
  3018. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3019. #: apt-get.8.xml:455
  3020. msgid "<option>--print-uris</option>"
  3021. msgstr ""
  3022. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3023. #: apt-get.8.xml:456
  3024. msgid ""
  3025. "Instead of fetching the files to install their URIs are printed. Each URI "
  3026. "will have the path, the destination file name, the size and the expected md5 "
  3027. "hash. Note that the file name to write to will not always match the file "
  3028. "name on the remote site! This also works with the <literal>source</literal> "
  3029. "and <literal>update</literal> commands. When used with the "
  3030. "<literal>update</literal> command the MD5 and size are not included, and it "
  3031. "is up to the user to decompress any compressed files. Configuration Item: "
  3032. "<literal>APT::Get::Print-URIs</literal>."
  3033. msgstr ""
  3034. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3035. #: apt-get.8.xml:466
  3036. msgid "<option>--purge</option>"
  3037. msgstr ""
  3038. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3039. #: apt-get.8.xml:467
  3040. msgid ""
  3041. "Use purge instead of remove for anything that would be removed. An asterisk "
  3042. "(\"*\") will be displayed next to packages which are scheduled to be "
  3043. "purged. <option>remove --purge</option> is equivalent to the "
  3044. "<option>purge</option> command. Configuration Item: "
  3045. "<literal>APT::Get::Purge</literal>."
  3046. msgstr ""
  3047. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3048. #: apt-get.8.xml:474
  3049. msgid "<option>--reinstall</option>"
  3050. msgstr ""
  3051. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3052. #: apt-get.8.xml:475
  3053. msgid ""
  3054. "Re-Install packages that are already installed and at the newest version. "
  3055. "Configuration Item: <literal>APT::Get::ReInstall</literal>."
  3056. msgstr ""
  3057. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3058. #: apt-get.8.xml:479
  3059. msgid "<option>--list-cleanup</option>"
  3060. msgstr ""
  3061. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3062. #: apt-get.8.xml:480
  3063. msgid ""
  3064. "This option defaults to on, use <literal>--no-list-cleanup</literal> to turn "
  3065. "it off. When on <command>apt-get</command> will automatically manage the "
  3066. "contents of <filename>&statedir;/lists</filename> to ensure that obsolete "
  3067. "files are erased. The only reason to turn it off is if you frequently "
  3068. "change your source list. Configuration Item: "
  3069. "<literal>APT::Get::List-Cleanup</literal>."
  3070. msgstr ""
  3071. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3072. #: apt-get.8.xml:489
  3073. msgid "<option>--target-release</option>"
  3074. msgstr ""
  3075. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3076. #: apt-get.8.xml:490
  3077. msgid "<option>--default-release</option>"
  3078. msgstr ""
  3079. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3080. #: apt-get.8.xml:491
  3081. msgid ""
  3082. "This option controls the default input to the policy engine, it creates a "
  3083. "default pin at priority 990 using the specified release string. This "
  3084. "overrides the general settings in "
  3085. "<filename>/etc/apt/preferences</filename>. Specifically pinned packages are "
  3086. "not affected by the value of this option. In short, this option lets you "
  3087. "have simple control over which distribution packages will be retrieved "
  3088. "from. Some common examples might be <option>-t '2.1*'</option>, <option>-t "
  3089. "unstable</option> or <option>-t sid</option>. Configuration Item: "
  3090. "<literal>APT::Default-Release</literal>; see also the &apt-preferences; "
  3091. "manual page."
  3092. msgstr ""
  3093. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3094. #: apt-get.8.xml:504
  3095. msgid "<option>--trivial-only</option>"
  3096. msgstr ""
  3097. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3098. #: apt-get.8.xml:506
  3099. msgid ""
  3100. "Only perform operations that are 'trivial'. Logically this can be considered "
  3101. "related to <option>--assume-yes</option>, where "
  3102. "<option>--assume-yes</option> will answer yes to any prompt, "
  3103. "<option>--trivial-only</option> will answer no. Configuration Item: "
  3104. "<literal>APT::Get::Trivial-Only</literal>."
  3105. msgstr ""
  3106. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3107. #: apt-get.8.xml:512
  3108. msgid "<option>--no-remove</option>"
  3109. msgstr ""
  3110. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3111. #: apt-get.8.xml:513
  3112. msgid ""
  3113. "If any packages are to be removed apt-get immediately aborts without "
  3114. "prompting. Configuration Item: <literal>APT::Get::Remove</literal>."
  3115. msgstr ""
  3116. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3117. #: apt-get.8.xml:518
  3118. msgid "<option>--auto-remove</option>"
  3119. msgstr ""
  3120. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3121. #: apt-get.8.xml:519
  3122. msgid ""
  3123. "If the command is either <literal>install</literal> or "
  3124. "<literal>remove</literal>, then this option acts like running "
  3125. "<literal>autoremove</literal> command, removing the unused dependency "
  3126. "packages. Configuration Item: <literal>APT::Get::AutomaticRemove</literal>."
  3127. msgstr ""
  3128. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3129. #: apt-get.8.xml:525
  3130. msgid "<option>--only-source</option>"
  3131. msgstr ""
  3132. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3133. #: apt-get.8.xml:526
  3134. msgid ""
  3135. "Only has meaning for the <literal>source</literal> and "
  3136. "<literal>build-dep</literal> commands. Indicates that the given source "
  3137. "names are not to be mapped through the binary table. This means that if "
  3138. "this option is specified, these commands will only accept source package "
  3139. "names as arguments, rather than accepting binary package names and looking "
  3140. "up the corresponding source package. Configuration Item: "
  3141. "<literal>APT::Get::Only-Source</literal>."
  3142. msgstr ""
  3143. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3144. #: apt-get.8.xml:536
  3145. msgid "<option>--diff-only</option>"
  3146. msgstr ""
  3147. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3148. #: apt-get.8.xml:536
  3149. msgid "<option>--dsc-only</option>"
  3150. msgstr ""
  3151. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3152. #: apt-get.8.xml:536
  3153. msgid "<option>--tar-only</option>"
  3154. msgstr ""
  3155. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3156. #: apt-get.8.xml:537
  3157. msgid ""
  3158. "Download only the diff, dsc, or tar file of a source archive. Configuration "
  3159. "Item: <literal>APT::Get::Diff-Only</literal>, "
  3160. "<literal>APT::Get::Dsc-Only</literal>, and "
  3161. "<literal>APT::Get::Tar-Only</literal>."
  3162. msgstr ""
  3163. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3164. #: apt-get.8.xml:542
  3165. msgid "<option>--arch-only</option>"
  3166. msgstr ""
  3167. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3168. #: apt-get.8.xml:543
  3169. msgid ""
  3170. "Only process architecture-dependent build-dependencies. Configuration Item: "
  3171. "<literal>APT::Get::Arch-Only</literal>."
  3172. msgstr ""
  3173. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3174. #: apt-get.8.xml:547
  3175. msgid "<option>--allow-unauthenticated</option>"
  3176. msgstr ""
  3177. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3178. #: apt-get.8.xml:548
  3179. msgid ""
  3180. "Ignore if packages can't be authenticated and don't prompt about it. This "
  3181. "is useful for tools like pbuilder. Configuration Item: "
  3182. "<literal>APT::Get::AllowUnauthenticated</literal>."
  3183. msgstr ""
  3184. #. type: Content of: <refentry><refsect1><variablelist>
  3185. #: apt-get.8.xml:561
  3186. msgid ""
  3187. "&file-sourceslist; &file-aptconf; &file-preferences; &file-cachearchives; "
  3188. "&file-statelists;"
  3189. msgstr ""
  3190. #. type: Content of: <refentry><refsect1><para>
  3191. #: apt-get.8.xml:570
  3192. msgid ""
  3193. "&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, "
  3194. "&apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, "
  3195. "&apt-preferences;, the APT Howto."
  3196. msgstr ""
  3197. #. type: Content of: <refentry><refsect1><para>
  3198. #: apt-get.8.xml:576
  3199. msgid ""
  3200. "<command>apt-get</command> returns zero on normal operation, decimal 100 on "
  3201. "error."
  3202. msgstr ""
  3203. #. type: Content of: <refentry><refsect1><title>
  3204. #: apt-get.8.xml:579
  3205. msgid "ORIGINAL AUTHORS"
  3206. msgstr ""
  3207. #. type: Content of: <refentry><refsect1><para>
  3208. #: apt-get.8.xml:580
  3209. msgid "&apt-author.jgunthorpe;"
  3210. msgstr ""
  3211. #. type: Content of: <refentry><refsect1><title>
  3212. #: apt-get.8.xml:583
  3213. msgid "CURRENT AUTHORS"
  3214. msgstr ""
  3215. #. type: Content of: <refentry><refsect1><para>
  3216. #: apt-get.8.xml:585
  3217. msgid "&apt-author.team;"
  3218. msgstr ""
  3219. #. type: Content of: <refentry><refnamediv><refname>
  3220. #: apt-key.8.xml:14 apt-key.8.xml:21
  3221. msgid "apt-key"
  3222. msgstr ""
  3223. #. type: Content of: <refentry><refnamediv><refpurpose>
  3224. #: apt-key.8.xml:22
  3225. msgid "APT key management utility"
  3226. msgstr ""
  3227. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  3228. #: apt-key.8.xml:28
  3229. msgid ""
  3230. "<command>apt-key</command> <arg><option>--keyring "
  3231. "<replaceable>filename</replaceable></option></arg> "
  3232. "<arg><replaceable>command</replaceable></arg> <arg "
  3233. "rep=\"repeat\"><option><replaceable>arguments</replaceable></option></arg>"
  3234. msgstr ""
  3235. #. type: Content of: <refentry><refsect1><para>
  3236. #: apt-key.8.xml:37
  3237. msgid ""
  3238. "<command>apt-key</command> is used to manage the list of keys used by apt to "
  3239. "authenticate packages. Packages which have been authenticated using these "
  3240. "keys will be considered trusted."
  3241. msgstr ""
  3242. #. type: Content of: <refentry><refsect1><title>
  3243. #: apt-key.8.xml:43
  3244. msgid "Commands"
  3245. msgstr ""
  3246. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3247. #: apt-key.8.xml:45
  3248. msgid "add <replaceable>filename</replaceable>"
  3249. msgstr ""
  3250. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3251. #: apt-key.8.xml:49
  3252. msgid ""
  3253. "Add a new key to the list of trusted keys. The key is read from "
  3254. "<replaceable>filename</replaceable>, or standard input if "
  3255. "<replaceable>filename</replaceable> is <literal>-</literal>."
  3256. msgstr ""
  3257. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3258. #: apt-key.8.xml:57
  3259. msgid "del <replaceable>keyid</replaceable>"
  3260. msgstr ""
  3261. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3262. #: apt-key.8.xml:61
  3263. msgid "Remove a key from the list of trusted keys."
  3264. msgstr ""
  3265. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3266. #: apt-key.8.xml:68
  3267. msgid "export <replaceable>keyid</replaceable>"
  3268. msgstr ""
  3269. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3270. #: apt-key.8.xml:72
  3271. msgid "Output the key <replaceable>keyid</replaceable> to standard output."
  3272. msgstr ""
  3273. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3274. #: apt-key.8.xml:79
  3275. msgid "exportall"
  3276. msgstr ""
  3277. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3278. #: apt-key.8.xml:83
  3279. msgid "Output all trusted keys to standard output."
  3280. msgstr ""
  3281. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3282. #: apt-key.8.xml:90
  3283. msgid "list"
  3284. msgstr ""
  3285. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3286. #: apt-key.8.xml:94
  3287. msgid "List trusted keys."
  3288. msgstr ""
  3289. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3290. #: apt-key.8.xml:101
  3291. msgid "finger"
  3292. msgstr ""
  3293. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3294. #: apt-key.8.xml:105
  3295. msgid "List fingerprints of trusted keys."
  3296. msgstr ""
  3297. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3298. #: apt-key.8.xml:112
  3299. msgid "adv"
  3300. msgstr ""
  3301. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3302. #: apt-key.8.xml:116
  3303. msgid ""
  3304. "Pass advanced options to gpg. With adv --recv-key you can download the "
  3305. "public key."
  3306. msgstr ""
  3307. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3308. #: apt-key.8.xml:128
  3309. msgid ""
  3310. "Update the local keyring with the keyring of Debian archive keys and removes "
  3311. "from the keyring the archive keys which are no longer valid."
  3312. msgstr ""
  3313. #. type: Content of: <refentry><refsect1><para>
  3314. #: apt-key.8.xml:140
  3315. msgid ""
  3316. "Note that options need to be defined before the commands described in the "
  3317. "previous section."
  3318. msgstr ""
  3319. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3320. #: apt-key.8.xml:142
  3321. msgid "--keyring <replaceable>filename</replaceable>"
  3322. msgstr ""
  3323. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3324. #: apt-key.8.xml:143
  3325. msgid ""
  3326. "With this option it is possible to specify a specific keyring file the "
  3327. "command should operate on. The default is that a command is executed on the "
  3328. "<filename>trusted.gpg</filename> file as well as on all parts in the "
  3329. "<filename>trusted.gpg.d</filename> directory, through "
  3330. "<filename>trusted.gpg</filename> is the primary keyring which means that "
  3331. "e.g. new keys are added to this one."
  3332. msgstr ""
  3333. #. type: Content of: <refentry><refsect1><variablelist>
  3334. #: apt-key.8.xml:156
  3335. msgid "&file-trustedgpg;"
  3336. msgstr ""
  3337. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3338. #: apt-key.8.xml:158
  3339. msgid "<filename>/etc/apt/trustdb.gpg</filename>"
  3340. msgstr ""
  3341. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3342. #: apt-key.8.xml:159
  3343. msgid "Local trust database of archive keys."
  3344. msgstr ""
  3345. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3346. #: apt-key.8.xml:162
  3347. msgid "<filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename>"
  3348. msgstr ""
  3349. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3350. #: apt-key.8.xml:163
  3351. msgid "Keyring of Debian archive trusted keys."
  3352. msgstr ""
  3353. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3354. #: apt-key.8.xml:166
  3355. msgid "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>"
  3356. msgstr ""
  3357. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3358. #: apt-key.8.xml:167
  3359. msgid "Keyring of Debian archive removed trusted keys."
  3360. msgstr ""
  3361. #. type: Content of: <refentry><refsect1><para>
  3362. #: apt-key.8.xml:176
  3363. msgid "&apt-get;, &apt-secure;"
  3364. msgstr ""
  3365. #. The last update date
  3366. #. type: Content of: <refentry><refentryinfo>
  3367. #: apt-mark.8.xml:13
  3368. msgid ""
  3369. "&apt-author.moconnor; &apt-author.team; &apt-email; &apt-product; <date>9 "
  3370. "August 2009</date>"
  3371. msgstr ""
  3372. #. type: Content of: <refentry><refnamediv><refname>
  3373. #: apt-mark.8.xml:22 apt-mark.8.xml:29
  3374. msgid "apt-mark"
  3375. msgstr ""
  3376. #. type: Content of: <refentry><refnamediv><refpurpose>
  3377. #: apt-mark.8.xml:30
  3378. msgid "mark/unmark a package as being automatically-installed"
  3379. msgstr ""
  3380. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  3381. #: apt-mark.8.xml:36
  3382. msgid ""
  3383. " <command>apt-mark</command> <arg><option>-hv</option></arg> "
  3384. "<arg><option>-f=<replaceable>FILENAME</replaceable></option></arg> <group "
  3385. "choice=\"plain\"> <arg choice=\"plain\"> <group choice=\"req\"> <arg "
  3386. "choice=\"plain\">markauto</arg> <arg choice=\"plain\">unmarkauto</arg> "
  3387. "</group> <arg choice=\"plain\" "
  3388. "rep=\"repeat\"><replaceable>package</replaceable></arg> </arg> <arg "
  3389. "choice=\"plain\">showauto</arg> </group>"
  3390. msgstr ""
  3391. #. type: Content of: <refentry><refsect1><para>
  3392. #: apt-mark.8.xml:53
  3393. msgid ""
  3394. "<command>apt-mark</command> will change whether a package has been marked as "
  3395. "being automatically installed."
  3396. msgstr ""
  3397. #. type: Content of: <refentry><refsect1><para>
  3398. #: apt-mark.8.xml:57
  3399. msgid ""
  3400. "When you request that a package is installed, and as a result other packages "
  3401. "are installed to satisfy its dependencies, the dependencies are marked as "
  3402. "being automatically installed. Once these automatically installed packages "
  3403. "are no longer depended on by any manually installed packages, they will be "
  3404. "removed by e.g. <command>apt-get</command> or <command>aptitude</command>."
  3405. msgstr ""
  3406. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3407. #: apt-mark.8.xml:65
  3408. msgid "markauto"
  3409. msgstr ""
  3410. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3411. #: apt-mark.8.xml:66
  3412. msgid ""
  3413. "<literal>markauto</literal> is used to mark a package as being automatically "
  3414. "installed, which will cause the package to be removed when no more manually "
  3415. "installed packages depend on this package."
  3416. msgstr ""
  3417. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3418. #: apt-mark.8.xml:73
  3419. msgid "unmarkauto"
  3420. msgstr ""
  3421. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3422. #: apt-mark.8.xml:74
  3423. msgid ""
  3424. "<literal>unmarkauto</literal> is used to mark a package as being manually "
  3425. "installed, which will prevent the package from being automatically removed "
  3426. "if no other packages depend on it."
  3427. msgstr ""
  3428. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3429. #: apt-mark.8.xml:81
  3430. msgid "showauto"
  3431. msgstr ""
  3432. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3433. #: apt-mark.8.xml:82
  3434. msgid ""
  3435. "<literal>showauto</literal> is used to print a list of automatically "
  3436. "installed packages with each package on a new line."
  3437. msgstr ""
  3438. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3439. #: apt-mark.8.xml:93
  3440. msgid "<option>-f=<filename><replaceable>FILENAME</replaceable></filename></option>"
  3441. msgstr ""
  3442. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3443. #: apt-mark.8.xml:94
  3444. msgid "<option>--file=<filename><replaceable>FILENAME</replaceable></filename></option>"
  3445. msgstr ""
  3446. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3447. #: apt-mark.8.xml:97
  3448. msgid ""
  3449. "Read/Write package stats from "
  3450. "<filename><replaceable>FILENAME</replaceable></filename> instead of the "
  3451. "default location, which is <filename>extended_status</filename> in the "
  3452. "directory defined by the Configuration Item: <literal>Dir::State</literal>."
  3453. msgstr ""
  3454. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3455. #: apt-mark.8.xml:103
  3456. msgid "<option>-h</option>"
  3457. msgstr ""
  3458. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3459. #: apt-mark.8.xml:104
  3460. msgid "<option>--help</option>"
  3461. msgstr ""
  3462. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3463. #: apt-mark.8.xml:105
  3464. msgid "Show a short usage summary."
  3465. msgstr ""
  3466. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3467. #: apt-mark.8.xml:111
  3468. msgid "<option>-v</option>"
  3469. msgstr ""
  3470. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3471. #: apt-mark.8.xml:112
  3472. msgid "<option>--version</option>"
  3473. msgstr ""
  3474. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3475. #: apt-mark.8.xml:113
  3476. msgid "Show the program version."
  3477. msgstr ""
  3478. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3479. #: apt-mark.8.xml:124
  3480. msgid "<filename>/var/lib/apt/extended_states</filename>"
  3481. msgstr ""
  3482. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3483. #: apt-mark.8.xml:125
  3484. msgid ""
  3485. "Status list of auto-installed packages. Configuration Item: "
  3486. "<literal>Dir::State</literal> sets the path to the "
  3487. "<filename>extended_states</filename> file."
  3488. msgstr ""
  3489. #. type: Content of: <refentry><refsect1><para>
  3490. #: apt-mark.8.xml:134
  3491. msgid "&apt-get;,&aptitude;,&apt-conf;"
  3492. msgstr ""
  3493. #. type: Content of: <refentry><refsect1><para>
  3494. #: apt-mark.8.xml:138
  3495. msgid ""
  3496. "<command>apt-mark</command> returns zero on normal operation, non-zero on "
  3497. "error."
  3498. msgstr ""
  3499. #. type: Content of: <refentry><refnamediv><refname>
  3500. #: apt-secure.8.xml:14 apt-secure.8.xml:36
  3501. msgid "apt-secure"
  3502. msgstr ""
  3503. #. type: Content of: <refentry><refnamediv><refpurpose>
  3504. #: apt-secure.8.xml:37
  3505. msgid "Archive authentication support for APT"
  3506. msgstr ""
  3507. #. type: Content of: <refentry><refsect1><para>
  3508. #: apt-secure.8.xml:42
  3509. msgid ""
  3510. "Starting with version 0.6, <command>apt</command> contains code that does "
  3511. "signature checking of the Release file for all archives. This ensures that "
  3512. "packages in the archive can't be modified by people who have no access to "
  3513. "the Release file signing key."
  3514. msgstr ""
  3515. #. type: Content of: <refentry><refsect1><para>
  3516. #: apt-secure.8.xml:50
  3517. msgid ""
  3518. "If a package comes from a archive without a signature or with a signature "
  3519. "that apt does not have a key for that package is considered untrusted and "
  3520. "installing it will result in a big warning. <command>apt-get</command> will "
  3521. "currently only warn for unsigned archives, future releases might force all "
  3522. "sources to be verified before downloading packages from them."
  3523. msgstr ""
  3524. #. type: Content of: <refentry><refsect1><para>
  3525. #: apt-secure.8.xml:59
  3526. msgid ""
  3527. "The package frontends &apt-get;, &aptitude; and &synaptic; support this new "
  3528. "authentication feature."
  3529. msgstr ""
  3530. #. type: Content of: <refentry><refsect1><title>
  3531. #: apt-secure.8.xml:64
  3532. msgid "Trusted archives"
  3533. msgstr ""
  3534. #. type: Content of: <refentry><refsect1><para>
  3535. #: apt-secure.8.xml:67
  3536. msgid ""
  3537. "The chain of trust from an apt archive to the end user is made up of "
  3538. "different steps. <command>apt-secure</command> is the last step in this "
  3539. "chain, trusting an archive does not mean that the packages that you trust it "
  3540. "do not contain malicious code but means that you trust the archive "
  3541. "maintainer. It's the archive maintainer responsibility to ensure that the "
  3542. "archive integrity is correct."
  3543. msgstr ""
  3544. #. type: Content of: <refentry><refsect1><para>
  3545. #: apt-secure.8.xml:75
  3546. msgid ""
  3547. "apt-secure does not review signatures at a package level. If you require "
  3548. "tools to do this you should look at <command>debsig-verify</command> and "
  3549. "<command>debsign</command> (provided in the debsig-verify and devscripts "
  3550. "packages respectively)."
  3551. msgstr ""
  3552. #. type: Content of: <refentry><refsect1><para>
  3553. #: apt-secure.8.xml:82
  3554. msgid ""
  3555. "The chain of trust in Debian starts when a maintainer uploads a new package "
  3556. "or a new version of a package to the Debian archive. This upload in order to "
  3557. "become effective needs to be signed by a key of a maintainer within the "
  3558. "Debian maintainer's keyring (available in the debian-keyring "
  3559. "package). Maintainer's keys are signed by other maintainers following "
  3560. "pre-established procedures to ensure the identity of the key holder."
  3561. msgstr ""
  3562. #. type: Content of: <refentry><refsect1><para>
  3563. #: apt-secure.8.xml:92
  3564. msgid ""
  3565. "Once the uploaded package is verified and included in the archive, the "
  3566. "maintainer signature is stripped off, an MD5 sum of the package is computed "
  3567. "and put in the Packages file. The MD5 sum of all of the packages files are "
  3568. "then computed and put into the Release file. The Release file is then signed "
  3569. "by the archive key (which is created once a year) and distributed through "
  3570. "the FTP server. This key is also on the Debian keyring."
  3571. msgstr ""
  3572. #. type: Content of: <refentry><refsect1><para>
  3573. #: apt-secure.8.xml:102
  3574. msgid ""
  3575. "Any end user can check the signature of the Release file, extract the MD5 "
  3576. "sum of a package from it and compare it with the MD5 sum of the package he "
  3577. "downloaded. Prior to version 0.6 only the MD5 sum of the downloaded Debian "
  3578. "package was checked. Now both the MD5 sum and the signature of the Release "
  3579. "file are checked."
  3580. msgstr ""
  3581. #. type: Content of: <refentry><refsect1><para>
  3582. #: apt-secure.8.xml:109
  3583. msgid ""
  3584. "Notice that this is distinct from checking signatures on a per package "
  3585. "basis. It is designed to prevent two possible attacks:"
  3586. msgstr ""
  3587. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3588. #: apt-secure.8.xml:114
  3589. msgid ""
  3590. "<literal>Network \"man in the middle\" attacks</literal>. Without signature "
  3591. "checking, a malicious agent can introduce himself in the package download "
  3592. "process and provide malicious software either by controlling a network "
  3593. "element (router, switch, etc.) or by redirecting traffic to a rogue server "
  3594. "(through arp or DNS spoofing attacks)."
  3595. msgstr ""
  3596. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3597. #: apt-secure.8.xml:122
  3598. msgid ""
  3599. "<literal>Mirror network compromise</literal>. Without signature checking, a "
  3600. "malicious agent can compromise a mirror host and modify the files in it to "
  3601. "propagate malicious software to all users downloading packages from that "
  3602. "host."
  3603. msgstr ""
  3604. #. type: Content of: <refentry><refsect1><para>
  3605. #: apt-secure.8.xml:129
  3606. msgid ""
  3607. "However, it does not defend against a compromise of the Debian master server "
  3608. "itself (which signs the packages) or against a compromise of the key used to "
  3609. "sign the Release files. In any case, this mechanism can complement a "
  3610. "per-package signature."
  3611. msgstr ""
  3612. #. type: Content of: <refentry><refsect1><title>
  3613. #: apt-secure.8.xml:135
  3614. msgid "User configuration"
  3615. msgstr ""
  3616. #. type: Content of: <refentry><refsect1><para>
  3617. #: apt-secure.8.xml:137
  3618. msgid ""
  3619. "<command>apt-key</command> is the program that manages the list of keys used "
  3620. "by apt. It can be used to add or remove keys although an installation of "
  3621. "this release will automatically provide the default Debian archive signing "
  3622. "keys used in the Debian package repositories."
  3623. msgstr ""
  3624. #. type: Content of: <refentry><refsect1><para>
  3625. #: apt-secure.8.xml:144
  3626. msgid ""
  3627. "In order to add a new key you need to first download it (you should make "
  3628. "sure you are using a trusted communication channel when retrieving it), add "
  3629. "it with <command>apt-key</command> and then run <command>apt-get "
  3630. "update</command> so that apt can download and verify the "
  3631. "<filename>Release.gpg</filename> files from the archives you have "
  3632. "configured."
  3633. msgstr ""
  3634. #. type: Content of: <refentry><refsect1><title>
  3635. #: apt-secure.8.xml:153
  3636. msgid "Archive configuration"
  3637. msgstr ""
  3638. #. type: Content of: <refentry><refsect1><para>
  3639. #: apt-secure.8.xml:155
  3640. msgid ""
  3641. "If you want to provide archive signatures in an archive under your "
  3642. "maintenance you have to:"
  3643. msgstr ""
  3644. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3645. #: apt-secure.8.xml:160
  3646. msgid ""
  3647. "<emphasis>Create a toplevel Release file</emphasis>, if it does not exist "
  3648. "already. You can do this by running <command>apt-ftparchive "
  3649. "release</command> (provided in apt-utils)."
  3650. msgstr ""
  3651. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3652. #: apt-secure.8.xml:165
  3653. msgid ""
  3654. "<emphasis>Sign it</emphasis>. You can do this by running <command>gpg -abs "
  3655. "-o Release.gpg Release</command>."
  3656. msgstr ""
  3657. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3658. #: apt-secure.8.xml:168
  3659. msgid ""
  3660. "<emphasis>Publish the key fingerprint</emphasis>, that way your users will "
  3661. "know what key they need to import in order to authenticate the files in the "
  3662. "archive."
  3663. msgstr ""
  3664. #. type: Content of: <refentry><refsect1><para>
  3665. #: apt-secure.8.xml:175
  3666. msgid ""
  3667. "Whenever the contents of the archive changes (new packages are added or "
  3668. "removed) the archive maintainer has to follow the first two steps previously "
  3669. "outlined."
  3670. msgstr ""
  3671. #. type: Content of: <refentry><refsect1><para>
  3672. #: apt-secure.8.xml:183
  3673. msgid ""
  3674. "&apt-conf;, &apt-get;, &sources-list;, &apt-key;, &apt-ftparchive;, "
  3675. "&debsign; &debsig-verify;, &gpg;"
  3676. msgstr ""
  3677. #. type: Content of: <refentry><refsect1><para>
  3678. #: apt-secure.8.xml:187
  3679. msgid ""
  3680. "For more background information you might want to review the <ulink "
  3681. "url=\"http://www.debian.org/doc/manuals/securing-debian-howto/ch7.en.html\">Debian "
  3682. "Security Infrastructure</ulink> chapter of the Securing Debian Manual "
  3683. "(available also in the harden-doc package) and the <ulink "
  3684. "url=\"http://www.cryptnet.net/fdp/crypto/strong_distro.html\" >Strong "
  3685. "Distribution HOWTO</ulink> by V. Alex Brennen."
  3686. msgstr ""
  3687. #. type: Content of: <refentry><refsect1><title>
  3688. #: apt-secure.8.xml:200
  3689. msgid "Manpage Authors"
  3690. msgstr ""
  3691. #. type: Content of: <refentry><refsect1><para>
  3692. #: apt-secure.8.xml:202
  3693. msgid ""
  3694. "This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac "
  3695. "Jones, Colin Walters, Florian Weimer and Michael Vogt."
  3696. msgstr ""
  3697. #. type: Content of: <refentry><refnamediv><refname>
  3698. #: apt-sortpkgs.1.xml:22 apt-sortpkgs.1.xml:29
  3699. msgid "apt-sortpkgs"
  3700. msgstr ""
  3701. #. type: Content of: <refentry><refnamediv><refpurpose>
  3702. #: apt-sortpkgs.1.xml:30
  3703. msgid "Utility to sort package index files"
  3704. msgstr ""
  3705. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  3706. #: apt-sortpkgs.1.xml:36
  3707. msgid ""
  3708. "<command>apt-sortpkgs</command> <arg><option>-hvs</option></arg> "
  3709. "<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
  3710. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <arg "
  3711. "choice=\"plain\" rep=\"repeat\"><replaceable>file</replaceable></arg>"
  3712. msgstr ""
  3713. #. type: Content of: <refentry><refsect1><para>
  3714. #: apt-sortpkgs.1.xml:45
  3715. msgid ""
  3716. "<command>apt-sortpkgs</command> will take an index file (Source index or "
  3717. "Package index) and sort the records so that they are ordered by the package "
  3718. "name. It will also sort the internal fields of each record according to the "
  3719. "internal sorting rules."
  3720. msgstr ""
  3721. #. type: Content of: <refentry><refsect1><para>
  3722. #: apt-sortpkgs.1.xml:51
  3723. msgid "All output is sent to stdout, the input must be a seekable file."
  3724. msgstr ""
  3725. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3726. #: apt-sortpkgs.1.xml:58
  3727. msgid "<option>--source</option>"
  3728. msgstr ""
  3729. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3730. #: apt-sortpkgs.1.xml:60
  3731. msgid ""
  3732. "Use Source index field ordering. Configuration Item: "
  3733. "<literal>APT::SortPkgs::Source</literal>."
  3734. msgstr ""
  3735. #. type: Content of: <refentry><refsect1><para>
  3736. #: apt-sortpkgs.1.xml:74
  3737. msgid ""
  3738. "<command>apt-sortpkgs</command> returns zero on normal operation, decimal "
  3739. "100 on error."
  3740. msgstr ""
  3741. #. The last update date
  3742. #. type: Content of: <refentry><refentryinfo>
  3743. #: apt.conf.5.xml:13
  3744. msgid ""
  3745. "&apt-author.jgunthorpe; &apt-author.team; <author> "
  3746. "<firstname>Daniel</firstname> <surname>Burrows</surname> <contrib>Initial "
  3747. "documentation of Debug::*.</contrib> <email>dburrows@debian.org</email> "
  3748. "</author> &apt-email; &apt-product; <date>16 January 2010</date>"
  3749. msgstr ""
  3750. #. type: Content of: <refentry><refnamediv><refname>
  3751. #: apt.conf.5.xml:28 apt.conf.5.xml:35
  3752. msgid "apt.conf"
  3753. msgstr ""
  3754. #. type: Content of: <refentry><refmeta><manvolnum>
  3755. #: apt.conf.5.xml:29 apt_preferences.5.xml:22 sources.list.5.xml:23
  3756. msgid "5"
  3757. msgstr ""
  3758. #. type: Content of: <refentry><refnamediv><refpurpose>
  3759. #: apt.conf.5.xml:36
  3760. msgid "Configuration file for APT"
  3761. msgstr ""
  3762. #. type: Content of: <refentry><refsect1><para>
  3763. #: apt.conf.5.xml:40
  3764. msgid ""
  3765. "<filename>apt.conf</filename> is the main configuration file for the APT "
  3766. "suite of tools, but by far not the only place changes to options can be "
  3767. "made. All tools therefore share the configuration files and also use a "
  3768. "common command line parser to provide a uniform environment."
  3769. msgstr ""
  3770. #. type: Content of: <refentry><refsect1><orderedlist><para>
  3771. #: apt.conf.5.xml:45
  3772. msgid ""
  3773. "When an APT tool starts up it will read the configuration files in the "
  3774. "following order:"
  3775. msgstr ""
  3776. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  3777. #: apt.conf.5.xml:47
  3778. msgid ""
  3779. "the file specified by the <envar>APT_CONFIG</envar> environment variable (if "
  3780. "any)"
  3781. msgstr ""
  3782. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  3783. #: apt.conf.5.xml:49
  3784. msgid ""
  3785. "all files in <literal>Dir::Etc::Parts</literal> in alphanumeric ascending "
  3786. "order which have no or \"<literal>conf</literal>\" as filename extension and "
  3787. "which only contain alphanumeric, hyphen (-), underscore (_) and period (.) "
  3788. "characters - otherwise they will be silently ignored."
  3789. msgstr ""
  3790. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  3791. #: apt.conf.5.xml:54
  3792. msgid "the main configuration file specified by <literal>Dir::Etc::main</literal>"
  3793. msgstr ""
  3794. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  3795. #: apt.conf.5.xml:56
  3796. msgid ""
  3797. "the command line options are applied to override the configuration "
  3798. "directives or to load even more configuration files."
  3799. msgstr ""
  3800. #. type: Content of: <refentry><refsect1><title>
  3801. #: apt.conf.5.xml:60
  3802. msgid "Syntax"
  3803. msgstr ""
  3804. #. type: Content of: <refentry><refsect1><para>
  3805. #: apt.conf.5.xml:61
  3806. msgid ""
  3807. "The configuration file is organized in a tree with options organized into "
  3808. "functional groups. Option specification is given with a double colon "
  3809. "notation, for instance <literal>APT::Get::Assume-Yes</literal> is an option "
  3810. "within the APT tool group, for the Get tool. Options do not inherit from "
  3811. "their parent groups."
  3812. msgstr ""
  3813. #. type: Content of: <refentry><refsect1><para>
  3814. #: apt.conf.5.xml:67
  3815. msgid ""
  3816. "Syntactically the configuration language is modeled after what the ISC tools "
  3817. "such as bind and dhcp use. Lines starting with <literal>//</literal> are "
  3818. "treated as comments (ignored), as well as all text between "
  3819. "<literal>/*</literal> and <literal>*/</literal>, just like C/C++ comments. "
  3820. "Each line is of the form <literal>APT::Get::Assume-Yes "
  3821. "\"true\";</literal>. The trailing semicolon and the quotes are required. The "
  3822. "value must be on one line, and there is no kind of string concatenation. It "
  3823. "must not include inside quotes. The behavior of the backslash \"\\\" and "
  3824. "escaped characters inside a value is undefined and it should not be used. An "
  3825. "option name may include alphanumerical characters and the \"/-:._+\" "
  3826. "characters. A new scope can be opened with curly braces, like:"
  3827. msgstr ""
  3828. #. type: Content of: <refentry><refsect1><informalexample><programlisting>
  3829. #: apt.conf.5.xml:81
  3830. #, no-wrap
  3831. msgid ""
  3832. "APT {\n"
  3833. " Get {\n"
  3834. " Assume-Yes \"true\";\n"
  3835. " Fix-Broken \"true\";\n"
  3836. " };\n"
  3837. "};\n"
  3838. msgstr ""
  3839. #. type: Content of: <refentry><refsect1><para>
  3840. #: apt.conf.5.xml:89
  3841. msgid ""
  3842. "with newlines placed to make it more readable. Lists can be created by "
  3843. "opening a scope and including a single string enclosed in quotes followed by "
  3844. "a semicolon. Multiple entries can be included, each separated by a "
  3845. "semicolon."
  3846. msgstr ""
  3847. #. type: Content of: <refentry><refsect1><informalexample><programlisting>
  3848. #: apt.conf.5.xml:94
  3849. #, no-wrap
  3850. msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n"
  3851. msgstr ""
  3852. #. type: Content of: <refentry><refsect1><para>
  3853. #: apt.conf.5.xml:97
  3854. msgid ""
  3855. "In general the sample configuration file in "
  3856. "<filename>&docdir;examples/apt.conf</filename> &configureindex; is a good "
  3857. "guide for how it should look."
  3858. msgstr ""
  3859. #. type: Content of: <refentry><refsect1><para>
  3860. #: apt.conf.5.xml:101
  3861. msgid ""
  3862. "The names of the configuration items are not case-sensitive. So in the "
  3863. "previous example you could use <literal>dpkg::pre-install-pkgs</literal>."
  3864. msgstr ""
  3865. #. type: Content of: <refentry><refsect1><para>
  3866. #: apt.conf.5.xml:104
  3867. msgid ""
  3868. "Names for the configuration items are optional if a list is defined as it "
  3869. "can be see in the <literal>DPkg::Pre-Install-Pkgs</literal> example "
  3870. "above. If you don't specify a name a new entry will simply add a new option "
  3871. "to the list. If you specify a name you can override the option as every "
  3872. "other option by reassigning a new value to the option."
  3873. msgstr ""
  3874. #. type: Content of: <refentry><refsect1><para>
  3875. #: apt.conf.5.xml:109
  3876. msgid ""
  3877. "Two specials are allowed, <literal>#include</literal> (which is deprecated "
  3878. "and not supported by alternative implementations) and "
  3879. "<literal>#clear</literal>: <literal>#include</literal> will include the "
  3880. "given file, unless the filename ends in a slash, then the whole directory is "
  3881. "included. <literal>#clear</literal> is used to erase a part of the "
  3882. "configuration tree. The specified element and all its descendants are "
  3883. "erased. (Note that these lines also need to end with a semicolon.)"
  3884. msgstr ""
  3885. #. type: Content of: <refentry><refsect1><para>
  3886. #: apt.conf.5.xml:117
  3887. msgid ""
  3888. "The #clear command is the only way to delete a list or a complete scope. "
  3889. "Reopening a scope or the ::-style described below will "
  3890. "<emphasis>not</emphasis> override previously written entries. Only options "
  3891. "can be overridden by addressing a new value to it - lists and scopes can't "
  3892. "be overridden, only cleared."
  3893. msgstr ""
  3894. #. type: Content of: <refentry><refsect1><para>
  3895. #: apt.conf.5.xml:122
  3896. msgid ""
  3897. "All of the APT tools take a -o option which allows an arbitrary "
  3898. "configuration directive to be specified on the command line. The syntax is a "
  3899. "full option name (<literal>APT::Get::Assume-Yes</literal> for instance) "
  3900. "followed by an equals sign then the new value of the option. Lists can be "
  3901. "appended too by adding a trailing :: to the list name. (As you might "
  3902. "suspect: The scope syntax can't be used on the command line.)"
  3903. msgstr ""
  3904. #. type: Content of: <refentry><refsect1><para>
  3905. #: apt.conf.5.xml:129
  3906. msgid ""
  3907. "Note that you can use :: only for appending one item per line to a list and "
  3908. "that you should not use it in combination with the scope syntax. (The scope "
  3909. "syntax implicit insert ::) Using both syntaxes together will trigger a bug "
  3910. "which some users unfortunately relay on: An option with the unusual name "
  3911. "\"<literal>::</literal>\" which acts like every other option with a "
  3912. "name. These introduces many problems including that a user who writes "
  3913. "multiple lines in this <emphasis>wrong</emphasis> syntax in the hope to "
  3914. "append to a list will gain the opposite as only the last assignment for this "
  3915. "option \"<literal>::</literal>\" will be used. Upcoming APT versions will "
  3916. "raise errors and will stop working if they encounter this misuse, so please "
  3917. "correct such statements now as long as APT doesn't complain explicit about "
  3918. "them."
  3919. msgstr ""
  3920. #. type: Content of: <refentry><refsect1><title>
  3921. #: apt.conf.5.xml:141
  3922. msgid "The APT Group"
  3923. msgstr ""
  3924. #. type: Content of: <refentry><refsect1><para>
  3925. #: apt.conf.5.xml:142
  3926. msgid ""
  3927. "This group of options controls general APT behavior as well as holding the "
  3928. "options for all of the tools."
  3929. msgstr ""
  3930. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3931. #: apt.conf.5.xml:146
  3932. msgid "Architecture"
  3933. msgstr ""
  3934. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3935. #: apt.conf.5.xml:147
  3936. msgid ""
  3937. "System Architecture; sets the architecture to use when fetching files and "
  3938. "parsing package lists. The internal default is the architecture apt was "
  3939. "compiled for."
  3940. msgstr ""
  3941. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3942. #: apt.conf.5.xml:152
  3943. msgid "Default-Release"
  3944. msgstr ""
  3945. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3946. #: apt.conf.5.xml:153
  3947. msgid ""
  3948. "Default release to install packages from if more than one version "
  3949. "available. Contains release name, codename or release version. Examples: "
  3950. "'stable', 'testing', 'unstable', 'lenny', 'squeeze', '4.0', '5.0*'. See also "
  3951. "&apt-preferences;."
  3952. msgstr ""
  3953. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3954. #: apt.conf.5.xml:157
  3955. msgid "Ignore-Hold"
  3956. msgstr ""
  3957. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3958. #: apt.conf.5.xml:158
  3959. msgid ""
  3960. "Ignore Held packages; This global option causes the problem resolver to "
  3961. "ignore held packages in its decision making."
  3962. msgstr ""
  3963. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3964. #: apt.conf.5.xml:162
  3965. msgid "Clean-Installed"
  3966. msgstr ""
  3967. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3968. #: apt.conf.5.xml:163
  3969. msgid ""
  3970. "Defaults to on. When turned on the autoclean feature will remove any "
  3971. "packages which can no longer be downloaded from the cache. If turned off "
  3972. "then packages that are locally installed are also excluded from cleaning - "
  3973. "but note that APT provides no direct means to reinstall them."
  3974. msgstr ""
  3975. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3976. #: apt.conf.5.xml:169
  3977. msgid "Immediate-Configure"
  3978. msgstr ""
  3979. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3980. #: apt.conf.5.xml:170
  3981. msgid ""
  3982. "Defaults to on which will cause APT to install essential and important "
  3983. "packages as fast as possible in the install/upgrade operation. This is done "
  3984. "to limit the effect of a failing &dpkg; call: If this option is disabled APT "
  3985. "does treat an important package in the same way as an extra package: Between "
  3986. "the unpacking of the important package A and his configuration can then be "
  3987. "many other unpack or configuration calls, e.g. for package B which has no "
  3988. "relation to A, but causes the dpkg call to fail (e.g. because maintainer "
  3989. "script of package B generates an error) which results in a system state in "
  3990. "which package A is unpacked but unconfigured - each package depending on A "
  3991. "is now no longer guaranteed to work as their dependency on A is not longer "
  3992. "satisfied. The immediate configuration marker is also applied to all "
  3993. "dependencies which can generate a problem if the dependencies e.g. form a "
  3994. "circle as a dependency with the immediate flag is comparable with a "
  3995. "Pre-Dependency. So in theory it is possible that APT encounters a situation "
  3996. "in which it is unable to perform immediate configuration, errors out and "
  3997. "refers to this option so the user can deactivate the immediate configuration "
  3998. "temporarily to be able to perform an install/upgrade again. Note the use of "
  3999. "the word \"theory\" here as this problem was only encountered by now in real "
  4000. "world a few times in non-stable distribution versions and was caused by "
  4001. "wrong dependencies of the package in question or by a system in an already "
  4002. "broken state, so you should not blindly disable this option as the mentioned "
  4003. "scenario above is not the only problem immediate configuration can help to "
  4004. "prevent in the first place. Before a big operation like "
  4005. "<literal>dist-upgrade</literal> is run with this option disabled it should "
  4006. "be tried to explicitly <literal>install</literal> the package APT is unable "
  4007. "to configure immediately, but please make sure to report your problem also "
  4008. "to your distribution and to the APT team with the buglink below so they can "
  4009. "work on improving or correcting the upgrade process."
  4010. msgstr ""
  4011. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4012. #: apt.conf.5.xml:192
  4013. msgid "Force-LoopBreak"
  4014. msgstr ""
  4015. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4016. #: apt.conf.5.xml:193
  4017. msgid ""
  4018. "Never Enable this option unless you -really- know what you are doing. It "
  4019. "permits APT to temporarily remove an essential package to break a "
  4020. "Conflicts/Conflicts or Conflicts/Pre-Depend loop between two essential "
  4021. "packages. SUCH A LOOP SHOULD NEVER EXIST AND IS A GRAVE BUG. This option "
  4022. "will work if the essential packages are not tar, gzip, libc, dpkg, bash or "
  4023. "anything that those packages depend on."
  4024. msgstr ""
  4025. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4026. #: apt.conf.5.xml:201
  4027. msgid "Cache-Limit"
  4028. msgstr ""
  4029. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4030. #: apt.conf.5.xml:202
  4031. msgid ""
  4032. "APT uses a fixed size memory mapped cache file to store the 'available' "
  4033. "information. This sets the size of that cache (in bytes)."
  4034. msgstr ""
  4035. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4036. #: apt.conf.5.xml:206
  4037. msgid "Build-Essential"
  4038. msgstr ""
  4039. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4040. #: apt.conf.5.xml:207
  4041. msgid "Defines which package(s) are considered essential build dependencies."
  4042. msgstr ""
  4043. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4044. #: apt.conf.5.xml:210
  4045. msgid "Get"
  4046. msgstr ""
  4047. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4048. #: apt.conf.5.xml:211
  4049. msgid ""
  4050. "The Get subsection controls the &apt-get; tool, please see its documentation "
  4051. "for more information about the options here."
  4052. msgstr ""
  4053. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4054. #: apt.conf.5.xml:215
  4055. msgid "Cache"
  4056. msgstr ""
  4057. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4058. #: apt.conf.5.xml:216
  4059. msgid ""
  4060. "The Cache subsection controls the &apt-cache; tool, please see its "
  4061. "documentation for more information about the options here."
  4062. msgstr ""
  4063. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4064. #: apt.conf.5.xml:220
  4065. msgid "CDROM"
  4066. msgstr ""
  4067. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4068. #: apt.conf.5.xml:221
  4069. msgid ""
  4070. "The CDROM subsection controls the &apt-cdrom; tool, please see its "
  4071. "documentation for more information about the options here."
  4072. msgstr ""
  4073. #. type: Content of: <refentry><refsect1><title>
  4074. #: apt.conf.5.xml:227
  4075. msgid "The Acquire Group"
  4076. msgstr ""
  4077. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4078. #: apt.conf.5.xml:232
  4079. msgid "PDiffs"
  4080. msgstr ""
  4081. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4082. #: apt.conf.5.xml:233
  4083. msgid ""
  4084. "Try to download deltas called <literal>PDiffs</literal> for Packages or "
  4085. "Sources files instead of downloading whole ones. True by default."
  4086. msgstr ""
  4087. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4088. #: apt.conf.5.xml:236
  4089. msgid ""
  4090. "Two sub-options to limit the use of PDiffs are also available: With "
  4091. "<literal>FileLimit</literal> can be specified how many PDiff files are "
  4092. "downloaded at most to patch a file. <literal>SizeLimit</literal> on the "
  4093. "other hand is the maximum precentage of the size of all patches compared to "
  4094. "the size of the targeted file. If one of these limits is exceeded the "
  4095. "complete file is downloaded instead of the patches."
  4096. msgstr ""
  4097. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4098. #: apt.conf.5.xml:245
  4099. msgid "Queue-Mode"
  4100. msgstr ""
  4101. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4102. #: apt.conf.5.xml:246
  4103. msgid ""
  4104. "Queuing mode; <literal>Queue-Mode</literal> can be one of "
  4105. "<literal>host</literal> or <literal>access</literal> which determines how "
  4106. "APT parallelizes outgoing connections. <literal>host</literal> means that "
  4107. "one connection per target host will be opened, <literal>access</literal> "
  4108. "means that one connection per URI type will be opened."
  4109. msgstr ""
  4110. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4111. #: apt.conf.5.xml:253
  4112. msgid "Retries"
  4113. msgstr ""
  4114. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4115. #: apt.conf.5.xml:254
  4116. msgid ""
  4117. "Number of retries to perform. If this is non-zero APT will retry failed "
  4118. "files the given number of times."
  4119. msgstr ""
  4120. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4121. #: apt.conf.5.xml:258
  4122. msgid "Source-Symlinks"
  4123. msgstr ""
  4124. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4125. #: apt.conf.5.xml:259
  4126. msgid ""
  4127. "Use symlinks for source archives. If set to true then source archives will "
  4128. "be symlinked when possible instead of copying. True is the default."
  4129. msgstr ""
  4130. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4131. #: apt.conf.5.xml:263 sources.list.5.xml:139
  4132. msgid "http"
  4133. msgstr ""
  4134. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4135. #: apt.conf.5.xml:264
  4136. msgid ""
  4137. "HTTP URIs; http::Proxy is the default http proxy to use. It is in the "
  4138. "standard form of <literal>http://[[user][:pass]@]host[:port]/</literal>. Per "
  4139. "host proxies can also be specified by using the form "
  4140. "<literal>http::Proxy::&lt;host&gt;</literal> with the special keyword "
  4141. "<literal>DIRECT</literal> meaning to use no proxies. If no one of the above "
  4142. "settings is specified, <envar>http_proxy</envar> environment variable will "
  4143. "be used."
  4144. msgstr ""
  4145. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4146. #: apt.conf.5.xml:272
  4147. msgid ""
  4148. "Three settings are provided for cache control with HTTP/1.1 compliant proxy "
  4149. "caches. <literal>No-Cache</literal> tells the proxy to not use its cached "
  4150. "response under any circumstances, <literal>Max-Age</literal> is sent only "
  4151. "for index files and tells the cache to refresh its object if it is older "
  4152. "than the given number of seconds. Debian updates its index files daily so "
  4153. "the default is 1 day. <literal>No-Store</literal> specifies that the cache "
  4154. "should never store this request, it is only set for archive files. This may "
  4155. "be useful to prevent polluting a proxy cache with very large .deb "
  4156. "files. Note: Squid 2.0.2 does not support any of these options."
  4157. msgstr ""
  4158. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4159. #: apt.conf.5.xml:282 apt.conf.5.xml:346
  4160. msgid ""
  4161. "The option <literal>timeout</literal> sets the timeout timer used by the "
  4162. "method, this applies to all things including connection timeout and data "
  4163. "timeout."
  4164. msgstr ""
  4165. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4166. #: apt.conf.5.xml:285
  4167. msgid ""
  4168. "One setting is provided to control the pipeline depth in cases where the "
  4169. "remote server is not RFC conforming or buggy (such as Squid 2.0.2). "
  4170. "<literal>Acquire::http::Pipeline-Depth</literal> can be a value from 0 to 5 "
  4171. "indicating how many outstanding requests APT should send. A value of zero "
  4172. "MUST be specified if the remote host does not properly linger on TCP "
  4173. "connections - otherwise data corruption will occur. Hosts which require this "
  4174. "are in violation of RFC 2068."
  4175. msgstr ""
  4176. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4177. #: apt.conf.5.xml:293
  4178. msgid ""
  4179. "The used bandwidth can be limited with "
  4180. "<literal>Acquire::http::Dl-Limit</literal> which accepts integer values in "
  4181. "kilobyte. The default value is 0 which deactivates the limit and tries uses "
  4182. "as much as possible of the bandwidth (Note that this option implicit "
  4183. "deactivates the download from multiple servers at the same time.)"
  4184. msgstr ""
  4185. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4186. #: apt.conf.5.xml:298
  4187. msgid ""
  4188. "<literal>Acquire::http::User-Agent</literal> can be used to set a different "
  4189. "User-Agent for the http download method as some proxies allow access for "
  4190. "clients only if the client uses a known identifier."
  4191. msgstr ""
  4192. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4193. #: apt.conf.5.xml:304
  4194. msgid "https"
  4195. msgstr ""
  4196. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4197. #: apt.conf.5.xml:305
  4198. msgid ""
  4199. "HTTPS URIs. Cache-control, Timeout, AllowRedirect, Dl-Limit and proxy "
  4200. "options are the same as for <literal>http</literal> method and will also "
  4201. "default to the options from the <literal>http</literal> method if they are "
  4202. "not explicitly set for https. <literal>Pipeline-Depth</literal> option is "
  4203. "not supported yet."
  4204. msgstr ""
  4205. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4206. #: apt.conf.5.xml:311
  4207. msgid ""
  4208. "<literal>CaInfo</literal> suboption specifies place of file that holds info "
  4209. "about trusted certificates. <literal>&lt;host&gt;::CaInfo</literal> is "
  4210. "corresponding per-host option. <literal>Verify-Peer</literal> boolean "
  4211. "suboption determines whether verify server's host certificate against "
  4212. "trusted certificates or not. <literal>&lt;host&gt;::Verify-Peer</literal> "
  4213. "is corresponding per-host option. <literal>Verify-Host</literal> boolean "
  4214. "suboption determines whether verify server's hostname or not. "
  4215. "<literal>&lt;host&gt;::Verify-Host</literal> is corresponding per-host "
  4216. "option. <literal>SslCert</literal> determines what certificate to use for "
  4217. "client authentication. <literal>&lt;host&gt;::SslCert</literal> is "
  4218. "corresponding per-host option. <literal>SslKey</literal> determines what "
  4219. "private key to use for client "
  4220. "authentication. <literal>&lt;host&gt;::SslKey</literal> is corresponding "
  4221. "per-host option. <literal>SslForceVersion</literal> overrides default SSL "
  4222. "version to use. Can contain 'TLSv1' or 'SSLv3' string. "
  4223. "<literal>&lt;host&gt;::SslForceVersion</literal> is corresponding per-host "
  4224. "option."
  4225. msgstr ""
  4226. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4227. #: apt.conf.5.xml:329 sources.list.5.xml:150
  4228. msgid "ftp"
  4229. msgstr ""
  4230. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4231. #: apt.conf.5.xml:330
  4232. msgid ""
  4233. "FTP URIs; ftp::Proxy is the default ftp proxy to use. It is in the standard "
  4234. "form of <literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per host "
  4235. "proxies can also be specified by using the form "
  4236. "<literal>ftp::Proxy::&lt;host&gt;</literal> with the special keyword "
  4237. "<literal>DIRECT</literal> meaning to use no proxies. If no one of the above "
  4238. "settings is specified, <envar>ftp_proxy</envar> environment variable will be "
  4239. "used. To use a ftp proxy you will have to set the "
  4240. "<literal>ftp::ProxyLogin</literal> script in the configuration file. This "
  4241. "entry specifies the commands to send to tell the proxy server what to "
  4242. "connect to. Please see &configureindex; for an example of how to do "
  4243. "this. The substitution variables available are "
  4244. "<literal>$(PROXY_USER)</literal> <literal>$(PROXY_PASS)</literal> "
  4245. "<literal>$(SITE_USER)</literal> <literal>$(SITE_PASS)</literal> "
  4246. "<literal>$(SITE)</literal> and <literal>$(SITE_PORT)</literal> Each is taken "
  4247. "from it's respective URI component."
  4248. msgstr ""
  4249. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4250. #: apt.conf.5.xml:349
  4251. msgid ""
  4252. "Several settings are provided to control passive mode. Generally it is safe "
  4253. "to leave passive mode on, it works in nearly every environment. However "
  4254. "some situations require that passive mode be disabled and port mode ftp used "
  4255. "instead. This can be done globally, for connections that go through a proxy "
  4256. "or for a specific host (See the sample config file for examples)."
  4257. msgstr ""
  4258. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4259. #: apt.conf.5.xml:356
  4260. msgid ""
  4261. "It is possible to proxy FTP over HTTP by setting the "
  4262. "<envar>ftp_proxy</envar> environment variable to a http url - see the "
  4263. "discussion of the http method above for syntax. You cannot set this in the "
  4264. "configuration file and it is not recommended to use FTP over HTTP due to its "
  4265. "low efficiency."
  4266. msgstr ""
  4267. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4268. #: apt.conf.5.xml:361
  4269. msgid ""
  4270. "The setting <literal>ForceExtended</literal> controls the use of RFC2428 "
  4271. "<literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is "
  4272. "false, which means these commands are only used if the control connection is "
  4273. "IPv6. Setting this to true forces their use even on IPv4 connections. Note "
  4274. "that most FTP servers do not support RFC2428."
  4275. msgstr ""
  4276. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4277. #: apt.conf.5.xml:368 sources.list.5.xml:132
  4278. msgid "cdrom"
  4279. msgstr ""
  4280. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout>
  4281. #: apt.conf.5.xml:374
  4282. #, no-wrap
  4283. msgid "/cdrom/::Mount \"foo\";"
  4284. msgstr ""
  4285. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4286. #: apt.conf.5.xml:369
  4287. msgid ""
  4288. "CDROM URIs; the only setting for CDROM URIs is the mount point, "
  4289. "<literal>cdrom::Mount</literal> which must be the mount point for the CDROM "
  4290. "drive as specified in <filename>/etc/fstab</filename>. It is possible to "
  4291. "provide alternate mount and unmount commands if your mount point cannot be "
  4292. "listed in the fstab (such as an SMB mount and old mount packages). The "
  4293. "syntax is to put <placeholder type=\"literallayout\" id=\"0\"/> within the "
  4294. "cdrom block. It is important to have the trailing slash. Unmount commands "
  4295. "can be specified using UMount."
  4296. msgstr ""
  4297. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4298. #: apt.conf.5.xml:379
  4299. msgid "gpgv"
  4300. msgstr ""
  4301. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4302. #: apt.conf.5.xml:380
  4303. msgid ""
  4304. "GPGV URIs; the only option for GPGV URIs is the option to pass additional "
  4305. "parameters to gpgv. <literal>gpgv::Options</literal> Additional options "
  4306. "passed to gpgv."
  4307. msgstr ""
  4308. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4309. #: apt.conf.5.xml:385
  4310. msgid "CompressionTypes"
  4311. msgstr ""
  4312. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  4313. #: apt.conf.5.xml:391
  4314. #, no-wrap
  4315. msgid ""
  4316. "Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> "
  4317. "\"<replaceable>Methodname</replaceable>\";"
  4318. msgstr ""
  4319. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4320. #: apt.conf.5.xml:386
  4321. msgid ""
  4322. "List of compression types which are understood by the acquire methods. "
  4323. "Files like <filename>Packages</filename> can be available in various "
  4324. "compression formats. Per default the acquire methods can decompress "
  4325. "<command>bzip2</command>, <command>lzma</command> and "
  4326. "<command>gzip</command> compressed files, with this setting more formats can "
  4327. "be added on the fly or the used method can be changed. The syntax for this "
  4328. "is: <placeholder type=\"synopsis\" id=\"0\"/>"
  4329. msgstr ""
  4330. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  4331. #: apt.conf.5.xml:396
  4332. #, no-wrap
  4333. msgid "Acquire::CompressionTypes::Order:: \"gz\";"
  4334. msgstr ""
  4335. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  4336. #: apt.conf.5.xml:399
  4337. #, no-wrap
  4338. msgid "Acquire::CompressionTypes::Order { \"lzma\"; \"gz\"; };"
  4339. msgstr ""
  4340. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4341. #: apt.conf.5.xml:392
  4342. msgid ""
  4343. "Also the <literal>Order</literal> subgroup can be used to define in which "
  4344. "order the acquire system will try to download the compressed files. The "
  4345. "acquire system will try the first and proceed with the next compression type "
  4346. "in this list on error, so to prefer one over the other type simple add the "
  4347. "preferred type at first - not already added default types will be added at "
  4348. "run time to the end of the list, so e.g. <placeholder type=\"synopsis\" "
  4349. "id=\"0\"/> can be used to prefer <command>gzip</command> compressed files "
  4350. "over <command>bzip2</command> and <command>lzma</command>. If "
  4351. "<command>lzma</command> should be preferred over <command>gzip</command> and "
  4352. "<command>bzip2</command> the configure setting should look like this "
  4353. "<placeholder type=\"synopsis\" id=\"1\"/> It is not needed to add "
  4354. "<literal>bz2</literal> explicit to the list as it will be added automatic."
  4355. msgstr ""
  4356. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout>
  4357. #: apt.conf.5.xml:403
  4358. #, no-wrap
  4359. msgid "Dir::Bin::bzip2 \"/bin/bzip2\";"
  4360. msgstr ""
  4361. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4362. #: apt.conf.5.xml:401
  4363. msgid ""
  4364. "Note that at run time the "
  4365. "<literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will be "
  4366. "checked: If this setting exists the method will only be used if this file "
  4367. "exists, e.g. for the bzip2 method (the inbuilt) setting is <placeholder "
  4368. "type=\"literallayout\" id=\"0\"/> Note also that list entries specified on "
  4369. "the command line will be added at the end of the list specified in the "
  4370. "configuration files, but before the default entries. To prefer a type in "
  4371. "this case over the ones specified in in the configuration files you can set "
  4372. "the option direct - not in list style. This will not override the defined "
  4373. "list, it will only prefix the list with this type."
  4374. msgstr ""
  4375. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4376. #: apt.conf.5.xml:408
  4377. msgid ""
  4378. "While it is possible to add an empty compression type to the order list, but "
  4379. "APT in its current version doesn't understand it correctly and will display "
  4380. "many warnings about not downloaded files - these warnings are most of the "
  4381. "time false negatives. Future versions will maybe include a way to really "
  4382. "prefer uncompressed files to support the usage of local mirrors."
  4383. msgstr ""
  4384. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4385. #: apt.conf.5.xml:414
  4386. msgid "Languages"
  4387. msgstr ""
  4388. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4389. #: apt.conf.5.xml:415
  4390. msgid ""
  4391. "The Languages subsection controls which <filename>Translation</filename> "
  4392. "files are downloaded and in which order APT tries to display the "
  4393. "Description-Translations. APT will try to display the first available "
  4394. "Description in the Language which is listed at first. Languages can be "
  4395. "defined with their short or long Languagecodes. Note that not all archives "
  4396. "provide <filename>Translation</filename> files for every Language - "
  4397. "especially the long Languagecodes are rare, so please inform you which ones "
  4398. "are available before you set here impossible values."
  4399. msgstr ""
  4400. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><programlisting>
  4401. #: apt.conf.5.xml:431
  4402. #, no-wrap
  4403. msgid "Acquire::Languages { \"environment\"; \"de\"; \"en\"; \"none\"; \"fr\"; };"
  4404. msgstr ""
  4405. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4406. #: apt.conf.5.xml:421
  4407. msgid ""
  4408. "The default list includes \"environment\" and "
  4409. "\"en\". \"<literal>environment</literal>\" has a special meaning here: It "
  4410. "will be replaced at runtime with the languagecodes extracted from the "
  4411. "<literal>LC_MESSAGES</literal> environment variable. It will also ensure "
  4412. "that these codes are not included twice in the list. If "
  4413. "<literal>LC_MESSAGES</literal> is set to \"C\" only the "
  4414. "<filename>Translation-en</filename> file (if available) will be used. To "
  4415. "force apt to use no Translation file use the setting "
  4416. "<literal>Acquire::Languages=none</literal>. \"<literal>none</literal>\" is "
  4417. "another special meaning code which will stop the search for a fitting "
  4418. "<filename>Translation</filename> file. This can be used by the system "
  4419. "administrator to let APT know that it should download also this files "
  4420. "without actually use them if the environment doesn't specify this "
  4421. "languages. So the following example configuration will result in the order "
  4422. "\"en, de\" in an english and in \"de, en\" in a german localization. Note "
  4423. "that \"fr\" is downloaded, but not used if APT is not used in a french "
  4424. "localization, in such an environment the order would be \"fr, de, en\". "
  4425. "<placeholder type=\"programlisting\" id=\"0\"/>"
  4426. msgstr ""
  4427. #. type: Content of: <refentry><refsect1><para>
  4428. #: apt.conf.5.xml:228
  4429. msgid ""
  4430. "The <literal>Acquire</literal> group of options controls the download of "
  4431. "packages and the URI handlers. <placeholder type=\"variablelist\" "
  4432. "id=\"0\"/>"
  4433. msgstr ""
  4434. #. type: Content of: <refentry><refsect1><title>
  4435. #: apt.conf.5.xml:438
  4436. msgid "Directories"
  4437. msgstr ""
  4438. #. type: Content of: <refentry><refsect1><para>
  4439. #: apt.conf.5.xml:440
  4440. msgid ""
  4441. "The <literal>Dir::State</literal> section has directories that pertain to "
  4442. "local state information. <literal>lists</literal> is the directory to place "
  4443. "downloaded package lists in and <literal>status</literal> is the name of the "
  4444. "dpkg status file. <literal>preferences</literal> is the name of the APT "
  4445. "preferences file. <literal>Dir::State</literal> contains the default "
  4446. "directory to prefix on all sub items if they do not start with "
  4447. "<filename>/</filename> or <filename>./</filename>."
  4448. msgstr ""
  4449. #. type: Content of: <refentry><refsect1><para>
  4450. #: apt.conf.5.xml:447
  4451. msgid ""
  4452. "<literal>Dir::Cache</literal> contains locations pertaining to local cache "
  4453. "information, such as the two package caches <literal>srcpkgcache</literal> "
  4454. "and <literal>pkgcache</literal> as well as the location to place downloaded "
  4455. "archives, <literal>Dir::Cache::archives</literal>. Generation of caches can "
  4456. "be turned off by setting their names to be blank. This will slow down "
  4457. "startup but save disk space. It is probably preferred to turn off the "
  4458. "pkgcache rather than the srcpkgcache. Like <literal>Dir::State</literal> the "
  4459. "default directory is contained in <literal>Dir::Cache</literal>"
  4460. msgstr ""
  4461. #. type: Content of: <refentry><refsect1><para>
  4462. #: apt.conf.5.xml:456
  4463. msgid ""
  4464. "<literal>Dir::Etc</literal> contains the location of configuration files, "
  4465. "<literal>sourcelist</literal> gives the location of the sourcelist and "
  4466. "<literal>main</literal> is the default configuration file (setting has no "
  4467. "effect, unless it is done from the config file specified by "
  4468. "<envar>APT_CONFIG</envar>)."
  4469. msgstr ""
  4470. #. type: Content of: <refentry><refsect1><para>
  4471. #: apt.conf.5.xml:462
  4472. msgid ""
  4473. "The <literal>Dir::Parts</literal> setting reads in all the config fragments "
  4474. "in lexical order from the directory specified. After this is done then the "
  4475. "main config file is loaded."
  4476. msgstr ""
  4477. #. type: Content of: <refentry><refsect1><para>
  4478. #: apt.conf.5.xml:466
  4479. msgid ""
  4480. "Binary programs are pointed to by "
  4481. "<literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> specifies "
  4482. "the location of the method handlers and <literal>gzip</literal>, "
  4483. "<literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, "
  4484. "<literal>apt-get</literal> <literal>dpkg-source</literal> "
  4485. "<literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> "
  4486. "specify the location of the respective programs."
  4487. msgstr ""
  4488. #. type: Content of: <refentry><refsect1><para>
  4489. #: apt.conf.5.xml:474
  4490. msgid ""
  4491. "The configuration item <literal>RootDir</literal> has a special meaning. If "
  4492. "set, all paths in <literal>Dir::</literal> will be relative to "
  4493. "<literal>RootDir</literal>, <emphasis>even paths that are specified "
  4494. "absolutely</emphasis>. So, for instance, if <literal>RootDir</literal> is "
  4495. "set to <filename>/tmp/staging</filename> and "
  4496. "<literal>Dir::State::status</literal> is set to "
  4497. "<filename>/var/lib/dpkg/status</filename>, then the status file will be "
  4498. "looked up in <filename>/tmp/staging/var/lib/dpkg/status</filename>."
  4499. msgstr ""
  4500. #. type: Content of: <refentry><refsect1><title>
  4501. #: apt.conf.5.xml:487
  4502. msgid "APT in DSelect"
  4503. msgstr ""
  4504. #. type: Content of: <refentry><refsect1><para>
  4505. #: apt.conf.5.xml:489
  4506. msgid ""
  4507. "When APT is used as a &dselect; method several configuration directives "
  4508. "control the default behaviour. These are in the <literal>DSelect</literal> "
  4509. "section."
  4510. msgstr ""
  4511. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4512. #: apt.conf.5.xml:493
  4513. msgid "Clean"
  4514. msgstr ""
  4515. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4516. #: apt.conf.5.xml:494
  4517. msgid ""
  4518. "Cache Clean mode; this value may be one of always, prompt, auto, pre-auto "
  4519. "and never. always and prompt will remove all packages from the cache after "
  4520. "upgrading, prompt (the default) does so conditionally. auto removes only "
  4521. "those packages which are no longer downloadable (replaced with a new version "
  4522. "for instance). pre-auto performs this action before downloading new "
  4523. "packages."
  4524. msgstr ""
  4525. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4526. #: apt.conf.5.xml:503
  4527. msgid ""
  4528. "The contents of this variable is passed to &apt-get; as command line options "
  4529. "when it is run for the install phase."
  4530. msgstr ""
  4531. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4532. #: apt.conf.5.xml:507
  4533. msgid "Updateoptions"
  4534. msgstr ""
  4535. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4536. #: apt.conf.5.xml:508
  4537. msgid ""
  4538. "The contents of this variable is passed to &apt-get; as command line options "
  4539. "when it is run for the update phase."
  4540. msgstr ""
  4541. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4542. #: apt.conf.5.xml:512
  4543. msgid "PromptAfterUpdate"
  4544. msgstr ""
  4545. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4546. #: apt.conf.5.xml:513
  4547. msgid ""
  4548. "If true the [U]pdate operation in &dselect; will always prompt to continue. "
  4549. "The default is to prompt only on error."
  4550. msgstr ""
  4551. #. type: Content of: <refentry><refsect1><title>
  4552. #: apt.conf.5.xml:519
  4553. msgid "How APT calls dpkg"
  4554. msgstr ""
  4555. #. type: Content of: <refentry><refsect1><para>
  4556. #: apt.conf.5.xml:520
  4557. msgid ""
  4558. "Several configuration directives control how APT invokes &dpkg;. These are "
  4559. "in the <literal>DPkg</literal> section."
  4560. msgstr ""
  4561. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4562. #: apt.conf.5.xml:525
  4563. msgid ""
  4564. "This is a list of options to pass to dpkg. The options must be specified "
  4565. "using the list notation and each list item is passed as a single argument to "
  4566. "&dpkg;."
  4567. msgstr ""
  4568. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4569. #: apt.conf.5.xml:530
  4570. msgid "Pre-Invoke"
  4571. msgstr ""
  4572. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4573. #: apt.conf.5.xml:530
  4574. msgid "Post-Invoke"
  4575. msgstr ""
  4576. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4577. #: apt.conf.5.xml:531
  4578. msgid ""
  4579. "This is a list of shell commands to run before/after invoking &dpkg;. Like "
  4580. "<literal>options</literal> this must be specified in list notation. The "
  4581. "commands are invoked in order using <filename>/bin/sh</filename>, should any "
  4582. "fail APT will abort."
  4583. msgstr ""
  4584. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4585. #: apt.conf.5.xml:537
  4586. msgid "Pre-Install-Pkgs"
  4587. msgstr ""
  4588. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4589. #: apt.conf.5.xml:538
  4590. msgid ""
  4591. "This is a list of shell commands to run before invoking dpkg. Like "
  4592. "<literal>options</literal> this must be specified in list notation. The "
  4593. "commands are invoked in order using <filename>/bin/sh</filename>, should any "
  4594. "fail APT will abort. APT will pass to the commands on standard input the "
  4595. "filenames of all .deb files it is going to install, one per line."
  4596. msgstr ""
  4597. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4598. #: apt.conf.5.xml:544
  4599. msgid ""
  4600. "Version 2 of this protocol dumps more information, including the protocol "
  4601. "version, the APT configuration space and the packages, files and versions "
  4602. "being changed. Version 2 is enabled by setting "
  4603. "<literal>DPkg::Tools::options::cmd::Version</literal> to "
  4604. "2. <literal>cmd</literal> is a command given to "
  4605. "<literal>Pre-Install-Pkgs</literal>."
  4606. msgstr ""
  4607. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4608. #: apt.conf.5.xml:551
  4609. msgid "Run-Directory"
  4610. msgstr ""
  4611. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4612. #: apt.conf.5.xml:552
  4613. msgid ""
  4614. "APT chdirs to this directory before invoking dpkg, the default is "
  4615. "<filename>/</filename>."
  4616. msgstr ""
  4617. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4618. #: apt.conf.5.xml:556
  4619. msgid "Build-options"
  4620. msgstr ""
  4621. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4622. #: apt.conf.5.xml:557
  4623. msgid ""
  4624. "These options are passed to &dpkg-buildpackage; when compiling packages, the "
  4625. "default is to disable signing and produce all binaries."
  4626. msgstr ""
  4627. #. type: Content of: <refentry><refsect1><refsect2><title>
  4628. #: apt.conf.5.xml:562
  4629. msgid "dpkg trigger usage (and related options)"
  4630. msgstr ""
  4631. #. type: Content of: <refentry><refsect1><refsect2><para>
  4632. #: apt.conf.5.xml:563
  4633. msgid ""
  4634. "APT can call dpkg in a way so it can make aggressive use of triggers over "
  4635. "multiply calls of dpkg. Without further options dpkg will use triggers only "
  4636. "in between his own run. Activating these options can therefore decrease the "
  4637. "time needed to perform the install / upgrade. Note that it is intended to "
  4638. "activate these options per default in the future, but as it changes the way "
  4639. "APT calling dpkg drastically it needs a lot more testing. <emphasis>These "
  4640. "options are therefore currently experimental and should not be used in "
  4641. "productive environments.</emphasis> Also it breaks the progress reporting so "
  4642. "all frontends will currently stay around half (or more) of the time in the "
  4643. "100% state while it actually configures all packages."
  4644. msgstr ""
  4645. #. type: Content of: <refentry><refsect1><refsect2><para><literallayout>
  4646. #: apt.conf.5.xml:578
  4647. #, no-wrap
  4648. msgid ""
  4649. "DPkg::NoTriggers \"true\";\n"
  4650. "PackageManager::Configure \"smart\";\n"
  4651. "DPkg::ConfigurePending \"true\";\n"
  4652. "DPkg::TriggersPending \"true\";"
  4653. msgstr ""
  4654. #. type: Content of: <refentry><refsect1><refsect2><para>
  4655. #: apt.conf.5.xml:572
  4656. msgid ""
  4657. "Note that it is not guaranteed that APT will support these options or that "
  4658. "these options will not cause (big) trouble in the future. If you have "
  4659. "understand the current risks and problems with these options, but are brave "
  4660. "enough to help testing them create a new configuration file and test a "
  4661. "combination of options. Please report any bugs, problems and improvements "
  4662. "you encounter and make sure to note which options you have used in your "
  4663. "reports. Asking dpkg for help could also be useful for debugging proposes, "
  4664. "see e.g. <command>dpkg --audit</command>. A defensive option combination "
  4665. "would be <placeholder type=\"literallayout\" id=\"0\"/>"
  4666. msgstr ""
  4667. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4668. #: apt.conf.5.xml:584
  4669. msgid "DPkg::NoTriggers"
  4670. msgstr ""
  4671. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4672. #: apt.conf.5.xml:585
  4673. msgid ""
  4674. "Add the no triggers flag to all dpkg calls (except the ConfigurePending "
  4675. "call). See &dpkg; if you are interested in what this actually means. In "
  4676. "short: dpkg will not run the triggers when this flag is present unless it is "
  4677. "explicitly called to do so in an extra call. Note that this option exists "
  4678. "(undocumented) also in older apt versions with a slightly different meaning: "
  4679. "Previously these option only append --no-triggers to the configure calls to "
  4680. "dpkg - now apt will add these flag also to the unpack and remove calls."
  4681. msgstr ""
  4682. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4683. #: apt.conf.5.xml:592
  4684. msgid "PackageManager::Configure"
  4685. msgstr ""
  4686. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4687. #: apt.conf.5.xml:593
  4688. msgid ""
  4689. "Valid values are \"<literal>all</literal>\", \"<literal>smart</literal>\" "
  4690. "and \"<literal>no</literal>\". \"<literal>all</literal>\" is the default "
  4691. "value and causes APT to configure all packages explicit. The "
  4692. "\"<literal>smart</literal>\" way is it to configure only packages which need "
  4693. "to be configured before another package can be unpacked (Pre-Depends) and "
  4694. "let the rest configure by dpkg with a call generated by the next "
  4695. "option. \"<literal>no</literal>\" on the other hand will not configure "
  4696. "anything and totally rely on dpkg for configuration (which will at the "
  4697. "moment fail if a Pre-Depends is encountered). Setting this option to "
  4698. "another than the all value will implicitly activate also the next option per "
  4699. "default as otherwise the system could end in an unconfigured status which "
  4700. "could be unbootable!"
  4701. msgstr ""
  4702. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4703. #: apt.conf.5.xml:603
  4704. msgid "DPkg::ConfigurePending"
  4705. msgstr ""
  4706. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4707. #: apt.conf.5.xml:604
  4708. msgid ""
  4709. "If this option is set apt will call <command>dpkg --configure "
  4710. "--pending</command> to let dpkg handle all required configurations and "
  4711. "triggers. This option is activated automatic per default if the previous "
  4712. "option is not set to <literal>all</literal>, but deactivating could be "
  4713. "useful if you want to run APT multiple times in a row - e.g. in an "
  4714. "installer. In these sceneries you could deactivate this option in all but "
  4715. "the last run."
  4716. msgstr ""
  4717. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4718. #: apt.conf.5.xml:610
  4719. msgid "DPkg::TriggersPending"
  4720. msgstr ""
  4721. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4722. #: apt.conf.5.xml:611
  4723. msgid ""
  4724. "Useful for <literal>smart</literal> configuration as a package which has "
  4725. "pending triggers is not considered as <literal>installed</literal> and dpkg "
  4726. "treats them as <literal>unpacked</literal> currently which is a dealbreaker "
  4727. "for Pre-Dependencies (see debbugs #526774). Note that this will process all "
  4728. "triggers, not only the triggers needed to configure this package."
  4729. msgstr ""
  4730. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4731. #: apt.conf.5.xml:616
  4732. msgid "PackageManager::UnpackAll"
  4733. msgstr ""
  4734. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4735. #: apt.conf.5.xml:617
  4736. msgid ""
  4737. "As the configuration can be deferred to be done at the end by dpkg it can be "
  4738. "tried to order the unpack series only by critical needs, e.g. by "
  4739. "Pre-Depends. Default is true and therefore the \"old\" method of ordering in "
  4740. "various steps by everything. While both method were present in earlier APT "
  4741. "versions the <literal>OrderCritical</literal> method was unused, so this "
  4742. "method is very experimental and needs further improvements before becoming "
  4743. "really useful."
  4744. msgstr ""
  4745. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4746. #: apt.conf.5.xml:624
  4747. msgid "OrderList::Score::Immediate"
  4748. msgstr ""
  4749. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para><literallayout>
  4750. #: apt.conf.5.xml:632
  4751. #, no-wrap
  4752. msgid ""
  4753. "OrderList::Score {\n"
  4754. "\tDelete 500;\n"
  4755. "\tEssential 200;\n"
  4756. "\tImmediate 10;\n"
  4757. "\tPreDepends 50;\n"
  4758. "};"
  4759. msgstr ""
  4760. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4761. #: apt.conf.5.xml:625
  4762. msgid ""
  4763. "Essential packages (and there dependencies) should be configured immediately "
  4764. "after unpacking. It will be a good idea to do this quite early in the "
  4765. "upgrade process as these these configure calls require currently also "
  4766. "<literal>DPkg::TriggersPending</literal> which will run quite a few triggers "
  4767. "(which maybe not needed). Essentials get per default a high score but the "
  4768. "immediate flag is relatively low (a package which has a Pre-Depends is "
  4769. "higher rated). These option and the others in the same group can be used to "
  4770. "change the scoring. The following example shows the settings with there "
  4771. "default values. <placeholder type=\"literallayout\" id=\"0\"/>"
  4772. msgstr ""
  4773. #. type: Content of: <refentry><refsect1><title>
  4774. #: apt.conf.5.xml:645
  4775. msgid "Periodic and Archives options"
  4776. msgstr ""
  4777. #. type: Content of: <refentry><refsect1><para>
  4778. #: apt.conf.5.xml:646
  4779. msgid ""
  4780. "<literal>APT::Periodic</literal> and <literal>APT::Archives</literal> groups "
  4781. "of options configure behavior of apt periodic updates, which is done by "
  4782. "<literal>/etc/cron.daily/apt</literal> script. See header of this script for "
  4783. "the brief documentation of these options."
  4784. msgstr ""
  4785. #. type: Content of: <refentry><refsect1><title>
  4786. #: apt.conf.5.xml:654
  4787. msgid "Debug options"
  4788. msgstr ""
  4789. #. type: Content of: <refentry><refsect1><para>
  4790. #: apt.conf.5.xml:656
  4791. msgid ""
  4792. "Enabling options in the <literal>Debug::</literal> section will cause "
  4793. "debugging information to be sent to the standard error stream of the program "
  4794. "utilizing the <literal>apt</literal> libraries, or enable special program "
  4795. "modes that are primarily useful for debugging the behavior of "
  4796. "<literal>apt</literal>. Most of these options are not interesting to a "
  4797. "normal user, but a few may be:"
  4798. msgstr ""
  4799. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4800. #: apt.conf.5.xml:667
  4801. msgid ""
  4802. "<literal>Debug::pkgProblemResolver</literal> enables output about the "
  4803. "decisions made by <literal>dist-upgrade, upgrade, install, remove, "
  4804. "purge</literal>."
  4805. msgstr ""
  4806. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4807. #: apt.conf.5.xml:675
  4808. msgid ""
  4809. "<literal>Debug::NoLocking</literal> disables all file locking. This can be "
  4810. "used to run some operations (for instance, <literal>apt-get -s "
  4811. "install</literal>) as a non-root user."
  4812. msgstr ""
  4813. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4814. #: apt.conf.5.xml:684
  4815. msgid ""
  4816. "<literal>Debug::pkgDPkgPM</literal> prints out the actual command line each "
  4817. "time that <literal>apt</literal> invokes &dpkg;."
  4818. msgstr ""
  4819. #. TODO: provide a
  4820. #. motivating example, except I haven't a clue why you'd want
  4821. #. to do this.
  4822. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4823. #: apt.conf.5.xml:692
  4824. msgid ""
  4825. "<literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data "
  4826. "in CDROM IDs."
  4827. msgstr ""
  4828. #. type: Content of: <refentry><refsect1><para>
  4829. #: apt.conf.5.xml:702
  4830. msgid "A full list of debugging options to apt follows."
  4831. msgstr ""
  4832. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4833. #: apt.conf.5.xml:707
  4834. msgid "<literal>Debug::Acquire::cdrom</literal>"
  4835. msgstr ""
  4836. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4837. #: apt.conf.5.xml:711
  4838. msgid "Print information related to accessing <literal>cdrom://</literal> sources."
  4839. msgstr ""
  4840. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4841. #: apt.conf.5.xml:718
  4842. msgid "<literal>Debug::Acquire::ftp</literal>"
  4843. msgstr ""
  4844. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4845. #: apt.conf.5.xml:722
  4846. msgid "Print information related to downloading packages using FTP."
  4847. msgstr ""
  4848. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4849. #: apt.conf.5.xml:729
  4850. msgid "<literal>Debug::Acquire::http</literal>"
  4851. msgstr ""
  4852. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4853. #: apt.conf.5.xml:733
  4854. msgid "Print information related to downloading packages using HTTP."
  4855. msgstr ""
  4856. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4857. #: apt.conf.5.xml:740
  4858. msgid "<literal>Debug::Acquire::https</literal>"
  4859. msgstr ""
  4860. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4861. #: apt.conf.5.xml:744
  4862. msgid "Print information related to downloading packages using HTTPS."
  4863. msgstr ""
  4864. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4865. #: apt.conf.5.xml:751
  4866. msgid "<literal>Debug::Acquire::gpgv</literal>"
  4867. msgstr ""
  4868. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4869. #: apt.conf.5.xml:755
  4870. msgid ""
  4871. "Print information related to verifying cryptographic signatures using "
  4872. "<literal>gpg</literal>."
  4873. msgstr ""
  4874. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4875. #: apt.conf.5.xml:762
  4876. msgid "<literal>Debug::aptcdrom</literal>"
  4877. msgstr ""
  4878. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4879. #: apt.conf.5.xml:766
  4880. msgid ""
  4881. "Output information about the process of accessing collections of packages "
  4882. "stored on CD-ROMs."
  4883. msgstr ""
  4884. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4885. #: apt.conf.5.xml:773
  4886. msgid "<literal>Debug::BuildDeps</literal>"
  4887. msgstr ""
  4888. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4889. #: apt.conf.5.xml:776
  4890. msgid "Describes the process of resolving build-dependencies in &apt-get;."
  4891. msgstr ""
  4892. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4893. #: apt.conf.5.xml:783
  4894. msgid "<literal>Debug::Hashes</literal>"
  4895. msgstr ""
  4896. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4897. #: apt.conf.5.xml:786
  4898. msgid ""
  4899. "Output each cryptographic hash that is generated by the "
  4900. "<literal>apt</literal> libraries."
  4901. msgstr ""
  4902. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4903. #: apt.conf.5.xml:793
  4904. msgid "<literal>Debug::IdentCDROM</literal>"
  4905. msgstr ""
  4906. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4907. #: apt.conf.5.xml:796
  4908. msgid ""
  4909. "Do not include information from <literal>statfs</literal>, namely the number "
  4910. "of used and free blocks on the CD-ROM filesystem, when generating an ID for "
  4911. "a CD-ROM."
  4912. msgstr ""
  4913. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4914. #: apt.conf.5.xml:804
  4915. msgid "<literal>Debug::NoLocking</literal>"
  4916. msgstr ""
  4917. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4918. #: apt.conf.5.xml:807
  4919. msgid ""
  4920. "Disable all file locking. For instance, this will allow two instances of "
  4921. "<quote><literal>apt-get update</literal></quote> to run at the same time."
  4922. msgstr ""
  4923. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4924. #: apt.conf.5.xml:815
  4925. msgid "<literal>Debug::pkgAcquire</literal>"
  4926. msgstr ""
  4927. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4928. #: apt.conf.5.xml:819
  4929. msgid "Log when items are added to or removed from the global download queue."
  4930. msgstr ""
  4931. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4932. #: apt.conf.5.xml:826
  4933. msgid "<literal>Debug::pkgAcquire::Auth</literal>"
  4934. msgstr ""
  4935. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4936. #: apt.conf.5.xml:829
  4937. msgid ""
  4938. "Output status messages and errors related to verifying checksums and "
  4939. "cryptographic signatures of downloaded files."
  4940. msgstr ""
  4941. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4942. #: apt.conf.5.xml:836
  4943. msgid "<literal>Debug::pkgAcquire::Diffs</literal>"
  4944. msgstr ""
  4945. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4946. #: apt.conf.5.xml:839
  4947. msgid ""
  4948. "Output information about downloading and applying package index list diffs, "
  4949. "and errors relating to package index list diffs."
  4950. msgstr ""
  4951. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4952. #: apt.conf.5.xml:847
  4953. msgid "<literal>Debug::pkgAcquire::RRed</literal>"
  4954. msgstr ""
  4955. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4956. #: apt.conf.5.xml:851
  4957. msgid ""
  4958. "Output information related to patching apt package lists when downloading "
  4959. "index diffs instead of full indices."
  4960. msgstr ""
  4961. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4962. #: apt.conf.5.xml:858
  4963. msgid "<literal>Debug::pkgAcquire::Worker</literal>"
  4964. msgstr ""
  4965. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4966. #: apt.conf.5.xml:862
  4967. msgid "Log all interactions with the sub-processes that actually perform downloads."
  4968. msgstr ""
  4969. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4970. #: apt.conf.5.xml:869
  4971. msgid "<literal>Debug::pkgAutoRemove</literal>"
  4972. msgstr ""
  4973. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4974. #: apt.conf.5.xml:873
  4975. msgid ""
  4976. "Log events related to the automatically-installed status of packages and to "
  4977. "the removal of unused packages."
  4978. msgstr ""
  4979. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4980. #: apt.conf.5.xml:880
  4981. msgid "<literal>Debug::pkgDepCache::AutoInstall</literal>"
  4982. msgstr ""
  4983. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4984. #: apt.conf.5.xml:883
  4985. msgid ""
  4986. "Generate debug messages describing which packages are being automatically "
  4987. "installed to resolve dependencies. This corresponds to the initial "
  4988. "auto-install pass performed in, e.g., <literal>apt-get install</literal>, "
  4989. "and not to the full <literal>apt</literal> dependency resolver; see "
  4990. "<literal>Debug::pkgProblemResolver</literal> for that."
  4991. msgstr ""
  4992. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4993. #: apt.conf.5.xml:894
  4994. msgid "<literal>Debug::pkgDepCache::Marker</literal>"
  4995. msgstr ""
  4996. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4997. #: apt.conf.5.xml:897
  4998. msgid ""
  4999. "Generate debug messages describing which package is marked as "
  5000. "keep/install/remove while the ProblemResolver does his work. Each addition "
  5001. "or deletion may trigger additional actions; they are shown indented two "
  5002. "additional space under the original entry. The format for each line is "
  5003. "<literal>MarkKeep</literal>, <literal>MarkDelete</literal> or "
  5004. "<literal>MarkInstall</literal> followed by <literal>package-name &lt;a.b.c "
  5005. "-&gt; d.e.f | x.y.z&gt; (section)</literal> where <literal>a.b.c</literal> "
  5006. "is the current version of the package, <literal>d.e.f</literal> is the "
  5007. "version considered for installation and <literal>x.y.z</literal> is a newer "
  5008. "version, but not considered for installation (because of a low pin "
  5009. "score). The later two can be omitted if there is none or if it is the same "
  5010. "version as the installed. <literal>section</literal> is the name of the "
  5011. "section the package appears in."
  5012. msgstr ""
  5013. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  5014. #: apt.conf.5.xml:916
  5015. msgid "<literal>Debug::pkgInitConfig</literal>"
  5016. msgstr ""
  5017. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  5018. #: apt.conf.5.xml:919
  5019. msgid "Dump the default configuration to standard error on startup."
  5020. msgstr ""
  5021. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  5022. #: apt.conf.5.xml:926
  5023. msgid "<literal>Debug::pkgDPkgPM</literal>"
  5024. msgstr ""
  5025. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  5026. #: apt.conf.5.xml:929
  5027. msgid ""
  5028. "When invoking &dpkg;, output the precise command line with which it is being "
  5029. "invoked, with arguments separated by a single space character."
  5030. msgstr ""
  5031. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  5032. #: apt.conf.5.xml:937
  5033. msgid "<literal>Debug::pkgDPkgProgressReporting</literal>"
  5034. msgstr ""
  5035. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  5036. #: apt.conf.5.xml:940
  5037. msgid ""
  5038. "Output all the data received from &dpkg; on the status file descriptor and "
  5039. "any errors encountered while parsing it."
  5040. msgstr ""
  5041. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  5042. #: apt.conf.5.xml:947
  5043. msgid "<literal>Debug::pkgOrderList</literal>"
  5044. msgstr ""
  5045. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  5046. #: apt.conf.5.xml:951
  5047. msgid ""
  5048. "Generate a trace of the algorithm that decides the order in which "
  5049. "<literal>apt</literal> should pass packages to &dpkg;."
  5050. msgstr ""
  5051. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  5052. #: apt.conf.5.xml:959
  5053. msgid "<literal>Debug::pkgPackageManager</literal>"
  5054. msgstr ""
  5055. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  5056. #: apt.conf.5.xml:963
  5057. msgid "Output status messages tracing the steps performed when invoking &dpkg;."
  5058. msgstr ""
  5059. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  5060. #: apt.conf.5.xml:970
  5061. msgid "<literal>Debug::pkgPolicy</literal>"
  5062. msgstr ""
  5063. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  5064. #: apt.conf.5.xml:974
  5065. msgid "Output the priority of each package list on startup."
  5066. msgstr ""
  5067. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  5068. #: apt.conf.5.xml:980
  5069. msgid "<literal>Debug::pkgProblemResolver</literal>"
  5070. msgstr ""
  5071. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  5072. #: apt.conf.5.xml:984
  5073. msgid ""
  5074. "Trace the execution of the dependency resolver (this applies only to what "
  5075. "happens when a complex dependency problem is encountered)."
  5076. msgstr ""
  5077. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  5078. #: apt.conf.5.xml:992
  5079. msgid "<literal>Debug::pkgProblemResolver::ShowScores</literal>"
  5080. msgstr ""
  5081. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  5082. #: apt.conf.5.xml:995
  5083. msgid ""
  5084. "Display a list of all installed packages with their calculated score used by "
  5085. "the pkgProblemResolver. The description of the package is the same as "
  5086. "described in <literal>Debug::pkgDepCache::Marker</literal>"
  5087. msgstr ""
  5088. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  5089. #: apt.conf.5.xml:1003
  5090. msgid "<literal>Debug::sourceList</literal>"
  5091. msgstr ""
  5092. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  5093. #: apt.conf.5.xml:1007
  5094. msgid ""
  5095. "Print information about the vendors read from "
  5096. "<filename>/etc/apt/vendors.list</filename>."
  5097. msgstr ""
  5098. #. type: Content of: <refentry><refsect1><para>
  5099. #: apt.conf.5.xml:1030
  5100. msgid ""
  5101. "&configureindex; is a configuration file showing example values for all "
  5102. "possible options."
  5103. msgstr ""
  5104. #. type: Content of: <refentry><refsect1><variablelist>
  5105. #: apt.conf.5.xml:1037
  5106. msgid "&file-aptconf;"
  5107. msgstr ""
  5108. #. ? reading apt.conf
  5109. #. type: Content of: <refentry><refsect1><para>
  5110. #: apt.conf.5.xml:1042
  5111. msgid "&apt-cache;, &apt-config;, &apt-preferences;."
  5112. msgstr ""
  5113. #. The last update date
  5114. #. type: Content of: <refentry><refentryinfo>
  5115. #: apt_preferences.5.xml:13
  5116. msgid "&apt-author.team; &apt-email; &apt-product; <date>16 February 2010</date>"
  5117. msgstr ""
  5118. #. type: Content of: <refentry><refnamediv><refname>
  5119. #: apt_preferences.5.xml:21 apt_preferences.5.xml:28
  5120. msgid "apt_preferences"
  5121. msgstr ""
  5122. #. type: Content of: <refentry><refnamediv><refpurpose>
  5123. #: apt_preferences.5.xml:29
  5124. msgid "Preference control file for APT"
  5125. msgstr ""
  5126. #. type: Content of: <refentry><refsect1><para>
  5127. #: apt_preferences.5.xml:34
  5128. msgid ""
  5129. "The APT preferences file <filename>/etc/apt/preferences</filename> and the "
  5130. "fragment files in the <filename>/etc/apt/preferences.d/</filename> folder "
  5131. "can be used to control which versions of packages will be selected for "
  5132. "installation."
  5133. msgstr ""
  5134. #. type: Content of: <refentry><refsect1><para>
  5135. #: apt_preferences.5.xml:39
  5136. msgid ""
  5137. "Several versions of a package may be available for installation when the "
  5138. "&sources-list; file contains references to more than one distribution (for "
  5139. "example, <literal>stable</literal> and <literal>testing</literal>). APT "
  5140. "assigns a priority to each version that is available. Subject to dependency "
  5141. "constraints, <command>apt-get</command> selects the version with the highest "
  5142. "priority for installation. The APT preferences file overrides the "
  5143. "priorities that APT assigns to package versions by default, thus giving the "
  5144. "user control over which one is selected for installation."
  5145. msgstr ""
  5146. #. type: Content of: <refentry><refsect1><para>
  5147. #: apt_preferences.5.xml:49
  5148. msgid ""
  5149. "Several instances of the same version of a package may be available when the "
  5150. "&sources-list; file contains references to more than one source. In this "
  5151. "case <command>apt-get</command> downloads the instance listed earliest in "
  5152. "the &sources-list; file. The APT preferences file does not affect the "
  5153. "choice of instance, only the choice of version."
  5154. msgstr ""
  5155. #. type: Content of: <refentry><refsect1><para>
  5156. #: apt_preferences.5.xml:56
  5157. msgid ""
  5158. "Preferences are a strong power in the hands of a system administrator but "
  5159. "they can become also their biggest nightmare if used without care! APT will "
  5160. "not questioning the preferences so wrong settings will therefore lead to "
  5161. "uninstallable packages or wrong decisions while upgrading packages. Even "
  5162. "more problems will arise if multiply distribution releases are mixed without "
  5163. "a good understanding of the following paragraphs. You have been warned."
  5164. msgstr ""
  5165. #. type: Content of: <refentry><refsect1><para>
  5166. #: apt_preferences.5.xml:64
  5167. msgid ""
  5168. "Note that the files in the <filename>/etc/apt/preferences.d</filename> "
  5169. "directory are parsed in alphanumeric ascending order and need to obey the "
  5170. "following naming convention: The files have no or "
  5171. "\"<literal>pref</literal>\" as filename extension and which only contain "
  5172. "alphanumeric, hyphen (-), underscore (_) and period (.) characters - "
  5173. "otherwise they will be silently ignored."
  5174. msgstr ""
  5175. #. type: Content of: <refentry><refsect1><refsect2><title>
  5176. #: apt_preferences.5.xml:71
  5177. msgid "APT's Default Priority Assignments"
  5178. msgstr ""
  5179. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5180. #: apt_preferences.5.xml:86
  5181. #, no-wrap
  5182. msgid ""
  5183. "<command>apt-get install -t testing "
  5184. "<replaceable>some-package</replaceable></command>\n"
  5185. msgstr ""
  5186. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5187. #: apt_preferences.5.xml:89
  5188. #, no-wrap
  5189. msgid "APT::Default-Release \"stable\";\n"
  5190. msgstr ""
  5191. #. type: Content of: <refentry><refsect1><refsect2><para>
  5192. #: apt_preferences.5.xml:73
  5193. msgid ""
  5194. "If there is no preferences file or if there is no entry in the file that "
  5195. "applies to a particular version then the priority assigned to that version "
  5196. "is the priority of the distribution to which that version belongs. It is "
  5197. "possible to single out a distribution, \"the target release\", which "
  5198. "receives a higher priority than other distributions do by default. The "
  5199. "target release can be set on the <command>apt-get</command> command line or "
  5200. "in the APT configuration file <filename>/etc/apt/apt.conf</filename>. Note "
  5201. "that this has precedence over any general priority you set in the "
  5202. "<filename>/etc/apt/preferences</filename> file described later, but not over "
  5203. "specifically pinned packages. For example, <placeholder "
  5204. "type=\"programlisting\" id=\"0\"/> <placeholder type=\"programlisting\" "
  5205. "id=\"1\"/>"
  5206. msgstr ""
  5207. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5208. #: apt_preferences.5.xml:98
  5209. msgid "priority 100"
  5210. msgstr ""
  5211. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5212. #: apt_preferences.5.xml:99
  5213. msgid "to the version that is already installed (if any)."
  5214. msgstr ""
  5215. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5216. #: apt_preferences.5.xml:103
  5217. msgid "priority 500"
  5218. msgstr ""
  5219. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5220. #: apt_preferences.5.xml:104
  5221. msgid ""
  5222. "to the versions that are not installed and do not belong to the target "
  5223. "release."
  5224. msgstr ""
  5225. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5226. #: apt_preferences.5.xml:108
  5227. msgid "priority 990"
  5228. msgstr ""
  5229. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5230. #: apt_preferences.5.xml:109
  5231. msgid "to the versions that are not installed and belong to the target release."
  5232. msgstr ""
  5233. #. type: Content of: <refentry><refsect1><refsect2><para>
  5234. #: apt_preferences.5.xml:93
  5235. msgid ""
  5236. "If the target release has been specified then APT uses the following "
  5237. "algorithm to set the priorities of the versions of a package. Assign: "
  5238. "<placeholder type=\"variablelist\" id=\"0\"/>"
  5239. msgstr ""
  5240. #. type: Content of: <refentry><refsect1><refsect2><para>
  5241. #: apt_preferences.5.xml:114
  5242. msgid ""
  5243. "If the target release has not been specified then APT simply assigns "
  5244. "priority 100 to all installed package versions and priority 500 to all "
  5245. "uninstalled package versions."
  5246. msgstr ""
  5247. #. type: Content of: <refentry><refsect1><refsect2><para>
  5248. #: apt_preferences.5.xml:118
  5249. msgid ""
  5250. "APT then applies the following rules, listed in order of precedence, to "
  5251. "determine which version of a package to install."
  5252. msgstr ""
  5253. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5254. #: apt_preferences.5.xml:121
  5255. msgid ""
  5256. "Never downgrade unless the priority of an available version exceeds 1000. "
  5257. "(\"Downgrading\" is installing a less recent version of a package in place "
  5258. "of a more recent version. Note that none of APT's default priorities "
  5259. "exceeds 1000; such high priorities can only be set in the preferences file. "
  5260. "Note also that downgrading a package can be risky.)"
  5261. msgstr ""
  5262. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5263. #: apt_preferences.5.xml:127
  5264. msgid "Install the highest priority version."
  5265. msgstr ""
  5266. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5267. #: apt_preferences.5.xml:128
  5268. msgid ""
  5269. "If two or more versions have the same priority, install the most recent one "
  5270. "(that is, the one with the higher version number)."
  5271. msgstr ""
  5272. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5273. #: apt_preferences.5.xml:131
  5274. msgid ""
  5275. "If two or more versions have the same priority and version number but either "
  5276. "the packages differ in some of their metadata or the "
  5277. "<literal>--reinstall</literal> option is given, install the uninstalled one."
  5278. msgstr ""
  5279. #. type: Content of: <refentry><refsect1><refsect2><para>
  5280. #: apt_preferences.5.xml:137
  5281. msgid ""
  5282. "In a typical situation, the installed version of a package (priority 100) "
  5283. "is not as recent as one of the versions available from the sources listed in "
  5284. "the &sources-list; file (priority 500 or 990). Then the package will be "
  5285. "upgraded when <command>apt-get install "
  5286. "<replaceable>some-package</replaceable></command> or <command>apt-get "
  5287. "upgrade</command> is executed."
  5288. msgstr ""
  5289. #. type: Content of: <refentry><refsect1><refsect2><para>
  5290. #: apt_preferences.5.xml:144
  5291. msgid ""
  5292. "More rarely, the installed version of a package is <emphasis>more</emphasis> "
  5293. "recent than any of the other available versions. The package will not be "
  5294. "downgraded when <command>apt-get install "
  5295. "<replaceable>some-package</replaceable></command> or <command>apt-get "
  5296. "upgrade</command> is executed."
  5297. msgstr ""
  5298. #. type: Content of: <refentry><refsect1><refsect2><para>
  5299. #: apt_preferences.5.xml:149
  5300. msgid ""
  5301. "Sometimes the installed version of a package is more recent than the version "
  5302. "belonging to the target release, but not as recent as a version belonging to "
  5303. "some other distribution. Such a package will indeed be upgraded when "
  5304. "<command>apt-get install <replaceable>some-package</replaceable></command> "
  5305. "or <command>apt-get upgrade</command> is executed, because at least "
  5306. "<emphasis>one</emphasis> of the available versions has a higher priority "
  5307. "than the installed version."
  5308. msgstr ""
  5309. #. type: Content of: <refentry><refsect1><refsect2><title>
  5310. #: apt_preferences.5.xml:158
  5311. msgid "The Effect of APT Preferences"
  5312. msgstr ""
  5313. #. type: Content of: <refentry><refsect1><refsect2><para>
  5314. #: apt_preferences.5.xml:160
  5315. msgid ""
  5316. "The APT preferences file allows the system administrator to control the "
  5317. "assignment of priorities. The file consists of one or more multi-line "
  5318. "records separated by blank lines. Records can have one of two forms, a "
  5319. "specific form and a general form."
  5320. msgstr ""
  5321. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5322. #: apt_preferences.5.xml:166
  5323. msgid ""
  5324. "The specific form assigns a priority (a \"Pin-Priority\") to one or more "
  5325. "specified packages and specified version or version range. For example, the "
  5326. "following record assigns a high priority to all versions of the "
  5327. "<filename>perl</filename> package whose version number begins with "
  5328. "\"<literal>5.8</literal>\". Multiple packages can be separated by spaces."
  5329. msgstr ""
  5330. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5331. #: apt_preferences.5.xml:173
  5332. #, no-wrap
  5333. msgid ""
  5334. "Package: perl\n"
  5335. "Pin: version 5.8*\n"
  5336. "Pin-Priority: 1001\n"
  5337. msgstr ""
  5338. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5339. #: apt_preferences.5.xml:179
  5340. msgid ""
  5341. "The general form assigns a priority to all of the package versions in a "
  5342. "given distribution (that is, to all the versions of packages that are listed "
  5343. "in a certain <filename>Release</filename> file) or to all of the package "
  5344. "versions coming from a particular Internet site, as identified by the site's "
  5345. "fully qualified domain name."
  5346. msgstr ""
  5347. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5348. #: apt_preferences.5.xml:185
  5349. msgid ""
  5350. "This general-form entry in the APT preferences file applies only to groups "
  5351. "of packages. For example, the following record assigns a high priority to "
  5352. "all package versions available from the local site."
  5353. msgstr ""
  5354. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5355. #: apt_preferences.5.xml:190
  5356. #, no-wrap
  5357. msgid ""
  5358. "Package: *\n"
  5359. "Pin: origin \"\"\n"
  5360. "Pin-Priority: 999\n"
  5361. msgstr ""
  5362. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5363. #: apt_preferences.5.xml:195
  5364. msgid ""
  5365. "A note of caution: the keyword used here is \"<literal>origin</literal>\". "
  5366. "This should not be confused with the Origin of a distribution as specified "
  5367. "in a <filename>Release</filename> file. What follows the \"Origin:\" tag in "
  5368. "a <filename>Release</filename> file is not an Internet address but an author "
  5369. "or vendor name, such as \"Debian\" or \"Ximian\"."
  5370. msgstr ""
  5371. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5372. #: apt_preferences.5.xml:201
  5373. msgid ""
  5374. "The following record assigns a low priority to all package versions "
  5375. "belonging to any distribution whose Archive name is "
  5376. "\"<literal>unstable</literal>\"."
  5377. msgstr ""
  5378. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5379. #: apt_preferences.5.xml:205
  5380. #, no-wrap
  5381. msgid ""
  5382. "Package: *\n"
  5383. "Pin: release a=unstable\n"
  5384. "Pin-Priority: 50\n"
  5385. msgstr ""
  5386. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5387. #: apt_preferences.5.xml:210
  5388. msgid ""
  5389. "The following record assigns a high priority to all package versions "
  5390. "belonging to any distribution whose Codename is "
  5391. "\"<literal>squeeze</literal>\"."
  5392. msgstr ""
  5393. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5394. #: apt_preferences.5.xml:214
  5395. #, no-wrap
  5396. msgid ""
  5397. "Package: *\n"
  5398. "Pin: release n=squeeze\n"
  5399. "Pin-Priority: 900\n"
  5400. msgstr ""
  5401. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5402. #: apt_preferences.5.xml:219
  5403. msgid ""
  5404. "The following record assigns a high priority to all package versions "
  5405. "belonging to any release whose Archive name is \"<literal>stable</literal>\" "
  5406. "and whose release Version number is \"<literal>3.0</literal>\"."
  5407. msgstr ""
  5408. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5409. #: apt_preferences.5.xml:224
  5410. #, no-wrap
  5411. msgid ""
  5412. "Package: *\n"
  5413. "Pin: release a=stable, v=3.0\n"
  5414. "Pin-Priority: 500\n"
  5415. msgstr ""
  5416. #. type: Content of: <refentry><refsect1><refsect2><title>
  5417. #: apt_preferences.5.xml:235
  5418. msgid "How APT Interprets Priorities"
  5419. msgstr ""
  5420. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5421. #: apt_preferences.5.xml:243
  5422. msgid "P &gt; 1000"
  5423. msgstr ""
  5424. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5425. #: apt_preferences.5.xml:244
  5426. msgid ""
  5427. "causes a version to be installed even if this constitutes a downgrade of the "
  5428. "package"
  5429. msgstr ""
  5430. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5431. #: apt_preferences.5.xml:248
  5432. msgid "990 &lt; P &lt;=1000"
  5433. msgstr ""
  5434. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5435. #: apt_preferences.5.xml:249
  5436. msgid ""
  5437. "causes a version to be installed even if it does not come from the target "
  5438. "release, unless the installed version is more recent"
  5439. msgstr ""
  5440. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5441. #: apt_preferences.5.xml:254
  5442. msgid "500 &lt; P &lt;=990"
  5443. msgstr ""
  5444. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5445. #: apt_preferences.5.xml:255
  5446. msgid ""
  5447. "causes a version to be installed unless there is a version available "
  5448. "belonging to the target release or the installed version is more recent"
  5449. msgstr ""
  5450. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5451. #: apt_preferences.5.xml:260
  5452. msgid "100 &lt; P &lt;=500"
  5453. msgstr ""
  5454. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5455. #: apt_preferences.5.xml:261
  5456. msgid ""
  5457. "causes a version to be installed unless there is a version available "
  5458. "belonging to some other distribution or the installed version is more recent"
  5459. msgstr ""
  5460. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5461. #: apt_preferences.5.xml:266
  5462. msgid "0 &lt; P &lt;=100"
  5463. msgstr ""
  5464. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5465. #: apt_preferences.5.xml:267
  5466. msgid ""
  5467. "causes a version to be installed only if there is no installed version of "
  5468. "the package"
  5469. msgstr ""
  5470. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5471. #: apt_preferences.5.xml:271
  5472. msgid "P &lt; 0"
  5473. msgstr ""
  5474. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5475. #: apt_preferences.5.xml:272
  5476. msgid "prevents the version from being installed"
  5477. msgstr ""
  5478. #. type: Content of: <refentry><refsect1><refsect2><para>
  5479. #: apt_preferences.5.xml:238
  5480. msgid ""
  5481. "Priorities (P) assigned in the APT preferences file must be positive or "
  5482. "negative integers. They are interpreted as follows (roughly speaking): "
  5483. "<placeholder type=\"variablelist\" id=\"0\"/>"
  5484. msgstr ""
  5485. #. type: Content of: <refentry><refsect1><refsect2><para>
  5486. #: apt_preferences.5.xml:277
  5487. msgid ""
  5488. "If any specific-form records match an available package version then the "
  5489. "first such record determines the priority of the package version. Failing "
  5490. "that, if any general-form records match an available package version then "
  5491. "the first such record determines the priority of the package version."
  5492. msgstr ""
  5493. #. type: Content of: <refentry><refsect1><refsect2><para>
  5494. #: apt_preferences.5.xml:283
  5495. msgid ""
  5496. "For example, suppose the APT preferences file contains the three records "
  5497. "presented earlier:"
  5498. msgstr ""
  5499. #. type: Content of: <refentry><refsect1><refsect2><programlisting>
  5500. #: apt_preferences.5.xml:287
  5501. #, no-wrap
  5502. msgid ""
  5503. "Package: perl\n"
  5504. "Pin: version 5.8*\n"
  5505. "Pin-Priority: 1001\n"
  5506. "\n"
  5507. "Package: *\n"
  5508. "Pin: origin \"\"\n"
  5509. "Pin-Priority: 999\n"
  5510. "\n"
  5511. "Package: *\n"
  5512. "Pin: release unstable\n"
  5513. "Pin-Priority: 50\n"
  5514. msgstr ""
  5515. #. type: Content of: <refentry><refsect1><refsect2><para>
  5516. #: apt_preferences.5.xml:300
  5517. msgid "Then:"
  5518. msgstr ""
  5519. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5520. #: apt_preferences.5.xml:302
  5521. msgid ""
  5522. "The most recent available version of the <literal>perl</literal> package "
  5523. "will be installed, so long as that version's version number begins with "
  5524. "\"<literal>5.8</literal>\". If <emphasis>any</emphasis> 5.8* version of "
  5525. "<literal>perl</literal> is available and the installed version is 5.9*, then "
  5526. "<literal>perl</literal> will be downgraded."
  5527. msgstr ""
  5528. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5529. #: apt_preferences.5.xml:307
  5530. msgid ""
  5531. "A version of any package other than <literal>perl</literal> that is "
  5532. "available from the local system has priority over other versions, even "
  5533. "versions belonging to the target release."
  5534. msgstr ""
  5535. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5536. #: apt_preferences.5.xml:311
  5537. msgid ""
  5538. "A version of a package whose origin is not the local system but some other "
  5539. "site listed in &sources-list; and which belongs to an "
  5540. "<literal>unstable</literal> distribution is only installed if it is selected "
  5541. "for installation and no version of the package is already installed."
  5542. msgstr ""
  5543. #. type: Content of: <refentry><refsect1><refsect2><title>
  5544. #: apt_preferences.5.xml:321
  5545. msgid "Determination of Package Version and Distribution Properties"
  5546. msgstr ""
  5547. #. type: Content of: <refentry><refsect1><refsect2><para>
  5548. #: apt_preferences.5.xml:323
  5549. msgid ""
  5550. "The locations listed in the &sources-list; file should provide "
  5551. "<filename>Packages</filename> and <filename>Release</filename> files to "
  5552. "describe the packages available at that location."
  5553. msgstr ""
  5554. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5555. #: apt_preferences.5.xml:335
  5556. msgid "the <literal>Package:</literal> line"
  5557. msgstr ""
  5558. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5559. #: apt_preferences.5.xml:336
  5560. msgid "gives the package name"
  5561. msgstr ""
  5562. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5563. #: apt_preferences.5.xml:339 apt_preferences.5.xml:389
  5564. msgid "the <literal>Version:</literal> line"
  5565. msgstr ""
  5566. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5567. #: apt_preferences.5.xml:340
  5568. msgid "gives the version number for the named package"
  5569. msgstr ""
  5570. #. type: Content of: <refentry><refsect1><refsect2><para>
  5571. #: apt_preferences.5.xml:327
  5572. msgid ""
  5573. "The <filename>Packages</filename> file is normally found in the directory "
  5574. "<filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>: "
  5575. "for example, "
  5576. "<filename>.../dists/stable/main/binary-i386/Packages</filename>. It "
  5577. "consists of a series of multi-line records, one for each package available "
  5578. "in that directory. Only two lines in each record are relevant for setting "
  5579. "APT priorities: <placeholder type=\"variablelist\" id=\"0\"/>"
  5580. msgstr ""
  5581. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5582. #: apt_preferences.5.xml:356
  5583. msgid "the <literal>Archive:</literal> or <literal>Suite:</literal> line"
  5584. msgstr ""
  5585. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5586. #: apt_preferences.5.xml:357
  5587. msgid ""
  5588. "names the archive to which all the packages in the directory tree belong. "
  5589. "For example, the line \"Archive: stable\" or \"Suite: stable\" specifies "
  5590. "that all of the packages in the directory tree below the parent of the "
  5591. "<filename>Release</filename> file are in a <literal>stable</literal> "
  5592. "archive. Specifying this value in the APT preferences file would require "
  5593. "the line:"
  5594. msgstr ""
  5595. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5596. #: apt_preferences.5.xml:367
  5597. #, no-wrap
  5598. msgid "Pin: release a=stable\n"
  5599. msgstr ""
  5600. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5601. #: apt_preferences.5.xml:373
  5602. msgid "the <literal>Codename:</literal> line"
  5603. msgstr ""
  5604. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5605. #: apt_preferences.5.xml:374
  5606. msgid ""
  5607. "names the codename to which all the packages in the directory tree belong. "
  5608. "For example, the line \"Codename: squeeze\" specifies that all of the "
  5609. "packages in the directory tree below the parent of the "
  5610. "<filename>Release</filename> file belong to a version named "
  5611. "<literal>squeeze</literal>. Specifying this value in the APT preferences "
  5612. "file would require the line:"
  5613. msgstr ""
  5614. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5615. #: apt_preferences.5.xml:383
  5616. #, no-wrap
  5617. msgid "Pin: release n=squeeze\n"
  5618. msgstr ""
  5619. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5620. #: apt_preferences.5.xml:390
  5621. msgid ""
  5622. "names the release version. For example, the packages in the tree might "
  5623. "belong to Debian GNU/Linux release version 3.0. Note that there is normally "
  5624. "no version number for the <literal>testing</literal> and "
  5625. "<literal>unstable</literal> distributions because they have not been "
  5626. "released yet. Specifying this in the APT preferences file would require one "
  5627. "of the following lines."
  5628. msgstr ""
  5629. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5630. #: apt_preferences.5.xml:399
  5631. #, no-wrap
  5632. msgid ""
  5633. "Pin: release v=3.0\n"
  5634. "Pin: release a=stable, v=3.0\n"
  5635. "Pin: release 3.0\n"
  5636. msgstr ""
  5637. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5638. #: apt_preferences.5.xml:408
  5639. msgid "the <literal>Component:</literal> line"
  5640. msgstr ""
  5641. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5642. #: apt_preferences.5.xml:409
  5643. msgid ""
  5644. "names the licensing component associated with the packages in the directory "
  5645. "tree of the <filename>Release</filename> file. For example, the line "
  5646. "\"Component: main\" specifies that all the packages in the directory tree "
  5647. "are from the <literal>main</literal> component, which entails that they are "
  5648. "licensed under terms listed in the Debian Free Software Guidelines. "
  5649. "Specifying this component in the APT preferences file would require the "
  5650. "line:"
  5651. msgstr ""
  5652. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5653. #: apt_preferences.5.xml:418
  5654. #, no-wrap
  5655. msgid "Pin: release c=main\n"
  5656. msgstr ""
  5657. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5658. #: apt_preferences.5.xml:424
  5659. msgid "the <literal>Origin:</literal> line"
  5660. msgstr ""
  5661. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5662. #: apt_preferences.5.xml:425
  5663. msgid ""
  5664. "names the originator of the packages in the directory tree of the "
  5665. "<filename>Release</filename> file. Most commonly, this is "
  5666. "<literal>Debian</literal>. Specifying this origin in the APT preferences "
  5667. "file would require the line:"
  5668. msgstr ""
  5669. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5670. #: apt_preferences.5.xml:431
  5671. #, no-wrap
  5672. msgid "Pin: release o=Debian\n"
  5673. msgstr ""
  5674. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5675. #: apt_preferences.5.xml:437
  5676. msgid "the <literal>Label:</literal> line"
  5677. msgstr ""
  5678. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5679. #: apt_preferences.5.xml:438
  5680. msgid ""
  5681. "names the label of the packages in the directory tree of the "
  5682. "<filename>Release</filename> file. Most commonly, this is "
  5683. "<literal>Debian</literal>. Specifying this label in the APT preferences "
  5684. "file would require the line:"
  5685. msgstr ""
  5686. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5687. #: apt_preferences.5.xml:444
  5688. #, no-wrap
  5689. msgid "Pin: release l=Debian\n"
  5690. msgstr ""
  5691. #. type: Content of: <refentry><refsect1><refsect2><para>
  5692. #: apt_preferences.5.xml:345
  5693. msgid ""
  5694. "The <filename>Release</filename> file is normally found in the directory "
  5695. "<filename>.../dists/<replaceable>dist-name</replaceable></filename>: for "
  5696. "example, <filename>.../dists/stable/Release</filename>, or "
  5697. "<filename>.../dists/woody/Release</filename>. It consists of a single "
  5698. "multi-line record which applies to <emphasis>all</emphasis> of the packages "
  5699. "in the directory tree below its parent. Unlike the "
  5700. "<filename>Packages</filename> file, nearly all of the lines in a "
  5701. "<filename>Release</filename> file are relevant for setting APT priorities: "
  5702. "<placeholder type=\"variablelist\" id=\"0\"/>"
  5703. msgstr ""
  5704. #. type: Content of: <refentry><refsect1><refsect2><para>
  5705. #: apt_preferences.5.xml:451
  5706. msgid ""
  5707. "All of the <filename>Packages</filename> and <filename>Release</filename> "
  5708. "files retrieved from locations listed in the &sources-list; file are stored "
  5709. "in the directory <filename>/var/lib/apt/lists</filename>, or in the file "
  5710. "named by the variable <literal>Dir::State::Lists</literal> in the "
  5711. "<filename>apt.conf</filename> file. For example, the file "
  5712. "<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> "
  5713. "contains the <filename>Release</filename> file retrieved from the site "
  5714. "<literal>debian.lcs.mit.edu</literal> for <literal>binary-i386</literal> "
  5715. "architecture files from the <literal>contrib</literal> component of the "
  5716. "<literal>unstable</literal> distribution."
  5717. msgstr ""
  5718. #. type: Content of: <refentry><refsect1><refsect2><title>
  5719. #: apt_preferences.5.xml:464
  5720. msgid "Optional Lines in an APT Preferences Record"
  5721. msgstr ""
  5722. #. type: Content of: <refentry><refsect1><refsect2><para>
  5723. #: apt_preferences.5.xml:466
  5724. msgid ""
  5725. "Each record in the APT preferences file can optionally begin with one or "
  5726. "more lines beginning with the word <literal>Explanation:</literal>. This "
  5727. "provides a place for comments."
  5728. msgstr ""
  5729. #. type: Content of: <refentry><refsect1><refsect2><para>
  5730. #: apt_preferences.5.xml:470
  5731. msgid ""
  5732. "The <literal>Pin-Priority:</literal> line in each APT preferences record is "
  5733. "optional. If omitted, APT assigns a priority of 1 less than the last value "
  5734. "specified on a line beginning with <literal>Pin-Priority: release "
  5735. "...</literal>."
  5736. msgstr ""
  5737. #. type: Content of: <refentry><refsect1><refsect2><title>
  5738. #: apt_preferences.5.xml:479
  5739. msgid "Tracking Stable"
  5740. msgstr ""
  5741. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5742. #: apt_preferences.5.xml:487
  5743. #, no-wrap
  5744. msgid ""
  5745. "Explanation: Uninstall or do not install any Debian-originated\n"
  5746. "Explanation: package versions other than those in the stable distro\n"
  5747. "Package: *\n"
  5748. "Pin: release a=stable\n"
  5749. "Pin-Priority: 900\n"
  5750. "\n"
  5751. "Package: *\n"
  5752. "Pin: release o=Debian\n"
  5753. "Pin-Priority: -10\n"
  5754. msgstr ""
  5755. #. type: Content of: <refentry><refsect1><refsect2><para>
  5756. #: apt_preferences.5.xml:481
  5757. msgid ""
  5758. "The following APT preferences file will cause APT to assign a priority "
  5759. "higher than the default (500) to all package versions belonging to a "
  5760. "<literal>stable</literal> distribution and a prohibitively low priority to "
  5761. "package versions belonging to other <literal>Debian</literal> "
  5762. "distributions. <placeholder type=\"programlisting\" id=\"0\"/>"
  5763. msgstr ""
  5764. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5765. #: apt_preferences.5.xml:504 apt_preferences.5.xml:550 apt_preferences.5.xml:608
  5766. #, no-wrap
  5767. msgid ""
  5768. "apt-get install <replaceable>package-name</replaceable>\n"
  5769. "apt-get upgrade\n"
  5770. "apt-get dist-upgrade\n"
  5771. msgstr ""
  5772. #. type: Content of: <refentry><refsect1><refsect2><para>
  5773. #: apt_preferences.5.xml:499
  5774. msgid ""
  5775. "With a suitable &sources-list; file and the above preferences file, any of "
  5776. "the following commands will cause APT to upgrade to the latest "
  5777. "<literal>stable</literal> version(s). <placeholder type=\"programlisting\" "
  5778. "id=\"0\"/>"
  5779. msgstr ""
  5780. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5781. #: apt_preferences.5.xml:516
  5782. #, no-wrap
  5783. msgid "apt-get install <replaceable>package</replaceable>/testing\n"
  5784. msgstr ""
  5785. #. type: Content of: <refentry><refsect1><refsect2><para>
  5786. #: apt_preferences.5.xml:510
  5787. msgid ""
  5788. "The following command will cause APT to upgrade the specified package to the "
  5789. "latest version from the <literal>testing</literal> distribution; the package "
  5790. "will not be upgraded again unless this command is given again. <placeholder "
  5791. "type=\"programlisting\" id=\"0\"/>"
  5792. msgstr ""
  5793. #. type: Content of: <refentry><refsect1><refsect2><title>
  5794. #: apt_preferences.5.xml:522
  5795. msgid "Tracking Testing or Unstable"
  5796. msgstr ""
  5797. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5798. #: apt_preferences.5.xml:531
  5799. #, no-wrap
  5800. msgid ""
  5801. "Package: *\n"
  5802. "Pin: release a=testing\n"
  5803. "Pin-Priority: 900\n"
  5804. "\n"
  5805. "Package: *\n"
  5806. "Pin: release a=unstable\n"
  5807. "Pin-Priority: 800\n"
  5808. "\n"
  5809. "Package: *\n"
  5810. "Pin: release o=Debian\n"
  5811. "Pin-Priority: -10\n"
  5812. msgstr ""
  5813. #. type: Content of: <refentry><refsect1><refsect2><para>
  5814. #: apt_preferences.5.xml:524
  5815. msgid ""
  5816. "The following APT preferences file will cause APT to assign a high priority "
  5817. "to package versions from the <literal>testing</literal> distribution, a "
  5818. "lower priority to package versions from the <literal>unstable</literal> "
  5819. "distribution, and a prohibitively low priority to package versions from "
  5820. "other <literal>Debian</literal> distributions. <placeholder "
  5821. "type=\"programlisting\" id=\"0\"/>"
  5822. msgstr ""
  5823. #. type: Content of: <refentry><refsect1><refsect2><para>
  5824. #: apt_preferences.5.xml:545
  5825. msgid ""
  5826. "With a suitable &sources-list; file and the above preferences file, any of "
  5827. "the following commands will cause APT to upgrade to the latest "
  5828. "<literal>testing</literal> version(s). <placeholder type=\"programlisting\" "
  5829. "id=\"0\"/>"
  5830. msgstr ""
  5831. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5832. #: apt_preferences.5.xml:565
  5833. #, no-wrap
  5834. msgid "apt-get install <replaceable>package</replaceable>/unstable\n"
  5835. msgstr ""
  5836. #. type: Content of: <refentry><refsect1><refsect2><para>
  5837. #: apt_preferences.5.xml:556
  5838. msgid ""
  5839. "The following command will cause APT to upgrade the specified package to the "
  5840. "latest version from the <literal>unstable</literal> distribution. "
  5841. "Thereafter, <command>apt-get upgrade</command> will upgrade the package to "
  5842. "the most recent <literal>testing</literal> version if that is more recent "
  5843. "than the installed version, otherwise, to the most recent "
  5844. "<literal>unstable</literal> version if that is more recent than the "
  5845. "installed version. <placeholder type=\"programlisting\" id=\"0\"/>"
  5846. msgstr ""
  5847. #. type: Content of: <refentry><refsect1><refsect2><title>
  5848. #: apt_preferences.5.xml:572
  5849. msgid "Tracking the evolution of a codename release"
  5850. msgstr ""
  5851. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5852. #: apt_preferences.5.xml:586
  5853. #, no-wrap
  5854. msgid ""
  5855. "Explanation: Uninstall or do not install any Debian-originated package "
  5856. "versions\n"
  5857. "Explanation: other than those in the distribution codenamed with squeeze or "
  5858. "sid\n"
  5859. "Package: *\n"
  5860. "Pin: release n=squeeze\n"
  5861. "Pin-Priority: 900\n"
  5862. "\n"
  5863. "Explanation: Debian unstable is always codenamed with sid\n"
  5864. "Package: *\n"
  5865. "Pin: release a=sid\n"
  5866. "Pin-Priority: 800\n"
  5867. "\n"
  5868. "Package: *\n"
  5869. "Pin: release o=Debian\n"
  5870. "Pin-Priority: -10\n"
  5871. msgstr ""
  5872. #. type: Content of: <refentry><refsect1><refsect2><para>
  5873. #: apt_preferences.5.xml:574
  5874. msgid ""
  5875. "The following APT preferences file will cause APT to assign a priority "
  5876. "higher than the default (500) to all package versions belonging to a "
  5877. "specified codename of a distribution and a prohibitively low priority to "
  5878. "package versions belonging to other <literal>Debian</literal> distributions, "
  5879. "codenames and archives. Note that with this APT preference APT will follow "
  5880. "the migration of a release from the archive <literal>testing</literal> to "
  5881. "<literal>stable</literal> and later <literal>oldstable</literal>. If you "
  5882. "want to follow for example the progress in <literal>testing</literal> "
  5883. "notwithstanding the codename changes you should use the example "
  5884. "configurations above. <placeholder type=\"programlisting\" id=\"0\"/>"
  5885. msgstr ""
  5886. #. type: Content of: <refentry><refsect1><refsect2><para>
  5887. #: apt_preferences.5.xml:603
  5888. msgid ""
  5889. "With a suitable &sources-list; file and the above preferences file, any of "
  5890. "the following commands will cause APT to upgrade to the latest version(s) in "
  5891. "the release codenamed with <literal>squeeze</literal>. <placeholder "
  5892. "type=\"programlisting\" id=\"0\"/>"
  5893. msgstr ""
  5894. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5895. #: apt_preferences.5.xml:623
  5896. #, no-wrap
  5897. msgid "apt-get install <replaceable>package</replaceable>/sid\n"
  5898. msgstr ""
  5899. #. type: Content of: <refentry><refsect1><refsect2><para>
  5900. #: apt_preferences.5.xml:614
  5901. msgid ""
  5902. "The following command will cause APT to upgrade the specified package to the "
  5903. "latest version from the <literal>sid</literal> distribution. Thereafter, "
  5904. "<command>apt-get upgrade</command> will upgrade the package to the most "
  5905. "recent <literal>squeeze</literal> version if that is more recent than the "
  5906. "installed version, otherwise, to the most recent <literal>sid</literal> "
  5907. "version if that is more recent than the installed version. <placeholder "
  5908. "type=\"programlisting\" id=\"0\"/>"
  5909. msgstr ""
  5910. #. type: Content of: <refentry><refsect1><variablelist>
  5911. #: apt_preferences.5.xml:632
  5912. msgid "&file-preferences;"
  5913. msgstr ""
  5914. #. type: Content of: <refentry><refsect1><para>
  5915. #: apt_preferences.5.xml:638
  5916. msgid "&apt-get; &apt-cache; &apt-conf; &sources-list;"
  5917. msgstr ""
  5918. #. type: Content of: <refentry><refnamediv><refname>
  5919. #: sources.list.5.xml:22 sources.list.5.xml:29
  5920. msgid "sources.list"
  5921. msgstr ""
  5922. #. type: Content of: <refentry><refnamediv><refpurpose>
  5923. #: sources.list.5.xml:30
  5924. msgid "Package resource list for APT"
  5925. msgstr ""
  5926. #. type: Content of: <refentry><refsect1><para>
  5927. #: sources.list.5.xml:34
  5928. msgid ""
  5929. "The package resource list is used to locate archives of the package "
  5930. "distribution system in use on the system. At this time, this manual page "
  5931. "documents only the packaging system used by the Debian GNU/Linux system. "
  5932. "This control file is <filename>/etc/apt/sources.list</filename>."
  5933. msgstr ""
  5934. #. type: Content of: <refentry><refsect1><para>
  5935. #: sources.list.5.xml:39
  5936. msgid ""
  5937. "The source list is designed to support any number of active sources and a "
  5938. "variety of source media. The file lists one source per line, with the most "
  5939. "preferred source listed first. The format of each line is: <literal>type uri "
  5940. "args</literal> The first item, <literal>type</literal> determines the format "
  5941. "for <literal>args</literal>. <literal>uri</literal> is a Universal Resource "
  5942. "Identifier (URI), which is a superset of the more specific and well-known "
  5943. "Universal Resource Locator, or URL. The rest of the line can be marked as a "
  5944. "comment by using a #."
  5945. msgstr ""
  5946. #. type: Content of: <refentry><refsect1><title>
  5947. #: sources.list.5.xml:50
  5948. msgid "sources.list.d"
  5949. msgstr ""
  5950. #. type: Content of: <refentry><refsect1><para>
  5951. #: sources.list.5.xml:51
  5952. msgid ""
  5953. "The <filename>/etc/apt/sources.list.d</filename> directory provides a way to "
  5954. "add sources.list entries in separate files. The format is the same as for "
  5955. "the regular <filename>sources.list</filename> file. File names need to end "
  5956. "with <filename>.list</filename> and may only contain letters (a-z and A-Z), "
  5957. "digits (0-9), underscore (_), hyphen (-) and period (.) characters. "
  5958. "Otherwise they will be silently ignored."
  5959. msgstr ""
  5960. #. type: Content of: <refentry><refsect1><title>
  5961. #: sources.list.5.xml:60
  5962. msgid "The deb and deb-src types"
  5963. msgstr ""
  5964. #. type: Content of: <refentry><refsect1><para>
  5965. #: sources.list.5.xml:61
  5966. msgid ""
  5967. "The <literal>deb</literal> type describes a typical two-level Debian "
  5968. "archive, <filename>distribution/component</filename>. Typically, "
  5969. "<literal>distribution</literal> is generally one of "
  5970. "<literal>stable</literal> <literal>unstable</literal> or "
  5971. "<literal>testing</literal> while component is one of <literal>main</literal> "
  5972. "<literal>contrib</literal> <literal>non-free</literal> or "
  5973. "<literal>non-us</literal>. The <literal>deb-src</literal> type describes a "
  5974. "debian distribution's source code in the same form as the "
  5975. "<literal>deb</literal> type. A <literal>deb-src</literal> line is required "
  5976. "to fetch source indexes."
  5977. msgstr ""
  5978. #. type: Content of: <refentry><refsect1><para>
  5979. #: sources.list.5.xml:73
  5980. msgid ""
  5981. "The format for a <filename>sources.list</filename> entry using the "
  5982. "<literal>deb</literal> and <literal>deb-src</literal> types is:"
  5983. msgstr ""
  5984. #. type: Content of: <refentry><refsect1><literallayout>
  5985. #: sources.list.5.xml:76
  5986. #, no-wrap
  5987. msgid "deb uri distribution [component1] [component2] [...]"
  5988. msgstr ""
  5989. #. type: Content of: <refentry><refsect1><para>
  5990. #: sources.list.5.xml:78
  5991. msgid ""
  5992. "The URI for the <literal>deb</literal> type must specify the base of the "
  5993. "Debian distribution, from which APT will find the information it needs. "
  5994. "<literal>distribution</literal> can specify an exact path, in which case the "
  5995. "components must be omitted and <literal>distribution</literal> must end with "
  5996. "a slash (/). This is useful for when the case only a particular sub-section "
  5997. "of the archive denoted by the URI is of interest. If "
  5998. "<literal>distribution</literal> does not specify an exact path, at least one "
  5999. "<literal>component</literal> must be present."
  6000. msgstr ""
  6001. #. type: Content of: <refentry><refsect1><para>
  6002. #: sources.list.5.xml:87
  6003. msgid ""
  6004. "<literal>distribution</literal> may also contain a variable, "
  6005. "<literal>$(ARCH)</literal> which expands to the Debian architecture (i386, "
  6006. "m68k, powerpc, ...) used on the system. This permits "
  6007. "architecture-independent <filename>sources.list</filename> files to be "
  6008. "used. In general this is only of interest when specifying an exact path, "
  6009. "<literal>APT</literal> will automatically generate a URI with the current "
  6010. "architecture otherwise."
  6011. msgstr ""
  6012. #. type: Content of: <refentry><refsect1><para>
  6013. #: sources.list.5.xml:95
  6014. msgid ""
  6015. "Since only one distribution can be specified per line it may be necessary to "
  6016. "have multiple lines for the same URI, if a subset of all available "
  6017. "distributions or components at that location is desired. APT will sort the "
  6018. "URI list after it has generated a complete set internally, and will collapse "
  6019. "multiple references to the same Internet host, for instance, into a single "
  6020. "connection, so that it does not inefficiently establish an FTP connection, "
  6021. "close it, do something else, and then re-establish a connection to that same "
  6022. "host. This feature is useful for accessing busy FTP sites with limits on the "
  6023. "number of simultaneous anonymous users. APT also parallelizes connections to "
  6024. "different hosts to more effectively deal with sites with low bandwidth."
  6025. msgstr ""
  6026. #. type: Content of: <refentry><refsect1><para>
  6027. #: sources.list.5.xml:107
  6028. msgid ""
  6029. "It is important to list sources in order of preference, with the most "
  6030. "preferred source listed first. Typically this will result in sorting by "
  6031. "speed from fastest to slowest (CD-ROM followed by hosts on a local network, "
  6032. "followed by distant Internet hosts, for example)."
  6033. msgstr ""
  6034. #. type: Content of: <refentry><refsect1><para>
  6035. #: sources.list.5.xml:112
  6036. msgid "Some examples:"
  6037. msgstr ""
  6038. #. type: Content of: <refentry><refsect1><literallayout>
  6039. #: sources.list.5.xml:114
  6040. #, no-wrap
  6041. msgid ""
  6042. "deb http://http.us.debian.org/debian stable main contrib non-free\n"
  6043. "deb http://http.us.debian.org/debian dists/stable-updates/\n"
  6044. " "
  6045. msgstr ""
  6046. #. type: Content of: <refentry><refsect1><title>
  6047. #: sources.list.5.xml:120
  6048. msgid "URI specification"
  6049. msgstr ""
  6050. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  6051. #: sources.list.5.xml:125
  6052. msgid "file"
  6053. msgstr ""
  6054. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  6055. #: sources.list.5.xml:127
  6056. msgid ""
  6057. "The file scheme allows an arbitrary directory in the file system to be "
  6058. "considered an archive. This is useful for NFS mounts and local mirrors or "
  6059. "archives."
  6060. msgstr ""
  6061. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  6062. #: sources.list.5.xml:134
  6063. msgid ""
  6064. "The cdrom scheme allows APT to use a local CDROM drive with media "
  6065. "swapping. Use the &apt-cdrom; program to create cdrom entries in the source "
  6066. "list."
  6067. msgstr ""
  6068. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  6069. #: sources.list.5.xml:141
  6070. msgid ""
  6071. "The http scheme specifies an HTTP server for the archive. If an environment "
  6072. "variable <envar>http_proxy</envar> is set with the format "
  6073. "http://server:port/, the proxy server specified in <envar>http_proxy</envar> "
  6074. "will be used. Users of authenticated HTTP/1.1 proxies may use a string of "
  6075. "the format http://user:pass@server:port/. Note that this is an insecure "
  6076. "method of authentication."
  6077. msgstr ""
  6078. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  6079. #: sources.list.5.xml:152
  6080. msgid ""
  6081. "The ftp scheme specifies an FTP server for the archive. APT's FTP behavior "
  6082. "is highly configurable; for more information see the &apt-conf; manual "
  6083. "page. Please note that a ftp proxy can be specified by using the "
  6084. "<envar>ftp_proxy</envar> environment variable. It is possible to specify a "
  6085. "http proxy (http proxy servers often understand ftp urls) using this method "
  6086. "and ONLY this method. ftp proxies using http specified in the configuration "
  6087. "file will be ignored."
  6088. msgstr ""
  6089. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  6090. #: sources.list.5.xml:161
  6091. msgid "copy"
  6092. msgstr ""
  6093. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  6094. #: sources.list.5.xml:163
  6095. msgid ""
  6096. "The copy scheme is identical to the file scheme except that packages are "
  6097. "copied into the cache directory instead of used directly at their location. "
  6098. "This is useful for people using a zip disk to copy files around with APT."
  6099. msgstr ""
  6100. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  6101. #: sources.list.5.xml:168
  6102. msgid "rsh"
  6103. msgstr ""
  6104. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  6105. #: sources.list.5.xml:168
  6106. msgid "ssh"
  6107. msgstr ""
  6108. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  6109. #: sources.list.5.xml:170
  6110. msgid ""
  6111. "The rsh/ssh method invokes rsh/ssh to connect to a remote host as a given "
  6112. "user and access the files. It is a good idea to do prior arrangements with "
  6113. "RSA keys or rhosts. Access to files on the remote uses standard "
  6114. "<command>find</command> and <command>dd</command> commands to perform the "
  6115. "file transfers from the remote."
  6116. msgstr ""
  6117. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  6118. #: sources.list.5.xml:178
  6119. msgid "more recognizable URI types"
  6120. msgstr ""
  6121. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  6122. #: sources.list.5.xml:180
  6123. msgid ""
  6124. "APT can be extended with more methods shipped in other optional packages "
  6125. "which should follow the nameing scheme "
  6126. "<literal>apt-transport-<replaceable>method</replaceable></literal>. The APT "
  6127. "team e.g. maintains also the <literal>apt-transport-https</literal> package "
  6128. "which provides access methods for https-URIs with features similar to the "
  6129. "http method, but other methods for using e.g. debtorrent are also available, "
  6130. "see <citerefentry> "
  6131. "<refentrytitle><filename>apt-transport-debtorrent</filename></refentrytitle> "
  6132. "<manvolnum>1</manvolnum></citerefentry>."
  6133. msgstr ""
  6134. #. type: Content of: <refentry><refsect1><para>
  6135. #: sources.list.5.xml:122
  6136. msgid ""
  6137. "The currently recognized URI types are cdrom, file, http, ftp, copy, ssh, "
  6138. "rsh. <placeholder type=\"variablelist\" id=\"0\"/>"
  6139. msgstr ""
  6140. #. type: Content of: <refentry><refsect1><para>
  6141. #: sources.list.5.xml:194
  6142. msgid ""
  6143. "Uses the archive stored locally (or NFS mounted) at /home/jason/debian for "
  6144. "stable/main, stable/contrib, and stable/non-free."
  6145. msgstr ""
  6146. #. type: Content of: <refentry><refsect1><literallayout>
  6147. #: sources.list.5.xml:196
  6148. #, no-wrap
  6149. msgid "deb file:/home/jason/debian stable main contrib non-free"
  6150. msgstr ""
  6151. #. type: Content of: <refentry><refsect1><para>
  6152. #: sources.list.5.xml:198
  6153. msgid "As above, except this uses the unstable (development) distribution."
  6154. msgstr ""
  6155. #. type: Content of: <refentry><refsect1><literallayout>
  6156. #: sources.list.5.xml:199
  6157. #, no-wrap
  6158. msgid "deb file:/home/jason/debian unstable main contrib non-free"
  6159. msgstr ""
  6160. #. type: Content of: <refentry><refsect1><para>
  6161. #: sources.list.5.xml:201
  6162. msgid "Source line for the above"
  6163. msgstr ""
  6164. #. type: Content of: <refentry><refsect1><literallayout>
  6165. #: sources.list.5.xml:202
  6166. #, no-wrap
  6167. msgid "deb-src file:/home/jason/debian unstable main contrib non-free"
  6168. msgstr ""
  6169. #. type: Content of: <refentry><refsect1><para>
  6170. #: sources.list.5.xml:204
  6171. msgid ""
  6172. "Uses HTTP to access the archive at archive.debian.org, and uses only the "
  6173. "hamm/main area."
  6174. msgstr ""
  6175. #. type: Content of: <refentry><refsect1><literallayout>
  6176. #: sources.list.5.xml:206
  6177. #, no-wrap
  6178. msgid "deb http://archive.debian.org/debian-archive hamm main"
  6179. msgstr ""
  6180. #. type: Content of: <refentry><refsect1><para>
  6181. #: sources.list.5.xml:208
  6182. msgid ""
  6183. "Uses FTP to access the archive at ftp.debian.org, under the debian "
  6184. "directory, and uses only the stable/contrib area."
  6185. msgstr ""
  6186. #. type: Content of: <refentry><refsect1><literallayout>
  6187. #: sources.list.5.xml:210
  6188. #, no-wrap
  6189. msgid "deb ftp://ftp.debian.org/debian stable contrib"
  6190. msgstr ""
  6191. #. type: Content of: <refentry><refsect1><para>
  6192. #: sources.list.5.xml:212
  6193. msgid ""
  6194. "Uses FTP to access the archive at ftp.debian.org, under the debian "
  6195. "directory, and uses only the unstable/contrib area. If this line appears as "
  6196. "well as the one in the previous example in <filename>sources.list</filename> "
  6197. "a single FTP session will be used for both resource lines."
  6198. msgstr ""
  6199. #. type: Content of: <refentry><refsect1><literallayout>
  6200. #: sources.list.5.xml:216
  6201. #, no-wrap
  6202. msgid "deb ftp://ftp.debian.org/debian unstable contrib"
  6203. msgstr ""
  6204. #. type: Content of: <refentry><refsect1><para>
  6205. #: sources.list.5.xml:218
  6206. msgid ""
  6207. "Uses HTTP to access the archive at nonus.debian.org, under the debian-non-US "
  6208. "directory."
  6209. msgstr ""
  6210. #. type: Content of: <refentry><refsect1><literallayout>
  6211. #: sources.list.5.xml:220
  6212. #, no-wrap
  6213. msgid ""
  6214. "deb http://nonus.debian.org/debian-non-US stable/non-US main contrib "
  6215. "non-free"
  6216. msgstr ""
  6217. #. type: Content of: <refentry><refsect1><para><literallayout>
  6218. #: sources.list.5.xml:229
  6219. #, no-wrap
  6220. msgid "deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/"
  6221. msgstr ""
  6222. #. type: Content of: <refentry><refsect1><para>
  6223. #: sources.list.5.xml:222
  6224. msgid ""
  6225. "Uses HTTP to access the archive at nonus.debian.org, under the debian-non-US "
  6226. "directory, and uses only files found under "
  6227. "<filename>unstable/binary-i386</filename> on i386 machines, "
  6228. "<filename>unstable/binary-m68k</filename> on m68k, and so forth for other "
  6229. "supported architectures. [Note this example only illustrates how to use the "
  6230. "substitution variable; non-us is no longer structured like this] "
  6231. "<placeholder type=\"literallayout\" id=\"0\"/>"
  6232. msgstr ""
  6233. #. type: Content of: <refentry><refsect1><para>
  6234. #: sources.list.5.xml:234
  6235. msgid "&apt-cache; &apt-conf;"
  6236. msgstr ""
  6237. #. type: <title></title>
  6238. #: guide.sgml:4
  6239. msgid "APT User's Guide"
  6240. msgstr ""
  6241. #. type: <author></author>
  6242. #: guide.sgml:6 offline.sgml:6
  6243. msgid "<name>Jason Gunthorpe </name><email>jgg@debian.org</email>"
  6244. msgstr ""
  6245. #. type: <version></version>
  6246. #: guide.sgml:7
  6247. msgid "$Id: guide.sgml,v 1.7 2003/04/26 23:26:13 doogie Exp $"
  6248. msgstr ""
  6249. #. type: <abstract></abstract>
  6250. #: guide.sgml:11
  6251. msgid ""
  6252. "This document provides an overview of how to use the the APT package "
  6253. "manager."
  6254. msgstr ""
  6255. #. type: <copyrightsummary></copyrightsummary>
  6256. #: guide.sgml:15
  6257. msgid "Copyright &copy; Jason Gunthorpe, 1998."
  6258. msgstr ""
  6259. #. type: <p></p>
  6260. #: guide.sgml:21 offline.sgml:22
  6261. msgid ""
  6262. "\"APT\" and this document are free software; you can redistribute them "
  6263. "and/or modify them under the terms of the GNU General Public License as "
  6264. "published by the Free Software Foundation; either version 2 of the License, "
  6265. "or (at your option) any later version."
  6266. msgstr ""
  6267. #. type: <p></p>
  6268. #: guide.sgml:24 offline.sgml:25
  6269. msgid ""
  6270. "For more details, on Debian GNU/Linux systems, see the file "
  6271. "/usr/share/common-licenses/GPL for the full license."
  6272. msgstr ""
  6273. #. type: <heading></heading>
  6274. #: guide.sgml:32
  6275. msgid "General"
  6276. msgstr ""
  6277. #. type: <p></p>
  6278. #: guide.sgml:38
  6279. msgid ""
  6280. "The APT package currently contains two sections, the APT "
  6281. "<prgn>dselect</prgn> method and the <prgn>apt-get</prgn> command line user "
  6282. "interface. Both provide a way to install and remove packages as well as "
  6283. "download new packages from the Internet."
  6284. msgstr ""
  6285. #. type: <heading></heading>
  6286. #: guide.sgml:39
  6287. msgid "Anatomy of the Package System"
  6288. msgstr ""
  6289. #. type: <p></p>
  6290. #: guide.sgml:44
  6291. msgid ""
  6292. "The Debian packaging system has a large amount of information associated "
  6293. "with each package to help assure that it integrates cleanly and easily into "
  6294. "the system. The most prominent of its features is the dependency system."
  6295. msgstr ""
  6296. #. type: <p></p>
  6297. #: guide.sgml:52
  6298. msgid ""
  6299. "The dependency system allows individual programs to make use of shared "
  6300. "elements in the system such as libraries. It simplifies placing infrequently "
  6301. "used portions of a program in separate packages to reduce the number of "
  6302. "things the average user is required to install. Also, it allows for choices "
  6303. "in mail transport agents, X servers and so on."
  6304. msgstr ""
  6305. #. type: <p></p>
  6306. #: guide.sgml:57
  6307. msgid ""
  6308. "The first step to understanding the dependency system is to grasp the "
  6309. "concept of a simple dependency. The meaning of a simple dependency is that a "
  6310. "package requires another package to be installed at the same time to work "
  6311. "properly."
  6312. msgstr ""
  6313. #. type: <p></p>
  6314. #: guide.sgml:63
  6315. msgid ""
  6316. "For instance, mailcrypt is an emacs extension that aids in encrypting email "
  6317. "with GPG. Without GPGP installed mailcrypt is useless, so mailcrypt has a "
  6318. "simple dependency on GPG. Also, because it is an emacs extension it has a "
  6319. "simple dependency on emacs, without emacs it is completely useless."
  6320. msgstr ""
  6321. #. type: <p></p>
  6322. #: guide.sgml:73
  6323. msgid ""
  6324. "The other important dependency to understand is a conflicting dependency. It "
  6325. "means that a package, when installed with another package, will not work and "
  6326. "may possibly be extremely harmful to the system. As an example consider a "
  6327. "mail transport agent such as sendmail, exim or qmail. It is not possible to "
  6328. "have two mail transport agents installed because both need to listen to the "
  6329. "network to receive mail. Attempting to install two will seriously damage the "
  6330. "system so all mail transport agents have a conflicting dependency with all "
  6331. "other mail transport agents."
  6332. msgstr ""
  6333. #. type: <p></p>
  6334. #: guide.sgml:83
  6335. msgid ""
  6336. "As an added complication there is the possibility for a package to pretend "
  6337. "to be another package. Consider that exim and sendmail for many intents are "
  6338. "identical, they both deliver mail and understand a common interface. Hence, "
  6339. "the package system has a way for them to declare that they are both "
  6340. "mail-transport-agents. So, exim and sendmail both declare that they provide "
  6341. "a mail-transport-agent and other packages that need a mail transport agent "
  6342. "depend on mail-transport-agent. This can add a great deal of confusion when "
  6343. "trying to manually fix packages."
  6344. msgstr ""
  6345. #. type: <p></p>
  6346. #: guide.sgml:88
  6347. msgid ""
  6348. "At any given time a single dependency may be met by packages that are "
  6349. "already installed or it may not be. APT attempts to help resolve dependency "
  6350. "issues by providing a number of automatic algorithms that help in selecting "
  6351. "packages for installation."
  6352. msgstr ""
  6353. #. type: <p></p>
  6354. #: guide.sgml:102
  6355. msgid ""
  6356. "<prgn>apt-get</prgn> provides a simple way to install packages from the "
  6357. "command line. Unlike <prgn>dpkg</prgn>, <prgn>apt-get</prgn> does not "
  6358. "understand .deb files, it works with the package's proper name and can only "
  6359. "install .deb archives from a <em>Source</em>."
  6360. msgstr ""
  6361. #. type: <p></p>
  6362. #: guide.sgml:109
  6363. msgid ""
  6364. "The first <footnote><p>If you are using an http proxy server you must set "
  6365. "the http_proxy environment variable first, see "
  6366. "sources.list(5)</p></footnote> thing that should be done before using "
  6367. "<prgn>apt-get</prgn> is to fetch the package lists from the <em>Sources</em> "
  6368. "so that it knows what packages are available. This is done with <tt>apt-get "
  6369. "update</tt>. For instance,"
  6370. msgstr ""
  6371. #. type: <example></example>
  6372. #: guide.sgml:116
  6373. #, no-wrap
  6374. msgid ""
  6375. "# apt-get update\n"
  6376. "Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages\n"
  6377. "Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n"
  6378. "Reading Package Lists... Done\n"
  6379. "Building Dependency Tree... Done"
  6380. msgstr ""
  6381. #. type: <p><taglist>
  6382. #: guide.sgml:120
  6383. msgid "Once updated there are several commands that can be used:"
  6384. msgstr ""
  6385. #. type: <p></p>
  6386. #: guide.sgml:131
  6387. msgid ""
  6388. "Upgrade will attempt to gently upgrade the whole system. Upgrade will never "
  6389. "install a new package or remove an existing package, nor will it ever "
  6390. "upgrade a package that might cause some other package to break. This can be "
  6391. "used daily to relatively safely upgrade the system. Upgrade will list all of "
  6392. "the packages that it could not upgrade, this usually means that they depend "
  6393. "on new packages or conflict with some other package. <prgn>dselect</prgn> or "
  6394. "<tt>apt-get install</tt> can be used to force these packages to install."
  6395. msgstr ""
  6396. #. type: <p></p>
  6397. #: guide.sgml:140
  6398. msgid ""
  6399. "Install is used to install packages by name. The package is automatically "
  6400. "fetched and installed. This can be useful if you already know the name of "
  6401. "the package to install and do not want to go into a GUI to select it. Any "
  6402. "number of packages may be passed to install, they will all be "
  6403. "fetched. Install automatically attempts to resolve dependency problems with "
  6404. "the listed packages and will print a summary and ask for confirmation if "
  6405. "anything other than its arguments are changed."
  6406. msgstr ""
  6407. #. type: <p></p>
  6408. #: guide.sgml:149
  6409. msgid ""
  6410. "Dist-upgrade is a complete upgrader designed to simplify upgrading between "
  6411. "releases of Debian. It uses a sophisticated algorithm to determine the best "
  6412. "set of packages to install, upgrade and remove to get as much of the system "
  6413. "to the newest release. In some situations it may be desired to use "
  6414. "dist-upgrade rather than spend the time manually resolving dependencies in "
  6415. "<prgn>dselect</prgn>. Once dist-upgrade has completed then "
  6416. "<prgn>dselect</prgn> can be used to install any packages that may have been "
  6417. "left out."
  6418. msgstr ""
  6419. #. type: <p></p>
  6420. #: guide.sgml:152
  6421. msgid ""
  6422. "It is important to closely look at what dist-upgrade is going to do, its "
  6423. "decisions may sometimes be quite surprising."
  6424. msgstr ""
  6425. #. type: <p></p>
  6426. #: guide.sgml:163
  6427. msgid ""
  6428. "<prgn>apt-get</prgn> has several command line options that are detailed in "
  6429. "its man page, <manref section=\"8\" name=\"apt-get\">. The most useful "
  6430. "option is <tt>-d</tt> which does not install the fetched files. If the "
  6431. "system has to download a large number of package it would be undesired to "
  6432. "start installing them in case something goes wrong. When <tt>-d</tt> is used "
  6433. "the downloaded archives can be installed by simply running the command that "
  6434. "caused them to be downloaded again without <tt>-d</tt>."
  6435. msgstr ""
  6436. #. type: <heading></heading>
  6437. #: guide.sgml:168
  6438. msgid "DSelect"
  6439. msgstr ""
  6440. #. type: <p></p>
  6441. #: guide.sgml:173
  6442. msgid ""
  6443. "The APT <prgn>dselect</prgn> method provides the complete APT system with "
  6444. "the <prgn>dselect</prgn> package selection GUI. <prgn>dselect</prgn> is used "
  6445. "to select the packages to be installed or removed and APT actually installs "
  6446. "them."
  6447. msgstr ""
  6448. #. type: <p></p>
  6449. #: guide.sgml:184
  6450. msgid ""
  6451. "To enable the APT method you need to select [A]ccess in <prgn>dselect</prgn> "
  6452. "and then choose the APT method. You will be prompted for a set of "
  6453. "<em>Sources</em> which are places to fetch archives from. These can be "
  6454. "remote Internet sites, local Debian mirrors or CDROMs. Each source can "
  6455. "provide a fragment of the total Debian archive, APT will automatically "
  6456. "combine them to form a complete set of packages. If you have a CDROM then it "
  6457. "is a good idea to specify it first and then specify a mirror so that you "
  6458. "have access to the latest bug fixes. APT will automatically use packages on "
  6459. "your CDROM before downloading from the Internet."
  6460. msgstr ""
  6461. #. type: <example></example>
  6462. #: guide.sgml:198
  6463. #, no-wrap
  6464. msgid ""
  6465. " Set up a list of distribution source locations\n"
  6466. "\t \n"
  6467. " Please give the base URL of the debian distribution.\n"
  6468. " The access schemes I know about are: http file\n"
  6469. "\t \n"
  6470. " For example:\n"
  6471. " file:/mnt/debian,\n"
  6472. " ftp://ftp.debian.org/debian,\n"
  6473. " http://ftp.de.debian.org/debian,\n"
  6474. " \n"
  6475. " \n"
  6476. " URL [http://llug.sep.bnl.gov/debian]:"
  6477. msgstr ""
  6478. #. type: <p></p>
  6479. #: guide.sgml:205
  6480. msgid ""
  6481. "The <em>Sources</em> setup starts by asking for the base of the Debian "
  6482. "archive, defaulting to a HTTP mirror. Next it asks for the distribution to "
  6483. "get."
  6484. msgstr ""
  6485. #. type: <example></example>
  6486. #: guide.sgml:212
  6487. #, no-wrap
  6488. msgid ""
  6489. " Please give the distribution tag to get or a path to the\n"
  6490. " package file ending in a /. The distribution\n"
  6491. " tags are typically something like: stable unstable testing non-US\n"
  6492. " \n"
  6493. " Distribution [stable]:"
  6494. msgstr ""
  6495. #. type: <p></p>
  6496. #: guide.sgml:222
  6497. msgid ""
  6498. "The distribution refers to the Debian version in the archive, "
  6499. "<em>stable</em> refers to the latest released version and <em>unstable</em> "
  6500. "refers to the developmental version. <em>non-US</em> is only available on "
  6501. "some mirrors and refers to packages that contain encryption technology or "
  6502. "other things that cannot be exported from the United States. Importing these "
  6503. "packages into the US is legal however."
  6504. msgstr ""
  6505. #. type: <example></example>
  6506. #: guide.sgml:228
  6507. #, no-wrap
  6508. msgid ""
  6509. " Please give the components to get\n"
  6510. " The components are typically something like: main contrib non-free\n"
  6511. " \n"
  6512. " Components [main contrib non-free]:"
  6513. msgstr ""
  6514. #. type: <p></p>
  6515. #: guide.sgml:236
  6516. msgid ""
  6517. "The components list refers to the list of sub distributions to fetch. The "
  6518. "distribution is split up based on software licenses, main being DFSG free "
  6519. "packages while contrib and non-free contain things that have various "
  6520. "restrictions placed on their use and distribution."
  6521. msgstr ""
  6522. #. type: <p></p>
  6523. #: guide.sgml:240
  6524. msgid ""
  6525. "Any number of sources can be added, the setup script will continue to prompt "
  6526. "until you have specified all that you want."
  6527. msgstr ""
  6528. #. type: <p></p>
  6529. #: guide.sgml:247
  6530. msgid ""
  6531. "Before starting to use <prgn>dselect</prgn> it is necessary to update the "
  6532. "available list by selecting [U]pdate from the menu. This is a superset of "
  6533. "<tt>apt-get update</tt> that makes the fetched information available to "
  6534. "<prgn>dselect</prgn>. [U]pdate must be performed even if <tt>apt-get "
  6535. "update</tt> has been run before."
  6536. msgstr ""
  6537. #. type: <p></p>
  6538. #: guide.sgml:253
  6539. msgid ""
  6540. "You can then go on and make your selections using [S]elect and then perform "
  6541. "the installation using [I]nstall. When using the APT method the [C]onfig and "
  6542. "[R]emove commands have no meaning, the [I]nstall command performs both of "
  6543. "them together."
  6544. msgstr ""
  6545. #. type: <p></p>
  6546. #: guide.sgml:258
  6547. msgid ""
  6548. "By default APT will automatically remove the package (.deb) files once they "
  6549. "have been successfully installed. To change this behavior place "
  6550. "<tt>Dselect::clean \"prompt\";</tt> in /etc/apt/apt.conf."
  6551. msgstr ""
  6552. #. type: <heading></heading>
  6553. #: guide.sgml:264
  6554. msgid "The Interface"
  6555. msgstr ""
  6556. #. type: <p></p>
  6557. #: guide.sgml:278
  6558. msgid ""
  6559. "Both that APT <prgn>dselect</prgn> method and <prgn>apt-get</prgn> share the "
  6560. "same interface. It is a simple system that generally tells you what it will "
  6561. "do and then goes and does it. <footnote><p>The <prgn>dselect</prgn> method "
  6562. "actually is a set of wrapper scripts to <prgn>apt-get</prgn>. The method "
  6563. "actually provides more functionality than is present in <prgn>apt-get</prgn> "
  6564. "alone.</p></footnote> After printing out a summary of what will happen APT "
  6565. "then will print out some informative status messages so that you can "
  6566. "estimate how far along it is and how much is left to do."
  6567. msgstr ""
  6568. #. type: <heading></heading>
  6569. #: guide.sgml:280
  6570. msgid "Startup"
  6571. msgstr ""
  6572. #. type: <p></p>
  6573. #: guide.sgml:284
  6574. msgid ""
  6575. "Before all operations except update, APT performs a number of actions to "
  6576. "prepare its internal state. It also does some checks of the system's "
  6577. "state. At any time these operations can be performed by running <tt>apt-get "
  6578. "check</tt>."
  6579. msgstr ""
  6580. #. type: <example></example>
  6581. #: guide.sgml:289
  6582. #, no-wrap
  6583. msgid ""
  6584. "# apt-get check\n"
  6585. "Reading Package Lists... Done\n"
  6586. "Building Dependency Tree... Done"
  6587. msgstr ""
  6588. #. type: <p></p>
  6589. #: guide.sgml:297
  6590. msgid ""
  6591. "The first thing it does is read all the package files into memory. APT uses "
  6592. "a caching scheme so this operation will be faster the second time it is "
  6593. "run. If some of the package files are not found then they will be ignored "
  6594. "and a warning will be printed when apt-get exits."
  6595. msgstr ""
  6596. #. type: <p></p>
  6597. #: guide.sgml:303
  6598. msgid ""
  6599. "The final operation performs a detailed analysis of the system's "
  6600. "dependencies. It checks every dependency of every installed or unpacked "
  6601. "package and considers if it is OK. Should this find a problem then a report "
  6602. "will be printed out and <prgn>apt-get</prgn> will refuse to run."
  6603. msgstr ""
  6604. #. type: <example></example>
  6605. #: guide.sgml:320
  6606. #, no-wrap
  6607. msgid ""
  6608. "# apt-get check\n"
  6609. "Reading Package Lists... Done\n"
  6610. "Building Dependency Tree... Done\n"
  6611. "You might want to run apt-get -f install' to correct these.\n"
  6612. "Sorry, but the following packages have unmet dependencies:\n"
  6613. " 9fonts: Depends: xlib6g but it is not installed\n"
  6614. " uucp: Depends: mailx but it is not installed\n"
  6615. " blast: Depends: xlib6g (>= 3.3-5) but it is not installed\n"
  6616. " adduser: Depends: perl-base but it is not installed\n"
  6617. " aumix: Depends: libgpmg1 but it is not installed\n"
  6618. " debiandoc-sgml: Depends: sgml-base but it is not installed\n"
  6619. " bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed\n"
  6620. " cthugha: Depends: svgalibg1 but it is not installed\n"
  6621. " Depends: xlib6g (>= 3.3-5) but it is not installed\n"
  6622. " libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1)"
  6623. msgstr ""
  6624. #. type: <p></p>
  6625. #: guide.sgml:329
  6626. msgid ""
  6627. "In this example the system has many problems, including a serious problem "
  6628. "with libreadlineg2. For each package that has unmet dependencies a line is "
  6629. "printed out indicating the package with the problem and the dependencies "
  6630. "that are unmet. A short explanation of why the package has a dependency "
  6631. "problem is also included."
  6632. msgstr ""
  6633. #. type: <p></p>
  6634. #: guide.sgml:337
  6635. msgid ""
  6636. "There are two ways a system can get into a broken state like this. The first "
  6637. "is caused by <prgn>dpkg</prgn> missing some subtle relationships between "
  6638. "packages when performing upgrades. <footnote><p>APT however considers all "
  6639. "known dependencies and attempts to prevent broken "
  6640. "packages</p></footnote>. The second is if a package installation fails "
  6641. "during an operation. In this situation a package may have been unpacked "
  6642. "without its dependents being installed."
  6643. msgstr ""
  6644. #. type: <p></p>
  6645. #: guide.sgml:345
  6646. msgid ""
  6647. "The second situation is much less serious than the first because APT places "
  6648. "certain constraints on the order that packages are installed. In both cases "
  6649. "supplying the <tt>-f</tt> option to <prgn>apt-get</prgn> will cause APT to "
  6650. "deduce a possible solution to the problem and then continue on. The APT "
  6651. "<prgn>dselect</prgn> method always supplies the <tt>-f</tt> option to allow "
  6652. "for easy continuation of failed maintainer scripts."
  6653. msgstr ""
  6654. #. type: <p></p>
  6655. #: guide.sgml:351
  6656. msgid ""
  6657. "However, if the <tt>-f</tt> option is used to correct a seriously broken "
  6658. "system caused by the first case then it is possible that it will either fail "
  6659. "immediately or the installation sequence will fail. In either case it is "
  6660. "necessary to manually use dpkg (possibly with forcing options) to correct "
  6661. "the situation enough to allow APT to proceed."
  6662. msgstr ""
  6663. #. type: <heading></heading>
  6664. #: guide.sgml:356
  6665. msgid "The Status Report"
  6666. msgstr ""
  6667. #. type: <p></p>
  6668. #: guide.sgml:363
  6669. msgid ""
  6670. "Before proceeding <prgn>apt-get</prgn> will present a report on what will "
  6671. "happen. Generally the report reflects the type of operation being performed "
  6672. "but there are several common elements. In all cases the lists reflect the "
  6673. "final state of things, taking into account the <tt>-f</tt> option and any "
  6674. "other relevant activities to the command being executed."
  6675. msgstr ""
  6676. #. type: <heading></heading>
  6677. #: guide.sgml:364
  6678. msgid "The Extra Package list"
  6679. msgstr ""
  6680. #. type: <example></example>
  6681. #: guide.sgml:372
  6682. #, no-wrap
  6683. msgid ""
  6684. "The following extra packages will be installed:\n"
  6685. " libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl\n"
  6686. " mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base\n"
  6687. " bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy\n"
  6688. " squake pgp-i python-base debmake ldso perl libreadlineg2\n"
  6689. " ssh"
  6690. msgstr ""
  6691. #. type: <p></p>
  6692. #: guide.sgml:379
  6693. msgid ""
  6694. "The Extra Package list shows all of the packages that will be installed or "
  6695. "upgraded in excess of the ones mentioned on the command line. It is only "
  6696. "generated for an <tt>install</tt> command. The listed packages are often the "
  6697. "result of an Auto Install."
  6698. msgstr ""
  6699. #. type: <heading></heading>
  6700. #: guide.sgml:382
  6701. msgid "The Packages to Remove"
  6702. msgstr ""
  6703. #. type: <example></example>
  6704. #: guide.sgml:389
  6705. #, no-wrap
  6706. msgid ""
  6707. "The following packages will be REMOVED:\n"
  6708. " xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix\n"
  6709. " xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel\n"
  6710. " xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid\n"
  6711. " nas xpilot xfig"
  6712. msgstr ""
  6713. #. type: <p></p>
  6714. #: guide.sgml:399
  6715. msgid ""
  6716. "The Packages to Remove list shows all of the packages that will be removed "
  6717. "from the system. It can be shown for any of the operations and should be "
  6718. "given a careful inspection to ensure nothing important is to be taken "
  6719. "off. The <tt>-f</tt> option is especially good at generating packages to "
  6720. "remove so extreme care should be used in that case. The list may contain "
  6721. "packages that are going to be removed because they are only partially "
  6722. "installed, possibly due to an aborted installation."
  6723. msgstr ""
  6724. #. type: <heading></heading>
  6725. #: guide.sgml:402
  6726. msgid "The New Packages list"
  6727. msgstr ""
  6728. #. type: <example></example>
  6729. #: guide.sgml:406
  6730. #, no-wrap
  6731. msgid ""
  6732. "The following NEW packages will installed:\n"
  6733. " zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base"
  6734. msgstr ""
  6735. #. type: <p></p>
  6736. #: guide.sgml:411
  6737. msgid ""
  6738. "The New Packages list is simply a reminder of what will happen. The packages "
  6739. "listed are not presently installed in the system but will be when APT is "
  6740. "done."
  6741. msgstr ""
  6742. #. type: <heading></heading>
  6743. #: guide.sgml:414
  6744. msgid "The Kept Back list"
  6745. msgstr ""
  6746. #. type: <example></example>
  6747. #: guide.sgml:419
  6748. #, no-wrap
  6749. msgid ""
  6750. "The following packages have been kept back\n"
  6751. " compface man-db tetex-base msql libpaper svgalib1\n"
  6752. " gs snmp arena lynx xpat2 groff xscreensaver"
  6753. msgstr ""
  6754. #. type: <p></p>
  6755. #: guide.sgml:428
  6756. msgid ""
  6757. "Whenever the whole system is being upgraded there is the possibility that "
  6758. "new versions of packages cannot be installed because they require new things "
  6759. "or conflict with already installed things. In this case the package will "
  6760. "appear in the Kept Back list. The best way to convince packages listed there "
  6761. "to install is with <tt>apt-get install</tt> or by using <prgn>dselect</prgn> "
  6762. "to resolve their problems."
  6763. msgstr ""
  6764. #. type: <heading></heading>
  6765. #: guide.sgml:431
  6766. msgid "Held Packages warning"
  6767. msgstr ""
  6768. #. type: <example></example>
  6769. #: guide.sgml:435
  6770. #, no-wrap
  6771. msgid ""
  6772. "The following held packages will be changed:\n"
  6773. " cvs"
  6774. msgstr ""
  6775. #. type: <p></p>
  6776. #: guide.sgml:441
  6777. msgid ""
  6778. "Sometimes you can ask APT to install a package that is on hold, in such a "
  6779. "case it prints out a warning that the held package is going to be "
  6780. "changed. This should only happen during dist-upgrade or install."
  6781. msgstr ""
  6782. #. type: <heading></heading>
  6783. #: guide.sgml:444
  6784. msgid "Final summary"
  6785. msgstr ""
  6786. #. type: <p></p>
  6787. #: guide.sgml:447
  6788. msgid "Finally, APT will print out a summary of all the changes that will occur."
  6789. msgstr ""
  6790. #. type: <example></example>
  6791. #: guide.sgml:452
  6792. #, no-wrap
  6793. msgid ""
  6794. "206 packages upgraded, 8 newly installed, 23 to remove and 51 not "
  6795. "upgraded.\n"
  6796. "12 packages not fully installed or removed.\n"
  6797. "Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used."
  6798. msgstr ""
  6799. #. type: <p></p>
  6800. #: guide.sgml:470
  6801. msgid ""
  6802. "The first line of the summary simply is a reduced version of all of the "
  6803. "lists and includes the number of upgrades - that is packages already "
  6804. "installed that have new versions available. The second line indicates the "
  6805. "number of poorly configured packages, possibly the result of an aborted "
  6806. "installation. The final line shows the space requirements that the "
  6807. "installation needs. The first pair of numbers refer to the size of the "
  6808. "archive files. The first number indicates the number of bytes that must be "
  6809. "fetched from remote locations and the second indicates the total size of all "
  6810. "the archives required. The next number indicates the size difference between "
  6811. "the presently installed packages and the newly installed packages. It is "
  6812. "roughly equivalent to the space required in /usr after everything is "
  6813. "done. If a large number of packages are being removed then the value may "
  6814. "indicate the amount of space that will be freed."
  6815. msgstr ""
  6816. #. type: <p></p>
  6817. #: guide.sgml:473
  6818. msgid ""
  6819. "Some other reports can be generated by using the -u option to show packages "
  6820. "to upgrade, they are similar to the previous examples."
  6821. msgstr ""
  6822. #. type: <heading></heading>
  6823. #: guide.sgml:477
  6824. msgid "The Status Display"
  6825. msgstr ""
  6826. #. type: <p></p>
  6827. #: guide.sgml:481
  6828. msgid ""
  6829. "During the download of archives and package files APT prints out a series of "
  6830. "status messages."
  6831. msgstr ""
  6832. #. type: <example></example>
  6833. #: guide.sgml:490
  6834. #, no-wrap
  6835. msgid ""
  6836. "# apt-get update\n"
  6837. "Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages\n"
  6838. "Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n"
  6839. "Hit http://llug.sep.bnl.gov/debian/ testing/main Packages\n"
  6840. "Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ "
  6841. "Packages\n"
  6842. "Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages\n"
  6843. "11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s"
  6844. msgstr ""
  6845. #. type: <p></p>
  6846. #: guide.sgml:500
  6847. msgid ""
  6848. "The lines starting with <em>Get</em> are printed out when APT begins to "
  6849. "fetch a file while the last line indicates the progress of the download. The "
  6850. "first percent value on the progress line indicates the total percent done of "
  6851. "all files. Unfortunately since the size of the Package files is unknown "
  6852. "<tt>apt-get update</tt> estimates the percent done which causes some "
  6853. "inaccuracies."
  6854. msgstr ""
  6855. #. type: <p></p>
  6856. #: guide.sgml:509
  6857. msgid ""
  6858. "The next section of the status line is repeated once for each download "
  6859. "thread and indicates the operation being performed and some useful "
  6860. "information about what is happening. Sometimes this section will simply read "
  6861. "<em>Forking</em> which means the OS is loading the download module. The "
  6862. "first word after the [ is the fetch number as shown on the history "
  6863. "lines. The next word is the short form name of the object being "
  6864. "downloaded. For archives it will contain the name of the package that is "
  6865. "being fetched."
  6866. msgstr ""
  6867. #. type: <p></p>
  6868. #: guide.sgml:524
  6869. msgid ""
  6870. "Inside of the single quote is an informative string indicating the progress "
  6871. "of the negotiation phase of the download. Typically it progresses from "
  6872. "<em>Connecting</em> to <em>Waiting for file</em> to <em>Downloading</em> or "
  6873. "<em>Resuming</em>. The final value is the number of bytes downloaded from "
  6874. "the remote site. Once the download begins this is represented as "
  6875. "<tt>102/10.2k</tt> indicating that 102 bytes have been fetched and 10.2 "
  6876. "kilobytes is expected. The total size is always shown in 4 figure notation "
  6877. "to preserve space. After the size display is a percent meter for the file "
  6878. "itself. The second last element is the instantaneous average speed. This "
  6879. "values is updated every 5 seconds and reflects the rate of data transfer for "
  6880. "that period. Finally is shown the estimated transfer time. This is updated "
  6881. "regularly and reflects the time to complete everything at the shown transfer "
  6882. "rate."
  6883. msgstr ""
  6884. #. type: <p></p>
  6885. #: guide.sgml:530
  6886. msgid ""
  6887. "The status display updates every half second to provide a constant feedback "
  6888. "on the download progress while the Get lines scroll back whenever a new file "
  6889. "is started. Since the status display is constantly updated it is unsuitable "
  6890. "for logging to a file, use the <tt>-q</tt> option to remove the status "
  6891. "display."
  6892. msgstr ""
  6893. #. type: <heading></heading>
  6894. #: guide.sgml:535
  6895. msgid "Dpkg"
  6896. msgstr ""
  6897. #. type: <p></p>
  6898. #: guide.sgml:542
  6899. msgid ""
  6900. "APT uses <prgn>dpkg</prgn> for installing the archives and will switch over "
  6901. "to the <prgn>dpkg</prgn> interface once downloading is "
  6902. "completed. <prgn>dpkg</prgn> will also ask a number of questions as it "
  6903. "processes the packages and the packages themselves may also ask several "
  6904. "questions. Before each question there is usually a description of what it is "
  6905. "asking and the questions are too varied to discuss completely here."
  6906. msgstr ""
  6907. #. type: <title></title>
  6908. #: offline.sgml:4
  6909. msgid "Using APT Offline"
  6910. msgstr ""
  6911. #. type: <version></version>
  6912. #: offline.sgml:7
  6913. msgid "$Id: offline.sgml,v 1.8 2003/02/12 15:06:41 doogie Exp $"
  6914. msgstr ""
  6915. #. type: <abstract></abstract>
  6916. #: offline.sgml:12
  6917. msgid ""
  6918. "This document describes how to use APT in a non-networked environment, "
  6919. "specifically a 'sneaker-net' approach for performing upgrades."
  6920. msgstr ""
  6921. #. type: <copyrightsummary></copyrightsummary>
  6922. #: offline.sgml:16
  6923. msgid "Copyright &copy; Jason Gunthorpe, 1999."
  6924. msgstr ""
  6925. #. type: <heading></heading>
  6926. #: offline.sgml:32
  6927. msgid "Introduction"
  6928. msgstr ""
  6929. #. type: <heading></heading>
  6930. #: offline.sgml:34 offline.sgml:65 offline.sgml:180
  6931. msgid "Overview"
  6932. msgstr ""
  6933. #. type: <p></p>
  6934. #: offline.sgml:40
  6935. msgid ""
  6936. "Normally APT requires direct access to a Debian archive, either from a local "
  6937. "media or through a network. Another common complaint is that a Debian "
  6938. "machine is on a slow link, such as a modem and another machine has a very "
  6939. "fast connection but they are physically distant."
  6940. msgstr ""
  6941. #. type: <p></p>
  6942. #: offline.sgml:51
  6943. msgid ""
  6944. "The solution to this is to use large removable media such as a Zip disc or a "
  6945. "SuperDisk disc. These discs are not large enough to store the entire Debian "
  6946. "archive but can easily fit a subset large enough for most users. The idea is "
  6947. "to use APT to generate a list of packages that are required and then fetch "
  6948. "them onto the disc using another machine with good connectivity. It is even "
  6949. "possible to use another Debian machine with APT or to use a completely "
  6950. "different OS and a download tool like wget. Let <em>remote host</em> mean "
  6951. "the machine downloading the packages, and <em>target host</em> the one with "
  6952. "bad or no connection."
  6953. msgstr ""
  6954. #. type: <p></p>
  6955. #: offline.sgml:57
  6956. msgid ""
  6957. "This is achieved by creatively manipulating the APT configuration file. The "
  6958. "essential premise to tell APT to look on a disc for it's archive files. Note "
  6959. "that the disc should be formated with a filesystem that can handle long file "
  6960. "names such as ext2, fat32 or vfat."
  6961. msgstr ""
  6962. #. type: <heading></heading>
  6963. #: offline.sgml:63
  6964. msgid "Using APT on both machines"
  6965. msgstr ""
  6966. #. type: <p><example>
  6967. #: offline.sgml:71
  6968. msgid ""
  6969. "APT being available on both machines gives the simplest configuration. The "
  6970. "basic idea is to place a copy of the status file on the disc and use the "
  6971. "remote machine to fetch the latest package files and decide which packages "
  6972. "to download. The disk directory structure should look like:"
  6973. msgstr ""
  6974. #. type: <example></example>
  6975. #: offline.sgml:80
  6976. #, no-wrap
  6977. msgid ""
  6978. " /disc/\n"
  6979. " archives/\n"
  6980. " partial/\n"
  6981. " lists/\n"
  6982. " partial/\n"
  6983. " status\n"
  6984. " sources.list\n"
  6985. " apt.conf"
  6986. msgstr ""
  6987. #. type: <heading></heading>
  6988. #: offline.sgml:88
  6989. msgid "The configuration file"
  6990. msgstr ""
  6991. #. type: <p></p>
  6992. #: offline.sgml:96
  6993. msgid ""
  6994. "The configuration file should tell APT to store its files on the disc and to "
  6995. "use the configuration files on the disc as well. The sources.list should "
  6996. "contain the proper sites that you wish to use from the remote machine, and "
  6997. "the status file should be a copy of <em>/var/lib/dpkg/status</em> from the "
  6998. "<em>target host</em>. Please note, if you are using a local archive you must "
  6999. "use copy URIs, the syntax is identical to file URIs."
  7000. msgstr ""
  7001. #. type: <p><example>
  7002. #: offline.sgml:100
  7003. msgid ""
  7004. "<em>apt.conf</em> must contain the necessary information to make APT use the "
  7005. "disc:"
  7006. msgstr ""
  7007. #. type: <example></example>
  7008. #: offline.sgml:124
  7009. #, no-wrap
  7010. msgid ""
  7011. " APT\n"
  7012. " {\n"
  7013. " /* This is not necessary if the two machines are the same arch, it "
  7014. "tells\n"
  7015. " the remote APT what architecture the target machine is */\n"
  7016. " Architecture \"i386\";\n"
  7017. " \n"
  7018. " Get::Download-Only \"true\";\n"
  7019. " };\n"
  7020. " \n"
  7021. " Dir\n"
  7022. " {\n"
  7023. " /* Use the disc for state information and redirect the status file from\n"
  7024. " the /var/lib/dpkg default */\n"
  7025. " State \"/disc/\";\n"
  7026. " State::status \"status\";\n"
  7027. "\n"
  7028. " // Binary caches will be stored locally\n"
  7029. " Cache::archives \"/disc/archives/\";\n"
  7030. " Cache \"/tmp/\";\n"
  7031. " \n"
  7032. " // Location of the source list.\n"
  7033. " Etc \"/disc/\";\n"
  7034. " };"
  7035. msgstr ""
  7036. #. type: </example></p>
  7037. #: offline.sgml:129
  7038. msgid ""
  7039. "More details can be seen by examining the apt.conf man page and the sample "
  7040. "configuration file in <em>/usr/share/doc/apt/examples/apt.conf</em>."
  7041. msgstr ""
  7042. #. type: <p><example>
  7043. #: offline.sgml:136
  7044. msgid ""
  7045. "On the target machine the first thing to do is mount the disc and copy "
  7046. "<em>/var/lib/dpkg/status</em> to it. You will also need to create the "
  7047. "directories outlined in the Overview, <em>archives/partial/</em> and "
  7048. "<em>lists/partial/</em>. Then take the disc to the remote machine and "
  7049. "configure the sources.list. On the remote machine execute the following:"
  7050. msgstr ""
  7051. #. type: <example></example>
  7052. #: offline.sgml:142
  7053. #, no-wrap
  7054. msgid ""
  7055. " # export APT_CONFIG=\"/disc/apt.conf\"\n"
  7056. " # apt-get update\n"
  7057. " [ APT fetches the package files ]\n"
  7058. " # apt-get dist-upgrade\n"
  7059. " [ APT fetches all the packages needed to upgrade the target machine ]"
  7060. msgstr ""
  7061. #. type: </example></p>
  7062. #: offline.sgml:149
  7063. msgid ""
  7064. "The dist-upgrade command can be replaced with any other standard APT "
  7065. "commands, particularly dselect-upgrade. You can even use an APT front end "
  7066. "such as <em>dselect</em>. However this presents a problem in communicating "
  7067. "your selections back to the local computer."
  7068. msgstr ""
  7069. #. type: <p><example>
  7070. #: offline.sgml:153
  7071. msgid ""
  7072. "Now the disc contains all of the index files and archives needed to upgrade "
  7073. "the target machine. Take the disc back and run:"
  7074. msgstr ""
  7075. #. type: <example></example>
  7076. #: offline.sgml:159
  7077. #, no-wrap
  7078. msgid ""
  7079. " # export APT_CONFIG=\"/disc/apt.conf\"\n"
  7080. " # apt-get check\n"
  7081. " [ APT generates a local copy of the cache files ]\n"
  7082. " # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade\n"
  7083. " [ Or any other APT command ]"
  7084. msgstr ""
  7085. #. type: <p></p>
  7086. #: offline.sgml:165
  7087. msgid ""
  7088. "It is necessary for proper function to re-specify the status file to be the "
  7089. "local one. This is very important!"
  7090. msgstr ""
  7091. #. type: <p></p>
  7092. #: offline.sgml:172
  7093. msgid ""
  7094. "If you are using dselect you can do the very risky operation of copying "
  7095. "disc/status to /var/lib/dpkg/status so that any selections you made on the "
  7096. "remote machine are updated. I highly recommend that people only make "
  7097. "selections on the local machine - but this may not always be possible. DO "
  7098. "NOT copy the status file if dpkg or APT have been run in the mean time!!"
  7099. msgstr ""
  7100. #. type: <heading></heading>
  7101. #: offline.sgml:178
  7102. msgid "Using APT and wget"
  7103. msgstr ""
  7104. #. type: <p></p>
  7105. #: offline.sgml:185
  7106. msgid ""
  7107. "<em>wget</em> is a popular and portable download tool that can run on nearly "
  7108. "any machine. Unlike the method above this requires that the Debian machine "
  7109. "already has a list of available packages."
  7110. msgstr ""
  7111. #. type: <p></p>
  7112. #: offline.sgml:190
  7113. msgid ""
  7114. "The basic idea is to create a disc that has only the archive files "
  7115. "downloaded from the remote site. This is done by using the --print-uris "
  7116. "option to apt-get and then preparing a wget script to actually fetch the "
  7117. "packages."
  7118. msgstr ""
  7119. #. type: <heading></heading>
  7120. #: offline.sgml:196
  7121. msgid "Operation"
  7122. msgstr ""
  7123. #. type: <p><example>
  7124. #: offline.sgml:200
  7125. msgid ""
  7126. "Unlike the previous technique no special configuration files are "
  7127. "required. We merely use the standard APT commands to generate the file list."
  7128. msgstr ""
  7129. #. type: <example></example>
  7130. #: offline.sgml:205
  7131. #, no-wrap
  7132. msgid ""
  7133. " # apt-get dist-upgrade \n"
  7134. " [ Press no when prompted, make sure you are happy with the actions ]\n"
  7135. " # apt-get -qq --print-uris dist-upgrade > uris\n"
  7136. " # awk '{print \"wget -O \" $2 \" \" $1}' < uris > /disc/wget-script"
  7137. msgstr ""
  7138. #. type: </example></p>
  7139. #: offline.sgml:210
  7140. msgid ""
  7141. "Any command other than dist-upgrade could be used here, including "
  7142. "dselect-upgrade."
  7143. msgstr ""
  7144. #. type: <p></p>
  7145. #: offline.sgml:216
  7146. msgid ""
  7147. "The /disc/wget-script file will now contain a list of wget commands to "
  7148. "execute in order to fetch the necessary archives. This script should be run "
  7149. "with the current directory as the disc's mount point so as to save the "
  7150. "output on the disc."
  7151. msgstr ""
  7152. #. type: <p><example>
  7153. #: offline.sgml:219
  7154. msgid "The remote machine would do something like"
  7155. msgstr ""
  7156. #. type: <example></example>
  7157. #: offline.sgml:223
  7158. #, no-wrap
  7159. msgid ""
  7160. " # cd /disc\n"
  7161. " # sh -x ./wget-script\n"
  7162. " [ wait.. ]"
  7163. msgstr ""
  7164. #. type: </example><example>
  7165. #: offline.sgml:228
  7166. msgid ""
  7167. "Once the archives are downloaded and the disc returned to the Debian machine "
  7168. "installation can proceed using,"
  7169. msgstr ""
  7170. #. type: <example></example>
  7171. #: offline.sgml:230
  7172. #, no-wrap
  7173. msgid " # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade"
  7174. msgstr ""
  7175. #. type: </example></p>
  7176. #: offline.sgml:234
  7177. msgid "Which will use the already fetched archives on the disc."
  7178. msgstr ""