it.po 319 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459
  1. # Translation of apt package man pages
  2. # Copyright (C) 2000 Debian Italian l10n team <debian-l10n-italian@lists.debian.org>
  3. # This file is distributed under the same license as the apt package.
  4. #
  5. # Translators:
  6. # Eugenia Franzoni <eugenia@linuxcare.com>, 2000
  7. #
  8. #, fuzzy
  9. msgid ""
  10. msgstr ""
  11. "Project-Id-Version: \n"
  12. "POT-Creation-Date: 2010-11-30 10:38+0100\n"
  13. "PO-Revision-Date: 2003-04-26 23:26+0100\n"
  14. "Last-Translator: Traduzione di Eugenia Franzoni <eugenia@linuxcare.com>\n"
  15. "Language-Team: <debian-l10n-italian@lists.debian.org>\n"
  16. "Language: \n"
  17. "MIME-Version: 1.0\n"
  18. "Content-Type: text/plain; charset=UTF-8\n"
  19. "Content-Transfer-Encoding: 8bit\n"
  20. #. type: TH
  21. #: apt.8:17
  22. #, no-wrap
  23. msgid "apt"
  24. msgstr "apt"
  25. #. type: TH
  26. #: apt.8:17
  27. #, no-wrap
  28. msgid "16 June 1998"
  29. msgstr ""
  30. #. type: TH
  31. #: apt.8:17
  32. #, no-wrap
  33. msgid "Debian GNU/Linux"
  34. msgstr ""
  35. #. type: SH
  36. #: apt.8:18
  37. #, no-wrap
  38. msgid "NAME"
  39. msgstr ""
  40. #. type: Plain text
  41. #: apt.8:20
  42. msgid "apt - Advanced Package Tool"
  43. msgstr ""
  44. #. type: SH
  45. #: apt.8:20
  46. #, no-wrap
  47. msgid "SYNOPSIS"
  48. msgstr ""
  49. #. type: Plain text
  50. #: apt.8:22
  51. msgid "B<apt>"
  52. msgstr ""
  53. #. type: SH
  54. #: apt.8:22
  55. #, no-wrap
  56. msgid "DESCRIPTION"
  57. msgstr ""
  58. #. type: Plain text
  59. #: apt.8:31
  60. msgid ""
  61. "APT is a management system for software packages. For normal day to day "
  62. "package management there are several frontends available, such as B<aptitude>"
  63. "(8) for the command line or B<synaptic>(8) for the X Window System. Some "
  64. "options are only implemented in B<apt-get>(8) though."
  65. msgstr ""
  66. #. type: SH
  67. #: apt.8:31
  68. #, no-wrap
  69. msgid "SEE ALSO"
  70. msgstr ""
  71. #. type: Plain text
  72. #: apt.8:38
  73. msgid ""
  74. "B<apt-cache>(8), B<apt-get>(8), B<apt.conf>(5), B<sources.list>(5), "
  75. "B<apt_preferences>(5), B<apt-secure>(8)"
  76. msgstr ""
  77. #. type: SH
  78. #: apt.8:38
  79. #, no-wrap
  80. msgid "DIAGNOSTICS"
  81. msgstr ""
  82. #. type: Plain text
  83. #: apt.8:40
  84. msgid "apt returns zero on normal operation, decimal 100 on error."
  85. msgstr ""
  86. #. type: SH
  87. #: apt.8:40
  88. #, no-wrap
  89. msgid "BUGS"
  90. msgstr ""
  91. #. type: Plain text
  92. #: apt.8:42
  93. msgid "This manpage isn't even started."
  94. msgstr ""
  95. #. type: Plain text
  96. #: apt.8:51
  97. msgid ""
  98. "See E<lt>http://bugs.debian.org/aptE<gt>. If you wish to report a bug in "
  99. "B<apt>, please see I</usr/share/doc/debian/bug-reporting.txt> or the "
  100. "B<reportbug>(1) command."
  101. msgstr ""
  102. #. type: SH
  103. #: apt.8:51
  104. #, no-wrap
  105. msgid "AUTHOR"
  106. msgstr ""
  107. #. type: Plain text
  108. #: apt.8:52
  109. msgid "apt was written by the APT team E<lt>apt@packages.debian.orgE<gt>."
  110. msgstr ""
  111. #. type: Plain text
  112. #: apt.ent:2
  113. msgid "<!-- -*- mode: sgml; mode: fold -*- -->"
  114. msgstr ""
  115. #. type: Plain text
  116. #: apt.ent:16
  117. #, no-wrap
  118. msgid ""
  119. "<!-- Boiler plate docinfo section -->\n"
  120. "<!ENTITY apt-docinfo \"\n"
  121. " <refentryinfo>\n"
  122. " <address><email>apt@packages.debian.org</email></address>\n"
  123. " <author>\n"
  124. " <firstname>Jason</firstname> <surname>Gunthorpe</surname>\n"
  125. " <contrib></contrib>\n"
  126. " </author>\n"
  127. " <copyright><year>1998-2001</year> <holder>Jason Gunthorpe</holder></copyright>\n"
  128. " <date>28 October 2008</date>\n"
  129. " <productname>Linux</productname>\n"
  130. " </refentryinfo>\n"
  131. "\">\n"
  132. msgstr ""
  133. #. type: Plain text
  134. #: apt.ent:23
  135. #, no-wrap
  136. msgid ""
  137. "<!ENTITY apt-author.team \"\n"
  138. " <author>\n"
  139. " <othername>APT team</othername>\n"
  140. " <contrib></contrib>\n"
  141. " </author>\n"
  142. "\">\n"
  143. msgstr ""
  144. #. type: Plain text
  145. #: apt.ent:29
  146. #, no-wrap
  147. msgid ""
  148. "<!ENTITY apt-qapage \"\n"
  149. "\t<para>\n"
  150. "\t\t<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>\n"
  151. "\t</para>\n"
  152. "\">\n"
  153. msgstr ""
  154. #. type: Plain text
  155. #: apt.ent:40
  156. #, no-wrap
  157. msgid ""
  158. "<!-- Boiler plate Bug reporting section -->\n"
  159. "<!ENTITY manbugs \"\n"
  160. " <refsect1><title>Bugs</title>\n"
  161. " <para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>.\n"
  162. " If you wish to report a bug in APT, please see\n"
  163. " <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the\n"
  164. " &reportbug; command.\n"
  165. " </para>\n"
  166. " </refsect1>\n"
  167. "\">\n"
  168. msgstr ""
  169. #. type: Plain text
  170. #: apt.ent:48
  171. #, no-wrap
  172. msgid ""
  173. "<!-- Boiler plate Author section -->\n"
  174. "<!ENTITY manauthor \"\n"
  175. " <refsect1><title>Author</title>\n"
  176. " <para>APT was written by the APT team <email>apt@packages.debian.org</email>.\n"
  177. " </para>\n"
  178. " </refsect1>\n"
  179. "\">\n"
  180. msgstr ""
  181. #. type: Plain text
  182. #: apt.ent:58
  183. #, no-wrap
  184. msgid ""
  185. "<!-- Should be used within the option section of the text to\n"
  186. " put in the blurb about -h, -v, -c and -o -->\n"
  187. "<!ENTITY apt-commonoptions \"\n"
  188. " <varlistentry><term><option>-h</option></term>\n"
  189. " <term><option>--help</option></term>\n"
  190. " <listitem><para>Show a short usage summary.\n"
  191. " </para>\n"
  192. " </listitem>\n"
  193. " </varlistentry>\n"
  194. msgstr ""
  195. #. type: Plain text
  196. #: apt.ent:66
  197. #, no-wrap
  198. msgid ""
  199. " <varlistentry>\n"
  200. " <term><option>-v</option></term>\n"
  201. " <term><option>--version</option></term>\n"
  202. " <listitem><para>Show the program version.\n"
  203. " </para>\n"
  204. " </listitem>\n"
  205. " </varlistentry>\n"
  206. msgstr ""
  207. #. type: Plain text
  208. #: apt.ent:78
  209. #, no-wrap
  210. msgid ""
  211. " <varlistentry>\n"
  212. " <term><option>-c</option></term>\n"
  213. " <term><option>--config-file</option></term>\n"
  214. " <listitem><para>Configuration File; Specify a configuration file to use. \n"
  215. " The program will read the default configuration file and then this \n"
  216. " configuration file. If configuration settings need to be set before the\n"
  217. " default configuration files are parsed specify a file with the <envar>APT_CONFIG</envar>\n"
  218. " environment variable. See &apt-conf; for syntax information.\n"
  219. " </para>\n"
  220. " </listitem>\n"
  221. " </varlistentry>\n"
  222. msgstr ""
  223. #. type: Plain text
  224. #: apt.ent:90
  225. #, no-wrap
  226. msgid ""
  227. " <varlistentry>\n"
  228. " <term><option>-o</option></term>\n"
  229. " <term><option>--option</option></term>\n"
  230. " <listitem><para>Set a Configuration Option; This will set an arbitrary\n"
  231. " configuration option. The syntax is <option>-o Foo::Bar=bar</option>.\n"
  232. " <option>-o</option> and <option>--option</option> can be used multiple\n"
  233. " times to set different options.\n"
  234. " </para>\n"
  235. " </listitem>\n"
  236. " </varlistentry>\n"
  237. "\">\n"
  238. msgstr ""
  239. #. type: Plain text
  240. #: apt.ent:101
  241. #, no-wrap
  242. msgid ""
  243. "<!-- Should be used within the option section of the text to\n"
  244. " put in the blurb about -h, -v, -c and -o -->\n"
  245. "<!ENTITY apt-cmdblurb \"\n"
  246. " <para>All command line options may be set using the configuration file, the\n"
  247. " descriptions indicate the configuration option to set. For boolean\n"
  248. " options you can override the config file by using something like \n"
  249. " <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>\n"
  250. " or several other variations.\n"
  251. " </para>\n"
  252. "\">\n"
  253. msgstr ""
  254. #. type: Plain text
  255. #: apt.ent:107
  256. #, no-wrap
  257. msgid ""
  258. "<!ENTITY file-aptconf \"\n"
  259. " <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>\n"
  260. " <listitem><para>APT configuration file.\n"
  261. " Configuration Item: <literal>Dir::Etc::Main</literal>.</para></listitem>\n"
  262. " </varlistentry>\n"
  263. msgstr ""
  264. #. type: Plain text
  265. #: apt.ent:113
  266. #, no-wrap
  267. msgid ""
  268. " <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>\n"
  269. " <listitem><para>APT configuration file fragments.\n"
  270. " Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem>\n"
  271. " </varlistentry>\n"
  272. "\">\n"
  273. msgstr ""
  274. #. type: Plain text
  275. #: apt.ent:119
  276. #, no-wrap
  277. msgid ""
  278. "<!ENTITY file-cachearchives \"\n"
  279. " <varlistentry><term><filename>&cachedir;/archives/</filename></term>\n"
  280. " <listitem><para>Storage area for retrieved package files.\n"
  281. " Configuration Item: <literal>Dir::Cache::Archives</literal>.</para></listitem>\n"
  282. " </varlistentry>\n"
  283. msgstr ""
  284. #. type: Plain text
  285. #: apt.ent:125
  286. #, no-wrap
  287. msgid ""
  288. " <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>\n"
  289. " <listitem><para>Storage area for package files in transit.\n"
  290. " Configuration Item: <literal>Dir::Cache::Archives</literal> (implicit partial). </para></listitem>\n"
  291. " </varlistentry>\n"
  292. "\">\n"
  293. msgstr ""
  294. #. type: Plain text
  295. #: apt.ent:135
  296. #, no-wrap
  297. msgid ""
  298. "<!ENTITY file-preferences \"\n"
  299. " <varlistentry><term><filename>/etc/apt/preferences</filename></term>\n"
  300. " <listitem><para>Version preferences file.\n"
  301. " This is where you would specify &quot;pinning&quot;,\n"
  302. " i.e. a preference to get certain packages\n"
  303. " from a separate source\n"
  304. " or from a different version of a distribution.\n"
  305. " Configuration Item: <literal>Dir::Etc::Preferences</literal>.</para></listitem>\n"
  306. " </varlistentry>\n"
  307. msgstr ""
  308. #. type: Plain text
  309. #: apt.ent:141
  310. #, no-wrap
  311. msgid ""
  312. " <varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>\n"
  313. " <listitem><para>File fragments for the version preferences.\n"
  314. " Configuration Item: <literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>\n"
  315. " </varlistentry>\n"
  316. "\">\n"
  317. msgstr ""
  318. #. type: Plain text
  319. #: apt.ent:147
  320. #, no-wrap
  321. msgid ""
  322. "<!ENTITY file-sourceslist \"\n"
  323. " <varlistentry><term><filename>/etc/apt/sources.list</filename></term>\n"
  324. " <listitem><para>Locations to fetch packages from.\n"
  325. " Configuration Item: <literal>Dir::Etc::SourceList</literal>.</para></listitem>\n"
  326. " </varlistentry>\n"
  327. msgstr ""
  328. #. type: Plain text
  329. #: apt.ent:153
  330. #, no-wrap
  331. msgid ""
  332. " <varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>\n"
  333. " <listitem><para>File fragments for locations to fetch packages from.\n"
  334. " Configuration Item: <literal>Dir::Etc::SourceParts</literal>.</para></listitem>\n"
  335. " </varlistentry>\n"
  336. "\">\n"
  337. msgstr ""
  338. #. type: Plain text
  339. #: apt.ent:160
  340. #, no-wrap
  341. msgid ""
  342. "<!ENTITY file-statelists \"\n"
  343. " <varlistentry><term><filename>&statedir;/lists/</filename></term>\n"
  344. " <listitem><para>Storage area for state information for each package resource specified in\n"
  345. " &sources-list;\n"
  346. " Configuration Item: <literal>Dir::State::Lists</literal>.</para></listitem>\n"
  347. " </varlistentry>\n"
  348. msgstr ""
  349. #. type: Plain text
  350. #: apt.ent:166
  351. #, no-wrap
  352. msgid ""
  353. " <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>\n"
  354. " <listitem><para>Storage area for state information in transit.\n"
  355. " Configuration Item: <literal>Dir::State::Lists</literal> (implicit partial).</para></listitem>\n"
  356. " </varlistentry>\n"
  357. "\">\n"
  358. msgstr ""
  359. #. type: Plain text
  360. #: apt.ent:172
  361. #, no-wrap
  362. msgid ""
  363. "<!ENTITY file-trustedgpg \"\n"
  364. " <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>\n"
  365. " <listitem><para>Keyring of local trusted keys, new keys will be added here.\n"
  366. " Configuration Item: <literal>Dir::Etc::Trusted</literal>.</para></listitem>\n"
  367. " </varlistentry>\n"
  368. msgstr ""
  369. #. type: Plain text
  370. #: apt.ent:179
  371. #, no-wrap
  372. msgid ""
  373. " <varlistentry><term><filename>/etc/apt/trusted.gpg.d/</filename></term>\n"
  374. " <listitem><para>File fragments for the trusted keys, additional keyrings can\n"
  375. " be stored here (by other packages or the administrator).\n"
  376. " Configuration Item <literal>Dir::Etc::TrustedParts</literal>.</para></listitem>\n"
  377. " </varlistentry>\n"
  378. "\">\n"
  379. msgstr ""
  380. #. type: Plain text
  381. #: apt.ent:187
  382. #, no-wrap
  383. msgid ""
  384. "<!ENTITY file-extended_states \"\n"
  385. " <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term>\n"
  386. " <listitem><para>Status list of auto-installed packages.\n"
  387. " Configuration Item: <literal>Dir::State::extended_states</literal>.\n"
  388. " </para></listitem>\n"
  389. " </varlistentry>\n"
  390. "\">\n"
  391. msgstr ""
  392. #. type: Plain text
  393. #: apt.ent:191
  394. #, no-wrap
  395. msgid ""
  396. "<!-- TRANSLATOR: This is the section header for the following paragraphs - comparable\n"
  397. " to the other headers like NAME and DESCRIPTION and should therefore be uppercase. -->\n"
  398. "<!ENTITY translation-title \"TRANSLATION\">\n"
  399. msgstr ""
  400. #. type: Plain text
  401. #: apt.ent:200
  402. #, no-wrap
  403. msgid ""
  404. "<!-- TRANSLATOR: This is a placeholder. You should write here who has contributed\n"
  405. " to the translation in the past, who is responsible now and maybe further information\n"
  406. " specially related to your translation. -->\n"
  407. "<!ENTITY translation-holder \"\n"
  408. " The english translation was done by John Doe <email>john@doe.org</email> in 2009,\n"
  409. " 2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together with the\n"
  410. " Debian Dummy l10n Team <email>debian-l10n-dummy@lists.debian.org</email>.\n"
  411. "\">\n"
  412. msgstr ""
  413. #. type: Plain text
  414. #: apt.ent:210
  415. #, no-wrap
  416. msgid ""
  417. "<!-- TRANSLATOR: As a translation is allowed to have 20% of untranslated/fuzzy strings\n"
  418. " in a shipped manpage newer/modified paragraphs will maybe appear in english in\n"
  419. " the generated manpage. This sentence is therefore here to tell the reader that this\n"
  420. " is not a mistake by the translator - obviously the target is that at least for stable\n"
  421. " releases this sentence is not needed. :) -->\n"
  422. "<!ENTITY translation-english \"\n"
  423. " Note that this translated document may contain untranslated parts.\n"
  424. " This is done on purpose, to avoid losing content when the\n"
  425. " translation is lagging behind the original content.\n"
  426. "\">\n"
  427. msgstr ""
  428. #. The last update date
  429. #. type: Content of: <refentry><refentryinfo>
  430. #: apt-cache.8.xml:16 apt-config.8.xml:16 apt-extracttemplates.1.xml:16
  431. #: apt-sortpkgs.1.xml:16 sources.list.5.xml:16
  432. msgid ""
  433. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>29 "
  434. "February 2004</date>"
  435. msgstr ""
  436. #. type: Content of: <refentry><refnamediv><refname>
  437. #: apt-cache.8.xml:25 apt-cache.8.xml:32
  438. #, fuzzy
  439. msgid "apt-cache"
  440. msgstr "apt-get"
  441. #. type: Content of: <refentry><refmeta><manvolnum>
  442. #: apt-cache.8.xml:26 apt-cdrom.8.xml:25 apt-config.8.xml:26 apt-get.8.xml:26
  443. #: apt-key.8.xml:18 apt-mark.8.xml:26 apt-secure.8.xml:18
  444. msgid "8"
  445. msgstr ""
  446. #. type: Content of: <refentry><refmeta><refmiscinfo>
  447. #: apt-cache.8.xml:27 apt-cdrom.8.xml:26 apt-config.8.xml:27
  448. #: apt-extracttemplates.1.xml:27 apt-ftparchive.1.xml:27 apt-get.8.xml:27
  449. #: apt-key.8.xml:19 apt-mark.8.xml:27 apt-secure.8.xml:19
  450. #: apt-sortpkgs.1.xml:27 apt.conf.5.xml:33 apt_preferences.5.xml:26
  451. #: sources.list.5.xml:27
  452. msgid "APT"
  453. msgstr ""
  454. #. type: Content of: <refentry><refnamediv><refpurpose>
  455. #: apt-cache.8.xml:33
  456. msgid "APT package handling utility -- cache manipulator"
  457. msgstr ""
  458. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  459. #: apt-cache.8.xml:39
  460. msgid ""
  461. "<command>apt-cache</command> <arg><option>-hvsn</option></arg> <arg><option>-"
  462. "o=<replaceable>config string</replaceable></option></arg> <arg><option>-"
  463. "c=<replaceable>file</replaceable></option></arg> <group choice=\"req\"> "
  464. "<arg>add <arg choice=\"plain\" rep=\"repeat\"><replaceable>file</"
  465. "replaceable></arg></arg> <arg>gencaches</arg> <arg>showpkg <arg choice="
  466. "\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  467. "<arg>showsrc <arg choice=\"plain\" rep=\"repeat\"><replaceable>pkg</"
  468. "replaceable></arg></arg> <arg>stats</arg> <arg>dump</arg> <arg>dumpavail</"
  469. "arg> <arg>unmet</arg> <arg>search <arg choice=\"plain\"><replaceable>regex</"
  470. "replaceable></arg></arg> <arg>show <arg choice=\"plain\" rep=\"repeat"
  471. "\"><replaceable>pkg</replaceable></arg></arg> <arg>depends <arg choice="
  472. "\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  473. "<arg>rdepends <arg choice=\"plain\" rep=\"repeat\"><replaceable>pkg</"
  474. "replaceable></arg></arg> <arg>pkgnames <arg choice=\"plain"
  475. "\"><replaceable>prefix</replaceable></arg></arg> <arg>dotty <arg choice="
  476. "\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  477. "<arg>xvcg <arg choice=\"plain\" rep=\"repeat\"><replaceable>pkg</"
  478. "replaceable></arg></arg> <arg>policy <arg choice=\"plain\" rep=\"repeat"
  479. "\"><replaceable>pkgs</replaceable></arg></arg> <arg>madison <arg choice="
  480. "\"plain\" rep=\"repeat\"><replaceable>pkgs</replaceable></arg></arg> </group>"
  481. msgstr ""
  482. #. type: Content of: <refentry><refsect1><title>
  483. #: apt-cache.8.xml:65 apt-cdrom.8.xml:50 apt-config.8.xml:50
  484. #: apt-extracttemplates.1.xml:46 apt-ftparchive.1.xml:59 apt-get.8.xml:114
  485. #: apt-key.8.xml:38 apt-mark.8.xml:55 apt-secure.8.xml:43
  486. #: apt-sortpkgs.1.xml:47 apt.conf.5.xml:42 apt_preferences.5.xml:36
  487. #: sources.list.5.xml:36
  488. msgid "Description"
  489. msgstr ""
  490. #. type: Content of: <refentry><refsect1><para>
  491. #: apt-cache.8.xml:66
  492. msgid ""
  493. "<command>apt-cache</command> performs a variety of operations on APT's "
  494. "package cache. <command>apt-cache</command> does not manipulate the state of "
  495. "the system but does provide operations to search and generate interesting "
  496. "output from the package metadata."
  497. msgstr ""
  498. #. type: Content of: <refentry><refsect1><para>
  499. #: apt-cache.8.xml:71 apt-get.8.xml:120
  500. msgid ""
  501. "Unless the <option>-h</option>, or <option>--help</option> option is given, "
  502. "one of the commands below must be present."
  503. msgstr ""
  504. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  505. #: apt-cache.8.xml:75
  506. msgid "add <replaceable>file(s)</replaceable>"
  507. msgstr ""
  508. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  509. #: apt-cache.8.xml:76
  510. msgid ""
  511. "<literal>add</literal> adds the named package index files to the package "
  512. "cache. This is for debugging only."
  513. msgstr ""
  514. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  515. #: apt-cache.8.xml:80
  516. msgid "gencaches"
  517. msgstr ""
  518. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  519. #: apt-cache.8.xml:81
  520. msgid ""
  521. "<literal>gencaches</literal> performs the same operation as <command>apt-get "
  522. "check</command>. It builds the source and package caches from the sources in "
  523. "&sources-list; and from <filename>/var/lib/dpkg/status</filename>."
  524. msgstr ""
  525. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  526. #: apt-cache.8.xml:87
  527. msgid "showpkg <replaceable>pkg(s)</replaceable>"
  528. msgstr ""
  529. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  530. #: apt-cache.8.xml:88
  531. msgid ""
  532. "<literal>showpkg</literal> displays information about the packages listed on "
  533. "the command line. Remaining arguments are package names. The available "
  534. "versions and reverse dependencies of each package listed are listed, as well "
  535. "as forward dependencies for each version. Forward (normal) dependencies are "
  536. "those packages upon which the package in question depends; reverse "
  537. "dependencies are those packages that depend upon the package in question. "
  538. "Thus, forward dependencies must be satisfied for a package, but reverse "
  539. "dependencies need not be. For instance, <command>apt-cache showpkg "
  540. "libreadline2</command> would produce output similar to the following:"
  541. msgstr ""
  542. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
  543. #: apt-cache.8.xml:100
  544. #, no-wrap
  545. msgid ""
  546. "Package: libreadline2\n"
  547. "Versions: 2.1-12(/var/state/apt/lists/foo_Packages),\n"
  548. "Reverse Depends: \n"
  549. " libreadlineg2,libreadline2\n"
  550. " libreadline2-altdev,libreadline2\n"
  551. "Dependencies:\n"
  552. "2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))\n"
  553. "Provides:\n"
  554. "2.1-12 - \n"
  555. "Reverse Provides: \n"
  556. msgstr ""
  557. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  558. #: apt-cache.8.xml:112
  559. msgid ""
  560. "Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and "
  561. "ncurses3.0 which must be installed for libreadline2 to work. In turn, "
  562. "libreadlineg2 and libreadline2-altdev depend on libreadline2. If "
  563. "libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be "
  564. "installed; libreadlineg2 and libreadline2-altdev do not have to be "
  565. "installed. For the specific meaning of the remainder of the output it is "
  566. "best to consult the apt source code."
  567. msgstr ""
  568. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  569. #: apt-cache.8.xml:121
  570. msgid "stats"
  571. msgstr ""
  572. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  573. #: apt-cache.8.xml:121
  574. msgid ""
  575. "<literal>stats</literal> displays some statistics about the cache. No "
  576. "further arguments are expected. Statistics reported are:"
  577. msgstr ""
  578. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  579. #: apt-cache.8.xml:124
  580. msgid ""
  581. "<literal>Total package names</literal> is the number of package names found "
  582. "in the cache."
  583. msgstr ""
  584. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  585. #: apt-cache.8.xml:128
  586. msgid ""
  587. "<literal>Normal packages</literal> is the number of regular, ordinary "
  588. "package names; these are packages that bear a one-to-one correspondence "
  589. "between their names and the names used by other packages for them in "
  590. "dependencies. The majority of packages fall into this category."
  591. msgstr ""
  592. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  593. #: apt-cache.8.xml:134
  594. msgid ""
  595. "<literal>Pure virtual packages</literal> is the number of packages that "
  596. "exist only as a virtual package name; that is, packages only \"provide\" the "
  597. "virtual package name, and no package actually uses the name. For instance, "
  598. "\"mail-transport-agent\" in the Debian GNU/Linux system is a pure virtual "
  599. "package; several packages provide \"mail-transport-agent\", but there is no "
  600. "package named \"mail-transport-agent\"."
  601. msgstr ""
  602. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  603. #: apt-cache.8.xml:142
  604. msgid ""
  605. "<literal>Single virtual packages</literal> is the number of packages with "
  606. "only one package providing a particular virtual package. For example, in the "
  607. "Debian GNU/Linux system, \"X11-text-viewer\" is a virtual package, but only "
  608. "one package, xless, provides \"X11-text-viewer\"."
  609. msgstr ""
  610. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  611. #: apt-cache.8.xml:148
  612. msgid ""
  613. "<literal>Mixed virtual packages</literal> is the number of packages that "
  614. "either provide a particular virtual package or have the virtual package name "
  615. "as the package name. For instance, in the Debian GNU/Linux system, \"debconf"
  616. "\" is both an actual package, and provided by the debconf-tiny package."
  617. msgstr ""
  618. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  619. #: apt-cache.8.xml:155
  620. msgid ""
  621. "<literal>Missing</literal> is the number of package names that were "
  622. "referenced in a dependency but were not provided by any package. Missing "
  623. "packages may be an evidence if a full distribution is not accessed, or if a "
  624. "package (real or virtual) has been dropped from the distribution. Usually "
  625. "they are referenced from Conflicts or Breaks statements."
  626. msgstr ""
  627. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  628. #: apt-cache.8.xml:162
  629. msgid ""
  630. "<literal>Total distinct</literal> versions is the number of package versions "
  631. "found in the cache; this value is therefore at least equal to the number of "
  632. "total package names. If more than one distribution (both \"stable\" and "
  633. "\"unstable\", for instance), is being accessed, this value can be "
  634. "considerably larger than the number of total package names."
  635. msgstr ""
  636. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  637. #: apt-cache.8.xml:169
  638. msgid ""
  639. "<literal>Total dependencies</literal> is the number of dependency "
  640. "relationships claimed by all of the packages in the cache."
  641. msgstr ""
  642. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  643. #: apt-cache.8.xml:176
  644. msgid "showsrc <replaceable>pkg(s)</replaceable>"
  645. msgstr ""
  646. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  647. #: apt-cache.8.xml:177
  648. msgid ""
  649. "<literal>showsrc</literal> displays all the source package records that "
  650. "match the given package names. All versions are shown, as well as all "
  651. "records that declare the name to be a Binary."
  652. msgstr ""
  653. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  654. #: apt-cache.8.xml:182 apt-config.8.xml:87
  655. msgid "dump"
  656. msgstr ""
  657. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  658. #: apt-cache.8.xml:183
  659. msgid ""
  660. "<literal>dump</literal> shows a short listing of every package in the cache. "
  661. "It is primarily for debugging."
  662. msgstr ""
  663. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  664. #: apt-cache.8.xml:187
  665. msgid "dumpavail"
  666. msgstr ""
  667. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  668. #: apt-cache.8.xml:188
  669. msgid ""
  670. "<literal>dumpavail</literal> prints out an available list to stdout. This is "
  671. "suitable for use with &dpkg; and is used by the &dselect; method."
  672. msgstr ""
  673. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  674. #: apt-cache.8.xml:192
  675. msgid "unmet"
  676. msgstr ""
  677. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  678. #: apt-cache.8.xml:193
  679. msgid ""
  680. "<literal>unmet</literal> displays a summary of all unmet dependencies in the "
  681. "package cache."
  682. msgstr ""
  683. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  684. #: apt-cache.8.xml:197
  685. msgid "show <replaceable>pkg(s)</replaceable>"
  686. msgstr ""
  687. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  688. #: apt-cache.8.xml:198
  689. msgid ""
  690. "<literal>show</literal> performs a function similar to <command>dpkg --print-"
  691. "avail</command>; it displays the package records for the named packages."
  692. msgstr ""
  693. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  694. #: apt-cache.8.xml:203
  695. msgid "search <replaceable>regex [ regex ... ]</replaceable>"
  696. msgstr ""
  697. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  698. #: apt-cache.8.xml:204
  699. msgid ""
  700. "<literal>search</literal> performs a full text search on all available "
  701. "package lists for the POSIX regex pattern given, see "
  702. "<citerefentry><refentrytitle><command>regex</command></refentrytitle> "
  703. "<manvolnum>7</manvolnum></citerefentry>. It searches the package names and "
  704. "the descriptions for an occurrence of the regular expression and prints out "
  705. "the package name and the short description, including virtual package "
  706. "names. If <option>--full</option> is given then output identical to "
  707. "<literal>show</literal> is produced for each matched package, and if "
  708. "<option>--names-only</option> is given then the long description is not "
  709. "searched, only the package name is."
  710. msgstr ""
  711. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  712. #: apt-cache.8.xml:217
  713. msgid ""
  714. "Separate arguments can be used to specify multiple search patterns that are "
  715. "and'ed together."
  716. msgstr ""
  717. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  718. #: apt-cache.8.xml:221
  719. msgid "depends <replaceable>pkg(s)</replaceable>"
  720. msgstr ""
  721. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  722. #: apt-cache.8.xml:222
  723. msgid ""
  724. "<literal>depends</literal> shows a listing of each dependency a package has "
  725. "and all the possible other packages that can fulfill that dependency."
  726. msgstr ""
  727. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  728. #: apt-cache.8.xml:226
  729. msgid "rdepends <replaceable>pkg(s)</replaceable>"
  730. msgstr ""
  731. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  732. #: apt-cache.8.xml:227
  733. msgid ""
  734. "<literal>rdepends</literal> shows a listing of each reverse dependency a "
  735. "package has."
  736. msgstr ""
  737. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  738. #: apt-cache.8.xml:231
  739. msgid "pkgnames <replaceable>[ prefix ]</replaceable>"
  740. msgstr ""
  741. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  742. #: apt-cache.8.xml:232
  743. msgid ""
  744. "This command prints the name of each package APT knows. The optional "
  745. "argument is a prefix match to filter the name list. The output is suitable "
  746. "for use in a shell tab complete function and the output is generated "
  747. "extremely quickly. This command is best used with the <option>--generate</"
  748. "option> option."
  749. msgstr ""
  750. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  751. #: apt-cache.8.xml:237
  752. msgid ""
  753. "Note that a package which APT knows of is not necessarily available to "
  754. "download, installable or installed, e.g. virtual packages are also listed in "
  755. "the generated list."
  756. msgstr ""
  757. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  758. #: apt-cache.8.xml:242
  759. msgid "dotty <replaceable>pkg(s)</replaceable>"
  760. msgstr ""
  761. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  762. #: apt-cache.8.xml:243
  763. msgid ""
  764. "<literal>dotty</literal> takes a list of packages on the command line and "
  765. "generates output suitable for use by dotty from the <ulink url=\"http://www."
  766. "research.att.com/sw/tools/graphviz/\">GraphViz</ulink> package. The result "
  767. "will be a set of nodes and edges representing the relationships between the "
  768. "packages. By default the given packages will trace out all dependent "
  769. "packages; this can produce a very large graph. To limit the output to only "
  770. "the packages listed on the command line, set the <literal>APT::Cache::"
  771. "GivenOnly</literal> option."
  772. msgstr ""
  773. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  774. #: apt-cache.8.xml:252
  775. msgid ""
  776. "The resulting nodes will have several shapes; normal packages are boxes, "
  777. "pure provides are triangles, mixed provides are diamonds, missing packages "
  778. "are hexagons. Orange boxes mean recursion was stopped [leaf packages], blue "
  779. "lines are pre-depends, green lines are conflicts."
  780. msgstr ""
  781. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  782. #: apt-cache.8.xml:257
  783. msgid "Caution, dotty cannot graph larger sets of packages."
  784. msgstr ""
  785. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  786. #: apt-cache.8.xml:260
  787. msgid "xvcg <replaceable>pkg(s)</replaceable>"
  788. msgstr ""
  789. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  790. #: apt-cache.8.xml:261
  791. msgid ""
  792. "The same as <literal>dotty</literal>, only for xvcg from the <ulink url="
  793. "\"http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html\">VCG tool</ulink>."
  794. msgstr ""
  795. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  796. #: apt-cache.8.xml:265
  797. msgid "policy <replaceable>[ pkg(s) ]</replaceable>"
  798. msgstr ""
  799. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  800. #: apt-cache.8.xml:266
  801. msgid ""
  802. "<literal>policy</literal> is meant to help debug issues relating to the "
  803. "preferences file. With no arguments it will print out the priorities of each "
  804. "source. Otherwise it prints out detailed information about the priority "
  805. "selection of the named package."
  806. msgstr ""
  807. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  808. #: apt-cache.8.xml:272
  809. msgid "madison <replaceable>/[ pkg(s) ]</replaceable>"
  810. msgstr ""
  811. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  812. #: apt-cache.8.xml:273
  813. msgid ""
  814. "<literal>apt-cache</literal>'s <literal>madison</literal> command attempts "
  815. "to mimic the output format and a subset of the functionality of the Debian "
  816. "archive management tool, <literal>madison</literal>. It displays available "
  817. "versions of a package in a tabular format. Unlike the original "
  818. "<literal>madison</literal>, it can only display information for the "
  819. "architecture for which APT has retrieved package lists (<literal>APT::"
  820. "Architecture</literal>)."
  821. msgstr ""
  822. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  823. #: apt-cache.8.xml:284 apt-config.8.xml:96 apt-extracttemplates.1.xml:59
  824. #: apt-ftparchive.1.xml:522 apt-get.8.xml:308 apt-mark.8.xml:92
  825. #: apt-sortpkgs.1.xml:57 apt.conf.5.xml:559 apt.conf.5.xml:581
  826. msgid "options"
  827. msgstr ""
  828. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  829. #: apt-cache.8.xml:288
  830. msgid "<option>-p</option>"
  831. msgstr ""
  832. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  833. #: apt-cache.8.xml:288
  834. msgid "<option>--pkg-cache</option>"
  835. msgstr ""
  836. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  837. #: apt-cache.8.xml:289
  838. msgid ""
  839. "Select the file to store the package cache. The package cache is the primary "
  840. "cache used by all operations. Configuration Item: <literal>Dir::Cache::"
  841. "pkgcache</literal>."
  842. msgstr ""
  843. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  844. #: apt-cache.8.xml:294 apt-ftparchive.1.xml:565 apt-get.8.xml:365
  845. #: apt-sortpkgs.1.xml:61
  846. msgid "<option>-s</option>"
  847. msgstr ""
  848. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  849. #: apt-cache.8.xml:294
  850. msgid "<option>--src-cache</option>"
  851. msgstr ""
  852. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  853. #: apt-cache.8.xml:295
  854. msgid ""
  855. "Select the file to store the source cache. The source is used only by "
  856. "<literal>gencaches</literal> and it stores a parsed version of the package "
  857. "information from remote sources. When building the package cache the source "
  858. "cache is used to avoid reparsing all of the package files. Configuration "
  859. "Item: <literal>Dir::Cache::srcpkgcache</literal>."
  860. msgstr ""
  861. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  862. #: apt-cache.8.xml:302 apt-ftparchive.1.xml:539 apt-get.8.xml:355
  863. msgid "<option>-q</option>"
  864. msgstr ""
  865. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  866. #: apt-cache.8.xml:302 apt-ftparchive.1.xml:539 apt-get.8.xml:355
  867. msgid "<option>--quiet</option>"
  868. msgstr ""
  869. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  870. #: apt-cache.8.xml:303
  871. msgid ""
  872. "Quiet; produces output suitable for logging, omitting progress indicators. "
  873. "More q's will produce more quietness up to a maximum of 2. You can also use "
  874. "<option>-q=#</option> to set the quietness level, overriding the "
  875. "configuration file. Configuration Item: <literal>quiet</literal>."
  876. msgstr ""
  877. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  878. #: apt-cache.8.xml:309
  879. msgid "<option>-i</option>"
  880. msgstr ""
  881. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  882. #: apt-cache.8.xml:309
  883. msgid "<option>--important</option>"
  884. msgstr ""
  885. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  886. #: apt-cache.8.xml:310
  887. msgid ""
  888. "Print only important dependencies; for use with unmet and depends. Causes "
  889. "only Depends and Pre-Depends relations to be printed. Configuration Item: "
  890. "<literal>APT::Cache::Important</literal>."
  891. msgstr ""
  892. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  893. #: apt-cache.8.xml:315
  894. msgid "<option>--no-pre-depends</option>"
  895. msgstr ""
  896. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  897. #: apt-cache.8.xml:316
  898. msgid "<option>--no-depends</option>"
  899. msgstr ""
  900. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  901. #: apt-cache.8.xml:317
  902. msgid "<option>--no-recommends</option>"
  903. msgstr ""
  904. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  905. #: apt-cache.8.xml:318
  906. msgid "<option>--no-suggests</option>"
  907. msgstr ""
  908. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  909. #: apt-cache.8.xml:319
  910. msgid "<option>--no-conflicts</option>"
  911. msgstr ""
  912. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  913. #: apt-cache.8.xml:320
  914. msgid "<option>--no-breaks</option>"
  915. msgstr ""
  916. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  917. #: apt-cache.8.xml:321
  918. msgid "<option>--no-replaces</option>"
  919. msgstr ""
  920. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  921. #: apt-cache.8.xml:322
  922. msgid "<option>--no-enhances</option>"
  923. msgstr ""
  924. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  925. #: apt-cache.8.xml:323
  926. msgid ""
  927. "Per default the <literal>depends</literal> and <literal>rdepends</literal> "
  928. "print all dependencies. This can be twicked with these flags which will omit "
  929. "the specified dependency type. Configuration Item: <literal>APT::Cache::"
  930. "Show<replaceable>DependencyType</replaceable></literal> e.g. <literal>APT::"
  931. "Cache::ShowRecommends</literal>."
  932. msgstr ""
  933. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  934. #: apt-cache.8.xml:329 apt-cdrom.8.xml:124 apt-get.8.xml:322
  935. msgid "<option>-f</option>"
  936. msgstr ""
  937. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  938. #: apt-cache.8.xml:329
  939. msgid "<option>--full</option>"
  940. msgstr ""
  941. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  942. #: apt-cache.8.xml:330
  943. msgid ""
  944. "Print full package records when searching. Configuration Item: "
  945. "<literal>APT::Cache::ShowFull</literal>."
  946. msgstr ""
  947. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  948. #: apt-cache.8.xml:334 apt-cdrom.8.xml:134 apt-ftparchive.1.xml:577
  949. msgid "<option>-a</option>"
  950. msgstr ""
  951. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  952. #: apt-cache.8.xml:334
  953. msgid "<option>--all-versions</option>"
  954. msgstr ""
  955. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  956. #: apt-cache.8.xml:335
  957. msgid ""
  958. "Print full records for all available versions. This is the default; to turn "
  959. "it off, use <option>--no-all-versions</option>. If <option>--no-all-"
  960. "versions</option> is specified, only the candidate version will displayed "
  961. "(the one which would be selected for installation). This option is only "
  962. "applicable to the <literal>show</literal> command. Configuration Item: "
  963. "<literal>APT::Cache::AllVersions</literal>."
  964. msgstr ""
  965. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  966. #: apt-cache.8.xml:343
  967. msgid "<option>-g</option>"
  968. msgstr ""
  969. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  970. #: apt-cache.8.xml:343
  971. msgid "<option>--generate</option>"
  972. msgstr ""
  973. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  974. #: apt-cache.8.xml:344
  975. msgid ""
  976. "Perform automatic package cache regeneration, rather than use the cache as "
  977. "it is. This is the default; to turn it off, use <option>--no-generate</"
  978. "option>. Configuration Item: <literal>APT::Cache::Generate</literal>."
  979. msgstr ""
  980. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  981. #: apt-cache.8.xml:349
  982. msgid "<option>--names-only</option>"
  983. msgstr ""
  984. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  985. #: apt-cache.8.xml:349 apt-cdrom.8.xml:142
  986. msgid "<option>-n</option>"
  987. msgstr ""
  988. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  989. #: apt-cache.8.xml:350
  990. msgid ""
  991. "Only search on the package names, not the long descriptions. Configuration "
  992. "Item: <literal>APT::Cache::NamesOnly</literal>."
  993. msgstr ""
  994. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  995. #: apt-cache.8.xml:354
  996. msgid "<option>--all-names</option>"
  997. msgstr ""
  998. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  999. #: apt-cache.8.xml:355
  1000. msgid ""
  1001. "Make <literal>pkgnames</literal> print all names, including virtual packages "
  1002. "and missing dependencies. Configuration Item: <literal>APT::Cache::"
  1003. "AllNames</literal>."
  1004. msgstr ""
  1005. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1006. #: apt-cache.8.xml:360
  1007. msgid "<option>--recurse</option>"
  1008. msgstr ""
  1009. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1010. #: apt-cache.8.xml:361
  1011. msgid ""
  1012. "Make <literal>depends</literal> and <literal>rdepends</literal> recursive so "
  1013. "that all packages mentioned are printed once. Configuration Item: "
  1014. "<literal>APT::Cache::RecurseDepends</literal>."
  1015. msgstr ""
  1016. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1017. #: apt-cache.8.xml:366
  1018. msgid "<option>--installed</option>"
  1019. msgstr ""
  1020. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1021. #: apt-cache.8.xml:368
  1022. msgid ""
  1023. "Limit the output of <literal>depends</literal> and <literal>rdepends</"
  1024. "literal> to packages which are currently installed. Configuration Item: "
  1025. "<literal>APT::Cache::Installed</literal>."
  1026. msgstr ""
  1027. #. type: Content of: <refentry><refsect1><variablelist>
  1028. #: apt-cache.8.xml:373 apt-cdrom.8.xml:153 apt-config.8.xml:101
  1029. #: apt-extracttemplates.1.xml:70 apt-ftparchive.1.xml:605 apt-get.8.xml:550
  1030. #: apt-sortpkgs.1.xml:67
  1031. msgid "&apt-commonoptions;"
  1032. msgstr ""
  1033. #. type: Content of: <refentry><refsect1><title>
  1034. #: apt-cache.8.xml:378 apt-get.8.xml:555 apt-key.8.xml:156 apt-mark.8.xml:125
  1035. #: apt.conf.5.xml:1092 apt_preferences.5.xml:647
  1036. msgid "Files"
  1037. msgstr ""
  1038. #. type: Content of: <refentry><refsect1><variablelist>
  1039. #: apt-cache.8.xml:380
  1040. msgid "&file-sourceslist; &file-statelists;"
  1041. msgstr ""
  1042. #. type: Content of: <refentry><refsect1><title>
  1043. #: apt-cache.8.xml:385 apt-cdrom.8.xml:158 apt-config.8.xml:106
  1044. #: apt-extracttemplates.1.xml:77 apt-ftparchive.1.xml:621 apt-get.8.xml:565
  1045. #: apt-key.8.xml:177 apt-mark.8.xml:131 apt-secure.8.xml:184
  1046. #: apt-sortpkgs.1.xml:72 apt.conf.5.xml:1098 apt_preferences.5.xml:654
  1047. #: sources.list.5.xml:236
  1048. msgid "See Also"
  1049. msgstr ""
  1050. #. type: Content of: <refentry><refsect1><para>
  1051. #: apt-cache.8.xml:386
  1052. msgid "&apt-conf;, &sources-list;, &apt-get;"
  1053. msgstr ""
  1054. #. type: Content of: <refentry><refsect1><title>
  1055. #: apt-cache.8.xml:390 apt-cdrom.8.xml:163 apt-config.8.xml:111
  1056. #: apt-extracttemplates.1.xml:81 apt-ftparchive.1.xml:625 apt-get.8.xml:571
  1057. #: apt-mark.8.xml:135 apt-sortpkgs.1.xml:76
  1058. msgid "Diagnostics"
  1059. msgstr ""
  1060. #. type: Content of: <refentry><refsect1><para>
  1061. #: apt-cache.8.xml:391
  1062. msgid ""
  1063. "<command>apt-cache</command> returns zero on normal operation, decimal 100 "
  1064. "on error."
  1065. msgstr ""
  1066. #. type: Content of: <refentry><refentryinfo>
  1067. #: apt-cdrom.8.xml:16
  1068. msgid ""
  1069. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>14 "
  1070. "February 2004</date>"
  1071. msgstr ""
  1072. #. type: Content of: <refentry><refnamediv><refname>
  1073. #: apt-cdrom.8.xml:24 apt-cdrom.8.xml:31
  1074. msgid "apt-cdrom"
  1075. msgstr ""
  1076. #. type: Content of: <refentry><refnamediv><refpurpose>
  1077. #: apt-cdrom.8.xml:32
  1078. msgid "APT CDROM management utility"
  1079. msgstr ""
  1080. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1081. #: apt-cdrom.8.xml:38
  1082. msgid ""
  1083. "<command>apt-cdrom</command> <arg><option>-hvrmfan</option></arg> "
  1084. "<arg><option>-d=<replaceable>cdrom mount point</replaceable></option></arg> "
  1085. "<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
  1086. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <group> "
  1087. "<arg>add</arg> <arg>ident</arg> </group>"
  1088. msgstr ""
  1089. #. type: Content of: <refentry><refsect1><para>
  1090. #: apt-cdrom.8.xml:51
  1091. msgid ""
  1092. "<command>apt-cdrom</command> is used to add a new CDROM to APTs list of "
  1093. "available sources. <command>apt-cdrom</command> takes care of determining "
  1094. "the structure of the disc as well as correcting for several possible mis-"
  1095. "burns and verifying the index files."
  1096. msgstr ""
  1097. #. type: Content of: <refentry><refsect1><para>
  1098. #: apt-cdrom.8.xml:58
  1099. msgid ""
  1100. "It is necessary to use <command>apt-cdrom</command> to add CDs to the APT "
  1101. "system, it cannot be done by hand. Furthermore each disk in a multi-cd set "
  1102. "must be inserted and scanned separately to account for possible mis-burns."
  1103. msgstr ""
  1104. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  1105. #: apt-cdrom.8.xml:68
  1106. msgid "add"
  1107. msgstr ""
  1108. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  1109. #: apt-cdrom.8.xml:69
  1110. msgid ""
  1111. "<literal>add</literal> is used to add a new disc to the source list. It will "
  1112. "unmount the CDROM device, prompt for a disk to be inserted and then proceed "
  1113. "to scan it and copy the index files. If the disc does not have a proper "
  1114. "<filename>disk</filename> directory you will be prompted for a descriptive "
  1115. "title."
  1116. msgstr ""
  1117. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  1118. #: apt-cdrom.8.xml:77
  1119. msgid ""
  1120. "APT uses a CDROM ID to track which disc is currently in the drive and "
  1121. "maintains a database of these IDs in <filename>&statedir;/cdroms.list</"
  1122. "filename>"
  1123. msgstr ""
  1124. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  1125. #: apt-cdrom.8.xml:84
  1126. msgid "ident"
  1127. msgstr ""
  1128. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  1129. #: apt-cdrom.8.xml:85
  1130. msgid ""
  1131. "A debugging tool to report the identity of the current disc as well as the "
  1132. "stored file name"
  1133. msgstr ""
  1134. #. type: Content of: <refentry><refsect1><para>
  1135. #: apt-cdrom.8.xml:64
  1136. msgid ""
  1137. "Unless the <option>-h</option>, or <option>--help</option> option is given "
  1138. "one of the commands below must be present. <placeholder type=\"variablelist"
  1139. "\" id=\"0\"/>"
  1140. msgstr ""
  1141. #. type: Content of: <refentry><refsect1><title>
  1142. #: apt-cdrom.8.xml:94 apt-key.8.xml:142
  1143. msgid "Options"
  1144. msgstr ""
  1145. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1146. #: apt-cdrom.8.xml:98 apt-ftparchive.1.xml:533 apt-get.8.xml:317
  1147. msgid "<option>-d</option>"
  1148. msgstr ""
  1149. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1150. #: apt-cdrom.8.xml:98
  1151. msgid "<option>--cdrom</option>"
  1152. msgstr ""
  1153. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1154. #: apt-cdrom.8.xml:99
  1155. msgid ""
  1156. "Mount point; specify the location to mount the cdrom. This mount point must "
  1157. "be listed in <filename>/etc/fstab</filename> and properly configured. "
  1158. "Configuration Item: <literal>Acquire::cdrom::mount</literal>."
  1159. msgstr ""
  1160. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1161. #: apt-cdrom.8.xml:107
  1162. msgid "<option>-r</option>"
  1163. msgstr ""
  1164. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1165. #: apt-cdrom.8.xml:107
  1166. msgid "<option>--rename</option>"
  1167. msgstr ""
  1168. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1169. #: apt-cdrom.8.xml:108
  1170. msgid ""
  1171. "Rename a disc; change the label of a disk or override the disks given label. "
  1172. "This option will cause <command>apt-cdrom</command> to prompt for a new "
  1173. "label. Configuration Item: <literal>APT::CDROM::Rename</literal>."
  1174. msgstr ""
  1175. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1176. #: apt-cdrom.8.xml:116 apt-get.8.xml:336
  1177. msgid "<option>-m</option>"
  1178. msgstr ""
  1179. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1180. #: apt-cdrom.8.xml:116
  1181. msgid "<option>--no-mount</option>"
  1182. msgstr ""
  1183. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1184. #: apt-cdrom.8.xml:117
  1185. msgid ""
  1186. "No mounting; prevent <command>apt-cdrom</command> from mounting and "
  1187. "unmounting the mount point. Configuration Item: <literal>APT::CDROM::"
  1188. "NoMount</literal>."
  1189. msgstr ""
  1190. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1191. #: apt-cdrom.8.xml:124
  1192. msgid "<option>--fast</option>"
  1193. msgstr ""
  1194. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1195. #: apt-cdrom.8.xml:125
  1196. msgid ""
  1197. "Fast Copy; Assume the package files are valid and do not check every "
  1198. "package. This option should be used only if <command>apt-cdrom</command> has "
  1199. "been run on this disc before and did not detect any errors. Configuration "
  1200. "Item: <literal>APT::CDROM::Fast</literal>."
  1201. msgstr ""
  1202. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1203. #: apt-cdrom.8.xml:134
  1204. msgid "<option>--thorough</option>"
  1205. msgstr ""
  1206. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1207. #: apt-cdrom.8.xml:135
  1208. msgid ""
  1209. "Thorough Package Scan; This option may be needed with some old Debian "
  1210. "1.1/1.2 discs that have Package files in strange places. It takes much "
  1211. "longer to scan the CD but will pick them all up."
  1212. msgstr ""
  1213. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1214. #: apt-cdrom.8.xml:143 apt-get.8.xml:367
  1215. msgid "<option>--just-print</option>"
  1216. msgstr ""
  1217. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1218. #: apt-cdrom.8.xml:144 apt-get.8.xml:369
  1219. msgid "<option>--recon</option>"
  1220. msgstr ""
  1221. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1222. #: apt-cdrom.8.xml:145 apt-get.8.xml:370
  1223. msgid "<option>--no-act</option>"
  1224. msgstr ""
  1225. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1226. #: apt-cdrom.8.xml:146
  1227. msgid ""
  1228. "No Changes; Do not change the &sources-list; file and do not write index "
  1229. "files. Everything is still checked however. Configuration Item: "
  1230. "<literal>APT::CDROM::NoAct</literal>."
  1231. msgstr ""
  1232. #. type: Content of: <refentry><refsect1><para>
  1233. #: apt-cdrom.8.xml:159
  1234. msgid "&apt-conf;, &apt-get;, &sources-list;"
  1235. msgstr ""
  1236. #. type: Content of: <refentry><refsect1><para>
  1237. #: apt-cdrom.8.xml:164
  1238. msgid ""
  1239. "<command>apt-cdrom</command> returns zero on normal operation, decimal 100 "
  1240. "on error."
  1241. msgstr ""
  1242. #. type: Content of: <refentry><refnamediv><refname>
  1243. #: apt-config.8.xml:25 apt-config.8.xml:32
  1244. msgid "apt-config"
  1245. msgstr ""
  1246. #. type: Content of: <refentry><refnamediv><refpurpose>
  1247. #: apt-config.8.xml:33
  1248. msgid "APT Configuration Query program"
  1249. msgstr ""
  1250. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1251. #: apt-config.8.xml:39
  1252. msgid ""
  1253. "<command>apt-config</command> <arg><option>-hv</option></arg> <arg><option>-"
  1254. "o=<replaceable>config string</replaceable></option></arg> <arg><option>-"
  1255. "c=<replaceable>file</replaceable></option></arg> <group choice=\"req\"> "
  1256. "<arg>shell</arg> <arg>dump</arg> </group>"
  1257. msgstr ""
  1258. #. type: Content of: <refentry><refsect1><para>
  1259. #: apt-config.8.xml:51
  1260. msgid ""
  1261. "<command>apt-config</command> is an internal program used by various "
  1262. "portions of the APT suite to provide consistent configurability. It accesses "
  1263. "the main configuration file <filename>/etc/apt/apt.conf</filename> in a "
  1264. "manner that is easy to use by scripted applications."
  1265. msgstr ""
  1266. #. type: Content of: <refentry><refsect1><para>
  1267. #: apt-config.8.xml:56 apt-ftparchive.1.xml:75
  1268. msgid ""
  1269. "Unless the <option>-h</option>, or <option>--help</option> option is given "
  1270. "one of the commands below must be present."
  1271. msgstr ""
  1272. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1273. #: apt-config.8.xml:61
  1274. msgid "shell"
  1275. msgstr ""
  1276. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1277. #: apt-config.8.xml:63
  1278. msgid ""
  1279. "shell is used to access the configuration information from a shell script. "
  1280. "It is given pairs of arguments, the first being a shell variable and the "
  1281. "second the configuration value to query. As output it lists a series of "
  1282. "shell assignments commands for each present value. In a shell script it "
  1283. "should be used like:"
  1284. msgstr ""
  1285. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
  1286. #: apt-config.8.xml:71
  1287. #, no-wrap
  1288. msgid ""
  1289. "OPTS=\"-f\"\n"
  1290. "RES=`apt-config shell OPTS MyApp::options`\n"
  1291. "eval $RES\n"
  1292. msgstr ""
  1293. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1294. #: apt-config.8.xml:76
  1295. msgid ""
  1296. "This will set the shell environment variable $OPTS to the value of MyApp::"
  1297. "options with a default of <option>-f</option>."
  1298. msgstr ""
  1299. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1300. #: apt-config.8.xml:80
  1301. msgid ""
  1302. "The configuration item may be postfixed with a /[fdbi]. f returns file "
  1303. "names, d returns directories, b returns true or false and i returns an "
  1304. "integer. Each of the returns is normalized and verified internally."
  1305. msgstr ""
  1306. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1307. #: apt-config.8.xml:89
  1308. msgid "Just show the contents of the configuration space."
  1309. msgstr ""
  1310. #. type: Content of: <refentry><refsect1><para>
  1311. #: apt-config.8.xml:107 apt-extracttemplates.1.xml:78 apt-ftparchive.1.xml:622
  1312. #: apt-sortpkgs.1.xml:73
  1313. msgid "&apt-conf;"
  1314. msgstr ""
  1315. #. type: Content of: <refentry><refsect1><para>
  1316. #: apt-config.8.xml:112
  1317. msgid ""
  1318. "<command>apt-config</command> returns zero on normal operation, decimal 100 "
  1319. "on error."
  1320. msgstr ""
  1321. #. type: Content of: <refentry><refnamediv><refname>
  1322. #: apt-extracttemplates.1.xml:25 apt-extracttemplates.1.xml:32
  1323. msgid "apt-extracttemplates"
  1324. msgstr ""
  1325. #. type: Content of: <refentry><refmeta><manvolnum>
  1326. #: apt-extracttemplates.1.xml:26 apt-ftparchive.1.xml:26 apt-sortpkgs.1.xml:26
  1327. msgid "1"
  1328. msgstr ""
  1329. #. type: Content of: <refentry><refnamediv><refpurpose>
  1330. #: apt-extracttemplates.1.xml:33
  1331. msgid "Utility to extract DebConf config and templates from Debian packages"
  1332. msgstr ""
  1333. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1334. #: apt-extracttemplates.1.xml:39
  1335. msgid ""
  1336. "<command>apt-extracttemplates</command> <arg><option>-hv</option></arg> "
  1337. "<arg><option>-t=<replaceable>temporary directory</replaceable></option></"
  1338. "arg> <arg choice=\"plain\" rep=\"repeat\"><replaceable>file</replaceable></"
  1339. "arg>"
  1340. msgstr ""
  1341. #. type: Content of: <refentry><refsect1><para>
  1342. #: apt-extracttemplates.1.xml:47
  1343. msgid ""
  1344. "<command>apt-extracttemplates</command> will take one or more Debian package "
  1345. "files as input and write out (to a temporary directory) all associated "
  1346. "config scripts and template files. For each passed in package that contains "
  1347. "config scripts and templates, one line of output will be generated in the "
  1348. "format:"
  1349. msgstr ""
  1350. #. type: Content of: <refentry><refsect1><para>
  1351. #: apt-extracttemplates.1.xml:52
  1352. msgid "package version template-file config-script"
  1353. msgstr ""
  1354. #. type: Content of: <refentry><refsect1><para>
  1355. #: apt-extracttemplates.1.xml:53
  1356. msgid ""
  1357. "template-file and config-script are written to the temporary directory "
  1358. "specified by the -t or --tempdir (<literal>APT::ExtractTemplates::TempDir</"
  1359. "literal>) directory, with filenames of the form <filename>package.template."
  1360. "XXXX</filename> and <filename>package.config.XXXX</filename>"
  1361. msgstr ""
  1362. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1363. #: apt-extracttemplates.1.xml:63 apt-get.8.xml:484
  1364. msgid "<option>-t</option>"
  1365. msgstr ""
  1366. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1367. #: apt-extracttemplates.1.xml:63
  1368. msgid "<option>--tempdir</option>"
  1369. msgstr ""
  1370. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1371. #: apt-extracttemplates.1.xml:65
  1372. msgid ""
  1373. "Temporary directory in which to write extracted debconf template files and "
  1374. "config scripts. Configuration Item: <literal>APT::ExtractTemplates::"
  1375. "TempDir</literal>"
  1376. msgstr ""
  1377. #. type: Content of: <refentry><refsect1><para>
  1378. #: apt-extracttemplates.1.xml:82
  1379. msgid ""
  1380. "<command>apt-extracttemplates</command> returns zero on normal operation, "
  1381. "decimal 100 on error."
  1382. msgstr ""
  1383. #. The last update date
  1384. #. type: Content of: <refentry><refentryinfo>
  1385. #: apt-ftparchive.1.xml:16
  1386. msgid ""
  1387. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>17 "
  1388. "August 2009</date>"
  1389. msgstr ""
  1390. #. type: Content of: <refentry><refnamediv><refname>
  1391. #: apt-ftparchive.1.xml:25 apt-ftparchive.1.xml:32
  1392. msgid "apt-ftparchive"
  1393. msgstr ""
  1394. #. type: Content of: <refentry><refnamediv><refpurpose>
  1395. #: apt-ftparchive.1.xml:33
  1396. msgid "Utility to generate index files"
  1397. msgstr ""
  1398. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1399. #: apt-ftparchive.1.xml:39
  1400. msgid ""
  1401. "<command>apt-ftparchive</command> <arg><option>-hvdsq</option></arg> "
  1402. "<arg><option>--md5</option></arg> <arg><option>--delink</option></arg> "
  1403. "<arg><option>--readonly</option></arg> <arg><option>--contents</option></"
  1404. "arg> <arg><option>--arch <replaceable>architecture</replaceable></option></"
  1405. "arg> <arg><option>-o <replaceable>config</replaceable>=<replaceable>string</"
  1406. "replaceable></option></arg> <arg><option>-c=<replaceable>file</replaceable></"
  1407. "option></arg> <group choice=\"req\"> <arg>packages<arg choice=\"plain\" rep="
  1408. "\"repeat\"><replaceable>path</replaceable></arg><arg><replaceable>override</"
  1409. "replaceable><arg><replaceable>pathprefix</replaceable></arg></arg></arg> "
  1410. "<arg>sources<arg choice=\"plain\" rep=\"repeat\"><replaceable>path</"
  1411. "replaceable></arg><arg><replaceable>override</"
  1412. "replaceable><arg><replaceable>pathprefix</replaceable></arg></arg></arg> "
  1413. "<arg>contents <arg choice=\"plain\"><replaceable>path</replaceable></arg></"
  1414. "arg> <arg>release <arg choice=\"plain\"><replaceable>path</replaceable></"
  1415. "arg></arg> <arg>generate <arg choice=\"plain\"><replaceable>config-file</"
  1416. "replaceable></arg> <arg choice=\"plain\" rep=\"repeat"
  1417. "\"><replaceable>section</replaceable></arg></arg> <arg>clean <arg choice="
  1418. "\"plain\"><replaceable>config-file</replaceable></arg></arg> </group>"
  1419. msgstr ""
  1420. #. type: Content of: <refentry><refsect1><para>
  1421. #: apt-ftparchive.1.xml:60
  1422. msgid ""
  1423. "<command>apt-ftparchive</command> is the command line tool that generates "
  1424. "the index files that APT uses to access a distribution source. The index "
  1425. "files should be generated on the origin site based on the content of that "
  1426. "site."
  1427. msgstr ""
  1428. #. type: Content of: <refentry><refsect1><para>
  1429. #: apt-ftparchive.1.xml:64
  1430. msgid ""
  1431. "<command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; "
  1432. "program, incorporating its entire functionality via the <literal>packages</"
  1433. "literal> command. It also contains a contents file generator, "
  1434. "<literal>contents</literal>, and an elaborate means to 'script' the "
  1435. "generation process for a complete archive."
  1436. msgstr ""
  1437. #. type: Content of: <refentry><refsect1><para>
  1438. #: apt-ftparchive.1.xml:70
  1439. msgid ""
  1440. "Internally <command>apt-ftparchive</command> can make use of binary "
  1441. "databases to cache the contents of a .deb file and it does not rely on any "
  1442. "external programs aside from &gzip;. When doing a full generate it "
  1443. "automatically performs file-change checks and builds the desired compressed "
  1444. "output files."
  1445. msgstr ""
  1446. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1447. #: apt-ftparchive.1.xml:79
  1448. msgid "packages"
  1449. msgstr ""
  1450. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1451. #: apt-ftparchive.1.xml:81
  1452. msgid ""
  1453. "The packages command generates a package file from a directory tree. It "
  1454. "takes the given directory and recursively searches it for .deb files, "
  1455. "emitting a package record to stdout for each. This command is approximately "
  1456. "equivalent to &dpkg-scanpackages;."
  1457. msgstr ""
  1458. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1459. #: apt-ftparchive.1.xml:86 apt-ftparchive.1.xml:110
  1460. msgid ""
  1461. "The option <option>--db</option> can be used to specify a binary caching DB."
  1462. msgstr ""
  1463. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1464. #: apt-ftparchive.1.xml:89
  1465. msgid "sources"
  1466. msgstr ""
  1467. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1468. #: apt-ftparchive.1.xml:91
  1469. msgid ""
  1470. "The <literal>sources</literal> command generates a source index file from a "
  1471. "directory tree. It takes the given directory and recursively searches it "
  1472. "for .dsc files, emitting a source record to stdout for each. This command is "
  1473. "approximately equivalent to &dpkg-scansources;."
  1474. msgstr ""
  1475. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1476. #: apt-ftparchive.1.xml:96
  1477. msgid ""
  1478. "If an override file is specified then a source override file will be looked "
  1479. "for with an extension of .src. The --source-override option can be used to "
  1480. "change the source override file that will be used."
  1481. msgstr ""
  1482. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1483. #: apt-ftparchive.1.xml:101
  1484. msgid "contents"
  1485. msgstr ""
  1486. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1487. #: apt-ftparchive.1.xml:103
  1488. msgid ""
  1489. "The <literal>contents</literal> command generates a contents file from a "
  1490. "directory tree. It takes the given directory and recursively searches it "
  1491. "for .deb files, and reads the file list from each file. It then sorts and "
  1492. "writes to stdout the list of files matched to packages. Directories are not "
  1493. "written to the output. If multiple packages own the same file then each "
  1494. "package is separated by a comma in the output."
  1495. msgstr ""
  1496. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1497. #: apt-ftparchive.1.xml:113
  1498. msgid "release"
  1499. msgstr ""
  1500. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1501. #: apt-ftparchive.1.xml:115
  1502. msgid ""
  1503. "The <literal>release</literal> command generates a Release file from a "
  1504. "directory tree. It recursively searches the given directory for Packages, "
  1505. "Packages.gz, Packages.bz2, Sources, Sources.gz, Sources.bz2, Release and "
  1506. "md5sum.txt files. It then writes to stdout a Release file containing an MD5 "
  1507. "digest and SHA1 digest for each file."
  1508. msgstr ""
  1509. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1510. #: apt-ftparchive.1.xml:122
  1511. msgid ""
  1512. "Values for the additional metadata fields in the Release file are taken from "
  1513. "the corresponding variables under <literal>APT::FTPArchive::Release</"
  1514. "literal>, e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The "
  1515. "supported fields are: <literal>Origin</literal>, <literal>Label</literal>, "
  1516. "<literal>Suite</literal>, <literal>Version</literal>, <literal>Codename</"
  1517. "literal>, <literal>Date</literal>, <literal>Valid-Until</literal>, "
  1518. "<literal>Architectures</literal>, <literal>Components</literal>, "
  1519. "<literal>Description</literal>."
  1520. msgstr ""
  1521. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1522. #: apt-ftparchive.1.xml:133
  1523. #, fuzzy
  1524. msgid "generate"
  1525. msgstr "Descrizione generale"
  1526. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1527. #: apt-ftparchive.1.xml:135
  1528. msgid ""
  1529. "The <literal>generate</literal> command is designed to be runnable from a "
  1530. "cron script and builds indexes according to the given config file. The "
  1531. "config language provides a flexible means of specifying which index files "
  1532. "are built from which directories, as well as providing a simple means of "
  1533. "maintaining the required settings."
  1534. msgstr ""
  1535. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1536. #: apt-ftparchive.1.xml:142 apt-get.8.xml:281
  1537. msgid "clean"
  1538. msgstr ""
  1539. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1540. #: apt-ftparchive.1.xml:144
  1541. msgid ""
  1542. "The <literal>clean</literal> command tidies the databases used by the given "
  1543. "configuration file by removing any records that are no longer necessary."
  1544. msgstr ""
  1545. #. type: Content of: <refentry><refsect1><title>
  1546. #: apt-ftparchive.1.xml:150
  1547. msgid "The Generate Configuration"
  1548. msgstr ""
  1549. #. type: Content of: <refentry><refsect1><para>
  1550. #: apt-ftparchive.1.xml:152
  1551. msgid ""
  1552. "The <literal>generate</literal> command uses a configuration file to "
  1553. "describe the archives that are going to be generated. It follows the typical "
  1554. "ISC configuration format as seen in ISC tools like bind 8 and dhcpd. &apt-"
  1555. "conf; contains a description of the syntax. Note that the generate "
  1556. "configuration is parsed in sectional manner, but &apt-conf; is parsed in a "
  1557. "tree manner. This only effects how the scope tag is handled."
  1558. msgstr ""
  1559. #. type: Content of: <refentry><refsect1><para>
  1560. #: apt-ftparchive.1.xml:160
  1561. msgid ""
  1562. "The generate configuration has 4 separate sections, each described below."
  1563. msgstr ""
  1564. #. type: Content of: <refentry><refsect1><refsect2><title>
  1565. #: apt-ftparchive.1.xml:162
  1566. msgid "Dir Section"
  1567. msgstr ""
  1568. #. type: Content of: <refentry><refsect1><refsect2><para>
  1569. #: apt-ftparchive.1.xml:164
  1570. msgid ""
  1571. "The <literal>Dir</literal> section defines the standard directories needed "
  1572. "to locate the files required during the generation process. These "
  1573. "directories are prepended certain relative paths defined in later sections "
  1574. "to produce a complete an absolute path."
  1575. msgstr ""
  1576. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1577. #: apt-ftparchive.1.xml:169
  1578. msgid "ArchiveDir"
  1579. msgstr ""
  1580. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1581. #: apt-ftparchive.1.xml:171
  1582. msgid ""
  1583. "Specifies the root of the FTP archive, in a standard Debian configuration "
  1584. "this is the directory that contains the <filename>ls-LR</filename> and dist "
  1585. "nodes."
  1586. msgstr ""
  1587. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1588. #: apt-ftparchive.1.xml:176
  1589. msgid "OverrideDir"
  1590. msgstr ""
  1591. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1592. #: apt-ftparchive.1.xml:178
  1593. msgid "Specifies the location of the override files."
  1594. msgstr ""
  1595. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1596. #: apt-ftparchive.1.xml:181
  1597. msgid "CacheDir"
  1598. msgstr ""
  1599. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1600. #: apt-ftparchive.1.xml:183
  1601. msgid "Specifies the location of the cache files"
  1602. msgstr ""
  1603. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1604. #: apt-ftparchive.1.xml:186
  1605. msgid "FileListDir"
  1606. msgstr ""
  1607. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1608. #: apt-ftparchive.1.xml:188
  1609. msgid ""
  1610. "Specifies the location of the file list files, if the <literal>FileList</"
  1611. "literal> setting is used below."
  1612. msgstr ""
  1613. #. type: Content of: <refentry><refsect1><refsect2><title>
  1614. #: apt-ftparchive.1.xml:194
  1615. msgid "Default Section"
  1616. msgstr ""
  1617. #. type: Content of: <refentry><refsect1><refsect2><para>
  1618. #: apt-ftparchive.1.xml:196
  1619. msgid ""
  1620. "The <literal>Default</literal> section specifies default values, and "
  1621. "settings that control the operation of the generator. Other sections may "
  1622. "override these defaults with a per-section setting."
  1623. msgstr ""
  1624. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1625. #: apt-ftparchive.1.xml:200
  1626. msgid "Packages::Compress"
  1627. msgstr ""
  1628. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1629. #: apt-ftparchive.1.xml:202
  1630. msgid ""
  1631. "Sets the default compression schemes to use for the Package index files. It "
  1632. "is a string that contains a space separated list of at least one of: '.' (no "
  1633. "compression), 'gzip' and 'bzip2'. The default for all compression schemes is "
  1634. "'. gzip'."
  1635. msgstr ""
  1636. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1637. #: apt-ftparchive.1.xml:208
  1638. msgid "Packages::Extensions"
  1639. msgstr ""
  1640. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1641. #: apt-ftparchive.1.xml:210
  1642. msgid ""
  1643. "Sets the default list of file extensions that are package files. This "
  1644. "defaults to '.deb'."
  1645. msgstr ""
  1646. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1647. #: apt-ftparchive.1.xml:214
  1648. msgid "Sources::Compress"
  1649. msgstr ""
  1650. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1651. #: apt-ftparchive.1.xml:216
  1652. msgid ""
  1653. "This is similar to <literal>Packages::Compress</literal> except that it "
  1654. "controls the compression for the Sources files."
  1655. msgstr ""
  1656. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1657. #: apt-ftparchive.1.xml:220
  1658. msgid "Sources::Extensions"
  1659. msgstr ""
  1660. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1661. #: apt-ftparchive.1.xml:222
  1662. msgid ""
  1663. "Sets the default list of file extensions that are source files. This "
  1664. "defaults to '.dsc'."
  1665. msgstr ""
  1666. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1667. #: apt-ftparchive.1.xml:226
  1668. msgid "Contents::Compress"
  1669. msgstr ""
  1670. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1671. #: apt-ftparchive.1.xml:228
  1672. msgid ""
  1673. "This is similar to <literal>Packages::Compress</literal> except that it "
  1674. "controls the compression for the Contents files."
  1675. msgstr ""
  1676. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1677. #: apt-ftparchive.1.xml:232
  1678. msgid "Translation::Compress"
  1679. msgstr ""
  1680. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1681. #: apt-ftparchive.1.xml:234
  1682. msgid ""
  1683. "This is similar to <literal>Packages::Compress</literal> except that it "
  1684. "controls the compression for the Translation-en master file."
  1685. msgstr ""
  1686. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1687. #: apt-ftparchive.1.xml:238
  1688. msgid "DeLinkLimit"
  1689. msgstr ""
  1690. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1691. #: apt-ftparchive.1.xml:240
  1692. msgid ""
  1693. "Specifies the number of kilobytes to delink (and replace with hard links) "
  1694. "per run. This is used in conjunction with the per-section <literal>External-"
  1695. "Links</literal> setting."
  1696. msgstr ""
  1697. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1698. #: apt-ftparchive.1.xml:245
  1699. msgid "FileMode"
  1700. msgstr ""
  1701. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1702. #: apt-ftparchive.1.xml:247
  1703. msgid ""
  1704. "Specifies the mode of all created index files. It defaults to 0644. All "
  1705. "index files are set to this mode with no regard to the umask."
  1706. msgstr ""
  1707. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1708. #: apt-ftparchive.1.xml:252 apt-ftparchive.1.xml:398
  1709. msgid "LongDescription"
  1710. msgstr ""
  1711. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1712. #: apt-ftparchive.1.xml:254 apt-ftparchive.1.xml:400
  1713. msgid ""
  1714. "Sets if long descriptions should be included in the Packages file or split "
  1715. "out into a master Translation-en file."
  1716. msgstr ""
  1717. #. type: Content of: <refentry><refsect1><refsect2><title>
  1718. #: apt-ftparchive.1.xml:260
  1719. msgid "TreeDefault Section"
  1720. msgstr ""
  1721. #. type: Content of: <refentry><refsect1><refsect2><para>
  1722. #: apt-ftparchive.1.xml:262
  1723. msgid ""
  1724. "Sets defaults specific to <literal>Tree</literal> sections. All of these "
  1725. "variables are substitution variables and have the strings $(DIST), "
  1726. "$(SECTION) and $(ARCH) replaced with their respective values."
  1727. msgstr ""
  1728. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1729. #: apt-ftparchive.1.xml:267
  1730. msgid "MaxContentsChange"
  1731. msgstr ""
  1732. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1733. #: apt-ftparchive.1.xml:269
  1734. msgid ""
  1735. "Sets the number of kilobytes of contents files that are generated each day. "
  1736. "The contents files are round-robined so that over several days they will all "
  1737. "be rebuilt."
  1738. msgstr ""
  1739. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1740. #: apt-ftparchive.1.xml:274
  1741. msgid "ContentsAge"
  1742. msgstr ""
  1743. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1744. #: apt-ftparchive.1.xml:276
  1745. msgid ""
  1746. "Controls the number of days a contents file is allowed to be checked without "
  1747. "changing. If this limit is passed the mtime of the contents file is updated. "
  1748. "This case can occur if the package file is changed in such a way that does "
  1749. "not result in a new contents file [override edit for instance]. A hold off "
  1750. "is allowed in hopes that new .debs will be installed, requiring a new file "
  1751. "anyhow. The default is 10, the units are in days."
  1752. msgstr ""
  1753. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1754. #: apt-ftparchive.1.xml:285
  1755. msgid "Directory"
  1756. msgstr ""
  1757. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1758. #: apt-ftparchive.1.xml:287
  1759. msgid ""
  1760. "Sets the top of the .deb directory tree. Defaults to <filename>$(DIST)/"
  1761. "$(SECTION)/binary-$(ARCH)/</filename>"
  1762. msgstr ""
  1763. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1764. #: apt-ftparchive.1.xml:291
  1765. msgid "SrcDirectory"
  1766. msgstr ""
  1767. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1768. #: apt-ftparchive.1.xml:293
  1769. msgid ""
  1770. "Sets the top of the source package directory tree. Defaults to <filename>"
  1771. "$(DIST)/$(SECTION)/source/</filename>"
  1772. msgstr ""
  1773. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1774. #: apt-ftparchive.1.xml:297 apt-ftparchive.1.xml:436
  1775. msgid "Packages"
  1776. msgstr ""
  1777. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1778. #: apt-ftparchive.1.xml:299
  1779. msgid ""
  1780. "Sets the output Packages file. Defaults to <filename>$(DIST)/$(SECTION)/"
  1781. "binary-$(ARCH)/Packages</filename>"
  1782. msgstr ""
  1783. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1784. #: apt-ftparchive.1.xml:303 apt-ftparchive.1.xml:441
  1785. msgid "Sources"
  1786. msgstr ""
  1787. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1788. #: apt-ftparchive.1.xml:305
  1789. msgid ""
  1790. "Sets the output Sources file. Defaults to <filename>$(DIST)/$(SECTION)/"
  1791. "source/Sources</filename>"
  1792. msgstr ""
  1793. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1794. #: apt-ftparchive.1.xml:309
  1795. msgid "Translation"
  1796. msgstr ""
  1797. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1798. #: apt-ftparchive.1.xml:311
  1799. msgid ""
  1800. "Set the output Translation-en master file with the long descriptions if they "
  1801. "should be not included in the Packages file. Defaults to <filename>$(DIST)/"
  1802. "$(SECTION)/i18n/Translation-en</filename>"
  1803. msgstr ""
  1804. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1805. #: apt-ftparchive.1.xml:316
  1806. msgid "InternalPrefix"
  1807. msgstr ""
  1808. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1809. #: apt-ftparchive.1.xml:318
  1810. msgid ""
  1811. "Sets the path prefix that causes a symlink to be considered an internal link "
  1812. "instead of an external link. Defaults to <filename>$(DIST)/$(SECTION)/</"
  1813. "filename>"
  1814. msgstr ""
  1815. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1816. #: apt-ftparchive.1.xml:323 apt-ftparchive.1.xml:447
  1817. msgid "Contents"
  1818. msgstr ""
  1819. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1820. #: apt-ftparchive.1.xml:325
  1821. msgid ""
  1822. "Sets the output Contents file. Defaults to <filename>$(DIST)/Contents-$(ARCH)"
  1823. "</filename>. If this setting causes multiple Packages files to map onto a "
  1824. "single Contents file (such as the default) then <command>apt-ftparchive</"
  1825. "command> will integrate those package files together automatically."
  1826. msgstr ""
  1827. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1828. #: apt-ftparchive.1.xml:332
  1829. msgid "Contents::Header"
  1830. msgstr ""
  1831. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1832. #: apt-ftparchive.1.xml:334
  1833. msgid "Sets header file to prepend to the contents output."
  1834. msgstr ""
  1835. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1836. #: apt-ftparchive.1.xml:337 apt-ftparchive.1.xml:472
  1837. msgid "BinCacheDB"
  1838. msgstr ""
  1839. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1840. #: apt-ftparchive.1.xml:339
  1841. msgid ""
  1842. "Sets the binary cache database to use for this section. Multiple sections "
  1843. "can share the same database."
  1844. msgstr ""
  1845. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1846. #: apt-ftparchive.1.xml:343
  1847. msgid "FileList"
  1848. msgstr ""
  1849. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1850. #: apt-ftparchive.1.xml:345
  1851. msgid ""
  1852. "Specifies that instead of walking the directory tree, <command>apt-"
  1853. "ftparchive</command> should read the list of files from the given file. "
  1854. "Relative files names are prefixed with the archive directory."
  1855. msgstr ""
  1856. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1857. #: apt-ftparchive.1.xml:350
  1858. msgid "SourceFileList"
  1859. msgstr ""
  1860. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1861. #: apt-ftparchive.1.xml:352
  1862. msgid ""
  1863. "Specifies that instead of walking the directory tree, <command>apt-"
  1864. "ftparchive</command> should read the list of files from the given file. "
  1865. "Relative files names are prefixed with the archive directory. This is used "
  1866. "when processing source indexes."
  1867. msgstr ""
  1868. #. type: Content of: <refentry><refsect1><refsect2><title>
  1869. #: apt-ftparchive.1.xml:360
  1870. msgid "Tree Section"
  1871. msgstr ""
  1872. #. type: Content of: <refentry><refsect1><refsect2><para>
  1873. #: apt-ftparchive.1.xml:362
  1874. msgid ""
  1875. "The <literal>Tree</literal> section defines a standard Debian file tree "
  1876. "which consists of a base directory, then multiple sections in that base "
  1877. "directory and finally multiple Architectures in each section. The exact "
  1878. "pathing used is defined by the <literal>Directory</literal> substitution "
  1879. "variable."
  1880. msgstr ""
  1881. #. type: Content of: <refentry><refsect1><refsect2><para>
  1882. #: apt-ftparchive.1.xml:367
  1883. msgid ""
  1884. "The <literal>Tree</literal> section takes a scope tag which sets the "
  1885. "<literal>$(DIST)</literal> variable and defines the root of the tree (the "
  1886. "path is prefixed by <literal>ArchiveDir</literal>). Typically this is a "
  1887. "setting such as <filename>dists/&stable-codename;</filename>."
  1888. msgstr ""
  1889. #. type: Content of: <refentry><refsect1><refsect2><para>
  1890. #: apt-ftparchive.1.xml:372
  1891. msgid ""
  1892. "All of the settings defined in the <literal>TreeDefault</literal> section "
  1893. "can be use in a <literal>Tree</literal> section as well as three new "
  1894. "variables."
  1895. msgstr ""
  1896. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  1897. #: apt-ftparchive.1.xml:378
  1898. #, no-wrap
  1899. msgid ""
  1900. "for i in Sections do \n"
  1901. " for j in Architectures do\n"
  1902. " Generate for DIST=scope SECTION=i ARCH=j\n"
  1903. " "
  1904. msgstr ""
  1905. #. type: Content of: <refentry><refsect1><refsect2><para>
  1906. #: apt-ftparchive.1.xml:375
  1907. msgid ""
  1908. "When processing a <literal>Tree</literal> section <command>apt-ftparchive</"
  1909. "command> performs an operation similar to: <placeholder type=\"programlisting"
  1910. "\" id=\"0\"/>"
  1911. msgstr ""
  1912. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1913. #: apt-ftparchive.1.xml:384
  1914. msgid "Sections"
  1915. msgstr ""
  1916. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1917. #: apt-ftparchive.1.xml:386
  1918. msgid ""
  1919. "This is a space separated list of sections which appear under the "
  1920. "distribution, typically this is something like <literal>main contrib non-"
  1921. "free</literal>"
  1922. msgstr ""
  1923. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1924. #: apt-ftparchive.1.xml:391
  1925. msgid "Architectures"
  1926. msgstr ""
  1927. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1928. #: apt-ftparchive.1.xml:393
  1929. msgid ""
  1930. "This is a space separated list of all the architectures that appear under "
  1931. "search section. The special architecture 'source' is used to indicate that "
  1932. "this tree has a source archive."
  1933. msgstr ""
  1934. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1935. #: apt-ftparchive.1.xml:404 apt-ftparchive.1.xml:452
  1936. msgid "BinOverride"
  1937. msgstr ""
  1938. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1939. #: apt-ftparchive.1.xml:406
  1940. msgid ""
  1941. "Sets the binary override file. The override file contains section, priority "
  1942. "and maintainer address information."
  1943. msgstr ""
  1944. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1945. #: apt-ftparchive.1.xml:410 apt-ftparchive.1.xml:457
  1946. msgid "SrcOverride"
  1947. msgstr ""
  1948. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1949. #: apt-ftparchive.1.xml:412
  1950. msgid ""
  1951. "Sets the source override file. The override file contains section "
  1952. "information."
  1953. msgstr ""
  1954. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1955. #: apt-ftparchive.1.xml:416 apt-ftparchive.1.xml:462
  1956. msgid "ExtraOverride"
  1957. msgstr ""
  1958. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1959. #: apt-ftparchive.1.xml:418 apt-ftparchive.1.xml:464
  1960. msgid "Sets the binary extra override file."
  1961. msgstr ""
  1962. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1963. #: apt-ftparchive.1.xml:421 apt-ftparchive.1.xml:467
  1964. msgid "SrcExtraOverride"
  1965. msgstr ""
  1966. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1967. #: apt-ftparchive.1.xml:423 apt-ftparchive.1.xml:469
  1968. msgid "Sets the source extra override file."
  1969. msgstr ""
  1970. #. type: Content of: <refentry><refsect1><refsect2><title>
  1971. #: apt-ftparchive.1.xml:428
  1972. msgid "BinDirectory Section"
  1973. msgstr ""
  1974. #. type: Content of: <refentry><refsect1><refsect2><para>
  1975. #: apt-ftparchive.1.xml:430
  1976. msgid ""
  1977. "The <literal>bindirectory</literal> section defines a binary directory tree "
  1978. "with no special structure. The scope tag specifies the location of the "
  1979. "binary directory and the settings are similar to the <literal>Tree</literal> "
  1980. "section with no substitution variables or <literal>Section</"
  1981. "literal><literal>Architecture</literal> settings."
  1982. msgstr ""
  1983. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1984. #: apt-ftparchive.1.xml:438
  1985. msgid "Sets the Packages file output."
  1986. msgstr ""
  1987. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1988. #: apt-ftparchive.1.xml:443
  1989. msgid ""
  1990. "Sets the Sources file output. At least one of <literal>Packages</literal> or "
  1991. "<literal>Sources</literal> is required."
  1992. msgstr ""
  1993. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1994. #: apt-ftparchive.1.xml:449
  1995. msgid "Sets the Contents file output. (optional)"
  1996. msgstr ""
  1997. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1998. #: apt-ftparchive.1.xml:454
  1999. msgid "Sets the binary override file."
  2000. msgstr ""
  2001. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2002. #: apt-ftparchive.1.xml:459
  2003. msgid "Sets the source override file."
  2004. msgstr ""
  2005. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2006. #: apt-ftparchive.1.xml:474
  2007. msgid "Sets the cache DB."
  2008. msgstr ""
  2009. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2010. #: apt-ftparchive.1.xml:477
  2011. msgid "PathPrefix"
  2012. msgstr ""
  2013. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2014. #: apt-ftparchive.1.xml:479
  2015. msgid "Appends a path to all the output paths."
  2016. msgstr ""
  2017. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2018. #: apt-ftparchive.1.xml:482
  2019. msgid "FileList, SourceFileList"
  2020. msgstr ""
  2021. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2022. #: apt-ftparchive.1.xml:484
  2023. msgid "Specifies the file list file."
  2024. msgstr ""
  2025. #. type: Content of: <refentry><refsect1><title>
  2026. #: apt-ftparchive.1.xml:491
  2027. msgid "The Binary Override File"
  2028. msgstr ""
  2029. #. type: Content of: <refentry><refsect1><para>
  2030. #: apt-ftparchive.1.xml:492
  2031. msgid ""
  2032. "The binary override file is fully compatible with &dpkg-scanpackages;. It "
  2033. "contains 4 fields separated by spaces. The first field is the package name, "
  2034. "the second is the priority to force that package to, the third is the the "
  2035. "section to force that package to and the final field is the maintainer "
  2036. "permutation field."
  2037. msgstr ""
  2038. #. type: Content of: <refentry><refsect1><para><literallayout>
  2039. #: apt-ftparchive.1.xml:498
  2040. #, no-wrap
  2041. msgid "old [// oldn]* => new"
  2042. msgstr ""
  2043. #. type: Content of: <refentry><refsect1><para><literallayout>
  2044. #: apt-ftparchive.1.xml:500
  2045. #, no-wrap
  2046. msgid "new"
  2047. msgstr ""
  2048. #. type: Content of: <refentry><refsect1><para>
  2049. #: apt-ftparchive.1.xml:497
  2050. msgid ""
  2051. "The general form of the maintainer field is: <placeholder type="
  2052. "\"literallayout\" id=\"0\"/> or simply, <placeholder type=\"literallayout\" "
  2053. "id=\"1\"/> The first form allows a double-slash separated list of old email "
  2054. "addresses to be specified. If any of those are found then new is substituted "
  2055. "for the maintainer field. The second form unconditionally substitutes the "
  2056. "maintainer field."
  2057. msgstr ""
  2058. #. type: Content of: <refentry><refsect1><title>
  2059. #: apt-ftparchive.1.xml:508
  2060. msgid "The Source Override File"
  2061. msgstr ""
  2062. #. type: Content of: <refentry><refsect1><para>
  2063. #: apt-ftparchive.1.xml:510
  2064. msgid ""
  2065. "The source override file is fully compatible with &dpkg-scansources;. It "
  2066. "contains 2 fields separated by spaces. The first fields is the source "
  2067. "package name, the second is the section to assign it."
  2068. msgstr ""
  2069. #. type: Content of: <refentry><refsect1><title>
  2070. #: apt-ftparchive.1.xml:515
  2071. msgid "The Extra Override File"
  2072. msgstr ""
  2073. #. type: Content of: <refentry><refsect1><para>
  2074. #: apt-ftparchive.1.xml:517
  2075. msgid ""
  2076. "The extra override file allows any arbitrary tag to be added or replaced in "
  2077. "the output. It has 3 columns, the first is the package, the second is the "
  2078. "tag and the remainder of the line is the new value."
  2079. msgstr ""
  2080. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2081. #: apt-ftparchive.1.xml:526
  2082. msgid "<option>--md5</option>"
  2083. msgstr ""
  2084. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2085. #: apt-ftparchive.1.xml:528
  2086. msgid ""
  2087. "Generate MD5 sums. This defaults to on, when turned off the generated index "
  2088. "files will not have MD5Sum fields where possible. Configuration Item: "
  2089. "<literal>APT::FTPArchive::MD5</literal>"
  2090. msgstr ""
  2091. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2092. #: apt-ftparchive.1.xml:533
  2093. msgid "<option>--db</option>"
  2094. msgstr ""
  2095. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2096. #: apt-ftparchive.1.xml:535
  2097. msgid ""
  2098. "Use a binary caching DB. This has no effect on the generate command. "
  2099. "Configuration Item: <literal>APT::FTPArchive::DB</literal>."
  2100. msgstr ""
  2101. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2102. #: apt-ftparchive.1.xml:541
  2103. msgid ""
  2104. "Quiet; produces output suitable for logging, omitting progress indicators. "
  2105. "More q's will produce more quiet up to a maximum of 2. You can also use "
  2106. "<option>-q=#</option> to set the quiet level, overriding the configuration "
  2107. "file. Configuration Item: <literal>quiet</literal>."
  2108. msgstr ""
  2109. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2110. #: apt-ftparchive.1.xml:547
  2111. msgid "<option>--delink</option>"
  2112. msgstr ""
  2113. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2114. #: apt-ftparchive.1.xml:549
  2115. msgid ""
  2116. "Perform Delinking. If the <literal>External-Links</literal> setting is used "
  2117. "then this option actually enables delinking of the files. It defaults to on "
  2118. "and can be turned off with <option>--no-delink</option>. Configuration "
  2119. "Item: <literal>APT::FTPArchive::DeLinkAct</literal>."
  2120. msgstr ""
  2121. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2122. #: apt-ftparchive.1.xml:555
  2123. msgid "<option>--contents</option>"
  2124. msgstr ""
  2125. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2126. #: apt-ftparchive.1.xml:557
  2127. msgid ""
  2128. "Perform contents generation. When this option is set and package indexes are "
  2129. "being generated with a cache DB then the file listing will also be extracted "
  2130. "and stored in the DB for later use. When using the generate command this "
  2131. "option also allows the creation of any Contents files. The default is on. "
  2132. "Configuration Item: <literal>APT::FTPArchive::Contents</literal>."
  2133. msgstr ""
  2134. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2135. #: apt-ftparchive.1.xml:565
  2136. msgid "<option>--source-override</option>"
  2137. msgstr ""
  2138. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2139. #: apt-ftparchive.1.xml:567
  2140. msgid ""
  2141. "Select the source override file to use with the <literal>sources</literal> "
  2142. "command. Configuration Item: <literal>APT::FTPArchive::SourceOverride</"
  2143. "literal>."
  2144. msgstr ""
  2145. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2146. #: apt-ftparchive.1.xml:571
  2147. msgid "<option>--readonly</option>"
  2148. msgstr ""
  2149. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2150. #: apt-ftparchive.1.xml:573
  2151. msgid ""
  2152. "Make the caching databases read only. Configuration Item: <literal>APT::"
  2153. "FTPArchive::ReadOnlyDB</literal>."
  2154. msgstr ""
  2155. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2156. #: apt-ftparchive.1.xml:577
  2157. msgid "<option>--arch</option>"
  2158. msgstr ""
  2159. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2160. #: apt-ftparchive.1.xml:578
  2161. msgid ""
  2162. "Accept in the <literal>packages</literal> and <literal>contents</literal> "
  2163. "commands only package files matching <literal>*_arch.deb</literal> or "
  2164. "<literal>*_all.deb</literal> instead of all package files in the given "
  2165. "path. Configuration Item: <literal>APT::FTPArchive::Architecture</literal>."
  2166. msgstr ""
  2167. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2168. #: apt-ftparchive.1.xml:584
  2169. msgid "<option>APT::FTPArchive::AlwaysStat</option>"
  2170. msgstr ""
  2171. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2172. #: apt-ftparchive.1.xml:586
  2173. msgid ""
  2174. "&apt-ftparchive; caches as much as possible of metadata in a cachedb. If "
  2175. "packages are recompiled and/or republished with the same version again, this "
  2176. "will lead to problems as the now outdated cached metadata like size and "
  2177. "checksums will be used. With this option enabled this will no longer happen "
  2178. "as it will be checked if the file was changed. Note that this option is set "
  2179. "to \"<literal>false</literal>\" by default as it is not recommend to upload "
  2180. "multiply versions/builds of a package with the same versionnumber, so in "
  2181. "theory nobody will have these problems and therefore all these extra checks "
  2182. "are useless."
  2183. msgstr ""
  2184. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2185. #: apt-ftparchive.1.xml:596
  2186. msgid "<option>APT::FTPArchive::LongDescription</option>"
  2187. msgstr ""
  2188. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2189. #: apt-ftparchive.1.xml:598
  2190. msgid ""
  2191. "This configuration option defaults to \"<literal>true</literal>\" and should "
  2192. "only be set to <literal>\"false\"</literal> if the Archive generated with "
  2193. "&apt-ftparchive; also provides <filename>Translation</filename> files. Note "
  2194. "that the <filename>Translation-en</filename> master file can only be created "
  2195. "in the generate command."
  2196. msgstr ""
  2197. #. type: Content of: <refentry><refsect1><title>
  2198. #: apt-ftparchive.1.xml:610 apt.conf.5.xml:1086 apt_preferences.5.xml:494
  2199. #: sources.list.5.xml:196
  2200. msgid "Examples"
  2201. msgstr ""
  2202. #. type: Content of: <refentry><refsect1><para><programlisting>
  2203. #: apt-ftparchive.1.xml:616
  2204. #, no-wrap
  2205. msgid "<command>apt-ftparchive</command> packages <replaceable>directory</replaceable> | <command>gzip</command> > <filename>Packages.gz</filename>\n"
  2206. msgstr ""
  2207. #. type: Content of: <refentry><refsect1><para>
  2208. #: apt-ftparchive.1.xml:612
  2209. msgid ""
  2210. "To create a compressed Packages file for a directory containing binary "
  2211. "packages (.deb): <placeholder type=\"programlisting\" id=\"0\"/>"
  2212. msgstr ""
  2213. #. type: Content of: <refentry><refsect1><para>
  2214. #: apt-ftparchive.1.xml:626
  2215. msgid ""
  2216. "<command>apt-ftparchive</command> returns zero on normal operation, decimal "
  2217. "100 on error."
  2218. msgstr ""
  2219. #. The last update date
  2220. #. type: Content of: <refentry><refentryinfo>
  2221. #: apt-get.8.xml:16
  2222. msgid ""
  2223. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>08 "
  2224. "November 2008</date>"
  2225. msgstr ""
  2226. #. type: <heading></heading>
  2227. #: apt-get.8.xml:25 apt-get.8.xml:32 guide.sgml:96
  2228. #, fuzzy
  2229. msgid "apt-get"
  2230. msgstr "apt-get"
  2231. #. type: Content of: <refentry><refnamediv><refpurpose>
  2232. #: apt-get.8.xml:33
  2233. msgid "APT package handling utility -- command-line interface"
  2234. msgstr ""
  2235. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  2236. #: apt-get.8.xml:39
  2237. msgid ""
  2238. "<command>apt-get</command> <arg><option>-sqdyfmubV</option></arg> <arg> "
  2239. "<option>-o= <replaceable>config_string</replaceable> </option> </arg> <arg> "
  2240. "<option>-c= <replaceable>config_file</replaceable> </option> </arg> <arg> "
  2241. "<option>-t=</option> <arg choice='plain'> <replaceable>target_release</"
  2242. "replaceable> </arg> </arg> <group choice=\"req\"> <arg "
  2243. "choice='plain'>update</arg> <arg choice='plain'>upgrade</arg> <arg "
  2244. "choice='plain'>dselect-upgrade</arg> <arg choice='plain'>dist-upgrade</arg> "
  2245. "<arg choice='plain'>install <arg choice=\"plain\" rep=\"repeat"
  2246. "\"><replaceable>pkg</replaceable> <arg> <group choice='req'> <arg "
  2247. "choice='plain'> =<replaceable>pkg_version_number</replaceable> </arg> <arg "
  2248. "choice='plain'> /<replaceable>target_release</replaceable> </arg> </group> </"
  2249. "arg> </arg> </arg> <arg choice='plain'>remove <arg choice=\"plain\" rep="
  2250. "\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg "
  2251. "choice='plain'>purge <arg choice=\"plain\" rep=\"repeat\"><replaceable>pkg</"
  2252. "replaceable></arg></arg> <arg choice='plain'>source <arg choice=\"plain\" "
  2253. "rep=\"repeat\"><replaceable>pkg</replaceable> <arg> <group choice='req'> "
  2254. "<arg choice='plain'> =<replaceable>pkg_version_number</replaceable> </arg> "
  2255. "<arg choice='plain'> /<replaceable>target_release</replaceable> </arg> </"
  2256. "group> </arg> </arg> </arg> <arg choice='plain'>build-dep <arg choice=\"plain"
  2257. "\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg "
  2258. "choice='plain'>check</arg> <arg choice='plain'>clean</arg> <arg "
  2259. "choice='plain'>autoclean</arg> <arg choice='plain'>autoremove</arg> <arg "
  2260. "choice='plain'> <group choice='req'> <arg choice='plain'>-v</arg> <arg "
  2261. "choice='plain'>--version</arg> </group> </arg> <arg choice='plain'> <group "
  2262. "choice='req'> <arg choice='plain'>-h</arg> <arg choice='plain'>--help</arg> "
  2263. "</group> </arg> </group>"
  2264. msgstr ""
  2265. #. type: Content of: <refentry><refsect1><para>
  2266. #: apt-get.8.xml:115
  2267. msgid ""
  2268. "<command>apt-get</command> is the command-line tool for handling packages, "
  2269. "and may be considered the user's \"back-end\" to other tools using the APT "
  2270. "library. Several \"front-end\" interfaces exist, such as &dselect;, "
  2271. "&aptitude;, &synaptic; and &wajig;."
  2272. msgstr ""
  2273. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2274. #: apt-get.8.xml:124 apt-key.8.xml:127
  2275. #, fuzzy
  2276. msgid "update"
  2277. msgstr "upgrade"
  2278. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2279. #: apt-get.8.xml:125
  2280. msgid ""
  2281. "<literal>update</literal> is used to resynchronize the package index files "
  2282. "from their sources. The indexes of available packages are fetched from the "
  2283. "location(s) specified in <filename>/etc/apt/sources.list</filename>. For "
  2284. "example, when using a Debian archive, this command retrieves and scans the "
  2285. "<filename>Packages.gz</filename> files, so that information about new and "
  2286. "updated packages is available. An <literal>update</literal> should always be "
  2287. "performed before an <literal>upgrade</literal> or <literal>dist-upgrade</"
  2288. "literal>. Please be aware that the overall progress meter will be incorrect "
  2289. "as the size of the package files cannot be known in advance."
  2290. msgstr ""
  2291. #. type: <tag></tag>
  2292. #: apt-get.8.xml:136 guide.sgml:121
  2293. #, fuzzy
  2294. msgid "upgrade"
  2295. msgstr "upgrade"
  2296. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2297. #: apt-get.8.xml:137
  2298. msgid ""
  2299. "<literal>upgrade</literal> is used to install the newest versions of all "
  2300. "packages currently installed on the system from the sources enumerated in "
  2301. "<filename>/etc/apt/sources.list</filename>. Packages currently installed "
  2302. "with new versions available are retrieved and upgraded; under no "
  2303. "circumstances are currently installed packages removed, or packages not "
  2304. "already installed retrieved and installed. New versions of currently "
  2305. "installed packages that cannot be upgraded without changing the install "
  2306. "status of another package will be left at their current version. An "
  2307. "<literal>update</literal> must be performed first so that <command>apt-get</"
  2308. "command> knows that new versions of packages are available."
  2309. msgstr ""
  2310. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2311. #: apt-get.8.xml:149
  2312. #, fuzzy
  2313. msgid "dselect-upgrade"
  2314. msgstr "dist-upgrade"
  2315. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2316. #: apt-get.8.xml:150
  2317. msgid ""
  2318. "<literal>dselect-upgrade</literal> is used in conjunction with the "
  2319. "traditional Debian packaging front-end, &dselect;. <literal>dselect-upgrade</"
  2320. "literal> follows the changes made by &dselect; to the <literal>Status</"
  2321. "literal> field of available packages, and performs the actions necessary to "
  2322. "realize that state (for instance, the removal of old and the installation of "
  2323. "new packages)."
  2324. msgstr ""
  2325. #. type: <tag></tag>
  2326. #: apt-get.8.xml:159 guide.sgml:140
  2327. #, fuzzy
  2328. msgid "dist-upgrade"
  2329. msgstr "dist-upgrade"
  2330. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2331. #: apt-get.8.xml:160
  2332. msgid ""
  2333. "<literal>dist-upgrade</literal> in addition to performing the function of "
  2334. "<literal>upgrade</literal>, also intelligently handles changing dependencies "
  2335. "with new versions of packages; <command>apt-get</command> has a \"smart\" "
  2336. "conflict resolution system, and it will attempt to upgrade the most "
  2337. "important packages at the expense of less important ones if necessary. So, "
  2338. "<literal>dist-upgrade</literal> command may remove some packages. The "
  2339. "<filename>/etc/apt/sources.list</filename> file contains a list of locations "
  2340. "from which to retrieve desired package files. See also &apt-preferences; "
  2341. "for a mechanism for overriding the general settings for individual packages."
  2342. msgstr ""
  2343. #. type: <tag></tag>
  2344. #: apt-get.8.xml:172 guide.sgml:131
  2345. #, fuzzy
  2346. msgid "install"
  2347. msgstr "install"
  2348. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2349. #: apt-get.8.xml:174
  2350. msgid ""
  2351. "<literal>install</literal> is followed by one or more packages desired for "
  2352. "installation or upgrading. Each package is a package name, not a fully "
  2353. "qualified filename (for instance, in a Debian GNU/Linux system, libc6 would "
  2354. "be the argument provided, not <literal>libc6_1.9.6-2.deb</literal>). All "
  2355. "packages required by the package(s) specified for installation will also be "
  2356. "retrieved and installed. The <filename>/etc/apt/sources.list</filename> "
  2357. "file is used to locate the desired packages. If a hyphen is appended to the "
  2358. "package name (with no intervening space), the identified package will be "
  2359. "removed if it is installed. Similarly a plus sign can be used to designate "
  2360. "a package to install. These latter features may be used to override "
  2361. "decisions made by apt-get's conflict resolution system."
  2362. msgstr ""
  2363. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2364. #: apt-get.8.xml:192
  2365. msgid ""
  2366. "A specific version of a package can be selected for installation by "
  2367. "following the package name with an equals and the version of the package to "
  2368. "select. This will cause that version to be located and selected for install. "
  2369. "Alternatively a specific distribution can be selected by following the "
  2370. "package name with a slash and the version of the distribution or the Archive "
  2371. "name (stable, testing, unstable)."
  2372. msgstr ""
  2373. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2374. #: apt-get.8.xml:199
  2375. msgid ""
  2376. "Both of the version selection mechanisms can downgrade packages and must be "
  2377. "used with care."
  2378. msgstr ""
  2379. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2380. #: apt-get.8.xml:202
  2381. msgid ""
  2382. "This is also the target to use if you want to upgrade one or more already-"
  2383. "installed packages without upgrading every package you have on your system. "
  2384. "Unlike the \"upgrade\" target, which installs the newest version of all "
  2385. "currently installed packages, \"install\" will install the newest version of "
  2386. "only the package(s) specified. Simply provide the name of the package(s) "
  2387. "you wish to upgrade, and if a newer version is available, it (and its "
  2388. "dependencies, as described above) will be downloaded and installed."
  2389. msgstr ""
  2390. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2391. #: apt-get.8.xml:213
  2392. msgid ""
  2393. "Finally, the &apt-preferences; mechanism allows you to create an alternative "
  2394. "installation policy for individual packages."
  2395. msgstr ""
  2396. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2397. #: apt-get.8.xml:217
  2398. msgid ""
  2399. "If no package matches the given expression and the expression contains one "
  2400. "of '.', '?' or '*' then it is assumed to be a POSIX regular expression, and "
  2401. "it is applied to all package names in the database. Any matches are then "
  2402. "installed (or removed). Note that matching is done by substring so 'lo.*' "
  2403. "matches 'how-lo' and 'lowest'. If this is undesired, anchor the regular "
  2404. "expression with a '^' or '$' character, or create a more specific regular "
  2405. "expression."
  2406. msgstr ""
  2407. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2408. #: apt-get.8.xml:226
  2409. msgid "remove"
  2410. msgstr ""
  2411. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2412. #: apt-get.8.xml:227
  2413. msgid ""
  2414. "<literal>remove</literal> is identical to <literal>install</literal> except "
  2415. "that packages are removed instead of installed. Note the removing a package "
  2416. "leaves its configuration files in system. If a plus sign is appended to the "
  2417. "package name (with no intervening space), the identified package will be "
  2418. "installed instead of removed."
  2419. msgstr ""
  2420. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2421. #: apt-get.8.xml:234
  2422. msgid "purge"
  2423. msgstr ""
  2424. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2425. #: apt-get.8.xml:235
  2426. msgid ""
  2427. "<literal>purge</literal> is identical to <literal>remove</literal> except "
  2428. "that packages are removed and purged (any configuration files are deleted "
  2429. "too)."
  2430. msgstr ""
  2431. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2432. #: apt-get.8.xml:239
  2433. msgid "source"
  2434. msgstr ""
  2435. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2436. #: apt-get.8.xml:240
  2437. msgid ""
  2438. "<literal>source</literal> causes <command>apt-get</command> to fetch source "
  2439. "packages. APT will examine the available packages to decide which source "
  2440. "package to fetch. It will then find and download into the current directory "
  2441. "the newest available version of that source package while respect the "
  2442. "default release, set with the option <literal>APT::Default-Release</"
  2443. "literal>, the <option>-t</option> option or per package with the "
  2444. "<literal>pkg/release</literal> syntax, if possible."
  2445. msgstr ""
  2446. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2447. #: apt-get.8.xml:248
  2448. msgid ""
  2449. "Source packages are tracked separately from binary packages via <literal>deb-"
  2450. "src</literal> type lines in the &sources-list; file. This means that you "
  2451. "will need to add such a line for each repository you want to get sources "
  2452. "from. If you don't do this you will properly get another (newer, older or "
  2453. "none) source version than the one you have installed or could install."
  2454. msgstr ""
  2455. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2456. #: apt-get.8.xml:255
  2457. msgid ""
  2458. "If the <option>--compile</option> option is specified then the package will "
  2459. "be compiled to a binary .deb using <command>dpkg-buildpackage</command>, if "
  2460. "<option>--download-only</option> is specified then the source package will "
  2461. "not be unpacked."
  2462. msgstr ""
  2463. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2464. #: apt-get.8.xml:260
  2465. msgid ""
  2466. "A specific source version can be retrieved by postfixing the source name "
  2467. "with an equals and then the version to fetch, similar to the mechanism used "
  2468. "for the package files. This enables exact matching of the source package "
  2469. "name and version, implicitly enabling the <literal>APT::Get::Only-Source</"
  2470. "literal> option."
  2471. msgstr ""
  2472. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2473. #: apt-get.8.xml:266
  2474. msgid ""
  2475. "Note that source packages are not tracked like binary packages, they exist "
  2476. "only in the current directory and are similar to downloading source tar "
  2477. "balls."
  2478. msgstr ""
  2479. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2480. #: apt-get.8.xml:271
  2481. msgid "build-dep"
  2482. msgstr ""
  2483. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2484. #: apt-get.8.xml:272
  2485. msgid ""
  2486. "<literal>build-dep</literal> causes apt-get to install/remove packages in an "
  2487. "attempt to satisfy the build dependencies for a source package."
  2488. msgstr ""
  2489. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2490. #: apt-get.8.xml:276
  2491. msgid "check"
  2492. msgstr ""
  2493. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2494. #: apt-get.8.xml:277
  2495. msgid ""
  2496. "<literal>check</literal> is a diagnostic tool; it updates the package cache "
  2497. "and checks for broken dependencies."
  2498. msgstr ""
  2499. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2500. #: apt-get.8.xml:282
  2501. msgid ""
  2502. "<literal>clean</literal> clears out the local repository of retrieved "
  2503. "package files. It removes everything but the lock file from "
  2504. "<filename>&cachedir;/archives/</filename> and <filename>&cachedir;/archives/"
  2505. "partial/</filename>. When APT is used as a &dselect; method, <literal>clean</"
  2506. "literal> is run automatically. Those who do not use dselect will likely "
  2507. "want to run <literal>apt-get clean</literal> from time to time to free up "
  2508. "disk space."
  2509. msgstr ""
  2510. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2511. #: apt-get.8.xml:291
  2512. msgid "autoclean"
  2513. msgstr ""
  2514. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2515. #: apt-get.8.xml:292
  2516. msgid ""
  2517. "Like <literal>clean</literal>, <literal>autoclean</literal> clears out the "
  2518. "local repository of retrieved package files. The difference is that it only "
  2519. "removes package files that can no longer be downloaded, and are largely "
  2520. "useless. This allows a cache to be maintained over a long period without it "
  2521. "growing out of control. The configuration option <literal>APT::Clean-"
  2522. "Installed</literal> will prevent installed packages from being erased if it "
  2523. "is set to off."
  2524. msgstr ""
  2525. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2526. #: apt-get.8.xml:301
  2527. msgid "autoremove"
  2528. msgstr ""
  2529. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2530. #: apt-get.8.xml:302
  2531. msgid ""
  2532. "<literal>autoremove</literal> is used to remove packages that were "
  2533. "automatically installed to satisfy dependencies for some package and that "
  2534. "are no more needed."
  2535. msgstr ""
  2536. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2537. #: apt-get.8.xml:312 apt-get.8.xml:418
  2538. msgid "<option>--no-install-recommends</option>"
  2539. msgstr ""
  2540. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2541. #: apt-get.8.xml:313
  2542. msgid ""
  2543. "Do not consider recommended packages as a dependency for installing. "
  2544. "Configuration Item: <literal>APT::Install-Recommends</literal>."
  2545. msgstr ""
  2546. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2547. #: apt-get.8.xml:317
  2548. msgid "<option>--download-only</option>"
  2549. msgstr ""
  2550. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2551. #: apt-get.8.xml:318
  2552. msgid ""
  2553. "Download only; package files are only retrieved, not unpacked or installed. "
  2554. "Configuration Item: <literal>APT::Get::Download-Only</literal>."
  2555. msgstr ""
  2556. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2557. #: apt-get.8.xml:322
  2558. msgid "<option>--fix-broken</option>"
  2559. msgstr ""
  2560. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2561. #: apt-get.8.xml:323
  2562. msgid ""
  2563. "Fix; attempt to correct a system with broken dependencies in place. This "
  2564. "option, when used with install/remove, can omit any packages to permit APT "
  2565. "to deduce a likely solution. If packages are specified, these have to "
  2566. "completely correct the problem. The option is sometimes necessary when "
  2567. "running APT for the first time; APT itself does not allow broken package "
  2568. "dependencies to exist on a system. It is possible that a system's dependency "
  2569. "structure can be so corrupt as to require manual intervention (which usually "
  2570. "means using &dselect; or <command>dpkg --remove</command> to eliminate some "
  2571. "of the offending packages). Use of this option together with <option>-m</"
  2572. "option> may produce an error in some situations. Configuration Item: "
  2573. "<literal>APT::Get::Fix-Broken</literal>."
  2574. msgstr ""
  2575. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2576. #: apt-get.8.xml:336
  2577. msgid "<option>--ignore-missing</option>"
  2578. msgstr ""
  2579. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2580. #: apt-get.8.xml:337
  2581. msgid "<option>--fix-missing</option>"
  2582. msgstr ""
  2583. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2584. #: apt-get.8.xml:338
  2585. msgid ""
  2586. "Ignore missing packages; If packages cannot be retrieved or fail the "
  2587. "integrity check after retrieval (corrupted package files), hold back those "
  2588. "packages and handle the result. Use of this option together with <option>-f</"
  2589. "option> may produce an error in some situations. If a package is selected "
  2590. "for installation (particularly if it is mentioned on the command line) and "
  2591. "it could not be downloaded then it will be silently held back. "
  2592. "Configuration Item: <literal>APT::Get::Fix-Missing</literal>."
  2593. msgstr ""
  2594. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2595. #: apt-get.8.xml:348
  2596. msgid "<option>--no-download</option>"
  2597. msgstr ""
  2598. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2599. #: apt-get.8.xml:349
  2600. msgid ""
  2601. "Disables downloading of packages. This is best used with <option>--ignore-"
  2602. "missing</option> to force APT to use only the .debs it has already "
  2603. "downloaded. Configuration Item: <literal>APT::Get::Download</literal>."
  2604. msgstr ""
  2605. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2606. #: apt-get.8.xml:356
  2607. msgid ""
  2608. "Quiet; produces output suitable for logging, omitting progress indicators. "
  2609. "More q's will produce more quiet up to a maximum of 2. You can also use "
  2610. "<option>-q=#</option> to set the quiet level, overriding the configuration "
  2611. "file. Note that quiet level 2 implies <option>-y</option>, you should never "
  2612. "use -qq without a no-action modifier such as -d, --print-uris or -s as APT "
  2613. "may decided to do something you did not expect. Configuration Item: "
  2614. "<literal>quiet</literal>."
  2615. msgstr ""
  2616. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2617. #: apt-get.8.xml:366
  2618. msgid "<option>--simulate</option>"
  2619. msgstr ""
  2620. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2621. #: apt-get.8.xml:368
  2622. msgid "<option>--dry-run</option>"
  2623. msgstr ""
  2624. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2625. #: apt-get.8.xml:371
  2626. msgid ""
  2627. "No action; perform a simulation of events that would occur but do not "
  2628. "actually change the system. Configuration Item: <literal>APT::Get::"
  2629. "Simulate</literal>."
  2630. msgstr ""
  2631. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2632. #: apt-get.8.xml:375
  2633. msgid ""
  2634. "Simulation run as user will deactivate locking (<literal>Debug::NoLocking</"
  2635. "literal>) automatic. Also a notice will be displayed indicating that this "
  2636. "is only a simulation, if the option <literal>APT::Get::Show-User-Simulation-"
  2637. "Note</literal> is set (Default: true). Neither NoLocking nor the notice "
  2638. "will be triggered if run as root (root should know what he is doing without "
  2639. "further warnings by <literal>apt-get</literal>)."
  2640. msgstr ""
  2641. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2642. #: apt-get.8.xml:381
  2643. msgid ""
  2644. "Simulate prints out a series of lines each one representing a dpkg "
  2645. "operation, Configure (Conf), Remove (Remv), Unpack (Inst). Square brackets "
  2646. "indicate broken packages and empty set of square brackets meaning breaks "
  2647. "that are of no consequence (rare)."
  2648. msgstr ""
  2649. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2650. #: apt-get.8.xml:388
  2651. msgid "<option>-y</option>"
  2652. msgstr ""
  2653. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2654. #: apt-get.8.xml:388
  2655. msgid "<option>--yes</option>"
  2656. msgstr ""
  2657. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2658. #: apt-get.8.xml:389
  2659. msgid "<option>--assume-yes</option>"
  2660. msgstr ""
  2661. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2662. #: apt-get.8.xml:390
  2663. msgid ""
  2664. "Automatic yes to prompts; assume \"yes\" as answer to all prompts and run "
  2665. "non-interactively. If an undesirable situation, such as changing a held "
  2666. "package, trying to install a unauthenticated package or removing an "
  2667. "essential package occurs then <literal>apt-get</literal> will abort. "
  2668. "Configuration Item: <literal>APT::Get::Assume-Yes</literal>."
  2669. msgstr ""
  2670. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2671. #: apt-get.8.xml:397
  2672. msgid "<option>-u</option>"
  2673. msgstr ""
  2674. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2675. #: apt-get.8.xml:397
  2676. msgid "<option>--show-upgraded</option>"
  2677. msgstr ""
  2678. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2679. #: apt-get.8.xml:398
  2680. msgid ""
  2681. "Show upgraded packages; Print out a list of all packages that are to be "
  2682. "upgraded. Configuration Item: <literal>APT::Get::Show-Upgraded</literal>."
  2683. msgstr ""
  2684. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2685. #: apt-get.8.xml:403
  2686. msgid "<option>-V</option>"
  2687. msgstr ""
  2688. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2689. #: apt-get.8.xml:403
  2690. msgid "<option>--verbose-versions</option>"
  2691. msgstr ""
  2692. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2693. #: apt-get.8.xml:404
  2694. msgid ""
  2695. "Show full versions for upgraded and installed packages. Configuration Item: "
  2696. "<literal>APT::Get::Show-Versions</literal>."
  2697. msgstr ""
  2698. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2699. #: apt-get.8.xml:408
  2700. msgid "<option>-b</option>"
  2701. msgstr ""
  2702. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2703. #: apt-get.8.xml:408
  2704. msgid "<option>--compile</option>"
  2705. msgstr ""
  2706. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2707. #: apt-get.8.xml:409
  2708. msgid "<option>--build</option>"
  2709. msgstr ""
  2710. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2711. #: apt-get.8.xml:410
  2712. msgid ""
  2713. "Compile source packages after downloading them. Configuration Item: "
  2714. "<literal>APT::Get::Compile</literal>."
  2715. msgstr ""
  2716. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2717. #: apt-get.8.xml:414
  2718. msgid "<option>--install-recommends</option>"
  2719. msgstr ""
  2720. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2721. #: apt-get.8.xml:415
  2722. msgid "Also install recommended packages."
  2723. msgstr ""
  2724. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2725. #: apt-get.8.xml:419
  2726. msgid "Do not install recommended packages."
  2727. msgstr ""
  2728. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2729. #: apt-get.8.xml:422
  2730. msgid "<option>--ignore-hold</option>"
  2731. msgstr ""
  2732. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2733. #: apt-get.8.xml:423
  2734. msgid ""
  2735. "Ignore package Holds; This causes <command>apt-get</command> to ignore a "
  2736. "hold placed on a package. This may be useful in conjunction with "
  2737. "<literal>dist-upgrade</literal> to override a large number of undesired "
  2738. "holds. Configuration Item: <literal>APT::Ignore-Hold</literal>."
  2739. msgstr ""
  2740. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2741. #: apt-get.8.xml:429
  2742. msgid "<option>--no-upgrade</option>"
  2743. msgstr ""
  2744. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2745. #: apt-get.8.xml:430
  2746. msgid ""
  2747. "Do not upgrade packages; When used in conjunction with <literal>install</"
  2748. "literal>, <literal>no-upgrade</literal> will prevent packages on the command "
  2749. "line from being upgraded if they are already installed. Configuration Item: "
  2750. "<literal>APT::Get::Upgrade</literal>."
  2751. msgstr ""
  2752. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2753. #: apt-get.8.xml:436
  2754. msgid "<option>--only-upgrade</option>"
  2755. msgstr ""
  2756. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2757. #: apt-get.8.xml:437
  2758. msgid ""
  2759. "Do not install new packages; When used in conjunction with <literal>install</"
  2760. "literal>, <literal>only-upgrade</literal> will prevent packages on the "
  2761. "command line from being upgraded if they are not already installed. "
  2762. "Configuration Item: <literal>APT::Get::Only-Upgrade</literal>."
  2763. msgstr ""
  2764. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2765. #: apt-get.8.xml:443
  2766. msgid "<option>--force-yes</option>"
  2767. msgstr ""
  2768. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2769. #: apt-get.8.xml:444
  2770. msgid ""
  2771. "Force yes; This is a dangerous option that will cause apt to continue "
  2772. "without prompting if it is doing something potentially harmful. It should "
  2773. "not be used except in very special situations. Using <literal>force-yes</"
  2774. "literal> can potentially destroy your system! Configuration Item: "
  2775. "<literal>APT::Get::force-yes</literal>."
  2776. msgstr ""
  2777. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2778. #: apt-get.8.xml:451
  2779. msgid "<option>--print-uris</option>"
  2780. msgstr ""
  2781. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2782. #: apt-get.8.xml:452
  2783. msgid ""
  2784. "Instead of fetching the files to install their URIs are printed. Each URI "
  2785. "will have the path, the destination file name, the size and the expected md5 "
  2786. "hash. Note that the file name to write to will not always match the file "
  2787. "name on the remote site! This also works with the <literal>source</literal> "
  2788. "and <literal>update</literal> commands. When used with the <literal>update</"
  2789. "literal> command the MD5 and size are not included, and it is up to the user "
  2790. "to decompress any compressed files. Configuration Item: <literal>APT::Get::"
  2791. "Print-URIs</literal>."
  2792. msgstr ""
  2793. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2794. #: apt-get.8.xml:462
  2795. msgid "<option>--purge</option>"
  2796. msgstr ""
  2797. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2798. #: apt-get.8.xml:463
  2799. msgid ""
  2800. "Use purge instead of remove for anything that would be removed. An asterisk "
  2801. "(\"*\") will be displayed next to packages which are scheduled to be purged. "
  2802. "<option>remove --purge</option> is equivalent to the <option>purge</option> "
  2803. "command. Configuration Item: <literal>APT::Get::Purge</literal>."
  2804. msgstr ""
  2805. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2806. #: apt-get.8.xml:470
  2807. msgid "<option>--reinstall</option>"
  2808. msgstr ""
  2809. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2810. #: apt-get.8.xml:471
  2811. msgid ""
  2812. "Re-Install packages that are already installed and at the newest version. "
  2813. "Configuration Item: <literal>APT::Get::ReInstall</literal>."
  2814. msgstr ""
  2815. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2816. #: apt-get.8.xml:475
  2817. msgid "<option>--list-cleanup</option>"
  2818. msgstr ""
  2819. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2820. #: apt-get.8.xml:476
  2821. msgid ""
  2822. "This option defaults to on, use <literal>--no-list-cleanup</literal> to turn "
  2823. "it off. When on <command>apt-get</command> will automatically manage the "
  2824. "contents of <filename>&statedir;/lists</filename> to ensure that obsolete "
  2825. "files are erased. The only reason to turn it off is if you frequently "
  2826. "change your source list. Configuration Item: <literal>APT::Get::List-"
  2827. "Cleanup</literal>."
  2828. msgstr ""
  2829. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2830. #: apt-get.8.xml:485
  2831. msgid "<option>--target-release</option>"
  2832. msgstr ""
  2833. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2834. #: apt-get.8.xml:486
  2835. msgid "<option>--default-release</option>"
  2836. msgstr ""
  2837. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2838. #: apt-get.8.xml:487
  2839. msgid ""
  2840. "This option controls the default input to the policy engine, it creates a "
  2841. "default pin at priority 990 using the specified release string. This "
  2842. "overrides the general settings in <filename>/etc/apt/preferences</"
  2843. "filename>. Specifically pinned packages are not affected by the value of "
  2844. "this option. In short, this option lets you have simple control over which "
  2845. "distribution packages will be retrieved from. Some common examples might be "
  2846. "<option>-t '2.1*'</option>, <option>-t unstable</option> or <option>-t sid</"
  2847. "option>. Configuration Item: <literal>APT::Default-Release</literal>; see "
  2848. "also the &apt-preferences; manual page."
  2849. msgstr ""
  2850. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2851. #: apt-get.8.xml:500
  2852. msgid "<option>--trivial-only</option>"
  2853. msgstr ""
  2854. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2855. #: apt-get.8.xml:502
  2856. msgid ""
  2857. "Only perform operations that are 'trivial'. Logically this can be considered "
  2858. "related to <option>--assume-yes</option>, where <option>--assume-yes</"
  2859. "option> will answer yes to any prompt, <option>--trivial-only</option> will "
  2860. "answer no. Configuration Item: <literal>APT::Get::Trivial-Only</literal>."
  2861. msgstr ""
  2862. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2863. #: apt-get.8.xml:508
  2864. msgid "<option>--no-remove</option>"
  2865. msgstr ""
  2866. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2867. #: apt-get.8.xml:509
  2868. msgid ""
  2869. "If any packages are to be removed apt-get immediately aborts without "
  2870. "prompting. Configuration Item: <literal>APT::Get::Remove</literal>."
  2871. msgstr ""
  2872. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2873. #: apt-get.8.xml:514
  2874. msgid "<option>--auto-remove</option>"
  2875. msgstr ""
  2876. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2877. #: apt-get.8.xml:515
  2878. msgid ""
  2879. "If the command is either <literal>install</literal> or <literal>remove</"
  2880. "literal>, then this option acts like running <literal>autoremove</literal> "
  2881. "command, removing the unused dependency packages. Configuration Item: "
  2882. "<literal>APT::Get::AutomaticRemove</literal>."
  2883. msgstr ""
  2884. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2885. #: apt-get.8.xml:521
  2886. msgid "<option>--only-source</option>"
  2887. msgstr ""
  2888. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2889. #: apt-get.8.xml:522
  2890. msgid ""
  2891. "Only has meaning for the <literal>source</literal> and <literal>build-dep</"
  2892. "literal> commands. Indicates that the given source names are not to be "
  2893. "mapped through the binary table. This means that if this option is "
  2894. "specified, these commands will only accept source package names as "
  2895. "arguments, rather than accepting binary package names and looking up the "
  2896. "corresponding source package. Configuration Item: <literal>APT::Get::Only-"
  2897. "Source</literal>."
  2898. msgstr ""
  2899. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2900. #: apt-get.8.xml:532
  2901. msgid "<option>--diff-only</option>"
  2902. msgstr ""
  2903. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2904. #: apt-get.8.xml:532
  2905. msgid "<option>--dsc-only</option>"
  2906. msgstr ""
  2907. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2908. #: apt-get.8.xml:532
  2909. msgid "<option>--tar-only</option>"
  2910. msgstr ""
  2911. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2912. #: apt-get.8.xml:533
  2913. msgid ""
  2914. "Download only the diff, dsc, or tar file of a source archive. Configuration "
  2915. "Item: <literal>APT::Get::Diff-Only</literal>, <literal>APT::Get::Dsc-Only</"
  2916. "literal>, and <literal>APT::Get::Tar-Only</literal>."
  2917. msgstr ""
  2918. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2919. #: apt-get.8.xml:538
  2920. msgid "<option>--arch-only</option>"
  2921. msgstr ""
  2922. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2923. #: apt-get.8.xml:539
  2924. msgid ""
  2925. "Only process architecture-dependent build-dependencies. Configuration Item: "
  2926. "<literal>APT::Get::Arch-Only</literal>."
  2927. msgstr ""
  2928. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2929. #: apt-get.8.xml:543
  2930. msgid "<option>--allow-unauthenticated</option>"
  2931. msgstr ""
  2932. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2933. #: apt-get.8.xml:544
  2934. msgid ""
  2935. "Ignore if packages can't be authenticated and don't prompt about it. This "
  2936. "is useful for tools like pbuilder. Configuration Item: <literal>APT::Get::"
  2937. "AllowUnauthenticated</literal>."
  2938. msgstr ""
  2939. #. type: Content of: <refentry><refsect1><variablelist>
  2940. #: apt-get.8.xml:557
  2941. msgid ""
  2942. "&file-sourceslist; &file-aptconf; &file-preferences; &file-cachearchives; "
  2943. "&file-statelists;"
  2944. msgstr ""
  2945. #. type: Content of: <refentry><refsect1><para>
  2946. #: apt-get.8.xml:566
  2947. msgid ""
  2948. "&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, "
  2949. "&apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, &apt-"
  2950. "preferences;, the APT Howto."
  2951. msgstr ""
  2952. #. type: Content of: <refentry><refsect1><para>
  2953. #: apt-get.8.xml:572
  2954. msgid ""
  2955. "<command>apt-get</command> returns zero on normal operation, decimal 100 on "
  2956. "error."
  2957. msgstr ""
  2958. #. type: Content of: <refentry><refsect1><title>
  2959. #: apt-get.8.xml:575
  2960. msgid "ORIGINAL AUTHORS"
  2961. msgstr ""
  2962. #. type: Content of: <refentry><refsect1><para>
  2963. #: apt-get.8.xml:576
  2964. msgid "&apt-author.jgunthorpe;"
  2965. msgstr ""
  2966. #. type: Content of: <refentry><refsect1><title>
  2967. #: apt-get.8.xml:579
  2968. msgid "CURRENT AUTHORS"
  2969. msgstr ""
  2970. #. type: Content of: <refentry><refsect1><para>
  2971. #: apt-get.8.xml:581
  2972. msgid "&apt-author.team;"
  2973. msgstr ""
  2974. #. type: Content of: <refentry><refnamediv><refname>
  2975. #: apt-key.8.xml:17 apt-key.8.xml:24
  2976. #, fuzzy
  2977. msgid "apt-key"
  2978. msgstr "apt-get"
  2979. #. type: Content of: <refentry><refnamediv><refpurpose>
  2980. #: apt-key.8.xml:25
  2981. msgid "APT key management utility"
  2982. msgstr ""
  2983. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  2984. #: apt-key.8.xml:31
  2985. msgid ""
  2986. "<command>apt-key</command> <arg><option>--keyring <replaceable>filename</"
  2987. "replaceable></option></arg> <arg><replaceable>command</replaceable></arg> "
  2988. "<arg rep=\"repeat\"><option><replaceable>arguments</replaceable></option></"
  2989. "arg>"
  2990. msgstr ""
  2991. #. type: Content of: <refentry><refsect1><para>
  2992. #: apt-key.8.xml:40
  2993. msgid ""
  2994. "<command>apt-key</command> is used to manage the list of keys used by apt to "
  2995. "authenticate packages. Packages which have been authenticated using these "
  2996. "keys will be considered trusted."
  2997. msgstr ""
  2998. #. type: Content of: <refentry><refsect1><title>
  2999. #: apt-key.8.xml:46
  3000. msgid "Commands"
  3001. msgstr ""
  3002. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3003. #: apt-key.8.xml:48
  3004. msgid "add <replaceable>filename</replaceable>"
  3005. msgstr ""
  3006. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3007. #: apt-key.8.xml:52
  3008. msgid ""
  3009. "Add a new key to the list of trusted keys. The key is read from "
  3010. "<replaceable>filename</replaceable>, or standard input if "
  3011. "<replaceable>filename</replaceable> is <literal>-</literal>."
  3012. msgstr ""
  3013. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3014. #: apt-key.8.xml:60
  3015. msgid "del <replaceable>keyid</replaceable>"
  3016. msgstr ""
  3017. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3018. #: apt-key.8.xml:64
  3019. msgid "Remove a key from the list of trusted keys."
  3020. msgstr ""
  3021. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3022. #: apt-key.8.xml:71
  3023. msgid "export <replaceable>keyid</replaceable>"
  3024. msgstr ""
  3025. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3026. #: apt-key.8.xml:75
  3027. msgid "Output the key <replaceable>keyid</replaceable> to standard output."
  3028. msgstr ""
  3029. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3030. #: apt-key.8.xml:82
  3031. msgid "exportall"
  3032. msgstr ""
  3033. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3034. #: apt-key.8.xml:86
  3035. msgid "Output all trusted keys to standard output."
  3036. msgstr ""
  3037. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3038. #: apt-key.8.xml:93
  3039. msgid "list"
  3040. msgstr ""
  3041. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3042. #: apt-key.8.xml:97
  3043. msgid "List trusted keys."
  3044. msgstr ""
  3045. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3046. #: apt-key.8.xml:104
  3047. msgid "finger"
  3048. msgstr ""
  3049. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3050. #: apt-key.8.xml:108
  3051. msgid "List fingerprints of trusted keys."
  3052. msgstr ""
  3053. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3054. #: apt-key.8.xml:115
  3055. msgid "adv"
  3056. msgstr ""
  3057. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3058. #: apt-key.8.xml:119
  3059. msgid ""
  3060. "Pass advanced options to gpg. With adv --recv-key you can download the "
  3061. "public key."
  3062. msgstr ""
  3063. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3064. #: apt-key.8.xml:131
  3065. msgid ""
  3066. "Update the local keyring with the keyring of Debian archive keys and removes "
  3067. "from the keyring the archive keys which are no longer valid."
  3068. msgstr ""
  3069. #. type: Content of: <refentry><refsect1><para>
  3070. #: apt-key.8.xml:143
  3071. msgid ""
  3072. "Note that options need to be defined before the commands described in the "
  3073. "previous section."
  3074. msgstr ""
  3075. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3076. #: apt-key.8.xml:145
  3077. msgid "--keyring <replaceable>filename</replaceable>"
  3078. msgstr ""
  3079. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3080. #: apt-key.8.xml:146
  3081. msgid ""
  3082. "With this option it is possible to specify a specific keyring file the "
  3083. "command should operate on. The default is that a command is executed on the "
  3084. "<filename>trusted.gpg</filename> file as well as on all parts in the "
  3085. "<filename>trusted.gpg.d</filename> directory, through <filename>trusted.gpg</"
  3086. "filename> is the primary keyring which means that e.g. new keys are added to "
  3087. "this one."
  3088. msgstr ""
  3089. #. type: Content of: <refentry><refsect1><variablelist>
  3090. #: apt-key.8.xml:159
  3091. msgid "&file-trustedgpg;"
  3092. msgstr ""
  3093. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3094. #: apt-key.8.xml:161
  3095. msgid "<filename>/etc/apt/trustdb.gpg</filename>"
  3096. msgstr ""
  3097. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3098. #: apt-key.8.xml:162
  3099. msgid "Local trust database of archive keys."
  3100. msgstr ""
  3101. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3102. #: apt-key.8.xml:165
  3103. msgid "<filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename>"
  3104. msgstr ""
  3105. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3106. #: apt-key.8.xml:166
  3107. msgid "Keyring of Debian archive trusted keys."
  3108. msgstr ""
  3109. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3110. #: apt-key.8.xml:169
  3111. msgid ""
  3112. "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>"
  3113. msgstr ""
  3114. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3115. #: apt-key.8.xml:170
  3116. msgid "Keyring of Debian archive removed trusted keys."
  3117. msgstr ""
  3118. #. type: Content of: <refentry><refsect1><para>
  3119. #: apt-key.8.xml:179
  3120. msgid "&apt-get;, &apt-secure;"
  3121. msgstr ""
  3122. #. The last update date
  3123. #. type: Content of: <refentry><refentryinfo>
  3124. #: apt-mark.8.xml:16
  3125. msgid ""
  3126. "&apt-author.moconnor; &apt-author.team; &apt-email; &apt-product; <date>9 "
  3127. "August 2009</date>"
  3128. msgstr ""
  3129. #. type: Content of: <refentry><refnamediv><refname>
  3130. #: apt-mark.8.xml:25 apt-mark.8.xml:32
  3131. msgid "apt-mark"
  3132. msgstr ""
  3133. #. type: Content of: <refentry><refnamediv><refpurpose>
  3134. #: apt-mark.8.xml:33
  3135. msgid "mark/unmark a package as being automatically-installed"
  3136. msgstr ""
  3137. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  3138. #: apt-mark.8.xml:39
  3139. msgid ""
  3140. " <command>apt-mark</command> <arg><option>-hv</option></arg> <arg><option>-"
  3141. "f=<replaceable>FILENAME</replaceable></option></arg> <group choice=\"plain"
  3142. "\"> <arg choice=\"plain\"> <group choice=\"req\"> <arg choice=\"plain"
  3143. "\">markauto</arg> <arg choice=\"plain\">unmarkauto</arg> </group> <arg "
  3144. "choice=\"plain\" rep=\"repeat\"><replaceable>package</replaceable></arg> </"
  3145. "arg> <arg choice=\"plain\">showauto</arg> </group>"
  3146. msgstr ""
  3147. #. type: Content of: <refentry><refsect1><para>
  3148. #: apt-mark.8.xml:56
  3149. msgid ""
  3150. "<command>apt-mark</command> will change whether a package has been marked as "
  3151. "being automatically installed."
  3152. msgstr ""
  3153. #. type: Content of: <refentry><refsect1><para>
  3154. #: apt-mark.8.xml:60
  3155. msgid ""
  3156. "When you request that a package is installed, and as a result other packages "
  3157. "are installed to satisfy its dependencies, the dependencies are marked as "
  3158. "being automatically installed. Once these automatically installed packages "
  3159. "are no longer depended on by any manually installed packages, they will be "
  3160. "removed by e.g. <command>apt-get</command> or <command>aptitude</command>."
  3161. msgstr ""
  3162. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3163. #: apt-mark.8.xml:68
  3164. msgid "markauto"
  3165. msgstr ""
  3166. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3167. #: apt-mark.8.xml:69
  3168. msgid ""
  3169. "<literal>markauto</literal> is used to mark a package as being automatically "
  3170. "installed, which will cause the package to be removed when no more manually "
  3171. "installed packages depend on this package."
  3172. msgstr ""
  3173. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3174. #: apt-mark.8.xml:76
  3175. msgid "unmarkauto"
  3176. msgstr ""
  3177. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3178. #: apt-mark.8.xml:77
  3179. msgid ""
  3180. "<literal>unmarkauto</literal> is used to mark a package as being manually "
  3181. "installed, which will prevent the package from being automatically removed "
  3182. "if no other packages depend on it."
  3183. msgstr ""
  3184. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3185. #: apt-mark.8.xml:84
  3186. msgid "showauto"
  3187. msgstr ""
  3188. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3189. #: apt-mark.8.xml:85
  3190. msgid ""
  3191. "<literal>showauto</literal> is used to print a list of automatically "
  3192. "installed packages with each package on a new line."
  3193. msgstr ""
  3194. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3195. #: apt-mark.8.xml:96
  3196. msgid ""
  3197. "<option>-f=<filename><replaceable>FILENAME</replaceable></filename></option>"
  3198. msgstr ""
  3199. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3200. #: apt-mark.8.xml:97
  3201. msgid ""
  3202. "<option>--file=<filename><replaceable>FILENAME</replaceable></filename></"
  3203. "option>"
  3204. msgstr ""
  3205. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3206. #: apt-mark.8.xml:100
  3207. msgid ""
  3208. "Read/Write package stats from <filename><replaceable>FILENAME</replaceable></"
  3209. "filename> instead of the default location, which is "
  3210. "<filename>extended_status</filename> in the directory defined by the "
  3211. "Configuration Item: <literal>Dir::State</literal>."
  3212. msgstr ""
  3213. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3214. #: apt-mark.8.xml:106
  3215. msgid "<option>-h</option>"
  3216. msgstr ""
  3217. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3218. #: apt-mark.8.xml:107
  3219. msgid "<option>--help</option>"
  3220. msgstr ""
  3221. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3222. #: apt-mark.8.xml:108
  3223. msgid "Show a short usage summary."
  3224. msgstr ""
  3225. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3226. #: apt-mark.8.xml:114
  3227. msgid "<option>-v</option>"
  3228. msgstr ""
  3229. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3230. #: apt-mark.8.xml:115
  3231. msgid "<option>--version</option>"
  3232. msgstr ""
  3233. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3234. #: apt-mark.8.xml:116
  3235. msgid "Show the program version."
  3236. msgstr ""
  3237. #. type: Content of: <refentry><refsect1><variablelist>
  3238. #: apt-mark.8.xml:127
  3239. msgid " &file-extended_states;"
  3240. msgstr ""
  3241. #. type: Content of: <refentry><refsect1><para>
  3242. #: apt-mark.8.xml:132
  3243. msgid "&apt-get;,&aptitude;,&apt-conf;"
  3244. msgstr ""
  3245. #. type: Content of: <refentry><refsect1><para>
  3246. #: apt-mark.8.xml:136
  3247. msgid ""
  3248. "<command>apt-mark</command> returns zero on normal operation, non-zero on "
  3249. "error."
  3250. msgstr ""
  3251. #. type: Content of: <refentry><refnamediv><refname>
  3252. #: apt-secure.8.xml:17 apt-secure.8.xml:39
  3253. msgid "apt-secure"
  3254. msgstr ""
  3255. #. type: Content of: <refentry><refnamediv><refpurpose>
  3256. #: apt-secure.8.xml:40
  3257. msgid "Archive authentication support for APT"
  3258. msgstr ""
  3259. #. type: Content of: <refentry><refsect1><para>
  3260. #: apt-secure.8.xml:45
  3261. msgid ""
  3262. "Starting with version 0.6, <command>apt</command> contains code that does "
  3263. "signature checking of the Release file for all archives. This ensures that "
  3264. "packages in the archive can't be modified by people who have no access to "
  3265. "the Release file signing key."
  3266. msgstr ""
  3267. #. type: Content of: <refentry><refsect1><para>
  3268. #: apt-secure.8.xml:53
  3269. msgid ""
  3270. "If a package comes from a archive without a signature or with a signature "
  3271. "that apt does not have a key for that package is considered untrusted and "
  3272. "installing it will result in a big warning. <command>apt-get</command> will "
  3273. "currently only warn for unsigned archives, future releases might force all "
  3274. "sources to be verified before downloading packages from them."
  3275. msgstr ""
  3276. #. type: Content of: <refentry><refsect1><para>
  3277. #: apt-secure.8.xml:62
  3278. msgid ""
  3279. "The package frontends &apt-get;, &aptitude; and &synaptic; support this new "
  3280. "authentication feature."
  3281. msgstr ""
  3282. #. type: Content of: <refentry><refsect1><title>
  3283. #: apt-secure.8.xml:67
  3284. msgid "Trusted archives"
  3285. msgstr ""
  3286. #. type: Content of: <refentry><refsect1><para>
  3287. #: apt-secure.8.xml:70
  3288. msgid ""
  3289. "The chain of trust from an apt archive to the end user is made up of "
  3290. "different steps. <command>apt-secure</command> is the last step in this "
  3291. "chain, trusting an archive does not mean that the packages that you trust it "
  3292. "do not contain malicious code but means that you trust the archive "
  3293. "maintainer. It's the archive maintainer responsibility to ensure that the "
  3294. "archive integrity is correct."
  3295. msgstr ""
  3296. #. type: Content of: <refentry><refsect1><para>
  3297. #: apt-secure.8.xml:78
  3298. msgid ""
  3299. "apt-secure does not review signatures at a package level. If you require "
  3300. "tools to do this you should look at <command>debsig-verify</command> and "
  3301. "<command>debsign</command> (provided in the debsig-verify and devscripts "
  3302. "packages respectively)."
  3303. msgstr ""
  3304. #. type: Content of: <refentry><refsect1><para>
  3305. #: apt-secure.8.xml:85
  3306. msgid ""
  3307. "The chain of trust in Debian starts when a maintainer uploads a new package "
  3308. "or a new version of a package to the Debian archive. This upload in order to "
  3309. "become effective needs to be signed by a key of a maintainer within the "
  3310. "Debian maintainer's keyring (available in the debian-keyring package). "
  3311. "Maintainer's keys are signed by other maintainers following pre-established "
  3312. "procedures to ensure the identity of the key holder."
  3313. msgstr ""
  3314. #. type: Content of: <refentry><refsect1><para>
  3315. #: apt-secure.8.xml:95
  3316. msgid ""
  3317. "Once the uploaded package is verified and included in the archive, the "
  3318. "maintainer signature is stripped off, an MD5 sum of the package is computed "
  3319. "and put in the Packages file. The MD5 sum of all of the packages files are "
  3320. "then computed and put into the Release file. The Release file is then signed "
  3321. "by the archive key (which is created once a year) and distributed through "
  3322. "the FTP server. This key is also on the Debian keyring."
  3323. msgstr ""
  3324. #. type: Content of: <refentry><refsect1><para>
  3325. #: apt-secure.8.xml:105
  3326. msgid ""
  3327. "Any end user can check the signature of the Release file, extract the MD5 "
  3328. "sum of a package from it and compare it with the MD5 sum of the package he "
  3329. "downloaded. Prior to version 0.6 only the MD5 sum of the downloaded Debian "
  3330. "package was checked. Now both the MD5 sum and the signature of the Release "
  3331. "file are checked."
  3332. msgstr ""
  3333. #. type: Content of: <refentry><refsect1><para>
  3334. #: apt-secure.8.xml:112
  3335. msgid ""
  3336. "Notice that this is distinct from checking signatures on a per package "
  3337. "basis. It is designed to prevent two possible attacks:"
  3338. msgstr ""
  3339. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3340. #: apt-secure.8.xml:117
  3341. msgid ""
  3342. "<literal>Network \"man in the middle\" attacks</literal>. Without signature "
  3343. "checking, a malicious agent can introduce himself in the package download "
  3344. "process and provide malicious software either by controlling a network "
  3345. "element (router, switch, etc.) or by redirecting traffic to a rogue server "
  3346. "(through arp or DNS spoofing attacks)."
  3347. msgstr ""
  3348. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3349. #: apt-secure.8.xml:125
  3350. msgid ""
  3351. "<literal>Mirror network compromise</literal>. Without signature checking, a "
  3352. "malicious agent can compromise a mirror host and modify the files in it to "
  3353. "propagate malicious software to all users downloading packages from that "
  3354. "host."
  3355. msgstr ""
  3356. #. type: Content of: <refentry><refsect1><para>
  3357. #: apt-secure.8.xml:132
  3358. msgid ""
  3359. "However, it does not defend against a compromise of the Debian master server "
  3360. "itself (which signs the packages) or against a compromise of the key used to "
  3361. "sign the Release files. In any case, this mechanism can complement a per-"
  3362. "package signature."
  3363. msgstr ""
  3364. #. type: Content of: <refentry><refsect1><title>
  3365. #: apt-secure.8.xml:138
  3366. msgid "User configuration"
  3367. msgstr ""
  3368. #. type: Content of: <refentry><refsect1><para>
  3369. #: apt-secure.8.xml:140
  3370. msgid ""
  3371. "<command>apt-key</command> is the program that manages the list of keys used "
  3372. "by apt. It can be used to add or remove keys although an installation of "
  3373. "this release will automatically provide the default Debian archive signing "
  3374. "keys used in the Debian package repositories."
  3375. msgstr ""
  3376. #. type: Content of: <refentry><refsect1><para>
  3377. #: apt-secure.8.xml:147
  3378. msgid ""
  3379. "In order to add a new key you need to first download it (you should make "
  3380. "sure you are using a trusted communication channel when retrieving it), add "
  3381. "it with <command>apt-key</command> and then run <command>apt-get update</"
  3382. "command> so that apt can download and verify the <filename>Release.gpg</"
  3383. "filename> files from the archives you have configured."
  3384. msgstr ""
  3385. #. type: Content of: <refentry><refsect1><title>
  3386. #: apt-secure.8.xml:156
  3387. msgid "Archive configuration"
  3388. msgstr ""
  3389. #. type: Content of: <refentry><refsect1><para>
  3390. #: apt-secure.8.xml:158
  3391. msgid ""
  3392. "If you want to provide archive signatures in an archive under your "
  3393. "maintenance you have to:"
  3394. msgstr ""
  3395. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3396. #: apt-secure.8.xml:163
  3397. msgid ""
  3398. "<emphasis>Create a toplevel Release file</emphasis>, if it does not exist "
  3399. "already. You can do this by running <command>apt-ftparchive release</"
  3400. "command> (provided in apt-utils)."
  3401. msgstr ""
  3402. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3403. #: apt-secure.8.xml:168
  3404. msgid ""
  3405. "<emphasis>Sign it</emphasis>. You can do this by running <command>gpg -abs -"
  3406. "o Release.gpg Release</command>."
  3407. msgstr ""
  3408. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3409. #: apt-secure.8.xml:171
  3410. msgid ""
  3411. "<emphasis>Publish the key fingerprint</emphasis>, that way your users will "
  3412. "know what key they need to import in order to authenticate the files in the "
  3413. "archive."
  3414. msgstr ""
  3415. #. type: Content of: <refentry><refsect1><para>
  3416. #: apt-secure.8.xml:178
  3417. msgid ""
  3418. "Whenever the contents of the archive changes (new packages are added or "
  3419. "removed) the archive maintainer has to follow the first two steps previously "
  3420. "outlined."
  3421. msgstr ""
  3422. #. type: Content of: <refentry><refsect1><para>
  3423. #: apt-secure.8.xml:186
  3424. msgid ""
  3425. "&apt-conf;, &apt-get;, &sources-list;, &apt-key;, &apt-ftparchive;, "
  3426. "&debsign; &debsig-verify;, &gpg;"
  3427. msgstr ""
  3428. #. type: Content of: <refentry><refsect1><para>
  3429. #: apt-secure.8.xml:190
  3430. msgid ""
  3431. "For more background information you might want to review the <ulink url="
  3432. "\"http://www.debian.org/doc/manuals/securing-debian-howto/ch7.en.html"
  3433. "\">Debian Security Infrastructure</ulink> chapter of the Securing Debian "
  3434. "Manual (available also in the harden-doc package) and the <ulink url="
  3435. "\"http://www.cryptnet.net/fdp/crypto/strong_distro.html\" >Strong "
  3436. "Distribution HOWTO</ulink> by V. Alex Brennen."
  3437. msgstr ""
  3438. #. type: Content of: <refentry><refsect1><title>
  3439. #: apt-secure.8.xml:203
  3440. msgid "Manpage Authors"
  3441. msgstr ""
  3442. #. type: Content of: <refentry><refsect1><para>
  3443. #: apt-secure.8.xml:205
  3444. msgid ""
  3445. "This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac "
  3446. "Jones, Colin Walters, Florian Weimer and Michael Vogt."
  3447. msgstr ""
  3448. #. type: Content of: <refentry><refnamediv><refname>
  3449. #: apt-sortpkgs.1.xml:25 apt-sortpkgs.1.xml:32
  3450. msgid "apt-sortpkgs"
  3451. msgstr ""
  3452. #. type: Content of: <refentry><refnamediv><refpurpose>
  3453. #: apt-sortpkgs.1.xml:33
  3454. msgid "Utility to sort package index files"
  3455. msgstr ""
  3456. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  3457. #: apt-sortpkgs.1.xml:39
  3458. msgid ""
  3459. "<command>apt-sortpkgs</command> <arg><option>-hvs</option></arg> "
  3460. "<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
  3461. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <arg choice="
  3462. "\"plain\" rep=\"repeat\"><replaceable>file</replaceable></arg>"
  3463. msgstr ""
  3464. #. type: Content of: <refentry><refsect1><para>
  3465. #: apt-sortpkgs.1.xml:48
  3466. msgid ""
  3467. "<command>apt-sortpkgs</command> will take an index file (Source index or "
  3468. "Package index) and sort the records so that they are ordered by the package "
  3469. "name. It will also sort the internal fields of each record according to the "
  3470. "internal sorting rules."
  3471. msgstr ""
  3472. #. type: Content of: <refentry><refsect1><para>
  3473. #: apt-sortpkgs.1.xml:54
  3474. msgid "All output is sent to stdout, the input must be a seekable file."
  3475. msgstr ""
  3476. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3477. #: apt-sortpkgs.1.xml:61
  3478. msgid "<option>--source</option>"
  3479. msgstr ""
  3480. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3481. #: apt-sortpkgs.1.xml:63
  3482. msgid ""
  3483. "Use Source index field ordering. Configuration Item: <literal>APT::"
  3484. "SortPkgs::Source</literal>."
  3485. msgstr ""
  3486. #. type: Content of: <refentry><refsect1><para>
  3487. #: apt-sortpkgs.1.xml:77
  3488. msgid ""
  3489. "<command>apt-sortpkgs</command> returns zero on normal operation, decimal "
  3490. "100 on error."
  3491. msgstr ""
  3492. #. The last update date
  3493. #. type: Content of: <refentry><refentryinfo>
  3494. #: apt.conf.5.xml:16
  3495. msgid ""
  3496. "&apt-author.jgunthorpe; &apt-author.team; <author> <firstname>Daniel</"
  3497. "firstname> <surname>Burrows</surname> <contrib>Initial documentation of "
  3498. "Debug::*.</contrib> <email>dburrows@debian.org</email> </author> &apt-email; "
  3499. "&apt-product; <date>16 January 2010</date>"
  3500. msgstr ""
  3501. #. type: Content of: <refentry><refnamediv><refname>
  3502. #: apt.conf.5.xml:31 apt.conf.5.xml:38
  3503. msgid "apt.conf"
  3504. msgstr ""
  3505. #. type: Content of: <refentry><refmeta><manvolnum>
  3506. #: apt.conf.5.xml:32 apt_preferences.5.xml:25 sources.list.5.xml:26
  3507. msgid "5"
  3508. msgstr ""
  3509. #. type: Content of: <refentry><refnamediv><refpurpose>
  3510. #: apt.conf.5.xml:39
  3511. msgid "Configuration file for APT"
  3512. msgstr ""
  3513. #. type: Content of: <refentry><refsect1><para>
  3514. #: apt.conf.5.xml:43
  3515. msgid ""
  3516. "<filename>apt.conf</filename> is the main configuration file for the APT "
  3517. "suite of tools, but by far not the only place changes to options can be "
  3518. "made. All tools therefore share the configuration files and also use a "
  3519. "common command line parser to provide a uniform environment."
  3520. msgstr ""
  3521. #. type: Content of: <refentry><refsect1><orderedlist><para>
  3522. #: apt.conf.5.xml:48
  3523. msgid ""
  3524. "When an APT tool starts up it will read the configuration files in the "
  3525. "following order:"
  3526. msgstr ""
  3527. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  3528. #: apt.conf.5.xml:50
  3529. msgid ""
  3530. "the file specified by the <envar>APT_CONFIG</envar> environment variable (if "
  3531. "any)"
  3532. msgstr ""
  3533. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  3534. #: apt.conf.5.xml:52
  3535. msgid ""
  3536. "all files in <literal>Dir::Etc::Parts</literal> in alphanumeric ascending "
  3537. "order which have no or \"<literal>conf</literal>\" as filename extension and "
  3538. "which only contain alphanumeric, hyphen (-), underscore (_) and period (.) "
  3539. "characters - otherwise they will be silently ignored."
  3540. msgstr ""
  3541. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  3542. #: apt.conf.5.xml:57
  3543. msgid ""
  3544. "the main configuration file specified by <literal>Dir::Etc::main</literal>"
  3545. msgstr ""
  3546. #. type: Content of: <refentry><refsect1><orderedlist><listitem><para>
  3547. #: apt.conf.5.xml:59
  3548. msgid ""
  3549. "the command line options are applied to override the configuration "
  3550. "directives or to load even more configuration files."
  3551. msgstr ""
  3552. #. type: Content of: <refentry><refsect1><title>
  3553. #: apt.conf.5.xml:63
  3554. msgid "Syntax"
  3555. msgstr ""
  3556. #. type: Content of: <refentry><refsect1><para>
  3557. #: apt.conf.5.xml:64
  3558. msgid ""
  3559. "The configuration file is organized in a tree with options organized into "
  3560. "functional groups. Option specification is given with a double colon "
  3561. "notation, for instance <literal>APT::Get::Assume-Yes</literal> is an option "
  3562. "within the APT tool group, for the Get tool. Options do not inherit from "
  3563. "their parent groups."
  3564. msgstr ""
  3565. #. type: Content of: <refentry><refsect1><para>
  3566. #: apt.conf.5.xml:70
  3567. msgid ""
  3568. "Syntactically the configuration language is modeled after what the ISC tools "
  3569. "such as bind and dhcp use. Lines starting with <literal>//</literal> are "
  3570. "treated as comments (ignored), as well as all text between <literal>/*</"
  3571. "literal> and <literal>*/</literal>, just like C/C++ comments. Each line is "
  3572. "of the form <literal>APT::Get::Assume-Yes \"true\";</literal>. The trailing "
  3573. "semicolon and the quotes are required. The value must be on one line, and "
  3574. "there is no kind of string concatenation. It must not include inside "
  3575. "quotes. The behavior of the backslash \"\\\" and escaped characters inside "
  3576. "a value is undefined and it should not be used. An option name may include "
  3577. "alphanumerical characters and the \"/-:._+\" characters. A new scope can be "
  3578. "opened with curly braces, like:"
  3579. msgstr ""
  3580. #. type: Content of: <refentry><refsect1><informalexample><programlisting>
  3581. #: apt.conf.5.xml:84
  3582. #, no-wrap
  3583. msgid ""
  3584. "APT {\n"
  3585. " Get {\n"
  3586. " Assume-Yes \"true\";\n"
  3587. " Fix-Broken \"true\";\n"
  3588. " };\n"
  3589. "};\n"
  3590. msgstr ""
  3591. #. type: Content of: <refentry><refsect1><para>
  3592. #: apt.conf.5.xml:92
  3593. msgid ""
  3594. "with newlines placed to make it more readable. Lists can be created by "
  3595. "opening a scope and including a single string enclosed in quotes followed by "
  3596. "a semicolon. Multiple entries can be included, each separated by a semicolon."
  3597. msgstr ""
  3598. #. type: Content of: <refentry><refsect1><informalexample><programlisting>
  3599. #: apt.conf.5.xml:97
  3600. #, no-wrap
  3601. msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n"
  3602. msgstr ""
  3603. #. type: Content of: <refentry><refsect1><para>
  3604. #: apt.conf.5.xml:100
  3605. msgid ""
  3606. "In general the sample configuration file in <filename>&docdir;examples/apt."
  3607. "conf</filename> &configureindex; is a good guide for how it should look."
  3608. msgstr ""
  3609. #. type: Content of: <refentry><refsect1><para>
  3610. #: apt.conf.5.xml:104
  3611. msgid ""
  3612. "The names of the configuration items are not case-sensitive. So in the "
  3613. "previous example you could use <literal>dpkg::pre-install-pkgs</literal>."
  3614. msgstr ""
  3615. #. type: Content of: <refentry><refsect1><para>
  3616. #: apt.conf.5.xml:107
  3617. msgid ""
  3618. "Names for the configuration items are optional if a list is defined as it "
  3619. "can be see in the <literal>DPkg::Pre-Install-Pkgs</literal> example above. "
  3620. "If you don't specify a name a new entry will simply add a new option to the "
  3621. "list. If you specify a name you can override the option as every other "
  3622. "option by reassigning a new value to the option."
  3623. msgstr ""
  3624. #. type: Content of: <refentry><refsect1><para>
  3625. #: apt.conf.5.xml:112
  3626. msgid ""
  3627. "Two specials are allowed, <literal>#include</literal> (which is deprecated "
  3628. "and not supported by alternative implementations) and <literal>#clear</"
  3629. "literal>: <literal>#include</literal> will include the given file, unless "
  3630. "the filename ends in a slash, then the whole directory is included. "
  3631. "<literal>#clear</literal> is used to erase a part of the configuration tree. "
  3632. "The specified element and all its descendants are erased. (Note that these "
  3633. "lines also need to end with a semicolon.)"
  3634. msgstr ""
  3635. #. type: Content of: <refentry><refsect1><para>
  3636. #: apt.conf.5.xml:120
  3637. msgid ""
  3638. "The #clear command is the only way to delete a list or a complete scope. "
  3639. "Reopening a scope or the ::-style described below will <emphasis>not</"
  3640. "emphasis> override previously written entries. Only options can be "
  3641. "overridden by addressing a new value to it - lists and scopes can't be "
  3642. "overridden, only cleared."
  3643. msgstr ""
  3644. #. type: Content of: <refentry><refsect1><para>
  3645. #: apt.conf.5.xml:125
  3646. msgid ""
  3647. "All of the APT tools take a -o option which allows an arbitrary "
  3648. "configuration directive to be specified on the command line. The syntax is a "
  3649. "full option name (<literal>APT::Get::Assume-Yes</literal> for instance) "
  3650. "followed by an equals sign then the new value of the option. Lists can be "
  3651. "appended too by adding a trailing :: to the list name. (As you might "
  3652. "suspect: The scope syntax can't be used on the command line.)"
  3653. msgstr ""
  3654. #. type: Content of: <refentry><refsect1><para>
  3655. #: apt.conf.5.xml:132
  3656. msgid ""
  3657. "Note that you can use :: only for appending one item per line to a list and "
  3658. "that you should not use it in combination with the scope syntax. (The scope "
  3659. "syntax implicit insert ::) Using both syntaxes together will trigger a bug "
  3660. "which some users unfortunately relay on: An option with the unusual name "
  3661. "\"<literal>::</literal>\" which acts like every other option with a name. "
  3662. "These introduces many problems including that a user who writes multiple "
  3663. "lines in this <emphasis>wrong</emphasis> syntax in the hope to append to a "
  3664. "list will gain the opposite as only the last assignment for this option "
  3665. "\"<literal>::</literal>\" will be used. Upcoming APT versions will raise "
  3666. "errors and will stop working if they encounter this misuse, so please "
  3667. "correct such statements now as long as APT doesn't complain explicit about "
  3668. "them."
  3669. msgstr ""
  3670. #. type: Content of: <refentry><refsect1><title>
  3671. #: apt.conf.5.xml:144
  3672. msgid "The APT Group"
  3673. msgstr ""
  3674. #. type: Content of: <refentry><refsect1><para>
  3675. #: apt.conf.5.xml:145
  3676. msgid ""
  3677. "This group of options controls general APT behavior as well as holding the "
  3678. "options for all of the tools."
  3679. msgstr ""
  3680. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3681. #: apt.conf.5.xml:149
  3682. msgid "Architecture"
  3683. msgstr ""
  3684. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3685. #: apt.conf.5.xml:150
  3686. msgid ""
  3687. "System Architecture; sets the architecture to use when fetching files and "
  3688. "parsing package lists. The internal default is the architecture apt was "
  3689. "compiled for."
  3690. msgstr ""
  3691. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3692. #: apt.conf.5.xml:155
  3693. msgid "Default-Release"
  3694. msgstr ""
  3695. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3696. #: apt.conf.5.xml:156
  3697. msgid ""
  3698. "Default release to install packages from if more than one version available. "
  3699. "Contains release name, codename or release version. Examples: 'stable', "
  3700. "'testing', 'unstable', '&stable-codename;', '&testing-codename;', '4.0', "
  3701. "'5.0*'. See also &apt-preferences;."
  3702. msgstr ""
  3703. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3704. #: apt.conf.5.xml:161
  3705. msgid "Ignore-Hold"
  3706. msgstr ""
  3707. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3708. #: apt.conf.5.xml:162
  3709. msgid ""
  3710. "Ignore Held packages; This global option causes the problem resolver to "
  3711. "ignore held packages in its decision making."
  3712. msgstr ""
  3713. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3714. #: apt.conf.5.xml:166
  3715. msgid "Clean-Installed"
  3716. msgstr ""
  3717. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3718. #: apt.conf.5.xml:167
  3719. msgid ""
  3720. "Defaults to on. When turned on the autoclean feature will remove any "
  3721. "packages which can no longer be downloaded from the cache. If turned off "
  3722. "then packages that are locally installed are also excluded from cleaning - "
  3723. "but note that APT provides no direct means to reinstall them."
  3724. msgstr ""
  3725. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3726. #: apt.conf.5.xml:173
  3727. msgid "Immediate-Configure"
  3728. msgstr ""
  3729. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3730. #: apt.conf.5.xml:174
  3731. msgid ""
  3732. "Defaults to on which will cause APT to install essential and important "
  3733. "packages as fast as possible in the install/upgrade operation. This is done "
  3734. "to limit the effect of a failing &dpkg; call: If this option is disabled APT "
  3735. "does treat an important package in the same way as an extra package: Between "
  3736. "the unpacking of the important package A and his configuration can then be "
  3737. "many other unpack or configuration calls, e.g. for package B which has no "
  3738. "relation to A, but causes the dpkg call to fail (e.g. because maintainer "
  3739. "script of package B generates an error) which results in a system state in "
  3740. "which package A is unpacked but unconfigured - each package depending on A "
  3741. "is now no longer guaranteed to work as their dependency on A is not longer "
  3742. "satisfied. The immediate configuration marker is also applied to all "
  3743. "dependencies which can generate a problem if the dependencies e.g. form a "
  3744. "circle as a dependency with the immediate flag is comparable with a Pre-"
  3745. "Dependency. So in theory it is possible that APT encounters a situation in "
  3746. "which it is unable to perform immediate configuration, errors out and refers "
  3747. "to this option so the user can deactivate the immediate configuration "
  3748. "temporarily to be able to perform an install/upgrade again. Note the use of "
  3749. "the word \"theory\" here as this problem was only encountered by now in real "
  3750. "world a few times in non-stable distribution versions and was caused by "
  3751. "wrong dependencies of the package in question or by a system in an already "
  3752. "broken state, so you should not blindly disable this option as the mentioned "
  3753. "scenario above is not the only problem immediate configuration can help to "
  3754. "prevent in the first place. Before a big operation like <literal>dist-"
  3755. "upgrade</literal> is run with this option disabled it should be tried to "
  3756. "explicitly <literal>install</literal> the package APT is unable to configure "
  3757. "immediately, but please make sure to report your problem also to your "
  3758. "distribution and to the APT team with the buglink below so they can work on "
  3759. "improving or correcting the upgrade process."
  3760. msgstr ""
  3761. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3762. #: apt.conf.5.xml:196
  3763. msgid "Force-LoopBreak"
  3764. msgstr ""
  3765. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3766. #: apt.conf.5.xml:197
  3767. msgid ""
  3768. "Never Enable this option unless you -really- know what you are doing. It "
  3769. "permits APT to temporarily remove an essential package to break a Conflicts/"
  3770. "Conflicts or Conflicts/Pre-Depend loop between two essential packages. SUCH "
  3771. "A LOOP SHOULD NEVER EXIST AND IS A GRAVE BUG. This option will work if the "
  3772. "essential packages are not tar, gzip, libc, dpkg, bash or anything that "
  3773. "those packages depend on."
  3774. msgstr ""
  3775. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3776. #: apt.conf.5.xml:205
  3777. msgid "Cache-Start, Cache-Grow and Cache-Limit"
  3778. msgstr ""
  3779. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3780. #: apt.conf.5.xml:206
  3781. msgid ""
  3782. "APT uses since version 0.7.26 a resizable memory mapped cache file to store "
  3783. "the 'available' information. <literal>Cache-Start</literal> acts as a hint "
  3784. "to which size the Cache will grow and is therefore the amount of memory APT "
  3785. "will request at startup. The default value is 20971520 bytes (~20 MB). Note "
  3786. "that these amount of space need to be available for APT otherwise it will "
  3787. "likely fail ungracefully, so for memory restricted devices these value "
  3788. "should be lowered while on systems with a lot of configured sources this "
  3789. "might be increased. <literal>Cache-Grow</literal> defines in byte with the "
  3790. "default of 1048576 (~1 MB) how much the Cache size will be increased in the "
  3791. "event the space defined by <literal>Cache-Start</literal> is not enough. "
  3792. "These value will be applied again and again until either the cache is big "
  3793. "enough to store all information or the size of the cache reaches the "
  3794. "<literal>Cache-Limit</literal>. The default of <literal>Cache-Limit</"
  3795. "literal> is 0 which stands for no limit. If <literal>Cache-Grow</literal> "
  3796. "is set to 0 the automatic grow of the cache is disabled."
  3797. msgstr ""
  3798. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3799. #: apt.conf.5.xml:221
  3800. msgid "Build-Essential"
  3801. msgstr ""
  3802. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3803. #: apt.conf.5.xml:222
  3804. msgid "Defines which package(s) are considered essential build dependencies."
  3805. msgstr ""
  3806. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3807. #: apt.conf.5.xml:225
  3808. msgid "Get"
  3809. msgstr ""
  3810. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3811. #: apt.conf.5.xml:226
  3812. msgid ""
  3813. "The Get subsection controls the &apt-get; tool, please see its documentation "
  3814. "for more information about the options here."
  3815. msgstr ""
  3816. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3817. #: apt.conf.5.xml:230
  3818. msgid "Cache"
  3819. msgstr ""
  3820. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3821. #: apt.conf.5.xml:231
  3822. msgid ""
  3823. "The Cache subsection controls the &apt-cache; tool, please see its "
  3824. "documentation for more information about the options here."
  3825. msgstr ""
  3826. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3827. #: apt.conf.5.xml:235
  3828. msgid "CDROM"
  3829. msgstr ""
  3830. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3831. #: apt.conf.5.xml:236
  3832. msgid ""
  3833. "The CDROM subsection controls the &apt-cdrom; tool, please see its "
  3834. "documentation for more information about the options here."
  3835. msgstr ""
  3836. #. type: Content of: <refentry><refsect1><title>
  3837. #: apt.conf.5.xml:242
  3838. msgid "The Acquire Group"
  3839. msgstr ""
  3840. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3841. #: apt.conf.5.xml:247
  3842. msgid "Check-Valid-Until"
  3843. msgstr ""
  3844. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3845. #: apt.conf.5.xml:248
  3846. msgid ""
  3847. "Security related option defaulting to true as an expiring validation for a "
  3848. "Release file prevents longtime replay attacks and can e.g. also help users "
  3849. "to identify no longer updated mirrors - but the feature depends on the "
  3850. "correctness of the time on the user system. Archive maintainers are "
  3851. "encouraged to create Release files with the <literal>Valid-Until</literal> "
  3852. "header, but if they don't or a stricter value is volitional the following "
  3853. "<literal>Max-ValidTime</literal> option can be used."
  3854. msgstr ""
  3855. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3856. #: apt.conf.5.xml:258
  3857. msgid "Max-ValidTime"
  3858. msgstr ""
  3859. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3860. #: apt.conf.5.xml:259
  3861. msgid ""
  3862. "Seconds the Release file should be considered valid after it was created. "
  3863. "The default is \"for ever\" (0) if the Release file of the archive doesn't "
  3864. "include a <literal>Valid-Until</literal> header. If it does then this date "
  3865. "is the default. The date from the Release file or the date specified by the "
  3866. "creation time of the Release file (<literal>Date</literal> header) plus the "
  3867. "seconds specified with this options are used to check if the validation of a "
  3868. "file has expired by using the earlier date of the two. Archive specific "
  3869. "settings can be made by appending the label of the archive to the option "
  3870. "name."
  3871. msgstr ""
  3872. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3873. #: apt.conf.5.xml:271
  3874. msgid "PDiffs"
  3875. msgstr ""
  3876. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3877. #: apt.conf.5.xml:272
  3878. msgid ""
  3879. "Try to download deltas called <literal>PDiffs</literal> for Packages or "
  3880. "Sources files instead of downloading whole ones. True by default."
  3881. msgstr ""
  3882. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3883. #: apt.conf.5.xml:275
  3884. msgid ""
  3885. "Two sub-options to limit the use of PDiffs are also available: With "
  3886. "<literal>FileLimit</literal> can be specified how many PDiff files are "
  3887. "downloaded at most to patch a file. <literal>SizeLimit</literal> on the "
  3888. "other hand is the maximum precentage of the size of all patches compared to "
  3889. "the size of the targeted file. If one of these limits is exceeded the "
  3890. "complete file is downloaded instead of the patches."
  3891. msgstr ""
  3892. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3893. #: apt.conf.5.xml:284
  3894. msgid "Queue-Mode"
  3895. msgstr ""
  3896. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3897. #: apt.conf.5.xml:285
  3898. msgid ""
  3899. "Queuing mode; <literal>Queue-Mode</literal> can be one of <literal>host</"
  3900. "literal> or <literal>access</literal> which determines how APT parallelizes "
  3901. "outgoing connections. <literal>host</literal> means that one connection per "
  3902. "target host will be opened, <literal>access</literal> means that one "
  3903. "connection per URI type will be opened."
  3904. msgstr ""
  3905. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3906. #: apt.conf.5.xml:292
  3907. msgid "Retries"
  3908. msgstr ""
  3909. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3910. #: apt.conf.5.xml:293
  3911. msgid ""
  3912. "Number of retries to perform. If this is non-zero APT will retry failed "
  3913. "files the given number of times."
  3914. msgstr ""
  3915. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3916. #: apt.conf.5.xml:297
  3917. msgid "Source-Symlinks"
  3918. msgstr ""
  3919. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3920. #: apt.conf.5.xml:298
  3921. msgid ""
  3922. "Use symlinks for source archives. If set to true then source archives will "
  3923. "be symlinked when possible instead of copying. True is the default."
  3924. msgstr ""
  3925. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3926. #: apt.conf.5.xml:302 sources.list.5.xml:142
  3927. msgid "http"
  3928. msgstr ""
  3929. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3930. #: apt.conf.5.xml:303
  3931. msgid ""
  3932. "HTTP URIs; http::Proxy is the default http proxy to use. It is in the "
  3933. "standard form of <literal>http://[[user][:pass]@]host[:port]/</literal>. Per "
  3934. "host proxies can also be specified by using the form <literal>http::Proxy::"
  3935. "&lt;host&gt;</literal> with the special keyword <literal>DIRECT</literal> "
  3936. "meaning to use no proxies. If no one of the above settings is specified, "
  3937. "<envar>http_proxy</envar> environment variable will be used."
  3938. msgstr ""
  3939. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3940. #: apt.conf.5.xml:311
  3941. msgid ""
  3942. "Three settings are provided for cache control with HTTP/1.1 compliant proxy "
  3943. "caches. <literal>No-Cache</literal> tells the proxy to not use its cached "
  3944. "response under any circumstances, <literal>Max-Age</literal> is sent only "
  3945. "for index files and tells the cache to refresh its object if it is older "
  3946. "than the given number of seconds. Debian updates its index files daily so "
  3947. "the default is 1 day. <literal>No-Store</literal> specifies that the cache "
  3948. "should never store this request, it is only set for archive files. This may "
  3949. "be useful to prevent polluting a proxy cache with very large .deb files. "
  3950. "Note: Squid 2.0.2 does not support any of these options."
  3951. msgstr ""
  3952. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3953. #: apt.conf.5.xml:321 apt.conf.5.xml:385
  3954. msgid ""
  3955. "The option <literal>timeout</literal> sets the timeout timer used by the "
  3956. "method, this applies to all things including connection timeout and data "
  3957. "timeout."
  3958. msgstr ""
  3959. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3960. #: apt.conf.5.xml:324
  3961. msgid ""
  3962. "One setting is provided to control the pipeline depth in cases where the "
  3963. "remote server is not RFC conforming or buggy (such as Squid 2.0.2). "
  3964. "<literal>Acquire::http::Pipeline-Depth</literal> can be a value from 0 to 5 "
  3965. "indicating how many outstanding requests APT should send. A value of zero "
  3966. "MUST be specified if the remote host does not properly linger on TCP "
  3967. "connections - otherwise data corruption will occur. Hosts which require this "
  3968. "are in violation of RFC 2068."
  3969. msgstr ""
  3970. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3971. #: apt.conf.5.xml:332
  3972. msgid ""
  3973. "The used bandwidth can be limited with <literal>Acquire::http::Dl-Limit</"
  3974. "literal> which accepts integer values in kilobyte. The default value is 0 "
  3975. "which deactivates the limit and tries uses as much as possible of the "
  3976. "bandwidth (Note that this option implicit deactivates the download from "
  3977. "multiple servers at the same time.)"
  3978. msgstr ""
  3979. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3980. #: apt.conf.5.xml:337
  3981. msgid ""
  3982. "<literal>Acquire::http::User-Agent</literal> can be used to set a different "
  3983. "User-Agent for the http download method as some proxies allow access for "
  3984. "clients only if the client uses a known identifier."
  3985. msgstr ""
  3986. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3987. #: apt.conf.5.xml:343
  3988. msgid "https"
  3989. msgstr ""
  3990. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3991. #: apt.conf.5.xml:344
  3992. msgid ""
  3993. "HTTPS URIs. Cache-control, Timeout, AllowRedirect, Dl-Limit and proxy "
  3994. "options are the same as for <literal>http</literal> method and will also "
  3995. "default to the options from the <literal>http</literal> method if they are "
  3996. "not explicitly set for https. <literal>Pipeline-Depth</literal> option is "
  3997. "not supported yet."
  3998. msgstr ""
  3999. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4000. #: apt.conf.5.xml:350
  4001. msgid ""
  4002. "<literal>CaInfo</literal> suboption specifies place of file that holds info "
  4003. "about trusted certificates. <literal>&lt;host&gt;::CaInfo</literal> is "
  4004. "corresponding per-host option. <literal>Verify-Peer</literal> boolean "
  4005. "suboption determines whether verify server's host certificate against "
  4006. "trusted certificates or not. <literal>&lt;host&gt;::Verify-Peer</literal> "
  4007. "is corresponding per-host option. <literal>Verify-Host</literal> boolean "
  4008. "suboption determines whether verify server's hostname or not. <literal>&lt;"
  4009. "host&gt;::Verify-Host</literal> is corresponding per-host option. "
  4010. "<literal>SslCert</literal> determines what certificate to use for client "
  4011. "authentication. <literal>&lt;host&gt;::SslCert</literal> is corresponding "
  4012. "per-host option. <literal>SslKey</literal> determines what private key to "
  4013. "use for client authentication. <literal>&lt;host&gt;::SslKey</literal> is "
  4014. "corresponding per-host option. <literal>SslForceVersion</literal> overrides "
  4015. "default SSL version to use. Can contain 'TLSv1' or 'SSLv3' string. "
  4016. "<literal>&lt;host&gt;::SslForceVersion</literal> is corresponding per-host "
  4017. "option."
  4018. msgstr ""
  4019. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4020. #: apt.conf.5.xml:368 sources.list.5.xml:153
  4021. msgid "ftp"
  4022. msgstr ""
  4023. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4024. #: apt.conf.5.xml:369
  4025. msgid ""
  4026. "FTP URIs; ftp::Proxy is the default ftp proxy to use. It is in the standard "
  4027. "form of <literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per host "
  4028. "proxies can also be specified by using the form <literal>ftp::Proxy::&lt;"
  4029. "host&gt;</literal> with the special keyword <literal>DIRECT</literal> "
  4030. "meaning to use no proxies. If no one of the above settings is specified, "
  4031. "<envar>ftp_proxy</envar> environment variable will be used. To use a ftp "
  4032. "proxy you will have to set the <literal>ftp::ProxyLogin</literal> script in "
  4033. "the configuration file. This entry specifies the commands to send to tell "
  4034. "the proxy server what to connect to. Please see &configureindex; for an "
  4035. "example of how to do this. The substitution variables available are <literal>"
  4036. "$(PROXY_USER)</literal> <literal>$(PROXY_PASS)</literal> <literal>"
  4037. "$(SITE_USER)</literal> <literal>$(SITE_PASS)</literal> <literal>$(SITE)</"
  4038. "literal> and <literal>$(SITE_PORT)</literal> Each is taken from it's "
  4039. "respective URI component."
  4040. msgstr ""
  4041. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4042. #: apt.conf.5.xml:388
  4043. msgid ""
  4044. "Several settings are provided to control passive mode. Generally it is safe "
  4045. "to leave passive mode on, it works in nearly every environment. However "
  4046. "some situations require that passive mode be disabled and port mode ftp used "
  4047. "instead. This can be done globally, for connections that go through a proxy "
  4048. "or for a specific host (See the sample config file for examples)."
  4049. msgstr ""
  4050. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4051. #: apt.conf.5.xml:395
  4052. msgid ""
  4053. "It is possible to proxy FTP over HTTP by setting the <envar>ftp_proxy</"
  4054. "envar> environment variable to a http url - see the discussion of the http "
  4055. "method above for syntax. You cannot set this in the configuration file and "
  4056. "it is not recommended to use FTP over HTTP due to its low efficiency."
  4057. msgstr ""
  4058. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4059. #: apt.conf.5.xml:400
  4060. msgid ""
  4061. "The setting <literal>ForceExtended</literal> controls the use of RFC2428 "
  4062. "<literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is "
  4063. "false, which means these commands are only used if the control connection is "
  4064. "IPv6. Setting this to true forces their use even on IPv4 connections. Note "
  4065. "that most FTP servers do not support RFC2428."
  4066. msgstr ""
  4067. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4068. #: apt.conf.5.xml:407 sources.list.5.xml:135
  4069. msgid "cdrom"
  4070. msgstr ""
  4071. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout>
  4072. #: apt.conf.5.xml:413
  4073. #, no-wrap
  4074. msgid "/cdrom/::Mount \"foo\";"
  4075. msgstr ""
  4076. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4077. #: apt.conf.5.xml:408
  4078. msgid ""
  4079. "CDROM URIs; the only setting for CDROM URIs is the mount point, "
  4080. "<literal>cdrom::Mount</literal> which must be the mount point for the CDROM "
  4081. "drive as specified in <filename>/etc/fstab</filename>. It is possible to "
  4082. "provide alternate mount and unmount commands if your mount point cannot be "
  4083. "listed in the fstab (such as an SMB mount and old mount packages). The "
  4084. "syntax is to put <placeholder type=\"literallayout\" id=\"0\"/> within the "
  4085. "cdrom block. It is important to have the trailing slash. Unmount commands "
  4086. "can be specified using UMount."
  4087. msgstr ""
  4088. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4089. #: apt.conf.5.xml:418
  4090. msgid "gpgv"
  4091. msgstr ""
  4092. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4093. #: apt.conf.5.xml:419
  4094. msgid ""
  4095. "GPGV URIs; the only option for GPGV URIs is the option to pass additional "
  4096. "parameters to gpgv. <literal>gpgv::Options</literal> Additional options "
  4097. "passed to gpgv."
  4098. msgstr ""
  4099. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4100. #: apt.conf.5.xml:424
  4101. msgid "CompressionTypes"
  4102. msgstr ""
  4103. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  4104. #: apt.conf.5.xml:430
  4105. #, no-wrap
  4106. msgid "Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> \"<replaceable>Methodname</replaceable>\";"
  4107. msgstr ""
  4108. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4109. #: apt.conf.5.xml:425
  4110. msgid ""
  4111. "List of compression types which are understood by the acquire methods. "
  4112. "Files like <filename>Packages</filename> can be available in various "
  4113. "compression formats. Per default the acquire methods can decompress "
  4114. "<command>bzip2</command>, <command>lzma</command> and <command>gzip</"
  4115. "command> compressed files, with this setting more formats can be added on "
  4116. "the fly or the used method can be changed. The syntax for this is: "
  4117. "<placeholder type=\"synopsis\" id=\"0\"/>"
  4118. msgstr ""
  4119. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  4120. #: apt.conf.5.xml:435
  4121. #, no-wrap
  4122. msgid "Acquire::CompressionTypes::Order:: \"gz\";"
  4123. msgstr ""
  4124. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  4125. #: apt.conf.5.xml:438
  4126. #, no-wrap
  4127. msgid "Acquire::CompressionTypes::Order { \"lzma\"; \"gz\"; };"
  4128. msgstr ""
  4129. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4130. #: apt.conf.5.xml:431
  4131. msgid ""
  4132. "Also the <literal>Order</literal> subgroup can be used to define in which "
  4133. "order the acquire system will try to download the compressed files. The "
  4134. "acquire system will try the first and proceed with the next compression type "
  4135. "in this list on error, so to prefer one over the other type simple add the "
  4136. "preferred type at first - not already added default types will be added at "
  4137. "run time to the end of the list, so e.g. <placeholder type=\"synopsis\" id="
  4138. "\"0\"/> can be used to prefer <command>gzip</command> compressed files over "
  4139. "<command>bzip2</command> and <command>lzma</command>. If <command>lzma</"
  4140. "command> should be preferred over <command>gzip</command> and "
  4141. "<command>bzip2</command> the configure setting should look like this "
  4142. "<placeholder type=\"synopsis\" id=\"1\"/> It is not needed to add "
  4143. "<literal>bz2</literal> explicit to the list as it will be added automatic."
  4144. msgstr ""
  4145. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout>
  4146. #: apt.conf.5.xml:442
  4147. #, no-wrap
  4148. msgid "Dir::Bin::bzip2 \"/bin/bzip2\";"
  4149. msgstr ""
  4150. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4151. #: apt.conf.5.xml:440
  4152. msgid ""
  4153. "Note that at run time the <literal>Dir::Bin::<replaceable>Methodname</"
  4154. "replaceable></literal> will be checked: If this setting exists the method "
  4155. "will only be used if this file exists, e.g. for the bzip2 method (the "
  4156. "inbuilt) setting is <placeholder type=\"literallayout\" id=\"0\"/> Note also "
  4157. "that list entries specified on the command line will be added at the end of "
  4158. "the list specified in the configuration files, but before the default "
  4159. "entries. To prefer a type in this case over the ones specified in in the "
  4160. "configuration files you can set the option direct - not in list style. This "
  4161. "will not override the defined list, it will only prefix the list with this "
  4162. "type."
  4163. msgstr ""
  4164. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4165. #: apt.conf.5.xml:447
  4166. msgid ""
  4167. "While it is possible to add an empty compression type to the order list, but "
  4168. "APT in its current version doesn't understand it correctly and will display "
  4169. "many warnings about not downloaded files - these warnings are most of the "
  4170. "time false negatives. Future versions will maybe include a way to really "
  4171. "prefer uncompressed files to support the usage of local mirrors."
  4172. msgstr ""
  4173. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4174. #: apt.conf.5.xml:453
  4175. msgid "GzipIndexes"
  4176. msgstr ""
  4177. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4178. #: apt.conf.5.xml:455
  4179. msgid ""
  4180. "When downloading <literal>gzip</literal> compressed indexes (Packages, "
  4181. "Sources, or Translations), keep them gzip compressed locally instead of "
  4182. "unpacking them. This saves quite a lot of disk space at the expense of more "
  4183. "CPU requirements when building the local package caches. False by default."
  4184. msgstr ""
  4185. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4186. #: apt.conf.5.xml:462
  4187. msgid "Languages"
  4188. msgstr ""
  4189. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4190. #: apt.conf.5.xml:463
  4191. msgid ""
  4192. "The Languages subsection controls which <filename>Translation</filename> "
  4193. "files are downloaded and in which order APT tries to display the Description-"
  4194. "Translations. APT will try to display the first available Description in the "
  4195. "Language which is listed at first. Languages can be defined with their short "
  4196. "or long Languagecodes. Note that not all archives provide "
  4197. "<filename>Translation</filename> files for every Language - especially the "
  4198. "long Languagecodes are rare, so please inform you which ones are available "
  4199. "before you set here impossible values."
  4200. msgstr ""
  4201. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><programlisting>
  4202. #: apt.conf.5.xml:479
  4203. #, no-wrap
  4204. msgid "Acquire::Languages { \"environment\"; \"de\"; \"en\"; \"none\"; \"fr\"; };"
  4205. msgstr ""
  4206. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4207. #: apt.conf.5.xml:469
  4208. msgid ""
  4209. "The default list includes \"environment\" and \"en\". "
  4210. "\"<literal>environment</literal>\" has a special meaning here: It will be "
  4211. "replaced at runtime with the languagecodes extracted from the "
  4212. "<literal>LC_MESSAGES</literal> environment variable. It will also ensure "
  4213. "that these codes are not included twice in the list. If "
  4214. "<literal>LC_MESSAGES</literal> is set to \"C\" only the "
  4215. "<filename>Translation-en</filename> file (if available) will be used. To "
  4216. "force apt to use no Translation file use the setting <literal>Acquire::"
  4217. "Languages=none</literal>. \"<literal>none</literal>\" is another special "
  4218. "meaning code which will stop the search for a fitting <filename>Translation</"
  4219. "filename> file. This can be used by the system administrator to let APT "
  4220. "know that it should download also this files without actually use them if "
  4221. "the environment doesn't specify this languages. So the following example "
  4222. "configuration will result in the order \"en, de\" in an english and in \"de, "
  4223. "en\" in a german localization. Note that \"fr\" is downloaded, but not used "
  4224. "if APT is not used in a french localization, in such an environment the "
  4225. "order would be \"fr, de, en\". <placeholder type=\"programlisting\" id="
  4226. "\"0\"/>"
  4227. msgstr ""
  4228. #. type: Content of: <refentry><refsect1><para>
  4229. #: apt.conf.5.xml:243
  4230. msgid ""
  4231. "The <literal>Acquire</literal> group of options controls the download of "
  4232. "packages and the URI handlers. <placeholder type=\"variablelist\" id=\"0\"/>"
  4233. msgstr ""
  4234. #. type: Content of: <refentry><refsect1><title>
  4235. #: apt.conf.5.xml:486
  4236. msgid "Directories"
  4237. msgstr ""
  4238. #. type: Content of: <refentry><refsect1><para>
  4239. #: apt.conf.5.xml:488
  4240. msgid ""
  4241. "The <literal>Dir::State</literal> section has directories that pertain to "
  4242. "local state information. <literal>lists</literal> is the directory to place "
  4243. "downloaded package lists in and <literal>status</literal> is the name of the "
  4244. "dpkg status file. <literal>preferences</literal> is the name of the APT "
  4245. "preferences file. <literal>Dir::State</literal> contains the default "
  4246. "directory to prefix on all sub items if they do not start with <filename>/</"
  4247. "filename> or <filename>./</filename>."
  4248. msgstr ""
  4249. #. type: Content of: <refentry><refsect1><para>
  4250. #: apt.conf.5.xml:495
  4251. msgid ""
  4252. "<literal>Dir::Cache</literal> contains locations pertaining to local cache "
  4253. "information, such as the two package caches <literal>srcpkgcache</literal> "
  4254. "and <literal>pkgcache</literal> as well as the location to place downloaded "
  4255. "archives, <literal>Dir::Cache::archives</literal>. Generation of caches can "
  4256. "be turned off by setting their names to be blank. This will slow down "
  4257. "startup but save disk space. It is probably preferred to turn off the "
  4258. "pkgcache rather than the srcpkgcache. Like <literal>Dir::State</literal> the "
  4259. "default directory is contained in <literal>Dir::Cache</literal>"
  4260. msgstr ""
  4261. #. type: Content of: <refentry><refsect1><para>
  4262. #: apt.conf.5.xml:504
  4263. msgid ""
  4264. "<literal>Dir::Etc</literal> contains the location of configuration files, "
  4265. "<literal>sourcelist</literal> gives the location of the sourcelist and "
  4266. "<literal>main</literal> is the default configuration file (setting has no "
  4267. "effect, unless it is done from the config file specified by "
  4268. "<envar>APT_CONFIG</envar>)."
  4269. msgstr ""
  4270. #. type: Content of: <refentry><refsect1><para>
  4271. #: apt.conf.5.xml:510
  4272. msgid ""
  4273. "The <literal>Dir::Parts</literal> setting reads in all the config fragments "
  4274. "in lexical order from the directory specified. After this is done then the "
  4275. "main config file is loaded."
  4276. msgstr ""
  4277. #. type: Content of: <refentry><refsect1><para>
  4278. #: apt.conf.5.xml:514
  4279. msgid ""
  4280. "Binary programs are pointed to by <literal>Dir::Bin</literal>. <literal>Dir::"
  4281. "Bin::Methods</literal> specifies the location of the method handlers and "
  4282. "<literal>gzip</literal>, <literal>bzip2</literal>, <literal>lzma</literal>, "
  4283. "<literal>dpkg</literal>, <literal>apt-get</literal> <literal>dpkg-source</"
  4284. "literal> <literal>dpkg-buildpackage</literal> and <literal>apt-cache</"
  4285. "literal> specify the location of the respective programs."
  4286. msgstr ""
  4287. #. type: Content of: <refentry><refsect1><para>
  4288. #: apt.conf.5.xml:522
  4289. msgid ""
  4290. "The configuration item <literal>RootDir</literal> has a special meaning. If "
  4291. "set, all paths in <literal>Dir::</literal> will be relative to "
  4292. "<literal>RootDir</literal>, <emphasis>even paths that are specified "
  4293. "absolutely</emphasis>. So, for instance, if <literal>RootDir</literal> is "
  4294. "set to <filename>/tmp/staging</filename> and <literal>Dir::State::status</"
  4295. "literal> is set to <filename>/var/lib/dpkg/status</filename>, then the "
  4296. "status file will be looked up in <filename>/tmp/staging/var/lib/dpkg/status</"
  4297. "filename>."
  4298. msgstr ""
  4299. #. type: Content of: <refentry><refsect1><para>
  4300. #: apt.conf.5.xml:535
  4301. msgid ""
  4302. "The <literal>Ignore-Files-Silently</literal> list can be used to specify "
  4303. "which files APT should silently ignore while parsing the files in the "
  4304. "fragment directories. Per default a file which end with <literal>.disabled</"
  4305. "literal>, <literal>~</literal>, <literal>.bak</literal> or <literal>.dpkg-[a-"
  4306. "z]+</literal> is silently ignored. As seen in the last default value these "
  4307. "patterns can use regular expression syntax."
  4308. msgstr ""
  4309. #. type: Content of: <refentry><refsect1><title>
  4310. #: apt.conf.5.xml:544
  4311. #, fuzzy
  4312. msgid "APT in DSelect"
  4313. msgstr "DSelect"
  4314. #. type: Content of: <refentry><refsect1><para>
  4315. #: apt.conf.5.xml:546
  4316. msgid ""
  4317. "When APT is used as a &dselect; method several configuration directives "
  4318. "control the default behaviour. These are in the <literal>DSelect</literal> "
  4319. "section."
  4320. msgstr ""
  4321. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4322. #: apt.conf.5.xml:550
  4323. msgid "Clean"
  4324. msgstr ""
  4325. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4326. #: apt.conf.5.xml:551
  4327. msgid ""
  4328. "Cache Clean mode; this value may be one of always, prompt, auto, pre-auto "
  4329. "and never. always and prompt will remove all packages from the cache after "
  4330. "upgrading, prompt (the default) does so conditionally. auto removes only "
  4331. "those packages which are no longer downloadable (replaced with a new version "
  4332. "for instance). pre-auto performs this action before downloading new "
  4333. "packages."
  4334. msgstr ""
  4335. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4336. #: apt.conf.5.xml:560
  4337. msgid ""
  4338. "The contents of this variable is passed to &apt-get; as command line options "
  4339. "when it is run for the install phase."
  4340. msgstr ""
  4341. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4342. #: apt.conf.5.xml:564
  4343. msgid "Updateoptions"
  4344. msgstr ""
  4345. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4346. #: apt.conf.5.xml:565
  4347. msgid ""
  4348. "The contents of this variable is passed to &apt-get; as command line options "
  4349. "when it is run for the update phase."
  4350. msgstr ""
  4351. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4352. #: apt.conf.5.xml:569
  4353. msgid "PromptAfterUpdate"
  4354. msgstr ""
  4355. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4356. #: apt.conf.5.xml:570
  4357. msgid ""
  4358. "If true the [U]pdate operation in &dselect; will always prompt to continue. "
  4359. "The default is to prompt only on error."
  4360. msgstr ""
  4361. #. type: Content of: <refentry><refsect1><title>
  4362. #: apt.conf.5.xml:576
  4363. msgid "How APT calls dpkg"
  4364. msgstr ""
  4365. #. type: Content of: <refentry><refsect1><para>
  4366. #: apt.conf.5.xml:577
  4367. msgid ""
  4368. "Several configuration directives control how APT invokes &dpkg;. These are "
  4369. "in the <literal>DPkg</literal> section."
  4370. msgstr ""
  4371. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4372. #: apt.conf.5.xml:582
  4373. msgid ""
  4374. "This is a list of options to pass to dpkg. The options must be specified "
  4375. "using the list notation and each list item is passed as a single argument to "
  4376. "&dpkg;."
  4377. msgstr ""
  4378. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4379. #: apt.conf.5.xml:587
  4380. msgid "Pre-Invoke"
  4381. msgstr ""
  4382. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4383. #: apt.conf.5.xml:587
  4384. msgid "Post-Invoke"
  4385. msgstr ""
  4386. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4387. #: apt.conf.5.xml:588
  4388. msgid ""
  4389. "This is a list of shell commands to run before/after invoking &dpkg;. Like "
  4390. "<literal>options</literal> this must be specified in list notation. The "
  4391. "commands are invoked in order using <filename>/bin/sh</filename>, should any "
  4392. "fail APT will abort."
  4393. msgstr ""
  4394. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4395. #: apt.conf.5.xml:594
  4396. msgid "Pre-Install-Pkgs"
  4397. msgstr ""
  4398. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4399. #: apt.conf.5.xml:595
  4400. msgid ""
  4401. "This is a list of shell commands to run before invoking dpkg. Like "
  4402. "<literal>options</literal> this must be specified in list notation. The "
  4403. "commands are invoked in order using <filename>/bin/sh</filename>, should any "
  4404. "fail APT will abort. APT will pass to the commands on standard input the "
  4405. "filenames of all .deb files it is going to install, one per line."
  4406. msgstr ""
  4407. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4408. #: apt.conf.5.xml:601
  4409. msgid ""
  4410. "Version 2 of this protocol dumps more information, including the protocol "
  4411. "version, the APT configuration space and the packages, files and versions "
  4412. "being changed. Version 2 is enabled by setting <literal>DPkg::Tools::"
  4413. "options::cmd::Version</literal> to 2. <literal>cmd</literal> is a command "
  4414. "given to <literal>Pre-Install-Pkgs</literal>."
  4415. msgstr ""
  4416. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4417. #: apt.conf.5.xml:608
  4418. msgid "Run-Directory"
  4419. msgstr ""
  4420. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4421. #: apt.conf.5.xml:609
  4422. msgid ""
  4423. "APT chdirs to this directory before invoking dpkg, the default is <filename>/"
  4424. "</filename>."
  4425. msgstr ""
  4426. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4427. #: apt.conf.5.xml:613
  4428. msgid "Build-options"
  4429. msgstr ""
  4430. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4431. #: apt.conf.5.xml:614
  4432. msgid ""
  4433. "These options are passed to &dpkg-buildpackage; when compiling packages, the "
  4434. "default is to disable signing and produce all binaries."
  4435. msgstr ""
  4436. #. type: Content of: <refentry><refsect1><refsect2><title>
  4437. #: apt.conf.5.xml:619
  4438. msgid "dpkg trigger usage (and related options)"
  4439. msgstr ""
  4440. #. type: Content of: <refentry><refsect1><refsect2><para>
  4441. #: apt.conf.5.xml:620
  4442. msgid ""
  4443. "APT can call dpkg in a way so it can make aggressive use of triggers over "
  4444. "multiply calls of dpkg. Without further options dpkg will use triggers only "
  4445. "in between his own run. Activating these options can therefore decrease the "
  4446. "time needed to perform the install / upgrade. Note that it is intended to "
  4447. "activate these options per default in the future, but as it changes the way "
  4448. "APT calling dpkg drastically it needs a lot more testing. <emphasis>These "
  4449. "options are therefore currently experimental and should not be used in "
  4450. "productive environments.</emphasis> Also it breaks the progress reporting so "
  4451. "all frontends will currently stay around half (or more) of the time in the "
  4452. "100% state while it actually configures all packages."
  4453. msgstr ""
  4454. #. type: Content of: <refentry><refsect1><refsect2><para><literallayout>
  4455. #: apt.conf.5.xml:635
  4456. #, no-wrap
  4457. msgid ""
  4458. "DPkg::NoTriggers \"true\";\n"
  4459. "PackageManager::Configure \"smart\";\n"
  4460. "DPkg::ConfigurePending \"true\";\n"
  4461. "DPkg::TriggersPending \"true\";"
  4462. msgstr ""
  4463. #. type: Content of: <refentry><refsect1><refsect2><para>
  4464. #: apt.conf.5.xml:629
  4465. msgid ""
  4466. "Note that it is not guaranteed that APT will support these options or that "
  4467. "these options will not cause (big) trouble in the future. If you have "
  4468. "understand the current risks and problems with these options, but are brave "
  4469. "enough to help testing them create a new configuration file and test a "
  4470. "combination of options. Please report any bugs, problems and improvements "
  4471. "you encounter and make sure to note which options you have used in your "
  4472. "reports. Asking dpkg for help could also be useful for debugging proposes, "
  4473. "see e.g. <command>dpkg --audit</command>. A defensive option combination "
  4474. "would be <placeholder type=\"literallayout\" id=\"0\"/>"
  4475. msgstr ""
  4476. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4477. #: apt.conf.5.xml:641
  4478. msgid "DPkg::NoTriggers"
  4479. msgstr ""
  4480. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4481. #: apt.conf.5.xml:642
  4482. msgid ""
  4483. "Add the no triggers flag to all dpkg calls (except the ConfigurePending "
  4484. "call). See &dpkg; if you are interested in what this actually means. In "
  4485. "short: dpkg will not run the triggers when this flag is present unless it is "
  4486. "explicitly called to do so in an extra call. Note that this option exists "
  4487. "(undocumented) also in older apt versions with a slightly different meaning: "
  4488. "Previously these option only append --no-triggers to the configure calls to "
  4489. "dpkg - now apt will add these flag also to the unpack and remove calls."
  4490. msgstr ""
  4491. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4492. #: apt.conf.5.xml:649
  4493. msgid "PackageManager::Configure"
  4494. msgstr ""
  4495. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4496. #: apt.conf.5.xml:650
  4497. msgid ""
  4498. "Valid values are \"<literal>all</literal>\", \"<literal>smart</literal>\" "
  4499. "and \"<literal>no</literal>\". \"<literal>all</literal>\" is the default "
  4500. "value and causes APT to configure all packages explicit. The "
  4501. "\"<literal>smart</literal>\" way is it to configure only packages which need "
  4502. "to be configured before another package can be unpacked (Pre-Depends) and "
  4503. "let the rest configure by dpkg with a call generated by the next option. "
  4504. "\"<literal>no</literal>\" on the other hand will not configure anything and "
  4505. "totally rely on dpkg for configuration (which will at the moment fail if a "
  4506. "Pre-Depends is encountered). Setting this option to another than the all "
  4507. "value will implicitly activate also the next option per default as otherwise "
  4508. "the system could end in an unconfigured status which could be unbootable!"
  4509. msgstr ""
  4510. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4511. #: apt.conf.5.xml:660
  4512. msgid "DPkg::ConfigurePending"
  4513. msgstr ""
  4514. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4515. #: apt.conf.5.xml:661
  4516. msgid ""
  4517. "If this option is set apt will call <command>dpkg --configure --pending</"
  4518. "command> to let dpkg handle all required configurations and triggers. This "
  4519. "option is activated automatic per default if the previous option is not set "
  4520. "to <literal>all</literal>, but deactivating could be useful if you want to "
  4521. "run APT multiple times in a row - e.g. in an installer. In these sceneries "
  4522. "you could deactivate this option in all but the last run."
  4523. msgstr ""
  4524. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4525. #: apt.conf.5.xml:667
  4526. msgid "DPkg::TriggersPending"
  4527. msgstr ""
  4528. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4529. #: apt.conf.5.xml:668
  4530. msgid ""
  4531. "Useful for <literal>smart</literal> configuration as a package which has "
  4532. "pending triggers is not considered as <literal>installed</literal> and dpkg "
  4533. "treats them as <literal>unpacked</literal> currently which is a dealbreaker "
  4534. "for Pre-Dependencies (see debbugs #526774). Note that this will process all "
  4535. "triggers, not only the triggers needed to configure this package."
  4536. msgstr ""
  4537. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4538. #: apt.conf.5.xml:673
  4539. msgid "PackageManager::UnpackAll"
  4540. msgstr ""
  4541. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4542. #: apt.conf.5.xml:674
  4543. msgid ""
  4544. "As the configuration can be deferred to be done at the end by dpkg it can be "
  4545. "tried to order the unpack series only by critical needs, e.g. by Pre-"
  4546. "Depends. Default is true and therefore the \"old\" method of ordering in "
  4547. "various steps by everything. While both method were present in earlier APT "
  4548. "versions the <literal>OrderCritical</literal> method was unused, so this "
  4549. "method is very experimental and needs further improvements before becoming "
  4550. "really useful."
  4551. msgstr ""
  4552. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4553. #: apt.conf.5.xml:681
  4554. msgid "OrderList::Score::Immediate"
  4555. msgstr ""
  4556. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para><literallayout>
  4557. #: apt.conf.5.xml:689
  4558. #, no-wrap
  4559. msgid ""
  4560. "OrderList::Score {\n"
  4561. "\tDelete 500;\n"
  4562. "\tEssential 200;\n"
  4563. "\tImmediate 10;\n"
  4564. "\tPreDepends 50;\n"
  4565. "};"
  4566. msgstr ""
  4567. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4568. #: apt.conf.5.xml:682
  4569. msgid ""
  4570. "Essential packages (and there dependencies) should be configured immediately "
  4571. "after unpacking. It will be a good idea to do this quite early in the "
  4572. "upgrade process as these these configure calls require currently also "
  4573. "<literal>DPkg::TriggersPending</literal> which will run quite a few triggers "
  4574. "(which maybe not needed). Essentials get per default a high score but the "
  4575. "immediate flag is relatively low (a package which has a Pre-Depends is "
  4576. "higher rated). These option and the others in the same group can be used to "
  4577. "change the scoring. The following example shows the settings with there "
  4578. "default values. <placeholder type=\"literallayout\" id=\"0\"/>"
  4579. msgstr ""
  4580. #. type: Content of: <refentry><refsect1><title>
  4581. #: apt.conf.5.xml:702
  4582. msgid "Periodic and Archives options"
  4583. msgstr ""
  4584. #. type: Content of: <refentry><refsect1><para>
  4585. #: apt.conf.5.xml:703
  4586. msgid ""
  4587. "<literal>APT::Periodic</literal> and <literal>APT::Archives</literal> groups "
  4588. "of options configure behavior of apt periodic updates, which is done by "
  4589. "<literal>/etc/cron.daily/apt</literal> script. See header of this script for "
  4590. "the brief documentation of these options."
  4591. msgstr ""
  4592. #. type: Content of: <refentry><refsect1><title>
  4593. #: apt.conf.5.xml:711
  4594. msgid "Debug options"
  4595. msgstr ""
  4596. #. type: Content of: <refentry><refsect1><para>
  4597. #: apt.conf.5.xml:713
  4598. msgid ""
  4599. "Enabling options in the <literal>Debug::</literal> section will cause "
  4600. "debugging information to be sent to the standard error stream of the program "
  4601. "utilizing the <literal>apt</literal> libraries, or enable special program "
  4602. "modes that are primarily useful for debugging the behavior of <literal>apt</"
  4603. "literal>. Most of these options are not interesting to a normal user, but a "
  4604. "few may be:"
  4605. msgstr ""
  4606. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4607. #: apt.conf.5.xml:724
  4608. msgid ""
  4609. "<literal>Debug::pkgProblemResolver</literal> enables output about the "
  4610. "decisions made by <literal>dist-upgrade, upgrade, install, remove, purge</"
  4611. "literal>."
  4612. msgstr ""
  4613. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4614. #: apt.conf.5.xml:732
  4615. msgid ""
  4616. "<literal>Debug::NoLocking</literal> disables all file locking. This can be "
  4617. "used to run some operations (for instance, <literal>apt-get -s install</"
  4618. "literal>) as a non-root user."
  4619. msgstr ""
  4620. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4621. #: apt.conf.5.xml:741
  4622. msgid ""
  4623. "<literal>Debug::pkgDPkgPM</literal> prints out the actual command line each "
  4624. "time that <literal>apt</literal> invokes &dpkg;."
  4625. msgstr ""
  4626. #. TODO: provide a
  4627. #. motivating example, except I haven't a clue why you'd want
  4628. #. to do this.
  4629. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4630. #: apt.conf.5.xml:749
  4631. msgid ""
  4632. "<literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data "
  4633. "in CDROM IDs."
  4634. msgstr ""
  4635. #. type: Content of: <refentry><refsect1><para>
  4636. #: apt.conf.5.xml:759
  4637. msgid "A full list of debugging options to apt follows."
  4638. msgstr ""
  4639. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4640. #: apt.conf.5.xml:764
  4641. msgid "<literal>Debug::Acquire::cdrom</literal>"
  4642. msgstr ""
  4643. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4644. #: apt.conf.5.xml:768
  4645. msgid ""
  4646. "Print information related to accessing <literal>cdrom://</literal> sources."
  4647. msgstr ""
  4648. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4649. #: apt.conf.5.xml:775
  4650. msgid "<literal>Debug::Acquire::ftp</literal>"
  4651. msgstr ""
  4652. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4653. #: apt.conf.5.xml:779
  4654. msgid "Print information related to downloading packages using FTP."
  4655. msgstr ""
  4656. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4657. #: apt.conf.5.xml:786
  4658. msgid "<literal>Debug::Acquire::http</literal>"
  4659. msgstr ""
  4660. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4661. #: apt.conf.5.xml:790
  4662. msgid "Print information related to downloading packages using HTTP."
  4663. msgstr ""
  4664. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4665. #: apt.conf.5.xml:797
  4666. msgid "<literal>Debug::Acquire::https</literal>"
  4667. msgstr ""
  4668. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4669. #: apt.conf.5.xml:801
  4670. msgid "Print information related to downloading packages using HTTPS."
  4671. msgstr ""
  4672. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4673. #: apt.conf.5.xml:808
  4674. msgid "<literal>Debug::Acquire::gpgv</literal>"
  4675. msgstr ""
  4676. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4677. #: apt.conf.5.xml:812
  4678. msgid ""
  4679. "Print information related to verifying cryptographic signatures using "
  4680. "<literal>gpg</literal>."
  4681. msgstr ""
  4682. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4683. #: apt.conf.5.xml:819
  4684. msgid "<literal>Debug::aptcdrom</literal>"
  4685. msgstr ""
  4686. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4687. #: apt.conf.5.xml:823
  4688. msgid ""
  4689. "Output information about the process of accessing collections of packages "
  4690. "stored on CD-ROMs."
  4691. msgstr ""
  4692. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4693. #: apt.conf.5.xml:830
  4694. msgid "<literal>Debug::BuildDeps</literal>"
  4695. msgstr ""
  4696. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4697. #: apt.conf.5.xml:833
  4698. msgid "Describes the process of resolving build-dependencies in &apt-get;."
  4699. msgstr ""
  4700. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4701. #: apt.conf.5.xml:840
  4702. msgid "<literal>Debug::Hashes</literal>"
  4703. msgstr ""
  4704. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4705. #: apt.conf.5.xml:843
  4706. msgid ""
  4707. "Output each cryptographic hash that is generated by the <literal>apt</"
  4708. "literal> libraries."
  4709. msgstr ""
  4710. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4711. #: apt.conf.5.xml:850
  4712. msgid "<literal>Debug::IdentCDROM</literal>"
  4713. msgstr ""
  4714. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4715. #: apt.conf.5.xml:853
  4716. msgid ""
  4717. "Do not include information from <literal>statfs</literal>, namely the number "
  4718. "of used and free blocks on the CD-ROM filesystem, when generating an ID for "
  4719. "a CD-ROM."
  4720. msgstr ""
  4721. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4722. #: apt.conf.5.xml:861
  4723. msgid "<literal>Debug::NoLocking</literal>"
  4724. msgstr ""
  4725. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4726. #: apt.conf.5.xml:864
  4727. msgid ""
  4728. "Disable all file locking. For instance, this will allow two instances of "
  4729. "<quote><literal>apt-get update</literal></quote> to run at the same time."
  4730. msgstr ""
  4731. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4732. #: apt.conf.5.xml:872
  4733. msgid "<literal>Debug::pkgAcquire</literal>"
  4734. msgstr ""
  4735. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4736. #: apt.conf.5.xml:876
  4737. msgid "Log when items are added to or removed from the global download queue."
  4738. msgstr ""
  4739. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4740. #: apt.conf.5.xml:883
  4741. msgid "<literal>Debug::pkgAcquire::Auth</literal>"
  4742. msgstr ""
  4743. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4744. #: apt.conf.5.xml:886
  4745. msgid ""
  4746. "Output status messages and errors related to verifying checksums and "
  4747. "cryptographic signatures of downloaded files."
  4748. msgstr ""
  4749. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4750. #: apt.conf.5.xml:893
  4751. msgid "<literal>Debug::pkgAcquire::Diffs</literal>"
  4752. msgstr ""
  4753. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4754. #: apt.conf.5.xml:896
  4755. msgid ""
  4756. "Output information about downloading and applying package index list diffs, "
  4757. "and errors relating to package index list diffs."
  4758. msgstr ""
  4759. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4760. #: apt.conf.5.xml:904
  4761. msgid "<literal>Debug::pkgAcquire::RRed</literal>"
  4762. msgstr ""
  4763. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4764. #: apt.conf.5.xml:908
  4765. msgid ""
  4766. "Output information related to patching apt package lists when downloading "
  4767. "index diffs instead of full indices."
  4768. msgstr ""
  4769. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4770. #: apt.conf.5.xml:915
  4771. msgid "<literal>Debug::pkgAcquire::Worker</literal>"
  4772. msgstr ""
  4773. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4774. #: apt.conf.5.xml:919
  4775. msgid ""
  4776. "Log all interactions with the sub-processes that actually perform downloads."
  4777. msgstr ""
  4778. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4779. #: apt.conf.5.xml:926
  4780. msgid "<literal>Debug::pkgAutoRemove</literal>"
  4781. msgstr ""
  4782. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4783. #: apt.conf.5.xml:930
  4784. msgid ""
  4785. "Log events related to the automatically-installed status of packages and to "
  4786. "the removal of unused packages."
  4787. msgstr ""
  4788. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4789. #: apt.conf.5.xml:937
  4790. msgid "<literal>Debug::pkgDepCache::AutoInstall</literal>"
  4791. msgstr ""
  4792. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4793. #: apt.conf.5.xml:940
  4794. msgid ""
  4795. "Generate debug messages describing which packages are being automatically "
  4796. "installed to resolve dependencies. This corresponds to the initial auto-"
  4797. "install pass performed in, e.g., <literal>apt-get install</literal>, and not "
  4798. "to the full <literal>apt</literal> dependency resolver; see <literal>Debug::"
  4799. "pkgProblemResolver</literal> for that."
  4800. msgstr ""
  4801. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4802. #: apt.conf.5.xml:951
  4803. msgid "<literal>Debug::pkgDepCache::Marker</literal>"
  4804. msgstr ""
  4805. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4806. #: apt.conf.5.xml:954
  4807. msgid ""
  4808. "Generate debug messages describing which package is marked as keep/install/"
  4809. "remove while the ProblemResolver does his work. Each addition or deletion "
  4810. "may trigger additional actions; they are shown indented two additional space "
  4811. "under the original entry. The format for each line is <literal>MarkKeep</"
  4812. "literal>, <literal>MarkDelete</literal> or <literal>MarkInstall</literal> "
  4813. "followed by <literal>package-name &lt;a.b.c -&gt; d.e.f | x.y.z&gt; (section)"
  4814. "</literal> where <literal>a.b.c</literal> is the current version of the "
  4815. "package, <literal>d.e.f</literal> is the version considered for installation "
  4816. "and <literal>x.y.z</literal> is a newer version, but not considered for "
  4817. "installation (because of a low pin score). The later two can be omitted if "
  4818. "there is none or if it is the same version as the installed. "
  4819. "<literal>section</literal> is the name of the section the package appears in."
  4820. msgstr ""
  4821. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4822. #: apt.conf.5.xml:973
  4823. msgid "<literal>Debug::pkgInitConfig</literal>"
  4824. msgstr ""
  4825. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4826. #: apt.conf.5.xml:976
  4827. msgid "Dump the default configuration to standard error on startup."
  4828. msgstr ""
  4829. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4830. #: apt.conf.5.xml:983
  4831. msgid "<literal>Debug::pkgDPkgPM</literal>"
  4832. msgstr ""
  4833. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4834. #: apt.conf.5.xml:986
  4835. msgid ""
  4836. "When invoking &dpkg;, output the precise command line with which it is being "
  4837. "invoked, with arguments separated by a single space character."
  4838. msgstr ""
  4839. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4840. #: apt.conf.5.xml:994
  4841. msgid "<literal>Debug::pkgDPkgProgressReporting</literal>"
  4842. msgstr ""
  4843. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4844. #: apt.conf.5.xml:997
  4845. msgid ""
  4846. "Output all the data received from &dpkg; on the status file descriptor and "
  4847. "any errors encountered while parsing it."
  4848. msgstr ""
  4849. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4850. #: apt.conf.5.xml:1004
  4851. msgid "<literal>Debug::pkgOrderList</literal>"
  4852. msgstr ""
  4853. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4854. #: apt.conf.5.xml:1008
  4855. msgid ""
  4856. "Generate a trace of the algorithm that decides the order in which "
  4857. "<literal>apt</literal> should pass packages to &dpkg;."
  4858. msgstr ""
  4859. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4860. #: apt.conf.5.xml:1016
  4861. msgid "<literal>Debug::pkgPackageManager</literal>"
  4862. msgstr ""
  4863. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4864. #: apt.conf.5.xml:1020
  4865. msgid ""
  4866. "Output status messages tracing the steps performed when invoking &dpkg;."
  4867. msgstr ""
  4868. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4869. #: apt.conf.5.xml:1027
  4870. msgid "<literal>Debug::pkgPolicy</literal>"
  4871. msgstr ""
  4872. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4873. #: apt.conf.5.xml:1031
  4874. msgid "Output the priority of each package list on startup."
  4875. msgstr ""
  4876. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4877. #: apt.conf.5.xml:1037
  4878. msgid "<literal>Debug::pkgProblemResolver</literal>"
  4879. msgstr ""
  4880. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4881. #: apt.conf.5.xml:1041
  4882. msgid ""
  4883. "Trace the execution of the dependency resolver (this applies only to what "
  4884. "happens when a complex dependency problem is encountered)."
  4885. msgstr ""
  4886. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4887. #: apt.conf.5.xml:1049
  4888. msgid "<literal>Debug::pkgProblemResolver::ShowScores</literal>"
  4889. msgstr ""
  4890. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4891. #: apt.conf.5.xml:1052
  4892. msgid ""
  4893. "Display a list of all installed packages with their calculated score used by "
  4894. "the pkgProblemResolver. The description of the package is the same as "
  4895. "described in <literal>Debug::pkgDepCache::Marker</literal>"
  4896. msgstr ""
  4897. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4898. #: apt.conf.5.xml:1060
  4899. msgid "<literal>Debug::sourceList</literal>"
  4900. msgstr ""
  4901. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4902. #: apt.conf.5.xml:1064
  4903. msgid ""
  4904. "Print information about the vendors read from <filename>/etc/apt/vendors."
  4905. "list</filename>."
  4906. msgstr ""
  4907. #. type: Content of: <refentry><refsect1><para>
  4908. #: apt.conf.5.xml:1087
  4909. msgid ""
  4910. "&configureindex; is a configuration file showing example values for all "
  4911. "possible options."
  4912. msgstr ""
  4913. #. type: Content of: <refentry><refsect1><variablelist>
  4914. #: apt.conf.5.xml:1094
  4915. msgid "&file-aptconf;"
  4916. msgstr ""
  4917. #. ? reading apt.conf
  4918. #. type: Content of: <refentry><refsect1><para>
  4919. #: apt.conf.5.xml:1099
  4920. msgid "&apt-cache;, &apt-config;, &apt-preferences;."
  4921. msgstr ""
  4922. #. The last update date
  4923. #. type: Content of: <refentry><refentryinfo>
  4924. #: apt_preferences.5.xml:16
  4925. msgid ""
  4926. "&apt-author.team; &apt-email; &apt-product; <date>16 February 2010</date>"
  4927. msgstr ""
  4928. #. type: Content of: <refentry><refnamediv><refname>
  4929. #: apt_preferences.5.xml:24 apt_preferences.5.xml:31
  4930. msgid "apt_preferences"
  4931. msgstr ""
  4932. #. type: Content of: <refentry><refnamediv><refpurpose>
  4933. #: apt_preferences.5.xml:32
  4934. msgid "Preference control file for APT"
  4935. msgstr ""
  4936. #. type: Content of: <refentry><refsect1><para>
  4937. #: apt_preferences.5.xml:37
  4938. msgid ""
  4939. "The APT preferences file <filename>/etc/apt/preferences</filename> and the "
  4940. "fragment files in the <filename>/etc/apt/preferences.d/</filename> folder "
  4941. "can be used to control which versions of packages will be selected for "
  4942. "installation."
  4943. msgstr ""
  4944. #. type: Content of: <refentry><refsect1><para>
  4945. #: apt_preferences.5.xml:42
  4946. msgid ""
  4947. "Several versions of a package may be available for installation when the "
  4948. "&sources-list; file contains references to more than one distribution (for "
  4949. "example, <literal>stable</literal> and <literal>testing</literal>). APT "
  4950. "assigns a priority to each version that is available. Subject to dependency "
  4951. "constraints, <command>apt-get</command> selects the version with the highest "
  4952. "priority for installation. The APT preferences file overrides the "
  4953. "priorities that APT assigns to package versions by default, thus giving the "
  4954. "user control over which one is selected for installation."
  4955. msgstr ""
  4956. #. type: Content of: <refentry><refsect1><para>
  4957. #: apt_preferences.5.xml:52
  4958. msgid ""
  4959. "Several instances of the same version of a package may be available when the "
  4960. "&sources-list; file contains references to more than one source. In this "
  4961. "case <command>apt-get</command> downloads the instance listed earliest in "
  4962. "the &sources-list; file. The APT preferences file does not affect the "
  4963. "choice of instance, only the choice of version."
  4964. msgstr ""
  4965. #. type: Content of: <refentry><refsect1><para>
  4966. #: apt_preferences.5.xml:59
  4967. msgid ""
  4968. "Preferences are a strong power in the hands of a system administrator but "
  4969. "they can become also their biggest nightmare if used without care! APT will "
  4970. "not questioning the preferences so wrong settings will therefore lead to "
  4971. "uninstallable packages or wrong decisions while upgrading packages. Even "
  4972. "more problems will arise if multiply distribution releases are mixed without "
  4973. "a good understanding of the following paragraphs. Packages included in a "
  4974. "specific release aren't tested in and therefore doesn't always work as "
  4975. "expected in older or newer releases or together with other packages from "
  4976. "different releases. You have been warned."
  4977. msgstr ""
  4978. #. type: Content of: <refentry><refsect1><para>
  4979. #: apt_preferences.5.xml:70
  4980. msgid ""
  4981. "Note that the files in the <filename>/etc/apt/preferences.d</filename> "
  4982. "directory are parsed in alphanumeric ascending order and need to obey the "
  4983. "following naming convention: The files have no or \"<literal>pref</literal>"
  4984. "\" as filename extension and which only contain alphanumeric, hyphen (-), "
  4985. "underscore (_) and period (.) characters - otherwise they will be silently "
  4986. "ignored."
  4987. msgstr ""
  4988. #. type: Content of: <refentry><refsect1><refsect2><title>
  4989. #: apt_preferences.5.xml:77
  4990. msgid "APT's Default Priority Assignments"
  4991. msgstr ""
  4992. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4993. #: apt_preferences.5.xml:92
  4994. #, no-wrap
  4995. msgid "<command>apt-get install -t testing <replaceable>some-package</replaceable></command>\n"
  4996. msgstr ""
  4997. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4998. #: apt_preferences.5.xml:95
  4999. #, no-wrap
  5000. msgid "APT::Default-Release \"stable\";\n"
  5001. msgstr ""
  5002. #. type: Content of: <refentry><refsect1><refsect2><para>
  5003. #: apt_preferences.5.xml:79
  5004. msgid ""
  5005. "If there is no preferences file or if there is no entry in the file that "
  5006. "applies to a particular version then the priority assigned to that version "
  5007. "is the priority of the distribution to which that version belongs. It is "
  5008. "possible to single out a distribution, \"the target release\", which "
  5009. "receives a higher priority than other distributions do by default. The "
  5010. "target release can be set on the <command>apt-get</command> command line or "
  5011. "in the APT configuration file <filename>/etc/apt/apt.conf</filename>. Note "
  5012. "that this has precedence over any general priority you set in the <filename>/"
  5013. "etc/apt/preferences</filename> file described later, but not over "
  5014. "specifically pinned packages. For example, <placeholder type="
  5015. "\"programlisting\" id=\"0\"/> <placeholder type=\"programlisting\" id=\"1\"/>"
  5016. msgstr ""
  5017. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5018. #: apt_preferences.5.xml:104
  5019. msgid "priority 1"
  5020. msgstr ""
  5021. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5022. #: apt_preferences.5.xml:105
  5023. msgid ""
  5024. "to the versions coming from archives which in their <filename>Release</"
  5025. "filename> files are marked as \"NotAutomatic: yes\" like the debian "
  5026. "experimental archive."
  5027. msgstr ""
  5028. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5029. #: apt_preferences.5.xml:110
  5030. msgid "priority 100"
  5031. msgstr ""
  5032. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5033. #: apt_preferences.5.xml:111
  5034. msgid "to the version that is already installed (if any)."
  5035. msgstr ""
  5036. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5037. #: apt_preferences.5.xml:115
  5038. msgid "priority 500"
  5039. msgstr ""
  5040. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5041. #: apt_preferences.5.xml:116
  5042. msgid ""
  5043. "to the versions that are not installed and do not belong to the target "
  5044. "release."
  5045. msgstr ""
  5046. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5047. #: apt_preferences.5.xml:120
  5048. msgid "priority 990"
  5049. msgstr ""
  5050. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5051. #: apt_preferences.5.xml:121
  5052. msgid ""
  5053. "to the versions that are not installed and belong to the target release."
  5054. msgstr ""
  5055. #. type: Content of: <refentry><refsect1><refsect2><para>
  5056. #: apt_preferences.5.xml:99
  5057. msgid ""
  5058. "If the target release has been specified then APT uses the following "
  5059. "algorithm to set the priorities of the versions of a package. Assign: "
  5060. "<placeholder type=\"variablelist\" id=\"0\"/>"
  5061. msgstr ""
  5062. #. type: Content of: <refentry><refsect1><refsect2><para>
  5063. #: apt_preferences.5.xml:126
  5064. msgid ""
  5065. "If the target release has not been specified then APT simply assigns "
  5066. "priority 100 to all installed package versions and priority 500 to all "
  5067. "uninstalled package versions, expect versions coming from archives which in "
  5068. "their <filename>Release</filename> files are marked as \"NotAutomatic: yes\" "
  5069. "- these versions get the priority 1."
  5070. msgstr ""
  5071. #. type: Content of: <refentry><refsect1><refsect2><para>
  5072. #: apt_preferences.5.xml:132
  5073. msgid ""
  5074. "APT then applies the following rules, listed in order of precedence, to "
  5075. "determine which version of a package to install."
  5076. msgstr ""
  5077. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5078. #: apt_preferences.5.xml:135
  5079. msgid ""
  5080. "Never downgrade unless the priority of an available version exceeds 1000. "
  5081. "(\"Downgrading\" is installing a less recent version of a package in place "
  5082. "of a more recent version. Note that none of APT's default priorities "
  5083. "exceeds 1000; such high priorities can only be set in the preferences file. "
  5084. "Note also that downgrading a package can be risky.)"
  5085. msgstr ""
  5086. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5087. #: apt_preferences.5.xml:141
  5088. msgid "Install the highest priority version."
  5089. msgstr ""
  5090. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5091. #: apt_preferences.5.xml:142
  5092. msgid ""
  5093. "If two or more versions have the same priority, install the most recent one "
  5094. "(that is, the one with the higher version number)."
  5095. msgstr ""
  5096. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5097. #: apt_preferences.5.xml:145
  5098. msgid ""
  5099. "If two or more versions have the same priority and version number but either "
  5100. "the packages differ in some of their metadata or the <literal>--reinstall</"
  5101. "literal> option is given, install the uninstalled one."
  5102. msgstr ""
  5103. #. type: Content of: <refentry><refsect1><refsect2><para>
  5104. #: apt_preferences.5.xml:151
  5105. msgid ""
  5106. "In a typical situation, the installed version of a package (priority 100) "
  5107. "is not as recent as one of the versions available from the sources listed in "
  5108. "the &sources-list; file (priority 500 or 990). Then the package will be "
  5109. "upgraded when <command>apt-get install <replaceable>some-package</"
  5110. "replaceable></command> or <command>apt-get upgrade</command> is executed."
  5111. msgstr ""
  5112. #. type: Content of: <refentry><refsect1><refsect2><para>
  5113. #: apt_preferences.5.xml:158
  5114. msgid ""
  5115. "More rarely, the installed version of a package is <emphasis>more</emphasis> "
  5116. "recent than any of the other available versions. The package will not be "
  5117. "downgraded when <command>apt-get install <replaceable>some-package</"
  5118. "replaceable></command> or <command>apt-get upgrade</command> is executed."
  5119. msgstr ""
  5120. #. type: Content of: <refentry><refsect1><refsect2><para>
  5121. #: apt_preferences.5.xml:163
  5122. msgid ""
  5123. "Sometimes the installed version of a package is more recent than the version "
  5124. "belonging to the target release, but not as recent as a version belonging to "
  5125. "some other distribution. Such a package will indeed be upgraded when "
  5126. "<command>apt-get install <replaceable>some-package</replaceable></command> "
  5127. "or <command>apt-get upgrade</command> is executed, because at least "
  5128. "<emphasis>one</emphasis> of the available versions has a higher priority "
  5129. "than the installed version."
  5130. msgstr ""
  5131. #. type: Content of: <refentry><refsect1><refsect2><title>
  5132. #: apt_preferences.5.xml:172
  5133. msgid "The Effect of APT Preferences"
  5134. msgstr ""
  5135. #. type: Content of: <refentry><refsect1><refsect2><para>
  5136. #: apt_preferences.5.xml:174
  5137. msgid ""
  5138. "The APT preferences file allows the system administrator to control the "
  5139. "assignment of priorities. The file consists of one or more multi-line "
  5140. "records separated by blank lines. Records can have one of two forms, a "
  5141. "specific form and a general form."
  5142. msgstr ""
  5143. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5144. #: apt_preferences.5.xml:180
  5145. msgid ""
  5146. "The specific form assigns a priority (a \"Pin-Priority\") to one or more "
  5147. "specified packages and specified version or version range. For example, the "
  5148. "following record assigns a high priority to all versions of the "
  5149. "<filename>perl</filename> package whose version number begins with "
  5150. "\"<literal>5.8</literal>\". Multiple packages can be separated by spaces."
  5151. msgstr ""
  5152. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5153. #: apt_preferences.5.xml:187
  5154. #, no-wrap
  5155. msgid ""
  5156. "Package: perl\n"
  5157. "Pin: version 5.8*\n"
  5158. "Pin-Priority: 1001\n"
  5159. msgstr ""
  5160. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5161. #: apt_preferences.5.xml:193
  5162. msgid ""
  5163. "The general form assigns a priority to all of the package versions in a "
  5164. "given distribution (that is, to all the versions of packages that are listed "
  5165. "in a certain <filename>Release</filename> file) or to all of the package "
  5166. "versions coming from a particular Internet site, as identified by the site's "
  5167. "fully qualified domain name."
  5168. msgstr ""
  5169. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5170. #: apt_preferences.5.xml:199
  5171. msgid ""
  5172. "This general-form entry in the APT preferences file applies only to groups "
  5173. "of packages. For example, the following record assigns a high priority to "
  5174. "all package versions available from the local site."
  5175. msgstr ""
  5176. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5177. #: apt_preferences.5.xml:204
  5178. #, no-wrap
  5179. msgid ""
  5180. "Package: *\n"
  5181. "Pin: origin \"\"\n"
  5182. "Pin-Priority: 999\n"
  5183. msgstr ""
  5184. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5185. #: apt_preferences.5.xml:209
  5186. msgid ""
  5187. "A note of caution: the keyword used here is \"<literal>origin</literal>\" "
  5188. "which can be used to match a hostname. The following record will assign a "
  5189. "high priority to all versions available from the server identified by the "
  5190. "hostname \"ftp.de.debian.org\""
  5191. msgstr ""
  5192. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5193. #: apt_preferences.5.xml:213
  5194. #, no-wrap
  5195. msgid ""
  5196. "Package: *\n"
  5197. "Pin: origin \"ftp.de.debian.org\"\n"
  5198. "Pin-Priority: 999\n"
  5199. msgstr ""
  5200. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5201. #: apt_preferences.5.xml:217
  5202. msgid ""
  5203. "This should <emphasis>not</emphasis> be confused with the Origin of a "
  5204. "distribution as specified in a <filename>Release</filename> file. What "
  5205. "follows the \"Origin:\" tag in a <filename>Release</filename> file is not an "
  5206. "Internet address but an author or vendor name, such as \"Debian\" or \"Ximian"
  5207. "\"."
  5208. msgstr ""
  5209. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5210. #: apt_preferences.5.xml:222
  5211. msgid ""
  5212. "The following record assigns a low priority to all package versions "
  5213. "belonging to any distribution whose Archive name is \"<literal>unstable</"
  5214. "literal>\"."
  5215. msgstr ""
  5216. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5217. #: apt_preferences.5.xml:226
  5218. #, no-wrap
  5219. msgid ""
  5220. "Package: *\n"
  5221. "Pin: release a=unstable\n"
  5222. "Pin-Priority: 50\n"
  5223. msgstr ""
  5224. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5225. #: apt_preferences.5.xml:231
  5226. msgid ""
  5227. "The following record assigns a high priority to all package versions "
  5228. "belonging to any distribution whose Codename is \"<literal>&testing-codename;"
  5229. "</literal>\"."
  5230. msgstr ""
  5231. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5232. #: apt_preferences.5.xml:235
  5233. #, no-wrap
  5234. msgid ""
  5235. "Package: *\n"
  5236. "Pin: release n=&testing-codename;\n"
  5237. "Pin-Priority: 900\n"
  5238. msgstr ""
  5239. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5240. #: apt_preferences.5.xml:240
  5241. msgid ""
  5242. "The following record assigns a high priority to all package versions "
  5243. "belonging to any release whose Archive name is \"<literal>stable</literal>\" "
  5244. "and whose release Version number is \"<literal>3.0</literal>\"."
  5245. msgstr ""
  5246. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5247. #: apt_preferences.5.xml:245
  5248. #, no-wrap
  5249. msgid ""
  5250. "Package: *\n"
  5251. "Pin: release a=stable, v=3.0\n"
  5252. "Pin-Priority: 500\n"
  5253. msgstr ""
  5254. #. type: Content of: <refentry><refsect1><refsect2><title>
  5255. #: apt_preferences.5.xml:256
  5256. msgid "How APT Interprets Priorities"
  5257. msgstr ""
  5258. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5259. #: apt_preferences.5.xml:264
  5260. msgid "P &gt; 1000"
  5261. msgstr ""
  5262. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5263. #: apt_preferences.5.xml:265
  5264. msgid ""
  5265. "causes a version to be installed even if this constitutes a downgrade of the "
  5266. "package"
  5267. msgstr ""
  5268. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5269. #: apt_preferences.5.xml:269
  5270. msgid "990 &lt; P &lt;=1000"
  5271. msgstr ""
  5272. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5273. #: apt_preferences.5.xml:270
  5274. msgid ""
  5275. "causes a version to be installed even if it does not come from the target "
  5276. "release, unless the installed version is more recent"
  5277. msgstr ""
  5278. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5279. #: apt_preferences.5.xml:275
  5280. msgid "500 &lt; P &lt;=990"
  5281. msgstr ""
  5282. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5283. #: apt_preferences.5.xml:276
  5284. msgid ""
  5285. "causes a version to be installed unless there is a version available "
  5286. "belonging to the target release or the installed version is more recent"
  5287. msgstr ""
  5288. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5289. #: apt_preferences.5.xml:281
  5290. msgid "100 &lt; P &lt;=500"
  5291. msgstr ""
  5292. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5293. #: apt_preferences.5.xml:282
  5294. msgid ""
  5295. "causes a version to be installed unless there is a version available "
  5296. "belonging to some other distribution or the installed version is more recent"
  5297. msgstr ""
  5298. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5299. #: apt_preferences.5.xml:287
  5300. msgid "0 &lt; P &lt;=100"
  5301. msgstr ""
  5302. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5303. #: apt_preferences.5.xml:288
  5304. msgid ""
  5305. "causes a version to be installed only if there is no installed version of "
  5306. "the package"
  5307. msgstr ""
  5308. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5309. #: apt_preferences.5.xml:292
  5310. msgid "P &lt; 0"
  5311. msgstr ""
  5312. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5313. #: apt_preferences.5.xml:293
  5314. msgid "prevents the version from being installed"
  5315. msgstr ""
  5316. #. type: Content of: <refentry><refsect1><refsect2><para>
  5317. #: apt_preferences.5.xml:259
  5318. msgid ""
  5319. "Priorities (P) assigned in the APT preferences file must be positive or "
  5320. "negative integers. They are interpreted as follows (roughly speaking): "
  5321. "<placeholder type=\"variablelist\" id=\"0\"/>"
  5322. msgstr ""
  5323. #. type: Content of: <refentry><refsect1><refsect2><para>
  5324. #: apt_preferences.5.xml:298
  5325. msgid ""
  5326. "If any specific-form records match an available package version then the "
  5327. "first such record determines the priority of the package version. Failing "
  5328. "that, if any general-form records match an available package version then "
  5329. "the first such record determines the priority of the package version."
  5330. msgstr ""
  5331. #. type: Content of: <refentry><refsect1><refsect2><para>
  5332. #: apt_preferences.5.xml:304
  5333. msgid ""
  5334. "For example, suppose the APT preferences file contains the three records "
  5335. "presented earlier:"
  5336. msgstr ""
  5337. #. type: Content of: <refentry><refsect1><refsect2><programlisting>
  5338. #: apt_preferences.5.xml:308
  5339. #, no-wrap
  5340. msgid ""
  5341. "Package: perl\n"
  5342. "Pin: version 5.8*\n"
  5343. "Pin-Priority: 1001\n"
  5344. "\n"
  5345. "Package: *\n"
  5346. "Pin: origin \"\"\n"
  5347. "Pin-Priority: 999\n"
  5348. "\n"
  5349. "Package: *\n"
  5350. "Pin: release unstable\n"
  5351. "Pin-Priority: 50\n"
  5352. msgstr ""
  5353. #. type: Content of: <refentry><refsect1><refsect2><para>
  5354. #: apt_preferences.5.xml:321
  5355. msgid "Then:"
  5356. msgstr ""
  5357. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5358. #: apt_preferences.5.xml:323
  5359. msgid ""
  5360. "The most recent available version of the <literal>perl</literal> package "
  5361. "will be installed, so long as that version's version number begins with "
  5362. "\"<literal>5.8</literal>\". If <emphasis>any</emphasis> 5.8* version of "
  5363. "<literal>perl</literal> is available and the installed version is 5.9*, then "
  5364. "<literal>perl</literal> will be downgraded."
  5365. msgstr ""
  5366. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5367. #: apt_preferences.5.xml:328
  5368. msgid ""
  5369. "A version of any package other than <literal>perl</literal> that is "
  5370. "available from the local system has priority over other versions, even "
  5371. "versions belonging to the target release."
  5372. msgstr ""
  5373. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5374. #: apt_preferences.5.xml:332
  5375. msgid ""
  5376. "A version of a package whose origin is not the local system but some other "
  5377. "site listed in &sources-list; and which belongs to an <literal>unstable</"
  5378. "literal> distribution is only installed if it is selected for installation "
  5379. "and no version of the package is already installed."
  5380. msgstr ""
  5381. #. type: Content of: <refentry><refsect1><refsect2><title>
  5382. #: apt_preferences.5.xml:342
  5383. msgid "Determination of Package Version and Distribution Properties"
  5384. msgstr ""
  5385. #. type: Content of: <refentry><refsect1><refsect2><para>
  5386. #: apt_preferences.5.xml:344
  5387. msgid ""
  5388. "The locations listed in the &sources-list; file should provide "
  5389. "<filename>Packages</filename> and <filename>Release</filename> files to "
  5390. "describe the packages available at that location."
  5391. msgstr ""
  5392. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5393. #: apt_preferences.5.xml:356
  5394. msgid "the <literal>Package:</literal> line"
  5395. msgstr ""
  5396. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5397. #: apt_preferences.5.xml:357
  5398. msgid "gives the package name"
  5399. msgstr ""
  5400. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5401. #: apt_preferences.5.xml:360 apt_preferences.5.xml:410
  5402. msgid "the <literal>Version:</literal> line"
  5403. msgstr ""
  5404. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5405. #: apt_preferences.5.xml:361
  5406. msgid "gives the version number for the named package"
  5407. msgstr ""
  5408. #. type: Content of: <refentry><refsect1><refsect2><para>
  5409. #: apt_preferences.5.xml:348
  5410. msgid ""
  5411. "The <filename>Packages</filename> file is normally found in the directory "
  5412. "<filename>.../dists/<replaceable>dist-name</replaceable>/"
  5413. "<replaceable>component</replaceable>/<replaceable>arch</replaceable></"
  5414. "filename>: for example, <filename>.../dists/stable/main/binary-i386/"
  5415. "Packages</filename>. It consists of a series of multi-line records, one for "
  5416. "each package available in that directory. Only two lines in each record are "
  5417. "relevant for setting APT priorities: <placeholder type=\"variablelist\" id="
  5418. "\"0\"/>"
  5419. msgstr ""
  5420. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5421. #: apt_preferences.5.xml:377
  5422. msgid "the <literal>Archive:</literal> or <literal>Suite:</literal> line"
  5423. msgstr ""
  5424. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5425. #: apt_preferences.5.xml:378
  5426. msgid ""
  5427. "names the archive to which all the packages in the directory tree belong. "
  5428. "For example, the line \"Archive: stable\" or \"Suite: stable\" specifies "
  5429. "that all of the packages in the directory tree below the parent of the "
  5430. "<filename>Release</filename> file are in a <literal>stable</literal> "
  5431. "archive. Specifying this value in the APT preferences file would require "
  5432. "the line:"
  5433. msgstr ""
  5434. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5435. #: apt_preferences.5.xml:388
  5436. #, no-wrap
  5437. msgid "Pin: release a=stable\n"
  5438. msgstr ""
  5439. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5440. #: apt_preferences.5.xml:394
  5441. msgid "the <literal>Codename:</literal> line"
  5442. msgstr ""
  5443. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5444. #: apt_preferences.5.xml:395
  5445. msgid ""
  5446. "names the codename to which all the packages in the directory tree belong. "
  5447. "For example, the line \"Codename: &testing-codename;\" specifies that all of "
  5448. "the packages in the directory tree below the parent of the "
  5449. "<filename>Release</filename> file belong to a version named "
  5450. "<literal>&testing-codename;</literal>. Specifying this value in the APT "
  5451. "preferences file would require the line:"
  5452. msgstr ""
  5453. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5454. #: apt_preferences.5.xml:404
  5455. #, no-wrap
  5456. msgid "Pin: release n=&testing-codename;\n"
  5457. msgstr ""
  5458. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5459. #: apt_preferences.5.xml:411
  5460. msgid ""
  5461. "names the release version. For example, the packages in the tree might "
  5462. "belong to Debian GNU/Linux release version 3.0. Note that there is normally "
  5463. "no version number for the <literal>testing</literal> and <literal>unstable</"
  5464. "literal> distributions because they have not been released yet. Specifying "
  5465. "this in the APT preferences file would require one of the following lines."
  5466. msgstr ""
  5467. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5468. #: apt_preferences.5.xml:420
  5469. #, no-wrap
  5470. msgid ""
  5471. "Pin: release v=3.0\n"
  5472. "Pin: release a=stable, v=3.0\n"
  5473. "Pin: release 3.0\n"
  5474. msgstr ""
  5475. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5476. #: apt_preferences.5.xml:429
  5477. msgid "the <literal>Component:</literal> line"
  5478. msgstr ""
  5479. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5480. #: apt_preferences.5.xml:430
  5481. msgid ""
  5482. "names the licensing component associated with the packages in the directory "
  5483. "tree of the <filename>Release</filename> file. For example, the line "
  5484. "\"Component: main\" specifies that all the packages in the directory tree "
  5485. "are from the <literal>main</literal> component, which entails that they are "
  5486. "licensed under terms listed in the Debian Free Software Guidelines. "
  5487. "Specifying this component in the APT preferences file would require the line:"
  5488. msgstr ""
  5489. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5490. #: apt_preferences.5.xml:439
  5491. #, no-wrap
  5492. msgid "Pin: release c=main\n"
  5493. msgstr ""
  5494. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5495. #: apt_preferences.5.xml:445
  5496. msgid "the <literal>Origin:</literal> line"
  5497. msgstr ""
  5498. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5499. #: apt_preferences.5.xml:446
  5500. msgid ""
  5501. "names the originator of the packages in the directory tree of the "
  5502. "<filename>Release</filename> file. Most commonly, this is <literal>Debian</"
  5503. "literal>. Specifying this origin in the APT preferences file would require "
  5504. "the line:"
  5505. msgstr ""
  5506. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5507. #: apt_preferences.5.xml:452
  5508. #, no-wrap
  5509. msgid "Pin: release o=Debian\n"
  5510. msgstr ""
  5511. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5512. #: apt_preferences.5.xml:458
  5513. msgid "the <literal>Label:</literal> line"
  5514. msgstr ""
  5515. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5516. #: apt_preferences.5.xml:459
  5517. msgid ""
  5518. "names the label of the packages in the directory tree of the "
  5519. "<filename>Release</filename> file. Most commonly, this is <literal>Debian</"
  5520. "literal>. Specifying this label in the APT preferences file would require "
  5521. "the line:"
  5522. msgstr ""
  5523. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5524. #: apt_preferences.5.xml:465
  5525. #, no-wrap
  5526. msgid "Pin: release l=Debian\n"
  5527. msgstr ""
  5528. #. type: Content of: <refentry><refsect1><refsect2><para>
  5529. #: apt_preferences.5.xml:366
  5530. msgid ""
  5531. "The <filename>Release</filename> file is normally found in the directory "
  5532. "<filename>.../dists/<replaceable>dist-name</replaceable></filename>: for "
  5533. "example, <filename>.../dists/stable/Release</filename>, or <filename>.../"
  5534. "dists/&stable-codename;/Release</filename>. It consists of a single multi-"
  5535. "line record which applies to <emphasis>all</emphasis> of the packages in the "
  5536. "directory tree below its parent. Unlike the <filename>Packages</filename> "
  5537. "file, nearly all of the lines in a <filename>Release</filename> file are "
  5538. "relevant for setting APT priorities: <placeholder type=\"variablelist\" id="
  5539. "\"0\"/>"
  5540. msgstr ""
  5541. #. type: Content of: <refentry><refsect1><refsect2><para>
  5542. #: apt_preferences.5.xml:472
  5543. msgid ""
  5544. "All of the <filename>Packages</filename> and <filename>Release</filename> "
  5545. "files retrieved from locations listed in the &sources-list; file are stored "
  5546. "in the directory <filename>/var/lib/apt/lists</filename>, or in the file "
  5547. "named by the variable <literal>Dir::State::Lists</literal> in the "
  5548. "<filename>apt.conf</filename> file. For example, the file <filename>debian."
  5549. "lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> "
  5550. "contains the <filename>Release</filename> file retrieved from the site "
  5551. "<literal>debian.lcs.mit.edu</literal> for <literal>binary-i386</literal> "
  5552. "architecture files from the <literal>contrib</literal> component of the "
  5553. "<literal>unstable</literal> distribution."
  5554. msgstr ""
  5555. #. type: Content of: <refentry><refsect1><refsect2><title>
  5556. #: apt_preferences.5.xml:485
  5557. msgid "Optional Lines in an APT Preferences Record"
  5558. msgstr ""
  5559. #. type: Content of: <refentry><refsect1><refsect2><para>
  5560. #: apt_preferences.5.xml:487
  5561. msgid ""
  5562. "Each record in the APT preferences file can optionally begin with one or "
  5563. "more lines beginning with the word <literal>Explanation:</literal>. This "
  5564. "provides a place for comments."
  5565. msgstr ""
  5566. #. type: Content of: <refentry><refsect1><refsect2><title>
  5567. #: apt_preferences.5.xml:496
  5568. msgid "Tracking Stable"
  5569. msgstr ""
  5570. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5571. #: apt_preferences.5.xml:504
  5572. #, no-wrap
  5573. msgid ""
  5574. "Explanation: Uninstall or do not install any Debian-originated\n"
  5575. "Explanation: package versions other than those in the stable distro\n"
  5576. "Package: *\n"
  5577. "Pin: release a=stable\n"
  5578. "Pin-Priority: 900\n"
  5579. "\n"
  5580. "Package: *\n"
  5581. "Pin: release o=Debian\n"
  5582. "Pin-Priority: -10\n"
  5583. msgstr ""
  5584. #. type: Content of: <refentry><refsect1><refsect2><para>
  5585. #: apt_preferences.5.xml:498
  5586. msgid ""
  5587. "The following APT preferences file will cause APT to assign a priority "
  5588. "higher than the default (500) to all package versions belonging to a "
  5589. "<literal>stable</literal> distribution and a prohibitively low priority to "
  5590. "package versions belonging to other <literal>Debian</literal> "
  5591. "distributions. <placeholder type=\"programlisting\" id=\"0\"/>"
  5592. msgstr ""
  5593. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5594. #: apt_preferences.5.xml:521 apt_preferences.5.xml:567
  5595. #: apt_preferences.5.xml:625
  5596. #, no-wrap
  5597. msgid ""
  5598. "apt-get install <replaceable>package-name</replaceable>\n"
  5599. "apt-get upgrade\n"
  5600. "apt-get dist-upgrade\n"
  5601. msgstr ""
  5602. #. type: Content of: <refentry><refsect1><refsect2><para>
  5603. #: apt_preferences.5.xml:516
  5604. msgid ""
  5605. "With a suitable &sources-list; file and the above preferences file, any of "
  5606. "the following commands will cause APT to upgrade to the latest "
  5607. "<literal>stable</literal> version(s). <placeholder type=\"programlisting\" "
  5608. "id=\"0\"/>"
  5609. msgstr ""
  5610. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5611. #: apt_preferences.5.xml:533
  5612. #, no-wrap
  5613. msgid "apt-get install <replaceable>package</replaceable>/testing\n"
  5614. msgstr ""
  5615. #. type: Content of: <refentry><refsect1><refsect2><para>
  5616. #: apt_preferences.5.xml:527
  5617. msgid ""
  5618. "The following command will cause APT to upgrade the specified package to the "
  5619. "latest version from the <literal>testing</literal> distribution; the package "
  5620. "will not be upgraded again unless this command is given again. <placeholder "
  5621. "type=\"programlisting\" id=\"0\"/>"
  5622. msgstr ""
  5623. #. type: Content of: <refentry><refsect1><refsect2><title>
  5624. #: apt_preferences.5.xml:539
  5625. msgid "Tracking Testing or Unstable"
  5626. msgstr ""
  5627. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5628. #: apt_preferences.5.xml:548
  5629. #, no-wrap
  5630. msgid ""
  5631. "Package: *\n"
  5632. "Pin: release a=testing\n"
  5633. "Pin-Priority: 900\n"
  5634. "\n"
  5635. "Package: *\n"
  5636. "Pin: release a=unstable\n"
  5637. "Pin-Priority: 800\n"
  5638. "\n"
  5639. "Package: *\n"
  5640. "Pin: release o=Debian\n"
  5641. "Pin-Priority: -10\n"
  5642. msgstr ""
  5643. #. type: Content of: <refentry><refsect1><refsect2><para>
  5644. #: apt_preferences.5.xml:541
  5645. msgid ""
  5646. "The following APT preferences file will cause APT to assign a high priority "
  5647. "to package versions from the <literal>testing</literal> distribution, a "
  5648. "lower priority to package versions from the <literal>unstable</literal> "
  5649. "distribution, and a prohibitively low priority to package versions from "
  5650. "other <literal>Debian</literal> distributions. <placeholder type="
  5651. "\"programlisting\" id=\"0\"/>"
  5652. msgstr ""
  5653. #. type: Content of: <refentry><refsect1><refsect2><para>
  5654. #: apt_preferences.5.xml:562
  5655. msgid ""
  5656. "With a suitable &sources-list; file and the above preferences file, any of "
  5657. "the following commands will cause APT to upgrade to the latest "
  5658. "<literal>testing</literal> version(s). <placeholder type=\"programlisting\" "
  5659. "id=\"0\"/>"
  5660. msgstr ""
  5661. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5662. #: apt_preferences.5.xml:582
  5663. #, no-wrap
  5664. msgid "apt-get install <replaceable>package</replaceable>/unstable\n"
  5665. msgstr ""
  5666. #. type: Content of: <refentry><refsect1><refsect2><para>
  5667. #: apt_preferences.5.xml:573
  5668. msgid ""
  5669. "The following command will cause APT to upgrade the specified package to the "
  5670. "latest version from the <literal>unstable</literal> distribution. "
  5671. "Thereafter, <command>apt-get upgrade</command> will upgrade the package to "
  5672. "the most recent <literal>testing</literal> version if that is more recent "
  5673. "than the installed version, otherwise, to the most recent <literal>unstable</"
  5674. "literal> version if that is more recent than the installed version. "
  5675. "<placeholder type=\"programlisting\" id=\"0\"/>"
  5676. msgstr ""
  5677. #. type: Content of: <refentry><refsect1><refsect2><title>
  5678. #: apt_preferences.5.xml:589
  5679. msgid "Tracking the evolution of a codename release"
  5680. msgstr ""
  5681. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5682. #: apt_preferences.5.xml:603
  5683. #, no-wrap
  5684. msgid ""
  5685. "Explanation: Uninstall or do not install any Debian-originated package versions\n"
  5686. "Explanation: other than those in the distribution codenamed with &testing-codename; or sid\n"
  5687. "Package: *\n"
  5688. "Pin: release n=&testing-codename;\n"
  5689. "Pin-Priority: 900\n"
  5690. "\n"
  5691. "Explanation: Debian unstable is always codenamed with sid\n"
  5692. "Package: *\n"
  5693. "Pin: release n=sid\n"
  5694. "Pin-Priority: 800\n"
  5695. "\n"
  5696. "Package: *\n"
  5697. "Pin: release o=Debian\n"
  5698. "Pin-Priority: -10\n"
  5699. msgstr ""
  5700. #. type: Content of: <refentry><refsect1><refsect2><para>
  5701. #: apt_preferences.5.xml:591
  5702. msgid ""
  5703. "The following APT preferences file will cause APT to assign a priority "
  5704. "higher than the default (500) to all package versions belonging to a "
  5705. "specified codename of a distribution and a prohibitively low priority to "
  5706. "package versions belonging to other <literal>Debian</literal> distributions, "
  5707. "codenames and archives. Note that with this APT preference APT will follow "
  5708. "the migration of a release from the archive <literal>testing</literal> to "
  5709. "<literal>stable</literal> and later <literal>oldstable</literal>. If you "
  5710. "want to follow for example the progress in <literal>testing</literal> "
  5711. "notwithstanding the codename changes you should use the example "
  5712. "configurations above. <placeholder type=\"programlisting\" id=\"0\"/>"
  5713. msgstr ""
  5714. #. type: Content of: <refentry><refsect1><refsect2><para>
  5715. #: apt_preferences.5.xml:620
  5716. msgid ""
  5717. "With a suitable &sources-list; file and the above preferences file, any of "
  5718. "the following commands will cause APT to upgrade to the latest version(s) in "
  5719. "the release codenamed with <literal>&testing-codename;</literal>. "
  5720. "<placeholder type=\"programlisting\" id=\"0\"/>"
  5721. msgstr ""
  5722. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5723. #: apt_preferences.5.xml:640
  5724. #, no-wrap
  5725. msgid "apt-get install <replaceable>package</replaceable>/sid\n"
  5726. msgstr ""
  5727. #. type: Content of: <refentry><refsect1><refsect2><para>
  5728. #: apt_preferences.5.xml:631
  5729. msgid ""
  5730. "The following command will cause APT to upgrade the specified package to the "
  5731. "latest version from the <literal>sid</literal> distribution. Thereafter, "
  5732. "<command>apt-get upgrade</command> will upgrade the package to the most "
  5733. "recent <literal>&testing-codename;</literal> version if that is more recent "
  5734. "than the installed version, otherwise, to the most recent <literal>sid</"
  5735. "literal> version if that is more recent than the installed version. "
  5736. "<placeholder type=\"programlisting\" id=\"0\"/>"
  5737. msgstr ""
  5738. #. type: Content of: <refentry><refsect1><variablelist>
  5739. #: apt_preferences.5.xml:649
  5740. msgid "&file-preferences;"
  5741. msgstr ""
  5742. #. type: Content of: <refentry><refsect1><para>
  5743. #: apt_preferences.5.xml:655
  5744. msgid "&apt-get; &apt-cache; &apt-conf; &sources-list;"
  5745. msgstr ""
  5746. #. type: Content of: <refentry><refnamediv><refname>
  5747. #: sources.list.5.xml:25 sources.list.5.xml:32
  5748. msgid "sources.list"
  5749. msgstr ""
  5750. #. type: Content of: <refentry><refnamediv><refpurpose>
  5751. #: sources.list.5.xml:33
  5752. msgid "Package resource list for APT"
  5753. msgstr ""
  5754. #. type: Content of: <refentry><refsect1><para>
  5755. #: sources.list.5.xml:37
  5756. msgid ""
  5757. "The package resource list is used to locate archives of the package "
  5758. "distribution system in use on the system. At this time, this manual page "
  5759. "documents only the packaging system used by the Debian GNU/Linux system. "
  5760. "This control file is <filename>/etc/apt/sources.list</filename>."
  5761. msgstr ""
  5762. #. type: Content of: <refentry><refsect1><para>
  5763. #: sources.list.5.xml:42
  5764. msgid ""
  5765. "The source list is designed to support any number of active sources and a "
  5766. "variety of source media. The file lists one source per line, with the most "
  5767. "preferred source listed first. The format of each line is: <literal>type uri "
  5768. "args</literal> The first item, <literal>type</literal> determines the format "
  5769. "for <literal>args</literal>. <literal>uri</literal> is a Universal Resource "
  5770. "Identifier (URI), which is a superset of the more specific and well-known "
  5771. "Universal Resource Locator, or URL. The rest of the line can be marked as a "
  5772. "comment by using a #."
  5773. msgstr ""
  5774. #. type: Content of: <refentry><refsect1><title>
  5775. #: sources.list.5.xml:53
  5776. msgid "sources.list.d"
  5777. msgstr ""
  5778. #. type: Content of: <refentry><refsect1><para>
  5779. #: sources.list.5.xml:54
  5780. msgid ""
  5781. "The <filename>/etc/apt/sources.list.d</filename> directory provides a way to "
  5782. "add sources.list entries in separate files. The format is the same as for "
  5783. "the regular <filename>sources.list</filename> file. File names need to end "
  5784. "with <filename>.list</filename> and may only contain letters (a-z and A-Z), "
  5785. "digits (0-9), underscore (_), hyphen (-) and period (.) characters. "
  5786. "Otherwise they will be silently ignored."
  5787. msgstr ""
  5788. #. type: Content of: <refentry><refsect1><title>
  5789. #: sources.list.5.xml:63
  5790. msgid "The deb and deb-src types"
  5791. msgstr ""
  5792. #. type: Content of: <refentry><refsect1><para>
  5793. #: sources.list.5.xml:64
  5794. msgid ""
  5795. "The <literal>deb</literal> type describes a typical two-level Debian "
  5796. "archive, <filename>distribution/component</filename>. Typically, "
  5797. "<literal>distribution</literal> is generally one of <literal>stable</"
  5798. "literal> <literal>unstable</literal> or <literal>testing</literal> while "
  5799. "component is one of <literal>main</literal> <literal>contrib</literal> "
  5800. "<literal>non-free</literal> or <literal>non-us</literal>. The <literal>deb-"
  5801. "src</literal> type describes a debian distribution's source code in the same "
  5802. "form as the <literal>deb</literal> type. A <literal>deb-src</literal> line "
  5803. "is required to fetch source indexes."
  5804. msgstr ""
  5805. #. type: Content of: <refentry><refsect1><para>
  5806. #: sources.list.5.xml:76
  5807. msgid ""
  5808. "The format for a <filename>sources.list</filename> entry using the "
  5809. "<literal>deb</literal> and <literal>deb-src</literal> types is:"
  5810. msgstr ""
  5811. #. type: Content of: <refentry><refsect1><literallayout>
  5812. #: sources.list.5.xml:79
  5813. #, no-wrap
  5814. msgid "deb uri distribution [component1] [component2] [...]"
  5815. msgstr ""
  5816. #. type: Content of: <refentry><refsect1><para>
  5817. #: sources.list.5.xml:81
  5818. msgid ""
  5819. "The URI for the <literal>deb</literal> type must specify the base of the "
  5820. "Debian distribution, from which APT will find the information it needs. "
  5821. "<literal>distribution</literal> can specify an exact path, in which case the "
  5822. "components must be omitted and <literal>distribution</literal> must end with "
  5823. "a slash (/). This is useful for when the case only a particular sub-section "
  5824. "of the archive denoted by the URI is of interest. If <literal>distribution</"
  5825. "literal> does not specify an exact path, at least one <literal>component</"
  5826. "literal> must be present."
  5827. msgstr ""
  5828. #. type: Content of: <refentry><refsect1><para>
  5829. #: sources.list.5.xml:90
  5830. msgid ""
  5831. "<literal>distribution</literal> may also contain a variable, <literal>$(ARCH)"
  5832. "</literal> which expands to the Debian architecture (i386, m68k, "
  5833. "powerpc, ...) used on the system. This permits architecture-independent "
  5834. "<filename>sources.list</filename> files to be used. In general this is only "
  5835. "of interest when specifying an exact path, <literal>APT</literal> will "
  5836. "automatically generate a URI with the current architecture otherwise."
  5837. msgstr ""
  5838. #. type: Content of: <refentry><refsect1><para>
  5839. #: sources.list.5.xml:98
  5840. msgid ""
  5841. "Since only one distribution can be specified per line it may be necessary to "
  5842. "have multiple lines for the same URI, if a subset of all available "
  5843. "distributions or components at that location is desired. APT will sort the "
  5844. "URI list after it has generated a complete set internally, and will collapse "
  5845. "multiple references to the same Internet host, for instance, into a single "
  5846. "connection, so that it does not inefficiently establish an FTP connection, "
  5847. "close it, do something else, and then re-establish a connection to that same "
  5848. "host. This feature is useful for accessing busy FTP sites with limits on the "
  5849. "number of simultaneous anonymous users. APT also parallelizes connections to "
  5850. "different hosts to more effectively deal with sites with low bandwidth."
  5851. msgstr ""
  5852. #. type: Content of: <refentry><refsect1><para>
  5853. #: sources.list.5.xml:110
  5854. msgid ""
  5855. "It is important to list sources in order of preference, with the most "
  5856. "preferred source listed first. Typically this will result in sorting by "
  5857. "speed from fastest to slowest (CD-ROM followed by hosts on a local network, "
  5858. "followed by distant Internet hosts, for example)."
  5859. msgstr ""
  5860. #. type: Content of: <refentry><refsect1><para>
  5861. #: sources.list.5.xml:115
  5862. msgid "Some examples:"
  5863. msgstr ""
  5864. #. type: Content of: <refentry><refsect1><literallayout>
  5865. #: sources.list.5.xml:117
  5866. #, no-wrap
  5867. msgid ""
  5868. "deb http://ftp.debian.org/debian &stable-codename; main contrib non-free\n"
  5869. "deb http://security.debian.org/ &stable-codename;/updates main contrib non-free\n"
  5870. " "
  5871. msgstr ""
  5872. #. type: Content of: <refentry><refsect1><title>
  5873. #: sources.list.5.xml:123
  5874. msgid "URI specification"
  5875. msgstr ""
  5876. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  5877. #: sources.list.5.xml:128
  5878. msgid "file"
  5879. msgstr ""
  5880. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5881. #: sources.list.5.xml:130
  5882. msgid ""
  5883. "The file scheme allows an arbitrary directory in the file system to be "
  5884. "considered an archive. This is useful for NFS mounts and local mirrors or "
  5885. "archives."
  5886. msgstr ""
  5887. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5888. #: sources.list.5.xml:137
  5889. msgid ""
  5890. "The cdrom scheme allows APT to use a local CDROM drive with media swapping. "
  5891. "Use the &apt-cdrom; program to create cdrom entries in the source list."
  5892. msgstr ""
  5893. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5894. #: sources.list.5.xml:144
  5895. msgid ""
  5896. "The http scheme specifies an HTTP server for the archive. If an environment "
  5897. "variable <envar>http_proxy</envar> is set with the format http://server:"
  5898. "port/, the proxy server specified in <envar>http_proxy</envar> will be used. "
  5899. "Users of authenticated HTTP/1.1 proxies may use a string of the format "
  5900. "http://user:pass@server:port/. Note that this is an insecure method of "
  5901. "authentication."
  5902. msgstr ""
  5903. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5904. #: sources.list.5.xml:155
  5905. msgid ""
  5906. "The ftp scheme specifies an FTP server for the archive. APT's FTP behavior "
  5907. "is highly configurable; for more information see the &apt-conf; manual page. "
  5908. "Please note that a ftp proxy can be specified by using the <envar>ftp_proxy</"
  5909. "envar> environment variable. It is possible to specify a http proxy (http "
  5910. "proxy servers often understand ftp urls) using this method and ONLY this "
  5911. "method. ftp proxies using http specified in the configuration file will be "
  5912. "ignored."
  5913. msgstr ""
  5914. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  5915. #: sources.list.5.xml:164
  5916. msgid "copy"
  5917. msgstr ""
  5918. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5919. #: sources.list.5.xml:166
  5920. msgid ""
  5921. "The copy scheme is identical to the file scheme except that packages are "
  5922. "copied into the cache directory instead of used directly at their location. "
  5923. "This is useful for people using a zip disk to copy files around with APT."
  5924. msgstr ""
  5925. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  5926. #: sources.list.5.xml:171
  5927. msgid "rsh"
  5928. msgstr ""
  5929. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  5930. #: sources.list.5.xml:171
  5931. msgid "ssh"
  5932. msgstr ""
  5933. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5934. #: sources.list.5.xml:173
  5935. msgid ""
  5936. "The rsh/ssh method invokes rsh/ssh to connect to a remote host as a given "
  5937. "user and access the files. It is a good idea to do prior arrangements with "
  5938. "RSA keys or rhosts. Access to files on the remote uses standard "
  5939. "<command>find</command> and <command>dd</command> commands to perform the "
  5940. "file transfers from the remote."
  5941. msgstr ""
  5942. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  5943. #: sources.list.5.xml:181
  5944. msgid "more recognizable URI types"
  5945. msgstr ""
  5946. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5947. #: sources.list.5.xml:183
  5948. msgid ""
  5949. "APT can be extended with more methods shipped in other optional packages "
  5950. "which should follow the nameing scheme <literal>apt-transport-"
  5951. "<replaceable>method</replaceable></literal>. The APT team e.g. maintains "
  5952. "also the <literal>apt-transport-https</literal> package which provides "
  5953. "access methods for https-URIs with features similar to the http method, but "
  5954. "other methods for using e.g. debtorrent are also available, see "
  5955. "<citerefentry> <refentrytitle><filename>apt-transport-debtorrent</filename></"
  5956. "refentrytitle> <manvolnum>1</manvolnum></citerefentry>."
  5957. msgstr ""
  5958. #. type: Content of: <refentry><refsect1><para>
  5959. #: sources.list.5.xml:125
  5960. msgid ""
  5961. "The currently recognized URI types are cdrom, file, http, ftp, copy, ssh, "
  5962. "rsh. <placeholder type=\"variablelist\" id=\"0\"/>"
  5963. msgstr ""
  5964. #. type: Content of: <refentry><refsect1><para>
  5965. #: sources.list.5.xml:197
  5966. msgid ""
  5967. "Uses the archive stored locally (or NFS mounted) at /home/jason/debian for "
  5968. "stable/main, stable/contrib, and stable/non-free."
  5969. msgstr ""
  5970. #. type: Content of: <refentry><refsect1><literallayout>
  5971. #: sources.list.5.xml:199
  5972. #, no-wrap
  5973. msgid "deb file:/home/jason/debian stable main contrib non-free"
  5974. msgstr ""
  5975. #. type: Content of: <refentry><refsect1><para>
  5976. #: sources.list.5.xml:201
  5977. msgid "As above, except this uses the unstable (development) distribution."
  5978. msgstr ""
  5979. #. type: Content of: <refentry><refsect1><literallayout>
  5980. #: sources.list.5.xml:202
  5981. #, no-wrap
  5982. msgid "deb file:/home/jason/debian unstable main contrib non-free"
  5983. msgstr ""
  5984. #. type: Content of: <refentry><refsect1><para>
  5985. #: sources.list.5.xml:204
  5986. msgid "Source line for the above"
  5987. msgstr ""
  5988. #. type: Content of: <refentry><refsect1><literallayout>
  5989. #: sources.list.5.xml:205
  5990. #, no-wrap
  5991. msgid "deb-src file:/home/jason/debian unstable main contrib non-free"
  5992. msgstr ""
  5993. #. type: Content of: <refentry><refsect1><para>
  5994. #: sources.list.5.xml:207
  5995. msgid ""
  5996. "Uses HTTP to access the archive at archive.debian.org, and uses only the "
  5997. "hamm/main area."
  5998. msgstr ""
  5999. #. type: Content of: <refentry><refsect1><literallayout>
  6000. #: sources.list.5.xml:209
  6001. #, no-wrap
  6002. msgid "deb http://archive.debian.org/debian-archive hamm main"
  6003. msgstr ""
  6004. #. type: Content of: <refentry><refsect1><para>
  6005. #: sources.list.5.xml:211
  6006. msgid ""
  6007. "Uses FTP to access the archive at ftp.debian.org, under the debian "
  6008. "directory, and uses only the &stable-codename;/contrib area."
  6009. msgstr ""
  6010. #. type: Content of: <refentry><refsect1><literallayout>
  6011. #: sources.list.5.xml:213
  6012. #, no-wrap
  6013. msgid "deb ftp://ftp.debian.org/debian &stable-codename; contrib"
  6014. msgstr ""
  6015. #. type: Content of: <refentry><refsect1><para>
  6016. #: sources.list.5.xml:215
  6017. msgid ""
  6018. "Uses FTP to access the archive at ftp.debian.org, under the debian "
  6019. "directory, and uses only the unstable/contrib area. If this line appears as "
  6020. "well as the one in the previous example in <filename>sources.list</filename> "
  6021. "a single FTP session will be used for both resource lines."
  6022. msgstr ""
  6023. #. type: Content of: <refentry><refsect1><literallayout>
  6024. #: sources.list.5.xml:219
  6025. #, no-wrap
  6026. msgid "deb ftp://ftp.debian.org/debian unstable contrib"
  6027. msgstr ""
  6028. #. type: Content of: <refentry><refsect1><para>
  6029. #: sources.list.5.xml:221
  6030. msgid ""
  6031. "Uses HTTP to access the archive at nonus.debian.org, under the debian-non-US "
  6032. "directory."
  6033. msgstr ""
  6034. #. type: Content of: <refentry><refsect1><literallayout>
  6035. #: sources.list.5.xml:223
  6036. #, no-wrap
  6037. msgid "deb http://nonus.debian.org/debian-non-US stable/non-US main contrib non-free"
  6038. msgstr ""
  6039. #. type: Content of: <refentry><refsect1><para><literallayout>
  6040. #: sources.list.5.xml:232
  6041. #, no-wrap
  6042. msgid "deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/"
  6043. msgstr ""
  6044. #. type: Content of: <refentry><refsect1><para>
  6045. #: sources.list.5.xml:225
  6046. msgid ""
  6047. "Uses HTTP to access the archive at nonus.debian.org, under the debian-non-US "
  6048. "directory, and uses only files found under <filename>unstable/binary-i386</"
  6049. "filename> on i386 machines, <filename>unstable/binary-m68k</filename> on "
  6050. "m68k, and so forth for other supported architectures. [Note this example "
  6051. "only illustrates how to use the substitution variable; non-us is no longer "
  6052. "structured like this] <placeholder type=\"literallayout\" id=\"0\"/>"
  6053. msgstr ""
  6054. #. type: Content of: <refentry><refsect1><para>
  6055. #: sources.list.5.xml:237
  6056. msgid "&apt-cache; &apt-conf;"
  6057. msgstr ""
  6058. #. type: <title></title>
  6059. #: guide.sgml:4
  6060. #, fuzzy
  6061. msgid "APT User's Guide"
  6062. msgstr "Guida dell'utente di APT"
  6063. #. type: <author></author>
  6064. #: guide.sgml:6 offline.sgml:6
  6065. #, fuzzy
  6066. msgid "<name>Jason Gunthorpe </name><email>jgg@debian.org</email>"
  6067. msgstr "<name>Jason Gunthorpe </name><email>jgg@debian.org</email>"
  6068. #. type: <version></version>
  6069. #: guide.sgml:7
  6070. #, fuzzy
  6071. msgid "$Id: guide.sgml,v 1.7 2003/04/26 23:26:13 doogie Exp $"
  6072. msgstr "$Id: guide.it.sgml,v 1.5 2003/04/26 23:26:13 doogie Exp $"
  6073. #. type: <abstract></abstract>
  6074. #: guide.sgml:11
  6075. #, fuzzy
  6076. msgid ""
  6077. "This document provides an overview of how to use the the APT package manager."
  6078. msgstr "Guida per l'uso del gestore di pacchetti APT."
  6079. #. type: <copyrightsummary></copyrightsummary>
  6080. #: guide.sgml:15
  6081. #, fuzzy
  6082. msgid "Copyright &copy; Jason Gunthorpe, 1998."
  6083. msgstr "Copyright &copy; Jason Gunthorpe, 1998."
  6084. #. type: <p></p>
  6085. #: guide.sgml:21 offline.sgml:22
  6086. #, fuzzy
  6087. msgid ""
  6088. "\"APT\" and this document are free software; you can redistribute them and/"
  6089. "or modify them under the terms of the GNU General Public License as "
  6090. "published by the Free Software Foundation; either version 2 of the License, "
  6091. "or (at your option) any later version."
  6092. msgstr ""
  6093. "\"APT\" e questo documento sono software libero, e li si può ridistribuire e/"
  6094. "o modificare secondo i termini della Licenza Pubblica Generica GNU (GPL), "
  6095. "pubblicata dalla Free Software Foundation, nella versione 2 o (se preferite) "
  6096. "qualsiasi versione successiva."
  6097. #. type: <p></p>
  6098. #: guide.sgml:24 offline.sgml:25
  6099. #, fuzzy
  6100. msgid ""
  6101. "For more details, on Debian GNU/Linux systems, see the file /usr/share/"
  6102. "common-licenses/GPL for the full license."
  6103. msgstr ""
  6104. "Per ulteriori dettagli sui sistemi GNU/Linux si veda il testo completo della "
  6105. "licenza nel file /usr/share/common-licenses/GPL."
  6106. #. type: <heading></heading>
  6107. #: guide.sgml:32
  6108. #, fuzzy
  6109. msgid "General"
  6110. msgstr "Descrizione generale"
  6111. #. type: <p></p>
  6112. #: guide.sgml:38
  6113. #, fuzzy
  6114. msgid ""
  6115. "The APT package currently contains two sections, the APT <prgn>dselect</"
  6116. "prgn> method and the <prgn>apt-get</prgn> command line user interface. Both "
  6117. "provide a way to install and remove packages as well as download new "
  6118. "packages from the Internet."
  6119. msgstr ""
  6120. "Il pacchetto APT al momento contiene due sezioni, il metodo APT "
  6121. "<prgn>dselect</prgn> e l'interfaccia utente a linea di comando <prgn>apt-"
  6122. "get</prgn>; entrambi danno modo di installare e rimuovere pacchetti, e di "
  6123. "scaricarne altri da Internet."
  6124. #. type: <heading></heading>
  6125. #: guide.sgml:39
  6126. #, fuzzy
  6127. msgid "Anatomy of the Package System"
  6128. msgstr "Anatomia del sistema di pacchettizzazione"
  6129. #. type: <p></p>
  6130. #: guide.sgml:44
  6131. #, fuzzy
  6132. msgid ""
  6133. "The Debian packaging system has a large amount of information associated "
  6134. "with each package to help assure that it integrates cleanly and easily into "
  6135. "the system. The most prominent of its features is the dependency system."
  6136. msgstr ""
  6137. "Il sistema di pacchettizzazione di Debian contiene un gran numero di "
  6138. "informazioni associate a ciascun pacchetto, per assicurarsi che si integri "
  6139. "facilmente ed in maniera pulita nel sistema; la più importante di esse è il "
  6140. "sistema di dipendenze."
  6141. #. type: <p></p>
  6142. #: guide.sgml:52
  6143. #, fuzzy
  6144. msgid ""
  6145. "The dependency system allows individual programs to make use of shared "
  6146. "elements in the system such as libraries. It simplifies placing infrequently "
  6147. "used portions of a program in separate packages to reduce the number of "
  6148. "things the average user is required to install. Also, it allows for choices "
  6149. "in mail transport agents, X servers and so on."
  6150. msgstr ""
  6151. "Il sistema di dipendenze permette ai singoli programmi di fare uso degli "
  6152. "elementi condivisi del sistema, quali le librerie; per ridurre il numero di "
  6153. "elementi che l'utente medio debba installare, le porzioni di programmi che "
  6154. "non vengono usate spesso vengono poste in pacchetti separati. Inoltre, è "
  6155. "possibile avere più di una scelta per cose quali i programmi di posta "
  6156. "elettronica, i server X e così via."
  6157. #. type: <p></p>
  6158. #: guide.sgml:57
  6159. #, fuzzy
  6160. msgid ""
  6161. "The first step to understanding the dependency system is to grasp the "
  6162. "concept of a simple dependency. The meaning of a simple dependency is that a "
  6163. "package requires another package to be installed at the same time to work "
  6164. "properly."
  6165. msgstr ""
  6166. "Il primo passo per capire il sistema di dipendenze è la comprensione del "
  6167. "concetto di dipendenza semplice: un pacchetto richiede che un altro sia "
  6168. "installato insieme ad esso per poter funzionare."
  6169. #. type: <p></p>
  6170. #: guide.sgml:63
  6171. #, fuzzy
  6172. msgid ""
  6173. "For instance, mailcrypt is an emacs extension that aids in encrypting email "
  6174. "with GPG. Without GPGP installed mailcrypt is useless, so mailcrypt has a "
  6175. "simple dependency on GPG. Also, because it is an emacs extension it has a "
  6176. "simple dependency on emacs, without emacs it is completely useless."
  6177. msgstr ""
  6178. "Ad esempio, mail-crypt è un'estensione di emacs che aiuta a criptare le mail "
  6179. "con PGP. Se PGP non è installato, mail-crypt è inutile, quindi mail-crypt ha "
  6180. "una dipendenza semplice da PGP. Inoltre, dato che si tratta di un'estensione "
  6181. "di emacs, mail-crypt dipende anche da emacs, senza il quale è totalmente "
  6182. "inutile."
  6183. #. type: <p></p>
  6184. #: guide.sgml:73
  6185. #, fuzzy
  6186. msgid ""
  6187. "The other important dependency to understand is a conflicting dependency. It "
  6188. "means that a package, when installed with another package, will not work and "
  6189. "may possibly be extremely harmful to the system. As an example consider a "
  6190. "mail transport agent such as sendmail, exim or qmail. It is not possible to "
  6191. "have two mail transport agents installed because both need to listen to the "
  6192. "network to receive mail. Attempting to install two will seriously damage the "
  6193. "system so all mail transport agents have a conflicting dependency with all "
  6194. "other mail transport agents."
  6195. msgstr ""
  6196. "L'altro tipo di dipendenza importante da capire è la dipendenza di "
  6197. "conflitto; con questa, un pacchetto che venga installato insieme ad un altro "
  6198. "pacchetto non funziona, e si hanno seri problemi al sistema. Come esempio, "
  6199. "si consideri un programma di trasporto della posta, quale sendmail, exim o "
  6200. "qmail: non è possibile averne due contemporaneamente, perché entrambi hanno "
  6201. "bisogno di restare in ascolto sulla stessa porta di rete per ricevere la "
  6202. "posta. Tentare di installarne due danneggerebbe seriamente il sistema, "
  6203. "quindi ciascun programma di trasporto della posta ha una dipendenza di "
  6204. "conflitto con tutti gli altri."
  6205. #. type: <p></p>
  6206. #: guide.sgml:83
  6207. #, fuzzy
  6208. msgid ""
  6209. "As an added complication there is the possibility for a package to pretend "
  6210. "to be another package. Consider that exim and sendmail for many intents are "
  6211. "identical, they both deliver mail and understand a common interface. Hence, "
  6212. "the package system has a way for them to declare that they are both mail-"
  6213. "transport-agents. So, exim and sendmail both declare that they provide a "
  6214. "mail-transport-agent and other packages that need a mail transport agent "
  6215. "depend on mail-transport-agent. This can add a great deal of confusion when "
  6216. "trying to manually fix packages."
  6217. msgstr ""
  6218. "Come ulteriore complicazione, c'è la possibilità che un pacchetto voglia "
  6219. "prendere il posto di un altro; ad esempio, exim e sendmail per molte cose "
  6220. "sono identici, dato che entrambi gestiscono la posta e comprendono "
  6221. "un'interfaccia comune, quindi il sistema di pacchettizzazione deve "
  6222. "dichiarare che sono entrambi agenti di trasporto della posta, e che gli "
  6223. "altri pacchetti a cui serve uno dei due devono dipendere da un pacchetto "
  6224. "fittizio agente-di-trasporto-della-posta. Quando si modificano a mano i "
  6225. "pacchetti, questo può portare a moltissima confusione."
  6226. #. type: <p></p>
  6227. #: guide.sgml:88
  6228. #, fuzzy
  6229. msgid ""
  6230. "At any given time a single dependency may be met by packages that are "
  6231. "already installed or it may not be. APT attempts to help resolve dependency "
  6232. "issues by providing a number of automatic algorithms that help in selecting "
  6233. "packages for installation."
  6234. msgstr ""
  6235. "In ciascun momento una singola dipendenza può essere soddisfatta o meno dai "
  6236. "pacchetti già installati; APT cerca di risolvere i problemi di dipendenze "
  6237. "con un buon numero di algoritmi automatici, che aiutano a selezionare i "
  6238. "pacchetti da installare."
  6239. #. type: <p></p>
  6240. #: guide.sgml:102
  6241. #, fuzzy
  6242. msgid ""
  6243. "<prgn>apt-get</prgn> provides a simple way to install packages from the "
  6244. "command line. Unlike <prgn>dpkg</prgn>, <prgn>apt-get</prgn> does not "
  6245. "understand .deb files, it works with the package's proper name and can only "
  6246. "install .deb archives from a <em>Source</em>."
  6247. msgstr ""
  6248. "<prgn>apt-get</prgn> fornisce un modo semplice di installare i pacchetti "
  6249. "dalla linea di comando. Diversamente da <prgn>dpkg</prgn>, <prgn>apt-get</"
  6250. "prgn> non capisce i nomi dei file .deb, ma utilizza il vero nome dei "
  6251. "pacchetti, e può installare archivi .deb solo da una fonte."
  6252. #. type: <p></p>
  6253. #: guide.sgml:109
  6254. #, fuzzy
  6255. msgid ""
  6256. "The first <footnote><p>If you are using an http proxy server you must set "
  6257. "the http_proxy environment variable first, see sources.list(5)</p></"
  6258. "footnote> thing that should be done before using <prgn>apt-get</prgn> is to "
  6259. "fetch the package lists from the <em>Sources</em> so that it knows what "
  6260. "packages are available. This is done with <tt>apt-get update</tt>. For "
  6261. "instance,"
  6262. msgstr ""
  6263. "La prima <footnote><p>Se state usando un proxy server http, dovete prima "
  6264. "ancora impostare la variabile d'ambiente http_proxy; vedere sources.list(5)."
  6265. "</p></footnote> cosa da fare prima di usare <prgn>apt-get</prgn> è impostare "
  6266. "l'elenco dei pacchetti dalle fonti in modo che il programma sappia quali "
  6267. "pacchetti sono disponibili. Lo si fa con <tt>apt-get update</tt>. Ad esempio,"
  6268. #. type: <example></example>
  6269. #: guide.sgml:116
  6270. #, fuzzy, no-wrap
  6271. msgid ""
  6272. "# apt-get update\n"
  6273. "Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages\n"
  6274. "Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n"
  6275. "Reading Package Lists... Done\n"
  6276. "Building Dependency Tree... Done"
  6277. msgstr ""
  6278. "# apt-get update\n"
  6279. "Get http://ftp.de.debian.org/debian-non-US/ stable/binary-i386/ Packages\n"
  6280. "Get http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n"
  6281. "Reading Package Lists... Done\n"
  6282. "Building Dependency Tree... Done"
  6283. #. type: <p><taglist>
  6284. #: guide.sgml:120
  6285. #, fuzzy
  6286. msgid "Once updated there are several commands that can be used:"
  6287. msgstr "Dopo aver aggiornato l'elenco si possono usare molti comandi:"
  6288. #. type: <p></p>
  6289. #: guide.sgml:131
  6290. #, fuzzy
  6291. msgid ""
  6292. "Upgrade will attempt to gently upgrade the whole system. Upgrade will never "
  6293. "install a new package or remove an existing package, nor will it ever "
  6294. "upgrade a package that might cause some other package to break. This can be "
  6295. "used daily to relatively safely upgrade the system. Upgrade will list all of "
  6296. "the packages that it could not upgrade, this usually means that they depend "
  6297. "on new packages or conflict with some other package. <prgn>dselect</prgn> or "
  6298. "<tt>apt-get install</tt> can be used to force these packages to install."
  6299. msgstr ""
  6300. "Upgrade tenterà di fare un aggiornamento indolore del sistema completo, "
  6301. "senza installare nuovi pacchetti o rimuoverne di esistenti, e senza "
  6302. "aggiornare un pacchetto che possa rovinarne altri. Upgrade farà un elenco di "
  6303. "tutti i pacchetti che non avrà potuto aggiornare, cosa che in genere "
  6304. "significa che questi dipendono da nuovi pacchetti o vanno in conflitto con "
  6305. "altri. Per forzare la loro installazione si può usare <prgn>dselect</prgn> o "
  6306. "<tt>apt-get install</tt>."
  6307. #. type: <p></p>
  6308. #: guide.sgml:140
  6309. #, fuzzy
  6310. msgid ""
  6311. "Install is used to install packages by name. The package is automatically "
  6312. "fetched and installed. This can be useful if you already know the name of "
  6313. "the package to install and do not want to go into a GUI to select it. Any "
  6314. "number of packages may be passed to install, they will all be fetched. "
  6315. "Install automatically attempts to resolve dependency problems with the "
  6316. "listed packages and will print a summary and ask for confirmation if "
  6317. "anything other than its arguments are changed."
  6318. msgstr ""
  6319. "Install viene usato per installare i singoli pacchetti dando il loro nome. "
  6320. "Il pacchetto viene automaticamente scaricato ed installato, cosa molto utile "
  6321. "se già se ne conosce il nome e non si vuole entrare in grafica per "
  6322. "selezionarlo. Al comando si possono passare anche più pacchetti, che saranno "
  6323. "tutti scaricati. L'installazione automatica cerca di risolvere i problemi di "
  6324. "dipendenze con gli altri pacchetti elencati, stampa un riassunto e chiede "
  6325. "conferma se si devono modificare altri pacchetti che non siano quelli sulla "
  6326. "linea di comando."
  6327. #. type: <p></p>
  6328. #: guide.sgml:149
  6329. #, fuzzy
  6330. msgid ""
  6331. "Dist-upgrade is a complete upgrader designed to simplify upgrading between "
  6332. "releases of Debian. It uses a sophisticated algorithm to determine the best "
  6333. "set of packages to install, upgrade and remove to get as much of the system "
  6334. "to the newest release. In some situations it may be desired to use dist-"
  6335. "upgrade rather than spend the time manually resolving dependencies in "
  6336. "<prgn>dselect</prgn>. Once dist-upgrade has completed then <prgn>dselect</"
  6337. "prgn> can be used to install any packages that may have been left out."
  6338. msgstr ""
  6339. "Dist-upgrade fa un aggiornamento completo, progettato in modo da rendere "
  6340. "semplici gli aggiornamenti tra versioni di Debian. Usa un algoritmo "
  6341. "sofisticato per determinare il miglior insieme di pacchetti da installare, "
  6342. "aggiornare e rimuovere per arrivare alla versione più aggiornata del sistema "
  6343. "possibile. In alcune situazioni può essere vantaggioso usare dist-upgrade "
  6344. "invece che sprecare tempo a risolvere manualmente le dipendenze con "
  6345. "<prgn>dselect</prgn>. Una volta completato dist-upgrade, si può usare "
  6346. "<prgn>dselect</prgn> per installare eventuali pacchetti che sono stati "
  6347. "tralasciati."
  6348. #. type: <p></p>
  6349. #: guide.sgml:152
  6350. #, fuzzy
  6351. msgid ""
  6352. "It is important to closely look at what dist-upgrade is going to do, its "
  6353. "decisions may sometimes be quite surprising."
  6354. msgstr ""
  6355. "È importante controllare attentamente cosa intende fare dist-upgrade, dato "
  6356. "che le sue decisioni a volte possono essere abbastanza sorprendenti."
  6357. #. type: <p></p>
  6358. #: guide.sgml:163
  6359. #, fuzzy
  6360. msgid ""
  6361. "<prgn>apt-get</prgn> has several command line options that are detailed in "
  6362. "its man page, <manref section=\"8\" name=\"apt-get\">. The most useful "
  6363. "option is <tt>-d</tt> which does not install the fetched files. If the "
  6364. "system has to download a large number of package it would be undesired to "
  6365. "start installing them in case something goes wrong. When <tt>-d</tt> is used "
  6366. "the downloaded archives can be installed by simply running the command that "
  6367. "caused them to be downloaded again without <tt>-d</tt>."
  6368. msgstr ""
  6369. "<prgn>apt-get</prgn> ha diverse opzioni a linea di comando, che vengono "
  6370. "documentate dettagliatamente nella sua pagina man, <manref section=\"8\" "
  6371. "name=\"apt-get\">. L'opzione più utile è <tt>-d</tt>, che non installa i "
  6372. "file scaricati: se il sistema deve scaricare un gran numero di pacchetti, "
  6373. "non è bene farglieli installare subito, in caso dovesse andare male "
  6374. "qualcosa. Dopo aver usato <tt>-d</tt>, gli archivi scaricati possono essere "
  6375. "installati semplicemente dando di nuovo lo stesso comando senza l'opzione "
  6376. "<tt>-d</tt>."
  6377. #. type: <heading></heading>
  6378. #: guide.sgml:168
  6379. #, fuzzy
  6380. msgid "DSelect"
  6381. msgstr "DSelect"
  6382. #. type: <p></p>
  6383. #: guide.sgml:173
  6384. #, fuzzy
  6385. msgid ""
  6386. "The APT <prgn>dselect</prgn> method provides the complete APT system with "
  6387. "the <prgn>dselect</prgn> package selection GUI. <prgn>dselect</prgn> is used "
  6388. "to select the packages to be installed or removed and APT actually installs "
  6389. "them."
  6390. msgstr ""
  6391. "Il metodo APT di <prgn>dselect</prgn> fornisce tutte le funzionalità di APT "
  6392. "all'interno dell'interfaccia grafica di selezione dei pacchetti "
  6393. "<prgn>dselect</prgn>. <prgn>dselect</prgn> viene usato per selezionare i "
  6394. "pacchetti da installare o rimuovere, ed APT li installa."
  6395. #. type: <p></p>
  6396. #: guide.sgml:184
  6397. #, fuzzy
  6398. msgid ""
  6399. "To enable the APT method you need to select [A]ccess in <prgn>dselect</prgn> "
  6400. "and then choose the APT method. You will be prompted for a set of "
  6401. "<em>Sources</em> which are places to fetch archives from. These can be "
  6402. "remote Internet sites, local Debian mirrors or CDROMs. Each source can "
  6403. "provide a fragment of the total Debian archive, APT will automatically "
  6404. "combine them to form a complete set of packages. If you have a CDROM then it "
  6405. "is a good idea to specify it first and then specify a mirror so that you "
  6406. "have access to the latest bug fixes. APT will automatically use packages on "
  6407. "your CDROM before downloading from the Internet."
  6408. msgstr ""
  6409. "Per abilitare il metodo APT dovete selezionare [A]ccess in <prgn>dselect</"
  6410. "prgn> e scegliere il metodo APT; vi verrà chiesto un insieme di fonti "
  6411. "(<em>Sources</em>), cioè di posti da cui scaricare gli archivi. Tali fonti "
  6412. "possono essere siti Internet remoti, mirror locali di Debian o CDROM; "
  6413. "ciascuna di esse può fornire una parte dell'archivio Debian, ed APT le "
  6414. "combinerà insieme in un set completo di pacchetti. Se avete un CDROM è una "
  6415. "buona idea indicare quello per primo, e poi i mirror, in modo da avere "
  6416. "accesso alle ultime versioni; APT userà in questo modo automaticamente i "
  6417. "pacchetti sul CDROM prima di scaricarli da Internet."
  6418. #. type: <example></example>
  6419. #: guide.sgml:198
  6420. #, fuzzy, no-wrap
  6421. msgid ""
  6422. " Set up a list of distribution source locations\n"
  6423. "\t \n"
  6424. " Please give the base URL of the debian distribution.\n"
  6425. " The access schemes I know about are: http file\n"
  6426. "\t \n"
  6427. " For example:\n"
  6428. " file:/mnt/debian,\n"
  6429. " ftp://ftp.debian.org/debian,\n"
  6430. " http://ftp.de.debian.org/debian,\n"
  6431. " \n"
  6432. " \n"
  6433. " URL [http://llug.sep.bnl.gov/debian]:"
  6434. msgstr ""
  6435. " Set up a list of distribution source locations\n"
  6436. "\t \n"
  6437. " Please give the base URL of the debian distribution.\n"
  6438. " The access schemes I know about are: http file\n"
  6439. "\t \n"
  6440. " For example:\n"
  6441. " file:/mnt/debian,\n"
  6442. " ftp://ftp.debian.org/debian,\n"
  6443. " http://ftp.de.debian.org/debian,\n"
  6444. " \n"
  6445. " \n"
  6446. " URL [http://llug.sep.bnl.gov/debian]:"
  6447. #. type: <p></p>
  6448. #: guide.sgml:205
  6449. #, fuzzy
  6450. msgid ""
  6451. "The <em>Sources</em> setup starts by asking for the base of the Debian "
  6452. "archive, defaulting to a HTTP mirror. Next it asks for the distribution to "
  6453. "get."
  6454. msgstr ""
  6455. "La configurazione delle fonti inizia chiedendo la base dell'archivio Debian, "
  6456. "propone come default un mirror HTTP, e poi chiede la distribuzione da "
  6457. "scaricare."
  6458. #. type: <example></example>
  6459. #: guide.sgml:212
  6460. #, fuzzy, no-wrap
  6461. msgid ""
  6462. " Please give the distribution tag to get or a path to the\n"
  6463. " package file ending in a /. The distribution\n"
  6464. " tags are typically something like: stable unstable testing non-US\n"
  6465. " \n"
  6466. " Distribution [stable]:"
  6467. msgstr ""
  6468. " Please give the distribution tag to get or a path to the\n"
  6469. " package file ending in a /. The distribution\n"
  6470. " tags are typically something like: stable unstable testing non-US\n"
  6471. " \n"
  6472. " Distribution [stable]:"
  6473. #. type: <p></p>
  6474. #: guide.sgml:222
  6475. #, fuzzy
  6476. msgid ""
  6477. "The distribution refers to the Debian version in the archive, <em>stable</"
  6478. "em> refers to the latest released version and <em>unstable</em> refers to "
  6479. "the developmental version. <em>non-US</em> is only available on some mirrors "
  6480. "and refers to packages that contain encryption technology or other things "
  6481. "that cannot be exported from the United States. Importing these packages "
  6482. "into the US is legal however."
  6483. msgstr ""
  6484. "La distribuzione (``distribution'') fa riferimento alla versione Debian "
  6485. "dell'archivio: <em>stable</em> è l'ultima rilasciata, ed <em>unstable</em> è "
  6486. "quella di sviluppo. <em>non-US</em> è disponibile solo su alcuni mirror, e "
  6487. "contiene dei pacchetti in cui viene usata della tecnologia di criptazione o "
  6488. "altre cose che non possano essere esportate dagli Stati Uniti; importare "
  6489. "questi pacchetti negli US è però legale."
  6490. #. type: <example></example>
  6491. #: guide.sgml:228
  6492. #, fuzzy, no-wrap
  6493. msgid ""
  6494. " Please give the components to get\n"
  6495. " The components are typically something like: main contrib non-free\n"
  6496. " \n"
  6497. " Components [main contrib non-free]:"
  6498. msgstr ""
  6499. " Please give the components to get\n"
  6500. " The components are typically something like: main contrib non-free\n"
  6501. " \n"
  6502. " Components [main contrib non-free]:"
  6503. #. type: <p></p>
  6504. #: guide.sgml:236
  6505. #, fuzzy
  6506. msgid ""
  6507. "The components list refers to the list of sub distributions to fetch. The "
  6508. "distribution is split up based on software licenses, main being DFSG free "
  6509. "packages while contrib and non-free contain things that have various "
  6510. "restrictions placed on their use and distribution."
  6511. msgstr ""
  6512. "L'elenco dei componenti (``components'') si riferisce alla lista di sotto-"
  6513. "distribuzioni da scaricare. Ciascuna distribuzione viene divisa in base al "
  6514. "copyright del software: la main contiene pacchetti la cui licenza soddisfa "
  6515. "le DFSG, mentre contrib e non-free contengono software che ha diverse "
  6516. "restrizioni sull'uso e sulla distribuzione."
  6517. #. type: <p></p>
  6518. #: guide.sgml:240
  6519. #, fuzzy
  6520. msgid ""
  6521. "Any number of sources can be added, the setup script will continue to prompt "
  6522. "until you have specified all that you want."
  6523. msgstr ""
  6524. "Si possono inserire un qualsiasi numero di fonti, e lo script di "
  6525. "configurazione continuerà a chiedere fino a che abbiate specificato tutti "
  6526. "gli elementi che volete."
  6527. #. type: <p></p>
  6528. #: guide.sgml:247
  6529. #, fuzzy
  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 update</"
  6535. "tt> has been run before."
  6536. msgstr ""
  6537. "Prima di cominciare ad usare <prgn>dselect</prgn> è necessario aggiornare "
  6538. "l'elenco dei pacchetti disponibili selezionando [U]pdate dal menù: si tratta "
  6539. "di un sovrainsieme di ciò che fa <tt>apt-get update</tt>, che rende "
  6540. "l'informazione scaricata disponibile a <prgn>dselect</prgn>. [U]pdate deve "
  6541. "essere fatto anche se prima è stato dato <tt>apt-get update</tt>."
  6542. #. type: <p></p>
  6543. #: guide.sgml:253
  6544. #, fuzzy
  6545. msgid ""
  6546. "You can then go on and make your selections using [S]elect and then perform "
  6547. "the installation using [I]nstall. When using the APT method the [C]onfig and "
  6548. "[R]emove commands have no meaning, the [I]nstall command performs both of "
  6549. "them together."
  6550. msgstr ""
  6551. "Si può a questo punto continuare selezionando i pacchetti desiderati usando "
  6552. "[S]elect e poi installando con [I]nstall. Se si usa il metodo APT, i comandi "
  6553. "[C]onfig e [R]emove non hanno significato, dato che entrambe le fasi sono "
  6554. "contenute in [I]nstall."
  6555. #. type: <p></p>
  6556. #: guide.sgml:258
  6557. #, fuzzy
  6558. msgid ""
  6559. "By default APT will automatically remove the package (.deb) files once they "
  6560. "have been successfully installed. To change this behavior place <tt>Dselect::"
  6561. "clean \"prompt\";</tt> in /etc/apt/apt.conf."
  6562. msgstr ""
  6563. "Per default APT rimuoverà automaticamente i pacchetti che sono stati "
  6564. "installati con successo. Per modificare questo comportamento, si inserisca "
  6565. "<tt>Dselect::clean \"prompt\";</tt> in /etc/apt/apt.conf."
  6566. #. type: <heading></heading>
  6567. #: guide.sgml:264
  6568. #, fuzzy
  6569. msgid "The Interface"
  6570. msgstr "L'interfaccia"
  6571. #. type: <p></p>
  6572. #: guide.sgml:278
  6573. #, fuzzy
  6574. msgid ""
  6575. "Both that APT <prgn>dselect</prgn> method and <prgn>apt-get</prgn> share the "
  6576. "same interface. It is a simple system that generally tells you what it will "
  6577. "do and then goes and does it. <footnote><p>The <prgn>dselect</prgn> method "
  6578. "actually is a set of wrapper scripts to <prgn>apt-get</prgn>. The method "
  6579. "actually provides more functionality than is present in <prgn>apt-get</prgn> "
  6580. "alone.</p></footnote> After printing out a summary of what will happen APT "
  6581. "then will print out some informative status messages so that you can "
  6582. "estimate how far along it is and how much is left to do."
  6583. msgstr ""
  6584. "Entrambi i metodi, <prgn>dselect</prgn> APT ed <prgn>apt-get</prgn>, "
  6585. "condividono la stessa interfaccia; si tratta di un sistema semplice che "
  6586. "indica in genere cosa sta per fare, e poi lo fa. <footnote><p>Il metodo "
  6587. "<prgn>dselect</prgn> è in realtà un insieme di script di wrapper ad "
  6588. "<prgn>apt-get</prgn>. Il metodo fornisce delle funzionalità maggiori del "
  6589. "solo <prgn>apt-get</prgn>.</p></footnote> Dopo la stampa di un riassunto "
  6590. "delle operazioni che saranno fatte, APT stampa dei messaggi informativi "
  6591. "sullo stato del sistema, in modo che possiate avere davanti agli occhi a "
  6592. "quale punto dell'operazione si trova, e quanto ancora si deve aspettare."
  6593. #. type: <heading></heading>
  6594. #: guide.sgml:280
  6595. #, fuzzy
  6596. msgid "Startup"
  6597. msgstr "Avvio"
  6598. #. type: <p></p>
  6599. #: guide.sgml:284
  6600. #, fuzzy
  6601. msgid ""
  6602. "Before all operations except update, APT performs a number of actions to "
  6603. "prepare its internal state. It also does some checks of the system's state. "
  6604. "At any time these operations can be performed by running <tt>apt-get check</"
  6605. "tt>."
  6606. msgstr ""
  6607. "Prima di ciascuna operazione, eccetto l'aggiornamento della lista, APT "
  6608. "compie alcune operazioni per prepararsi, oltre a dei controlli dello stato "
  6609. "del sistema. In qualsiasi momento le stesse operazioni possono essere fatte "
  6610. "con <tt>apt-get check</tt>"
  6611. #. type: <example></example>
  6612. #: guide.sgml:289
  6613. #, fuzzy, no-wrap
  6614. msgid ""
  6615. "# apt-get check\n"
  6616. "Reading Package Lists... Done\n"
  6617. "Building Dependency Tree... Done"
  6618. msgstr ""
  6619. "# apt-get check\n"
  6620. "Reading Package Lists... Done\n"
  6621. "Building Dependancy Tree... Done"
  6622. #. type: <p></p>
  6623. #: guide.sgml:297
  6624. #, fuzzy
  6625. msgid ""
  6626. "The first thing it does is read all the package files into memory. APT uses "
  6627. "a caching scheme so this operation will be faster the second time it is run. "
  6628. "If some of the package files are not found then they will be ignored and a "
  6629. "warning will be printed when apt-get exits."
  6630. msgstr ""
  6631. "La prima cosa che fa è leggere tutti i file dei pacchetti in memoria, usando "
  6632. "uno schema di caching in modo da rendere la stessa operazione più veloce la "
  6633. "seconda volta che la si fa. Se alcuni dei file dei pacchetti non vengono "
  6634. "trovati, sono ignorati e viene stampato un avvertimento all'uscita di apt-"
  6635. "get."
  6636. #. type: <p></p>
  6637. #: guide.sgml:303
  6638. #, fuzzy
  6639. msgid ""
  6640. "The final operation performs a detailed analysis of the system's "
  6641. "dependencies. It checks every dependency of every installed or unpacked "
  6642. "package and considers if it is OK. Should this find a problem then a report "
  6643. "will be printed out and <prgn>apt-get</prgn> will refuse to run."
  6644. msgstr ""
  6645. "L'operazione finale consiste in un'analisi dettagliata delle dipendenze del "
  6646. "sistema: viene controllato che tutte le dipendenze dei singoli pacchetti "
  6647. "installati o non scompattati siano soddisfatte. Se vengono individuati dei "
  6648. "problemi, viene stampato un resoconto, ed <prgn>apt-get</prgn> esce senza "
  6649. "eseguire alcuna operazione."
  6650. #. type: <example></example>
  6651. #: guide.sgml:320
  6652. #, fuzzy, no-wrap
  6653. msgid ""
  6654. "# apt-get check\n"
  6655. "Reading Package Lists... Done\n"
  6656. "Building Dependency Tree... Done\n"
  6657. "You might want to run apt-get -f install' to correct these.\n"
  6658. "Sorry, but the following packages have unmet dependencies:\n"
  6659. " 9fonts: Depends: xlib6g but it is not installed\n"
  6660. " uucp: Depends: mailx but it is not installed\n"
  6661. " blast: Depends: xlib6g (>= 3.3-5) but it is not installed\n"
  6662. " adduser: Depends: perl-base but it is not installed\n"
  6663. " aumix: Depends: libgpmg1 but it is not installed\n"
  6664. " debiandoc-sgml: Depends: sgml-base but it is not installed\n"
  6665. " bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed\n"
  6666. " cthugha: Depends: svgalibg1 but it is not installed\n"
  6667. " Depends: xlib6g (>= 3.3-5) but it is not installed\n"
  6668. " libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1)"
  6669. msgstr ""
  6670. "# apt-get check\n"
  6671. "Reading Package Lists... Done\n"
  6672. "Building Dependancy Tree... Done\n"
  6673. "You might want to run apt-get -f install' to correct these.\n"
  6674. "Sorry, but the following packages have unmet dependencies:\n"
  6675. " 9fonts: Depends: xlib6g but it is not installed\n"
  6676. " uucp: Depends: mailx but it is not installed\n"
  6677. " blast: Depends: xlib6g (>= 3.3-5) but it is not installed\n"
  6678. " adduser: Depends: perl-base but it is not installed\n"
  6679. " aumix: Depends: libgpmg1 but it is not installed\n"
  6680. " debiandoc-sgml: Depends: sgml-base but it is not installed\n"
  6681. " bash-builtins: Depends: bash (>= 2.01) but 2.0-3 is installed\n"
  6682. " cthugha: Depends: svgalibg1 but it is not installed\n"
  6683. " Depends: xlib6g (>= 3.3-5) but it is not installed\n"
  6684. " libreadlineg2: Conflicts:libreadline2 (<< 2.1-2.1)"
  6685. #. type: <p></p>
  6686. #: guide.sgml:329
  6687. #, fuzzy
  6688. msgid ""
  6689. "In this example the system has many problems, including a serious problem "
  6690. "with libreadlineg2. For each package that has unmet dependencies a line is "
  6691. "printed out indicating the package with the problem and the dependencies "
  6692. "that are unmet. A short explanation of why the package has a dependency "
  6693. "problem is also included."
  6694. msgstr ""
  6695. "In questo esempio il sistema ha molti problemi, tra cui uno piuttosto serio "
  6696. "con la libreadlineg2. Per ciascun pacchetto che ha dipendenze non "
  6697. "soddisfatte, viene stampata una linea che indica il pacchetto che crea il "
  6698. "problema e quali problemi ci sono. Viene inclusa inoltre una breve "
  6699. "spiegazione del perché il pacchetto ha un problema di dipendenze."
  6700. #. type: <p></p>
  6701. #: guide.sgml:337
  6702. #, fuzzy
  6703. msgid ""
  6704. "There are two ways a system can get into a broken state like this. The first "
  6705. "is caused by <prgn>dpkg</prgn> missing some subtle relationships between "
  6706. "packages when performing upgrades. <footnote><p>APT however considers all "
  6707. "known dependencies and attempts to prevent broken packages</p></footnote>. "
  6708. "The second is if a package installation fails during an operation. In this "
  6709. "situation a package may have been unpacked without its dependents being "
  6710. "installed."
  6711. msgstr ""
  6712. "Ci sono due modi in cui un sistema possa arrivare in uno stato problematico "
  6713. "di questo genere: il primo è causato dal fatto che <prgn>dpkg</prgn> possa "
  6714. "mancare alcune relazioni sottili tra pacchetti durante un aggiornamento del "
  6715. "sistema<footnote><p>APT considera comunque tutte le dipendenze note, e cerca "
  6716. "di prevenire problemi ai pacchetti</p></footnote>; il secondo è possibile se "
  6717. "l'installazione di un pacchetto fallisce, ed in questo caso è possibile che "
  6718. "un pacchetto venga scompattato senza che tutti quelli da cui dipende siano "
  6719. "stati installati."
  6720. #. type: <p></p>
  6721. #: guide.sgml:345
  6722. #, fuzzy
  6723. msgid ""
  6724. "The second situation is much less serious than the first because APT places "
  6725. "certain constraints on the order that packages are installed. In both cases "
  6726. "supplying the <tt>-f</tt> option to <prgn>apt-get</prgn> will cause APT to "
  6727. "deduce a possible solution to the problem and then continue on. The APT "
  6728. "<prgn>dselect</prgn> method always supplies the <tt>-f</tt> option to allow "
  6729. "for easy continuation of failed maintainer scripts."
  6730. msgstr ""
  6731. "La seconda possibilità è meno seria della prima, dato che APT gestisce "
  6732. "l'ordine di installazione dei pacchetti; in entrambi i casi l'opzione <tt>-"
  6733. "f</tt> di <prgn>apt-get</prgn> gli farà trovare una soluzione e lo farà "
  6734. "continuare. Il metodo APT di <prgn>dselect</prgn> comprende sempre l'opzione "
  6735. "<tt>-f</tt> per permettere di configurare facilmente anche i pacchetti con "
  6736. "script errati."
  6737. #. type: <p></p>
  6738. #: guide.sgml:351
  6739. #, fuzzy
  6740. msgid ""
  6741. "However, if the <tt>-f</tt> option is used to correct a seriously broken "
  6742. "system caused by the first case then it is possible that it will either fail "
  6743. "immediately or the installation sequence will fail. In either case it is "
  6744. "necessary to manually use dpkg (possibly with forcing options) to correct "
  6745. "the situation enough to allow APT to proceed."
  6746. msgstr ""
  6747. "Se viene usata però l'opzione <tt>-f</tt> per correggere un sistema in uno "
  6748. "stato molto problematico, è possibile che anche con l'opzione il programma "
  6749. "fallisca, subito o durante la sequenza di installazione. In entrambi i casi "
  6750. "è necessario usare dpkg a mano (probabilmente usando delle opzioni di "
  6751. "forzatura) per correggere quanto basta per poter fare continuare APT."
  6752. #. type: <heading></heading>
  6753. #: guide.sgml:356
  6754. #, fuzzy
  6755. msgid "The Status Report"
  6756. msgstr "Il resoconto sullo stato"
  6757. #. type: <p></p>
  6758. #: guide.sgml:363
  6759. #, fuzzy
  6760. msgid ""
  6761. "Before proceeding <prgn>apt-get</prgn> will present a report on what will "
  6762. "happen. Generally the report reflects the type of operation being performed "
  6763. "but there are several common elements. In all cases the lists reflect the "
  6764. "final state of things, taking into account the <tt>-f</tt> option and any "
  6765. "other relevant activities to the command being executed."
  6766. msgstr ""
  6767. "Prima di procedere, <prgn>apt-get</prgn> presenterà un resoconto delle "
  6768. "operazioni che sta per fare. In genere tale resoconto varierà con il tipo di "
  6769. "operazioni da fare, ma ci sono alcuni elementi comuni: in tutti i casi gli "
  6770. "elenchi dipendono dallo stato finale delle cose, e tengono conto "
  6771. "dell'opzione <tt>-f</tt> e di altre attività rilevanti per il comando da "
  6772. "eseguire."
  6773. #. type: <heading></heading>
  6774. #: guide.sgml:364
  6775. #, fuzzy
  6776. msgid "The Extra Package list"
  6777. msgstr "L'elenco dei pacchetti Extra"
  6778. #. type: <example></example>
  6779. #: guide.sgml:372
  6780. #, fuzzy, no-wrap
  6781. msgid ""
  6782. "The following extra packages will be installed:\n"
  6783. " libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl\n"
  6784. " mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base\n"
  6785. " bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy\n"
  6786. " squake pgp-i python-base debmake ldso perl libreadlineg2\n"
  6787. " ssh"
  6788. msgstr ""
  6789. "The following extra packages will be installed:\n"
  6790. " libdbd-mysql-perl xlib6 zlib1 xzx libreadline2 libdbd-msql-perl\n"
  6791. " mailpgp xdpkg fileutils pinepgp zlib1g xlib6g perl-base\n"
  6792. " bin86 libgdbm1 libgdbmg1 quake-lib gmp2 bcc xbuffy\n"
  6793. " squake pgp-i python-base debmake ldso perl libreadlineg2\n"
  6794. " ssh"
  6795. #. type: <p></p>
  6796. #: guide.sgml:379
  6797. #, fuzzy
  6798. msgid ""
  6799. "The Extra Package list shows all of the packages that will be installed or "
  6800. "upgraded in excess of the ones mentioned on the command line. It is only "
  6801. "generated for an <tt>install</tt> command. The listed packages are often the "
  6802. "result of an Auto Install."
  6803. msgstr ""
  6804. "L'elenco dei pacchetti Extra mostra tutti i pacchetti che verranno "
  6805. "installati o aggiornati oltre a quelli indicati sulla linea di comando. "
  6806. "Viene generato solo per il comando <tt>install</tt>. I pacchetti elencati "
  6807. "sono spesso il risultato di un'operazione di auto installazione (Auto "
  6808. "Install)."
  6809. #. type: <heading></heading>
  6810. #: guide.sgml:382
  6811. #, fuzzy
  6812. msgid "The Packages to Remove"
  6813. msgstr "I pacchetti da rimuovere"
  6814. #. type: <example></example>
  6815. #: guide.sgml:389
  6816. #, fuzzy, no-wrap
  6817. msgid ""
  6818. "The following packages will be REMOVED:\n"
  6819. " xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix\n"
  6820. " xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel\n"
  6821. " xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid\n"
  6822. " nas xpilot xfig"
  6823. msgstr ""
  6824. "The following packages will be REMOVED:\n"
  6825. " xlib6-dev xpat2 tk40-dev xkeycaps xbattle xonix\n"
  6826. " xdaliclock tk40 tk41 xforms0.86 ghostview xloadimage xcolorsel\n"
  6827. " xadmin xboard perl-debug tkined xtetris libreadline2-dev perl-suid\n"
  6828. " nas xpilot xfig"
  6829. #. type: <p></p>
  6830. #: guide.sgml:399
  6831. #, fuzzy
  6832. msgid ""
  6833. "The Packages to Remove list shows all of the packages that will be removed "
  6834. "from the system. It can be shown for any of the operations and should be "
  6835. "given a careful inspection to ensure nothing important is to be taken off. "
  6836. "The <tt>-f</tt> option is especially good at generating packages to remove "
  6837. "so extreme care should be used in that case. The list may contain packages "
  6838. "that are going to be removed because they are only partially installed, "
  6839. "possibly due to an aborted installation."
  6840. msgstr ""
  6841. "L'elenco dei pacchetti da rimuovere (Remove) indica tutti i pacchetti che "
  6842. "verranno rimossi dal sistema. Può essere mostrato per una qualsiasi delle "
  6843. "operazioni, e deve sempre essere esaminato attentamente per assicurarsi che "
  6844. "non venga eliminato qualcosa di importante. Con l'opzione <tt>-f</tt> è "
  6845. "particolarmente probabile che vengano eliminati dei pacchetti, ed in questo "
  6846. "caso va fatta estrema attenzione. La lista può contenere dei pacchetti che "
  6847. "verranno rimossi perché sono già rimossi parzialmente, forse a causa di "
  6848. "un'installazione non terminata correttamente."
  6849. #. type: <heading></heading>
  6850. #: guide.sgml:402
  6851. #, fuzzy
  6852. msgid "The New Packages list"
  6853. msgstr "L'elenco dei nuovi pacchetti installati"
  6854. #. type: <example></example>
  6855. #: guide.sgml:406
  6856. #, fuzzy, no-wrap
  6857. msgid ""
  6858. "The following NEW packages will installed:\n"
  6859. " zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base"
  6860. msgstr ""
  6861. "The following NEW packages will installed:\n"
  6862. " zlib1g xlib6g perl-base libgdbmg1 quake-lib gmp2 pgp-i python-base"
  6863. #. type: <p></p>
  6864. #: guide.sgml:411
  6865. #, fuzzy
  6866. msgid ""
  6867. "The New Packages list is simply a reminder of what will happen. The packages "
  6868. "listed are not presently installed in the system but will be when APT is "
  6869. "done."
  6870. msgstr ""
  6871. "L'elenco dei nuovi pacchetti installati (New) è semplicemente un appunto su "
  6872. "quello che accadrà. I pacchetti nell'elenco non sono al momento installati "
  6873. "nel sistema, ma lo saranno alla fine delle operazioni di APT."
  6874. #. type: <heading></heading>
  6875. #: guide.sgml:414
  6876. #, fuzzy
  6877. msgid "The Kept Back list"
  6878. msgstr "L'elenco dei pacchetti trattenuti"
  6879. #. type: <example></example>
  6880. #: guide.sgml:419
  6881. #, fuzzy, no-wrap
  6882. msgid ""
  6883. "The following packages have been kept back\n"
  6884. " compface man-db tetex-base msql libpaper svgalib1\n"
  6885. " gs snmp arena lynx xpat2 groff xscreensaver"
  6886. msgstr ""
  6887. "The following packages have been kept back\n"
  6888. " compface man-db tetex-base msql libpaper svgalib1\n"
  6889. " gs snmp arena lynx xpat2 groff xscreensaver"
  6890. #. type: <p></p>
  6891. #: guide.sgml:428
  6892. #, fuzzy
  6893. msgid ""
  6894. "Whenever the whole system is being upgraded there is the possibility that "
  6895. "new versions of packages cannot be installed because they require new things "
  6896. "or conflict with already installed things. In this case the package will "
  6897. "appear in the Kept Back list. The best way to convince packages listed there "
  6898. "to install is with <tt>apt-get install</tt> or by using <prgn>dselect</prgn> "
  6899. "to resolve their problems."
  6900. msgstr ""
  6901. "In ogni caso in cui il sistema viene aggiornato nel suo insieme, c'è la "
  6902. "possibilità che non possano venire installate nuove versioni di alcuni "
  6903. "pacchetti, dato che potrebbero richiedere l'installazione di pacchetti non "
  6904. "presenti nel sistema, o entrare in conflitto con altri già presenti. In "
  6905. "questo caso, il pacchetto viene elencato nella lista di quelli trattenuti "
  6906. "(Kept Back). Il miglior modo per convincere i pacchetti elencati in questa "
  6907. "lista è di installarli con <tt>apt-get install</tt> o usare <prgn>dselect</"
  6908. "prgn> per risolvere i problemi."
  6909. #. type: <heading></heading>
  6910. #: guide.sgml:431
  6911. #, fuzzy
  6912. msgid "Held Packages warning"
  6913. msgstr "Messaggi di attenzione sui pacchetti trattenuti"
  6914. #. type: <example></example>
  6915. #: guide.sgml:435
  6916. #, fuzzy, no-wrap
  6917. msgid ""
  6918. "The following held packages will be changed:\n"
  6919. " cvs"
  6920. msgstr ""
  6921. "The following held packages will be changed:\n"
  6922. " cvs"
  6923. #. type: <p></p>
  6924. #: guide.sgml:441
  6925. #, fuzzy
  6926. msgid ""
  6927. "Sometimes you can ask APT to install a package that is on hold, in such a "
  6928. "case it prints out a warning that the held package is going to be changed. "
  6929. "This should only happen during dist-upgrade or install."
  6930. msgstr ""
  6931. "A volte si può richiedere ad APT di installare un pacchetto che è stato "
  6932. "trattenuto; in questi casi viene stampato un messaggio di attenzione, che "
  6933. "avverte che il pacchetto verrà modificato. Questo dovrebbe accadere solo "
  6934. "durante operazioni di dist-upgrade o di install."
  6935. #. type: <heading></heading>
  6936. #: guide.sgml:444
  6937. #, fuzzy
  6938. msgid "Final summary"
  6939. msgstr "Resoconto finale"
  6940. #. type: <p></p>
  6941. #: guide.sgml:447
  6942. #, fuzzy
  6943. msgid ""
  6944. "Finally, APT will print out a summary of all the changes that will occur."
  6945. msgstr ""
  6946. "Infine, APT stamperà un riassunto di tutte le modifiche che accadranno."
  6947. #. type: <example></example>
  6948. #: guide.sgml:452
  6949. #, fuzzy, no-wrap
  6950. msgid ""
  6951. "206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded.\n"
  6952. "12 packages not fully installed or removed.\n"
  6953. "Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used."
  6954. msgstr ""
  6955. "206 packages upgraded, 8 newly installed, 23 to remove and 51 not upgraded.\n"
  6956. "12 packages not fully installed or removed.\n"
  6957. "Need to get 65.7M/66.7M of archives. After unpacking 26.5M will be used."
  6958. #. type: <p></p>
  6959. #: guide.sgml:470
  6960. #, fuzzy
  6961. msgid ""
  6962. "The first line of the summary simply is a reduced version of all of the "
  6963. "lists and includes the number of upgrades - that is packages already "
  6964. "installed that have new versions available. The second line indicates the "
  6965. "number of poorly configured packages, possibly the result of an aborted "
  6966. "installation. The final line shows the space requirements that the "
  6967. "installation needs. The first pair of numbers refer to the size of the "
  6968. "archive files. The first number indicates the number of bytes that must be "
  6969. "fetched from remote locations and the second indicates the total size of all "
  6970. "the archives required. The next number indicates the size difference between "
  6971. "the presently installed packages and the newly installed packages. It is "
  6972. "roughly equivalent to the space required in /usr after everything is done. "
  6973. "If a large number of packages are being removed then the value may indicate "
  6974. "the amount of space that will be freed."
  6975. msgstr ""
  6976. "La prima linea del riassunto è semplicemente una versione ridotta di tutte "
  6977. "le liste, ed include il numero di aggiornamenti -- cioè dei pacchetti già "
  6978. "installati per cui sono disponibili nuove versioni. La seconda linea indica "
  6979. "il numero di pacchetti con problemi di configurazione, probabilmente in "
  6980. "conseguenza di un'installazione non andata a buon fine. La linea finale "
  6981. "indica i requisiti di spazio dell'installazione: i primi due numeri indicano "
  6982. "rispettivamente il numero di byte che devono essere trasferiti da posizioni "
  6983. "remote, ed il secondo la dimensione totale di tutti gli archivi necessari "
  6984. "per l'installazione. Il numero successivo indica la differenza in dimensione "
  6985. "tra i pacchetti già installati e quelli che lo saranno, ed è "
  6986. "approssimativamente equivalente allo spazio richiesto in /usr dopo "
  6987. "l'installazione. Se si stanno rimuovendo dei pacchetti, il valore può "
  6988. "indicare lo spazio che verrà liberato."
  6989. #. type: <p></p>
  6990. #: guide.sgml:473
  6991. #, fuzzy
  6992. msgid ""
  6993. "Some other reports can be generated by using the -u option to show packages "
  6994. "to upgrade, they are similar to the previous examples."
  6995. msgstr ""
  6996. "Si possono generare altri resoconti usando l'opzione -u per mostrare i "
  6997. "pacchetti da aggiornare, ma sono simili all'esempio precedente."
  6998. #. type: <heading></heading>
  6999. #: guide.sgml:477
  7000. #, fuzzy
  7001. msgid "The Status Display"
  7002. msgstr "La visualizzazione dello stato"
  7003. #. type: <p></p>
  7004. #: guide.sgml:481
  7005. #, fuzzy
  7006. msgid ""
  7007. "During the download of archives and package files APT prints out a series of "
  7008. "status messages."
  7009. msgstr ""
  7010. "Durante il download degli archivi e dei file dei pacchetti, APT stampa una "
  7011. "serie di messaggi di stato."
  7012. #. type: <example></example>
  7013. #: guide.sgml:490
  7014. #, fuzzy, no-wrap
  7015. msgid ""
  7016. "# apt-get update\n"
  7017. "Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages\n"
  7018. "Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n"
  7019. "Hit http://llug.sep.bnl.gov/debian/ testing/main Packages\n"
  7020. "Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages\n"
  7021. "Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages\n"
  7022. "11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s"
  7023. msgstr ""
  7024. "# apt-get update\n"
  7025. "Get:1 http://ftp.de.debian.org/debian-non-US/ stable/non-US/ Packages\n"
  7026. "Get:2 http://llug.sep.bnl.gov/debian/ testing/contrib Packages\n"
  7027. "Hit http://llug.sep.bnl.gov/debian/ testing/main Packages\n"
  7028. "Get:4 http://ftp.de.debian.org/debian-non-US/ unstable/binary-i386/ Packages\n"
  7029. "Get:5 http://llug.sep.bnl.gov/debian/ testing/non-free Packages\n"
  7030. "11% [5 testing/non-free `Waiting for file' 0/32.1k 0%] 2203b/s 1m52s"
  7031. #. type: <p></p>
  7032. #: guide.sgml:500
  7033. #, fuzzy
  7034. msgid ""
  7035. "The lines starting with <em>Get</em> are printed out when APT begins to "
  7036. "fetch a file while the last line indicates the progress of the download. The "
  7037. "first percent value on the progress line indicates the total percent done of "
  7038. "all files. Unfortunately since the size of the Package files is unknown "
  7039. "<tt>apt-get update</tt> estimates the percent done which causes some "
  7040. "inaccuracies."
  7041. msgstr ""
  7042. "Le linee che cominciano con <em>Get</em> vengono stampate quando APT inizia "
  7043. "a scaricare un file, e l'ultima linea indica il progresso dell'operazione. "
  7044. "Il primo valore in percentuale indica la percentuale totale di tutti i file; "
  7045. "dato che la dimensione dei file Package non è nota, purtroppo a volte "
  7046. "<tt>apt-get update</tt> fa una stima poco accurata."
  7047. #. type: <p></p>
  7048. #: guide.sgml:509
  7049. #, fuzzy
  7050. msgid ""
  7051. "The next section of the status line is repeated once for each download "
  7052. "thread and indicates the operation being performed and some useful "
  7053. "information about what is happening. Sometimes this section will simply read "
  7054. "<em>Forking</em> which means the OS is loading the download module. The "
  7055. "first word after the [ is the fetch number as shown on the history lines. "
  7056. "The next word is the short form name of the object being downloaded. For "
  7057. "archives it will contain the name of the package that is being fetched."
  7058. msgstr ""
  7059. "La sezione successiva della linea di stato viene ripetuta una volta per "
  7060. "ciascuna fase del download, ed indica l'operazione in corso, insieme ad "
  7061. "alcune informazioni utili su cosa stia accadendo. A volte questa sezione "
  7062. "contiene solamente <em>Forking</em>, che significa che il sistema operativo "
  7063. "sta caricando il modulo. La prima parola dopo la parentesi quadra aperta è "
  7064. "il nome breve dell'oggetto che si sta scaricando, che per gli archivi è il "
  7065. "nome del pacchetto."
  7066. #. type: <p></p>
  7067. #: guide.sgml:524
  7068. #, fuzzy
  7069. msgid ""
  7070. "Inside of the single quote is an informative string indicating the progress "
  7071. "of the negotiation phase of the download. Typically it progresses from "
  7072. "<em>Connecting</em> to <em>Waiting for file</em> to <em>Downloading</em> or "
  7073. "<em>Resuming</em>. The final value is the number of bytes downloaded from "
  7074. "the remote site. Once the download begins this is represented as "
  7075. "<tt>102/10.2k</tt> indicating that 102 bytes have been fetched and 10.2 "
  7076. "kilobytes is expected. The total size is always shown in 4 figure notation "
  7077. "to preserve space. After the size display is a percent meter for the file "
  7078. "itself. The second last element is the instantaneous average speed. This "
  7079. "values is updated every 5 seconds and reflects the rate of data transfer for "
  7080. "that period. Finally is shown the estimated transfer time. This is updated "
  7081. "regularly and reflects the time to complete everything at the shown transfer "
  7082. "rate."
  7083. msgstr ""
  7084. "All'interno delle virgolette c'è una stringa informativa, che indica il "
  7085. "progresso della fase di negoziazione del download. Tipicamente comincia con "
  7086. "<em>Connecting</em>, procede con <em>Waiting for file</em> e poi con "
  7087. "<em>Downloading</em> o <em>Resuming</em>. Il valore finale è il numero di "
  7088. "byte che sono stati scaricati dal sito remoto: una volta cominciato il "
  7089. "download viene rappresentato come <tt>102/10.2k</tt>, che indica che sono "
  7090. "stati scaricati 102 byte di 10.2 kilobyte. La dimensione totale viene sempre "
  7091. "espressa in notazione a quattro cifre, per risparmiare spazio. Dopo la "
  7092. "dimensione viene indicato un indicatore progressivo della percentuale del "
  7093. "file. Il penultimo elemento è la velocità istantanea media, che viene "
  7094. "aggiornata ogni 5 secondi, e riflette la velocità di trasferimento dei dati "
  7095. "in quel periodo. Infine, viene visualizzato il tempo stimato per il "
  7096. "trasferimento, che viene aggiornato periodicamente e riflette il tempo "
  7097. "necessario per completare tutte le operazioni alla velocità di trasferimento "
  7098. "mostrata."
  7099. #. type: <p></p>
  7100. #: guide.sgml:530
  7101. #, fuzzy
  7102. msgid ""
  7103. "The status display updates every half second to provide a constant feedback "
  7104. "on the download progress while the Get lines scroll back whenever a new file "
  7105. "is started. Since the status display is constantly updated it is unsuitable "
  7106. "for logging to a file, use the <tt>-q</tt> option to remove the status "
  7107. "display."
  7108. msgstr ""
  7109. "La visualizzazione dello stato viene aggiornata ogni mezzo secondo per "
  7110. "fornire un feedback costante del processo di download, e le linee Get "
  7111. "scorrono indietro quando viene cominciato il download di un nuovo file. Dato "
  7112. "che la visualizzazione dello stato viene costantemente aggiornata, non è "
  7113. "adatta per essere registrata in un file; per non visualizzarla si può usare "
  7114. "l'opzione <tt>-q</tt>."
  7115. #. type: <heading></heading>
  7116. #: guide.sgml:535
  7117. #, fuzzy
  7118. msgid "Dpkg"
  7119. msgstr "Dpkg"
  7120. #. type: <p></p>
  7121. #: guide.sgml:542
  7122. #, fuzzy
  7123. msgid ""
  7124. "APT uses <prgn>dpkg</prgn> for installing the archives and will switch over "
  7125. "to the <prgn>dpkg</prgn> interface once downloading is completed. "
  7126. "<prgn>dpkg</prgn> will also ask a number of questions as it processes the "
  7127. "packages and the packages themselves may also ask several questions. Before "
  7128. "each question there is usually a description of what it is asking and the "
  7129. "questions are too varied to discuss completely here."
  7130. msgstr ""
  7131. "APT usa <prgn>dpkg</prgn> per installare gli archivi e passerà "
  7132. "all'interfaccia <prgn>dpkg</prgn> una volta finito il download. <prgn>dpkg</"
  7133. "prgn> porrà anche alcune domande durante la manipolazione dei pacchetti, ed "
  7134. "i pacchetti stessi potranno farne altre. Prima di ciascuna domanda viene "
  7135. "proposta una descrizione di quello che sta per chiedere, e le domande sono "
  7136. "troppo diverse per poter essere discusse in maniera completa in questa "
  7137. "occasione."
  7138. #. type: <title></title>
  7139. #: offline.sgml:4
  7140. msgid "Using APT Offline"
  7141. msgstr ""
  7142. #. type: <version></version>
  7143. #: offline.sgml:7
  7144. #, fuzzy
  7145. msgid "$Id: offline.sgml,v 1.8 2003/02/12 15:06:41 doogie Exp $"
  7146. msgstr "$Id: guide.it.sgml,v 1.5 2003/04/26 23:26:13 doogie Exp $"
  7147. #. type: <abstract></abstract>
  7148. #: offline.sgml:12
  7149. msgid ""
  7150. "This document describes how to use APT in a non-networked environment, "
  7151. "specifically a 'sneaker-net' approach for performing upgrades."
  7152. msgstr ""
  7153. #. type: <copyrightsummary></copyrightsummary>
  7154. #: offline.sgml:16
  7155. #, fuzzy
  7156. msgid "Copyright &copy; Jason Gunthorpe, 1999."
  7157. msgstr "Copyright &copy; Jason Gunthorpe, 1998."
  7158. #. type: <heading></heading>
  7159. #: offline.sgml:32
  7160. msgid "Introduction"
  7161. msgstr ""
  7162. #. type: <heading></heading>
  7163. #: offline.sgml:34 offline.sgml:65 offline.sgml:180
  7164. msgid "Overview"
  7165. msgstr ""
  7166. #. type: <p></p>
  7167. #: offline.sgml:40
  7168. msgid ""
  7169. "Normally APT requires direct access to a Debian archive, either from a local "
  7170. "media or through a network. Another common complaint is that a Debian "
  7171. "machine is on a slow link, such as a modem and another machine has a very "
  7172. "fast connection but they are physically distant."
  7173. msgstr ""
  7174. #. type: <p></p>
  7175. #: offline.sgml:51
  7176. msgid ""
  7177. "The solution to this is to use large removable media such as a Zip disc or a "
  7178. "SuperDisk disc. These discs are not large enough to store the entire Debian "
  7179. "archive but can easily fit a subset large enough for most users. The idea is "
  7180. "to use APT to generate a list of packages that are required and then fetch "
  7181. "them onto the disc using another machine with good connectivity. It is even "
  7182. "possible to use another Debian machine with APT or to use a completely "
  7183. "different OS and a download tool like wget. Let <em>remote host</em> mean "
  7184. "the machine downloading the packages, and <em>target host</em> the one with "
  7185. "bad or no connection."
  7186. msgstr ""
  7187. #. type: <p></p>
  7188. #: offline.sgml:57
  7189. msgid ""
  7190. "This is achieved by creatively manipulating the APT configuration file. The "
  7191. "essential premise to tell APT to look on a disc for it's archive files. Note "
  7192. "that the disc should be formated with a filesystem that can handle long file "
  7193. "names such as ext2, fat32 or vfat."
  7194. msgstr ""
  7195. #. type: <heading></heading>
  7196. #: offline.sgml:63
  7197. msgid "Using APT on both machines"
  7198. msgstr ""
  7199. #. type: <p><example>
  7200. #: offline.sgml:71
  7201. msgid ""
  7202. "APT being available on both machines gives the simplest configuration. The "
  7203. "basic idea is to place a copy of the status file on the disc and use the "
  7204. "remote machine to fetch the latest package files and decide which packages "
  7205. "to download. The disk directory structure should look like:"
  7206. msgstr ""
  7207. #. type: <example></example>
  7208. #: offline.sgml:80
  7209. #, no-wrap
  7210. msgid ""
  7211. " /disc/\n"
  7212. " archives/\n"
  7213. " partial/\n"
  7214. " lists/\n"
  7215. " partial/\n"
  7216. " status\n"
  7217. " sources.list\n"
  7218. " apt.conf"
  7219. msgstr ""
  7220. #. type: <heading></heading>
  7221. #: offline.sgml:88
  7222. msgid "The configuration file"
  7223. msgstr ""
  7224. #. type: <p></p>
  7225. #: offline.sgml:96
  7226. msgid ""
  7227. "The configuration file should tell APT to store its files on the disc and to "
  7228. "use the configuration files on the disc as well. The sources.list should "
  7229. "contain the proper sites that you wish to use from the remote machine, and "
  7230. "the status file should be a copy of <em>/var/lib/dpkg/status</em> from the "
  7231. "<em>target host</em>. Please note, if you are using a local archive you must "
  7232. "use copy URIs, the syntax is identical to file URIs."
  7233. msgstr ""
  7234. #. type: <p><example>
  7235. #: offline.sgml:100
  7236. msgid ""
  7237. "<em>apt.conf</em> must contain the necessary information to make APT use the "
  7238. "disc:"
  7239. msgstr ""
  7240. #. type: <example></example>
  7241. #: offline.sgml:124
  7242. #, no-wrap
  7243. msgid ""
  7244. " APT\n"
  7245. " {\n"
  7246. " /* This is not necessary if the two machines are the same arch, it tells\n"
  7247. " the remote APT what architecture the target machine is */\n"
  7248. " Architecture \"i386\";\n"
  7249. " \n"
  7250. " Get::Download-Only \"true\";\n"
  7251. " };\n"
  7252. " \n"
  7253. " Dir\n"
  7254. " {\n"
  7255. " /* Use the disc for state information and redirect the status file from\n"
  7256. " the /var/lib/dpkg default */\n"
  7257. " State \"/disc/\";\n"
  7258. " State::status \"status\";\n"
  7259. "\n"
  7260. " // Binary caches will be stored locally\n"
  7261. " Cache::archives \"/disc/archives/\";\n"
  7262. " Cache \"/tmp/\";\n"
  7263. " \n"
  7264. " // Location of the source list.\n"
  7265. " Etc \"/disc/\";\n"
  7266. " };"
  7267. msgstr ""
  7268. #. type: </example></p>
  7269. #: offline.sgml:129
  7270. msgid ""
  7271. "More details can be seen by examining the apt.conf man page and the sample "
  7272. "configuration file in <em>/usr/share/doc/apt/examples/apt.conf</em>."
  7273. msgstr ""
  7274. #. type: <p><example>
  7275. #: offline.sgml:136
  7276. msgid ""
  7277. "On the target machine the first thing to do is mount the disc and copy <em>/"
  7278. "var/lib/dpkg/status</em> to it. You will also need to create the directories "
  7279. "outlined in the Overview, <em>archives/partial/</em> and <em>lists/partial/</"
  7280. "em>. Then take the disc to the remote machine and configure the sources."
  7281. "list. On the remote machine execute the following:"
  7282. msgstr ""
  7283. #. type: <example></example>
  7284. #: offline.sgml:142
  7285. #, no-wrap
  7286. msgid ""
  7287. " # export APT_CONFIG=\"/disc/apt.conf\"\n"
  7288. " # apt-get update\n"
  7289. " [ APT fetches the package files ]\n"
  7290. " # apt-get dist-upgrade\n"
  7291. " [ APT fetches all the packages needed to upgrade the target machine ]"
  7292. msgstr ""
  7293. #. type: </example></p>
  7294. #: offline.sgml:149
  7295. msgid ""
  7296. "The dist-upgrade command can be replaced with any other standard APT "
  7297. "commands, particularly dselect-upgrade. You can even use an APT front end "
  7298. "such as <em>dselect</em>. However this presents a problem in communicating "
  7299. "your selections back to the local computer."
  7300. msgstr ""
  7301. #. type: <p><example>
  7302. #: offline.sgml:153
  7303. msgid ""
  7304. "Now the disc contains all of the index files and archives needed to upgrade "
  7305. "the target machine. Take the disc back and run:"
  7306. msgstr ""
  7307. #. type: <example></example>
  7308. #: offline.sgml:159
  7309. #, no-wrap
  7310. msgid ""
  7311. " # export APT_CONFIG=\"/disc/apt.conf\"\n"
  7312. " # apt-get check\n"
  7313. " [ APT generates a local copy of the cache files ]\n"
  7314. " # apt-get --no-d -o dir::state::status=/var/lib/dpkg/status dist-upgrade\n"
  7315. " [ Or any other APT command ]"
  7316. msgstr ""
  7317. #. type: <p></p>
  7318. #: offline.sgml:165
  7319. msgid ""
  7320. "It is necessary for proper function to re-specify the status file to be the "
  7321. "local one. This is very important!"
  7322. msgstr ""
  7323. #. type: <p></p>
  7324. #: offline.sgml:172
  7325. msgid ""
  7326. "If you are using dselect you can do the very risky operation of copying disc/"
  7327. "status to /var/lib/dpkg/status so that any selections you made on the remote "
  7328. "machine are updated. I highly recommend that people only make selections on "
  7329. "the local machine - but this may not always be possible. DO NOT copy the "
  7330. "status file if dpkg or APT have been run in the mean time!!"
  7331. msgstr ""
  7332. #. type: <heading></heading>
  7333. #: offline.sgml:178
  7334. msgid "Using APT and wget"
  7335. msgstr ""
  7336. #. type: <p></p>
  7337. #: offline.sgml:185
  7338. msgid ""
  7339. "<em>wget</em> is a popular and portable download tool that can run on nearly "
  7340. "any machine. Unlike the method above this requires that the Debian machine "
  7341. "already has a list of available packages."
  7342. msgstr ""
  7343. #. type: <p></p>
  7344. #: offline.sgml:190
  7345. msgid ""
  7346. "The basic idea is to create a disc that has only the archive files "
  7347. "downloaded from the remote site. This is done by using the --print-uris "
  7348. "option to apt-get and then preparing a wget script to actually fetch the "
  7349. "packages."
  7350. msgstr ""
  7351. #. type: <heading></heading>
  7352. #: offline.sgml:196
  7353. msgid "Operation"
  7354. msgstr ""
  7355. #. type: <p><example>
  7356. #: offline.sgml:200
  7357. msgid ""
  7358. "Unlike the previous technique no special configuration files are required. "
  7359. "We merely use the standard APT commands to generate the file list."
  7360. msgstr ""
  7361. #. type: <example></example>
  7362. #: offline.sgml:205
  7363. #, no-wrap
  7364. msgid ""
  7365. " # apt-get dist-upgrade \n"
  7366. " [ Press no when prompted, make sure you are happy with the actions ]\n"
  7367. " # apt-get -qq --print-uris dist-upgrade > uris\n"
  7368. " # awk '{print \"wget -O \" $2 \" \" $1}' < uris > /disc/wget-script"
  7369. msgstr ""
  7370. #. type: </example></p>
  7371. #: offline.sgml:210
  7372. msgid ""
  7373. "Any command other than dist-upgrade could be used here, including dselect-"
  7374. "upgrade."
  7375. msgstr ""
  7376. #. type: <p></p>
  7377. #: offline.sgml:216
  7378. msgid ""
  7379. "The /disc/wget-script file will now contain a list of wget commands to "
  7380. "execute in order to fetch the necessary archives. This script should be run "
  7381. "with the current directory as the disc's mount point so as to save the "
  7382. "output on the disc."
  7383. msgstr ""
  7384. #. type: <p><example>
  7385. #: offline.sgml:219
  7386. msgid "The remote machine would do something like"
  7387. msgstr ""
  7388. #. type: <example></example>
  7389. #: offline.sgml:223
  7390. #, no-wrap
  7391. msgid ""
  7392. " # cd /disc\n"
  7393. " # sh -x ./wget-script\n"
  7394. " [ wait.. ]"
  7395. msgstr ""
  7396. #. type: </example><example>
  7397. #: offline.sgml:228
  7398. msgid ""
  7399. "Once the archives are downloaded and the disc returned to the Debian machine "
  7400. "installation can proceed using,"
  7401. msgstr ""
  7402. #. type: <example></example>
  7403. #: offline.sgml:230
  7404. #, no-wrap
  7405. msgid " # apt-get -o dir::cache::archives=\"/disc/\" dist-upgrade"
  7406. msgstr ""
  7407. #. type: </example></p>
  7408. #: offline.sgml:234
  7409. msgid "Which will use the already fetched archives on the disc."
  7410. msgstr ""