apt-doc.pot 246 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222422342244225422642274228422942304231423242334234423542364237423842394240424142424243424442454246424742484249425042514252425342544255425642574258425942604261426242634264426542664267426842694270427142724273427442754276427742784279428042814282428342844285428642874288428942904291429242934294429542964297429842994300430143024303430443054306430743084309431043114312431343144315431643174318431943204321432243234324432543264327432843294330433143324333433443354336433743384339434043414342434343444345434643474348434943504351435243534354435543564357435843594360436143624363436443654366436743684369437043714372437343744375437643774378437943804381438243834384438543864387438843894390439143924393439443954396439743984399440044014402440344044405440644074408440944104411441244134414441544164417441844194420442144224423442444254426442744284429443044314432443344344435443644374438443944404441444244434444444544464447444844494450445144524453445444554456445744584459446044614462446344644465446644674468446944704471447244734474447544764477447844794480448144824483448444854486448744884489449044914492449344944495449644974498449945004501450245034504450545064507450845094510451145124513451445154516451745184519452045214522452345244525452645274528452945304531453245334534453545364537453845394540454145424543454445454546454745484549455045514552455345544555455645574558455945604561456245634564456545664567456845694570457145724573457445754576457745784579458045814582458345844585458645874588458945904591459245934594459545964597459845994600460146024603460446054606460746084609461046114612461346144615461646174618461946204621462246234624462546264627462846294630463146324633463446354636463746384639464046414642464346444645464646474648464946504651465246534654465546564657465846594660466146624663466446654666466746684669467046714672467346744675467646774678467946804681468246834684468546864687468846894690469146924693469446954696469746984699470047014702470347044705470647074708470947104711471247134714471547164717471847194720472147224723472447254726472747284729473047314732473347344735473647374738473947404741474247434744474547464747474847494750475147524753475447554756475747584759476047614762476347644765476647674768476947704771477247734774477547764777477847794780478147824783478447854786478747884789479047914792479347944795479647974798479948004801480248034804480548064807480848094810481148124813481448154816481748184819482048214822482348244825482648274828482948304831483248334834483548364837483848394840484148424843484448454846484748484849485048514852485348544855485648574858485948604861486248634864486548664867486848694870487148724873487448754876487748784879488048814882488348844885488648874888488948904891489248934894489548964897489848994900490149024903490449054906490749084909491049114912491349144915491649174918491949204921492249234924492549264927492849294930493149324933493449354936493749384939494049414942494349444945494649474948494949504951495249534954495549564957495849594960496149624963496449654966496749684969497049714972497349744975497649774978497949804981498249834984498549864987498849894990499149924993499449954996499749984999500050015002500350045005500650075008500950105011501250135014501550165017501850195020502150225023502450255026502750285029503050315032503350345035503650375038503950405041504250435044504550465047504850495050505150525053505450555056505750585059506050615062506350645065506650675068506950705071507250735074507550765077507850795080508150825083508450855086508750885089509050915092509350945095509650975098509951005101510251035104510551065107510851095110511151125113511451155116511751185119512051215122512351245125512651275128512951305131513251335134513551365137513851395140514151425143514451455146514751485149515051515152515351545155515651575158515951605161516251635164516551665167516851695170517151725173517451755176517751785179518051815182518351845185518651875188518951905191519251935194519551965197519851995200520152025203520452055206520752085209521052115212521352145215521652175218521952205221522252235224522552265227522852295230523152325233523452355236523752385239524052415242524352445245524652475248524952505251525252535254525552565257525852595260526152625263526452655266526752685269527052715272527352745275527652775278527952805281528252835284528552865287528852895290529152925293529452955296529752985299530053015302530353045305530653075308530953105311531253135314531553165317531853195320532153225323532453255326532753285329533053315332533353345335533653375338533953405341534253435344534553465347534853495350535153525353535453555356535753585359536053615362536353645365536653675368536953705371537253735374537553765377537853795380538153825383538453855386538753885389539053915392539353945395539653975398539954005401540254035404540554065407540854095410541154125413541454155416541754185419542054215422542354245425542654275428542954305431543254335434543554365437543854395440544154425443544454455446544754485449545054515452545354545455545654575458545954605461546254635464546554665467546854695470547154725473547454755476547754785479548054815482548354845485548654875488548954905491549254935494549554965497549854995500550155025503550455055506550755085509551055115512551355145515551655175518551955205521552255235524552555265527552855295530553155325533553455355536553755385539554055415542554355445545554655475548554955505551555255535554555555565557555855595560556155625563556455655566556755685569557055715572557355745575557655775578557955805581558255835584558555865587558855895590559155925593559455955596559755985599560056015602560356045605560656075608560956105611561256135614561556165617561856195620562156225623562456255626562756285629563056315632563356345635563656375638563956405641564256435644564556465647564856495650565156525653565456555656565756585659566056615662566356645665566656675668566956705671567256735674567556765677567856795680568156825683568456855686568756885689569056915692569356945695569656975698569957005701570257035704570557065707570857095710571157125713571457155716571757185719572057215722572357245725572657275728572957305731573257335734573557365737573857395740574157425743574457455746574757485749575057515752575357545755575657575758575957605761576257635764576557665767576857695770577157725773577457755776577757785779578057815782578357845785578657875788578957905791579257935794579557965797579857995800580158025803580458055806580758085809581058115812581358145815581658175818581958205821582258235824582558265827582858295830583158325833583458355836583758385839584058415842584358445845584658475848584958505851585258535854585558565857585858595860586158625863586458655866586758685869587058715872587358745875587658775878587958805881588258835884588558865887588858895890589158925893589458955896589758985899590059015902590359045905590659075908590959105911591259135914591559165917591859195920592159225923592459255926592759285929593059315932593359345935593659375938593959405941594259435944594559465947594859495950595159525953595459555956595759585959596059615962596359645965596659675968596959705971597259735974597559765977597859795980598159825983598459855986598759885989599059915992599359945995599659975998599960006001600260036004600560066007600860096010601160126013601460156016601760186019602060216022602360246025602660276028602960306031603260336034603560366037603860396040604160426043604460456046604760486049605060516052605360546055605660576058605960606061606260636064606560666067606860696070607160726073607460756076607760786079608060816082608360846085608660876088608960906091609260936094609560966097609860996100610161026103610461056106610761086109611061116112611361146115611661176118611961206121612261236124612561266127612861296130613161326133613461356136613761386139614061416142614361446145614661476148614961506151615261536154615561566157615861596160616161626163616461656166616761686169617061716172617361746175617661776178617961806181618261836184618561866187618861896190619161926193619461956196619761986199620062016202620362046205620662076208620962106211621262136214621562166217621862196220622162226223622462256226622762286229623062316232623362346235623662376238623962406241624262436244624562466247624862496250625162526253625462556256625762586259626062616262626362646265626662676268626962706271627262736274627562766277627862796280628162826283628462856286628762886289629062916292629362946295629662976298629963006301630263036304630563066307630863096310631163126313631463156316631763186319632063216322632363246325632663276328632963306331633263336334633563366337633863396340634163426343634463456346634763486349635063516352635363546355635663576358635963606361636263636364636563666367636863696370637163726373637463756376637763786379638063816382638363846385638663876388638963906391639263936394639563966397639863996400640164026403640464056406640764086409641064116412641364146415641664176418641964206421642264236424642564266427642864296430643164326433643464356436643764386439644064416442644364446445644664476448644964506451645264536454645564566457645864596460646164626463646464656466646764686469647064716472647364746475647664776478647964806481648264836484648564866487648864896490649164926493649464956496649764986499650065016502650365046505650665076508650965106511651265136514651565166517651865196520652165226523652465256526652765286529653065316532653365346535653665376538653965406541654265436544654565466547654865496550655165526553655465556556655765586559656065616562656365646565656665676568656965706571657265736574657565766577657865796580658165826583658465856586658765886589659065916592659365946595659665976598659966006601660266036604660566066607660866096610661166126613661466156616661766186619662066216622662366246625662666276628662966306631663266336634663566366637663866396640664166426643664466456646664766486649665066516652665366546655665666576658665966606661666266636664666566666667666866696670667166726673667466756676667766786679668066816682668366846685668666876688668966906691669266936694669566966697669866996700670167026703670467056706670767086709671067116712671367146715671667176718671967206721672267236724672567266727672867296730673167326733673467356736673767386739674067416742674367446745674667476748674967506751675267536754675567566757675867596760676167626763676467656766676767686769677067716772677367746775677667776778677967806781678267836784678567866787678867896790679167926793679467956796679767986799680068016802680368046805680668076808680968106811681268136814681568166817681868196820682168226823682468256826682768286829683068316832683368346835683668376838683968406841684268436844684568466847684868496850685168526853685468556856685768586859
  1. # SOME DESCRIPTIVE TITLE
  2. # Copyright (C) YEAR Free Software Foundation, Inc.
  3. # This file is distributed under the same license as the PACKAGE package.
  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
  5. #
  6. #, fuzzy
  7. msgid ""
  8. msgstr ""
  9. "Project-Id-Version: PACKAGE VERSION\n"
  10. "POT-Creation-Date: 2009-09-24 15:02+0300\n"
  11. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13. "Language-Team: LANGUAGE <LL@li.org>\n"
  14. "MIME-Version: 1.0\n"
  15. "Content-Type: text/plain; charset=utf-8\n"
  16. "Content-Transfer-Encoding: ENCODING"
  17. #. type: TH
  18. #: apt.8:17
  19. #, no-wrap
  20. msgid "apt"
  21. msgstr ""
  22. #. type: TH
  23. #: apt.8:17
  24. #, no-wrap
  25. msgid "16 June 1998"
  26. msgstr ""
  27. #. type: TH
  28. #: apt.8:17
  29. #, no-wrap
  30. msgid "Debian GNU/Linux"
  31. msgstr ""
  32. #. type: SH
  33. #: apt.8:18
  34. #, no-wrap
  35. msgid "NAME"
  36. msgstr ""
  37. #. type: Plain text
  38. #: apt.8:20
  39. msgid "apt - Advanced Package Tool"
  40. msgstr ""
  41. #. type: SH
  42. #: apt.8:20
  43. #, no-wrap
  44. msgid "SYNOPSIS"
  45. msgstr ""
  46. #. type: Plain text
  47. #: apt.8:22
  48. msgid "B<apt>"
  49. msgstr ""
  50. #. type: SH
  51. #: apt.8:22
  52. #, no-wrap
  53. msgid "DESCRIPTION"
  54. msgstr ""
  55. #. type: Plain text
  56. #: apt.8:31
  57. msgid ""
  58. "APT is a management system for software packages. For normal day to day "
  59. "package management there are several frontends available, such as "
  60. "B<aptitude>(8) for the command line or B<synaptic>(8) for the X Window "
  61. "System. Some options are only implemented in B<apt-get>(8) though."
  62. msgstr ""
  63. #. type: SH
  64. #: apt.8:31
  65. #, no-wrap
  66. msgid "OPTIONS"
  67. msgstr ""
  68. #. type: Plain text
  69. #: apt.8:33 apt.8:35
  70. msgid "None."
  71. msgstr ""
  72. #. type: SH
  73. #: apt.8:33
  74. #, no-wrap
  75. msgid "FILES"
  76. msgstr ""
  77. #. type: SH
  78. #: apt.8:35
  79. #, no-wrap
  80. msgid "SEE ALSO"
  81. msgstr ""
  82. #. type: Plain text
  83. #: apt.8:42
  84. msgid ""
  85. "B<apt-cache>(8), B<apt-get>(8), B<apt.conf>(5), B<sources.list>(5), "
  86. "B<apt_preferences>(5), B<apt-secure>(8)"
  87. msgstr ""
  88. #. type: SH
  89. #: apt.8:42
  90. #, no-wrap
  91. msgid "DIAGNOSTICS"
  92. msgstr ""
  93. #. type: Plain text
  94. #: apt.8:44
  95. msgid "apt returns zero on normal operation, decimal 100 on error."
  96. msgstr ""
  97. #. type: SH
  98. #: apt.8:44
  99. #, no-wrap
  100. msgid "BUGS"
  101. msgstr ""
  102. #. type: Plain text
  103. #: apt.8:46
  104. msgid "This manpage isn't even started."
  105. msgstr ""
  106. #. type: Plain text
  107. #: apt.8:55
  108. msgid ""
  109. "See E<lt>http://bugs.debian.org/aptE<gt>. If you wish to report a bug in "
  110. "B<apt>, please see I</usr/share/doc/debian/bug-reporting.txt> or the "
  111. "B<reportbug>(1) command."
  112. msgstr ""
  113. #. type: SH
  114. #: apt.8:55
  115. #, no-wrap
  116. msgid "AUTHOR"
  117. msgstr ""
  118. #. type: Plain text
  119. #: apt.8:56
  120. msgid "apt was written by the APT team E<lt>apt@packages.debian.orgE<gt>."
  121. msgstr ""
  122. #. type: Plain text
  123. #: apt.ent:2
  124. msgid "<!-- -*- mode: sgml; mode: fold -*- -->"
  125. msgstr ""
  126. #. type: Plain text
  127. #: apt.ent:10
  128. msgid ""
  129. "<!-- Some common paths.. --> <!ENTITY docdir \"/usr/share/doc/apt/\"> "
  130. "<!ENTITY guidesdir \"/usr/share/doc/apt-doc/\"> <!ENTITY configureindex "
  131. "\"<filename>&docdir;examples/configure-index.gz</filename>\"> <!ENTITY "
  132. "aptconfdir \"<filename>/etc/apt.conf</filename>\"> <!ENTITY statedir "
  133. "\"/var/lib/apt\"> <!ENTITY cachedir \"/var/cache/apt\">"
  134. msgstr ""
  135. #. type: Plain text
  136. #: apt.ent:17
  137. #, no-wrap
  138. msgid ""
  139. "<!-- Cross references to other man pages -->\n"
  140. "<!ENTITY apt-conf \"<citerefentry>\n"
  141. " <refentrytitle><filename>apt.conf</filename></refentrytitle>\n"
  142. " <manvolnum>5</manvolnum>\n"
  143. " </citerefentry>\"\n"
  144. ">\n"
  145. msgstr ""
  146. #. type: Plain text
  147. #: apt.ent:23
  148. #, no-wrap
  149. msgid ""
  150. "<!ENTITY apt-get \"<citerefentry>\n"
  151. " <refentrytitle><command>apt-get</command></refentrytitle>\n"
  152. " <manvolnum>8</manvolnum>\n"
  153. " </citerefentry>\"\n"
  154. ">\n"
  155. msgstr ""
  156. #. type: Plain text
  157. #: apt.ent:29
  158. #, no-wrap
  159. msgid ""
  160. "<!ENTITY apt-config \"<citerefentry>\n"
  161. " <refentrytitle><command>apt-config</command></refentrytitle>\n"
  162. " <manvolnum>8</manvolnum>\n"
  163. " </citerefentry>\"\n"
  164. ">\n"
  165. msgstr ""
  166. #. type: Plain text
  167. #: apt.ent:35
  168. #, no-wrap
  169. msgid ""
  170. "<!ENTITY apt-cdrom \"<citerefentry>\n"
  171. " <refentrytitle><command>apt-cdrom</command></refentrytitle>\n"
  172. " <manvolnum>8</manvolnum>\n"
  173. " </citerefentry>\"\n"
  174. ">\n"
  175. msgstr ""
  176. #. type: Plain text
  177. #: apt.ent:41
  178. #, no-wrap
  179. msgid ""
  180. "<!ENTITY apt-cache \"<citerefentry>\n"
  181. " <refentrytitle><command>apt-cache</command></refentrytitle>\n"
  182. " <manvolnum>8</manvolnum>\n"
  183. " </citerefentry>\"\n"
  184. ">\n"
  185. msgstr ""
  186. #. type: Plain text
  187. #: apt.ent:47
  188. #, no-wrap
  189. msgid ""
  190. "<!ENTITY apt-preferences \"<citerefentry>\n"
  191. " <refentrytitle><command>apt_preferences</command></refentrytitle>\n"
  192. " <manvolnum>5</manvolnum>\n"
  193. " </citerefentry>\"\n"
  194. ">\n"
  195. msgstr ""
  196. #. type: Plain text
  197. #: apt.ent:53
  198. #, no-wrap
  199. msgid ""
  200. "<!ENTITY apt-key \"<citerefentry>\n"
  201. " <refentrytitle><command>apt-key</command></refentrytitle>\n"
  202. " <manvolnum>8</manvolnum>\n"
  203. " </citerefentry>\"\n"
  204. ">\n"
  205. msgstr ""
  206. #. type: Plain text
  207. #: apt.ent:59
  208. #, no-wrap
  209. msgid ""
  210. "<!ENTITY apt-secure \"<citerefentry>\n"
  211. " <refentrytitle>apt-secure</refentrytitle>\n"
  212. " <manvolnum>8</manvolnum>\n"
  213. " </citerefentry>\"\n"
  214. ">\n"
  215. msgstr ""
  216. #. type: Plain text
  217. #: apt.ent:65
  218. #, no-wrap
  219. msgid ""
  220. "<!ENTITY apt-ftparchive \"<citerefentry>\n"
  221. " <refentrytitle><filename>apt-ftparchive</filename></refentrytitle>\n"
  222. " <manvolnum>1</manvolnum>\n"
  223. " </citerefentry>\"\n"
  224. ">\n"
  225. msgstr ""
  226. #. type: Plain text
  227. #: apt.ent:72
  228. #, no-wrap
  229. msgid ""
  230. "<!ENTITY sources-list \"<citerefentry>\n"
  231. " <refentrytitle><filename>sources.list</filename></refentrytitle>\n"
  232. " <manvolnum>5</manvolnum>\n"
  233. " </citerefentry>\"\n"
  234. ">\n"
  235. msgstr ""
  236. #. type: Plain text
  237. #: apt.ent:78
  238. #, no-wrap
  239. msgid ""
  240. "<!ENTITY reportbug \"<citerefentry>\n"
  241. " <refentrytitle><command>reportbug</command></refentrytitle>\n"
  242. " <manvolnum>1</manvolnum>\n"
  243. " </citerefentry>\"\n"
  244. ">\n"
  245. msgstr ""
  246. #. type: Plain text
  247. #: apt.ent:84
  248. #, no-wrap
  249. msgid ""
  250. "<!ENTITY dpkg \"<citerefentry>\n"
  251. " <refentrytitle><command>dpkg</command></refentrytitle>\n"
  252. " <manvolnum>8</manvolnum>\n"
  253. " </citerefentry>\"\n"
  254. ">\n"
  255. msgstr ""
  256. #. type: Plain text
  257. #: apt.ent:90
  258. #, no-wrap
  259. msgid ""
  260. "<!ENTITY dpkg-buildpackage \"<citerefentry>\n"
  261. " <refentrytitle><command>dpkg-buildpackage</command></refentrytitle>\n"
  262. " <manvolnum>1</manvolnum>\n"
  263. " </citerefentry>\"\n"
  264. ">\n"
  265. msgstr ""
  266. #. type: Plain text
  267. #: apt.ent:96
  268. #, no-wrap
  269. msgid ""
  270. "<!ENTITY gzip \"<citerefentry>\n"
  271. " <refentrytitle><command>gzip</command></refentrytitle>\n"
  272. " <manvolnum>1</manvolnum>\n"
  273. " </citerefentry>\"\n"
  274. ">\n"
  275. msgstr ""
  276. #. type: Plain text
  277. #: apt.ent:102
  278. #, no-wrap
  279. msgid ""
  280. "<!ENTITY dpkg-scanpackages \"<citerefentry>\n"
  281. " <refentrytitle><command>dpkg-scanpackages</command></refentrytitle>\n"
  282. " <manvolnum>8</manvolnum>\n"
  283. " </citerefentry>\"\n"
  284. ">\n"
  285. msgstr ""
  286. #. type: Plain text
  287. #: apt.ent:108
  288. #, no-wrap
  289. msgid ""
  290. "<!ENTITY dpkg-scansources \"<citerefentry>\n"
  291. " <refentrytitle><command>dpkg-scansources</command></refentrytitle>\n"
  292. " <manvolnum>8</manvolnum>\n"
  293. " </citerefentry>\"\n"
  294. ">\n"
  295. msgstr ""
  296. #. type: Plain text
  297. #: apt.ent:114
  298. #, no-wrap
  299. msgid ""
  300. "<!ENTITY dselect \"<citerefentry>\n"
  301. " <refentrytitle><command>dselect</command></refentrytitle>\n"
  302. " <manvolnum>8</manvolnum>\n"
  303. " </citerefentry>\"\n"
  304. ">\n"
  305. msgstr ""
  306. #. type: Plain text
  307. #: apt.ent:120
  308. #, no-wrap
  309. msgid ""
  310. "<!ENTITY aptitude \"<citerefentry>\n"
  311. " <refentrytitle><command>aptitude</command></refentrytitle>\n"
  312. " <manvolnum>8</manvolnum>\n"
  313. " </citerefentry>\"\n"
  314. ">\n"
  315. msgstr ""
  316. #. type: Plain text
  317. #: apt.ent:126
  318. #, no-wrap
  319. msgid ""
  320. "<!ENTITY synaptic \"<citerefentry>\n"
  321. " <refentrytitle><command>synaptic</command></refentrytitle>\n"
  322. " <manvolnum>8</manvolnum>\n"
  323. " </citerefentry>\"\n"
  324. ">\n"
  325. msgstr ""
  326. #. type: Plain text
  327. #: apt.ent:132
  328. #, no-wrap
  329. msgid ""
  330. "<!ENTITY debsign \"<citerefentry>\n"
  331. " <refentrytitle><command>debsign</command></refentrytitle>\n"
  332. " <manvolnum>1</manvolnum>\n"
  333. " </citerefentry>\"\n"
  334. ">\n"
  335. msgstr ""
  336. #. type: Plain text
  337. #: apt.ent:138
  338. #, no-wrap
  339. msgid ""
  340. "<!ENTITY debsig-verify \"<citerefentry>\n"
  341. " <refentrytitle><command>debsig-verify</command></refentrytitle>\n"
  342. " <manvolnum>1</manvolnum>\n"
  343. " </citerefentry>\"\n"
  344. ">\n"
  345. msgstr ""
  346. #. type: Plain text
  347. #: apt.ent:144
  348. #, no-wrap
  349. msgid ""
  350. "<!ENTITY gpg \"<citerefentry>\n"
  351. " <refentrytitle><command>gpg</command></refentrytitle>\n"
  352. " <manvolnum>1</manvolnum>\n"
  353. " </citerefentry>\"\n"
  354. ">\n"
  355. msgstr ""
  356. #. type: Plain text
  357. #: apt.ent:150
  358. #, no-wrap
  359. msgid ""
  360. "<!ENTITY gnome-apt \"<citerefentry>\n"
  361. " <refentrytitle><command>gnome-apt</command></refentrytitle>\n"
  362. " <manvolnum>1</manvolnum>\n"
  363. " </citerefentry>\"\n"
  364. ">\n"
  365. msgstr ""
  366. #. type: Plain text
  367. #: apt.ent:156
  368. #, no-wrap
  369. msgid ""
  370. "<!ENTITY wajig \"<citerefentry>\n"
  371. " <refentrytitle><command>wajig</command></refentrytitle>\n"
  372. " <manvolnum>1</manvolnum>\n"
  373. " </citerefentry>\"\n"
  374. ">\n"
  375. msgstr ""
  376. #. type: Plain text
  377. #: apt.ent:168
  378. #, no-wrap
  379. msgid ""
  380. "<!-- Boiler plate docinfo section -->\n"
  381. "<!ENTITY apt-docinfo \"\n"
  382. " <refentryinfo>\n"
  383. " <address><email>apt@packages.debian.org</email></address>\n"
  384. " <author>\n"
  385. " <firstname>Jason</firstname> <surname>Gunthorpe</surname>\n"
  386. " <contrib></contrib>\n"
  387. " </author>\n"
  388. " <copyright><year>1998-2001</year> <holder>Jason "
  389. "Gunthorpe</holder></copyright>\n"
  390. " <date>28 October 2008</date>\n"
  391. " <productname>Linux</productname>\n"
  392. msgstr ""
  393. #. type: Plain text
  394. #: apt.ent:171
  395. #, no-wrap
  396. msgid ""
  397. " </refentryinfo>\n"
  398. "\"> \n"
  399. msgstr ""
  400. #. type: Plain text
  401. #: apt.ent:177
  402. #, no-wrap
  403. msgid ""
  404. "<!ENTITY apt-email \"\n"
  405. " <address>\n"
  406. " <email>apt@packages.debian.org</email>\n"
  407. " </address>\n"
  408. "\">\n"
  409. msgstr ""
  410. #. type: Plain text
  411. #: apt.ent:185
  412. #, no-wrap
  413. msgid ""
  414. "<!ENTITY apt-author.jgunthorpe \"\n"
  415. " <author>\n"
  416. " <firstname>Jason</firstname>\n"
  417. " <surname>Gunthorpe</surname>\n"
  418. " <contrib></contrib>\n"
  419. " </author>\n"
  420. "\">\n"
  421. msgstr ""
  422. #. type: Plain text
  423. #: apt.ent:193
  424. #, no-wrap
  425. msgid ""
  426. "<!ENTITY apt-author.moconnor \"\n"
  427. " <author>\n"
  428. " <firstname>Mike</firstname>\n"
  429. " <surname>O'Connor</surname>\n"
  430. " <contrib></contrib>\n"
  431. " </author>\n"
  432. "\">\n"
  433. msgstr ""
  434. #. type: Plain text
  435. #: apt.ent:200
  436. #, no-wrap
  437. msgid ""
  438. "<!ENTITY apt-author.team \"\n"
  439. " <author>\n"
  440. " <othername>APT team</othername>\n"
  441. " <contrib></contrib>\n"
  442. " </author>\n"
  443. "\">\n"
  444. msgstr ""
  445. #. type: Plain text
  446. #: apt.ent:204 apt.ent:215
  447. #, no-wrap
  448. msgid ""
  449. "<!ENTITY apt-product \"\n"
  450. " <productname>Linux</productname>\n"
  451. "\">\n"
  452. msgstr ""
  453. #. type: Plain text
  454. #: apt.ent:211
  455. #, no-wrap
  456. msgid ""
  457. "<!ENTITY apt-copyright \"\n"
  458. " <copyright>\n"
  459. " <holder>Jason Gunthorpe</holder>\n"
  460. " <year>1998-2001</year>\n"
  461. " </copyright>\n"
  462. "\">\n"
  463. msgstr ""
  464. #. type: Plain text
  465. #: apt.ent:221
  466. #, no-wrap
  467. msgid ""
  468. "<!ENTITY apt-qapage \"\n"
  469. "\t<para>\n"
  470. "\t\t<ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>\n"
  471. "\t</para>\n"
  472. "\">\n"
  473. msgstr ""
  474. #. type: Plain text
  475. #: apt.ent:232
  476. #, no-wrap
  477. msgid ""
  478. "<!-- Boiler plate Bug reporting section -->\n"
  479. "<!ENTITY manbugs \"\n"
  480. " <refsect1><title>Bugs</title>\n"
  481. " <para><ulink url='http://bugs.debian.org/src:apt'>APT bug "
  482. "page</ulink>. \n"
  483. " If you wish to report a bug in APT, please see\n"
  484. " <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the\n"
  485. " &reportbug; command.\n"
  486. " </para>\n"
  487. " </refsect1>\n"
  488. "\">\n"
  489. msgstr ""
  490. #. type: Plain text
  491. #: apt.ent:240
  492. #, no-wrap
  493. msgid ""
  494. "<!-- Boiler plate Author section -->\n"
  495. "<!ENTITY manauthor \"\n"
  496. " <refsect1><title>Author</title>\n"
  497. " <para>APT was written by the APT team "
  498. "<email>apt@packages.debian.org</email>.\n"
  499. " </para>\n"
  500. " </refsect1>\n"
  501. "\">\n"
  502. msgstr ""
  503. #. type: Plain text
  504. #: apt.ent:250
  505. #, no-wrap
  506. msgid ""
  507. "<!-- Should be used within the option section of the text to\n"
  508. " put in the blurb about -h, -v, -c and -o -->\n"
  509. "<!ENTITY apt-commonoptions \"\n"
  510. " <varlistentry><term><option>-h</option></term>\n"
  511. " <term><option>--help</option></term>\n"
  512. " <listitem><para>Show a short usage summary.\n"
  513. " </para>\n"
  514. " </listitem>\n"
  515. " </varlistentry>\n"
  516. msgstr ""
  517. #. type: Plain text
  518. #: apt.ent:258
  519. #, no-wrap
  520. msgid ""
  521. " <varlistentry>\n"
  522. " <term><option>-v</option></term>\n"
  523. " <term><option>--version</option></term>\n"
  524. " <listitem><para>Show the program version.\n"
  525. " </para>\n"
  526. " </listitem>\n"
  527. " </varlistentry>\n"
  528. msgstr ""
  529. #. type: Plain text
  530. #: apt.ent:268
  531. #, no-wrap
  532. msgid ""
  533. " <varlistentry>\n"
  534. " <term><option>-c</option></term>\n"
  535. " <term><option>--config-file</option></term>\n"
  536. " <listitem><para>Configuration File; Specify a configuration file to "
  537. "use. \n"
  538. " The program will read the default configuration file and then this \n"
  539. " configuration file. See &apt-conf; for syntax information. \n"
  540. " </para>\n"
  541. " </listitem>\n"
  542. " </varlistentry>\n"
  543. msgstr ""
  544. #. type: Plain text
  545. #: apt.ent:280
  546. #, no-wrap
  547. msgid ""
  548. " <varlistentry>\n"
  549. " <term><option>-o</option></term>\n"
  550. " <term><option>--option</option></term>\n"
  551. " <listitem><para>Set a Configuration Option; This will set an "
  552. "arbitrary\n"
  553. " configuration option. The syntax is <option>-o "
  554. "Foo::Bar=bar</option>.\n"
  555. " <option>-o</option> and <option>--option</option> can be used "
  556. "multiple\n"
  557. " times to set different options.\n"
  558. " </para>\n"
  559. " </listitem>\n"
  560. " </varlistentry>\n"
  561. "\">\n"
  562. msgstr ""
  563. #. type: Plain text
  564. #: apt.ent:291
  565. #, no-wrap
  566. msgid ""
  567. "<!-- Should be used within the option section of the text to\n"
  568. " put in the blurb about -h, -v, -c and -o -->\n"
  569. "<!ENTITY apt-cmdblurb \"\n"
  570. " <para>All command line options may be set using the configuration file, "
  571. "the\n"
  572. " descriptions indicate the configuration option to set. For boolean\n"
  573. " options you can override the config file by using something like \n"
  574. " <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>\n"
  575. " or several other variations.\n"
  576. " </para>\n"
  577. "\">\n"
  578. msgstr ""
  579. #. type: Plain text
  580. #: apt.ent:297
  581. #, no-wrap
  582. msgid ""
  583. "<!ENTITY file-aptconf \"\n"
  584. " <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>\n"
  585. " <listitem><para>APT configuration file.\n"
  586. " Configuration Item: "
  587. "<literal>Dir::Etc::Main</literal>.</para></listitem>\n"
  588. " </varlistentry>\n"
  589. msgstr ""
  590. #. type: Plain text
  591. #: apt.ent:303
  592. #, no-wrap
  593. msgid ""
  594. " <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>\n"
  595. " <listitem><para>APT configuration file fragments.\n"
  596. " Configuration Item: "
  597. "<literal>Dir::Etc::Parts</literal>.</para></listitem>\n"
  598. " </varlistentry>\n"
  599. "\">\n"
  600. msgstr ""
  601. #. type: Plain text
  602. #: apt.ent:309
  603. #, no-wrap
  604. msgid ""
  605. "<!ENTITY file-cachearchives \"\n"
  606. " <varlistentry><term><filename>&cachedir;/archives/</filename></term>\n"
  607. " <listitem><para>Storage area for retrieved package files.\n"
  608. " Configuration Item: "
  609. "<literal>Dir::Cache::Archives</literal>.</para></listitem>\n"
  610. " </varlistentry>\n"
  611. msgstr ""
  612. #. type: Plain text
  613. #: apt.ent:315
  614. #, no-wrap
  615. msgid ""
  616. " "
  617. "<varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>\n"
  618. " <listitem><para>Storage area for package files in transit.\n"
  619. " Configuration Item: <literal>Dir::Cache::Archives</literal> (implicit "
  620. "partial). </para></listitem>\n"
  621. " </varlistentry>\n"
  622. "\">\n"
  623. msgstr ""
  624. #. type: Plain text
  625. #: apt.ent:325
  626. #, no-wrap
  627. msgid ""
  628. "<!ENTITY file-preferences \"\n"
  629. " <varlistentry><term><filename>/etc/apt/preferences</filename></term>\n"
  630. " <listitem><para>Version preferences file.\n"
  631. " This is where you would specify &quot;pinning&quot;,\n"
  632. " i.e. a preference to get certain packages\n"
  633. " from a separate source\n"
  634. " or from a different version of a distribution.\n"
  635. " Configuration Item: "
  636. "<literal>Dir::Etc::Preferences</literal>.</para></listitem>\n"
  637. " </varlistentry>\n"
  638. msgstr ""
  639. #. type: Plain text
  640. #: apt.ent:331
  641. #, no-wrap
  642. msgid ""
  643. " "
  644. "<varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>\n"
  645. " <listitem><para>File fragments for the version preferences.\n"
  646. " Configuration Item: "
  647. "<literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>\n"
  648. " </varlistentry>\n"
  649. "\">\n"
  650. msgstr ""
  651. #. type: Plain text
  652. #: apt.ent:337
  653. #, no-wrap
  654. msgid ""
  655. "<!ENTITY file-sourceslist \"\n"
  656. " <varlistentry><term><filename>/etc/apt/sources.list</filename></term>\n"
  657. " <listitem><para>Locations to fetch packages from.\n"
  658. " Configuration Item: "
  659. "<literal>Dir::Etc::SourceList</literal>.</para></listitem>\n"
  660. " </varlistentry>\n"
  661. msgstr ""
  662. #. type: Plain text
  663. #: apt.ent:343
  664. #, no-wrap
  665. msgid ""
  666. " "
  667. "<varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>\n"
  668. " <listitem><para>File fragments for locations to fetch packages from.\n"
  669. " Configuration Item: "
  670. "<literal>Dir::Etc::SourceParts</literal>.</para></listitem>\n"
  671. " </varlistentry>\n"
  672. "\">\n"
  673. msgstr ""
  674. #. type: Plain text
  675. #: apt.ent:350
  676. #, no-wrap
  677. msgid ""
  678. "<!ENTITY file-statelists \"\n"
  679. " <varlistentry><term><filename>&statedir;/lists/</filename></term>\n"
  680. " <listitem><para>Storage area for state information for each package "
  681. "resource specified in\n"
  682. " &sources-list;\n"
  683. " Configuration Item: "
  684. "<literal>Dir::State::Lists</literal>.</para></listitem>\n"
  685. " </varlistentry>\n"
  686. msgstr ""
  687. #. type: Plain text
  688. #: apt.ent:355
  689. #, no-wrap
  690. msgid ""
  691. " "
  692. "<varlistentry><term><filename>&statedir;/lists/partial/</filename></term>\n"
  693. " <listitem><para>Storage area for state information in transit.\n"
  694. " Configuration Item: <literal>Dir::State::Lists</literal> (implicit "
  695. "partial).</para></listitem>\n"
  696. " </varlistentry>\n"
  697. "\">\n"
  698. msgstr ""
  699. #. The last update date
  700. #. type: Content of: <refentry><refentryinfo>
  701. #: apt-cache.8.xml:13 apt-config.8.xml:13 apt-extracttemplates.1.xml:13 apt-ftparchive.1.xml:13 apt-sortpkgs.1.xml:13 sources.list.5.xml:13
  702. msgid ""
  703. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>29 "
  704. "February 2004</date>"
  705. msgstr ""
  706. #. type: Content of: <refentry><refnamediv><refname>
  707. #: apt-cache.8.xml:22 apt-cache.8.xml:29
  708. msgid "apt-cache"
  709. msgstr ""
  710. #. type: Content of: <refentry><refmeta><manvolnum>
  711. #: apt-cache.8.xml:23 apt-cdrom.8.xml:22 apt-config.8.xml:23 apt-get.8.xml:23 apt-key.8.xml:15 apt-mark.8.xml:23 apt-secure.8.xml:15
  712. msgid "8"
  713. msgstr ""
  714. #. type: Content of: <refentry><refmeta><refmiscinfo>
  715. #: apt-cache.8.xml:24 apt-cdrom.8.xml:23 apt-config.8.xml:24 apt-extracttemplates.1.xml:24 apt-ftparchive.1.xml:24 apt-get.8.xml:24 apt-key.8.xml:16 apt-mark.8.xml:24 apt-secure.8.xml:16 apt-sortpkgs.1.xml:24 apt.conf.5.xml:30 apt_preferences.5.xml:23 sources.list.5.xml:24
  716. msgid "APT"
  717. msgstr ""
  718. #. type: Content of: <refentry><refnamediv><refpurpose>
  719. #: apt-cache.8.xml:30
  720. msgid "APT package handling utility -- cache manipulator"
  721. msgstr ""
  722. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  723. #: apt-cache.8.xml:36
  724. msgid ""
  725. "<command>apt-cache</command> <arg><option>-hvsn</option></arg> "
  726. "<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
  727. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
  728. "choice=\"req\"> <arg>add <arg choice=\"plain\" "
  729. "rep=\"repeat\"><replaceable>file</replaceable></arg></arg> "
  730. "<arg>gencaches</arg> <arg>showpkg <arg choice=\"plain\" "
  731. "rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>showsrc <arg "
  732. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  733. "<arg>stats</arg> <arg>dump</arg> <arg>dumpavail</arg> <arg>unmet</arg> "
  734. "<arg>search <arg "
  735. "choice=\"plain\"><replaceable>regex</replaceable></arg></arg> <arg>show <arg "
  736. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  737. "<arg>depends <arg choice=\"plain\" "
  738. "rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>rdepends <arg "
  739. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  740. "<arg>pkgnames <arg "
  741. "choice=\"plain\"><replaceable>prefix</replaceable></arg></arg> <arg>dotty "
  742. "<arg choice=\"plain\" "
  743. "rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg>xvcg <arg "
  744. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  745. "<arg>policy <arg choice=\"plain\" "
  746. "rep=\"repeat\"><replaceable>pkgs</replaceable></arg></arg> <arg>madison <arg "
  747. "choice=\"plain\" rep=\"repeat\"><replaceable>pkgs</replaceable></arg></arg> "
  748. "</group>"
  749. msgstr ""
  750. #. type: Content of: <refentry><refsect1><title>
  751. #: apt-cache.8.xml:62 apt-cdrom.8.xml:47 apt-config.8.xml:47 apt-extracttemplates.1.xml:43 apt-ftparchive.1.xml:55 apt-get.8.xml:125 apt-key.8.xml:34 apt-mark.8.xml:52 apt-secure.8.xml:40 apt-sortpkgs.1.xml:44 apt.conf.5.xml:39 apt_preferences.5.xml:33 sources.list.5.xml:33
  752. msgid "Description"
  753. msgstr ""
  754. #. type: Content of: <refentry><refsect1><para>
  755. #: apt-cache.8.xml:63
  756. msgid ""
  757. "<command>apt-cache</command> performs a variety of operations on APT's "
  758. "package cache. <command>apt-cache</command> does not manipulate the state of "
  759. "the system but does provide operations to search and generate interesting "
  760. "output from the package metadata."
  761. msgstr ""
  762. #. type: Content of: <refentry><refsect1><para>
  763. #: apt-cache.8.xml:68 apt-get.8.xml:131
  764. msgid ""
  765. "Unless the <option>-h</option>, or <option>--help</option> option is given, "
  766. "one of the commands below must be present."
  767. msgstr ""
  768. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  769. #: apt-cache.8.xml:72
  770. msgid "add <replaceable>file(s)</replaceable>"
  771. msgstr ""
  772. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  773. #: apt-cache.8.xml:73
  774. msgid ""
  775. "<literal>add</literal> adds the named package index files to the package "
  776. "cache. This is for debugging only."
  777. msgstr ""
  778. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  779. #: apt-cache.8.xml:77
  780. msgid "gencaches"
  781. msgstr ""
  782. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  783. #: apt-cache.8.xml:78
  784. msgid ""
  785. "<literal>gencaches</literal> performs the same operation as <command>apt-get "
  786. "check</command>. It builds the source and package caches from the sources in "
  787. "&sources-list; and from <filename>/var/lib/dpkg/status</filename>."
  788. msgstr ""
  789. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  790. #: apt-cache.8.xml:84
  791. msgid "showpkg <replaceable>pkg(s)</replaceable>"
  792. msgstr ""
  793. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  794. #: apt-cache.8.xml:85
  795. msgid ""
  796. "<literal>showpkg</literal> displays information about the packages listed on "
  797. "the command line. Remaining arguments are package names. The available "
  798. "versions and reverse dependencies of each package listed are listed, as well "
  799. "as forward dependencies for each version. Forward (normal) dependencies are "
  800. "those packages upon which the package in question depends; reverse "
  801. "dependencies are those packages that depend upon the package in "
  802. "question. Thus, forward dependencies must be satisfied for a package, but "
  803. "reverse dependencies need not be. For instance, <command>apt-cache showpkg "
  804. "libreadline2</command> would produce output similar to the following:"
  805. msgstr ""
  806. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
  807. #: apt-cache.8.xml:97
  808. #, no-wrap
  809. msgid ""
  810. "Package: libreadline2\n"
  811. "Versions: 2.1-12(/var/state/apt/lists/foo_Packages),\n"
  812. "Reverse Depends: \n"
  813. " libreadlineg2,libreadline2\n"
  814. " libreadline2-altdev,libreadline2\n"
  815. "Dependencies:\n"
  816. "2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))\n"
  817. "Provides:\n"
  818. "2.1-12 - \n"
  819. "Reverse Provides: \n"
  820. msgstr ""
  821. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  822. #: apt-cache.8.xml:109
  823. msgid ""
  824. "Thus it may be seen that libreadline2, version 2.1-12, depends on libc5 and "
  825. "ncurses3.0 which must be installed for libreadline2 to work. In turn, "
  826. "libreadlineg2 and libreadline2-altdev depend on libreadline2. If "
  827. "libreadline2 is installed, libc5 and ncurses3.0 (and ldso) must also be "
  828. "installed; libreadlineg2 and libreadline2-altdev do not have to be "
  829. "installed. For the specific meaning of the remainder of the output it is "
  830. "best to consult the apt source code."
  831. msgstr ""
  832. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  833. #: apt-cache.8.xml:118
  834. msgid "stats"
  835. msgstr ""
  836. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  837. #: apt-cache.8.xml:118
  838. msgid ""
  839. "<literal>stats</literal> displays some statistics about the cache. No "
  840. "further arguments are expected. Statistics reported are:"
  841. msgstr ""
  842. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  843. #: apt-cache.8.xml:121
  844. msgid ""
  845. "<literal>Total package names</literal> is the number of package names found "
  846. "in the cache."
  847. msgstr ""
  848. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  849. #: apt-cache.8.xml:125
  850. msgid ""
  851. "<literal>Normal packages</literal> is the number of regular, ordinary "
  852. "package names; these are packages that bear a one-to-one correspondence "
  853. "between their names and the names used by other packages for them in "
  854. "dependencies. The majority of packages fall into this category."
  855. msgstr ""
  856. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  857. #: apt-cache.8.xml:131
  858. msgid ""
  859. "<literal>Pure virtual packages</literal> is the number of packages that "
  860. "exist only as a virtual package name; that is, packages only \"provide\" the "
  861. "virtual package name, and no package actually uses the name. For instance, "
  862. "\"mail-transport-agent\" in the Debian GNU/Linux system is a pure virtual "
  863. "package; several packages provide \"mail-transport-agent\", but there is no "
  864. "package named \"mail-transport-agent\"."
  865. msgstr ""
  866. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  867. #: apt-cache.8.xml:139
  868. msgid ""
  869. "<literal>Single virtual packages</literal> is the number of packages with "
  870. "only one package providing a particular virtual package. For example, in the "
  871. "Debian GNU/Linux system, \"X11-text-viewer\" is a virtual package, but only "
  872. "one package, xless, provides \"X11-text-viewer\"."
  873. msgstr ""
  874. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  875. #: apt-cache.8.xml:145
  876. msgid ""
  877. "<literal>Mixed virtual packages</literal> is the number of packages that "
  878. "either provide a particular virtual package or have the virtual package name "
  879. "as the package name. For instance, in the Debian GNU/Linux system, "
  880. "\"debconf\" is both an actual package, and provided by the debconf-tiny "
  881. "package."
  882. msgstr ""
  883. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  884. #: apt-cache.8.xml:152
  885. msgid ""
  886. "<literal>Missing</literal> is the number of package names that were "
  887. "referenced in a dependency but were not provided by any package. Missing "
  888. "packages may be in evidence if a full distribution is not accessed, or if a "
  889. "package (real or virtual) has been dropped from the distribution. Usually "
  890. "they are referenced from Conflicts or Breaks statements."
  891. msgstr ""
  892. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  893. #: apt-cache.8.xml:159
  894. msgid ""
  895. "<literal>Total distinct</literal> versions is the number of package versions "
  896. "found in the cache; this value is therefore at least equal to the number of "
  897. "total package names. If more than one distribution (both \"stable\" and "
  898. "\"unstable\", for instance), is being accessed, this value can be "
  899. "considerably larger than the number of total package names."
  900. msgstr ""
  901. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para><itemizedlist><listitem><para>
  902. #: apt-cache.8.xml:166
  903. msgid ""
  904. "<literal>Total dependencies</literal> is the number of dependency "
  905. "relationships claimed by all of the packages in the cache."
  906. msgstr ""
  907. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  908. #: apt-cache.8.xml:173
  909. msgid "showsrc <replaceable>pkg(s)</replaceable>"
  910. msgstr ""
  911. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  912. #: apt-cache.8.xml:174
  913. msgid ""
  914. "<literal>showsrc</literal> displays all the source package records that "
  915. "match the given package names. All versions are shown, as well as all "
  916. "records that declare the name to be a Binary."
  917. msgstr ""
  918. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  919. #: apt-cache.8.xml:179 apt-config.8.xml:84
  920. msgid "dump"
  921. msgstr ""
  922. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  923. #: apt-cache.8.xml:180
  924. msgid ""
  925. "<literal>dump</literal> shows a short listing of every package in the "
  926. "cache. It is primarily for debugging."
  927. msgstr ""
  928. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  929. #: apt-cache.8.xml:184
  930. msgid "dumpavail"
  931. msgstr ""
  932. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  933. #: apt-cache.8.xml:185
  934. msgid ""
  935. "<literal>dumpavail</literal> prints out an available list to stdout. This is "
  936. "suitable for use with &dpkg; and is used by the &dselect; method."
  937. msgstr ""
  938. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  939. #: apt-cache.8.xml:189
  940. msgid "unmet"
  941. msgstr ""
  942. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  943. #: apt-cache.8.xml:190
  944. msgid ""
  945. "<literal>unmet</literal> displays a summary of all unmet dependencies in the "
  946. "package cache."
  947. msgstr ""
  948. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  949. #: apt-cache.8.xml:194
  950. msgid "show <replaceable>pkg(s)</replaceable>"
  951. msgstr ""
  952. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  953. #: apt-cache.8.xml:195
  954. msgid ""
  955. "<literal>show</literal> performs a function similar to <command>dpkg "
  956. "--print-avail</command>; it displays the package records for the named "
  957. "packages."
  958. msgstr ""
  959. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  960. #: apt-cache.8.xml:200
  961. msgid "search <replaceable>regex [ regex ... ]</replaceable>"
  962. msgstr ""
  963. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  964. #: apt-cache.8.xml:201
  965. msgid ""
  966. "<literal>search</literal> performs a full text search on all available "
  967. "package lists for the POSIX regex pattern given, see "
  968. "<citerefentry><refentrytitle><command>regex</command></refentrytitle> "
  969. "<manvolnum>7</manvolnum></citerefentry>. It searches the package names and "
  970. "the descriptions for an occurrence of the regular expression and prints out "
  971. "the package name and the short description, including virtual package "
  972. "names. If <option>--full</option> is given then output identical to "
  973. "<literal>show</literal> is produced for each matched package, and if "
  974. "<option>--names-only</option> is given then the long description is not "
  975. "searched, only the package name is."
  976. msgstr ""
  977. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  978. #: apt-cache.8.xml:214
  979. msgid ""
  980. "Separate arguments can be used to specify multiple search patterns that are "
  981. "and'ed together."
  982. msgstr ""
  983. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  984. #: apt-cache.8.xml:218
  985. msgid "depends <replaceable>pkg(s)</replaceable>"
  986. msgstr ""
  987. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  988. #: apt-cache.8.xml:219
  989. msgid ""
  990. "<literal>depends</literal> shows a listing of each dependency a package has "
  991. "and all the possible other packages that can fulfill that dependency."
  992. msgstr ""
  993. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  994. #: apt-cache.8.xml:223
  995. msgid "rdepends <replaceable>pkg(s)</replaceable>"
  996. msgstr ""
  997. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  998. #: apt-cache.8.xml:224
  999. msgid ""
  1000. "<literal>rdepends</literal> shows a listing of each reverse dependency a "
  1001. "package has."
  1002. msgstr ""
  1003. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1004. #: apt-cache.8.xml:228
  1005. msgid "pkgnames <replaceable>[ prefix ]</replaceable>"
  1006. msgstr ""
  1007. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1008. #: apt-cache.8.xml:229
  1009. msgid ""
  1010. "This command prints the name of each package APT knows. The optional "
  1011. "argument is a prefix match to filter the name list. The output is suitable "
  1012. "for use in a shell tab complete function and the output is generated "
  1013. "extremely quickly. This command is best used with the "
  1014. "<option>--generate</option> option."
  1015. msgstr ""
  1016. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1017. #: apt-cache.8.xml:234
  1018. msgid ""
  1019. "Note that a package which APT knows of is not nessasarily available to "
  1020. "download, installable or installed, e.g. virtual packages are also listed in "
  1021. "the generated list."
  1022. msgstr ""
  1023. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1024. #: apt-cache.8.xml:239
  1025. msgid "dotty <replaceable>pkg(s)</replaceable>"
  1026. msgstr ""
  1027. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1028. #: apt-cache.8.xml:240
  1029. msgid ""
  1030. "<literal>dotty</literal> takes a list of packages on the command line and "
  1031. "generates output suitable for use by dotty from the <ulink "
  1032. "url=\"http://www.research.att.com/sw/tools/graphviz/\">GraphViz</ulink> "
  1033. "package. The result will be a set of nodes and edges representing the "
  1034. "relationships between the packages. By default the given packages will trace "
  1035. "out all dependent packages; this can produce a very large graph. To limit "
  1036. "the output to only the packages listed on the command line, set the "
  1037. "<literal>APT::Cache::GivenOnly</literal> option."
  1038. msgstr ""
  1039. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1040. #: apt-cache.8.xml:249
  1041. msgid ""
  1042. "The resulting nodes will have several shapes; normal packages are boxes, "
  1043. "pure provides are triangles, mixed provides are diamonds, missing packages "
  1044. "are hexagons. Orange boxes mean recursion was stopped [leaf packages], blue "
  1045. "lines are pre-depends, green lines are conflicts."
  1046. msgstr ""
  1047. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1048. #: apt-cache.8.xml:254
  1049. msgid "Caution, dotty cannot graph larger sets of packages."
  1050. msgstr ""
  1051. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1052. #: apt-cache.8.xml:257
  1053. msgid "xvcg <replaceable>pkg(s)</replaceable>"
  1054. msgstr ""
  1055. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1056. #: apt-cache.8.xml:258
  1057. msgid ""
  1058. "The same as <literal>dotty</literal>, only for xvcg from the <ulink "
  1059. "url=\"http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html\">VCG "
  1060. "tool</ulink>."
  1061. msgstr ""
  1062. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1063. #: apt-cache.8.xml:262
  1064. msgid "policy <replaceable>[ pkg(s) ]</replaceable>"
  1065. msgstr ""
  1066. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1067. #: apt-cache.8.xml:263
  1068. msgid ""
  1069. "<literal>policy</literal> is meant to help debug issues relating to the "
  1070. "preferences file. With no arguments it will print out the priorities of each "
  1071. "source. Otherwise it prints out detailed information about the priority "
  1072. "selection of the named package."
  1073. msgstr ""
  1074. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1075. #: apt-cache.8.xml:269
  1076. msgid "madison <replaceable>/[ pkg(s) ]</replaceable>"
  1077. msgstr ""
  1078. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1079. #: apt-cache.8.xml:270
  1080. msgid ""
  1081. "<literal>apt-cache</literal>'s <literal>madison</literal> command attempts "
  1082. "to mimic the output format and a subset of the functionality of the Debian "
  1083. "archive management tool, <literal>madison</literal>. It displays available "
  1084. "versions of a package in a tabular format. Unlike the original "
  1085. "<literal>madison</literal>, it can only display information for the "
  1086. "architecture for which APT has retrieved package lists "
  1087. "(<literal>APT::Architecture</literal>)."
  1088. msgstr ""
  1089. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1090. #: apt-cache.8.xml:281 apt-config.8.xml:93 apt-extracttemplates.1.xml:56 apt-ftparchive.1.xml:492 apt-get.8.xml:319 apt-mark.8.xml:89 apt-sortpkgs.1.xml:54 apt.conf.5.xml:436 apt.conf.5.xml:458
  1091. msgid "options"
  1092. msgstr ""
  1093. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1094. #: apt-cache.8.xml:285
  1095. msgid "<option>-p</option>"
  1096. msgstr ""
  1097. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1098. #: apt-cache.8.xml:285
  1099. msgid "<option>--pkg-cache</option>"
  1100. msgstr ""
  1101. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1102. #: apt-cache.8.xml:286
  1103. msgid ""
  1104. "Select the file to store the package cache. The package cache is the primary "
  1105. "cache used by all operations. Configuration Item: "
  1106. "<literal>Dir::Cache::pkgcache</literal>."
  1107. msgstr ""
  1108. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1109. #: apt-cache.8.xml:291 apt-ftparchive.1.xml:535 apt-get.8.xml:376 apt-sortpkgs.1.xml:58
  1110. msgid "<option>-s</option>"
  1111. msgstr ""
  1112. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1113. #: apt-cache.8.xml:291
  1114. msgid "<option>--src-cache</option>"
  1115. msgstr ""
  1116. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1117. #: apt-cache.8.xml:292
  1118. msgid ""
  1119. "Select the file to store the source cache. The source is used only by "
  1120. "<literal>gencaches</literal> and it stores a parsed version of the package "
  1121. "information from remote sources. When building the package cache the source "
  1122. "cache is used to avoid reparsing all of the package files. Configuration "
  1123. "Item: <literal>Dir::Cache::srcpkgcache</literal>."
  1124. msgstr ""
  1125. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1126. #: apt-cache.8.xml:299 apt-ftparchive.1.xml:509 apt-get.8.xml:366
  1127. msgid "<option>-q</option>"
  1128. msgstr ""
  1129. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1130. #: apt-cache.8.xml:299 apt-ftparchive.1.xml:509 apt-get.8.xml:366
  1131. msgid "<option>--quiet</option>"
  1132. msgstr ""
  1133. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1134. #: apt-cache.8.xml:300
  1135. msgid ""
  1136. "Quiet; produces output suitable for logging, omitting progress indicators. "
  1137. "More q's will produce more quietness up to a maximum of 2. You can also use "
  1138. "<option>-q=#</option> to set the quietness level, overriding the "
  1139. "configuration file. Configuration Item: <literal>quiet</literal>."
  1140. msgstr ""
  1141. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1142. #: apt-cache.8.xml:306
  1143. msgid "<option>-i</option>"
  1144. msgstr ""
  1145. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1146. #: apt-cache.8.xml:306
  1147. msgid "<option>--important</option>"
  1148. msgstr ""
  1149. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1150. #: apt-cache.8.xml:307
  1151. msgid ""
  1152. "Print only important dependencies; for use with unmet and depends. Causes "
  1153. "only Depends and Pre-Depends relations to be printed. Configuration Item: "
  1154. "<literal>APT::Cache::Important</literal>."
  1155. msgstr ""
  1156. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1157. #: apt-cache.8.xml:312 apt-cdrom.8.xml:121 apt-get.8.xml:333
  1158. msgid "<option>-f</option>"
  1159. msgstr ""
  1160. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1161. #: apt-cache.8.xml:312
  1162. msgid "<option>--full</option>"
  1163. msgstr ""
  1164. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1165. #: apt-cache.8.xml:313
  1166. msgid ""
  1167. "Print full package records when searching. Configuration Item: "
  1168. "<literal>APT::Cache::ShowFull</literal>."
  1169. msgstr ""
  1170. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1171. #: apt-cache.8.xml:317 apt-cdrom.8.xml:131
  1172. msgid "<option>-a</option>"
  1173. msgstr ""
  1174. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1175. #: apt-cache.8.xml:317
  1176. msgid "<option>--all-versions</option>"
  1177. msgstr ""
  1178. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1179. #: apt-cache.8.xml:318
  1180. msgid ""
  1181. "Print full records for all available versions. This is the default; to turn "
  1182. "it off, use <option>--no-all-versions</option>. If "
  1183. "<option>--no-all-versions</option> is specified, only the candidate version "
  1184. "will displayed (the one which would be selected for installation). This "
  1185. "option is only applicable to the <literal>show</literal> command. "
  1186. "Configuration Item: <literal>APT::Cache::AllVersions</literal>."
  1187. msgstr ""
  1188. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1189. #: apt-cache.8.xml:326
  1190. msgid "<option>-g</option>"
  1191. msgstr ""
  1192. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1193. #: apt-cache.8.xml:326
  1194. msgid "<option>--generate</option>"
  1195. msgstr ""
  1196. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1197. #: apt-cache.8.xml:327
  1198. msgid ""
  1199. "Perform automatic package cache regeneration, rather than use the cache as "
  1200. "it is. This is the default; to turn it off, use "
  1201. "<option>--no-generate</option>. Configuration Item: "
  1202. "<literal>APT::Cache::Generate</literal>."
  1203. msgstr ""
  1204. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1205. #: apt-cache.8.xml:332
  1206. msgid "<option>--names-only</option>"
  1207. msgstr ""
  1208. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1209. #: apt-cache.8.xml:332 apt-cdrom.8.xml:139
  1210. msgid "<option>-n</option>"
  1211. msgstr ""
  1212. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1213. #: apt-cache.8.xml:333
  1214. msgid ""
  1215. "Only search on the package names, not the long descriptions. Configuration "
  1216. "Item: <literal>APT::Cache::NamesOnly</literal>."
  1217. msgstr ""
  1218. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1219. #: apt-cache.8.xml:337
  1220. msgid "<option>--all-names</option>"
  1221. msgstr ""
  1222. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1223. #: apt-cache.8.xml:338
  1224. msgid ""
  1225. "Make <literal>pkgnames</literal> print all names, including virtual packages "
  1226. "and missing dependencies. Configuration Item: "
  1227. "<literal>APT::Cache::AllNames</literal>."
  1228. msgstr ""
  1229. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1230. #: apt-cache.8.xml:343
  1231. msgid "<option>--recurse</option>"
  1232. msgstr ""
  1233. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1234. #: apt-cache.8.xml:344
  1235. msgid ""
  1236. "Make <literal>depends</literal> and <literal>rdepends</literal> recursive so "
  1237. "that all packages mentioned are printed once. Configuration Item: "
  1238. "<literal>APT::Cache::RecurseDepends</literal>."
  1239. msgstr ""
  1240. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1241. #: apt-cache.8.xml:349
  1242. msgid "<option>--installed</option>"
  1243. msgstr ""
  1244. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1245. #: apt-cache.8.xml:351
  1246. msgid ""
  1247. "Limit the output of <literal>depends</literal> and "
  1248. "<literal>rdepends</literal> to packages which are currently installed. "
  1249. "Configuration Item: <literal>APT::Cache::Installed</literal>."
  1250. msgstr ""
  1251. #. type: Content of: <refentry><refsect1><variablelist>
  1252. #: apt-cache.8.xml:356 apt-cdrom.8.xml:150 apt-config.8.xml:98 apt-extracttemplates.1.xml:67 apt-ftparchive.1.xml:547 apt-get.8.xml:554 apt-sortpkgs.1.xml:64
  1253. msgid "&apt-commonoptions;"
  1254. msgstr ""
  1255. #. type: Content of: <refentry><refsect1><title>
  1256. #: apt-cache.8.xml:361 apt-get.8.xml:559 apt-key.8.xml:138 apt-mark.8.xml:122 apt.conf.5.xml:968 apt_preferences.5.xml:615
  1257. msgid "Files"
  1258. msgstr ""
  1259. #. type: Content of: <refentry><refsect1><variablelist>
  1260. #: apt-cache.8.xml:363
  1261. msgid "&file-sourceslist; &file-statelists;"
  1262. msgstr ""
  1263. #. type: Content of: <refentry><refsect1><title>
  1264. #: apt-cache.8.xml:368 apt-cdrom.8.xml:155 apt-config.8.xml:103 apt-extracttemplates.1.xml:74 apt-ftparchive.1.xml:563 apt-get.8.xml:569 apt-key.8.xml:162 apt-mark.8.xml:133 apt-secure.8.xml:181 apt-sortpkgs.1.xml:69 apt.conf.5.xml:974 apt_preferences.5.xml:622 sources.list.5.xml:221
  1265. msgid "See Also"
  1266. msgstr ""
  1267. #. type: Content of: <refentry><refsect1><para>
  1268. #: apt-cache.8.xml:369
  1269. msgid "&apt-conf;, &sources-list;, &apt-get;"
  1270. msgstr ""
  1271. #. type: Content of: <refentry><refsect1><title>
  1272. #: apt-cache.8.xml:373 apt-cdrom.8.xml:160 apt-config.8.xml:108 apt-extracttemplates.1.xml:78 apt-ftparchive.1.xml:567 apt-get.8.xml:575 apt-mark.8.xml:137 apt-sortpkgs.1.xml:73
  1273. msgid "Diagnostics"
  1274. msgstr ""
  1275. #. type: Content of: <refentry><refsect1><para>
  1276. #: apt-cache.8.xml:374
  1277. msgid ""
  1278. "<command>apt-cache</command> returns zero on normal operation, decimal 100 "
  1279. "on error."
  1280. msgstr ""
  1281. #. type: Content of: <refentry><refentryinfo>
  1282. #: apt-cdrom.8.xml:13
  1283. msgid ""
  1284. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>14 "
  1285. "February 2004</date>"
  1286. msgstr ""
  1287. #. type: Content of: <refentry><refnamediv><refname>
  1288. #: apt-cdrom.8.xml:21 apt-cdrom.8.xml:28
  1289. msgid "apt-cdrom"
  1290. msgstr ""
  1291. #. type: Content of: <refentry><refnamediv><refpurpose>
  1292. #: apt-cdrom.8.xml:29
  1293. msgid "APT CDROM management utility"
  1294. msgstr ""
  1295. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1296. #: apt-cdrom.8.xml:35
  1297. msgid ""
  1298. "<command>apt-cdrom</command> <arg><option>-hvrmfan</option></arg> "
  1299. "<arg><option>-d=<replaceable>cdrom mount point</replaceable></option></arg> "
  1300. "<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
  1301. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <group> "
  1302. "<arg>add</arg> <arg>ident</arg> </group>"
  1303. msgstr ""
  1304. #. type: Content of: <refentry><refsect1><para>
  1305. #: apt-cdrom.8.xml:48
  1306. msgid ""
  1307. "<command>apt-cdrom</command> is used to add a new CDROM to APTs list of "
  1308. "available sources. <command>apt-cdrom</command> takes care of determining "
  1309. "the structure of the disc as well as correcting for several possible "
  1310. "mis-burns and verifying the index files."
  1311. msgstr ""
  1312. #. type: Content of: <refentry><refsect1><para>
  1313. #: apt-cdrom.8.xml:55
  1314. msgid ""
  1315. "It is necessary to use <command>apt-cdrom</command> to add CDs to the APT "
  1316. "system, it cannot be done by hand. Furthermore each disk in a multi-cd set "
  1317. "must be inserted and scanned separately to account for possible mis-burns."
  1318. msgstr ""
  1319. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  1320. #: apt-cdrom.8.xml:65
  1321. msgid "add"
  1322. msgstr ""
  1323. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  1324. #: apt-cdrom.8.xml:66
  1325. msgid ""
  1326. "<literal>add</literal> is used to add a new disc to the source list. It will "
  1327. "unmount the CDROM device, prompt for a disk to be inserted and then procceed "
  1328. "to scan it and copy the index files. If the disc does not have a proper "
  1329. "<filename>disk</filename> directory you will be prompted for a descriptive "
  1330. "title."
  1331. msgstr ""
  1332. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  1333. #: apt-cdrom.8.xml:74
  1334. msgid ""
  1335. "APT uses a CDROM ID to track which disc is currently in the drive and "
  1336. "maintains a database of these IDs in "
  1337. "<filename>&statedir;/cdroms.list</filename>"
  1338. msgstr ""
  1339. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  1340. #: apt-cdrom.8.xml:81
  1341. msgid "ident"
  1342. msgstr ""
  1343. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  1344. #: apt-cdrom.8.xml:82
  1345. msgid ""
  1346. "A debugging tool to report the identity of the current disc as well as the "
  1347. "stored file name"
  1348. msgstr ""
  1349. #. type: Content of: <refentry><refsect1><para>
  1350. #: apt-cdrom.8.xml:61
  1351. msgid ""
  1352. "Unless the <option>-h</option>, or <option>--help</option> option is given "
  1353. "one of the commands below must be present. <placeholder "
  1354. "type=\"variablelist\" id=\"0\"/>"
  1355. msgstr ""
  1356. #. type: Content of: <refentry><refsect1><title>
  1357. #: apt-cdrom.8.xml:91
  1358. msgid "Options"
  1359. msgstr ""
  1360. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1361. #: apt-cdrom.8.xml:95 apt-ftparchive.1.xml:503 apt-get.8.xml:328
  1362. msgid "<option>-d</option>"
  1363. msgstr ""
  1364. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1365. #: apt-cdrom.8.xml:95
  1366. msgid "<option>--cdrom</option>"
  1367. msgstr ""
  1368. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1369. #: apt-cdrom.8.xml:96
  1370. msgid ""
  1371. "Mount point; specify the location to mount the cdrom. This mount point must "
  1372. "be listed in <filename>/etc/fstab</filename> and properly configured. "
  1373. "Configuration Item: <literal>Acquire::cdrom::mount</literal>."
  1374. msgstr ""
  1375. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1376. #: apt-cdrom.8.xml:104
  1377. msgid "<option>-r</option>"
  1378. msgstr ""
  1379. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1380. #: apt-cdrom.8.xml:104
  1381. msgid "<option>--rename</option>"
  1382. msgstr ""
  1383. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1384. #: apt-cdrom.8.xml:105
  1385. msgid ""
  1386. "Rename a disc; change the label of a disk or override the disks given "
  1387. "label. This option will cause <command>apt-cdrom</command> to prompt for a "
  1388. "new label. Configuration Item: <literal>APT::CDROM::Rename</literal>."
  1389. msgstr ""
  1390. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1391. #: apt-cdrom.8.xml:113 apt-get.8.xml:347
  1392. msgid "<option>-m</option>"
  1393. msgstr ""
  1394. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1395. #: apt-cdrom.8.xml:113
  1396. msgid "<option>--no-mount</option>"
  1397. msgstr ""
  1398. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1399. #: apt-cdrom.8.xml:114
  1400. msgid ""
  1401. "No mounting; prevent <command>apt-cdrom</command> from mounting and "
  1402. "unmounting the mount point. Configuration Item: "
  1403. "<literal>APT::CDROM::NoMount</literal>."
  1404. msgstr ""
  1405. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1406. #: apt-cdrom.8.xml:121
  1407. msgid "<option>--fast</option>"
  1408. msgstr ""
  1409. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1410. #: apt-cdrom.8.xml:122
  1411. msgid ""
  1412. "Fast Copy; Assume the package files are valid and do not check every "
  1413. "package. This option should be used only if <command>apt-cdrom</command> has "
  1414. "been run on this disc before and did not detect any errors. Configuration "
  1415. "Item: <literal>APT::CDROM::Fast</literal>."
  1416. msgstr ""
  1417. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1418. #: apt-cdrom.8.xml:131
  1419. msgid "<option>--thorough</option>"
  1420. msgstr ""
  1421. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1422. #: apt-cdrom.8.xml:132
  1423. msgid ""
  1424. "Thorough Package Scan; This option may be needed with some old Debian "
  1425. "1.1/1.2 discs that have Package files in strange places. It takes much "
  1426. "longer to scan the CD but will pick them all up."
  1427. msgstr ""
  1428. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1429. #: apt-cdrom.8.xml:140 apt-get.8.xml:378
  1430. msgid "<option>--just-print</option>"
  1431. msgstr ""
  1432. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1433. #: apt-cdrom.8.xml:141 apt-get.8.xml:380
  1434. msgid "<option>--recon</option>"
  1435. msgstr ""
  1436. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1437. #: apt-cdrom.8.xml:142 apt-get.8.xml:381
  1438. msgid "<option>--no-act</option>"
  1439. msgstr ""
  1440. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1441. #: apt-cdrom.8.xml:143
  1442. msgid ""
  1443. "No Changes; Do not change the &sources-list; file and do not write index "
  1444. "files. Everything is still checked however. Configuration Item: "
  1445. "<literal>APT::CDROM::NoAct</literal>."
  1446. msgstr ""
  1447. #. type: Content of: <refentry><refsect1><para>
  1448. #: apt-cdrom.8.xml:156
  1449. msgid "&apt-conf;, &apt-get;, &sources-list;"
  1450. msgstr ""
  1451. #. type: Content of: <refentry><refsect1><para>
  1452. #: apt-cdrom.8.xml:161
  1453. msgid ""
  1454. "<command>apt-cdrom</command> returns zero on normal operation, decimal 100 "
  1455. "on error."
  1456. msgstr ""
  1457. #. type: Content of: <refentry><refnamediv><refname>
  1458. #: apt-config.8.xml:22 apt-config.8.xml:29
  1459. msgid "apt-config"
  1460. msgstr ""
  1461. #. type: Content of: <refentry><refnamediv><refpurpose>
  1462. #: apt-config.8.xml:30
  1463. msgid "APT Configuration Query program"
  1464. msgstr ""
  1465. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1466. #: apt-config.8.xml:36
  1467. msgid ""
  1468. "<command>apt-config</command> <arg><option>-hv</option></arg> "
  1469. "<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
  1470. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
  1471. "choice=\"req\"> <arg>shell</arg> <arg>dump</arg> </group>"
  1472. msgstr ""
  1473. #. type: Content of: <refentry><refsect1><para>
  1474. #: apt-config.8.xml:48
  1475. msgid ""
  1476. "<command>apt-config</command> is an internal program used by various "
  1477. "portions of the APT suite to provide consistent configurability. It accesses "
  1478. "the main configuration file <filename>/etc/apt/apt.conf</filename> in a "
  1479. "manner that is easy to use by scripted applications."
  1480. msgstr ""
  1481. #. type: Content of: <refentry><refsect1><para>
  1482. #: apt-config.8.xml:53 apt-ftparchive.1.xml:71
  1483. msgid ""
  1484. "Unless the <option>-h</option>, or <option>--help</option> option is given "
  1485. "one of the commands below must be present."
  1486. msgstr ""
  1487. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1488. #: apt-config.8.xml:58
  1489. msgid "shell"
  1490. msgstr ""
  1491. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1492. #: apt-config.8.xml:60
  1493. msgid ""
  1494. "shell is used to access the configuration information from a shell "
  1495. "script. It is given pairs of arguments, the first being a shell variable and "
  1496. "the second the configuration value to query. As output it lists a series of "
  1497. "shell assignments commands for each present value. In a shell script it "
  1498. "should be used like:"
  1499. msgstr ""
  1500. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><informalexample><programlisting>
  1501. #: apt-config.8.xml:68
  1502. #, no-wrap
  1503. msgid ""
  1504. "OPTS=\"-f\"\n"
  1505. "RES=`apt-config shell OPTS MyApp::options`\n"
  1506. "eval $RES\n"
  1507. msgstr ""
  1508. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1509. #: apt-config.8.xml:73
  1510. msgid ""
  1511. "This will set the shell environment variable $OPTS to the value of "
  1512. "MyApp::options with a default of <option>-f</option>."
  1513. msgstr ""
  1514. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1515. #: apt-config.8.xml:77
  1516. msgid ""
  1517. "The configuration item may be postfixed with a /[fdbi]. f returns file "
  1518. "names, d returns directories, b returns true or false and i returns an "
  1519. "integer. Each of the returns is normalized and verified internally."
  1520. msgstr ""
  1521. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1522. #: apt-config.8.xml:86
  1523. msgid "Just show the contents of the configuration space."
  1524. msgstr ""
  1525. #. type: Content of: <refentry><refsect1><para>
  1526. #: apt-config.8.xml:104 apt-extracttemplates.1.xml:75 apt-ftparchive.1.xml:564 apt-sortpkgs.1.xml:70
  1527. msgid "&apt-conf;"
  1528. msgstr ""
  1529. #. type: Content of: <refentry><refsect1><para>
  1530. #: apt-config.8.xml:109
  1531. msgid ""
  1532. "<command>apt-config</command> returns zero on normal operation, decimal 100 "
  1533. "on error."
  1534. msgstr ""
  1535. #. type: Content of: <refentry><refnamediv><refname>
  1536. #: apt-extracttemplates.1.xml:22 apt-extracttemplates.1.xml:29
  1537. msgid "apt-extracttemplates"
  1538. msgstr ""
  1539. #. type: Content of: <refentry><refmeta><manvolnum>
  1540. #: apt-extracttemplates.1.xml:23 apt-ftparchive.1.xml:23 apt-sortpkgs.1.xml:23
  1541. msgid "1"
  1542. msgstr ""
  1543. #. type: Content of: <refentry><refnamediv><refpurpose>
  1544. #: apt-extracttemplates.1.xml:30
  1545. msgid "Utility to extract DebConf config and templates from Debian packages"
  1546. msgstr ""
  1547. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1548. #: apt-extracttemplates.1.xml:36
  1549. msgid ""
  1550. "<command>apt-extracttemplates</command> <arg><option>-hv</option></arg> "
  1551. "<arg><option>-t=<replaceable>temporary "
  1552. "directory</replaceable></option></arg> <arg choice=\"plain\" "
  1553. "rep=\"repeat\"><replaceable>file</replaceable></arg>"
  1554. msgstr ""
  1555. #. type: Content of: <refentry><refsect1><para>
  1556. #: apt-extracttemplates.1.xml:44
  1557. msgid ""
  1558. "<command>apt-extracttemplates</command> will take one or more Debian package "
  1559. "files as input and write out (to a temporary directory) all associated "
  1560. "config scripts and template files. For each passed in package that contains "
  1561. "config scripts and templates, one line of output will be generated in the "
  1562. "format:"
  1563. msgstr ""
  1564. #. type: Content of: <refentry><refsect1><para>
  1565. #: apt-extracttemplates.1.xml:49
  1566. msgid "package version template-file config-script"
  1567. msgstr ""
  1568. #. type: Content of: <refentry><refsect1><para>
  1569. #: apt-extracttemplates.1.xml:50
  1570. msgid ""
  1571. "template-file and config-script are written to the temporary directory "
  1572. "specified by the -t or --tempdir "
  1573. "(<literal>APT::ExtractTemplates::TempDir</literal>) directory, with "
  1574. "filenames of the form <filename>package.template.XXXX</filename> and "
  1575. "<filename>package.config.XXXX</filename>"
  1576. msgstr ""
  1577. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1578. #: apt-extracttemplates.1.xml:60 apt-get.8.xml:488
  1579. msgid "<option>-t</option>"
  1580. msgstr ""
  1581. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1582. #: apt-extracttemplates.1.xml:60
  1583. msgid "<option>--tempdir</option>"
  1584. msgstr ""
  1585. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1586. #: apt-extracttemplates.1.xml:62
  1587. msgid ""
  1588. "Temporary directory in which to write extracted debconf template files and "
  1589. "config scripts Configuration Item: "
  1590. "<literal>APT::ExtractTemplates::TempDir</literal>"
  1591. msgstr ""
  1592. #. type: Content of: <refentry><refsect1><para>
  1593. #: apt-extracttemplates.1.xml:79
  1594. msgid ""
  1595. "<command>apt-extracttemplates</command> returns zero on normal operation, "
  1596. "decimal 100 on error."
  1597. msgstr ""
  1598. #. type: Content of: <refentry><refnamediv><refname>
  1599. #: apt-ftparchive.1.xml:22 apt-ftparchive.1.xml:29
  1600. msgid "apt-ftparchive"
  1601. msgstr ""
  1602. #. type: Content of: <refentry><refnamediv><refpurpose>
  1603. #: apt-ftparchive.1.xml:30
  1604. msgid "Utility to generate index files"
  1605. msgstr ""
  1606. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  1607. #: apt-ftparchive.1.xml:36
  1608. msgid ""
  1609. "<command>apt-ftparchive</command> <arg><option>-hvdsq</option></arg> "
  1610. "<arg><option>--md5</option></arg> <arg><option>--delink</option></arg> "
  1611. "<arg><option>--readonly</option></arg> "
  1612. "<arg><option>--contents</option></arg> <arg><option>-o=<replaceable>config "
  1613. "string</replaceable></option></arg> "
  1614. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <group "
  1615. "choice=\"req\"> <arg>packages<arg choice=\"plain\" "
  1616. "rep=\"repeat\"><replaceable>path</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>pathprefix</replaceable></arg></arg></arg> "
  1617. "<arg>sources<arg choice=\"plain\" "
  1618. "rep=\"repeat\"><replaceable>path</replaceable></arg><arg><replaceable>override</replaceable><arg><replaceable>pathprefix</replaceable></arg></arg></arg> "
  1619. "<arg>contents <arg "
  1620. "choice=\"plain\"><replaceable>path</replaceable></arg></arg> <arg>release "
  1621. "<arg choice=\"plain\"><replaceable>path</replaceable></arg></arg> "
  1622. "<arg>generate <arg "
  1623. "choice=\"plain\"><replaceable>config-file</replaceable></arg> <arg "
  1624. "choice=\"plain\" "
  1625. "rep=\"repeat\"><replaceable>section</replaceable></arg></arg> <arg>clean "
  1626. "<arg choice=\"plain\"><replaceable>config-file</replaceable></arg></arg> "
  1627. "</group>"
  1628. msgstr ""
  1629. #. type: Content of: <refentry><refsect1><para>
  1630. #: apt-ftparchive.1.xml:56
  1631. msgid ""
  1632. "<command>apt-ftparchive</command> is the command line tool that generates "
  1633. "the index files that APT uses to access a distribution source. The index "
  1634. "files should be generated on the origin site based on the content of that "
  1635. "site."
  1636. msgstr ""
  1637. #. type: Content of: <refentry><refsect1><para>
  1638. #: apt-ftparchive.1.xml:60
  1639. msgid ""
  1640. "<command>apt-ftparchive</command> is a superset of the &dpkg-scanpackages; "
  1641. "program, incorporating its entire functionality via the "
  1642. "<literal>packages</literal> command. It also contains a contents file "
  1643. "generator, <literal>contents</literal>, and an elaborate means to 'script' "
  1644. "the generation process for a complete archive."
  1645. msgstr ""
  1646. #. type: Content of: <refentry><refsect1><para>
  1647. #: apt-ftparchive.1.xml:66
  1648. msgid ""
  1649. "Internally <command>apt-ftparchive</command> can make use of binary "
  1650. "databases to cache the contents of a .deb file and it does not rely on any "
  1651. "external programs aside from &gzip;. When doing a full generate it "
  1652. "automatically performs file-change checks and builds the desired compressed "
  1653. "output files."
  1654. msgstr ""
  1655. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1656. #: apt-ftparchive.1.xml:75
  1657. msgid "packages"
  1658. msgstr ""
  1659. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1660. #: apt-ftparchive.1.xml:77
  1661. msgid ""
  1662. "The packages command generates a package file from a directory tree. It "
  1663. "takes the given directory and recursively searches it for .deb files, "
  1664. "emitting a package record to stdout for each. This command is approximately "
  1665. "equivalent to &dpkg-scanpackages;."
  1666. msgstr ""
  1667. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1668. #: apt-ftparchive.1.xml:82 apt-ftparchive.1.xml:106
  1669. msgid "The option <option>--db</option> can be used to specify a binary caching DB."
  1670. msgstr ""
  1671. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1672. #: apt-ftparchive.1.xml:85
  1673. msgid "sources"
  1674. msgstr ""
  1675. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1676. #: apt-ftparchive.1.xml:87
  1677. msgid ""
  1678. "The <literal>sources</literal> command generates a source index file from a "
  1679. "directory tree. It takes the given directory and recursively searches it "
  1680. "for .dsc files, emitting a source record to stdout for each. This command is "
  1681. "approximately equivalent to &dpkg-scansources;."
  1682. msgstr ""
  1683. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1684. #: apt-ftparchive.1.xml:92
  1685. msgid ""
  1686. "If an override file is specified then a source override file will be looked "
  1687. "for with an extension of .src. The --source-override option can be used to "
  1688. "change the source override file that will be used."
  1689. msgstr ""
  1690. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1691. #: apt-ftparchive.1.xml:97
  1692. msgid "contents"
  1693. msgstr ""
  1694. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1695. #: apt-ftparchive.1.xml:99
  1696. msgid ""
  1697. "The <literal>contents</literal> command generates a contents file from a "
  1698. "directory tree. It takes the given directory and recursively searches it for "
  1699. ".deb files, and reads the file list from each file. It then sorts and writes "
  1700. "to stdout the list of files matched to packages. Directories are not written "
  1701. "to the output. If multiple packages own the same file then each package is "
  1702. "separated by a comma in the output."
  1703. msgstr ""
  1704. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1705. #: apt-ftparchive.1.xml:109
  1706. msgid "release"
  1707. msgstr ""
  1708. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1709. #: apt-ftparchive.1.xml:111
  1710. msgid ""
  1711. "The <literal>release</literal> command generates a Release file from a "
  1712. "directory tree. It recursively searches the given directory for Packages, "
  1713. "Packages.gz, Packages.bz2, Sources, Sources.gz, Sources.bz2, Release and "
  1714. "md5sum.txt files. It then writes to stdout a Release file containing an MD5 "
  1715. "digest and SHA1 digest for each file."
  1716. msgstr ""
  1717. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1718. #: apt-ftparchive.1.xml:118
  1719. msgid ""
  1720. "Values for the additional metadata fields in the Release file are taken from "
  1721. "the corresponding variables under "
  1722. "<literal>APT::FTPArchive::Release</literal>, "
  1723. "e.g. <literal>APT::FTPArchive::Release::Origin</literal>. The supported "
  1724. "fields are: <literal>Origin</literal>, <literal>Label</literal>, "
  1725. "<literal>Suite</literal>, <literal>Version</literal>, "
  1726. "<literal>Codename</literal>, <literal>Date</literal>, "
  1727. "<literal>Architectures</literal>, <literal>Components</literal>, "
  1728. "<literal>Description</literal>."
  1729. msgstr ""
  1730. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1731. #: apt-ftparchive.1.xml:128
  1732. msgid "generate"
  1733. msgstr ""
  1734. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1735. #: apt-ftparchive.1.xml:130
  1736. msgid ""
  1737. "The <literal>generate</literal> command is designed to be runnable from a "
  1738. "cron script and builds indexes according to the given config file. The "
  1739. "config language provides a flexible means of specifying which index files "
  1740. "are built from which directories, as well as providing a simple means of "
  1741. "maintaining the required settings."
  1742. msgstr ""
  1743. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  1744. #: apt-ftparchive.1.xml:137 apt-get.8.xml:292
  1745. msgid "clean"
  1746. msgstr ""
  1747. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  1748. #: apt-ftparchive.1.xml:139
  1749. msgid ""
  1750. "The <literal>clean</literal> command tidies the databases used by the given "
  1751. "configuration file by removing any records that are no longer necessary."
  1752. msgstr ""
  1753. #. type: Content of: <refentry><refsect1><title>
  1754. #: apt-ftparchive.1.xml:145
  1755. msgid "The Generate Configuration"
  1756. msgstr ""
  1757. #. type: Content of: <refentry><refsect1><para>
  1758. #: apt-ftparchive.1.xml:147
  1759. msgid ""
  1760. "The <literal>generate</literal> command uses a configuration file to "
  1761. "describe the archives that are going to be generated. It follows the typical "
  1762. "ISC configuration format as seen in ISC tools like bind 8 and dhcpd. "
  1763. "&apt-conf; contains a description of the syntax. Note that the generate "
  1764. "configuration is parsed in sectional manner, but &apt-conf; is parsed in a "
  1765. "tree manner. This only effects how the scope tag is handled."
  1766. msgstr ""
  1767. #. type: Content of: <refentry><refsect1><para>
  1768. #: apt-ftparchive.1.xml:155
  1769. msgid "The generate configuration has 4 separate sections, each described below."
  1770. msgstr ""
  1771. #. type: Content of: <refentry><refsect1><refsect2><title>
  1772. #: apt-ftparchive.1.xml:157
  1773. msgid "Dir Section"
  1774. msgstr ""
  1775. #. type: Content of: <refentry><refsect1><refsect2><para>
  1776. #: apt-ftparchive.1.xml:159
  1777. msgid ""
  1778. "The <literal>Dir</literal> section defines the standard directories needed "
  1779. "to locate the files required during the generation process. These "
  1780. "directories are prepended to certain relative paths defined in later "
  1781. "sections to produce a complete an absolute path."
  1782. msgstr ""
  1783. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1784. #: apt-ftparchive.1.xml:164
  1785. msgid "ArchiveDir"
  1786. msgstr ""
  1787. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1788. #: apt-ftparchive.1.xml:166
  1789. msgid ""
  1790. "Specifies the root of the FTP archive, in a standard Debian configuration "
  1791. "this is the directory that contains the <filename>ls-LR</filename> and dist "
  1792. "nodes."
  1793. msgstr ""
  1794. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1795. #: apt-ftparchive.1.xml:171
  1796. msgid "OverrideDir"
  1797. msgstr ""
  1798. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1799. #: apt-ftparchive.1.xml:173
  1800. msgid "Specifies the location of the override files."
  1801. msgstr ""
  1802. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1803. #: apt-ftparchive.1.xml:176
  1804. msgid "CacheDir"
  1805. msgstr ""
  1806. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1807. #: apt-ftparchive.1.xml:178
  1808. msgid "Specifies the location of the cache files"
  1809. msgstr ""
  1810. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1811. #: apt-ftparchive.1.xml:181
  1812. msgid "FileListDir"
  1813. msgstr ""
  1814. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1815. #: apt-ftparchive.1.xml:183
  1816. msgid ""
  1817. "Specifies the location of the file list files, if the "
  1818. "<literal>FileList</literal> setting is used below."
  1819. msgstr ""
  1820. #. type: Content of: <refentry><refsect1><refsect2><title>
  1821. #: apt-ftparchive.1.xml:189
  1822. msgid "Default Section"
  1823. msgstr ""
  1824. #. type: Content of: <refentry><refsect1><refsect2><para>
  1825. #: apt-ftparchive.1.xml:191
  1826. msgid ""
  1827. "The <literal>Default</literal> section specifies default values, and "
  1828. "settings that control the operation of the generator. Other sections may "
  1829. "override these defaults with a per-section setting."
  1830. msgstr ""
  1831. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1832. #: apt-ftparchive.1.xml:195
  1833. msgid "Packages::Compress"
  1834. msgstr ""
  1835. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1836. #: apt-ftparchive.1.xml:197
  1837. msgid ""
  1838. "Sets the default compression schemes to use for the Package index files. It "
  1839. "is a string that contains a space separated list of at least one of: '.' (no "
  1840. "compression), 'gzip' and 'bzip2'. The default for all compression schemes is "
  1841. "'. gzip'."
  1842. msgstr ""
  1843. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1844. #: apt-ftparchive.1.xml:203
  1845. msgid "Packages::Extensions"
  1846. msgstr ""
  1847. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1848. #: apt-ftparchive.1.xml:205
  1849. msgid ""
  1850. "Sets the default list of file extensions that are package files. This "
  1851. "defaults to '.deb'."
  1852. msgstr ""
  1853. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1854. #: apt-ftparchive.1.xml:209
  1855. msgid "Sources::Compress"
  1856. msgstr ""
  1857. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1858. #: apt-ftparchive.1.xml:211
  1859. msgid ""
  1860. "This is similar to <literal>Packages::Compress</literal> except that it "
  1861. "controls the compression for the Sources files."
  1862. msgstr ""
  1863. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1864. #: apt-ftparchive.1.xml:215
  1865. msgid "Sources::Extensions"
  1866. msgstr ""
  1867. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1868. #: apt-ftparchive.1.xml:217
  1869. msgid ""
  1870. "Sets the default list of file extensions that are source files. This "
  1871. "defaults to '.dsc'."
  1872. msgstr ""
  1873. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1874. #: apt-ftparchive.1.xml:221
  1875. msgid "Contents::Compress"
  1876. msgstr ""
  1877. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1878. #: apt-ftparchive.1.xml:223
  1879. msgid ""
  1880. "This is similar to <literal>Packages::Compress</literal> except that it "
  1881. "controls the compression for the Contents files."
  1882. msgstr ""
  1883. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1884. #: apt-ftparchive.1.xml:227
  1885. msgid "DeLinkLimit"
  1886. msgstr ""
  1887. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1888. #: apt-ftparchive.1.xml:229
  1889. msgid ""
  1890. "Specifies the number of kilobytes to delink (and replace with hard links) "
  1891. "per run. This is used in conjunction with the per-section "
  1892. "<literal>External-Links</literal> setting."
  1893. msgstr ""
  1894. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1895. #: apt-ftparchive.1.xml:234
  1896. msgid "FileMode"
  1897. msgstr ""
  1898. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1899. #: apt-ftparchive.1.xml:236
  1900. msgid ""
  1901. "Specifies the mode of all created index files. It defaults to 0644. All "
  1902. "index files are set to this mode with no regard to the umask."
  1903. msgstr ""
  1904. #. type: Content of: <refentry><refsect1><refsect2><title>
  1905. #: apt-ftparchive.1.xml:243
  1906. msgid "TreeDefault Section"
  1907. msgstr ""
  1908. #. type: Content of: <refentry><refsect1><refsect2><para>
  1909. #: apt-ftparchive.1.xml:245
  1910. msgid ""
  1911. "Sets defaults specific to <literal>Tree</literal> sections. All of these "
  1912. "variables are substitution variables and have the strings $(DIST), "
  1913. "$(SECTION) and $(ARCH) replaced with their respective values."
  1914. msgstr ""
  1915. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1916. #: apt-ftparchive.1.xml:250
  1917. msgid "MaxContentsChange"
  1918. msgstr ""
  1919. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1920. #: apt-ftparchive.1.xml:252
  1921. msgid ""
  1922. "Sets the number of kilobytes of contents files that are generated each "
  1923. "day. The contents files are round-robined so that over several days they "
  1924. "will all be rebuilt."
  1925. msgstr ""
  1926. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1927. #: apt-ftparchive.1.xml:257
  1928. msgid "ContentsAge"
  1929. msgstr ""
  1930. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1931. #: apt-ftparchive.1.xml:259
  1932. msgid ""
  1933. "Controls the number of days a contents file is allowed to be checked without "
  1934. "changing. If this limit is passed the mtime of the contents file is "
  1935. "updated. This case can occur if the package file is changed in such a way "
  1936. "that does not result in a new contents file [override edit for instance]. A "
  1937. "hold off is allowed in hopes that new .debs will be installed, requiring a "
  1938. "new file anyhow. The default is 10, the units are in days."
  1939. msgstr ""
  1940. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1941. #: apt-ftparchive.1.xml:268
  1942. msgid "Directory"
  1943. msgstr ""
  1944. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1945. #: apt-ftparchive.1.xml:270
  1946. msgid ""
  1947. "Sets the top of the .deb directory tree. Defaults to "
  1948. "<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename>"
  1949. msgstr ""
  1950. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1951. #: apt-ftparchive.1.xml:274
  1952. msgid "SrcDirectory"
  1953. msgstr ""
  1954. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1955. #: apt-ftparchive.1.xml:276
  1956. msgid ""
  1957. "Sets the top of the source package directory tree. Defaults to "
  1958. "<filename>$(DIST)/$(SECTION)/source/</filename>"
  1959. msgstr ""
  1960. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1961. #: apt-ftparchive.1.xml:280 apt-ftparchive.1.xml:406
  1962. msgid "Packages"
  1963. msgstr ""
  1964. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1965. #: apt-ftparchive.1.xml:282
  1966. msgid ""
  1967. "Sets the output Packages file. Defaults to "
  1968. "<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename>"
  1969. msgstr ""
  1970. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1971. #: apt-ftparchive.1.xml:286 apt-ftparchive.1.xml:411
  1972. msgid "Sources"
  1973. msgstr ""
  1974. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1975. #: apt-ftparchive.1.xml:288
  1976. msgid ""
  1977. "Sets the output Packages file. Defaults to "
  1978. "<filename>$(DIST)/$(SECTION)/source/Sources</filename>"
  1979. msgstr ""
  1980. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1981. #: apt-ftparchive.1.xml:292
  1982. msgid "InternalPrefix"
  1983. msgstr ""
  1984. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1985. #: apt-ftparchive.1.xml:294
  1986. msgid ""
  1987. "Sets the path prefix that causes a symlink to be considered an internal link "
  1988. "instead of an external link. Defaults to "
  1989. "<filename>$(DIST)/$(SECTION)/</filename>"
  1990. msgstr ""
  1991. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  1992. #: apt-ftparchive.1.xml:299 apt-ftparchive.1.xml:417
  1993. msgid "Contents"
  1994. msgstr ""
  1995. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  1996. #: apt-ftparchive.1.xml:301
  1997. msgid ""
  1998. "Sets the output Contents file. Defaults to "
  1999. "<filename>$(DIST)/Contents-$(ARCH)</filename>. If this setting causes "
  2000. "multiple Packages files to map onto a single Contents file (such as the "
  2001. "default) then <command>apt-ftparchive</command> will integrate those "
  2002. "package files together automatically."
  2003. msgstr ""
  2004. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2005. #: apt-ftparchive.1.xml:308
  2006. msgid "Contents::Header"
  2007. msgstr ""
  2008. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2009. #: apt-ftparchive.1.xml:310
  2010. msgid "Sets header file to prepend to the contents output."
  2011. msgstr ""
  2012. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2013. #: apt-ftparchive.1.xml:313 apt-ftparchive.1.xml:442
  2014. msgid "BinCacheDB"
  2015. msgstr ""
  2016. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2017. #: apt-ftparchive.1.xml:315
  2018. msgid ""
  2019. "Sets the binary cache database to use for this section. Multiple sections "
  2020. "can share the same database."
  2021. msgstr ""
  2022. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2023. #: apt-ftparchive.1.xml:319
  2024. msgid "FileList"
  2025. msgstr ""
  2026. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2027. #: apt-ftparchive.1.xml:321
  2028. msgid ""
  2029. "Specifies that instead of walking the directory tree, "
  2030. "<command>apt-ftparchive</command> should read the list of files from the "
  2031. "given file. Relative files names are prefixed with the archive directory."
  2032. msgstr ""
  2033. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2034. #: apt-ftparchive.1.xml:326
  2035. msgid "SourceFileList"
  2036. msgstr ""
  2037. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2038. #: apt-ftparchive.1.xml:328
  2039. msgid ""
  2040. "Specifies that instead of walking the directory tree, "
  2041. "<command>apt-ftparchive</command> should read the list of files from the "
  2042. "given file. Relative files names are prefixed with the archive directory. "
  2043. "This is used when processing source indexes."
  2044. msgstr ""
  2045. #. type: Content of: <refentry><refsect1><refsect2><title>
  2046. #: apt-ftparchive.1.xml:336
  2047. msgid "Tree Section"
  2048. msgstr ""
  2049. #. type: Content of: <refentry><refsect1><refsect2><para>
  2050. #: apt-ftparchive.1.xml:338
  2051. msgid ""
  2052. "The <literal>Tree</literal> section defines a standard Debian file tree "
  2053. "which consists of a base directory, then multiple sections in that base "
  2054. "directory and finally multiple Architectures in each section. The exact "
  2055. "pathing used is defined by the <literal>Directory</literal> substitution "
  2056. "variable."
  2057. msgstr ""
  2058. #. type: Content of: <refentry><refsect1><refsect2><para>
  2059. #: apt-ftparchive.1.xml:343
  2060. msgid ""
  2061. "The <literal>Tree</literal> section takes a scope tag which sets the "
  2062. "<literal>$(DIST)</literal> variable and defines the root of the tree (the "
  2063. "path is prefixed by <literal>ArchiveDir</literal>). Typically this is a "
  2064. "setting such as <filename>dists/woody</filename>."
  2065. msgstr ""
  2066. #. type: Content of: <refentry><refsect1><refsect2><para>
  2067. #: apt-ftparchive.1.xml:348
  2068. msgid ""
  2069. "All of the settings defined in the <literal>TreeDefault</literal> section "
  2070. "can be use in a <literal>Tree</literal> section as well as three new "
  2071. "variables."
  2072. msgstr ""
  2073. #. type: Content of: <refentry><refsect1><refsect2><para>
  2074. #: apt-ftparchive.1.xml:351
  2075. msgid ""
  2076. "When processing a <literal>Tree</literal> section "
  2077. "<command>apt-ftparchive</command> performs an operation similar to:"
  2078. msgstr ""
  2079. #. type: Content of: <refentry><refsect1><refsect2><para><informalexample><programlisting>
  2080. #: apt-ftparchive.1.xml:354
  2081. #, no-wrap
  2082. msgid ""
  2083. "for i in Sections do \n"
  2084. " for j in Architectures do\n"
  2085. " Generate for DIST=scope SECTION=i ARCH=j\n"
  2086. msgstr ""
  2087. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2088. #: apt-ftparchive.1.xml:360
  2089. msgid "Sections"
  2090. msgstr ""
  2091. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2092. #: apt-ftparchive.1.xml:362
  2093. msgid ""
  2094. "This is a space separated list of sections which appear under the "
  2095. "distribution, typically this is something like <literal>main contrib "
  2096. "non-free</literal>"
  2097. msgstr ""
  2098. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2099. #: apt-ftparchive.1.xml:367
  2100. msgid "Architectures"
  2101. msgstr ""
  2102. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2103. #: apt-ftparchive.1.xml:369
  2104. msgid ""
  2105. "This is a space separated list of all the architectures that appear under "
  2106. "search section. The special architecture 'source' is used to indicate that "
  2107. "this tree has a source archive."
  2108. msgstr ""
  2109. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2110. #: apt-ftparchive.1.xml:374 apt-ftparchive.1.xml:422
  2111. msgid "BinOverride"
  2112. msgstr ""
  2113. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2114. #: apt-ftparchive.1.xml:376
  2115. msgid ""
  2116. "Sets the binary override file. The override file contains section, priority "
  2117. "and maintainer address information."
  2118. msgstr ""
  2119. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2120. #: apt-ftparchive.1.xml:380 apt-ftparchive.1.xml:427
  2121. msgid "SrcOverride"
  2122. msgstr ""
  2123. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2124. #: apt-ftparchive.1.xml:382
  2125. msgid ""
  2126. "Sets the source override file. The override file contains section "
  2127. "information."
  2128. msgstr ""
  2129. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2130. #: apt-ftparchive.1.xml:386 apt-ftparchive.1.xml:432
  2131. msgid "ExtraOverride"
  2132. msgstr ""
  2133. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2134. #: apt-ftparchive.1.xml:388 apt-ftparchive.1.xml:434
  2135. msgid "Sets the binary extra override file."
  2136. msgstr ""
  2137. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2138. #: apt-ftparchive.1.xml:391 apt-ftparchive.1.xml:437
  2139. msgid "SrcExtraOverride"
  2140. msgstr ""
  2141. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2142. #: apt-ftparchive.1.xml:393 apt-ftparchive.1.xml:439
  2143. msgid "Sets the source extra override file."
  2144. msgstr ""
  2145. #. type: Content of: <refentry><refsect1><refsect2><title>
  2146. #: apt-ftparchive.1.xml:398
  2147. msgid "BinDirectory Section"
  2148. msgstr ""
  2149. #. type: Content of: <refentry><refsect1><refsect2><para>
  2150. #: apt-ftparchive.1.xml:400
  2151. msgid ""
  2152. "The <literal>bindirectory</literal> section defines a binary directory tree "
  2153. "with no special structure. The scope tag specifies the location of the "
  2154. "binary directory and the settings are similar to the <literal>Tree</literal> "
  2155. "section with no substitution variables or "
  2156. "<literal>Section</literal><literal>Architecture</literal> settings."
  2157. msgstr ""
  2158. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2159. #: apt-ftparchive.1.xml:408
  2160. msgid "Sets the Packages file output."
  2161. msgstr ""
  2162. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2163. #: apt-ftparchive.1.xml:413
  2164. msgid ""
  2165. "Sets the Sources file output. At least one of <literal>Packages</literal> or "
  2166. "<literal>Sources</literal> is required."
  2167. msgstr ""
  2168. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2169. #: apt-ftparchive.1.xml:419
  2170. msgid "Sets the Contents file output. (optional)"
  2171. msgstr ""
  2172. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2173. #: apt-ftparchive.1.xml:424
  2174. msgid "Sets the binary override file."
  2175. msgstr ""
  2176. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2177. #: apt-ftparchive.1.xml:429
  2178. msgid "Sets the source override file."
  2179. msgstr ""
  2180. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2181. #: apt-ftparchive.1.xml:444
  2182. msgid "Sets the cache DB."
  2183. msgstr ""
  2184. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2185. #: apt-ftparchive.1.xml:447
  2186. msgid "PathPrefix"
  2187. msgstr ""
  2188. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2189. #: apt-ftparchive.1.xml:449
  2190. msgid "Appends a path to all the output paths."
  2191. msgstr ""
  2192. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  2193. #: apt-ftparchive.1.xml:452
  2194. msgid "FileList, SourceFileList"
  2195. msgstr ""
  2196. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  2197. #: apt-ftparchive.1.xml:454
  2198. msgid "Specifies the file list file."
  2199. msgstr ""
  2200. #. type: Content of: <refentry><refsect1><title>
  2201. #: apt-ftparchive.1.xml:461
  2202. msgid "The Binary Override File"
  2203. msgstr ""
  2204. #. type: Content of: <refentry><refsect1><para>
  2205. #: apt-ftparchive.1.xml:462
  2206. msgid ""
  2207. "The binary override file is fully compatible with &dpkg-scanpackages;. It "
  2208. "contains 4 fields separated by spaces. The first field is the package name, "
  2209. "the second is the priority to force that package to, the third is the the "
  2210. "section to force that package to and the final field is the maintainer "
  2211. "permutation field."
  2212. msgstr ""
  2213. #. type: Content of: <refentry><refsect1><para><literallayout>
  2214. #: apt-ftparchive.1.xml:468
  2215. #, no-wrap
  2216. msgid "old [// oldn]* => new"
  2217. msgstr ""
  2218. #. type: Content of: <refentry><refsect1><para><literallayout>
  2219. #: apt-ftparchive.1.xml:470
  2220. #, no-wrap
  2221. msgid "new"
  2222. msgstr ""
  2223. #. type: Content of: <refentry><refsect1><para>
  2224. #: apt-ftparchive.1.xml:467
  2225. msgid ""
  2226. "The general form of the maintainer field is: <placeholder "
  2227. "type=\"literallayout\" id=\"0\"/> or simply, <placeholder "
  2228. "type=\"literallayout\" id=\"1\"/> The first form allows a double-slash "
  2229. "separated list of old email addresses to be specified. If any of those are "
  2230. "found then new is substituted for the maintainer field. The second form "
  2231. "unconditionally substitutes the maintainer field."
  2232. msgstr ""
  2233. #. type: Content of: <refentry><refsect1><title>
  2234. #: apt-ftparchive.1.xml:478
  2235. msgid "The Source Override File"
  2236. msgstr ""
  2237. #. type: Content of: <refentry><refsect1><para>
  2238. #: apt-ftparchive.1.xml:480
  2239. msgid ""
  2240. "The source override file is fully compatible with &dpkg-scansources;. It "
  2241. "contains 2 fields separated by spaces. The first fields is the source "
  2242. "package name, the second is the section to assign it."
  2243. msgstr ""
  2244. #. type: Content of: <refentry><refsect1><title>
  2245. #: apt-ftparchive.1.xml:485
  2246. msgid "The Extra Override File"
  2247. msgstr ""
  2248. #. type: Content of: <refentry><refsect1><para>
  2249. #: apt-ftparchive.1.xml:487
  2250. msgid ""
  2251. "The extra override file allows any arbitrary tag to be added or replaced in "
  2252. "the output. It has 3 columns, the first is the package, the second is the "
  2253. "tag and the remainder of the line is the new value."
  2254. msgstr ""
  2255. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2256. #: apt-ftparchive.1.xml:496
  2257. msgid "<option>--md5</option>"
  2258. msgstr ""
  2259. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2260. #: apt-ftparchive.1.xml:498
  2261. msgid ""
  2262. "Generate MD5 sums. This defaults to on, when turned off the generated index "
  2263. "files will not have MD5Sum fields where possible. Configuration Item: "
  2264. "<literal>APT::FTPArchive::MD5</literal>"
  2265. msgstr ""
  2266. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2267. #: apt-ftparchive.1.xml:503
  2268. msgid "<option>--db</option>"
  2269. msgstr ""
  2270. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2271. #: apt-ftparchive.1.xml:505
  2272. msgid ""
  2273. "Use a binary caching DB. This has no effect on the generate command. "
  2274. "Configuration Item: <literal>APT::FTPArchive::DB</literal>."
  2275. msgstr ""
  2276. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2277. #: apt-ftparchive.1.xml:511
  2278. msgid ""
  2279. "Quiet; produces output suitable for logging, omitting progress indicators. "
  2280. "More q's will produce more quiet up to a maximum of 2. You can also use "
  2281. "<option>-q=#</option> to set the quiet level, overriding the configuration "
  2282. "file. Configuration Item: <literal>quiet</literal>."
  2283. msgstr ""
  2284. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2285. #: apt-ftparchive.1.xml:517
  2286. msgid "<option>--delink</option>"
  2287. msgstr ""
  2288. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2289. #: apt-ftparchive.1.xml:519
  2290. msgid ""
  2291. "Perform Delinking. If the <literal>External-Links</literal> setting is used "
  2292. "then this option actually enables delinking of the files. It defaults to on "
  2293. "and can be turned off with <option>--no-delink</option>. Configuration "
  2294. "Item: <literal>APT::FTPArchive::DeLinkAct</literal>."
  2295. msgstr ""
  2296. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2297. #: apt-ftparchive.1.xml:525
  2298. msgid "<option>--contents</option>"
  2299. msgstr ""
  2300. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2301. #: apt-ftparchive.1.xml:527
  2302. msgid ""
  2303. "Perform contents generation. When this option is set and package indexes are "
  2304. "being generated with a cache DB then the file listing will also be extracted "
  2305. "and stored in the DB for later use. When using the generate command this "
  2306. "option also allows the creation of any Contents files. The default is on. "
  2307. "Configuration Item: <literal>APT::FTPArchive::Contents</literal>."
  2308. msgstr ""
  2309. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2310. #: apt-ftparchive.1.xml:535
  2311. msgid "<option>--source-override</option>"
  2312. msgstr ""
  2313. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2314. #: apt-ftparchive.1.xml:537
  2315. msgid ""
  2316. "Select the source override file to use with the <literal>sources</literal> "
  2317. "command. Configuration Item: "
  2318. "<literal>APT::FTPArchive::SourceOverride</literal>."
  2319. msgstr ""
  2320. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2321. #: apt-ftparchive.1.xml:541
  2322. msgid "<option>--readonly</option>"
  2323. msgstr ""
  2324. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2325. #: apt-ftparchive.1.xml:543
  2326. msgid ""
  2327. "Make the caching databases read only. Configuration Item: "
  2328. "<literal>APT::FTPArchive::ReadOnlyDB</literal>."
  2329. msgstr ""
  2330. #. type: Content of: <refentry><refsect1><title>
  2331. #: apt-ftparchive.1.xml:552 apt.conf.5.xml:962 apt_preferences.5.xml:462 sources.list.5.xml:181
  2332. msgid "Examples"
  2333. msgstr ""
  2334. #. type: Content of: <refentry><refsect1><para><programlisting>
  2335. #: apt-ftparchive.1.xml:558
  2336. #, no-wrap
  2337. msgid ""
  2338. "<command>apt-ftparchive</command> packages "
  2339. "<replaceable>directory</replaceable> | <command>gzip</command> > "
  2340. "<filename>Packages.gz</filename>\n"
  2341. msgstr ""
  2342. #. type: Content of: <refentry><refsect1><para>
  2343. #: apt-ftparchive.1.xml:554
  2344. msgid ""
  2345. "To create a compressed Packages file for a directory containing binary "
  2346. "packages (.deb): <placeholder type=\"programlisting\" id=\"0\"/>"
  2347. msgstr ""
  2348. #. type: Content of: <refentry><refsect1><para>
  2349. #: apt-ftparchive.1.xml:568
  2350. msgid ""
  2351. "<command>apt-ftparchive</command> returns zero on normal operation, decimal "
  2352. "100 on error."
  2353. msgstr ""
  2354. #. The last update date
  2355. #. type: Content of: <refentry><refentryinfo>
  2356. #: apt-get.8.xml:13
  2357. msgid ""
  2358. "&apt-author.jgunthorpe; &apt-author.team; &apt-email; &apt-product; <date>08 "
  2359. "November 2008</date>"
  2360. msgstr ""
  2361. #. type: Content of: <refentry><refnamediv><refname>
  2362. #: apt-get.8.xml:22 apt-get.8.xml:29
  2363. msgid "apt-get"
  2364. msgstr ""
  2365. #. type: Content of: <refentry><refnamediv><refpurpose>
  2366. #: apt-get.8.xml:30
  2367. msgid "APT package handling utility -- command-line interface"
  2368. msgstr ""
  2369. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  2370. #: apt-get.8.xml:36
  2371. msgid ""
  2372. "<command>apt-get</command> <arg><option>-sqdyfmubV</option></arg> <arg> "
  2373. "<option>-o= <replaceable>config_string</replaceable> </option> </arg> <arg> "
  2374. "<option>-c= <replaceable>config_file</replaceable> </option> </arg> <arg> "
  2375. "<option>-t=</option> <group choice='req'> <arg choice='plain'> "
  2376. "<replaceable>target_release_name</replaceable> </arg> <arg choice='plain'> "
  2377. "<replaceable>target_release_number_expression</replaceable> </arg> <arg "
  2378. "choice='plain'> <replaceable>target_release_codename</replaceable> </arg> "
  2379. "</group> </arg> <group choice=\"req\"> <arg choice='plain'>update</arg> <arg "
  2380. "choice='plain'>upgrade</arg> <arg choice='plain'>dselect-upgrade</arg> <arg "
  2381. "choice='plain'>dist-upgrade</arg> <arg choice='plain'>install <arg "
  2382. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable> <arg> <group "
  2383. "choice='req'> <arg choice='plain'> "
  2384. "=<replaceable>pkg_version_number</replaceable> </arg> <arg choice='plain'> "
  2385. "/<replaceable>target_release_name</replaceable> </arg> <arg choice='plain'> "
  2386. "/<replaceable>target_release_codename</replaceable> </arg> </group> </arg> "
  2387. "</arg> </arg> <arg choice='plain'>remove <arg choice=\"plain\" "
  2388. "rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg "
  2389. "choice='plain'>purge <arg choice=\"plain\" "
  2390. "rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> <arg "
  2391. "choice='plain'>source <arg choice=\"plain\" "
  2392. "rep=\"repeat\"><replaceable>pkg</replaceable> <arg> <group choice='req'> "
  2393. "<arg choice='plain'> =<replaceable>pkg_version_number</replaceable> </arg> "
  2394. "<arg choice='plain'> /<replaceable>target_release_name</replaceable> </arg> "
  2395. "<arg choice='plain'> /<replaceable>target_release_codename</replaceable> "
  2396. "</arg> </group> </arg> </arg> </arg> <arg choice='plain'>build-dep <arg "
  2397. "choice=\"plain\" rep=\"repeat\"><replaceable>pkg</replaceable></arg></arg> "
  2398. "<arg choice='plain'>check</arg> <arg choice='plain'>clean</arg> <arg "
  2399. "choice='plain'>autoclean</arg> <arg choice='plain'>autoremove</arg> <arg "
  2400. "choice='plain'> <group choice='req'> <arg choice='plain'>-v</arg> <arg "
  2401. "choice='plain'>--version</arg> </group> </arg> <arg choice='plain'> <group "
  2402. "choice='req'> <arg choice='plain'>-h</arg> <arg choice='plain'>--help</arg> "
  2403. "</group> </arg> </group>"
  2404. msgstr ""
  2405. #. type: Content of: <refentry><refsect1><para>
  2406. #: apt-get.8.xml:126
  2407. msgid ""
  2408. "<command>apt-get</command> is the command-line tool for handling packages, "
  2409. "and may be considered the user's \"back-end\" to other tools using the APT "
  2410. "library. Several \"front-end\" interfaces exist, such as &dselect;, "
  2411. "&aptitude;, &synaptic;, &gnome-apt; and &wajig;."
  2412. msgstr ""
  2413. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2414. #: apt-get.8.xml:135 apt-key.8.xml:123
  2415. msgid "update"
  2416. msgstr ""
  2417. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2418. #: apt-get.8.xml:136
  2419. msgid ""
  2420. "<literal>update</literal> is used to resynchronize the package index files "
  2421. "from their sources. The indexes of available packages are fetched from the "
  2422. "location(s) specified in <filename>/etc/apt/sources.list</filename>. For "
  2423. "example, when using a Debian archive, this command retrieves and scans the "
  2424. "<filename>Packages.gz</filename> files, so that information about new and "
  2425. "updated packages is available. An <literal>update</literal> should always be "
  2426. "performed before an <literal>upgrade</literal> or "
  2427. "<literal>dist-upgrade</literal>. Please be aware that the overall progress "
  2428. "meter will be incorrect as the size of the package files cannot be known in "
  2429. "advance."
  2430. msgstr ""
  2431. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2432. #: apt-get.8.xml:147
  2433. msgid "upgrade"
  2434. msgstr ""
  2435. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2436. #: apt-get.8.xml:148
  2437. msgid ""
  2438. "<literal>upgrade</literal> is used to install the newest versions of all "
  2439. "packages currently installed on the system from the sources enumerated in "
  2440. "<filename>/etc/apt/sources.list</filename>. Packages currently installed "
  2441. "with new versions available are retrieved and upgraded; under no "
  2442. "circumstances are currently installed packages removed, or packages not "
  2443. "already installed retrieved and installed. New versions of currently "
  2444. "installed packages that cannot be upgraded without changing the install "
  2445. "status of another package will be left at their current version. An "
  2446. "<literal>update</literal> must be performed first so that "
  2447. "<command>apt-get</command> knows that new versions of packages are "
  2448. "available."
  2449. msgstr ""
  2450. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2451. #: apt-get.8.xml:160
  2452. msgid "dselect-upgrade"
  2453. msgstr ""
  2454. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2455. #: apt-get.8.xml:161
  2456. msgid ""
  2457. "<literal>dselect-upgrade</literal> is used in conjunction with the "
  2458. "traditional Debian packaging front-end, "
  2459. "&dselect;. <literal>dselect-upgrade</literal> follows the changes made by "
  2460. "&dselect; to the <literal>Status</literal> field of available packages, and "
  2461. "performs the actions necessary to realize that state (for instance, the "
  2462. "removal of old and the installation of new packages)."
  2463. msgstr ""
  2464. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2465. #: apt-get.8.xml:170
  2466. msgid "dist-upgrade"
  2467. msgstr ""
  2468. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2469. #: apt-get.8.xml:171
  2470. msgid ""
  2471. "<literal>dist-upgrade</literal> in addition to performing the function of "
  2472. "<literal>upgrade</literal>, also intelligently handles changing dependencies "
  2473. "with new versions of packages; <command>apt-get</command> has a \"smart\" "
  2474. "conflict resolution system, and it will attempt to upgrade the most "
  2475. "important packages at the expense of less important ones if necessary. So, "
  2476. "<literal>dist-upgrade</literal> command may remove some packages. The "
  2477. "<filename>/etc/apt/sources.list</filename> file contains a list of locations "
  2478. "from which to retrieve desired package files. See also &apt-preferences; "
  2479. "for a mechanism for overriding the general settings for individual packages."
  2480. msgstr ""
  2481. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2482. #: apt-get.8.xml:183
  2483. msgid "install"
  2484. msgstr ""
  2485. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2486. #: apt-get.8.xml:185
  2487. msgid ""
  2488. "<literal>install</literal> is followed by one or more packages desired for "
  2489. "installation or upgrading. Each package is a package name, not a fully "
  2490. "qualified filename (for instance, in a Debian GNU/Linux system, libc6 would "
  2491. "be the argument provided, not <literal>libc6_1.9.6-2.deb</literal>). All "
  2492. "packages required by the package(s) specified for installation will also be "
  2493. "retrieved and installed. The <filename>/etc/apt/sources.list</filename> "
  2494. "file is used to locate the desired packages. If a hyphen is appended to the "
  2495. "package name (with no intervening space), the identified package will be "
  2496. "removed if it is installed. Similarly a plus sign can be used to designate "
  2497. "a package to install. These latter features may be used to override "
  2498. "decisions made by apt-get's conflict resolution system."
  2499. msgstr ""
  2500. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2501. #: apt-get.8.xml:203
  2502. msgid ""
  2503. "A specific version of a package can be selected for installation by "
  2504. "following the package name with an equals and the version of the package to "
  2505. "select. This will cause that version to be located and selected for "
  2506. "install. Alternatively a specific distribution can be selected by following "
  2507. "the package name with a slash and the version of the distribution or the "
  2508. "Archive name (stable, testing, unstable)."
  2509. msgstr ""
  2510. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2511. #: apt-get.8.xml:210
  2512. msgid ""
  2513. "Both of the version selection mechanisms can downgrade packages and must be "
  2514. "used with care."
  2515. msgstr ""
  2516. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2517. #: apt-get.8.xml:213
  2518. msgid ""
  2519. "This is also the target to use if you want to upgrade one or more "
  2520. "already-installed packages without upgrading every package you have on your "
  2521. "system. Unlike the \"upgrade\" target, which installs the newest version of "
  2522. "all currently installed packages, \"install\" will install the newest "
  2523. "version of only the package(s) specified. Simply provide the name of the "
  2524. "package(s) you wish to upgrade, and if a newer version is available, it (and "
  2525. "its dependencies, as described above) will be downloaded and installed."
  2526. msgstr ""
  2527. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2528. #: apt-get.8.xml:224
  2529. msgid ""
  2530. "Finally, the &apt-preferences; mechanism allows you to create an alternative "
  2531. "installation policy for individual packages."
  2532. msgstr ""
  2533. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2534. #: apt-get.8.xml:228
  2535. msgid ""
  2536. "If no package matches the given expression and the expression contains one "
  2537. "of '.', '?' or '*' then it is assumed to be a POSIX regular expression, and "
  2538. "it is applied to all package names in the database. Any matches are then "
  2539. "installed (or removed). Note that matching is done by substring so 'lo.*' "
  2540. "matches 'how-lo' and 'lowest'. If this is undesired, anchor the regular "
  2541. "expression with a '^' or '$' character, or create a more specific regular "
  2542. "expression."
  2543. msgstr ""
  2544. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2545. #: apt-get.8.xml:237
  2546. msgid "remove"
  2547. msgstr ""
  2548. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2549. #: apt-get.8.xml:238
  2550. msgid ""
  2551. "<literal>remove</literal> is identical to <literal>install</literal> except "
  2552. "that packages are removed instead of installed. Note the removing a package "
  2553. "leaves its configuration files in system. If a plus sign is appended to the "
  2554. "package name (with no intervening space), the identified package will be "
  2555. "installed instead of removed."
  2556. msgstr ""
  2557. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2558. #: apt-get.8.xml:245
  2559. msgid "purge"
  2560. msgstr ""
  2561. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2562. #: apt-get.8.xml:246
  2563. msgid ""
  2564. "<literal>purge</literal> is identical to <literal>remove</literal> except "
  2565. "that packages are removed and purged (any configuration files are deleted "
  2566. "too)."
  2567. msgstr ""
  2568. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2569. #: apt-get.8.xml:250
  2570. msgid "source"
  2571. msgstr ""
  2572. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2573. #: apt-get.8.xml:251
  2574. msgid ""
  2575. "<literal>source</literal> causes <command>apt-get</command> to fetch source "
  2576. "packages. APT will examine the available packages to decide which source "
  2577. "package to fetch. It will then find and download into the current directory "
  2578. "the newest available version of that source package while respect the "
  2579. "default release, set with the option "
  2580. "<literal>APT::Default-Release</literal>, the <option>-t</option> option or "
  2581. "per package with with the <literal>pkg/release</literal> syntax, if "
  2582. "possible."
  2583. msgstr ""
  2584. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2585. #: apt-get.8.xml:259
  2586. msgid ""
  2587. "Source packages are tracked separately from binary packages via "
  2588. "<literal>deb-src</literal> type lines in the &sources-list; file. This means "
  2589. "that you will need to add such a line for each repository you want to get "
  2590. "sources from. If you don't do this you will properly get another (newer, "
  2591. "older or none) source version than the one you have installed or could "
  2592. "install."
  2593. msgstr ""
  2594. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2595. #: apt-get.8.xml:266
  2596. msgid ""
  2597. "If the <option>--compile</option> options is specified then the package will "
  2598. "be compiled to a binary .deb using <command>dpkg-buildpackage</command>, if "
  2599. "<option>--download-only</option> is specified then the source package will "
  2600. "not be unpacked."
  2601. msgstr ""
  2602. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2603. #: apt-get.8.xml:271
  2604. msgid ""
  2605. "A specific source version can be retrieved by postfixing the source name "
  2606. "with an equals and then the version to fetch, similar to the mechanism used "
  2607. "for the package files. This enables exact matching of the source package "
  2608. "name and version, implicitly enabling the "
  2609. "<literal>APT::Get::Only-Source</literal> option."
  2610. msgstr ""
  2611. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2612. #: apt-get.8.xml:277
  2613. msgid ""
  2614. "Note that source packages are not tracked like binary packages, they exist "
  2615. "only in the current directory and are similar to downloading source tar "
  2616. "balls."
  2617. msgstr ""
  2618. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2619. #: apt-get.8.xml:282
  2620. msgid "build-dep"
  2621. msgstr ""
  2622. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2623. #: apt-get.8.xml:283
  2624. msgid ""
  2625. "<literal>build-dep</literal> causes apt-get to install/remove packages in an "
  2626. "attempt to satisfy the build dependencies for a source package."
  2627. msgstr ""
  2628. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2629. #: apt-get.8.xml:287
  2630. msgid "check"
  2631. msgstr ""
  2632. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2633. #: apt-get.8.xml:288
  2634. msgid ""
  2635. "<literal>check</literal> is a diagnostic tool; it updates the package cache "
  2636. "and checks for broken dependencies."
  2637. msgstr ""
  2638. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2639. #: apt-get.8.xml:293
  2640. msgid ""
  2641. "<literal>clean</literal> clears out the local repository of retrieved "
  2642. "package files. It removes everything but the lock file from "
  2643. "<filename>&cachedir;/archives/</filename> and "
  2644. "<filename>&cachedir;/archives/partial/</filename>. When APT is used as a "
  2645. "&dselect; method, <literal>clean</literal> is run automatically. Those who "
  2646. "do not use dselect will likely want to run <literal>apt-get clean</literal> "
  2647. "from time to time to free up disk space."
  2648. msgstr ""
  2649. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2650. #: apt-get.8.xml:302
  2651. msgid "autoclean"
  2652. msgstr ""
  2653. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2654. #: apt-get.8.xml:303
  2655. msgid ""
  2656. "Like <literal>clean</literal>, <literal>autoclean</literal> clears out the "
  2657. "local repository of retrieved package files. The difference is that it only "
  2658. "removes package files that can no longer be downloaded, and are largely "
  2659. "useless. This allows a cache to be maintained over a long period without it "
  2660. "growing out of control. The configuration option "
  2661. "<literal>APT::Clean-Installed</literal> will prevent installed packages from "
  2662. "being erased if it is set to off."
  2663. msgstr ""
  2664. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2665. #: apt-get.8.xml:312
  2666. msgid "autoremove"
  2667. msgstr ""
  2668. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2669. #: apt-get.8.xml:313
  2670. msgid ""
  2671. "<literal>autoremove</literal> is used to remove packages that were "
  2672. "automatically installed to satisfy dependencies for some package and that "
  2673. "are no more needed."
  2674. msgstr ""
  2675. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2676. #: apt-get.8.xml:323 apt-get.8.xml:429
  2677. msgid "<option>--no-install-recommends</option>"
  2678. msgstr ""
  2679. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2680. #: apt-get.8.xml:324
  2681. msgid ""
  2682. "Do not consider recommended packages as a dependency for installing. "
  2683. "Configuration Item: <literal>APT::Install-Recommends</literal>."
  2684. msgstr ""
  2685. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2686. #: apt-get.8.xml:328
  2687. msgid "<option>--download-only</option>"
  2688. msgstr ""
  2689. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2690. #: apt-get.8.xml:329
  2691. msgid ""
  2692. "Download only; package files are only retrieved, not unpacked or installed. "
  2693. "Configuration Item: <literal>APT::Get::Download-Only</literal>."
  2694. msgstr ""
  2695. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2696. #: apt-get.8.xml:333
  2697. msgid "<option>--fix-broken</option>"
  2698. msgstr ""
  2699. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2700. #: apt-get.8.xml:334
  2701. msgid ""
  2702. "Fix; attempt to correct a system with broken dependencies in place. This "
  2703. "option, when used with install/remove, can omit any packages to permit APT "
  2704. "to deduce a likely solution. Any Package that are specified must completely "
  2705. "correct the problem. The option is sometimes necessary when running APT for "
  2706. "the first time; APT itself does not allow broken package dependencies to "
  2707. "exist on a system. It is possible that a system's dependency structure can "
  2708. "be so corrupt as to require manual intervention (which usually means using "
  2709. "&dselect; or <command>dpkg --remove</command> to eliminate some of the "
  2710. "offending packages). Use of this option together with <option>-m</option> "
  2711. "may produce an error in some situations. Configuration Item: "
  2712. "<literal>APT::Get::Fix-Broken</literal>."
  2713. msgstr ""
  2714. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2715. #: apt-get.8.xml:347
  2716. msgid "<option>--ignore-missing</option>"
  2717. msgstr ""
  2718. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2719. #: apt-get.8.xml:348
  2720. msgid "<option>--fix-missing</option>"
  2721. msgstr ""
  2722. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2723. #: apt-get.8.xml:349
  2724. msgid ""
  2725. "Ignore missing packages; If packages cannot be retrieved or fail the "
  2726. "integrity check after retrieval (corrupted package files), hold back those "
  2727. "packages and handle the result. Use of this option together with "
  2728. "<option>-f</option> may produce an error in some situations. If a package is "
  2729. "selected for installation (particularly if it is mentioned on the command "
  2730. "line) and it could not be downloaded then it will be silently held back. "
  2731. "Configuration Item: <literal>APT::Get::Fix-Missing</literal>."
  2732. msgstr ""
  2733. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2734. #: apt-get.8.xml:359
  2735. msgid "<option>--no-download</option>"
  2736. msgstr ""
  2737. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2738. #: apt-get.8.xml:360
  2739. msgid ""
  2740. "Disables downloading of packages. This is best used with "
  2741. "<option>--ignore-missing</option> to force APT to use only the .debs it has "
  2742. "already downloaded. Configuration Item: "
  2743. "<literal>APT::Get::Download</literal>."
  2744. msgstr ""
  2745. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2746. #: apt-get.8.xml:367
  2747. msgid ""
  2748. "Quiet; produces output suitable for logging, omitting progress indicators. "
  2749. "More q's will produce more quiet up to a maximum of 2. You can also use "
  2750. "<option>-q=#</option> to set the quiet level, overriding the configuration "
  2751. "file. Note that quiet level 2 implies <option>-y</option>, you should never "
  2752. "use -qq without a no-action modifier such as -d, --print-uris or -s as APT "
  2753. "may decided to do something you did not expect. Configuration Item: "
  2754. "<literal>quiet</literal>."
  2755. msgstr ""
  2756. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2757. #: apt-get.8.xml:377
  2758. msgid "<option>--simulate</option>"
  2759. msgstr ""
  2760. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2761. #: apt-get.8.xml:379
  2762. msgid "<option>--dry-run</option>"
  2763. msgstr ""
  2764. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2765. #: apt-get.8.xml:382
  2766. msgid ""
  2767. "No action; perform a simulation of events that would occur but do not "
  2768. "actually change the system. Configuration Item: "
  2769. "<literal>APT::Get::Simulate</literal>."
  2770. msgstr ""
  2771. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2772. #: apt-get.8.xml:386
  2773. msgid ""
  2774. "Simulation run as user will deactivate locking "
  2775. "(<literal>Debug::NoLocking</literal>) automatic. Also a notice will be "
  2776. "displayed indicating that this is only a simulation, if the option "
  2777. "<literal>APT::Get::Show-User-Simulation-Note</literal> is set (Default: "
  2778. "true). Neither NoLocking nor the notice will be triggered if run as root "
  2779. "(root should know what he is doing without further warnings by "
  2780. "<literal>apt-get</literal>)."
  2781. msgstr ""
  2782. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2783. #: apt-get.8.xml:392
  2784. msgid ""
  2785. "Simulate prints out a series of lines each one representing a dpkg "
  2786. "operation, Configure (Conf), Remove (Remv), Unpack (Inst). Square brackets "
  2787. "indicate broken packages with and empty set of square brackets meaning "
  2788. "breaks that are of no consequence (rare)."
  2789. msgstr ""
  2790. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2791. #: apt-get.8.xml:399
  2792. msgid "<option>-y</option>"
  2793. msgstr ""
  2794. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2795. #: apt-get.8.xml:399
  2796. msgid "<option>--yes</option>"
  2797. msgstr ""
  2798. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2799. #: apt-get.8.xml:400
  2800. msgid "<option>--assume-yes</option>"
  2801. msgstr ""
  2802. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2803. #: apt-get.8.xml:401
  2804. msgid ""
  2805. "Automatic yes to prompts; assume \"yes\" as answer to all prompts and run "
  2806. "non-interactively. If an undesirable situation, such as changing a held "
  2807. "package, trying to install a unauthenticated package or removing an "
  2808. "essential package occurs then <literal>apt-get</literal> will abort. "
  2809. "Configuration Item: <literal>APT::Get::Assume-Yes</literal>."
  2810. msgstr ""
  2811. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2812. #: apt-get.8.xml:408
  2813. msgid "<option>-u</option>"
  2814. msgstr ""
  2815. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2816. #: apt-get.8.xml:408
  2817. msgid "<option>--show-upgraded</option>"
  2818. msgstr ""
  2819. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2820. #: apt-get.8.xml:409
  2821. msgid ""
  2822. "Show upgraded packages; Print out a list of all packages that are to be "
  2823. "upgraded. Configuration Item: <literal>APT::Get::Show-Upgraded</literal>."
  2824. msgstr ""
  2825. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2826. #: apt-get.8.xml:414
  2827. msgid "<option>-V</option>"
  2828. msgstr ""
  2829. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2830. #: apt-get.8.xml:414
  2831. msgid "<option>--verbose-versions</option>"
  2832. msgstr ""
  2833. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2834. #: apt-get.8.xml:415
  2835. msgid ""
  2836. "Show full versions for upgraded and installed packages. Configuration Item: "
  2837. "<literal>APT::Get::Show-Versions</literal>."
  2838. msgstr ""
  2839. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2840. #: apt-get.8.xml:419
  2841. msgid "<option>-b</option>"
  2842. msgstr ""
  2843. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2844. #: apt-get.8.xml:419
  2845. msgid "<option>--compile</option>"
  2846. msgstr ""
  2847. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2848. #: apt-get.8.xml:420
  2849. msgid "<option>--build</option>"
  2850. msgstr ""
  2851. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2852. #: apt-get.8.xml:421
  2853. msgid ""
  2854. "Compile source packages after downloading them. Configuration Item: "
  2855. "<literal>APT::Get::Compile</literal>."
  2856. msgstr ""
  2857. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2858. #: apt-get.8.xml:425
  2859. msgid "<option>--install-recommends</option>"
  2860. msgstr ""
  2861. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2862. #: apt-get.8.xml:426
  2863. msgid "Also install recommended packages."
  2864. msgstr ""
  2865. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2866. #: apt-get.8.xml:430
  2867. msgid "Do not install recommended packages."
  2868. msgstr ""
  2869. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2870. #: apt-get.8.xml:433
  2871. msgid "<option>--ignore-hold</option>"
  2872. msgstr ""
  2873. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2874. #: apt-get.8.xml:434
  2875. msgid ""
  2876. "Ignore package Holds; This causes <command>apt-get</command> to ignore a "
  2877. "hold placed on a package. This may be useful in conjunction with "
  2878. "<literal>dist-upgrade</literal> to override a large number of undesired "
  2879. "holds. Configuration Item: <literal>APT::Ignore-Hold</literal>."
  2880. msgstr ""
  2881. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2882. #: apt-get.8.xml:440
  2883. msgid "<option>--no-upgrade</option>"
  2884. msgstr ""
  2885. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2886. #: apt-get.8.xml:441
  2887. msgid ""
  2888. "Do not upgrade packages; When used in conjunction with "
  2889. "<literal>install</literal>, <literal>no-upgrade</literal> will prevent "
  2890. "packages on the command line from being upgraded if they are already "
  2891. "installed. Configuration Item: <literal>APT::Get::Upgrade</literal>."
  2892. msgstr ""
  2893. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2894. #: apt-get.8.xml:447
  2895. msgid "<option>--force-yes</option>"
  2896. msgstr ""
  2897. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2898. #: apt-get.8.xml:448
  2899. msgid ""
  2900. "Force yes; This is a dangerous option that will cause apt to continue "
  2901. "without prompting if it is doing something potentially harmful. It should "
  2902. "not be used except in very special situations. Using "
  2903. "<literal>force-yes</literal> can potentially destroy your system! "
  2904. "Configuration Item: <literal>APT::Get::force-yes</literal>."
  2905. msgstr ""
  2906. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2907. #: apt-get.8.xml:455
  2908. msgid "<option>--print-uris</option>"
  2909. msgstr ""
  2910. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2911. #: apt-get.8.xml:456
  2912. msgid ""
  2913. "Instead of fetching the files to install their URIs are printed. Each URI "
  2914. "will have the path, the destination file name, the size and the expected md5 "
  2915. "hash. Note that the file name to write to will not always match the file "
  2916. "name on the remote site! This also works with the <literal>source</literal> "
  2917. "and <literal>update</literal> commands. When used with the "
  2918. "<literal>update</literal> command the MD5 and size are not included, and it "
  2919. "is up to the user to decompress any compressed files. Configuration Item: "
  2920. "<literal>APT::Get::Print-URIs</literal>."
  2921. msgstr ""
  2922. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2923. #: apt-get.8.xml:466
  2924. msgid "<option>--purge</option>"
  2925. msgstr ""
  2926. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2927. #: apt-get.8.xml:467
  2928. msgid ""
  2929. "Use purge instead of remove for anything that would be removed. An asterisk "
  2930. "(\"*\") will be displayed next to packages which are scheduled to be "
  2931. "purged. <option>remove --purge</option> is equivalent for "
  2932. "<option>purge</option> command. Configuration Item: "
  2933. "<literal>APT::Get::Purge</literal>."
  2934. msgstr ""
  2935. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2936. #: apt-get.8.xml:474
  2937. msgid "<option>--reinstall</option>"
  2938. msgstr ""
  2939. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2940. #: apt-get.8.xml:475
  2941. msgid ""
  2942. "Re-Install packages that are already installed and at the newest version. "
  2943. "Configuration Item: <literal>APT::Get::ReInstall</literal>."
  2944. msgstr ""
  2945. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2946. #: apt-get.8.xml:479
  2947. msgid "<option>--list-cleanup</option>"
  2948. msgstr ""
  2949. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2950. #: apt-get.8.xml:480
  2951. msgid ""
  2952. "This option defaults to on, use <literal>--no-list-cleanup</literal> to turn "
  2953. "it off. When on <command>apt-get</command> will automatically manage the "
  2954. "contents of <filename>&statedir;/lists</filename> to ensure that obsolete "
  2955. "files are erased. The only reason to turn it off is if you frequently "
  2956. "change your source list. Configuration Item: "
  2957. "<literal>APT::Get::List-Cleanup</literal>."
  2958. msgstr ""
  2959. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2960. #: apt-get.8.xml:489
  2961. msgid "<option>--target-release</option>"
  2962. msgstr ""
  2963. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2964. #: apt-get.8.xml:490
  2965. msgid "<option>--default-release</option>"
  2966. msgstr ""
  2967. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2968. #: apt-get.8.xml:491
  2969. msgid ""
  2970. "This option controls the default input to the policy engine, it creates a "
  2971. "default pin at priority 990 using the specified release string. This "
  2972. "overrides the general settings in "
  2973. "<filename>/etc/apt/preferences</filename>. Specifically pinned packages are "
  2974. "not affected by the value of this option. In short, this option lets you "
  2975. "have simple control over which distribution packages will be retrieved "
  2976. "from. Some common examples might be <option>-t '2.1*'</option>, <option>-t "
  2977. "unstable</option> or <option>-t sid</option>. Configuration Item: "
  2978. "<literal>APT::Default-Release</literal>; see also the &apt-preferences; "
  2979. "manual page."
  2980. msgstr ""
  2981. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2982. #: apt-get.8.xml:504
  2983. msgid "<option>--trivial-only</option>"
  2984. msgstr ""
  2985. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2986. #: apt-get.8.xml:506
  2987. msgid ""
  2988. "Only perform operations that are 'trivial'. Logically this can be considered "
  2989. "related to <option>--assume-yes</option>, where "
  2990. "<option>--assume-yes</option> will answer yes to any prompt, "
  2991. "<option>--trivial-only</option> will answer no. Configuration Item: "
  2992. "<literal>APT::Get::Trivial-Only</literal>."
  2993. msgstr ""
  2994. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  2995. #: apt-get.8.xml:512
  2996. msgid "<option>--no-remove</option>"
  2997. msgstr ""
  2998. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  2999. #: apt-get.8.xml:513
  3000. msgid ""
  3001. "If any packages are to be removed apt-get immediately aborts without "
  3002. "prompting. Configuration Item: <literal>APT::Get::Remove</literal>."
  3003. msgstr ""
  3004. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3005. #: apt-get.8.xml:518
  3006. msgid "<option>--auto-remove</option>"
  3007. msgstr ""
  3008. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3009. #: apt-get.8.xml:519
  3010. msgid ""
  3011. "If the command is either <literal>install</literal> or "
  3012. "<literal>remove</literal>, then this option acts like running "
  3013. "<literal>autoremove</literal> command, removing the unused dependency "
  3014. "packages. Configuration Item: <literal>APT::Get::AutomaticRemove</literal>."
  3015. msgstr ""
  3016. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3017. #: apt-get.8.xml:525
  3018. msgid "<option>--only-source</option>"
  3019. msgstr ""
  3020. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3021. #: apt-get.8.xml:526
  3022. msgid ""
  3023. "Only has meaning for the <literal>source</literal> and "
  3024. "<literal>build-dep</literal> commands. Indicates that the given source "
  3025. "names are not to be mapped through the binary table. This means that if "
  3026. "this option is specified, these commands will only accept source package "
  3027. "names as arguments, rather than accepting binary package names and looking "
  3028. "up the corresponding source package. Configuration Item: "
  3029. "<literal>APT::Get::Only-Source</literal>."
  3030. msgstr ""
  3031. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3032. #: apt-get.8.xml:536
  3033. msgid "<option>--diff-only</option>"
  3034. msgstr ""
  3035. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3036. #: apt-get.8.xml:536
  3037. msgid "<option>--dsc-only</option>"
  3038. msgstr ""
  3039. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3040. #: apt-get.8.xml:536
  3041. msgid "<option>--tar-only</option>"
  3042. msgstr ""
  3043. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3044. #: apt-get.8.xml:537
  3045. msgid ""
  3046. "Download only the diff, dsc, or tar file of a source archive. Configuration "
  3047. "Item: <literal>APT::Get::Diff-Only</literal>, "
  3048. "<literal>APT::Get::Dsc-Only</literal>, and "
  3049. "<literal>APT::Get::Tar-Only</literal>."
  3050. msgstr ""
  3051. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3052. #: apt-get.8.xml:542
  3053. msgid "<option>--arch-only</option>"
  3054. msgstr ""
  3055. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3056. #: apt-get.8.xml:543
  3057. msgid ""
  3058. "Only process architecture-dependent build-dependencies. Configuration Item: "
  3059. "<literal>APT::Get::Arch-Only</literal>."
  3060. msgstr ""
  3061. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3062. #: apt-get.8.xml:547
  3063. msgid "<option>--allow-unauthenticated</option>"
  3064. msgstr ""
  3065. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3066. #: apt-get.8.xml:548
  3067. msgid ""
  3068. "Ignore if packages can't be authenticated and don't prompt about it. This "
  3069. "is useful for tools like pbuilder. Configuration Item: "
  3070. "<literal>APT::Get::AllowUnauthenticated</literal>."
  3071. msgstr ""
  3072. #. type: Content of: <refentry><refsect1><variablelist>
  3073. #: apt-get.8.xml:561
  3074. msgid ""
  3075. "&file-sourceslist; &file-aptconf; &file-preferences; &file-cachearchives; "
  3076. "&file-statelists;"
  3077. msgstr ""
  3078. #. type: Content of: <refentry><refsect1><para>
  3079. #: apt-get.8.xml:570
  3080. msgid ""
  3081. "&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, "
  3082. "&apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, "
  3083. "&apt-preferences;, the APT Howto."
  3084. msgstr ""
  3085. #. type: Content of: <refentry><refsect1><para>
  3086. #: apt-get.8.xml:576
  3087. msgid ""
  3088. "<command>apt-get</command> returns zero on normal operation, decimal 100 on "
  3089. "error."
  3090. msgstr ""
  3091. #. type: Content of: <refentry><refsect1><title>
  3092. #: apt-get.8.xml:579
  3093. msgid "ORIGINAL AUTHORS"
  3094. msgstr ""
  3095. #. type: Content of: <refentry><refsect1><para>
  3096. #: apt-get.8.xml:580
  3097. msgid "&apt-author.jgunthorpe;"
  3098. msgstr ""
  3099. #. type: Content of: <refentry><refsect1><title>
  3100. #: apt-get.8.xml:583
  3101. msgid "CURRENT AUTHORS"
  3102. msgstr ""
  3103. #. type: Content of: <refentry><refsect1><para>
  3104. #: apt-get.8.xml:585
  3105. msgid "&apt-author.team;"
  3106. msgstr ""
  3107. #. type: Content of: <refentry><refnamediv><refname>
  3108. #: apt-key.8.xml:14 apt-key.8.xml:21
  3109. msgid "apt-key"
  3110. msgstr ""
  3111. #. type: Content of: <refentry><refnamediv><refpurpose>
  3112. #: apt-key.8.xml:22
  3113. msgid "APT key management utility"
  3114. msgstr ""
  3115. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  3116. #: apt-key.8.xml:28
  3117. msgid ""
  3118. "<command>apt-key</command> <arg><replaceable>command</replaceable>/</arg> "
  3119. "<arg "
  3120. "rep=\"repeat\"><option><replaceable>arguments</replaceable></option></arg>"
  3121. msgstr ""
  3122. #. type: Content of: <refentry><refsect1><para>
  3123. #: apt-key.8.xml:36
  3124. msgid ""
  3125. "<command>apt-key</command> is used to manage the list of keys used by apt to "
  3126. "authenticate packages. Packages which have been authenticated using these "
  3127. "keys will be considered trusted."
  3128. msgstr ""
  3129. #. type: Content of: <refentry><refsect1><title>
  3130. #: apt-key.8.xml:42
  3131. msgid "Commands"
  3132. msgstr ""
  3133. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3134. #: apt-key.8.xml:44
  3135. msgid "add <replaceable>filename</replaceable>"
  3136. msgstr ""
  3137. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3138. #: apt-key.8.xml:48
  3139. msgid ""
  3140. "Add a new key to the list of trusted keys. The key is read from "
  3141. "<replaceable>filename</replaceable>, or standard input if "
  3142. "<replaceable>filename</replaceable> is <literal>-</literal>."
  3143. msgstr ""
  3144. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3145. #: apt-key.8.xml:56
  3146. msgid "del <replaceable>keyid</replaceable>"
  3147. msgstr ""
  3148. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3149. #: apt-key.8.xml:60
  3150. msgid "Remove a key from the list of trusted keys."
  3151. msgstr ""
  3152. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3153. #: apt-key.8.xml:67
  3154. msgid "export <replaceable>keyid</replaceable>"
  3155. msgstr ""
  3156. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3157. #: apt-key.8.xml:71
  3158. msgid "Output the key <replaceable>keyid</replaceable> to standard output."
  3159. msgstr ""
  3160. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3161. #: apt-key.8.xml:78
  3162. msgid "exportall"
  3163. msgstr ""
  3164. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3165. #: apt-key.8.xml:82
  3166. msgid "Output all trusted keys to standard output."
  3167. msgstr ""
  3168. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3169. #: apt-key.8.xml:89
  3170. msgid "list"
  3171. msgstr ""
  3172. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3173. #: apt-key.8.xml:93
  3174. msgid "List trusted keys."
  3175. msgstr ""
  3176. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3177. #: apt-key.8.xml:100
  3178. msgid "finger"
  3179. msgstr ""
  3180. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3181. #: apt-key.8.xml:104
  3182. msgid "List fingerprints of trusted keys."
  3183. msgstr ""
  3184. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3185. #: apt-key.8.xml:111
  3186. msgid "adv"
  3187. msgstr ""
  3188. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3189. #: apt-key.8.xml:115
  3190. msgid ""
  3191. "Pass advanced options to gpg. With adv --recv-key you can download the "
  3192. "public key."
  3193. msgstr ""
  3194. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3195. #: apt-key.8.xml:127
  3196. msgid ""
  3197. "Update the local keyring with the keyring of Debian archive keys and removes "
  3198. "from the keyring the archive keys which are no longer valid."
  3199. msgstr ""
  3200. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3201. #: apt-key.8.xml:140
  3202. msgid "<filename>/etc/apt/trusted.gpg</filename>"
  3203. msgstr ""
  3204. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3205. #: apt-key.8.xml:141
  3206. msgid "Keyring of local trusted keys, new keys will be added here."
  3207. msgstr ""
  3208. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3209. #: apt-key.8.xml:144
  3210. msgid "<filename>/etc/apt/trustdb.gpg</filename>"
  3211. msgstr ""
  3212. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3213. #: apt-key.8.xml:145
  3214. msgid "Local trust database of archive keys."
  3215. msgstr ""
  3216. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3217. #: apt-key.8.xml:148
  3218. msgid "<filename>/usr/share/keyrings/debian-archive-keyring.gpg</filename>"
  3219. msgstr ""
  3220. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3221. #: apt-key.8.xml:149
  3222. msgid "Keyring of Debian archive trusted keys."
  3223. msgstr ""
  3224. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3225. #: apt-key.8.xml:152
  3226. msgid "<filename>/usr/share/keyrings/debian-archive-removed-keys.gpg</filename>"
  3227. msgstr ""
  3228. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3229. #: apt-key.8.xml:153
  3230. msgid "Keyring of Debian archive removed trusted keys."
  3231. msgstr ""
  3232. #. type: Content of: <refentry><refsect1><para>
  3233. #: apt-key.8.xml:164
  3234. msgid "&apt-get;, &apt-secure;"
  3235. msgstr ""
  3236. #. The last update date
  3237. #. type: Content of: <refentry><refentryinfo>
  3238. #: apt-mark.8.xml:13
  3239. msgid ""
  3240. "&apt-author.moconnor; &apt-author.team; &apt-email; &apt-product; <date>9 "
  3241. "August 2009</date>"
  3242. msgstr ""
  3243. #. type: Content of: <refentry><refnamediv><refname>
  3244. #: apt-mark.8.xml:22 apt-mark.8.xml:29
  3245. msgid "apt-mark"
  3246. msgstr ""
  3247. #. type: Content of: <refentry><refnamediv><refpurpose>
  3248. #: apt-mark.8.xml:30
  3249. msgid "mark/unmark a package as being automatically-installed"
  3250. msgstr ""
  3251. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  3252. #: apt-mark.8.xml:36
  3253. msgid ""
  3254. " <command>apt-mark</command> <arg><option>-hv</option></arg> "
  3255. "<arg><option>-f=<replaceable>FILENAME</replaceable></option></arg> <group "
  3256. "choice=\"plain\"> <arg choice=\"plain\"> <group choice=\"req\"> <arg "
  3257. "choice=\"plain\">markauto</arg> <arg choice=\"plain\">unmarkauto</arg> "
  3258. "</group> <arg choice=\"plain\" "
  3259. "rep=\"repeat\"><replaceable>package</replaceable></arg> </arg> <arg "
  3260. "choice=\"plain\">showauto</arg> </group>"
  3261. msgstr ""
  3262. #. type: Content of: <refentry><refsect1><para>
  3263. #: apt-mark.8.xml:53
  3264. msgid ""
  3265. "<command>apt-mark</command> will change whether a package has been marked as "
  3266. "being automatically installed."
  3267. msgstr ""
  3268. #. type: Content of: <refentry><refsect1><para>
  3269. #: apt-mark.8.xml:57
  3270. msgid ""
  3271. "When you request that a package is installed, and as a result other packages "
  3272. "are installed to satisfy its dependencies, the dependencies are marked as "
  3273. "being automatically installed. Once these automatically installed packages "
  3274. "are no longer depended on by any manually installed packages, they will be "
  3275. "removed by e.g. <command>apt-get</command> or <command>aptitude</command>."
  3276. msgstr ""
  3277. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3278. #: apt-mark.8.xml:65
  3279. msgid "markauto"
  3280. msgstr ""
  3281. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3282. #: apt-mark.8.xml:66
  3283. msgid ""
  3284. "<literal>markauto</literal> is used to mark a package as being automatically "
  3285. "installed, which will cause the package to be removed when no more manually "
  3286. "installed packages depend on this package."
  3287. msgstr ""
  3288. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3289. #: apt-mark.8.xml:73
  3290. msgid "unmarkauto"
  3291. msgstr ""
  3292. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3293. #: apt-mark.8.xml:74
  3294. msgid ""
  3295. "<literal>unmarkauto</literal> is used to mark a package as being manually "
  3296. "installed, which will prevent the package from being automatically removed "
  3297. "if no other packages depend on it."
  3298. msgstr ""
  3299. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3300. #: apt-mark.8.xml:81
  3301. msgid "showauto"
  3302. msgstr ""
  3303. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3304. #: apt-mark.8.xml:82
  3305. msgid ""
  3306. "<literal>showauto</literal> is used to print a list of manually installed "
  3307. "packages with each package on a new line."
  3308. msgstr ""
  3309. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3310. #: apt-mark.8.xml:93
  3311. msgid "<option>-f=<filename><replaceable>FILENAME</replaceable></filename></option>"
  3312. msgstr ""
  3313. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3314. #: apt-mark.8.xml:94
  3315. msgid "<option>--file=<filename><replaceable>FILENAME</replaceable></filename></option>"
  3316. msgstr ""
  3317. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3318. #: apt-mark.8.xml:97
  3319. msgid ""
  3320. "Read/Write package stats from "
  3321. "<filename><replaceable>FILENAME</replaceable></filename> instead of the "
  3322. "default location, which is <filename>extended_status</filename> in the "
  3323. "directory defined by the Configuration Item: <literal>Dir::State</literal>."
  3324. msgstr ""
  3325. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3326. #: apt-mark.8.xml:103
  3327. msgid "<option>-h</option>"
  3328. msgstr ""
  3329. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3330. #: apt-mark.8.xml:104
  3331. msgid "<option>--help</option>"
  3332. msgstr ""
  3333. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3334. #: apt-mark.8.xml:105
  3335. msgid "Show a short usage summary."
  3336. msgstr ""
  3337. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3338. #: apt-mark.8.xml:111
  3339. msgid "<option>-v</option>"
  3340. msgstr ""
  3341. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3342. #: apt-mark.8.xml:112
  3343. msgid "<option>--version</option>"
  3344. msgstr ""
  3345. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3346. #: apt-mark.8.xml:113
  3347. msgid "Show the program version."
  3348. msgstr ""
  3349. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3350. #: apt-mark.8.xml:124
  3351. msgid "<filename>/var/lib/apt/extended_states</filename>"
  3352. msgstr ""
  3353. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3354. #: apt-mark.8.xml:125
  3355. msgid ""
  3356. "Status list of auto-installed packages. Configuration Item: "
  3357. "<literal>Dir::State</literal> sets the path to the "
  3358. "<filename>extended_states</filename> file."
  3359. msgstr ""
  3360. #. type: Content of: <refentry><refsect1><para>
  3361. #: apt-mark.8.xml:134
  3362. msgid "&apt-get;,&aptitude;,&apt-conf;"
  3363. msgstr ""
  3364. #. type: Content of: <refentry><refsect1><para>
  3365. #: apt-mark.8.xml:138
  3366. msgid ""
  3367. "<command>apt-mark</command> returns zero on normal operation, non-zero on "
  3368. "error."
  3369. msgstr ""
  3370. #. type: Content of: <refentry><refnamediv><refname>
  3371. #: apt-secure.8.xml:14 apt-secure.8.xml:36
  3372. msgid "apt-secure"
  3373. msgstr ""
  3374. #. type: Content of: <refentry><refnamediv><refpurpose>
  3375. #: apt-secure.8.xml:37
  3376. msgid "Archive authentication support for APT"
  3377. msgstr ""
  3378. #. type: Content of: <refentry><refsect1><para>
  3379. #: apt-secure.8.xml:42
  3380. msgid ""
  3381. "Starting with version 0.6, <command>apt</command> contains code that does "
  3382. "signature checking of the Release file for all archives. This ensures that "
  3383. "packages in the archive can't be modified by people who have no access to "
  3384. "the Release file signing key."
  3385. msgstr ""
  3386. #. type: Content of: <refentry><refsect1><para>
  3387. #: apt-secure.8.xml:50
  3388. msgid ""
  3389. "If a package comes from a archive without a signature or with a signature "
  3390. "that apt does not have a key for that package is considered untrusted and "
  3391. "installing it will result in a big warning. <command>apt-get</command> will "
  3392. "currently only warn for unsigned archives, future releases might force all "
  3393. "sources to be verified before downloading packages from them."
  3394. msgstr ""
  3395. #. type: Content of: <refentry><refsect1><para>
  3396. #: apt-secure.8.xml:59
  3397. msgid ""
  3398. "The package frontends &apt-get;, &aptitude; and &synaptic; support this new "
  3399. "authentication feature."
  3400. msgstr ""
  3401. #. type: Content of: <refentry><refsect1><title>
  3402. #: apt-secure.8.xml:64
  3403. msgid "Trusted archives"
  3404. msgstr ""
  3405. #. type: Content of: <refentry><refsect1><para>
  3406. #: apt-secure.8.xml:67
  3407. msgid ""
  3408. "The chain of trust from an apt archive to the end user is made up of "
  3409. "different steps. <command>apt-secure</command> is the last step in this "
  3410. "chain, trusting an archive does not mean that the packages that you trust it "
  3411. "do not contain malicious code but means that you trust the archive "
  3412. "maintainer. Its the archive maintainer responsibility to ensure that the "
  3413. "archive integrity is correct."
  3414. msgstr ""
  3415. #. type: Content of: <refentry><refsect1><para>
  3416. #: apt-secure.8.xml:75
  3417. msgid ""
  3418. "apt-secure does not review signatures at a package level. If you require "
  3419. "tools to do this you should look at <command>debsig-verify</command> and "
  3420. "<command>debsign</command> (provided in the debsig-verify and devscripts "
  3421. "packages respectively)."
  3422. msgstr ""
  3423. #. type: Content of: <refentry><refsect1><para>
  3424. #: apt-secure.8.xml:82
  3425. msgid ""
  3426. "The chain of trust in Debian starts when a maintainer uploads a new package "
  3427. "or a new version of a package to the Debian archive. This upload in order to "
  3428. "become effective needs to be signed by a key of a maintainer within the "
  3429. "Debian maintainer's keyring (available in the debian-keyring "
  3430. "package). Maintainer's keys are signed by other maintainers following "
  3431. "pre-established procedures to ensure the identity of the key holder."
  3432. msgstr ""
  3433. #. type: Content of: <refentry><refsect1><para>
  3434. #: apt-secure.8.xml:92
  3435. msgid ""
  3436. "Once the uploaded package is verified and included in the archive, the "
  3437. "maintainer signature is stripped off, an MD5 sum of the package is computed "
  3438. "and put in the Packages file. The MD5 sum of all of the packages files are "
  3439. "then computed and put into the Release file. The Release file is then signed "
  3440. "by the archive key (which is created once a year and distributed through the "
  3441. "FTP server. This key is also on the Debian keyring."
  3442. msgstr ""
  3443. #. type: Content of: <refentry><refsect1><para>
  3444. #: apt-secure.8.xml:102
  3445. msgid ""
  3446. "Any end user can check the signature of the Release file, extract the MD5 "
  3447. "sum of a package from it and compare it with the MD5 sum of the package he "
  3448. "downloaded. Prior to version 0.6 only the MD5 sum of the downloaded Debian "
  3449. "package was checked. Now both the MD5 sum and the signature of the Release "
  3450. "file are checked."
  3451. msgstr ""
  3452. #. type: Content of: <refentry><refsect1><para>
  3453. #: apt-secure.8.xml:109
  3454. msgid ""
  3455. "Notice that this is distinct from checking signatures on a per package "
  3456. "basis. It is designed to prevent two possible attacks:"
  3457. msgstr ""
  3458. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3459. #: apt-secure.8.xml:114
  3460. msgid ""
  3461. "<literal>Network \"man in the middle\" attacks</literal>. Without signature "
  3462. "checking, a malicious agent can introduce himself in the package download "
  3463. "process and provide malicious software either by controlling a network "
  3464. "element (router, switch, etc.) or by redirecting traffic to a rogue server "
  3465. "(through arp or DNS spoofing attacks)."
  3466. msgstr ""
  3467. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3468. #: apt-secure.8.xml:122
  3469. msgid ""
  3470. "<literal>Mirror network compromise</literal>. Without signature checking, a "
  3471. "malicious agent can compromise a mirror host and modify the files in it to "
  3472. "propagate malicious software to all users downloading packages from that "
  3473. "host."
  3474. msgstr ""
  3475. #. type: Content of: <refentry><refsect1><para>
  3476. #: apt-secure.8.xml:129
  3477. msgid ""
  3478. "However, it does not defend against a compromise of the Debian master server "
  3479. "itself (which signs the packages) or against a compromise of the key used to "
  3480. "sign the Release files. In any case, this mechanism can complement a "
  3481. "per-package signature."
  3482. msgstr ""
  3483. #. type: Content of: <refentry><refsect1><title>
  3484. #: apt-secure.8.xml:135
  3485. msgid "User configuration"
  3486. msgstr ""
  3487. #. type: Content of: <refentry><refsect1><para>
  3488. #: apt-secure.8.xml:137
  3489. msgid ""
  3490. "<command>apt-key</command> is the program that manages the list of keys used "
  3491. "by apt. It can be used to add or remove keys although an installation of "
  3492. "this release will automatically provide the default Debian archive signing "
  3493. "keys used in the Debian package repositories."
  3494. msgstr ""
  3495. #. type: Content of: <refentry><refsect1><para>
  3496. #: apt-secure.8.xml:144
  3497. msgid ""
  3498. "In order to add a new key you need to first download it (you should make "
  3499. "sure you are using a trusted communication channel when retrieving it), add "
  3500. "it with <command>apt-key</command> and then run <command>apt-get "
  3501. "update</command> so that apt can download and verify the "
  3502. "<filename>Release.gpg</filename> files from the archives you have "
  3503. "configured."
  3504. msgstr ""
  3505. #. type: Content of: <refentry><refsect1><title>
  3506. #: apt-secure.8.xml:153
  3507. msgid "Archive configuration"
  3508. msgstr ""
  3509. #. type: Content of: <refentry><refsect1><para>
  3510. #: apt-secure.8.xml:155
  3511. msgid ""
  3512. "If you want to provide archive signatures in an archive under your "
  3513. "maintenance you have to:"
  3514. msgstr ""
  3515. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3516. #: apt-secure.8.xml:160
  3517. msgid ""
  3518. "<literal>Create a toplevel Release file</literal>. if it does not exist "
  3519. "already. You can do this by running <command>apt-ftparchive "
  3520. "release</command> (provided in apt-utils)."
  3521. msgstr ""
  3522. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3523. #: apt-secure.8.xml:165
  3524. msgid ""
  3525. "<literal>Sign it</literal>. You can do this by running <command>gpg -abs -o "
  3526. "Release.gpg Release</command>."
  3527. msgstr ""
  3528. #. type: Content of: <refentry><refsect1><itemizedlist><listitem><para>
  3529. #: apt-secure.8.xml:168
  3530. msgid ""
  3531. "<literal>Publish the key fingerprint</literal>, that way your users will "
  3532. "know what key they need to import in order to authenticate the files in the "
  3533. "archive."
  3534. msgstr ""
  3535. #. type: Content of: <refentry><refsect1><para>
  3536. #: apt-secure.8.xml:175
  3537. msgid ""
  3538. "Whenever the contents of the archive changes (new packages are added or "
  3539. "removed) the archive maintainer has to follow the first two steps previously "
  3540. "outlined."
  3541. msgstr ""
  3542. #. type: Content of: <refentry><refsect1><para>
  3543. #: apt-secure.8.xml:183
  3544. msgid ""
  3545. "&apt-conf;, &apt-get;, &sources-list;, &apt-key;, &apt-ftparchive;, "
  3546. "&debsign; &debsig-verify;, &gpg;"
  3547. msgstr ""
  3548. #. type: Content of: <refentry><refsect1><para>
  3549. #: apt-secure.8.xml:187
  3550. msgid ""
  3551. "For more background information you might want to review the <ulink "
  3552. "url=\"http://www.debian.org/doc/manuals/securing-debian-howto/ch7.en.html\">Debian "
  3553. "Security Infrastructure</ulink> chapter of the Securing Debian Manual "
  3554. "(available also in the harden-doc package) and the <ulink "
  3555. "url=\"http://www.cryptnet.net/fdp/crypto/strong_distro.html\" >Strong "
  3556. "Distribution HOWTO</ulink> by V. Alex Brennen."
  3557. msgstr ""
  3558. #. type: Content of: <refentry><refsect1><title>
  3559. #: apt-secure.8.xml:200
  3560. msgid "Manpage Authors"
  3561. msgstr ""
  3562. #. type: Content of: <refentry><refsect1><para>
  3563. #: apt-secure.8.xml:202
  3564. msgid ""
  3565. "This man-page is based on the work of Javier Fernández-Sanguino Peña, Isaac "
  3566. "Jones, Colin Walters, Florian Weimer and Michael Vogt."
  3567. msgstr ""
  3568. #. type: Content of: <refentry><refnamediv><refname>
  3569. #: apt-sortpkgs.1.xml:22 apt-sortpkgs.1.xml:29
  3570. msgid "apt-sortpkgs"
  3571. msgstr ""
  3572. #. type: Content of: <refentry><refnamediv><refpurpose>
  3573. #: apt-sortpkgs.1.xml:30
  3574. msgid "Utility to sort package index files"
  3575. msgstr ""
  3576. #. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
  3577. #: apt-sortpkgs.1.xml:36
  3578. msgid ""
  3579. "<command>apt-sortpkgs</command> <arg><option>-hvs</option></arg> "
  3580. "<arg><option>-o=<replaceable>config string</replaceable></option></arg> "
  3581. "<arg><option>-c=<replaceable>file</replaceable></option></arg> <arg "
  3582. "choice=\"plain\" rep=\"repeat\"><replaceable>file</replaceable></arg>"
  3583. msgstr ""
  3584. #. type: Content of: <refentry><refsect1><para>
  3585. #: apt-sortpkgs.1.xml:45
  3586. msgid ""
  3587. "<command>apt-sortpkgs</command> will take an index file (Source index or "
  3588. "Package index) and sort the records so that they are ordered by the package "
  3589. "name. It will also sort the internal fields of each record according to the "
  3590. "internal sorting rules."
  3591. msgstr ""
  3592. #. type: Content of: <refentry><refsect1><para>
  3593. #: apt-sortpkgs.1.xml:51
  3594. msgid "All output is sent to stdout, the input must be a seekable file."
  3595. msgstr ""
  3596. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3597. #: apt-sortpkgs.1.xml:58
  3598. msgid "<option>--source</option>"
  3599. msgstr ""
  3600. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3601. #: apt-sortpkgs.1.xml:60
  3602. msgid ""
  3603. "Use Source index field ordering. Configuration Item: "
  3604. "<literal>APT::SortPkgs::Source</literal>."
  3605. msgstr ""
  3606. #. type: Content of: <refentry><refsect1><para>
  3607. #: apt-sortpkgs.1.xml:74
  3608. msgid ""
  3609. "<command>apt-sortpkgs</command> returns zero on normal operation, decimal "
  3610. "100 on error."
  3611. msgstr ""
  3612. #. The last update date
  3613. #. type: Content of: <refentry><refentryinfo>
  3614. #: apt.conf.5.xml:13
  3615. msgid ""
  3616. "&apt-author.jgunthorpe; &apt-author.team; <author> "
  3617. "<firstname>Daniel</firstname> <surname>Burrows</surname> <contrib>Initial "
  3618. "documentation of Debug::*.</contrib> <email>dburrows@debian.org</email> "
  3619. "</author> &apt-email; &apt-product; <date>18 September 2009</date>"
  3620. msgstr ""
  3621. #. type: Content of: <refentry><refnamediv><refname>
  3622. #: apt.conf.5.xml:28 apt.conf.5.xml:35
  3623. msgid "apt.conf"
  3624. msgstr ""
  3625. #. type: Content of: <refentry><refmeta><manvolnum>
  3626. #: apt.conf.5.xml:29 apt_preferences.5.xml:22 sources.list.5.xml:23
  3627. msgid "5"
  3628. msgstr ""
  3629. #. type: Content of: <refentry><refnamediv><refpurpose>
  3630. #: apt.conf.5.xml:36
  3631. msgid "Configuration file for APT"
  3632. msgstr ""
  3633. #. type: Content of: <refentry><refsect1><para>
  3634. #: apt.conf.5.xml:40
  3635. msgid ""
  3636. "<filename>apt.conf</filename> is the main configuration file for the APT "
  3637. "suite of tools, all tools make use of the configuration file and a common "
  3638. "command line parser to provide a uniform environment. When an APT tool "
  3639. "starts up it will read the configuration specified by the "
  3640. "<envar>APT_CONFIG</envar> environment variable (if any) and then read the "
  3641. "files in <literal>Dir::Etc::Parts</literal> then read the main configuration "
  3642. "file specified by <literal>Dir::Etc::main</literal> then finally apply the "
  3643. "command line options to override the configuration directives, possibly "
  3644. "loading even more config files."
  3645. msgstr ""
  3646. #. type: Content of: <refentry><refsect1><para>
  3647. #: apt.conf.5.xml:50
  3648. msgid ""
  3649. "The configuration file is organized in a tree with options organized into "
  3650. "functional groups. option specification is given with a double colon "
  3651. "notation, for instance <literal>APT::Get::Assume-Yes</literal> is an option "
  3652. "within the APT tool group, for the Get tool. options do not inherit from "
  3653. "their parent groups."
  3654. msgstr ""
  3655. #. type: Content of: <refentry><refsect1><para>
  3656. #: apt.conf.5.xml:56
  3657. msgid ""
  3658. "Syntactically the configuration language is modeled after what the ISC tools "
  3659. "such as bind and dhcp use. Lines starting with <literal>//</literal> are "
  3660. "treated as comments (ignored), as well as all text between "
  3661. "<literal>/*</literal> and <literal>*/</literal>, just like C/C++ comments. "
  3662. "Each line is of the form <literal>APT::Get::Assume-Yes \"true\";</literal> "
  3663. "The trailing semicolon is required and the quotes are optional. A new scope "
  3664. "can be opened with curly braces, like:"
  3665. msgstr ""
  3666. #. type: Content of: <refentry><refsect1><informalexample><programlisting>
  3667. #: apt.conf.5.xml:66
  3668. #, no-wrap
  3669. msgid ""
  3670. "APT {\n"
  3671. " Get {\n"
  3672. " Assume-Yes \"true\";\n"
  3673. " Fix-Broken \"true\";\n"
  3674. " };\n"
  3675. "};\n"
  3676. msgstr ""
  3677. #. type: Content of: <refentry><refsect1><para>
  3678. #: apt.conf.5.xml:74
  3679. msgid ""
  3680. "with newlines placed to make it more readable. Lists can be created by "
  3681. "opening a scope and including a single string enclosed in quotes followed by "
  3682. "a semicolon. Multiple entries can be included, each separated by a "
  3683. "semicolon."
  3684. msgstr ""
  3685. #. type: Content of: <refentry><refsect1><informalexample><programlisting>
  3686. #: apt.conf.5.xml:79
  3687. #, no-wrap
  3688. msgid "DPkg::Pre-Install-Pkgs {\"/usr/sbin/dpkg-preconfigure --apt\";};\n"
  3689. msgstr ""
  3690. #. type: Content of: <refentry><refsect1><para>
  3691. #: apt.conf.5.xml:82
  3692. msgid ""
  3693. "In general the sample configuration file in "
  3694. "<filename>&docdir;examples/apt.conf</filename> &configureindex; is a good "
  3695. "guide for how it should look."
  3696. msgstr ""
  3697. #. type: Content of: <refentry><refsect1><para>
  3698. #: apt.conf.5.xml:86
  3699. msgid ""
  3700. "The names of the configuration items are not case-sensitive. So in the "
  3701. "previous example you could use <literal>dpkg::pre-install-pkgs</literal>."
  3702. msgstr ""
  3703. #. type: Content of: <refentry><refsect1><para>
  3704. #: apt.conf.5.xml:89
  3705. msgid ""
  3706. "Names for the configuration items are optional if a list is defined as it "
  3707. "can be see in the <literal>DPkg::Pre-Install-Pkgs</literal> example "
  3708. "above. If you don't specify a name a new entry will simply add a new option "
  3709. "to the list. If you specify a name you can override the option as every "
  3710. "other option by reassigning a new value to the option."
  3711. msgstr ""
  3712. #. type: Content of: <refentry><refsect1><para>
  3713. #: apt.conf.5.xml:94
  3714. msgid ""
  3715. "Two specials are allowed, <literal>#include</literal> and "
  3716. "<literal>#clear</literal>: <literal>#include</literal> will include the "
  3717. "given file, unless the filename ends in a slash, then the whole directory is "
  3718. "included. <literal>#clear</literal> is used to erase a part of the "
  3719. "configuration tree. The specified element and all its descendants are "
  3720. "erased. (Note that these lines also need to end with a semicolon.)"
  3721. msgstr ""
  3722. #. type: Content of: <refentry><refsect1><para>
  3723. #: apt.conf.5.xml:101
  3724. msgid ""
  3725. "The #clear command is the only way to delete a list or a complete scope. "
  3726. "Reopening a scope or the ::-style described below will "
  3727. "<emphasis>not</emphasis> override previewsly written entries. Only options "
  3728. "can be overridden by adressing a new value to it - lists and scopes can't be "
  3729. "overridden, only cleared."
  3730. msgstr ""
  3731. #. type: Content of: <refentry><refsect1><para>
  3732. #: apt.conf.5.xml:106
  3733. msgid ""
  3734. "All of the APT tools take a -o option which allows an arbitrary "
  3735. "configuration directive to be specified on the command line. The syntax is a "
  3736. "full option name (<literal>APT::Get::Assume-Yes</literal> for instance) "
  3737. "followed by an equals sign then the new value of the option. Lists can be "
  3738. "appended too by adding a trailing :: to the list name. (As you might "
  3739. "suspect: The scope syntax can't be used on the commandline.)"
  3740. msgstr ""
  3741. #. type: Content of: <refentry><refsect1><para>
  3742. #: apt.conf.5.xml:113
  3743. msgid ""
  3744. "Note that you can use :: only for appending one item per line to a list and "
  3745. "that you should not use it in combination with the scope syntax. (The scope "
  3746. "syntax implicit insert ::) Using both syntaxes together will trigger a bug "
  3747. "which some users unfortunately relay on: An option with the unusual name "
  3748. "\"<literal>::</literal>\" which acts like every other option with a "
  3749. "name. These introduces many problems including that a user who writes "
  3750. "multiple lines in this <emphasis>wrong</emphasis> syntax in the hope to "
  3751. "append to a list will gain the opposite as only the last assignment for this "
  3752. "option \"<literal>::</literal>\" will be used. Upcoming APT versions will "
  3753. "raise errors and will stop working if they encounter this misuse, so please "
  3754. "correct such statements now as long as APT doesn't complain explicit about "
  3755. "them."
  3756. msgstr ""
  3757. #. type: Content of: <refentry><refsect1><title>
  3758. #: apt.conf.5.xml:125
  3759. msgid "The APT Group"
  3760. msgstr ""
  3761. #. type: Content of: <refentry><refsect1><para>
  3762. #: apt.conf.5.xml:126
  3763. msgid ""
  3764. "This group of options controls general APT behavior as well as holding the "
  3765. "options for all of the tools."
  3766. msgstr ""
  3767. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3768. #: apt.conf.5.xml:130
  3769. msgid "Architecture"
  3770. msgstr ""
  3771. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3772. #: apt.conf.5.xml:131
  3773. msgid ""
  3774. "System Architecture; sets the architecture to use when fetching files and "
  3775. "parsing package lists. The internal default is the architecture apt was "
  3776. "compiled for."
  3777. msgstr ""
  3778. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3779. #: apt.conf.5.xml:136
  3780. msgid "Default-Release"
  3781. msgstr ""
  3782. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3783. #: apt.conf.5.xml:137
  3784. msgid ""
  3785. "Default release to install packages from if more than one version "
  3786. "available. Contains release name, codename or release version. Examples: "
  3787. "'stable', 'testing', 'unstable', 'lenny', 'squeeze', '4.0', '5.0*'. See also "
  3788. "&apt-preferences;."
  3789. msgstr ""
  3790. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3791. #: apt.conf.5.xml:141
  3792. msgid "Ignore-Hold"
  3793. msgstr ""
  3794. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3795. #: apt.conf.5.xml:142
  3796. msgid ""
  3797. "Ignore Held packages; This global option causes the problem resolver to "
  3798. "ignore held packages in its decision making."
  3799. msgstr ""
  3800. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3801. #: apt.conf.5.xml:146
  3802. msgid "Clean-Installed"
  3803. msgstr ""
  3804. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3805. #: apt.conf.5.xml:147
  3806. msgid ""
  3807. "Defaults to on. When turned on the autoclean feature will remove any "
  3808. "packages which can no longer be downloaded from the cache. If turned off "
  3809. "then packages that are locally installed are also excluded from cleaning - "
  3810. "but note that APT provides no direct means to reinstall them."
  3811. msgstr ""
  3812. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3813. #: apt.conf.5.xml:153
  3814. msgid "Immediate-Configure"
  3815. msgstr ""
  3816. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3817. #: apt.conf.5.xml:154
  3818. msgid ""
  3819. "Disable Immediate Configuration; This dangerous option disables some of "
  3820. "APT's ordering code to cause it to make fewer dpkg calls. Doing so may be "
  3821. "necessary on some extremely slow single user systems but is very dangerous "
  3822. "and may cause package install scripts to fail or worse. Use at your own "
  3823. "risk."
  3824. msgstr ""
  3825. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3826. #: apt.conf.5.xml:161
  3827. msgid "Force-LoopBreak"
  3828. msgstr ""
  3829. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3830. #: apt.conf.5.xml:162
  3831. msgid ""
  3832. "Never Enable this option unless you -really- know what you are doing. It "
  3833. "permits APT to temporarily remove an essential package to break a "
  3834. "Conflicts/Conflicts or Conflicts/Pre-Depend loop between two essential "
  3835. "packages. SUCH A LOOP SHOULD NEVER EXIST AND IS A GRAVE BUG. This option "
  3836. "will work if the essential packages are not tar, gzip, libc, dpkg, bash or "
  3837. "anything that those packages depend on."
  3838. msgstr ""
  3839. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3840. #: apt.conf.5.xml:170
  3841. msgid "Cache-Limit"
  3842. msgstr ""
  3843. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3844. #: apt.conf.5.xml:171
  3845. msgid ""
  3846. "APT uses a fixed size memory mapped cache file to store the 'available' "
  3847. "information. This sets the size of that cache (in bytes)."
  3848. msgstr ""
  3849. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3850. #: apt.conf.5.xml:175
  3851. msgid "Build-Essential"
  3852. msgstr ""
  3853. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3854. #: apt.conf.5.xml:176
  3855. msgid "Defines which package(s) are considered essential build dependencies."
  3856. msgstr ""
  3857. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3858. #: apt.conf.5.xml:179
  3859. msgid "Get"
  3860. msgstr ""
  3861. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3862. #: apt.conf.5.xml:180
  3863. msgid ""
  3864. "The Get subsection controls the &apt-get; tool, please see its documentation "
  3865. "for more information about the options here."
  3866. msgstr ""
  3867. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3868. #: apt.conf.5.xml:184
  3869. msgid "Cache"
  3870. msgstr ""
  3871. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3872. #: apt.conf.5.xml:185
  3873. msgid ""
  3874. "The Cache subsection controls the &apt-cache; tool, please see its "
  3875. "documentation for more information about the options here."
  3876. msgstr ""
  3877. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  3878. #: apt.conf.5.xml:189
  3879. msgid "CDROM"
  3880. msgstr ""
  3881. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  3882. #: apt.conf.5.xml:190
  3883. msgid ""
  3884. "The CDROM subsection controls the &apt-cdrom; tool, please see its "
  3885. "documentation for more information about the options here."
  3886. msgstr ""
  3887. #. type: Content of: <refentry><refsect1><title>
  3888. #: apt.conf.5.xml:196
  3889. msgid "The Acquire Group"
  3890. msgstr ""
  3891. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3892. #: apt.conf.5.xml:201
  3893. msgid "PDiffs"
  3894. msgstr ""
  3895. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3896. #: apt.conf.5.xml:202
  3897. msgid ""
  3898. "Try to download deltas called <literal>PDiffs</literal> for Packages or "
  3899. "Sources files instead of downloading whole ones. True by default."
  3900. msgstr ""
  3901. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3902. #: apt.conf.5.xml:207
  3903. msgid "Queue-Mode"
  3904. msgstr ""
  3905. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3906. #: apt.conf.5.xml:208
  3907. msgid ""
  3908. "Queuing mode; <literal>Queue-Mode</literal> can be one of "
  3909. "<literal>host</literal> or <literal>access</literal> which determines how "
  3910. "APT parallelizes outgoing connections. <literal>host</literal> means that "
  3911. "one connection per target host will be opened, <literal>access</literal> "
  3912. "means that one connection per URI type will be opened."
  3913. msgstr ""
  3914. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3915. #: apt.conf.5.xml:215
  3916. msgid "Retries"
  3917. msgstr ""
  3918. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3919. #: apt.conf.5.xml:216
  3920. msgid ""
  3921. "Number of retries to perform. If this is non-zero APT will retry failed "
  3922. "files the given number of times."
  3923. msgstr ""
  3924. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3925. #: apt.conf.5.xml:220
  3926. msgid "Source-Symlinks"
  3927. msgstr ""
  3928. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3929. #: apt.conf.5.xml:221
  3930. msgid ""
  3931. "Use symlinks for source archives. If set to true then source archives will "
  3932. "be symlinked when possible instead of copying. True is the default."
  3933. msgstr ""
  3934. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3935. #: apt.conf.5.xml:225 sources.list.5.xml:139
  3936. msgid "http"
  3937. msgstr ""
  3938. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3939. #: apt.conf.5.xml:226
  3940. msgid ""
  3941. "HTTP URIs; http::Proxy is the default http proxy to use. It is in the "
  3942. "standard form of <literal>http://[[user][:pass]@]host[:port]/</literal>. Per "
  3943. "host proxies can also be specified by using the form "
  3944. "<literal>http::Proxy::&lt;host&gt;</literal> with the special keyword "
  3945. "<literal>DIRECT</literal> meaning to use no proxies. If no one of the above "
  3946. "settings is specified, <envar>http_proxy</envar> environment variable will "
  3947. "be used."
  3948. msgstr ""
  3949. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3950. #: apt.conf.5.xml:234
  3951. msgid ""
  3952. "Three settings are provided for cache control with HTTP/1.1 compliant proxy "
  3953. "caches. <literal>No-Cache</literal> tells the proxy to not use its cached "
  3954. "response under any circumstances, <literal>Max-Age</literal> is sent only "
  3955. "for index files and tells the cache to refresh its object if it is older "
  3956. "than the given number of seconds. Debian updates its index files daily so "
  3957. "the default is 1 day. <literal>No-Store</literal> specifies that the cache "
  3958. "should never store this request, it is only set for archive files. This may "
  3959. "be useful to prevent polluting a proxy cache with very large .deb "
  3960. "files. Note: Squid 2.0.2 does not support any of these options."
  3961. msgstr ""
  3962. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3963. #: apt.conf.5.xml:244 apt.conf.5.xml:301
  3964. msgid ""
  3965. "The option <literal>timeout</literal> sets the timeout timer used by the "
  3966. "method, this applies to all things including connection timeout and data "
  3967. "timeout."
  3968. msgstr ""
  3969. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3970. #: apt.conf.5.xml:247
  3971. msgid ""
  3972. "One setting is provided to control the pipeline depth in cases where the "
  3973. "remote server is not RFC conforming or buggy (such as Squid 2.0.2) "
  3974. "<literal>Acquire::http::Pipeline-Depth</literal> can be a value from 0 to 5 "
  3975. "indicating how many outstanding requests APT should send. A value of zero "
  3976. "MUST be specified if the remote host does not properly linger on TCP "
  3977. "connections - otherwise data corruption will occur. Hosts which require this "
  3978. "are in violation of RFC 2068."
  3979. msgstr ""
  3980. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3981. #: apt.conf.5.xml:255
  3982. msgid ""
  3983. "The used bandwidth can be limited with "
  3984. "<literal>Acquire::http::Dl-Limit</literal> which accepts integer values in "
  3985. "kilobyte. The default value is 0 which deactivates the limit and tries uses "
  3986. "as much as possible of the bandwith (Note that this option implicit "
  3987. "deactivates the download from multiple servers at the same time.)"
  3988. msgstr ""
  3989. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  3990. #: apt.conf.5.xml:261
  3991. msgid "https"
  3992. msgstr ""
  3993. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  3994. #: apt.conf.5.xml:262
  3995. msgid ""
  3996. "HTTPS URIs. Cache-control and proxy options are the same as for "
  3997. "<literal>http</literal> method. <literal>Pipeline-Depth</literal> option is "
  3998. "not supported yet."
  3999. msgstr ""
  4000. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4001. #: apt.conf.5.xml:266
  4002. msgid ""
  4003. "<literal>CaInfo</literal> suboption specifies place of file that holds info "
  4004. "about trusted certificates. <literal>&lt;host&gt;::CaInfo</literal> is "
  4005. "corresponding per-host option. <literal>Verify-Peer</literal> boolean "
  4006. "suboption determines whether verify server's host certificate against "
  4007. "trusted certificates or not. <literal>&lt;host&gt;::Verify-Peer</literal> "
  4008. "is corresponding per-host option. <literal>Verify-Host</literal> boolean "
  4009. "suboption determines whether verify server's hostname or not. "
  4010. "<literal>&lt;host&gt;::Verify-Host</literal> is corresponding per-host "
  4011. "option. <literal>SslCert</literal> determines what certificate to use for "
  4012. "client authentication. <literal>&lt;host&gt;::SslCert</literal> is "
  4013. "corresponding per-host option. <literal>SslKey</literal> determines what "
  4014. "private key to use for client "
  4015. "authentication. <literal>&lt;host&gt;::SslKey</literal> is corresponding "
  4016. "per-host option. <literal>SslForceVersion</literal> overrides default SSL "
  4017. "version to use. Can contain 'TLSv1' or 'SSLv3' string. "
  4018. "<literal>&lt;host&gt;::SslForceVersion</literal> is corresponding per-host "
  4019. "option."
  4020. msgstr ""
  4021. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4022. #: apt.conf.5.xml:284 sources.list.5.xml:150
  4023. msgid "ftp"
  4024. msgstr ""
  4025. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4026. #: apt.conf.5.xml:285
  4027. msgid ""
  4028. "FTP URIs; ftp::Proxy is the default ftp proxy to use. It is in the standard "
  4029. "form of <literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per host "
  4030. "proxies can also be specified by using the form "
  4031. "<literal>ftp::Proxy::&lt;host&gt;</literal> with the special keyword "
  4032. "<literal>DIRECT</literal> meaning to use no proxies. If no one of the above "
  4033. "settings is specified, <envar>ftp_proxy</envar> environment variable will be "
  4034. "used. To use a ftp proxy you will have to set the "
  4035. "<literal>ftp::ProxyLogin</literal> script in the configuration file. This "
  4036. "entry specifies the commands to send to tell the proxy server what to "
  4037. "connect to. Please see &configureindex; for an example of how to do "
  4038. "this. The substitution variables available are "
  4039. "<literal>$(PROXY_USER)</literal> <literal>$(PROXY_PASS)</literal> "
  4040. "<literal>$(SITE_USER)</literal> <literal>$(SITE_PASS)</literal> "
  4041. "<literal>$(SITE)</literal> and <literal>$(SITE_PORT)</literal> Each is taken "
  4042. "from it's respective URI component."
  4043. msgstr ""
  4044. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4045. #: apt.conf.5.xml:304
  4046. msgid ""
  4047. "Several settings are provided to control passive mode. Generally it is safe "
  4048. "to leave passive mode on, it works in nearly every environment. However "
  4049. "some situations require that passive mode be disabled and port mode ftp used "
  4050. "instead. This can be done globally, for connections that go through a proxy "
  4051. "or for a specific host (See the sample config file for examples)."
  4052. msgstr ""
  4053. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4054. #: apt.conf.5.xml:311
  4055. msgid ""
  4056. "It is possible to proxy FTP over HTTP by setting the "
  4057. "<envar>ftp_proxy</envar> environment variable to a http url - see the "
  4058. "discussion of the http method above for syntax. You cannot set this in the "
  4059. "configuration file and it is not recommended to use FTP over HTTP due to its "
  4060. "low efficiency."
  4061. msgstr ""
  4062. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4063. #: apt.conf.5.xml:316
  4064. msgid ""
  4065. "The setting <literal>ForceExtended</literal> controls the use of RFC2428 "
  4066. "<literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is "
  4067. "false, which means these commands are only used if the control connection is "
  4068. "IPv6. Setting this to true forces their use even on IPv4 connections. Note "
  4069. "that most FTP servers do not support RFC2428."
  4070. msgstr ""
  4071. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4072. #: apt.conf.5.xml:323 sources.list.5.xml:132
  4073. msgid "cdrom"
  4074. msgstr ""
  4075. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout>
  4076. #: apt.conf.5.xml:329
  4077. #, no-wrap
  4078. msgid "\"/cdrom/\"::Mount \"foo\";"
  4079. msgstr ""
  4080. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4081. #: apt.conf.5.xml:324
  4082. msgid ""
  4083. "CDROM URIs; the only setting for CDROM URIs is the mount point, "
  4084. "<literal>cdrom::Mount</literal> which must be the mount point for the CDROM "
  4085. "drive as specified in <filename>/etc/fstab</filename>. It is possible to "
  4086. "provide alternate mount and unmount commands if your mount point cannot be "
  4087. "listed in the fstab (such as an SMB mount and old mount packages). The "
  4088. "syntax is to put <placeholder type=\"literallayout\" id=\"0\"/> within the "
  4089. "cdrom block. It is important to have the trailing slash. Unmount commands "
  4090. "can be specified using UMount."
  4091. msgstr ""
  4092. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4093. #: apt.conf.5.xml:334
  4094. msgid "gpgv"
  4095. msgstr ""
  4096. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4097. #: apt.conf.5.xml:335
  4098. msgid ""
  4099. "GPGV URIs; the only option for GPGV URIs is the option to pass additional "
  4100. "parameters to gpgv. <literal>gpgv::Options</literal> Additional options "
  4101. "passed to gpgv."
  4102. msgstr ""
  4103. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  4104. #: apt.conf.5.xml:340
  4105. msgid "CompressionTypes"
  4106. msgstr ""
  4107. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  4108. #: apt.conf.5.xml:346
  4109. #, no-wrap
  4110. msgid ""
  4111. "Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> "
  4112. "\"<replaceable>Methodname</replaceable>\";"
  4113. msgstr ""
  4114. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4115. #: apt.conf.5.xml:341
  4116. msgid ""
  4117. "List of compression types which are understood by the acquire methods. "
  4118. "Files like <filename>Packages</filename> can be available in various "
  4119. "compression formats. Per default the acquire methods can decompress "
  4120. "<command>bzip2</command>, <command>lzma</command> and "
  4121. "<command>gzip</command> compressed files, with this setting more formats can "
  4122. "be added on the fly or the used method can be changed. The syntax for this "
  4123. "is: <placeholder type=\"synopsis\" id=\"0\"/>"
  4124. msgstr ""
  4125. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  4126. #: apt.conf.5.xml:351
  4127. #, no-wrap
  4128. msgid "Acquire::CompressionTypes::Order:: \"gz\";"
  4129. msgstr ""
  4130. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><synopsis>
  4131. #: apt.conf.5.xml:354
  4132. #, no-wrap
  4133. msgid "Acquire::CompressionTypes::Order { \"lzma\"; \"gz\"; };"
  4134. msgstr ""
  4135. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4136. #: apt.conf.5.xml:347
  4137. msgid ""
  4138. "Also the <literal>Order</literal> subgroup can be used to define in which "
  4139. "order the acquire system will try to download the compressed files. The "
  4140. "acquire system will try the first and proceed with the next compression type "
  4141. "in this list on error, so to prefer one over the other type simple add the "
  4142. "preferred type at first - not already added default types will be added at "
  4143. "run time to the end of the list, so e.g. <placeholder type=\"synopsis\" "
  4144. "id=\"0\"/> can be used to prefer <command>gzip</command> compressed files "
  4145. "over <command>bzip2</command> and <command>lzma</command>. If "
  4146. "<command>lzma</command> should be preferred over <command>gzip</command> and "
  4147. "<command>bzip2</command> the configure setting should look like this "
  4148. "<placeholder type=\"synopsis\" id=\"1\"/> It is not needed to add "
  4149. "<literal>bz2</literal> explicit to the list as it will be added automatic."
  4150. msgstr ""
  4151. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para><literallayout>
  4152. #: apt.conf.5.xml:358
  4153. #, no-wrap
  4154. msgid "Dir::Bin::bzip2 \"/bin/bzip2\";"
  4155. msgstr ""
  4156. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4157. #: apt.conf.5.xml:356
  4158. msgid ""
  4159. "Note that at run time the "
  4160. "<literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will be "
  4161. "checked: If this setting exists the method will only be used if this file "
  4162. "exists, e.g. for the bzip2 method (the inbuilt) setting is <placeholder "
  4163. "type=\"literallayout\" id=\"0\"/> Note also that list entries specified on "
  4164. "the commandline will be added at the end of the list specified in the "
  4165. "configuration files, but before the default entries. To prefer a type in "
  4166. "this case over the ones specified in in the configuration files you can set "
  4167. "the option direct - not in list style. This will not override the defined "
  4168. "list, it will only prefix the list with this type."
  4169. msgstr ""
  4170. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  4171. #: apt.conf.5.xml:363
  4172. msgid ""
  4173. "While it is possible to add an empty compression type to the order list, but "
  4174. "APT in its current version doesn't understand it correctly and will display "
  4175. "many warnings about not downloaded files - these warnings are most of the "
  4176. "time false negatives. Future versions will maybe include a way to really "
  4177. "prefer uncompressed files to support the usage of local mirrors."
  4178. msgstr ""
  4179. #. type: Content of: <refentry><refsect1><para>
  4180. #: apt.conf.5.xml:197
  4181. msgid ""
  4182. "The <literal>Acquire</literal> group of options controls the download of "
  4183. "packages and the URI handlers. <placeholder type=\"variablelist\" "
  4184. "id=\"0\"/>"
  4185. msgstr ""
  4186. #. type: Content of: <refentry><refsect1><title>
  4187. #: apt.conf.5.xml:372
  4188. msgid "Directories"
  4189. msgstr ""
  4190. #. type: Content of: <refentry><refsect1><para>
  4191. #: apt.conf.5.xml:374
  4192. msgid ""
  4193. "The <literal>Dir::State</literal> section has directories that pertain to "
  4194. "local state information. <literal>lists</literal> is the directory to place "
  4195. "downloaded package lists in and <literal>status</literal> is the name of the "
  4196. "dpkg status file. <literal>preferences</literal> is the name of the APT "
  4197. "preferences file. <literal>Dir::State</literal> contains the default "
  4198. "directory to prefix on all sub items if they do not start with "
  4199. "<filename>/</filename> or <filename>./</filename>."
  4200. msgstr ""
  4201. #. type: Content of: <refentry><refsect1><para>
  4202. #: apt.conf.5.xml:381
  4203. msgid ""
  4204. "<literal>Dir::Cache</literal> contains locations pertaining to local cache "
  4205. "information, such as the two package caches <literal>srcpkgcache</literal> "
  4206. "and <literal>pkgcache</literal> as well as the location to place downloaded "
  4207. "archives, <literal>Dir::Cache::archives</literal>. Generation of caches can "
  4208. "be turned off by setting their names to be blank. This will slow down "
  4209. "startup but save disk space. It is probably preferred to turn off the "
  4210. "pkgcache rather than the srcpkgcache. Like <literal>Dir::State</literal> the "
  4211. "default directory is contained in <literal>Dir::Cache</literal>"
  4212. msgstr ""
  4213. #. type: Content of: <refentry><refsect1><para>
  4214. #: apt.conf.5.xml:390
  4215. msgid ""
  4216. "<literal>Dir::Etc</literal> contains the location of configuration files, "
  4217. "<literal>sourcelist</literal> gives the location of the sourcelist and "
  4218. "<literal>main</literal> is the default configuration file (setting has no "
  4219. "effect, unless it is done from the config file specified by "
  4220. "<envar>APT_CONFIG</envar>)."
  4221. msgstr ""
  4222. #. type: Content of: <refentry><refsect1><para>
  4223. #: apt.conf.5.xml:396
  4224. msgid ""
  4225. "The <literal>Dir::Parts</literal> setting reads in all the config fragments "
  4226. "in lexical order from the directory specified. After this is done then the "
  4227. "main config file is loaded."
  4228. msgstr ""
  4229. #. type: Content of: <refentry><refsect1><para>
  4230. #: apt.conf.5.xml:400
  4231. msgid ""
  4232. "Binary programs are pointed to by "
  4233. "<literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> specifies "
  4234. "the location of the method handlers and <literal>gzip</literal>, "
  4235. "<literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, "
  4236. "<literal>apt-get</literal> <literal>dpkg-source</literal> "
  4237. "<literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> "
  4238. "specify the location of the respective programs."
  4239. msgstr ""
  4240. #. type: Content of: <refentry><refsect1><para>
  4241. #: apt.conf.5.xml:408
  4242. msgid ""
  4243. "The configuration item <literal>RootDir</literal> has a special meaning. If "
  4244. "set, all paths in <literal>Dir::</literal> will be relative to "
  4245. "<literal>RootDir</literal>, <emphasis>even paths that are specified "
  4246. "absolutely</emphasis>. So, for instance, if <literal>RootDir</literal> is "
  4247. "set to <filename>/tmp/staging</filename> and "
  4248. "<literal>Dir::State::status</literal> is set to "
  4249. "<filename>/var/lib/dpkg/status</filename>, then the status file will be "
  4250. "looked up in <filename>/tmp/staging/var/lib/dpkg/status</filename>."
  4251. msgstr ""
  4252. #. type: Content of: <refentry><refsect1><title>
  4253. #: apt.conf.5.xml:421
  4254. msgid "APT in DSelect"
  4255. msgstr ""
  4256. #. type: Content of: <refentry><refsect1><para>
  4257. #: apt.conf.5.xml:423
  4258. msgid ""
  4259. "When APT is used as a &dselect; method several configuration directives "
  4260. "control the default behaviour. These are in the <literal>DSelect</literal> "
  4261. "section."
  4262. msgstr ""
  4263. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4264. #: apt.conf.5.xml:427
  4265. msgid "Clean"
  4266. msgstr ""
  4267. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4268. #: apt.conf.5.xml:428
  4269. msgid ""
  4270. "Cache Clean mode; this value may be one of always, prompt, auto, pre-auto "
  4271. "and never. always and prompt will remove all packages from the cache after "
  4272. "upgrading, prompt (the default) does so conditionally. auto removes only "
  4273. "those packages which are no longer downloadable (replaced with a new version "
  4274. "for instance). pre-auto performs this action before downloading new "
  4275. "packages."
  4276. msgstr ""
  4277. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4278. #: apt.conf.5.xml:437
  4279. msgid ""
  4280. "The contents of this variable is passed to &apt-get; as command line options "
  4281. "when it is run for the install phase."
  4282. msgstr ""
  4283. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4284. #: apt.conf.5.xml:441
  4285. msgid "Updateoptions"
  4286. msgstr ""
  4287. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4288. #: apt.conf.5.xml:442
  4289. msgid ""
  4290. "The contents of this variable is passed to &apt-get; as command line options "
  4291. "when it is run for the update phase."
  4292. msgstr ""
  4293. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4294. #: apt.conf.5.xml:446
  4295. msgid "PromptAfterUpdate"
  4296. msgstr ""
  4297. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4298. #: apt.conf.5.xml:447
  4299. msgid ""
  4300. "If true the [U]pdate operation in &dselect; will always prompt to continue. "
  4301. "The default is to prompt only on error."
  4302. msgstr ""
  4303. #. type: Content of: <refentry><refsect1><title>
  4304. #: apt.conf.5.xml:453
  4305. msgid "How APT calls dpkg"
  4306. msgstr ""
  4307. #. type: Content of: <refentry><refsect1><para>
  4308. #: apt.conf.5.xml:454
  4309. msgid ""
  4310. "Several configuration directives control how APT invokes &dpkg;. These are "
  4311. "in the <literal>DPkg</literal> section."
  4312. msgstr ""
  4313. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4314. #: apt.conf.5.xml:459
  4315. msgid ""
  4316. "This is a list of options to pass to dpkg. The options must be specified "
  4317. "using the list notation and each list item is passed as a single argument to "
  4318. "&dpkg;."
  4319. msgstr ""
  4320. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4321. #: apt.conf.5.xml:464
  4322. msgid "Pre-Invoke"
  4323. msgstr ""
  4324. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4325. #: apt.conf.5.xml:464
  4326. msgid "Post-Invoke"
  4327. msgstr ""
  4328. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4329. #: apt.conf.5.xml:465
  4330. msgid ""
  4331. "This is a list of shell commands to run before/after invoking &dpkg;. Like "
  4332. "<literal>options</literal> this must be specified in list notation. The "
  4333. "commands are invoked in order using <filename>/bin/sh</filename>, should any "
  4334. "fail APT will abort."
  4335. msgstr ""
  4336. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4337. #: apt.conf.5.xml:471
  4338. msgid "Pre-Install-Pkgs"
  4339. msgstr ""
  4340. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4341. #: apt.conf.5.xml:472
  4342. msgid ""
  4343. "This is a list of shell commands to run before invoking dpkg. Like "
  4344. "<literal>options</literal> this must be specified in list notation. The "
  4345. "commands are invoked in order using <filename>/bin/sh</filename>, should any "
  4346. "fail APT will abort. APT will pass to the commands on standard input the "
  4347. "filenames of all .deb files it is going to install, one per line."
  4348. msgstr ""
  4349. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4350. #: apt.conf.5.xml:478
  4351. msgid ""
  4352. "Version 2 of this protocol dumps more information, including the protocol "
  4353. "version, the APT configuration space and the packages, files and versions "
  4354. "being changed. Version 2 is enabled by setting "
  4355. "<literal>DPkg::Tools::options::cmd::Version</literal> to "
  4356. "2. <literal>cmd</literal> is a command given to "
  4357. "<literal>Pre-Install-Pkgs</literal>."
  4358. msgstr ""
  4359. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4360. #: apt.conf.5.xml:485
  4361. msgid "Run-Directory"
  4362. msgstr ""
  4363. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4364. #: apt.conf.5.xml:486
  4365. msgid ""
  4366. "APT chdirs to this directory before invoking dpkg, the default is "
  4367. "<filename>/</filename>."
  4368. msgstr ""
  4369. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4370. #: apt.conf.5.xml:490
  4371. msgid "Build-options"
  4372. msgstr ""
  4373. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4374. #: apt.conf.5.xml:491
  4375. msgid ""
  4376. "These options are passed to &dpkg-buildpackage; when compiling packages, the "
  4377. "default is to disable signing and produce all binaries."
  4378. msgstr ""
  4379. #. type: Content of: <refentry><refsect1><refsect2><title>
  4380. #: apt.conf.5.xml:496
  4381. msgid "dpkg trigger usage (and related options)"
  4382. msgstr ""
  4383. #. type: Content of: <refentry><refsect1><refsect2><para>
  4384. #: apt.conf.5.xml:497
  4385. msgid ""
  4386. "APT can call dpkg in a way so it can make aggressive use of triggers over "
  4387. "multiply calls of dpkg. Without further options dpkg will use triggers only "
  4388. "in between his own run. Activating these options can therefore decrease the "
  4389. "time needed to perform the install / upgrade. Note that it is intended to "
  4390. "activate these options per default in the future, but as it changes the way "
  4391. "APT calling dpkg drastical it needs a lot more testing. <emphasis>These "
  4392. "options are therefore currently experimental and should not be used in "
  4393. "productive environments.</emphasis> Also it breaks the progress reporting so "
  4394. "all frontends will currently stay around half (or more) of the time in the "
  4395. "100% state while it actually configures all packages."
  4396. msgstr ""
  4397. #. type: Content of: <refentry><refsect1><refsect2><para><literallayout>
  4398. #: apt.conf.5.xml:512
  4399. #, no-wrap
  4400. msgid ""
  4401. "DPkg::NoTriggers \"true\";\n"
  4402. "PackageManager::Configure \"smart\";\n"
  4403. "DPkg::ConfigurePending \"true\";\n"
  4404. "DPkg::TriggersPending \"true\";"
  4405. msgstr ""
  4406. #. type: Content of: <refentry><refsect1><refsect2><para>
  4407. #: apt.conf.5.xml:506
  4408. msgid ""
  4409. "Note that it is not garanteed that APT will support these options or that "
  4410. "these options will not cause (big) trouble in the future. If you have "
  4411. "understand the current risks and problems with these options, but are brave "
  4412. "enough to help testing them create a new configuration file and test a "
  4413. "combination of options. Please report any bugs, problems and improvements "
  4414. "you encounter and make sure to note which options you have used in your "
  4415. "reports. Asking dpkg for help could also be useful for debugging proposes, "
  4416. "see e.g. <command>dpkg --audit</command>. A defensive option combination "
  4417. "would be <placeholder type=\"literallayout\" id=\"0\"/>"
  4418. msgstr ""
  4419. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4420. #: apt.conf.5.xml:518
  4421. msgid "DPkg::NoTriggers"
  4422. msgstr ""
  4423. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4424. #: apt.conf.5.xml:519
  4425. msgid ""
  4426. "Add the no triggers flag to all dpkg calls (expect the ConfigurePending "
  4427. "call). See &dpkg; if you are interested in what this actually means. In "
  4428. "short: dpkg will not run the triggers then this flag is present unless it is "
  4429. "explicit called to do so in an extra call. Note that this option exists "
  4430. "(undocumented) also in older apt versions with a slightly different meaning: "
  4431. "Previously these option only append --no-triggers to the configure calls to "
  4432. "dpkg - now apt will add these flag also to the unpack and remove calls."
  4433. msgstr ""
  4434. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4435. #: apt.conf.5.xml:526
  4436. msgid "PackageManager::Configure"
  4437. msgstr ""
  4438. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4439. #: apt.conf.5.xml:527
  4440. msgid ""
  4441. "Valid values are \"<literal>all</literal>\", \"<literal>smart</literal>\" "
  4442. "and \"<literal>no</literal>\". \"<literal>all</literal>\" is the default "
  4443. "value and causes APT to configure all packages explicit. The "
  4444. "\"<literal>smart</literal>\" way is it to configure only packages which need "
  4445. "to be configured before another package can be unpacked (Pre-Depends) and "
  4446. "let the rest configure by dpkg with a call generated by the next "
  4447. "option. \"<literal>no</literal>\" on the other hand will not configure "
  4448. "anything and totally relay on dpkg for configuration (which will at the "
  4449. "moment fail if a Pre-Depends is encountered). Setting this option to "
  4450. "another than the all value will implicit activate also the next option per "
  4451. "default as otherwise the system could end in an unconfigured status which "
  4452. "could be unbootable!"
  4453. msgstr ""
  4454. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4455. #: apt.conf.5.xml:537
  4456. msgid "DPkg::ConfigurePending"
  4457. msgstr ""
  4458. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4459. #: apt.conf.5.xml:538
  4460. msgid ""
  4461. "If this option is set apt will call <command>dpkg --configure "
  4462. "--pending</command> to let dpkg handle all required configurations and "
  4463. "triggers. This option is activated automatic per default if the previous "
  4464. "option is not set to <literal>all</literal>, but deactivating could be "
  4465. "useful if you want to run APT multiple times in a row - e.g. in an "
  4466. "installer. In this sceneries you could deactivate this option in all but the "
  4467. "last run."
  4468. msgstr ""
  4469. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4470. #: apt.conf.5.xml:544
  4471. msgid "DPkg::TriggersPending"
  4472. msgstr ""
  4473. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4474. #: apt.conf.5.xml:545
  4475. msgid ""
  4476. "Useful for <literal>smart</literal> configuration as a package which has "
  4477. "pending triggers is not considered as <literal>installed</literal> and dpkg "
  4478. "treats them as <literal>unpacked</literal> currently which is a dealbreaker "
  4479. "for Pre-Dependencies (see debbugs #526774). Note that this will process all "
  4480. "triggers, not only the triggers needed to configure this package."
  4481. msgstr ""
  4482. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4483. #: apt.conf.5.xml:550
  4484. msgid "PackageManager::UnpackAll"
  4485. msgstr ""
  4486. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4487. #: apt.conf.5.xml:551
  4488. msgid ""
  4489. "As the configuration can be deferred to be done at the end by dpkg it can be "
  4490. "tried to order the unpack series only by critical needs, e.g. by "
  4491. "Pre-Depends. Default is true and therefore the \"old\" method of ordering in "
  4492. "verious steps by everything. While both method were present in earlier APT "
  4493. "versions the <literal>OrderCritical</literal> method was unused, so this "
  4494. "method is very experimental and needs further improvements before becoming "
  4495. "really useful."
  4496. msgstr ""
  4497. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><term>
  4498. #: apt.conf.5.xml:558
  4499. msgid "OrderList::Score::Immediate"
  4500. msgstr ""
  4501. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para><literallayout>
  4502. #: apt.conf.5.xml:566
  4503. #, no-wrap
  4504. msgid ""
  4505. "OrderList::Score {\n"
  4506. "\tDelete 500;\n"
  4507. "\tEssential 200;\n"
  4508. "\tImmediate 10;\n"
  4509. "\tPreDepends 50;\n"
  4510. "};"
  4511. msgstr ""
  4512. #. type: Content of: <refentry><refsect1><refsect2><variablelist><varlistentry><listitem><para>
  4513. #: apt.conf.5.xml:559
  4514. msgid ""
  4515. "Essential packages (and there dependencies) should be configured immediately "
  4516. "after unpacking. It will be a good idea to do this quite early in the "
  4517. "upgrade process as these these configure calls require currently also "
  4518. "<literal>DPkg::TriggersPending</literal> which will run quite a few triggers "
  4519. "(which maybe not needed). Essentials get per default a high score but the "
  4520. "immediate flag is relativly low (a package which has a Pre-Depends is higher "
  4521. "rated). These option and the others in the same group can be used to change "
  4522. "the scoring. The following example shows the settings with there default "
  4523. "values. <placeholder type=\"literallayout\" id=\"0\"/>"
  4524. msgstr ""
  4525. #. type: Content of: <refentry><refsect1><title>
  4526. #: apt.conf.5.xml:579
  4527. msgid "Periodic and Archives options"
  4528. msgstr ""
  4529. #. type: Content of: <refentry><refsect1><para>
  4530. #: apt.conf.5.xml:580
  4531. msgid ""
  4532. "<literal>APT::Periodic</literal> and <literal>APT::Archives</literal> groups "
  4533. "of options configure behavior of apt periodic updates, which is done by "
  4534. "<literal>/etc/cron.daily/apt</literal> script. See header of this script for "
  4535. "the brief documentation of these options."
  4536. msgstr ""
  4537. #. type: Content of: <refentry><refsect1><title>
  4538. #: apt.conf.5.xml:588
  4539. msgid "Debug options"
  4540. msgstr ""
  4541. #. type: Content of: <refentry><refsect1><para>
  4542. #: apt.conf.5.xml:590
  4543. msgid ""
  4544. "Enabling options in the <literal>Debug::</literal> section will cause "
  4545. "debugging information to be sent to the standard error stream of the program "
  4546. "utilizing the <literal>apt</literal> libraries, or enable special program "
  4547. "modes that are primarily useful for debugging the behavior of "
  4548. "<literal>apt</literal>. Most of these options are not interesting to a "
  4549. "normal user, but a few may be:"
  4550. msgstr ""
  4551. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4552. #: apt.conf.5.xml:601
  4553. msgid ""
  4554. "<literal>Debug::pkgProblemResolver</literal> enables output about the "
  4555. "decisions made by <literal>dist-upgrade, upgrade, install, remove, "
  4556. "purge</literal>."
  4557. msgstr ""
  4558. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4559. #: apt.conf.5.xml:609
  4560. msgid ""
  4561. "<literal>Debug::NoLocking</literal> disables all file locking. This can be "
  4562. "used to run some operations (for instance, <literal>apt-get -s "
  4563. "install</literal>) as a non-root user."
  4564. msgstr ""
  4565. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4566. #: apt.conf.5.xml:618
  4567. msgid ""
  4568. "<literal>Debug::pkgDPkgPM</literal> prints out the actual command line each "
  4569. "time that <literal>apt</literal> invokes &dpkg;."
  4570. msgstr ""
  4571. #. TODO: provide a
  4572. #. motivating example, except I haven't a clue why you'd want
  4573. #. to do this.
  4574. #. type: Content of: <refentry><refsect1><para><itemizedlist><listitem><para>
  4575. #: apt.conf.5.xml:626
  4576. msgid ""
  4577. "<literal>Debug::IdentCdrom</literal> disables the inclusion of statfs data "
  4578. "in CDROM IDs."
  4579. msgstr ""
  4580. #. type: Content of: <refentry><refsect1><para>
  4581. #: apt.conf.5.xml:636
  4582. msgid "A full list of debugging options to apt follows."
  4583. msgstr ""
  4584. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4585. #: apt.conf.5.xml:641
  4586. msgid "<literal>Debug::Acquire::cdrom</literal>"
  4587. msgstr ""
  4588. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4589. #: apt.conf.5.xml:645
  4590. msgid "Print information related to accessing <literal>cdrom://</literal> sources."
  4591. msgstr ""
  4592. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4593. #: apt.conf.5.xml:652
  4594. msgid "<literal>Debug::Acquire::ftp</literal>"
  4595. msgstr ""
  4596. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4597. #: apt.conf.5.xml:656
  4598. msgid "Print information related to downloading packages using FTP."
  4599. msgstr ""
  4600. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4601. #: apt.conf.5.xml:663
  4602. msgid "<literal>Debug::Acquire::http</literal>"
  4603. msgstr ""
  4604. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4605. #: apt.conf.5.xml:667
  4606. msgid "Print information related to downloading packages using HTTP."
  4607. msgstr ""
  4608. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4609. #: apt.conf.5.xml:674
  4610. msgid "<literal>Debug::Acquire::https</literal>"
  4611. msgstr ""
  4612. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4613. #: apt.conf.5.xml:678
  4614. msgid "Print information related to downloading packages using HTTPS."
  4615. msgstr ""
  4616. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4617. #: apt.conf.5.xml:685
  4618. msgid "<literal>Debug::Acquire::gpgv</literal>"
  4619. msgstr ""
  4620. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4621. #: apt.conf.5.xml:689
  4622. msgid ""
  4623. "Print information related to verifying cryptographic signatures using "
  4624. "<literal>gpg</literal>."
  4625. msgstr ""
  4626. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4627. #: apt.conf.5.xml:696
  4628. msgid "<literal>Debug::aptcdrom</literal>"
  4629. msgstr ""
  4630. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4631. #: apt.conf.5.xml:700
  4632. msgid ""
  4633. "Output information about the process of accessing collections of packages "
  4634. "stored on CD-ROMs."
  4635. msgstr ""
  4636. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4637. #: apt.conf.5.xml:707
  4638. msgid "<literal>Debug::BuildDeps</literal>"
  4639. msgstr ""
  4640. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4641. #: apt.conf.5.xml:710
  4642. msgid "Describes the process of resolving build-dependencies in &apt-get;."
  4643. msgstr ""
  4644. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4645. #: apt.conf.5.xml:717
  4646. msgid "<literal>Debug::Hashes</literal>"
  4647. msgstr ""
  4648. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4649. #: apt.conf.5.xml:720
  4650. msgid ""
  4651. "Output each cryptographic hash that is generated by the "
  4652. "<literal>apt</literal> libraries."
  4653. msgstr ""
  4654. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4655. #: apt.conf.5.xml:727
  4656. msgid "<literal>Debug::IdentCDROM</literal>"
  4657. msgstr ""
  4658. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4659. #: apt.conf.5.xml:730
  4660. msgid ""
  4661. "Do not include information from <literal>statfs</literal>, namely the number "
  4662. "of used and free blocks on the CD-ROM filesystem, when generating an ID for "
  4663. "a CD-ROM."
  4664. msgstr ""
  4665. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4666. #: apt.conf.5.xml:738
  4667. msgid "<literal>Debug::NoLocking</literal>"
  4668. msgstr ""
  4669. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4670. #: apt.conf.5.xml:741
  4671. msgid ""
  4672. "Disable all file locking. For instance, this will allow two instances of "
  4673. "<quote><literal>apt-get update</literal></quote> to run at the same time."
  4674. msgstr ""
  4675. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4676. #: apt.conf.5.xml:749
  4677. msgid "<literal>Debug::pkgAcquire</literal>"
  4678. msgstr ""
  4679. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4680. #: apt.conf.5.xml:753
  4681. msgid "Log when items are added to or removed from the global download queue."
  4682. msgstr ""
  4683. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4684. #: apt.conf.5.xml:760
  4685. msgid "<literal>Debug::pkgAcquire::Auth</literal>"
  4686. msgstr ""
  4687. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4688. #: apt.conf.5.xml:763
  4689. msgid ""
  4690. "Output status messages and errors related to verifying checksums and "
  4691. "cryptographic signatures of downloaded files."
  4692. msgstr ""
  4693. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4694. #: apt.conf.5.xml:770
  4695. msgid "<literal>Debug::pkgAcquire::Diffs</literal>"
  4696. msgstr ""
  4697. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4698. #: apt.conf.5.xml:773
  4699. msgid ""
  4700. "Output information about downloading and applying package index list diffs, "
  4701. "and errors relating to package index list diffs."
  4702. msgstr ""
  4703. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4704. #: apt.conf.5.xml:781
  4705. msgid "<literal>Debug::pkgAcquire::RRed</literal>"
  4706. msgstr ""
  4707. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4708. #: apt.conf.5.xml:785
  4709. msgid ""
  4710. "Output information related to patching apt package lists when downloading "
  4711. "index diffs instead of full indices."
  4712. msgstr ""
  4713. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4714. #: apt.conf.5.xml:792
  4715. msgid "<literal>Debug::pkgAcquire::Worker</literal>"
  4716. msgstr ""
  4717. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4718. #: apt.conf.5.xml:796
  4719. msgid "Log all interactions with the sub-processes that actually perform downloads."
  4720. msgstr ""
  4721. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4722. #: apt.conf.5.xml:803
  4723. msgid "<literal>Debug::pkgAutoRemove</literal>"
  4724. msgstr ""
  4725. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4726. #: apt.conf.5.xml:807
  4727. msgid ""
  4728. "Log events related to the automatically-installed status of packages and to "
  4729. "the removal of unused packages."
  4730. msgstr ""
  4731. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4732. #: apt.conf.5.xml:814
  4733. msgid "<literal>Debug::pkgDepCache::AutoInstall</literal>"
  4734. msgstr ""
  4735. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4736. #: apt.conf.5.xml:817
  4737. msgid ""
  4738. "Generate debug messages describing which packages are being automatically "
  4739. "installed to resolve dependencies. This corresponds to the initial "
  4740. "auto-install pass performed in, e.g., <literal>apt-get install</literal>, "
  4741. "and not to the full <literal>apt</literal> dependency resolver; see "
  4742. "<literal>Debug::pkgProblemResolver</literal> for that."
  4743. msgstr ""
  4744. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4745. #: apt.conf.5.xml:828
  4746. msgid "<literal>Debug::pkgDepCache::Marker</literal>"
  4747. msgstr ""
  4748. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4749. #: apt.conf.5.xml:831
  4750. msgid ""
  4751. "Generate debug messages describing which package is marked as "
  4752. "keep/install/remove while the ProblemResolver does his work. Each addition "
  4753. "or deletion may trigger additional actions; they are shown indented two "
  4754. "additional space under the original entry. The format for each line is "
  4755. "<literal>MarkKeep</literal>, <literal>MarkDelete</literal> or "
  4756. "<literal>MarkInstall</literal> followed by <literal>package-name &lt;a.b.c "
  4757. "-&gt; d.e.f | x.y.z&gt; (section)</literal> where <literal>a.b.c</literal> "
  4758. "is the current version of the package, <literal>d.e.f</literal> is the "
  4759. "version considered for installation and <literal>x.y.z</literal> is a newer "
  4760. "version, but not considered for installation (because of a low pin "
  4761. "score). The later two can be omitted if there is none or if it is the same "
  4762. "version as the installed. <literal>section</literal> is the name of the "
  4763. "section the package appears in."
  4764. msgstr ""
  4765. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4766. #: apt.conf.5.xml:850
  4767. msgid "<literal>Debug::pkgInitConfig</literal>"
  4768. msgstr ""
  4769. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4770. #: apt.conf.5.xml:853
  4771. msgid "Dump the default configuration to standard error on startup."
  4772. msgstr ""
  4773. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4774. #: apt.conf.5.xml:860
  4775. msgid "<literal>Debug::pkgDPkgPM</literal>"
  4776. msgstr ""
  4777. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4778. #: apt.conf.5.xml:863
  4779. msgid ""
  4780. "When invoking &dpkg;, output the precise command line with which it is being "
  4781. "invoked, with arguments separated by a single space character."
  4782. msgstr ""
  4783. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4784. #: apt.conf.5.xml:871
  4785. msgid "<literal>Debug::pkgDPkgProgressReporting</literal>"
  4786. msgstr ""
  4787. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4788. #: apt.conf.5.xml:874
  4789. msgid ""
  4790. "Output all the data received from &dpkg; on the status file descriptor and "
  4791. "any errors encountered while parsing it."
  4792. msgstr ""
  4793. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4794. #: apt.conf.5.xml:881
  4795. msgid "<literal>Debug::pkgOrderList</literal>"
  4796. msgstr ""
  4797. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4798. #: apt.conf.5.xml:885
  4799. msgid ""
  4800. "Generate a trace of the algorithm that decides the order in which "
  4801. "<literal>apt</literal> should pass packages to &dpkg;."
  4802. msgstr ""
  4803. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4804. #: apt.conf.5.xml:893
  4805. msgid "<literal>Debug::pkgPackageManager</literal>"
  4806. msgstr ""
  4807. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4808. #: apt.conf.5.xml:897
  4809. msgid "Output status messages tracing the steps performed when invoking &dpkg;."
  4810. msgstr ""
  4811. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4812. #: apt.conf.5.xml:904
  4813. msgid "<literal>Debug::pkgPolicy</literal>"
  4814. msgstr ""
  4815. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4816. #: apt.conf.5.xml:908
  4817. msgid "Output the priority of each package list on startup."
  4818. msgstr ""
  4819. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4820. #: apt.conf.5.xml:914
  4821. msgid "<literal>Debug::pkgProblemResolver</literal>"
  4822. msgstr ""
  4823. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4824. #: apt.conf.5.xml:918
  4825. msgid ""
  4826. "Trace the execution of the dependency resolver (this applies only to what "
  4827. "happens when a complex dependency problem is encountered)."
  4828. msgstr ""
  4829. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4830. #: apt.conf.5.xml:926
  4831. msgid "<literal>Debug::pkgProblemResolver::ShowScores</literal>"
  4832. msgstr ""
  4833. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4834. #: apt.conf.5.xml:929
  4835. msgid ""
  4836. "Display a list of all installed packages with their calculated score used by "
  4837. "the pkgProblemResolver. The description of the package is the same as "
  4838. "described in <literal>Debug::pkgDepCache::Marker</literal>"
  4839. msgstr ""
  4840. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
  4841. #: apt.conf.5.xml:937
  4842. msgid "<literal>Debug::sourceList</literal>"
  4843. msgstr ""
  4844. #. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
  4845. #: apt.conf.5.xml:941
  4846. msgid ""
  4847. "Print information about the vendors read from "
  4848. "<filename>/etc/apt/vendors.list</filename>."
  4849. msgstr ""
  4850. #. type: Content of: <refentry><refsect1><para>
  4851. #: apt.conf.5.xml:963
  4852. msgid ""
  4853. "&configureindex; is a configuration file showing example values for all "
  4854. "possible options."
  4855. msgstr ""
  4856. #. type: Content of: <refentry><refsect1><variablelist>
  4857. #: apt.conf.5.xml:970
  4858. msgid "&file-aptconf;"
  4859. msgstr ""
  4860. #. ? reading apt.conf
  4861. #. type: Content of: <refentry><refsect1><para>
  4862. #: apt.conf.5.xml:975
  4863. msgid "&apt-cache;, &apt-config;, &apt-preferences;."
  4864. msgstr ""
  4865. #. The last update date
  4866. #. type: Content of: <refentry><refentryinfo>
  4867. #: apt_preferences.5.xml:13
  4868. msgid "&apt-author.team; &apt-email; &apt-product; <date>04 May 2009</date>"
  4869. msgstr ""
  4870. #. type: Content of: <refentry><refnamediv><refname>
  4871. #: apt_preferences.5.xml:21 apt_preferences.5.xml:28
  4872. msgid "apt_preferences"
  4873. msgstr ""
  4874. #. type: Content of: <refentry><refnamediv><refpurpose>
  4875. #: apt_preferences.5.xml:29
  4876. msgid "Preference control file for APT"
  4877. msgstr ""
  4878. #. type: Content of: <refentry><refsect1><para>
  4879. #: apt_preferences.5.xml:34
  4880. msgid ""
  4881. "The APT preferences file <filename>/etc/apt/preferences</filename> and the "
  4882. "fragment files in the <filename>/etc/apt/preferences.d/</filename> folder "
  4883. "can be used to control which versions of packages will be selected for "
  4884. "installation."
  4885. msgstr ""
  4886. #. type: Content of: <refentry><refsect1><para>
  4887. #: apt_preferences.5.xml:39
  4888. msgid ""
  4889. "Several versions of a package may be available for installation when the "
  4890. "&sources-list; file contains references to more than one distribution (for "
  4891. "example, <literal>stable</literal> and <literal>testing</literal>). APT "
  4892. "assigns a priority to each version that is available. Subject to dependency "
  4893. "constraints, <command>apt-get</command> selects the version with the highest "
  4894. "priority for installation. The APT preferences file overrides the "
  4895. "priorities that APT assigns to package versions by default, thus giving the "
  4896. "user control over which one is selected for installation."
  4897. msgstr ""
  4898. #. type: Content of: <refentry><refsect1><para>
  4899. #: apt_preferences.5.xml:49
  4900. msgid ""
  4901. "Several instances of the same version of a package may be available when the "
  4902. "&sources-list; file contains references to more than one source. In this "
  4903. "case <command>apt-get</command> downloads the instance listed earliest in "
  4904. "the &sources-list; file. The APT preferences file does not affect the "
  4905. "choice of instance, only the choice of version."
  4906. msgstr ""
  4907. #. type: Content of: <refentry><refsect1><refsect2><title>
  4908. #: apt_preferences.5.xml:56
  4909. msgid "APT's Default Priority Assignments"
  4910. msgstr ""
  4911. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4912. #: apt_preferences.5.xml:71
  4913. #, no-wrap
  4914. msgid ""
  4915. "<command>apt-get install -t testing "
  4916. "<replaceable>some-package</replaceable></command>\n"
  4917. msgstr ""
  4918. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  4919. #: apt_preferences.5.xml:74
  4920. #, no-wrap
  4921. msgid "APT::Default-Release \"stable\";\n"
  4922. msgstr ""
  4923. #. type: Content of: <refentry><refsect1><refsect2><para>
  4924. #: apt_preferences.5.xml:58
  4925. msgid ""
  4926. "If there is no preferences file or if there is no entry in the file that "
  4927. "applies to a particular version then the priority assigned to that version "
  4928. "is the priority of the distribution to which that version belongs. It is "
  4929. "possible to single out a distribution, \"the target release\", which "
  4930. "receives a higher priority than other distributions do by default. The "
  4931. "target release can be set on the <command>apt-get</command> command line or "
  4932. "in the APT configuration file <filename>/etc/apt/apt.conf</filename>. Note "
  4933. "that this has precedence over any general priority you set in the "
  4934. "<filename>/etc/apt/preferences</filename> file described later, but not over "
  4935. "specifically pinned packages. For example, <placeholder "
  4936. "type=\"programlisting\" id=\"0\"/> <placeholder type=\"programlisting\" "
  4937. "id=\"1\"/>"
  4938. msgstr ""
  4939. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4940. #: apt_preferences.5.xml:83
  4941. msgid "priority 100"
  4942. msgstr ""
  4943. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4944. #: apt_preferences.5.xml:84
  4945. msgid "to the version that is already installed (if any)."
  4946. msgstr ""
  4947. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4948. #: apt_preferences.5.xml:88
  4949. msgid "priority 500"
  4950. msgstr ""
  4951. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4952. #: apt_preferences.5.xml:89
  4953. msgid ""
  4954. "to the versions that are not installed and do not belong to the target "
  4955. "release."
  4956. msgstr ""
  4957. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  4958. #: apt_preferences.5.xml:93
  4959. msgid "priority 990"
  4960. msgstr ""
  4961. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  4962. #: apt_preferences.5.xml:94
  4963. msgid "to the versions that are not installed and belong to the target release."
  4964. msgstr ""
  4965. #. type: Content of: <refentry><refsect1><refsect2><para>
  4966. #: apt_preferences.5.xml:78
  4967. msgid ""
  4968. "If the target release has been specified then APT uses the following "
  4969. "algorithm to set the priorities of the versions of a package. Assign: "
  4970. "<placeholder type=\"variablelist\" id=\"0\"/>"
  4971. msgstr ""
  4972. #. type: Content of: <refentry><refsect1><refsect2><para>
  4973. #: apt_preferences.5.xml:99
  4974. msgid ""
  4975. "If the target release has not been specified then APT simply assigns "
  4976. "priority 100 to all installed package versions and priority 500 to all "
  4977. "uninstalled package versions."
  4978. msgstr ""
  4979. #. type: Content of: <refentry><refsect1><refsect2><para>
  4980. #: apt_preferences.5.xml:103
  4981. msgid ""
  4982. "APT then applies the following rules, listed in order of precedence, to "
  4983. "determine which version of a package to install."
  4984. msgstr ""
  4985. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4986. #: apt_preferences.5.xml:106
  4987. msgid ""
  4988. "Never downgrade unless the priority of an available version exceeds 1000. "
  4989. "(\"Downgrading\" is installing a less recent version of a package in place "
  4990. "of a more recent version. Note that none of APT's default priorities "
  4991. "exceeds 1000; such high priorities can only be set in the preferences file. "
  4992. "Note also that downgrading a package can be risky.)"
  4993. msgstr ""
  4994. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4995. #: apt_preferences.5.xml:112
  4996. msgid "Install the highest priority version."
  4997. msgstr ""
  4998. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  4999. #: apt_preferences.5.xml:113
  5000. msgid ""
  5001. "If two or more versions have the same priority, install the most recent one "
  5002. "(that is, the one with the higher version number)."
  5003. msgstr ""
  5004. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5005. #: apt_preferences.5.xml:116
  5006. msgid ""
  5007. "If two or more versions have the same priority and version number but either "
  5008. "the packages differ in some of their metadata or the "
  5009. "<literal>--reinstall</literal> option is given, install the uninstalled one."
  5010. msgstr ""
  5011. #. type: Content of: <refentry><refsect1><refsect2><para>
  5012. #: apt_preferences.5.xml:122
  5013. msgid ""
  5014. "In a typical situation, the installed version of a package (priority 100) "
  5015. "is not as recent as one of the versions available from the sources listed in "
  5016. "the &sources-list; file (priority 500 or 990). Then the package will be "
  5017. "upgraded when <command>apt-get install "
  5018. "<replaceable>some-package</replaceable></command> or <command>apt-get "
  5019. "upgrade</command> is executed."
  5020. msgstr ""
  5021. #. type: Content of: <refentry><refsect1><refsect2><para>
  5022. #: apt_preferences.5.xml:129
  5023. msgid ""
  5024. "More rarely, the installed version of a package is <emphasis>more</emphasis> "
  5025. "recent than any of the other available versions. The package will not be "
  5026. "downgraded when <command>apt-get install "
  5027. "<replaceable>some-package</replaceable></command> or <command>apt-get "
  5028. "upgrade</command> is executed."
  5029. msgstr ""
  5030. #. type: Content of: <refentry><refsect1><refsect2><para>
  5031. #: apt_preferences.5.xml:134
  5032. msgid ""
  5033. "Sometimes the installed version of a package is more recent than the version "
  5034. "belonging to the target release, but not as recent as a version belonging to "
  5035. "some other distribution. Such a package will indeed be upgraded when "
  5036. "<command>apt-get install <replaceable>some-package</replaceable></command> "
  5037. "or <command>apt-get upgrade</command> is executed, because at least "
  5038. "<emphasis>one</emphasis> of the available versions has a higher priority "
  5039. "than the installed version."
  5040. msgstr ""
  5041. #. type: Content of: <refentry><refsect1><refsect2><title>
  5042. #: apt_preferences.5.xml:143
  5043. msgid "The Effect of APT Preferences"
  5044. msgstr ""
  5045. #. type: Content of: <refentry><refsect1><refsect2><para>
  5046. #: apt_preferences.5.xml:145
  5047. msgid ""
  5048. "The APT preferences file allows the system administrator to control the "
  5049. "assignment of priorities. The file consists of one or more multi-line "
  5050. "records separated by blank lines. Records can have one of two forms, a "
  5051. "specific form and a general form."
  5052. msgstr ""
  5053. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5054. #: apt_preferences.5.xml:151
  5055. msgid ""
  5056. "The specific form assigns a priority (a \"Pin-Priority\") to one or more "
  5057. "specified packages and specified version or version range. For example, the "
  5058. "following record assigns a high priority to all versions of the "
  5059. "<filename>perl</filename> package whose version number begins with "
  5060. "\"<literal>5.8</literal>\". Multiple packages can be separated by spaces."
  5061. msgstr ""
  5062. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5063. #: apt_preferences.5.xml:158
  5064. #, no-wrap
  5065. msgid ""
  5066. "Package: perl\n"
  5067. "Pin: version 5.8*\n"
  5068. "Pin-Priority: 1001\n"
  5069. msgstr ""
  5070. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5071. #: apt_preferences.5.xml:164
  5072. msgid ""
  5073. "The general form assigns a priority to all of the package versions in a "
  5074. "given distribution (that is, to all the versions of packages that are listed "
  5075. "in a certain <filename>Release</filename> file) or to all of the package "
  5076. "versions coming from a particular Internet site, as identified by the site's "
  5077. "fully qualified domain name."
  5078. msgstr ""
  5079. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5080. #: apt_preferences.5.xml:170
  5081. msgid ""
  5082. "This general-form entry in the APT preferences file applies only to groups "
  5083. "of packages. For example, the following record assigns a high priority to "
  5084. "all package versions available from the local site."
  5085. msgstr ""
  5086. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5087. #: apt_preferences.5.xml:175
  5088. #, no-wrap
  5089. msgid ""
  5090. "Package: *\n"
  5091. "Pin: origin \"\"\n"
  5092. "Pin-Priority: 999\n"
  5093. msgstr ""
  5094. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5095. #: apt_preferences.5.xml:180
  5096. msgid ""
  5097. "A note of caution: the keyword used here is \"<literal>origin</literal>\". "
  5098. "This should not be confused with the Origin of a distribution as specified "
  5099. "in a <filename>Release</filename> file. What follows the \"Origin:\" tag in "
  5100. "a <filename>Release</filename> file is not an Internet address but an author "
  5101. "or vendor name, such as \"Debian\" or \"Ximian\"."
  5102. msgstr ""
  5103. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5104. #: apt_preferences.5.xml:186
  5105. msgid ""
  5106. "The following record assigns a low priority to all package versions "
  5107. "belonging to any distribution whose Archive name is "
  5108. "\"<literal>unstable</literal>\"."
  5109. msgstr ""
  5110. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5111. #: apt_preferences.5.xml:190
  5112. #, no-wrap
  5113. msgid ""
  5114. "Package: *\n"
  5115. "Pin: release a=unstable\n"
  5116. "Pin-Priority: 50\n"
  5117. msgstr ""
  5118. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5119. #: apt_preferences.5.xml:195
  5120. msgid ""
  5121. "The following record assigns a high priority to all package versions "
  5122. "belonging to any distribution whose Codename is "
  5123. "\"<literal>squeeze</literal>\"."
  5124. msgstr ""
  5125. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5126. #: apt_preferences.5.xml:199
  5127. #, no-wrap
  5128. msgid ""
  5129. "Package: *\n"
  5130. "Pin: release n=squeeze\n"
  5131. "Pin-Priority: 900\n"
  5132. msgstr ""
  5133. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5134. #: apt_preferences.5.xml:204
  5135. msgid ""
  5136. "The following record assigns a high priority to all package versions "
  5137. "belonging to any release whose Archive name is \"<literal>stable</literal>\" "
  5138. "and whose release Version number is \"<literal>3.0</literal>\"."
  5139. msgstr ""
  5140. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><programlisting>
  5141. #: apt_preferences.5.xml:209
  5142. #, no-wrap
  5143. msgid ""
  5144. "Package: *\n"
  5145. "Pin: release a=stable, v=3.0\n"
  5146. "Pin-Priority: 500\n"
  5147. msgstr ""
  5148. #. type: Content of: <refentry><refsect1><refsect2><title>
  5149. #: apt_preferences.5.xml:220
  5150. msgid "How APT Interprets Priorities"
  5151. msgstr ""
  5152. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5153. #: apt_preferences.5.xml:228
  5154. msgid "P &gt; 1000"
  5155. msgstr ""
  5156. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5157. #: apt_preferences.5.xml:229
  5158. msgid ""
  5159. "causes a version to be installed even if this constitutes a downgrade of the "
  5160. "package"
  5161. msgstr ""
  5162. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5163. #: apt_preferences.5.xml:233
  5164. msgid "990 &lt; P &lt;=1000"
  5165. msgstr ""
  5166. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5167. #: apt_preferences.5.xml:234
  5168. msgid ""
  5169. "causes a version to be installed even if it does not come from the target "
  5170. "release, unless the installed version is more recent"
  5171. msgstr ""
  5172. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5173. #: apt_preferences.5.xml:239
  5174. msgid "500 &lt; P &lt;=990"
  5175. msgstr ""
  5176. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5177. #: apt_preferences.5.xml:240
  5178. msgid ""
  5179. "causes a version to be installed unless there is a version available "
  5180. "belonging to the target release or the installed version is more recent"
  5181. msgstr ""
  5182. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5183. #: apt_preferences.5.xml:245
  5184. msgid "100 &lt; P &lt;=500"
  5185. msgstr ""
  5186. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5187. #: apt_preferences.5.xml:246
  5188. msgid ""
  5189. "causes a version to be installed unless there is a version available "
  5190. "belonging to some other distribution or the installed version is more recent"
  5191. msgstr ""
  5192. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5193. #: apt_preferences.5.xml:251
  5194. msgid "0 &lt; P &lt;=100"
  5195. msgstr ""
  5196. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5197. #: apt_preferences.5.xml:252
  5198. msgid ""
  5199. "causes a version to be installed only if there is no installed version of "
  5200. "the package"
  5201. msgstr ""
  5202. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5203. #: apt_preferences.5.xml:256
  5204. msgid "P &lt; 0"
  5205. msgstr ""
  5206. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5207. #: apt_preferences.5.xml:257
  5208. msgid "prevents the version from being installed"
  5209. msgstr ""
  5210. #. type: Content of: <refentry><refsect1><refsect2><para>
  5211. #: apt_preferences.5.xml:223
  5212. msgid ""
  5213. "Priorities (P) assigned in the APT preferences file must be positive or "
  5214. "negative integers. They are interpreted as follows (roughly speaking): "
  5215. "<placeholder type=\"variablelist\" id=\"0\"/>"
  5216. msgstr ""
  5217. #. type: Content of: <refentry><refsect1><refsect2><para>
  5218. #: apt_preferences.5.xml:262
  5219. msgid ""
  5220. "If any specific-form records match an available package version then the "
  5221. "first such record determines the priority of the package version. Failing "
  5222. "that, if any general-form records match an available package version then "
  5223. "the first such record determines the priority of the package version."
  5224. msgstr ""
  5225. #. type: Content of: <refentry><refsect1><refsect2><para>
  5226. #: apt_preferences.5.xml:268
  5227. msgid ""
  5228. "For example, suppose the APT preferences file contains the three records "
  5229. "presented earlier:"
  5230. msgstr ""
  5231. #. type: Content of: <refentry><refsect1><refsect2><programlisting>
  5232. #: apt_preferences.5.xml:272
  5233. #, no-wrap
  5234. msgid ""
  5235. "Package: perl\n"
  5236. "Pin: version 5.8*\n"
  5237. "Pin-Priority: 1001\n"
  5238. "\n"
  5239. "Package: *\n"
  5240. "Pin: origin \"\"\n"
  5241. "Pin-Priority: 999\n"
  5242. "\n"
  5243. "Package: *\n"
  5244. "Pin: release unstable\n"
  5245. "Pin-Priority: 50\n"
  5246. msgstr ""
  5247. #. type: Content of: <refentry><refsect1><refsect2><para>
  5248. #: apt_preferences.5.xml:285
  5249. msgid "Then:"
  5250. msgstr ""
  5251. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5252. #: apt_preferences.5.xml:287
  5253. msgid ""
  5254. "The most recent available version of the <literal>perl</literal> package "
  5255. "will be installed, so long as that version's version number begins with "
  5256. "\"<literal>5.8</literal>\". If <emphasis>any</emphasis> 5.8* version of "
  5257. "<literal>perl</literal> is available and the installed version is 5.9*, then "
  5258. "<literal>perl</literal> will be downgraded."
  5259. msgstr ""
  5260. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5261. #: apt_preferences.5.xml:292
  5262. msgid ""
  5263. "A version of any package other than <literal>perl</literal> that is "
  5264. "available from the local system has priority over other versions, even "
  5265. "versions belonging to the target release."
  5266. msgstr ""
  5267. #. type: Content of: <refentry><refsect1><refsect2><para><itemizedlist><listitem><simpara>
  5268. #: apt_preferences.5.xml:296
  5269. msgid ""
  5270. "A version of a package whose origin is not the local system but some other "
  5271. "site listed in &sources-list; and which belongs to an "
  5272. "<literal>unstable</literal> distribution is only installed if it is selected "
  5273. "for installation and no version of the package is already installed."
  5274. msgstr ""
  5275. #. type: Content of: <refentry><refsect1><refsect2><title>
  5276. #: apt_preferences.5.xml:306
  5277. msgid "Determination of Package Version and Distribution Properties"
  5278. msgstr ""
  5279. #. type: Content of: <refentry><refsect1><refsect2><para>
  5280. #: apt_preferences.5.xml:308
  5281. msgid ""
  5282. "The locations listed in the &sources-list; file should provide "
  5283. "<filename>Packages</filename> and <filename>Release</filename> files to "
  5284. "describe the packages available at that location."
  5285. msgstr ""
  5286. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5287. #: apt_preferences.5.xml:320
  5288. msgid "the <literal>Package:</literal> line"
  5289. msgstr ""
  5290. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5291. #: apt_preferences.5.xml:321
  5292. msgid "gives the package name"
  5293. msgstr ""
  5294. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5295. #: apt_preferences.5.xml:324 apt_preferences.5.xml:374
  5296. msgid "the <literal>Version:</literal> line"
  5297. msgstr ""
  5298. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5299. #: apt_preferences.5.xml:325
  5300. msgid "gives the version number for the named package"
  5301. msgstr ""
  5302. #. type: Content of: <refentry><refsect1><refsect2><para>
  5303. #: apt_preferences.5.xml:312
  5304. msgid ""
  5305. "The <filename>Packages</filename> file is normally found in the directory "
  5306. "<filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>: "
  5307. "for example, "
  5308. "<filename>.../dists/stable/main/binary-i386/Packages</filename>. It "
  5309. "consists of a series of multi-line records, one for each package available "
  5310. "in that directory. Only two lines in each record are relevant for setting "
  5311. "APT priorities: <placeholder type=\"variablelist\" id=\"0\"/>"
  5312. msgstr ""
  5313. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5314. #: apt_preferences.5.xml:341
  5315. msgid "the <literal>Archive:</literal> or <literal>Suite:</literal> line"
  5316. msgstr ""
  5317. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5318. #: apt_preferences.5.xml:342
  5319. msgid ""
  5320. "names the archive to which all the packages in the directory tree belong. "
  5321. "For example, the line \"Archive: stable\" or \"Suite: stable\" specifies "
  5322. "that all of the packages in the directory tree below the parent of the "
  5323. "<filename>Release</filename> file are in a <literal>stable</literal> "
  5324. "archive. Specifying this value in the APT preferences file would require "
  5325. "the line:"
  5326. msgstr ""
  5327. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5328. #: apt_preferences.5.xml:352
  5329. #, no-wrap
  5330. msgid "Pin: release a=stable\n"
  5331. msgstr ""
  5332. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5333. #: apt_preferences.5.xml:358
  5334. msgid "the <literal>Codename:</literal> line"
  5335. msgstr ""
  5336. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5337. #: apt_preferences.5.xml:359
  5338. msgid ""
  5339. "names the codename to which all the packages in the directory tree belong. "
  5340. "For example, the line \"Codename: squeeze\" specifies that all of the "
  5341. "packages in the directory tree below the parent of the "
  5342. "<filename>Release</filename> file belong to a version named "
  5343. "<literal>squeeze</literal>. Specifying this value in the APT preferences "
  5344. "file would require the line:"
  5345. msgstr ""
  5346. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5347. #: apt_preferences.5.xml:368
  5348. #, no-wrap
  5349. msgid "Pin: release n=squeeze\n"
  5350. msgstr ""
  5351. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5352. #: apt_preferences.5.xml:375
  5353. msgid ""
  5354. "names the release version. For example, the packages in the tree might "
  5355. "belong to Debian GNU/Linux release version 3.0. Note that there is normally "
  5356. "no version number for the <literal>testing</literal> and "
  5357. "<literal>unstable</literal> distributions because they have not been "
  5358. "released yet. Specifying this in the APT preferences file would require one "
  5359. "of the following lines."
  5360. msgstr ""
  5361. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5362. #: apt_preferences.5.xml:384
  5363. #, no-wrap
  5364. msgid ""
  5365. "Pin: release v=3.0\n"
  5366. "Pin: release a=stable, v=3.0\n"
  5367. "Pin: release 3.0\n"
  5368. msgstr ""
  5369. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5370. #: apt_preferences.5.xml:393
  5371. msgid "the <literal>Component:</literal> line"
  5372. msgstr ""
  5373. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5374. #: apt_preferences.5.xml:394
  5375. msgid ""
  5376. "names the licensing component associated with the packages in the directory "
  5377. "tree of the <filename>Release</filename> file. For example, the line "
  5378. "\"Component: main\" specifies that all the packages in the directory tree "
  5379. "are from the <literal>main</literal> component, which entails that they are "
  5380. "licensed under terms listed in the Debian Free Software Guidelines. "
  5381. "Specifying this component in the APT preferences file would require the "
  5382. "line:"
  5383. msgstr ""
  5384. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5385. #: apt_preferences.5.xml:403
  5386. #, no-wrap
  5387. msgid "Pin: release c=main\n"
  5388. msgstr ""
  5389. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5390. #: apt_preferences.5.xml:409
  5391. msgid "the <literal>Origin:</literal> line"
  5392. msgstr ""
  5393. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5394. #: apt_preferences.5.xml:410
  5395. msgid ""
  5396. "names the originator of the packages in the directory tree of the "
  5397. "<filename>Release</filename> file. Most commonly, this is "
  5398. "<literal>Debian</literal>. Specifying this origin in the APT preferences "
  5399. "file would require the line:"
  5400. msgstr ""
  5401. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5402. #: apt_preferences.5.xml:416
  5403. #, no-wrap
  5404. msgid "Pin: release o=Debian\n"
  5405. msgstr ""
  5406. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><term>
  5407. #: apt_preferences.5.xml:422
  5408. msgid "the <literal>Label:</literal> line"
  5409. msgstr ""
  5410. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><simpara>
  5411. #: apt_preferences.5.xml:423
  5412. msgid ""
  5413. "names the label of the packages in the directory tree of the "
  5414. "<filename>Release</filename> file. Most commonly, this is "
  5415. "<literal>Debian</literal>. Specifying this label in the APT preferences "
  5416. "file would require the line:"
  5417. msgstr ""
  5418. #. type: Content of: <refentry><refsect1><refsect2><para><variablelist><varlistentry><listitem><programlisting>
  5419. #: apt_preferences.5.xml:429
  5420. #, no-wrap
  5421. msgid "Pin: release l=Debian\n"
  5422. msgstr ""
  5423. #. type: Content of: <refentry><refsect1><refsect2><para>
  5424. #: apt_preferences.5.xml:330
  5425. msgid ""
  5426. "The <filename>Release</filename> file is normally found in the directory "
  5427. "<filename>.../dists/<replaceable>dist-name</replaceable></filename>: for "
  5428. "example, <filename>.../dists/stable/Release</filename>, or "
  5429. "<filename>.../dists/woody/Release</filename>. It consists of a single "
  5430. "multi-line record which applies to <emphasis>all</emphasis> of the packages "
  5431. "in the directory tree below its parent. Unlike the "
  5432. "<filename>Packages</filename> file, nearly all of the lines in a "
  5433. "<filename>Release</filename> file are relevant for setting APT priorities: "
  5434. "<placeholder type=\"variablelist\" id=\"0\"/>"
  5435. msgstr ""
  5436. #. type: Content of: <refentry><refsect1><refsect2><para>
  5437. #: apt_preferences.5.xml:436
  5438. msgid ""
  5439. "All of the <filename>Packages</filename> and <filename>Release</filename> "
  5440. "files retrieved from locations listed in the &sources-list; file are stored "
  5441. "in the directory <filename>/var/lib/apt/lists</filename>, or in the file "
  5442. "named by the variable <literal>Dir::State::Lists</literal> in the "
  5443. "<filename>apt.conf</filename> file. For example, the file "
  5444. "<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> "
  5445. "contains the <filename>Release</filename> file retrieved from the site "
  5446. "<literal>debian.lcs.mit.edu</literal> for <literal>binary-i386</literal> "
  5447. "architecture files from the <literal>contrib</literal> component of the "
  5448. "<literal>unstable</literal> distribution."
  5449. msgstr ""
  5450. #. type: Content of: <refentry><refsect1><refsect2><title>
  5451. #: apt_preferences.5.xml:449
  5452. msgid "Optional Lines in an APT Preferences Record"
  5453. msgstr ""
  5454. #. type: Content of: <refentry><refsect1><refsect2><para>
  5455. #: apt_preferences.5.xml:451
  5456. msgid ""
  5457. "Each record in the APT preferences file can optionally begin with one or "
  5458. "more lines beginning with the word <literal>Explanation:</literal>. This "
  5459. "provides a place for comments."
  5460. msgstr ""
  5461. #. type: Content of: <refentry><refsect1><refsect2><para>
  5462. #: apt_preferences.5.xml:455
  5463. msgid ""
  5464. "The <literal>Pin-Priority:</literal> line in each APT preferences record is "
  5465. "optional. If omitted, APT assigns a priority of 1 less than the last value "
  5466. "specified on a line beginning with <literal>Pin-Priority: release "
  5467. "...</literal>."
  5468. msgstr ""
  5469. #. type: Content of: <refentry><refsect1><refsect2><title>
  5470. #: apt_preferences.5.xml:464
  5471. msgid "Tracking Stable"
  5472. msgstr ""
  5473. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5474. #: apt_preferences.5.xml:472
  5475. #, no-wrap
  5476. msgid ""
  5477. "Explanation: Uninstall or do not install any Debian-originated\n"
  5478. "Explanation: package versions other than those in the stable distro\n"
  5479. "Package: *\n"
  5480. "Pin: release a=stable\n"
  5481. "Pin-Priority: 900\n"
  5482. "\n"
  5483. "Package: *\n"
  5484. "Pin: release o=Debian\n"
  5485. "Pin-Priority: -10\n"
  5486. msgstr ""
  5487. #. type: Content of: <refentry><refsect1><refsect2><para>
  5488. #: apt_preferences.5.xml:466
  5489. msgid ""
  5490. "The following APT preferences file will cause APT to assign a priority "
  5491. "higher than the default (500) to all package versions belonging to a "
  5492. "<literal>stable</literal> distribution and a prohibitively low priority to "
  5493. "package versions belonging to other <literal>Debian</literal> "
  5494. "distributions. <placeholder type=\"programlisting\" id=\"0\"/>"
  5495. msgstr ""
  5496. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5497. #: apt_preferences.5.xml:489 apt_preferences.5.xml:535 apt_preferences.5.xml:593
  5498. #, no-wrap
  5499. msgid ""
  5500. "apt-get install <replaceable>package-name</replaceable>\n"
  5501. "apt-get upgrade\n"
  5502. "apt-get dist-upgrade\n"
  5503. msgstr ""
  5504. #. type: Content of: <refentry><refsect1><refsect2><para>
  5505. #: apt_preferences.5.xml:484
  5506. msgid ""
  5507. "With a suitable &sources-list; file and the above preferences file, any of "
  5508. "the following commands will cause APT to upgrade to the latest "
  5509. "<literal>stable</literal> version(s). <placeholder type=\"programlisting\" "
  5510. "id=\"0\"/>"
  5511. msgstr ""
  5512. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5513. #: apt_preferences.5.xml:501
  5514. #, no-wrap
  5515. msgid "apt-get install <replaceable>package</replaceable>/testing\n"
  5516. msgstr ""
  5517. #. type: Content of: <refentry><refsect1><refsect2><para>
  5518. #: apt_preferences.5.xml:495
  5519. msgid ""
  5520. "The following command will cause APT to upgrade the specified package to the "
  5521. "latest version from the <literal>testing</literal> distribution; the package "
  5522. "will not be upgraded again unless this command is given again. <placeholder "
  5523. "type=\"programlisting\" id=\"0\"/>"
  5524. msgstr ""
  5525. #. type: Content of: <refentry><refsect1><refsect2><title>
  5526. #: apt_preferences.5.xml:507
  5527. msgid "Tracking Testing or Unstable"
  5528. msgstr ""
  5529. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5530. #: apt_preferences.5.xml:516
  5531. #, no-wrap
  5532. msgid ""
  5533. "Package: *\n"
  5534. "Pin: release a=testing\n"
  5535. "Pin-Priority: 900\n"
  5536. "\n"
  5537. "Package: *\n"
  5538. "Pin: release a=unstable\n"
  5539. "Pin-Priority: 800\n"
  5540. "\n"
  5541. "Package: *\n"
  5542. "Pin: release o=Debian\n"
  5543. "Pin-Priority: -10\n"
  5544. msgstr ""
  5545. #. type: Content of: <refentry><refsect1><refsect2><para>
  5546. #: apt_preferences.5.xml:509
  5547. msgid ""
  5548. "The following APT preferences file will cause APT to assign a high priority "
  5549. "to package versions from the <literal>testing</literal> distribution, a "
  5550. "lower priority to package versions from the <literal>unstable</literal> "
  5551. "distribution, and a prohibitively low priority to package versions from "
  5552. "other <literal>Debian</literal> distributions. <placeholder "
  5553. "type=\"programlisting\" id=\"0\"/>"
  5554. msgstr ""
  5555. #. type: Content of: <refentry><refsect1><refsect2><para>
  5556. #: apt_preferences.5.xml:530
  5557. msgid ""
  5558. "With a suitable &sources-list; file and the above preferences file, any of "
  5559. "the following commands will cause APT to upgrade to the latest "
  5560. "<literal>testing</literal> version(s). <placeholder type=\"programlisting\" "
  5561. "id=\"0\"/>"
  5562. msgstr ""
  5563. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5564. #: apt_preferences.5.xml:550
  5565. #, no-wrap
  5566. msgid "apt-get install <replaceable>package</replaceable>/unstable\n"
  5567. msgstr ""
  5568. #. type: Content of: <refentry><refsect1><refsect2><para>
  5569. #: apt_preferences.5.xml:541
  5570. msgid ""
  5571. "The following command will cause APT to upgrade the specified package to the "
  5572. "latest version from the <literal>unstable</literal> distribution. "
  5573. "Thereafter, <command>apt-get upgrade</command> will upgrade the package to "
  5574. "the most recent <literal>testing</literal> version if that is more recent "
  5575. "than the installed version, otherwise, to the most recent "
  5576. "<literal>unstable</literal> version if that is more recent than the "
  5577. "installed version. <placeholder type=\"programlisting\" id=\"0\"/>"
  5578. msgstr ""
  5579. #. type: Content of: <refentry><refsect1><refsect2><title>
  5580. #: apt_preferences.5.xml:557
  5581. msgid "Tracking the evolution of a codename release"
  5582. msgstr ""
  5583. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5584. #: apt_preferences.5.xml:571
  5585. #, no-wrap
  5586. msgid ""
  5587. "Explanation: Uninstall or do not install any Debian-originated package "
  5588. "versions\n"
  5589. "Explanation: other than those in the distribution codenamed with squeeze or "
  5590. "sid\n"
  5591. "Package: *\n"
  5592. "Pin: release n=squeeze\n"
  5593. "Pin-Priority: 900\n"
  5594. "\n"
  5595. "Explanation: Debian unstable is always codenamed with sid\n"
  5596. "Package: *\n"
  5597. "Pin: release a=sid\n"
  5598. "Pin-Priority: 800\n"
  5599. "\n"
  5600. "Package: *\n"
  5601. "Pin: release o=Debian\n"
  5602. "Pin-Priority: -10\n"
  5603. msgstr ""
  5604. #. type: Content of: <refentry><refsect1><refsect2><para>
  5605. #: apt_preferences.5.xml:559
  5606. msgid ""
  5607. "The following APT preferences file will cause APT to assign a priority "
  5608. "higher than the default (500) to all package versions belonging to a "
  5609. "specified codename of a distribution and a prohibitively low priority to "
  5610. "package versions belonging to other <literal>Debian</literal> distributions, "
  5611. "codenames and archives. Note that with this APT preference APT will follow "
  5612. "the migration of a release from the archive <literal>testing</literal> to "
  5613. "<literal>stable</literal> and later <literal>oldstable</literal>. If you "
  5614. "want to follow for example the progress in <literal>testing</literal> "
  5615. "notwithstanding the codename changes you should use the example "
  5616. "configurations above. <placeholder type=\"programlisting\" id=\"0\"/>"
  5617. msgstr ""
  5618. #. type: Content of: <refentry><refsect1><refsect2><para>
  5619. #: apt_preferences.5.xml:588
  5620. msgid ""
  5621. "With a suitable &sources-list; file and the above preferences file, any of "
  5622. "the following commands will cause APT to upgrade to the latest version(s) in "
  5623. "the release codenamed with <literal>squeeze</literal>. <placeholder "
  5624. "type=\"programlisting\" id=\"0\"/>"
  5625. msgstr ""
  5626. #. type: Content of: <refentry><refsect1><refsect2><para><programlisting>
  5627. #: apt_preferences.5.xml:608
  5628. #, no-wrap
  5629. msgid "apt-get install <replaceable>package</replaceable>/sid\n"
  5630. msgstr ""
  5631. #. type: Content of: <refentry><refsect1><refsect2><para>
  5632. #: apt_preferences.5.xml:599
  5633. msgid ""
  5634. "The following command will cause APT to upgrade the specified package to the "
  5635. "latest version from the <literal>sid</literal> distribution. Thereafter, "
  5636. "<command>apt-get upgrade</command> will upgrade the package to the most "
  5637. "recent <literal>squeeze</literal> version if that is more recent than the "
  5638. "installed version, otherwise, to the most recent <literal>sid</literal> "
  5639. "version if that is more recent than the installed version. <placeholder "
  5640. "type=\"programlisting\" id=\"0\"/>"
  5641. msgstr ""
  5642. #. type: Content of: <refentry><refsect1><variablelist>
  5643. #: apt_preferences.5.xml:617
  5644. msgid "&file-preferences;"
  5645. msgstr ""
  5646. #. type: Content of: <refentry><refsect1><para>
  5647. #: apt_preferences.5.xml:623
  5648. msgid "&apt-get; &apt-cache; &apt-conf; &sources-list;"
  5649. msgstr ""
  5650. #. type: Content of: <refentry><refnamediv><refname>
  5651. #: sources.list.5.xml:22 sources.list.5.xml:29
  5652. msgid "sources.list"
  5653. msgstr ""
  5654. #. type: Content of: <refentry><refnamediv><refpurpose>
  5655. #: sources.list.5.xml:30
  5656. msgid "Package resource list for APT"
  5657. msgstr ""
  5658. #. type: Content of: <refentry><refsect1><para>
  5659. #: sources.list.5.xml:34
  5660. msgid ""
  5661. "The package resource list is used to locate archives of the package "
  5662. "distribution system in use on the system. At this time, this manual page "
  5663. "documents only the packaging system used by the Debian GNU/Linux system. "
  5664. "This control file is located in <filename>/etc/apt/sources.list</filename>"
  5665. msgstr ""
  5666. #. type: Content of: <refentry><refsect1><para>
  5667. #: sources.list.5.xml:39
  5668. msgid ""
  5669. "The source list is designed to support any number of active sources and a "
  5670. "variety of source media. The file lists one source per line, with the most "
  5671. "preferred source listed first. The format of each line is: <literal>type uri "
  5672. "args</literal> The first item, <literal>type</literal> determines the format "
  5673. "for <literal>args</literal> <literal>uri</literal> is a Universal Resource "
  5674. "Identifier (URI), which is a superset of the more specific and well-known "
  5675. "Universal Resource Locator, or URL. The rest of the line can be marked as a "
  5676. "comment by using a #."
  5677. msgstr ""
  5678. #. type: Content of: <refentry><refsect1><title>
  5679. #: sources.list.5.xml:50
  5680. msgid "sources.list.d"
  5681. msgstr ""
  5682. #. type: Content of: <refentry><refsect1><para>
  5683. #: sources.list.5.xml:51
  5684. msgid ""
  5685. "The <filename>/etc/apt/sources.list.d</filename> directory provides a way to "
  5686. "add sources.list entries in separate files. The format is the same as for "
  5687. "the regular <filename>sources.list</filename> file. File names need to end "
  5688. "with <filename>.list</filename> and may only contain letters (a-z and A-Z), "
  5689. "digits (0-9), underscore (_), hyphen (-) and period (.) characters. "
  5690. "Otherwise they will be silently ignored."
  5691. msgstr ""
  5692. #. type: Content of: <refentry><refsect1><title>
  5693. #: sources.list.5.xml:60
  5694. msgid "The deb and deb-src types"
  5695. msgstr ""
  5696. #. type: Content of: <refentry><refsect1><para>
  5697. #: sources.list.5.xml:61
  5698. msgid ""
  5699. "The <literal>deb</literal> type describes a typical two-level Debian "
  5700. "archive, <filename>distribution/component</filename>. Typically, "
  5701. "<literal>distribution</literal> is generally one of "
  5702. "<literal>stable</literal> <literal>unstable</literal> or "
  5703. "<literal>testing</literal> while component is one of <literal>main</literal> "
  5704. "<literal>contrib</literal> <literal>non-free</literal> or "
  5705. "<literal>non-us</literal> The <literal>deb-src</literal> type describes a "
  5706. "debian distribution's source code in the same form as the "
  5707. "<literal>deb</literal> type. A <literal>deb-src</literal> line is required "
  5708. "to fetch source indexes."
  5709. msgstr ""
  5710. #. type: Content of: <refentry><refsect1><para>
  5711. #: sources.list.5.xml:73
  5712. msgid ""
  5713. "The format for a <filename>sources.list</filename> entry using the "
  5714. "<literal>deb</literal> and <literal>deb-src</literal> types are:"
  5715. msgstr ""
  5716. #. type: Content of: <refentry><refsect1><literallayout>
  5717. #: sources.list.5.xml:76
  5718. #, no-wrap
  5719. msgid "deb uri distribution [component1] [component2] [...]"
  5720. msgstr ""
  5721. #. type: Content of: <refentry><refsect1><para>
  5722. #: sources.list.5.xml:78
  5723. msgid ""
  5724. "The URI for the <literal>deb</literal> type must specify the base of the "
  5725. "Debian distribution, from which APT will find the information it needs. "
  5726. "<literal>distribution</literal> can specify an exact path, in which case the "
  5727. "components must be omitted and <literal>distribution</literal> must end with "
  5728. "a slash (/). This is useful for when only a particular sub-section of the "
  5729. "archive denoted by the URI is of interest. If "
  5730. "<literal>distribution</literal> does not specify an exact path, at least one "
  5731. "<literal>component</literal> must be present."
  5732. msgstr ""
  5733. #. type: Content of: <refentry><refsect1><para>
  5734. #: sources.list.5.xml:87
  5735. msgid ""
  5736. "<literal>distribution</literal> may also contain a variable, "
  5737. "<literal>$(ARCH)</literal> which expands to the Debian architecture (i386, "
  5738. "m68k, powerpc, ...) used on the system. This permits "
  5739. "architecture-independent <filename>sources.list</filename> files to be "
  5740. "used. In general this is only of interest when specifying an exact path, "
  5741. "<literal>APT</literal> will automatically generate a URI with the current "
  5742. "architecture otherwise."
  5743. msgstr ""
  5744. #. type: Content of: <refentry><refsect1><para>
  5745. #: sources.list.5.xml:95
  5746. msgid ""
  5747. "Since only one distribution can be specified per line it may be necessary to "
  5748. "have multiple lines for the same URI, if a subset of all available "
  5749. "distributions or components at that location is desired. APT will sort the "
  5750. "URI list after it has generated a complete set internally, and will collapse "
  5751. "multiple references to the same Internet host, for instance, into a single "
  5752. "connection, so that it does not inefficiently establish an FTP connection, "
  5753. "close it, do something else, and then re-establish a connection to that same "
  5754. "host. This feature is useful for accessing busy FTP sites with limits on the "
  5755. "number of simultaneous anonymous users. APT also parallelizes connections to "
  5756. "different hosts to more effectively deal with sites with low bandwidth."
  5757. msgstr ""
  5758. #. type: Content of: <refentry><refsect1><para>
  5759. #: sources.list.5.xml:107
  5760. msgid ""
  5761. "It is important to list sources in order of preference, with the most "
  5762. "preferred source listed first. Typically this will result in sorting by "
  5763. "speed from fastest to slowest (CD-ROM followed by hosts on a local network, "
  5764. "followed by distant Internet hosts, for example)."
  5765. msgstr ""
  5766. #. type: Content of: <refentry><refsect1><para>
  5767. #: sources.list.5.xml:112
  5768. msgid "Some examples:"
  5769. msgstr ""
  5770. #. type: Content of: <refentry><refsect1><literallayout>
  5771. #: sources.list.5.xml:114
  5772. #, no-wrap
  5773. msgid ""
  5774. "deb http://http.us.debian.org/debian stable main contrib non-free\n"
  5775. "deb http://http.us.debian.org/debian dists/stable-updates/\n"
  5776. " "
  5777. msgstr ""
  5778. #. type: Content of: <refentry><refsect1><title>
  5779. #: sources.list.5.xml:120
  5780. msgid "URI specification"
  5781. msgstr ""
  5782. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  5783. #: sources.list.5.xml:125
  5784. msgid "file"
  5785. msgstr ""
  5786. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5787. #: sources.list.5.xml:127
  5788. msgid ""
  5789. "The file scheme allows an arbitrary directory in the file system to be "
  5790. "considered an archive. This is useful for NFS mounts and local mirrors or "
  5791. "archives."
  5792. msgstr ""
  5793. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5794. #: sources.list.5.xml:134
  5795. msgid ""
  5796. "The cdrom scheme allows APT to use a local CDROM drive with media "
  5797. "swapping. Use the &apt-cdrom; program to create cdrom entries in the source "
  5798. "list."
  5799. msgstr ""
  5800. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5801. #: sources.list.5.xml:141
  5802. msgid ""
  5803. "The http scheme specifies an HTTP server for the archive. If an environment "
  5804. "variable <envar>http_proxy</envar> is set with the format "
  5805. "http://server:port/, the proxy server specified in <envar>http_proxy</envar> "
  5806. "will be used. Users of authenticated HTTP/1.1 proxies may use a string of "
  5807. "the format http://user:pass@server:port/ Note that this is an insecure "
  5808. "method of authentication."
  5809. msgstr ""
  5810. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5811. #: sources.list.5.xml:152
  5812. msgid ""
  5813. "The ftp scheme specifies an FTP server for the archive. APT's FTP behavior "
  5814. "is highly configurable; for more information see the &apt-conf; manual "
  5815. "page. Please note that a ftp proxy can be specified by using the "
  5816. "<envar>ftp_proxy</envar> environment variable. It is possible to specify a "
  5817. "http proxy (http proxy servers often understand ftp urls) using this method "
  5818. "and ONLY this method. ftp proxies using http specified in the configuration "
  5819. "file will be ignored."
  5820. msgstr ""
  5821. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  5822. #: sources.list.5.xml:161
  5823. msgid "copy"
  5824. msgstr ""
  5825. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5826. #: sources.list.5.xml:163
  5827. msgid ""
  5828. "The copy scheme is identical to the file scheme except that packages are "
  5829. "copied into the cache directory instead of used directly at their location. "
  5830. "This is useful for people using a zip disk to copy files around with APT."
  5831. msgstr ""
  5832. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  5833. #: sources.list.5.xml:168
  5834. msgid "rsh"
  5835. msgstr ""
  5836. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><term>
  5837. #: sources.list.5.xml:168
  5838. msgid "ssh"
  5839. msgstr ""
  5840. #. type: Content of: <refentry><refsect1><para><variablelist><varlistentry><listitem><para>
  5841. #: sources.list.5.xml:170
  5842. msgid ""
  5843. "The rsh/ssh method invokes rsh/ssh to connect to a remote host as a given "
  5844. "user and access the files. It is a good idea to do prior arrangements with "
  5845. "RSA keys or rhosts. Access to files on the remote uses standard "
  5846. "<command>find</command> and <command>dd</command> commands to perform the "
  5847. "file transfers from the remote."
  5848. msgstr ""
  5849. #. type: Content of: <refentry><refsect1><para>
  5850. #: sources.list.5.xml:122
  5851. msgid ""
  5852. "The currently recognized URI types are cdrom, file, http, ftp, copy, ssh, "
  5853. "rsh. <placeholder type=\"variablelist\" id=\"0\"/>"
  5854. msgstr ""
  5855. #. type: Content of: <refentry><refsect1><para>
  5856. #: sources.list.5.xml:182
  5857. msgid ""
  5858. "Uses the archive stored locally (or NFS mounted) at /home/jason/debian for "
  5859. "stable/main, stable/contrib, and stable/non-free."
  5860. msgstr ""
  5861. #. type: Content of: <refentry><refsect1><literallayout>
  5862. #: sources.list.5.xml:184
  5863. #, no-wrap
  5864. msgid "deb file:/home/jason/debian stable main contrib non-free"
  5865. msgstr ""
  5866. #. type: Content of: <refentry><refsect1><para>
  5867. #: sources.list.5.xml:186
  5868. msgid "As above, except this uses the unstable (development) distribution."
  5869. msgstr ""
  5870. #. type: Content of: <refentry><refsect1><literallayout>
  5871. #: sources.list.5.xml:187
  5872. #, no-wrap
  5873. msgid "deb file:/home/jason/debian unstable main contrib non-free"
  5874. msgstr ""
  5875. #. type: Content of: <refentry><refsect1><para>
  5876. #: sources.list.5.xml:189
  5877. msgid "Source line for the above"
  5878. msgstr ""
  5879. #. type: Content of: <refentry><refsect1><literallayout>
  5880. #: sources.list.5.xml:190
  5881. #, no-wrap
  5882. msgid "deb-src file:/home/jason/debian unstable main contrib non-free"
  5883. msgstr ""
  5884. #. type: Content of: <refentry><refsect1><para>
  5885. #: sources.list.5.xml:192
  5886. msgid ""
  5887. "Uses HTTP to access the archive at archive.debian.org, and uses only the "
  5888. "hamm/main area."
  5889. msgstr ""
  5890. #. type: Content of: <refentry><refsect1><literallayout>
  5891. #: sources.list.5.xml:194
  5892. #, no-wrap
  5893. msgid "deb http://archive.debian.org/debian-archive hamm main"
  5894. msgstr ""
  5895. #. type: Content of: <refentry><refsect1><para>
  5896. #: sources.list.5.xml:196
  5897. msgid ""
  5898. "Uses FTP to access the archive at ftp.debian.org, under the debian "
  5899. "directory, and uses only the stable/contrib area."
  5900. msgstr ""
  5901. #. type: Content of: <refentry><refsect1><literallayout>
  5902. #: sources.list.5.xml:198
  5903. #, no-wrap
  5904. msgid "deb ftp://ftp.debian.org/debian stable contrib"
  5905. msgstr ""
  5906. #. type: Content of: <refentry><refsect1><para>
  5907. #: sources.list.5.xml:200
  5908. msgid ""
  5909. "Uses FTP to access the archive at ftp.debian.org, under the debian "
  5910. "directory, and uses only the unstable/contrib area. If this line appears as "
  5911. "well as the one in the previous example in "
  5912. "<filename>sources.list</filename>. a single FTP session will be used for "
  5913. "both resource lines."
  5914. msgstr ""
  5915. #. type: Content of: <refentry><refsect1><literallayout>
  5916. #: sources.list.5.xml:204
  5917. #, no-wrap
  5918. msgid "deb ftp://ftp.debian.org/debian unstable contrib"
  5919. msgstr ""
  5920. #. type: Content of: <refentry><refsect1><para>
  5921. #: sources.list.5.xml:206
  5922. msgid ""
  5923. "Uses HTTP to access the archive at nonus.debian.org, under the debian-non-US "
  5924. "directory."
  5925. msgstr ""
  5926. #. type: Content of: <refentry><refsect1><literallayout>
  5927. #: sources.list.5.xml:208
  5928. #, no-wrap
  5929. msgid ""
  5930. "deb http://nonus.debian.org/debian-non-US stable/non-US main contrib "
  5931. "non-free"
  5932. msgstr ""
  5933. #. type: Content of: <refentry><refsect1><para><literallayout>
  5934. #: sources.list.5.xml:217
  5935. #, no-wrap
  5936. msgid "deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/"
  5937. msgstr ""
  5938. #. type: Content of: <refentry><refsect1><para>
  5939. #: sources.list.5.xml:210
  5940. msgid ""
  5941. "Uses HTTP to access the archive at nonus.debian.org, under the debian-non-US "
  5942. "directory, and uses only files found under "
  5943. "<filename>unstable/binary-i386</filename> on i386 machines, "
  5944. "<filename>unstable/binary-m68k</filename> on m68k, and so forth for other "
  5945. "supported architectures. [Note this example only illustrates how to use the "
  5946. "substitution variable; non-us is no longer structured like this] "
  5947. "<placeholder type=\"literallayout\" id=\"0\"/>"
  5948. msgstr ""
  5949. #. type: Content of: <refentry><refsect1><para>
  5950. #: sources.list.5.xml:222
  5951. msgid "&apt-cache; &apt-conf;"
  5952. msgstr ""