guix-manual.it.po 2.0 MB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473347434753476347734783479348034813482348334843485348634873488348934903491349234933494349534963497349834993500350135023503350435053506350735083509351035113512351335143515351635173518351935203521352235233524352535263527352835293530353135323533353435353536353735383539354035413542354335443545354635473548354935503551355235533554355535563557355835593560356135623563356435653566356735683569357035713572357335743575357635773578357935803581358235833584358535863587358835893590359135923593359435953596359735983599360036013602360336043605360636073608360936103611361236133614361536163617361836193620362136223623362436253626362736283629363036313632363336343635363636373638363936403641364236433644364536463647364836493650365136523653365436553656365736583659366036613662366336643665366636673668366936703671367236733674367536763677367836793680368136823683368436853686368736883689369036913692369336943695369636973698369937003701370237033704370537063707370837093710371137123713371437153716371737183719372037213722372337243725372637273728372937303731373237333734373537363737373837393740374137423743374437453746374737483749375037513752375337543755375637573758375937603761376237633764376537663767376837693770377137723773377437753776377737783779378037813782378337843785378637873788378937903791379237933794379537963797379837993800380138023803380438053806380738083809381038113812381338143815381638173818381938203821382238233824382538263827382838293830383138323833383438353836383738383839384038413842384338443845384638473848384938503851385238533854385538563857385838593860386138623863386438653866386738683869387038713872387338743875387638773878387938803881388238833884388538863887388838893890389138923893389438953896389738983899390039013902390339043905390639073908390939103911391239133914391539163917391839193920392139223923392439253926392739283929393039313932393339343935393639373938393939403941394239433944394539463947394839493950395139523953395439553956395739583959396039613962396339643965396639673968396939703971397239733974397539763977397839793980398139823983398439853986398739883989399039913992399339943995399639973998399940004001400240034004400540064007400840094010401140124013401440154016401740184019402040214022402340244025402640274028402940304031403240334034403540364037403840394040404140424043404440454046404740484049405040514052405340544055405640574058405940604061406240634064406540664067406840694070407140724073407440754076407740784079408040814082408340844085408640874088408940904091409240934094409540964097409840994100410141024103410441054106410741084109411041114112411341144115411641174118411941204121412241234124412541264127412841294130413141324133413441354136413741384139414041414142414341444145414641474148414941504151415241534154415541564157415841594160416141624163416441654166416741684169417041714172417341744175417641774178417941804181418241834184418541864187418841894190419141924193419441954196419741984199420042014202420342044205420642074208420942104211421242134214421542164217421842194220422142224223422442254226422742284229423042314232423342344235423642374238423942404241424242434244424542464247424842494250425142524253425442554256425742584259426042614262426342644265426642674268426942704271427242734274427542764277427842794280428142824283428442854286428742884289429042914292429342944295429642974298429943004301430243034304430543064307430843094310431143124313431443154316431743184319432043214322432343244325432643274328432943304331433243334334433543364337433843394340434143424343434443454346434743484349435043514352435343544355435643574358435943604361436243634364436543664367436843694370437143724373437443754376437743784379438043814382438343844385438643874388438943904391439243934394439543964397439843994400440144024403440444054406440744084409441044114412441344144415441644174418441944204421442244234424442544264427442844294430443144324433443444354436443744384439444044414442444344444445444644474448444944504451445244534454445544564457445844594460446144624463446444654466446744684469447044714472447344744475447644774478447944804481448244834484448544864487448844894490449144924493449444954496449744984499450045014502450345044505450645074508450945104511451245134514451545164517451845194520452145224523452445254526452745284529453045314532453345344535453645374538453945404541454245434544454545464547454845494550455145524553455445554556455745584559456045614562456345644565456645674568456945704571457245734574457545764577457845794580458145824583458445854586458745884589459045914592459345944595459645974598459946004601460246034604460546064607460846094610461146124613461446154616461746184619462046214622462346244625462646274628462946304631463246334634463546364637463846394640464146424643464446454646464746484649465046514652465346544655465646574658465946604661466246634664466546664667466846694670467146724673467446754676467746784679468046814682468346844685468646874688468946904691469246934694469546964697469846994700470147024703470447054706470747084709471047114712471347144715471647174718471947204721472247234724472547264727472847294730473147324733473447354736473747384739474047414742474347444745474647474748474947504751475247534754475547564757475847594760476147624763476447654766476747684769477047714772477347744775477647774778477947804781478247834784478547864787478847894790479147924793479447954796479747984799480048014802480348044805480648074808480948104811481248134814481548164817481848194820482148224823482448254826482748284829483048314832483348344835483648374838483948404841484248434844484548464847484848494850485148524853485448554856485748584859486048614862486348644865486648674868486948704871487248734874487548764877487848794880488148824883488448854886488748884889489048914892489348944895489648974898489949004901490249034904490549064907490849094910491149124913491449154916491749184919492049214922492349244925492649274928492949304931493249334934493549364937493849394940494149424943494449454946494749484949495049514952495349544955495649574958495949604961496249634964496549664967496849694970497149724973497449754976497749784979498049814982498349844985498649874988498949904991499249934994499549964997499849995000500150025003500450055006500750085009501050115012501350145015501650175018501950205021502250235024502550265027502850295030503150325033503450355036503750385039504050415042504350445045504650475048504950505051505250535054505550565057505850595060506150625063506450655066506750685069507050715072507350745075507650775078507950805081508250835084508550865087508850895090509150925093509450955096509750985099510051015102510351045105510651075108510951105111511251135114511551165117511851195120512151225123512451255126512751285129513051315132513351345135513651375138513951405141514251435144514551465147514851495150515151525153515451555156515751585159516051615162516351645165516651675168516951705171517251735174517551765177517851795180518151825183518451855186518751885189519051915192519351945195519651975198519952005201520252035204520552065207520852095210521152125213521452155216521752185219522052215222522352245225522652275228522952305231523252335234523552365237523852395240524152425243524452455246524752485249525052515252525352545255525652575258525952605261526252635264526552665267526852695270527152725273527452755276527752785279528052815282528352845285528652875288528952905291529252935294529552965297529852995300530153025303530453055306530753085309531053115312531353145315531653175318531953205321532253235324532553265327532853295330533153325333533453355336533753385339534053415342534353445345534653475348534953505351535253535354535553565357535853595360536153625363536453655366536753685369537053715372537353745375537653775378537953805381538253835384538553865387538853895390539153925393539453955396539753985399540054015402540354045405540654075408540954105411541254135414541554165417541854195420542154225423542454255426542754285429543054315432543354345435543654375438543954405441544254435444544554465447544854495450545154525453545454555456545754585459546054615462546354645465546654675468546954705471547254735474547554765477547854795480548154825483548454855486548754885489549054915492549354945495549654975498549955005501550255035504550555065507550855095510551155125513551455155516551755185519552055215522552355245525552655275528552955305531553255335534553555365537553855395540554155425543554455455546554755485549555055515552555355545555555655575558555955605561556255635564556555665567556855695570557155725573557455755576557755785579558055815582558355845585558655875588558955905591559255935594559555965597559855995600560156025603560456055606560756085609561056115612561356145615561656175618561956205621562256235624562556265627562856295630563156325633563456355636563756385639564056415642564356445645564656475648564956505651565256535654565556565657565856595660566156625663566456655666566756685669567056715672567356745675567656775678567956805681568256835684568556865687568856895690569156925693569456955696569756985699570057015702570357045705570657075708570957105711571257135714571557165717571857195720572157225723572457255726572757285729573057315732573357345735573657375738573957405741574257435744574557465747574857495750575157525753575457555756575757585759576057615762576357645765576657675768576957705771577257735774577557765777577857795780578157825783578457855786578757885789579057915792579357945795579657975798579958005801580258035804580558065807580858095810581158125813581458155816581758185819582058215822582358245825582658275828582958305831583258335834583558365837583858395840584158425843584458455846584758485849585058515852585358545855585658575858585958605861586258635864586558665867586858695870587158725873587458755876587758785879588058815882588358845885588658875888588958905891589258935894589558965897589858995900590159025903590459055906590759085909591059115912591359145915591659175918591959205921592259235924592559265927592859295930593159325933593459355936593759385939594059415942594359445945594659475948594959505951595259535954595559565957595859595960596159625963596459655966596759685969597059715972597359745975597659775978597959805981598259835984598559865987598859895990599159925993599459955996599759985999600060016002600360046005600660076008600960106011601260136014601560166017601860196020602160226023602460256026602760286029603060316032603360346035603660376038603960406041604260436044604560466047604860496050605160526053605460556056605760586059606060616062606360646065606660676068606960706071607260736074607560766077607860796080608160826083608460856086608760886089609060916092609360946095609660976098609961006101610261036104610561066107610861096110611161126113611461156116611761186119612061216122612361246125612661276128612961306131613261336134613561366137613861396140614161426143614461456146614761486149615061516152615361546155615661576158615961606161616261636164616561666167616861696170617161726173617461756176617761786179618061816182618361846185618661876188618961906191619261936194619561966197619861996200620162026203620462056206620762086209621062116212621362146215621662176218621962206221622262236224622562266227622862296230623162326233623462356236623762386239624062416242624362446245624662476248624962506251625262536254625562566257625862596260626162626263626462656266626762686269627062716272627362746275627662776278627962806281628262836284628562866287628862896290629162926293629462956296629762986299630063016302630363046305630663076308630963106311631263136314631563166317631863196320632163226323632463256326632763286329633063316332633363346335633663376338633963406341634263436344634563466347634863496350635163526353635463556356635763586359636063616362636363646365636663676368636963706371637263736374637563766377637863796380638163826383638463856386638763886389639063916392639363946395639663976398639964006401640264036404640564066407640864096410641164126413641464156416641764186419642064216422642364246425642664276428642964306431643264336434643564366437643864396440644164426443644464456446644764486449645064516452645364546455645664576458645964606461646264636464646564666467646864696470647164726473647464756476647764786479648064816482648364846485648664876488648964906491649264936494649564966497649864996500650165026503650465056506650765086509651065116512651365146515651665176518651965206521652265236524652565266527652865296530653165326533653465356536653765386539654065416542654365446545654665476548654965506551655265536554655565566557655865596560656165626563656465656566656765686569657065716572657365746575657665776578657965806581658265836584658565866587658865896590659165926593659465956596659765986599660066016602660366046605660666076608660966106611661266136614661566166617661866196620662166226623662466256626662766286629663066316632663366346635663666376638663966406641664266436644664566466647664866496650665166526653665466556656665766586659666066616662666366646665666666676668666966706671667266736674667566766677667866796680668166826683668466856686668766886689669066916692669366946695669666976698669967006701670267036704670567066707670867096710671167126713671467156716671767186719672067216722672367246725672667276728672967306731673267336734673567366737673867396740674167426743674467456746674767486749675067516752675367546755675667576758675967606761676267636764676567666767676867696770677167726773677467756776677767786779678067816782678367846785678667876788678967906791679267936794679567966797679867996800680168026803680468056806680768086809681068116812681368146815681668176818681968206821682268236824682568266827682868296830683168326833683468356836683768386839684068416842684368446845684668476848684968506851685268536854685568566857685868596860686168626863686468656866686768686869687068716872687368746875687668776878687968806881688268836884688568866887688868896890689168926893689468956896689768986899690069016902690369046905690669076908690969106911691269136914691569166917691869196920692169226923692469256926692769286929693069316932693369346935693669376938693969406941694269436944694569466947694869496950695169526953695469556956695769586959696069616962696369646965696669676968696969706971697269736974697569766977697869796980698169826983698469856986698769886989699069916992699369946995699669976998699970007001700270037004700570067007700870097010701170127013701470157016701770187019702070217022702370247025702670277028702970307031703270337034703570367037703870397040704170427043704470457046704770487049705070517052705370547055705670577058705970607061706270637064706570667067706870697070707170727073707470757076707770787079708070817082708370847085708670877088708970907091709270937094709570967097709870997100710171027103710471057106710771087109711071117112711371147115711671177118711971207121712271237124712571267127712871297130713171327133713471357136713771387139714071417142714371447145714671477148714971507151715271537154715571567157715871597160716171627163716471657166716771687169717071717172717371747175717671777178717971807181718271837184718571867187718871897190719171927193719471957196719771987199720072017202720372047205720672077208720972107211721272137214721572167217721872197220722172227223722472257226722772287229723072317232723372347235723672377238723972407241724272437244724572467247724872497250725172527253725472557256725772587259726072617262726372647265726672677268726972707271727272737274727572767277727872797280728172827283728472857286728772887289729072917292729372947295729672977298729973007301730273037304730573067307730873097310731173127313731473157316731773187319732073217322732373247325732673277328732973307331733273337334733573367337733873397340734173427343734473457346734773487349735073517352735373547355735673577358735973607361736273637364736573667367736873697370737173727373737473757376737773787379738073817382738373847385738673877388738973907391739273937394739573967397739873997400740174027403740474057406740774087409741074117412741374147415741674177418741974207421742274237424742574267427742874297430743174327433743474357436743774387439744074417442744374447445744674477448744974507451745274537454745574567457745874597460746174627463746474657466746774687469747074717472747374747475747674777478747974807481748274837484748574867487748874897490749174927493749474957496749774987499750075017502750375047505750675077508750975107511751275137514751575167517751875197520752175227523752475257526752775287529753075317532753375347535753675377538753975407541754275437544754575467547754875497550755175527553755475557556755775587559756075617562756375647565756675677568756975707571757275737574757575767577757875797580758175827583758475857586758775887589759075917592759375947595759675977598759976007601760276037604760576067607760876097610761176127613761476157616761776187619762076217622762376247625762676277628762976307631763276337634763576367637763876397640764176427643764476457646764776487649765076517652765376547655765676577658765976607661766276637664766576667667766876697670767176727673767476757676767776787679768076817682768376847685768676877688768976907691769276937694769576967697769876997700770177027703770477057706770777087709771077117712771377147715771677177718771977207721772277237724772577267727772877297730773177327733773477357736773777387739774077417742774377447745774677477748774977507751775277537754775577567757775877597760776177627763776477657766776777687769777077717772777377747775777677777778777977807781778277837784778577867787778877897790779177927793779477957796779777987799780078017802780378047805780678077808780978107811781278137814781578167817781878197820782178227823782478257826782778287829783078317832783378347835783678377838783978407841784278437844784578467847784878497850785178527853785478557856785778587859786078617862786378647865786678677868786978707871787278737874787578767877787878797880788178827883788478857886788778887889789078917892789378947895789678977898789979007901790279037904790579067907790879097910791179127913791479157916791779187919792079217922792379247925792679277928792979307931793279337934793579367937793879397940794179427943794479457946794779487949795079517952795379547955795679577958795979607961796279637964796579667967796879697970797179727973797479757976797779787979798079817982798379847985798679877988798979907991799279937994799579967997799879998000800180028003800480058006800780088009801080118012801380148015801680178018801980208021802280238024802580268027802880298030803180328033803480358036803780388039804080418042804380448045804680478048804980508051805280538054805580568057805880598060806180628063806480658066806780688069807080718072807380748075807680778078807980808081808280838084808580868087808880898090809180928093809480958096809780988099810081018102810381048105810681078108810981108111811281138114811581168117811881198120812181228123812481258126812781288129813081318132813381348135813681378138813981408141814281438144814581468147814881498150815181528153815481558156815781588159816081618162816381648165816681678168816981708171817281738174817581768177817881798180818181828183818481858186818781888189819081918192819381948195819681978198819982008201820282038204820582068207820882098210821182128213821482158216821782188219822082218222822382248225822682278228822982308231823282338234823582368237823882398240824182428243824482458246824782488249825082518252825382548255825682578258825982608261826282638264826582668267826882698270827182728273827482758276827782788279828082818282828382848285828682878288828982908291829282938294829582968297829882998300830183028303830483058306830783088309831083118312831383148315831683178318831983208321832283238324832583268327832883298330833183328333833483358336833783388339834083418342834383448345834683478348834983508351835283538354835583568357835883598360836183628363836483658366836783688369837083718372837383748375837683778378837983808381838283838384838583868387838883898390839183928393839483958396839783988399840084018402840384048405840684078408840984108411841284138414841584168417841884198420842184228423842484258426842784288429843084318432843384348435843684378438843984408441844284438444844584468447844884498450845184528453845484558456845784588459846084618462846384648465846684678468846984708471847284738474847584768477847884798480848184828483848484858486848784888489849084918492849384948495849684978498849985008501850285038504850585068507850885098510851185128513851485158516851785188519852085218522852385248525852685278528852985308531853285338534853585368537853885398540854185428543854485458546854785488549855085518552855385548555855685578558855985608561856285638564856585668567856885698570857185728573857485758576857785788579858085818582858385848585858685878588858985908591859285938594859585968597859885998600860186028603860486058606860786088609861086118612861386148615861686178618861986208621862286238624862586268627862886298630863186328633863486358636863786388639864086418642864386448645864686478648864986508651865286538654865586568657865886598660866186628663866486658666866786688669867086718672867386748675867686778678867986808681868286838684868586868687868886898690869186928693869486958696869786988699870087018702870387048705870687078708870987108711871287138714871587168717871887198720872187228723872487258726872787288729873087318732873387348735873687378738873987408741874287438744874587468747874887498750875187528753875487558756875787588759876087618762876387648765876687678768876987708771877287738774877587768777877887798780878187828783878487858786878787888789879087918792879387948795879687978798879988008801880288038804880588068807880888098810881188128813881488158816881788188819882088218822882388248825882688278828882988308831883288338834883588368837883888398840884188428843884488458846884788488849885088518852885388548855885688578858885988608861886288638864886588668867886888698870887188728873887488758876887788788879888088818882888388848885888688878888888988908891889288938894889588968897889888998900890189028903890489058906890789088909891089118912891389148915891689178918891989208921892289238924892589268927892889298930893189328933893489358936893789388939894089418942894389448945894689478948894989508951895289538954895589568957895889598960896189628963896489658966896789688969897089718972897389748975897689778978897989808981898289838984898589868987898889898990899189928993899489958996899789988999900090019002900390049005900690079008900990109011901290139014901590169017901890199020902190229023902490259026902790289029903090319032903390349035903690379038903990409041904290439044904590469047904890499050905190529053905490559056905790589059906090619062906390649065906690679068906990709071907290739074907590769077907890799080908190829083908490859086908790889089909090919092909390949095909690979098909991009101910291039104910591069107910891099110911191129113911491159116911791189119912091219122912391249125912691279128912991309131913291339134913591369137913891399140914191429143914491459146914791489149915091519152915391549155915691579158915991609161916291639164916591669167916891699170917191729173917491759176917791789179918091819182918391849185918691879188918991909191919291939194919591969197919891999200920192029203920492059206920792089209921092119212921392149215921692179218921992209221922292239224922592269227922892299230923192329233923492359236923792389239924092419242924392449245924692479248924992509251925292539254925592569257925892599260926192629263926492659266926792689269927092719272927392749275927692779278927992809281928292839284928592869287928892899290929192929293929492959296929792989299930093019302930393049305930693079308930993109311931293139314931593169317931893199320932193229323932493259326932793289329933093319332933393349335933693379338933993409341934293439344934593469347934893499350935193529353935493559356935793589359936093619362936393649365936693679368936993709371937293739374937593769377937893799380938193829383938493859386938793889389939093919392939393949395939693979398939994009401940294039404940594069407940894099410941194129413941494159416941794189419942094219422942394249425942694279428942994309431943294339434943594369437943894399440944194429443944494459446944794489449945094519452945394549455945694579458945994609461946294639464946594669467946894699470947194729473947494759476947794789479948094819482948394849485948694879488948994909491949294939494949594969497949894999500950195029503950495059506950795089509951095119512951395149515951695179518951995209521952295239524952595269527952895299530953195329533953495359536953795389539954095419542954395449545954695479548954995509551955295539554955595569557955895599560956195629563956495659566956795689569957095719572957395749575957695779578957995809581958295839584958595869587958895899590959195929593959495959596959795989599960096019602960396049605960696079608960996109611961296139614961596169617961896199620962196229623962496259626962796289629963096319632963396349635963696379638963996409641964296439644964596469647964896499650965196529653965496559656965796589659966096619662966396649665966696679668966996709671967296739674967596769677967896799680968196829683968496859686968796889689969096919692969396949695969696979698969997009701970297039704970597069707970897099710971197129713971497159716971797189719972097219722972397249725972697279728972997309731973297339734973597369737973897399740974197429743974497459746974797489749975097519752975397549755975697579758975997609761976297639764976597669767976897699770977197729773977497759776977797789779978097819782978397849785978697879788978997909791979297939794979597969797979897999800980198029803980498059806980798089809981098119812981398149815981698179818981998209821982298239824982598269827982898299830983198329833983498359836983798389839984098419842984398449845984698479848984998509851985298539854985598569857985898599860986198629863986498659866986798689869987098719872987398749875987698779878987998809881988298839884988598869887988898899890989198929893989498959896989798989899990099019902990399049905990699079908990999109911991299139914991599169917991899199920992199229923992499259926992799289929993099319932993399349935993699379938993999409941994299439944994599469947994899499950995199529953995499559956995799589959996099619962996399649965996699679968996999709971997299739974997599769977997899799980998199829983998499859986998799889989999099919992999399949995999699979998999910000100011000210003100041000510006100071000810009100101001110012100131001410015100161001710018100191002010021100221002310024100251002610027100281002910030100311003210033100341003510036100371003810039100401004110042100431004410045100461004710048100491005010051100521005310054100551005610057100581005910060100611006210063100641006510066100671006810069100701007110072100731007410075100761007710078100791008010081100821008310084100851008610087100881008910090100911009210093100941009510096100971009810099101001010110102101031010410105101061010710108101091011010111101121011310114101151011610117101181011910120101211012210123101241012510126101271012810129101301013110132101331013410135101361013710138101391014010141101421014310144101451014610147101481014910150101511015210153101541015510156101571015810159101601016110162101631016410165101661016710168101691017010171101721017310174101751017610177101781017910180101811018210183101841018510186101871018810189101901019110192101931019410195101961019710198101991020010201102021020310204102051020610207102081020910210102111021210213102141021510216102171021810219102201022110222102231022410225102261022710228102291023010231102321023310234102351023610237102381023910240102411024210243102441024510246102471024810249102501025110252102531025410255102561025710258102591026010261102621026310264102651026610267102681026910270102711027210273102741027510276102771027810279102801028110282102831028410285102861028710288102891029010291102921029310294102951029610297102981029910300103011030210303103041030510306103071030810309103101031110312103131031410315103161031710318103191032010321103221032310324103251032610327103281032910330103311033210333103341033510336103371033810339103401034110342103431034410345103461034710348103491035010351103521035310354103551035610357103581035910360103611036210363103641036510366103671036810369103701037110372103731037410375103761037710378103791038010381103821038310384103851038610387103881038910390103911039210393103941039510396103971039810399104001040110402104031040410405104061040710408104091041010411104121041310414104151041610417104181041910420104211042210423104241042510426104271042810429104301043110432104331043410435104361043710438104391044010441104421044310444104451044610447104481044910450104511045210453104541045510456104571045810459104601046110462104631046410465104661046710468104691047010471104721047310474104751047610477104781047910480104811048210483104841048510486104871048810489104901049110492104931049410495104961049710498104991050010501105021050310504105051050610507105081050910510105111051210513105141051510516105171051810519105201052110522105231052410525105261052710528105291053010531105321053310534105351053610537105381053910540105411054210543105441054510546105471054810549105501055110552105531055410555105561055710558105591056010561105621056310564105651056610567105681056910570105711057210573105741057510576105771057810579105801058110582105831058410585105861058710588105891059010591105921059310594105951059610597105981059910600106011060210603106041060510606106071060810609106101061110612106131061410615106161061710618106191062010621106221062310624106251062610627106281062910630106311063210633106341063510636106371063810639106401064110642106431064410645106461064710648106491065010651106521065310654106551065610657106581065910660106611066210663106641066510666106671066810669106701067110672106731067410675106761067710678106791068010681106821068310684106851068610687106881068910690106911069210693106941069510696106971069810699107001070110702107031070410705107061070710708107091071010711107121071310714107151071610717107181071910720107211072210723107241072510726107271072810729107301073110732107331073410735107361073710738107391074010741107421074310744107451074610747107481074910750107511075210753107541075510756107571075810759107601076110762107631076410765107661076710768107691077010771107721077310774107751077610777107781077910780107811078210783107841078510786107871078810789107901079110792107931079410795107961079710798107991080010801108021080310804108051080610807108081080910810108111081210813108141081510816108171081810819108201082110822108231082410825108261082710828108291083010831108321083310834108351083610837108381083910840108411084210843108441084510846108471084810849108501085110852108531085410855108561085710858108591086010861108621086310864108651086610867108681086910870108711087210873108741087510876108771087810879108801088110882108831088410885108861088710888108891089010891108921089310894108951089610897108981089910900109011090210903109041090510906109071090810909109101091110912109131091410915109161091710918109191092010921109221092310924109251092610927109281092910930109311093210933109341093510936109371093810939109401094110942109431094410945109461094710948109491095010951109521095310954109551095610957109581095910960109611096210963109641096510966109671096810969109701097110972109731097410975109761097710978109791098010981109821098310984109851098610987109881098910990109911099210993109941099510996109971099810999110001100111002110031100411005110061100711008110091101011011110121101311014110151101611017110181101911020110211102211023110241102511026110271102811029110301103111032110331103411035110361103711038110391104011041110421104311044110451104611047110481104911050110511105211053110541105511056110571105811059110601106111062110631106411065110661106711068110691107011071110721107311074110751107611077110781107911080110811108211083110841108511086110871108811089110901109111092110931109411095110961109711098110991110011101111021110311104111051110611107111081110911110111111111211113111141111511116111171111811119111201112111122111231112411125111261112711128111291113011131111321113311134111351113611137111381113911140111411114211143111441114511146111471114811149111501115111152111531115411155111561115711158111591116011161111621116311164111651116611167111681116911170111711117211173111741117511176111771117811179111801118111182111831118411185111861118711188111891119011191111921119311194111951119611197111981119911200112011120211203112041120511206112071120811209112101121111212112131121411215112161121711218112191122011221112221122311224112251122611227112281122911230112311123211233112341123511236112371123811239112401124111242112431124411245112461124711248112491125011251112521125311254112551125611257112581125911260112611126211263112641126511266112671126811269112701127111272112731127411275112761127711278112791128011281112821128311284112851128611287112881128911290112911129211293112941129511296112971129811299113001130111302113031130411305113061130711308113091131011311113121131311314113151131611317113181131911320113211132211323113241132511326113271132811329113301133111332113331133411335113361133711338113391134011341113421134311344113451134611347113481134911350113511135211353113541135511356113571135811359113601136111362113631136411365113661136711368113691137011371113721137311374113751137611377113781137911380113811138211383113841138511386113871138811389113901139111392113931139411395113961139711398113991140011401114021140311404114051140611407114081140911410114111141211413114141141511416114171141811419114201142111422114231142411425114261142711428114291143011431114321143311434114351143611437114381143911440114411144211443114441144511446114471144811449114501145111452114531145411455114561145711458114591146011461114621146311464114651146611467114681146911470114711147211473114741147511476114771147811479114801148111482114831148411485114861148711488114891149011491114921149311494114951149611497114981149911500115011150211503115041150511506115071150811509115101151111512115131151411515115161151711518115191152011521115221152311524115251152611527115281152911530115311153211533115341153511536115371153811539115401154111542115431154411545115461154711548115491155011551115521155311554115551155611557115581155911560115611156211563115641156511566115671156811569115701157111572115731157411575115761157711578115791158011581115821158311584115851158611587115881158911590115911159211593115941159511596115971159811599116001160111602116031160411605116061160711608116091161011611116121161311614116151161611617116181161911620116211162211623116241162511626116271162811629116301163111632116331163411635116361163711638116391164011641116421164311644116451164611647116481164911650116511165211653116541165511656116571165811659116601166111662116631166411665116661166711668116691167011671116721167311674116751167611677116781167911680116811168211683116841168511686116871168811689116901169111692116931169411695116961169711698116991170011701117021170311704117051170611707117081170911710117111171211713117141171511716117171171811719117201172111722117231172411725117261172711728117291173011731117321173311734117351173611737117381173911740117411174211743117441174511746117471174811749117501175111752117531175411755117561175711758117591176011761117621176311764117651176611767117681176911770117711177211773117741177511776117771177811779117801178111782117831178411785117861178711788117891179011791117921179311794117951179611797117981179911800118011180211803118041180511806118071180811809118101181111812118131181411815118161181711818118191182011821118221182311824118251182611827118281182911830118311183211833118341183511836118371183811839118401184111842118431184411845118461184711848118491185011851118521185311854118551185611857118581185911860118611186211863118641186511866118671186811869118701187111872118731187411875118761187711878118791188011881118821188311884118851188611887118881188911890118911189211893118941189511896118971189811899119001190111902119031190411905119061190711908119091191011911119121191311914119151191611917119181191911920119211192211923119241192511926119271192811929119301193111932119331193411935119361193711938119391194011941119421194311944119451194611947119481194911950119511195211953119541195511956119571195811959119601196111962119631196411965119661196711968119691197011971119721197311974119751197611977119781197911980119811198211983119841198511986119871198811989119901199111992119931199411995119961199711998119991200012001120021200312004120051200612007120081200912010120111201212013120141201512016120171201812019120201202112022120231202412025120261202712028120291203012031120321203312034120351203612037120381203912040120411204212043120441204512046120471204812049120501205112052120531205412055120561205712058120591206012061120621206312064120651206612067120681206912070120711207212073120741207512076120771207812079120801208112082120831208412085120861208712088120891209012091120921209312094120951209612097120981209912100121011210212103121041210512106121071210812109121101211112112121131211412115121161211712118121191212012121121221212312124121251212612127121281212912130121311213212133121341213512136121371213812139121401214112142121431214412145121461214712148121491215012151121521215312154121551215612157121581215912160121611216212163121641216512166121671216812169121701217112172121731217412175121761217712178121791218012181121821218312184121851218612187121881218912190121911219212193121941219512196121971219812199122001220112202122031220412205122061220712208122091221012211122121221312214122151221612217122181221912220122211222212223122241222512226122271222812229122301223112232122331223412235122361223712238122391224012241122421224312244122451224612247122481224912250122511225212253122541225512256122571225812259122601226112262122631226412265122661226712268122691227012271122721227312274122751227612277122781227912280122811228212283122841228512286122871228812289122901229112292122931229412295122961229712298122991230012301123021230312304123051230612307123081230912310123111231212313123141231512316123171231812319123201232112322123231232412325123261232712328123291233012331123321233312334123351233612337123381233912340123411234212343123441234512346123471234812349123501235112352123531235412355123561235712358123591236012361123621236312364123651236612367123681236912370123711237212373123741237512376123771237812379123801238112382123831238412385123861238712388123891239012391123921239312394123951239612397123981239912400124011240212403124041240512406124071240812409124101241112412124131241412415124161241712418124191242012421124221242312424124251242612427124281242912430124311243212433124341243512436124371243812439124401244112442124431244412445124461244712448124491245012451124521245312454124551245612457124581245912460124611246212463124641246512466124671246812469124701247112472124731247412475124761247712478124791248012481124821248312484124851248612487124881248912490124911249212493124941249512496124971249812499125001250112502125031250412505125061250712508125091251012511125121251312514125151251612517125181251912520125211252212523125241252512526125271252812529125301253112532125331253412535125361253712538125391254012541125421254312544125451254612547125481254912550125511255212553125541255512556125571255812559125601256112562125631256412565125661256712568125691257012571125721257312574125751257612577125781257912580125811258212583125841258512586125871258812589125901259112592125931259412595125961259712598125991260012601126021260312604126051260612607126081260912610126111261212613126141261512616126171261812619126201262112622126231262412625126261262712628126291263012631126321263312634126351263612637126381263912640126411264212643126441264512646126471264812649126501265112652126531265412655126561265712658126591266012661126621266312664126651266612667126681266912670126711267212673126741267512676126771267812679126801268112682126831268412685126861268712688126891269012691126921269312694126951269612697126981269912700127011270212703127041270512706127071270812709127101271112712127131271412715127161271712718127191272012721127221272312724127251272612727127281272912730127311273212733127341273512736127371273812739127401274112742127431274412745127461274712748127491275012751127521275312754127551275612757127581275912760127611276212763127641276512766127671276812769127701277112772127731277412775127761277712778127791278012781127821278312784127851278612787127881278912790127911279212793127941279512796127971279812799128001280112802128031280412805128061280712808128091281012811128121281312814128151281612817128181281912820128211282212823128241282512826128271282812829128301283112832128331283412835128361283712838128391284012841128421284312844128451284612847128481284912850128511285212853128541285512856128571285812859128601286112862128631286412865128661286712868128691287012871128721287312874128751287612877128781287912880128811288212883128841288512886128871288812889128901289112892128931289412895128961289712898128991290012901129021290312904129051290612907129081290912910129111291212913129141291512916129171291812919129201292112922129231292412925129261292712928129291293012931129321293312934129351293612937129381293912940129411294212943129441294512946129471294812949129501295112952129531295412955129561295712958129591296012961129621296312964129651296612967129681296912970129711297212973129741297512976129771297812979129801298112982129831298412985129861298712988129891299012991129921299312994129951299612997129981299913000130011300213003130041300513006130071300813009130101301113012130131301413015130161301713018130191302013021130221302313024130251302613027130281302913030130311303213033130341303513036130371303813039130401304113042130431304413045130461304713048130491305013051130521305313054130551305613057130581305913060130611306213063130641306513066130671306813069130701307113072130731307413075130761307713078130791308013081130821308313084130851308613087130881308913090130911309213093130941309513096130971309813099131001310113102131031310413105131061310713108131091311013111131121311313114131151311613117131181311913120131211312213123131241312513126131271312813129131301313113132131331313413135131361313713138131391314013141131421314313144131451314613147131481314913150131511315213153131541315513156131571315813159131601316113162131631316413165131661316713168131691317013171131721317313174131751317613177131781317913180131811318213183131841318513186131871318813189131901319113192131931319413195131961319713198131991320013201132021320313204132051320613207132081320913210132111321213213132141321513216132171321813219132201322113222132231322413225132261322713228132291323013231132321323313234132351323613237132381323913240132411324213243132441324513246132471324813249132501325113252132531325413255132561325713258132591326013261132621326313264132651326613267132681326913270132711327213273132741327513276132771327813279132801328113282132831328413285132861328713288132891329013291132921329313294132951329613297132981329913300133011330213303133041330513306133071330813309133101331113312133131331413315133161331713318133191332013321133221332313324133251332613327133281332913330133311333213333133341333513336133371333813339133401334113342133431334413345133461334713348133491335013351133521335313354133551335613357133581335913360133611336213363133641336513366133671336813369133701337113372133731337413375133761337713378133791338013381133821338313384133851338613387133881338913390133911339213393133941339513396133971339813399134001340113402134031340413405134061340713408134091341013411134121341313414134151341613417134181341913420134211342213423134241342513426134271342813429134301343113432134331343413435134361343713438134391344013441134421344313444134451344613447134481344913450134511345213453134541345513456134571345813459134601346113462134631346413465134661346713468134691347013471134721347313474134751347613477134781347913480134811348213483134841348513486134871348813489134901349113492134931349413495134961349713498134991350013501135021350313504135051350613507135081350913510135111351213513135141351513516135171351813519135201352113522135231352413525135261352713528135291353013531135321353313534135351353613537135381353913540135411354213543135441354513546135471354813549135501355113552135531355413555135561355713558135591356013561135621356313564135651356613567135681356913570135711357213573135741357513576135771357813579135801358113582135831358413585135861358713588135891359013591135921359313594135951359613597135981359913600136011360213603136041360513606136071360813609136101361113612136131361413615136161361713618136191362013621136221362313624136251362613627136281362913630136311363213633136341363513636136371363813639136401364113642136431364413645136461364713648136491365013651136521365313654136551365613657136581365913660136611366213663136641366513666136671366813669136701367113672136731367413675136761367713678136791368013681136821368313684136851368613687136881368913690136911369213693136941369513696136971369813699137001370113702137031370413705137061370713708137091371013711137121371313714137151371613717137181371913720137211372213723137241372513726137271372813729137301373113732137331373413735137361373713738137391374013741137421374313744137451374613747137481374913750137511375213753137541375513756137571375813759137601376113762137631376413765137661376713768137691377013771137721377313774137751377613777137781377913780137811378213783137841378513786137871378813789137901379113792137931379413795137961379713798137991380013801138021380313804138051380613807138081380913810138111381213813138141381513816138171381813819138201382113822138231382413825138261382713828138291383013831138321383313834138351383613837138381383913840138411384213843138441384513846138471384813849138501385113852138531385413855138561385713858138591386013861138621386313864138651386613867138681386913870138711387213873138741387513876138771387813879138801388113882138831388413885138861388713888138891389013891138921389313894138951389613897138981389913900139011390213903139041390513906139071390813909139101391113912139131391413915139161391713918139191392013921139221392313924139251392613927139281392913930139311393213933139341393513936139371393813939139401394113942139431394413945139461394713948139491395013951139521395313954139551395613957139581395913960139611396213963139641396513966139671396813969139701397113972139731397413975139761397713978139791398013981139821398313984139851398613987139881398913990139911399213993139941399513996139971399813999140001400114002140031400414005140061400714008140091401014011140121401314014140151401614017140181401914020140211402214023140241402514026140271402814029140301403114032140331403414035140361403714038140391404014041140421404314044140451404614047140481404914050140511405214053140541405514056140571405814059140601406114062140631406414065140661406714068140691407014071140721407314074140751407614077140781407914080140811408214083140841408514086140871408814089140901409114092140931409414095140961409714098140991410014101141021410314104141051410614107141081410914110141111411214113141141411514116141171411814119141201412114122141231412414125141261412714128141291413014131141321413314134141351413614137141381413914140141411414214143141441414514146141471414814149141501415114152141531415414155141561415714158141591416014161141621416314164141651416614167141681416914170141711417214173141741417514176141771417814179141801418114182141831418414185141861418714188141891419014191141921419314194141951419614197141981419914200142011420214203142041420514206142071420814209142101421114212142131421414215142161421714218142191422014221142221422314224142251422614227142281422914230142311423214233142341423514236142371423814239142401424114242142431424414245142461424714248142491425014251142521425314254142551425614257142581425914260142611426214263142641426514266142671426814269142701427114272142731427414275142761427714278142791428014281142821428314284142851428614287142881428914290142911429214293142941429514296142971429814299143001430114302143031430414305143061430714308143091431014311143121431314314143151431614317143181431914320143211432214323143241432514326143271432814329143301433114332143331433414335143361433714338143391434014341143421434314344143451434614347143481434914350143511435214353143541435514356143571435814359143601436114362143631436414365143661436714368143691437014371143721437314374143751437614377143781437914380143811438214383143841438514386143871438814389143901439114392143931439414395143961439714398143991440014401144021440314404144051440614407144081440914410144111441214413144141441514416144171441814419144201442114422144231442414425144261442714428144291443014431144321443314434144351443614437144381443914440144411444214443144441444514446144471444814449144501445114452144531445414455144561445714458144591446014461144621446314464144651446614467144681446914470144711447214473144741447514476144771447814479144801448114482144831448414485144861448714488144891449014491144921449314494144951449614497144981449914500145011450214503145041450514506145071450814509145101451114512145131451414515145161451714518145191452014521145221452314524145251452614527145281452914530145311453214533145341453514536145371453814539145401454114542145431454414545145461454714548145491455014551145521455314554145551455614557145581455914560145611456214563145641456514566145671456814569145701457114572145731457414575145761457714578145791458014581145821458314584145851458614587145881458914590145911459214593145941459514596145971459814599146001460114602146031460414605146061460714608146091461014611146121461314614146151461614617146181461914620146211462214623146241462514626146271462814629146301463114632146331463414635146361463714638146391464014641146421464314644146451464614647146481464914650146511465214653146541465514656146571465814659146601466114662146631466414665146661466714668146691467014671146721467314674146751467614677146781467914680146811468214683146841468514686146871468814689146901469114692146931469414695146961469714698146991470014701147021470314704147051470614707147081470914710147111471214713147141471514716147171471814719147201472114722147231472414725147261472714728147291473014731147321473314734147351473614737147381473914740147411474214743147441474514746147471474814749147501475114752147531475414755147561475714758147591476014761147621476314764147651476614767147681476914770147711477214773147741477514776147771477814779147801478114782147831478414785147861478714788147891479014791147921479314794147951479614797147981479914800148011480214803148041480514806148071480814809148101481114812148131481414815148161481714818148191482014821148221482314824148251482614827148281482914830148311483214833148341483514836148371483814839148401484114842148431484414845148461484714848148491485014851148521485314854148551485614857148581485914860148611486214863148641486514866148671486814869148701487114872148731487414875148761487714878148791488014881148821488314884148851488614887148881488914890148911489214893148941489514896148971489814899149001490114902149031490414905149061490714908149091491014911149121491314914149151491614917149181491914920149211492214923149241492514926149271492814929149301493114932149331493414935149361493714938149391494014941149421494314944149451494614947149481494914950149511495214953149541495514956149571495814959149601496114962149631496414965149661496714968149691497014971149721497314974149751497614977149781497914980149811498214983149841498514986149871498814989149901499114992149931499414995149961499714998149991500015001150021500315004150051500615007150081500915010150111501215013150141501515016150171501815019150201502115022150231502415025150261502715028150291503015031150321503315034150351503615037150381503915040150411504215043150441504515046150471504815049150501505115052150531505415055150561505715058150591506015061150621506315064150651506615067150681506915070150711507215073150741507515076150771507815079150801508115082150831508415085150861508715088150891509015091150921509315094150951509615097150981509915100151011510215103151041510515106151071510815109151101511115112151131511415115151161511715118151191512015121151221512315124151251512615127151281512915130151311513215133151341513515136151371513815139151401514115142151431514415145151461514715148151491515015151151521515315154151551515615157151581515915160151611516215163151641516515166151671516815169151701517115172151731517415175151761517715178151791518015181151821518315184151851518615187151881518915190151911519215193151941519515196151971519815199152001520115202152031520415205152061520715208152091521015211152121521315214152151521615217152181521915220152211522215223152241522515226152271522815229152301523115232152331523415235152361523715238152391524015241152421524315244152451524615247152481524915250152511525215253152541525515256152571525815259152601526115262152631526415265152661526715268152691527015271152721527315274152751527615277152781527915280152811528215283152841528515286152871528815289152901529115292152931529415295152961529715298152991530015301153021530315304153051530615307153081530915310153111531215313153141531515316153171531815319153201532115322153231532415325153261532715328153291533015331153321533315334153351533615337153381533915340153411534215343153441534515346153471534815349153501535115352153531535415355153561535715358153591536015361153621536315364153651536615367153681536915370153711537215373153741537515376153771537815379153801538115382153831538415385153861538715388153891539015391153921539315394153951539615397153981539915400154011540215403154041540515406154071540815409154101541115412154131541415415154161541715418154191542015421154221542315424154251542615427154281542915430154311543215433154341543515436154371543815439154401544115442154431544415445154461544715448154491545015451154521545315454154551545615457154581545915460154611546215463154641546515466154671546815469154701547115472154731547415475154761547715478154791548015481154821548315484154851548615487154881548915490154911549215493154941549515496154971549815499155001550115502155031550415505155061550715508155091551015511155121551315514155151551615517155181551915520155211552215523155241552515526155271552815529155301553115532155331553415535155361553715538155391554015541155421554315544155451554615547155481554915550155511555215553155541555515556155571555815559155601556115562155631556415565155661556715568155691557015571155721557315574155751557615577155781557915580155811558215583155841558515586155871558815589155901559115592155931559415595155961559715598155991560015601156021560315604156051560615607156081560915610156111561215613156141561515616156171561815619156201562115622156231562415625156261562715628156291563015631156321563315634156351563615637156381563915640156411564215643156441564515646156471564815649156501565115652156531565415655156561565715658156591566015661156621566315664156651566615667156681566915670156711567215673156741567515676156771567815679156801568115682156831568415685156861568715688156891569015691156921569315694156951569615697156981569915700157011570215703157041570515706157071570815709157101571115712157131571415715157161571715718157191572015721157221572315724157251572615727157281572915730157311573215733157341573515736157371573815739157401574115742157431574415745157461574715748157491575015751157521575315754157551575615757157581575915760157611576215763157641576515766157671576815769157701577115772157731577415775157761577715778157791578015781157821578315784157851578615787157881578915790157911579215793157941579515796157971579815799158001580115802158031580415805158061580715808158091581015811158121581315814158151581615817158181581915820158211582215823158241582515826158271582815829158301583115832158331583415835158361583715838158391584015841158421584315844158451584615847158481584915850158511585215853158541585515856158571585815859158601586115862158631586415865158661586715868158691587015871158721587315874158751587615877158781587915880158811588215883158841588515886158871588815889158901589115892158931589415895158961589715898158991590015901159021590315904159051590615907159081590915910159111591215913159141591515916159171591815919159201592115922159231592415925159261592715928159291593015931159321593315934159351593615937159381593915940159411594215943159441594515946159471594815949159501595115952159531595415955159561595715958159591596015961159621596315964159651596615967159681596915970159711597215973159741597515976159771597815979159801598115982159831598415985159861598715988159891599015991159921599315994159951599615997159981599916000160011600216003160041600516006160071600816009160101601116012160131601416015160161601716018160191602016021160221602316024160251602616027160281602916030160311603216033160341603516036160371603816039160401604116042160431604416045160461604716048160491605016051160521605316054160551605616057160581605916060160611606216063160641606516066160671606816069160701607116072160731607416075160761607716078160791608016081160821608316084160851608616087160881608916090160911609216093160941609516096160971609816099161001610116102161031610416105161061610716108161091611016111161121611316114161151611616117161181611916120161211612216123161241612516126161271612816129161301613116132161331613416135161361613716138161391614016141161421614316144161451614616147161481614916150161511615216153161541615516156161571615816159161601616116162161631616416165161661616716168161691617016171161721617316174161751617616177161781617916180161811618216183161841618516186161871618816189161901619116192161931619416195161961619716198161991620016201162021620316204162051620616207162081620916210162111621216213162141621516216162171621816219162201622116222162231622416225162261622716228162291623016231162321623316234162351623616237162381623916240162411624216243162441624516246162471624816249162501625116252162531625416255162561625716258162591626016261162621626316264162651626616267162681626916270162711627216273162741627516276162771627816279162801628116282162831628416285162861628716288162891629016291162921629316294162951629616297162981629916300163011630216303163041630516306163071630816309163101631116312163131631416315163161631716318163191632016321163221632316324163251632616327163281632916330163311633216333163341633516336163371633816339163401634116342163431634416345163461634716348163491635016351163521635316354163551635616357163581635916360163611636216363163641636516366163671636816369163701637116372163731637416375163761637716378163791638016381163821638316384163851638616387163881638916390163911639216393163941639516396163971639816399164001640116402164031640416405164061640716408164091641016411164121641316414164151641616417164181641916420164211642216423164241642516426164271642816429164301643116432164331643416435164361643716438164391644016441164421644316444164451644616447164481644916450164511645216453164541645516456164571645816459164601646116462164631646416465164661646716468164691647016471164721647316474164751647616477164781647916480164811648216483164841648516486164871648816489164901649116492164931649416495164961649716498164991650016501165021650316504165051650616507165081650916510165111651216513165141651516516165171651816519165201652116522165231652416525165261652716528165291653016531165321653316534165351653616537165381653916540165411654216543165441654516546165471654816549165501655116552165531655416555165561655716558165591656016561165621656316564165651656616567165681656916570165711657216573165741657516576165771657816579165801658116582165831658416585165861658716588165891659016591165921659316594165951659616597165981659916600166011660216603166041660516606166071660816609166101661116612166131661416615166161661716618166191662016621166221662316624166251662616627166281662916630166311663216633166341663516636166371663816639166401664116642166431664416645166461664716648166491665016651166521665316654166551665616657166581665916660166611666216663166641666516666166671666816669166701667116672166731667416675166761667716678166791668016681166821668316684166851668616687166881668916690166911669216693166941669516696166971669816699167001670116702167031670416705167061670716708167091671016711167121671316714167151671616717167181671916720167211672216723167241672516726167271672816729167301673116732167331673416735167361673716738167391674016741167421674316744167451674616747167481674916750167511675216753167541675516756167571675816759167601676116762167631676416765167661676716768167691677016771167721677316774167751677616777167781677916780167811678216783167841678516786167871678816789167901679116792167931679416795167961679716798167991680016801168021680316804168051680616807168081680916810168111681216813168141681516816168171681816819168201682116822168231682416825168261682716828168291683016831168321683316834168351683616837168381683916840168411684216843168441684516846168471684816849168501685116852168531685416855168561685716858168591686016861168621686316864168651686616867168681686916870168711687216873168741687516876168771687816879168801688116882168831688416885168861688716888168891689016891168921689316894168951689616897168981689916900169011690216903169041690516906169071690816909169101691116912169131691416915169161691716918169191692016921169221692316924169251692616927169281692916930169311693216933169341693516936169371693816939169401694116942169431694416945169461694716948169491695016951169521695316954169551695616957169581695916960169611696216963169641696516966169671696816969169701697116972169731697416975169761697716978169791698016981169821698316984169851698616987169881698916990169911699216993169941699516996169971699816999170001700117002170031700417005170061700717008170091701017011170121701317014170151701617017170181701917020170211702217023170241702517026170271702817029170301703117032170331703417035170361703717038170391704017041170421704317044170451704617047170481704917050170511705217053170541705517056170571705817059170601706117062170631706417065170661706717068170691707017071170721707317074170751707617077170781707917080170811708217083170841708517086170871708817089170901709117092170931709417095170961709717098170991710017101171021710317104171051710617107171081710917110171111711217113171141711517116171171711817119171201712117122171231712417125171261712717128171291713017131171321713317134171351713617137171381713917140171411714217143171441714517146171471714817149171501715117152171531715417155171561715717158171591716017161171621716317164171651716617167171681716917170171711717217173171741717517176171771717817179171801718117182171831718417185171861718717188171891719017191171921719317194171951719617197171981719917200172011720217203172041720517206172071720817209172101721117212172131721417215172161721717218172191722017221172221722317224172251722617227172281722917230172311723217233172341723517236172371723817239172401724117242172431724417245172461724717248172491725017251172521725317254172551725617257172581725917260172611726217263172641726517266172671726817269172701727117272172731727417275172761727717278172791728017281172821728317284172851728617287172881728917290172911729217293172941729517296172971729817299173001730117302173031730417305173061730717308173091731017311173121731317314173151731617317173181731917320173211732217323173241732517326173271732817329173301733117332173331733417335173361733717338173391734017341173421734317344173451734617347173481734917350173511735217353173541735517356173571735817359173601736117362173631736417365173661736717368173691737017371173721737317374173751737617377173781737917380173811738217383173841738517386173871738817389173901739117392173931739417395173961739717398173991740017401174021740317404174051740617407174081740917410174111741217413174141741517416174171741817419174201742117422174231742417425174261742717428174291743017431174321743317434174351743617437174381743917440174411744217443174441744517446174471744817449174501745117452174531745417455174561745717458174591746017461174621746317464174651746617467174681746917470174711747217473174741747517476174771747817479174801748117482174831748417485174861748717488174891749017491174921749317494174951749617497174981749917500175011750217503175041750517506175071750817509175101751117512175131751417515175161751717518175191752017521175221752317524175251752617527175281752917530175311753217533175341753517536175371753817539175401754117542175431754417545175461754717548175491755017551175521755317554175551755617557175581755917560175611756217563175641756517566175671756817569175701757117572175731757417575175761757717578175791758017581175821758317584175851758617587175881758917590175911759217593175941759517596175971759817599176001760117602176031760417605176061760717608176091761017611176121761317614176151761617617176181761917620176211762217623176241762517626176271762817629176301763117632176331763417635176361763717638176391764017641176421764317644176451764617647176481764917650176511765217653176541765517656176571765817659176601766117662176631766417665176661766717668176691767017671176721767317674176751767617677176781767917680176811768217683176841768517686176871768817689176901769117692176931769417695176961769717698176991770017701177021770317704177051770617707177081770917710177111771217713177141771517716177171771817719177201772117722177231772417725177261772717728177291773017731177321773317734177351773617737177381773917740177411774217743177441774517746177471774817749177501775117752177531775417755177561775717758177591776017761177621776317764177651776617767177681776917770177711777217773177741777517776177771777817779177801778117782177831778417785177861778717788177891779017791177921779317794177951779617797177981779917800178011780217803178041780517806178071780817809178101781117812178131781417815178161781717818178191782017821178221782317824178251782617827178281782917830178311783217833178341783517836178371783817839178401784117842178431784417845178461784717848178491785017851178521785317854178551785617857178581785917860178611786217863178641786517866178671786817869178701787117872178731787417875178761787717878178791788017881178821788317884178851788617887178881788917890178911789217893178941789517896178971789817899179001790117902179031790417905179061790717908179091791017911179121791317914179151791617917179181791917920179211792217923179241792517926179271792817929179301793117932179331793417935179361793717938179391794017941179421794317944179451794617947179481794917950179511795217953179541795517956179571795817959179601796117962179631796417965179661796717968179691797017971179721797317974179751797617977179781797917980179811798217983179841798517986179871798817989179901799117992179931799417995179961799717998179991800018001180021800318004180051800618007180081800918010180111801218013180141801518016180171801818019180201802118022180231802418025180261802718028180291803018031180321803318034180351803618037180381803918040180411804218043180441804518046180471804818049180501805118052180531805418055180561805718058180591806018061180621806318064180651806618067180681806918070180711807218073180741807518076180771807818079180801808118082180831808418085180861808718088180891809018091180921809318094180951809618097180981809918100181011810218103181041810518106181071810818109181101811118112181131811418115181161811718118181191812018121181221812318124181251812618127181281812918130181311813218133181341813518136181371813818139181401814118142181431814418145181461814718148181491815018151181521815318154181551815618157181581815918160181611816218163181641816518166181671816818169181701817118172181731817418175181761817718178181791818018181181821818318184181851818618187181881818918190181911819218193181941819518196181971819818199182001820118202182031820418205182061820718208182091821018211182121821318214182151821618217182181821918220182211822218223182241822518226182271822818229182301823118232182331823418235182361823718238182391824018241182421824318244182451824618247182481824918250182511825218253182541825518256182571825818259182601826118262182631826418265182661826718268182691827018271182721827318274182751827618277182781827918280182811828218283182841828518286182871828818289182901829118292182931829418295182961829718298182991830018301183021830318304183051830618307183081830918310183111831218313183141831518316183171831818319183201832118322183231832418325183261832718328183291833018331183321833318334183351833618337183381833918340183411834218343183441834518346183471834818349183501835118352183531835418355183561835718358183591836018361183621836318364183651836618367183681836918370183711837218373183741837518376183771837818379183801838118382183831838418385183861838718388183891839018391183921839318394183951839618397183981839918400184011840218403184041840518406184071840818409184101841118412184131841418415184161841718418184191842018421184221842318424184251842618427184281842918430184311843218433184341843518436184371843818439184401844118442184431844418445184461844718448184491845018451184521845318454184551845618457184581845918460184611846218463184641846518466184671846818469184701847118472184731847418475184761847718478184791848018481184821848318484184851848618487184881848918490184911849218493184941849518496184971849818499185001850118502185031850418505185061850718508185091851018511185121851318514185151851618517185181851918520185211852218523185241852518526185271852818529185301853118532185331853418535185361853718538185391854018541185421854318544185451854618547185481854918550185511855218553185541855518556185571855818559185601856118562185631856418565185661856718568185691857018571185721857318574185751857618577185781857918580185811858218583185841858518586185871858818589185901859118592185931859418595185961859718598185991860018601186021860318604186051860618607186081860918610186111861218613186141861518616186171861818619186201862118622186231862418625186261862718628186291863018631186321863318634186351863618637186381863918640186411864218643186441864518646186471864818649186501865118652186531865418655186561865718658186591866018661186621866318664186651866618667186681866918670186711867218673186741867518676186771867818679186801868118682186831868418685186861868718688186891869018691186921869318694186951869618697186981869918700187011870218703187041870518706187071870818709187101871118712187131871418715187161871718718187191872018721187221872318724187251872618727187281872918730187311873218733187341873518736187371873818739187401874118742187431874418745187461874718748187491875018751187521875318754187551875618757187581875918760187611876218763187641876518766187671876818769187701877118772187731877418775187761877718778187791878018781187821878318784187851878618787187881878918790187911879218793187941879518796187971879818799188001880118802188031880418805188061880718808188091881018811188121881318814188151881618817188181881918820188211882218823188241882518826188271882818829188301883118832188331883418835188361883718838188391884018841188421884318844188451884618847188481884918850188511885218853188541885518856188571885818859188601886118862188631886418865188661886718868188691887018871188721887318874188751887618877188781887918880188811888218883188841888518886188871888818889188901889118892188931889418895188961889718898188991890018901189021890318904189051890618907189081890918910189111891218913189141891518916189171891818919189201892118922189231892418925189261892718928189291893018931189321893318934189351893618937189381893918940189411894218943189441894518946189471894818949189501895118952189531895418955189561895718958189591896018961189621896318964189651896618967189681896918970189711897218973189741897518976189771897818979189801898118982189831898418985189861898718988189891899018991189921899318994189951899618997189981899919000190011900219003190041900519006190071900819009190101901119012190131901419015190161901719018190191902019021190221902319024190251902619027190281902919030190311903219033190341903519036190371903819039190401904119042190431904419045190461904719048190491905019051190521905319054190551905619057190581905919060190611906219063190641906519066190671906819069190701907119072190731907419075190761907719078190791908019081190821908319084190851908619087190881908919090190911909219093190941909519096190971909819099191001910119102191031910419105191061910719108191091911019111191121911319114191151911619117191181911919120191211912219123191241912519126191271912819129191301913119132191331913419135191361913719138191391914019141191421914319144191451914619147191481914919150191511915219153191541915519156191571915819159191601916119162191631916419165191661916719168191691917019171191721917319174191751917619177191781917919180191811918219183191841918519186191871918819189191901919119192191931919419195191961919719198191991920019201192021920319204192051920619207192081920919210192111921219213192141921519216192171921819219192201922119222192231922419225192261922719228192291923019231192321923319234192351923619237192381923919240192411924219243192441924519246192471924819249192501925119252192531925419255192561925719258192591926019261192621926319264192651926619267192681926919270192711927219273192741927519276192771927819279192801928119282192831928419285192861928719288192891929019291192921929319294192951929619297192981929919300193011930219303193041930519306193071930819309193101931119312193131931419315193161931719318193191932019321193221932319324193251932619327193281932919330193311933219333193341933519336193371933819339193401934119342193431934419345193461934719348193491935019351193521935319354193551935619357193581935919360193611936219363193641936519366193671936819369193701937119372193731937419375193761937719378193791938019381193821938319384193851938619387193881938919390193911939219393193941939519396193971939819399194001940119402194031940419405194061940719408194091941019411194121941319414194151941619417194181941919420194211942219423194241942519426194271942819429194301943119432194331943419435194361943719438194391944019441194421944319444194451944619447194481944919450194511945219453194541945519456194571945819459194601946119462194631946419465194661946719468194691947019471194721947319474194751947619477194781947919480194811948219483194841948519486194871948819489194901949119492194931949419495194961949719498194991950019501195021950319504195051950619507195081950919510195111951219513195141951519516195171951819519195201952119522195231952419525195261952719528195291953019531195321953319534195351953619537195381953919540195411954219543195441954519546195471954819549195501955119552195531955419555195561955719558195591956019561195621956319564195651956619567195681956919570195711957219573195741957519576195771957819579195801958119582195831958419585195861958719588195891959019591195921959319594195951959619597195981959919600196011960219603196041960519606196071960819609196101961119612196131961419615196161961719618196191962019621196221962319624196251962619627196281962919630196311963219633196341963519636196371963819639196401964119642196431964419645196461964719648196491965019651196521965319654196551965619657196581965919660196611966219663196641966519666196671966819669196701967119672196731967419675196761967719678196791968019681196821968319684196851968619687196881968919690196911969219693196941969519696196971969819699197001970119702197031970419705197061970719708197091971019711197121971319714197151971619717197181971919720197211972219723197241972519726197271972819729197301973119732197331973419735197361973719738197391974019741197421974319744197451974619747197481974919750197511975219753197541975519756197571975819759197601976119762197631976419765197661976719768197691977019771197721977319774197751977619777197781977919780197811978219783197841978519786197871978819789197901979119792197931979419795197961979719798197991980019801198021980319804198051980619807198081980919810198111981219813198141981519816198171981819819198201982119822198231982419825198261982719828198291983019831198321983319834198351983619837198381983919840198411984219843198441984519846198471984819849198501985119852198531985419855198561985719858198591986019861198621986319864198651986619867198681986919870198711987219873198741987519876198771987819879198801988119882198831988419885198861988719888198891989019891198921989319894198951989619897198981989919900199011990219903199041990519906199071990819909199101991119912199131991419915199161991719918199191992019921199221992319924199251992619927199281992919930199311993219933199341993519936199371993819939199401994119942199431994419945199461994719948199491995019951199521995319954199551995619957199581995919960199611996219963199641996519966199671996819969199701997119972199731997419975199761997719978199791998019981199821998319984199851998619987199881998919990199911999219993199941999519996199971999819999200002000120002200032000420005200062000720008200092001020011200122001320014200152001620017200182001920020200212002220023200242002520026200272002820029200302003120032200332003420035200362003720038200392004020041200422004320044200452004620047200482004920050200512005220053200542005520056200572005820059200602006120062200632006420065200662006720068200692007020071200722007320074200752007620077200782007920080200812008220083200842008520086200872008820089200902009120092200932009420095200962009720098200992010020101201022010320104201052010620107201082010920110201112011220113201142011520116201172011820119201202012120122201232012420125201262012720128201292013020131201322013320134201352013620137201382013920140201412014220143201442014520146201472014820149201502015120152201532015420155201562015720158201592016020161201622016320164201652016620167201682016920170201712017220173201742017520176201772017820179201802018120182201832018420185201862018720188201892019020191201922019320194201952019620197201982019920200202012020220203202042020520206202072020820209202102021120212202132021420215202162021720218202192022020221202222022320224202252022620227202282022920230202312023220233202342023520236202372023820239202402024120242202432024420245202462024720248202492025020251202522025320254202552025620257202582025920260202612026220263202642026520266202672026820269202702027120272202732027420275202762027720278202792028020281202822028320284202852028620287202882028920290202912029220293202942029520296202972029820299203002030120302203032030420305203062030720308203092031020311203122031320314203152031620317203182031920320203212032220323203242032520326203272032820329203302033120332203332033420335203362033720338203392034020341203422034320344203452034620347203482034920350203512035220353203542035520356203572035820359203602036120362203632036420365203662036720368203692037020371203722037320374203752037620377203782037920380203812038220383203842038520386203872038820389203902039120392203932039420395203962039720398203992040020401204022040320404204052040620407204082040920410204112041220413204142041520416204172041820419204202042120422204232042420425204262042720428204292043020431204322043320434204352043620437204382043920440204412044220443204442044520446204472044820449204502045120452204532045420455204562045720458204592046020461204622046320464204652046620467204682046920470204712047220473204742047520476204772047820479204802048120482204832048420485204862048720488204892049020491204922049320494204952049620497204982049920500205012050220503205042050520506205072050820509205102051120512205132051420515205162051720518205192052020521205222052320524205252052620527205282052920530205312053220533205342053520536205372053820539205402054120542205432054420545205462054720548205492055020551205522055320554205552055620557205582055920560205612056220563205642056520566205672056820569205702057120572205732057420575205762057720578205792058020581205822058320584205852058620587205882058920590205912059220593205942059520596205972059820599206002060120602206032060420605206062060720608206092061020611206122061320614206152061620617206182061920620206212062220623206242062520626206272062820629206302063120632206332063420635206362063720638206392064020641206422064320644206452064620647206482064920650206512065220653206542065520656206572065820659206602066120662206632066420665206662066720668206692067020671206722067320674206752067620677206782067920680206812068220683206842068520686206872068820689206902069120692206932069420695206962069720698206992070020701207022070320704207052070620707207082070920710207112071220713207142071520716207172071820719207202072120722207232072420725207262072720728207292073020731207322073320734207352073620737207382073920740207412074220743207442074520746207472074820749207502075120752207532075420755207562075720758207592076020761207622076320764207652076620767207682076920770207712077220773207742077520776207772077820779207802078120782207832078420785207862078720788207892079020791207922079320794207952079620797207982079920800208012080220803208042080520806208072080820809208102081120812208132081420815208162081720818208192082020821208222082320824208252082620827208282082920830208312083220833208342083520836208372083820839208402084120842208432084420845208462084720848208492085020851208522085320854208552085620857208582085920860208612086220863208642086520866208672086820869208702087120872208732087420875208762087720878208792088020881208822088320884208852088620887208882088920890208912089220893208942089520896208972089820899209002090120902209032090420905209062090720908209092091020911209122091320914209152091620917209182091920920209212092220923209242092520926209272092820929209302093120932209332093420935209362093720938209392094020941209422094320944209452094620947209482094920950209512095220953209542095520956209572095820959209602096120962209632096420965209662096720968209692097020971209722097320974209752097620977209782097920980209812098220983209842098520986209872098820989209902099120992209932099420995209962099720998209992100021001210022100321004210052100621007210082100921010210112101221013210142101521016210172101821019210202102121022210232102421025210262102721028210292103021031210322103321034210352103621037210382103921040210412104221043210442104521046210472104821049210502105121052210532105421055210562105721058210592106021061210622106321064210652106621067210682106921070210712107221073210742107521076210772107821079210802108121082210832108421085210862108721088210892109021091210922109321094210952109621097210982109921100211012110221103211042110521106211072110821109211102111121112211132111421115211162111721118211192112021121211222112321124211252112621127211282112921130211312113221133211342113521136211372113821139211402114121142211432114421145211462114721148211492115021151211522115321154211552115621157211582115921160211612116221163211642116521166211672116821169211702117121172211732117421175211762117721178211792118021181211822118321184211852118621187211882118921190211912119221193211942119521196211972119821199212002120121202212032120421205212062120721208212092121021211212122121321214212152121621217212182121921220212212122221223212242122521226212272122821229212302123121232212332123421235212362123721238212392124021241212422124321244212452124621247212482124921250212512125221253212542125521256212572125821259212602126121262212632126421265212662126721268212692127021271212722127321274212752127621277212782127921280212812128221283212842128521286212872128821289212902129121292212932129421295212962129721298212992130021301213022130321304213052130621307213082130921310213112131221313213142131521316213172131821319213202132121322213232132421325213262132721328213292133021331213322133321334213352133621337213382133921340213412134221343213442134521346213472134821349213502135121352213532135421355213562135721358213592136021361213622136321364213652136621367213682136921370213712137221373213742137521376213772137821379213802138121382213832138421385213862138721388213892139021391213922139321394213952139621397213982139921400214012140221403214042140521406214072140821409214102141121412214132141421415214162141721418214192142021421214222142321424214252142621427214282142921430214312143221433214342143521436214372143821439214402144121442214432144421445214462144721448214492145021451214522145321454214552145621457214582145921460214612146221463214642146521466214672146821469214702147121472214732147421475214762147721478214792148021481214822148321484214852148621487214882148921490214912149221493214942149521496214972149821499215002150121502215032150421505215062150721508215092151021511215122151321514215152151621517215182151921520215212152221523215242152521526215272152821529215302153121532215332153421535215362153721538215392154021541215422154321544215452154621547215482154921550215512155221553215542155521556215572155821559215602156121562215632156421565215662156721568215692157021571215722157321574215752157621577215782157921580215812158221583215842158521586215872158821589215902159121592215932159421595215962159721598215992160021601216022160321604216052160621607216082160921610216112161221613216142161521616216172161821619216202162121622216232162421625216262162721628216292163021631216322163321634216352163621637216382163921640216412164221643216442164521646216472164821649216502165121652216532165421655216562165721658216592166021661216622166321664216652166621667216682166921670216712167221673216742167521676216772167821679216802168121682216832168421685216862168721688216892169021691216922169321694216952169621697216982169921700217012170221703217042170521706217072170821709217102171121712217132171421715217162171721718217192172021721217222172321724217252172621727217282172921730217312173221733217342173521736217372173821739217402174121742217432174421745217462174721748217492175021751217522175321754217552175621757217582175921760217612176221763217642176521766217672176821769217702177121772217732177421775217762177721778217792178021781217822178321784217852178621787217882178921790217912179221793217942179521796217972179821799218002180121802218032180421805218062180721808218092181021811218122181321814218152181621817218182181921820218212182221823218242182521826218272182821829218302183121832218332183421835218362183721838218392184021841218422184321844218452184621847218482184921850218512185221853218542185521856218572185821859218602186121862218632186421865218662186721868218692187021871218722187321874218752187621877218782187921880218812188221883218842188521886218872188821889218902189121892218932189421895218962189721898218992190021901219022190321904219052190621907219082190921910219112191221913219142191521916219172191821919219202192121922219232192421925219262192721928219292193021931219322193321934219352193621937219382193921940219412194221943219442194521946219472194821949219502195121952219532195421955219562195721958219592196021961219622196321964219652196621967219682196921970219712197221973219742197521976219772197821979219802198121982219832198421985219862198721988219892199021991219922199321994219952199621997219982199922000220012200222003220042200522006220072200822009220102201122012220132201422015220162201722018220192202022021220222202322024220252202622027220282202922030220312203222033220342203522036220372203822039220402204122042220432204422045220462204722048220492205022051220522205322054220552205622057220582205922060220612206222063220642206522066220672206822069220702207122072220732207422075220762207722078220792208022081220822208322084220852208622087220882208922090220912209222093220942209522096220972209822099221002210122102221032210422105221062210722108221092211022111221122211322114221152211622117221182211922120221212212222123221242212522126221272212822129221302213122132221332213422135221362213722138221392214022141221422214322144221452214622147221482214922150221512215222153221542215522156221572215822159221602216122162221632216422165221662216722168221692217022171221722217322174221752217622177221782217922180221812218222183221842218522186221872218822189221902219122192221932219422195221962219722198221992220022201222022220322204222052220622207222082220922210222112221222213222142221522216222172221822219222202222122222222232222422225222262222722228222292223022231222322223322234222352223622237222382223922240222412224222243222442224522246222472224822249222502225122252222532225422255222562225722258222592226022261222622226322264222652226622267222682226922270222712227222273222742227522276222772227822279222802228122282222832228422285222862228722288222892229022291222922229322294222952229622297222982229922300223012230222303223042230522306223072230822309223102231122312223132231422315223162231722318223192232022321223222232322324223252232622327223282232922330223312233222333223342233522336223372233822339223402234122342223432234422345223462234722348223492235022351223522235322354223552235622357223582235922360223612236222363223642236522366223672236822369223702237122372223732237422375223762237722378223792238022381223822238322384223852238622387223882238922390223912239222393223942239522396223972239822399224002240122402224032240422405224062240722408224092241022411224122241322414224152241622417224182241922420224212242222423224242242522426224272242822429224302243122432224332243422435224362243722438224392244022441224422244322444224452244622447224482244922450224512245222453224542245522456224572245822459224602246122462224632246422465224662246722468224692247022471224722247322474224752247622477224782247922480224812248222483224842248522486224872248822489224902249122492224932249422495224962249722498224992250022501225022250322504225052250622507225082250922510225112251222513225142251522516225172251822519225202252122522225232252422525225262252722528225292253022531225322253322534225352253622537225382253922540225412254222543225442254522546225472254822549225502255122552225532255422555225562255722558225592256022561225622256322564225652256622567225682256922570225712257222573225742257522576225772257822579225802258122582225832258422585225862258722588225892259022591225922259322594225952259622597225982259922600226012260222603226042260522606226072260822609226102261122612226132261422615226162261722618226192262022621226222262322624226252262622627226282262922630226312263222633226342263522636226372263822639226402264122642226432264422645226462264722648226492265022651226522265322654226552265622657226582265922660226612266222663226642266522666226672266822669226702267122672226732267422675226762267722678226792268022681226822268322684226852268622687226882268922690226912269222693226942269522696226972269822699227002270122702227032270422705227062270722708227092271022711227122271322714227152271622717227182271922720227212272222723227242272522726227272272822729227302273122732227332273422735227362273722738227392274022741227422274322744227452274622747227482274922750227512275222753227542275522756227572275822759227602276122762227632276422765227662276722768227692277022771227722277322774227752277622777227782277922780227812278222783227842278522786227872278822789227902279122792227932279422795227962279722798227992280022801228022280322804228052280622807228082280922810228112281222813228142281522816228172281822819228202282122822228232282422825228262282722828228292283022831228322283322834228352283622837228382283922840228412284222843228442284522846228472284822849228502285122852228532285422855228562285722858228592286022861228622286322864228652286622867228682286922870228712287222873228742287522876228772287822879228802288122882228832288422885228862288722888228892289022891228922289322894228952289622897228982289922900229012290222903229042290522906229072290822909229102291122912229132291422915229162291722918229192292022921229222292322924229252292622927229282292922930229312293222933229342293522936229372293822939229402294122942229432294422945229462294722948229492295022951229522295322954229552295622957229582295922960229612296222963229642296522966229672296822969229702297122972229732297422975229762297722978229792298022981229822298322984229852298622987229882298922990229912299222993229942299522996229972299822999230002300123002230032300423005230062300723008230092301023011230122301323014230152301623017230182301923020230212302223023230242302523026230272302823029230302303123032230332303423035230362303723038230392304023041230422304323044230452304623047230482304923050230512305223053230542305523056230572305823059230602306123062230632306423065230662306723068230692307023071230722307323074230752307623077230782307923080230812308223083230842308523086230872308823089230902309123092230932309423095230962309723098230992310023101231022310323104231052310623107231082310923110231112311223113231142311523116231172311823119231202312123122231232312423125231262312723128231292313023131231322313323134231352313623137231382313923140231412314223143231442314523146231472314823149231502315123152231532315423155231562315723158231592316023161231622316323164231652316623167231682316923170231712317223173231742317523176231772317823179231802318123182231832318423185231862318723188231892319023191231922319323194231952319623197231982319923200232012320223203232042320523206232072320823209232102321123212232132321423215232162321723218232192322023221232222322323224232252322623227232282322923230232312323223233232342323523236232372323823239232402324123242232432324423245232462324723248232492325023251232522325323254232552325623257232582325923260232612326223263232642326523266232672326823269232702327123272232732327423275232762327723278232792328023281232822328323284232852328623287232882328923290232912329223293232942329523296232972329823299233002330123302233032330423305233062330723308233092331023311233122331323314233152331623317233182331923320233212332223323233242332523326233272332823329233302333123332233332333423335233362333723338233392334023341233422334323344233452334623347233482334923350233512335223353233542335523356233572335823359233602336123362233632336423365233662336723368233692337023371233722337323374233752337623377233782337923380233812338223383233842338523386233872338823389233902339123392233932339423395233962339723398233992340023401234022340323404234052340623407234082340923410234112341223413234142341523416234172341823419234202342123422234232342423425234262342723428234292343023431234322343323434234352343623437234382343923440234412344223443234442344523446234472344823449234502345123452234532345423455234562345723458234592346023461234622346323464234652346623467234682346923470234712347223473234742347523476234772347823479234802348123482234832348423485234862348723488234892349023491234922349323494234952349623497234982349923500235012350223503235042350523506235072350823509235102351123512235132351423515235162351723518235192352023521235222352323524235252352623527235282352923530235312353223533235342353523536235372353823539235402354123542235432354423545235462354723548235492355023551235522355323554235552355623557235582355923560235612356223563235642356523566235672356823569235702357123572235732357423575235762357723578235792358023581235822358323584235852358623587235882358923590235912359223593235942359523596235972359823599236002360123602236032360423605236062360723608236092361023611236122361323614236152361623617236182361923620236212362223623236242362523626236272362823629236302363123632236332363423635236362363723638236392364023641236422364323644236452364623647236482364923650236512365223653236542365523656236572365823659236602366123662236632366423665236662366723668236692367023671236722367323674236752367623677236782367923680236812368223683236842368523686236872368823689236902369123692236932369423695236962369723698236992370023701237022370323704237052370623707237082370923710237112371223713237142371523716237172371823719237202372123722237232372423725237262372723728237292373023731237322373323734237352373623737237382373923740237412374223743237442374523746237472374823749237502375123752237532375423755237562375723758237592376023761237622376323764237652376623767237682376923770237712377223773237742377523776237772377823779237802378123782237832378423785237862378723788237892379023791237922379323794237952379623797237982379923800238012380223803238042380523806238072380823809238102381123812238132381423815238162381723818238192382023821238222382323824238252382623827238282382923830238312383223833238342383523836238372383823839238402384123842238432384423845238462384723848238492385023851238522385323854238552385623857238582385923860238612386223863238642386523866238672386823869238702387123872238732387423875238762387723878238792388023881238822388323884238852388623887238882388923890238912389223893238942389523896238972389823899239002390123902239032390423905239062390723908239092391023911239122391323914239152391623917239182391923920239212392223923239242392523926239272392823929239302393123932239332393423935239362393723938239392394023941239422394323944239452394623947239482394923950239512395223953239542395523956239572395823959239602396123962239632396423965239662396723968239692397023971239722397323974239752397623977239782397923980239812398223983239842398523986239872398823989239902399123992239932399423995239962399723998239992400024001240022400324004240052400624007240082400924010240112401224013240142401524016240172401824019240202402124022240232402424025240262402724028240292403024031240322403324034240352403624037240382403924040240412404224043240442404524046240472404824049240502405124052240532405424055240562405724058240592406024061240622406324064240652406624067240682406924070240712407224073240742407524076240772407824079240802408124082240832408424085240862408724088240892409024091240922409324094240952409624097240982409924100241012410224103241042410524106241072410824109241102411124112241132411424115241162411724118241192412024121241222412324124241252412624127241282412924130241312413224133241342413524136241372413824139241402414124142241432414424145241462414724148241492415024151241522415324154241552415624157241582415924160241612416224163241642416524166241672416824169241702417124172241732417424175241762417724178241792418024181241822418324184241852418624187241882418924190241912419224193241942419524196241972419824199242002420124202242032420424205242062420724208242092421024211242122421324214242152421624217242182421924220242212422224223242242422524226242272422824229242302423124232242332423424235242362423724238242392424024241242422424324244242452424624247242482424924250242512425224253242542425524256242572425824259242602426124262242632426424265242662426724268242692427024271242722427324274242752427624277242782427924280242812428224283242842428524286242872428824289242902429124292242932429424295242962429724298242992430024301243022430324304243052430624307243082430924310243112431224313243142431524316243172431824319243202432124322243232432424325243262432724328243292433024331243322433324334243352433624337243382433924340243412434224343243442434524346243472434824349243502435124352243532435424355243562435724358243592436024361243622436324364243652436624367243682436924370243712437224373243742437524376243772437824379243802438124382243832438424385243862438724388243892439024391243922439324394243952439624397243982439924400244012440224403244042440524406244072440824409244102441124412244132441424415244162441724418244192442024421244222442324424244252442624427244282442924430244312443224433244342443524436244372443824439244402444124442244432444424445244462444724448244492445024451244522445324454244552445624457244582445924460244612446224463244642446524466244672446824469244702447124472244732447424475244762447724478244792448024481244822448324484244852448624487244882448924490244912449224493244942449524496244972449824499245002450124502245032450424505245062450724508245092451024511245122451324514245152451624517245182451924520245212452224523245242452524526245272452824529245302453124532245332453424535245362453724538245392454024541245422454324544245452454624547245482454924550245512455224553245542455524556245572455824559245602456124562245632456424565245662456724568245692457024571245722457324574245752457624577245782457924580245812458224583245842458524586245872458824589245902459124592245932459424595245962459724598245992460024601246022460324604246052460624607246082460924610246112461224613246142461524616246172461824619246202462124622246232462424625246262462724628246292463024631246322463324634246352463624637246382463924640246412464224643246442464524646246472464824649246502465124652246532465424655246562465724658246592466024661246622466324664246652466624667246682466924670246712467224673246742467524676246772467824679246802468124682246832468424685246862468724688246892469024691246922469324694246952469624697246982469924700247012470224703247042470524706247072470824709247102471124712247132471424715247162471724718247192472024721247222472324724247252472624727247282472924730247312473224733247342473524736247372473824739247402474124742247432474424745247462474724748247492475024751247522475324754247552475624757247582475924760247612476224763247642476524766247672476824769247702477124772247732477424775247762477724778247792478024781247822478324784247852478624787247882478924790247912479224793247942479524796247972479824799248002480124802248032480424805248062480724808248092481024811248122481324814248152481624817248182481924820248212482224823248242482524826248272482824829248302483124832248332483424835248362483724838248392484024841248422484324844248452484624847248482484924850248512485224853248542485524856248572485824859248602486124862248632486424865248662486724868248692487024871248722487324874248752487624877248782487924880248812488224883248842488524886248872488824889248902489124892248932489424895248962489724898248992490024901249022490324904249052490624907249082490924910249112491224913249142491524916249172491824919249202492124922249232492424925249262492724928249292493024931249322493324934249352493624937249382493924940249412494224943249442494524946249472494824949249502495124952249532495424955249562495724958249592496024961249622496324964249652496624967249682496924970249712497224973249742497524976249772497824979249802498124982249832498424985249862498724988249892499024991249922499324994249952499624997249982499925000250012500225003250042500525006250072500825009250102501125012250132501425015250162501725018250192502025021250222502325024250252502625027250282502925030250312503225033250342503525036250372503825039250402504125042250432504425045250462504725048250492505025051250522505325054250552505625057250582505925060250612506225063250642506525066250672506825069250702507125072250732507425075250762507725078250792508025081250822508325084250852508625087250882508925090250912509225093250942509525096250972509825099251002510125102251032510425105251062510725108251092511025111251122511325114251152511625117251182511925120251212512225123251242512525126251272512825129251302513125132251332513425135251362513725138251392514025141251422514325144251452514625147251482514925150251512515225153251542515525156251572515825159251602516125162251632516425165251662516725168251692517025171251722517325174251752517625177251782517925180251812518225183251842518525186251872518825189251902519125192251932519425195251962519725198251992520025201252022520325204252052520625207252082520925210252112521225213252142521525216252172521825219252202522125222252232522425225252262522725228252292523025231252322523325234252352523625237252382523925240252412524225243252442524525246252472524825249252502525125252252532525425255252562525725258252592526025261252622526325264252652526625267252682526925270252712527225273252742527525276252772527825279252802528125282252832528425285252862528725288252892529025291252922529325294252952529625297252982529925300253012530225303253042530525306253072530825309253102531125312253132531425315253162531725318253192532025321253222532325324253252532625327253282532925330253312533225333253342533525336253372533825339253402534125342253432534425345253462534725348253492535025351253522535325354253552535625357253582535925360253612536225363253642536525366253672536825369253702537125372253732537425375253762537725378253792538025381253822538325384253852538625387253882538925390253912539225393253942539525396253972539825399254002540125402254032540425405254062540725408254092541025411254122541325414254152541625417254182541925420254212542225423254242542525426254272542825429254302543125432254332543425435254362543725438254392544025441254422544325444254452544625447254482544925450254512545225453254542545525456254572545825459254602546125462254632546425465254662546725468254692547025471254722547325474254752547625477254782547925480254812548225483254842548525486254872548825489254902549125492254932549425495254962549725498254992550025501255022550325504255052550625507255082550925510255112551225513255142551525516255172551825519255202552125522255232552425525255262552725528255292553025531255322553325534255352553625537255382553925540255412554225543255442554525546255472554825549255502555125552255532555425555255562555725558255592556025561255622556325564255652556625567255682556925570255712557225573255742557525576255772557825579255802558125582255832558425585255862558725588255892559025591255922559325594255952559625597255982559925600256012560225603256042560525606256072560825609256102561125612256132561425615256162561725618256192562025621256222562325624256252562625627256282562925630256312563225633256342563525636256372563825639256402564125642256432564425645256462564725648256492565025651256522565325654256552565625657256582565925660256612566225663256642566525666256672566825669256702567125672256732567425675256762567725678256792568025681256822568325684256852568625687256882568925690256912569225693256942569525696256972569825699257002570125702257032570425705257062570725708257092571025711257122571325714257152571625717257182571925720257212572225723257242572525726257272572825729257302573125732257332573425735257362573725738257392574025741257422574325744257452574625747257482574925750257512575225753257542575525756257572575825759257602576125762257632576425765257662576725768257692577025771257722577325774257752577625777257782577925780257812578225783257842578525786257872578825789257902579125792257932579425795257962579725798257992580025801258022580325804258052580625807258082580925810258112581225813258142581525816258172581825819258202582125822258232582425825258262582725828258292583025831258322583325834258352583625837258382583925840258412584225843258442584525846258472584825849258502585125852258532585425855258562585725858258592586025861258622586325864258652586625867258682586925870258712587225873258742587525876258772587825879258802588125882258832588425885258862588725888258892589025891258922589325894258952589625897258982589925900259012590225903259042590525906259072590825909259102591125912259132591425915259162591725918259192592025921259222592325924259252592625927259282592925930259312593225933259342593525936259372593825939259402594125942259432594425945259462594725948259492595025951259522595325954259552595625957259582595925960259612596225963259642596525966259672596825969259702597125972259732597425975259762597725978259792598025981259822598325984259852598625987259882598925990259912599225993259942599525996259972599825999260002600126002260032600426005260062600726008260092601026011260122601326014260152601626017260182601926020260212602226023260242602526026260272602826029260302603126032260332603426035260362603726038260392604026041260422604326044260452604626047260482604926050260512605226053260542605526056260572605826059260602606126062260632606426065260662606726068260692607026071260722607326074260752607626077260782607926080260812608226083260842608526086260872608826089260902609126092260932609426095260962609726098260992610026101261022610326104261052610626107261082610926110261112611226113261142611526116261172611826119261202612126122261232612426125261262612726128261292613026131261322613326134261352613626137261382613926140261412614226143261442614526146261472614826149261502615126152261532615426155261562615726158261592616026161261622616326164261652616626167261682616926170261712617226173261742617526176261772617826179261802618126182261832618426185261862618726188261892619026191261922619326194261952619626197261982619926200262012620226203262042620526206262072620826209262102621126212262132621426215262162621726218262192622026221262222622326224262252622626227262282622926230262312623226233262342623526236262372623826239262402624126242262432624426245262462624726248262492625026251262522625326254262552625626257262582625926260262612626226263262642626526266262672626826269262702627126272262732627426275262762627726278262792628026281262822628326284262852628626287262882628926290262912629226293262942629526296262972629826299263002630126302263032630426305263062630726308263092631026311263122631326314263152631626317263182631926320263212632226323263242632526326263272632826329263302633126332263332633426335263362633726338263392634026341263422634326344263452634626347263482634926350263512635226353263542635526356263572635826359263602636126362263632636426365263662636726368263692637026371263722637326374263752637626377263782637926380263812638226383263842638526386263872638826389263902639126392263932639426395263962639726398263992640026401264022640326404264052640626407264082640926410264112641226413264142641526416264172641826419264202642126422264232642426425264262642726428264292643026431264322643326434264352643626437264382643926440264412644226443264442644526446264472644826449264502645126452264532645426455264562645726458264592646026461264622646326464264652646626467264682646926470264712647226473264742647526476264772647826479264802648126482264832648426485264862648726488264892649026491264922649326494264952649626497264982649926500265012650226503265042650526506265072650826509265102651126512265132651426515265162651726518265192652026521265222652326524265252652626527265282652926530265312653226533265342653526536265372653826539265402654126542265432654426545265462654726548265492655026551265522655326554265552655626557265582655926560265612656226563265642656526566265672656826569265702657126572265732657426575265762657726578265792658026581265822658326584265852658626587265882658926590265912659226593265942659526596265972659826599266002660126602266032660426605266062660726608266092661026611266122661326614266152661626617266182661926620266212662226623266242662526626266272662826629266302663126632266332663426635266362663726638266392664026641266422664326644266452664626647266482664926650266512665226653266542665526656266572665826659266602666126662266632666426665266662666726668266692667026671266722667326674266752667626677266782667926680266812668226683266842668526686266872668826689266902669126692266932669426695266962669726698266992670026701267022670326704267052670626707267082670926710267112671226713267142671526716267172671826719267202672126722267232672426725267262672726728267292673026731267322673326734267352673626737267382673926740267412674226743267442674526746267472674826749267502675126752267532675426755267562675726758267592676026761267622676326764267652676626767267682676926770267712677226773267742677526776267772677826779267802678126782267832678426785267862678726788267892679026791267922679326794267952679626797267982679926800268012680226803268042680526806268072680826809268102681126812268132681426815268162681726818268192682026821268222682326824268252682626827268282682926830268312683226833268342683526836268372683826839268402684126842268432684426845268462684726848268492685026851268522685326854268552685626857268582685926860268612686226863268642686526866268672686826869268702687126872268732687426875268762687726878268792688026881268822688326884268852688626887268882688926890268912689226893268942689526896268972689826899269002690126902269032690426905269062690726908269092691026911269122691326914269152691626917269182691926920269212692226923269242692526926269272692826929269302693126932269332693426935269362693726938269392694026941269422694326944269452694626947269482694926950269512695226953269542695526956269572695826959269602696126962269632696426965269662696726968269692697026971269722697326974269752697626977269782697926980269812698226983269842698526986269872698826989269902699126992269932699426995269962699726998269992700027001270022700327004270052700627007270082700927010270112701227013270142701527016270172701827019270202702127022270232702427025270262702727028270292703027031270322703327034270352703627037270382703927040270412704227043270442704527046270472704827049270502705127052270532705427055270562705727058270592706027061270622706327064270652706627067270682706927070270712707227073270742707527076270772707827079270802708127082270832708427085270862708727088270892709027091270922709327094270952709627097270982709927100271012710227103271042710527106271072710827109271102711127112271132711427115271162711727118271192712027121271222712327124271252712627127271282712927130271312713227133271342713527136271372713827139271402714127142271432714427145271462714727148271492715027151271522715327154271552715627157271582715927160271612716227163271642716527166271672716827169271702717127172271732717427175271762717727178271792718027181271822718327184271852718627187271882718927190271912719227193271942719527196271972719827199272002720127202272032720427205272062720727208272092721027211272122721327214272152721627217272182721927220272212722227223272242722527226272272722827229272302723127232272332723427235272362723727238272392724027241272422724327244272452724627247272482724927250272512725227253272542725527256272572725827259272602726127262272632726427265272662726727268272692727027271272722727327274272752727627277272782727927280272812728227283272842728527286272872728827289272902729127292272932729427295272962729727298272992730027301273022730327304273052730627307273082730927310273112731227313273142731527316273172731827319273202732127322273232732427325273262732727328273292733027331273322733327334273352733627337273382733927340273412734227343273442734527346273472734827349273502735127352273532735427355273562735727358273592736027361273622736327364273652736627367273682736927370273712737227373273742737527376273772737827379273802738127382273832738427385273862738727388273892739027391273922739327394273952739627397273982739927400274012740227403274042740527406274072740827409274102741127412274132741427415274162741727418274192742027421274222742327424274252742627427274282742927430274312743227433274342743527436274372743827439274402744127442274432744427445274462744727448274492745027451274522745327454274552745627457274582745927460274612746227463274642746527466274672746827469274702747127472274732747427475274762747727478274792748027481274822748327484274852748627487274882748927490274912749227493274942749527496274972749827499275002750127502275032750427505275062750727508275092751027511275122751327514275152751627517275182751927520275212752227523275242752527526275272752827529275302753127532275332753427535275362753727538275392754027541275422754327544275452754627547275482754927550275512755227553275542755527556275572755827559275602756127562275632756427565275662756727568275692757027571275722757327574275752757627577275782757927580275812758227583275842758527586275872758827589275902759127592275932759427595275962759727598275992760027601276022760327604276052760627607276082760927610276112761227613276142761527616276172761827619276202762127622276232762427625276262762727628276292763027631276322763327634276352763627637276382763927640276412764227643276442764527646276472764827649276502765127652276532765427655276562765727658276592766027661276622766327664276652766627667276682766927670276712767227673276742767527676276772767827679276802768127682276832768427685276862768727688276892769027691276922769327694276952769627697276982769927700277012770227703277042770527706277072770827709277102771127712277132771427715277162771727718277192772027721277222772327724277252772627727277282772927730277312773227733277342773527736277372773827739277402774127742277432774427745277462774727748277492775027751277522775327754277552775627757277582775927760277612776227763277642776527766277672776827769277702777127772277732777427775277762777727778277792778027781277822778327784277852778627787277882778927790277912779227793277942779527796277972779827799278002780127802278032780427805278062780727808278092781027811278122781327814278152781627817278182781927820278212782227823278242782527826278272782827829278302783127832278332783427835278362783727838278392784027841278422784327844278452784627847278482784927850278512785227853278542785527856278572785827859278602786127862278632786427865278662786727868278692787027871278722787327874278752787627877278782787927880278812788227883278842788527886278872788827889278902789127892278932789427895278962789727898278992790027901279022790327904279052790627907279082790927910279112791227913279142791527916279172791827919279202792127922279232792427925279262792727928279292793027931279322793327934279352793627937279382793927940279412794227943279442794527946279472794827949279502795127952279532795427955279562795727958279592796027961279622796327964279652796627967279682796927970279712797227973279742797527976279772797827979279802798127982279832798427985279862798727988279892799027991279922799327994279952799627997279982799928000280012800228003280042800528006280072800828009280102801128012280132801428015280162801728018280192802028021280222802328024280252802628027280282802928030280312803228033280342803528036280372803828039280402804128042280432804428045280462804728048280492805028051280522805328054280552805628057280582805928060280612806228063280642806528066280672806828069280702807128072280732807428075280762807728078280792808028081280822808328084280852808628087280882808928090280912809228093280942809528096280972809828099281002810128102281032810428105281062810728108281092811028111281122811328114281152811628117281182811928120281212812228123281242812528126281272812828129281302813128132281332813428135281362813728138281392814028141281422814328144281452814628147281482814928150281512815228153281542815528156281572815828159281602816128162281632816428165281662816728168281692817028171281722817328174281752817628177281782817928180281812818228183281842818528186281872818828189281902819128192281932819428195281962819728198281992820028201282022820328204282052820628207282082820928210282112821228213282142821528216282172821828219282202822128222282232822428225282262822728228282292823028231282322823328234282352823628237282382823928240282412824228243282442824528246282472824828249282502825128252282532825428255282562825728258282592826028261282622826328264282652826628267282682826928270282712827228273282742827528276282772827828279282802828128282282832828428285282862828728288282892829028291282922829328294282952829628297282982829928300283012830228303283042830528306283072830828309283102831128312283132831428315283162831728318283192832028321283222832328324283252832628327283282832928330283312833228333283342833528336283372833828339283402834128342283432834428345283462834728348283492835028351283522835328354283552835628357283582835928360283612836228363283642836528366283672836828369283702837128372283732837428375283762837728378283792838028381283822838328384283852838628387283882838928390283912839228393283942839528396283972839828399284002840128402284032840428405284062840728408284092841028411284122841328414284152841628417284182841928420284212842228423284242842528426284272842828429284302843128432284332843428435284362843728438284392844028441284422844328444284452844628447284482844928450284512845228453284542845528456284572845828459284602846128462284632846428465284662846728468284692847028471284722847328474284752847628477284782847928480284812848228483284842848528486284872848828489284902849128492284932849428495284962849728498284992850028501285022850328504285052850628507285082850928510285112851228513285142851528516285172851828519285202852128522285232852428525285262852728528285292853028531285322853328534285352853628537285382853928540285412854228543285442854528546285472854828549285502855128552285532855428555285562855728558285592856028561285622856328564285652856628567285682856928570285712857228573285742857528576285772857828579285802858128582285832858428585285862858728588285892859028591285922859328594285952859628597285982859928600286012860228603286042860528606286072860828609286102861128612286132861428615286162861728618286192862028621286222862328624286252862628627286282862928630286312863228633286342863528636286372863828639286402864128642286432864428645286462864728648286492865028651286522865328654286552865628657286582865928660286612866228663286642866528666286672866828669286702867128672286732867428675286762867728678286792868028681286822868328684286852868628687286882868928690286912869228693286942869528696286972869828699287002870128702287032870428705287062870728708287092871028711287122871328714287152871628717287182871928720287212872228723287242872528726287272872828729287302873128732287332873428735287362873728738287392874028741287422874328744287452874628747287482874928750287512875228753287542875528756287572875828759287602876128762287632876428765287662876728768287692877028771287722877328774287752877628777287782877928780287812878228783287842878528786287872878828789287902879128792287932879428795287962879728798287992880028801288022880328804288052880628807288082880928810288112881228813288142881528816288172881828819288202882128822288232882428825288262882728828288292883028831288322883328834288352883628837288382883928840288412884228843288442884528846288472884828849288502885128852288532885428855288562885728858288592886028861288622886328864288652886628867288682886928870288712887228873288742887528876288772887828879288802888128882288832888428885288862888728888288892889028891288922889328894288952889628897288982889928900289012890228903289042890528906289072890828909289102891128912289132891428915289162891728918289192892028921289222892328924289252892628927289282892928930289312893228933289342893528936289372893828939289402894128942289432894428945289462894728948289492895028951289522895328954289552895628957289582895928960289612896228963289642896528966289672896828969289702897128972289732897428975289762897728978289792898028981289822898328984289852898628987289882898928990289912899228993289942899528996289972899828999290002900129002290032900429005290062900729008290092901029011290122901329014290152901629017290182901929020290212902229023290242902529026290272902829029290302903129032290332903429035290362903729038290392904029041290422904329044290452904629047290482904929050290512905229053290542905529056290572905829059290602906129062290632906429065290662906729068290692907029071290722907329074290752907629077290782907929080290812908229083290842908529086290872908829089290902909129092290932909429095290962909729098290992910029101291022910329104291052910629107291082910929110291112911229113291142911529116291172911829119291202912129122291232912429125291262912729128291292913029131291322913329134291352913629137291382913929140291412914229143291442914529146291472914829149291502915129152291532915429155291562915729158291592916029161291622916329164291652916629167291682916929170291712917229173291742917529176291772917829179291802918129182291832918429185291862918729188291892919029191291922919329194291952919629197291982919929200292012920229203292042920529206292072920829209292102921129212292132921429215292162921729218292192922029221292222922329224292252922629227292282922929230292312923229233292342923529236292372923829239292402924129242292432924429245292462924729248292492925029251292522925329254292552925629257292582925929260292612926229263292642926529266292672926829269292702927129272292732927429275292762927729278292792928029281292822928329284292852928629287292882928929290292912929229293292942929529296292972929829299293002930129302293032930429305293062930729308293092931029311293122931329314293152931629317293182931929320293212932229323293242932529326293272932829329293302933129332293332933429335293362933729338293392934029341293422934329344293452934629347293482934929350293512935229353293542935529356293572935829359293602936129362293632936429365293662936729368293692937029371293722937329374293752937629377293782937929380293812938229383293842938529386293872938829389293902939129392293932939429395293962939729398293992940029401294022940329404294052940629407294082940929410294112941229413294142941529416294172941829419294202942129422294232942429425294262942729428294292943029431294322943329434294352943629437294382943929440294412944229443294442944529446294472944829449294502945129452294532945429455294562945729458294592946029461294622946329464294652946629467294682946929470294712947229473294742947529476294772947829479294802948129482294832948429485294862948729488294892949029491294922949329494294952949629497294982949929500295012950229503295042950529506295072950829509295102951129512295132951429515295162951729518295192952029521295222952329524295252952629527295282952929530295312953229533295342953529536295372953829539295402954129542295432954429545295462954729548295492955029551295522955329554295552955629557295582955929560295612956229563295642956529566295672956829569295702957129572295732957429575295762957729578295792958029581295822958329584295852958629587295882958929590295912959229593295942959529596295972959829599296002960129602296032960429605296062960729608296092961029611296122961329614296152961629617296182961929620296212962229623296242962529626296272962829629296302963129632296332963429635296362963729638296392964029641296422964329644296452964629647296482964929650296512965229653296542965529656296572965829659296602966129662296632966429665296662966729668296692967029671296722967329674296752967629677296782967929680296812968229683296842968529686296872968829689296902969129692296932969429695296962969729698296992970029701297022970329704297052970629707297082970929710297112971229713297142971529716297172971829719297202972129722297232972429725297262972729728297292973029731297322973329734297352973629737297382973929740297412974229743297442974529746297472974829749297502975129752297532975429755297562975729758297592976029761297622976329764297652976629767297682976929770297712977229773297742977529776297772977829779297802978129782297832978429785297862978729788297892979029791297922979329794297952979629797297982979929800298012980229803298042980529806298072980829809298102981129812298132981429815298162981729818298192982029821298222982329824298252982629827298282982929830298312983229833298342983529836298372983829839298402984129842298432984429845298462984729848298492985029851298522985329854298552985629857298582985929860298612986229863298642986529866298672986829869298702987129872298732987429875298762987729878298792988029881298822988329884298852988629887298882988929890298912989229893298942989529896298972989829899299002990129902299032990429905299062990729908299092991029911299122991329914299152991629917299182991929920299212992229923299242992529926299272992829929299302993129932299332993429935299362993729938299392994029941299422994329944299452994629947299482994929950299512995229953299542995529956299572995829959299602996129962299632996429965299662996729968299692997029971299722997329974299752997629977299782997929980299812998229983299842998529986299872998829989299902999129992299932999429995299962999729998299993000030001300023000330004300053000630007300083000930010300113001230013300143001530016300173001830019300203002130022300233002430025300263002730028300293003030031300323003330034300353003630037300383003930040300413004230043300443004530046300473004830049300503005130052300533005430055300563005730058300593006030061300623006330064300653006630067300683006930070300713007230073300743007530076300773007830079300803008130082300833008430085300863008730088300893009030091300923009330094300953009630097300983009930100301013010230103301043010530106301073010830109301103011130112301133011430115301163011730118301193012030121301223012330124301253012630127301283012930130301313013230133301343013530136301373013830139301403014130142301433014430145301463014730148301493015030151301523015330154301553015630157301583015930160301613016230163301643016530166301673016830169301703017130172301733017430175301763017730178301793018030181301823018330184301853018630187301883018930190301913019230193301943019530196301973019830199302003020130202302033020430205302063020730208302093021030211302123021330214302153021630217302183021930220302213022230223302243022530226302273022830229302303023130232302333023430235302363023730238302393024030241302423024330244302453024630247302483024930250302513025230253302543025530256302573025830259302603026130262302633026430265302663026730268302693027030271302723027330274302753027630277302783027930280302813028230283302843028530286302873028830289302903029130292302933029430295302963029730298302993030030301303023030330304303053030630307303083030930310303113031230313303143031530316303173031830319303203032130322303233032430325303263032730328303293033030331303323033330334303353033630337303383033930340303413034230343303443034530346303473034830349303503035130352303533035430355303563035730358303593036030361303623036330364303653036630367303683036930370303713037230373303743037530376303773037830379303803038130382303833038430385303863038730388303893039030391303923039330394303953039630397303983039930400304013040230403304043040530406304073040830409304103041130412304133041430415304163041730418304193042030421304223042330424304253042630427304283042930430304313043230433304343043530436304373043830439304403044130442304433044430445304463044730448304493045030451304523045330454304553045630457304583045930460304613046230463304643046530466304673046830469304703047130472304733047430475304763047730478304793048030481304823048330484304853048630487304883048930490304913049230493304943049530496304973049830499305003050130502305033050430505305063050730508305093051030511305123051330514305153051630517305183051930520305213052230523305243052530526305273052830529305303053130532305333053430535305363053730538305393054030541305423054330544305453054630547305483054930550305513055230553305543055530556305573055830559305603056130562305633056430565305663056730568305693057030571305723057330574305753057630577305783057930580305813058230583305843058530586305873058830589305903059130592305933059430595305963059730598305993060030601306023060330604306053060630607306083060930610306113061230613306143061530616306173061830619306203062130622306233062430625306263062730628306293063030631306323063330634306353063630637306383063930640306413064230643306443064530646306473064830649306503065130652306533065430655306563065730658306593066030661306623066330664306653066630667306683066930670306713067230673306743067530676306773067830679306803068130682306833068430685306863068730688306893069030691306923069330694306953069630697306983069930700307013070230703307043070530706307073070830709307103071130712307133071430715307163071730718307193072030721307223072330724307253072630727307283072930730307313073230733307343073530736307373073830739307403074130742307433074430745307463074730748307493075030751307523075330754307553075630757307583075930760307613076230763307643076530766307673076830769307703077130772307733077430775307763077730778307793078030781307823078330784307853078630787307883078930790307913079230793307943079530796307973079830799308003080130802308033080430805308063080730808308093081030811308123081330814308153081630817308183081930820308213082230823308243082530826308273082830829308303083130832308333083430835308363083730838308393084030841308423084330844308453084630847308483084930850308513085230853308543085530856308573085830859308603086130862308633086430865308663086730868308693087030871308723087330874308753087630877308783087930880308813088230883308843088530886308873088830889308903089130892308933089430895308963089730898308993090030901309023090330904309053090630907309083090930910309113091230913309143091530916309173091830919309203092130922309233092430925309263092730928309293093030931309323093330934309353093630937309383093930940309413094230943309443094530946309473094830949309503095130952309533095430955309563095730958309593096030961309623096330964309653096630967309683096930970309713097230973309743097530976309773097830979309803098130982309833098430985309863098730988309893099030991309923099330994309953099630997309983099931000310013100231003310043100531006310073100831009310103101131012310133101431015310163101731018310193102031021310223102331024310253102631027310283102931030310313103231033310343103531036310373103831039310403104131042310433104431045310463104731048310493105031051310523105331054310553105631057310583105931060310613106231063310643106531066310673106831069310703107131072310733107431075310763107731078310793108031081310823108331084310853108631087310883108931090310913109231093310943109531096310973109831099311003110131102311033110431105311063110731108311093111031111311123111331114311153111631117311183111931120311213112231123311243112531126311273112831129311303113131132311333113431135311363113731138311393114031141311423114331144311453114631147311483114931150311513115231153311543115531156311573115831159311603116131162311633116431165311663116731168311693117031171311723117331174311753117631177311783117931180311813118231183311843118531186311873118831189311903119131192311933119431195311963119731198311993120031201312023120331204312053120631207312083120931210312113121231213312143121531216312173121831219312203122131222312233122431225312263122731228312293123031231312323123331234312353123631237312383123931240312413124231243312443124531246312473124831249312503125131252312533125431255312563125731258312593126031261312623126331264312653126631267312683126931270312713127231273312743127531276312773127831279312803128131282312833128431285312863128731288312893129031291312923129331294312953129631297312983129931300313013130231303313043130531306313073130831309313103131131312313133131431315313163131731318313193132031321313223132331324313253132631327313283132931330313313133231333313343133531336313373133831339313403134131342313433134431345313463134731348313493135031351313523135331354313553135631357313583135931360313613136231363313643136531366313673136831369313703137131372313733137431375313763137731378313793138031381313823138331384313853138631387313883138931390313913139231393313943139531396313973139831399314003140131402314033140431405314063140731408314093141031411314123141331414314153141631417314183141931420314213142231423314243142531426314273142831429314303143131432314333143431435314363143731438314393144031441314423144331444314453144631447314483144931450314513145231453314543145531456314573145831459314603146131462314633146431465314663146731468314693147031471314723147331474314753147631477314783147931480314813148231483314843148531486314873148831489314903149131492314933149431495314963149731498314993150031501315023150331504315053150631507315083150931510315113151231513315143151531516315173151831519315203152131522315233152431525315263152731528315293153031531315323153331534315353153631537315383153931540315413154231543315443154531546315473154831549315503155131552315533155431555315563155731558315593156031561315623156331564315653156631567315683156931570315713157231573315743157531576315773157831579315803158131582315833158431585315863158731588315893159031591315923159331594315953159631597315983159931600316013160231603316043160531606316073160831609316103161131612316133161431615316163161731618316193162031621316223162331624316253162631627316283162931630316313163231633316343163531636316373163831639316403164131642316433164431645316463164731648316493165031651316523165331654316553165631657316583165931660316613166231663316643166531666316673166831669316703167131672316733167431675316763167731678316793168031681316823168331684316853168631687316883168931690316913169231693316943169531696316973169831699317003170131702317033170431705317063170731708317093171031711317123171331714317153171631717317183171931720317213172231723317243172531726317273172831729317303173131732317333173431735317363173731738317393174031741317423174331744317453174631747317483174931750317513175231753317543175531756317573175831759317603176131762317633176431765317663176731768317693177031771317723177331774317753177631777317783177931780317813178231783317843178531786317873178831789317903179131792317933179431795317963179731798317993180031801318023180331804318053180631807318083180931810318113181231813318143181531816318173181831819318203182131822318233182431825318263182731828318293183031831318323183331834318353183631837318383183931840318413184231843318443184531846318473184831849318503185131852318533185431855318563185731858318593186031861318623186331864318653186631867318683186931870318713187231873318743187531876318773187831879318803188131882318833188431885318863188731888318893189031891318923189331894318953189631897318983189931900319013190231903319043190531906319073190831909319103191131912319133191431915319163191731918319193192031921319223192331924319253192631927319283192931930319313193231933319343193531936319373193831939319403194131942319433194431945319463194731948319493195031951319523195331954319553195631957319583195931960319613196231963319643196531966319673196831969319703197131972319733197431975319763197731978319793198031981319823198331984319853198631987319883198931990319913199231993319943199531996319973199831999320003200132002320033200432005320063200732008320093201032011320123201332014320153201632017320183201932020320213202232023320243202532026320273202832029320303203132032320333203432035320363203732038320393204032041320423204332044320453204632047320483204932050320513205232053320543205532056320573205832059320603206132062320633206432065320663206732068320693207032071320723207332074320753207632077320783207932080320813208232083320843208532086320873208832089320903209132092320933209432095320963209732098320993210032101321023210332104321053210632107321083210932110321113211232113321143211532116321173211832119321203212132122321233212432125321263212732128321293213032131321323213332134321353213632137321383213932140321413214232143321443214532146321473214832149321503215132152321533215432155321563215732158321593216032161321623216332164321653216632167321683216932170321713217232173321743217532176321773217832179321803218132182321833218432185321863218732188321893219032191321923219332194321953219632197321983219932200322013220232203322043220532206322073220832209322103221132212322133221432215322163221732218322193222032221322223222332224322253222632227322283222932230322313223232233322343223532236322373223832239322403224132242322433224432245322463224732248322493225032251322523225332254322553225632257322583225932260322613226232263322643226532266322673226832269322703227132272322733227432275322763227732278322793228032281322823228332284322853228632287322883228932290322913229232293322943229532296322973229832299323003230132302323033230432305323063230732308323093231032311323123231332314323153231632317323183231932320323213232232323323243232532326323273232832329323303233132332323333233432335323363233732338323393234032341323423234332344323453234632347323483234932350323513235232353323543235532356323573235832359323603236132362323633236432365323663236732368323693237032371323723237332374323753237632377323783237932380323813238232383323843238532386323873238832389323903239132392323933239432395323963239732398323993240032401324023240332404324053240632407324083240932410324113241232413324143241532416324173241832419324203242132422324233242432425324263242732428324293243032431324323243332434324353243632437324383243932440324413244232443324443244532446324473244832449324503245132452324533245432455324563245732458324593246032461324623246332464324653246632467324683246932470324713247232473324743247532476324773247832479324803248132482324833248432485324863248732488324893249032491324923249332494324953249632497324983249932500325013250232503325043250532506325073250832509325103251132512325133251432515325163251732518325193252032521325223252332524325253252632527325283252932530325313253232533325343253532536325373253832539325403254132542325433254432545325463254732548325493255032551325523255332554325553255632557325583255932560325613256232563325643256532566325673256832569325703257132572325733257432575325763257732578325793258032581325823258332584325853258632587325883258932590325913259232593325943259532596325973259832599326003260132602326033260432605326063260732608326093261032611326123261332614326153261632617326183261932620326213262232623326243262532626326273262832629326303263132632326333263432635326363263732638326393264032641326423264332644326453264632647326483264932650326513265232653326543265532656326573265832659326603266132662326633266432665326663266732668326693267032671326723267332674326753267632677326783267932680326813268232683326843268532686326873268832689326903269132692326933269432695326963269732698326993270032701327023270332704327053270632707327083270932710327113271232713327143271532716327173271832719327203272132722327233272432725327263272732728327293273032731327323273332734327353273632737327383273932740327413274232743327443274532746327473274832749327503275132752327533275432755327563275732758327593276032761327623276332764327653276632767327683276932770327713277232773327743277532776327773277832779327803278132782327833278432785327863278732788327893279032791327923279332794327953279632797327983279932800328013280232803328043280532806328073280832809328103281132812328133281432815328163281732818328193282032821328223282332824328253282632827328283282932830328313283232833328343283532836328373283832839328403284132842328433284432845328463284732848328493285032851328523285332854328553285632857328583285932860328613286232863328643286532866328673286832869328703287132872328733287432875328763287732878328793288032881328823288332884328853288632887328883288932890328913289232893328943289532896328973289832899329003290132902329033290432905329063290732908329093291032911329123291332914329153291632917329183291932920329213292232923329243292532926329273292832929329303293132932329333293432935329363293732938329393294032941329423294332944329453294632947329483294932950329513295232953329543295532956329573295832959329603296132962329633296432965329663296732968329693297032971329723297332974329753297632977329783297932980329813298232983329843298532986329873298832989329903299132992329933299432995329963299732998329993300033001330023300333004330053300633007330083300933010330113301233013330143301533016330173301833019330203302133022330233302433025330263302733028330293303033031330323303333034330353303633037330383303933040330413304233043330443304533046330473304833049330503305133052330533305433055330563305733058330593306033061330623306333064330653306633067330683306933070330713307233073330743307533076330773307833079330803308133082330833308433085330863308733088330893309033091330923309333094330953309633097330983309933100331013310233103331043310533106331073310833109331103311133112331133311433115331163311733118331193312033121331223312333124331253312633127331283312933130331313313233133331343313533136331373313833139331403314133142331433314433145331463314733148331493315033151331523315333154331553315633157331583315933160331613316233163331643316533166331673316833169331703317133172331733317433175331763317733178331793318033181331823318333184331853318633187331883318933190331913319233193331943319533196331973319833199332003320133202332033320433205332063320733208332093321033211332123321333214332153321633217332183321933220332213322233223332243322533226332273322833229332303323133232332333323433235332363323733238332393324033241332423324333244332453324633247332483324933250332513325233253332543325533256332573325833259332603326133262332633326433265332663326733268332693327033271332723327333274332753327633277332783327933280332813328233283332843328533286332873328833289332903329133292332933329433295332963329733298332993330033301333023330333304333053330633307333083330933310333113331233313333143331533316333173331833319333203332133322333233332433325333263332733328333293333033331333323333333334333353333633337333383333933340333413334233343333443334533346333473334833349333503335133352333533335433355333563335733358333593336033361333623336333364333653336633367333683336933370333713337233373333743337533376333773337833379333803338133382333833338433385333863338733388333893339033391333923339333394333953339633397333983339933400334013340233403334043340533406334073340833409334103341133412334133341433415334163341733418334193342033421334223342333424334253342633427334283342933430334313343233433334343343533436334373343833439334403344133442334433344433445334463344733448334493345033451334523345333454334553345633457334583345933460334613346233463334643346533466334673346833469334703347133472334733347433475334763347733478334793348033481334823348333484334853348633487334883348933490334913349233493334943349533496334973349833499335003350133502335033350433505335063350733508335093351033511335123351333514335153351633517335183351933520335213352233523335243352533526335273352833529335303353133532335333353433535335363353733538335393354033541335423354333544335453354633547335483354933550335513355233553335543355533556335573355833559335603356133562335633356433565335663356733568335693357033571335723357333574335753357633577335783357933580335813358233583335843358533586335873358833589335903359133592335933359433595335963359733598335993360033601336023360333604336053360633607336083360933610336113361233613336143361533616336173361833619336203362133622336233362433625336263362733628336293363033631336323363333634336353363633637336383363933640336413364233643336443364533646336473364833649336503365133652336533365433655336563365733658336593366033661336623366333664336653366633667336683366933670336713367233673336743367533676336773367833679336803368133682336833368433685336863368733688336893369033691336923369333694336953369633697336983369933700337013370233703337043370533706337073370833709337103371133712337133371433715337163371733718337193372033721337223372333724337253372633727337283372933730337313373233733337343373533736337373373833739337403374133742337433374433745337463374733748337493375033751337523375333754337553375633757337583375933760337613376233763337643376533766337673376833769337703377133772337733377433775337763377733778337793378033781337823378333784337853378633787337883378933790337913379233793337943379533796337973379833799338003380133802338033380433805338063380733808338093381033811338123381333814338153381633817338183381933820338213382233823338243382533826338273382833829338303383133832338333383433835338363383733838338393384033841338423384333844338453384633847338483384933850338513385233853338543385533856338573385833859338603386133862338633386433865338663386733868338693387033871338723387333874338753387633877338783387933880338813388233883338843388533886338873388833889338903389133892338933389433895338963389733898338993390033901339023390333904339053390633907339083390933910339113391233913339143391533916339173391833919339203392133922339233392433925339263392733928339293393033931339323393333934339353393633937339383393933940339413394233943339443394533946339473394833949339503395133952339533395433955339563395733958339593396033961339623396333964339653396633967339683396933970339713397233973339743397533976339773397833979339803398133982339833398433985339863398733988339893399033991339923399333994339953399633997339983399934000340013400234003340043400534006340073400834009340103401134012340133401434015340163401734018340193402034021340223402334024340253402634027340283402934030340313403234033340343403534036340373403834039340403404134042340433404434045340463404734048340493405034051340523405334054340553405634057340583405934060340613406234063340643406534066340673406834069340703407134072340733407434075340763407734078340793408034081340823408334084340853408634087340883408934090340913409234093340943409534096340973409834099341003410134102341033410434105341063410734108341093411034111341123411334114341153411634117341183411934120341213412234123341243412534126341273412834129341303413134132341333413434135341363413734138341393414034141341423414334144341453414634147341483414934150341513415234153341543415534156341573415834159341603416134162341633416434165341663416734168341693417034171341723417334174341753417634177341783417934180341813418234183341843418534186341873418834189341903419134192341933419434195341963419734198341993420034201342023420334204342053420634207342083420934210342113421234213342143421534216342173421834219342203422134222342233422434225342263422734228342293423034231342323423334234342353423634237342383423934240342413424234243342443424534246342473424834249342503425134252342533425434255342563425734258342593426034261342623426334264342653426634267342683426934270342713427234273342743427534276342773427834279342803428134282342833428434285342863428734288342893429034291342923429334294342953429634297342983429934300343013430234303343043430534306343073430834309343103431134312343133431434315343163431734318343193432034321343223432334324343253432634327343283432934330343313433234333343343433534336343373433834339343403434134342343433434434345343463434734348343493435034351343523435334354343553435634357343583435934360343613436234363343643436534366343673436834369343703437134372343733437434375343763437734378343793438034381343823438334384343853438634387343883438934390343913439234393343943439534396343973439834399344003440134402344033440434405344063440734408344093441034411344123441334414344153441634417344183441934420344213442234423344243442534426344273442834429344303443134432344333443434435344363443734438344393444034441344423444334444344453444634447344483444934450344513445234453344543445534456344573445834459344603446134462344633446434465344663446734468344693447034471344723447334474344753447634477344783447934480344813448234483344843448534486344873448834489344903449134492344933449434495344963449734498344993450034501345023450334504345053450634507345083450934510345113451234513345143451534516345173451834519345203452134522345233452434525345263452734528345293453034531345323453334534345353453634537345383453934540345413454234543345443454534546345473454834549345503455134552345533455434555345563455734558345593456034561345623456334564345653456634567345683456934570345713457234573345743457534576345773457834579345803458134582345833458434585345863458734588345893459034591345923459334594345953459634597345983459934600346013460234603346043460534606346073460834609346103461134612346133461434615346163461734618346193462034621346223462334624346253462634627346283462934630346313463234633346343463534636346373463834639346403464134642346433464434645346463464734648346493465034651346523465334654346553465634657346583465934660346613466234663346643466534666346673466834669346703467134672346733467434675346763467734678346793468034681346823468334684346853468634687346883468934690346913469234693346943469534696346973469834699347003470134702347033470434705347063470734708347093471034711347123471334714347153471634717347183471934720347213472234723347243472534726347273472834729347303473134732347333473434735347363473734738347393474034741347423474334744347453474634747347483474934750347513475234753347543475534756347573475834759347603476134762347633476434765347663476734768347693477034771347723477334774347753477634777347783477934780347813478234783347843478534786347873478834789347903479134792347933479434795347963479734798347993480034801348023480334804348053480634807348083480934810348113481234813348143481534816348173481834819348203482134822348233482434825348263482734828348293483034831348323483334834348353483634837348383483934840348413484234843348443484534846348473484834849348503485134852348533485434855348563485734858348593486034861348623486334864348653486634867348683486934870348713487234873348743487534876348773487834879348803488134882348833488434885348863488734888348893489034891348923489334894348953489634897348983489934900349013490234903349043490534906349073490834909349103491134912349133491434915349163491734918349193492034921349223492334924349253492634927349283492934930349313493234933349343493534936349373493834939349403494134942349433494434945349463494734948349493495034951349523495334954349553495634957349583495934960349613496234963349643496534966349673496834969349703497134972349733497434975349763497734978349793498034981349823498334984349853498634987349883498934990349913499234993349943499534996349973499834999350003500135002350033500435005350063500735008350093501035011350123501335014350153501635017350183501935020350213502235023350243502535026350273502835029350303503135032350333503435035350363503735038350393504035041350423504335044350453504635047350483504935050350513505235053350543505535056350573505835059350603506135062350633506435065350663506735068350693507035071350723507335074350753507635077350783507935080350813508235083350843508535086350873508835089350903509135092350933509435095350963509735098350993510035101351023510335104351053510635107351083510935110351113511235113351143511535116351173511835119351203512135122351233512435125351263512735128351293513035131351323513335134351353513635137351383513935140351413514235143351443514535146351473514835149351503515135152351533515435155351563515735158351593516035161351623516335164351653516635167351683516935170351713517235173351743517535176351773517835179351803518135182351833518435185351863518735188351893519035191351923519335194351953519635197351983519935200352013520235203352043520535206352073520835209352103521135212352133521435215352163521735218352193522035221352223522335224352253522635227352283522935230352313523235233352343523535236352373523835239352403524135242352433524435245352463524735248352493525035251352523525335254352553525635257352583525935260352613526235263352643526535266352673526835269352703527135272352733527435275352763527735278352793528035281352823528335284352853528635287352883528935290352913529235293352943529535296352973529835299353003530135302353033530435305353063530735308353093531035311353123531335314353153531635317353183531935320353213532235323353243532535326353273532835329353303533135332353333533435335353363533735338353393534035341353423534335344353453534635347353483534935350353513535235353353543535535356353573535835359353603536135362353633536435365353663536735368353693537035371353723537335374353753537635377353783537935380353813538235383353843538535386353873538835389353903539135392353933539435395353963539735398353993540035401354023540335404354053540635407354083540935410354113541235413354143541535416354173541835419354203542135422354233542435425354263542735428354293543035431354323543335434354353543635437354383543935440354413544235443354443544535446354473544835449354503545135452354533545435455354563545735458354593546035461354623546335464354653546635467354683546935470354713547235473354743547535476354773547835479354803548135482354833548435485354863548735488354893549035491354923549335494354953549635497354983549935500355013550235503355043550535506355073550835509355103551135512355133551435515355163551735518355193552035521355223552335524355253552635527355283552935530355313553235533355343553535536355373553835539355403554135542355433554435545355463554735548355493555035551355523555335554355553555635557355583555935560355613556235563355643556535566355673556835569355703557135572355733557435575355763557735578355793558035581355823558335584355853558635587355883558935590355913559235593355943559535596355973559835599356003560135602356033560435605356063560735608356093561035611356123561335614356153561635617356183561935620356213562235623356243562535626356273562835629356303563135632356333563435635356363563735638356393564035641356423564335644356453564635647356483564935650356513565235653356543565535656356573565835659356603566135662356633566435665356663566735668356693567035671356723567335674356753567635677356783567935680356813568235683356843568535686356873568835689356903569135692356933569435695356963569735698356993570035701357023570335704357053570635707357083570935710357113571235713357143571535716357173571835719357203572135722357233572435725357263572735728357293573035731357323573335734357353573635737357383573935740357413574235743357443574535746357473574835749357503575135752357533575435755357563575735758357593576035761357623576335764357653576635767357683576935770357713577235773357743577535776357773577835779357803578135782357833578435785357863578735788357893579035791357923579335794357953579635797357983579935800358013580235803358043580535806358073580835809358103581135812358133581435815358163581735818358193582035821358223582335824358253582635827358283582935830358313583235833358343583535836358373583835839358403584135842358433584435845358463584735848358493585035851358523585335854358553585635857358583585935860358613586235863358643586535866358673586835869358703587135872358733587435875358763587735878358793588035881358823588335884358853588635887358883588935890358913589235893358943589535896358973589835899359003590135902359033590435905359063590735908359093591035911359123591335914359153591635917359183591935920359213592235923359243592535926359273592835929359303593135932359333593435935359363593735938359393594035941359423594335944359453594635947359483594935950359513595235953359543595535956359573595835959359603596135962359633596435965359663596735968359693597035971359723597335974359753597635977359783597935980359813598235983359843598535986359873598835989359903599135992359933599435995359963599735998359993600036001360023600336004360053600636007360083600936010360113601236013360143601536016360173601836019360203602136022360233602436025360263602736028360293603036031360323603336034360353603636037360383603936040360413604236043360443604536046360473604836049360503605136052360533605436055360563605736058360593606036061360623606336064360653606636067360683606936070360713607236073360743607536076360773607836079360803608136082360833608436085360863608736088360893609036091360923609336094360953609636097360983609936100361013610236103361043610536106361073610836109361103611136112361133611436115361163611736118361193612036121361223612336124361253612636127361283612936130361313613236133361343613536136361373613836139361403614136142361433614436145361463614736148361493615036151361523615336154361553615636157361583615936160361613616236163361643616536166361673616836169361703617136172361733617436175361763617736178361793618036181361823618336184361853618636187361883618936190361913619236193361943619536196361973619836199362003620136202362033620436205362063620736208362093621036211362123621336214362153621636217362183621936220362213622236223362243622536226362273622836229362303623136232362333623436235362363623736238362393624036241362423624336244362453624636247362483624936250362513625236253362543625536256362573625836259362603626136262362633626436265362663626736268362693627036271362723627336274362753627636277362783627936280362813628236283362843628536286362873628836289362903629136292362933629436295362963629736298362993630036301363023630336304363053630636307363083630936310363113631236313363143631536316363173631836319363203632136322363233632436325363263632736328363293633036331363323633336334363353633636337363383633936340363413634236343363443634536346363473634836349363503635136352363533635436355363563635736358363593636036361363623636336364363653636636367363683636936370363713637236373363743637536376363773637836379363803638136382363833638436385363863638736388363893639036391363923639336394363953639636397363983639936400364013640236403364043640536406364073640836409364103641136412364133641436415364163641736418364193642036421364223642336424364253642636427364283642936430364313643236433364343643536436364373643836439364403644136442364433644436445364463644736448364493645036451364523645336454364553645636457364583645936460364613646236463364643646536466364673646836469364703647136472364733647436475364763647736478364793648036481364823648336484364853648636487364883648936490364913649236493364943649536496364973649836499365003650136502365033650436505365063650736508365093651036511365123651336514365153651636517365183651936520365213652236523365243652536526365273652836529365303653136532365333653436535365363653736538365393654036541365423654336544365453654636547365483654936550365513655236553365543655536556365573655836559365603656136562365633656436565365663656736568365693657036571365723657336574365753657636577365783657936580365813658236583365843658536586365873658836589365903659136592365933659436595365963659736598365993660036601366023660336604366053660636607366083660936610366113661236613366143661536616366173661836619366203662136622366233662436625366263662736628366293663036631366323663336634366353663636637366383663936640366413664236643366443664536646366473664836649366503665136652366533665436655366563665736658366593666036661366623666336664366653666636667366683666936670366713667236673366743667536676366773667836679366803668136682366833668436685366863668736688366893669036691366923669336694366953669636697366983669936700367013670236703367043670536706367073670836709367103671136712367133671436715367163671736718367193672036721367223672336724367253672636727367283672936730367313673236733367343673536736367373673836739367403674136742367433674436745367463674736748367493675036751367523675336754367553675636757367583675936760367613676236763367643676536766367673676836769367703677136772367733677436775367763677736778367793678036781367823678336784367853678636787367883678936790367913679236793367943679536796367973679836799368003680136802368033680436805368063680736808368093681036811368123681336814368153681636817368183681936820368213682236823368243682536826368273682836829368303683136832368333683436835368363683736838368393684036841368423684336844368453684636847368483684936850368513685236853368543685536856368573685836859368603686136862368633686436865368663686736868368693687036871368723687336874368753687636877368783687936880368813688236883368843688536886368873688836889368903689136892368933689436895368963689736898368993690036901369023690336904369053690636907369083690936910369113691236913369143691536916369173691836919369203692136922369233692436925369263692736928369293693036931369323693336934369353693636937369383693936940369413694236943369443694536946369473694836949369503695136952369533695436955369563695736958369593696036961369623696336964369653696636967369683696936970369713697236973369743697536976369773697836979369803698136982369833698436985369863698736988369893699036991369923699336994369953699636997369983699937000370013700237003370043700537006370073700837009370103701137012370133701437015370163701737018370193702037021370223702337024370253702637027370283702937030370313703237033370343703537036370373703837039370403704137042370433704437045370463704737048370493705037051370523705337054370553705637057370583705937060370613706237063370643706537066370673706837069370703707137072370733707437075370763707737078370793708037081370823708337084370853708637087370883708937090370913709237093370943709537096370973709837099371003710137102371033710437105371063710737108371093711037111371123711337114371153711637117371183711937120371213712237123371243712537126371273712837129371303713137132371333713437135371363713737138371393714037141371423714337144371453714637147371483714937150371513715237153371543715537156371573715837159371603716137162371633716437165371663716737168371693717037171371723717337174371753717637177371783717937180371813718237183371843718537186371873718837189371903719137192371933719437195371963719737198371993720037201372023720337204372053720637207372083720937210372113721237213372143721537216372173721837219372203722137222372233722437225372263722737228372293723037231372323723337234372353723637237372383723937240372413724237243372443724537246372473724837249372503725137252372533725437255372563725737258372593726037261372623726337264372653726637267372683726937270372713727237273372743727537276372773727837279372803728137282372833728437285372863728737288372893729037291372923729337294372953729637297372983729937300373013730237303373043730537306373073730837309373103731137312373133731437315373163731737318373193732037321373223732337324373253732637327373283732937330373313733237333373343733537336373373733837339373403734137342373433734437345373463734737348373493735037351373523735337354373553735637357373583735937360373613736237363373643736537366373673736837369373703737137372373733737437375373763737737378373793738037381373823738337384373853738637387373883738937390373913739237393373943739537396373973739837399374003740137402374033740437405374063740737408374093741037411374123741337414374153741637417374183741937420374213742237423374243742537426374273742837429374303743137432374333743437435374363743737438374393744037441374423744337444374453744637447374483744937450374513745237453374543745537456374573745837459374603746137462374633746437465374663746737468374693747037471374723747337474374753747637477374783747937480374813748237483374843748537486374873748837489374903749137492374933749437495374963749737498374993750037501375023750337504375053750637507375083750937510375113751237513375143751537516375173751837519375203752137522375233752437525375263752737528375293753037531375323753337534375353753637537375383753937540375413754237543375443754537546375473754837549375503755137552375533755437555375563755737558375593756037561375623756337564375653756637567375683756937570375713757237573375743757537576375773757837579375803758137582375833758437585375863758737588375893759037591375923759337594375953759637597375983759937600376013760237603376043760537606376073760837609376103761137612376133761437615376163761737618376193762037621376223762337624376253762637627376283762937630376313763237633376343763537636376373763837639376403764137642376433764437645376463764737648376493765037651376523765337654376553765637657376583765937660376613766237663376643766537666376673766837669376703767137672376733767437675376763767737678376793768037681376823768337684376853768637687376883768937690376913769237693376943769537696376973769837699377003770137702377033770437705377063770737708377093771037711377123771337714377153771637717377183771937720377213772237723377243772537726377273772837729377303773137732377333773437735377363773737738377393774037741377423774337744377453774637747377483774937750377513775237753377543775537756377573775837759377603776137762377633776437765377663776737768377693777037771377723777337774377753777637777377783777937780377813778237783377843778537786377873778837789377903779137792377933779437795377963779737798377993780037801378023780337804378053780637807378083780937810378113781237813378143781537816378173781837819378203782137822378233782437825378263782737828378293783037831378323783337834378353783637837378383783937840378413784237843378443784537846378473784837849378503785137852378533785437855378563785737858378593786037861378623786337864378653786637867378683786937870378713787237873378743787537876378773787837879378803788137882378833788437885378863788737888378893789037891378923789337894378953789637897378983789937900379013790237903379043790537906379073790837909379103791137912379133791437915379163791737918379193792037921379223792337924379253792637927379283792937930379313793237933379343793537936379373793837939379403794137942379433794437945379463794737948379493795037951379523795337954379553795637957379583795937960379613796237963379643796537966379673796837969379703797137972379733797437975379763797737978379793798037981379823798337984379853798637987379883798937990379913799237993379943799537996379973799837999380003800138002380033800438005380063800738008380093801038011380123801338014380153801638017380183801938020380213802238023380243802538026380273802838029380303803138032380333803438035380363803738038380393804038041380423804338044380453804638047380483804938050380513805238053380543805538056380573805838059380603806138062380633806438065380663806738068380693807038071380723807338074380753807638077380783807938080380813808238083380843808538086380873808838089380903809138092380933809438095380963809738098380993810038101381023810338104381053810638107381083810938110381113811238113381143811538116381173811838119381203812138122381233812438125381263812738128381293813038131381323813338134381353813638137381383813938140381413814238143381443814538146381473814838149381503815138152381533815438155381563815738158381593816038161381623816338164381653816638167381683816938170381713817238173381743817538176381773817838179381803818138182381833818438185381863818738188381893819038191381923819338194381953819638197381983819938200382013820238203382043820538206382073820838209382103821138212382133821438215382163821738218382193822038221382223822338224382253822638227382283822938230382313823238233382343823538236382373823838239382403824138242382433824438245382463824738248382493825038251382523825338254382553825638257382583825938260382613826238263382643826538266382673826838269382703827138272382733827438275382763827738278382793828038281382823828338284382853828638287382883828938290382913829238293382943829538296382973829838299383003830138302383033830438305383063830738308383093831038311383123831338314383153831638317383183831938320383213832238323383243832538326383273832838329383303833138332383333833438335383363833738338383393834038341383423834338344383453834638347383483834938350383513835238353383543835538356383573835838359383603836138362383633836438365383663836738368383693837038371383723837338374383753837638377383783837938380383813838238383383843838538386383873838838389383903839138392383933839438395383963839738398383993840038401384023840338404384053840638407384083840938410384113841238413384143841538416384173841838419384203842138422384233842438425384263842738428384293843038431384323843338434384353843638437384383843938440384413844238443384443844538446384473844838449384503845138452384533845438455384563845738458384593846038461384623846338464384653846638467384683846938470384713847238473384743847538476384773847838479384803848138482384833848438485384863848738488384893849038491384923849338494384953849638497384983849938500385013850238503385043850538506385073850838509385103851138512385133851438515385163851738518385193852038521385223852338524385253852638527385283852938530385313853238533385343853538536385373853838539385403854138542385433854438545385463854738548385493855038551385523855338554385553855638557385583855938560385613856238563385643856538566385673856838569385703857138572385733857438575385763857738578385793858038581385823858338584385853858638587385883858938590385913859238593385943859538596385973859838599386003860138602386033860438605386063860738608386093861038611386123861338614386153861638617386183861938620386213862238623386243862538626386273862838629386303863138632386333863438635386363863738638386393864038641386423864338644386453864638647386483864938650386513865238653386543865538656386573865838659386603866138662386633866438665386663866738668386693867038671386723867338674386753867638677386783867938680386813868238683386843868538686386873868838689386903869138692386933869438695386963869738698386993870038701387023870338704387053870638707387083870938710387113871238713387143871538716387173871838719387203872138722387233872438725387263872738728387293873038731387323873338734387353873638737387383873938740387413874238743387443874538746387473874838749387503875138752387533875438755387563875738758387593876038761387623876338764387653876638767387683876938770387713877238773387743877538776387773877838779387803878138782387833878438785387863878738788387893879038791387923879338794387953879638797387983879938800388013880238803388043880538806388073880838809388103881138812388133881438815388163881738818388193882038821388223882338824388253882638827388283882938830388313883238833388343883538836388373883838839388403884138842388433884438845388463884738848388493885038851388523885338854388553885638857388583885938860388613886238863388643886538866388673886838869388703887138872388733887438875388763887738878388793888038881388823888338884388853888638887388883888938890388913889238893388943889538896388973889838899389003890138902389033890438905389063890738908389093891038911389123891338914389153891638917389183891938920389213892238923389243892538926389273892838929389303893138932389333893438935389363893738938389393894038941389423894338944389453894638947389483894938950389513895238953389543895538956389573895838959389603896138962389633896438965389663896738968389693897038971389723897338974389753897638977389783897938980389813898238983389843898538986389873898838989389903899138992389933899438995389963899738998389993900039001390023900339004390053900639007390083900939010390113901239013390143901539016390173901839019390203902139022390233902439025390263902739028390293903039031390323903339034390353903639037390383903939040390413904239043390443904539046390473904839049390503905139052390533905439055390563905739058390593906039061390623906339064390653906639067390683906939070390713907239073390743907539076390773907839079390803908139082390833908439085390863908739088390893909039091390923909339094390953909639097390983909939100391013910239103391043910539106391073910839109391103911139112391133911439115391163911739118391193912039121391223912339124391253912639127391283912939130391313913239133391343913539136391373913839139391403914139142391433914439145391463914739148391493915039151391523915339154391553915639157391583915939160391613916239163391643916539166391673916839169391703917139172391733917439175391763917739178391793918039181391823918339184391853918639187391883918939190391913919239193391943919539196391973919839199392003920139202392033920439205392063920739208392093921039211392123921339214392153921639217392183921939220392213922239223392243922539226392273922839229392303923139232392333923439235392363923739238392393924039241392423924339244392453924639247392483924939250392513925239253392543925539256392573925839259392603926139262392633926439265392663926739268392693927039271392723927339274392753927639277392783927939280392813928239283392843928539286392873928839289392903929139292392933929439295392963929739298392993930039301393023930339304393053930639307393083930939310393113931239313393143931539316393173931839319393203932139322393233932439325393263932739328393293933039331393323933339334393353933639337393383933939340393413934239343393443934539346393473934839349393503935139352393533935439355393563935739358393593936039361393623936339364393653936639367393683936939370393713937239373393743937539376393773937839379393803938139382393833938439385393863938739388393893939039391393923939339394393953939639397393983939939400394013940239403394043940539406394073940839409394103941139412394133941439415394163941739418394193942039421394223942339424394253942639427394283942939430394313943239433394343943539436394373943839439394403944139442394433944439445394463944739448394493945039451394523945339454394553945639457394583945939460394613946239463394643946539466394673946839469394703947139472394733947439475394763947739478394793948039481394823948339484394853948639487394883948939490394913949239493394943949539496394973949839499395003950139502395033950439505395063950739508395093951039511395123951339514395153951639517395183951939520395213952239523395243952539526395273952839529395303953139532395333953439535395363953739538395393954039541395423954339544395453954639547395483954939550395513955239553395543955539556395573955839559395603956139562395633956439565395663956739568395693957039571395723957339574395753957639577395783957939580395813958239583395843958539586395873958839589395903959139592395933959439595395963959739598395993960039601396023960339604396053960639607396083960939610396113961239613396143961539616396173961839619396203962139622396233962439625396263962739628396293963039631396323963339634396353963639637396383963939640396413964239643396443964539646396473964839649396503965139652396533965439655396563965739658396593966039661396623966339664396653966639667396683966939670396713967239673396743967539676396773967839679396803968139682396833968439685396863968739688396893969039691396923969339694396953969639697396983969939700397013970239703397043970539706397073970839709397103971139712397133971439715397163971739718397193972039721397223972339724397253972639727397283972939730397313973239733397343973539736397373973839739397403974139742397433974439745397463974739748397493975039751397523975339754397553975639757397583975939760397613976239763397643976539766397673976839769397703977139772397733977439775397763977739778397793978039781397823978339784397853978639787397883978939790397913979239793397943979539796397973979839799398003980139802398033980439805398063980739808398093981039811398123981339814398153981639817398183981939820398213982239823398243982539826398273982839829398303983139832398333983439835398363983739838398393984039841398423984339844398453984639847398483984939850398513985239853398543985539856398573985839859398603986139862398633986439865398663986739868398693987039871398723987339874398753987639877398783987939880398813988239883398843988539886398873988839889398903989139892398933989439895398963989739898398993990039901399023990339904399053990639907399083990939910399113991239913399143991539916399173991839919399203992139922399233992439925399263992739928399293993039931399323993339934399353993639937399383993939940399413994239943399443994539946399473994839949399503995139952399533995439955399563995739958399593996039961399623996339964399653996639967399683996939970399713997239973399743997539976399773997839979399803998139982399833998439985399863998739988399893999039991399923999339994399953999639997399983999940000400014000240003400044000540006400074000840009400104001140012400134001440015400164001740018400194002040021400224002340024400254002640027400284002940030400314003240033400344003540036400374003840039400404004140042400434004440045400464004740048400494005040051400524005340054400554005640057400584005940060400614006240063400644006540066400674006840069400704007140072400734007440075400764007740078400794008040081400824008340084400854008640087400884008940090400914009240093400944009540096400974009840099401004010140102401034010440105401064010740108401094011040111401124011340114401154011640117401184011940120401214012240123401244012540126401274012840129401304013140132401334013440135401364013740138401394014040141401424014340144401454014640147401484014940150401514015240153401544015540156401574015840159401604016140162401634016440165401664016740168401694017040171401724017340174401754017640177401784017940180401814018240183401844018540186401874018840189401904019140192401934019440195401964019740198401994020040201402024020340204402054020640207402084020940210402114021240213402144021540216402174021840219402204022140222402234022440225402264022740228402294023040231402324023340234402354023640237402384023940240402414024240243402444024540246402474024840249402504025140252402534025440255402564025740258402594026040261402624026340264402654026640267402684026940270402714027240273402744027540276402774027840279402804028140282402834028440285402864028740288402894029040291402924029340294402954029640297402984029940300403014030240303403044030540306403074030840309403104031140312403134031440315403164031740318403194032040321403224032340324403254032640327403284032940330403314033240333403344033540336403374033840339403404034140342403434034440345403464034740348403494035040351403524035340354403554035640357403584035940360403614036240363403644036540366403674036840369403704037140372403734037440375403764037740378403794038040381403824038340384403854038640387403884038940390403914039240393403944039540396403974039840399404004040140402404034040440405404064040740408404094041040411404124041340414404154041640417404184041940420404214042240423404244042540426404274042840429404304043140432404334043440435404364043740438404394044040441404424044340444404454044640447404484044940450404514045240453404544045540456404574045840459404604046140462404634046440465404664046740468404694047040471404724047340474404754047640477404784047940480404814048240483404844048540486404874048840489404904049140492404934049440495404964049740498404994050040501405024050340504405054050640507405084050940510405114051240513405144051540516405174051840519405204052140522405234052440525405264052740528405294053040531405324053340534405354053640537405384053940540405414054240543405444054540546405474054840549405504055140552405534055440555405564055740558405594056040561405624056340564405654056640567405684056940570405714057240573405744057540576405774057840579405804058140582405834058440585405864058740588405894059040591405924059340594405954059640597405984059940600406014060240603406044060540606406074060840609406104061140612406134061440615406164061740618406194062040621406224062340624406254062640627406284062940630406314063240633406344063540636406374063840639406404064140642406434064440645406464064740648406494065040651406524065340654406554065640657406584065940660406614066240663406644066540666406674066840669406704067140672406734067440675406764067740678406794068040681406824068340684406854068640687406884068940690406914069240693406944069540696406974069840699407004070140702407034070440705407064070740708407094071040711407124071340714407154071640717407184071940720407214072240723407244072540726407274072840729407304073140732407334073440735407364073740738407394074040741407424074340744407454074640747407484074940750407514075240753407544075540756407574075840759407604076140762407634076440765407664076740768407694077040771407724077340774407754077640777407784077940780407814078240783407844078540786407874078840789407904079140792407934079440795407964079740798407994080040801408024080340804408054080640807408084080940810408114081240813408144081540816408174081840819408204082140822408234082440825408264082740828408294083040831408324083340834408354083640837408384083940840408414084240843408444084540846408474084840849408504085140852408534085440855408564085740858408594086040861408624086340864408654086640867408684086940870408714087240873408744087540876408774087840879408804088140882408834088440885408864088740888408894089040891408924089340894408954089640897408984089940900409014090240903409044090540906409074090840909409104091140912409134091440915409164091740918409194092040921409224092340924409254092640927409284092940930409314093240933409344093540936409374093840939409404094140942409434094440945409464094740948409494095040951409524095340954409554095640957409584095940960409614096240963409644096540966409674096840969409704097140972409734097440975409764097740978409794098040981409824098340984409854098640987409884098940990409914099240993409944099540996409974099840999410004100141002410034100441005410064100741008410094101041011410124101341014410154101641017410184101941020410214102241023410244102541026410274102841029410304103141032410334103441035410364103741038410394104041041410424104341044410454104641047410484104941050410514105241053410544105541056410574105841059410604106141062410634106441065410664106741068410694107041071410724107341074410754107641077410784107941080410814108241083410844108541086410874108841089410904109141092410934109441095410964109741098410994110041101411024110341104411054110641107411084110941110411114111241113411144111541116411174111841119411204112141122411234112441125411264112741128411294113041131411324113341134411354113641137411384113941140411414114241143411444114541146411474114841149411504115141152411534115441155411564115741158411594116041161411624116341164411654116641167411684116941170411714117241173411744117541176411774117841179411804118141182411834118441185411864118741188411894119041191411924119341194411954119641197411984119941200412014120241203412044120541206412074120841209412104121141212412134121441215412164121741218412194122041221412224122341224412254122641227412284122941230412314123241233412344123541236412374123841239412404124141242412434124441245412464124741248412494125041251412524125341254412554125641257412584125941260412614126241263412644126541266412674126841269412704127141272412734127441275412764127741278412794128041281412824128341284412854128641287412884128941290412914129241293412944129541296412974129841299413004130141302413034130441305413064130741308413094131041311413124131341314413154131641317413184131941320413214132241323413244132541326413274132841329413304133141332413334133441335413364133741338413394134041341413424134341344413454134641347413484134941350413514135241353413544135541356413574135841359413604136141362413634136441365413664136741368413694137041371413724137341374413754137641377413784137941380413814138241383413844138541386413874138841389413904139141392413934139441395413964139741398413994140041401414024140341404414054140641407414084140941410414114141241413414144141541416414174141841419414204142141422414234142441425414264142741428414294143041431414324143341434414354143641437414384143941440414414144241443414444144541446414474144841449414504145141452414534145441455414564145741458414594146041461414624146341464414654146641467414684146941470414714147241473414744147541476414774147841479414804148141482414834148441485414864148741488414894149041491414924149341494414954149641497414984149941500415014150241503415044150541506415074150841509415104151141512415134151441515415164151741518415194152041521415224152341524415254152641527415284152941530415314153241533415344153541536415374153841539415404154141542415434154441545415464154741548415494155041551415524155341554415554155641557415584155941560415614156241563415644156541566415674156841569415704157141572415734157441575415764157741578415794158041581415824158341584415854158641587415884158941590415914159241593415944159541596415974159841599416004160141602416034160441605416064160741608416094161041611416124161341614416154161641617416184161941620416214162241623416244162541626416274162841629416304163141632416334163441635416364163741638416394164041641416424164341644416454164641647416484164941650416514165241653416544165541656416574165841659416604166141662416634166441665416664166741668416694167041671416724167341674416754167641677416784167941680416814168241683416844168541686416874168841689416904169141692416934169441695416964169741698416994170041701417024170341704417054170641707417084170941710417114171241713417144171541716417174171841719417204172141722417234172441725417264172741728417294173041731417324173341734417354173641737417384173941740417414174241743417444174541746417474174841749417504175141752417534175441755417564175741758417594176041761417624176341764417654176641767417684176941770417714177241773417744177541776417774177841779417804178141782417834178441785417864178741788417894179041791417924179341794417954179641797417984179941800418014180241803418044180541806418074180841809418104181141812418134181441815418164181741818418194182041821418224182341824418254182641827418284182941830418314183241833418344183541836418374183841839418404184141842418434184441845418464184741848418494185041851418524185341854418554185641857418584185941860418614186241863418644186541866418674186841869418704187141872418734187441875418764187741878418794188041881418824188341884418854188641887418884188941890418914189241893418944189541896418974189841899419004190141902419034190441905419064190741908419094191041911419124191341914419154191641917419184191941920419214192241923419244192541926419274192841929419304193141932419334193441935419364193741938419394194041941419424194341944419454194641947419484194941950419514195241953419544195541956419574195841959419604196141962419634196441965419664196741968419694197041971419724197341974419754197641977419784197941980419814198241983419844198541986419874198841989419904199141992419934199441995419964199741998419994200042001420024200342004420054200642007420084200942010420114201242013420144201542016420174201842019420204202142022420234202442025420264202742028420294203042031420324203342034420354203642037420384203942040420414204242043420444204542046420474204842049420504205142052420534205442055420564205742058420594206042061420624206342064420654206642067420684206942070420714207242073420744207542076420774207842079420804208142082420834208442085420864208742088420894209042091420924209342094420954209642097420984209942100421014210242103421044210542106421074210842109421104211142112421134211442115421164211742118421194212042121421224212342124421254212642127421284212942130421314213242133421344213542136421374213842139421404214142142421434214442145421464214742148421494215042151421524215342154421554215642157421584215942160421614216242163421644216542166421674216842169421704217142172421734217442175421764217742178421794218042181421824218342184421854218642187421884218942190421914219242193421944219542196421974219842199422004220142202422034220442205422064220742208422094221042211422124221342214422154221642217422184221942220422214222242223422244222542226422274222842229422304223142232422334223442235422364223742238422394224042241422424224342244422454224642247422484224942250422514225242253422544225542256422574225842259422604226142262422634226442265422664226742268422694227042271422724227342274422754227642277422784227942280422814228242283422844228542286422874228842289422904229142292422934229442295422964229742298422994230042301423024230342304423054230642307423084230942310423114231242313423144231542316423174231842319423204232142322423234232442325423264232742328423294233042331423324233342334423354233642337423384233942340423414234242343423444234542346423474234842349423504235142352423534235442355423564235742358423594236042361423624236342364423654236642367423684236942370423714237242373423744237542376423774237842379423804238142382423834238442385423864238742388423894239042391423924239342394423954239642397423984239942400424014240242403424044240542406424074240842409424104241142412424134241442415424164241742418424194242042421424224242342424424254242642427424284242942430424314243242433424344243542436424374243842439424404244142442424434244442445424464244742448424494245042451424524245342454424554245642457424584245942460424614246242463424644246542466424674246842469424704247142472424734247442475424764247742478424794248042481424824248342484424854248642487424884248942490424914249242493424944249542496424974249842499425004250142502425034250442505425064250742508425094251042511425124251342514425154251642517425184251942520425214252242523425244252542526425274252842529425304253142532425334253442535425364253742538425394254042541425424254342544425454254642547425484254942550425514255242553425544255542556425574255842559425604256142562425634256442565425664256742568425694257042571425724257342574425754257642577425784257942580425814258242583425844258542586425874258842589425904259142592425934259442595425964259742598425994260042601426024260342604426054260642607426084260942610426114261242613426144261542616426174261842619426204262142622426234262442625426264262742628426294263042631426324263342634426354263642637426384263942640426414264242643426444264542646426474264842649426504265142652426534265442655426564265742658426594266042661426624266342664426654266642667426684266942670426714267242673426744267542676426774267842679426804268142682426834268442685426864268742688426894269042691426924269342694426954269642697426984269942700427014270242703427044270542706427074270842709427104271142712427134271442715427164271742718427194272042721427224272342724427254272642727427284272942730427314273242733427344273542736427374273842739427404274142742427434274442745427464274742748427494275042751427524275342754427554275642757427584275942760427614276242763427644276542766427674276842769427704277142772427734277442775427764277742778427794278042781427824278342784427854278642787427884278942790427914279242793427944279542796427974279842799428004280142802428034280442805428064280742808428094281042811428124281342814428154281642817428184281942820428214282242823428244282542826428274282842829428304283142832428334283442835428364283742838428394284042841428424284342844428454284642847428484284942850428514285242853428544285542856428574285842859428604286142862428634286442865428664286742868428694287042871428724287342874428754287642877428784287942880428814288242883428844288542886428874288842889428904289142892428934289442895428964289742898428994290042901429024290342904429054290642907429084290942910429114291242913429144291542916429174291842919429204292142922429234292442925429264292742928429294293042931429324293342934429354293642937429384293942940429414294242943429444294542946429474294842949429504295142952429534295442955429564295742958429594296042961429624296342964429654296642967429684296942970429714297242973429744297542976429774297842979429804298142982429834298442985429864298742988429894299042991429924299342994429954299642997429984299943000430014300243003430044300543006430074300843009430104301143012430134301443015430164301743018430194302043021430224302343024430254302643027430284302943030430314303243033430344303543036430374303843039430404304143042430434304443045430464304743048430494305043051430524305343054430554305643057430584305943060430614306243063430644306543066430674306843069430704307143072430734307443075430764307743078430794308043081430824308343084430854308643087430884308943090430914309243093430944309543096430974309843099431004310143102431034310443105431064310743108431094311043111431124311343114431154311643117431184311943120431214312243123431244312543126431274312843129431304313143132431334313443135431364313743138431394314043141431424314343144431454314643147431484314943150431514315243153431544315543156431574315843159431604316143162431634316443165431664316743168431694317043171431724317343174431754317643177431784317943180431814318243183431844318543186431874318843189431904319143192431934319443195431964319743198431994320043201432024320343204432054320643207432084320943210432114321243213432144321543216432174321843219432204322143222432234322443225432264322743228432294323043231432324323343234432354323643237432384323943240432414324243243432444324543246432474324843249432504325143252432534325443255432564325743258432594326043261432624326343264432654326643267432684326943270432714327243273432744327543276432774327843279432804328143282432834328443285432864328743288432894329043291432924329343294432954329643297432984329943300433014330243303433044330543306433074330843309433104331143312433134331443315433164331743318433194332043321433224332343324433254332643327433284332943330433314333243333433344333543336433374333843339433404334143342433434334443345433464334743348433494335043351433524335343354433554335643357433584335943360433614336243363433644336543366433674336843369433704337143372433734337443375433764337743378433794338043381433824338343384433854338643387433884338943390433914339243393433944339543396433974339843399434004340143402434034340443405434064340743408434094341043411434124341343414434154341643417434184341943420434214342243423434244342543426434274342843429434304343143432434334343443435434364343743438434394344043441434424344343444434454344643447434484344943450434514345243453434544345543456434574345843459434604346143462434634346443465434664346743468434694347043471434724347343474434754347643477434784347943480434814348243483434844348543486434874348843489434904349143492434934349443495434964349743498434994350043501435024350343504435054350643507435084350943510435114351243513435144351543516435174351843519435204352143522435234352443525435264352743528435294353043531435324353343534435354353643537435384353943540435414354243543435444354543546435474354843549435504355143552435534355443555435564355743558435594356043561435624356343564435654356643567435684356943570435714357243573435744357543576435774357843579435804358143582435834358443585435864358743588435894359043591435924359343594435954359643597435984359943600436014360243603436044360543606436074360843609436104361143612436134361443615436164361743618436194362043621436224362343624436254362643627436284362943630436314363243633436344363543636436374363843639436404364143642436434364443645436464364743648436494365043651436524365343654436554365643657436584365943660436614366243663436644366543666436674366843669436704367143672436734367443675436764367743678436794368043681436824368343684436854368643687436884368943690436914369243693436944369543696436974369843699437004370143702437034370443705437064370743708437094371043711437124371343714437154371643717437184371943720437214372243723437244372543726437274372843729437304373143732437334373443735437364373743738437394374043741437424374343744437454374643747437484374943750437514375243753437544375543756437574375843759437604376143762437634376443765437664376743768437694377043771437724377343774437754377643777437784377943780437814378243783437844378543786437874378843789437904379143792437934379443795437964379743798437994380043801438024380343804438054380643807438084380943810438114381243813438144381543816438174381843819438204382143822438234382443825438264382743828438294383043831438324383343834438354383643837438384383943840438414384243843438444384543846438474384843849438504385143852438534385443855438564385743858438594386043861438624386343864438654386643867438684386943870438714387243873438744387543876438774387843879438804388143882438834388443885438864388743888438894389043891438924389343894438954389643897438984389943900439014390243903439044390543906439074390843909439104391143912439134391443915439164391743918439194392043921439224392343924439254392643927439284392943930439314393243933439344393543936439374393843939439404394143942439434394443945439464394743948439494395043951439524395343954439554395643957439584395943960439614396243963439644396543966439674396843969439704397143972439734397443975439764397743978439794398043981439824398343984439854398643987439884398943990439914399243993439944399543996439974399843999440004400144002440034400444005440064400744008440094401044011440124401344014440154401644017440184401944020440214402244023440244402544026440274402844029440304403144032440334403444035440364403744038440394404044041440424404344044440454404644047440484404944050440514405244053440544405544056440574405844059440604406144062440634406444065440664406744068440694407044071440724407344074440754407644077440784407944080440814408244083440844408544086440874408844089440904409144092440934409444095440964409744098440994410044101441024410344104441054410644107441084410944110441114411244113441144411544116441174411844119441204412144122441234412444125441264412744128441294413044131441324413344134441354413644137441384413944140441414414244143441444414544146441474414844149441504415144152441534415444155441564415744158441594416044161441624416344164441654416644167441684416944170441714417244173441744417544176441774417844179441804418144182441834418444185441864418744188441894419044191441924419344194441954419644197441984419944200442014420244203442044420544206442074420844209442104421144212442134421444215442164421744218442194422044221442224422344224442254422644227442284422944230442314423244233442344423544236442374423844239442404424144242442434424444245442464424744248442494425044251442524425344254442554425644257442584425944260442614426244263442644426544266442674426844269442704427144272442734427444275442764427744278442794428044281442824428344284442854428644287442884428944290442914429244293442944429544296442974429844299443004430144302443034430444305443064430744308443094431044311443124431344314443154431644317443184431944320443214432244323443244432544326443274432844329443304433144332443334433444335443364433744338443394434044341443424434344344443454434644347443484434944350443514435244353443544435544356443574435844359443604436144362443634436444365443664436744368443694437044371443724437344374443754437644377443784437944380443814438244383443844438544386443874438844389443904439144392443934439444395443964439744398443994440044401444024440344404444054440644407444084440944410444114441244413444144441544416444174441844419444204442144422444234442444425444264442744428444294443044431444324443344434444354443644437444384443944440444414444244443444444444544446444474444844449444504445144452444534445444455444564445744458444594446044461444624446344464444654446644467444684446944470444714447244473444744447544476444774447844479444804448144482444834448444485444864448744488444894449044491444924449344494444954449644497444984449944500445014450244503445044450544506445074450844509445104451144512445134451444515445164451744518445194452044521445224452344524445254452644527445284452944530445314453244533445344453544536445374453844539445404454144542445434454444545445464454744548445494455044551445524455344554445554455644557445584455944560445614456244563445644456544566445674456844569445704457144572445734457444575445764457744578445794458044581445824458344584445854458644587445884458944590445914459244593445944459544596445974459844599446004460144602446034460444605446064460744608446094461044611446124461344614446154461644617446184461944620446214462244623446244462544626446274462844629446304463144632446334463444635446364463744638446394464044641446424464344644446454464644647446484464944650446514465244653446544465544656446574465844659446604466144662446634466444665446664466744668446694467044671446724467344674446754467644677446784467944680446814468244683446844468544686446874468844689446904469144692446934469444695446964469744698446994470044701447024470344704447054470644707447084470944710447114471244713447144471544716447174471844719447204472144722447234472444725447264472744728447294473044731447324473344734447354473644737447384473944740447414474244743447444474544746447474474844749447504475144752447534475444755447564475744758447594476044761447624476344764447654476644767447684476944770447714477244773447744477544776447774477844779447804478144782447834478444785447864478744788447894479044791447924479344794447954479644797447984479944800448014480244803448044480544806448074480844809448104481144812448134481444815448164481744818448194482044821448224482344824448254482644827448284482944830448314483244833448344483544836448374483844839448404484144842448434484444845448464484744848448494485044851448524485344854448554485644857448584485944860448614486244863448644486544866448674486844869448704487144872448734487444875448764487744878448794488044881448824488344884448854488644887448884488944890448914489244893448944489544896448974489844899449004490144902449034490444905449064490744908449094491044911449124491344914449154491644917449184491944920449214492244923449244492544926449274492844929449304493144932449334493444935449364493744938449394494044941449424494344944449454494644947449484494944950449514495244953449544495544956449574495844959449604496144962449634496444965449664496744968449694497044971449724497344974449754497644977449784497944980449814498244983449844498544986449874498844989449904499144992449934499444995449964499744998449994500045001450024500345004450054500645007450084500945010450114501245013450144501545016450174501845019450204502145022450234502445025450264502745028450294503045031450324503345034450354503645037450384503945040450414504245043450444504545046450474504845049450504505145052450534505445055450564505745058450594506045061450624506345064450654506645067450684506945070450714507245073450744507545076450774507845079450804508145082450834508445085450864508745088450894509045091450924509345094450954509645097450984509945100451014510245103451044510545106451074510845109451104511145112451134511445115451164511745118451194512045121451224512345124451254512645127451284512945130451314513245133451344513545136451374513845139451404514145142451434514445145451464514745148451494515045151451524515345154451554515645157451584515945160451614516245163451644516545166451674516845169451704517145172451734517445175451764517745178451794518045181451824518345184451854518645187451884518945190451914519245193451944519545196451974519845199452004520145202452034520445205452064520745208452094521045211452124521345214452154521645217452184521945220452214522245223452244522545226452274522845229452304523145232452334523445235452364523745238452394524045241452424524345244452454524645247452484524945250452514525245253452544525545256452574525845259452604526145262452634526445265452664526745268452694527045271452724527345274452754527645277452784527945280452814528245283452844528545286452874528845289452904529145292452934529445295452964529745298452994530045301453024530345304453054530645307453084530945310453114531245313453144531545316453174531845319453204532145322453234532445325453264532745328453294533045331453324533345334453354533645337453384533945340453414534245343453444534545346453474534845349453504535145352453534535445355453564535745358453594536045361453624536345364453654536645367453684536945370453714537245373453744537545376453774537845379453804538145382453834538445385453864538745388453894539045391453924539345394453954539645397453984539945400454014540245403454044540545406454074540845409454104541145412454134541445415454164541745418454194542045421454224542345424454254542645427454284542945430454314543245433454344543545436454374543845439454404544145442454434544445445454464544745448454494545045451454524545345454454554545645457454584545945460454614546245463454644546545466454674546845469454704547145472454734547445475454764547745478454794548045481454824548345484454854548645487454884548945490454914549245493454944549545496454974549845499455004550145502455034550445505455064550745508455094551045511455124551345514455154551645517455184551945520455214552245523455244552545526455274552845529455304553145532455334553445535455364553745538455394554045541455424554345544455454554645547455484554945550455514555245553455544555545556455574555845559455604556145562455634556445565455664556745568455694557045571455724557345574455754557645577455784557945580455814558245583455844558545586455874558845589455904559145592455934559445595455964559745598455994560045601456024560345604456054560645607456084560945610456114561245613456144561545616456174561845619456204562145622456234562445625456264562745628456294563045631456324563345634456354563645637456384563945640456414564245643456444564545646456474564845649456504565145652456534565445655456564565745658456594566045661456624566345664456654566645667456684566945670456714567245673456744567545676456774567845679456804568145682456834568445685456864568745688456894569045691456924569345694456954569645697456984569945700457014570245703457044570545706457074570845709457104571145712457134571445715457164571745718457194572045721457224572345724457254572645727457284572945730457314573245733457344573545736457374573845739457404574145742457434574445745457464574745748457494575045751457524575345754457554575645757457584575945760457614576245763457644576545766457674576845769457704577145772457734577445775457764577745778457794578045781457824578345784457854578645787457884578945790457914579245793457944579545796457974579845799458004580145802458034580445805458064580745808458094581045811458124581345814458154581645817458184581945820458214582245823458244582545826458274582845829458304583145832458334583445835458364583745838458394584045841458424584345844458454584645847458484584945850458514585245853458544585545856458574585845859458604586145862458634586445865458664586745868458694587045871458724587345874458754587645877458784587945880458814588245883458844588545886458874588845889458904589145892458934589445895458964589745898458994590045901459024590345904459054590645907459084590945910459114591245913459144591545916459174591845919459204592145922459234592445925459264592745928459294593045931459324593345934459354593645937459384593945940459414594245943459444594545946459474594845949459504595145952459534595445955459564595745958459594596045961459624596345964459654596645967459684596945970459714597245973459744597545976459774597845979459804598145982459834598445985459864598745988459894599045991459924599345994459954599645997459984599946000460014600246003460044600546006460074600846009460104601146012460134601446015460164601746018460194602046021460224602346024460254602646027460284602946030460314603246033460344603546036460374603846039460404604146042460434604446045460464604746048460494605046051460524605346054460554605646057460584605946060460614606246063460644606546066460674606846069460704607146072460734607446075460764607746078460794608046081460824608346084460854608646087460884608946090460914609246093460944609546096460974609846099461004610146102461034610446105461064610746108461094611046111461124611346114461154611646117461184611946120461214612246123461244612546126461274612846129461304613146132461334613446135461364613746138461394614046141461424614346144461454614646147461484614946150461514615246153461544615546156461574615846159461604616146162461634616446165461664616746168461694617046171461724617346174461754617646177461784617946180461814618246183461844618546186461874618846189461904619146192461934619446195461964619746198461994620046201462024620346204462054620646207462084620946210462114621246213462144621546216462174621846219462204622146222462234622446225462264622746228462294623046231462324623346234462354623646237462384623946240462414624246243462444624546246462474624846249462504625146252462534625446255462564625746258462594626046261462624626346264462654626646267462684626946270462714627246273462744627546276462774627846279462804628146282462834628446285462864628746288462894629046291462924629346294462954629646297462984629946300463014630246303463044630546306463074630846309463104631146312463134631446315463164631746318463194632046321463224632346324463254632646327463284632946330463314633246333463344633546336463374633846339463404634146342463434634446345463464634746348463494635046351463524635346354463554635646357463584635946360463614636246363463644636546366463674636846369463704637146372463734637446375463764637746378463794638046381463824638346384463854638646387463884638946390463914639246393463944639546396463974639846399464004640146402464034640446405464064640746408464094641046411464124641346414464154641646417464184641946420464214642246423464244642546426464274642846429464304643146432464334643446435464364643746438464394644046441464424644346444464454644646447464484644946450464514645246453464544645546456464574645846459464604646146462464634646446465464664646746468464694647046471464724647346474464754647646477464784647946480464814648246483464844648546486464874648846489464904649146492464934649446495464964649746498464994650046501465024650346504465054650646507465084650946510465114651246513465144651546516465174651846519465204652146522465234652446525465264652746528465294653046531465324653346534465354653646537465384653946540465414654246543465444654546546465474654846549465504655146552465534655446555465564655746558465594656046561465624656346564465654656646567465684656946570465714657246573465744657546576465774657846579465804658146582465834658446585465864658746588465894659046591465924659346594465954659646597465984659946600466014660246603466044660546606466074660846609466104661146612466134661446615466164661746618466194662046621466224662346624466254662646627466284662946630466314663246633466344663546636466374663846639466404664146642466434664446645466464664746648466494665046651466524665346654466554665646657466584665946660466614666246663466644666546666466674666846669466704667146672466734667446675466764667746678466794668046681466824668346684466854668646687466884668946690466914669246693466944669546696466974669846699467004670146702467034670446705467064670746708467094671046711467124671346714467154671646717467184671946720467214672246723467244672546726467274672846729467304673146732467334673446735467364673746738467394674046741467424674346744467454674646747467484674946750467514675246753467544675546756467574675846759467604676146762467634676446765467664676746768467694677046771467724677346774467754677646777467784677946780467814678246783467844678546786467874678846789467904679146792467934679446795467964679746798467994680046801468024680346804468054680646807468084680946810468114681246813468144681546816468174681846819468204682146822468234682446825468264682746828468294683046831468324683346834468354683646837468384683946840468414684246843468444684546846468474684846849468504685146852468534685446855468564685746858468594686046861468624686346864468654686646867468684686946870468714687246873468744687546876468774687846879468804688146882468834688446885468864688746888468894689046891468924689346894468954689646897468984689946900469014690246903469044690546906469074690846909469104691146912469134691446915469164691746918469194692046921469224692346924469254692646927469284692946930469314693246933469344693546936469374693846939469404694146942469434694446945469464694746948469494695046951469524695346954469554695646957469584695946960469614696246963469644696546966469674696846969469704697146972469734697446975469764697746978469794698046981469824698346984469854698646987469884698946990469914699246993469944699546996469974699846999470004700147002470034700447005470064700747008470094701047011470124701347014470154701647017470184701947020470214702247023470244702547026470274702847029470304703147032470334703447035470364703747038470394704047041470424704347044470454704647047470484704947050470514705247053470544705547056470574705847059470604706147062470634706447065470664706747068470694707047071470724707347074470754707647077470784707947080470814708247083470844708547086470874708847089470904709147092470934709447095470964709747098470994710047101471024710347104471054710647107471084710947110471114711247113471144711547116471174711847119471204712147122471234712447125471264712747128471294713047131471324713347134471354713647137471384713947140471414714247143471444714547146471474714847149471504715147152471534715447155471564715747158471594716047161471624716347164471654716647167471684716947170471714717247173471744717547176471774717847179471804718147182471834718447185471864718747188471894719047191471924719347194471954719647197471984719947200472014720247203472044720547206472074720847209472104721147212472134721447215472164721747218472194722047221472224722347224472254722647227472284722947230472314723247233472344723547236472374723847239472404724147242472434724447245472464724747248472494725047251472524725347254472554725647257472584725947260472614726247263472644726547266472674726847269472704727147272472734727447275472764727747278472794728047281472824728347284472854728647287472884728947290472914729247293472944729547296472974729847299473004730147302473034730447305473064730747308473094731047311473124731347314473154731647317473184731947320473214732247323473244732547326473274732847329473304733147332473334733447335473364733747338473394734047341473424734347344473454734647347473484734947350473514735247353473544735547356473574735847359473604736147362473634736447365473664736747368473694737047371473724737347374473754737647377473784737947380473814738247383473844738547386473874738847389473904739147392473934739447395473964739747398473994740047401474024740347404474054740647407474084740947410474114741247413474144741547416474174741847419474204742147422474234742447425474264742747428474294743047431474324743347434474354743647437474384743947440474414744247443474444744547446474474744847449474504745147452474534745447455474564745747458474594746047461474624746347464474654746647467474684746947470474714747247473474744747547476474774747847479474804748147482474834748447485474864748747488474894749047491474924749347494474954749647497474984749947500475014750247503475044750547506475074750847509475104751147512475134751447515475164751747518475194752047521475224752347524475254752647527475284752947530475314753247533475344753547536475374753847539475404754147542475434754447545475464754747548475494755047551475524755347554475554755647557475584755947560475614756247563475644756547566475674756847569475704757147572475734757447575475764757747578475794758047581475824758347584475854758647587475884758947590475914759247593475944759547596475974759847599476004760147602476034760447605476064760747608476094761047611476124761347614476154761647617476184761947620476214762247623476244762547626476274762847629476304763147632476334763447635476364763747638476394764047641476424764347644476454764647647476484764947650476514765247653476544765547656476574765847659476604766147662476634766447665476664766747668476694767047671476724767347674476754767647677476784767947680476814768247683476844768547686476874768847689476904769147692476934769447695476964769747698476994770047701477024770347704477054770647707477084770947710477114771247713477144771547716477174771847719477204772147722477234772447725477264772747728477294773047731477324773347734477354773647737477384773947740477414774247743477444774547746477474774847749477504775147752477534775447755477564775747758477594776047761477624776347764477654776647767477684776947770477714777247773477744777547776477774777847779477804778147782477834778447785477864778747788477894779047791477924779347794477954779647797477984779947800478014780247803478044780547806478074780847809478104781147812478134781447815478164781747818478194782047821478224782347824478254782647827478284782947830478314783247833478344783547836478374783847839478404784147842478434784447845478464784747848478494785047851478524785347854478554785647857478584785947860478614786247863478644786547866478674786847869478704787147872478734787447875478764787747878478794788047881478824788347884478854788647887478884788947890478914789247893478944789547896478974789847899479004790147902479034790447905479064790747908479094791047911479124791347914479154791647917479184791947920479214792247923479244792547926479274792847929479304793147932479334793447935479364793747938479394794047941479424794347944479454794647947479484794947950479514795247953479544795547956479574795847959479604796147962479634796447965479664796747968479694797047971479724797347974479754797647977479784797947980479814798247983479844798547986479874798847989479904799147992479934799447995479964799747998479994800048001480024800348004480054800648007480084800948010480114801248013480144801548016480174801848019480204802148022480234802448025480264802748028480294803048031480324803348034480354803648037480384803948040480414804248043480444804548046480474804848049480504805148052480534805448055480564805748058480594806048061480624806348064480654806648067480684806948070480714807248073480744807548076480774807848079480804808148082480834808448085480864808748088480894809048091480924809348094480954809648097480984809948100481014810248103481044810548106481074810848109481104811148112481134811448115481164811748118481194812048121481224812348124481254812648127481284812948130481314813248133481344813548136481374813848139481404814148142481434814448145481464814748148481494815048151481524815348154481554815648157481584815948160481614816248163481644816548166481674816848169481704817148172481734817448175481764817748178481794818048181481824818348184481854818648187481884818948190481914819248193481944819548196481974819848199482004820148202482034820448205482064820748208482094821048211482124821348214482154821648217482184821948220482214822248223482244822548226482274822848229482304823148232482334823448235482364823748238482394824048241482424824348244482454824648247482484824948250482514825248253482544825548256482574825848259482604826148262482634826448265482664826748268482694827048271482724827348274482754827648277482784827948280482814828248283482844828548286482874828848289482904829148292482934829448295482964829748298482994830048301483024830348304483054830648307483084830948310483114831248313483144831548316483174831848319483204832148322483234832448325483264832748328483294833048331483324833348334483354833648337483384833948340483414834248343483444834548346483474834848349483504835148352483534835448355483564835748358483594836048361483624836348364483654836648367483684836948370483714837248373483744837548376483774837848379483804838148382483834838448385483864838748388483894839048391483924839348394483954839648397483984839948400484014840248403484044840548406484074840848409484104841148412484134841448415484164841748418484194842048421484224842348424484254842648427484284842948430484314843248433484344843548436484374843848439484404844148442484434844448445484464844748448484494845048451484524845348454484554845648457484584845948460484614846248463484644846548466484674846848469484704847148472484734847448475484764847748478484794848048481484824848348484484854848648487484884848948490484914849248493484944849548496484974849848499485004850148502485034850448505485064850748508485094851048511485124851348514485154851648517485184851948520485214852248523485244852548526485274852848529485304853148532485334853448535485364853748538485394854048541485424854348544485454854648547485484854948550485514855248553485544855548556485574855848559485604856148562485634856448565485664856748568485694857048571485724857348574485754857648577485784857948580485814858248583485844858548586485874858848589485904859148592485934859448595485964859748598485994860048601486024860348604486054860648607486084860948610486114861248613486144861548616486174861848619486204862148622486234862448625486264862748628486294863048631486324863348634486354863648637486384863948640486414864248643486444864548646486474864848649486504865148652486534865448655486564865748658486594866048661486624866348664486654866648667486684866948670486714867248673486744867548676486774867848679486804868148682486834868448685486864868748688486894869048691486924869348694486954869648697486984869948700487014870248703487044870548706487074870848709487104871148712487134871448715487164871748718487194872048721487224872348724487254872648727487284872948730487314873248733487344873548736487374873848739487404874148742487434874448745487464874748748487494875048751487524875348754487554875648757487584875948760487614876248763487644876548766487674876848769487704877148772487734877448775487764877748778487794878048781487824878348784487854878648787487884878948790487914879248793487944879548796487974879848799488004880148802488034880448805488064880748808488094881048811488124881348814488154881648817488184881948820488214882248823488244882548826488274882848829488304883148832488334883448835488364883748838488394884048841488424884348844488454884648847488484884948850488514885248853488544885548856488574885848859488604886148862488634886448865488664886748868488694887048871488724887348874488754887648877488784887948880488814888248883488844888548886488874888848889488904889148892488934889448895488964889748898488994890048901489024890348904489054890648907489084890948910489114891248913489144891548916489174891848919489204892148922489234892448925489264892748928489294893048931489324893348934489354893648937489384893948940489414894248943489444894548946489474894848949489504895148952489534895448955489564895748958489594896048961489624896348964489654896648967489684896948970489714897248973489744897548976489774897848979489804898148982489834898448985489864898748988489894899048991489924899348994489954899648997489984899949000490014900249003490044900549006490074900849009490104901149012490134901449015490164901749018490194902049021490224902349024490254902649027490284902949030490314903249033490344903549036490374903849039490404904149042490434904449045490464904749048490494905049051490524905349054490554905649057490584905949060490614906249063490644906549066490674906849069490704907149072490734907449075490764907749078490794908049081490824908349084490854908649087490884908949090490914909249093490944909549096490974909849099491004910149102491034910449105491064910749108491094911049111491124911349114491154911649117491184911949120491214912249123491244912549126491274912849129491304913149132491334913449135491364913749138491394914049141491424914349144491454914649147491484914949150491514915249153491544915549156491574915849159491604916149162491634916449165491664916749168491694917049171491724917349174491754917649177491784917949180491814918249183491844918549186491874918849189491904919149192491934919449195491964919749198491994920049201492024920349204492054920649207492084920949210492114921249213492144921549216492174921849219492204922149222492234922449225492264922749228492294923049231492324923349234492354923649237492384923949240492414924249243492444924549246492474924849249492504925149252492534925449255492564925749258492594926049261492624926349264492654926649267492684926949270492714927249273492744927549276492774927849279492804928149282492834928449285492864928749288492894929049291492924929349294492954929649297492984929949300493014930249303493044930549306493074930849309493104931149312493134931449315493164931749318493194932049321493224932349324493254932649327493284932949330493314933249333493344933549336493374933849339493404934149342493434934449345493464934749348493494935049351493524935349354493554935649357493584935949360493614936249363493644936549366493674936849369493704937149372493734937449375493764937749378493794938049381493824938349384493854938649387493884938949390493914939249393493944939549396493974939849399494004940149402494034940449405494064940749408494094941049411494124941349414494154941649417494184941949420494214942249423494244942549426494274942849429494304943149432494334943449435494364943749438494394944049441494424944349444494454944649447494484944949450494514945249453494544945549456494574945849459494604946149462494634946449465494664946749468494694947049471494724947349474494754947649477494784947949480494814948249483494844948549486494874948849489494904949149492494934949449495494964949749498494994950049501495024950349504495054950649507495084950949510495114951249513495144951549516495174951849519495204952149522495234952449525495264952749528495294953049531495324953349534495354953649537495384953949540495414954249543495444954549546495474954849549495504955149552495534955449555495564955749558495594956049561495624956349564495654956649567495684956949570495714957249573495744957549576495774957849579495804958149582495834958449585495864958749588495894959049591495924959349594495954959649597495984959949600496014960249603496044960549606496074960849609496104961149612496134961449615496164961749618496194962049621496224962349624496254962649627496284962949630496314963249633496344963549636496374963849639496404964149642496434964449645496464964749648496494965049651496524965349654496554965649657496584965949660496614966249663496644966549666496674966849669496704967149672496734967449675496764967749678496794968049681496824968349684496854968649687496884968949690496914969249693496944969549696496974969849699497004970149702497034970449705497064970749708497094971049711497124971349714497154971649717497184971949720497214972249723497244972549726497274972849729497304973149732497334973449735497364973749738497394974049741497424974349744497454974649747497484974949750497514975249753497544975549756497574975849759497604976149762497634976449765497664976749768497694977049771497724977349774497754977649777497784977949780497814978249783497844978549786497874978849789497904979149792497934979449795497964979749798497994980049801498024980349804498054980649807498084980949810498114981249813498144981549816498174981849819498204982149822498234982449825498264982749828498294983049831498324983349834498354983649837498384983949840498414984249843498444984549846498474984849849498504985149852498534985449855498564985749858498594986049861498624986349864498654986649867498684986949870498714987249873498744987549876498774987849879498804988149882498834988449885498864988749888498894989049891498924989349894498954989649897498984989949900499014990249903499044990549906499074990849909499104991149912499134991449915499164991749918499194992049921499224992349924499254992649927499284992949930499314993249933499344993549936499374993849939499404994149942499434994449945499464994749948499494995049951499524995349954499554995649957499584995949960499614996249963499644996549966499674996849969499704997149972499734997449975499764997749978499794998049981499824998349984499854998649987499884998949990499914999249993499944999549996499974999849999500005000150002500035000450005500065000750008500095001050011500125001350014500155001650017500185001950020500215002250023500245002550026500275002850029500305003150032500335003450035500365003750038500395004050041500425004350044500455004650047500485004950050500515005250053500545005550056500575005850059500605006150062500635006450065500665006750068500695007050071500725007350074500755007650077500785007950080500815008250083500845008550086500875008850089500905009150092500935009450095500965009750098500995010050101501025010350104501055010650107501085010950110501115011250113501145011550116501175011850119501205012150122501235012450125501265012750128501295013050131501325013350134501355013650137501385013950140501415014250143501445014550146501475014850149501505015150152501535015450155501565015750158501595016050161501625016350164501655016650167501685016950170501715017250173501745017550176501775017850179501805018150182501835018450185501865018750188501895019050191501925019350194501955019650197501985019950200502015020250203502045020550206502075020850209502105021150212502135021450215502165021750218502195022050221502225022350224502255022650227502285022950230502315023250233502345023550236502375023850239502405024150242502435024450245502465024750248502495025050251502525025350254502555025650257502585025950260502615026250263502645026550266502675026850269502705027150272502735027450275502765027750278502795028050281502825028350284502855028650287502885028950290502915029250293502945029550296502975029850299503005030150302503035030450305503065030750308503095031050311503125031350314503155031650317503185031950320503215032250323503245032550326503275032850329503305033150332503335033450335503365033750338503395034050341503425034350344503455034650347503485034950350503515035250353503545035550356503575035850359503605036150362503635036450365503665036750368503695037050371503725037350374503755037650377503785037950380503815038250383503845038550386503875038850389503905039150392503935039450395503965039750398503995040050401504025040350404504055040650407504085040950410504115041250413504145041550416504175041850419504205042150422504235042450425504265042750428504295043050431504325043350434504355043650437504385043950440504415044250443504445044550446504475044850449504505045150452504535045450455504565045750458504595046050461504625046350464504655046650467504685046950470504715047250473504745047550476504775047850479504805048150482504835048450485504865048750488504895049050491504925049350494504955049650497504985049950500505015050250503505045050550506505075050850509505105051150512505135051450515505165051750518505195052050521505225052350524505255052650527505285052950530505315053250533505345053550536505375053850539505405054150542505435054450545505465054750548505495055050551505525055350554505555055650557505585055950560505615056250563505645056550566505675056850569505705057150572505735057450575505765057750578505795058050581505825058350584505855058650587505885058950590505915059250593505945059550596505975059850599506005060150602506035060450605506065060750608506095061050611506125061350614506155061650617506185061950620506215062250623506245062550626506275062850629506305063150632506335063450635506365063750638506395064050641506425064350644506455064650647506485064950650506515065250653506545065550656506575065850659506605066150662506635066450665506665066750668506695067050671506725067350674506755067650677506785067950680506815068250683506845068550686506875068850689506905069150692506935069450695506965069750698506995070050701507025070350704507055070650707507085070950710507115071250713507145071550716507175071850719507205072150722507235072450725507265072750728507295073050731507325073350734507355073650737507385073950740507415074250743507445074550746507475074850749507505075150752507535075450755507565075750758507595076050761507625076350764507655076650767507685076950770507715077250773507745077550776507775077850779507805078150782507835078450785507865078750788507895079050791507925079350794507955079650797507985079950800508015080250803508045080550806508075080850809508105081150812508135081450815508165081750818508195082050821508225082350824508255082650827508285082950830508315083250833508345083550836508375083850839508405084150842508435084450845508465084750848508495085050851508525085350854508555085650857508585085950860508615086250863508645086550866508675086850869508705087150872508735087450875508765087750878508795088050881508825088350884508855088650887508885088950890508915089250893508945089550896508975089850899509005090150902509035090450905509065090750908509095091050911509125091350914509155091650917509185091950920509215092250923509245092550926509275092850929509305093150932509335093450935509365093750938509395094050941509425094350944509455094650947509485094950950509515095250953509545095550956509575095850959509605096150962509635096450965509665096750968509695097050971509725097350974509755097650977509785097950980509815098250983509845098550986509875098850989509905099150992509935099450995509965099750998509995100051001510025100351004510055100651007510085100951010510115101251013510145101551016510175101851019510205102151022510235102451025510265102751028510295103051031510325103351034510355103651037510385103951040510415104251043510445104551046510475104851049510505105151052510535105451055510565105751058510595106051061510625106351064510655106651067510685106951070510715107251073510745107551076510775107851079510805108151082510835108451085510865108751088510895109051091510925109351094510955109651097510985109951100511015110251103511045110551106511075110851109511105111151112511135111451115511165111751118511195112051121511225112351124511255112651127511285112951130511315113251133511345113551136511375113851139511405114151142511435114451145511465114751148511495115051151511525115351154511555115651157511585115951160511615116251163511645116551166511675116851169511705117151172511735117451175511765117751178511795118051181511825118351184511855118651187511885118951190511915119251193511945119551196511975119851199512005120151202512035120451205512065120751208512095121051211512125121351214512155121651217512185121951220512215122251223512245122551226512275122851229512305123151232512335123451235512365123751238512395124051241512425124351244512455124651247512485124951250512515125251253512545125551256512575125851259512605126151262512635126451265512665126751268512695127051271512725127351274512755127651277512785127951280512815128251283512845128551286512875128851289512905129151292512935129451295512965129751298512995130051301513025130351304513055130651307513085130951310513115131251313513145131551316513175131851319513205132151322513235132451325513265132751328513295133051331513325133351334513355133651337513385133951340513415134251343513445134551346513475134851349513505135151352513535135451355513565135751358513595136051361513625136351364513655136651367513685136951370513715137251373513745137551376513775137851379513805138151382513835138451385513865138751388513895139051391513925139351394513955139651397513985139951400514015140251403514045140551406514075140851409514105141151412514135141451415514165141751418514195142051421514225142351424514255142651427514285142951430514315143251433514345143551436514375143851439514405144151442514435144451445514465144751448514495145051451514525145351454514555145651457514585145951460514615146251463514645146551466514675146851469514705147151472514735147451475514765147751478514795148051481514825148351484514855148651487514885148951490514915149251493514945149551496514975149851499515005150151502515035150451505515065150751508515095151051511515125151351514515155151651517515185151951520515215152251523515245152551526515275152851529515305153151532515335153451535515365153751538515395154051541515425154351544515455154651547515485154951550515515155251553515545155551556515575155851559515605156151562515635156451565515665156751568515695157051571515725157351574515755157651577515785157951580515815158251583515845158551586515875158851589515905159151592515935159451595515965159751598515995160051601516025160351604516055160651607516085160951610516115161251613516145161551616516175161851619516205162151622516235162451625516265162751628516295163051631516325163351634516355163651637516385163951640516415164251643516445164551646516475164851649516505165151652516535165451655516565165751658516595166051661516625166351664516655166651667516685166951670516715167251673516745167551676516775167851679516805168151682516835168451685516865168751688516895169051691516925169351694516955169651697516985169951700517015170251703517045170551706517075170851709517105171151712517135171451715517165171751718517195172051721517225172351724517255172651727517285172951730517315173251733517345173551736517375173851739517405174151742517435174451745517465174751748517495175051751517525175351754517555175651757517585175951760517615176251763517645176551766517675176851769517705177151772517735177451775517765177751778517795178051781517825178351784517855178651787517885178951790517915179251793517945179551796517975179851799518005180151802518035180451805518065180751808518095181051811518125181351814518155181651817518185181951820518215182251823518245182551826518275182851829518305183151832518335183451835518365183751838518395184051841518425184351844518455184651847518485184951850518515185251853518545185551856518575185851859518605186151862518635186451865518665186751868518695187051871518725187351874518755187651877518785187951880518815188251883518845188551886518875188851889518905189151892518935189451895518965189751898518995190051901519025190351904519055190651907519085190951910519115191251913519145191551916519175191851919519205192151922519235192451925519265192751928519295193051931519325193351934519355193651937519385193951940519415194251943519445194551946519475194851949519505195151952519535195451955519565195751958519595196051961519625196351964519655196651967519685196951970519715197251973519745197551976519775197851979519805198151982519835198451985519865198751988519895199051991519925199351994519955199651997519985199952000520015200252003520045200552006520075200852009520105201152012520135201452015520165201752018520195202052021520225202352024520255202652027520285202952030520315203252033520345203552036520375203852039520405204152042520435204452045520465204752048520495205052051520525205352054520555205652057520585205952060520615206252063520645206552066520675206852069520705207152072520735207452075520765207752078520795208052081520825208352084520855208652087520885208952090520915209252093520945209552096520975209852099521005210152102521035210452105521065210752108521095211052111521125211352114521155211652117521185211952120521215212252123521245212552126521275212852129521305213152132521335213452135521365213752138521395214052141521425214352144521455214652147521485214952150521515215252153521545215552156521575215852159521605216152162521635216452165521665216752168521695217052171521725217352174521755217652177521785217952180521815218252183521845218552186521875218852189521905219152192521935219452195521965219752198521995220052201522025220352204522055220652207522085220952210522115221252213522145221552216522175221852219522205222152222522235222452225522265222752228522295223052231522325223352234522355223652237522385223952240522415224252243522445224552246522475224852249522505225152252522535225452255522565225752258522595226052261522625226352264522655226652267522685226952270522715227252273522745227552276522775227852279522805228152282522835228452285522865228752288522895229052291522925229352294522955229652297522985229952300523015230252303523045230552306523075230852309523105231152312523135231452315523165231752318523195232052321523225232352324523255232652327523285232952330523315233252333523345233552336523375233852339523405234152342523435234452345523465234752348523495235052351523525235352354523555235652357523585235952360523615236252363523645236552366523675236852369523705237152372523735237452375523765237752378523795238052381523825238352384523855238652387523885238952390523915239252393523945239552396523975239852399524005240152402524035240452405524065240752408524095241052411524125241352414524155241652417524185241952420524215242252423524245242552426524275242852429524305243152432524335243452435524365243752438524395244052441524425244352444524455244652447524485244952450524515245252453524545245552456524575245852459524605246152462524635246452465524665246752468524695247052471524725247352474524755247652477524785247952480524815248252483524845248552486524875248852489524905249152492524935249452495524965249752498524995250052501525025250352504525055250652507525085250952510525115251252513525145251552516525175251852519525205252152522525235252452525525265252752528525295253052531525325253352534525355253652537525385253952540525415254252543525445254552546525475254852549525505255152552525535255452555525565255752558525595256052561525625256352564525655256652567525685256952570525715257252573525745257552576525775257852579525805258152582525835258452585525865258752588525895259052591525925259352594525955259652597525985259952600526015260252603526045260552606526075260852609526105261152612526135261452615526165261752618526195262052621526225262352624526255262652627526285262952630526315263252633526345263552636526375263852639526405264152642526435264452645526465264752648526495265052651526525265352654526555265652657526585265952660526615266252663526645266552666526675266852669526705267152672526735267452675526765267752678526795268052681526825268352684526855268652687526885268952690526915269252693526945269552696526975269852699527005270152702527035270452705527065270752708527095271052711527125271352714527155271652717527185271952720527215272252723527245272552726527275272852729527305273152732527335273452735527365273752738527395274052741527425274352744527455274652747527485274952750527515275252753527545275552756527575275852759527605276152762527635276452765527665276752768527695277052771527725277352774527755277652777527785277952780527815278252783527845278552786527875278852789527905279152792527935279452795527965279752798527995280052801528025280352804528055280652807528085280952810528115281252813528145281552816528175281852819528205282152822528235282452825528265282752828528295283052831528325283352834528355283652837528385283952840528415284252843528445284552846528475284852849528505285152852528535285452855528565285752858528595286052861528625286352864528655286652867528685286952870528715287252873528745287552876528775287852879528805288152882528835288452885528865288752888528895289052891528925289352894528955289652897528985289952900529015290252903529045290552906529075290852909529105291152912529135291452915529165291752918529195292052921529225292352924529255292652927529285292952930529315293252933529345293552936529375293852939529405294152942529435294452945529465294752948529495295052951529525295352954529555295652957529585295952960529615296252963529645296552966529675296852969529705297152972529735297452975529765297752978529795298052981529825298352984529855298652987529885298952990529915299252993529945299552996529975299852999530005300153002530035300453005530065300753008530095301053011530125301353014530155301653017530185301953020530215302253023530245302553026530275302853029530305303153032530335303453035530365303753038530395304053041530425304353044530455304653047530485304953050530515305253053530545305553056530575305853059530605306153062530635306453065530665306753068530695307053071530725307353074530755307653077530785307953080530815308253083530845308553086530875308853089530905309153092530935309453095530965309753098530995310053101531025310353104531055310653107531085310953110531115311253113531145311553116531175311853119531205312153122531235312453125531265312753128531295313053131531325313353134531355313653137531385313953140531415314253143531445314553146531475314853149531505315153152531535315453155531565315753158531595316053161531625316353164531655316653167531685316953170531715317253173531745317553176531775317853179531805318153182531835318453185531865318753188531895319053191531925319353194531955319653197531985319953200532015320253203532045320553206532075320853209532105321153212532135321453215532165321753218532195322053221532225322353224532255322653227532285322953230532315323253233532345323553236532375323853239532405324153242532435324453245532465324753248532495325053251532525325353254532555325653257532585325953260532615326253263532645326553266532675326853269532705327153272532735327453275532765327753278532795328053281532825328353284532855328653287532885328953290532915329253293532945329553296532975329853299533005330153302533035330453305533065330753308533095331053311533125331353314533155331653317533185331953320533215332253323533245332553326533275332853329533305333153332533335333453335533365333753338533395334053341533425334353344533455334653347533485334953350533515335253353533545335553356533575335853359533605336153362533635336453365533665336753368533695337053371533725337353374533755337653377533785337953380533815338253383533845338553386533875338853389533905339153392533935339453395533965339753398533995340053401534025340353404534055340653407534085340953410534115341253413534145341553416534175341853419534205342153422534235342453425534265342753428534295343053431534325343353434534355343653437534385343953440534415344253443534445344553446534475344853449534505345153452534535345453455534565345753458534595346053461534625346353464534655346653467534685346953470534715347253473534745347553476534775347853479534805348153482534835348453485534865348753488534895349053491534925349353494534955349653497534985349953500535015350253503535045350553506535075350853509535105351153512535135351453515535165351753518535195352053521535225352353524535255352653527535285352953530535315353253533535345353553536535375353853539535405354153542535435354453545535465354753548535495355053551535525355353554535555355653557535585355953560535615356253563535645356553566535675356853569535705357153572535735357453575535765357753578535795358053581535825358353584535855358653587535885358953590535915359253593535945359553596535975359853599536005360153602536035360453605536065360753608536095361053611536125361353614536155361653617536185361953620536215362253623536245362553626536275362853629536305363153632536335363453635536365363753638536395364053641536425364353644536455364653647536485364953650536515365253653536545365553656536575365853659536605366153662536635366453665536665366753668536695367053671536725367353674536755367653677536785367953680536815368253683536845368553686536875368853689536905369153692536935369453695536965369753698536995370053701537025370353704537055370653707537085370953710537115371253713537145371553716537175371853719537205372153722537235372453725537265372753728537295373053731537325373353734537355373653737537385373953740537415374253743537445374553746537475374853749537505375153752537535375453755537565375753758537595376053761537625376353764537655376653767537685376953770537715377253773537745377553776537775377853779537805378153782537835378453785537865378753788537895379053791537925379353794537955379653797537985379953800538015380253803538045380553806538075380853809538105381153812538135381453815538165381753818538195382053821538225382353824538255382653827538285382953830538315383253833538345383553836538375383853839538405384153842538435384453845538465384753848538495385053851538525385353854538555385653857538585385953860538615386253863538645386553866538675386853869538705387153872538735387453875538765387753878538795388053881538825388353884538855388653887538885388953890538915389253893538945389553896538975389853899539005390153902539035390453905539065390753908539095391053911539125391353914539155391653917539185391953920539215392253923539245392553926539275392853929539305393153932539335393453935539365393753938539395394053941539425394353944539455394653947539485394953950539515395253953539545395553956539575395853959539605396153962539635396453965539665396753968539695397053971539725397353974539755397653977539785397953980539815398253983539845398553986539875398853989539905399153992539935399453995539965399753998539995400054001540025400354004540055400654007540085400954010540115401254013540145401554016540175401854019540205402154022540235402454025540265402754028540295403054031540325403354034540355403654037540385403954040540415404254043540445404554046540475404854049540505405154052540535405454055540565405754058540595406054061540625406354064540655406654067540685406954070540715407254073540745407554076540775407854079540805408154082540835408454085540865408754088540895409054091540925409354094540955409654097540985409954100541015410254103541045410554106541075410854109541105411154112541135411454115541165411754118541195412054121541225412354124541255412654127541285412954130541315413254133541345413554136541375413854139541405414154142541435414454145541465414754148541495415054151541525415354154541555415654157541585415954160541615416254163541645416554166541675416854169541705417154172541735417454175541765417754178541795418054181541825418354184541855418654187541885418954190541915419254193541945419554196541975419854199542005420154202542035420454205542065420754208542095421054211542125421354214542155421654217542185421954220542215422254223542245422554226542275422854229542305423154232542335423454235542365423754238542395424054241542425424354244542455424654247542485424954250542515425254253542545425554256542575425854259542605426154262542635426454265542665426754268542695427054271542725427354274542755427654277542785427954280542815428254283542845428554286542875428854289542905429154292542935429454295542965429754298542995430054301543025430354304543055430654307543085430954310543115431254313543145431554316543175431854319543205432154322543235432454325543265432754328543295433054331543325433354334543355433654337543385433954340543415434254343543445434554346543475434854349543505435154352543535435454355543565435754358543595436054361543625436354364543655436654367543685436954370543715437254373543745437554376543775437854379543805438154382543835438454385543865438754388543895439054391543925439354394543955439654397543985439954400544015440254403544045440554406544075440854409544105441154412544135441454415544165441754418544195442054421544225442354424544255442654427544285442954430544315443254433544345443554436544375443854439544405444154442544435444454445544465444754448544495445054451544525445354454544555445654457544585445954460544615446254463544645446554466544675446854469544705447154472544735447454475544765447754478544795448054481544825448354484544855448654487544885448954490544915449254493544945449554496544975449854499545005450154502545035450454505545065450754508545095451054511545125451354514545155451654517545185451954520545215452254523545245452554526545275452854529545305453154532545335453454535545365453754538545395454054541545425454354544545455454654547545485454954550545515455254553545545455554556545575455854559545605456154562545635456454565545665456754568545695457054571545725457354574545755457654577545785457954580545815458254583545845458554586545875458854589545905459154592545935459454595545965459754598545995460054601546025460354604546055460654607546085460954610546115461254613546145461554616546175461854619546205462154622546235462454625546265462754628546295463054631546325463354634546355463654637546385463954640546415464254643546445464554646546475464854649546505465154652546535465454655546565465754658546595466054661546625466354664546655466654667546685466954670546715467254673546745467554676546775467854679546805468154682546835468454685546865468754688546895469054691546925469354694546955469654697546985469954700547015470254703547045470554706547075470854709547105471154712547135471454715547165471754718547195472054721547225472354724547255472654727547285472954730547315473254733547345473554736547375473854739547405474154742547435474454745547465474754748547495475054751547525475354754547555475654757547585475954760547615476254763547645476554766547675476854769547705477154772547735477454775547765477754778547795478054781547825478354784547855478654787547885478954790547915479254793547945479554796547975479854799548005480154802548035480454805548065480754808548095481054811548125481354814548155481654817548185481954820548215482254823548245482554826548275482854829548305483154832548335483454835548365483754838548395484054841548425484354844548455484654847548485484954850548515485254853548545485554856548575485854859548605486154862548635486454865548665486754868548695487054871548725487354874548755487654877548785487954880548815488254883548845488554886548875488854889548905489154892548935489454895548965489754898548995490054901549025490354904549055490654907549085490954910549115491254913549145491554916549175491854919549205492154922549235492454925549265492754928549295493054931549325493354934549355493654937549385493954940549415494254943549445494554946549475494854949549505495154952549535495454955549565495754958549595496054961549625496354964549655496654967549685496954970549715497254973549745497554976549775497854979549805498154982549835498454985549865498754988549895499054991549925499354994549955499654997549985499955000550015500255003550045500555006550075500855009550105501155012550135501455015550165501755018550195502055021550225502355024550255502655027550285502955030550315503255033550345503555036550375503855039550405504155042550435504455045550465504755048550495505055051550525505355054550555505655057550585505955060550615506255063550645506555066550675506855069550705507155072550735507455075550765507755078550795508055081550825508355084550855508655087550885508955090550915509255093550945509555096550975509855099551005510155102551035510455105551065510755108551095511055111551125511355114551155511655117551185511955120551215512255123551245512555126551275512855129551305513155132551335513455135551365513755138551395514055141551425514355144551455514655147551485514955150551515515255153551545515555156551575515855159551605516155162551635516455165551665516755168551695517055171551725517355174551755517655177551785517955180551815518255183551845518555186551875518855189551905519155192551935519455195551965519755198551995520055201552025520355204552055520655207552085520955210552115521255213552145521555216552175521855219552205522155222552235522455225552265522755228552295523055231552325523355234552355523655237552385523955240552415524255243552445524555246552475524855249552505525155252552535525455255552565525755258552595526055261552625526355264552655526655267552685526955270552715527255273552745527555276552775527855279552805528155282552835528455285552865528755288552895529055291552925529355294552955529655297552985529955300553015530255303553045530555306553075530855309553105531155312553135531455315553165531755318553195532055321553225532355324553255532655327553285532955330553315533255333553345533555336553375533855339553405534155342553435534455345553465534755348553495535055351553525535355354553555535655357553585535955360553615536255363553645536555366553675536855369553705537155372553735537455375553765537755378553795538055381553825538355384553855538655387553885538955390553915539255393553945539555396553975539855399554005540155402554035540455405554065540755408554095541055411554125541355414554155541655417554185541955420554215542255423554245542555426554275542855429554305543155432554335543455435554365543755438554395544055441554425544355444554455544655447554485544955450554515545255453554545545555456554575545855459554605546155462554635546455465554665546755468554695547055471554725547355474554755547655477554785547955480554815548255483554845548555486554875548855489554905549155492554935549455495554965549755498554995550055501555025550355504555055550655507555085550955510555115551255513555145551555516555175551855519555205552155522555235552455525555265552755528555295553055531555325553355534555355553655537555385553955540555415554255543555445554555546555475554855549555505555155552555535555455555555565555755558555595556055561555625556355564555655556655567555685556955570555715557255573555745557555576555775557855579555805558155582555835558455585555865558755588555895559055591555925559355594555955559655597555985559955600556015560255603556045560555606556075560855609556105561155612556135561455615556165561755618556195562055621556225562355624556255562655627556285562955630556315563255633556345563555636556375563855639556405564155642556435564455645556465564755648556495565055651556525565355654556555565655657556585565955660556615566255663556645566555666556675566855669556705567155672556735567455675556765567755678556795568055681556825568355684556855568655687556885568955690556915569255693556945569555696556975569855699557005570155702557035570455705557065570755708557095571055711557125571355714557155571655717557185571955720557215572255723557245572555726557275572855729557305573155732557335573455735557365573755738557395574055741557425574355744557455574655747557485574955750557515575255753557545575555756557575575855759557605576155762557635576455765557665576755768557695577055771557725577355774557755577655777557785577955780557815578255783557845578555786557875578855789557905579155792557935579455795557965579755798557995580055801558025580355804558055580655807558085580955810558115581255813558145581555816558175581855819558205582155822558235582455825558265582755828558295583055831558325583355834558355583655837558385583955840558415584255843558445584555846558475584855849558505585155852558535585455855558565585755858558595586055861558625586355864558655586655867558685586955870558715587255873558745587555876558775587855879558805588155882558835588455885558865588755888558895589055891558925589355894558955589655897558985589955900559015590255903559045590555906559075590855909559105591155912559135591455915559165591755918559195592055921559225592355924559255592655927559285592955930559315593255933559345593555936559375593855939559405594155942559435594455945559465594755948559495595055951559525595355954559555595655957559585595955960559615596255963559645596555966559675596855969559705597155972559735597455975559765597755978559795598055981559825598355984559855598655987559885598955990559915599255993559945599555996559975599855999560005600156002560035600456005560065600756008560095601056011560125601356014560155601656017560185601956020560215602256023560245602556026560275602856029560305603156032560335603456035560365603756038560395604056041560425604356044560455604656047560485604956050560515605256053560545605556056560575605856059560605606156062560635606456065560665606756068560695607056071560725607356074560755607656077560785607956080560815608256083560845608556086560875608856089560905609156092560935609456095560965609756098560995610056101561025610356104561055610656107561085610956110561115611256113561145611556116561175611856119561205612156122561235612456125561265612756128561295613056131561325613356134561355613656137561385613956140561415614256143561445614556146561475614856149561505615156152561535615456155561565615756158561595616056161561625616356164561655616656167561685616956170561715617256173561745617556176561775617856179561805618156182561835618456185561865618756188561895619056191561925619356194561955619656197561985619956200562015620256203562045620556206562075620856209562105621156212562135621456215562165621756218562195622056221562225622356224562255622656227562285622956230562315623256233562345623556236562375623856239562405624156242562435624456245562465624756248562495625056251562525625356254562555625656257562585625956260562615626256263562645626556266562675626856269562705627156272562735627456275562765627756278562795628056281562825628356284562855628656287562885628956290562915629256293562945629556296562975629856299563005630156302563035630456305563065630756308563095631056311563125631356314563155631656317563185631956320563215632256323563245632556326563275632856329563305633156332563335633456335563365633756338563395634056341563425634356344563455634656347563485634956350563515635256353563545635556356563575635856359563605636156362563635636456365563665636756368563695637056371563725637356374563755637656377563785637956380563815638256383563845638556386563875638856389563905639156392563935639456395563965639756398563995640056401564025640356404564055640656407564085640956410564115641256413564145641556416564175641856419564205642156422564235642456425564265642756428564295643056431564325643356434564355643656437564385643956440564415644256443564445644556446564475644856449564505645156452564535645456455564565645756458564595646056461564625646356464564655646656467564685646956470564715647256473564745647556476564775647856479564805648156482564835648456485564865648756488564895649056491564925649356494564955649656497564985649956500565015650256503565045650556506565075650856509565105651156512565135651456515565165651756518565195652056521565225652356524565255652656527565285652956530565315653256533565345653556536565375653856539565405654156542565435654456545565465654756548565495655056551565525655356554565555655656557565585655956560565615656256563565645656556566565675656856569565705657156572565735657456575565765657756578565795658056581565825658356584565855658656587565885658956590565915659256593565945659556596565975659856599566005660156602566035660456605566065660756608566095661056611566125661356614566155661656617566185661956620566215662256623566245662556626566275662856629566305663156632566335663456635566365663756638566395664056641566425664356644566455664656647566485664956650566515665256653566545665556656566575665856659566605666156662566635666456665566665666756668566695667056671566725667356674566755667656677566785667956680566815668256683566845668556686566875668856689566905669156692566935669456695566965669756698566995670056701567025670356704567055670656707567085670956710567115671256713567145671556716567175671856719567205672156722567235672456725567265672756728567295673056731567325673356734567355673656737567385673956740567415674256743567445674556746567475674856749567505675156752567535675456755567565675756758567595676056761567625676356764567655676656767567685676956770567715677256773567745677556776567775677856779567805678156782567835678456785567865678756788567895679056791567925679356794567955679656797567985679956800568015680256803568045680556806568075680856809568105681156812568135681456815568165681756818568195682056821568225682356824568255682656827568285682956830568315683256833568345683556836568375683856839568405684156842568435684456845568465684756848568495685056851568525685356854568555685656857568585685956860568615686256863568645686556866568675686856869568705687156872568735687456875568765687756878568795688056881568825688356884568855688656887568885688956890568915689256893568945689556896568975689856899569005690156902569035690456905569065690756908569095691056911569125691356914569155691656917569185691956920569215692256923569245692556926569275692856929569305693156932569335693456935569365693756938569395694056941569425694356944569455694656947569485694956950569515695256953569545695556956569575695856959569605696156962569635696456965569665696756968569695697056971569725697356974569755697656977569785697956980569815698256983569845698556986569875698856989569905699156992569935699456995569965699756998569995700057001570025700357004570055700657007570085700957010570115701257013570145701557016570175701857019570205702157022570235702457025570265702757028570295703057031570325703357034570355703657037570385703957040570415704257043570445704557046570475704857049570505705157052570535705457055570565705757058570595706057061570625706357064570655706657067570685706957070570715707257073570745707557076570775707857079570805708157082570835708457085570865708757088570895709057091570925709357094570955709657097570985709957100571015710257103571045710557106571075710857109571105711157112571135711457115571165711757118571195712057121571225712357124571255712657127571285712957130571315713257133571345713557136571375713857139571405714157142571435714457145571465714757148571495715057151571525715357154571555715657157571585715957160571615716257163571645716557166571675716857169571705717157172571735717457175571765717757178571795718057181571825718357184571855718657187571885718957190571915719257193571945719557196571975719857199572005720157202572035720457205572065720757208572095721057211572125721357214572155721657217572185721957220572215722257223572245722557226572275722857229572305723157232572335723457235572365723757238572395724057241572425724357244572455724657247572485724957250572515725257253572545725557256572575725857259572605726157262572635726457265572665726757268572695727057271572725727357274572755727657277572785727957280572815728257283572845728557286572875728857289572905729157292572935729457295572965729757298572995730057301573025730357304573055730657307573085730957310573115731257313573145731557316573175731857319573205732157322573235732457325573265732757328573295733057331573325733357334573355733657337573385733957340573415734257343573445734557346573475734857349573505735157352573535735457355573565735757358573595736057361573625736357364573655736657367573685736957370573715737257373573745737557376573775737857379573805738157382573835738457385573865738757388573895739057391573925739357394573955739657397573985739957400574015740257403574045740557406574075740857409574105741157412574135741457415574165741757418574195742057421574225742357424574255742657427574285742957430574315743257433574345743557436574375743857439574405744157442574435744457445574465744757448574495745057451574525745357454574555745657457574585745957460574615746257463574645746557466574675746857469574705747157472574735747457475574765747757478574795748057481574825748357484574855748657487574885748957490574915749257493574945749557496574975749857499575005750157502575035750457505575065750757508575095751057511575125751357514575155751657517575185751957520575215752257523575245752557526575275752857529575305753157532575335753457535575365753757538575395754057541575425754357544575455754657547575485754957550575515755257553575545755557556575575755857559575605756157562575635756457565575665756757568575695757057571575725757357574575755757657577575785757957580575815758257583575845758557586575875758857589575905759157592575935759457595575965759757598575995760057601576025760357604576055760657607576085760957610576115761257613576145761557616576175761857619576205762157622576235762457625576265762757628576295763057631576325763357634576355763657637576385763957640576415764257643576445764557646576475764857649576505765157652576535765457655576565765757658576595766057661576625766357664576655766657667576685766957670576715767257673576745767557676576775767857679576805768157682576835768457685576865768757688576895769057691576925769357694576955769657697576985769957700577015770257703577045770557706577075770857709577105771157712577135771457715577165771757718577195772057721577225772357724577255772657727577285772957730577315773257733577345773557736577375773857739577405774157742577435774457745577465774757748577495775057751577525775357754577555775657757577585775957760577615776257763577645776557766577675776857769577705777157772577735777457775577765777757778577795778057781577825778357784577855778657787577885778957790577915779257793577945779557796577975779857799578005780157802578035780457805578065780757808578095781057811578125781357814578155781657817578185781957820578215782257823578245782557826578275782857829578305783157832578335783457835578365783757838578395784057841578425784357844578455784657847578485784957850578515785257853578545785557856578575785857859578605786157862578635786457865578665786757868578695787057871578725787357874578755787657877578785787957880578815788257883578845788557886578875788857889578905789157892578935789457895578965789757898578995790057901579025790357904579055790657907579085790957910579115791257913579145791557916579175791857919579205792157922579235792457925579265792757928579295793057931579325793357934579355793657937579385793957940579415794257943579445794557946579475794857949579505795157952579535795457955579565795757958579595796057961579625796357964579655796657967579685796957970579715797257973579745797557976579775797857979579805798157982579835798457985579865798757988579895799057991579925799357994579955799657997579985799958000580015800258003580045800558006580075800858009580105801158012580135801458015580165801758018580195802058021580225802358024580255802658027580285802958030580315803258033580345803558036580375803858039580405804158042580435804458045580465804758048580495805058051580525805358054580555805658057580585805958060580615806258063580645806558066580675806858069580705807158072580735807458075580765807758078580795808058081580825808358084580855808658087580885808958090580915809258093580945809558096580975809858099581005810158102581035810458105581065810758108581095811058111581125811358114581155811658117581185811958120581215812258123581245812558126581275812858129581305813158132581335813458135581365813758138581395814058141581425814358144581455814658147581485814958150581515815258153581545815558156581575815858159581605816158162581635816458165581665816758168581695817058171581725817358174581755817658177581785817958180581815818258183581845818558186581875818858189581905819158192581935819458195581965819758198581995820058201582025820358204582055820658207582085820958210582115821258213582145821558216582175821858219582205822158222582235822458225582265822758228582295823058231582325823358234582355823658237582385823958240582415824258243582445824558246582475824858249582505825158252582535825458255582565825758258582595826058261582625826358264582655826658267582685826958270582715827258273582745827558276582775827858279582805828158282582835828458285582865828758288582895829058291582925829358294582955829658297582985829958300583015830258303583045830558306583075830858309583105831158312583135831458315583165831758318583195832058321583225832358324583255832658327583285832958330583315833258333583345833558336583375833858339583405834158342583435834458345583465834758348583495835058351583525835358354583555835658357583585835958360583615836258363583645836558366583675836858369583705837158372583735837458375583765837758378583795838058381583825838358384583855838658387583885838958390583915839258393583945839558396583975839858399584005840158402584035840458405584065840758408584095841058411584125841358414584155841658417584185841958420584215842258423584245842558426584275842858429584305843158432584335843458435584365843758438584395844058441584425844358444584455844658447584485844958450584515845258453584545845558456584575845858459584605846158462584635846458465584665846758468584695847058471584725847358474584755847658477584785847958480584815848258483584845848558486584875848858489584905849158492584935849458495584965849758498584995850058501585025850358504585055850658507585085850958510585115851258513585145851558516585175851858519585205852158522585235852458525585265852758528585295853058531585325853358534585355853658537585385853958540585415854258543585445854558546585475854858549585505855158552585535855458555585565855758558585595856058561585625856358564585655856658567585685856958570585715857258573585745857558576585775857858579585805858158582585835858458585585865858758588585895859058591585925859358594585955859658597585985859958600586015860258603586045860558606586075860858609586105861158612586135861458615586165861758618586195862058621586225862358624586255862658627586285862958630586315863258633586345863558636586375863858639586405864158642586435864458645586465864758648586495865058651586525865358654586555865658657586585865958660586615866258663586645866558666586675866858669586705867158672586735867458675586765867758678586795868058681586825868358684586855868658687586885868958690586915869258693586945869558696586975869858699587005870158702587035870458705587065870758708587095871058711587125871358714587155871658717587185871958720587215872258723587245872558726587275872858729587305873158732587335873458735587365873758738587395874058741587425874358744587455874658747587485874958750587515875258753587545875558756587575875858759587605876158762587635876458765587665876758768587695877058771587725877358774587755877658777587785877958780587815878258783587845878558786587875878858789587905879158792587935879458795587965879758798587995880058801588025880358804588055880658807588085880958810588115881258813588145881558816588175881858819588205882158822588235882458825588265882758828588295883058831588325883358834588355883658837588385883958840588415884258843588445884558846588475884858849588505885158852588535885458855588565885758858588595886058861588625886358864588655886658867588685886958870588715887258873588745887558876588775887858879588805888158882588835888458885588865888758888588895889058891588925889358894588955889658897588985889958900589015890258903589045890558906589075890858909589105891158912589135891458915589165891758918589195892058921589225892358924589255892658927589285892958930589315893258933589345893558936589375893858939589405894158942589435894458945589465894758948589495895058951589525895358954589555895658957589585895958960589615896258963589645896558966589675896858969589705897158972589735897458975589765897758978589795898058981589825898358984589855898658987589885898958990589915899258993589945899558996589975899858999590005900159002590035900459005590065900759008590095901059011590125901359014590155901659017590185901959020590215902259023590245902559026590275902859029590305903159032590335903459035590365903759038590395904059041590425904359044590455904659047590485904959050590515905259053590545905559056590575905859059590605906159062590635906459065590665906759068590695907059071590725907359074590755907659077590785907959080590815908259083590845908559086590875908859089590905909159092590935909459095590965909759098590995910059101591025910359104591055910659107591085910959110591115911259113591145911559116591175911859119591205912159122591235912459125591265912759128591295913059131591325913359134591355913659137591385913959140591415914259143591445914559146591475914859149591505915159152591535915459155591565915759158591595916059161591625916359164591655916659167591685916959170591715917259173591745917559176591775917859179591805918159182591835918459185591865918759188591895919059191591925919359194591955919659197591985919959200592015920259203592045920559206592075920859209592105921159212592135921459215592165921759218592195922059221592225922359224592255922659227592285922959230592315923259233592345923559236592375923859239592405924159242592435924459245592465924759248592495925059251592525925359254592555925659257592585925959260592615926259263592645926559266592675926859269592705927159272592735927459275592765927759278592795928059281592825928359284592855928659287592885928959290592915929259293592945929559296592975929859299593005930159302593035930459305593065930759308593095931059311593125931359314593155931659317593185931959320593215932259323593245932559326593275932859329593305933159332593335933459335593365933759338593395934059341593425934359344593455934659347593485934959350593515935259353593545935559356593575935859359593605936159362593635936459365593665936759368593695937059371593725937359374593755937659377593785937959380593815938259383593845938559386593875938859389593905939159392593935939459395593965939759398593995940059401594025940359404594055940659407594085940959410594115941259413594145941559416594175941859419594205942159422594235942459425594265942759428594295943059431594325943359434594355943659437594385943959440594415944259443594445944559446594475944859449594505945159452594535945459455594565945759458594595946059461594625946359464594655946659467594685946959470594715947259473594745947559476594775947859479594805948159482594835948459485594865948759488594895949059491594925949359494594955949659497594985949959500595015950259503595045950559506595075950859509595105951159512595135951459515595165951759518595195952059521595225952359524595255952659527595285952959530595315953259533595345953559536595375953859539595405954159542595435954459545595465954759548595495955059551595525955359554595555955659557595585955959560595615956259563595645956559566595675956859569595705957159572595735957459575595765957759578595795958059581595825958359584595855958659587595885958959590595915959259593595945959559596595975959859599596005960159602596035960459605596065960759608596095961059611596125961359614596155961659617596185961959620596215962259623596245962559626596275962859629596305963159632596335963459635596365963759638596395964059641596425964359644596455964659647596485964959650596515965259653596545965559656596575965859659596605966159662596635966459665596665966759668596695967059671596725967359674596755967659677596785967959680596815968259683596845968559686596875968859689596905969159692596935969459695596965969759698596995970059701597025970359704597055970659707597085970959710597115971259713597145971559716597175971859719597205972159722597235972459725597265972759728597295973059731597325973359734597355973659737597385973959740597415974259743597445974559746597475974859749597505975159752597535975459755597565975759758597595976059761597625976359764597655976659767597685976959770597715977259773597745977559776597775977859779597805978159782597835978459785597865978759788597895979059791597925979359794597955979659797597985979959800598015980259803598045980559806598075980859809598105981159812598135981459815598165981759818598195982059821598225982359824598255982659827598285982959830598315983259833598345983559836598375983859839598405984159842598435984459845598465984759848598495985059851598525985359854598555985659857598585985959860598615986259863598645986559866598675986859869598705987159872598735987459875598765987759878598795988059881598825988359884598855988659887598885988959890598915989259893598945989559896598975989859899599005990159902599035990459905599065990759908599095991059911599125991359914599155991659917599185991959920599215992259923599245992559926599275992859929599305993159932599335993459935599365993759938599395994059941599425994359944599455994659947599485994959950599515995259953599545995559956599575995859959599605996159962599635996459965599665996759968599695997059971599725997359974599755997659977599785997959980599815998259983599845998559986599875998859989599905999159992599935999459995599965999759998599996000060001600026000360004600056000660007600086000960010600116001260013600146001560016600176001860019600206002160022600236002460025600266002760028600296003060031600326003360034600356003660037600386003960040600416004260043600446004560046600476004860049600506005160052600536005460055600566005760058600596006060061600626006360064600656006660067600686006960070600716007260073600746007560076600776007860079600806008160082600836008460085600866008760088600896009060091600926009360094600956009660097600986009960100601016010260103601046010560106601076010860109601106011160112601136011460115601166011760118601196012060121601226012360124601256012660127601286012960130601316013260133601346013560136601376013860139601406014160142601436014460145601466014760148601496015060151601526015360154601556015660157601586015960160601616016260163601646016560166601676016860169601706017160172601736017460175601766017760178601796018060181601826018360184601856018660187601886018960190601916019260193601946019560196601976019860199602006020160202602036020460205602066020760208602096021060211602126021360214602156021660217602186021960220602216022260223602246022560226602276022860229602306023160232602336023460235602366023760238602396024060241602426024360244602456024660247602486024960250602516025260253602546025560256602576025860259602606026160262602636026460265602666026760268602696027060271602726027360274602756027660277602786027960280602816028260283602846028560286602876028860289602906029160292602936029460295602966029760298602996030060301603026030360304603056030660307603086030960310603116031260313603146031560316603176031860319603206032160322603236032460325603266032760328603296033060331603326033360334603356033660337603386033960340603416034260343603446034560346603476034860349603506035160352603536035460355603566035760358603596036060361603626036360364603656036660367603686036960370603716037260373603746037560376603776037860379603806038160382603836038460385603866038760388603896039060391603926039360394603956039660397603986039960400604016040260403604046040560406604076040860409604106041160412604136041460415604166041760418604196042060421604226042360424604256042660427604286042960430604316043260433604346043560436604376043860439604406044160442604436044460445604466044760448604496045060451604526045360454604556045660457604586045960460604616046260463604646046560466604676046860469604706047160472604736047460475604766047760478604796048060481604826048360484604856048660487604886048960490604916049260493604946049560496604976049860499605006050160502605036050460505605066050760508605096051060511605126051360514605156051660517605186051960520605216052260523605246052560526605276052860529605306053160532605336053460535605366053760538605396054060541605426054360544605456054660547605486054960550605516055260553605546055560556605576055860559605606056160562605636056460565605666056760568605696057060571605726057360574605756057660577605786057960580605816058260583605846058560586605876058860589605906059160592605936059460595605966059760598605996060060601606026060360604606056060660607606086060960610606116061260613606146061560616606176061860619606206062160622606236062460625606266062760628606296063060631606326063360634606356063660637606386063960640606416064260643606446064560646606476064860649606506065160652606536065460655606566065760658606596066060661606626066360664606656066660667606686066960670606716067260673606746067560676606776067860679606806068160682606836068460685606866068760688606896069060691606926069360694606956069660697606986069960700607016070260703607046070560706607076070860709607106071160712607136071460715607166071760718607196072060721607226072360724607256072660727607286072960730607316073260733607346073560736607376073860739607406074160742607436074460745607466074760748607496075060751607526075360754607556075660757607586075960760607616076260763607646076560766607676076860769607706077160772607736077460775607766077760778607796078060781607826078360784607856078660787607886078960790607916079260793607946079560796607976079860799608006080160802608036080460805608066080760808608096081060811608126081360814608156081660817608186081960820608216082260823608246082560826608276082860829608306083160832608336083460835608366083760838608396084060841608426084360844608456084660847608486084960850608516085260853608546085560856608576085860859608606086160862608636086460865608666086760868608696087060871608726087360874608756087660877608786087960880608816088260883608846088560886608876088860889608906089160892608936089460895608966089760898608996090060901609026090360904609056090660907609086090960910609116091260913609146091560916609176091860919609206092160922609236092460925609266092760928609296093060931609326093360934609356093660937609386093960940609416094260943609446094560946609476094860949609506095160952609536095460955609566095760958609596096060961609626096360964609656096660967609686096960970609716097260973609746097560976609776097860979609806098160982609836098460985609866098760988609896099060991609926099360994609956099660997609986099961000610016100261003610046100561006610076100861009610106101161012610136101461015610166101761018610196102061021610226102361024610256102661027610286102961030610316103261033610346103561036610376103861039610406104161042610436104461045610466104761048610496105061051610526105361054610556105661057610586105961060610616106261063610646106561066610676106861069610706107161072610736107461075610766107761078610796108061081610826108361084610856108661087610886108961090610916109261093610946109561096610976109861099611006110161102611036110461105611066110761108611096111061111611126111361114611156111661117611186111961120611216112261123611246112561126611276112861129611306113161132611336113461135611366113761138611396114061141611426114361144611456114661147611486114961150611516115261153611546115561156611576115861159611606116161162611636116461165611666116761168611696117061171611726117361174611756117661177611786117961180611816118261183611846118561186611876118861189611906119161192611936119461195611966119761198611996120061201612026120361204612056120661207612086120961210612116121261213612146121561216612176121861219612206122161222612236122461225612266122761228612296123061231612326123361234612356123661237612386123961240612416124261243612446124561246612476124861249612506125161252612536125461255612566125761258612596126061261612626126361264612656126661267612686126961270612716127261273612746127561276612776127861279612806128161282612836128461285612866128761288612896129061291612926129361294612956129661297612986129961300613016130261303613046130561306613076130861309613106131161312613136131461315613166131761318613196132061321613226132361324613256132661327613286132961330613316133261333613346133561336613376133861339613406134161342613436134461345613466134761348613496135061351613526135361354613556135661357613586135961360613616136261363613646136561366613676136861369613706137161372613736137461375613766137761378613796138061381613826138361384613856138661387613886138961390613916139261393613946139561396613976139861399614006140161402614036140461405614066140761408614096141061411614126141361414614156141661417614186141961420614216142261423614246142561426614276142861429614306143161432614336143461435614366143761438614396144061441614426144361444614456144661447614486144961450614516145261453614546145561456614576145861459614606146161462614636146461465614666146761468614696147061471614726147361474614756147661477614786147961480614816148261483614846148561486614876148861489614906149161492614936149461495614966149761498614996150061501615026150361504615056150661507615086150961510615116151261513615146151561516615176151861519615206152161522615236152461525615266152761528615296153061531615326153361534615356153661537615386153961540615416154261543615446154561546615476154861549615506155161552615536155461555615566155761558615596156061561615626156361564615656156661567615686156961570615716157261573615746157561576615776157861579615806158161582615836158461585615866158761588615896159061591615926159361594615956159661597615986159961600616016160261603616046160561606616076160861609616106161161612616136161461615616166161761618616196162061621616226162361624616256162661627616286162961630616316163261633616346163561636616376163861639616406164161642616436164461645616466164761648616496165061651616526165361654616556165661657616586165961660616616166261663616646166561666616676166861669616706167161672616736167461675616766167761678616796168061681616826168361684616856168661687616886168961690616916169261693616946169561696616976169861699617006170161702617036170461705617066170761708617096171061711617126171361714617156171661717617186171961720617216172261723617246172561726617276172861729617306173161732617336173461735617366173761738617396174061741617426174361744617456174661747617486174961750617516175261753617546175561756617576175861759617606176161762617636176461765617666176761768617696177061771617726177361774617756177661777617786177961780617816178261783617846178561786617876178861789617906179161792617936179461795617966179761798617996180061801618026180361804618056180661807618086180961810618116181261813618146181561816618176181861819618206182161822618236182461825618266182761828618296183061831618326183361834618356183661837618386183961840618416184261843618446184561846618476184861849618506185161852618536185461855618566185761858618596186061861618626186361864618656186661867618686186961870618716187261873618746187561876618776187861879618806188161882618836188461885618866188761888618896189061891618926189361894618956189661897618986189961900619016190261903619046190561906619076190861909619106191161912619136191461915619166191761918619196192061921619226192361924619256192661927619286192961930619316193261933619346193561936619376193861939619406194161942619436194461945619466194761948619496195061951619526195361954619556195661957619586195961960619616196261963619646196561966619676196861969619706197161972619736197461975619766197761978619796198061981619826198361984619856198661987619886198961990619916199261993619946199561996619976199861999620006200162002620036200462005620066200762008620096201062011620126201362014620156201662017620186201962020620216202262023620246202562026620276202862029620306203162032620336203462035620366203762038620396204062041620426204362044620456204662047620486204962050620516205262053620546205562056620576205862059620606206162062620636206462065620666206762068620696207062071620726207362074620756207662077620786207962080620816208262083620846208562086620876208862089620906209162092620936209462095620966209762098620996210062101621026210362104621056210662107621086210962110621116211262113621146211562116621176211862119621206212162122621236212462125621266212762128621296213062131621326213362134621356213662137621386213962140621416214262143621446214562146621476214862149621506215162152621536215462155621566215762158621596216062161621626216362164621656216662167621686216962170621716217262173621746217562176621776217862179621806218162182621836218462185621866218762188621896219062191621926219362194621956219662197621986219962200622016220262203622046220562206622076220862209622106221162212622136221462215622166221762218622196222062221622226222362224622256222662227622286222962230622316223262233622346223562236622376223862239622406224162242622436224462245622466224762248622496225062251622526225362254622556225662257622586225962260622616226262263622646226562266622676226862269622706227162272622736227462275622766227762278622796228062281622826228362284622856228662287622886228962290622916229262293622946229562296622976229862299623006230162302623036230462305623066230762308623096231062311623126231362314623156231662317623186231962320623216232262323623246232562326623276232862329623306233162332623336233462335623366233762338623396234062341623426234362344623456234662347623486234962350623516235262353623546235562356623576235862359623606236162362623636236462365623666236762368623696237062371623726237362374623756237662377623786237962380623816238262383623846238562386623876238862389623906239162392623936239462395623966239762398623996240062401624026240362404624056240662407624086240962410624116241262413624146241562416624176241862419624206242162422624236242462425624266242762428624296243062431624326243362434624356243662437624386243962440624416244262443624446244562446624476244862449624506245162452624536245462455624566245762458624596246062461624626246362464624656246662467624686246962470624716247262473624746247562476624776247862479624806248162482624836248462485624866248762488624896249062491624926249362494624956249662497624986249962500625016250262503625046250562506625076250862509625106251162512625136251462515625166251762518625196252062521625226252362524625256252662527625286252962530625316253262533625346253562536625376253862539625406254162542625436254462545625466254762548625496255062551625526255362554625556255662557625586255962560625616256262563625646256562566625676256862569625706257162572625736257462575625766257762578625796258062581625826258362584625856258662587625886258962590625916259262593625946259562596625976259862599626006260162602626036260462605626066260762608626096261062611626126261362614626156261662617626186261962620626216262262623626246262562626626276262862629626306263162632626336263462635626366263762638626396264062641626426264362644626456264662647626486264962650626516265262653626546265562656626576265862659626606266162662626636266462665626666266762668626696267062671626726267362674626756267662677626786267962680626816268262683626846268562686626876268862689626906269162692626936269462695626966269762698626996270062701627026270362704627056270662707627086270962710627116271262713627146271562716627176271862719627206272162722627236272462725627266272762728627296273062731627326273362734627356273662737627386273962740627416274262743627446274562746627476274862749627506275162752627536275462755627566275762758627596276062761627626276362764627656276662767627686276962770627716277262773627746277562776627776277862779627806278162782627836278462785627866278762788627896279062791627926279362794627956279662797627986279962800628016280262803628046280562806628076280862809628106281162812628136281462815628166281762818628196282062821628226282362824628256282662827628286282962830628316283262833628346283562836628376283862839628406284162842628436284462845628466284762848628496285062851628526285362854628556285662857628586285962860628616286262863628646286562866628676286862869628706287162872628736287462875628766287762878628796288062881628826288362884628856288662887628886288962890628916289262893628946289562896628976289862899629006290162902629036290462905629066290762908629096291062911629126291362914629156291662917629186291962920629216292262923629246292562926629276292862929629306293162932629336293462935629366293762938629396294062941629426294362944629456294662947629486294962950629516295262953629546295562956629576295862959629606296162962629636296462965629666296762968629696297062971629726297362974629756297662977629786297962980629816298262983629846298562986629876298862989629906299162992629936299462995629966299762998629996300063001630026300363004630056300663007630086300963010630116301263013630146301563016630176301863019630206302163022630236302463025630266302763028630296303063031630326303363034630356303663037630386303963040630416304263043630446304563046630476304863049630506305163052630536305463055630566305763058630596306063061630626306363064630656306663067630686306963070630716307263073630746307563076630776307863079630806308163082630836308463085630866308763088630896309063091630926309363094630956309663097630986309963100631016310263103631046310563106631076310863109631106311163112631136311463115631166311763118631196312063121631226312363124631256312663127631286312963130631316313263133631346313563136631376313863139631406314163142631436314463145631466314763148631496315063151631526315363154631556315663157631586315963160631616316263163631646316563166631676316863169631706317163172631736317463175631766317763178631796318063181631826318363184631856318663187631886318963190
  1. # SOME DESCRIPTIVE TITLE
  2. # Copyright (C) 2021 the authors of Guix (msgids) and the following authors (msgstr)
  3. # This file is distributed under the same license as the guix manual package.
  4. # Nicolo Balzarotti <nicolo@nixo.xyz>, 2021.
  5. # Nathan <nathan95@live.it>, 2021.
  6. msgid ""
  7. msgstr ""
  8. "Project-Id-Version: guix manual checkout\n"
  9. "Report-Msgid-Bugs-To: bug-guix@gnu.org\n"
  10. "POT-Creation-Date: 2021-07-15 14:49+0200\n"
  11. "PO-Revision-Date: 2021-08-26 14:42+0000\n"
  12. "Last-Translator: Nathan <nathan95@live.it>\n"
  13. "Language-Team: Italian <https://translate.fedoraproject.org/projects/guix/documentation-manual/it/>\n"
  14. "Language: it\n"
  15. "MIME-Version: 1.0\n"
  16. "Content-Type: text/plain; charset=UTF-8\n"
  17. "Content-Transfer-Encoding: 8bit\n"
  18. "Plural-Forms: nplurals=2; plural=n != 1;\n"
  19. "X-Generator: Weblate 4.8\n"
  20. #. #-#-#-#-# contributing.pot (guix manual checkout) #-#-#-#-#
  21. #. type: chapter
  22. #. #-#-#-#-# guix.pot (guix manual checkout) #-#-#-#-#
  23. #. type: menuentry
  24. #: guix-git/doc/contributing.texi:1 guix-git/doc/contributing.texi:2
  25. #: guix-git/doc/guix.texi:176
  26. #, no-wrap
  27. msgid "Contributing"
  28. msgstr "Contribuire"
  29. #. type: Plain text
  30. #: guix-git/doc/contributing.texi:9
  31. msgid "This project is a cooperative effort, and we need your help to make it grow! Please get in touch with us on @email{guix-devel@@gnu.org} and @code{#guix} on the Libera Chat IRC network. We welcome ideas, bug reports, patches, and anything that may be helpful to the project. We particularly welcome help on packaging (@pxref{Packaging Guidelines})."
  32. msgstr ""
  33. #. type: cindex
  34. #: guix-git/doc/contributing.texi:10
  35. #, no-wrap
  36. msgid "code of conduct, of contributors"
  37. msgstr ""
  38. #. type: cindex
  39. #: guix-git/doc/contributing.texi:11
  40. #, no-wrap
  41. msgid "contributor covenant"
  42. msgstr ""
  43. #. type: Plain text
  44. #: guix-git/doc/contributing.texi:17
  45. msgid "We want to provide a warm, friendly, and harassment-free environment, so that anyone can contribute to the best of their abilities. To this end our project uses a ``Contributor Covenant'', which was adapted from @url{https://contributor-covenant.org/}. You can find a local version in the @file{CODE-OF-CONDUCT} file in the source tree."
  46. msgstr ""
  47. #. type: Plain text
  48. #: guix-git/doc/contributing.texi:21
  49. msgid "Contributors are not required to use their legal name in patches and on-line communication; they can use any name or pseudonym of their choice."
  50. msgstr ""
  51. #. type: section
  52. #: guix-git/doc/contributing.texi:33 guix-git/doc/contributing.texi:35
  53. #: guix-git/doc/contributing.texi:36
  54. #, no-wrap
  55. msgid "Building from Git"
  56. msgstr ""
  57. #. type: menuentry
  58. #: guix-git/doc/contributing.texi:33
  59. msgid "The latest and greatest."
  60. msgstr ""
  61. #. type: section
  62. #: guix-git/doc/contributing.texi:33 guix-git/doc/contributing.texi:161
  63. #: guix-git/doc/contributing.texi:162
  64. #, no-wrap
  65. msgid "Running Guix Before It Is Installed"
  66. msgstr ""
  67. #. type: menuentry
  68. #: guix-git/doc/contributing.texi:33
  69. msgid "Hacker tricks."
  70. msgstr ""
  71. #. type: section
  72. #: guix-git/doc/contributing.texi:33 guix-git/doc/contributing.texi:235
  73. #: guix-git/doc/contributing.texi:236
  74. #, no-wrap
  75. msgid "The Perfect Setup"
  76. msgstr ""
  77. #. type: menuentry
  78. #: guix-git/doc/contributing.texi:33
  79. msgid "The right tools."
  80. msgstr ""
  81. #. type: section
  82. #: guix-git/doc/contributing.texi:33 guix-git/doc/contributing.texi:326
  83. #: guix-git/doc/contributing.texi:327
  84. #, no-wrap
  85. msgid "Packaging Guidelines"
  86. msgstr ""
  87. #. type: menuentry
  88. #: guix-git/doc/contributing.texi:33
  89. msgid "Growing the distribution."
  90. msgstr ""
  91. #. type: section
  92. #: guix-git/doc/contributing.texi:33 guix-git/doc/contributing.texi:890
  93. #: guix-git/doc/contributing.texi:891
  94. #, no-wrap
  95. msgid "Coding Style"
  96. msgstr ""
  97. #. type: menuentry
  98. #: guix-git/doc/contributing.texi:33
  99. msgid "Hygiene of the contributor."
  100. msgstr ""
  101. #. type: section
  102. #: guix-git/doc/contributing.texi:33 guix-git/doc/contributing.texi:989
  103. #: guix-git/doc/contributing.texi:990
  104. #, no-wrap
  105. msgid "Submitting Patches"
  106. msgstr "Invia delle Patches"
  107. #. type: menuentry
  108. #: guix-git/doc/contributing.texi:33
  109. msgid "Share your work."
  110. msgstr "Condividi il tuo lavoro."
  111. #. type: section
  112. #: guix-git/doc/contributing.texi:33 guix-git/doc/contributing.texi:1223
  113. #: guix-git/doc/contributing.texi:1224
  114. #, no-wrap
  115. msgid "Tracking Bugs and Patches"
  116. msgstr "Traccia Bug e Patches"
  117. #. type: menuentry
  118. #: guix-git/doc/contributing.texi:33
  119. msgid "Keeping it all organized."
  120. msgstr ""
  121. #. type: section
  122. #: guix-git/doc/contributing.texi:33 guix-git/doc/contributing.texi:1338
  123. #: guix-git/doc/contributing.texi:1339
  124. #, no-wrap
  125. msgid "Commit Access"
  126. msgstr "Acesso Commit"
  127. #. type: menuentry
  128. #: guix-git/doc/contributing.texi:33
  129. msgid "Pushing to the official repository."
  130. msgstr "Esegui il Pushing sul repository ufficiale."
  131. #. type: section
  132. #: guix-git/doc/contributing.texi:33 guix-git/doc/contributing.texi:1564
  133. #: guix-git/doc/contributing.texi:1565
  134. #, no-wrap
  135. msgid "Updating the Guix Package"
  136. msgstr "Aggiornamento del pacchetto Guix"
  137. #. type: menuentry
  138. #: guix-git/doc/contributing.texi:33
  139. msgid "Updating the Guix package definition."
  140. msgstr "Aggiornamento della definizione del pacchetto Guix."
  141. #. type: section
  142. #: guix-git/doc/contributing.texi:33 guix-git/doc/contributing.texi:1605
  143. #: guix-git/doc/contributing.texi:1606
  144. #, no-wrap
  145. msgid "Translating Guix"
  146. msgstr "Traduzione di Guix"
  147. #. type: menuentry
  148. #: guix-git/doc/contributing.texi:33
  149. msgid "Make Guix speak your native language."
  150. msgstr "Fai in modo che Guix parli la tua lingua madre."
  151. #. type: Plain text
  152. #: guix-git/doc/contributing.texi:40
  153. msgid "If you want to hack Guix itself, it is recommended to use the latest version from the Git repository:"
  154. msgstr ""
  155. #. type: example
  156. #: guix-git/doc/contributing.texi:43
  157. #, no-wrap
  158. msgid "git clone https://git.savannah.gnu.org/git/guix.git\n"
  159. msgstr ""
  160. #. type: cindex
  161. #: guix-git/doc/contributing.texi:45
  162. #, no-wrap
  163. msgid "authentication, of a Guix checkout"
  164. msgstr ""
  165. #. type: Plain text
  166. #: guix-git/doc/contributing.texi:50
  167. msgid "How do you ensure that you obtained a genuine copy of the repository? To do that, run @command{guix git authenticate}, passing it the commit and OpenPGP fingerprint of the @dfn{channel introduction} (@pxref{Invoking guix git authenticate}):"
  168. msgstr ""
  169. #. type: example
  170. #: guix-git/doc/contributing.texi:57
  171. #, no-wrap
  172. msgid ""
  173. "git fetch origin keyring:keyring\n"
  174. "guix git authenticate 9edb3f66fd807b096b48283debdcddccfea34bad \\\n"
  175. " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\"\n"
  176. msgstr ""
  177. #. type: Plain text
  178. #: guix-git/doc/contributing.texi:62
  179. msgid "This command completes with exit code zero on success; it prints an error message and exits with a non-zero code otherwise."
  180. msgstr ""
  181. #. type: Plain text
  182. #: guix-git/doc/contributing.texi:69
  183. msgid "As you can see, there is a chicken-and-egg problem: you first need to have Guix installed. Typically you would install Guix System (@pxref{System Installation}) or Guix on top of another distro (@pxref{Binary Installation}); in either case, you would verify the OpenPGP signature on the installation medium. This ``bootstraps'' the trust chain."
  184. msgstr ""
  185. #. type: Plain text
  186. #: guix-git/doc/contributing.texi:74
  187. msgid "The easiest way to set up a development environment for Guix is, of course, by using Guix! The following command starts a new shell where all the dependencies and appropriate environment variables are set up to hack on Guix:"
  188. msgstr ""
  189. #. type: example
  190. #: guix-git/doc/contributing.texi:77
  191. #, no-wrap
  192. msgid "guix environment guix --pure\n"
  193. msgstr ""
  194. #. type: Plain text
  195. #: guix-git/doc/contributing.texi:80
  196. msgid "@xref{Invoking guix environment}, for more information on that command."
  197. msgstr ""
  198. #. type: Plain text
  199. #: guix-git/doc/contributing.texi:84
  200. msgid "If you are unable to use Guix when building Guix from a checkout, the following are the required packages in addition to those mentioned in the installation instructions (@pxref{Requirements})."
  201. msgstr ""
  202. #. type: item
  203. #: guix-git/doc/contributing.texi:86
  204. #, no-wrap
  205. msgid "@url{https://gnu.org/software/autoconf/, GNU Autoconf};"
  206. msgstr ""
  207. #. type: item
  208. #: guix-git/doc/contributing.texi:87
  209. #, no-wrap
  210. msgid "@url{https://gnu.org/software/automake/, GNU Automake};"
  211. msgstr ""
  212. #. type: item
  213. #: guix-git/doc/contributing.texi:88
  214. #, no-wrap
  215. msgid "@url{https://gnu.org/software/gettext/, GNU Gettext};"
  216. msgstr ""
  217. #. type: item
  218. #: guix-git/doc/contributing.texi:89
  219. #, no-wrap
  220. msgid "@url{https://gnu.org/software/texinfo/, GNU Texinfo};"
  221. msgstr ""
  222. #. type: item
  223. #: guix-git/doc/contributing.texi:90
  224. #, no-wrap
  225. msgid "@url{https://www.graphviz.org/, Graphviz};"
  226. msgstr ""
  227. #. type: item
  228. #: guix-git/doc/contributing.texi:91
  229. #, no-wrap
  230. msgid "@url{https://www.gnu.org/software/help2man/, GNU Help2man (optional)}."
  231. msgstr ""
  232. #. type: Plain text
  233. #: guix-git/doc/contributing.texi:96
  234. msgid "On Guix, extra dependencies can be added by instead running @command{guix environment} with @option{--ad-hoc}:"
  235. msgstr ""
  236. #. type: example
  237. #: guix-git/doc/contributing.texi:99
  238. #, no-wrap
  239. msgid "guix environment guix --pure --ad-hoc help2man git strace\n"
  240. msgstr ""
  241. #. type: Plain text
  242. #: guix-git/doc/contributing.texi:103
  243. msgid "Run @command{./bootstrap} to generate the build system infrastructure using Autoconf and Automake. If you get an error like this one:"
  244. msgstr ""
  245. #. type: example
  246. #: guix-git/doc/contributing.texi:106
  247. #, no-wrap
  248. msgid "configure.ac:46: error: possibly undefined macro: PKG_CHECK_MODULES\n"
  249. msgstr ""
  250. #. type: Plain text
  251. #: guix-git/doc/contributing.texi:115
  252. msgid "it probably means that Autoconf couldn’t find @file{pkg.m4}, which is provided by pkg-config. Make sure that @file{pkg.m4} is available. The same holds for the @file{guile.m4} set of macros provided by Guile. For instance, if you installed Automake in @file{/usr/local}, it wouldn’t look for @file{.m4} files in @file{/usr/share}. In that case, you have to invoke the following command:"
  253. msgstr ""
  254. #. type: example
  255. #: guix-git/doc/contributing.texi:118
  256. #, no-wrap
  257. msgid "export ACLOCAL_PATH=/usr/share/aclocal\n"
  258. msgstr ""
  259. #. type: Plain text
  260. #: guix-git/doc/contributing.texi:122
  261. msgid "@xref{Macro Search Path,,, automake, The GNU Automake Manual}, for more information."
  262. msgstr ""
  263. #. type: Plain text
  264. #: guix-git/doc/contributing.texi:129
  265. msgid "Then, run @command{./configure} as usual. Make sure to pass @code{--localstatedir=@var{directory}} where @var{directory} is the @code{localstatedir} value used by your current installation (@pxref{The Store}, for information about this), usually @file{/var}. Note that you will probably not run @command{make install} at the end (you don't have to) but it's still important to pass the right @code{localstatedir}."
  266. msgstr ""
  267. #. type: Plain text
  268. #: guix-git/doc/contributing.texi:134
  269. msgid "Finally, you have to invoke @code{make && make check} to build Guix and run the tests (@pxref{Running the Test Suite}). If anything fails, take a look at installation instructions (@pxref{Installation}) or send a message to the @email{guix-devel@@gnu.org, mailing list}."
  270. msgstr ""
  271. #. type: Plain text
  272. #: guix-git/doc/contributing.texi:137
  273. msgid "From there on, you can authenticate all the commits included in your checkout by running:"
  274. msgstr ""
  275. #. type: example
  276. #: guix-git/doc/contributing.texi:140
  277. #, no-wrap
  278. msgid "make authenticate\n"
  279. msgstr ""
  280. #. type: Plain text
  281. #: guix-git/doc/contributing.texi:143
  282. msgid "The first run takes a couple of minutes, but subsequent runs are faster."
  283. msgstr ""
  284. #. type: Plain text
  285. #: guix-git/doc/contributing.texi:149
  286. msgid "Or, when your configuration for your local Git repository doesn't match the default one, you can provide the reference for the @code{keyring} branch through the variable @code{GUIX_GIT_KEYRING}. The following example assumes that you have a Git remote called @samp{myremote} pointing to the official repository:"
  287. msgstr ""
  288. #. type: example
  289. #: guix-git/doc/contributing.texi:152
  290. #, no-wrap
  291. msgid "make authenticate GUIX_GIT_KEYRING=myremote/keyring\n"
  292. msgstr ""
  293. #. type: quotation
  294. #: guix-git/doc/contributing.texi:154 guix-git/doc/contributing.texi:1416
  295. #: guix-git/doc/guix.texi:573 guix-git/doc/guix.texi:622
  296. #: guix-git/doc/guix.texi:800 guix-git/doc/guix.texi:1779
  297. #: guix-git/doc/guix.texi:2026 guix-git/doc/guix.texi:2210
  298. #: guix-git/doc/guix.texi:2431 guix-git/doc/guix.texi:2632
  299. #: guix-git/doc/guix.texi:3749 guix-git/doc/guix.texi:4490
  300. #: guix-git/doc/guix.texi:4504 guix-git/doc/guix.texi:4586
  301. #: guix-git/doc/guix.texi:4816 guix-git/doc/guix.texi:5666
  302. #: guix-git/doc/guix.texi:5912 guix-git/doc/guix.texi:6033
  303. #: guix-git/doc/guix.texi:6061 guix-git/doc/guix.texi:6114
  304. #: guix-git/doc/guix.texi:8816 guix-git/doc/guix.texi:8886
  305. #: guix-git/doc/guix.texi:10561 guix-git/doc/guix.texi:10601
  306. #: guix-git/doc/guix.texi:10874 guix-git/doc/guix.texi:10886
  307. #: guix-git/doc/guix.texi:13184 guix-git/doc/guix.texi:13814
  308. #: guix-git/doc/guix.texi:14597 guix-git/doc/guix.texi:15582
  309. #: guix-git/doc/guix.texi:18003 guix-git/doc/guix.texi:18160
  310. #: guix-git/doc/guix.texi:26024 guix-git/doc/guix.texi:29701
  311. #: guix-git/doc/guix.texi:31658 guix-git/doc/guix.texi:33267
  312. #: guix-git/doc/guix.texi:33501 guix-git/doc/guix.texi:33671
  313. #: guix-git/doc/guix.texi:33824 guix-git/doc/guix.texi:33926
  314. #: guix-git/doc/guix.texi:34027 guix-git/doc/guix.texi:34330
  315. #, no-wrap
  316. msgid "Note"
  317. msgstr "Note"
  318. #. type: quotation
  319. #: guix-git/doc/contributing.texi:158
  320. msgid "You are advised to run @command{make authenticate} after every @command{git pull} invocation. This ensures you keep receiving valid changes to the repository."
  321. msgstr ""
  322. #. type: Plain text
  323. #: guix-git/doc/contributing.texi:168
  324. msgid "In order to keep a sane working environment, you will find it useful to test the changes made in your local source tree checkout without actually installing them. So that you can distinguish between your ``end-user'' hat and your ``motley'' costume."
  325. msgstr ""
  326. #. type: Plain text
  327. #: guix-git/doc/contributing.texi:179
  328. msgid "To that end, all the command-line tools can be used even if you have not run @code{make install}. To do that, you first need to have an environment with all the dependencies available (@pxref{Building from Git}), and then simply prefix each command with @command{./pre-inst-env} (the @file{pre-inst-env} script lives in the top build tree of Guix; it is generated by running @command{./bootstrap} followed by @command{./configure}). As an example, here is how you would build the @code{hello} package as defined in your working tree (this assumes @command{guix-daemon} is already running on your system; it's OK if it's a different version):"
  329. msgstr ""
  330. #. type: example
  331. #: guix-git/doc/contributing.texi:182
  332. #, no-wrap
  333. msgid "$ ./pre-inst-env guix build hello\n"
  334. msgstr ""
  335. #. type: Plain text
  336. #: guix-git/doc/contributing.texi:186
  337. msgid "Similarly, an example for a Guile session using the Guix modules:"
  338. msgstr ""
  339. #. type: example
  340. #: guix-git/doc/contributing.texi:189
  341. #, no-wrap
  342. msgid ""
  343. "$ ./pre-inst-env guile -c '(use-modules (guix utils)) (pk (%current-system))'\n"
  344. "\n"
  345. msgstr ""
  346. #. type: example
  347. #: guix-git/doc/contributing.texi:191
  348. #, no-wrap
  349. msgid ";;; (\"x86_64-linux\")\n"
  350. msgstr ""
  351. #. type: cindex
  352. #: guix-git/doc/contributing.texi:194
  353. #, no-wrap
  354. msgid "REPL"
  355. msgstr ""
  356. #. type: cindex
  357. #: guix-git/doc/contributing.texi:195
  358. #, no-wrap
  359. msgid "read-eval-print loop"
  360. msgstr ""
  361. #. type: Plain text
  362. #: guix-git/doc/contributing.texi:198
  363. msgid "@dots{} and for a REPL (@pxref{Using Guile Interactively,,, guile, Guile Reference Manual}):"
  364. msgstr ""
  365. #. type: example
  366. #: guix-git/doc/contributing.texi:213
  367. #, no-wrap
  368. msgid ""
  369. "$ ./pre-inst-env guile\n"
  370. "scheme@@(guile-user)> ,use(guix)\n"
  371. "scheme@@(guile-user)> ,use(gnu)\n"
  372. "scheme@@(guile-user)> (define snakes\n"
  373. " (fold-packages\n"
  374. " (lambda (package lst)\n"
  375. " (if (string-prefix? \"python\"\n"
  376. " (package-name package))\n"
  377. " (cons package lst)\n"
  378. " lst))\n"
  379. " '()))\n"
  380. "scheme@@(guile-user)> (length snakes)\n"
  381. "$1 = 361\n"
  382. msgstr ""
  383. #. type: Plain text
  384. #: guix-git/doc/contributing.texi:221
  385. msgid "If you are hacking on the daemon and its supporting code or if @command{guix-daemon} is not already running on your system, you can launch it straight from the build tree@footnote{The @option{-E} flag to @command{sudo} guarantees that @code{GUILE_LOAD_PATH} is correctly set such that @command{guix-daemon} and the tools it uses can find the Guile modules they need.}:"
  386. msgstr ""
  387. #. type: example
  388. #: guix-git/doc/contributing.texi:224
  389. #, no-wrap
  390. msgid "$ sudo -E ./pre-inst-env guix-daemon --build-users-group=guixbuild\n"
  391. msgstr ""
  392. #. type: Plain text
  393. #: guix-git/doc/contributing.texi:228
  394. msgid "The @command{pre-inst-env} script sets up all the environment variables necessary to support this, including @env{PATH} and @env{GUILE_LOAD_PATH}."
  395. msgstr ""
  396. #. type: Plain text
  397. #: guix-git/doc/contributing.texi:233
  398. msgid "Note that @command{./pre-inst-env guix pull} does @emph{not} upgrade the local source tree; it simply updates the @file{~/.config/guix/current} symlink (@pxref{Invoking guix pull}). Run @command{git pull} instead if you want to upgrade your local source tree."
  399. msgstr ""
  400. #. type: Plain text
  401. #: guix-git/doc/contributing.texi:243
  402. msgid "The Perfect Setup to hack on Guix is basically the perfect setup used for Guile hacking (@pxref{Using Guile in Emacs,,, guile, Guile Reference Manual}). First, you need more than an editor, you need @url{https://www.gnu.org/software/emacs, Emacs}, empowered by the wonderful @url{https://nongnu.org/geiser/, Geiser}. To set that up, run:"
  403. msgstr ""
  404. #. type: example
  405. #: guix-git/doc/contributing.texi:246
  406. #, no-wrap
  407. msgid "guix package -i emacs guile emacs-geiser emacs-geiser-guile\n"
  408. msgstr ""
  409. #. type: Plain text
  410. #: guix-git/doc/contributing.texi:255
  411. msgid "Geiser allows for interactive and incremental development from within Emacs: code compilation and evaluation from within buffers, access to on-line documentation (docstrings), context-sensitive completion, @kbd{M-.} to jump to an object definition, a REPL to try out your code, and more (@pxref{Introduction,,, geiser, Geiser User Manual}). For convenient Guix development, make sure to augment Guile’s load path so that it finds source files from your checkout:"
  412. msgstr ""
  413. #. type: lisp
  414. #: guix-git/doc/contributing.texi:260
  415. #, no-wrap
  416. msgid ""
  417. ";; @r{Assuming the Guix checkout is in ~/src/guix.}\n"
  418. "(with-eval-after-load 'geiser-guile\n"
  419. " (add-to-list 'geiser-guile-load-path \"~/src/guix\"))\n"
  420. msgstr ""
  421. #. type: Plain text
  422. #: guix-git/doc/contributing.texi:268
  423. msgid "To actually edit the code, Emacs already has a neat Scheme mode. But in addition to that, you must not miss @url{https://www.emacswiki.org/emacs/ParEdit, Paredit}. It provides facilities to directly operate on the syntax tree, such as raising an s-expression or wrapping it, swallowing or rejecting the following s-expression, etc."
  424. msgstr ""
  425. #. type: cindex
  426. #: guix-git/doc/contributing.texi:269
  427. #, no-wrap
  428. msgid "code snippets"
  429. msgstr ""
  430. #. type: cindex
  431. #: guix-git/doc/contributing.texi:270
  432. #, no-wrap
  433. msgid "templates"
  434. msgstr "modelli"
  435. #. type: cindex
  436. #: guix-git/doc/contributing.texi:271
  437. #, no-wrap
  438. msgid "reducing boilerplate"
  439. msgstr ""
  440. #. type: Plain text
  441. #: guix-git/doc/contributing.texi:278
  442. msgid "We also provide templates for common git commit messages and package definitions in the @file{etc/snippets} directory. These templates can be used with @url{https://joaotavora.github.io/yasnippet/, YASnippet} to expand short trigger strings to interactive text snippets. You may want to add the snippets directory to the @var{yas-snippet-dirs} variable in Emacs."
  443. msgstr ""
  444. #. type: lisp
  445. #: guix-git/doc/contributing.texi:283
  446. #, no-wrap
  447. msgid ""
  448. ";; @r{Assuming the Guix checkout is in ~/src/guix.}\n"
  449. "(with-eval-after-load 'yasnippet\n"
  450. " (add-to-list 'yas-snippet-dirs \"~/src/guix/etc/snippets\"))\n"
  451. msgstr ""
  452. #. type: Plain text
  453. #: guix-git/doc/contributing.texi:291
  454. msgid "The commit message snippets depend on @url{https://magit.vc/, Magit} to display staged files. When editing a commit message type @code{add} followed by @kbd{TAB} to insert a commit message template for adding a package; type @code{update} followed by @kbd{TAB} to insert a template for updating a package; type @code{https} followed by @kbd{TAB} to insert a template for changing the home page URI of a package to HTTPS."
  455. msgstr ""
  456. #. type: Plain text
  457. #: guix-git/doc/contributing.texi:297
  458. msgid "The main snippet for @code{scheme-mode} is triggered by typing @code{package...} followed by @kbd{TAB}. This snippet also inserts the trigger string @code{origin...}, which can be expanded further. The @code{origin} snippet in turn may insert other trigger strings ending on @code{...}, which also can be expanded further."
  459. msgstr ""
  460. #. type: cindex
  461. #: guix-git/doc/contributing.texi:298
  462. #, no-wrap
  463. msgid "insert or update copyright"
  464. msgstr ""
  465. #. type: code{#1}
  466. #: guix-git/doc/contributing.texi:299
  467. #, no-wrap
  468. msgid "M-x guix-copyright"
  469. msgstr ""
  470. #. type: code{#1}
  471. #: guix-git/doc/contributing.texi:300
  472. #, no-wrap
  473. msgid "M-x copyright-update"
  474. msgstr ""
  475. #. type: Plain text
  476. #: guix-git/doc/contributing.texi:304
  477. msgid "We additionally provide insertion and automatic update of a copyright in @file{etc/copyright.el}. You may want to set your full name, mail, and load a file."
  478. msgstr ""
  479. #. type: lisp
  480. #: guix-git/doc/contributing.texi:310
  481. #, no-wrap
  482. msgid ""
  483. "(setq user-full-name \"Alice Doe\")\n"
  484. "(setq user-mail-address \"alice@@mail.org\")\n"
  485. ";; @r{Assuming the Guix checkout is in ~/src/guix.}\n"
  486. "(load-file \"~/src/guix/etc/copyright.el\")\n"
  487. msgstr ""
  488. #. type: Plain text
  489. #: guix-git/doc/contributing.texi:313
  490. msgid "To insert a copyright at the current line invoke @code{M-x guix-copyright}."
  491. msgstr ""
  492. #. type: Plain text
  493. #: guix-git/doc/contributing.texi:315
  494. msgid "To update a copyright you need to specify a @code{copyright-names-regexp}."
  495. msgstr ""
  496. #. type: lisp
  497. #: guix-git/doc/contributing.texi:319
  498. #, no-wrap
  499. msgid ""
  500. "(setq copyright-names-regexp\n"
  501. " (format \"%s <%s>\" user-full-name user-mail-address))\n"
  502. msgstr ""
  503. #. type: Plain text
  504. #: guix-git/doc/contributing.texi:325
  505. msgid "You can check if your copyright is up to date by evaluating @code{M-x copyright-update}. If you want to do it automatically after each buffer save then add @code{(add-hook 'after-save-hook 'copyright-update)} in Emacs."
  506. msgstr ""
  507. #. type: cindex
  508. #: guix-git/doc/contributing.texi:329
  509. #, no-wrap
  510. msgid "packages, creating"
  511. msgstr ""
  512. #. type: Plain text
  513. #: guix-git/doc/contributing.texi:333
  514. msgid "The GNU distribution is nascent and may well lack some of your favorite packages. This section describes how you can help make the distribution grow."
  515. msgstr ""
  516. #. type: Plain text
  517. #: guix-git/doc/contributing.texi:341
  518. msgid "Free software packages are usually distributed in the form of @dfn{source code tarballs}---typically @file{tar.gz} files that contain all the source files. Adding a package to the distribution means essentially two things: adding a @dfn{recipe} that describes how to build the package, including a list of other packages required to build it, and adding @dfn{package metadata} along with that recipe, such as a description and licensing information."
  519. msgstr ""
  520. #. type: Plain text
  521. #: guix-git/doc/contributing.texi:350
  522. msgid "In Guix all this information is embodied in @dfn{package definitions}. Package definitions provide a high-level view of the package. They are written using the syntax of the Scheme programming language; in fact, for each package we define a variable bound to the package definition, and export that variable from a module (@pxref{Package Modules}). However, in-depth Scheme knowledge is @emph{not} a prerequisite for creating packages. For more information on package definitions, @pxref{Defining Packages}."
  523. msgstr ""
  524. #. type: Plain text
  525. #: guix-git/doc/contributing.texi:356
  526. msgid "Once a package definition is in place, stored in a file in the Guix source tree, it can be tested using the @command{guix build} command (@pxref{Invoking guix build}). For example, assuming the new package is called @code{gnew}, you may run this command from the Guix build tree (@pxref{Running Guix Before It Is Installed}):"
  527. msgstr ""
  528. #. type: example
  529. #: guix-git/doc/contributing.texi:359
  530. #, no-wrap
  531. msgid "./pre-inst-env guix build gnew --keep-failed\n"
  532. msgstr ""
  533. #. type: Plain text
  534. #: guix-git/doc/contributing.texi:365
  535. msgid "Using @code{--keep-failed} makes it easier to debug build failures since it provides access to the failed build tree. Another useful command-line option when debugging is @code{--log-file}, to access the build log."
  536. msgstr ""
  537. #. type: Plain text
  538. #: guix-git/doc/contributing.texi:370
  539. msgid "If the package is unknown to the @command{guix} command, it may be that the source file contains a syntax error, or lacks a @code{define-public} clause to export the package variable. To figure it out, you may load the module from Guile to get more information about the actual error:"
  540. msgstr ""
  541. #. type: example
  542. #: guix-git/doc/contributing.texi:373
  543. #, no-wrap
  544. msgid "./pre-inst-env guile -c '(use-modules (gnu packages gnew))'\n"
  545. msgstr ""
  546. #. type: Plain text
  547. #: guix-git/doc/contributing.texi:380
  548. msgid "Once your package builds correctly, please send us a patch (@pxref{Submitting Patches}). Well, if you need help, we will be happy to help you too. Once the patch is committed in the Guix repository, the new package automatically gets built on the supported platforms by @url{https://@value{SUBSTITUTE-SERVER-1}, our continuous integration system}."
  549. msgstr ""
  550. #. type: cindex
  551. #: guix-git/doc/contributing.texi:381
  552. #, no-wrap
  553. msgid "substituter"
  554. msgstr ""
  555. #. type: Plain text
  556. #: guix-git/doc/contributing.texi:388
  557. msgid "Users can obtain the new package definition simply by running @command{guix pull} (@pxref{Invoking guix pull}). When @code{@value{SUBSTITUTE-SERVER-1}} is done building the package, installing the package automatically downloads binaries from there (@pxref{Substitutes}). The only place where human intervention is needed is to review and apply the patch."
  558. msgstr ""
  559. #. type: subsection
  560. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:404
  561. #: guix-git/doc/contributing.texi:405
  562. #, no-wrap
  563. msgid "Software Freedom"
  564. msgstr ""
  565. #. type: menuentry
  566. #: guix-git/doc/contributing.texi:402
  567. msgid "What may go into the distribution."
  568. msgstr ""
  569. #. type: subsection
  570. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:432
  571. #: guix-git/doc/contributing.texi:433
  572. #, no-wrap
  573. msgid "Package Naming"
  574. msgstr ""
  575. #. type: menuentry
  576. #: guix-git/doc/contributing.texi:402
  577. msgid "What's in a name?"
  578. msgstr ""
  579. #. type: subsection
  580. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:465
  581. #: guix-git/doc/contributing.texi:466
  582. #, no-wrap
  583. msgid "Version Numbers"
  584. msgstr ""
  585. #. type: menuentry
  586. #: guix-git/doc/contributing.texi:402
  587. msgid "When the name is not enough."
  588. msgstr ""
  589. #. type: subsection
  590. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:572
  591. #: guix-git/doc/contributing.texi:573
  592. #, no-wrap
  593. msgid "Synopses and Descriptions"
  594. msgstr ""
  595. #. type: menuentry
  596. #: guix-git/doc/contributing.texi:402
  597. msgid "Helping users find the right package."
  598. msgstr ""
  599. #. type: subsection
  600. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:651
  601. #: guix-git/doc/contributing.texi:652
  602. #, no-wrap
  603. msgid "Snippets versus Phases"
  604. msgstr ""
  605. #. type: menuentry
  606. #: guix-git/doc/contributing.texi:402
  607. msgid "Whether to use a snippet, or a build phase."
  608. msgstr ""
  609. #. type: subsection
  610. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:666
  611. #: guix-git/doc/contributing.texi:667 guix-git/doc/guix.texi:1961
  612. #, no-wrap
  613. msgid "Emacs Packages"
  614. msgstr ""
  615. #. type: menuentry
  616. #: guix-git/doc/contributing.texi:402
  617. msgid "Your Elisp fix."
  618. msgstr ""
  619. #. type: subsection
  620. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:706
  621. #: guix-git/doc/contributing.texi:707
  622. #, no-wrap
  623. msgid "Python Modules"
  624. msgstr ""
  625. #. type: menuentry
  626. #: guix-git/doc/contributing.texi:402
  627. msgid "A touch of British comedy."
  628. msgstr ""
  629. #. type: subsection
  630. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:782
  631. #: guix-git/doc/contributing.texi:783
  632. #, no-wrap
  633. msgid "Perl Modules"
  634. msgstr ""
  635. #. type: menuentry
  636. #: guix-git/doc/contributing.texi:402
  637. msgid "Little pearls."
  638. msgstr ""
  639. #. type: subsection
  640. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:798
  641. #: guix-git/doc/contributing.texi:799
  642. #, no-wrap
  643. msgid "Java Packages"
  644. msgstr ""
  645. #. type: menuentry
  646. #: guix-git/doc/contributing.texi:402
  647. msgid "Coffee break."
  648. msgstr ""
  649. #. type: subsection
  650. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:818
  651. #: guix-git/doc/contributing.texi:819
  652. #, no-wrap
  653. msgid "Rust Crates"
  654. msgstr ""
  655. #. type: menuentry
  656. #: guix-git/doc/contributing.texi:402
  657. msgid "Beware of oxidation."
  658. msgstr ""
  659. #. type: subsection
  660. #: guix-git/doc/contributing.texi:402 guix-git/doc/contributing.texi:852
  661. #: guix-git/doc/contributing.texi:853
  662. #, no-wrap
  663. msgid "Fonts"
  664. msgstr "Font"
  665. #. type: menuentry
  666. #: guix-git/doc/contributing.texi:402
  667. msgid "Fond of fonts."
  668. msgstr ""
  669. #. type: cindex
  670. #: guix-git/doc/contributing.texi:408
  671. #, no-wrap
  672. msgid "free software"
  673. msgstr "software libero"
  674. #. type: Plain text
  675. #: guix-git/doc/contributing.texi:416
  676. msgid "The GNU operating system has been developed so that users can have freedom in their computing. GNU is @dfn{free software}, meaning that users have the @url{https://www.gnu.org/philosophy/free-sw.html,four essential freedoms}: to run the program, to study and change the program in source code form, to redistribute exact copies, and to distribute modified versions. Packages found in the GNU distribution provide only software that conveys these four freedoms."
  677. msgstr ""
  678. #. type: Plain text
  679. #: guix-git/doc/contributing.texi:422
  680. msgid "In addition, the GNU distribution follow the @url{https://www.gnu.org/distros/free-system-distribution-guidelines.html,free software distribution guidelines}. Among other things, these guidelines reject non-free firmware, recommendations of non-free software, and discuss ways to deal with trademarks and patents."
  681. msgstr ""
  682. #. type: Plain text
  683. #: guix-git/doc/contributing.texi:430
  684. msgid "Some otherwise free upstream package sources contain a small and optional subset that violates the above guidelines, for instance because this subset is itself non-free code. When that happens, the offending items are removed with appropriate patches or code snippets in the @code{origin} form of the package (@pxref{Defining Packages}). This way, @code{guix build --source} returns the ``freed'' source rather than the unmodified upstream source."
  685. msgstr ""
  686. #. type: cindex
  687. #: guix-git/doc/contributing.texi:435
  688. #, no-wrap
  689. msgid "package name"
  690. msgstr ""
  691. #. type: Plain text
  692. #: guix-git/doc/contributing.texi:443
  693. msgid "A package actually has two names associated with it. First, there is the name of the @emph{Scheme variable}, the one following @code{define-public}. By this name, the package can be made known in the Scheme code, for instance as input to another package. Second, there is the string in the @code{name} field of a package definition. This name is used by package management commands such as @command{guix package} and @command{guix build}."
  694. msgstr ""
  695. #. type: Plain text
  696. #: guix-git/doc/contributing.texi:448
  697. msgid "Both are usually the same and correspond to the lowercase conversion of the project name chosen upstream, with underscores replaced with hyphens. For instance, GNUnet is available as @code{gnunet}, and SDL_net as @code{sdl-net}."
  698. msgstr ""
  699. #. type: Plain text
  700. #: guix-git/doc/contributing.texi:456
  701. msgid "A noteworthy exception to this rule is when the project name is only a single character, or if an older maintained project with the same name already exists---regardless of whether it has already been packaged for Guix. Use common sense to make such names unambiguous and meaningful. For example, Guix's package for the shell called ``s'' upstream is @code{s-shell} and @emph{not} @code{s}. Feel free to ask your fellow hackers for inspiration."
  702. msgstr ""
  703. #. type: Plain text
  704. #: guix-git/doc/contributing.texi:461
  705. msgid "We do not add @code{lib} prefixes for library packages, unless these are already part of the official project name. But @pxref{Python Modules} and @ref{Perl Modules} for special rules concerning modules for the Python and Perl languages."
  706. msgstr ""
  707. #. type: Plain text
  708. #: guix-git/doc/contributing.texi:463
  709. msgid "Font package names are handled differently, @pxref{Fonts}."
  710. msgstr ""
  711. #. type: cindex
  712. #: guix-git/doc/contributing.texi:468
  713. #, no-wrap
  714. msgid "package version"
  715. msgstr ""
  716. #. type: Plain text
  717. #: guix-git/doc/contributing.texi:477
  718. msgid "We usually package only the latest version of a given free software project. But sometimes, for instance for incompatible library versions, two (or more) versions of the same package are needed. These require different Scheme variable names. We use the name as defined in @ref{Package Naming} for the most recent version; previous versions use the same name, suffixed by @code{-} and the smallest prefix of the version number that may distinguish the two versions."
  719. msgstr ""
  720. #. type: Plain text
  721. #: guix-git/doc/contributing.texi:480
  722. msgid "The name inside the package definition is the same for all versions of a package and does not contain any version number."
  723. msgstr ""
  724. #. type: Plain text
  725. #: guix-git/doc/contributing.texi:482
  726. msgid "For instance, the versions 2.24.20 and 3.9.12 of GTK+ may be packaged as follows:"
  727. msgstr ""
  728. #. type: lisp
  729. #: guix-git/doc/contributing.texi:494
  730. #, no-wrap
  731. msgid ""
  732. "(define-public gtk+\n"
  733. " (package\n"
  734. " (name \"gtk+\")\n"
  735. " (version \"3.9.12\")\n"
  736. " ...))\n"
  737. "(define-public gtk+-2\n"
  738. " (package\n"
  739. " (name \"gtk+\")\n"
  740. " (version \"2.24.20\")\n"
  741. " ...))\n"
  742. msgstr ""
  743. #. type: Plain text
  744. #: guix-git/doc/contributing.texi:496
  745. msgid "If we also wanted GTK+ 3.8.2, this would be packaged as"
  746. msgstr ""
  747. #. type: lisp
  748. #: guix-git/doc/contributing.texi:502
  749. #, no-wrap
  750. msgid ""
  751. "(define-public gtk+-3.8\n"
  752. " (package\n"
  753. " (name \"gtk+\")\n"
  754. " (version \"3.8.2\")\n"
  755. " ...))\n"
  756. msgstr ""
  757. #. type: cindex
  758. #: guix-git/doc/contributing.texi:506
  759. #, no-wrap
  760. msgid "version number, for VCS snapshots"
  761. msgstr ""
  762. #. type: Plain text
  763. #: guix-git/doc/contributing.texi:512
  764. msgid "Occasionally, we package snapshots of upstream's version control system (VCS) instead of formal releases. This should remain exceptional, because it is up to upstream developers to clarify what the stable release is. Yet, it is sometimes necessary. So, what should we put in the @code{version} field?"
  765. msgstr ""
  766. #. type: Plain text
  767. #: guix-git/doc/contributing.texi:520
  768. msgid "Clearly, we need to make the commit identifier of the VCS snapshot visible in the version string, but we also need to make sure that the version string is monotonically increasing so that @command{guix package --upgrade} can determine which version is newer. Since commit identifiers, notably with Git, are not monotonically increasing, we add a revision number that we increase each time we upgrade to a newer snapshot. The resulting version string looks like this:"
  769. msgstr ""
  770. #. type: example
  771. #: guix-git/doc/contributing.texi:529
  772. #, no-wrap
  773. msgid ""
  774. "2.0.11-3.cabba9e\n"
  775. " ^ ^ ^\n"
  776. " | | `-- upstream commit ID\n"
  777. " | |\n"
  778. " | `--- Guix package revision\n"
  779. " |\n"
  780. "latest upstream version\n"
  781. msgstr ""
  782. #. type: Plain text
  783. #: guix-git/doc/contributing.texi:539
  784. msgid "It is a good idea to strip commit identifiers in the @code{version} field to, say, 7 digits. It avoids an aesthetic annoyance (assuming aesthetics have a role to play here) as well as problems related to OS limits such as the maximum shebang length (127 bytes for the Linux kernel). There are helper functions for doing this for packages using @code{git-fetch} or @code{hg-fetch} (see below). It is best to use the full commit identifiers in @code{origin}s, though, to avoid ambiguities. A typical package definition may look like this:"
  785. msgstr ""
  786. #. type: lisp
  787. #: guix-git/doc/contributing.texi:556
  788. #, no-wrap
  789. msgid ""
  790. "(define my-package\n"
  791. " (let ((commit \"c3f29bc928d5900971f65965feaae59e1272a3f7\")\n"
  792. " (revision \"1\")) ;Guix package revision\n"
  793. " (package\n"
  794. " (version (git-version \"0.9\" revision commit))\n"
  795. " (source (origin\n"
  796. " (method git-fetch)\n"
  797. " (uri (git-reference\n"
  798. " (url \"git://example.org/my-package.git\")\n"
  799. " (commit commit)))\n"
  800. " (sha256 (base32 \"1mbikn@dots{}\"))\n"
  801. " (file-name (git-file-name name version))))\n"
  802. " ;; @dots{}\n"
  803. " )))\n"
  804. msgstr ""
  805. #. type: deffn
  806. #: guix-git/doc/contributing.texi:558
  807. #, no-wrap
  808. msgid "{Scheme Procedure} git-version @var{VERSION} @var{REVISION} @var{COMMIT}"
  809. msgstr ""
  810. #. type: deffn
  811. #: guix-git/doc/contributing.texi:560
  812. msgid "Return the version string for packages using @code{git-fetch}."
  813. msgstr ""
  814. #. type: lisp
  815. #: guix-git/doc/contributing.texi:564
  816. #, no-wrap
  817. msgid ""
  818. "(git-version \"0.2.3\" \"0\" \"93818c936ee7e2f1ba1b315578bde363a7d43d05\")\n"
  819. "@result{} \"0.2.3-0.93818c9\"\n"
  820. msgstr ""
  821. #. type: deffn
  822. #: guix-git/doc/contributing.texi:567
  823. #, no-wrap
  824. msgid "{Scheme Procedure} hg-version @var{VERSION} @var{REVISION} @var{CHANGESET}"
  825. msgstr ""
  826. #. type: deffn
  827. #: guix-git/doc/contributing.texi:570
  828. msgid "Return the version string for packages using @code{hg-fetch}. It works in the same way as @code{git-version}."
  829. msgstr ""
  830. #. type: cindex
  831. #: guix-git/doc/contributing.texi:575
  832. #, no-wrap
  833. msgid "package description"
  834. msgstr ""
  835. #. type: cindex
  836. #: guix-git/doc/contributing.texi:576
  837. #, no-wrap
  838. msgid "package synopsis"
  839. msgstr ""
  840. #. type: Plain text
  841. #: guix-git/doc/contributing.texi:583
  842. msgid "As we have seen before, each package in GNU@tie{}Guix includes a synopsis and a description (@pxref{Defining Packages}). Synopses and descriptions are important: They are what @command{guix package --search} searches, and a crucial piece of information to help users determine whether a given package suits their needs. Consequently, packagers should pay attention to what goes into them."
  843. msgstr ""
  844. #. type: Plain text
  845. #: guix-git/doc/contributing.texi:591
  846. msgid "Synopses must start with a capital letter and must not end with a period. They must not start with ``a'' or ``the'', which usually does not bring anything; for instance, prefer ``File-frobbing tool'' over ``A tool that frobs files''. The synopsis should say what the package is---e.g., ``Core GNU utilities (file, text, shell)''---or what it is used for---e.g., the synopsis for GNU@tie{}grep is ``Print lines matching a pattern''."
  847. msgstr ""
  848. #. type: Plain text
  849. #: guix-git/doc/contributing.texi:601
  850. msgid "Keep in mind that the synopsis must be meaningful for a very wide audience. For example, ``Manipulate alignments in the SAM format'' might make sense for a seasoned bioinformatics researcher, but might be fairly unhelpful or even misleading to a non-specialized audience. It is a good idea to come up with a synopsis that gives an idea of the application domain of the package. In this example, this might give something like ``Manipulate nucleotide sequence alignments'', which hopefully gives the user a better idea of whether this is what they are looking for."
  851. msgstr ""
  852. #. type: Plain text
  853. #: guix-git/doc/contributing.texi:609
  854. msgid "Descriptions should take between five and ten lines. Use full sentences, and avoid using acronyms without first introducing them. Please avoid marketing phrases such as ``world-leading'', ``industrial-strength'', and ``next-generation'', and avoid superlatives like ``the most advanced''---they are not helpful to users looking for a package and may even sound suspicious. Instead, try to be factual, mentioning use cases and features."
  855. msgstr ""
  856. #. type: cindex
  857. #: guix-git/doc/contributing.texi:610
  858. #, no-wrap
  859. msgid "Texinfo markup, in package descriptions"
  860. msgstr ""
  861. #. type: Plain text
  862. #: guix-git/doc/contributing.texi:619
  863. msgid "Descriptions can include Texinfo markup, which is useful to introduce ornaments such as @code{@@code} or @code{@@dfn}, bullet lists, or hyperlinks (@pxref{Overview,,, texinfo, GNU Texinfo}). However you should be careful when using some characters for example @samp{@@} and curly braces which are the basic special characters in Texinfo (@pxref{Special Characters,,, texinfo, GNU Texinfo}). User interfaces such as @command{guix package --show} take care of rendering it appropriately."
  864. msgstr ""
  865. #. type: Plain text
  866. #: guix-git/doc/contributing.texi:625
  867. msgid "Synopses and descriptions are translated by volunteers @uref{https://translate.fedoraproject.org/projects/guix/packages, at Weblate} so that as many users as possible can read them in their native language. User interfaces search them and display them in the language specified by the current locale."
  868. msgstr ""
  869. #. type: Plain text
  870. #: guix-git/doc/contributing.texi:630
  871. msgid "To allow @command{xgettext} to extract them as translatable strings, synopses and descriptions @emph{must be literal strings}. This means that you cannot use @code{string-append} or @code{format} to construct these strings:"
  872. msgstr ""
  873. #. type: lisp
  874. #: guix-git/doc/contributing.texi:636
  875. #, no-wrap
  876. msgid ""
  877. "(package\n"
  878. " ;; @dots{}\n"
  879. " (synopsis \"This is translatable\")\n"
  880. " (description (string-append \"This is \" \"*not*\" \" translatable.\")))\n"
  881. msgstr ""
  882. #. type: Plain text
  883. #: guix-git/doc/contributing.texi:644
  884. msgid "Translation is a lot of work so, as a packager, please pay even more attention to your synopses and descriptions as every change may entail additional work for translators. In order to help them, it is possible to make recommendations or instructions visible to them by inserting special comments like this (@pxref{xgettext Invocation,,, gettext, GNU Gettext}):"
  885. msgstr ""
  886. #. type: lisp
  887. #: guix-git/doc/contributing.texi:649
  888. #, no-wrap
  889. msgid ""
  890. ";; TRANSLATORS: \"X11 resize-and-rotate\" should not be translated.\n"
  891. "(description \"ARandR is designed to provide a simple visual front end\n"
  892. "for the X11 resize-and-rotate (RandR) extension. @dots{}\")\n"
  893. msgstr ""
  894. #. type: cindex
  895. #: guix-git/doc/contributing.texi:654
  896. #, no-wrap
  897. msgid "snippets, when to use"
  898. msgstr ""
  899. #. type: Plain text
  900. #: guix-git/doc/contributing.texi:665
  901. msgid "The boundary between using an origin snippet versus a build phase to modify the sources of a package can be elusive. Origin snippets are typically used to remove unwanted files such as bundled libraries, nonfree sources, or to apply simple substitutions. The source derived from an origin should produce a source that can be used to build the package on any system that the upstream package supports (i.e., act as the corresponding source). In particular, origin snippets must not embed store items in the sources; such patching should rather be done using build phases. Refer to the @code{origin} record documentation for more information (@pxref{origin Reference})."
  902. msgstr ""
  903. #. type: cindex
  904. #: guix-git/doc/contributing.texi:669
  905. #, no-wrap
  906. msgid "emacs, packaging"
  907. msgstr ""
  908. #. type: cindex
  909. #: guix-git/doc/contributing.texi:670
  910. #, no-wrap
  911. msgid "elisp, packaging"
  912. msgstr ""
  913. #. type: Plain text
  914. #: guix-git/doc/contributing.texi:682
  915. msgid "Emacs packages should preferably use the Emacs build system (@pxref{emacs-build-system}), for uniformity and the benefits provided by its build phases, such as the auto-generation of the autoloads file and the byte compilation of the sources. Because there is no standardized way to run a test suite for Emacs packages, tests are disabled by default. When a test suite is available, it should be enabled by setting the @code{#:tests?} argument to @code{#true}. By default, the command to run the test is @command{make check}, but any command can be specified via the @code{#:test-command} argument. The @code{#:test-command} argument expects a list containing a command and its arguments, to be invoked during the @code{check} phase."
  916. msgstr ""
  917. #. type: Plain text
  918. #: guix-git/doc/contributing.texi:687
  919. msgid "The Elisp dependencies of Emacs packages are typically provided as @code{propagated-inputs} when required at run time. As for other packages, build or test dependencies should be specified as @code{native-inputs}."
  920. msgstr ""
  921. #. type: Plain text
  922. #: guix-git/doc/contributing.texi:696
  923. msgid "Emacs packages sometimes depend on resources directories that should be installed along the Elisp files. The @code{#:include} argument can be used for that purpose, by specifying a list of regexps to match. The best practice when using the @code{#:include} argument is to extend rather than override its default value (accessible via the @code{%default-include} variable). As an example, a yasnippet extension package typically include a @file{snippets} directory, which could be copied to the installation directory using:"
  924. msgstr ""
  925. #. type: lisp
  926. #: guix-git/doc/contributing.texi:699
  927. #, no-wrap
  928. msgid "#:include (cons \"^snippets/\" %default-include))\n"
  929. msgstr ""
  930. #. type: Plain text
  931. #: guix-git/doc/contributing.texi:705
  932. msgid "When encountering problems, it is wise to check for the presence of the @code{Package-Requires} extension header in the package main source file, and whether any dependencies and their versions listed therein are satisfied."
  933. msgstr ""
  934. #. type: cindex
  935. #: guix-git/doc/contributing.texi:709
  936. #, no-wrap
  937. msgid "python"
  938. msgstr "python"
  939. #. type: Plain text
  940. #: guix-git/doc/contributing.texi:715
  941. msgid "We currently package Python 2 and Python 3, under the Scheme variable names @code{python-2} and @code{python} as explained in @ref{Version Numbers}. To avoid confusion and naming clashes with other programming languages, it seems desirable that the name of a package for a Python module contains the word @code{python}."
  942. msgstr ""
  943. #. type: Plain text
  944. #: guix-git/doc/contributing.texi:722
  945. msgid "Some modules are compatible with only one version of Python, others with both. If the package Foo is compiled with Python 3, we name it @code{python-foo}. If it is compiled with Python 2, we name it @code{python2-foo}. Packages should be added when they are necessary; we don't add Python 2 variants of the package unless we are going to use them."
  946. msgstr ""
  947. #. type: Plain text
  948. #: guix-git/doc/contributing.texi:728
  949. msgid "If a project already contains the word @code{python}, we drop this; for instance, the module python-dateutil is packaged under the names @code{python-dateutil} and @code{python2-dateutil}. If the project name starts with @code{py} (e.g.@: @code{pytz}), we keep it and prefix it as described above."
  950. msgstr ""
  951. #. type: subsubsection
  952. #: guix-git/doc/contributing.texi:729
  953. #, no-wrap
  954. msgid "Specifying Dependencies"
  955. msgstr ""
  956. #. type: cindex
  957. #: guix-git/doc/contributing.texi:730
  958. #, no-wrap
  959. msgid "inputs, for Python packages"
  960. msgstr ""
  961. #. type: Plain text
  962. #: guix-git/doc/contributing.texi:735
  963. msgid "Dependency information for Python packages is usually available in the package source tree, with varying degrees of accuracy: in the @file{setup.py} file, in @file{requirements.txt}, or in @file{tox.ini}."
  964. msgstr ""
  965. #. type: Plain text
  966. #: guix-git/doc/contributing.texi:741
  967. msgid "Your mission, when writing a recipe for a Python package, is to map these dependencies to the appropriate type of ``input'' (@pxref{package Reference, inputs}). Although the @code{pypi} importer normally does a good job (@pxref{Invoking guix import}), you may want to check the following check list to determine which dependency goes where."
  968. msgstr ""
  969. #. type: itemize
  970. #: guix-git/doc/contributing.texi:749
  971. msgid "We currently package Python 2 with @code{setuptools} and @code{pip} installed like Python 3.4 has per default. Thus you don't need to specify either of these as an input. @command{guix lint} will warn you if you do."
  972. msgstr ""
  973. #. type: itemize
  974. #: guix-git/doc/contributing.texi:755
  975. msgid "Python dependencies required at run time go into @code{propagated-inputs}. They are typically defined with the @code{install_requires} keyword in @file{setup.py}, or in the @file{requirements.txt} file."
  976. msgstr ""
  977. #. type: itemize
  978. #: guix-git/doc/contributing.texi:763
  979. msgid "Python packages required only at build time---e.g., those listed with the @code{setup_requires} keyword in @file{setup.py}---or only for testing---e.g., those in @code{tests_require}---go into @code{native-inputs}. The rationale is that (1) they do not need to be propagated because they are not needed at run time, and (2) in a cross-compilation context, it's the ``native'' input that we'd want."
  980. msgstr ""
  981. #. type: itemize
  982. #: guix-git/doc/contributing.texi:767
  983. msgid "Examples are the @code{pytest}, @code{mock}, and @code{nose} test frameworks. Of course if any of these packages is also required at run-time, it needs to go to @code{propagated-inputs}."
  984. msgstr ""
  985. #. type: itemize
  986. #: guix-git/doc/contributing.texi:772
  987. msgid "Anything that does not fall in the previous categories goes to @code{inputs}, for example programs or C libraries required for building Python packages containing C extensions."
  988. msgstr ""
  989. #. type: itemize
  990. #: guix-git/doc/contributing.texi:778
  991. msgid "If a Python package has optional dependencies (@code{extras_require}), it is up to you to decide whether to add them or not, based on their usefulness/overhead ratio (@pxref{Submitting Patches, @command{guix size}})."
  992. msgstr ""
  993. #. type: cindex
  994. #: guix-git/doc/contributing.texi:785
  995. #, no-wrap
  996. msgid "perl"
  997. msgstr ""
  998. #. type: Plain text
  999. #: guix-git/doc/contributing.texi:796
  1000. msgid "Perl programs standing for themselves are named as any other package, using the lowercase upstream name. For Perl packages containing a single class, we use the lowercase class name, replace all occurrences of @code{::} by dashes and prepend the prefix @code{perl-}. So the class @code{XML::Parser} becomes @code{perl-xml-parser}. Modules containing several classes keep their lowercase upstream name and are also prepended by @code{perl-}. Such modules tend to have the word @code{perl} somewhere in their name, which gets dropped in favor of the prefix. For instance, @code{libwww-perl} becomes @code{perl-libwww}."
  1001. msgstr ""
  1002. #. type: cindex
  1003. #: guix-git/doc/contributing.texi:801
  1004. #, no-wrap
  1005. msgid "java"
  1006. msgstr ""
  1007. #. type: Plain text
  1008. #: guix-git/doc/contributing.texi:804
  1009. msgid "Java programs standing for themselves are named as any other package, using the lowercase upstream name."
  1010. msgstr ""
  1011. #. type: Plain text
  1012. #: guix-git/doc/contributing.texi:810
  1013. msgid "To avoid confusion and naming clashes with other programming languages, it is desirable that the name of a package for a Java package is prefixed with @code{java-}. If a project already contains the word @code{java}, we drop this; for instance, the package @code{ngsjava} is packaged under the name @code{java-ngs}."
  1014. msgstr ""
  1015. #. type: Plain text
  1016. #: guix-git/doc/contributing.texi:816
  1017. msgid "For Java packages containing a single class or a small class hierarchy, we use the lowercase class name, replace all occurrences of @code{.} by dashes and prepend the prefix @code{java-}. So the class @code{apache.commons.cli} becomes package @code{java-apache-commons-cli}."
  1018. msgstr ""
  1019. #. type: cindex
  1020. #: guix-git/doc/contributing.texi:821
  1021. #, no-wrap
  1022. msgid "rust"
  1023. msgstr ""
  1024. #. type: Plain text
  1025. #: guix-git/doc/contributing.texi:824
  1026. msgid "Rust programs standing for themselves are named as any other package, using the lowercase upstream name."
  1027. msgstr ""
  1028. #. type: Plain text
  1029. #: guix-git/doc/contributing.texi:828
  1030. msgid "To prevent namespace collisions we prefix all other Rust packages with the @code{rust-} prefix. The name should be changed to lowercase as appropriate and dashes should remain in place."
  1031. msgstr ""
  1032. #. type: Plain text
  1033. #: guix-git/doc/contributing.texi:834
  1034. msgid "In the rust ecosystem it is common for multiple incompatible versions of a package to be used at any given time, so all package definitions should have a versioned suffix. The versioned suffix is the left-most non-zero digit (and any leading zeros, of course). This follows the ``caret'' version scheme intended by Cargo. Examples@: @code{rust-clap-2}, @code{rust-rand-0.6}."
  1035. msgstr ""
  1036. #. type: Plain text
  1037. #: guix-git/doc/contributing.texi:844
  1038. msgid "Because of the difficulty in reusing rust packages as pre-compiled inputs for other packages the Cargo build system (@pxref{Build Systems, @code{cargo-build-system}}) presents the @code{#:cargo-inputs} and @code{cargo-development-inputs} keywords as build system arguments. It would be helpful to think of these as similar to @code{propagated-inputs} and @code{native-inputs}. Rust @code{dependencies} and @code{build-dependencies} should go in @code{#:cargo-inputs}, and @code{dev-dependencies} should go in @code{#:cargo-development-inputs}. If a Rust package links to other libraries then the standard placement in @code{inputs} and the like should be used."
  1039. msgstr ""
  1040. #. type: Plain text
  1041. #: guix-git/doc/contributing.texi:850
  1042. msgid "Care should be taken to ensure the correct version of dependencies are used; to this end we try to refrain from skipping the tests or using @code{#:skip-build?} when possible. Of course this is not always possible, as the package may be developed for a different Operating System, depend on features from the Nightly Rust compiler, or the test suite may have atrophied since it was released."
  1043. msgstr ""
  1044. #. type: cindex
  1045. #: guix-git/doc/contributing.texi:855 guix-git/doc/guix.texi:1896
  1046. #, no-wrap
  1047. msgid "fonts"
  1048. msgstr "font"
  1049. #. type: Plain text
  1050. #: guix-git/doc/contributing.texi:861
  1051. msgid "For fonts that are in general not installed by a user for typesetting purposes, or that are distributed as part of a larger software package, we rely on the general packaging rules for software; for instance, this applies to the fonts delivered as part of the X.Org system or fonts that are part of TeX Live."
  1052. msgstr ""
  1053. #. type: Plain text
  1054. #: guix-git/doc/contributing.texi:865
  1055. msgid "To make it easier for a user to search for fonts, names for other packages containing only fonts are constructed as follows, independently of the upstream package name."
  1056. msgstr ""
  1057. #. type: Plain text
  1058. #: guix-git/doc/contributing.texi:873
  1059. msgid "The name of a package containing only one font family starts with @code{font-}; it is followed by the foundry name and a dash @code{-} if the foundry is known, and the font family name, in which spaces are replaced by dashes (and as usual, all upper case letters are transformed to lower case). For example, the Gentium font family by SIL is packaged under the name @code{font-sil-gentium}."
  1060. msgstr ""
  1061. #. type: Plain text
  1062. #: guix-git/doc/contributing.texi:882
  1063. msgid "For a package containing several font families, the name of the collection is used in the place of the font family name. For instance, the Liberation fonts consist of three families, Liberation Sans, Liberation Serif and Liberation Mono. These could be packaged separately under the names @code{font-liberation-sans} and so on; but as they are distributed together under a common name, we prefer to package them together as @code{font-liberation}."
  1064. msgstr ""
  1065. #. type: Plain text
  1066. #: guix-git/doc/contributing.texi:888
  1067. msgid "In the case where several formats of the same font family or font collection are packaged separately, a short form of the format, prepended by a dash, is added to the package name. We use @code{-ttf} for TrueType fonts, @code{-otf} for OpenType fonts and @code{-type1} for PostScript Type 1 fonts."
  1068. msgstr ""
  1069. #. type: Plain text
  1070. #: guix-git/doc/contributing.texi:896
  1071. msgid "In general our code follows the GNU Coding Standards (@pxref{Top,,, standards, GNU Coding Standards}). However, they do not say much about Scheme, so here are some additional rules."
  1072. msgstr ""
  1073. #. type: subsection
  1074. #: guix-git/doc/contributing.texi:902 guix-git/doc/contributing.texi:904
  1075. #: guix-git/doc/contributing.texi:905
  1076. #, no-wrap
  1077. msgid "Programming Paradigm"
  1078. msgstr ""
  1079. #. type: menuentry
  1080. #: guix-git/doc/contributing.texi:902
  1081. msgid "How to compose your elements."
  1082. msgstr ""
  1083. #. type: subsection
  1084. #: guix-git/doc/contributing.texi:902 guix-git/doc/contributing.texi:911
  1085. #: guix-git/doc/contributing.texi:912
  1086. #, no-wrap
  1087. msgid "Modules"
  1088. msgstr "Moduli"
  1089. #. type: menuentry
  1090. #: guix-git/doc/contributing.texi:902
  1091. msgid "Where to store your code?"
  1092. msgstr ""
  1093. #. type: subsection
  1094. #: guix-git/doc/contributing.texi:902 guix-git/doc/contributing.texi:922
  1095. #: guix-git/doc/contributing.texi:923
  1096. #, no-wrap
  1097. msgid "Data Types and Pattern Matching"
  1098. msgstr ""
  1099. #. type: menuentry
  1100. #: guix-git/doc/contributing.texi:902
  1101. msgid "Implementing data structures."
  1102. msgstr ""
  1103. #. type: subsection
  1104. #: guix-git/doc/contributing.texi:902 guix-git/doc/contributing.texi:937
  1105. #: guix-git/doc/contributing.texi:938
  1106. #, no-wrap
  1107. msgid "Formatting Code"
  1108. msgstr ""
  1109. #. type: menuentry
  1110. #: guix-git/doc/contributing.texi:902
  1111. msgid "Writing conventions."
  1112. msgstr ""
  1113. #. type: Plain text
  1114. #: guix-git/doc/contributing.texi:910
  1115. msgid "Scheme code in Guix is written in a purely functional style. One exception is code that involves input/output, and procedures that implement low-level concepts, such as the @code{memoize} procedure."
  1116. msgstr ""
  1117. #. type: Plain text
  1118. #: guix-git/doc/contributing.texi:918
  1119. msgid "Guile modules that are meant to be used on the builder side must live in the @code{(guix build @dots{})} name space. They must not refer to other Guix or GNU modules. However, it is OK for a ``host-side'' module to use a build-side module."
  1120. msgstr ""
  1121. #. type: Plain text
  1122. #: guix-git/doc/contributing.texi:921
  1123. msgid "Modules that deal with the broader GNU system should be in the @code{(gnu @dots{})} name space rather than @code{(guix @dots{})}."
  1124. msgstr ""
  1125. #. type: Plain text
  1126. #: guix-git/doc/contributing.texi:930
  1127. msgid "The tendency in classical Lisp is to use lists to represent everything, and then to browse them ``by hand'' using @code{car}, @code{cdr}, @code{cadr}, and co. There are several problems with that style, notably the fact that it is hard to read, error-prone, and a hindrance to proper type error reports."
  1128. msgstr ""
  1129. #. type: Plain text
  1130. #: guix-git/doc/contributing.texi:936
  1131. msgid "Guix code should define appropriate data types (for instance, using @code{define-record-type*}) rather than abuse lists. In addition, it should use pattern matching, via Guile’s @code{(ice-9 match)} module, especially when matching lists (@pxref{Pattern Matching,,, guile, GNU Guile Reference Manual})."
  1132. msgstr ""
  1133. #. type: cindex
  1134. #: guix-git/doc/contributing.texi:940
  1135. #, no-wrap
  1136. msgid "formatting code"
  1137. msgstr ""
  1138. #. type: cindex
  1139. #: guix-git/doc/contributing.texi:941
  1140. #, no-wrap
  1141. msgid "coding style"
  1142. msgstr ""
  1143. #. type: Plain text
  1144. #: guix-git/doc/contributing.texi:948
  1145. msgid "When writing Scheme code, we follow common wisdom among Scheme programmers. In general, we follow the @url{https://mumble.net/~campbell/scheme/style.txt, Riastradh's Lisp Style Rules}. This document happens to describe the conventions mostly used in Guile’s code too. It is very thoughtful and well written, so please do read it."
  1146. msgstr ""
  1147. #. type: Plain text
  1148. #: guix-git/doc/contributing.texi:955
  1149. msgid "Some special forms introduced in Guix, such as the @code{substitute*} macro, have special indentation rules. These are defined in the @file{.dir-locals.el} file, which Emacs automatically uses. Also note that Emacs-Guix provides @code{guix-devel-mode} mode that indents and highlights Guix code properly (@pxref{Development,,, emacs-guix, The Emacs-Guix Reference Manual})."
  1150. msgstr ""
  1151. #. type: cindex
  1152. #: guix-git/doc/contributing.texi:956
  1153. #, no-wrap
  1154. msgid "indentation, of code"
  1155. msgstr ""
  1156. #. type: cindex
  1157. #: guix-git/doc/contributing.texi:957
  1158. #, no-wrap
  1159. msgid "formatting, of code"
  1160. msgstr ""
  1161. #. type: Plain text
  1162. #: guix-git/doc/contributing.texi:960
  1163. msgid "If you do not use Emacs, please make sure to let your editor knows these rules. To automatically indent a package definition, you can also run:"
  1164. msgstr ""
  1165. #. type: example
  1166. #: guix-git/doc/contributing.texi:963
  1167. #, no-wrap
  1168. msgid "./etc/indent-code.el gnu/packages/@var{file}.scm @var{package}\n"
  1169. msgstr ""
  1170. #. type: Plain text
  1171. #: guix-git/doc/contributing.texi:969
  1172. msgid "This automatically indents the definition of @var{package} in @file{gnu/packages/@var{file}.scm} by running Emacs in batch mode. To indent a whole file, omit the second argument:"
  1173. msgstr ""
  1174. #. type: example
  1175. #: guix-git/doc/contributing.texi:972
  1176. #, no-wrap
  1177. msgid "./etc/indent-code.el gnu/services/@var{file}.scm\n"
  1178. msgstr ""
  1179. #. type: cindex
  1180. #: guix-git/doc/contributing.texi:974
  1181. #, no-wrap
  1182. msgid "Vim, Scheme code editing"
  1183. msgstr ""
  1184. #. type: Plain text
  1185. #: guix-git/doc/contributing.texi:980
  1186. msgid "If you are editing code with Vim, we recommend that you run @code{:set autoindent} so that your code is automatically indented as you type. Additionally, @uref{https://www.vim.org/scripts/script.php?script_id=3998, @code{paredit.vim}} may help you deal with all these parentheses."
  1187. msgstr ""
  1188. #. type: Plain text
  1189. #: guix-git/doc/contributing.texi:984
  1190. msgid "We require all top-level procedures to carry a docstring. This requirement can be relaxed for simple private procedures in the @code{(guix build @dots{})} name space, though."
  1191. msgstr ""
  1192. #. type: Plain text
  1193. #: guix-git/doc/contributing.texi:987
  1194. msgid "Procedures should not have more than four positional parameters. Use keyword parameters for procedures that take more than four parameters."
  1195. msgstr ""
  1196. #. type: Plain text
  1197. #: guix-git/doc/contributing.texi:998
  1198. msgid "Development is done using the Git distributed version control system. Thus, access to the repository is not strictly necessary. We welcome contributions in the form of patches as produced by @code{git format-patch} sent to the @email{guix-patches@@gnu.org} mailing list. Seasoned Guix developers may also want to look at the section on commit access (@pxref{Commit Access})."
  1199. msgstr ""
  1200. #. type: Plain text
  1201. #: guix-git/doc/contributing.texi:1005
  1202. msgid "This mailing list is backed by a Debbugs instance, which allows us to keep track of submissions (@pxref{Tracking Bugs and Patches}). Each message sent to that mailing list gets a new tracking number assigned; people can then follow up on the submission by sending email to @code{@var{NNN}@@debbugs.gnu.org}, where @var{NNN} is the tracking number (@pxref{Sending a Patch Series})."
  1203. msgstr ""
  1204. #. type: Plain text
  1205. #: guix-git/doc/contributing.texi:1009
  1206. msgid "Please write commit logs in the ChangeLog format (@pxref{Change Logs,,, standards, GNU Coding Standards}); you can check the commit history for examples."
  1207. msgstr ""
  1208. #. type: Plain text
  1209. #: guix-git/doc/contributing.texi:1012
  1210. msgid "Before submitting a patch that adds or modifies a package definition, please run through this check list:"
  1211. msgstr ""
  1212. #. type: enumerate
  1213. #: guix-git/doc/contributing.texi:1019
  1214. msgid "If the authors of the packaged software provide a cryptographic signature for the release tarball, make an effort to verify the authenticity of the archive. For a detached GPG signature file this would be done with the @code{gpg --verify} command."
  1215. msgstr ""
  1216. #. type: enumerate
  1217. #: guix-git/doc/contributing.texi:1023
  1218. msgid "Take some time to provide an adequate synopsis and description for the package. @xref{Synopses and Descriptions}, for some guidelines."
  1219. msgstr ""
  1220. #. type: enumerate
  1221. #: guix-git/doc/contributing.texi:1028
  1222. msgid "Run @code{guix lint @var{package}}, where @var{package} is the name of the new or modified package, and fix any errors it reports (@pxref{Invoking guix lint})."
  1223. msgstr ""
  1224. #. type: enumerate
  1225. #: guix-git/doc/contributing.texi:1032
  1226. msgid "Make sure the package builds on your platform, using @code{guix build @var{package}}."
  1227. msgstr ""
  1228. #. type: enumerate
  1229. #: guix-git/doc/contributing.texi:1040
  1230. msgid "We recommend you also try building the package on other supported platforms. As you may not have access to actual hardware platforms, we recommend using the @code{qemu-binfmt-service-type} to emulate them. In order to enable it, add the @code{virtualization} service module and the following service to the list of services in your @code{operating-system} configuration:"
  1231. msgstr ""
  1232. #. type: lisp
  1233. #: guix-git/doc/contributing.texi:1045
  1234. #, no-wrap
  1235. msgid ""
  1236. "(service qemu-binfmt-service-type\n"
  1237. " (qemu-binfmt-configuration\n"
  1238. " (platforms (lookup-qemu-platforms \"arm\" \"aarch64\"))))\n"
  1239. msgstr ""
  1240. #. type: enumerate
  1241. #: guix-git/doc/contributing.texi:1048
  1242. msgid "Then reconfigure your system."
  1243. msgstr ""
  1244. #. type: enumerate
  1245. #: guix-git/doc/contributing.texi:1053
  1246. msgid "You can then build packages for different platforms by specifying the @code{--system} option. For example, to build the \"hello\" package for the armhf or aarch64 architectures, you would run the following commands, respectively:"
  1247. msgstr ""
  1248. #. type: example
  1249. #: guix-git/doc/contributing.texi:1056
  1250. #, no-wrap
  1251. msgid ""
  1252. "guix build --system=armhf-linux --rounds=2 hello\n"
  1253. "guix build --system=aarch64-linux --rounds=2 hello\n"
  1254. msgstr ""
  1255. #. type: cindex
  1256. #: guix-git/doc/contributing.texi:1059
  1257. #, no-wrap
  1258. msgid "bundling"
  1259. msgstr ""
  1260. #. type: enumerate
  1261. #: guix-git/doc/contributing.texi:1062
  1262. msgid "Make sure the package does not use bundled copies of software already available as separate packages."
  1263. msgstr ""
  1264. #. type: enumerate
  1265. #: guix-git/doc/contributing.texi:1071
  1266. msgid "Sometimes, packages include copies of the source code of their dependencies as a convenience for users. However, as a distribution, we want to make sure that such packages end up using the copy we already have in the distribution, if there is one. This improves resource usage (the dependency is built and stored only once), and allows the distribution to make transverse changes such as applying security updates for a given software package in a single place and have them affect the whole system---something that bundled copies prevent."
  1267. msgstr ""
  1268. #. type: enumerate
  1269. #: guix-git/doc/contributing.texi:1080
  1270. msgid "Take a look at the profile reported by @command{guix size} (@pxref{Invoking guix size}). This will allow you to notice references to other packages unwillingly retained. It may also help determine whether to split the package (@pxref{Packages with Multiple Outputs}), and which optional dependencies should be used. In particular, avoid adding @code{texlive} as a dependency: because of its extreme size, use the @code{texlive-tiny} package or @code{texlive-union} procedure instead."
  1271. msgstr ""
  1272. #. type: enumerate
  1273. #: guix-git/doc/contributing.texi:1085
  1274. msgid "For important changes, check that dependent packages (if applicable) are not affected by the change; @code{guix refresh --list-dependent @var{package}} will help you do that (@pxref{Invoking guix refresh})."
  1275. msgstr ""
  1276. #. type: cindex
  1277. #: guix-git/doc/contributing.texi:1087
  1278. #, no-wrap
  1279. msgid "branching strategy"
  1280. msgstr ""
  1281. #. type: cindex
  1282. #: guix-git/doc/contributing.texi:1088
  1283. #, no-wrap
  1284. msgid "rebuild scheduling strategy"
  1285. msgstr ""
  1286. #. type: enumerate
  1287. #: guix-git/doc/contributing.texi:1091
  1288. msgid "Depending on the number of dependent packages and thus the amount of rebuilding induced, commits go to different branches, along these lines:"
  1289. msgstr ""
  1290. #. type: item
  1291. #: guix-git/doc/contributing.texi:1093
  1292. #, no-wrap
  1293. msgid "300 dependent packages or less"
  1294. msgstr ""
  1295. #. type: table
  1296. #: guix-git/doc/contributing.texi:1095
  1297. msgid "@code{master} branch (non-disruptive changes)."
  1298. msgstr ""
  1299. #. type: item
  1300. #: guix-git/doc/contributing.texi:1096
  1301. #, no-wrap
  1302. msgid "between 300 and 1,800 dependent packages"
  1303. msgstr ""
  1304. #. type: table
  1305. #: guix-git/doc/contributing.texi:1102
  1306. msgid "@code{staging} branch (non-disruptive changes). This branch is intended to be merged in @code{master} every 6 weeks or so. Topical changes (e.g., an update of the GNOME stack) can instead go to a specific branch (say, @code{gnome-updates}). This branch is not expected to be buildable or usable until late in its development process."
  1307. msgstr ""
  1308. #. type: item
  1309. #: guix-git/doc/contributing.texi:1103
  1310. #, no-wrap
  1311. msgid "more than 1,800 dependent packages"
  1312. msgstr ""
  1313. #. type: table
  1314. #: guix-git/doc/contributing.texi:1108
  1315. msgid "@code{core-updates} branch (may include major and potentially disruptive changes). This branch is intended to be merged in @code{master} every 6 months or so. This branch is not expected to be buildable or usable until late in its development process."
  1316. msgstr ""
  1317. #. type: enumerate
  1318. #: guix-git/doc/contributing.texi:1115
  1319. msgid "All these branches are @uref{https://@value{SUBSTITUTE-SERVER-1}, tracked by our build farm} and merged into @code{master} once everything has been successfully built. This allows us to fix issues before they hit users, and to reduce the window during which pre-built binaries are not available."
  1320. msgstr ""
  1321. #. type: enumerate
  1322. #: guix-git/doc/contributing.texi:1124
  1323. msgid "When we decide to start building the @code{staging} or @code{core-updates} branches, they will be forked and renamed with the suffix @code{-frozen}, at which time only bug fixes may be pushed to the frozen branches. The @code{core-updates} and @code{staging} branches will remain open to accept patches for the next cycle. Please ask on the mailing list or IRC if unsure where to place a patch."
  1324. msgstr ""
  1325. #. type: cindex
  1326. #: guix-git/doc/contributing.texi:1126
  1327. #, no-wrap
  1328. msgid "determinism, of build processes"
  1329. msgstr ""
  1330. #. type: cindex
  1331. #: guix-git/doc/contributing.texi:1127
  1332. #, no-wrap
  1333. msgid "reproducible builds, checking"
  1334. msgstr ""
  1335. #. type: enumerate
  1336. #: guix-git/doc/contributing.texi:1131
  1337. msgid "Check whether the package's build process is deterministic. This typically means checking whether an independent build of the package yields the exact same result that you obtained, bit for bit."
  1338. msgstr ""
  1339. #. type: enumerate
  1340. #: guix-git/doc/contributing.texi:1134
  1341. msgid "A simple way to do that is by building the same package several times in a row on your machine (@pxref{Invoking guix build}):"
  1342. msgstr ""
  1343. #. type: example
  1344. #: guix-git/doc/contributing.texi:1137
  1345. #, no-wrap
  1346. msgid "guix build --rounds=2 my-package\n"
  1347. msgstr ""
  1348. #. type: enumerate
  1349. #: guix-git/doc/contributing.texi:1141
  1350. msgid "This is enough to catch a class of common non-determinism issues, such as timestamps or randomly-generated output in the build result."
  1351. msgstr ""
  1352. #. type: enumerate
  1353. #: guix-git/doc/contributing.texi:1151
  1354. msgid "Another option is to use @command{guix challenge} (@pxref{Invoking guix challenge}). You may run it once the package has been committed and built by @code{@value{SUBSTITUTE-SERVER-1}} to check whether it obtains the same result as you did. Better yet: Find another machine that can build it and run @command{guix publish}. Since the remote build machine is likely different from yours, this can catch non-determinism issues related to the hardware---e.g., use of different instruction set extensions---or to the operating system kernel---e.g., reliance on @code{uname} or @file{/proc} files."
  1355. msgstr ""
  1356. #. type: enumerate
  1357. #: guix-git/doc/contributing.texi:1157
  1358. msgid "When writing documentation, please use gender-neutral wording when referring to people, such as @uref{https://en.wikipedia.org/wiki/Singular_they, singular ``they''@comma{} ``their''@comma{} ``them''}, and so forth."
  1359. msgstr ""
  1360. #. type: enumerate
  1361. #: guix-git/doc/contributing.texi:1161
  1362. msgid "Verify that your patch contains only one set of related changes. Bundling unrelated changes together makes reviewing harder and slower."
  1363. msgstr ""
  1364. #. type: enumerate
  1365. #: guix-git/doc/contributing.texi:1164
  1366. msgid "Examples of unrelated changes include the addition of several packages, or a package update along with fixes to that package."
  1367. msgstr ""
  1368. #. type: enumerate
  1369. #: guix-git/doc/contributing.texi:1169
  1370. msgid "Please follow our code formatting rules, possibly running the @command{etc/indent-code.el} script to do that automatically for you (@pxref{Formatting Code})."
  1371. msgstr ""
  1372. #. type: enumerate
  1373. #: guix-git/doc/contributing.texi:1177
  1374. msgid "When possible, use mirrors in the source URL (@pxref{Invoking guix download}). Use reliable URLs, not generated ones. For instance, GitHub archives are not necessarily identical from one generation to the next, so in this case it's often better to clone the repository. Don't use the @command{name} field in the URL: it is not very useful and if the name changes, the URL will probably be wrong."
  1375. msgstr ""
  1376. #. type: enumerate
  1377. #: guix-git/doc/contributing.texi:1181
  1378. msgid "Check if Guix builds (@pxref{Building from Git}) and address the warnings, especially those about use of undefined symbols."
  1379. msgstr ""
  1380. #. type: enumerate
  1381. #: guix-git/doc/contributing.texi:1184
  1382. msgid "Make sure your changes do not break Guix and simulate a @code{guix pull} with:"
  1383. msgstr ""
  1384. #. type: example
  1385. #: guix-git/doc/contributing.texi:1186
  1386. #, no-wrap
  1387. msgid "guix pull --url=/path/to/your/checkout --profile=/tmp/guix.master\n"
  1388. msgstr ""
  1389. #. type: Plain text
  1390. #: guix-git/doc/contributing.texi:1199
  1391. msgid "When posting a patch to the mailing list, use @samp{[PATCH] @dots{}} as a subject, if your patch is to be applied on a branch other than @code{master}, say @code{core-updates}, specify it in the subject like @samp{[PATCH core-updates] @dots{}}. You may use your email client or the @command{git send-email} command (@pxref{Sending a Patch Series}). We prefer to get patches in plain text messages, either inline or as MIME attachments. You are advised to pay attention if your email client changes anything like line breaks or indentation which could potentially break the patches."
  1392. msgstr ""
  1393. #. type: Plain text
  1394. #: guix-git/doc/contributing.texi:1204
  1395. msgid "Expect some delay when you submit your very first patch to @email{guix-patches@@gnu.org}. You have to wait until you get an acknowledgement with the assigned tracking number. Future acknowledgements should not be delayed."
  1396. msgstr ""
  1397. #. type: Plain text
  1398. #: guix-git/doc/contributing.texi:1207
  1399. msgid "When a bug is resolved, please close the thread by sending an email to @email{@var{NNN}-done@@debbugs.gnu.org}."
  1400. msgstr ""
  1401. #. type: anchor{#1}
  1402. #: guix-git/doc/contributing.texi:1208 guix-git/doc/contributing.texi:1210
  1403. #, no-wrap
  1404. msgid "Sending a Patch Series"
  1405. msgstr ""
  1406. #. type: cindex
  1407. #: guix-git/doc/contributing.texi:1210
  1408. #, no-wrap
  1409. msgid "patch series"
  1410. msgstr ""
  1411. #. type: code{#1}
  1412. #: guix-git/doc/contributing.texi:1211
  1413. #, no-wrap
  1414. msgid "git send-email"
  1415. msgstr ""
  1416. #. type: code{#1}
  1417. #: guix-git/doc/contributing.texi:1212
  1418. #, no-wrap
  1419. msgid "git-send-email"
  1420. msgstr ""
  1421. #. type: Plain text
  1422. #: guix-git/doc/contributing.texi:1222
  1423. msgid "When sending a patch series (e.g., using @code{git send-email}), please first send one message to @email{guix-patches@@gnu.org}, and then send subsequent patches to @email{@var{NNN}@@debbugs.gnu.org} to make sure they are kept together. See @uref{https://debbugs.gnu.org/Advanced.html, the Debbugs documentation} for more information. You can install @command{git send-email} with @command{guix install git:send-email}."
  1424. msgstr ""
  1425. #. type: Plain text
  1426. #: guix-git/doc/contributing.texi:1228
  1427. msgid "This section describes how the Guix project tracks its bug reports and patch submissions."
  1428. msgstr ""
  1429. #. type: subsection
  1430. #: guix-git/doc/contributing.texi:1233 guix-git/doc/contributing.texi:1235
  1431. #: guix-git/doc/contributing.texi:1236
  1432. #, no-wrap
  1433. msgid "The Issue Tracker"
  1434. msgstr ""
  1435. #. type: menuentry
  1436. #: guix-git/doc/contributing.texi:1233
  1437. msgid "The official bug and patch tracker."
  1438. msgstr ""
  1439. #. type: subsection
  1440. #: guix-git/doc/contributing.texi:1233 guix-git/doc/contributing.texi:1249
  1441. #: guix-git/doc/contributing.texi:1250
  1442. #, no-wrap
  1443. msgid "Debbugs User Interfaces"
  1444. msgstr ""
  1445. #. type: menuentry
  1446. #: guix-git/doc/contributing.texi:1233
  1447. msgid "Ways to interact with Debbugs."
  1448. msgstr ""
  1449. #. type: subsection
  1450. #: guix-git/doc/contributing.texi:1233 guix-git/doc/contributing.texi:1289
  1451. #: guix-git/doc/contributing.texi:1290
  1452. #, no-wrap
  1453. msgid "Debbugs Usertags"
  1454. msgstr ""
  1455. #. type: menuentry
  1456. #: guix-git/doc/contributing.texi:1233
  1457. msgid "Tag reports with custom labels."
  1458. msgstr ""
  1459. #. type: cindex
  1460. #: guix-git/doc/contributing.texi:1238
  1461. #, no-wrap
  1462. msgid "bug reports, tracking"
  1463. msgstr ""
  1464. #. type: cindex
  1465. #: guix-git/doc/contributing.texi:1239
  1466. #, no-wrap
  1467. msgid "patch submissions, tracking"
  1468. msgstr ""
  1469. #. type: cindex
  1470. #: guix-git/doc/contributing.texi:1240
  1471. #, no-wrap
  1472. msgid "issue tracking"
  1473. msgstr ""
  1474. #. type: cindex
  1475. #: guix-git/doc/contributing.texi:1241
  1476. #, no-wrap
  1477. msgid "Debbugs, issue tracking system"
  1478. msgstr ""
  1479. #. type: Plain text
  1480. #: guix-git/doc/contributing.texi:1248
  1481. msgid "Bug reports and patch submissions are currently tracked using the Debbugs instance at @uref{https://bugs.gnu.org}. Bug reports are filed against the @code{guix} ``package'' (in Debbugs parlance), by sending email to @email{bug-guix@@gnu.org}, while patch submissions are filed against the @code{guix-patches} package by sending email to @email{guix-patches@@gnu.org} (@pxref{Submitting Patches})."
  1482. msgstr ""
  1483. #. type: Plain text
  1484. #: guix-git/doc/contributing.texi:1254
  1485. msgid "A web interface (actually @emph{two} web interfaces!) are available to browse issues:"
  1486. msgstr ""
  1487. #. type: itemize
  1488. #: guix-git/doc/contributing.texi:1263
  1489. msgid "@url{https://issues.guix.gnu.org} provides a pleasant interface@footnote{The web interface at @url{https://issues.guix.gnu.org} is powered by Mumi, a nice piece of software written in Guile, and you can help! See @url{https://git.elephly.net/gitweb.cgi?p=software/mumi.git}.} to browse bug reports and patches, and to participate in discussions;"
  1490. msgstr ""
  1491. #. type: itemize
  1492. #: guix-git/doc/contributing.texi:1265
  1493. msgid "@url{https://bugs.gnu.org/guix} lists bug reports;"
  1494. msgstr ""
  1495. #. type: itemize
  1496. #: guix-git/doc/contributing.texi:1267
  1497. msgid "@url{https://bugs.gnu.org/guix-patches} lists patch submissions."
  1498. msgstr ""
  1499. #. type: Plain text
  1500. #: guix-git/doc/contributing.texi:1272
  1501. msgid "To view discussions related to issue number @var{n}, go to @indicateurl{https://issues.guix.gnu.org/@var{n}} or @indicateurl{https://bugs.gnu.org/@var{n}}."
  1502. msgstr ""
  1503. #. type: Plain text
  1504. #: guix-git/doc/contributing.texi:1275
  1505. msgid "If you use Emacs, you may find it more convenient to interact with issues using @file{debbugs.el}, which you can install with:"
  1506. msgstr ""
  1507. #. type: example
  1508. #: guix-git/doc/contributing.texi:1278
  1509. #, no-wrap
  1510. msgid "guix install emacs-debbugs\n"
  1511. msgstr ""
  1512. #. type: Plain text
  1513. #: guix-git/doc/contributing.texi:1281
  1514. msgid "For example, to list all open issues on @code{guix-patches}, hit:"
  1515. msgstr ""
  1516. #. type: example
  1517. #: guix-git/doc/contributing.texi:1284
  1518. #, no-wrap
  1519. msgid "@kbd{C-u} @kbd{M-x} debbugs-gnu @kbd{RET} @kbd{RET} guix-patches @kbd{RET} n y\n"
  1520. msgstr ""
  1521. #. type: Plain text
  1522. #: guix-git/doc/contributing.texi:1288
  1523. msgid "@xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on this nifty tool!"
  1524. msgstr ""
  1525. #. type: cindex
  1526. #: guix-git/doc/contributing.texi:1292
  1527. #, no-wrap
  1528. msgid "usertags, for debbugs"
  1529. msgstr ""
  1530. #. type: cindex
  1531. #: guix-git/doc/contributing.texi:1293
  1532. #, no-wrap
  1533. msgid "Debbugs usertags"
  1534. msgstr ""
  1535. #. type: Plain text
  1536. #: guix-git/doc/contributing.texi:1299
  1537. msgid "Debbugs provides a feature called @dfn{usertags} that allows any user to tag any bug with an arbitrary label. Bugs can be searched by usertag, so this is a handy way to organize bugs@footnote{The list of usertags is public information, and anyone can modify any user's list of usertags, so keep that in mind if you choose to use this feature.}."
  1538. msgstr ""
  1539. #. type: Plain text
  1540. #: guix-git/doc/contributing.texi:1305
  1541. msgid "For example, to view all the bug reports (or patches, in the case of @code{guix-patches}) tagged with the usertag @code{powerpc64le-linux} for the user @code{guix}, open a URL like the following in a web browser: @url{https://debbugs.gnu.org/cgi-bin/pkgreport.cgi?tag=powerpc64le-linux;users=guix}."
  1542. msgstr ""
  1543. #. type: Plain text
  1544. #: guix-git/doc/contributing.texi:1309
  1545. msgid "For more information on how to use usertags, please refer to the documentation for Debbugs or the documentation for whatever tool you use to interact with Debbugs."
  1546. msgstr ""
  1547. #. type: Plain text
  1548. #: guix-git/doc/contributing.texi:1314
  1549. msgid "In Guix, we are experimenting with usertags to keep track of architecture-specific issues. To facilitate collaboration, all our usertags are associated with the single user @code{guix}. The following usertags currently exist for that user:"
  1550. msgstr ""
  1551. #. type: item
  1552. #: guix-git/doc/contributing.texi:1317 guix-git/doc/guix.texi:535
  1553. #, no-wrap
  1554. msgid "powerpc64le-linux"
  1555. msgstr ""
  1556. #. type: table
  1557. #: guix-git/doc/contributing.texi:1325
  1558. msgid "The purpose of this usertag is to make it easy to find the issues that matter most for the @code{powerpc64le-linux} system type. Please assign this usertag to bugs or patches that affect @code{powerpc64le-linux} but not other system types. In addition, you may use it to identify issues that for some reason are particularly important for the @code{powerpc64le-linux} system type, even if the issue affects other system types, too."
  1559. msgstr ""
  1560. #. #-#-#-#-# contributing.pot (guix manual checkout) #-#-#-#-#
  1561. #. type: item
  1562. #. #-#-#-#-# guix.pot (guix manual checkout) #-#-#-#-#
  1563. #. type: cindex
  1564. #: guix-git/doc/contributing.texi:1326 guix-git/doc/guix.texi:3025
  1565. #: guix-git/doc/guix.texi:4713
  1566. #, no-wrap
  1567. msgid "reproducibility"
  1568. msgstr ""
  1569. #. type: table
  1570. #: guix-git/doc/contributing.texi:1330
  1571. msgid "For issues related to reproducibility. For example, it would be appropriate to assign this usertag to a bug report for a package that fails to build reproducibly."
  1572. msgstr ""
  1573. #. type: Plain text
  1574. #: guix-git/doc/contributing.texi:1337
  1575. msgid "If you're a committer and you want to add a usertag, just start using it with the @code{guix} user. If the usertag proves useful to you, consider updating this section of the manual so that others will know what your usertag means."
  1576. msgstr ""
  1577. #. type: cindex
  1578. #: guix-git/doc/contributing.texi:1341
  1579. #, no-wrap
  1580. msgid "commit access, for developers"
  1581. msgstr ""
  1582. #. type: Plain text
  1583. #: guix-git/doc/contributing.texi:1347
  1584. msgid "Everyone can contribute to Guix without having commit access (@pxref{Submitting Patches}). However, for frequent contributors, having write access to the repository can be convenient. Commit access should not be thought of as a ``badge of honor'' but rather as a responsibility a contributor is willing to take to help the project."
  1585. msgstr ""
  1586. #. type: Plain text
  1587. #: guix-git/doc/contributing.texi:1351
  1588. msgid "The following sections explain how to get commit access, how to be ready to push commits, and the policies and community expectations for commits pushed upstream."
  1589. msgstr ""
  1590. #. type: subsection
  1591. #: guix-git/doc/contributing.texi:1352
  1592. #, no-wrap
  1593. msgid "Applying for Commit Access"
  1594. msgstr ""
  1595. #. type: Plain text
  1596. #: guix-git/doc/contributing.texi:1356
  1597. msgid "When you deem it necessary, consider applying for commit access by following these steps:"
  1598. msgstr ""
  1599. #. type: enumerate
  1600. #: guix-git/doc/contributing.texi:1365
  1601. msgid "Find three committers who would vouch for you. You can view the list of committers at @url{https://savannah.gnu.org/project/memberlist.php?group=guix}. Each of them should email a statement to @email{guix-maintainers@@gnu.org} (a private alias for the collective of maintainers), signed with their OpenPGP key."
  1602. msgstr ""
  1603. #. type: enumerate
  1604. #: guix-git/doc/contributing.texi:1371
  1605. msgid "Committers are expected to have had some interactions with you as a contributor and to be able to judge whether you are sufficiently familiar with the project's practices. It is @emph{not} a judgment on the value of your work, so a refusal should rather be interpreted as ``let's try again later''."
  1606. msgstr ""
  1607. #. type: enumerate
  1608. #: guix-git/doc/contributing.texi:1378
  1609. msgid "Send @email{guix-maintainers@@gnu.org} a message stating your intent, listing the three committers who support your application, signed with the OpenPGP key you will use to sign commits, and giving its fingerprint (see below). See @uref{https://emailselfdefense.fsf.org/en/}, for an introduction to public-key cryptography with GnuPG."
  1610. msgstr ""
  1611. #. type: enumerate
  1612. #: guix-git/doc/contributing.texi:1384
  1613. msgid "Set up GnuPG such that it never uses the SHA1 hash algorithm for digital signatures, which is known to be unsafe since 2019, for instance by adding the following line to @file{~/.gnupg/gpg.conf} (@pxref{GPG Esoteric Options,,, gnupg, The GNU Privacy Guard Manual}):"
  1614. msgstr ""
  1615. #. type: example
  1616. #: guix-git/doc/contributing.texi:1387
  1617. #, no-wrap
  1618. msgid "digest-algo sha512\n"
  1619. msgstr ""
  1620. #. type: enumerate
  1621. #: guix-git/doc/contributing.texi:1392
  1622. msgid "Maintainers ultimately decide whether to grant you commit access, usually following your referrals' recommendation."
  1623. msgstr ""
  1624. #. type: cindex
  1625. #: guix-git/doc/contributing.texi:1394
  1626. #, no-wrap
  1627. msgid "OpenPGP, signed commits"
  1628. msgstr ""
  1629. #. type: enumerate
  1630. #: guix-git/doc/contributing.texi:1399
  1631. msgid "If and once you've been given access, please send a message to @email{guix-devel@@gnu.org} to say so, again signed with the OpenPGP key you will use to sign commits (do that before pushing your first commit). That way, everyone can notice and ensure you control that OpenPGP key."
  1632. msgstr ""
  1633. #. type: quotation
  1634. #: guix-git/doc/contributing.texi:1400 guix-git/doc/guix.texi:16870
  1635. #, no-wrap
  1636. msgid "Important"
  1637. msgstr ""
  1638. #. type: quotation
  1639. #: guix-git/doc/contributing.texi:1402
  1640. msgid "Before you can push for the first time, maintainers must:"
  1641. msgstr ""
  1642. #. type: enumerate
  1643. #: guix-git/doc/contributing.texi:1406
  1644. msgid "add your OpenPGP key to the @code{keyring} branch;"
  1645. msgstr ""
  1646. #. type: enumerate
  1647. #: guix-git/doc/contributing.texi:1409
  1648. msgid "add your OpenPGP fingerprint to the @file{.guix-authorizations} file of the branch(es) you will commit to."
  1649. msgstr ""
  1650. #. type: enumerate
  1651. #: guix-git/doc/contributing.texi:1414
  1652. msgid "Make sure to read the rest of this section and... profit!"
  1653. msgstr ""
  1654. #. type: quotation
  1655. #: guix-git/doc/contributing.texi:1420
  1656. msgid "Maintainers are happy to give commit access to people who have been contributing for some time and have a track record---don't be shy and don't underestimate your work!"
  1657. msgstr ""
  1658. #. type: quotation
  1659. #: guix-git/doc/contributing.texi:1424
  1660. msgid "However, note that the project is working towards a more automated patch review and merging system, which, as a consequence, may lead us to have fewer people with commit access to the main repository. Stay tuned!"
  1661. msgstr ""
  1662. #. type: Plain text
  1663. #: guix-git/doc/contributing.texi:1431
  1664. msgid "All commits that are pushed to the central repository on Savannah must be signed with an OpenPGP key, and the public key should be uploaded to your user account on Savannah and to public key servers, such as @code{keys.openpgp.org}. To configure Git to automatically sign commits, run:"
  1665. msgstr ""
  1666. #. type: example
  1667. #: guix-git/doc/contributing.texi:1434
  1668. #, no-wrap
  1669. msgid ""
  1670. "git config commit.gpgsign true\n"
  1671. "\n"
  1672. msgstr ""
  1673. #. type: example
  1674. #: guix-git/doc/contributing.texi:1437
  1675. #, no-wrap
  1676. msgid ""
  1677. "# Substitute the fingerprint of your public PGP key.\n"
  1678. "git config user.signingkey CABBA6EA1DC0FF33\n"
  1679. msgstr ""
  1680. #. type: Plain text
  1681. #: guix-git/doc/contributing.texi:1442
  1682. msgid "You can prevent yourself from accidentally pushing unsigned commits to Savannah by using the pre-push Git hook located at @file{etc/git/pre-push}:"
  1683. msgstr ""
  1684. #. type: example
  1685. #: guix-git/doc/contributing.texi:1445
  1686. #, no-wrap
  1687. msgid "cp etc/git/pre-push .git/hooks/pre-push\n"
  1688. msgstr ""
  1689. #. type: subsection
  1690. #: guix-git/doc/contributing.texi:1447
  1691. #, no-wrap
  1692. msgid "Commit Policy"
  1693. msgstr ""
  1694. #. type: Plain text
  1695. #: guix-git/doc/contributing.texi:1452
  1696. msgid "If you get commit access, please make sure to follow the policy below (discussions of the policy can take place on @email{guix-devel@@gnu.org})."
  1697. msgstr ""
  1698. #. type: Plain text
  1699. #: guix-git/doc/contributing.texi:1457
  1700. msgid "Non-trivial patches should always be posted to @email{guix-patches@@gnu.org} (trivial patches include fixing typos, etc.). This mailing list fills the patch-tracking database (@pxref{Tracking Bugs and Patches})."
  1701. msgstr ""
  1702. #. type: Plain text
  1703. #: guix-git/doc/contributing.texi:1466
  1704. msgid "For patches that just add a new package, and a simple one, it's OK to commit, if you're confident (which means you successfully built it in a chroot setup, and have done a reasonable copyright and license auditing). Likewise for package upgrades, except upgrades that trigger a lot of rebuilds (for example, upgrading GnuTLS or GLib). We have a mailing list for commit notifications (@email{guix-commits@@gnu.org}), so people can notice. Before pushing your changes, make sure to run @code{git pull --rebase}."
  1705. msgstr ""
  1706. #. type: Plain text
  1707. #: guix-git/doc/contributing.texi:1471
  1708. msgid "When pushing a commit on behalf of somebody else, please add a @code{Signed-off-by} line at the end of the commit log message---e.g., with @command{git am --signoff}. This improves tracking of who did what."
  1709. msgstr ""
  1710. #. type: Plain text
  1711. #: guix-git/doc/contributing.texi:1475
  1712. msgid "When adding channel news entries (@pxref{Channels, Writing Channel News}), make sure they are well-formed by running the following command right before pushing:"
  1713. msgstr ""
  1714. #. type: example
  1715. #: guix-git/doc/contributing.texi:1478
  1716. #, no-wrap
  1717. msgid "make check-channel-news\n"
  1718. msgstr ""
  1719. #. type: Plain text
  1720. #: guix-git/doc/contributing.texi:1484
  1721. msgid "For anything else, please post to @email{guix-patches@@gnu.org} and leave time for a review, without committing anything (@pxref{Submitting Patches}). If you didn’t receive any reply after two weeks, and if you're confident, it's OK to commit."
  1722. msgstr ""
  1723. #. type: Plain text
  1724. #: guix-git/doc/contributing.texi:1487
  1725. msgid "That last part is subject to being adjusted, allowing individuals to commit directly on non-controversial changes on parts they’re familiar with."
  1726. msgstr ""
  1727. #. type: subsection
  1728. #: guix-git/doc/contributing.texi:1488
  1729. #, no-wrap
  1730. msgid "Addressing Issues"
  1731. msgstr ""
  1732. #. type: Plain text
  1733. #: guix-git/doc/contributing.texi:1499
  1734. msgid "Peer review (@pxref{Submitting Patches}) and tools such as @command{guix lint} (@pxref{Invoking guix lint}) and the test suite (@pxref{Running the Test Suite}) should catch issues before they are pushed. Yet, commits that ``break'' functionality might occasionally go through. When that happens, there are two priorities: mitigating the impact, and understanding what happened to reduce the chance of similar incidents in the future. The responsibility for both these things primarily lies with those involved, but like everything this is a group effort."
  1735. msgstr ""
  1736. #. type: Plain text
  1737. #: guix-git/doc/contributing.texi:1504
  1738. msgid "Some issues can directly affect all users---for instance because they make @command{guix pull} fail or break core functionality, because they break major packages (at build time or run time), or because they introduce known security vulnerabilities."
  1739. msgstr ""
  1740. #. type: cindex
  1741. #: guix-git/doc/contributing.texi:1505
  1742. #, no-wrap
  1743. msgid "reverting commits"
  1744. msgstr ""
  1745. #. type: Plain text
  1746. #: guix-git/doc/contributing.texi:1511
  1747. msgid "The people involved in authoring, reviewing, and pushing such commit(s) should be at the forefront to mitigate their impact in a timely fashion: by pushing a followup commit to fix it (if possible), or by reverting it to leave time to come up with a proper fix, and by communicating with other developers about the problem."
  1748. msgstr ""
  1749. #. type: Plain text
  1750. #: guix-git/doc/contributing.texi:1517
  1751. msgid "If these persons are unavailable to address the issue in time, other committers are entitled to revert the commit(s), explaining in the commit log and on the mailing list what the problem was, with the goal of leaving time to the original committer, reviewer(s), and author(s) to propose a way forward."
  1752. msgstr ""
  1753. #. type: Plain text
  1754. #: guix-git/doc/contributing.texi:1526
  1755. msgid "Once the problem has been dealt with, it is the responsibility of those involved to make sure the situation is understood. If you are working to understand what happened, focus on gathering information and avoid assigning any blame. Do ask those involved to describe what happened, do not ask them to explain the situation---this would implicitly blame them, which is unhelpful. Accountability comes from a consensus about the problem, learning from it and improving processes so that it's less likely to reoccur."
  1756. msgstr ""
  1757. #. type: subsection
  1758. #: guix-git/doc/contributing.texi:1527
  1759. #, no-wrap
  1760. msgid "Commit Revocation"
  1761. msgstr ""
  1762. #. type: Plain text
  1763. #: guix-git/doc/contributing.texi:1534
  1764. msgid "In order to reduce the possibility of mistakes, committers will have their Savannah account removed from the Guix Savannah project and their key removed from @file{.guix-authorizations} after 12 months of inactivity; they can ask to regain commit access by emailing the maintainers, without going through the vouching process."
  1765. msgstr ""
  1766. #. type: Plain text
  1767. #: guix-git/doc/contributing.texi:1544
  1768. msgid "Maintainers@footnote{See @uref{https://guix.gnu.org/en/about} for the current list of maintainers. You can email them privately at @email{guix-maintainers@@gnu.org}.} may also revoke an individual's commit rights, as a last resort, if cooperation with the rest of the community has caused too much friction---even within the bounds of the project's code of conduct (@pxref{Contributing}). They would only do so after public or private discussion with the individual and a clear notice. Examples of behavior that hinders cooperation and could lead to such a decision include:"
  1769. msgstr ""
  1770. #. type: item
  1771. #: guix-git/doc/contributing.texi:1546
  1772. #, no-wrap
  1773. msgid "repeated violation of the commit policy stated above;"
  1774. msgstr ""
  1775. #. type: item
  1776. #: guix-git/doc/contributing.texi:1547
  1777. #, no-wrap
  1778. msgid "repeated failure to take peer criticism into account;"
  1779. msgstr ""
  1780. #. type: item
  1781. #: guix-git/doc/contributing.texi:1548
  1782. #, no-wrap
  1783. msgid "breaching trust through a series of grave incidents."
  1784. msgstr ""
  1785. #. type: Plain text
  1786. #: guix-git/doc/contributing.texi:1555
  1787. msgid "When maintainers resort to such a decision, they notify developers on @email{guix-devel@@gnu.org}; inquiries may be sent to @email{guix-maintainers@@gnu.org}. Depending on the situation, the individual may still be welcome to contribute."
  1788. msgstr ""
  1789. #. type: subsection
  1790. #: guix-git/doc/contributing.texi:1556
  1791. #, no-wrap
  1792. msgid "Helping Out"
  1793. msgstr ""
  1794. #. type: Plain text
  1795. #: guix-git/doc/contributing.texi:1563
  1796. msgid "One last thing: the project keeps moving forward because committers not only push their own awesome changes, but also offer some of their time @emph{reviewing} and pushing other people's changes. As a committer, you're welcome to use your expertise and commit rights to help other contributors, too!"
  1797. msgstr ""
  1798. #. type: cindex
  1799. #: guix-git/doc/contributing.texi:1567
  1800. #, no-wrap
  1801. msgid "update-guix-package, updating the guix package"
  1802. msgstr ""
  1803. #. type: Plain text
  1804. #: guix-git/doc/contributing.texi:1573
  1805. msgid "It is sometimes desirable to update the @code{guix} package itself (the package defined in @code{(gnu packages package-management)}), for example to make new daemon features available for use by the @code{guix-service-type} service type. In order to simplify this task, the following command can be used:"
  1806. msgstr ""
  1807. #. type: example
  1808. #: guix-git/doc/contributing.texi:1576
  1809. #, no-wrap
  1810. msgid "make update-guix-package\n"
  1811. msgstr ""
  1812. #. type: Plain text
  1813. #: guix-git/doc/contributing.texi:1583
  1814. msgid "The @code{update-guix-package} make target will use the last known @emph{commit} corresponding to @code{HEAD} in your Guix checkout, compute the hash of the Guix sources corresponding to that commit and update the @code{commit}, @code{revision} and hash of the @code{guix} package definition."
  1815. msgstr ""
  1816. #. type: Plain text
  1817. #: guix-git/doc/contributing.texi:1587
  1818. msgid "To validate that the updated @code{guix} package hashes are correct and that it can be built successfully, the following command can be run from the directory of your Guix checkout:"
  1819. msgstr ""
  1820. #. type: example
  1821. #: guix-git/doc/contributing.texi:1590
  1822. #, no-wrap
  1823. msgid "./pre-inst-env guix build guix\n"
  1824. msgstr ""
  1825. #. type: Plain text
  1826. #: guix-git/doc/contributing.texi:1595
  1827. msgid "To guard against accidentally updating the @code{guix} package to a commit that others can't refer to, a check is made that the commit used has already been pushed to the Savannah-hosted Guix git repository."
  1828. msgstr ""
  1829. #. type: Plain text
  1830. #: guix-git/doc/contributing.texi:1600
  1831. msgid "This check can be disabled, @emph{at your own peril}, by setting the @code{GUIX_ALLOW_ME_TO_USE_PRIVATE_COMMIT} environment variable. When this variable is set, the updated package source is also added to the store. This is used as part of the release process of Guix."
  1832. msgstr ""
  1833. #. type: cindex
  1834. #: guix-git/doc/contributing.texi:1601
  1835. #, fuzzy, no-wrap
  1836. #| msgid "Installation"
  1837. msgid "translation"
  1838. msgstr "Installazione"
  1839. #. type: cindex
  1840. #: guix-git/doc/contributing.texi:1602
  1841. #, no-wrap
  1842. msgid "l10n"
  1843. msgstr ""
  1844. #. type: cindex
  1845. #: guix-git/doc/contributing.texi:1603
  1846. #, no-wrap
  1847. msgid "i18n"
  1848. msgstr ""
  1849. #. type: cindex
  1850. #: guix-git/doc/contributing.texi:1604
  1851. #, no-wrap
  1852. msgid "native language support"
  1853. msgstr ""
  1854. #. type: Plain text
  1855. #: guix-git/doc/contributing.texi:1614
  1856. msgid "Writing code and packages is not the only way to provide a meaningful contribution to Guix. Translating to a language you speak is another example of a valuable contribution you can make. This section is designed to describe the translation process. It gives you advice on how you can get involved, what can be translated, what mistakes you should avoid and what we can do to help you!"
  1857. msgstr ""
  1858. #. type: Plain text
  1859. #: guix-git/doc/contributing.texi:1620
  1860. msgid "Guix is a big project that has multiple components that can be translated. We coordinate the translation effort on a @uref{https://translate.fedoraproject.org/projects/guix/,Weblate instance} hosted by our friends at Fedora. You will need an account to submit translations."
  1861. msgstr ""
  1862. #. type: Plain text
  1863. #: guix-git/doc/contributing.texi:1627
  1864. msgid "Some of the software packaged in Guix also contain translations. We do not host a translation platform for them. If you want to translate a package provided by Guix, you should contact their developers or find the information on their website. As an example, you can find the homepage of the @code{hello} package by typing @code{guix show hello}. On the ``homepage'' line, you will see @url{https://www.gnu.org/software/hello/} as the homepage."
  1865. msgstr ""
  1866. #. type: Plain text
  1867. #: guix-git/doc/contributing.texi:1632
  1868. msgid "Many GNU and non-GNU packages can be translated on the @uref{https://translationproject.org,Translation Project}. Some projects with multiple components have their own platform. For instance, GNOME has its own platform, @uref{https://l10n.gnome.org/,Damned Lies}."
  1869. msgstr ""
  1870. #. type: Plain text
  1871. #: guix-git/doc/contributing.texi:1634
  1872. msgid "Guix has five components hosted on Weblate."
  1873. msgstr ""
  1874. #. type: item
  1875. #: guix-git/doc/contributing.texi:1636
  1876. #, no-wrap
  1877. msgid "@code{guix} contains all the strings from the Guix software (the"
  1878. msgstr ""
  1879. #. type: itemize
  1880. #: guix-git/doc/contributing.texi:1638
  1881. msgid "guided system installer, the package manager, etc), excluding packages."
  1882. msgstr ""
  1883. #. type: item
  1884. #: guix-git/doc/contributing.texi:1638
  1885. #, no-wrap
  1886. msgid "@code{packages} contains the synopsis (single-sentence description"
  1887. msgstr ""
  1888. #. type: itemize
  1889. #: guix-git/doc/contributing.texi:1640
  1890. msgid "of a package) and description (longer description) of packages in Guix."
  1891. msgstr ""
  1892. #. type: item
  1893. #: guix-git/doc/contributing.texi:1640
  1894. #, no-wrap
  1895. msgid "@code{website} contains the official Guix website, except for"
  1896. msgstr ""
  1897. #. type: itemize
  1898. #: guix-git/doc/contributing.texi:1642
  1899. msgid "blog posts and multimedia content."
  1900. msgstr ""
  1901. #. type: item
  1902. #: guix-git/doc/contributing.texi:1642
  1903. #, no-wrap
  1904. msgid "@code{documentation-manual} corresponds to this manual."
  1905. msgstr ""
  1906. #. type: item
  1907. #: guix-git/doc/contributing.texi:1643
  1908. #, no-wrap
  1909. msgid "@code{documentation-cookbook} is the component for the cookbook."
  1910. msgstr ""
  1911. #. type: subsubheading
  1912. #: guix-git/doc/contributing.texi:1646
  1913. #, no-wrap
  1914. msgid "General Directions"
  1915. msgstr ""
  1916. #. type: Plain text
  1917. #: guix-git/doc/contributing.texi:1654
  1918. msgid "Once you get an account, you should be able to select a component from @uref{https://translate.fedoraproject.org/projects/guix/,the guix project}, and select a language. If your language does not appear in the list, go to the bottom and click on the ``Start new translation'' button. Select the language you want to translate to from the list, to start your new translation."
  1919. msgstr ""
  1920. #. type: Plain text
  1921. #: guix-git/doc/contributing.texi:1659
  1922. msgid "Like lots of other free software packages, Guix uses @uref{https://www.gnu.org/software/gettext,GNU Gettext} for its translations, with which translatable strings are extracted from the source code to so-called PO files."
  1923. msgstr ""
  1924. #. type: Plain text
  1925. #: guix-git/doc/contributing.texi:1670
  1926. msgid "Even though PO files are text files, changes should not be made with a text editor but with PO editing software. Weblate integrates PO editing functionality. Alternatively, translators can use any of various free-software tools for filling in translations, of which @uref{https://poedit.net/,Poedit} is one example, and (after logging in) @uref{https://docs.weblate.org/en/latest/user/files.html,upload} the changed file. There is also a special @uref{https://www.emacswiki.org/emacs/PoMode,PO editing mode} for users of GNU Emacs. Over time translators find out what software they are happy with and what features they need."
  1927. msgstr ""
  1928. #. type: Plain text
  1929. #: guix-git/doc/contributing.texi:1675
  1930. msgid "On Weblate, you will find various links to the editor, that will show various subsets (or all) of the strings. Have a look around and at the @uref{https://docs.weblate.org/en/latest/,documentation} to familiarize yourself with the platform."
  1931. msgstr ""
  1932. #. type: subsubheading
  1933. #: guix-git/doc/contributing.texi:1676
  1934. #, no-wrap
  1935. msgid "Translation Components"
  1936. msgstr ""
  1937. #. type: Plain text
  1938. #: guix-git/doc/contributing.texi:1681
  1939. msgid "In this section, we provide more detailed guidance on the translation process, as well as details on what you should or should not do. When in doubt, please contact us, we will be happy to help!"
  1940. msgstr ""
  1941. #. type: item
  1942. #: guix-git/doc/contributing.texi:1683 guix-git/doc/guix.texi:8845
  1943. #, no-wrap
  1944. msgid "guix"
  1945. msgstr ""
  1946. #. type: table
  1947. #: guix-git/doc/contributing.texi:1688
  1948. msgid "Guix is written in the Guile programming language, and some strings contain special formatting that is interpreted by Guile. These special formatting should be highlighted by Weblate. They start with @code{~} followed by one or more characters."
  1949. msgstr ""
  1950. #. type: table
  1951. #: guix-git/doc/contributing.texi:1697
  1952. msgid "When printing the string, Guile replaces the special formatting symbols with actual values. For instance, the string @samp{ambiguous package specification `~a'} would be substituted to contain said package specification instead of @code{~a}. To properly translate this string, you must keep the formatting code in your translation, although you can place it where it makes sense in your language. For instance, the French translation says @samp{spécification du paquet « ~a » ambiguë} because the adjective needs to be placed in the end of the sentence."
  1953. msgstr ""
  1954. #. type: table
  1955. #: guix-git/doc/contributing.texi:1701
  1956. msgid "If there are multiple formatting symbols, make sure to respect the order. Guile does not know in which order you intended the string to be read, so it will substitute the symbols in the same order as the English sentence."
  1957. msgstr ""
  1958. #. type: table
  1959. #: guix-git/doc/contributing.texi:1709
  1960. msgid "As an example, you cannot translate @samp{package '~a' has been superseded by '~a'} by @samp{'~a' superseeds package '~a'}, because the meaning would be reversed. If @var{foo} is superseded by @var{bar}, the translation would read @samp{'foo' superseeds package 'bar'}. To work around this problem, it is possible to use more advanced formatting to select a given piece of data, instead of following the default English order. @xref{Formatted Output,,, guile, GNU Guile Reference Manual}, for more information on formatting in Guile."
  1961. msgstr ""
  1962. #. #-#-#-#-# contributing.pot (guix manual checkout) #-#-#-#-#
  1963. #. type: item
  1964. #. #-#-#-#-# guix.pot (guix manual checkout) #-#-#-#-#
  1965. #. type: cindex
  1966. #: guix-git/doc/contributing.texi:1710 guix-git/doc/guix.texi:2943
  1967. #, no-wrap
  1968. msgid "packages"
  1969. msgstr ""
  1970. #. type: table
  1971. #: guix-git/doc/contributing.texi:1715
  1972. msgid "Package descriptions occasionally contain Texinfo markup (@pxref{Synopses and Descriptions}). Texinfo markup looks like @samp{@@code@{rm -rf@}}, @samp{@@emph@{important@}}, etc. When translating, please leave markup as is."
  1973. msgstr ""
  1974. #. type: table
  1975. #: guix-git/doc/contributing.texi:1724
  1976. msgid "The characters after ``@@'' form the name of the markup, and the text between ``@{'' and ``@}'' is its content. In general, you should not translate the content of markup like @code{@@code}, as it contains literal code that do not change with language. You can translate the content of formatting markup such as @code{@@emph}, @code{@@i}, @code{@@itemize}, @code{@@item}. However, do not translate the name of the markup, or it will not be recognized. Do not translate the word after @code{@@end}, it is the name of the markup that is closed at this position (e.g.@: @code{@@itemize ... @@end itemize})."
  1977. msgstr ""
  1978. #. type: item
  1979. #: guix-git/doc/contributing.texi:1725
  1980. #, no-wrap
  1981. msgid "documentation-manual and documentation-cookbook"
  1982. msgstr ""
  1983. #. type: table
  1984. #: guix-git/doc/contributing.texi:1729
  1985. msgid "The first step to ensure a successful translation of the manual is to find and translate the following strings @emph{first}:"
  1986. msgstr ""
  1987. #. type: item
  1988. #: guix-git/doc/contributing.texi:1731
  1989. #, no-wrap
  1990. msgid "@code{version.texi}: Translate this string as @code{version-xx.texi},"
  1991. msgstr ""
  1992. #. type: itemize
  1993. #: guix-git/doc/contributing.texi:1734
  1994. msgid "where @code{xx} is your language code (the one shown in the URL on weblate)."
  1995. msgstr ""
  1996. #. type: item
  1997. #: guix-git/doc/contributing.texi:1734
  1998. #, no-wrap
  1999. msgid "@code{contributing.texi}: Translate this string as"
  2000. msgstr ""
  2001. #. type: itemize
  2002. #: guix-git/doc/contributing.texi:1736
  2003. msgid "@code{contributing.xx.texi}, where @code{xx} is the same language code."
  2004. msgstr ""
  2005. #. type: item
  2006. #: guix-git/doc/contributing.texi:1736
  2007. #, no-wrap
  2008. msgid "@code{Top}: Do not translate this string, it is important for Texinfo."
  2009. msgstr ""
  2010. #. type: itemize
  2011. #: guix-git/doc/contributing.texi:1739
  2012. msgid "If you translate it, the document will be empty (missing a Top node). Please look for it, and register @code{Top} as its translation."
  2013. msgstr ""
  2014. #. type: table
  2015. #: guix-git/doc/contributing.texi:1744
  2016. msgid "Translating these strings first ensure we can include your translation in the guix repository without breaking the make process or the @command{guix pull} machinery."
  2017. msgstr ""
  2018. #. type: table
  2019. #: guix-git/doc/contributing.texi:1751
  2020. msgid "The manual and the cookbook both use Texinfo. As for @code{packages}, please keep Texinfo markup as is. There are more possible markup types in the manual than in the package descriptions. In general, do not translate the content of @code{@@code}, @code{@@file}, @code{@@var}, @code{@@value}, etc. You should translate the content of formatting markup such as @code{@@emph}, @code{@@i}, etc."
  2021. msgstr ""
  2022. #. type: table
  2023. #: guix-git/doc/contributing.texi:1759
  2024. msgid "The manual contains sections that can be referred to by name by @code{@@ref}, @code{@@xref} and @code{@@pxref}. We have a mechanism in place so you do not have to translate their content. If you keep the English title, we will automatically replace it with your translation of that title. This ensures that Texinfo will always be able to find the node. If you decide to change the translation of the title, the references will automatically be updated and you will not have to update them all yourself."
  2025. msgstr ""
  2026. #. type: table
  2027. #: guix-git/doc/contributing.texi:1769
  2028. msgid "When translating references from the cookbook to the manual, you need to replace the name of the manual and the name of the section. For instance, to translate @code{@@pxref@{Defining Packages,,, guix, GNU Guix Reference Manual@}}, you would replace @code{Defining Packages} with the title of that section in the translated manual @emph{only} if that title is translated. If the title is not translated in your language yet, do not translate it here, or the link will be broken. Replace @code{guix} with @code{guix.xx} where @code{xx} is your language code. @code{GNU Guix Reference Manual} is the text of the link. You can translate it however you wish."
  2029. msgstr ""
  2030. #. type: item
  2031. #: guix-git/doc/contributing.texi:1770
  2032. #, no-wrap
  2033. msgid "website"
  2034. msgstr ""
  2035. #. type: table
  2036. #: guix-git/doc/contributing.texi:1777
  2037. msgid "The website pages are written using SXML, an s-expression version of HTML, the basic language of the web. We have a process to extract translatable strings from the source, and replace complex s-expressions with a more familiar XML markup, where each markup is numbered. Translators can arbitrarily change the ordering, as in the following example."
  2038. msgstr ""
  2039. #. type: example
  2040. #: guix-git/doc/contributing.texi:1784
  2041. #, no-wrap
  2042. msgid ""
  2043. "#. TRANSLATORS: Defining Packages is a section name\n"
  2044. "#. in the English (en) manual.\n"
  2045. "#: apps/base/templates/about.scm:64\n"
  2046. "msgid \"Packages are <1>defined<1.1>en</1.1><1.2>Defining-Packages.html</1.2></1> as native <2>Guile</2> modules.\"\n"
  2047. "msgstr \"Pakete werden als reine <2>Guile</2>-Module <1>definiert<1.1>de</1.1><1.2>Pakete-definieren.html</1.2></1>.\"\n"
  2048. msgstr ""
  2049. #. type: table
  2050. #: guix-git/doc/contributing.texi:1787
  2051. msgid "Note that you need to include the same markups. You cannot skip any."
  2052. msgstr ""
  2053. #. type: Plain text
  2054. #: guix-git/doc/contributing.texi:1795
  2055. msgid "In case you make a mistake, the component might fail to build properly with your language, or even make guix pull fail. To prevent that, we have a process in place to check the content of the files before pushing to our repository. We will not be able to update the translation for your language in Guix, so we will notify you (through weblate and/or by email) so you get a chance to fix the issue."
  2056. msgstr ""
  2057. #. type: subsubheading
  2058. #: guix-git/doc/contributing.texi:1796
  2059. #, no-wrap
  2060. msgid "Outside of Weblate"
  2061. msgstr ""
  2062. #. type: Plain text
  2063. #: guix-git/doc/contributing.texi:1799
  2064. msgid "Currently, some parts of Guix cannot be translated on Weblate, help wanted!"
  2065. msgstr ""
  2066. #. type: item
  2067. #: guix-git/doc/contributing.texi:1801
  2068. #, no-wrap
  2069. msgid "@command{guix pull} news can be translated in @file{news.scm}, but is not"
  2070. msgstr ""
  2071. #. type: itemize
  2072. #: guix-git/doc/contributing.texi:1807
  2073. msgid "available from Weblate. If you want to provide a translation, you can prepare a patch as described above, or simply send us your translation with the name of the news entry you translated and your language. @xref{Writing Channel News}, for more information about channel news."
  2074. msgstr ""
  2075. #. type: item
  2076. #: guix-git/doc/contributing.texi:1807
  2077. #, no-wrap
  2078. msgid "Guix blog posts cannot currently be translated."
  2079. msgstr ""
  2080. #. type: item
  2081. #: guix-git/doc/contributing.texi:1808
  2082. #, no-wrap
  2083. msgid "The installer script (for foreign distributions) is entirely in English."
  2084. msgstr ""
  2085. #. type: item
  2086. #: guix-git/doc/contributing.texi:1809
  2087. #, no-wrap
  2088. msgid "Some of the libraries Guix uses cannot be translated or are translated"
  2089. msgstr ""
  2090. #. type: itemize
  2091. #: guix-git/doc/contributing.texi:1811
  2092. msgid "outside of the Guix project. Guile itself is not internationalized."
  2093. msgstr ""
  2094. #. type: item
  2095. #: guix-git/doc/contributing.texi:1811
  2096. #, no-wrap
  2097. msgid "Other manuals linked from this manual or the cookbook might not be"
  2098. msgstr ""
  2099. #. type: itemize
  2100. #: guix-git/doc/contributing.texi:1813
  2101. msgid "translated."
  2102. msgstr ""
  2103. #. type: subsubheading
  2104. #: guix-git/doc/contributing.texi:1815
  2105. #, no-wrap
  2106. msgid "Translation Infrastructure"
  2107. msgstr ""
  2108. #. type: Plain text
  2109. #: guix-git/doc/contributing.texi:1826
  2110. msgid "Weblate is backed by a git repository from which it discovers new strings to translate and pushes new and updated translations. Normally, it would be enough to give it commit access to our repositories. However, we decided to use a separate repository for two reasons. First, we would have to give Weblate commit access and authorize its signing key, but we do not trust it in the same way we trust guix developers, especially since we do not manage the instance ourselves. Second, if translators mess something up, it can break the generation of the website and/or guix pull for all our users, independently of their language."
  2111. msgstr ""
  2112. #. type: Plain text
  2113. #: guix-git/doc/contributing.texi:1830
  2114. msgid "For these reasons, we use a dedicated repository to host translations, and we synchronize it with our guix and artworks repositories after checking no issue was introduced in the translation."
  2115. msgstr ""
  2116. #. type: Plain text
  2117. #: guix-git/doc/contributing.texi:1836
  2118. msgid "Developers can download the latest PO files from weblate in the Guix repository by running the @command{make download-po} command. It will automatically download the latest files from weblate, reformat them to a canonical form, and check they do not contain issues. The manual needs to be built again to check for additional issues that might crash Texinfo."
  2119. msgstr ""
  2120. #. type: Plain text
  2121. #: guix-git/doc/contributing.texi:1840
  2122. msgid "Before pushing new translation files, developers should add them to the make machinery so the translations are actually available. The process differs for the various components."
  2123. msgstr ""
  2124. #. type: item
  2125. #: guix-git/doc/contributing.texi:1842
  2126. #, no-wrap
  2127. msgid "New po files for the @code{guix} and @code{packages} components must"
  2128. msgstr ""
  2129. #. type: itemize
  2130. #: guix-git/doc/contributing.texi:1845
  2131. msgid "be registered by adding the new language to @file{po/guix/LINGUAS} or @file{po/packages/LINGUAS}."
  2132. msgstr ""
  2133. #. type: item
  2134. #: guix-git/doc/contributing.texi:1845
  2135. #, no-wrap
  2136. msgid "New po files for the @code{documentation-manual} component must be"
  2137. msgstr ""
  2138. #. type: itemize
  2139. #: guix-git/doc/contributing.texi:1851
  2140. msgid "registered by adding the file name to @code{DOC_PO_FILES} in @file{po/doc/local.mk}, the generated @file{%D%/guix.xx.texi} manual to @code{info_TEXINFOS} in @file{doc/local.mk} and the generated @file{%D%/guix.xx.texi} and @file{%D%/contributing.xx.texi} to @code{TRANSLATED_INFO} also in @file{doc/local.mk}."
  2141. msgstr ""
  2142. #. type: item
  2143. #: guix-git/doc/contributing.texi:1851
  2144. #, no-wrap
  2145. msgid "New po files for the @code{documentation-cookbook} component must be"
  2146. msgstr ""
  2147. #. type: itemize
  2148. #: guix-git/doc/contributing.texi:1857
  2149. msgid "registered by adding the file name to @code{DOC_COOKBOOK_PO_FILES} in @file{po/doc/local.mk}, the generated @file{%D%/guix-cookbook.xx.texi} manual to @code{info_TEXINFOS} in @file{doc/local.mk} and the generated @file{%D%/guix-cookbook.xx.texi} to @code{TRANSLATED_INFO} also in @file{doc/local.mk}."
  2150. msgstr ""
  2151. #. type: item
  2152. #: guix-git/doc/contributing.texi:1857
  2153. #, no-wrap
  2154. msgid "New po files for the @code{website} component must be added to the"
  2155. msgstr ""
  2156. #. type: itemize
  2157. #: guix-git/doc/contributing.texi:1862
  2158. msgid "@code{guix-artwork} repository, in @file{website/po/}. @file{website/po/LINGUAS} and @file{website/po/ietf-tags.scm} must be updated accordingly (see @file{website/i18n-howto.txt} for more information on the process)."
  2159. msgstr ""
  2160. #. type: Plain text
  2161. #: guix-git/doc/guix.texi:7
  2162. msgid "@documentencoding UTF-8"
  2163. msgstr ""
  2164. #. type: title
  2165. #: guix-git/doc/guix.texi:7 guix-git/doc/guix.texi:126
  2166. #, no-wrap
  2167. msgid "GNU Guix Reference Manual"
  2168. msgstr ""
  2169. #. type: include
  2170. #: guix-git/doc/guix.texi:10
  2171. #, no-wrap
  2172. msgid "version.texi"
  2173. msgstr "version-it.texi"
  2174. #. type: copying
  2175. #: guix-git/doc/guix.texi:99
  2176. msgid "Copyright @copyright{} 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021 Ludovic Courtès@* Copyright @copyright{} 2013, 2014, 2016 Andreas Enge@* Copyright @copyright{} 2013 Nikita Karetnikov@* Copyright @copyright{} 2014, 2015, 2016 Alex Kost@* Copyright @copyright{} 2015, 2016 Mathieu Lirzin@* Copyright @copyright{} 2014 Pierre-Antoine Rault@* Copyright @copyright{} 2015 Taylan Ulrich Bayırlı/Kammer@* Copyright @copyright{} 2015, 2016, 2017, 2019, 2020, 2021 Leo Famulari@* Copyright @copyright{} 2015, 2016, 2017, 2018, 2019, 2020 Ricardo Wurmus@* Copyright @copyright{} 2016 Ben Woodcroft@* Copyright @copyright{} 2016, 2017, 2018, 2021 Chris Marusich@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021 Efraim Flashner@* Copyright @copyright{} 2016 John Darrington@* Copyright @copyright{} 2016, 2017 Nikita Gillmann@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020 Jan Nieuwenhuizen@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021 Julien Lepiller@* Copyright @copyright{} 2016 Alex ter Weele@* Copyright @copyright{} 2016, 2017, 2018, 2019, 2020, 2021 Christopher Baines@* Copyright @copyright{} 2017, 2018, 2019 Clément Lassieur@* Copyright @copyright{} 2017, 2018, 2020, 2021 Mathieu Othacehe@* Copyright @copyright{} 2017 Federico Beffa@* Copyright @copyright{} 2017, 2018 Carlo Zancanaro@* Copyright @copyright{} 2017 Thomas Danckaert@* Copyright @copyright{} 2017 humanitiesNerd@* Copyright @copyright{} 2017, 2021 Christine Lemmer-Webber@* Copyright @copyright{} 2017, 2018, 2019, 2020 Marius Bakke@* Copyright @copyright{} 2017, 2019, 2020 Hartmut Goebel@* Copyright @copyright{} 2017, 2019, 2020, 2021 Maxim Cournoyer@* Copyright @copyright{} 2017, 2018, 2019, 2020, 2021 Tobias Geerinckx-Rice@* Copyright @copyright{} 2017 George Clemmer@* Copyright @copyright{} 2017 Andy Wingo@* Copyright @copyright{} 2017, 2018, 2019, 2020 Arun Isaac@* Copyright @copyright{} 2017 nee@* Copyright @copyright{} 2018 Rutger Helling@* Copyright @copyright{} 2018, 2021 Oleg Pykhalov@* Copyright @copyright{} 2018 Mike Gerwitz@* Copyright @copyright{} 2018 Pierre-Antoine Rouby@* Copyright @copyright{} 2018, 2019 Gábor Boskovits@* Copyright @copyright{} 2018, 2019, 2020 Florian Pelz@* Copyright @copyright{} 2018 Laura Lazzati@* Copyright @copyright{} 2018 Alex Vong@* Copyright @copyright{} 2019 Josh Holland@* Copyright @copyright{} 2019, 2020 Diego Nicola Barbato@* Copyright @copyright{} 2019 Ivan Petkov@* Copyright @copyright{} 2019 Jakob L. Kreuze@* Copyright @copyright{} 2019 Kyle Andrews@* Copyright @copyright{} 2019 Alex Griffin@* Copyright @copyright{} 2019, 2020, 2021 Guillaume Le Vaillant@* Copyright @copyright{} 2020 Leo Prikler@* Copyright @copyright{} 2019, 2020 Simon Tournier@* Copyright @copyright{} 2020 Wiktor Żelazny@* Copyright @copyright{} 2020 Damien Cassou@* Copyright @copyright{} 2020 Jakub Kądziołka@* Copyright @copyright{} 2020 Jack Hill@* Copyright @copyright{} 2020 Naga Malleswari@* Copyright @copyright{} 2020, 2021 Brice Waegeneire@* Copyright @copyright{} 2020 R Veera Kumar@* Copyright @copyright{} 2020 Pierre Langlois@* Copyright @copyright{} 2020 pinoaffe@* Copyright @copyright{} 2020 André Batista@* Copyright @copyright{} 2020, 2021 Alexandru-Sergiu Marton@* Copyright @copyright{} 2020 raingloom@* Copyright @copyright{} 2020 Daniel Brooks@* Copyright @copyright{} 2020 John Soo@* Copyright @copyright{} 2020 Jonathan Brielmaier@* Copyright @copyright{} 2020 Edgar Vincent@* Copyright @copyright{} 2021 Maxime Devos@* Copyright @copyright{} 2021 B. Wilson@* Copyright @copyright{} 2021 Xinglu Chen@* Copyright @copyright{} 2021 Raghav Gururajan@* Copyright @copyright{} 2021 Domagoj Stolfa@* Copyright @copyright{} 2021 Hui Lu@* Copyright @copyright{} 2021 pukkamustard@* Copyright @copyright{} 2021 Alice Brenon@*"
  2177. msgstr ""
  2178. #. type: copying
  2179. #: guix-git/doc/guix.texi:106
  2180. msgid "Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled ``GNU Free Documentation License''."
  2181. msgstr ""
  2182. #. type: dircategory
  2183. #: guix-git/doc/guix.texi:108
  2184. #, no-wrap
  2185. msgid "System administration"
  2186. msgstr ""
  2187. #. type: menuentry
  2188. #: guix-git/doc/guix.texi:116
  2189. msgid "Guix: (guix)"
  2190. msgstr ""
  2191. #. type: menuentry
  2192. #: guix-git/doc/guix.texi:116
  2193. msgid "Manage installed software and system configuration."
  2194. msgstr ""
  2195. #. type: menuentry
  2196. #: guix-git/doc/guix.texi:116
  2197. msgid "guix package: (guix)Invoking guix package"
  2198. msgstr ""
  2199. #. type: menuentry
  2200. #: guix-git/doc/guix.texi:116
  2201. msgid "Installing, removing, and upgrading packages."
  2202. msgstr ""
  2203. #. type: menuentry
  2204. #: guix-git/doc/guix.texi:116
  2205. msgid "guix gc: (guix)Invoking guix gc"
  2206. msgstr ""
  2207. #. type: menuentry
  2208. #: guix-git/doc/guix.texi:116
  2209. msgid "Reclaiming unused disk space."
  2210. msgstr ""
  2211. #. type: menuentry
  2212. #: guix-git/doc/guix.texi:116
  2213. msgid "guix pull: (guix)Invoking guix pull"
  2214. msgstr ""
  2215. #. type: menuentry
  2216. #: guix-git/doc/guix.texi:116
  2217. msgid "Update the list of available packages."
  2218. msgstr ""
  2219. #. type: menuentry
  2220. #: guix-git/doc/guix.texi:116
  2221. msgid "guix system: (guix)Invoking guix system"
  2222. msgstr ""
  2223. #. type: menuentry
  2224. #: guix-git/doc/guix.texi:116
  2225. msgid "Manage the operating system configuration."
  2226. msgstr ""
  2227. #. type: menuentry
  2228. #: guix-git/doc/guix.texi:116
  2229. msgid "guix deploy: (guix)Invoking guix deploy"
  2230. msgstr ""
  2231. #. type: menuentry
  2232. #: guix-git/doc/guix.texi:116
  2233. msgid "Manage operating system configurations for remote hosts."
  2234. msgstr ""
  2235. #. type: dircategory
  2236. #: guix-git/doc/guix.texi:118
  2237. #, no-wrap
  2238. msgid "Software development"
  2239. msgstr ""
  2240. #. type: menuentry
  2241. #: guix-git/doc/guix.texi:123
  2242. msgid "guix environment: (guix)Invoking guix environment"
  2243. msgstr ""
  2244. #. type: menuentry
  2245. #: guix-git/doc/guix.texi:123
  2246. msgid "Building development environments with Guix."
  2247. msgstr ""
  2248. #. type: menuentry
  2249. #: guix-git/doc/guix.texi:123
  2250. msgid "guix build: (guix)Invoking guix build"
  2251. msgstr ""
  2252. #. type: menuentry
  2253. #: guix-git/doc/guix.texi:123
  2254. msgid "Building packages."
  2255. msgstr ""
  2256. #. type: menuentry
  2257. #: guix-git/doc/guix.texi:123
  2258. msgid "guix pack: (guix)Invoking guix pack"
  2259. msgstr ""
  2260. #. type: menuentry
  2261. #: guix-git/doc/guix.texi:123
  2262. msgid "Creating binary bundles."
  2263. msgstr ""
  2264. #. type: subtitle
  2265. #: guix-git/doc/guix.texi:127
  2266. #, no-wrap
  2267. msgid "Using the GNU Guix Functional Package Manager"
  2268. msgstr ""
  2269. #. type: author
  2270. #: guix-git/doc/guix.texi:128
  2271. #, no-wrap
  2272. msgid "The GNU Guix Developers"
  2273. msgstr ""
  2274. #. type: titlepage
  2275. #: guix-git/doc/guix.texi:134
  2276. msgid "Edition @value{EDITION} @* @value{UPDATED} @*"
  2277. msgstr ""
  2278. #. type: node
  2279. #: guix-git/doc/guix.texi:141
  2280. #, no-wrap
  2281. msgid "Top"
  2282. msgstr ""
  2283. #. type: top
  2284. #: guix-git/doc/guix.texi:142
  2285. #, no-wrap
  2286. msgid "GNU Guix"
  2287. msgstr ""
  2288. #. type: Plain text
  2289. #: guix-git/doc/guix.texi:146
  2290. msgid "This document describes GNU Guix version @value{VERSION}, a functional package management tool written for the GNU system."
  2291. msgstr ""
  2292. #. You can replace the following paragraph with information on
  2293. #. type: Plain text
  2294. #: guix-git/doc/guix.texi:158
  2295. msgid "This manual is also available in Simplified Chinese (@pxref{Top,,, guix.zh_CN, GNU Guix参考手册}), French (@pxref{Top,,, guix.fr, Manuel de référence de GNU Guix}), German (@pxref{Top,,, guix.de, Referenzhandbuch zu GNU Guix}), Spanish (@pxref{Top,,, guix.es, Manual de referencia de GNU Guix}), and Russian (@pxref{Top,,, guix.ru, Руководство GNU Guix}). If you would like to translate it in your native language, consider joining @uref{https://translate.fedoraproject.org/projects/guix/documentation-manual, Weblate} (@pxref{Translating Guix})."
  2296. msgstr ""
  2297. #. type: chapter
  2298. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:186
  2299. #: guix-git/doc/guix.texi:387 guix-git/doc/guix.texi:388
  2300. #, no-wrap
  2301. msgid "Introduction"
  2302. msgstr ""
  2303. #. type: menuentry
  2304. #: guix-git/doc/guix.texi:176
  2305. msgid "What is Guix about?"
  2306. msgstr ""
  2307. #. type: chapter
  2308. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:191
  2309. #: guix-git/doc/guix.texi:568 guix-git/doc/guix.texi:569
  2310. #, no-wrap
  2311. msgid "Installation"
  2312. msgstr "Installazione"
  2313. #. type: menuentry
  2314. #: guix-git/doc/guix.texi:176
  2315. msgid "Installing Guix."
  2316. msgstr ""
  2317. #. type: chapter
  2318. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:207
  2319. #: guix-git/doc/guix.texi:2015 guix-git/doc/guix.texi:2016
  2320. #, no-wrap
  2321. msgid "System Installation"
  2322. msgstr ""
  2323. #. type: menuentry
  2324. #: guix-git/doc/guix.texi:176
  2325. msgid "Installing the whole operating system."
  2326. msgstr ""
  2327. #. type: chapter
  2328. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:2732
  2329. #: guix-git/doc/guix.texi:2733
  2330. #, no-wrap
  2331. msgid "Getting Started"
  2332. msgstr ""
  2333. #. type: menuentry
  2334. #: guix-git/doc/guix.texi:176
  2335. msgid "Your first steps."
  2336. msgstr ""
  2337. #. type: chapter
  2338. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:224
  2339. #: guix-git/doc/guix.texi:2940 guix-git/doc/guix.texi:2941
  2340. #, no-wrap
  2341. msgid "Package Management"
  2342. msgstr ""
  2343. #. type: menuentry
  2344. #: guix-git/doc/guix.texi:176
  2345. msgid "Package installation, upgrade, etc."
  2346. msgstr ""
  2347. #. type: chapter
  2348. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:247
  2349. #: guix-git/doc/guix.texi:4995 guix-git/doc/guix.texi:4996
  2350. #, no-wrap
  2351. msgid "Channels"
  2352. msgstr "Canali"
  2353. #. type: menuentry
  2354. #: guix-git/doc/guix.texi:176
  2355. msgid "Customizing the package collection."
  2356. msgstr ""
  2357. #. type: chapter
  2358. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:261
  2359. #: guix-git/doc/guix.texi:5523 guix-git/doc/guix.texi:5524
  2360. #, no-wrap
  2361. msgid "Development"
  2362. msgstr "Sviluppo"
  2363. #. type: menuentry
  2364. #: guix-git/doc/guix.texi:176
  2365. msgid "Guix-aided software development."
  2366. msgstr ""
  2367. #. type: chapter
  2368. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:268
  2369. #: guix-git/doc/guix.texi:6378 guix-git/doc/guix.texi:6379
  2370. #, no-wrap
  2371. msgid "Programming Interface"
  2372. msgstr ""
  2373. #. type: menuentry
  2374. #: guix-git/doc/guix.texi:176
  2375. msgid "Using Guix in Scheme."
  2376. msgstr ""
  2377. #. type: chapter
  2378. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:287
  2379. #: guix-git/doc/guix.texi:10199 guix-git/doc/guix.texi:10200
  2380. #, no-wrap
  2381. msgid "Utilities"
  2382. msgstr ""
  2383. #. type: menuentry
  2384. #: guix-git/doc/guix.texi:176
  2385. msgid "Package management commands."
  2386. msgstr ""
  2387. #. type: chapter
  2388. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:312
  2389. #: guix-git/doc/guix.texi:13462 guix-git/doc/guix.texi:13463
  2390. #, no-wrap
  2391. msgid "System Configuration"
  2392. msgstr ""
  2393. #. type: menuentry
  2394. #: guix-git/doc/guix.texi:176
  2395. msgid "Configuring the operating system."
  2396. msgstr ""
  2397. #. type: chapter
  2398. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:35094
  2399. #: guix-git/doc/guix.texi:35095
  2400. #, no-wrap
  2401. msgid "Documentation"
  2402. msgstr "Documentazione"
  2403. #. type: menuentry
  2404. #: guix-git/doc/guix.texi:176
  2405. msgid "Browsing software user manuals."
  2406. msgstr ""
  2407. #. type: chapter
  2408. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:374
  2409. #: guix-git/doc/guix.texi:35158 guix-git/doc/guix.texi:35159
  2410. #, no-wrap
  2411. msgid "Installing Debugging Files"
  2412. msgstr ""
  2413. #. type: menuentry
  2414. #: guix-git/doc/guix.texi:176
  2415. msgid "Feeding the debugger."
  2416. msgstr ""
  2417. #. type: chapter
  2418. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:35299
  2419. #: guix-git/doc/guix.texi:35300
  2420. #, no-wrap
  2421. msgid "Security Updates"
  2422. msgstr ""
  2423. #. type: menuentry
  2424. #: guix-git/doc/guix.texi:176
  2425. msgid "Deploying security fixes quickly."
  2426. msgstr ""
  2427. #. type: chapter
  2428. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:379
  2429. #: guix-git/doc/guix.texi:35414 guix-git/doc/guix.texi:35415
  2430. #, no-wrap
  2431. msgid "Bootstrapping"
  2432. msgstr ""
  2433. #. type: menuentry
  2434. #: guix-git/doc/guix.texi:176
  2435. msgid "GNU/Linux built from scratch."
  2436. msgstr ""
  2437. #. type: node
  2438. #: guix-git/doc/guix.texi:176 guix-git/doc/guix.texi:35706
  2439. #, no-wrap
  2440. msgid "Porting"
  2441. msgstr ""
  2442. #. type: menuentry
  2443. #: guix-git/doc/guix.texi:176
  2444. msgid "Targeting another platform or kernel."
  2445. msgstr ""
  2446. #. type: menuentry
  2447. #: guix-git/doc/guix.texi:176
  2448. msgid "Your help needed!"
  2449. msgstr ""
  2450. #. type: chapter
  2451. #: guix-git/doc/guix.texi:181 guix-git/doc/guix.texi:35754
  2452. #: guix-git/doc/guix.texi:35755
  2453. #, no-wrap
  2454. msgid "Acknowledgments"
  2455. msgstr ""
  2456. #. type: menuentry
  2457. #: guix-git/doc/guix.texi:181
  2458. msgid "Thanks!"
  2459. msgstr ""
  2460. #. type: appendix
  2461. #: guix-git/doc/guix.texi:181 guix-git/doc/guix.texi:35776
  2462. #: guix-git/doc/guix.texi:35777
  2463. #, no-wrap
  2464. msgid "GNU Free Documentation License"
  2465. msgstr ""
  2466. #. type: menuentry
  2467. #: guix-git/doc/guix.texi:181
  2468. msgid "The license of this manual."
  2469. msgstr ""
  2470. #. type: unnumbered
  2471. #: guix-git/doc/guix.texi:181 guix-git/doc/guix.texi:35782
  2472. #: guix-git/doc/guix.texi:35783
  2473. #, no-wrap
  2474. msgid "Concept Index"
  2475. msgstr ""
  2476. #. type: menuentry
  2477. #: guix-git/doc/guix.texi:181
  2478. msgid "Concepts."
  2479. msgstr ""
  2480. #. type: unnumbered
  2481. #: guix-git/doc/guix.texi:181 guix-git/doc/guix.texi:35786
  2482. #: guix-git/doc/guix.texi:35787
  2483. #, no-wrap
  2484. msgid "Programming Index"
  2485. msgstr ""
  2486. #. type: menuentry
  2487. #: guix-git/doc/guix.texi:181
  2488. msgid "Data types, functions, and variables."
  2489. msgstr ""
  2490. #. type: menuentry
  2491. #: guix-git/doc/guix.texi:184
  2492. msgid "--- The Detailed Node Listing ---"
  2493. msgstr ""
  2494. #. type: section
  2495. #: guix-git/doc/guix.texi:189 guix-git/doc/guix.texi:414
  2496. #: guix-git/doc/guix.texi:416 guix-git/doc/guix.texi:417
  2497. #, no-wrap
  2498. msgid "Managing Software the Guix Way"
  2499. msgstr ""
  2500. #. type: menuentry
  2501. #: guix-git/doc/guix.texi:189 guix-git/doc/guix.texi:414
  2502. msgid "What's special."
  2503. msgstr ""
  2504. #. type: section
  2505. #: guix-git/doc/guix.texi:189 guix-git/doc/guix.texi:414
  2506. #: guix-git/doc/guix.texi:471 guix-git/doc/guix.texi:472
  2507. #, no-wrap
  2508. msgid "GNU Distribution"
  2509. msgstr ""
  2510. #. type: menuentry
  2511. #: guix-git/doc/guix.texi:189 guix-git/doc/guix.texi:414
  2512. msgid "The packages and tools."
  2513. msgstr ""
  2514. #. type: section
  2515. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2516. #: guix-git/doc/guix.texi:610 guix-git/doc/guix.texi:611
  2517. #, no-wrap
  2518. msgid "Binary Installation"
  2519. msgstr ""
  2520. #. type: menuentry
  2521. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2522. msgid "Getting Guix running in no time!"
  2523. msgstr ""
  2524. #. type: section
  2525. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2526. #: guix-git/doc/guix.texi:838 guix-git/doc/guix.texi:839
  2527. #, no-wrap
  2528. msgid "Requirements"
  2529. msgstr ""
  2530. #. type: menuentry
  2531. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2532. msgid "Software needed to build and run Guix."
  2533. msgstr ""
  2534. #. type: section
  2535. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2536. #: guix-git/doc/guix.texi:924 guix-git/doc/guix.texi:925
  2537. #, no-wrap
  2538. msgid "Running the Test Suite"
  2539. msgstr ""
  2540. #. type: menuentry
  2541. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2542. msgid "Testing Guix."
  2543. msgstr ""
  2544. #. type: section
  2545. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:201
  2546. #: guix-git/doc/guix.texi:608 guix-git/doc/guix.texi:1021
  2547. #: guix-git/doc/guix.texi:1022
  2548. #, no-wrap
  2549. msgid "Setting Up the Daemon"
  2550. msgstr ""
  2551. #. type: menuentry
  2552. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2553. msgid "Preparing the build daemon's environment."
  2554. msgstr ""
  2555. #. type: node
  2556. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2557. #: guix-git/doc/guix.texi:1491
  2558. #, no-wrap
  2559. msgid "Invoking guix-daemon"
  2560. msgstr ""
  2561. #. type: menuentry
  2562. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2563. msgid "Running the build daemon."
  2564. msgstr ""
  2565. #. type: section
  2566. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2567. #: guix-git/doc/guix.texi:1793 guix-git/doc/guix.texi:1794
  2568. #, no-wrap
  2569. msgid "Application Setup"
  2570. msgstr ""
  2571. #. type: menuentry
  2572. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2573. msgid "Application-specific setup."
  2574. msgstr ""
  2575. #. type: section
  2576. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2577. #: guix-git/doc/guix.texi:1978 guix-git/doc/guix.texi:1979
  2578. #, no-wrap
  2579. msgid "Upgrading Guix"
  2580. msgstr ""
  2581. #. type: menuentry
  2582. #: guix-git/doc/guix.texi:199 guix-git/doc/guix.texi:608
  2583. msgid "Upgrading Guix and its build daemon."
  2584. msgstr ""
  2585. #. type: subsection
  2586. #: guix-git/doc/guix.texi:205 guix-git/doc/guix.texi:1041
  2587. #: guix-git/doc/guix.texi:1043 guix-git/doc/guix.texi:1044
  2588. #, no-wrap
  2589. msgid "Build Environment Setup"
  2590. msgstr ""
  2591. #. type: menuentry
  2592. #: guix-git/doc/guix.texi:205 guix-git/doc/guix.texi:1041
  2593. msgid "Preparing the isolated build environment."
  2594. msgstr ""
  2595. #. type: node
  2596. #: guix-git/doc/guix.texi:205 guix-git/doc/guix.texi:1041
  2597. #: guix-git/doc/guix.texi:1162
  2598. #, no-wrap
  2599. msgid "Daemon Offload Setup"
  2600. msgstr ""
  2601. #. type: menuentry
  2602. #: guix-git/doc/guix.texi:205 guix-git/doc/guix.texi:1041
  2603. msgid "Offloading builds to remote machines."
  2604. msgstr ""
  2605. #. type: subsection
  2606. #: guix-git/doc/guix.texi:205 guix-git/doc/guix.texi:1041
  2607. #: guix-git/doc/guix.texi:1400 guix-git/doc/guix.texi:1401
  2608. #, no-wrap
  2609. msgid "SELinux Support"
  2610. msgstr ""
  2611. #. type: menuentry
  2612. #: guix-git/doc/guix.texi:205 guix-git/doc/guix.texi:1041
  2613. msgid "Using an SELinux policy for the daemon."
  2614. msgstr ""
  2615. #. type: section
  2616. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:1436
  2617. #: guix-git/doc/guix.texi:2049 guix-git/doc/guix.texi:2051
  2618. #: guix-git/doc/guix.texi:2052
  2619. #, no-wrap
  2620. msgid "Limitations"
  2621. msgstr ""
  2622. #. type: menuentry
  2623. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2624. msgid "What you can expect."
  2625. msgstr ""
  2626. #. type: section
  2627. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2628. #: guix-git/doc/guix.texi:2077 guix-git/doc/guix.texi:2078
  2629. #, no-wrap
  2630. msgid "Hardware Considerations"
  2631. msgstr ""
  2632. #. type: menuentry
  2633. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2634. msgid "Supported hardware."
  2635. msgstr ""
  2636. #. type: section
  2637. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2638. #: guix-git/doc/guix.texi:2112 guix-git/doc/guix.texi:2113
  2639. #, no-wrap
  2640. msgid "USB Stick and DVD Installation"
  2641. msgstr ""
  2642. #. type: menuentry
  2643. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2644. msgid "Preparing the installation medium."
  2645. msgstr ""
  2646. #. type: section
  2647. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2648. #: guix-git/doc/guix.texi:2193 guix-git/doc/guix.texi:2194
  2649. #, no-wrap
  2650. msgid "Preparing for Installation"
  2651. msgstr ""
  2652. #. type: menuentry
  2653. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2654. msgid "Networking, partitioning, etc."
  2655. msgstr ""
  2656. #. type: section
  2657. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2658. #: guix-git/doc/guix.texi:2216 guix-git/doc/guix.texi:2217
  2659. #, no-wrap
  2660. msgid "Guided Graphical Installation"
  2661. msgstr ""
  2662. #. type: menuentry
  2663. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2664. msgid "Easy graphical installation."
  2665. msgstr ""
  2666. #. type: section
  2667. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:219
  2668. #: guix-git/doc/guix.texi:2049 guix-git/doc/guix.texi:2247
  2669. #: guix-git/doc/guix.texi:2248
  2670. #, no-wrap
  2671. msgid "Manual Installation"
  2672. msgstr ""
  2673. #. type: menuentry
  2674. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2675. msgid "Manual installation for wizards."
  2676. msgstr ""
  2677. #. type: section
  2678. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2679. #: guix-git/doc/guix.texi:2615 guix-git/doc/guix.texi:2616
  2680. #, no-wrap
  2681. msgid "After System Installation"
  2682. msgstr ""
  2683. #. type: menuentry
  2684. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2685. msgid "When installation succeeded."
  2686. msgstr ""
  2687. #. type: node
  2688. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2689. #: guix-git/doc/guix.texi:2649
  2690. #, no-wrap
  2691. msgid "Installing Guix in a VM"
  2692. msgstr ""
  2693. #. type: menuentry
  2694. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2695. msgid "Guix System playground."
  2696. msgstr ""
  2697. #. type: section
  2698. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2699. #: guix-git/doc/guix.texi:2700 guix-git/doc/guix.texi:2701
  2700. #, no-wrap
  2701. msgid "Building the Installation Image"
  2702. msgstr ""
  2703. #. type: menuentry
  2704. #: guix-git/doc/guix.texi:217 guix-git/doc/guix.texi:2049
  2705. msgid "How this comes to be."
  2706. msgstr ""
  2707. #. type: node
  2708. #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:2265
  2709. #: guix-git/doc/guix.texi:2267
  2710. #, no-wrap
  2711. msgid "Keyboard Layout and Networking and Partitioning"
  2712. msgstr ""
  2713. #. type: menuentry
  2714. #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:2265
  2715. msgid "Initial setup."
  2716. msgstr "Configurazione iniziale."
  2717. #. type: subsection
  2718. #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:2265
  2719. #: guix-git/doc/guix.texi:2527 guix-git/doc/guix.texi:2528
  2720. #, no-wrap
  2721. msgid "Proceeding with the Installation"
  2722. msgstr ""
  2723. #. type: menuentry
  2724. #: guix-git/doc/guix.texi:222 guix-git/doc/guix.texi:2265
  2725. msgid "Installing."
  2726. msgstr ""
  2727. #. type: section
  2728. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2729. #: guix-git/doc/guix.texi:2974 guix-git/doc/guix.texi:2975
  2730. #, no-wrap
  2731. msgid "Features"
  2732. msgstr ""
  2733. #. type: menuentry
  2734. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2735. msgid "How Guix will make your life brighter."
  2736. msgstr ""
  2737. #. type: node
  2738. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2739. #: guix-git/doc/guix.texi:3064
  2740. #, no-wrap
  2741. msgid "Invoking guix package"
  2742. msgstr ""
  2743. #. type: menuentry
  2744. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2745. msgid "Package installation, removal, etc."
  2746. msgstr ""
  2747. #. type: section
  2748. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:237
  2749. #: guix-git/doc/guix.texi:2972 guix-git/doc/guix.texi:3680
  2750. #: guix-git/doc/guix.texi:3681
  2751. #, no-wrap
  2752. msgid "Substitutes"
  2753. msgstr ""
  2754. #. type: menuentry
  2755. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2756. msgid "Downloading pre-built binaries."
  2757. msgstr ""
  2758. #. type: section
  2759. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2760. #: guix-git/doc/guix.texi:4016 guix-git/doc/guix.texi:4017
  2761. #, no-wrap
  2762. msgid "Packages with Multiple Outputs"
  2763. msgstr ""
  2764. #. type: menuentry
  2765. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2766. msgid "Single source package, multiple outputs."
  2767. msgstr ""
  2768. #. type: node
  2769. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2770. #: guix-git/doc/guix.texi:4070
  2771. #, no-wrap
  2772. msgid "Invoking guix gc"
  2773. msgstr ""
  2774. #. type: menuentry
  2775. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2776. msgid "Running the garbage collector."
  2777. msgstr ""
  2778. #. type: node
  2779. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2780. #: guix-git/doc/guix.texi:4280
  2781. #, no-wrap
  2782. msgid "Invoking guix pull"
  2783. msgstr ""
  2784. #. type: menuentry
  2785. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2786. msgid "Fetching the latest Guix and distribution."
  2787. msgstr ""
  2788. #. type: node
  2789. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2790. #: guix-git/doc/guix.texi:4527
  2791. #, no-wrap
  2792. msgid "Invoking guix time-machine"
  2793. msgstr ""
  2794. #. type: menuentry
  2795. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2796. msgid "Running an older revision of Guix."
  2797. msgstr ""
  2798. #. type: section
  2799. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2800. #: guix-git/doc/guix.texi:4582 guix-git/doc/guix.texi:4583
  2801. #, no-wrap
  2802. msgid "Inferiors"
  2803. msgstr ""
  2804. #. type: menuentry
  2805. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2806. msgid "Interacting with another revision of Guix."
  2807. msgstr ""
  2808. #. type: node
  2809. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2810. #: guix-git/doc/guix.texi:4710
  2811. #, no-wrap
  2812. msgid "Invoking guix describe"
  2813. msgstr ""
  2814. #. type: menuentry
  2815. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2816. msgid "Display information about your Guix revision."
  2817. msgstr ""
  2818. #. type: node
  2819. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2820. #: guix-git/doc/guix.texi:4805
  2821. #, no-wrap
  2822. msgid "Invoking guix archive"
  2823. msgstr ""
  2824. #. type: menuentry
  2825. #: guix-git/doc/guix.texi:235 guix-git/doc/guix.texi:2972
  2826. msgid "Exporting and importing store files."
  2827. msgstr ""
  2828. #. type: subsection
  2829. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2830. #: guix-git/doc/guix.texi:3706 guix-git/doc/guix.texi:3707
  2831. #, no-wrap
  2832. msgid "Official Substitute Servers"
  2833. msgstr ""
  2834. #. type: menuentry
  2835. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2836. msgid "One particular source of substitutes."
  2837. msgstr ""
  2838. #. type: subsection
  2839. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2840. #: guix-git/doc/guix.texi:3736 guix-git/doc/guix.texi:3737
  2841. #, no-wrap
  2842. msgid "Substitute Server Authorization"
  2843. msgstr ""
  2844. #. type: menuentry
  2845. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2846. msgid "How to enable or disable substitutes."
  2847. msgstr ""
  2848. #. type: subsection
  2849. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2850. #: guix-git/doc/guix.texi:3806 guix-git/doc/guix.texi:3807
  2851. #, no-wrap
  2852. msgid "Getting Substitutes from Other Servers"
  2853. msgstr ""
  2854. #. type: menuentry
  2855. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2856. msgid "Substitute diversity."
  2857. msgstr ""
  2858. #. type: subsection
  2859. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2860. #: guix-git/doc/guix.texi:3911 guix-git/doc/guix.texi:3912
  2861. #, no-wrap
  2862. msgid "Substitute Authentication"
  2863. msgstr ""
  2864. #. type: menuentry
  2865. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2866. msgid "How Guix verifies substitutes."
  2867. msgstr ""
  2868. #. type: subsection
  2869. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2870. #: guix-git/doc/guix.texi:3946 guix-git/doc/guix.texi:3947
  2871. #, no-wrap
  2872. msgid "Proxy Settings"
  2873. msgstr ""
  2874. #. type: menuentry
  2875. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2876. msgid "How to get substitutes via proxy."
  2877. msgstr ""
  2878. #. type: subsection
  2879. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2880. #: guix-git/doc/guix.texi:3958 guix-git/doc/guix.texi:3959
  2881. #, no-wrap
  2882. msgid "Substitution Failure"
  2883. msgstr ""
  2884. #. type: menuentry
  2885. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2886. msgid "What happens when substitution fails."
  2887. msgstr ""
  2888. #. type: subsection
  2889. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2890. #: guix-git/doc/guix.texi:3986 guix-git/doc/guix.texi:3987
  2891. #, no-wrap
  2892. msgid "On Trusting Binaries"
  2893. msgstr ""
  2894. #. type: menuentry
  2895. #: guix-git/doc/guix.texi:245 guix-git/doc/guix.texi:3704
  2896. msgid "How can you trust that binary blob?"
  2897. msgstr ""
  2898. #. type: section
  2899. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2900. #: guix-git/doc/guix.texi:5028 guix-git/doc/guix.texi:5029
  2901. #, no-wrap
  2902. msgid "Specifying Additional Channels"
  2903. msgstr ""
  2904. #. type: menuentry
  2905. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2906. msgid "Extending the package collection."
  2907. msgstr ""
  2908. #. type: section
  2909. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2910. #: guix-git/doc/guix.texi:5078 guix-git/doc/guix.texi:5079
  2911. #, no-wrap
  2912. msgid "Using a Custom Guix Channel"
  2913. msgstr ""
  2914. #. type: menuentry
  2915. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2916. msgid "Using a customized Guix."
  2917. msgstr ""
  2918. #. type: section
  2919. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2920. #: guix-git/doc/guix.texi:5100 guix-git/doc/guix.texi:5101
  2921. #, no-wrap
  2922. msgid "Replicating Guix"
  2923. msgstr ""
  2924. #. type: menuentry
  2925. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2926. msgid "Running the @emph{exact same} Guix."
  2927. msgstr ""
  2928. #. type: section
  2929. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2930. #: guix-git/doc/guix.texi:5141 guix-git/doc/guix.texi:5142
  2931. #, no-wrap
  2932. msgid "Channel Authentication"
  2933. msgstr ""
  2934. #. type: menuentry
  2935. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2936. msgid "How Guix verifies what it fetches."
  2937. msgstr ""
  2938. #. type: section
  2939. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2940. #: guix-git/doc/guix.texi:5181 guix-git/doc/guix.texi:5182
  2941. #, no-wrap
  2942. msgid "Channels with Substitutes"
  2943. msgstr ""
  2944. #. type: menuentry
  2945. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2946. msgid "Using channels with available substitutes."
  2947. msgstr ""
  2948. #. type: section
  2949. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2950. #: guix-git/doc/guix.texi:5206 guix-git/doc/guix.texi:5207
  2951. #, no-wrap
  2952. msgid "Creating a Channel"
  2953. msgstr ""
  2954. #. type: menuentry
  2955. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2956. msgid "How to write your custom channel."
  2957. msgstr ""
  2958. #. type: section
  2959. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2960. #: guix-git/doc/guix.texi:5273 guix-git/doc/guix.texi:5274
  2961. #, no-wrap
  2962. msgid "Package Modules in a Sub-directory"
  2963. msgstr ""
  2964. #. type: menuentry
  2965. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2966. msgid "Specifying the channel's package modules location."
  2967. msgstr ""
  2968. #. type: section
  2969. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2970. #: guix-git/doc/guix.texi:5287 guix-git/doc/guix.texi:5288
  2971. #, no-wrap
  2972. msgid "Declaring Channel Dependencies"
  2973. msgstr ""
  2974. #. type: menuentry
  2975. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2976. msgid "How to depend on other channels."
  2977. msgstr ""
  2978. #. type: section
  2979. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2980. #: guix-git/doc/guix.texi:5329 guix-git/doc/guix.texi:5330
  2981. #, no-wrap
  2982. msgid "Specifying Channel Authorizations"
  2983. msgstr ""
  2984. #. type: menuentry
  2985. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2986. msgid "Defining channel authors authorizations."
  2987. msgstr ""
  2988. #. type: section
  2989. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2990. #: guix-git/doc/guix.texi:5430 guix-git/doc/guix.texi:5431
  2991. #, no-wrap
  2992. msgid "Primary URL"
  2993. msgstr ""
  2994. #. type: menuentry
  2995. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  2996. msgid "Distinguishing mirror to original."
  2997. msgstr ""
  2998. #. type: section
  2999. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  3000. #: guix-git/doc/guix.texi:5453 guix-git/doc/guix.texi:5454
  3001. #, no-wrap
  3002. msgid "Writing Channel News"
  3003. msgstr ""
  3004. #. type: menuentry
  3005. #: guix-git/doc/guix.texi:259 guix-git/doc/guix.texi:5026
  3006. msgid "Communicating information to channel's users."
  3007. msgstr ""
  3008. #. type: node
  3009. #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:5542
  3010. #: guix-git/doc/guix.texi:5544
  3011. #, no-wrap
  3012. msgid "Invoking guix environment"
  3013. msgstr ""
  3014. #. type: menuentry
  3015. #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:5542
  3016. msgid "Setting up development environments."
  3017. msgstr ""
  3018. #. type: node
  3019. #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:5542
  3020. #: guix-git/doc/guix.texi:5904
  3021. #, no-wrap
  3022. msgid "Invoking guix pack"
  3023. msgstr ""
  3024. #. type: menuentry
  3025. #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:5542
  3026. msgid "Creating software bundles."
  3027. msgstr ""
  3028. #. type: section
  3029. #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:5542
  3030. #: guix-git/doc/guix.texi:6290 guix-git/doc/guix.texi:6291
  3031. #, no-wrap
  3032. msgid "The GCC toolchain"
  3033. msgstr ""
  3034. #. type: menuentry
  3035. #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:5542
  3036. msgid "Working with languages supported by GCC."
  3037. msgstr ""
  3038. #. type: node
  3039. #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:5542
  3040. #: guix-git/doc/guix.texi:6316
  3041. #, no-wrap
  3042. msgid "Invoking guix git authenticate"
  3043. msgstr ""
  3044. #. type: menuentry
  3045. #: guix-git/doc/guix.texi:266 guix-git/doc/guix.texi:5542
  3046. msgid "Authenticating Git repositories."
  3047. msgstr ""
  3048. #. type: section
  3049. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3050. #: guix-git/doc/guix.texi:6420 guix-git/doc/guix.texi:6421
  3051. #, no-wrap
  3052. msgid "Package Modules"
  3053. msgstr ""
  3054. #. type: menuentry
  3055. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3056. msgid "Packages from the programmer's viewpoint."
  3057. msgstr ""
  3058. #. type: section
  3059. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:282
  3060. #: guix-git/doc/guix.texi:6418 guix-git/doc/guix.texi:6482
  3061. #: guix-git/doc/guix.texi:6483
  3062. #, no-wrap
  3063. msgid "Defining Packages"
  3064. msgstr ""
  3065. #. type: menuentry
  3066. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3067. msgid "Defining new packages."
  3068. msgstr ""
  3069. #. type: section
  3070. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3071. #: guix-git/doc/guix.texi:7051 guix-git/doc/guix.texi:7052
  3072. #, no-wrap
  3073. msgid "Defining Package Variants"
  3074. msgstr ""
  3075. #. type: menuentry
  3076. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3077. msgid "Customizing packages."
  3078. msgstr ""
  3079. #. type: section
  3080. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3081. #: guix-git/doc/guix.texi:7283 guix-git/doc/guix.texi:7284
  3082. #, no-wrap
  3083. msgid "Build Systems"
  3084. msgstr ""
  3085. #. type: menuentry
  3086. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3087. msgid "Specifying how packages are built."
  3088. msgstr ""
  3089. #. type: subsection
  3090. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3091. #: guix-git/doc/guix.texi:8313 guix-git/doc/guix.texi:8314
  3092. #: guix-git/doc/guix.texi:8717
  3093. #, no-wrap
  3094. msgid "Build Phases"
  3095. msgstr ""
  3096. #. type: menuentry
  3097. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3098. msgid "Phases of the build process of a package."
  3099. msgstr ""
  3100. #. type: section
  3101. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3102. #: guix-git/doc/guix.texi:8507 guix-git/doc/guix.texi:8508
  3103. #, no-wrap
  3104. msgid "Build Utilities"
  3105. msgstr ""
  3106. #. type: menuentry
  3107. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3108. msgid "Helpers for your package definitions and more."
  3109. msgstr ""
  3110. #. type: section
  3111. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3112. #: guix-git/doc/guix.texi:8794 guix-git/doc/guix.texi:8795
  3113. #, no-wrap
  3114. msgid "The Store"
  3115. msgstr ""
  3116. #. type: menuentry
  3117. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3118. msgid "Manipulating the package store."
  3119. msgstr ""
  3120. #. type: section
  3121. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3122. #: guix-git/doc/guix.texi:8947 guix-git/doc/guix.texi:8948
  3123. #, no-wrap
  3124. msgid "Derivations"
  3125. msgstr ""
  3126. #. type: menuentry
  3127. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3128. msgid "Low-level interface to package derivations."
  3129. msgstr ""
  3130. #. type: section
  3131. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3132. #: guix-git/doc/guix.texi:9141 guix-git/doc/guix.texi:9142
  3133. #, no-wrap
  3134. msgid "The Store Monad"
  3135. msgstr ""
  3136. #. type: menuentry
  3137. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3138. msgid "Purely functional interface to the store."
  3139. msgstr ""
  3140. #. type: section
  3141. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3142. #: guix-git/doc/guix.texi:9460 guix-git/doc/guix.texi:9461
  3143. #, no-wrap
  3144. msgid "G-Expressions"
  3145. msgstr ""
  3146. #. type: menuentry
  3147. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3148. msgid "Manipulating build expressions."
  3149. msgstr ""
  3150. #. type: node
  3151. #: guix-git/doc/guix.texi:280 guix-git/doc/guix.texi:6418
  3152. #: guix-git/doc/guix.texi:10099
  3153. #, no-wrap
  3154. msgid "Invoking guix repl"
  3155. msgstr ""
  3156. #. type: menuentry
  3157. #: guix-git/doc/guix.texi:280
  3158. msgid "Programming Guix in Guile."
  3159. msgstr ""
  3160. #. type: node
  3161. #: guix-git/doc/guix.texi:285 guix-git/doc/guix.texi:6685
  3162. #: guix-git/doc/guix.texi:6688
  3163. #, no-wrap
  3164. msgid "package Reference"
  3165. msgstr ""
  3166. #. type: menuentry
  3167. #: guix-git/doc/guix.texi:285 guix-git/doc/guix.texi:6685
  3168. msgid "The package data type."
  3169. msgstr ""
  3170. #. type: node
  3171. #: guix-git/doc/guix.texi:285 guix-git/doc/guix.texi:6685
  3172. #: guix-git/doc/guix.texi:6860
  3173. #, no-wrap
  3174. msgid "origin Reference"
  3175. msgstr ""
  3176. #. type: menuentry
  3177. #: guix-git/doc/guix.texi:285 guix-git/doc/guix.texi:6685
  3178. msgid "The origin data type."
  3179. msgstr ""
  3180. #. type: node
  3181. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3182. #: guix-git/doc/guix.texi:10225
  3183. #, no-wrap
  3184. msgid "Invoking guix build"
  3185. msgstr ""
  3186. #. type: menuentry
  3187. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3188. msgid "Building packages from the command line."
  3189. msgstr ""
  3190. #. type: node
  3191. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3192. #: guix-git/doc/guix.texi:11061
  3193. #, no-wrap
  3194. msgid "Invoking guix edit"
  3195. msgstr ""
  3196. #. type: menuentry
  3197. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3198. msgid "Editing package definitions."
  3199. msgstr ""
  3200. #. type: node
  3201. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3202. #: guix-git/doc/guix.texi:11091
  3203. #, no-wrap
  3204. msgid "Invoking guix download"
  3205. msgstr ""
  3206. #. type: menuentry
  3207. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3208. msgid "Downloading a file and printing its hash."
  3209. msgstr ""
  3210. #. type: node
  3211. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3212. #: guix-git/doc/guix.texi:11149
  3213. #, no-wrap
  3214. msgid "Invoking guix hash"
  3215. msgstr ""
  3216. #. type: menuentry
  3217. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3218. msgid "Computing the cryptographic hash of a file."
  3219. msgstr ""
  3220. #. type: node
  3221. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3222. #: guix-git/doc/guix.texi:11221
  3223. #, no-wrap
  3224. msgid "Invoking guix import"
  3225. msgstr ""
  3226. #. type: menuentry
  3227. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3228. msgid "Importing package definitions."
  3229. msgstr ""
  3230. #. type: node
  3231. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3232. #: guix-git/doc/guix.texi:11747
  3233. #, no-wrap
  3234. msgid "Invoking guix refresh"
  3235. msgstr ""
  3236. #. type: menuentry
  3237. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3238. msgid "Updating package definitions."
  3239. msgstr ""
  3240. #. type: node
  3241. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3242. #: guix-git/doc/guix.texi:12085
  3243. #, no-wrap
  3244. msgid "Invoking guix lint"
  3245. msgstr ""
  3246. #. type: menuentry
  3247. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3248. msgid "Finding errors in package definitions."
  3249. msgstr ""
  3250. #. type: node
  3251. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3252. #: guix-git/doc/guix.texi:12254
  3253. #, no-wrap
  3254. msgid "Invoking guix size"
  3255. msgstr ""
  3256. #. type: menuentry
  3257. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3258. msgid "Profiling disk usage."
  3259. msgstr ""
  3260. #. type: node
  3261. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3262. #: guix-git/doc/guix.texi:12398
  3263. #, no-wrap
  3264. msgid "Invoking guix graph"
  3265. msgstr ""
  3266. #. type: menuentry
  3267. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3268. msgid "Visualizing the graph of packages."
  3269. msgstr ""
  3270. #. type: node
  3271. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3272. #: guix-git/doc/guix.texi:12665
  3273. #, no-wrap
  3274. msgid "Invoking guix publish"
  3275. msgstr ""
  3276. #. type: menuentry
  3277. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3278. msgid "Sharing substitutes."
  3279. msgstr ""
  3280. #. type: node
  3281. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3282. #: guix-git/doc/guix.texi:12934
  3283. #, no-wrap
  3284. msgid "Invoking guix challenge"
  3285. msgstr ""
  3286. #. type: menuentry
  3287. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3288. msgid "Challenging substitute servers."
  3289. msgstr ""
  3290. #. type: node
  3291. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3292. #: guix-git/doc/guix.texi:13117
  3293. #, no-wrap
  3294. msgid "Invoking guix copy"
  3295. msgstr ""
  3296. #. type: menuentry
  3297. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3298. msgid "Copying to and from a remote store."
  3299. msgstr ""
  3300. #. type: node
  3301. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3302. #: guix-git/doc/guix.texi:13180
  3303. #, no-wrap
  3304. msgid "Invoking guix container"
  3305. msgstr ""
  3306. #. type: menuentry
  3307. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3308. msgid "Process isolation."
  3309. msgstr ""
  3310. #. type: node
  3311. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3312. #: guix-git/doc/guix.texi:13234
  3313. #, no-wrap
  3314. msgid "Invoking guix weather"
  3315. msgstr ""
  3316. #. type: menuentry
  3317. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3318. msgid "Assessing substitute availability."
  3319. msgstr ""
  3320. #. type: node
  3321. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3322. #: guix-git/doc/guix.texi:13364
  3323. #, no-wrap
  3324. msgid "Invoking guix processes"
  3325. msgstr ""
  3326. #. type: menuentry
  3327. #: guix-git/doc/guix.texi:303 guix-git/doc/guix.texi:10223
  3328. msgid "Listing client processes."
  3329. msgstr ""
  3330. #. type: section
  3331. #: guix-git/doc/guix.texi:305 guix-git/doc/guix.texi:10226
  3332. #, no-wrap
  3333. msgid "Invoking @command{guix build}"
  3334. msgstr ""
  3335. #. type: subsection
  3336. #: guix-git/doc/guix.texi:310 guix-git/doc/guix.texi:10277
  3337. #: guix-git/doc/guix.texi:10279 guix-git/doc/guix.texi:10280
  3338. #, no-wrap
  3339. msgid "Common Build Options"
  3340. msgstr ""
  3341. #. type: menuentry
  3342. #: guix-git/doc/guix.texi:310 guix-git/doc/guix.texi:10277
  3343. msgid "Build options for most commands."
  3344. msgstr ""
  3345. #. type: subsection
  3346. #: guix-git/doc/guix.texi:310 guix-git/doc/guix.texi:10277
  3347. #: guix-git/doc/guix.texi:10434 guix-git/doc/guix.texi:10435
  3348. #, no-wrap
  3349. msgid "Package Transformation Options"
  3350. msgstr ""
  3351. #. type: menuentry
  3352. #: guix-git/doc/guix.texi:310 guix-git/doc/guix.texi:10277
  3353. msgid "Creating variants of packages."
  3354. msgstr ""
  3355. #. type: subsection
  3356. #: guix-git/doc/guix.texi:310 guix-git/doc/guix.texi:10277
  3357. #: guix-git/doc/guix.texi:10743 guix-git/doc/guix.texi:10744
  3358. #, no-wrap
  3359. msgid "Additional Build Options"
  3360. msgstr ""
  3361. #. type: menuentry
  3362. #: guix-git/doc/guix.texi:310 guix-git/doc/guix.texi:10277
  3363. msgid "Options specific to 'guix build'."
  3364. msgstr ""
  3365. #. type: subsection
  3366. #: guix-git/doc/guix.texi:310 guix-git/doc/guix.texi:10277
  3367. #: guix-git/doc/guix.texi:10981 guix-git/doc/guix.texi:10982
  3368. #, no-wrap
  3369. msgid "Debugging Build Failures"
  3370. msgstr ""
  3371. #. type: menuentry
  3372. #: guix-git/doc/guix.texi:310 guix-git/doc/guix.texi:10277
  3373. msgid "Real life packaging experience."
  3374. msgstr ""
  3375. #. type: section
  3376. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3377. #: guix-git/doc/guix.texi:13507 guix-git/doc/guix.texi:13508
  3378. #, no-wrap
  3379. msgid "Using the Configuration System"
  3380. msgstr ""
  3381. #. type: menuentry
  3382. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3383. msgid "Customizing your GNU system."
  3384. msgstr ""
  3385. #. type: node
  3386. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3387. #: guix-git/doc/guix.texi:13758
  3388. #, no-wrap
  3389. msgid "operating-system Reference"
  3390. msgstr ""
  3391. #. type: menuentry
  3392. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3393. msgid "Detail of operating-system declarations."
  3394. msgstr ""
  3395. #. type: section
  3396. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3397. #: guix-git/doc/guix.texi:14010 guix-git/doc/guix.texi:14011
  3398. #, no-wrap
  3399. msgid "File Systems"
  3400. msgstr "Filesystem"
  3401. #. type: menuentry
  3402. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3403. msgid "Configuring file system mounts."
  3404. msgstr ""
  3405. #. type: section
  3406. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3407. #: guix-git/doc/guix.texi:14333 guix-git/doc/guix.texi:14334
  3408. #, no-wrap
  3409. msgid "Mapped Devices"
  3410. msgstr ""
  3411. #. type: menuentry
  3412. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3413. msgid "Block device extra processing."
  3414. msgstr ""
  3415. #. type: section
  3416. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3417. #: guix-git/doc/guix.texi:14481 guix-git/doc/guix.texi:14482
  3418. #, no-wrap
  3419. msgid "User Accounts"
  3420. msgstr ""
  3421. #. type: menuentry
  3422. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3423. msgid "Specifying user accounts."
  3424. msgstr ""
  3425. #. type: section
  3426. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:2274
  3427. #: guix-git/doc/guix.texi:13505 guix-git/doc/guix.texi:14657
  3428. #: guix-git/doc/guix.texi:14658
  3429. #, no-wrap
  3430. msgid "Keyboard Layout"
  3431. msgstr ""
  3432. #. type: menuentry
  3433. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3434. msgid "How the system interprets key strokes."
  3435. msgstr ""
  3436. #. type: section
  3437. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:1801
  3438. #: guix-git/doc/guix.texi:13505 guix-git/doc/guix.texi:14803
  3439. #: guix-git/doc/guix.texi:14804
  3440. #, no-wrap
  3441. msgid "Locales"
  3442. msgstr "Lingue"
  3443. #. type: menuentry
  3444. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3445. msgid "Language and cultural convention settings."
  3446. msgstr ""
  3447. #. type: section
  3448. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:332
  3449. #: guix-git/doc/guix.texi:13505 guix-git/doc/guix.texi:14943
  3450. #: guix-git/doc/guix.texi:14944
  3451. #, no-wrap
  3452. msgid "Services"
  3453. msgstr "Servizi"
  3454. #. type: menuentry
  3455. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3456. msgid "Specifying system services."
  3457. msgstr ""
  3458. #. type: section
  3459. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3460. #: guix-git/doc/guix.texi:32688 guix-git/doc/guix.texi:32689
  3461. #, no-wrap
  3462. msgid "Setuid Programs"
  3463. msgstr ""
  3464. #. type: menuentry
  3465. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3466. msgid "Programs running with root privileges."
  3467. msgstr ""
  3468. #. type: section
  3469. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:1950
  3470. #: guix-git/doc/guix.texi:13505 guix-git/doc/guix.texi:32761
  3471. #: guix-git/doc/guix.texi:32762
  3472. #, no-wrap
  3473. msgid "X.509 Certificates"
  3474. msgstr ""
  3475. #. type: menuentry
  3476. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3477. msgid "Authenticating HTTPS servers."
  3478. msgstr ""
  3479. #. type: section
  3480. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:1844
  3481. #: guix-git/doc/guix.texi:13505 guix-git/doc/guix.texi:32824
  3482. #: guix-git/doc/guix.texi:32825
  3483. #, no-wrap
  3484. msgid "Name Service Switch"
  3485. msgstr ""
  3486. #. type: menuentry
  3487. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3488. msgid "Configuring libc's name service switch."
  3489. msgstr ""
  3490. #. type: section
  3491. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3492. #: guix-git/doc/guix.texi:32962 guix-git/doc/guix.texi:32963
  3493. #, no-wrap
  3494. msgid "Initial RAM Disk"
  3495. msgstr ""
  3496. #. type: menuentry
  3497. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3498. msgid "Linux-Libre bootstrapping."
  3499. msgstr ""
  3500. #. type: section
  3501. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3502. #: guix-git/doc/guix.texi:33138 guix-git/doc/guix.texi:33139
  3503. #, no-wrap
  3504. msgid "Bootloader Configuration"
  3505. msgstr ""
  3506. #. type: menuentry
  3507. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3508. msgid "Configuring the boot loader."
  3509. msgstr ""
  3510. #. type: node
  3511. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3512. #: guix-git/doc/guix.texi:33432
  3513. #, no-wrap
  3514. msgid "Invoking guix system"
  3515. msgstr ""
  3516. #. type: menuentry
  3517. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3518. msgid "Instantiating a system configuration."
  3519. msgstr ""
  3520. #. type: node
  3521. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3522. #: guix-git/doc/guix.texi:34017
  3523. #, no-wrap
  3524. msgid "Invoking guix deploy"
  3525. msgstr ""
  3526. #. type: menuentry
  3527. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3528. msgid "Deploying a system configuration to a remote host."
  3529. msgstr ""
  3530. #. type: node
  3531. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3532. #: guix-git/doc/guix.texi:34223
  3533. #, no-wrap
  3534. msgid "Running Guix in a VM"
  3535. msgstr ""
  3536. #. type: menuentry
  3537. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3538. msgid "How to run Guix System in a virtual machine."
  3539. msgstr ""
  3540. #. type: section
  3541. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:367
  3542. #: guix-git/doc/guix.texi:13505 guix-git/doc/guix.texi:34357
  3543. #: guix-git/doc/guix.texi:34358
  3544. #, no-wrap
  3545. msgid "Defining Services"
  3546. msgstr ""
  3547. #. type: menuentry
  3548. #: guix-git/doc/guix.texi:330 guix-git/doc/guix.texi:13505
  3549. msgid "Adding new service definitions."
  3550. msgstr ""
  3551. #. type: subsection
  3552. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3553. #: guix-git/doc/guix.texi:15028 guix-git/doc/guix.texi:15029
  3554. #, no-wrap
  3555. msgid "Base Services"
  3556. msgstr ""
  3557. #. type: menuentry
  3558. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3559. msgid "Essential system services."
  3560. msgstr ""
  3561. #. type: subsection
  3562. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3563. #: guix-git/doc/guix.texi:15955 guix-git/doc/guix.texi:15956
  3564. #, no-wrap
  3565. msgid "Scheduled Job Execution"
  3566. msgstr ""
  3567. #. type: menuentry
  3568. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3569. msgid "The mcron service."
  3570. msgstr ""
  3571. #. type: subsection
  3572. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3573. #: guix-git/doc/guix.texi:16105 guix-git/doc/guix.texi:16106
  3574. #, no-wrap
  3575. msgid "Log Rotation"
  3576. msgstr ""
  3577. #. type: menuentry
  3578. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3579. msgid "The rottlog service."
  3580. msgstr ""
  3581. #. type: subsection
  3582. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3583. #: guix-git/doc/guix.texi:16218 guix-git/doc/guix.texi:16219
  3584. #, no-wrap
  3585. msgid "Networking Services"
  3586. msgstr ""
  3587. #. type: menuentry
  3588. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3589. msgid "Network setup, SSH daemon, etc."
  3590. msgstr ""
  3591. #. type: subsection
  3592. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3593. #: guix-git/doc/guix.texi:17883 guix-git/doc/guix.texi:17884
  3594. #, no-wrap
  3595. msgid "Unattended Upgrades"
  3596. msgstr ""
  3597. #. type: menuentry
  3598. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3599. msgid "Automated system upgrades."
  3600. msgstr ""
  3601. #. type: subsection
  3602. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3603. #: guix-git/doc/guix.texi:18021 guix-git/doc/guix.texi:18022
  3604. #, no-wrap
  3605. msgid "X Window"
  3606. msgstr ""
  3607. #. type: menuentry
  3608. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3609. msgid "Graphical display."
  3610. msgstr ""
  3611. #. type: subsection
  3612. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3613. #: guix-git/doc/guix.texi:18406 guix-git/doc/guix.texi:18407
  3614. #, no-wrap
  3615. msgid "Printing Services"
  3616. msgstr ""
  3617. #. type: menuentry
  3618. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3619. msgid "Local and remote printer support."
  3620. msgstr ""
  3621. #. type: subsection
  3622. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3623. #: guix-git/doc/guix.texi:19253 guix-git/doc/guix.texi:19254
  3624. #, no-wrap
  3625. msgid "Desktop Services"
  3626. msgstr ""
  3627. #. type: menuentry
  3628. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3629. msgid "D-Bus and desktop services."
  3630. msgstr ""
  3631. #. type: subsection
  3632. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3633. #: guix-git/doc/guix.texi:19771 guix-git/doc/guix.texi:19772
  3634. #, no-wrap
  3635. msgid "Sound Services"
  3636. msgstr ""
  3637. #. type: menuentry
  3638. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3639. msgid "ALSA and Pulseaudio services."
  3640. msgstr ""
  3641. #. type: subsection
  3642. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3643. #: guix-git/doc/guix.texi:19911 guix-git/doc/guix.texi:19912
  3644. #, no-wrap
  3645. msgid "Database Services"
  3646. msgstr ""
  3647. #. type: menuentry
  3648. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3649. msgid "SQL databases, key-value stores, etc."
  3650. msgstr ""
  3651. #. type: subsection
  3652. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3653. #: guix-git/doc/guix.texi:20246 guix-git/doc/guix.texi:20247
  3654. #, no-wrap
  3655. msgid "Mail Services"
  3656. msgstr ""
  3657. #. type: menuentry
  3658. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3659. msgid "IMAP, POP3, SMTP, and all that."
  3660. msgstr ""
  3661. #. type: subsection
  3662. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3663. #: guix-git/doc/guix.texi:22105 guix-git/doc/guix.texi:22106
  3664. #, no-wrap
  3665. msgid "Messaging Services"
  3666. msgstr ""
  3667. #. type: menuentry
  3668. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3669. msgid "Messaging services."
  3670. msgstr ""
  3671. #. type: subsection
  3672. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3673. #: guix-git/doc/guix.texi:22608 guix-git/doc/guix.texi:22609
  3674. #, no-wrap
  3675. msgid "Telephony Services"
  3676. msgstr ""
  3677. #. type: menuentry
  3678. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3679. msgid "Telephony services."
  3680. msgstr ""
  3681. #. type: subsection
  3682. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3683. #: guix-git/doc/guix.texi:23839 guix-git/doc/guix.texi:23840
  3684. #, no-wrap
  3685. msgid "Monitoring Services"
  3686. msgstr ""
  3687. #. type: menuentry
  3688. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3689. msgid "Monitoring services."
  3690. msgstr ""
  3691. #. type: subsection
  3692. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3693. #: guix-git/doc/guix.texi:24350 guix-git/doc/guix.texi:24351
  3694. #, no-wrap
  3695. msgid "Kerberos Services"
  3696. msgstr ""
  3697. #. type: menuentry
  3698. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3699. msgid "Kerberos services."
  3700. msgstr ""
  3701. #. type: subsection
  3702. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3703. #: guix-git/doc/guix.texi:24476 guix-git/doc/guix.texi:24477
  3704. #, no-wrap
  3705. msgid "LDAP Services"
  3706. msgstr ""
  3707. #. type: menuentry
  3708. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3709. msgid "LDAP services."
  3710. msgstr ""
  3711. #. type: subsection
  3712. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3713. #: guix-git/doc/guix.texi:24955 guix-git/doc/guix.texi:24956
  3714. #, no-wrap
  3715. msgid "Web Services"
  3716. msgstr ""
  3717. #. type: menuentry
  3718. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3719. msgid "Web servers."
  3720. msgstr ""
  3721. #. type: subsection
  3722. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3723. #: guix-git/doc/guix.texi:26156 guix-git/doc/guix.texi:26157
  3724. #, no-wrap
  3725. msgid "Certificate Services"
  3726. msgstr ""
  3727. #. type: menuentry
  3728. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3729. msgid "TLS certificates via Let's Encrypt."
  3730. msgstr ""
  3731. #. type: subsection
  3732. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3733. #: guix-git/doc/guix.texi:26337 guix-git/doc/guix.texi:26338
  3734. #, no-wrap
  3735. msgid "DNS Services"
  3736. msgstr ""
  3737. #. type: menuentry
  3738. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3739. msgid "DNS daemons."
  3740. msgstr ""
  3741. #. type: subsection
  3742. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3743. #: guix-git/doc/guix.texi:27085 guix-git/doc/guix.texi:27086
  3744. #, no-wrap
  3745. msgid "VPN Services"
  3746. msgstr ""
  3747. #. type: menuentry
  3748. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3749. msgid "VPN daemons."
  3750. msgstr ""
  3751. #. type: subsection
  3752. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3753. #: guix-git/doc/guix.texi:27591 guix-git/doc/guix.texi:27592
  3754. #, no-wrap
  3755. msgid "Network File System"
  3756. msgstr "Filesystem di rete"
  3757. #. type: menuentry
  3758. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3759. msgid "NFS related services."
  3760. msgstr ""
  3761. #. type: subsection
  3762. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3763. #: guix-git/doc/guix.texi:27787 guix-git/doc/guix.texi:27788
  3764. #, no-wrap
  3765. msgid "Continuous Integration"
  3766. msgstr ""
  3767. #. type: menuentry
  3768. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3769. msgid "Cuirass and Laminar services."
  3770. msgstr ""
  3771. #. type: subsection
  3772. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3773. #: guix-git/doc/guix.texi:28073 guix-git/doc/guix.texi:28074
  3774. #, no-wrap
  3775. msgid "Power Management Services"
  3776. msgstr ""
  3777. #. type: menuentry
  3778. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3779. msgid "Extending battery life."
  3780. msgstr ""
  3781. #. type: subsection
  3782. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3783. #: guix-git/doc/guix.texi:28607 guix-git/doc/guix.texi:28608
  3784. #, no-wrap
  3785. msgid "Audio Services"
  3786. msgstr ""
  3787. #. type: menuentry
  3788. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3789. msgid "The MPD."
  3790. msgstr ""
  3791. #. type: subsection
  3792. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3793. #: guix-git/doc/guix.texi:28726 guix-git/doc/guix.texi:28727
  3794. #, no-wrap
  3795. msgid "Virtualization Services"
  3796. msgstr ""
  3797. #. type: menuentry
  3798. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3799. msgid "Virtualization services."
  3800. msgstr ""
  3801. #. type: subsection
  3802. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3803. #: guix-git/doc/guix.texi:30341 guix-git/doc/guix.texi:30342
  3804. #, no-wrap
  3805. msgid "Version Control Services"
  3806. msgstr ""
  3807. #. type: menuentry
  3808. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3809. msgid "Providing remote access to Git repositories."
  3810. msgstr ""
  3811. #. type: subsection
  3812. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3813. #: guix-git/doc/guix.texi:31533 guix-git/doc/guix.texi:31534
  3814. #, no-wrap
  3815. msgid "Game Services"
  3816. msgstr ""
  3817. #. type: menuentry
  3818. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3819. msgid "Game servers."
  3820. msgstr ""
  3821. #. type: subsection
  3822. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3823. #: guix-git/doc/guix.texi:31565 guix-git/doc/guix.texi:31566
  3824. #, no-wrap
  3825. msgid "PAM Mount Service"
  3826. msgstr ""
  3827. #. type: menuentry
  3828. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3829. msgid "Service to mount volumes when logging in."
  3830. msgstr ""
  3831. #. type: subsection
  3832. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3833. #: guix-git/doc/guix.texi:31648 guix-git/doc/guix.texi:31649
  3834. #, no-wrap
  3835. msgid "Guix Services"
  3836. msgstr ""
  3837. #. type: menuentry
  3838. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3839. msgid "Services relating specifically to Guix."
  3840. msgstr ""
  3841. #. type: subsection
  3842. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3843. #: guix-git/doc/guix.texi:31932 guix-git/doc/guix.texi:31933
  3844. #, no-wrap
  3845. msgid "Linux Services"
  3846. msgstr ""
  3847. #. type: menuentry
  3848. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3849. msgid "Services tied to the Linux kernel."
  3850. msgstr ""
  3851. #. type: subsection
  3852. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3853. #: guix-git/doc/guix.texi:32159 guix-git/doc/guix.texi:32160
  3854. #, no-wrap
  3855. msgid "Hurd Services"
  3856. msgstr ""
  3857. #. type: menuentry
  3858. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3859. msgid "Services specific for a Hurd System."
  3860. msgstr ""
  3861. #. type: subsection
  3862. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3863. #: guix-git/doc/guix.texi:32201 guix-git/doc/guix.texi:32202
  3864. #, no-wrap
  3865. msgid "Miscellaneous Services"
  3866. msgstr ""
  3867. #. type: menuentry
  3868. #: guix-git/doc/guix.texi:365 guix-git/doc/guix.texi:15026
  3869. msgid "Other services."
  3870. msgstr ""
  3871. #. type: subsection
  3872. #: guix-git/doc/guix.texi:372 guix-git/doc/guix.texi:34369
  3873. #: guix-git/doc/guix.texi:34371 guix-git/doc/guix.texi:34372
  3874. #, no-wrap
  3875. msgid "Service Composition"
  3876. msgstr ""
  3877. #. type: menuentry
  3878. #: guix-git/doc/guix.texi:372 guix-git/doc/guix.texi:34369
  3879. msgid "The model for composing services."
  3880. msgstr ""
  3881. #. type: subsection
  3882. #: guix-git/doc/guix.texi:372 guix-git/doc/guix.texi:34369
  3883. #: guix-git/doc/guix.texi:34427 guix-git/doc/guix.texi:34428
  3884. #, no-wrap
  3885. msgid "Service Types and Services"
  3886. msgstr ""
  3887. #. type: menuentry
  3888. #: guix-git/doc/guix.texi:372 guix-git/doc/guix.texi:34369
  3889. msgid "Types and services."
  3890. msgstr ""
  3891. #. type: subsection
  3892. #: guix-git/doc/guix.texi:372 guix-git/doc/guix.texi:34369
  3893. #: guix-git/doc/guix.texi:34564 guix-git/doc/guix.texi:34565
  3894. #, no-wrap
  3895. msgid "Service Reference"
  3896. msgstr ""
  3897. #. type: menuentry
  3898. #: guix-git/doc/guix.texi:372 guix-git/doc/guix.texi:34369
  3899. msgid "API reference."
  3900. msgstr ""
  3901. #. type: subsection
  3902. #: guix-git/doc/guix.texi:372 guix-git/doc/guix.texi:34369
  3903. #: guix-git/doc/guix.texi:34874 guix-git/doc/guix.texi:34875
  3904. #, no-wrap
  3905. msgid "Shepherd Services"
  3906. msgstr ""
  3907. #. type: menuentry
  3908. #: guix-git/doc/guix.texi:372 guix-git/doc/guix.texi:34369
  3909. msgid "A particular type of service."
  3910. msgstr ""
  3911. #. type: section
  3912. #: guix-git/doc/guix.texi:377 guix-git/doc/guix.texi:35175
  3913. #: guix-git/doc/guix.texi:35177 guix-git/doc/guix.texi:35178
  3914. #, no-wrap
  3915. msgid "Separate Debug Info"
  3916. msgstr ""
  3917. #. type: menuentry
  3918. #: guix-git/doc/guix.texi:377 guix-git/doc/guix.texi:35175
  3919. msgid "Installing 'debug' outputs."
  3920. msgstr ""
  3921. #. type: section
  3922. #: guix-git/doc/guix.texi:377 guix-git/doc/guix.texi:35175
  3923. #: guix-git/doc/guix.texi:35236 guix-git/doc/guix.texi:35237
  3924. #, no-wrap
  3925. msgid "Rebuilding Debug Info"
  3926. msgstr ""
  3927. #. type: menuentry
  3928. #: guix-git/doc/guix.texi:377 guix-git/doc/guix.texi:35175
  3929. msgid "Building missing debug info."
  3930. msgstr ""
  3931. #. type: node
  3932. #: guix-git/doc/guix.texi:382 guix-git/doc/guix.texi:35453
  3933. #: guix-git/doc/guix.texi:35455
  3934. #, no-wrap
  3935. msgid "Reduced Binary Seed Bootstrap"
  3936. msgstr ""
  3937. #. type: menuentry
  3938. #: guix-git/doc/guix.texi:382 guix-git/doc/guix.texi:35453
  3939. msgid "A Bootstrap worthy of GNU."
  3940. msgstr ""
  3941. #. type: section
  3942. #: guix-git/doc/guix.texi:382 guix-git/doc/guix.texi:35453
  3943. #: guix-git/doc/guix.texi:35530 guix-git/doc/guix.texi:35531
  3944. #, no-wrap
  3945. msgid "Preparing to Use the Bootstrap Binaries"
  3946. msgstr ""
  3947. #. type: menuentry
  3948. #: guix-git/doc/guix.texi:382 guix-git/doc/guix.texi:35453
  3949. msgid "Building that what matters most."
  3950. msgstr ""
  3951. #. type: cindex
  3952. #: guix-git/doc/guix.texi:390
  3953. #, no-wrap
  3954. msgid "purpose"
  3955. msgstr "scopo"
  3956. #. type: Plain text
  3957. #: guix-git/doc/guix.texi:398
  3958. msgid "GNU Guix@footnote{``Guix'' is pronounced like ``geeks'', or ``ɡiːks'' using the international phonetic alphabet (IPA).} is a package management tool for and distribution of the GNU system. Guix makes it easy for unprivileged users to install, upgrade, or remove software packages, to roll back to a previous package set, to build packages from source, and generally assists with the creation and maintenance of software environments."
  3959. msgstr ""
  3960. #. type: cindex
  3961. #: guix-git/doc/guix.texi:399 guix-git/doc/guix.texi:474
  3962. #, no-wrap
  3963. msgid "Guix System"
  3964. msgstr ""
  3965. #. type: cindex
  3966. #: guix-git/doc/guix.texi:400
  3967. #, no-wrap
  3968. msgid "GuixSD, now Guix System"
  3969. msgstr ""
  3970. #. type: cindex
  3971. #: guix-git/doc/guix.texi:401
  3972. #, no-wrap
  3973. msgid "Guix System Distribution, now Guix System"
  3974. msgstr ""
  3975. #. type: Plain text
  3976. #: guix-git/doc/guix.texi:410
  3977. msgid "You can install GNU@tie{}Guix on top of an existing GNU/Linux system where it complements the available tools without interference (@pxref{Installation}), or you can use it as a standalone operating system distribution, @dfn{Guix@tie{}System}@footnote{We used to refer to Guix System as ``Guix System Distribution'' or ``GuixSD''. We now consider it makes more sense to group everything under the ``Guix'' banner since, after all, Guix System is readily available through the @command{guix system} command, even if you're using a different distro underneath!}. @xref{GNU Distribution}."
  3978. msgstr ""
  3979. #. type: cindex
  3980. #: guix-git/doc/guix.texi:419
  3981. #, no-wrap
  3982. msgid "user interfaces"
  3983. msgstr ""
  3984. #. type: Plain text
  3985. #: guix-git/doc/guix.texi:425
  3986. msgid "Guix provides a command-line package management interface (@pxref{Package Management}), tools to help with software development (@pxref{Development}), command-line utilities for more advanced usage (@pxref{Utilities}), as well as Scheme programming interfaces (@pxref{Programming Interface})."
  3987. msgstr ""
  3988. #. type: cindex
  3989. #: guix-git/doc/guix.texi:425
  3990. #, no-wrap
  3991. msgid "build daemon"
  3992. msgstr ""
  3993. #. type: Plain text
  3994. #: guix-git/doc/guix.texi:429
  3995. msgid "Its @dfn{build daemon} is responsible for building packages on behalf of users (@pxref{Setting Up the Daemon}) and for downloading pre-built binaries from authorized sources (@pxref{Substitutes})."
  3996. msgstr ""
  3997. #. type: cindex
  3998. #: guix-git/doc/guix.texi:430
  3999. #, no-wrap
  4000. msgid "extensibility of the distribution"
  4001. msgstr ""
  4002. #. type: cindex
  4003. #: guix-git/doc/guix.texi:431 guix-git/doc/guix.texi:6442
  4004. #, no-wrap
  4005. msgid "customization, of packages"
  4006. msgstr ""
  4007. #. type: Plain text
  4008. #: guix-git/doc/guix.texi:440
  4009. msgid "Guix includes package definitions for many GNU and non-GNU packages, all of which @uref{https://www.gnu.org/philosophy/free-sw.html, respect the user's computing freedom}. It is @emph{extensible}: users can write their own package definitions (@pxref{Defining Packages}) and make them available as independent package modules (@pxref{Package Modules}). It is also @emph{customizable}: users can @emph{derive} specialized package definitions from existing ones, including from the command line (@pxref{Package Transformation Options})."
  4010. msgstr ""
  4011. #. type: cindex
  4012. #: guix-git/doc/guix.texi:441
  4013. #, no-wrap
  4014. msgid "functional package management"
  4015. msgstr ""
  4016. #. type: cindex
  4017. #: guix-git/doc/guix.texi:442
  4018. #, no-wrap
  4019. msgid "isolation"
  4020. msgstr ""
  4021. #. type: Plain text
  4022. #: guix-git/doc/guix.texi:457
  4023. msgid "Under the hood, Guix implements the @dfn{functional package management} discipline pioneered by Nix (@pxref{Acknowledgments}). In Guix, the package build and installation process is seen as a @emph{function}, in the mathematical sense. That function takes inputs, such as build scripts, a compiler, and libraries, and returns an installed package. As a pure function, its result depends solely on its inputs---for instance, it cannot refer to software or scripts that were not explicitly passed as inputs. A build function always produces the same result when passed a given set of inputs. It cannot alter the environment of the running system in any way; for instance, it cannot create, modify, or delete files outside of its build and installation directories. This is achieved by running build processes in isolated environments (or @dfn{containers}), where only their explicit inputs are visible."
  4024. msgstr ""
  4025. #. type: cindex
  4026. #: guix-git/doc/guix.texi:458 guix-git/doc/guix.texi:8797
  4027. #, no-wrap
  4028. msgid "store"
  4029. msgstr ""
  4030. #. type: Plain text
  4031. #: guix-git/doc/guix.texi:465
  4032. msgid "The result of package build functions is @dfn{cached} in the file system, in a special directory called @dfn{the store} (@pxref{The Store}). Each package is installed in a directory of its own in the store---by default under @file{/gnu/store}. The directory name contains a hash of all the inputs used to build that package; thus, changing an input yields a different directory name."
  4033. msgstr ""
  4034. #. type: Plain text
  4035. #: guix-git/doc/guix.texi:469
  4036. msgid "This approach is the foundation for the salient features of Guix: support for transactional package upgrade and rollback, per-user installation, and garbage collection of packages (@pxref{Features})."
  4037. msgstr ""
  4038. #. type: Plain text
  4039. #: guix-git/doc/guix.texi:484
  4040. msgid "Guix comes with a distribution of the GNU system consisting entirely of free software@footnote{The term ``free'' here refers to the @url{https://www.gnu.org/philosophy/free-sw.html,freedom provided to users of that software}.}. The distribution can be installed on its own (@pxref{System Installation}), but it is also possible to install Guix as a package manager on top of an installed GNU/Linux system (@pxref{Installation}). When we need to distinguish between the two, we refer to the standalone distribution as Guix@tie{}System."
  4041. msgstr ""
  4042. #. type: Plain text
  4043. #: guix-git/doc/guix.texi:490
  4044. msgid "The distribution provides core GNU packages such as GNU libc, GCC, and Binutils, as well as many GNU and non-GNU applications. The complete list of available packages can be browsed @url{https://www.gnu.org/software/guix/packages,on-line} or by running @command{guix package} (@pxref{Invoking guix package}):"
  4045. msgstr ""
  4046. #. type: example
  4047. #: guix-git/doc/guix.texi:493
  4048. #, no-wrap
  4049. msgid "guix package --list-available\n"
  4050. msgstr ""
  4051. #. type: Plain text
  4052. #: guix-git/doc/guix.texi:499
  4053. msgid "Our goal is to provide a practical 100% free software distribution of Linux-based and other variants of GNU, with a focus on the promotion and tight integration of GNU components, and an emphasis on programs and tools that help users exert that freedom."
  4054. msgstr ""
  4055. #. type: Plain text
  4056. #: guix-git/doc/guix.texi:501
  4057. msgid "Packages are currently available on the following platforms:"
  4058. msgstr ""
  4059. #. type: item
  4060. #: guix-git/doc/guix.texi:504 guix-git/doc/guix.texi:2121
  4061. #, no-wrap
  4062. msgid "x86_64-linux"
  4063. msgstr ""
  4064. #. type: table
  4065. #: guix-git/doc/guix.texi:506
  4066. msgid "Intel/AMD @code{x86_64} architecture, Linux-Libre kernel."
  4067. msgstr ""
  4068. #. type: item
  4069. #: guix-git/doc/guix.texi:507 guix-git/doc/guix.texi:2124
  4070. #, no-wrap
  4071. msgid "i686-linux"
  4072. msgstr ""
  4073. #. type: table
  4074. #: guix-git/doc/guix.texi:509
  4075. msgid "Intel 32-bit architecture (IA32), Linux-Libre kernel."
  4076. msgstr ""
  4077. #. type: item
  4078. #: guix-git/doc/guix.texi:510
  4079. #, no-wrap
  4080. msgid "armhf-linux"
  4081. msgstr ""
  4082. #. type: table
  4083. #: guix-git/doc/guix.texi:514
  4084. msgid "ARMv7-A architecture with hard float, Thumb-2 and NEON, using the EABI hard-float application binary interface (ABI), and Linux-Libre kernel."
  4085. msgstr ""
  4086. #. type: item
  4087. #: guix-git/doc/guix.texi:515
  4088. #, no-wrap
  4089. msgid "aarch64-linux"
  4090. msgstr ""
  4091. #. type: table
  4092. #: guix-git/doc/guix.texi:517
  4093. msgid "little-endian 64-bit ARMv8-A processors, Linux-Libre kernel."
  4094. msgstr ""
  4095. #. type: item
  4096. #: guix-git/doc/guix.texi:518
  4097. #, no-wrap
  4098. msgid "i586-gnu"
  4099. msgstr ""
  4100. #. type: table
  4101. #: guix-git/doc/guix.texi:521
  4102. msgid "@uref{https://hurd.gnu.org, GNU/Hurd} on the Intel 32-bit architecture (IA32)."
  4103. msgstr ""
  4104. #. type: table
  4105. #: guix-git/doc/guix.texi:527
  4106. msgid "This configuration is experimental and under development. The easiest way for you to give it a try is by setting up an instance of @code{hurd-vm-service-type} on your GNU/Linux machine (@pxref{transparent-emulation-qemu, @code{hurd-vm-service-type}}). @xref{Contributing}, on how to help!"
  4107. msgstr ""
  4108. #. type: item
  4109. #: guix-git/doc/guix.texi:528
  4110. #, no-wrap
  4111. msgid "mips64el-linux (deprecated)"
  4112. msgstr ""
  4113. #. type: table
  4114. #: guix-git/doc/guix.texi:534
  4115. msgid "little-endian 64-bit MIPS processors, specifically the Loongson series, n32 ABI, and Linux-Libre kernel. This configuration is no longer fully supported; in particular, there is no ongoing work to ensure that this architecture still works. Should someone decide they wish to revive this architecture then the code is still available."
  4116. msgstr ""
  4117. #. type: table
  4118. #: guix-git/doc/guix.texi:545
  4119. msgid "little-endian 64-bit Power ISA processors, Linux-Libre kernel. This includes POWER9 systems such as the @uref{https://www.fsf.org/news/talos-ii-mainboard-and-talos-ii-lite-mainboard-now-fsf-certified-to-respect-your-freedom, RYF Talos II mainboard}. This platform is available as a \"technology preview\": although it is supported, substitutes are not yet available from the build farm (@pxref{Substitutes}), and some packages may fail to build (@pxref{Tracking Bugs and Patches}). That said, the Guix community is actively working on improving this support, and now is a great time to try it and get involved!"
  4120. msgstr ""
  4121. #. type: Plain text
  4122. #: guix-git/doc/guix.texi:555
  4123. msgid "With Guix@tie{}System, you @emph{declare} all aspects of the operating system configuration and Guix takes care of instantiating the configuration in a transactional, reproducible, and stateless fashion (@pxref{System Configuration}). Guix System uses the Linux-libre kernel, the Shepherd initialization system (@pxref{Introduction,,, shepherd, The GNU Shepherd Manual}), the well-known GNU utilities and tool chain, as well as the graphical environment or system services of your choice."
  4124. msgstr ""
  4125. #. type: Plain text
  4126. #: guix-git/doc/guix.texi:558
  4127. msgid "Guix System is available on all the above platforms except @code{mips64el-linux} and @code{powerpc64le-linux}."
  4128. msgstr ""
  4129. #. type: Plain text
  4130. #: guix-git/doc/guix.texi:562
  4131. msgid "For information on porting to other architectures or kernels, @pxref{Porting}."
  4132. msgstr ""
  4133. #. type: Plain text
  4134. #: guix-git/doc/guix.texi:565
  4135. msgid "Building this distribution is a cooperative effort, and you are invited to join! @xref{Contributing}, for information about how you can help."
  4136. msgstr ""
  4137. #. type: cindex
  4138. #: guix-git/doc/guix.texi:571
  4139. #, no-wrap
  4140. msgid "installing Guix"
  4141. msgstr ""
  4142. #. type: quotation
  4143. #: guix-git/doc/guix.texi:583
  4144. msgid "We recommend the use of this @uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh, shell installer script} to install Guix on top of a running GNU/Linux system, thereafter called a @dfn{foreign distro}.@footnote{This section is concerned with the installation of the package manager, which can be done on top of a running GNU/Linux system. If, instead, you want to install the complete GNU operating system, @pxref{System Installation}.} The script automates the download, installation, and initial configuration of Guix. It should be run as the root user."
  4145. msgstr ""
  4146. #. type: cindex
  4147. #: guix-git/doc/guix.texi:585 guix-git/doc/guix.texi:1796
  4148. #, no-wrap
  4149. msgid "foreign distro"
  4150. msgstr ""
  4151. #. type: cindex
  4152. #: guix-git/doc/guix.texi:586
  4153. #, no-wrap
  4154. msgid "directories related to foreign distro"
  4155. msgstr ""
  4156. #. type: Plain text
  4157. #: guix-git/doc/guix.texi:591
  4158. msgid "When installed on a foreign distro, GNU@tie{}Guix complements the available tools without interference. Its data lives exclusively in two directories, usually @file{/gnu/store} and @file{/var/guix}; other files on your system, such as @file{/etc}, are left untouched."
  4159. msgstr ""
  4160. #. type: Plain text
  4161. #: guix-git/doc/guix.texi:594
  4162. msgid "Once installed, Guix can be updated by running @command{guix pull} (@pxref{Invoking guix pull})."
  4163. msgstr ""
  4164. #. type: Plain text
  4165. #: guix-git/doc/guix.texi:599
  4166. msgid "If you prefer to perform the installation steps manually or want to tweak them, you may find the following subsections useful. They describe the software requirements of Guix, as well as how to install it manually and get ready to use it."
  4167. msgstr ""
  4168. #. type: cindex
  4169. #: guix-git/doc/guix.texi:613
  4170. #, no-wrap
  4171. msgid "installing Guix from binaries"
  4172. msgstr ""
  4173. #. type: cindex
  4174. #: guix-git/doc/guix.texi:614
  4175. #, no-wrap
  4176. msgid "installer script"
  4177. msgstr ""
  4178. #. type: Plain text
  4179. #: guix-git/doc/guix.texi:620
  4180. msgid "This section describes how to install Guix on an arbitrary system from a self-contained tarball providing binaries for Guix and for all its dependencies. This is often quicker than installing from source, which is described in the next sections. The only requirement is to have GNU@tie{}tar and Xz."
  4181. msgstr ""
  4182. #. type: quotation
  4183. #: guix-git/doc/guix.texi:628
  4184. msgid "We recommend the use of this @uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh, shell installer script}. The script automates the download, installation, and initial configuration steps described below. It should be run as the root user. As root, you can thus run this:"
  4185. msgstr ""
  4186. #. type: example
  4187. #: guix-git/doc/guix.texi:634
  4188. #, no-wrap
  4189. msgid ""
  4190. "cd /tmp\n"
  4191. "wget https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh\n"
  4192. "chmod +x guix-install.sh\n"
  4193. "./guix-install.sh\n"
  4194. msgstr ""
  4195. #. type: quotation
  4196. #: guix-git/doc/guix.texi:638
  4197. msgid "When you're done, @pxref{Application Setup} for extra configuration you might need, and @ref{Getting Started} for your first steps!"
  4198. msgstr ""
  4199. #. type: Plain text
  4200. #: guix-git/doc/guix.texi:641
  4201. msgid "Installing goes along these lines:"
  4202. msgstr ""
  4203. #. type: cindex
  4204. #: guix-git/doc/guix.texi:644
  4205. #, no-wrap
  4206. msgid "downloading Guix binary"
  4207. msgstr ""
  4208. #. type: enumerate
  4209. #: guix-git/doc/guix.texi:650
  4210. msgid "Download the binary tarball from @indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.x86_64-linux.tar.xz}, where @code{x86_64-linux} can be replaced with @code{i686-linux} for an @code{i686} (32-bits) machine already running the kernel Linux, and so on (@pxref{GNU Distribution})."
  4211. msgstr ""
  4212. #. type: enumerate
  4213. #: guix-git/doc/guix.texi:654
  4214. msgid "Make sure to download the associated @file{.sig} file and to verify the authenticity of the tarball against it, along these lines:"
  4215. msgstr ""
  4216. #. type: example
  4217. #: guix-git/doc/guix.texi:658
  4218. #, no-wrap
  4219. msgid ""
  4220. "$ wget @value{BASE-URL}/guix-binary-@value{VERSION}.x86_64-linux.tar.xz.sig\n"
  4221. "$ gpg --verify guix-binary-@value{VERSION}.x86_64-linux.tar.xz.sig\n"
  4222. msgstr ""
  4223. #. type: Plain text
  4224. #: guix-git/doc/guix.texi:662 guix-git/doc/guix.texi:2139
  4225. msgid "If that command fails because you do not have the required public key, then run this command to import it:"
  4226. msgstr ""
  4227. #. type: example
  4228. #: guix-git/doc/guix.texi:666
  4229. #, no-wrap
  4230. msgid ""
  4231. "$ wget '@value{OPENPGP-SIGNING-KEY-URL}' \\\n"
  4232. " -qO - | gpg --import -\n"
  4233. msgstr ""
  4234. #. type: Plain text
  4235. #: guix-git/doc/guix.texi:670 guix-git/doc/guix.texi:2147
  4236. msgid "and rerun the @code{gpg --verify} command."
  4237. msgstr ""
  4238. #. type: Plain text
  4239. #: guix-git/doc/guix.texi:673 guix-git/doc/guix.texi:2150
  4240. msgid "Take note that a warning like ``This key is not certified with a trusted signature!'' is normal."
  4241. msgstr ""
  4242. #. type: enumerate
  4243. #: guix-git/doc/guix.texi:679
  4244. msgid "Now, you need to become the @code{root} user. Depending on your distribution, you may have to run @code{su -} or @code{sudo -i}. As @code{root}, run:"
  4245. msgstr ""
  4246. #. type: example
  4247. #: guix-git/doc/guix.texi:685
  4248. #, no-wrap
  4249. msgid ""
  4250. "# cd /tmp\n"
  4251. "# tar --warning=no-timestamp -xf \\\n"
  4252. " /path/to/guix-binary-@value{VERSION}.x86_64-linux.tar.xz\n"
  4253. "# mv var/guix /var/ && mv gnu /\n"
  4254. msgstr ""
  4255. #. type: enumerate
  4256. #: guix-git/doc/guix.texi:690
  4257. msgid "This creates @file{/gnu/store} (@pxref{The Store}) and @file{/var/guix}. The latter contains a ready-to-use profile for @code{root} (see next step)."
  4258. msgstr ""
  4259. #. type: enumerate
  4260. #: guix-git/doc/guix.texi:693
  4261. msgid "Do @emph{not} unpack the tarball on a working Guix system since that would overwrite its own essential files."
  4262. msgstr ""
  4263. #. type: enumerate
  4264. #: guix-git/doc/guix.texi:703
  4265. msgid "The @option{--warning=no-timestamp} option makes sure GNU@tie{}tar does not emit warnings about ``implausibly old time stamps'' (such warnings were triggered by GNU@tie{}tar 1.26 and older; recent versions are fine). They stem from the fact that all the files in the archive have their modification time set to 1 (which means January 1st, 1970). This is done on purpose to make sure the archive content is independent of its creation time, thus making it reproducible."
  4266. msgstr ""
  4267. #. type: enumerate
  4268. #: guix-git/doc/guix.texi:707
  4269. msgid "Make the profile available under @file{~root/.config/guix/current}, which is where @command{guix pull} will install updates (@pxref{Invoking guix pull}):"
  4270. msgstr ""
  4271. #. type: example
  4272. #: guix-git/doc/guix.texi:712
  4273. #, no-wrap
  4274. msgid ""
  4275. "# mkdir -p ~root/.config/guix\n"
  4276. "# ln -sf /var/guix/profiles/per-user/root/current-guix \\\n"
  4277. " ~root/.config/guix/current\n"
  4278. msgstr ""
  4279. #. type: enumerate
  4280. #: guix-git/doc/guix.texi:716
  4281. msgid "Source @file{etc/profile} to augment @env{PATH} and other relevant environment variables:"
  4282. msgstr ""
  4283. #. type: example
  4284. #: guix-git/doc/guix.texi:720
  4285. #, no-wrap
  4286. msgid ""
  4287. "# GUIX_PROFILE=\"`echo ~root`/.config/guix/current\" ; \\\n"
  4288. " source $GUIX_PROFILE/etc/profile\n"
  4289. msgstr ""
  4290. #. type: enumerate
  4291. #: guix-git/doc/guix.texi:725
  4292. msgid "Create the group and user accounts for build users as explained below (@pxref{Build Environment Setup})."
  4293. msgstr ""
  4294. #. type: enumerate
  4295. #: guix-git/doc/guix.texi:728
  4296. msgid "Run the daemon, and set it to automatically start on boot."
  4297. msgstr ""
  4298. #. type: enumerate
  4299. #: guix-git/doc/guix.texi:731
  4300. msgid "If your host distro uses the systemd init system, this can be achieved with these commands:"
  4301. msgstr ""
  4302. #. type: example
  4303. #: guix-git/doc/guix.texi:744
  4304. #, no-wrap
  4305. msgid ""
  4306. "# cp ~root/.config/guix/current/lib/systemd/system/gnu-store.mount \\\n"
  4307. " ~root/.config/guix/current/lib/systemd/system/guix-daemon.service \\\n"
  4308. " /etc/systemd/system/\n"
  4309. "# systemctl enable --now gnu-store.mount guix-daemon\n"
  4310. msgstr ""
  4311. #. type: itemize
  4312. #: guix-git/doc/guix.texi:747 guix-git/doc/guix.texi:12924
  4313. msgid "If your host distro uses the Upstart init system:"
  4314. msgstr ""
  4315. #. type: example
  4316. #: guix-git/doc/guix.texi:753
  4317. #, no-wrap
  4318. msgid ""
  4319. "# initctl reload-configuration\n"
  4320. "# cp ~root/.config/guix/current/lib/upstart/system/guix-daemon.conf \\\n"
  4321. " /etc/init/\n"
  4322. "# start guix-daemon\n"
  4323. msgstr ""
  4324. #. type: enumerate
  4325. #: guix-git/doc/guix.texi:756
  4326. msgid "Otherwise, you can still start the daemon manually with:"
  4327. msgstr ""
  4328. #. type: example
  4329. #: guix-git/doc/guix.texi:760
  4330. #, no-wrap
  4331. msgid ""
  4332. "# ~root/.config/guix/current/bin/guix-daemon \\\n"
  4333. " --build-users-group=guixbuild\n"
  4334. msgstr ""
  4335. #. type: enumerate
  4336. #: guix-git/doc/guix.texi:765
  4337. msgid "Make the @command{guix} command available to other users on the machine, for instance with:"
  4338. msgstr ""
  4339. #. type: example
  4340. #: guix-git/doc/guix.texi:770
  4341. #, no-wrap
  4342. msgid ""
  4343. "# mkdir -p /usr/local/bin\n"
  4344. "# cd /usr/local/bin\n"
  4345. "# ln -s /var/guix/profiles/per-user/root/current-guix/bin/guix\n"
  4346. msgstr ""
  4347. #. type: enumerate
  4348. #: guix-git/doc/guix.texi:774
  4349. msgid "It is also a good idea to make the Info version of this manual available there:"
  4350. msgstr ""
  4351. #. type: example
  4352. #: guix-git/doc/guix.texi:780
  4353. #, no-wrap
  4354. msgid ""
  4355. "# mkdir -p /usr/local/share/info\n"
  4356. "# cd /usr/local/share/info\n"
  4357. "# for i in /var/guix/profiles/per-user/root/current-guix/share/info/* ;\n"
  4358. " do ln -s $i ; done\n"
  4359. msgstr ""
  4360. #. type: enumerate
  4361. #: guix-git/doc/guix.texi:786
  4362. msgid "That way, assuming @file{/usr/local/share/info} is in the search path, running @command{info guix} will open this manual (@pxref{Other Info Directories,,, texinfo, GNU Texinfo}, for more details on changing the Info search path)."
  4363. msgstr ""
  4364. #. type: cindex
  4365. #: guix-git/doc/guix.texi:788 guix-git/doc/guix.texi:3740
  4366. #: guix-git/doc/guix.texi:15569
  4367. #, no-wrap
  4368. msgid "substitutes, authorization thereof"
  4369. msgstr ""
  4370. #. type: enumerate
  4371. #: guix-git/doc/guix.texi:792
  4372. msgid "To use substitutes from @code{@value{SUBSTITUTE-SERVER-1}}, @code{@value{SUBSTITUTE-SERVER-2}} or a mirror (@pxref{Substitutes}), authorize them:"
  4373. msgstr ""
  4374. #. type: example
  4375. #: guix-git/doc/guix.texi:798
  4376. #, no-wrap
  4377. msgid ""
  4378. "# guix archive --authorize < \\\n"
  4379. " ~root/.config/guix/current/share/guix/@value{SUBSTITUTE-SERVER-1}.pub\n"
  4380. "# guix archive --authorize < \\\n"
  4381. " ~root/.config/guix/current/share/guix/@value{SUBSTITUTE-SERVER-2}.pub\n"
  4382. msgstr ""
  4383. #. type: quotation
  4384. #: guix-git/doc/guix.texi:805
  4385. msgid "If you do not enable substitutes, Guix will end up building @emph{everything} from source on your machine, making each installation and upgrade very expensive. @xref{On Trusting Binaries}, for a discussion of reasons why one might want do disable substitutes."
  4386. msgstr ""
  4387. #. type: enumerate
  4388. #: guix-git/doc/guix.texi:810
  4389. msgid "Each user may need to perform a few additional steps to make their Guix environment ready for use, @pxref{Application Setup}."
  4390. msgstr ""
  4391. #. type: Plain text
  4392. #: guix-git/doc/guix.texi:813
  4393. msgid "Voilà, the installation is complete!"
  4394. msgstr ""
  4395. #. type: Plain text
  4396. #: guix-git/doc/guix.texi:816
  4397. msgid "You can confirm that Guix is working by installing a sample package into the root profile:"
  4398. msgstr ""
  4399. #. type: example
  4400. #: guix-git/doc/guix.texi:819
  4401. #, no-wrap
  4402. msgid "# guix install hello\n"
  4403. msgstr ""
  4404. #. type: Plain text
  4405. #: guix-git/doc/guix.texi:823
  4406. msgid "The binary installation tarball can be (re)produced and verified simply by running the following command in the Guix source tree:"
  4407. msgstr ""
  4408. #. type: example
  4409. #: guix-git/doc/guix.texi:826
  4410. #, no-wrap
  4411. msgid "make guix-binary.@var{system}.tar.xz\n"
  4412. msgstr ""
  4413. #. type: Plain text
  4414. #: guix-git/doc/guix.texi:830
  4415. msgid "...@: which, in turn, runs:"
  4416. msgstr ""
  4417. #. type: example
  4418. #: guix-git/doc/guix.texi:834
  4419. #, no-wrap
  4420. msgid ""
  4421. "guix pack -s @var{system} --localstatedir \\\n"
  4422. " --profile-name=current-guix guix\n"
  4423. msgstr ""
  4424. #. type: Plain text
  4425. #: guix-git/doc/guix.texi:837
  4426. msgid "@xref{Invoking guix pack}, for more info on this handy tool."
  4427. msgstr ""
  4428. #. type: Plain text
  4429. #: guix-git/doc/guix.texi:845
  4430. msgid "This section lists requirements when building Guix from source. The build procedure for Guix is the same as for other GNU software, and is not covered here. Please see the files @file{README} and @file{INSTALL} in the Guix source tree for additional details."
  4431. msgstr ""
  4432. #. type: cindex
  4433. #: guix-git/doc/guix.texi:846
  4434. #, no-wrap
  4435. msgid "official website"
  4436. msgstr ""
  4437. #. type: Plain text
  4438. #: guix-git/doc/guix.texi:849
  4439. msgid "GNU Guix is available for download from its website at @url{https://www.gnu.org/software/guix/}."
  4440. msgstr ""
  4441. #. type: Plain text
  4442. #: guix-git/doc/guix.texi:851
  4443. msgid "GNU Guix depends on the following packages:"
  4444. msgstr ""
  4445. #. type: item
  4446. #: guix-git/doc/guix.texi:853
  4447. #, no-wrap
  4448. msgid "@url{https://gnu.org/software/guile/, GNU Guile}, version 3.0.x;"
  4449. msgstr ""
  4450. #. type: item
  4451. #: guix-git/doc/guix.texi:854
  4452. #, no-wrap
  4453. msgid "@url{https://notabug.org/cwebber/guile-gcrypt, Guile-Gcrypt}, version"
  4454. msgstr ""
  4455. #. type: itemize
  4456. #: guix-git/doc/guix.texi:856
  4457. msgid "0.1.0 or later;"
  4458. msgstr ""
  4459. #. type: itemize
  4460. #: guix-git/doc/guix.texi:860
  4461. msgid "@uref{https://gnutls.org/, GnuTLS}, specifically its Guile bindings (@pxref{Guile Preparations, how to install the GnuTLS bindings for Guile,, gnutls-guile, GnuTLS-Guile});"
  4462. msgstr ""
  4463. #. type: itemize
  4464. #: guix-git/doc/guix.texi:863
  4465. msgid "@uref{https://notabug.org/guile-sqlite3/guile-sqlite3, Guile-SQLite3}, version 0.1.0 or later;"
  4466. msgstr ""
  4467. #. type: item
  4468. #: guix-git/doc/guix.texi:863
  4469. #, no-wrap
  4470. msgid "@uref{https://notabug.org/guile-zlib/guile-zlib, Guile-zlib},"
  4471. msgstr ""
  4472. #. type: itemize
  4473. #: guix-git/doc/guix.texi:865
  4474. msgid "version 0.1.0 or later;"
  4475. msgstr ""
  4476. #. type: item
  4477. #: guix-git/doc/guix.texi:865
  4478. #, no-wrap
  4479. msgid "@uref{https://notabug.org/guile-lzlib/guile-lzlib, Guile-lzlib};"
  4480. msgstr ""
  4481. #. type: item
  4482. #: guix-git/doc/guix.texi:866
  4483. #, no-wrap
  4484. msgid "@uref{https://www.nongnu.org/guile-avahi/, Guile-Avahi};"
  4485. msgstr ""
  4486. #. type: itemize
  4487. #: guix-git/doc/guix.texi:870
  4488. msgid "@uref{https://gitlab.com/guile-git/guile-git, Guile-Git}, version 0.5.0 or later;"
  4489. msgstr ""
  4490. #. type: item
  4491. #: guix-git/doc/guix.texi:870
  4492. #, no-wrap
  4493. msgid "@uref{https://savannah.nongnu.org/projects/guile-json/, Guile-JSON}"
  4494. msgstr ""
  4495. #. type: itemize
  4496. #: guix-git/doc/guix.texi:872
  4497. msgid "4.3.0 or later;"
  4498. msgstr ""
  4499. #. type: item
  4500. #: guix-git/doc/guix.texi:872
  4501. #, no-wrap
  4502. msgid "@url{https://www.gnu.org/software/make/, GNU Make}."
  4503. msgstr ""
  4504. #. type: Plain text
  4505. #: guix-git/doc/guix.texi:876
  4506. msgid "The following dependencies are optional:"
  4507. msgstr ""
  4508. #. type: itemize
  4509. #: guix-git/doc/guix.texi:884
  4510. msgid "Support for build offloading (@pxref{Daemon Offload Setup}) and @command{guix copy} (@pxref{Invoking guix copy}) depends on @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH}, version 0.13.0 or later."
  4511. msgstr ""
  4512. #. type: itemize
  4513. #: guix-git/doc/guix.texi:889
  4514. msgid "@uref{https://notabug.org/guile-zstd/guile-zstd, Guile-zstd}, for zstd compression and decompression in @command{guix publish} and for substitutes (@pxref{Invoking guix publish})."
  4515. msgstr ""
  4516. #. type: itemize
  4517. #: guix-git/doc/guix.texi:893
  4518. msgid "@uref{https://ngyro.com/software/guile-semver.html, Guile-Semver} for the @code{crate} importer (@pxref{Invoking guix import})."
  4519. msgstr ""
  4520. #. type: itemize
  4521. #: guix-git/doc/guix.texi:898
  4522. msgid "@uref{https://www.nongnu.org/guile-lib/doc/ref/htmlprag/, Guile-Lib} for the @code{go} importer (@pxref{Invoking guix import}) and for some of the ``updaters'' (@pxref{Invoking guix refresh})."
  4523. msgstr ""
  4524. #. type: itemize
  4525. #: guix-git/doc/guix.texi:902
  4526. msgid "When @url{http://www.bzip.org, libbz2} is available, @command{guix-daemon} can use it to compress build logs."
  4527. msgstr ""
  4528. #. type: Plain text
  4529. #: guix-git/doc/guix.texi:906
  4530. msgid "Unless @option{--disable-daemon} was passed to @command{configure}, the following packages are also needed:"
  4531. msgstr ""
  4532. #. type: item
  4533. #: guix-git/doc/guix.texi:908
  4534. #, no-wrap
  4535. msgid "@url{https://gnupg.org/, GNU libgcrypt};"
  4536. msgstr ""
  4537. #. type: item
  4538. #: guix-git/doc/guix.texi:909
  4539. #, no-wrap
  4540. msgid "@url{https://sqlite.org, SQLite 3};"
  4541. msgstr ""
  4542. #. type: item
  4543. #: guix-git/doc/guix.texi:910
  4544. #, no-wrap
  4545. msgid "@url{https://gcc.gnu.org, GCC's g++}, with support for the"
  4546. msgstr ""
  4547. #. type: itemize
  4548. #: guix-git/doc/guix.texi:912
  4549. msgid "C++11 standard."
  4550. msgstr ""
  4551. #. type: cindex
  4552. #: guix-git/doc/guix.texi:914
  4553. #, no-wrap
  4554. msgid "state directory"
  4555. msgstr ""
  4556. #. type: Plain text
  4557. #: guix-git/doc/guix.texi:923
  4558. msgid "When configuring Guix on a system that already has a Guix installation, be sure to specify the same state directory as the existing installation using the @option{--localstatedir} option of the @command{configure} script (@pxref{Directory Variables, @code{localstatedir},, standards, GNU Coding Standards}). Usually, this @var{localstatedir} option is set to the value @file{/var}. The @command{configure} script protects against unintended misconfiguration of @var{localstatedir} so you do not inadvertently corrupt your store (@pxref{The Store})."
  4559. msgstr ""
  4560. #. type: cindex
  4561. #: guix-git/doc/guix.texi:927
  4562. #, no-wrap
  4563. msgid "test suite"
  4564. msgstr ""
  4565. #. type: Plain text
  4566. #: guix-git/doc/guix.texi:933
  4567. msgid "After a successful @command{configure} and @code{make} run, it is a good idea to run the test suite. It can help catch issues with the setup or environment, or bugs in Guix itself---and really, reporting test failures is a good way to help improve the software. To run the test suite, type:"
  4568. msgstr ""
  4569. #. type: example
  4570. #: guix-git/doc/guix.texi:936
  4571. #, no-wrap
  4572. msgid "make check\n"
  4573. msgstr ""
  4574. #. type: Plain text
  4575. #: guix-git/doc/guix.texi:943
  4576. msgid "Test cases can run in parallel: you can use the @code{-j} option of GNU@tie{}make to speed things up. The first run may take a few minutes on a recent machine; subsequent runs will be faster because the store that is created for test purposes will already have various things in cache."
  4577. msgstr ""
  4578. #. type: Plain text
  4579. #: guix-git/doc/guix.texi:946
  4580. msgid "It is also possible to run a subset of the tests by defining the @code{TESTS} makefile variable as in this example:"
  4581. msgstr ""
  4582. #. type: example
  4583. #: guix-git/doc/guix.texi:949
  4584. #, no-wrap
  4585. msgid "make check TESTS=\"tests/store.scm tests/cpio.scm\"\n"
  4586. msgstr ""
  4587. #. type: Plain text
  4588. #: guix-git/doc/guix.texi:954
  4589. msgid "By default, tests results are displayed at a file level. In order to see the details of every individual test cases, it is possible to define the @code{SCM_LOG_DRIVER_FLAGS} makefile variable as in this example:"
  4590. msgstr ""
  4591. #. type: example
  4592. #: guix-git/doc/guix.texi:957
  4593. #, no-wrap
  4594. msgid "make check TESTS=\"tests/base64.scm\" SCM_LOG_DRIVER_FLAGS=\"--brief=no\"\n"
  4595. msgstr ""
  4596. #. type: Plain text
  4597. #: guix-git/doc/guix.texi:965
  4598. msgid "The underlying SRFI 64 custom Automake test driver used for the 'check' test suite (located at @file{build-aux/test-driver.scm}) also allows selecting which test cases to run at a finer level, via its @option{--select} and @option{--exclude} options. Here's an example, to run all the test cases from the @file{tests/packages.scm} test file whose names start with ``transaction-upgrade-entry'':"
  4599. msgstr ""
  4600. #. type: example
  4601. #: guix-git/doc/guix.texi:969
  4602. #, no-wrap
  4603. msgid ""
  4604. "export SCM_LOG_DRIVER_FLAGS=\"--select=^transaction-upgrade-entry\"\n"
  4605. "make check TESTS=\"tests/packages.scm\"\n"
  4606. msgstr ""
  4607. #. type: Plain text
  4608. #: guix-git/doc/guix.texi:975
  4609. msgid "Those wishing to inspect the results of failed tests directly from the command line can add the @option{--errors-only=yes} option to the @code{SCM_LOG_DRIVER_FLAGS} makefile variable and set the @code{VERBOSE} Automake makefile variable, as in:"
  4610. msgstr ""
  4611. #. type: example
  4612. #: guix-git/doc/guix.texi:978
  4613. #, no-wrap
  4614. msgid "make check SCM_LOG_DRIVER_FLAGS=\"--brief=no --errors-only=yes\" VERBOSE=1\n"
  4615. msgstr ""
  4616. #. type: Plain text
  4617. #: guix-git/doc/guix.texi:983
  4618. msgid "The @option{--show-duration=yes} option can be used to print the duration of the individual test cases, when used in combination with @option{--brief=no}:"
  4619. msgstr ""
  4620. #. type: example
  4621. #: guix-git/doc/guix.texi:986
  4622. #, no-wrap
  4623. msgid "make check SCM_LOG_DRIVER_FLAGS=\"--brief=no --show-duration=yes\"\n"
  4624. msgstr ""
  4625. #. type: Plain text
  4626. #: guix-git/doc/guix.texi:990
  4627. msgid "@xref{Parallel Test Harness,,,automake,GNU Automake} for more information about the Automake Parallel Test Harness."
  4628. msgstr ""
  4629. #. type: Plain text
  4630. #: guix-git/doc/guix.texi:995
  4631. msgid "Upon failure, please email @email{bug-guix@@gnu.org} and attach the @file{test-suite.log} file. Please specify the Guix version being used as well as version numbers of the dependencies (@pxref{Requirements}) in your message."
  4632. msgstr ""
  4633. #. type: Plain text
  4634. #: guix-git/doc/guix.texi:999
  4635. msgid "Guix also comes with a whole-system test suite that tests complete Guix System instances. It can only run on systems where Guix is already installed, using:"
  4636. msgstr ""
  4637. #. type: example
  4638. #: guix-git/doc/guix.texi:1002
  4639. #, no-wrap
  4640. msgid "make check-system\n"
  4641. msgstr ""
  4642. #. type: Plain text
  4643. #: guix-git/doc/guix.texi:1006
  4644. msgid "or, again, by defining @code{TESTS} to select a subset of tests to run:"
  4645. msgstr ""
  4646. #. type: example
  4647. #: guix-git/doc/guix.texi:1009
  4648. #, no-wrap
  4649. msgid "make check-system TESTS=\"basic mcron\"\n"
  4650. msgstr ""
  4651. #. type: Plain text
  4652. #: guix-git/doc/guix.texi:1017
  4653. msgid "These system tests are defined in the @code{(gnu tests @dots{})} modules. They work by running the operating systems under test with lightweight instrumentation in a virtual machine (VM). They can be computationally intensive or rather cheap, depending on whether substitutes are available for their dependencies (@pxref{Substitutes}). Some of them require a lot of storage space to hold VM images."
  4654. msgstr ""
  4655. #. type: Plain text
  4656. #: guix-git/doc/guix.texi:1020
  4657. msgid "Again in case of test failures, please send @email{bug-guix@@gnu.org} all the details."
  4658. msgstr ""
  4659. #. type: cindex
  4660. #: guix-git/doc/guix.texi:1024
  4661. #, no-wrap
  4662. msgid "daemon"
  4663. msgstr ""
  4664. #. type: Plain text
  4665. #: guix-git/doc/guix.texi:1032
  4666. msgid "Operations such as building a package or running the garbage collector are all performed by a specialized process, the @dfn{build daemon}, on behalf of clients. Only the daemon may access the store and its associated database. Thus, any operation that manipulates the store goes through the daemon. For instance, command-line tools such as @command{guix package} and @command{guix build} communicate with the daemon (@i{via} remote procedure calls) to instruct it what to do."
  4667. msgstr ""
  4668. #. type: Plain text
  4669. #: guix-git/doc/guix.texi:1036
  4670. msgid "The following sections explain how to prepare the build daemon's environment. See also @ref{Substitutes}, for information on how to allow the daemon to download pre-built binaries."
  4671. msgstr ""
  4672. #. type: cindex
  4673. #: guix-git/doc/guix.texi:1046 guix-git/doc/guix.texi:1508
  4674. #, no-wrap
  4675. msgid "build environment"
  4676. msgstr ""
  4677. #. type: Plain text
  4678. #: guix-git/doc/guix.texi:1054
  4679. msgid "In a standard multi-user setup, Guix and its daemon---the @command{guix-daemon} program---are installed by the system administrator; @file{/gnu/store} is owned by @code{root} and @command{guix-daemon} runs as @code{root}. Unprivileged users may use Guix tools to build packages or otherwise access the store, and the daemon will do it on their behalf, ensuring that the store is kept in a consistent state, and allowing built packages to be shared among users."
  4680. msgstr ""
  4681. #. type: cindex
  4682. #: guix-git/doc/guix.texi:1055
  4683. #, no-wrap
  4684. msgid "build users"
  4685. msgstr ""
  4686. #. type: Plain text
  4687. #: guix-git/doc/guix.texi:1066
  4688. msgid "When @command{guix-daemon} runs as @code{root}, you may not want package build processes themselves to run as @code{root} too, for obvious security reasons. To avoid that, a special pool of @dfn{build users} should be created for use by build processes started by the daemon. These build users need not have a shell and a home directory: they will just be used when the daemon drops @code{root} privileges in build processes. Having several such users allows the daemon to launch distinct build processes under separate UIDs, which guarantees that they do not interfere with each other---an essential feature since builds are regarded as pure functions (@pxref{Introduction})."
  4689. msgstr ""
  4690. #. type: Plain text
  4691. #: guix-git/doc/guix.texi:1069
  4692. msgid "On a GNU/Linux system, a build user pool may be created like this (using Bash syntax and the @code{shadow} commands):"
  4693. msgstr ""
  4694. #. type: example
  4695. #: guix-git/doc/guix.texi:1081
  4696. #, no-wrap
  4697. msgid ""
  4698. "# groupadd --system guixbuild\n"
  4699. "# for i in $(seq -w 1 10);\n"
  4700. " do\n"
  4701. " useradd -g guixbuild -G guixbuild \\\n"
  4702. " -d /var/empty -s $(which nologin) \\\n"
  4703. " -c \"Guix build user $i\" --system \\\n"
  4704. " guixbuilder$i;\n"
  4705. " done\n"
  4706. msgstr ""
  4707. #. type: Plain text
  4708. #: guix-git/doc/guix.texi:1091
  4709. msgid "The number of build users determines how many build jobs may run in parallel, as specified by the @option{--max-jobs} option (@pxref{Invoking guix-daemon, @option{--max-jobs}}). To use @command{guix system vm} and related commands, you may need to add the build users to the @code{kvm} group so they can access @file{/dev/kvm}, using @code{-G guixbuild,kvm} instead of @code{-G guixbuild} (@pxref{Invoking guix system})."
  4710. msgstr ""
  4711. #. type: Plain text
  4712. #: guix-git/doc/guix.texi:1100
  4713. msgid "The @code{guix-daemon} program may then be run as @code{root} with the following command@footnote{If your machine uses the systemd init system, dropping the @file{@var{prefix}/lib/systemd/system/guix-daemon.service} file in @file{/etc/systemd/system} will ensure that @command{guix-daemon} is automatically started. Similarly, if your machine uses the Upstart init system, drop the @file{@var{prefix}/lib/upstart/system/guix-daemon.conf} file in @file{/etc/init}.}:"
  4714. msgstr ""
  4715. #. type: example
  4716. #: guix-git/doc/guix.texi:1103 guix-git/doc/guix.texi:1501
  4717. #, no-wrap
  4718. msgid "# guix-daemon --build-users-group=guixbuild\n"
  4719. msgstr ""
  4720. #. type: cindex
  4721. #: guix-git/doc/guix.texi:1105 guix-git/doc/guix.texi:1506
  4722. #, no-wrap
  4723. msgid "chroot"
  4724. msgstr ""
  4725. #. type: Plain text
  4726. #: guix-git/doc/guix.texi:1110
  4727. msgid "This way, the daemon starts build processes in a chroot, under one of the @code{guixbuilder} users. On GNU/Linux, by default, the chroot environment contains nothing but:"
  4728. msgstr ""
  4729. #. type: itemize
  4730. #: guix-git/doc/guix.texi:1118
  4731. msgid "a minimal @code{/dev} directory, created mostly independently from the host @code{/dev}@footnote{``Mostly'', because while the set of files that appear in the chroot's @code{/dev} is fixed, most of these files can only be created if the host has them.};"
  4732. msgstr ""
  4733. #. type: itemize
  4734. #: guix-git/doc/guix.texi:1122
  4735. msgid "the @code{/proc} directory; it only shows the processes of the container since a separate PID name space is used;"
  4736. msgstr ""
  4737. #. type: itemize
  4738. #: guix-git/doc/guix.texi:1126
  4739. msgid "@file{/etc/passwd} with an entry for the current user and an entry for user @file{nobody};"
  4740. msgstr ""
  4741. #. type: itemize
  4742. #: guix-git/doc/guix.texi:1129
  4743. msgid "@file{/etc/group} with an entry for the user's group;"
  4744. msgstr ""
  4745. #. type: itemize
  4746. #: guix-git/doc/guix.texi:1133
  4747. msgid "@file{/etc/hosts} with an entry that maps @code{localhost} to @code{127.0.0.1};"
  4748. msgstr ""
  4749. #. type: itemize
  4750. #: guix-git/doc/guix.texi:1136
  4751. msgid "a writable @file{/tmp} directory."
  4752. msgstr ""
  4753. #. type: Plain text
  4754. #: guix-git/doc/guix.texi:1145
  4755. msgid "You can influence the directory where the daemon stores build trees @i{via} the @env{TMPDIR} environment variable. However, the build tree within the chroot is always called @file{/tmp/guix-build-@var{name}.drv-0}, where @var{name} is the derivation name---e.g., @code{coreutils-8.24}. This way, the value of @env{TMPDIR} does not leak inside build environments, which avoids discrepancies in cases where build processes capture the name of their build tree."
  4756. msgstr ""
  4757. #. type: vindex
  4758. #: guix-git/doc/guix.texi:1146 guix-git/doc/guix.texi:3949
  4759. #, no-wrap
  4760. msgid "http_proxy"
  4761. msgstr ""
  4762. #. type: vindex
  4763. #: guix-git/doc/guix.texi:1147 guix-git/doc/guix.texi:3950
  4764. #, no-wrap
  4765. msgid "https_proxy"
  4766. msgstr ""
  4767. #. type: Plain text
  4768. #: guix-git/doc/guix.texi:1152
  4769. msgid "The daemon also honors the @env{http_proxy} and @env{https_proxy} environment variables for HTTP and HTTPS downloads it performs, be it for fixed-output derivations (@pxref{Derivations}) or for substitutes (@pxref{Substitutes})."
  4770. msgstr ""
  4771. #. type: Plain text
  4772. #: guix-git/doc/guix.texi:1160
  4773. msgid "If you are installing Guix as an unprivileged user, it is still possible to run @command{guix-daemon} provided you pass @option{--disable-chroot}. However, build processes will not be isolated from one another, and not from the rest of the system. Thus, build processes may interfere with each other, and may access programs, libraries, and other files available on the system---making it much harder to view them as @emph{pure} functions."
  4774. msgstr ""
  4775. #. type: subsection
  4776. #: guix-git/doc/guix.texi:1163
  4777. #, no-wrap
  4778. msgid "Using the Offload Facility"
  4779. msgstr ""
  4780. #. type: cindex
  4781. #: guix-git/doc/guix.texi:1165 guix-git/doc/guix.texi:1567
  4782. #, no-wrap
  4783. msgid "offloading"
  4784. msgstr ""
  4785. #. type: cindex
  4786. #: guix-git/doc/guix.texi:1166
  4787. #, no-wrap
  4788. msgid "build hook"
  4789. msgstr ""
  4790. #. type: Plain text
  4791. #: guix-git/doc/guix.texi:1185
  4792. msgid "When desired, the build daemon can @dfn{offload} derivation builds to other machines running Guix, using the @code{offload} @dfn{build hook}@footnote{This feature is available only when @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH} is present.}. When that feature is enabled, a list of user-specified build machines is read from @file{/etc/guix/machines.scm}; every time a build is requested, for instance via @code{guix build}, the daemon attempts to offload it to one of the machines that satisfy the constraints of the derivation, in particular its system types---e.g., @code{x86_64-linux}. A single machine can have multiple system types, either because its architecture natively supports it, via emulation (@pxref{transparent-emulation-qemu, Transparent Emulation with QEMU}), or both. Missing prerequisites for the build are copied over SSH to the target machine, which then proceeds with the build; upon success the output(s) of the build are copied back to the initial machine. The offload facility comes with a basic scheduler that attempts to select the best machine. The best machine is chosen among the available machines based on criteria such as:"
  4793. msgstr ""
  4794. #. type: enumerate
  4795. #: guix-git/doc/guix.texi:1191
  4796. msgid "The availability of a build slot. A build machine can have as many build slots (connections) as the value of the @code{parallel-builds} field of its @code{build-machine} object."
  4797. msgstr ""
  4798. #. type: enumerate
  4799. #: guix-git/doc/guix.texi:1195
  4800. msgid "Its relative speed, as defined via the @code{speed} field of its @code{build-machine} object."
  4801. msgstr ""
  4802. #. type: enumerate
  4803. #: guix-git/doc/guix.texi:1200
  4804. msgid "Its load. The normalized machine load must be lower than a threshold value, configurable via the @code{overload-threshold} field of its @code{build-machine} object."
  4805. msgstr ""
  4806. #. type: enumerate
  4807. #: guix-git/doc/guix.texi:1203
  4808. msgid "Disk space availability. More than a 100 MiB must be available."
  4809. msgstr ""
  4810. #. type: Plain text
  4811. #: guix-git/doc/guix.texi:1206
  4812. msgid "The @file{/etc/guix/machines.scm} file typically looks like this:"
  4813. msgstr ""
  4814. #. type: lisp
  4815. #: guix-git/doc/guix.texi:1214
  4816. #, no-wrap
  4817. msgid ""
  4818. "(list (build-machine\n"
  4819. " (name \"eightysix.example.org\")\n"
  4820. " (systems (list \"x86_64-linux\" \"i686-linux\"))\n"
  4821. " (host-key \"ssh-ed25519 AAAAC3Nza@dots{}\")\n"
  4822. " (user \"bob\")\n"
  4823. " (speed 2.)) ;incredibly fast!\n"
  4824. "\n"
  4825. msgstr ""
  4826. #. type: lisp
  4827. #: guix-git/doc/guix.texi:1223
  4828. #, no-wrap
  4829. msgid ""
  4830. " (build-machine\n"
  4831. " (name \"armeight.example.org\")\n"
  4832. " (systems (list \"aarch64-linux\"))\n"
  4833. " (host-key \"ssh-rsa AAAAB3Nza@dots{}\")\n"
  4834. " (user \"alice\")\n"
  4835. " (private-key\n"
  4836. " (string-append (getenv \"HOME\")\n"
  4837. " \"/.ssh/identity-for-guix\"))))\n"
  4838. msgstr ""
  4839. #. type: Plain text
  4840. #: guix-git/doc/guix.texi:1229
  4841. msgid "In the example above we specify a list of two build machines, one for the @code{x86_64} and @code{i686} architectures and one for the @code{aarch64} architecture."
  4842. msgstr ""
  4843. #. type: Plain text
  4844. #: guix-git/doc/guix.texi:1238
  4845. msgid "In fact, this file is---not surprisingly!---a Scheme file that is evaluated when the @code{offload} hook is started. Its return value must be a list of @code{build-machine} objects. While this example shows a fixed list of build machines, one could imagine, say, using DNS-SD to return a list of potential build machines discovered in the local network (@pxref{Introduction, Guile-Avahi,, guile-avahi, Using Avahi in Guile Scheme Programs}). The @code{build-machine} data type is detailed below."
  4846. msgstr ""
  4847. #. type: deftp
  4848. #: guix-git/doc/guix.texi:1239
  4849. #, no-wrap
  4850. msgid "{Data Type} build-machine"
  4851. msgstr ""
  4852. #. type: deftp
  4853. #: guix-git/doc/guix.texi:1242
  4854. msgid "This data type represents build machines to which the daemon may offload builds. The important fields are:"
  4855. msgstr ""
  4856. #. type: item
  4857. #: guix-git/doc/guix.texi:1245 guix-git/doc/guix.texi:6698
  4858. #: guix-git/doc/guix.texi:14527 guix-git/doc/guix.texi:14621
  4859. #: guix-git/doc/guix.texi:14862 guix-git/doc/guix.texi:16833
  4860. #: guix-git/doc/guix.texi:20112 guix-git/doc/guix.texi:23022
  4861. #: guix-git/doc/guix.texi:24411 guix-git/doc/guix.texi:25023
  4862. #: guix-git/doc/guix.texi:25375 guix-git/doc/guix.texi:25416
  4863. #: guix-git/doc/guix.texi:27568 guix-git/doc/guix.texi:29852
  4864. #: guix-git/doc/guix.texi:29872 guix-git/doc/guix.texi:32408
  4865. #: guix-git/doc/guix.texi:32425 guix-git/doc/guix.texi:32941
  4866. #: guix-git/doc/guix.texi:34677 guix-git/doc/guix.texi:35004
  4867. #, no-wrap
  4868. msgid "name"
  4869. msgstr "nome"
  4870. #. type: table
  4871. #: guix-git/doc/guix.texi:1247
  4872. msgid "The host name of the remote machine."
  4873. msgstr ""
  4874. #. type: item
  4875. #: guix-git/doc/guix.texi:1248
  4876. #, no-wrap
  4877. msgid "systems"
  4878. msgstr ""
  4879. #. type: table
  4880. #: guix-git/doc/guix.texi:1251
  4881. msgid "The system types the remote machine supports---e.g., @code{(list \"x86_64-linux\" \"i686-linux\")}."
  4882. msgstr ""
  4883. #. type: code{#1}
  4884. #: guix-git/doc/guix.texi:1252 guix-git/doc/guix.texi:16843
  4885. #, no-wrap
  4886. msgid "user"
  4887. msgstr "utente"
  4888. #. type: table
  4889. #: guix-git/doc/guix.texi:1256
  4890. msgid "The user account to use when connecting to the remote machine over SSH. Note that the SSH key pair must @emph{not} be passphrase-protected, to allow non-interactive logins."
  4891. msgstr ""
  4892. #. type: item
  4893. #: guix-git/doc/guix.texi:1257
  4894. #, no-wrap
  4895. msgid "host-key"
  4896. msgstr ""
  4897. #. type: table
  4898. #: guix-git/doc/guix.texi:1261
  4899. msgid "This must be the machine's SSH @dfn{public host key} in OpenSSH format. This is used to authenticate the machine when we connect to it. It is a long string that looks like this:"
  4900. msgstr ""
  4901. #. type: example
  4902. #: guix-git/doc/guix.texi:1264
  4903. #, no-wrap
  4904. msgid "ssh-ed25519 AAAAC3NzaC@dots{}mde+UhL hint@@example.org\n"
  4905. msgstr ""
  4906. #. type: table
  4907. #: guix-git/doc/guix.texi:1269
  4908. msgid "If the machine is running the OpenSSH daemon, @command{sshd}, the host key can be found in a file such as @file{/etc/ssh/ssh_host_ed25519_key.pub}."
  4909. msgstr ""
  4910. #. type: table
  4911. #: guix-git/doc/guix.texi:1274
  4912. msgid "If the machine is running the SSH daemon of GNU@tie{}lsh, @command{lshd}, the host key is in @file{/etc/lsh/host-key.pub} or a similar file. It can be converted to the OpenSSH format using @command{lsh-export-key} (@pxref{Converting keys,,, lsh, LSH Manual}):"
  4913. msgstr ""
  4914. #. type: example
  4915. #: guix-git/doc/guix.texi:1278
  4916. #, no-wrap
  4917. msgid ""
  4918. "$ lsh-export-key --openssh < /etc/lsh/host-key.pub\n"
  4919. "ssh-rsa AAAAB3NzaC1yc2EAAAAEOp8FoQAAAQEAs1eB46LV@dots{}\n"
  4920. msgstr ""
  4921. #. type: deftp
  4922. #: guix-git/doc/guix.texi:1283
  4923. msgid "A number of optional fields may be specified:"
  4924. msgstr ""
  4925. #. type: item
  4926. #: guix-git/doc/guix.texi:1286 guix-git/doc/guix.texi:34173
  4927. #, no-wrap
  4928. msgid "@code{port} (default: @code{22})"
  4929. msgstr ""
  4930. #. type: table
  4931. #: guix-git/doc/guix.texi:1288
  4932. msgid "Port number of SSH server on the machine."
  4933. msgstr ""
  4934. #. type: item
  4935. #: guix-git/doc/guix.texi:1289
  4936. #, no-wrap
  4937. msgid "@code{private-key} (default: @file{~root/.ssh/id_rsa})"
  4938. msgstr ""
  4939. #. type: table
  4940. #: guix-git/doc/guix.texi:1292
  4941. msgid "The SSH private key file to use when connecting to the machine, in OpenSSH format. This key must not be protected with a passphrase."
  4942. msgstr ""
  4943. #. type: table
  4944. #: guix-git/doc/guix.texi:1295
  4945. msgid "Note that the default value is the private key @emph{of the root account}. Make sure it exists if you use the default."
  4946. msgstr ""
  4947. #. type: item
  4948. #: guix-git/doc/guix.texi:1296
  4949. #, no-wrap
  4950. msgid "@code{compression} (default: @code{\"zlib@@openssh.com,zlib\"})"
  4951. msgstr ""
  4952. #. type: itemx
  4953. #: guix-git/doc/guix.texi:1297
  4954. #, no-wrap
  4955. msgid "@code{compression-level} (default: @code{3})"
  4956. msgstr ""
  4957. #. type: table
  4958. #: guix-git/doc/guix.texi:1299
  4959. msgid "The SSH-level compression methods and compression level requested."
  4960. msgstr ""
  4961. #. type: table
  4962. #: guix-git/doc/guix.texi:1302
  4963. msgid "Note that offloading relies on SSH compression to reduce bandwidth usage when transferring files to and from build machines."
  4964. msgstr ""
  4965. #. type: item
  4966. #: guix-git/doc/guix.texi:1303
  4967. #, no-wrap
  4968. msgid "@code{daemon-socket} (default: @code{\"/var/guix/daemon-socket/socket\"})"
  4969. msgstr ""
  4970. #. type: table
  4971. #: guix-git/doc/guix.texi:1306
  4972. msgid "File name of the Unix-domain socket @command{guix-daemon} is listening to on that machine."
  4973. msgstr ""
  4974. #. type: item
  4975. #: guix-git/doc/guix.texi:1307
  4976. #, no-wrap
  4977. msgid "@code{overload-threshold} (default: @code{0.6})"
  4978. msgstr ""
  4979. #. type: table
  4980. #: guix-git/doc/guix.texi:1313
  4981. msgid "The load threshold above which a potential offload machine is disregarded by the offload scheduler. The value roughly translates to the total processor usage of the build machine, ranging from 0.0 (0%) to 1.0 (100%). It can also be disabled by setting @code{overload-threshold} to @code{#f}."
  4982. msgstr ""
  4983. #. type: item
  4984. #: guix-git/doc/guix.texi:1314
  4985. #, no-wrap
  4986. msgid "@code{parallel-builds} (default: @code{1})"
  4987. msgstr ""
  4988. #. type: table
  4989. #: guix-git/doc/guix.texi:1316
  4990. msgid "The number of builds that may run in parallel on the machine."
  4991. msgstr ""
  4992. #. type: item
  4993. #: guix-git/doc/guix.texi:1317
  4994. #, no-wrap
  4995. msgid "@code{speed} (default: @code{1.0})"
  4996. msgstr ""
  4997. #. type: table
  4998. #: guix-git/doc/guix.texi:1320
  4999. msgid "A ``relative speed factor''. The offload scheduler will tend to prefer machines with a higher speed factor."
  5000. msgstr ""
  5001. #. type: item
  5002. #: guix-git/doc/guix.texi:1321
  5003. #, no-wrap
  5004. msgid "@code{features} (default: @code{'()})"
  5005. msgstr ""
  5006. #. type: table
  5007. #: guix-git/doc/guix.texi:1326
  5008. msgid "A list of strings denoting specific features supported by the machine. An example is @code{\"kvm\"} for machines that have the KVM Linux modules and corresponding hardware support. Derivations can request features by name, and they will be scheduled on matching build machines."
  5009. msgstr ""
  5010. #. type: Plain text
  5011. #: guix-git/doc/guix.texi:1332
  5012. msgid "The @command{guix} command must be in the search path on the build machines. You can check whether this is the case by running:"
  5013. msgstr ""
  5014. #. type: example
  5015. #: guix-git/doc/guix.texi:1335
  5016. #, no-wrap
  5017. msgid "ssh build-machine guix repl --version\n"
  5018. msgstr ""
  5019. #. type: Plain text
  5020. #: guix-git/doc/guix.texi:1342
  5021. msgid "There is one last thing to do once @file{machines.scm} is in place. As explained above, when offloading, files are transferred back and forth between the machine stores. For this to work, you first need to generate a key pair on each machine to allow the daemon to export signed archives of files from the store (@pxref{Invoking guix archive}):"
  5022. msgstr ""
  5023. #. type: example
  5024. #: guix-git/doc/guix.texi:1345 guix-git/doc/guix.texi:34101
  5025. #, no-wrap
  5026. msgid "# guix archive --generate-key\n"
  5027. msgstr ""
  5028. #. type: Plain text
  5029. #: guix-git/doc/guix.texi:1350
  5030. msgid "Each build machine must authorize the key of the master machine so that it accepts store items it receives from the master:"
  5031. msgstr ""
  5032. #. type: example
  5033. #: guix-git/doc/guix.texi:1353
  5034. #, no-wrap
  5035. msgid "# guix archive --authorize < master-public-key.txt\n"
  5036. msgstr ""
  5037. #. type: Plain text
  5038. #: guix-git/doc/guix.texi:1357
  5039. msgid "Likewise, the master machine must authorize the key of each build machine."
  5040. msgstr ""
  5041. #. type: Plain text
  5042. #: guix-git/doc/guix.texi:1363
  5043. msgid "All the fuss with keys is here to express pairwise mutual trust relations between the master and the build machines. Concretely, when the master receives files from a build machine (and @i{vice versa}), its build daemon can make sure they are genuine, have not been tampered with, and that they are signed by an authorized key."
  5044. msgstr ""
  5045. #. type: cindex
  5046. #: guix-git/doc/guix.texi:1364
  5047. #, no-wrap
  5048. msgid "offload test"
  5049. msgstr ""
  5050. #. type: Plain text
  5051. #: guix-git/doc/guix.texi:1367
  5052. msgid "To test whether your setup is operational, run this command on the master node:"
  5053. msgstr ""
  5054. #. type: example
  5055. #: guix-git/doc/guix.texi:1370
  5056. #, no-wrap
  5057. msgid "# guix offload test\n"
  5058. msgstr ""
  5059. #. type: Plain text
  5060. #: guix-git/doc/guix.texi:1376
  5061. msgid "This will attempt to connect to each of the build machines specified in @file{/etc/guix/machines.scm}, make sure Guix is available on each machine, attempt to export to the machine and import from it, and report any error in the process."
  5062. msgstr ""
  5063. #. type: Plain text
  5064. #: guix-git/doc/guix.texi:1379
  5065. msgid "If you want to test a different machine file, just specify it on the command line:"
  5066. msgstr ""
  5067. #. type: example
  5068. #: guix-git/doc/guix.texi:1382
  5069. #, no-wrap
  5070. msgid "# guix offload test machines-qualif.scm\n"
  5071. msgstr ""
  5072. #. type: Plain text
  5073. #: guix-git/doc/guix.texi:1386
  5074. msgid "Last, you can test the subset of the machines whose name matches a regular expression like this:"
  5075. msgstr ""
  5076. #. type: example
  5077. #: guix-git/doc/guix.texi:1389
  5078. #, no-wrap
  5079. msgid "# guix offload test machines.scm '\\.gnu\\.org$'\n"
  5080. msgstr ""
  5081. #. type: cindex
  5082. #: guix-git/doc/guix.texi:1391
  5083. #, no-wrap
  5084. msgid "offload status"
  5085. msgstr ""
  5086. #. type: Plain text
  5087. #: guix-git/doc/guix.texi:1394
  5088. msgid "To display the current load of all build hosts, run this command on the main node:"
  5089. msgstr ""
  5090. #. type: example
  5091. #: guix-git/doc/guix.texi:1397
  5092. #, no-wrap
  5093. msgid "# guix offload status\n"
  5094. msgstr ""
  5095. #. type: cindex
  5096. #: guix-git/doc/guix.texi:1403
  5097. #, no-wrap
  5098. msgid "SELinux, daemon policy"
  5099. msgstr ""
  5100. #. type: cindex
  5101. #: guix-git/doc/guix.texi:1404
  5102. #, no-wrap
  5103. msgid "mandatory access control, SELinux"
  5104. msgstr ""
  5105. #. type: cindex
  5106. #: guix-git/doc/guix.texi:1405
  5107. #, no-wrap
  5108. msgid "security, guix-daemon"
  5109. msgstr ""
  5110. #. type: Plain text
  5111. #: guix-git/doc/guix.texi:1411
  5112. msgid "Guix includes an SELinux policy file at @file{etc/guix-daemon.cil} that can be installed on a system where SELinux is enabled, in order to label Guix files and to specify the expected behavior of the daemon. Since Guix System does not provide an SELinux base policy, the daemon policy cannot be used on Guix System."
  5113. msgstr ""
  5114. #. type: subsubsection
  5115. #: guix-git/doc/guix.texi:1412
  5116. #, no-wrap
  5117. msgid "Installing the SELinux policy"
  5118. msgstr ""
  5119. #. type: cindex
  5120. #: guix-git/doc/guix.texi:1413
  5121. #, no-wrap
  5122. msgid "SELinux, policy installation"
  5123. msgstr ""
  5124. #. type: Plain text
  5125. #: guix-git/doc/guix.texi:1415
  5126. msgid "To install the policy run this command as root:"
  5127. msgstr ""
  5128. #. type: example
  5129. #: guix-git/doc/guix.texi:1418
  5130. #, no-wrap
  5131. msgid "semodule -i etc/guix-daemon.cil\n"
  5132. msgstr ""
  5133. #. type: Plain text
  5134. #: guix-git/doc/guix.texi:1422
  5135. msgid "Then relabel the file system with @code{restorecon} or by a different mechanism provided by your system."
  5136. msgstr ""
  5137. #. type: Plain text
  5138. #: guix-git/doc/guix.texi:1427
  5139. msgid "Once the policy is installed, the file system has been relabeled, and the daemon has been restarted, it should be running in the @code{guix_daemon_t} context. You can confirm this with the following command:"
  5140. msgstr ""
  5141. #. type: example
  5142. #: guix-git/doc/guix.texi:1430
  5143. #, no-wrap
  5144. msgid "ps -Zax | grep guix-daemon\n"
  5145. msgstr ""
  5146. #. type: Plain text
  5147. #: guix-git/doc/guix.texi:1435
  5148. msgid "Monitor the SELinux log files as you run a command like @code{guix build hello} to convince yourself that SELinux permits all necessary operations."
  5149. msgstr ""
  5150. #. type: cindex
  5151. #: guix-git/doc/guix.texi:1437
  5152. #, no-wrap
  5153. msgid "SELinux, limitations"
  5154. msgstr ""
  5155. #. type: Plain text
  5156. #: guix-git/doc/guix.texi:1442
  5157. msgid "This policy is not perfect. Here is a list of limitations or quirks that should be considered when deploying the provided SELinux policy for the Guix daemon."
  5158. msgstr ""
  5159. #. type: enumerate
  5160. #: guix-git/doc/guix.texi:1449
  5161. msgid "@code{guix_daemon_socket_t} isn’t actually used. None of the socket operations involve contexts that have anything to do with @code{guix_daemon_socket_t}. It doesn’t hurt to have this unused label, but it would be preferable to define socket rules for only this label."
  5162. msgstr ""
  5163. #. type: enumerate
  5164. #: guix-git/doc/guix.texi:1460
  5165. msgid "@code{guix gc} cannot access arbitrary links to profiles. By design, the file label of the destination of a symlink is independent of the file label of the link itself. Although all profiles under $localstatedir are labelled, the links to these profiles inherit the label of the directory they are in. For links in the user’s home directory this will be @code{user_home_t}. But for links from the root user’s home directory, or @file{/tmp}, or the HTTP server’s working directory, etc, this won’t work. @code{guix gc} would be prevented from reading and following these links."
  5166. msgstr ""
  5167. #. type: enumerate
  5168. #: guix-git/doc/guix.texi:1465
  5169. msgid "The daemon’s feature to listen for TCP connections might no longer work. This might require extra rules, because SELinux treats network sockets differently from files."
  5170. msgstr ""
  5171. #. type: enumerate
  5172. #: guix-git/doc/guix.texi:1476
  5173. msgid "Currently all files with a name matching the regular expression @code{/gnu/store/.+-(guix-.+|profile)/bin/guix-daemon} are assigned the label @code{guix_daemon_exec_t}; this means that @emph{any} file with that name in any profile would be permitted to run in the @code{guix_daemon_t} domain. This is not ideal. An attacker could build a package that provides this executable and convince a user to install and run it, which lifts it into the @code{guix_daemon_t} domain. At that point SELinux could not prevent it from accessing files that are allowed for processes in that domain."
  5174. msgstr ""
  5175. #. type: enumerate
  5176. #: guix-git/doc/guix.texi:1481
  5177. msgid "You will need to relabel the store directory after all upgrades to @file{guix-daemon}, such as after running @code{guix pull}. Assuming the store is in @file{/gnu}, you can do this with @code{restorecon -vR /gnu}, or by other means provided by your operating system."
  5178. msgstr ""
  5179. #. type: enumerate
  5180. #: guix-git/doc/guix.texi:1489
  5181. msgid "We could generate a much more restrictive policy at installation time, so that only the @emph{exact} file name of the currently installed @code{guix-daemon} executable would be labelled with @code{guix_daemon_exec_t}, instead of using a broad regular expression. The downside is that root would have to install or upgrade the policy at installation time whenever the Guix package that provides the effectively running @code{guix-daemon} executable is upgraded."
  5182. msgstr ""
  5183. #. type: section
  5184. #: guix-git/doc/guix.texi:1492
  5185. #, no-wrap
  5186. msgid "Invoking @command{guix-daemon}"
  5187. msgstr ""
  5188. #. type: Plain text
  5189. #: guix-git/doc/guix.texi:1498
  5190. msgid "The @command{guix-daemon} program implements all the functionality to access the store. This includes launching build processes, running the garbage collector, querying the availability of a build result, etc. It is normally run as @code{root} like this:"
  5191. msgstr ""
  5192. #. type: Plain text
  5193. #: guix-git/doc/guix.texi:1505
  5194. msgid "For details on how to set it up, @pxref{Setting Up the Daemon}."
  5195. msgstr ""
  5196. #. type: cindex
  5197. #: guix-git/doc/guix.texi:1507
  5198. #, no-wrap
  5199. msgid "container, build environment"
  5200. msgstr ""
  5201. #. type: cindex
  5202. #: guix-git/doc/guix.texi:1509 guix-git/doc/guix.texi:3026
  5203. #: guix-git/doc/guix.texi:3930 guix-git/doc/guix.texi:12937
  5204. #, no-wrap
  5205. msgid "reproducible builds"
  5206. msgstr ""
  5207. #. type: Plain text
  5208. #: guix-git/doc/guix.texi:1521
  5209. msgid "By default, @command{guix-daemon} launches build processes under different UIDs, taken from the build group specified with @option{--build-users-group}. In addition, each build process is run in a chroot environment that only contains the subset of the store that the build process depends on, as specified by its derivation (@pxref{Programming Interface, derivation}), plus a set of specific system directories. By default, the latter contains @file{/dev} and @file{/dev/pts}. Furthermore, on GNU/Linux, the build environment is a @dfn{container}: in addition to having its own file system tree, it has a separate mount name space, its own PID name space, network name space, etc. This helps achieve reproducible builds (@pxref{Features})."
  5210. msgstr ""
  5211. #. type: Plain text
  5212. #: guix-git/doc/guix.texi:1527
  5213. msgid "When the daemon performs a build on behalf of the user, it creates a build directory under @file{/tmp} or under the directory specified by its @env{TMPDIR} environment variable. This directory is shared with the container for the duration of the build, though within the container, the build tree is always called @file{/tmp/guix-build-@var{name}.drv-0}."
  5214. msgstr ""
  5215. #. type: Plain text
  5216. #: guix-git/doc/guix.texi:1531
  5217. msgid "The build directory is automatically deleted upon completion, unless the build failed and the client specified @option{--keep-failed} (@pxref{Common Build Options, @option{--keep-failed}})."
  5218. msgstr ""
  5219. #. type: Plain text
  5220. #: guix-git/doc/guix.texi:1537
  5221. msgid "The daemon listens for connections and spawns one sub-process for each session started by a client (one of the @command{guix} sub-commands). The @command{guix processes} command allows you to get an overview of the activity on your system by viewing each of the active sessions and clients. @xref{Invoking guix processes}, for more information."
  5222. msgstr ""
  5223. #. type: Plain text
  5224. #: guix-git/doc/guix.texi:1539
  5225. msgid "The following command-line options are supported:"
  5226. msgstr ""
  5227. #. type: item
  5228. #: guix-git/doc/guix.texi:1541
  5229. #, no-wrap
  5230. msgid "--build-users-group=@var{group}"
  5231. msgstr ""
  5232. #. type: table
  5233. #: guix-git/doc/guix.texi:1544
  5234. msgid "Take users from @var{group} to run build processes (@pxref{Setting Up the Daemon, build users})."
  5235. msgstr ""
  5236. #. type: item
  5237. #: guix-git/doc/guix.texi:1545 guix-git/doc/guix.texi:10339
  5238. #, no-wrap
  5239. msgid "--no-substitutes"
  5240. msgstr ""
  5241. #. type: cindex
  5242. #: guix-git/doc/guix.texi:1546 guix-git/doc/guix.texi:3038
  5243. #: guix-git/doc/guix.texi:3683
  5244. #, no-wrap
  5245. msgid "substitutes"
  5246. msgstr ""
  5247. #. type: table
  5248. #: guix-git/doc/guix.texi:1550 guix-git/doc/guix.texi:10343
  5249. msgid "Do not use substitutes for build products. That is, always build things locally instead of allowing downloads of pre-built binaries (@pxref{Substitutes})."
  5250. msgstr ""
  5251. #. type: table
  5252. #: guix-git/doc/guix.texi:1554
  5253. msgid "When the daemon runs with @option{--no-substitutes}, clients can still explicitly enable substitution @i{via} the @code{set-build-options} remote procedure call (@pxref{The Store})."
  5254. msgstr ""
  5255. #. type: anchor{#1}
  5256. #: guix-git/doc/guix.texi:1556
  5257. msgid "daemon-substitute-urls"
  5258. msgstr ""
  5259. #. type: item
  5260. #: guix-git/doc/guix.texi:1556 guix-git/doc/guix.texi:10326
  5261. #: guix-git/doc/guix.texi:12358 guix-git/doc/guix.texi:13083
  5262. #: guix-git/doc/guix.texi:13308
  5263. #, no-wrap
  5264. msgid "--substitute-urls=@var{urls}"
  5265. msgstr ""
  5266. #. type: table
  5267. #: guix-git/doc/guix.texi:1560
  5268. msgid "Consider @var{urls} the default whitespace-separated list of substitute source URLs. When this option is omitted, @indicateurl{@value{SUBSTITUTE-URLS}} is used."
  5269. msgstr ""
  5270. #. type: table
  5271. #: guix-git/doc/guix.texi:1563
  5272. msgid "This means that substitutes may be downloaded from @var{urls}, as long as they are signed by a trusted signature (@pxref{Substitutes})."
  5273. msgstr ""
  5274. #. type: table
  5275. #: guix-git/doc/guix.texi:1566
  5276. msgid "@xref{Getting Substitutes from Other Servers}, for more information on how to configure the daemon to get substitutes from other servers."
  5277. msgstr ""
  5278. #. type: item
  5279. #: guix-git/doc/guix.texi:1568 guix-git/doc/guix.texi:10362
  5280. #, no-wrap
  5281. msgid "--no-offload"
  5282. msgstr ""
  5283. #. type: table
  5284. #: guix-git/doc/guix.texi:1572 guix-git/doc/guix.texi:10366
  5285. msgid "Do not use offload builds to other machines (@pxref{Daemon Offload Setup}). That is, always build things locally instead of offloading builds to remote machines."
  5286. msgstr ""
  5287. #. type: item
  5288. #: guix-git/doc/guix.texi:1573
  5289. #, no-wrap
  5290. msgid "--cache-failures"
  5291. msgstr ""
  5292. #. type: table
  5293. #: guix-git/doc/guix.texi:1575
  5294. msgid "Cache build failures. By default, only successful builds are cached."
  5295. msgstr ""
  5296. #. type: table
  5297. #: guix-git/doc/guix.texi:1580
  5298. msgid "When this option is used, @command{guix gc --list-failures} can be used to query the set of store items marked as failed; @command{guix gc --clear-failures} removes store items from the set of cached failures. @xref{Invoking guix gc}."
  5299. msgstr ""
  5300. #. type: item
  5301. #: guix-git/doc/guix.texi:1581 guix-git/doc/guix.texi:10392
  5302. #, no-wrap
  5303. msgid "--cores=@var{n}"
  5304. msgstr ""
  5305. #. type: itemx
  5306. #: guix-git/doc/guix.texi:1582 guix-git/doc/guix.texi:10393
  5307. #, no-wrap
  5308. msgid "-c @var{n}"
  5309. msgstr ""
  5310. #. type: table
  5311. #: guix-git/doc/guix.texi:1585
  5312. msgid "Use @var{n} CPU cores to build each derivation; @code{0} means as many as available."
  5313. msgstr ""
  5314. #. type: table
  5315. #: guix-git/doc/guix.texi:1589
  5316. msgid "The default value is @code{0}, but it may be overridden by clients, such as the @option{--cores} option of @command{guix build} (@pxref{Invoking guix build})."
  5317. msgstr ""
  5318. #. type: table
  5319. #: guix-git/doc/guix.texi:1593
  5320. msgid "The effect is to define the @env{NIX_BUILD_CORES} environment variable in the build process, which can then use it to exploit internal parallelism---for instance, by running @code{make -j$NIX_BUILD_CORES}."
  5321. msgstr ""
  5322. #. type: item
  5323. #: guix-git/doc/guix.texi:1594 guix-git/doc/guix.texi:10397
  5324. #, no-wrap
  5325. msgid "--max-jobs=@var{n}"
  5326. msgstr ""
  5327. #. type: itemx
  5328. #: guix-git/doc/guix.texi:1595 guix-git/doc/guix.texi:10398
  5329. #, no-wrap
  5330. msgid "-M @var{n}"
  5331. msgstr ""
  5332. #. type: table
  5333. #: guix-git/doc/guix.texi:1600
  5334. msgid "Allow at most @var{n} build jobs in parallel. The default value is @code{1}. Setting it to @code{0} means that no builds will be performed locally; instead, the daemon will offload builds (@pxref{Daemon Offload Setup}), or simply fail."
  5335. msgstr ""
  5336. #. type: item
  5337. #: guix-git/doc/guix.texi:1601 guix-git/doc/guix.texi:10367
  5338. #, no-wrap
  5339. msgid "--max-silent-time=@var{seconds}"
  5340. msgstr ""
  5341. #. type: table
  5342. #: guix-git/doc/guix.texi:1604 guix-git/doc/guix.texi:10370
  5343. msgid "When the build or substitution process remains silent for more than @var{seconds}, terminate it and report a build failure."
  5344. msgstr ""
  5345. #. type: table
  5346. #: guix-git/doc/guix.texi:1606 guix-git/doc/guix.texi:1615
  5347. msgid "The default value is @code{0}, which disables the timeout."
  5348. msgstr ""
  5349. #. type: table
  5350. #: guix-git/doc/guix.texi:1609
  5351. msgid "The value specified here can be overridden by clients (@pxref{Common Build Options, @option{--max-silent-time}})."
  5352. msgstr ""
  5353. #. type: item
  5354. #: guix-git/doc/guix.texi:1610 guix-git/doc/guix.texi:10374
  5355. #, no-wrap
  5356. msgid "--timeout=@var{seconds}"
  5357. msgstr ""
  5358. #. type: table
  5359. #: guix-git/doc/guix.texi:1613 guix-git/doc/guix.texi:10377
  5360. msgid "Likewise, when the build or substitution process lasts for more than @var{seconds}, terminate it and report a build failure."
  5361. msgstr ""
  5362. #. type: table
  5363. #: guix-git/doc/guix.texi:1618
  5364. msgid "The value specified here can be overridden by clients (@pxref{Common Build Options, @option{--timeout}})."
  5365. msgstr ""
  5366. #. type: item
  5367. #: guix-git/doc/guix.texi:1619
  5368. #, no-wrap
  5369. msgid "--rounds=@var{N}"
  5370. msgstr ""
  5371. #. type: table
  5372. #: guix-git/doc/guix.texi:1624
  5373. msgid "Build each derivation @var{n} times in a row, and raise an error if consecutive build results are not bit-for-bit identical. Note that this setting can be overridden by clients such as @command{guix build} (@pxref{Invoking guix build})."
  5374. msgstr ""
  5375. #. type: table
  5376. #: guix-git/doc/guix.texi:1628 guix-git/doc/guix.texi:10361
  5377. #: guix-git/doc/guix.texi:10923
  5378. msgid "When used in conjunction with @option{--keep-failed}, the differing output is kept in the store, under @file{/gnu/store/@dots{}-check}. This makes it easy to look for differences between the two results."
  5379. msgstr ""
  5380. #. type: item
  5381. #: guix-git/doc/guix.texi:1629
  5382. #, no-wrap
  5383. msgid "--debug"
  5384. msgstr ""
  5385. #. type: table
  5386. #: guix-git/doc/guix.texi:1631
  5387. msgid "Produce debugging output."
  5388. msgstr ""
  5389. #. type: table
  5390. #: guix-git/doc/guix.texi:1635
  5391. msgid "This is useful to debug daemon start-up issues, but then it may be overridden by clients, for example the @option{--verbosity} option of @command{guix build} (@pxref{Invoking guix build})."
  5392. msgstr ""
  5393. #. type: item
  5394. #: guix-git/doc/guix.texi:1636
  5395. #, no-wrap
  5396. msgid "--chroot-directory=@var{dir}"
  5397. msgstr ""
  5398. #. type: table
  5399. #: guix-git/doc/guix.texi:1638
  5400. msgid "Add @var{dir} to the build chroot."
  5401. msgstr ""
  5402. #. type: table
  5403. #: guix-git/doc/guix.texi:1644
  5404. msgid "Doing this may change the result of build processes---for instance if they use optional dependencies found in @var{dir} when it is available, and not otherwise. For that reason, it is not recommended to do so. Instead, make sure that each derivation declares all the inputs that it needs."
  5405. msgstr ""
  5406. #. type: item
  5407. #: guix-git/doc/guix.texi:1645
  5408. #, no-wrap
  5409. msgid "--disable-chroot"
  5410. msgstr ""
  5411. #. type: table
  5412. #: guix-git/doc/guix.texi:1647
  5413. msgid "Disable chroot builds."
  5414. msgstr ""
  5415. #. type: table
  5416. #: guix-git/doc/guix.texi:1652
  5417. msgid "Using this option is not recommended since, again, it would allow build processes to gain access to undeclared dependencies. It is necessary, though, when @command{guix-daemon} is running under an unprivileged user account."
  5418. msgstr ""
  5419. #. type: item
  5420. #: guix-git/doc/guix.texi:1653
  5421. #, no-wrap
  5422. msgid "--log-compression=@var{type}"
  5423. msgstr ""
  5424. #. type: table
  5425. #: guix-git/doc/guix.texi:1656
  5426. msgid "Compress build logs according to @var{type}, one of @code{gzip}, @code{bzip2}, or @code{none}."
  5427. msgstr ""
  5428. #. type: table
  5429. #: guix-git/doc/guix.texi:1660
  5430. msgid "Unless @option{--lose-logs} is used, all the build logs are kept in the @var{localstatedir}. To save space, the daemon automatically compresses them with Bzip2 by default."
  5431. msgstr ""
  5432. #. type: item
  5433. #: guix-git/doc/guix.texi:1661
  5434. #, no-wrap
  5435. msgid "--discover[=yes|no]"
  5436. msgstr ""
  5437. #. type: table
  5438. #: guix-git/doc/guix.texi:1664 guix-git/doc/guix.texi:15638
  5439. msgid "Whether to discover substitute servers on the local network using mDNS and DNS-SD."
  5440. msgstr ""
  5441. #. type: table
  5442. #: guix-git/doc/guix.texi:1667
  5443. msgid "This feature is still experimental. However, here are a few considerations."
  5444. msgstr ""
  5445. #. type: enumerate
  5446. #: guix-git/doc/guix.texi:1671
  5447. msgid "It might be faster/less expensive than fetching from remote servers;"
  5448. msgstr ""
  5449. #. type: enumerate
  5450. #: guix-git/doc/guix.texi:1674
  5451. msgid "There are no security risks, only genuine substitutes will be used (@pxref{Substitute Authentication});"
  5452. msgstr ""
  5453. #. type: enumerate
  5454. #: guix-git/doc/guix.texi:1678
  5455. msgid "An attacker advertising @command{guix publish} on your LAN cannot serve you malicious binaries, but they can learn what software you’re installing;"
  5456. msgstr ""
  5457. #. type: enumerate
  5458. #: guix-git/doc/guix.texi:1681
  5459. msgid "Servers may serve substitute over HTTP, unencrypted, so anyone on the LAN can see what software you’re installing."
  5460. msgstr ""
  5461. #. type: table
  5462. #: guix-git/doc/guix.texi:1685
  5463. msgid "It is also possible to enable or disable substitute server discovery at run-time by running:"
  5464. msgstr ""
  5465. #. type: example
  5466. #: guix-git/doc/guix.texi:1689
  5467. #, no-wrap
  5468. msgid ""
  5469. "herd discover guix-daemon on\n"
  5470. "herd discover guix-daemon off\n"
  5471. msgstr ""
  5472. #. type: item
  5473. #: guix-git/doc/guix.texi:1691
  5474. #, no-wrap
  5475. msgid "--disable-deduplication"
  5476. msgstr ""
  5477. #. type: cindex
  5478. #: guix-git/doc/guix.texi:1692 guix-git/doc/guix.texi:4268
  5479. #, no-wrap
  5480. msgid "deduplication"
  5481. msgstr "deduplicazione"
  5482. #. type: table
  5483. #: guix-git/doc/guix.texi:1694
  5484. msgid "Disable automatic file ``deduplication'' in the store."
  5485. msgstr ""
  5486. #. type: table
  5487. #: guix-git/doc/guix.texi:1701
  5488. msgid "By default, files added to the store are automatically ``deduplicated'': if a newly added file is identical to another one found in the store, the daemon makes the new file a hard link to the other file. This can noticeably reduce disk usage, at the expense of slightly increased input/output load at the end of a build process. This option disables this optimization."
  5489. msgstr ""
  5490. #. type: item
  5491. #: guix-git/doc/guix.texi:1702
  5492. #, no-wrap
  5493. msgid "--gc-keep-outputs[=yes|no]"
  5494. msgstr ""
  5495. #. type: table
  5496. #: guix-git/doc/guix.texi:1705
  5497. msgid "Tell whether the garbage collector (GC) must keep outputs of live derivations."
  5498. msgstr ""
  5499. #. type: cindex
  5500. #: guix-git/doc/guix.texi:1706 guix-git/doc/guix.texi:4081
  5501. #, no-wrap
  5502. msgid "GC roots"
  5503. msgstr ""
  5504. #. type: cindex
  5505. #: guix-git/doc/guix.texi:1707 guix-git/doc/guix.texi:4082
  5506. #, no-wrap
  5507. msgid "garbage collector roots"
  5508. msgstr ""
  5509. #. type: table
  5510. #: guix-git/doc/guix.texi:1713
  5511. msgid "When set to @code{yes}, the GC will keep the outputs of any live derivation available in the store---the @file{.drv} files. The default is @code{no}, meaning that derivation outputs are kept only if they are reachable from a GC root. @xref{Invoking guix gc}, for more on GC roots."
  5512. msgstr ""
  5513. #. type: item
  5514. #: guix-git/doc/guix.texi:1714
  5515. #, no-wrap
  5516. msgid "--gc-keep-derivations[=yes|no]"
  5517. msgstr ""
  5518. #. type: table
  5519. #: guix-git/doc/guix.texi:1717
  5520. msgid "Tell whether the garbage collector (GC) must keep derivations corresponding to live outputs."
  5521. msgstr ""
  5522. #. type: table
  5523. #: guix-git/doc/guix.texi:1723
  5524. msgid "When set to @code{yes}, as is the case by default, the GC keeps derivations---i.e., @file{.drv} files---as long as at least one of their outputs is live. This allows users to keep track of the origins of items in their store. Setting it to @code{no} saves a bit of disk space."
  5525. msgstr ""
  5526. #. type: table
  5527. #: guix-git/doc/guix.texi:1732
  5528. msgid "In this way, setting @option{--gc-keep-derivations} to @code{yes} causes liveness to flow from outputs to derivations, and setting @option{--gc-keep-outputs} to @code{yes} causes liveness to flow from derivations to outputs. When both are set to @code{yes}, the effect is to keep all the build prerequisites (the sources, compiler, libraries, and other build-time tools) of live objects in the store, regardless of whether these prerequisites are reachable from a GC root. This is convenient for developers since it saves rebuilds or downloads."
  5529. msgstr ""
  5530. #. type: item
  5531. #: guix-git/doc/guix.texi:1733
  5532. #, no-wrap
  5533. msgid "--impersonate-linux-2.6"
  5534. msgstr ""
  5535. #. type: table
  5536. #: guix-git/doc/guix.texi:1736
  5537. msgid "On Linux-based systems, impersonate Linux 2.6. This means that the kernel's @command{uname} system call will report 2.6 as the release number."
  5538. msgstr ""
  5539. #. type: table
  5540. #: guix-git/doc/guix.texi:1739
  5541. msgid "This might be helpful to build programs that (usually wrongfully) depend on the kernel version number."
  5542. msgstr ""
  5543. #. type: item
  5544. #: guix-git/doc/guix.texi:1740
  5545. #, no-wrap
  5546. msgid "--lose-logs"
  5547. msgstr ""
  5548. #. type: table
  5549. #: guix-git/doc/guix.texi:1743
  5550. msgid "Do not keep build logs. By default they are kept under @file{@var{localstatedir}/guix/log}."
  5551. msgstr ""
  5552. #. type: item
  5553. #: guix-git/doc/guix.texi:1744 guix-git/doc/guix.texi:4509
  5554. #: guix-git/doc/guix.texi:5808 guix-git/doc/guix.texi:6208
  5555. #: guix-git/doc/guix.texi:10867 guix-git/doc/guix.texi:12385
  5556. #: guix-git/doc/guix.texi:12636 guix-git/doc/guix.texi:13313
  5557. #: guix-git/doc/guix.texi:33044 guix-git/doc/guix.texi:33843
  5558. #, no-wrap
  5559. msgid "--system=@var{system}"
  5560. msgstr ""
  5561. #. type: table
  5562. #: guix-git/doc/guix.texi:1748
  5563. msgid "Assume @var{system} as the current system type. By default it is the architecture/kernel pair found at configure time, such as @code{x86_64-linux}."
  5564. msgstr ""
  5565. #. type: item
  5566. #: guix-git/doc/guix.texi:1749 guix-git/doc/guix.texi:10172
  5567. #, no-wrap
  5568. msgid "--listen=@var{endpoint}"
  5569. msgstr ""
  5570. #. type: table
  5571. #: guix-git/doc/guix.texi:1754
  5572. msgid "Listen for connections on @var{endpoint}. @var{endpoint} is interpreted as the file name of a Unix-domain socket if it starts with @code{/} (slash sign). Otherwise, @var{endpoint} is interpreted as a host name or host name and port to listen to. Here are a few examples:"
  5573. msgstr ""
  5574. #. type: item
  5575. #: guix-git/doc/guix.texi:1756
  5576. #, no-wrap
  5577. msgid "--listen=/gnu/var/daemon"
  5578. msgstr ""
  5579. #. type: table
  5580. #: guix-git/doc/guix.texi:1759
  5581. msgid "Listen for connections on the @file{/gnu/var/daemon} Unix-domain socket, creating it if needed."
  5582. msgstr ""
  5583. #. type: item
  5584. #: guix-git/doc/guix.texi:1760
  5585. #, no-wrap
  5586. msgid "--listen=localhost"
  5587. msgstr ""
  5588. #. type: cindex
  5589. #: guix-git/doc/guix.texi:1761 guix-git/doc/guix.texi:8846
  5590. #, no-wrap
  5591. msgid "daemon, remote access"
  5592. msgstr ""
  5593. #. type: cindex
  5594. #: guix-git/doc/guix.texi:1762 guix-git/doc/guix.texi:8847
  5595. #, no-wrap
  5596. msgid "remote access to the daemon"
  5597. msgstr ""
  5598. #. type: cindex
  5599. #: guix-git/doc/guix.texi:1763 guix-git/doc/guix.texi:8848
  5600. #, no-wrap
  5601. msgid "daemon, cluster setup"
  5602. msgstr ""
  5603. #. type: cindex
  5604. #: guix-git/doc/guix.texi:1764 guix-git/doc/guix.texi:8849
  5605. #, no-wrap
  5606. msgid "clusters, daemon setup"
  5607. msgstr ""
  5608. #. type: table
  5609. #: guix-git/doc/guix.texi:1767
  5610. msgid "Listen for TCP connections on the network interface corresponding to @code{localhost}, on port 44146."
  5611. msgstr ""
  5612. #. type: item
  5613. #: guix-git/doc/guix.texi:1768
  5614. #, no-wrap
  5615. msgid "--listen=128.0.0.42:1234"
  5616. msgstr ""
  5617. #. type: table
  5618. #: guix-git/doc/guix.texi:1771
  5619. msgid "Listen for TCP connections on the network interface corresponding to @code{128.0.0.42}, on port 1234."
  5620. msgstr ""
  5621. #. type: table
  5622. #: guix-git/doc/guix.texi:1778
  5623. msgid "This option can be repeated multiple times, in which case @command{guix-daemon} accepts connections on all the specified endpoints. Users can tell client commands what endpoint to connect to by setting the @env{GUIX_DAEMON_SOCKET} environment variable (@pxref{The Store, @env{GUIX_DAEMON_SOCKET}})."
  5624. msgstr ""
  5625. #. type: quotation
  5626. #: guix-git/doc/guix.texi:1785
  5627. msgid "The daemon protocol is @emph{unauthenticated and unencrypted}. Using @option{--listen=@var{host}} is suitable on local networks, such as clusters, where only trusted nodes may connect to the build daemon. In other cases where remote access to the daemon is needed, we recommend using Unix-domain sockets along with SSH."
  5628. msgstr ""
  5629. #. type: table
  5630. #: guix-git/doc/guix.texi:1790
  5631. msgid "When @option{--listen} is omitted, @command{guix-daemon} listens for connections on the Unix-domain socket located at @file{@var{localstatedir}/guix/daemon-socket/socket}."
  5632. msgstr ""
  5633. #. type: Plain text
  5634. #: guix-git/doc/guix.texi:1800
  5635. msgid "When using Guix on top of GNU/Linux distribution other than Guix System---a so-called @dfn{foreign distro}---a few additional steps are needed to get everything in place. Here are some of them."
  5636. msgstr ""
  5637. #. type: anchor{#1}
  5638. #: guix-git/doc/guix.texi:1804
  5639. msgid "locales-and-locpath"
  5640. msgstr ""
  5641. #. type: cindex
  5642. #: guix-git/doc/guix.texi:1804
  5643. #, no-wrap
  5644. msgid "locales, when not on Guix System"
  5645. msgstr ""
  5646. #. type: vindex
  5647. #: guix-git/doc/guix.texi:1805 guix-git/doc/guix.texi:14846
  5648. #, no-wrap
  5649. msgid "LOCPATH"
  5650. msgstr ""
  5651. #. type: vindex
  5652. #: guix-git/doc/guix.texi:1806
  5653. #, no-wrap
  5654. msgid "GUIX_LOCPATH"
  5655. msgstr ""
  5656. #. type: Plain text
  5657. #: guix-git/doc/guix.texi:1811
  5658. msgid "Packages installed @i{via} Guix will not use the locale data of the host system. Instead, you must first install one of the locale packages available with Guix and then define the @env{GUIX_LOCPATH} environment variable:"
  5659. msgstr ""
  5660. #. type: example
  5661. #: guix-git/doc/guix.texi:1815
  5662. #, no-wrap
  5663. msgid ""
  5664. "$ guix install glibc-locales\n"
  5665. "$ export GUIX_LOCPATH=$HOME/.guix-profile/lib/locale\n"
  5666. msgstr ""
  5667. #. type: Plain text
  5668. #: guix-git/doc/guix.texi:1821
  5669. msgid "Note that the @code{glibc-locales} package contains data for all the locales supported by the GNU@tie{}libc and weighs in at around 917@tie{}MiB@. Alternatively, the @code{glibc-utf8-locales} is smaller but limited to a few UTF-8 locales."
  5670. msgstr ""
  5671. #. type: Plain text
  5672. #: guix-git/doc/guix.texi:1825
  5673. msgid "The @env{GUIX_LOCPATH} variable plays a role similar to @env{LOCPATH} (@pxref{Locale Names, @env{LOCPATH},, libc, The GNU C Library Reference Manual}). There are two important differences though:"
  5674. msgstr ""
  5675. #. type: enumerate
  5676. #: guix-git/doc/guix.texi:1832
  5677. msgid "@env{GUIX_LOCPATH} is honored only by the libc in Guix, and not by the libc provided by foreign distros. Thus, using @env{GUIX_LOCPATH} allows you to make sure the programs of the foreign distro will not end up loading incompatible locale data."
  5678. msgstr ""
  5679. #. type: enumerate
  5680. #: guix-git/doc/guix.texi:1839
  5681. msgid "libc suffixes each entry of @env{GUIX_LOCPATH} with @code{/X.Y}, where @code{X.Y} is the libc version---e.g., @code{2.22}. This means that, should your Guix profile contain a mixture of programs linked against different libc version, each libc version will only try to load locale data in the right format."
  5682. msgstr ""
  5683. #. type: Plain text
  5684. #: guix-git/doc/guix.texi:1843
  5685. msgid "This is important because the locale data format used by different libc versions may be incompatible."
  5686. msgstr ""
  5687. #. type: cindex
  5688. #: guix-git/doc/guix.texi:1846
  5689. #, no-wrap
  5690. msgid "name service switch, glibc"
  5691. msgstr ""
  5692. #. type: cindex
  5693. #: guix-git/doc/guix.texi:1847
  5694. #, no-wrap
  5695. msgid "NSS (name service switch), glibc"
  5696. msgstr ""
  5697. #. type: cindex
  5698. #: guix-git/doc/guix.texi:1848
  5699. #, no-wrap
  5700. msgid "nscd (name service caching daemon)"
  5701. msgstr ""
  5702. #. type: cindex
  5703. #: guix-git/doc/guix.texi:1849
  5704. #, no-wrap
  5705. msgid "name service caching daemon (nscd)"
  5706. msgstr ""
  5707. #. type: Plain text
  5708. #: guix-git/doc/guix.texi:1856
  5709. msgid "When using Guix on a foreign distro, we @emph{strongly recommend} that the system run the GNU C library's @dfn{name service cache daemon}, @command{nscd}, which should be listening on the @file{/var/run/nscd/socket} socket. Failing to do that, applications installed with Guix may fail to look up host names or user accounts, or may even crash. The next paragraphs explain why."
  5710. msgstr ""
  5711. #. type: file{#1}
  5712. #: guix-git/doc/guix.texi:1857
  5713. #, no-wrap
  5714. msgid "nsswitch.conf"
  5715. msgstr ""
  5716. #. type: Plain text
  5717. #: guix-git/doc/guix.texi:1862
  5718. msgid "The GNU C library implements a @dfn{name service switch} (NSS), which is an extensible mechanism for ``name lookups'' in general: host name resolution, user accounts, and more (@pxref{Name Service Switch,,, libc, The GNU C Library Reference Manual})."
  5719. msgstr ""
  5720. #. type: cindex
  5721. #: guix-git/doc/guix.texi:1863
  5722. #, no-wrap
  5723. msgid "Network information service (NIS)"
  5724. msgstr ""
  5725. #. type: cindex
  5726. #: guix-git/doc/guix.texi:1864
  5727. #, no-wrap
  5728. msgid "NIS (Network information service)"
  5729. msgstr ""
  5730. #. type: Plain text
  5731. #: guix-git/doc/guix.texi:1873
  5732. msgid "Being extensible, the NSS supports @dfn{plugins}, which provide new name lookup implementations: for example, the @code{nss-mdns} plugin allow resolution of @code{.local} host names, the @code{nis} plugin allows user account lookup using the Network information service (NIS), and so on. These extra ``lookup services'' are configured system-wide in @file{/etc/nsswitch.conf}, and all the programs running on the system honor those settings (@pxref{NSS Configuration File,,, libc, The GNU C Reference Manual})."
  5733. msgstr ""
  5734. #. type: Plain text
  5735. #: guix-git/doc/guix.texi:1883
  5736. msgid "When they perform a name lookup---for instance by calling the @code{getaddrinfo} function in C---applications first try to connect to the nscd; on success, nscd performs name lookups on their behalf. If the nscd is not running, then they perform the name lookup by themselves, by loading the name lookup services into their own address space and running it. These name lookup services---the @file{libnss_*.so} files---are @code{dlopen}'d, but they may come from the host system's C library, rather than from the C library the application is linked against (the C library coming from Guix)."
  5737. msgstr ""
  5738. #. type: Plain text
  5739. #: guix-git/doc/guix.texi:1888
  5740. msgid "And this is where the problem is: if your application is linked against Guix's C library (say, glibc 2.24) and tries to load NSS plugins from another C library (say, @code{libnss_mdns.so} for glibc 2.22), it will likely crash or have its name lookups fail unexpectedly."
  5741. msgstr ""
  5742. #. type: Plain text
  5743. #: guix-git/doc/guix.texi:1893
  5744. msgid "Running @command{nscd} on the system, among other advantages, eliminates this binary incompatibility problem because those @code{libnss_*.so} files are loaded in the @command{nscd} process, not in applications themselves."
  5745. msgstr ""
  5746. #. type: subsection
  5747. #: guix-git/doc/guix.texi:1894
  5748. #, no-wrap
  5749. msgid "X11 Fonts"
  5750. msgstr ""
  5751. #. type: Plain text
  5752. #: guix-git/doc/guix.texi:1904
  5753. msgid "The majority of graphical applications use Fontconfig to locate and load fonts and perform X11-client-side rendering. The @code{fontconfig} package in Guix looks for fonts in @file{$HOME/.guix-profile} by default. Thus, to allow graphical applications installed with Guix to display fonts, you have to install fonts with Guix as well. Essential font packages include @code{gs-fonts}, @code{font-dejavu}, and @code{font-gnu-freefont}."
  5754. msgstr ""
  5755. #. type: code{#1}
  5756. #: guix-git/doc/guix.texi:1905
  5757. #, no-wrap
  5758. msgid "fc-cache"
  5759. msgstr ""
  5760. #. type: cindex
  5761. #: guix-git/doc/guix.texi:1906
  5762. #, no-wrap
  5763. msgid "font cache"
  5764. msgstr ""
  5765. #. type: Plain text
  5766. #: guix-git/doc/guix.texi:1910
  5767. msgid "Once you have installed or removed fonts, or when you notice an application that does not find fonts, you may need to install Fontconfig and to force an update of its font cache by running:"
  5768. msgstr ""
  5769. #. type: example
  5770. #: guix-git/doc/guix.texi:1914
  5771. #, no-wrap
  5772. msgid ""
  5773. "guix install fontconfig\n"
  5774. "fc-cache -rv\n"
  5775. msgstr ""
  5776. #. type: Plain text
  5777. #: guix-git/doc/guix.texi:1922
  5778. msgid "To display text written in Chinese languages, Japanese, or Korean in graphical applications, consider installing @code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}. The former has multiple outputs, one per language family (@pxref{Packages with Multiple Outputs}). For instance, the following command installs fonts for Chinese languages:"
  5779. msgstr ""
  5780. #. type: example
  5781. #: guix-git/doc/guix.texi:1925
  5782. #, no-wrap
  5783. msgid "guix install font-adobe-source-han-sans:cn\n"
  5784. msgstr ""
  5785. #. type: code{#1}
  5786. #: guix-git/doc/guix.texi:1927
  5787. #, no-wrap
  5788. msgid "xterm"
  5789. msgstr ""
  5790. #. type: Plain text
  5791. #: guix-git/doc/guix.texi:1931
  5792. msgid "Older programs such as @command{xterm} do not use Fontconfig and instead rely on server-side font rendering. Such programs require to specify a full name of a font using XLFD (X Logical Font Description), like this:"
  5793. msgstr ""
  5794. #. type: example
  5795. #: guix-git/doc/guix.texi:1934
  5796. #, no-wrap
  5797. msgid "-*-dejavu sans-medium-r-normal-*-*-100-*-*-*-*-*-1\n"
  5798. msgstr ""
  5799. #. type: Plain text
  5800. #: guix-git/doc/guix.texi:1938
  5801. msgid "To be able to use such full names for the TrueType fonts installed in your Guix profile, you need to extend the font path of the X server:"
  5802. msgstr ""
  5803. #. type: example
  5804. #: guix-git/doc/guix.texi:1943
  5805. #, no-wrap
  5806. msgid "xset +fp $(dirname $(readlink -f ~/.guix-profile/share/fonts/truetype/fonts.dir))\n"
  5807. msgstr ""
  5808. #. type: code{#1}
  5809. #: guix-git/doc/guix.texi:1945
  5810. #, no-wrap
  5811. msgid "xlsfonts"
  5812. msgstr ""
  5813. #. type: Plain text
  5814. #: guix-git/doc/guix.texi:1948
  5815. msgid "After that, you can run @code{xlsfonts} (from @code{xlsfonts} package) to make sure your TrueType fonts are listed there."
  5816. msgstr ""
  5817. #. type: code{#1}
  5818. #: guix-git/doc/guix.texi:1952 guix-git/doc/guix.texi:32782
  5819. #, no-wrap
  5820. msgid "nss-certs"
  5821. msgstr ""
  5822. #. type: Plain text
  5823. #: guix-git/doc/guix.texi:1955
  5824. msgid "The @code{nss-certs} package provides X.509 certificates, which allow programs to authenticate Web servers accessed over HTTPS."
  5825. msgstr ""
  5826. #. type: Plain text
  5827. #: guix-git/doc/guix.texi:1960
  5828. msgid "When using Guix on a foreign distro, you can install this package and define the relevant environment variables so that packages know where to look for certificates. @xref{X.509 Certificates}, for detailed information."
  5829. msgstr ""
  5830. #. type: code{#1}
  5831. #: guix-git/doc/guix.texi:1963
  5832. #, no-wrap
  5833. msgid "emacs"
  5834. msgstr "emacs"
  5835. #. type: Plain text
  5836. #: guix-git/doc/guix.texi:1969
  5837. msgid "When you install Emacs packages with Guix, the Elisp files are placed under the @file{share/emacs/site-lisp/} directory of the profile in which they are installed. The Elisp libraries are made available to Emacs through the @env{EMACSLOADPATH} environment variable, which is set when installing Emacs itself."
  5838. msgstr ""
  5839. #. type: Plain text
  5840. #: guix-git/doc/guix.texi:1976
  5841. msgid "Additionally, autoload definitions are automatically evaluated at the initialization of Emacs, by the Guix-specific @code{guix-emacs-autoload-packages} procedure. If, for some reason, you want to avoid auto-loading the Emacs packages installed with Guix, you can do so by running Emacs with the @option{--no-site-file} option (@pxref{Init File,,, emacs, The GNU Emacs Manual})."
  5842. msgstr ""
  5843. #. type: cindex
  5844. #: guix-git/doc/guix.texi:1981
  5845. #, no-wrap
  5846. msgid "Upgrading Guix, on a foreign distro"
  5847. msgstr ""
  5848. #. type: Plain text
  5849. #: guix-git/doc/guix.texi:1984
  5850. msgid "To upgrade Guix, run:"
  5851. msgstr ""
  5852. #. type: example
  5853. #: guix-git/doc/guix.texi:1987 guix-git/doc/guix.texi:2834
  5854. #, no-wrap
  5855. msgid "guix pull\n"
  5856. msgstr ""
  5857. #. type: Plain text
  5858. #: guix-git/doc/guix.texi:1990
  5859. msgid "@xref{Invoking guix pull}, for more information."
  5860. msgstr ""
  5861. #. type: cindex
  5862. #: guix-git/doc/guix.texi:1991
  5863. #, no-wrap
  5864. msgid "upgrading Guix for the root user, on a foreign distro"
  5865. msgstr ""
  5866. #. type: cindex
  5867. #: guix-git/doc/guix.texi:1992
  5868. #, no-wrap
  5869. msgid "upgrading the Guix daemon, on a foreign distro"
  5870. msgstr ""
  5871. #. type: cindex
  5872. #: guix-git/doc/guix.texi:1993
  5873. #, no-wrap
  5874. msgid "@command{guix pull} for the root user, on a foreign distro"
  5875. msgstr ""
  5876. #. type: Plain text
  5877. #: guix-git/doc/guix.texi:1996
  5878. msgid "On a foreign distro, you can upgrade the build daemon by running:"
  5879. msgstr ""
  5880. #. type: example
  5881. #: guix-git/doc/guix.texi:1999
  5882. #, no-wrap
  5883. msgid "sudo -i guix pull\n"
  5884. msgstr ""
  5885. #. type: Plain text
  5886. #: guix-git/doc/guix.texi:2004
  5887. msgid "followed by (assuming your distro uses the systemd service management tool):"
  5888. msgstr ""
  5889. #. type: example
  5890. #: guix-git/doc/guix.texi:2007
  5891. #, no-wrap
  5892. msgid "systemctl restart guix-daemon.service\n"
  5893. msgstr ""
  5894. #. type: Plain text
  5895. #: guix-git/doc/guix.texi:2011
  5896. msgid "On Guix System, upgrading the daemon is achieved by reconfiguring the system (@pxref{Invoking guix system, @code{guix system reconfigure}})."
  5897. msgstr ""
  5898. #. type: cindex
  5899. #: guix-git/doc/guix.texi:2018
  5900. #, no-wrap
  5901. msgid "installing Guix System"
  5902. msgstr ""
  5903. #. type: cindex
  5904. #: guix-git/doc/guix.texi:2019
  5905. #, no-wrap
  5906. msgid "Guix System, installation"
  5907. msgstr ""
  5908. #. type: Plain text
  5909. #: guix-git/doc/guix.texi:2024
  5910. msgid "This section explains how to install Guix System on a machine. Guix, as a package manager, can also be installed on top of a running GNU/Linux system, @pxref{Installation}."
  5911. msgstr ""
  5912. #. type: quotation
  5913. #: guix-git/doc/guix.texi:2033
  5914. msgid "You are reading this documentation with an Info reader. For details on how to use it, hit the @key{RET} key (``return'' or ``enter'') on the link that follows: @pxref{Top, Info reader,, info-stnd, Stand-alone GNU Info}. Hit @kbd{l} afterwards to come back here."
  5915. msgstr ""
  5916. #. type: quotation
  5917. #: guix-git/doc/guix.texi:2036
  5918. msgid "Alternatively, run @command{info info} in another tty to keep the manual available."
  5919. msgstr ""
  5920. #. type: Plain text
  5921. #: guix-git/doc/guix.texi:2057
  5922. msgid "We consider Guix System to be ready for a wide range of ``desktop'' and server use cases. The reliability guarantees it provides---transactional upgrades and rollbacks, reproducibility---make it a solid foundation."
  5923. msgstr ""
  5924. #. type: Plain text
  5925. #: guix-git/doc/guix.texi:2060
  5926. msgid "Nevertheless, before you proceed with the installation, be aware of the following noteworthy limitations applicable to version @value{VERSION}:"
  5927. msgstr ""
  5928. #. type: itemize
  5929. #: guix-git/doc/guix.texi:2065
  5930. msgid "More and more system services are provided (@pxref{Services}), but some may be missing."
  5931. msgstr ""
  5932. #. type: itemize
  5933. #: guix-git/doc/guix.texi:2070
  5934. msgid "GNOME, Xfce, LXDE, and Enlightenment are available (@pxref{Desktop Services}), as well as a number of X11 window managers. However, KDE is currently missing."
  5935. msgstr ""
  5936. #. type: Plain text
  5937. #: guix-git/doc/guix.texi:2075
  5938. msgid "More than a disclaimer, this is an invitation to report issues (and success stories!), and to join us in improving it. @xref{Contributing}, for more info."
  5939. msgstr ""
  5940. #. type: cindex
  5941. #: guix-git/doc/guix.texi:2080
  5942. #, no-wrap
  5943. msgid "hardware support on Guix System"
  5944. msgstr ""
  5945. #. type: Plain text
  5946. #: guix-git/doc/guix.texi:2089
  5947. msgid "GNU@tie{}Guix focuses on respecting the user's computing freedom. It builds around the kernel Linux-libre, which means that only hardware for which free software drivers and firmware exist is supported. Nowadays, a wide range of off-the-shelf hardware is supported on GNU/Linux-libre---from keyboards to graphics cards to scanners and Ethernet controllers. Unfortunately, there are still areas where hardware vendors deny users control over their own computing, and such hardware is not supported on Guix System."
  5948. msgstr ""
  5949. #. type: cindex
  5950. #: guix-git/doc/guix.texi:2090
  5951. #, no-wrap
  5952. msgid "WiFi, hardware support"
  5953. msgstr ""
  5954. #. type: Plain text
  5955. #: guix-git/doc/guix.texi:2099
  5956. msgid "One of the main areas where free drivers or firmware are lacking is WiFi devices. WiFi devices known to work include those using Atheros chips (AR9271 and AR7010), which corresponds to the @code{ath9k} Linux-libre driver, and those using Broadcom/AirForce chips (BCM43xx with Wireless-Core Revision 5), which corresponds to the @code{b43-open} Linux-libre driver. Free firmware exists for both and is available out-of-the-box on Guix System, as part of @code{%base-firmware} (@pxref{operating-system Reference, @code{firmware}})."
  5957. msgstr ""
  5958. #. type: cindex
  5959. #: guix-git/doc/guix.texi:2100
  5960. #, no-wrap
  5961. msgid "RYF, Respects Your Freedom"
  5962. msgstr ""
  5963. #. type: Plain text
  5964. #: guix-git/doc/guix.texi:2106
  5965. msgid "The @uref{https://www.fsf.org/, Free Software Foundation} runs @uref{https://www.fsf.org/ryf, @dfn{Respects Your Freedom}} (RYF), a certification program for hardware products that respect your freedom and your privacy and ensure that you have control over your device. We encourage you to check the list of RYF-certified devices."
  5966. msgstr ""
  5967. #. type: Plain text
  5968. #: guix-git/doc/guix.texi:2110
  5969. msgid "Another useful resource is the @uref{https://www.h-node.org/, H-Node} web site. It contains a catalog of hardware devices with information about their support in GNU/Linux."
  5970. msgstr ""
  5971. #. type: Plain text
  5972. #: guix-git/doc/guix.texi:2119
  5973. msgid "An ISO-9660 installation image that can be written to a USB stick or burnt to a DVD can be downloaded from @indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso}, where you can replace @code{x86_64-linux} with one of:"
  5974. msgstr ""
  5975. #. type: table
  5976. #: guix-git/doc/guix.texi:2123
  5977. msgid "for a GNU/Linux system on Intel/AMD-compatible 64-bit CPUs;"
  5978. msgstr ""
  5979. #. type: table
  5980. #: guix-git/doc/guix.texi:2126
  5981. msgid "for a 32-bit GNU/Linux system on Intel-compatible CPUs."
  5982. msgstr ""
  5983. #. type: Plain text
  5984. #: guix-git/doc/guix.texi:2131
  5985. msgid "Make sure to download the associated @file{.sig} file and to verify the authenticity of the image against it, along these lines:"
  5986. msgstr ""
  5987. #. type: example
  5988. #: guix-git/doc/guix.texi:2135
  5989. #, no-wrap
  5990. msgid ""
  5991. "$ wget @value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso.sig\n"
  5992. "$ gpg --verify guix-system-install-@value{VERSION}.x86_64-linux.iso.sig\n"
  5993. msgstr ""
  5994. #. type: example
  5995. #: guix-git/doc/guix.texi:2143
  5996. #, no-wrap
  5997. msgid ""
  5998. "$ wget @value{OPENPGP-SIGNING-KEY-URL} \\\n"
  5999. " -qO - | gpg --import -\n"
  6000. msgstr ""
  6001. #. type: Plain text
  6002. #: guix-git/doc/guix.texi:2155
  6003. msgid "This image contains the tools necessary for an installation. It is meant to be copied @emph{as is} to a large-enough USB stick or DVD."
  6004. msgstr ""
  6005. #. type: unnumberedsubsec
  6006. #: guix-git/doc/guix.texi:2156
  6007. #, no-wrap
  6008. msgid "Copying to a USB Stick"
  6009. msgstr ""
  6010. #. type: Plain text
  6011. #: guix-git/doc/guix.texi:2161
  6012. msgid "Insert a USB stick of 1@tie{}GiB or more into your machine, and determine its device name. Assuming that the USB stick is known as @file{/dev/sdX}, copy the image with:"
  6013. msgstr ""
  6014. #. type: example
  6015. #: guix-git/doc/guix.texi:2165
  6016. #, no-wrap
  6017. msgid ""
  6018. "dd if=guix-system-install-@value{VERSION}.x86_64-linux.iso of=/dev/sdX status=progress\n"
  6019. "sync\n"
  6020. msgstr ""
  6021. #. type: Plain text
  6022. #: guix-git/doc/guix.texi:2168
  6023. msgid "Access to @file{/dev/sdX} usually requires root privileges."
  6024. msgstr ""
  6025. #. type: unnumberedsubsec
  6026. #: guix-git/doc/guix.texi:2169
  6027. #, no-wrap
  6028. msgid "Burning on a DVD"
  6029. msgstr ""
  6030. #. type: Plain text
  6031. #: guix-git/doc/guix.texi:2174
  6032. msgid "Insert a blank DVD into your machine, and determine its device name. Assuming that the DVD drive is known as @file{/dev/srX}, copy the image with:"
  6033. msgstr ""
  6034. #. type: example
  6035. #: guix-git/doc/guix.texi:2177
  6036. #, no-wrap
  6037. msgid "growisofs -dvd-compat -Z /dev/srX=guix-system-install-@value{VERSION}.x86_64-linux.iso\n"
  6038. msgstr ""
  6039. #. type: Plain text
  6040. #: guix-git/doc/guix.texi:2180
  6041. msgid "Access to @file{/dev/srX} usually requires root privileges."
  6042. msgstr ""
  6043. #. type: unnumberedsubsec
  6044. #: guix-git/doc/guix.texi:2181
  6045. #, no-wrap
  6046. msgid "Booting"
  6047. msgstr ""
  6048. #. type: Plain text
  6049. #: guix-git/doc/guix.texi:2188
  6050. msgid "Once this is done, you should be able to reboot the system and boot from the USB stick or DVD@. The latter usually requires you to get in the BIOS or UEFI boot menu, where you can choose to boot from the USB stick. In order to boot from Libreboot, switch to the command mode by pressing the @kbd{c} key and type @command{search_grub usb}."
  6051. msgstr ""
  6052. #. type: Plain text
  6053. #: guix-git/doc/guix.texi:2191
  6054. msgid "@xref{Installing Guix in a VM}, if, instead, you would like to install Guix System in a virtual machine (VM)."
  6055. msgstr ""
  6056. #. type: Plain text
  6057. #: guix-git/doc/guix.texi:2201
  6058. msgid "Once you have booted, you can use the guided graphical installer, which makes it easy to get started (@pxref{Guided Graphical Installation}). Alternatively, if you are already familiar with GNU/Linux and if you want more control than what the graphical installer provides, you can choose the ``manual'' installation process (@pxref{Manual Installation})."
  6059. msgstr ""
  6060. #. type: Plain text
  6061. #: guix-git/doc/guix.texi:2209
  6062. msgid "The graphical installer is available on TTY1. You can obtain root shells on TTYs 3 to 6 by hitting @kbd{ctrl-alt-f3}, @kbd{ctrl-alt-f4}, etc. TTY2 shows this documentation and you can reach it with @kbd{ctrl-alt-f2}. Documentation is browsable using the Info reader commands (@pxref{Top,,, info-stnd, Stand-alone GNU Info}). The installation system runs the GPM mouse daemon, which allows you to select text with the left mouse button and to paste it with the middle button."
  6063. msgstr ""
  6064. #. type: quotation
  6065. #: guix-git/doc/guix.texi:2214
  6066. msgid "Installation requires access to the Internet so that any missing dependencies of your system configuration can be downloaded. See the ``Networking'' section below."
  6067. msgstr ""
  6068. #. type: Plain text
  6069. #: guix-git/doc/guix.texi:2221
  6070. msgid "The graphical installer is a text-based user interface. It will guide you, with dialog boxes, through the steps needed to install GNU@tie{}Guix System."
  6071. msgstr ""
  6072. #. type: Plain text
  6073. #: guix-git/doc/guix.texi:2226
  6074. msgid "The first dialog boxes allow you to set up the system as you use it during the installation: you can choose the language, keyboard layout, and set up networking, which will be used during the installation. The image below shows the networking dialog."
  6075. msgstr ""
  6076. #. type: Plain text
  6077. #: guix-git/doc/guix.texi:2228
  6078. msgid "@image{images/installer-network,5in,, networking setup with the graphical installer}"
  6079. msgstr ""
  6080. #. type: Plain text
  6081. #: guix-git/doc/guix.texi:2233
  6082. msgid "Later steps allow you to partition your hard disk, as shown in the image below, to choose whether or not to use encrypted file systems, to enter the host name and root password, and to create an additional account, among other things."
  6083. msgstr ""
  6084. #. type: Plain text
  6085. #: guix-git/doc/guix.texi:2235
  6086. msgid "@image{images/installer-partitions,5in,, partitioning with the graphical installer}"
  6087. msgstr ""
  6088. #. type: Plain text
  6089. #: guix-git/doc/guix.texi:2238
  6090. msgid "Note that, at any time, the installer allows you to exit the current installation step and resume at a previous step, as show in the image below."
  6091. msgstr ""
  6092. #. type: Plain text
  6093. #: guix-git/doc/guix.texi:2240
  6094. msgid "@image{images/installer-resume,5in,, resuming the installation process}"
  6095. msgstr ""
  6096. #. type: Plain text
  6097. #: guix-git/doc/guix.texi:2245
  6098. msgid "Once you're done, the installer produces an operating system configuration and displays it (@pxref{Using the Configuration System}). At that point you can hit ``OK'' and installation will proceed. On success, you can reboot into the new system and enjoy. @xref{After System Installation}, for what's next!"
  6099. msgstr ""
  6100. #. type: Plain text
  6101. #: guix-git/doc/guix.texi:2255
  6102. msgid "This section describes how you would ``manually'' install GNU@tie{}Guix System on your machine. This option requires familiarity with GNU/Linux, with the shell, and with common administration tools. If you think this is not for you, consider using the guided graphical installer (@pxref{Guided Graphical Installation})."
  6103. msgstr ""
  6104. #. type: Plain text
  6105. #: guix-git/doc/guix.texi:2261
  6106. msgid "The installation system provides root shells on TTYs 3 to 6; press @kbd{ctrl-alt-f3}, @kbd{ctrl-alt-f4}, and so on to reach them. It includes many common tools needed to install the system. But it is also a full-blown Guix System, which means that you can install additional packages, should you need it, using @command{guix package} (@pxref{Invoking guix package})."
  6107. msgstr ""
  6108. #. type: subsection
  6109. #: guix-git/doc/guix.texi:2268
  6110. #, no-wrap
  6111. msgid "Keyboard Layout, Networking, and Partitioning"
  6112. msgstr ""
  6113. #. type: Plain text
  6114. #: guix-git/doc/guix.texi:2273
  6115. msgid "Before you can install the system, you may want to adjust the keyboard layout, set up networking, and partition your target hard disk. This section will guide you through this."
  6116. msgstr ""
  6117. #. type: cindex
  6118. #: guix-git/doc/guix.texi:2276 guix-git/doc/guix.texi:14660
  6119. #, no-wrap
  6120. msgid "keyboard layout"
  6121. msgstr ""
  6122. #. type: Plain text
  6123. #: guix-git/doc/guix.texi:2280
  6124. msgid "The installation image uses the US qwerty keyboard layout. If you want to change it, you can use the @command{loadkeys} command. For example, the following command selects the Dvorak keyboard layout:"
  6125. msgstr ""
  6126. #. type: example
  6127. #: guix-git/doc/guix.texi:2283
  6128. #, no-wrap
  6129. msgid "loadkeys dvorak\n"
  6130. msgstr ""
  6131. #. type: Plain text
  6132. #: guix-git/doc/guix.texi:2288
  6133. msgid "See the files under @file{/run/current-system/profile/share/keymaps} for a list of available keyboard layouts. Run @command{man loadkeys} for more information."
  6134. msgstr ""
  6135. #. type: subsubsection
  6136. #: guix-git/doc/guix.texi:2289
  6137. #, no-wrap
  6138. msgid "Networking"
  6139. msgstr "Rete"
  6140. #. type: Plain text
  6141. #: guix-git/doc/guix.texi:2292
  6142. msgid "Run the following command to see what your network interfaces are called:"
  6143. msgstr ""
  6144. #. type: example
  6145. #: guix-git/doc/guix.texi:2295
  6146. #, no-wrap
  6147. msgid "ifconfig -a\n"
  6148. msgstr ""
  6149. #. type: table
  6150. #: guix-git/doc/guix.texi:2299 guix-git/doc/guix.texi:2321
  6151. msgid "@dots{} or, using the GNU/Linux-specific @command{ip} command:"
  6152. msgstr ""
  6153. #. type: example
  6154. #: guix-git/doc/guix.texi:2302
  6155. #, no-wrap
  6156. msgid "ip address\n"
  6157. msgstr ""
  6158. #. type: Plain text
  6159. #: guix-git/doc/guix.texi:2309
  6160. msgid "Wired interfaces have a name starting with @samp{e}; for example, the interface corresponding to the first on-board Ethernet controller is called @samp{eno1}. Wireless interfaces have a name starting with @samp{w}, like @samp{w1p2s0}."
  6161. msgstr ""
  6162. #. type: item
  6163. #: guix-git/doc/guix.texi:2311
  6164. #, no-wrap
  6165. msgid "Wired connection"
  6166. msgstr ""
  6167. #. type: table
  6168. #: guix-git/doc/guix.texi:2314
  6169. msgid "To configure a wired network run the following command, substituting @var{interface} with the name of the wired interface you want to use."
  6170. msgstr ""
  6171. #. type: example
  6172. #: guix-git/doc/guix.texi:2317
  6173. #, no-wrap
  6174. msgid "ifconfig @var{interface} up\n"
  6175. msgstr ""
  6176. #. type: example
  6177. #: guix-git/doc/guix.texi:2324
  6178. #, no-wrap
  6179. msgid "ip link set @var{interface} up\n"
  6180. msgstr ""
  6181. #. type: item
  6182. #: guix-git/doc/guix.texi:2326
  6183. #, no-wrap
  6184. msgid "Wireless connection"
  6185. msgstr ""
  6186. #. type: cindex
  6187. #: guix-git/doc/guix.texi:2327 guix-git/doc/guix.texi:16305
  6188. #, no-wrap
  6189. msgid "wireless"
  6190. msgstr ""
  6191. #. type: cindex
  6192. #: guix-git/doc/guix.texi:2328 guix-git/doc/guix.texi:16306
  6193. #, no-wrap
  6194. msgid "WiFi"
  6195. msgstr ""
  6196. #. type: table
  6197. #: guix-git/doc/guix.texi:2333
  6198. msgid "To configure wireless networking, you can create a configuration file for the @command{wpa_supplicant} configuration tool (its location is not important) using one of the available text editors such as @command{nano}:"
  6199. msgstr ""
  6200. #. type: example
  6201. #: guix-git/doc/guix.texi:2336
  6202. #, no-wrap
  6203. msgid "nano wpa_supplicant.conf\n"
  6204. msgstr ""
  6205. #. type: table
  6206. #: guix-git/doc/guix.texi:2341
  6207. msgid "As an example, the following stanza can go to this file and will work for many wireless networks, provided you give the actual SSID and passphrase for the network you are connecting to:"
  6208. msgstr ""
  6209. #. type: example
  6210. #: guix-git/doc/guix.texi:2348
  6211. #, no-wrap
  6212. msgid ""
  6213. "network=@{\n"
  6214. " ssid=\"@var{my-ssid}\"\n"
  6215. " key_mgmt=WPA-PSK\n"
  6216. " psk=\"the network's secret passphrase\"\n"
  6217. "@}\n"
  6218. msgstr ""
  6219. #. type: table
  6220. #: guix-git/doc/guix.texi:2353
  6221. msgid "Start the wireless service and run it in the background with the following command (substitute @var{interface} with the name of the network interface you want to use):"
  6222. msgstr ""
  6223. #. type: example
  6224. #: guix-git/doc/guix.texi:2356
  6225. #, no-wrap
  6226. msgid "wpa_supplicant -c wpa_supplicant.conf -i @var{interface} -B\n"
  6227. msgstr ""
  6228. #. type: table
  6229. #: guix-git/doc/guix.texi:2359
  6230. msgid "Run @command{man wpa_supplicant} for more information."
  6231. msgstr ""
  6232. #. type: cindex
  6233. #: guix-git/doc/guix.texi:2361
  6234. #, no-wrap
  6235. msgid "DHCP"
  6236. msgstr ""
  6237. #. type: Plain text
  6238. #: guix-git/doc/guix.texi:2364
  6239. msgid "At this point, you need to acquire an IP address. On a network where IP addresses are automatically assigned @i{via} DHCP, you can run:"
  6240. msgstr ""
  6241. #. type: example
  6242. #: guix-git/doc/guix.texi:2367
  6243. #, no-wrap
  6244. msgid "dhclient -v @var{interface}\n"
  6245. msgstr ""
  6246. #. type: Plain text
  6247. #: guix-git/doc/guix.texi:2370
  6248. msgid "Try to ping a server to see if networking is up and running:"
  6249. msgstr ""
  6250. #. type: example
  6251. #: guix-git/doc/guix.texi:2373
  6252. #, no-wrap
  6253. msgid "ping -c 3 gnu.org\n"
  6254. msgstr ""
  6255. #. type: Plain text
  6256. #: guix-git/doc/guix.texi:2377
  6257. msgid "Setting up network access is almost always a requirement because the image does not contain all the software and tools that may be needed."
  6258. msgstr ""
  6259. #. type: cindex
  6260. #: guix-git/doc/guix.texi:2378
  6261. #, no-wrap
  6262. msgid "proxy, during system installation"
  6263. msgstr ""
  6264. #. type: Plain text
  6265. #: guix-git/doc/guix.texi:2381
  6266. msgid "If you need HTTP and HTTPS access to go through a proxy, run the following command:"
  6267. msgstr ""
  6268. #. type: example
  6269. #: guix-git/doc/guix.texi:2384
  6270. #, no-wrap
  6271. msgid "herd set-http-proxy guix-daemon @var{URL}\n"
  6272. msgstr ""
  6273. #. type: Plain text
  6274. #: guix-git/doc/guix.texi:2389
  6275. msgid "where @var{URL} is the proxy URL, for example @code{http://example.org:8118}."
  6276. msgstr ""
  6277. #. type: cindex
  6278. #: guix-git/doc/guix.texi:2390
  6279. #, no-wrap
  6280. msgid "installing over SSH"
  6281. msgstr ""
  6282. #. type: Plain text
  6283. #: guix-git/doc/guix.texi:2393
  6284. msgid "If you want to, you can continue the installation remotely by starting an SSH server:"
  6285. msgstr ""
  6286. #. type: example
  6287. #: guix-git/doc/guix.texi:2396
  6288. #, no-wrap
  6289. msgid "herd start ssh-daemon\n"
  6290. msgstr ""
  6291. #. type: Plain text
  6292. #: guix-git/doc/guix.texi:2400
  6293. msgid "Make sure to either set a password with @command{passwd}, or configure OpenSSH public key authentication before logging in."
  6294. msgstr ""
  6295. #. type: subsubsection
  6296. #: guix-git/doc/guix.texi:2401
  6297. #, no-wrap
  6298. msgid "Disk Partitioning"
  6299. msgstr ""
  6300. #. type: Plain text
  6301. #: guix-git/doc/guix.texi:2405
  6302. msgid "Unless this has already been done, the next step is to partition, and then format the target partition(s)."
  6303. msgstr ""
  6304. #. type: Plain text
  6305. #: guix-git/doc/guix.texi:2410
  6306. msgid "The installation image includes several partitioning tools, including Parted (@pxref{Overview,,, parted, GNU Parted User Manual}), @command{fdisk}, and @command{cfdisk}. Run it and set up your disk with the partition layout you want:"
  6307. msgstr ""
  6308. #. type: example
  6309. #: guix-git/doc/guix.texi:2413
  6310. #, no-wrap
  6311. msgid "cfdisk\n"
  6312. msgstr ""
  6313. #. type: Plain text
  6314. #: guix-git/doc/guix.texi:2419
  6315. msgid "If your disk uses the GUID Partition Table (GPT) format and you plan to install BIOS-based GRUB (which is the default), make sure a BIOS Boot Partition is available (@pxref{BIOS installation,,, grub, GNU GRUB manual})."
  6316. msgstr ""
  6317. #. type: cindex
  6318. #: guix-git/doc/guix.texi:2420
  6319. #, no-wrap
  6320. msgid "EFI, installation"
  6321. msgstr ""
  6322. #. type: cindex
  6323. #: guix-git/doc/guix.texi:2421
  6324. #, no-wrap
  6325. msgid "UEFI, installation"
  6326. msgstr ""
  6327. #. type: cindex
  6328. #: guix-git/doc/guix.texi:2422
  6329. #, no-wrap
  6330. msgid "ESP, EFI system partition"
  6331. msgstr ""
  6332. #. type: Plain text
  6333. #: guix-git/doc/guix.texi:2426
  6334. msgid "If you instead wish to use EFI-based GRUB, a FAT32 @dfn{EFI System Partition} (ESP) is required. This partition can be mounted at @file{/boot/efi} for instance and must have the @code{esp} flag set. E.g., for @command{parted}:"
  6335. msgstr ""
  6336. #. type: example
  6337. #: guix-git/doc/guix.texi:2429
  6338. #, no-wrap
  6339. msgid "parted /dev/sda set 1 esp on\n"
  6340. msgstr ""
  6341. #. type: vindex
  6342. #: guix-git/doc/guix.texi:2432 guix-git/doc/guix.texi:33182
  6343. #, no-wrap
  6344. msgid "grub-bootloader"
  6345. msgstr ""
  6346. #. type: vindex
  6347. #: guix-git/doc/guix.texi:2433 guix-git/doc/guix.texi:33176
  6348. #, no-wrap
  6349. msgid "grub-efi-bootloader"
  6350. msgstr ""
  6351. #. type: quotation
  6352. #: guix-git/doc/guix.texi:2440
  6353. msgid "Unsure whether to use EFI- or BIOS-based GRUB? If the directory @file{/sys/firmware/efi} exists in the installation image, then you should probably perform an EFI installation, using @code{grub-efi-bootloader}. Otherwise you should use the BIOS-based GRUB, known as @code{grub-bootloader}. @xref{Bootloader Configuration}, for more info on bootloaders."
  6354. msgstr ""
  6355. #. type: Plain text
  6356. #: guix-git/doc/guix.texi:2448
  6357. msgid "Once you are done partitioning the target hard disk drive, you have to create a file system on the relevant partition(s)@footnote{Currently Guix System only supports ext4, btrfs, JFS, and F2FS file systems. In particular, code that reads file system UUIDs and labels only works for these file system types.}. For the ESP, if you have one and assuming it is @file{/dev/sda1}, run:"
  6358. msgstr ""
  6359. #. type: example
  6360. #: guix-git/doc/guix.texi:2451
  6361. #, no-wrap
  6362. msgid "mkfs.fat -F32 /dev/sda1\n"
  6363. msgstr ""
  6364. #. type: Plain text
  6365. #: guix-git/doc/guix.texi:2458
  6366. msgid "For the root file system, ext4 is the most widely used format. Other file systems, such as Btrfs, support compression, which is reported to nicely complement file deduplication that the daemon performs independently of the file system (@pxref{Invoking guix-daemon, deduplication})."
  6367. msgstr ""
  6368. #. type: Plain text
  6369. #: guix-git/doc/guix.texi:2465
  6370. msgid "Preferably, assign file systems a label so that you can easily and reliably refer to them in @code{file-system} declarations (@pxref{File Systems}). This is typically done using the @code{-L} option of @command{mkfs.ext4} and related commands. So, assuming the target root partition lives at @file{/dev/sda2}, a file system with the label @code{my-root} can be created with:"
  6371. msgstr ""
  6372. #. type: example
  6373. #: guix-git/doc/guix.texi:2468
  6374. #, no-wrap
  6375. msgid "mkfs.ext4 -L my-root /dev/sda2\n"
  6376. msgstr ""
  6377. #. type: cindex
  6378. #: guix-git/doc/guix.texi:2470 guix-git/doc/guix.texi:13658
  6379. #, no-wrap
  6380. msgid "encrypted disk"
  6381. msgstr ""
  6382. #. type: Plain text
  6383. #: guix-git/doc/guix.texi:2477
  6384. msgid "If you are instead planning to encrypt the root partition, you can use the Cryptsetup/LUKS utilities to do that (see @inlinefmtifelse{html, @uref{https://linux.die.net/man/8/cryptsetup, @code{man cryptsetup}}, @code{man cryptsetup}} for more information). Assuming you want to store the root partition on @file{/dev/sda2}, the command sequence would be along these lines:"
  6385. msgstr ""
  6386. #. type: example
  6387. #: guix-git/doc/guix.texi:2482
  6388. #, no-wrap
  6389. msgid ""
  6390. "cryptsetup luksFormat /dev/sda2\n"
  6391. "cryptsetup open --type luks /dev/sda2 my-partition\n"
  6392. "mkfs.ext4 -L my-root /dev/mapper/my-partition\n"
  6393. msgstr ""
  6394. #. type: Plain text
  6395. #: guix-git/doc/guix.texi:2487
  6396. msgid "Once that is done, mount the target file system under @file{/mnt} with a command like (again, assuming @code{my-root} is the label of the root file system):"
  6397. msgstr ""
  6398. #. type: example
  6399. #: guix-git/doc/guix.texi:2490
  6400. #, no-wrap
  6401. msgid "mount LABEL=my-root /mnt\n"
  6402. msgstr ""
  6403. #. type: Plain text
  6404. #: guix-git/doc/guix.texi:2496
  6405. msgid "Also mount any other file systems you would like to use on the target system relative to this path. If you have opted for @file{/boot/efi} as an EFI mount point for example, mount it at @file{/mnt/boot/efi} now so it is found by @code{guix system init} afterwards."
  6406. msgstr ""
  6407. #. type: Plain text
  6408. #: guix-git/doc/guix.texi:2501
  6409. msgid "Finally, if you plan to use one or more swap partitions (@pxref{Memory Concepts, swap space,, libc, The GNU C Library Reference Manual}), make sure to initialize them with @command{mkswap}. Assuming you have one swap partition on @file{/dev/sda3}, you would run:"
  6410. msgstr ""
  6411. #. type: example
  6412. #: guix-git/doc/guix.texi:2505
  6413. #, no-wrap
  6414. msgid ""
  6415. "mkswap /dev/sda3\n"
  6416. "swapon /dev/sda3\n"
  6417. msgstr ""
  6418. #. type: Plain text
  6419. #: guix-git/doc/guix.texi:2513
  6420. msgid "Alternatively, you may use a swap file. For example, assuming that in the new system you want to use the file @file{/swapfile} as a swap file, you would run@footnote{This example will work for many types of file systems (e.g., ext4). However, for copy-on-write file systems (e.g., btrfs), the required steps may be different. For details, see the manual pages for @command{mkswap} and @command{swapon}.}:"
  6421. msgstr ""
  6422. #. type: example
  6423. #: guix-git/doc/guix.texi:2521
  6424. #, no-wrap
  6425. msgid ""
  6426. "# This is 10 GiB of swap space. Adjust \"count\" to change the size.\n"
  6427. "dd if=/dev/zero of=/mnt/swapfile bs=1MiB count=10240\n"
  6428. "# For security, make the file readable and writable only by root.\n"
  6429. "chmod 600 /mnt/swapfile\n"
  6430. "mkswap /mnt/swapfile\n"
  6431. "swapon /mnt/swapfile\n"
  6432. msgstr ""
  6433. #. type: Plain text
  6434. #: guix-git/doc/guix.texi:2526
  6435. msgid "Note that if you have encrypted the root partition and created a swap file in its file system as described above, then the encryption also protects the swap file, just like any other file in that file system."
  6436. msgstr ""
  6437. #. type: Plain text
  6438. #: guix-git/doc/guix.texi:2532
  6439. msgid "With the target partitions ready and the target root mounted on @file{/mnt}, we're ready to go. First, run:"
  6440. msgstr ""
  6441. #. type: example
  6442. #: guix-git/doc/guix.texi:2535
  6443. #, no-wrap
  6444. msgid "herd start cow-store /mnt\n"
  6445. msgstr ""
  6446. #. type: Plain text
  6447. #: guix-git/doc/guix.texi:2542
  6448. msgid "This makes @file{/gnu/store} copy-on-write, such that packages added to it during the installation phase are written to the target disk on @file{/mnt} rather than kept in memory. This is necessary because the first phase of the @command{guix system init} command (see below) entails downloads or builds to @file{/gnu/store} which, initially, is an in-memory file system."
  6449. msgstr ""
  6450. #. type: Plain text
  6451. #: guix-git/doc/guix.texi:2553
  6452. msgid "Next, you have to edit a file and provide the declaration of the operating system to be installed. To that end, the installation system comes with three text editors. We recommend GNU nano (@pxref{Top,,, nano, GNU nano Manual}), which supports syntax highlighting and parentheses matching; other editors include mg (an Emacs clone), and nvi (a clone of the original BSD @command{vi} editor). We strongly recommend storing that file on the target root file system, say, as @file{/mnt/etc/config.scm}. Failing to do that, you will have lost your configuration file once you have rebooted into the newly-installed system."
  6453. msgstr ""
  6454. #. type: Plain text
  6455. #: guix-git/doc/guix.texi:2560
  6456. msgid "@xref{Using the Configuration System}, for an overview of the configuration file. The example configurations discussed in that section are available under @file{/etc/configuration} in the installation image. Thus, to get started with a system configuration providing a graphical display server (a ``desktop'' system), you can run something along these lines:"
  6457. msgstr ""
  6458. #. type: example
  6459. #: guix-git/doc/guix.texi:2565
  6460. #, no-wrap
  6461. msgid ""
  6462. "# mkdir /mnt/etc\n"
  6463. "# cp /etc/configuration/desktop.scm /mnt/etc/config.scm\n"
  6464. "# nano /mnt/etc/config.scm\n"
  6465. msgstr ""
  6466. #. type: Plain text
  6467. #: guix-git/doc/guix.texi:2569
  6468. msgid "You should pay attention to what your configuration file contains, and in particular:"
  6469. msgstr ""
  6470. #. type: itemize
  6471. #: guix-git/doc/guix.texi:2580
  6472. msgid "Make sure the @code{bootloader-configuration} form refers to the target you want to install GRUB on. It should mention @code{grub-bootloader} if you are installing GRUB in the legacy way, or @code{grub-efi-bootloader} for newer UEFI systems. For legacy systems, the @code{target} field names a device, like @code{/dev/sda}; for UEFI systems it names a path to a mounted EFI partition, like @code{/boot/efi}; do make sure the path is currently mounted and a @code{file-system} entry is specified in your configuration."
  6473. msgstr ""
  6474. #. type: itemize
  6475. #: guix-git/doc/guix.texi:2586
  6476. msgid "Be sure that your file system labels match the value of their respective @code{device} fields in your @code{file-system} configuration, assuming your @code{file-system} configuration uses the @code{file-system-label} procedure in its @code{device} field."
  6477. msgstr ""
  6478. #. type: itemize
  6479. #: guix-git/doc/guix.texi:2590
  6480. msgid "If there are encrypted or RAID partitions, make sure to add a @code{mapped-devices} field to describe them (@pxref{Mapped Devices})."
  6481. msgstr ""
  6482. #. type: Plain text
  6483. #: guix-git/doc/guix.texi:2595
  6484. msgid "Once you are done preparing the configuration file, the new system must be initialized (remember that the target root file system is mounted under @file{/mnt}):"
  6485. msgstr ""
  6486. #. type: example
  6487. #: guix-git/doc/guix.texi:2598
  6488. #, no-wrap
  6489. msgid "guix system init /mnt/etc/config.scm /mnt\n"
  6490. msgstr ""
  6491. #. type: Plain text
  6492. #: guix-git/doc/guix.texi:2605
  6493. msgid "This copies all the necessary files and installs GRUB on @file{/dev/sdX}, unless you pass the @option{--no-bootloader} option. For more information, @pxref{Invoking guix system}. This command may trigger downloads or builds of missing packages, which can take some time."
  6494. msgstr ""
  6495. #. type: Plain text
  6496. #: guix-git/doc/guix.texi:2613
  6497. msgid "Once that command has completed---and hopefully succeeded!---you can run @command{reboot} and boot into the new system. The @code{root} password in the new system is initially empty; other users' passwords need to be initialized by running the @command{passwd} command as @code{root}, unless your configuration specifies otherwise (@pxref{user-account-password, user account passwords}). @xref{After System Installation}, for what's next!"
  6498. msgstr ""
  6499. #. type: Plain text
  6500. #: guix-git/doc/guix.texi:2620
  6501. msgid "Success, you've now booted into Guix System! From then on, you can update the system whenever you want by running, say:"
  6502. msgstr ""
  6503. #. type: example
  6504. #: guix-git/doc/guix.texi:2624
  6505. #, no-wrap
  6506. msgid ""
  6507. "guix pull\n"
  6508. "sudo guix system reconfigure /etc/config.scm\n"
  6509. msgstr ""
  6510. #. type: Plain text
  6511. #: guix-git/doc/guix.texi:2630
  6512. msgid "This builds a new system generation with the latest packages and services (@pxref{Invoking guix system}). We recommend doing that regularly so that your system includes the latest security updates (@pxref{Security Updates})."
  6513. msgstr ""
  6514. #. type: cindex
  6515. #: guix-git/doc/guix.texi:2633
  6516. #, no-wrap
  6517. msgid "sudo vs. @command{guix pull}"
  6518. msgstr ""
  6519. #. type: quotation
  6520. #: guix-git/doc/guix.texi:2637
  6521. msgid "Note that @command{sudo guix} runs your user's @command{guix} command and @emph{not} root's, because @command{sudo} leaves @env{PATH} unchanged. To explicitly run root's @command{guix}, type @command{sudo -i guix @dots{}}."
  6522. msgstr ""
  6523. #. type: quotation
  6524. #: guix-git/doc/guix.texi:2642
  6525. msgid "The difference matters here, because @command{guix pull} updates the @command{guix} command and package definitions only for the user it is run as. This means that if you choose to use @command{guix system reconfigure} in root's login shell, you'll need to @command{guix pull} separately."
  6526. msgstr ""
  6527. #. type: Plain text
  6528. #: guix-git/doc/guix.texi:2647
  6529. msgid "Now, @pxref{Getting Started}, and join us on @code{#guix} on the Libera Chat IRC network or on @email{guix-devel@@gnu.org} to share your experience!"
  6530. msgstr ""
  6531. #. type: section
  6532. #: guix-git/doc/guix.texi:2650
  6533. #, no-wrap
  6534. msgid "Installing Guix in a Virtual Machine"
  6535. msgstr ""
  6536. #. type: cindex
  6537. #: guix-git/doc/guix.texi:2652
  6538. #, no-wrap
  6539. msgid "virtual machine, Guix System installation"
  6540. msgstr ""
  6541. #. type: cindex
  6542. #: guix-git/doc/guix.texi:2653
  6543. #, no-wrap
  6544. msgid "virtual private server (VPS)"
  6545. msgstr ""
  6546. #. type: cindex
  6547. #: guix-git/doc/guix.texi:2654
  6548. #, no-wrap
  6549. msgid "VPS (virtual private server)"
  6550. msgstr ""
  6551. #. type: Plain text
  6552. #: guix-git/doc/guix.texi:2658
  6553. msgid "If you'd like to install Guix System in a virtual machine (VM) or on a virtual private server (VPS) rather than on your beloved machine, this section is for you."
  6554. msgstr ""
  6555. #. type: Plain text
  6556. #: guix-git/doc/guix.texi:2661
  6557. msgid "To boot a @uref{https://qemu.org/,QEMU} VM for installing Guix System in a disk image, follow these steps:"
  6558. msgstr ""
  6559. #. type: enumerate
  6560. #: guix-git/doc/guix.texi:2666
  6561. msgid "First, retrieve and decompress the Guix system installation image as described previously (@pxref{USB Stick and DVD Installation})."
  6562. msgstr ""
  6563. #. type: enumerate
  6564. #: guix-git/doc/guix.texi:2670
  6565. msgid "Create a disk image that will hold the installed system. To make a qcow2-formatted disk image, use the @command{qemu-img} command:"
  6566. msgstr ""
  6567. #. type: example
  6568. #: guix-git/doc/guix.texi:2673
  6569. #, no-wrap
  6570. msgid "qemu-img create -f qcow2 guix-system.img 50G\n"
  6571. msgstr ""
  6572. #. type: enumerate
  6573. #: guix-git/doc/guix.texi:2677
  6574. msgid "The resulting file will be much smaller than 50 GB (typically less than 1 MB), but it will grow as the virtualized storage device is filled up."
  6575. msgstr ""
  6576. #. type: enumerate
  6577. #: guix-git/doc/guix.texi:2680
  6578. msgid "Boot the USB installation image in an VM:"
  6579. msgstr ""
  6580. #. type: example
  6581. #: guix-git/doc/guix.texi:2686
  6582. #, no-wrap
  6583. msgid ""
  6584. "qemu-system-x86_64 -m 1024 -smp 1 -enable-kvm \\\n"
  6585. " -nic user,model=virtio-net-pci -boot menu=on,order=d \\\n"
  6586. " -drive file=guix-system.img \\\n"
  6587. " -drive media=cdrom,file=guix-system-install-@value{VERSION}.@var{system}.iso\n"
  6588. msgstr ""
  6589. #. type: enumerate
  6590. #: guix-git/doc/guix.texi:2690
  6591. msgid "@code{-enable-kvm} is optional, but significantly improves performance, @pxref{Running Guix in a VM}."
  6592. msgstr ""
  6593. #. type: enumerate
  6594. #: guix-git/doc/guix.texi:2694
  6595. msgid "You're now root in the VM, proceed with the installation process. @xref{Preparing for Installation}, and follow the instructions."
  6596. msgstr ""
  6597. #. type: Plain text
  6598. #: guix-git/doc/guix.texi:2699
  6599. msgid "Once installation is complete, you can boot the system that's on your @file{guix-system.img} image. @xref{Running Guix in a VM}, for how to do that."
  6600. msgstr ""
  6601. #. type: cindex
  6602. #: guix-git/doc/guix.texi:2703
  6603. #, no-wrap
  6604. msgid "installation image"
  6605. msgstr ""
  6606. #. type: Plain text
  6607. #: guix-git/doc/guix.texi:2706
  6608. msgid "The installation image described above was built using the @command{guix system} command, specifically:"
  6609. msgstr ""
  6610. #. type: example
  6611. #: guix-git/doc/guix.texi:2709
  6612. #, no-wrap
  6613. msgid "guix system image -t iso9660 gnu/system/install.scm\n"
  6614. msgstr ""
  6615. #. type: Plain text
  6616. #: guix-git/doc/guix.texi:2714
  6617. msgid "Have a look at @file{gnu/system/install.scm} in the source tree, and see also @ref{Invoking guix system} for more information about the installation image."
  6618. msgstr ""
  6619. #. type: section
  6620. #: guix-git/doc/guix.texi:2715
  6621. #, no-wrap
  6622. msgid "Building the Installation Image for ARM Boards"
  6623. msgstr ""
  6624. #. type: Plain text
  6625. #: guix-git/doc/guix.texi:2719
  6626. msgid "Many ARM boards require a specific variant of the @uref{https://www.denx.de/wiki/U-Boot/, U-Boot} bootloader."
  6627. msgstr ""
  6628. #. type: Plain text
  6629. #: guix-git/doc/guix.texi:2723
  6630. msgid "If you build a disk image and the bootloader is not available otherwise (on another boot drive etc), it's advisable to build an image that includes the bootloader, specifically:"
  6631. msgstr ""
  6632. #. type: example
  6633. #: guix-git/doc/guix.texi:2726
  6634. #, no-wrap
  6635. msgid "guix system image --system=armhf-linux -e '((@@ (gnu system install) os-with-u-boot) (@@ (gnu system install) installation-os) \"A20-OLinuXino-Lime2\")'\n"
  6636. msgstr ""
  6637. #. type: Plain text
  6638. #: guix-git/doc/guix.texi:2730
  6639. msgid "@code{A20-OLinuXino-Lime2} is the name of the board. If you specify an invalid board, a list of possible boards will be printed."
  6640. msgstr ""
  6641. #. type: Plain text
  6642. #: guix-git/doc/guix.texi:2740
  6643. msgid "Presumably, you've reached this section because either you have installed Guix on top of another distribution (@pxref{Installation}), or you've installed the standalone Guix System (@pxref{System Installation}). It's time for you to get started using Guix and this section aims to help you do that and give you a feel of what it's like."
  6644. msgstr ""
  6645. #. type: Plain text
  6646. #: guix-git/doc/guix.texi:2744
  6647. msgid "Guix is about installing software, so probably the first thing you'll want to do is to actually look for software. Let's say you're looking for a text editor, you can run:"
  6648. msgstr ""
  6649. #. type: example
  6650. #: guix-git/doc/guix.texi:2747
  6651. #, no-wrap
  6652. msgid "guix search text editor\n"
  6653. msgstr ""
  6654. #. type: Plain text
  6655. #: guix-git/doc/guix.texi:2754
  6656. msgid "This command shows you a number of matching @dfn{packages}, each time showing the package's name, version, a description, and additional info. Once you've found out the one you want to use, let's say Emacs (ah ha!), you can go ahead and install it (run this command as a regular user, @emph{no need for root privileges}!):"
  6657. msgstr ""
  6658. #. type: example
  6659. #: guix-git/doc/guix.texi:2757
  6660. #, no-wrap
  6661. msgid "guix install emacs\n"
  6662. msgstr ""
  6663. #. type: cindex
  6664. #: guix-git/doc/guix.texi:2759 guix-git/doc/guix.texi:3071
  6665. #: guix-git/doc/guix.texi:3123
  6666. #, no-wrap
  6667. msgid "profile"
  6668. msgstr ""
  6669. #. type: Plain text
  6670. #: guix-git/doc/guix.texi:2767
  6671. msgid "You've installed your first package, congrats! The package is now visible in your default @dfn{profile}, @file{$HOME/.guix-profile}---a profile is a directory containing installed packages. In the process, you've probably noticed that Guix downloaded pre-built binaries; or, if you explicitly chose to @emph{not} use pre-built binaries, then probably Guix is still building software (@pxref{Substitutes}, for more info)."
  6672. msgstr ""
  6673. #. type: Plain text
  6674. #: guix-git/doc/guix.texi:2770
  6675. msgid "Unless you're using Guix System, the @command{guix install} command must have printed this hint:"
  6676. msgstr ""
  6677. #. type: example
  6678. #: guix-git/doc/guix.texi:2773
  6679. #, no-wrap
  6680. msgid ""
  6681. "hint: Consider setting the necessary environment variables by running:\n"
  6682. "\n"
  6683. msgstr ""
  6684. #. type: example
  6685. #: guix-git/doc/guix.texi:2776
  6686. #, no-wrap
  6687. msgid ""
  6688. " GUIX_PROFILE=\"$HOME/.guix-profile\"\n"
  6689. " . \"$GUIX_PROFILE/etc/profile\"\n"
  6690. "\n"
  6691. msgstr ""
  6692. #. type: example
  6693. #: guix-git/doc/guix.texi:2778
  6694. #, no-wrap
  6695. msgid "Alternately, see `guix package --search-paths -p \"$HOME/.guix-profile\"'.\n"
  6696. msgstr ""
  6697. #. type: Plain text
  6698. #: guix-git/doc/guix.texi:2792
  6699. msgid "Indeed, you must now tell your shell where @command{emacs} and other programs installed with Guix are to be found. Pasting the two lines above will do just that: it will add @code{$HOME/.guix-profile/bin}---which is where the installed package is---to the @code{PATH} environment variable. You can paste these two lines in your shell so they take effect right away, but more importantly you should add them to @file{~/.bash_profile} (or equivalent file if you do not use Bash) so that environment variables are set next time you spawn a shell. You only need to do this once and other search paths environment variables will be taken care of similarly---e.g., if you eventually install @code{python} and Python libraries, @code{PYTHONPATH} will be defined."
  6700. msgstr ""
  6701. #. type: Plain text
  6702. #: guix-git/doc/guix.texi:2795
  6703. msgid "You can go on installing packages at your will. To list installed packages, run:"
  6704. msgstr ""
  6705. #. type: example
  6706. #: guix-git/doc/guix.texi:2798
  6707. #, no-wrap
  6708. msgid "guix package --list-installed\n"
  6709. msgstr ""
  6710. #. type: Plain text
  6711. #: guix-git/doc/guix.texi:2803
  6712. msgid "To remove a package, you would unsurprisingly run @command{guix remove}. A distinguishing feature is the ability to @dfn{roll back} any operation you made---installation, removal, upgrade---by simply typing:"
  6713. msgstr ""
  6714. #. type: example
  6715. #: guix-git/doc/guix.texi:2806
  6716. #, no-wrap
  6717. msgid "guix package --roll-back\n"
  6718. msgstr ""
  6719. #. type: Plain text
  6720. #: guix-git/doc/guix.texi:2811
  6721. msgid "This is because each operation is in fact a @dfn{transaction} that creates a new @dfn{generation}. These generations and the difference between them can be displayed by running:"
  6722. msgstr ""
  6723. #. type: example
  6724. #: guix-git/doc/guix.texi:2814
  6725. #, no-wrap
  6726. msgid "guix package --list-generations\n"
  6727. msgstr ""
  6728. #. type: Plain text
  6729. #: guix-git/doc/guix.texi:2817
  6730. msgid "Now you know the basics of package management!"
  6731. msgstr ""
  6732. #. type: quotation
  6733. #: guix-git/doc/guix.texi:2818 guix-git/doc/guix.texi:2877
  6734. #, no-wrap
  6735. msgid "Going further"
  6736. msgstr ""
  6737. #. type: quotation
  6738. #: guix-git/doc/guix.texi:2826
  6739. msgid "@xref{Package Management}, for more about package management. You may like @dfn{declarative} package management with @command{guix package --manifest}, managing separate @dfn{profiles} with @option{--profile}, deleting old generations, collecting garbage, and other nifty features that will come in handy as you become more familiar with Guix. If you are a developer, @pxref{Development} for additional tools. And if you're curious, @pxref{Features}, to peek under the hood."
  6740. msgstr ""
  6741. #. type: Plain text
  6742. #: guix-git/doc/guix.texi:2831
  6743. msgid "Once you've installed a set of packages, you will want to periodically @emph{upgrade} them to the latest and greatest version. To do that, you will first pull the latest revision of Guix and its package collection:"
  6744. msgstr ""
  6745. #. type: Plain text
  6746. #: guix-git/doc/guix.texi:2841
  6747. msgid "The end result is a new @command{guix} command, under @file{~/.config/guix/current/bin}. Unless you're on Guix System, the first time you run @command{guix pull}, be sure to follow the hint that the command prints and, similar to what we saw above, paste these two lines in your terminal and @file{.bash_profile}:"
  6748. msgstr ""
  6749. #. type: example
  6750. #: guix-git/doc/guix.texi:2845
  6751. #, no-wrap
  6752. msgid ""
  6753. "GUIX_PROFILE=\"$HOME/.config/guix/current\"\n"
  6754. ". \"$GUIX_PROFILE/etc/profile\"\n"
  6755. msgstr ""
  6756. #. type: Plain text
  6757. #: guix-git/doc/guix.texi:2849
  6758. msgid "You must also instruct your shell to point to this new @command{guix}:"
  6759. msgstr ""
  6760. #. type: example
  6761. #: guix-git/doc/guix.texi:2852
  6762. #, no-wrap
  6763. msgid "hash guix\n"
  6764. msgstr ""
  6765. #. type: Plain text
  6766. #: guix-git/doc/guix.texi:2856
  6767. msgid "At this point, you're running a brand new Guix. You can thus go ahead and actually upgrade all the packages you previously installed:"
  6768. msgstr ""
  6769. #. type: example
  6770. #: guix-git/doc/guix.texi:2859
  6771. #, no-wrap
  6772. msgid "guix upgrade\n"
  6773. msgstr ""
  6774. #. type: Plain text
  6775. #: guix-git/doc/guix.texi:2865
  6776. msgid "As you run this command, you will see that binaries are downloaded (or perhaps some packages are built), and eventually you end up with the upgraded packages. Should one of these upgraded packages not be to your liking, remember you can always roll back!"
  6777. msgstr ""
  6778. #. type: Plain text
  6779. #: guix-git/doc/guix.texi:2868
  6780. msgid "You can display the exact revision of Guix you're currently using by running:"
  6781. msgstr ""
  6782. #. type: example
  6783. #: guix-git/doc/guix.texi:2871
  6784. #, no-wrap
  6785. msgid "guix describe\n"
  6786. msgstr ""
  6787. #. type: Plain text
  6788. #: guix-git/doc/guix.texi:2876
  6789. msgid "The information it displays is @emph{all it takes to reproduce the exact same Guix}, be it at a different point in time or on a different machine."
  6790. msgstr ""
  6791. #. type: quotation
  6792. #: guix-git/doc/guix.texi:2882
  6793. msgid "@xref{Invoking guix pull}, for more information. @xref{Channels}, on how to specify additional @dfn{channels} to pull packages from, how to replicate Guix, and more. You may also find @command{time-machine} handy (@pxref{Invoking guix time-machine})."
  6794. msgstr ""
  6795. #. type: Plain text
  6796. #: guix-git/doc/guix.texi:2887
  6797. msgid "If you installed Guix System, one of the first things you'll want to do is to upgrade your system. Once you've run @command{guix pull} to get the latest Guix, you can upgrade the system like this:"
  6798. msgstr ""
  6799. #. type: example
  6800. #: guix-git/doc/guix.texi:2890
  6801. #, no-wrap
  6802. msgid "sudo guix system reconfigure /etc/config.scm\n"
  6803. msgstr ""
  6804. #. type: Plain text
  6805. #: guix-git/doc/guix.texi:2899
  6806. msgid "Upon completion, the system runs the latest versions of its software packages. When you eventually reboot, you'll notice a sub-menu in the bootloader that reads ``Old system generations'': it's what allows you to boot @emph{an older generation of your system}, should the latest generation be ``broken'' or otherwise unsatisfying. Just like for packages, you can always @emph{roll back} to a previous generation @emph{of the whole system}:"
  6807. msgstr ""
  6808. #. type: example
  6809. #: guix-git/doc/guix.texi:2902
  6810. #, no-wrap
  6811. msgid "sudo guix system roll-back\n"
  6812. msgstr ""
  6813. #. type: Plain text
  6814. #: guix-git/doc/guix.texi:2909
  6815. msgid "There are many things you'll probably want to tweak on your system: adding new user accounts, adding new system services, fiddling with the configuration of those services, etc. The system configuration is @emph{entirely} described in the @file{/etc/config.scm} file. @xref{Using the Configuration System}, to learn how to change it."
  6816. msgstr ""
  6817. #. type: Plain text
  6818. #: guix-git/doc/guix.texi:2911
  6819. msgid "Now you know enough to get started!"
  6820. msgstr ""
  6821. #. type: quotation
  6822. #: guix-git/doc/guix.texi:2912
  6823. #, no-wrap
  6824. msgid "Resources"
  6825. msgstr ""
  6826. #. type: quotation
  6827. #: guix-git/doc/guix.texi:2915
  6828. msgid "The rest of this manual provides a reference for all things Guix. Here are some additional resources you may find useful:"
  6829. msgstr ""
  6830. #. type: itemize
  6831. #: guix-git/doc/guix.texi:2920
  6832. msgid "@xref{Top,,, guix-cookbook, The GNU Guix Cookbook}, for a list of ``how-to'' style of recipes for a variety of applications."
  6833. msgstr ""
  6834. #. type: itemize
  6835. #: guix-git/doc/guix.texi:2925
  6836. msgid "The @uref{https://guix.gnu.org/guix-refcard.pdf, GNU Guix Reference Card} lists in two pages most of the commands and options you'll ever need."
  6837. msgstr ""
  6838. #. type: itemize
  6839. #: guix-git/doc/guix.texi:2930
  6840. msgid "The web site contains @uref{https://guix.gnu.org/en/videos/, instructional videos} covering topics such as everyday use of Guix, how to get help, and how to become a contributor."
  6841. msgstr ""
  6842. #. type: itemize
  6843. #: guix-git/doc/guix.texi:2934
  6844. msgid "@xref{Documentation}, to learn how to access documentation on your computer."
  6845. msgstr ""
  6846. #. type: quotation
  6847. #: guix-git/doc/guix.texi:2937
  6848. msgid "We hope you will enjoy Guix as much as the community enjoys building it!"
  6849. msgstr ""
  6850. #. type: Plain text
  6851. #: guix-git/doc/guix.texi:2948
  6852. msgid "The purpose of GNU Guix is to allow users to easily install, upgrade, and remove software packages, without having to know about their build procedures or dependencies. Guix also goes beyond this obvious set of features."
  6853. msgstr ""
  6854. #. type: Plain text
  6855. #: guix-git/doc/guix.texi:2956
  6856. msgid "This chapter describes the main features of Guix, as well as the package management tools it provides. Along with the command-line interface described below (@pxref{Invoking guix package, @code{guix package}}), you may also use the Emacs-Guix interface (@pxref{Top,,, emacs-guix, The Emacs-Guix Reference Manual}), after installing @code{emacs-guix} package (run @kbd{M-x guix-help} command to start with it):"
  6857. msgstr ""
  6858. #. type: example
  6859. #: guix-git/doc/guix.texi:2959
  6860. #, no-wrap
  6861. msgid "guix install emacs-guix\n"
  6862. msgstr ""
  6863. #. type: Plain text
  6864. #: guix-git/doc/guix.texi:2980
  6865. msgid "Here we assume you've already made your first steps with Guix (@pxref{Getting Started}) and would like to get an overview about what's going on under the hood."
  6866. msgstr ""
  6867. #. type: Plain text
  6868. #: guix-git/doc/guix.texi:2984
  6869. msgid "When using Guix, each package ends up in the @dfn{package store}, in its own directory---something that resembles @file{/gnu/store/xxx-package-1.2}, where @code{xxx} is a base32 string."
  6870. msgstr ""
  6871. #. type: Plain text
  6872. #: guix-git/doc/guix.texi:2989
  6873. msgid "Instead of referring to these directories, users have their own @dfn{profile}, which points to the packages that they actually want to use. These profiles are stored within each user's home directory, at @code{$HOME/.guix-profile}."
  6874. msgstr ""
  6875. #. type: Plain text
  6876. #: guix-git/doc/guix.texi:2997
  6877. msgid "For example, @code{alice} installs GCC 4.7.2. As a result, @file{/home/alice/.guix-profile/bin/gcc} points to @file{/gnu/store/@dots{}-gcc-4.7.2/bin/gcc}. Now, on the same machine, @code{bob} had already installed GCC 4.8.0. The profile of @code{bob} simply continues to point to @file{/gnu/store/@dots{}-gcc-4.8.0/bin/gcc}---i.e., both versions of GCC coexist on the same system without any interference."
  6878. msgstr ""
  6879. #. type: Plain text
  6880. #: guix-git/doc/guix.texi:3001
  6881. msgid "The @command{guix package} command is the central tool to manage packages (@pxref{Invoking guix package}). It operates on the per-user profiles, and can be used @emph{with normal user privileges}."
  6882. msgstr ""
  6883. #. type: cindex
  6884. #: guix-git/doc/guix.texi:3002 guix-git/doc/guix.texi:3085
  6885. #, no-wrap
  6886. msgid "transactions"
  6887. msgstr ""
  6888. #. type: Plain text
  6889. #: guix-git/doc/guix.texi:3009
  6890. msgid "The command provides the obvious install, remove, and upgrade operations. Each invocation is actually a @emph{transaction}: either the specified operation succeeds, or nothing happens. Thus, if the @command{guix package} process is terminated during the transaction, or if a power outage occurs during the transaction, then the user's profile remains in its previous state, and remains usable."
  6891. msgstr ""
  6892. #. type: Plain text
  6893. #: guix-git/doc/guix.texi:3017
  6894. msgid "In addition, any package transaction may be @emph{rolled back}. So, if, for example, an upgrade installs a new version of a package that turns out to have a serious bug, users may roll back to the previous instance of their profile, which was known to work well. Similarly, the global system configuration on Guix is subject to transactional upgrades and roll-back (@pxref{Using the Configuration System})."
  6895. msgstr ""
  6896. #. type: Plain text
  6897. #: guix-git/doc/guix.texi:3024
  6898. msgid "All packages in the package store may be @emph{garbage-collected}. Guix can determine which packages are still referenced by user profiles, and remove those that are provably no longer referenced (@pxref{Invoking guix gc}). Users may also explicitly remove old generations of their profile so that the packages they refer to can be collected."
  6899. msgstr ""
  6900. #. type: Plain text
  6901. #: guix-git/doc/guix.texi:3037
  6902. msgid "Guix takes a @dfn{purely functional} approach to package management, as described in the introduction (@pxref{Introduction}). Each @file{/gnu/store} package directory name contains a hash of all the inputs that were used to build that package---compiler, libraries, build scripts, etc. This direct correspondence allows users to make sure a given package installation matches the current state of their distribution. It also helps maximize @dfn{build reproducibility}: thanks to the isolated build environments that are used, a given build is likely to yield bit-identical files when performed on different machines (@pxref{Invoking guix-daemon, container})."
  6903. msgstr ""
  6904. #. type: Plain text
  6905. #: guix-git/doc/guix.texi:3048
  6906. msgid "This foundation allows Guix to support @dfn{transparent binary/source deployment}. When a pre-built binary for a @file{/gnu/store} item is available from an external source---a @dfn{substitute}, Guix just downloads it and unpacks it; otherwise, it builds the package from source, locally (@pxref{Substitutes}). Because build results are usually bit-for-bit reproducible, users do not have to trust servers that provide substitutes: they can force a local build and @emph{challenge} providers (@pxref{Invoking guix challenge})."
  6907. msgstr ""
  6908. #. type: Plain text
  6909. #: guix-git/doc/guix.texi:3054
  6910. msgid "Control over the build environment is a feature that is also useful for developers. The @command{guix environment} command allows developers of a package to quickly set up the right development environment for their package, without having to manually install the dependencies of the package into their profile (@pxref{Invoking guix environment})."
  6911. msgstr ""
  6912. #. type: cindex
  6913. #: guix-git/doc/guix.texi:3055
  6914. #, no-wrap
  6915. msgid "replication, of software environments"
  6916. msgstr ""
  6917. #. type: cindex
  6918. #: guix-git/doc/guix.texi:3056
  6919. #, no-wrap
  6920. msgid "provenance tracking, of software artifacts"
  6921. msgstr ""
  6922. #. type: Plain text
  6923. #: guix-git/doc/guix.texi:3063
  6924. msgid "All of Guix and its package definitions is version-controlled, and @command{guix pull} allows you to ``travel in time'' on the history of Guix itself (@pxref{Invoking guix pull}). This makes it possible to replicate a Guix instance on a different machine or at a later point in time, which in turn allows you to @emph{replicate complete software environments}, while retaining precise @dfn{provenance tracking} of the software."
  6925. msgstr ""
  6926. #. type: section
  6927. #: guix-git/doc/guix.texi:3065
  6928. #, no-wrap
  6929. msgid "Invoking @command{guix package}"
  6930. msgstr ""
  6931. #. type: cindex
  6932. #: guix-git/doc/guix.texi:3067
  6933. #, no-wrap
  6934. msgid "installing packages"
  6935. msgstr ""
  6936. #. type: cindex
  6937. #: guix-git/doc/guix.texi:3068
  6938. #, no-wrap
  6939. msgid "removing packages"
  6940. msgstr ""
  6941. #. type: cindex
  6942. #: guix-git/doc/guix.texi:3069
  6943. #, no-wrap
  6944. msgid "package installation"
  6945. msgstr ""
  6946. #. type: cindex
  6947. #: guix-git/doc/guix.texi:3070
  6948. #, no-wrap
  6949. msgid "package removal"
  6950. msgstr ""
  6951. #. type: Plain text
  6952. #: guix-git/doc/guix.texi:3080
  6953. msgid "The @command{guix package} command is the tool that allows users to install, upgrade, and remove packages, as well as rolling back to previous configurations. These operations work on a user @dfn{profile}---a directory of installed packages. Each user has a default profile in @file{$HOME/.guix-profile}. The command operates only on the user's own profile, and works with normal user privileges (@pxref{Features}). Its syntax is:"
  6954. msgstr ""
  6955. #. type: example
  6956. #: guix-git/doc/guix.texi:3083
  6957. #, no-wrap
  6958. msgid "guix package @var{options}\n"
  6959. msgstr ""
  6960. #. type: Plain text
  6961. #: guix-git/doc/guix.texi:3090
  6962. msgid "Primarily, @var{options} specifies the operations to be performed during the transaction. Upon completion, a new profile is created, but previous @dfn{generations} of the profile remain available, should the user want to roll back."
  6963. msgstr ""
  6964. #. type: Plain text
  6965. #: guix-git/doc/guix.texi:3093
  6966. msgid "For example, to remove @code{lua} and install @code{guile} and @code{guile-cairo} in a single transaction:"
  6967. msgstr ""
  6968. #. type: example
  6969. #: guix-git/doc/guix.texi:3096
  6970. #, no-wrap
  6971. msgid "guix package -r lua -i guile guile-cairo\n"
  6972. msgstr ""
  6973. #. type: cindex
  6974. #: guix-git/doc/guix.texi:3098
  6975. #, no-wrap
  6976. msgid "aliases, for @command{guix package}"
  6977. msgstr ""
  6978. #. type: Plain text
  6979. #: guix-git/doc/guix.texi:3100
  6980. msgid "For your convenience, we also provide the following aliases:"
  6981. msgstr ""
  6982. #. type: itemize
  6983. #: guix-git/doc/guix.texi:3104
  6984. msgid "@command{guix search} is an alias for @command{guix package -s},"
  6985. msgstr ""
  6986. #. type: itemize
  6987. #: guix-git/doc/guix.texi:3106
  6988. msgid "@command{guix install} is an alias for @command{guix package -i},"
  6989. msgstr ""
  6990. #. type: itemize
  6991. #: guix-git/doc/guix.texi:3108
  6992. msgid "@command{guix remove} is an alias for @command{guix package -r},"
  6993. msgstr ""
  6994. #. type: itemize
  6995. #: guix-git/doc/guix.texi:3110
  6996. msgid "@command{guix upgrade} is an alias for @command{guix package -u},"
  6997. msgstr ""
  6998. #. type: itemize
  6999. #: guix-git/doc/guix.texi:3112
  7000. msgid "and @command{guix show} is an alias for @command{guix package --show=}."
  7001. msgstr ""
  7002. #. type: Plain text
  7003. #: guix-git/doc/guix.texi:3117
  7004. msgid "These aliases are less expressive than @command{guix package} and provide fewer options, so in some cases you'll probably want to use @command{guix package} directly."
  7005. msgstr ""
  7006. #. type: Plain text
  7007. #: guix-git/doc/guix.texi:3122
  7008. msgid "@command{guix package} also supports a @dfn{declarative approach} whereby the user specifies the exact set of packages to be available and passes it @i{via} the @option{--manifest} option (@pxref{profile-manifest, @option{--manifest}})."
  7009. msgstr ""
  7010. #. type: Plain text
  7011. #: guix-git/doc/guix.texi:3129
  7012. msgid "For each user, a symlink to the user's default profile is automatically created in @file{$HOME/.guix-profile}. This symlink always points to the current generation of the user's default profile. Thus, users can add @file{$HOME/.guix-profile/bin} to their @env{PATH} environment variable, and so on."
  7013. msgstr ""
  7014. #. type: cindex
  7015. #: guix-git/doc/guix.texi:3129 guix-git/doc/guix.texi:3362
  7016. #, no-wrap
  7017. msgid "search paths"
  7018. msgstr ""
  7019. #. type: Plain text
  7020. #: guix-git/doc/guix.texi:3134
  7021. msgid "If you are not using Guix System, consider adding the following lines to your @file{~/.bash_profile} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}) so that newly-spawned shells get all the right environment variable definitions:"
  7022. msgstr ""
  7023. #. type: example
  7024. #: guix-git/doc/guix.texi:3138
  7025. #, no-wrap
  7026. msgid ""
  7027. "GUIX_PROFILE=\"$HOME/.guix-profile\" ; \\\n"
  7028. "source \"$GUIX_PROFILE/etc/profile\"\n"
  7029. msgstr ""
  7030. #. type: Plain text
  7031. #: guix-git/doc/guix.texi:3149
  7032. msgid "In a multi-user setup, user profiles are stored in a place registered as a @dfn{garbage-collector root}, which @file{$HOME/.guix-profile} points to (@pxref{Invoking guix gc}). That directory is normally @code{@var{localstatedir}/guix/profiles/per-user/@var{user}}, where @var{localstatedir} is the value passed to @code{configure} as @option{--localstatedir}, and @var{user} is the user name. The @file{per-user} directory is created when @command{guix-daemon} is started, and the @var{user} sub-directory is created by @command{guix package}."
  7033. msgstr ""
  7034. #. type: Plain text
  7035. #: guix-git/doc/guix.texi:3151
  7036. msgid "The @var{options} can be among the following:"
  7037. msgstr ""
  7038. #. type: item
  7039. #: guix-git/doc/guix.texi:3154
  7040. #, no-wrap
  7041. msgid "--install=@var{package} @dots{}"
  7042. msgstr ""
  7043. #. type: itemx
  7044. #: guix-git/doc/guix.texi:3155
  7045. #, no-wrap
  7046. msgid "-i @var{package} @dots{}"
  7047. msgstr ""
  7048. #. type: table
  7049. #: guix-git/doc/guix.texi:3157
  7050. msgid "Install the specified @var{package}s."
  7051. msgstr ""
  7052. #. type: table
  7053. #: guix-git/doc/guix.texi:3162
  7054. msgid "Each @var{package} may specify either a simple package name, such as @code{guile}, or a package name followed by an at-sign and version number, such as @code{guile@@1.8.8} or simply @code{guile@@1.8} (in the latter case, the newest version prefixed by @code{1.8} is selected)."
  7055. msgstr ""
  7056. #. type: table
  7057. #: guix-git/doc/guix.texi:3170
  7058. msgid "If no version number is specified, the newest available version will be selected. In addition, @var{package} may contain a colon, followed by the name of one of the outputs of the package, as in @code{gcc:doc} or @code{binutils@@2.22:lib} (@pxref{Packages with Multiple Outputs}). Packages with a corresponding name (and optionally version) are searched for among the GNU distribution modules (@pxref{Package Modules})."
  7059. msgstr ""
  7060. #. type: cindex
  7061. #: guix-git/doc/guix.texi:3171
  7062. #, no-wrap
  7063. msgid "propagated inputs"
  7064. msgstr ""
  7065. #. type: table
  7066. #: guix-git/doc/guix.texi:3177
  7067. msgid "Sometimes packages have @dfn{propagated inputs}: these are dependencies that automatically get installed along with the required package (@pxref{package-propagated-inputs, @code{propagated-inputs} in @code{package} objects}, for information about propagated inputs in package definitions)."
  7068. msgstr ""
  7069. #. type: anchor{#1}
  7070. #: guix-git/doc/guix.texi:3184
  7071. msgid "package-cmd-propagated-inputs"
  7072. msgstr ""
  7073. #. type: table
  7074. #: guix-git/doc/guix.texi:3184
  7075. msgid "An example is the GNU MPC library: its C header files refer to those of the GNU MPFR library, which in turn refer to those of the GMP library. Thus, when installing MPC, the MPFR and GMP libraries also get installed in the profile; removing MPC also removes MPFR and GMP---unless they had also been explicitly installed by the user."
  7076. msgstr ""
  7077. #. type: table
  7078. #: guix-git/doc/guix.texi:3189
  7079. msgid "Besides, packages sometimes rely on the definition of environment variables for their search paths (see explanation of @option{--search-paths} below). Any missing or possibly incorrect environment variable definitions are reported here."
  7080. msgstr ""
  7081. #. type: item
  7082. #: guix-git/doc/guix.texi:3190
  7083. #, no-wrap
  7084. msgid "--install-from-expression=@var{exp}"
  7085. msgstr ""
  7086. #. type: itemx
  7087. #: guix-git/doc/guix.texi:3191
  7088. #, no-wrap
  7089. msgid "-e @var{exp}"
  7090. msgstr ""
  7091. #. type: table
  7092. #: guix-git/doc/guix.texi:3193
  7093. msgid "Install the package @var{exp} evaluates to."
  7094. msgstr ""
  7095. #. type: table
  7096. #: guix-git/doc/guix.texi:3198
  7097. msgid "@var{exp} must be a Scheme expression that evaluates to a @code{<package>} object. This option is notably useful to disambiguate between same-named variants of a package, with expressions such as @code{(@@ (gnu packages base) guile-final)}."
  7098. msgstr ""
  7099. #. type: table
  7100. #: guix-git/doc/guix.texi:3202
  7101. msgid "Note that this option installs the first output of the specified package, which may be insufficient when needing a specific output of a multiple-output package."
  7102. msgstr ""
  7103. #. type: item
  7104. #: guix-git/doc/guix.texi:3203
  7105. #, no-wrap
  7106. msgid "--install-from-file=@var{file}"
  7107. msgstr ""
  7108. #. type: itemx
  7109. #: guix-git/doc/guix.texi:3204 guix-git/doc/guix.texi:10758
  7110. #, no-wrap
  7111. msgid "-f @var{file}"
  7112. msgstr ""
  7113. #. type: table
  7114. #: guix-git/doc/guix.texi:3206
  7115. msgid "Install the package that the code within @var{file} evaluates to."
  7116. msgstr ""
  7117. #. type: table
  7118. #: guix-git/doc/guix.texi:3209 guix-git/doc/guix.texi:5741
  7119. msgid "As an example, @var{file} might contain a definition like this (@pxref{Defining Packages}):"
  7120. msgstr ""
  7121. #. type: include
  7122. #: guix-git/doc/guix.texi:3211 guix-git/doc/guix.texi:10766
  7123. #, no-wrap
  7124. msgid "package-hello.scm"
  7125. msgstr ""
  7126. #. type: table
  7127. #: guix-git/doc/guix.texi:3218
  7128. msgid "Developers may find it useful to include such a @file{guix.scm} file in the root of their project source tree that can be used to test development snapshots and create reproducible development environments (@pxref{Invoking guix environment})."
  7129. msgstr ""
  7130. #. type: table
  7131. #: guix-git/doc/guix.texi:3223
  7132. msgid "The @var{file} may also contain a JSON representation of one or more package definitions. Running @code{guix package -f} on @file{hello.json} with the following contents would result in installing the package @code{greeter} after building @code{myhello}:"
  7133. msgstr ""
  7134. #. type: example
  7135. #: guix-git/doc/guix.texi:3226 guix-git/doc/guix.texi:10776
  7136. #, no-wrap
  7137. msgid "@verbatiminclude package-hello.json\n"
  7138. msgstr ""
  7139. #. type: item
  7140. #: guix-git/doc/guix.texi:3228
  7141. #, no-wrap
  7142. msgid "--remove=@var{package} @dots{}"
  7143. msgstr ""
  7144. #. type: itemx
  7145. #: guix-git/doc/guix.texi:3229
  7146. #, no-wrap
  7147. msgid "-r @var{package} @dots{}"
  7148. msgstr ""
  7149. #. type: table
  7150. #: guix-git/doc/guix.texi:3231
  7151. msgid "Remove the specified @var{package}s."
  7152. msgstr ""
  7153. #. type: table
  7154. #: guix-git/doc/guix.texi:3236
  7155. msgid "As for @option{--install}, each @var{package} may specify a version number and/or output name in addition to the package name. For instance, @samp{-r glibc:debug} would remove the @code{debug} output of @code{glibc}."
  7156. msgstr ""
  7157. #. type: item
  7158. #: guix-git/doc/guix.texi:3237
  7159. #, no-wrap
  7160. msgid "--upgrade[=@var{regexp} @dots{}]"
  7161. msgstr ""
  7162. #. type: itemx
  7163. #: guix-git/doc/guix.texi:3238
  7164. #, no-wrap
  7165. msgid "-u [@var{regexp} @dots{}]"
  7166. msgstr ""
  7167. #. type: cindex
  7168. #: guix-git/doc/guix.texi:3239
  7169. #, no-wrap
  7170. msgid "upgrading packages"
  7171. msgstr ""
  7172. #. type: table
  7173. #: guix-git/doc/guix.texi:3243
  7174. msgid "Upgrade all the installed packages. If one or more @var{regexp}s are specified, upgrade only installed packages whose name matches a @var{regexp}. Also see the @option{--do-not-upgrade} option below."
  7175. msgstr ""
  7176. #. type: table
  7177. #: guix-git/doc/guix.texi:3248
  7178. msgid "Note that this upgrades package to the latest version of packages found in the distribution currently installed. To update your distribution, you should regularly run @command{guix pull} (@pxref{Invoking guix pull})."
  7179. msgstr ""
  7180. #. type: cindex
  7181. #: guix-git/doc/guix.texi:3249
  7182. #, no-wrap
  7183. msgid "package transformations, upgrades"
  7184. msgstr ""
  7185. #. type: table
  7186. #: guix-git/doc/guix.texi:3254
  7187. msgid "When upgrading, package transformations that were originally applied when creating the profile are automatically re-applied (@pxref{Package Transformation Options}). For example, assume you first installed Emacs from the tip of its development branch with:"
  7188. msgstr ""
  7189. #. type: example
  7190. #: guix-git/doc/guix.texi:3257
  7191. #, no-wrap
  7192. msgid "guix install emacs-next --with-branch=emacs-next=master\n"
  7193. msgstr ""
  7194. #. type: table
  7195. #: guix-git/doc/guix.texi:3262
  7196. msgid "Next time you run @command{guix upgrade}, Guix will again pull the tip of the Emacs development branch and build @code{emacs-next} from that checkout."
  7197. msgstr ""
  7198. #. type: table
  7199. #: guix-git/doc/guix.texi:3267
  7200. msgid "Note that transformation options such as @option{--with-branch} and @option{--with-source} depend on external state; it is up to you to ensure that they work as expected. You can also discard a transformations that apply to a package by running:"
  7201. msgstr ""
  7202. #. type: example
  7203. #: guix-git/doc/guix.texi:3270
  7204. #, no-wrap
  7205. msgid "guix install @var{package}\n"
  7206. msgstr ""
  7207. #. type: item
  7208. #: guix-git/doc/guix.texi:3272
  7209. #, no-wrap
  7210. msgid "--do-not-upgrade[=@var{regexp} @dots{}]"
  7211. msgstr ""
  7212. #. type: table
  7213. #: guix-git/doc/guix.texi:3277
  7214. msgid "When used together with the @option{--upgrade} option, do @emph{not} upgrade any packages whose name matches a @var{regexp}. For example, to upgrade all packages in the current profile except those containing the substring ``emacs'':"
  7215. msgstr ""
  7216. #. type: example
  7217. #: guix-git/doc/guix.texi:3280
  7218. #, no-wrap
  7219. msgid "$ guix package --upgrade . --do-not-upgrade emacs\n"
  7220. msgstr ""
  7221. #. type: anchor{#1}
  7222. #: guix-git/doc/guix.texi:3282
  7223. #, no-wrap
  7224. msgid "profile-manifest"
  7225. msgstr ""
  7226. #. type: item
  7227. #: guix-git/doc/guix.texi:3282 guix-git/doc/guix.texi:5746
  7228. #: guix-git/doc/guix.texi:6194 guix-git/doc/guix.texi:11870
  7229. #: guix-git/doc/guix.texi:13319
  7230. #, no-wrap
  7231. msgid "--manifest=@var{file}"
  7232. msgstr ""
  7233. #. type: itemx
  7234. #: guix-git/doc/guix.texi:3283 guix-git/doc/guix.texi:5747
  7235. #: guix-git/doc/guix.texi:6195 guix-git/doc/guix.texi:11871
  7236. #, no-wrap
  7237. msgid "-m @var{file}"
  7238. msgstr ""
  7239. #. type: cindex
  7240. #: guix-git/doc/guix.texi:3284
  7241. #, no-wrap
  7242. msgid "profile declaration"
  7243. msgstr ""
  7244. #. type: cindex
  7245. #: guix-git/doc/guix.texi:3285
  7246. #, no-wrap
  7247. msgid "profile manifest"
  7248. msgstr ""
  7249. #. type: table
  7250. #: guix-git/doc/guix.texi:3289
  7251. msgid "Create a new generation of the profile from the manifest object returned by the Scheme code in @var{file}. This option can be repeated several times, in which case the manifests are concatenated."
  7252. msgstr ""
  7253. #. type: table
  7254. #: guix-git/doc/guix.texi:3295
  7255. msgid "This allows you to @emph{declare} the profile's contents rather than constructing it through a sequence of @option{--install} and similar commands. The advantage is that @var{file} can be put under version control, copied to different machines to reproduce the same profile, and so on."
  7256. msgstr ""
  7257. #. type: table
  7258. #: guix-git/doc/guix.texi:3299
  7259. msgid "@var{file} must return a @dfn{manifest} object, which is roughly a list of packages:"
  7260. msgstr ""
  7261. #. type: findex
  7262. #: guix-git/doc/guix.texi:3300
  7263. #, no-wrap
  7264. msgid "packages->manifest"
  7265. msgstr ""
  7266. #. type: lisp
  7267. #: guix-git/doc/guix.texi:3303
  7268. #, no-wrap
  7269. msgid ""
  7270. "(use-package-modules guile emacs)\n"
  7271. "\n"
  7272. msgstr ""
  7273. #. type: lisp
  7274. #: guix-git/doc/guix.texi:3309
  7275. #, no-wrap
  7276. msgid ""
  7277. "(packages->manifest\n"
  7278. " (list emacs\n"
  7279. " guile-2.0\n"
  7280. " ;; Use a specific package output.\n"
  7281. " (list guile-2.0 \"debug\")))\n"
  7282. msgstr ""
  7283. #. type: findex
  7284. #: guix-git/doc/guix.texi:3311
  7285. #, no-wrap
  7286. msgid "specifications->manifest"
  7287. msgstr ""
  7288. #. type: table
  7289. #: guix-git/doc/guix.texi:3318
  7290. msgid "In this example we have to know which modules define the @code{emacs} and @code{guile-2.0} variables to provide the right @code{use-package-modules} line, which can be cumbersome. We can instead provide regular package specifications and let @code{specifications->manifest} look up the corresponding package objects, like this:"
  7291. msgstr ""
  7292. #. type: lisp
  7293. #: guix-git/doc/guix.texi:3322
  7294. #, no-wrap
  7295. msgid ""
  7296. "(specifications->manifest\n"
  7297. " '(\"emacs\" \"guile@@2.2\" \"guile@@2.2:debug\"))\n"
  7298. msgstr ""
  7299. #. type: table
  7300. #: guix-git/doc/guix.texi:3326
  7301. msgid "@xref{export-manifest, @option{--export-manifest}}, to learn how to obtain a manifest file from an existing profile."
  7302. msgstr ""
  7303. #. type: item
  7304. #: guix-git/doc/guix.texi:3327 guix-git/doc/guix.texi:4434
  7305. #, no-wrap
  7306. msgid "--roll-back"
  7307. msgstr ""
  7308. #. type: cindex
  7309. #: guix-git/doc/guix.texi:3328 guix-git/doc/guix.texi:4435
  7310. #: guix-git/doc/guix.texi:33604
  7311. #, no-wrap
  7312. msgid "rolling back"
  7313. msgstr ""
  7314. #. type: cindex
  7315. #: guix-git/doc/guix.texi:3329 guix-git/doc/guix.texi:4436
  7316. #, no-wrap
  7317. msgid "undoing transactions"
  7318. msgstr ""
  7319. #. type: cindex
  7320. #: guix-git/doc/guix.texi:3330 guix-git/doc/guix.texi:4437
  7321. #, no-wrap
  7322. msgid "transactions, undoing"
  7323. msgstr ""
  7324. #. type: table
  7325. #: guix-git/doc/guix.texi:3333
  7326. msgid "Roll back to the previous @dfn{generation} of the profile---i.e., undo the last transaction."
  7327. msgstr ""
  7328. #. type: table
  7329. #: guix-git/doc/guix.texi:3336
  7330. msgid "When combined with options such as @option{--install}, roll back occurs before any other actions."
  7331. msgstr ""
  7332. #. type: table
  7333. #: guix-git/doc/guix.texi:3340
  7334. msgid "When rolling back from the first generation that actually contains installed packages, the profile is made to point to the @dfn{zeroth generation}, which contains no files apart from its own metadata."
  7335. msgstr ""
  7336. #. type: table
  7337. #: guix-git/doc/guix.texi:3344
  7338. msgid "After having rolled back, installing, removing, or upgrading packages overwrites previous future generations. Thus, the history of the generations in a profile is always linear."
  7339. msgstr ""
  7340. #. type: item
  7341. #: guix-git/doc/guix.texi:3345 guix-git/doc/guix.texi:4441
  7342. #, no-wrap
  7343. msgid "--switch-generation=@var{pattern}"
  7344. msgstr ""
  7345. #. type: itemx
  7346. #: guix-git/doc/guix.texi:3346 guix-git/doc/guix.texi:4442
  7347. #, no-wrap
  7348. msgid "-S @var{pattern}"
  7349. msgstr ""
  7350. #. type: cindex
  7351. #: guix-git/doc/guix.texi:3347 guix-git/doc/guix.texi:3577
  7352. #: guix-git/doc/guix.texi:4443 guix-git/doc/guix.texi:33562
  7353. #, no-wrap
  7354. msgid "generations"
  7355. msgstr ""
  7356. #. type: table
  7357. #: guix-git/doc/guix.texi:3349 guix-git/doc/guix.texi:4445
  7358. msgid "Switch to a particular generation defined by @var{pattern}."
  7359. msgstr ""
  7360. #. type: table
  7361. #: guix-git/doc/guix.texi:3355 guix-git/doc/guix.texi:4451
  7362. msgid "@var{pattern} may be either a generation number or a number prefixed with ``+'' or ``-''. The latter means: move forward/backward by a specified number of generations. For example, if you want to return to the latest generation after @option{--roll-back}, use @option{--switch-generation=+1}."
  7363. msgstr ""
  7364. #. type: table
  7365. #: guix-git/doc/guix.texi:3360
  7366. msgid "The difference between @option{--roll-back} and @option{--switch-generation=-1} is that @option{--switch-generation} will not make a zeroth generation, so if a specified generation does not exist, the current generation will not be changed."
  7367. msgstr ""
  7368. #. type: item
  7369. #: guix-git/doc/guix.texi:3361
  7370. #, no-wrap
  7371. msgid "--search-paths[=@var{kind}]"
  7372. msgstr ""
  7373. #. type: table
  7374. #: guix-git/doc/guix.texi:3367
  7375. msgid "Report environment variable definitions, in Bash syntax, that may be needed in order to use the set of installed packages. These environment variables are used to specify @dfn{search paths} for files used by some of the installed packages."
  7376. msgstr ""
  7377. #. type: table
  7378. #: guix-git/doc/guix.texi:3375
  7379. msgid "For example, GCC needs the @env{CPATH} and @env{LIBRARY_PATH} environment variables to be defined so it can look for headers and libraries in the user's profile (@pxref{Environment Variables,,, gcc, Using the GNU Compiler Collection (GCC)}). If GCC and, say, the C library are installed in the profile, then @option{--search-paths} will suggest setting these variables to @file{@var{profile}/include} and @file{@var{profile}/lib}, respectively."
  7380. msgstr ""
  7381. #. type: table
  7382. #: guix-git/doc/guix.texi:3378
  7383. msgid "The typical use case is to define these environment variables in the shell:"
  7384. msgstr ""
  7385. #. type: example
  7386. #: guix-git/doc/guix.texi:3381
  7387. #, no-wrap
  7388. msgid "$ eval `guix package --search-paths`\n"
  7389. msgstr ""
  7390. #. type: table
  7391. #: guix-git/doc/guix.texi:3387
  7392. msgid "@var{kind} may be one of @code{exact}, @code{prefix}, or @code{suffix}, meaning that the returned environment variable definitions will either be exact settings, or prefixes or suffixes of the current value of these variables. When omitted, @var{kind} defaults to @code{exact}."
  7393. msgstr ""
  7394. #. type: table
  7395. #: guix-git/doc/guix.texi:3390
  7396. msgid "This option can also be used to compute the @emph{combined} search paths of several profiles. Consider this example:"
  7397. msgstr ""
  7398. #. type: example
  7399. #: guix-git/doc/guix.texi:3395
  7400. #, no-wrap
  7401. msgid ""
  7402. "$ guix package -p foo -i guile\n"
  7403. "$ guix package -p bar -i guile-json\n"
  7404. "$ guix package -p foo -p bar --search-paths\n"
  7405. msgstr ""
  7406. #. type: table
  7407. #: guix-git/doc/guix.texi:3400
  7408. msgid "The last command above reports about the @env{GUILE_LOAD_PATH} variable, even though, taken individually, neither @file{foo} nor @file{bar} would lead to that recommendation."
  7409. msgstr ""
  7410. #. type: cindex
  7411. #: guix-git/doc/guix.texi:3402
  7412. #, no-wrap
  7413. msgid "profile, choosing"
  7414. msgstr ""
  7415. #. type: item
  7416. #: guix-git/doc/guix.texi:3403 guix-git/doc/guix.texi:4471
  7417. #: guix-git/doc/guix.texi:4800
  7418. #, no-wrap
  7419. msgid "--profile=@var{profile}"
  7420. msgstr ""
  7421. #. type: itemx
  7422. #: guix-git/doc/guix.texi:3404 guix-git/doc/guix.texi:4472
  7423. #: guix-git/doc/guix.texi:4801
  7424. #, no-wrap
  7425. msgid "-p @var{profile}"
  7426. msgstr ""
  7427. #. type: table
  7428. #: guix-git/doc/guix.texi:3406
  7429. msgid "Use @var{profile} instead of the user's default profile."
  7430. msgstr ""
  7431. #. type: table
  7432. #: guix-git/doc/guix.texi:3411
  7433. msgid "@var{profile} must be the name of a file that will be created upon completion. Concretely, @var{profile} will be a mere symbolic link (``symlink'') pointing to the actual profile where packages are installed:"
  7434. msgstr ""
  7435. #. type: example
  7436. #: guix-git/doc/guix.texi:3417
  7437. #, no-wrap
  7438. msgid ""
  7439. "$ guix install hello -p ~/code/my-profile\n"
  7440. "@dots{}\n"
  7441. "$ ~/code/my-profile/bin/hello\n"
  7442. "Hello, world!\n"
  7443. msgstr ""
  7444. #. type: table
  7445. #: guix-git/doc/guix.texi:3421
  7446. msgid "All it takes to get rid of the profile is to remove this symlink and its siblings that point to specific generations:"
  7447. msgstr ""
  7448. #. type: example
  7449. #: guix-git/doc/guix.texi:3424
  7450. #, no-wrap
  7451. msgid "$ rm ~/code/my-profile ~/code/my-profile-*-link\n"
  7452. msgstr ""
  7453. #. type: item
  7454. #: guix-git/doc/guix.texi:3426
  7455. #, no-wrap
  7456. msgid "--list-profiles"
  7457. msgstr ""
  7458. #. type: table
  7459. #: guix-git/doc/guix.texi:3428
  7460. msgid "List all the user's profiles:"
  7461. msgstr ""
  7462. #. type: example
  7463. #: guix-git/doc/guix.texi:3435
  7464. #, no-wrap
  7465. msgid ""
  7466. "$ guix package --list-profiles\n"
  7467. "/home/charlie/.guix-profile\n"
  7468. "/home/charlie/code/my-profile\n"
  7469. "/home/charlie/code/devel-profile\n"
  7470. "/home/charlie/tmp/test\n"
  7471. msgstr ""
  7472. #. type: table
  7473. #: guix-git/doc/guix.texi:3438
  7474. msgid "When running as root, list all the profiles of all the users."
  7475. msgstr ""
  7476. #. type: cindex
  7477. #: guix-git/doc/guix.texi:3439
  7478. #, no-wrap
  7479. msgid "collisions, in a profile"
  7480. msgstr ""
  7481. #. type: cindex
  7482. #: guix-git/doc/guix.texi:3440
  7483. #, no-wrap
  7484. msgid "colliding packages in profiles"
  7485. msgstr ""
  7486. #. type: cindex
  7487. #: guix-git/doc/guix.texi:3441
  7488. #, no-wrap
  7489. msgid "profile collisions"
  7490. msgstr ""
  7491. #. type: item
  7492. #: guix-git/doc/guix.texi:3442
  7493. #, no-wrap
  7494. msgid "--allow-collisions"
  7495. msgstr ""
  7496. #. type: table
  7497. #: guix-git/doc/guix.texi:3444
  7498. msgid "Allow colliding packages in the new profile. Use at your own risk!"
  7499. msgstr ""
  7500. #. type: table
  7501. #: guix-git/doc/guix.texi:3448
  7502. msgid "By default, @command{guix package} reports as an error @dfn{collisions} in the profile. Collisions happen when two or more different versions or variants of a given package end up in the profile."
  7503. msgstr ""
  7504. #. type: item
  7505. #: guix-git/doc/guix.texi:3449 guix-git/doc/guix.texi:4514
  7506. #: guix-git/doc/guix.texi:6280
  7507. #, no-wrap
  7508. msgid "--bootstrap"
  7509. msgstr ""
  7510. #. type: table
  7511. #: guix-git/doc/guix.texi:3452
  7512. msgid "Use the bootstrap Guile to build the profile. This option is only useful to distribution developers."
  7513. msgstr ""
  7514. #. type: Plain text
  7515. #: guix-git/doc/guix.texi:3458
  7516. msgid "In addition to these actions, @command{guix package} supports the following options to query the current state of a profile, or the availability of packages:"
  7517. msgstr ""
  7518. #. type: item
  7519. #: guix-git/doc/guix.texi:3461
  7520. #, no-wrap
  7521. msgid "--search=@var{regexp}"
  7522. msgstr ""
  7523. #. type: itemx
  7524. #: guix-git/doc/guix.texi:3462
  7525. #, no-wrap
  7526. msgid "-s @var{regexp}"
  7527. msgstr ""
  7528. #. type: anchor{#1}
  7529. #: guix-git/doc/guix.texi:3464
  7530. msgid "guix-search"
  7531. msgstr ""
  7532. #. type: cindex
  7533. #: guix-git/doc/guix.texi:3464
  7534. #, no-wrap
  7535. msgid "searching for packages"
  7536. msgstr ""
  7537. #. type: table
  7538. #: guix-git/doc/guix.texi:3470
  7539. msgid "List the available packages whose name, synopsis, or description matches @var{regexp} (in a case-insensitive fashion), sorted by relevance. Print all the metadata of matching packages in @code{recutils} format (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual})."
  7540. msgstr ""
  7541. #. type: table
  7542. #: guix-git/doc/guix.texi:3473
  7543. msgid "This allows specific fields to be extracted using the @command{recsel} command, for instance:"
  7544. msgstr ""
  7545. #. type: example
  7546. #: guix-git/doc/guix.texi:3479
  7547. #, no-wrap
  7548. msgid ""
  7549. "$ guix package -s malloc | recsel -p name,version,relevance\n"
  7550. "name: jemalloc\n"
  7551. "version: 4.5.0\n"
  7552. "relevance: 6\n"
  7553. "\n"
  7554. msgstr ""
  7555. #. type: example
  7556. #: guix-git/doc/guix.texi:3483
  7557. #, no-wrap
  7558. msgid ""
  7559. "name: glibc\n"
  7560. "version: 2.25\n"
  7561. "relevance: 1\n"
  7562. "\n"
  7563. msgstr ""
  7564. #. type: example
  7565. #: guix-git/doc/guix.texi:3487
  7566. #, no-wrap
  7567. msgid ""
  7568. "name: libgc\n"
  7569. "version: 7.6.0\n"
  7570. "relevance: 1\n"
  7571. msgstr ""
  7572. #. type: table
  7573. #: guix-git/doc/guix.texi:3491
  7574. msgid "Similarly, to show the name of all the packages available under the terms of the GNU@tie{}LGPL version 3:"
  7575. msgstr ""
  7576. #. type: example
  7577. #: guix-git/doc/guix.texi:3495
  7578. #, no-wrap
  7579. msgid ""
  7580. "$ guix package -s \"\" | recsel -p name -e 'license ~ \"LGPL 3\"'\n"
  7581. "name: elfutils\n"
  7582. "\n"
  7583. msgstr ""
  7584. #. type: example
  7585. #: guix-git/doc/guix.texi:3498
  7586. #, no-wrap
  7587. msgid ""
  7588. "name: gmp\n"
  7589. "@dots{}\n"
  7590. msgstr ""
  7591. #. type: table
  7592. #: guix-git/doc/guix.texi:3504
  7593. msgid "It is also possible to refine search results using several @code{-s} flags to @command{guix package}, or several arguments to @command{guix search}. For example, the following command returns a list of board games (this time using the @command{guix search} alias):"
  7594. msgstr ""
  7595. #. type: example
  7596. #: guix-git/doc/guix.texi:3509
  7597. #, no-wrap
  7598. msgid ""
  7599. "$ guix search '\\<board\\>' game | recsel -p name\n"
  7600. "name: gnubg\n"
  7601. "@dots{}\n"
  7602. msgstr ""
  7603. #. type: table
  7604. #: guix-git/doc/guix.texi:3515
  7605. msgid "If we were to omit @code{-s game}, we would also get software packages that deal with printed circuit boards; removing the angle brackets around @code{board} would further add packages that have to do with keyboards."
  7606. msgstr ""
  7607. #. type: table
  7608. #: guix-git/doc/guix.texi:3519
  7609. msgid "And now for a more elaborate example. The following command searches for cryptographic libraries, filters out Haskell, Perl, Python, and Ruby libraries, and prints the name and synopsis of the matching packages:"
  7610. msgstr ""
  7611. #. type: example
  7612. #: guix-git/doc/guix.texi:3523
  7613. #, no-wrap
  7614. msgid ""
  7615. "$ guix search crypto library | \\\n"
  7616. " recsel -e '! (name ~ \"^(ghc|perl|python|ruby)\")' -p name,synopsis\n"
  7617. msgstr ""
  7618. #. type: table
  7619. #: guix-git/doc/guix.texi:3528
  7620. msgid "@xref{Selection Expressions,,, recutils, GNU recutils manual}, for more information on @dfn{selection expressions} for @code{recsel -e}."
  7621. msgstr ""
  7622. #. type: item
  7623. #: guix-git/doc/guix.texi:3529
  7624. #, no-wrap
  7625. msgid "--show=@var{package}"
  7626. msgstr ""
  7627. #. type: table
  7628. #: guix-git/doc/guix.texi:3533
  7629. msgid "Show details about @var{package}, taken from the list of available packages, in @code{recutils} format (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual})."
  7630. msgstr ""
  7631. #. type: example
  7632. #: guix-git/doc/guix.texi:3538
  7633. #, no-wrap
  7634. msgid ""
  7635. "$ guix package --show=python | recsel -p name,version\n"
  7636. "name: python\n"
  7637. "version: 2.7.6\n"
  7638. "\n"
  7639. msgstr ""
  7640. #. type: example
  7641. #: guix-git/doc/guix.texi:3541
  7642. #, no-wrap
  7643. msgid ""
  7644. "name: python\n"
  7645. "version: 3.3.5\n"
  7646. msgstr ""
  7647. #. type: table
  7648. #: guix-git/doc/guix.texi:3545
  7649. msgid "You may also specify the full name of a package to only get details about a specific version of it (this time using the @command{guix show} alias):"
  7650. msgstr ""
  7651. #. type: example
  7652. #: guix-git/doc/guix.texi:3549
  7653. #, no-wrap
  7654. msgid ""
  7655. "$ guix show python@@3.4 | recsel -p name,version\n"
  7656. "name: python\n"
  7657. "version: 3.4.3\n"
  7658. msgstr ""
  7659. #. type: item
  7660. #: guix-git/doc/guix.texi:3553
  7661. #, no-wrap
  7662. msgid "--list-installed[=@var{regexp}]"
  7663. msgstr ""
  7664. #. type: itemx
  7665. #: guix-git/doc/guix.texi:3554
  7666. #, no-wrap
  7667. msgid "-I [@var{regexp}]"
  7668. msgstr ""
  7669. #. type: table
  7670. #: guix-git/doc/guix.texi:3558
  7671. msgid "List the currently installed packages in the specified profile, with the most recently installed packages shown last. When @var{regexp} is specified, list only installed packages whose name matches @var{regexp}."
  7672. msgstr ""
  7673. #. type: table
  7674. #: guix-git/doc/guix.texi:3564
  7675. msgid "For each installed package, print the following items, separated by tabs: the package name, its version string, the part of the package that is installed (for instance, @code{out} for the default output, @code{include} for its headers, etc.), and the path of this package in the store."
  7676. msgstr ""
  7677. #. type: item
  7678. #: guix-git/doc/guix.texi:3565
  7679. #, no-wrap
  7680. msgid "--list-available[=@var{regexp}]"
  7681. msgstr ""
  7682. #. type: itemx
  7683. #: guix-git/doc/guix.texi:3566
  7684. #, no-wrap
  7685. msgid "-A [@var{regexp}]"
  7686. msgstr ""
  7687. #. type: table
  7688. #: guix-git/doc/guix.texi:3570
  7689. msgid "List packages currently available in the distribution for this system (@pxref{GNU Distribution}). When @var{regexp} is specified, list only available packages whose name matches @var{regexp}."
  7690. msgstr ""
  7691. #. type: table
  7692. #: guix-git/doc/guix.texi:3574
  7693. msgid "For each package, print the following items separated by tabs: its name, its version string, the parts of the package (@pxref{Packages with Multiple Outputs}), and the source location of its definition."
  7694. msgstr ""
  7695. #. type: item
  7696. #: guix-git/doc/guix.texi:3575 guix-git/doc/guix.texi:4427
  7697. #, no-wrap
  7698. msgid "--list-generations[=@var{pattern}]"
  7699. msgstr ""
  7700. #. type: itemx
  7701. #: guix-git/doc/guix.texi:3576 guix-git/doc/guix.texi:4428
  7702. #, no-wrap
  7703. msgid "-l [@var{pattern}]"
  7704. msgstr ""
  7705. #. type: table
  7706. #: guix-git/doc/guix.texi:3582
  7707. msgid "Return a list of generations along with their creation dates; for each generation, show the installed packages, with the most recently installed packages shown last. Note that the zeroth generation is never shown."
  7708. msgstr ""
  7709. #. type: table
  7710. #: guix-git/doc/guix.texi:3587
  7711. msgid "For each installed package, print the following items, separated by tabs: the name of a package, its version string, the part of the package that is installed (@pxref{Packages with Multiple Outputs}), and the location of this package in the store."
  7712. msgstr ""
  7713. #. type: table
  7714. #: guix-git/doc/guix.texi:3590
  7715. msgid "When @var{pattern} is used, the command returns only matching generations. Valid patterns include:"
  7716. msgstr ""
  7717. #. type: item
  7718. #: guix-git/doc/guix.texi:3592
  7719. #, no-wrap
  7720. msgid "@emph{Integers and comma-separated integers}. Both patterns denote"
  7721. msgstr ""
  7722. #. type: itemize
  7723. #: guix-git/doc/guix.texi:3595
  7724. msgid "generation numbers. For instance, @option{--list-generations=1} returns the first one."
  7725. msgstr ""
  7726. #. type: itemize
  7727. #: guix-git/doc/guix.texi:3598
  7728. msgid "And @option{--list-generations=1,8,2} outputs three generations in the specified order. Neither spaces nor trailing commas are allowed."
  7729. msgstr ""
  7730. #. type: item
  7731. #: guix-git/doc/guix.texi:3599
  7732. #, no-wrap
  7733. msgid "@emph{Ranges}. @option{--list-generations=2..9} prints the"
  7734. msgstr ""
  7735. #. type: itemize
  7736. #: guix-git/doc/guix.texi:3602
  7737. msgid "specified generations and everything in between. Note that the start of a range must be smaller than its end."
  7738. msgstr ""
  7739. #. type: itemize
  7740. #: guix-git/doc/guix.texi:3606
  7741. msgid "It is also possible to omit the endpoint. For example, @option{--list-generations=2..}, returns all generations starting from the second one."
  7742. msgstr ""
  7743. #. type: item
  7744. #: guix-git/doc/guix.texi:3607
  7745. #, no-wrap
  7746. msgid "@emph{Durations}. You can also get the last @emph{N}@tie{}days, weeks,"
  7747. msgstr ""
  7748. #. type: itemize
  7749. #: guix-git/doc/guix.texi:3611
  7750. msgid "or months by passing an integer along with the first letter of the duration. For example, @option{--list-generations=20d} lists generations that are up to 20 days old."
  7751. msgstr ""
  7752. #. type: item
  7753. #: guix-git/doc/guix.texi:3613 guix-git/doc/guix.texi:4452
  7754. #, no-wrap
  7755. msgid "--delete-generations[=@var{pattern}]"
  7756. msgstr ""
  7757. #. type: itemx
  7758. #: guix-git/doc/guix.texi:3614 guix-git/doc/guix.texi:4453
  7759. #, no-wrap
  7760. msgid "-d [@var{pattern}]"
  7761. msgstr ""
  7762. #. type: table
  7763. #: guix-git/doc/guix.texi:3617 guix-git/doc/guix.texi:4456
  7764. msgid "When @var{pattern} is omitted, delete all generations except the current one."
  7765. msgstr ""
  7766. #. type: table
  7767. #: guix-git/doc/guix.texi:3623 guix-git/doc/guix.texi:4462
  7768. msgid "This command accepts the same patterns as @option{--list-generations}. When @var{pattern} is specified, delete the matching generations. When @var{pattern} specifies a duration, generations @emph{older} than the specified duration match. For instance, @option{--delete-generations=1m} deletes generations that are more than one month old."
  7769. msgstr ""
  7770. #. type: table
  7771. #: guix-git/doc/guix.texi:3626
  7772. msgid "If the current generation matches, it is @emph{not} deleted. Also, the zeroth generation is never deleted."
  7773. msgstr ""
  7774. #. type: table
  7775. #: guix-git/doc/guix.texi:3629 guix-git/doc/guix.texi:4467
  7776. msgid "Note that deleting generations prevents rolling back to them. Consequently, this command must be used with care."
  7777. msgstr ""
  7778. #. type: cindex
  7779. #: guix-git/doc/guix.texi:3630
  7780. #, no-wrap
  7781. msgid "manifest, exporting"
  7782. msgstr ""
  7783. #. type: anchor{#1}
  7784. #: guix-git/doc/guix.texi:3632
  7785. msgid "export-manifest"
  7786. msgstr ""
  7787. #. type: item
  7788. #: guix-git/doc/guix.texi:3632
  7789. #, no-wrap
  7790. msgid "--export-manifest"
  7791. msgstr ""
  7792. #. type: table
  7793. #: guix-git/doc/guix.texi:3635
  7794. msgid "Write to standard output a manifest suitable for @option{--manifest} corresponding to the chosen profile(s)."
  7795. msgstr ""
  7796. #. type: table
  7797. #: guix-git/doc/guix.texi:3639
  7798. msgid "This option is meant to help you migrate from the ``imperative'' operating mode---running @command{guix install}, @command{guix upgrade}, etc.---to the declarative mode that @option{--manifest} offers."
  7799. msgstr ""
  7800. #. type: table
  7801. #: guix-git/doc/guix.texi:3644
  7802. msgid "Be aware that the resulting manifest @emph{approximates} what your profile actually contains; for instance, depending on how your profile was created, it can refer to packages or package versions that are not exactly what you specified."
  7803. msgstr ""
  7804. #. type: table
  7805. #: guix-git/doc/guix.texi:3649
  7806. msgid "Keep in mind that a manifest is purely symbolic: it only contains package names and possibly versions, and their meaning varies over time. If you wish to ``pin'' channels to the revisions that were used to build the profile(s), see @option{--export-channels} below."
  7807. msgstr ""
  7808. #. type: cindex
  7809. #: guix-git/doc/guix.texi:3650
  7810. #, no-wrap
  7811. msgid "pinning, channel revisions of a profile"
  7812. msgstr ""
  7813. #. type: item
  7814. #: guix-git/doc/guix.texi:3651
  7815. #, no-wrap
  7816. msgid "--export-channels"
  7817. msgstr ""
  7818. #. type: table
  7819. #: guix-git/doc/guix.texi:3655
  7820. msgid "Write to standard output the list of channels used by the chosen profile(s), in a format suitable for @command{guix pull --channels} or @command{guix time-machine --channels} (@pxref{Channels})."
  7821. msgstr ""
  7822. #. type: table
  7823. #: guix-git/doc/guix.texi:3659
  7824. msgid "Together with @option{--export-manifest}, this option provides information allowing you to replicate the current profile (@pxref{Replicating Guix})."
  7825. msgstr ""
  7826. #. type: table
  7827. #: guix-git/doc/guix.texi:3667
  7828. msgid "However, note that the output of this command @emph{approximates} what was actually used to build this profile. In particular, a single profile might have been built from several different revisions of the same channel. In that case, @option{--export-manifest} chooses the last one and writes the list of other revisions in a comment. If you really need to pick packages from different channel revisions, you can use inferiors in your manifest to do so (@pxref{Inferiors})."
  7829. msgstr ""
  7830. #. type: table
  7831. #: guix-git/doc/guix.texi:3672
  7832. msgid "Together with @option{--export-manifest}, this is a good starting point if you are willing to migrate from the ``imperative'' model to the fully declarative model consisting of a manifest file along with a channels file pinning the exact channel revision(s) you want."
  7833. msgstr ""
  7834. #. type: Plain text
  7835. #: guix-git/doc/guix.texi:3679
  7836. msgid "Finally, since @command{guix package} may actually start build processes, it supports all the common build options (@pxref{Common Build Options}). It also supports package transformation options, such as @option{--with-source}, and preserves them across upgrades (@pxref{Package Transformation Options})."
  7837. msgstr ""
  7838. #. type: cindex
  7839. #: guix-git/doc/guix.texi:3684
  7840. #, no-wrap
  7841. msgid "pre-built binaries"
  7842. msgstr ""
  7843. #. type: Plain text
  7844. #: guix-git/doc/guix.texi:3690
  7845. msgid "Guix supports transparent source/binary deployment, which means that it can either build things locally, or download pre-built items from a server, or both. We call these pre-built items @dfn{substitutes}---they are substitutes for local build results. In many cases, downloading a substitute is much faster than building things locally."
  7846. msgstr ""
  7847. #. type: Plain text
  7848. #: guix-git/doc/guix.texi:3695
  7849. msgid "Substitutes can be anything resulting from a derivation build (@pxref{Derivations}). Of course, in the common case, they are pre-built package binaries, but source tarballs, for instance, which also result from derivation builds, can be available as substitutes."
  7850. msgstr ""
  7851. #. type: cindex
  7852. #: guix-git/doc/guix.texi:3709
  7853. #, no-wrap
  7854. msgid "build farm"
  7855. msgstr ""
  7856. #. type: Plain text
  7857. #: guix-git/doc/guix.texi:3720
  7858. msgid "@code{@value{SUBSTITUTE-SERVER-1}} and @code{@value{SUBSTITUTE-SERVER-2}} are both front-ends to official build farms that build packages from Guix continuously for some architectures, and make them available as substitutes. These are the default source of substitutes; which can be overridden by passing the @option{--substitute-urls} option either to @command{guix-daemon} (@pxref{daemon-substitute-urls,, @code{guix-daemon --substitute-urls}}) or to client tools such as @command{guix package} (@pxref{client-substitute-urls,, client @option{--substitute-urls} option})."
  7859. msgstr ""
  7860. #. type: Plain text
  7861. #: guix-git/doc/guix.texi:3726
  7862. msgid "Substitute URLs can be either HTTP or HTTPS. HTTPS is recommended because communications are encrypted; conversely, using HTTP makes all communications visible to an eavesdropper, who could use the information gathered to determine, for instance, whether your system has unpatched security vulnerabilities."
  7863. msgstr ""
  7864. #. type: Plain text
  7865. #: guix-git/doc/guix.texi:3735
  7866. msgid "Substitutes from the official build farms are enabled by default when using Guix System (@pxref{GNU Distribution}). However, they are disabled by default when using Guix on a foreign distribution, unless you have explicitly enabled them via one of the recommended installation steps (@pxref{Installation}). The following paragraphs describe how to enable or disable substitutes for the official build farm; the same procedure can also be used to enable substitutes for any other substitute server."
  7867. msgstr ""
  7868. #. type: cindex
  7869. #: guix-git/doc/guix.texi:3739
  7870. #, no-wrap
  7871. msgid "security"
  7872. msgstr ""
  7873. #. type: cindex
  7874. #: guix-git/doc/guix.texi:3741
  7875. #, no-wrap
  7876. msgid "access control list (ACL), for substitutes"
  7877. msgstr ""
  7878. #. type: cindex
  7879. #: guix-git/doc/guix.texi:3742
  7880. #, no-wrap
  7881. msgid "ACL (access control list), for substitutes"
  7882. msgstr ""
  7883. #. type: Plain text
  7884. #: guix-git/doc/guix.texi:3748
  7885. msgid "To allow Guix to download substitutes from @code{@value{SUBSTITUTE-SERVER-1}}, @code{@value{SUBSTITUTE-SERVER-2}} or a mirror, you must add the relevant public key to the access control list (ACL) of archive imports, using the @command{guix archive} command (@pxref{Invoking guix archive}). Doing so implies that you trust the substitute server to not be compromised and to serve genuine substitutes."
  7886. msgstr ""
  7887. #. type: quotation
  7888. #: guix-git/doc/guix.texi:3753
  7889. msgid "If you are using Guix System, you can skip this section: Guix System authorizes substitutes from @code{@value{SUBSTITUTE-SERVER-1}} and @code{@value{SUBSTITUTE-SERVER-2}} by default."
  7890. msgstr ""
  7891. #. type: Plain text
  7892. #: guix-git/doc/guix.texi:3761
  7893. msgid "The public keys for each of the project maintained substitute servers are installed along with Guix, in @code{@var{prefix}/share/guix/}, where @var{prefix} is the installation prefix of Guix. If you installed Guix from source, make sure you checked the GPG signature of @file{guix-@value{VERSION}.tar.gz}, which contains this public key file. Then, you can run something like this:"
  7894. msgstr ""
  7895. #. type: example
  7896. #: guix-git/doc/guix.texi:3765
  7897. #, no-wrap
  7898. msgid ""
  7899. "# guix archive --authorize < @var{prefix}/share/guix/@value{SUBSTITUTE-SERVER-1}.pub\n"
  7900. "# guix archive --authorize < @var{prefix}/share/guix/@value{SUBSTITUTE-SERVER-2}.pub\n"
  7901. msgstr ""
  7902. #. type: Plain text
  7903. #: guix-git/doc/guix.texi:3769
  7904. msgid "Once this is in place, the output of a command like @code{guix build} should change from something like:"
  7905. msgstr ""
  7906. #. type: example
  7907. #: guix-git/doc/guix.texi:3778
  7908. #, no-wrap
  7909. msgid ""
  7910. "$ guix build emacs --dry-run\n"
  7911. "The following derivations would be built:\n"
  7912. " /gnu/store/yr7bnx8xwcayd6j95r2clmkdl1qh688w-emacs-24.3.drv\n"
  7913. " /gnu/store/x8qsh1hlhgjx6cwsjyvybnfv2i37z23w-dbus-1.6.4.tar.gz.drv\n"
  7914. " /gnu/store/1ixwp12fl950d15h2cj11c73733jay0z-alsa-lib-1.0.27.1.tar.bz2.drv\n"
  7915. " /gnu/store/nlma1pw0p603fpfiqy7kn4zm105r5dmw-util-linux-2.21.drv\n"
  7916. "@dots{}\n"
  7917. msgstr ""
  7918. #. type: Plain text
  7919. #: guix-git/doc/guix.texi:3782
  7920. msgid "to something like:"
  7921. msgstr ""
  7922. #. type: example
  7923. #: guix-git/doc/guix.texi:3791
  7924. #, no-wrap
  7925. msgid ""
  7926. "$ guix build emacs --dry-run\n"
  7927. "112.3 MB would be downloaded:\n"
  7928. " /gnu/store/pk3n22lbq6ydamyymqkkz7i69wiwjiwi-emacs-24.3\n"
  7929. " /gnu/store/2ygn4ncnhrpr61rssa6z0d9x22si0va3-libjpeg-8d\n"
  7930. " /gnu/store/71yz6lgx4dazma9dwn2mcjxaah9w77jq-cairo-1.12.16\n"
  7931. " /gnu/store/7zdhgp0n1518lvfn8mb96sxqfmvqrl7v-libxrender-0.9.7\n"
  7932. "@dots{}\n"
  7933. msgstr ""
  7934. #. type: Plain text
  7935. #: guix-git/doc/guix.texi:3798
  7936. msgid "The text changed from ``The following derivations would be built'' to ``112.3 MB would be downloaded''. This indicates that substitutes from the configured substitute servers are usable and will be downloaded, when possible, for future builds."
  7937. msgstr ""
  7938. #. type: cindex
  7939. #: guix-git/doc/guix.texi:3799
  7940. #, no-wrap
  7941. msgid "substitutes, how to disable"
  7942. msgstr ""
  7943. #. type: Plain text
  7944. #: guix-git/doc/guix.texi:3805
  7945. msgid "The substitute mechanism can be disabled globally by running @code{guix-daemon} with @option{--no-substitutes} (@pxref{Invoking guix-daemon}). It can also be disabled temporarily by passing the @option{--no-substitutes} option to @command{guix package}, @command{guix build}, and other command-line tools."
  7946. msgstr ""
  7947. #. type: cindex
  7948. #: guix-git/doc/guix.texi:3809
  7949. #, no-wrap
  7950. msgid "substitute servers, adding more"
  7951. msgstr ""
  7952. #. type: Plain text
  7953. #: guix-git/doc/guix.texi:3816
  7954. msgid "Guix can look up and fetch substitutes from several servers. This is useful when you are using packages from additional channels for which the official server does not have substitutes but another server provides them. Another situation where this is useful is when you would prefer to download from your organization's substitute server, resorting to the official server only as a fallback or dismissing it altogether."
  7955. msgstr ""
  7956. #. type: Plain text
  7957. #: guix-git/doc/guix.texi:3821
  7958. msgid "You can give Guix a list of substitute server URLs and it will check them in the specified order. You also need to explicitly authorize the public keys of substitute servers to instruct Guix to accept the substitutes they sign."
  7959. msgstr ""
  7960. #. type: Plain text
  7961. #: guix-git/doc/guix.texi:3828
  7962. msgid "On Guix System, this is achieved by modifying the configuration of the @code{guix} service. Since the @code{guix} service is part of the default lists of services, @code{%base-services} and @code{%desktop-services}, you can use @code{modify-services} to change its configuration and add the URLs and substitute keys that you want (@pxref{Service Reference, @code{modify-services}})."
  7963. msgstr ""
  7964. #. type: Plain text
  7965. #: guix-git/doc/guix.texi:3834
  7966. msgid "As an example, suppose you want to fetch substitutes from @code{guix.example.org} and to authorize the signing key of that server, in addition to the default @code{@value{SUBSTITUTE-SERVER-1}} and @code{@value{SUBSTITUTE-SERVER-2}}. The resulting operating system configuration will look something like:"
  7967. msgstr ""
  7968. #. type: lisp
  7969. #: guix-git/doc/guix.texi:3851
  7970. #, no-wrap
  7971. msgid ""
  7972. "(operating-system\n"
  7973. " ;; @dots{}\n"
  7974. " (services\n"
  7975. " ;; Assume we're starting from '%desktop-services'. Replace it\n"
  7976. " ;; with the list of services you're actually using.\n"
  7977. " (modify-services %desktop-services\n"
  7978. " (guix-service-type config =>\n"
  7979. " (guix-configuration\n"
  7980. " (inherit config)\n"
  7981. " (substitute-urls\n"
  7982. " (append (list \"https://guix.example.org\")\n"
  7983. " %default-substitute-urls))\n"
  7984. " (authorized-keys\n"
  7985. " (append (list (local-file \"./key.pub\"))\n"
  7986. " %default-authorized-guix-keys)))))))\n"
  7987. msgstr ""
  7988. #. type: Plain text
  7989. #: guix-git/doc/guix.texi:3858
  7990. msgid "This assumes that the file @file{key.pub} contains the signing key of @code{guix.example.org}. With this change in place in your operating system configuration file (say @file{/etc/config.scm}), you can reconfigure and restart the @code{guix-daemon} service or reboot so the changes take effect:"
  7991. msgstr ""
  7992. #. type: example
  7993. #: guix-git/doc/guix.texi:3862
  7994. #, no-wrap
  7995. msgid ""
  7996. "$ sudo guix system reconfigure /etc/config.scm\n"
  7997. "$ sudo herd restart guix-daemon\n"
  7998. msgstr ""
  7999. #. type: Plain text
  8000. #: guix-git/doc/guix.texi:3866
  8001. msgid "If you're running Guix on a ``foreign distro'', you would instead take the following steps to get substitutes from additional servers:"
  8002. msgstr ""
  8003. #. type: enumerate
  8004. #: guix-git/doc/guix.texi:3875
  8005. msgid "Edit the service configuration file for @code{guix-daemon}; when using systemd, this is normally @file{/etc/systemd/system/guix-daemon.service}. Add the @option{--substitute-urls} option on the @command{guix-daemon} command line and list the URLs of interest (@pxref{daemon-substitute-urls, @code{guix-daemon --substitute-urls}}):"
  8006. msgstr ""
  8007. #. type: example
  8008. #: guix-git/doc/guix.texi:3878
  8009. #, no-wrap
  8010. msgid "@dots{} --substitute-urls='https://guix.example.org @value{SUBSTITUTE-URLS}'\n"
  8011. msgstr ""
  8012. #. type: enumerate
  8013. #: guix-git/doc/guix.texi:3882
  8014. msgid "Restart the daemon. For systemd, it goes like this:"
  8015. msgstr ""
  8016. #. type: example
  8017. #: guix-git/doc/guix.texi:3886
  8018. #, no-wrap
  8019. msgid ""
  8020. "systemctl daemon-reload\n"
  8021. "systemctl restart guix-daemon.service\n"
  8022. msgstr ""
  8023. #. type: enumerate
  8024. #: guix-git/doc/guix.texi:3890
  8025. msgid "Authorize the key of the new server (@pxref{Invoking guix archive}):"
  8026. msgstr ""
  8027. #. type: example
  8028. #: guix-git/doc/guix.texi:3893
  8029. #, no-wrap
  8030. msgid "guix archive --authorize < key.pub\n"
  8031. msgstr ""
  8032. #. type: enumerate
  8033. #: guix-git/doc/guix.texi:3897
  8034. msgid "Again this assumes @file{key.pub} contains the public key that @code{guix.example.org} uses to sign substitutes."
  8035. msgstr ""
  8036. #. type: Plain text
  8037. #: guix-git/doc/guix.texi:3906
  8038. msgid "Now you're all set! Substitutes will be preferably taken from @code{https://guix.example.org}, using @code{@value{SUBSTITUTE-SERVER-1}} then @code{@value{SUBSTITUTE-SERVER-2}} as fallback options. Of course you can list as many substitute servers as you like, with the caveat that substitute lookup can be slowed down if too many servers need to be contacted."
  8039. msgstr ""
  8040. #. type: Plain text
  8041. #: guix-git/doc/guix.texi:3910
  8042. msgid "Note that there are also situations where one may want to add the URL of a substitute server @emph{without} authorizing its key. @xref{Substitute Authentication}, to understand this fine point."
  8043. msgstr ""
  8044. #. type: cindex
  8045. #: guix-git/doc/guix.texi:3914
  8046. #, no-wrap
  8047. msgid "digital signatures"
  8048. msgstr ""
  8049. #. type: Plain text
  8050. #: guix-git/doc/guix.texi:3918
  8051. msgid "Guix detects and raises an error when attempting to use a substitute that has been tampered with. Likewise, it ignores substitutes that are not signed, or that are not signed by one of the keys listed in the ACL."
  8052. msgstr ""
  8053. #. type: Plain text
  8054. #: guix-git/doc/guix.texi:3924
  8055. msgid "There is one exception though: if an unauthorized server provides substitutes that are @emph{bit-for-bit identical} to those provided by an authorized server, then the unauthorized server becomes eligible for downloads. For example, assume we have chosen two substitute servers with this option:"
  8056. msgstr ""
  8057. #. type: example
  8058. #: guix-git/doc/guix.texi:3927
  8059. #, no-wrap
  8060. msgid "--substitute-urls=\"https://a.example.org https://b.example.org\"\n"
  8061. msgstr ""
  8062. #. type: Plain text
  8063. #: guix-git/doc/guix.texi:3938
  8064. msgid "If the ACL contains only the key for @samp{b.example.org}, and if @samp{a.example.org} happens to serve the @emph{exact same} substitutes, then Guix will download substitutes from @samp{a.example.org} because it comes first in the list and can be considered a mirror of @samp{b.example.org}. In practice, independent build machines usually produce the same binaries, thanks to bit-reproducible builds (see below)."
  8065. msgstr ""
  8066. #. type: Plain text
  8067. #: guix-git/doc/guix.texi:3945
  8068. msgid "When using HTTPS, the server's X.509 certificate is @emph{not} validated (in other words, the server is not authenticated), contrary to what HTTPS clients such as Web browsers usually do. This is because Guix authenticates substitute information itself, as explained above, which is what we care about (whereas X.509 certificates are about authenticating bindings between domain names and public keys)."
  8069. msgstr ""
  8070. #. type: Plain text
  8071. #: guix-git/doc/guix.texi:3957
  8072. msgid "Substitutes are downloaded over HTTP or HTTPS@. The @env{http_proxy} and @env{https_proxy} environment variables can be set in the environment of @command{guix-daemon} and are honored for downloads of substitutes. Note that the value of those environment variables in the environment where @command{guix build}, @command{guix package}, and other client commands are run has @emph{absolutely no effect}."
  8073. msgstr ""
  8074. #. type: Plain text
  8075. #: guix-git/doc/guix.texi:3966
  8076. msgid "Even when a substitute for a derivation is available, sometimes the substitution attempt will fail. This can happen for a variety of reasons: the substitute server might be offline, the substitute may recently have been deleted, the connection might have been interrupted, etc."
  8077. msgstr ""
  8078. #. type: Plain text
  8079. #: guix-git/doc/guix.texi:3980
  8080. msgid "When substitutes are enabled and a substitute for a derivation is available, but the substitution attempt fails, Guix will attempt to build the derivation locally depending on whether or not @option{--fallback} was given (@pxref{fallback-option,, common build option @option{--fallback}}). Specifically, if @option{--fallback} was omitted, then no local build will be performed, and the derivation is considered to have failed. However, if @option{--fallback} was given, then Guix will attempt to build the derivation locally, and the success or failure of the derivation depends on the success or failure of the local build. Note that when substitutes are disabled or no substitute is available for the derivation in question, a local build will @emph{always} be performed, regardless of whether or not @option{--fallback} was given."
  8081. msgstr ""
  8082. #. type: Plain text
  8083. #: guix-git/doc/guix.texi:3985
  8084. msgid "To get an idea of how many substitutes are available right now, you can try running the @command{guix weather} command (@pxref{Invoking guix weather}). This command provides statistics on the substitutes provided by a server."
  8085. msgstr ""
  8086. #. type: cindex
  8087. #: guix-git/doc/guix.texi:3989
  8088. #, no-wrap
  8089. msgid "trust, of pre-built binaries"
  8090. msgstr ""
  8091. #. type: Plain text
  8092. #: guix-git/doc/guix.texi:3999
  8093. msgid "Today, each individual's control over their own computing is at the mercy of institutions, corporations, and groups with enough power and determination to subvert the computing infrastructure and exploit its weaknesses. While using substitutes can be convenient, we encourage users to also build on their own, or even run their own build farm, such that the project run substitute servers are less of an interesting target. One way to help is by publishing the software you build using @command{guix publish} so that others have one more choice of server to download substitutes from (@pxref{Invoking guix publish})."
  8094. msgstr ""
  8095. #. type: Plain text
  8096. #: guix-git/doc/guix.texi:4011
  8097. msgid "Guix has the foundations to maximize build reproducibility (@pxref{Features}). In most cases, independent builds of a given package or derivation should yield bit-identical results. Thus, through a diverse set of independent package builds, we can strengthen the integrity of our systems. The @command{guix challenge} command aims to help users assess substitute servers, and to assist developers in finding out about non-deterministic package builds (@pxref{Invoking guix challenge}). Similarly, the @option{--check} option of @command{guix build} allows users to check whether previously-installed substitutes are genuine by rebuilding them locally (@pxref{build-check, @command{guix build --check}})."
  8098. msgstr ""
  8099. #. type: Plain text
  8100. #: guix-git/doc/guix.texi:4015
  8101. msgid "In the future, we want Guix to have support to publish and retrieve binaries to/from other users, in a peer-to-peer fashion. If you would like to discuss this project, join us on @email{guix-devel@@gnu.org}."
  8102. msgstr ""
  8103. #. type: cindex
  8104. #: guix-git/doc/guix.texi:4019
  8105. #, no-wrap
  8106. msgid "multiple-output packages"
  8107. msgstr ""
  8108. #. type: cindex
  8109. #: guix-git/doc/guix.texi:4020
  8110. #, no-wrap
  8111. msgid "package outputs"
  8112. msgstr ""
  8113. #. type: cindex
  8114. #: guix-git/doc/guix.texi:4021
  8115. #, no-wrap
  8116. msgid "outputs"
  8117. msgstr ""
  8118. #. type: Plain text
  8119. #: guix-git/doc/guix.texi:4031
  8120. msgid "Often, packages defined in Guix have a single @dfn{output}---i.e., the source package leads to exactly one directory in the store. When running @command{guix install glibc}, one installs the default output of the GNU libc package; the default output is called @code{out}, but its name can be omitted as shown in this command. In this particular case, the default output of @code{glibc} contains all the C header files, shared libraries, static libraries, Info documentation, and other supporting files."
  8121. msgstr ""
  8122. #. type: Plain text
  8123. #: guix-git/doc/guix.texi:4039
  8124. msgid "Sometimes it is more appropriate to separate the various types of files produced from a single source package into separate outputs. For instance, the GLib C library (used by GTK+ and related packages) installs more than 20 MiB of reference documentation as HTML pages. To save space for users who do not need it, the documentation goes to a separate output, called @code{doc}. To install the main GLib output, which contains everything but the documentation, one would run:"
  8125. msgstr ""
  8126. #. type: example
  8127. #: guix-git/doc/guix.texi:4042
  8128. #, no-wrap
  8129. msgid "guix install glib\n"
  8130. msgstr ""
  8131. #. type: item
  8132. #: guix-git/doc/guix.texi:4044 guix-git/doc/guix.texi:34950
  8133. #: guix-git/doc/guix.texi:35007
  8134. #, no-wrap
  8135. msgid "documentation"
  8136. msgstr ""
  8137. #. type: Plain text
  8138. #: guix-git/doc/guix.texi:4046
  8139. msgid "The command to install its documentation is:"
  8140. msgstr ""
  8141. #. type: example
  8142. #: guix-git/doc/guix.texi:4049
  8143. #, no-wrap
  8144. msgid "guix install glib:doc\n"
  8145. msgstr ""
  8146. #. type: Plain text
  8147. #: guix-git/doc/guix.texi:4060
  8148. msgid "Some packages install programs with different ``dependency footprints''. For instance, the WordNet package installs both command-line tools and graphical user interfaces (GUIs). The former depend solely on the C library, whereas the latter depend on Tcl/Tk and the underlying X libraries. In this case, we leave the command-line tools in the default output, whereas the GUIs are in a separate output. This allows users who do not need the GUIs to save space. The @command{guix size} command can help find out about such situations (@pxref{Invoking guix size}). @command{guix graph} can also be helpful (@pxref{Invoking guix graph})."
  8149. msgstr ""
  8150. #. type: Plain text
  8151. #: guix-git/doc/guix.texi:4068
  8152. msgid "There are several such multiple-output packages in the GNU distribution. Other conventional output names include @code{lib} for libraries and possibly header files, @code{bin} for stand-alone programs, and @code{debug} for debugging information (@pxref{Installing Debugging Files}). The outputs of a packages are listed in the third column of the output of @command{guix package --list-available} (@pxref{Invoking guix package})."
  8153. msgstr ""
  8154. #. type: section
  8155. #: guix-git/doc/guix.texi:4071
  8156. #, no-wrap
  8157. msgid "Invoking @command{guix gc}"
  8158. msgstr ""
  8159. #. type: cindex
  8160. #: guix-git/doc/guix.texi:4073
  8161. #, no-wrap
  8162. msgid "garbage collector"
  8163. msgstr ""
  8164. #. type: cindex
  8165. #: guix-git/doc/guix.texi:4074
  8166. #, no-wrap
  8167. msgid "disk space"
  8168. msgstr ""
  8169. #. type: Plain text
  8170. #: guix-git/doc/guix.texi:4080
  8171. msgid "Packages that are installed, but not used, may be @dfn{garbage-collected}. The @command{guix gc} command allows users to explicitly run the garbage collector to reclaim space from the @file{/gnu/store} directory. It is the @emph{only} way to remove files from @file{/gnu/store}---removing files or directories manually may break it beyond repair!"
  8172. msgstr ""
  8173. #. type: Plain text
  8174. #: guix-git/doc/guix.texi:4091
  8175. msgid "The garbage collector has a set of known @dfn{roots}: any file under @file{/gnu/store} reachable from a root is considered @dfn{live} and cannot be deleted; any other file is considered @dfn{dead} and may be deleted. The set of garbage collector roots (``GC roots'' for short) includes default user profiles; by default, the symlinks under @file{/var/guix/gcroots} represent these GC roots. New GC roots can be added with @command{guix build --root}, for example (@pxref{Invoking guix build}). The @command{guix gc --list-roots} command lists them."
  8176. msgstr ""
  8177. #. type: Plain text
  8178. #: guix-git/doc/guix.texi:4097
  8179. msgid "Prior to running @code{guix gc --collect-garbage} to make space, it is often useful to remove old generations from user profiles; that way, old package builds referenced by those generations can be reclaimed. This is achieved by running @code{guix package --delete-generations} (@pxref{Invoking guix package})."
  8180. msgstr ""
  8181. #. type: Plain text
  8182. #: guix-git/doc/guix.texi:4101
  8183. msgid "Our recommendation is to run a garbage collection periodically, or when you are short on disk space. For instance, to guarantee that at least 5@tie{}GB are available on your disk, simply run:"
  8184. msgstr ""
  8185. #. type: example
  8186. #: guix-git/doc/guix.texi:4104
  8187. #, no-wrap
  8188. msgid "guix gc -F 5G\n"
  8189. msgstr ""
  8190. #. type: Plain text
  8191. #: guix-git/doc/guix.texi:4113
  8192. msgid "It is perfectly safe to run as a non-interactive periodic job (@pxref{Scheduled Job Execution}, for how to set up such a job). Running @command{guix gc} with no arguments will collect as much garbage as it can, but that is often inconvenient: you may find yourself having to rebuild or re-download software that is ``dead'' from the GC viewpoint but that is necessary to build other pieces of software---e.g., the compiler tool chain."
  8193. msgstr ""
  8194. #. type: Plain text
  8195. #: guix-git/doc/guix.texi:4119
  8196. msgid "The @command{guix gc} command has three modes of operation: it can be used to garbage-collect any dead files (the default), to delete specific files (the @option{--delete} option), to print garbage-collector information, or for more advanced queries. The garbage collection options are as follows:"
  8197. msgstr ""
  8198. #. type: item
  8199. #: guix-git/doc/guix.texi:4121
  8200. #, no-wrap
  8201. msgid "--collect-garbage[=@var{min}]"
  8202. msgstr ""
  8203. #. type: itemx
  8204. #: guix-git/doc/guix.texi:4122
  8205. #, no-wrap
  8206. msgid "-C [@var{min}]"
  8207. msgstr ""
  8208. #. type: table
  8209. #: guix-git/doc/guix.texi:4126
  8210. msgid "Collect garbage---i.e., unreachable @file{/gnu/store} files and sub-directories. This is the default operation when no option is specified."
  8211. msgstr ""
  8212. #. type: table
  8213. #: guix-git/doc/guix.texi:4131
  8214. msgid "When @var{min} is given, stop once @var{min} bytes have been collected. @var{min} may be a number of bytes, or it may include a unit as a suffix, such as @code{MiB} for mebibytes and @code{GB} for gigabytes (@pxref{Block size, size specifications,, coreutils, GNU Coreutils})."
  8215. msgstr ""
  8216. #. type: table
  8217. #: guix-git/doc/guix.texi:4133
  8218. msgid "When @var{min} is omitted, collect all the garbage."
  8219. msgstr ""
  8220. #. type: item
  8221. #: guix-git/doc/guix.texi:4134
  8222. #, no-wrap
  8223. msgid "--free-space=@var{free}"
  8224. msgstr ""
  8225. #. type: itemx
  8226. #: guix-git/doc/guix.texi:4135
  8227. #, no-wrap
  8228. msgid "-F @var{free}"
  8229. msgstr ""
  8230. #. type: table
  8231. #: guix-git/doc/guix.texi:4139
  8232. msgid "Collect garbage until @var{free} space is available under @file{/gnu/store}, if possible; @var{free} denotes storage space, such as @code{500MiB}, as described above."
  8233. msgstr ""
  8234. #. type: table
  8235. #: guix-git/doc/guix.texi:4142
  8236. msgid "When @var{free} or more is already available in @file{/gnu/store}, do nothing and exit immediately."
  8237. msgstr ""
  8238. #. type: item
  8239. #: guix-git/doc/guix.texi:4143
  8240. #, no-wrap
  8241. msgid "--delete-generations[=@var{duration}]"
  8242. msgstr ""
  8243. #. type: itemx
  8244. #: guix-git/doc/guix.texi:4144
  8245. #, no-wrap
  8246. msgid "-d [@var{duration}]"
  8247. msgstr ""
  8248. #. type: table
  8249. #: guix-git/doc/guix.texi:4148
  8250. msgid "Before starting the garbage collection process, delete all the generations older than @var{duration}, for all the user profiles; when run as root, this applies to all the profiles @emph{of all the users}."
  8251. msgstr ""
  8252. #. type: table
  8253. #: guix-git/doc/guix.texi:4152
  8254. msgid "For example, this command deletes all the generations of all your profiles that are older than 2 months (except generations that are current), and then proceeds to free space until at least 10 GiB are available:"
  8255. msgstr ""
  8256. #. type: example
  8257. #: guix-git/doc/guix.texi:4155
  8258. #, no-wrap
  8259. msgid "guix gc -d 2m -F 10G\n"
  8260. msgstr ""
  8261. #. type: item
  8262. #: guix-git/doc/guix.texi:4157
  8263. #, no-wrap
  8264. msgid "--delete"
  8265. msgstr ""
  8266. #. type: itemx
  8267. #: guix-git/doc/guix.texi:4158
  8268. #, no-wrap
  8269. msgid "-D"
  8270. msgstr ""
  8271. #. type: table
  8272. #: guix-git/doc/guix.texi:4162
  8273. msgid "Attempt to delete all the store files and directories specified as arguments. This fails if some of the files are not in the store, or if they are still live."
  8274. msgstr ""
  8275. #. type: item
  8276. #: guix-git/doc/guix.texi:4163
  8277. #, no-wrap
  8278. msgid "--list-failures"
  8279. msgstr ""
  8280. #. type: table
  8281. #: guix-git/doc/guix.texi:4165
  8282. msgid "List store items corresponding to cached build failures."
  8283. msgstr ""
  8284. #. type: table
  8285. #: guix-git/doc/guix.texi:4169
  8286. msgid "This prints nothing unless the daemon was started with @option{--cache-failures} (@pxref{Invoking guix-daemon, @option{--cache-failures}})."
  8287. msgstr ""
  8288. #. type: item
  8289. #: guix-git/doc/guix.texi:4170
  8290. #, no-wrap
  8291. msgid "--list-roots"
  8292. msgstr ""
  8293. #. type: table
  8294. #: guix-git/doc/guix.texi:4173
  8295. msgid "List the GC roots owned by the user; when run as root, list @emph{all} the GC roots."
  8296. msgstr ""
  8297. #. type: item
  8298. #: guix-git/doc/guix.texi:4174
  8299. #, no-wrap
  8300. msgid "--list-busy"
  8301. msgstr ""
  8302. #. type: table
  8303. #: guix-git/doc/guix.texi:4177
  8304. msgid "List store items in use by currently running processes. These store items are effectively considered GC roots: they cannot be deleted."
  8305. msgstr ""
  8306. #. type: item
  8307. #: guix-git/doc/guix.texi:4178
  8308. #, no-wrap
  8309. msgid "--clear-failures"
  8310. msgstr ""
  8311. #. type: table
  8312. #: guix-git/doc/guix.texi:4180
  8313. msgid "Remove the specified store items from the failed-build cache."
  8314. msgstr ""
  8315. #. type: table
  8316. #: guix-git/doc/guix.texi:4183
  8317. msgid "Again, this option only makes sense when the daemon is started with @option{--cache-failures}. Otherwise, it does nothing."
  8318. msgstr ""
  8319. #. type: item
  8320. #: guix-git/doc/guix.texi:4184
  8321. #, no-wrap
  8322. msgid "--list-dead"
  8323. msgstr ""
  8324. #. type: table
  8325. #: guix-git/doc/guix.texi:4187
  8326. msgid "Show the list of dead files and directories still present in the store---i.e., files and directories no longer reachable from any root."
  8327. msgstr ""
  8328. #. type: item
  8329. #: guix-git/doc/guix.texi:4188
  8330. #, no-wrap
  8331. msgid "--list-live"
  8332. msgstr ""
  8333. #. type: table
  8334. #: guix-git/doc/guix.texi:4190
  8335. msgid "Show the list of live store files and directories."
  8336. msgstr ""
  8337. #. type: Plain text
  8338. #: guix-git/doc/guix.texi:4194
  8339. msgid "In addition, the references among existing store files can be queried:"
  8340. msgstr ""
  8341. #. type: item
  8342. #: guix-git/doc/guix.texi:4197
  8343. #, no-wrap
  8344. msgid "--references"
  8345. msgstr ""
  8346. #. type: itemx
  8347. #: guix-git/doc/guix.texi:4198
  8348. #, no-wrap
  8349. msgid "--referrers"
  8350. msgstr ""
  8351. #. type: cindex
  8352. #: guix-git/doc/guix.texi:4199 guix-git/doc/guix.texi:12403
  8353. #, no-wrap
  8354. msgid "package dependencies"
  8355. msgstr ""
  8356. #. type: table
  8357. #: guix-git/doc/guix.texi:4202
  8358. msgid "List the references (respectively, the referrers) of store files given as arguments."
  8359. msgstr ""
  8360. #. type: item
  8361. #: guix-git/doc/guix.texi:4203
  8362. #, no-wrap
  8363. msgid "--requisites"
  8364. msgstr ""
  8365. #. type: itemx
  8366. #: guix-git/doc/guix.texi:4204 guix-git/doc/guix.texi:6080
  8367. #, no-wrap
  8368. msgid "-R"
  8369. msgstr ""
  8370. #. type: item
  8371. #: guix-git/doc/guix.texi:4205 guix-git/doc/guix.texi:12259
  8372. #: guix-git/doc/guix.texi:12287 guix-git/doc/guix.texi:12368
  8373. #, no-wrap
  8374. msgid "closure"
  8375. msgstr ""
  8376. #. type: table
  8377. #: guix-git/doc/guix.texi:4210
  8378. msgid "List the requisites of the store files passed as arguments. Requisites include the store files themselves, their references, and the references of these, recursively. In other words, the returned list is the @dfn{transitive closure} of the store files."
  8379. msgstr ""
  8380. #. type: table
  8381. #: guix-git/doc/guix.texi:4214
  8382. msgid "@xref{Invoking guix size}, for a tool to profile the size of the closure of an element. @xref{Invoking guix graph}, for a tool to visualize the graph of references."
  8383. msgstr ""
  8384. #. type: item
  8385. #: guix-git/doc/guix.texi:4215
  8386. #, no-wrap
  8387. msgid "--derivers"
  8388. msgstr ""
  8389. #. type: item
  8390. #: guix-git/doc/guix.texi:4216 guix-git/doc/guix.texi:6394
  8391. #: guix-git/doc/guix.texi:12122 guix-git/doc/guix.texi:12512
  8392. #, no-wrap
  8393. msgid "derivation"
  8394. msgstr ""
  8395. #. type: table
  8396. #: guix-git/doc/guix.texi:4219
  8397. msgid "Return the derivation(s) leading to the given store items (@pxref{Derivations})."
  8398. msgstr ""
  8399. #. type: table
  8400. #: guix-git/doc/guix.texi:4221
  8401. msgid "For example, this command:"
  8402. msgstr ""
  8403. #. type: example
  8404. #: guix-git/doc/guix.texi:4224
  8405. #, no-wrap
  8406. msgid "guix gc --derivers $(guix package -I ^emacs$ | cut -f4)\n"
  8407. msgstr ""
  8408. #. type: table
  8409. #: guix-git/doc/guix.texi:4229
  8410. msgid "returns the @file{.drv} file(s) leading to the @code{emacs} package installed in your profile."
  8411. msgstr ""
  8412. #. type: table
  8413. #: guix-git/doc/guix.texi:4233
  8414. msgid "Note that there may be zero matching @file{.drv} files, for instance because these files have been garbage-collected. There can also be more than one matching @file{.drv} due to fixed-output derivations."
  8415. msgstr ""
  8416. #. type: Plain text
  8417. #: guix-git/doc/guix.texi:4237
  8418. msgid "Lastly, the following options allow you to check the integrity of the store and to control disk usage."
  8419. msgstr ""
  8420. #. type: item
  8421. #: guix-git/doc/guix.texi:4240
  8422. #, no-wrap
  8423. msgid "--verify[=@var{options}]"
  8424. msgstr ""
  8425. #. type: cindex
  8426. #: guix-git/doc/guix.texi:4241
  8427. #, no-wrap
  8428. msgid "integrity, of the store"
  8429. msgstr ""
  8430. #. type: cindex
  8431. #: guix-git/doc/guix.texi:4242
  8432. #, no-wrap
  8433. msgid "integrity checking"
  8434. msgstr ""
  8435. #. type: table
  8436. #: guix-git/doc/guix.texi:4244
  8437. msgid "Verify the integrity of the store."
  8438. msgstr ""
  8439. #. type: table
  8440. #: guix-git/doc/guix.texi:4247
  8441. msgid "By default, make sure that all the store items marked as valid in the database of the daemon actually exist in @file{/gnu/store}."
  8442. msgstr ""
  8443. #. type: table
  8444. #: guix-git/doc/guix.texi:4250
  8445. msgid "When provided, @var{options} must be a comma-separated list containing one or more of @code{contents} and @code{repair}."
  8446. msgstr ""
  8447. #. type: table
  8448. #: guix-git/doc/guix.texi:4256
  8449. msgid "When passing @option{--verify=contents}, the daemon computes the content hash of each store item and compares it against its hash in the database. Hash mismatches are reported as data corruptions. Because it traverses @emph{all the files in the store}, this command can take a long time, especially on systems with a slow disk drive."
  8450. msgstr ""
  8451. #. type: cindex
  8452. #: guix-git/doc/guix.texi:4257
  8453. #, no-wrap
  8454. msgid "repairing the store"
  8455. msgstr ""
  8456. #. type: cindex
  8457. #: guix-git/doc/guix.texi:4258 guix-git/doc/guix.texi:10926
  8458. #, no-wrap
  8459. msgid "corruption, recovering from"
  8460. msgstr ""
  8461. #. type: table
  8462. #: guix-git/doc/guix.texi:4266
  8463. msgid "Using @option{--verify=repair} or @option{--verify=contents,repair} causes the daemon to try to repair corrupt store items by fetching substitutes for them (@pxref{Substitutes}). Because repairing is not atomic, and thus potentially dangerous, it is available only to the system administrator. A lightweight alternative, when you know exactly which items in the store are corrupt, is @command{guix build --repair} (@pxref{Invoking guix build})."
  8464. msgstr ""
  8465. #. type: item
  8466. #: guix-git/doc/guix.texi:4267
  8467. #, no-wrap
  8468. msgid "--optimize"
  8469. msgstr ""
  8470. #. type: table
  8471. #: guix-git/doc/guix.texi:4271
  8472. msgid "Optimize the store by hard-linking identical files---this is @dfn{deduplication}."
  8473. msgstr ""
  8474. #. type: table
  8475. #: guix-git/doc/guix.texi:4277
  8476. msgid "The daemon performs deduplication after each successful build or archive import, unless it was started with @option{--disable-deduplication} (@pxref{Invoking guix-daemon, @option{--disable-deduplication}}). Thus, this option is primarily useful when the daemon was running with @option{--disable-deduplication}."
  8477. msgstr ""
  8478. #. type: section
  8479. #: guix-git/doc/guix.texi:4281
  8480. #, no-wrap
  8481. msgid "Invoking @command{guix pull}"
  8482. msgstr ""
  8483. #. type: cindex
  8484. #: guix-git/doc/guix.texi:4283
  8485. #, no-wrap
  8486. msgid "upgrading Guix"
  8487. msgstr ""
  8488. #. type: cindex
  8489. #: guix-git/doc/guix.texi:4284
  8490. #, no-wrap
  8491. msgid "updating Guix"
  8492. msgstr ""
  8493. #. type: command{#1}
  8494. #: guix-git/doc/guix.texi:4285
  8495. #, no-wrap
  8496. msgid "guix pull"
  8497. msgstr ""
  8498. #. type: cindex
  8499. #: guix-git/doc/guix.texi:4286
  8500. #, no-wrap
  8501. msgid "pull"
  8502. msgstr ""
  8503. #. type: cindex
  8504. #: guix-git/doc/guix.texi:4287
  8505. #, no-wrap
  8506. msgid "security, @command{guix pull}"
  8507. msgstr ""
  8508. #. type: cindex
  8509. #: guix-git/doc/guix.texi:4288
  8510. #, no-wrap
  8511. msgid "authenticity, of code obtained with @command{guix pull}"
  8512. msgstr ""
  8513. #. type: Plain text
  8514. #: guix-git/doc/guix.texi:4298
  8515. msgid "Packages are installed or upgraded to the latest version available in the distribution currently available on your local machine. To update that distribution, along with the Guix tools, you must run @command{guix pull}: the command downloads the latest Guix source code and package descriptions, and deploys it. Source code is downloaded from a @uref{https://git-scm.com, Git} repository, by default the official GNU@tie{}Guix repository, though this can be customized. @command{guix pull} ensures that the code it downloads is @emph{authentic} by verifying that commits are signed by Guix developers."
  8516. msgstr ""
  8517. #. type: Plain text
  8518. #: guix-git/doc/guix.texi:4301
  8519. msgid "Specifically, @command{guix pull} downloads code from the @dfn{channels} (@pxref{Channels}) specified by one of the followings, in this order:"
  8520. msgstr ""
  8521. #. type: enumerate
  8522. #: guix-git/doc/guix.texi:4305
  8523. msgid "the @option{--channels} option;"
  8524. msgstr ""
  8525. #. type: enumerate
  8526. #: guix-git/doc/guix.texi:4307
  8527. msgid "the user's @file{~/.config/guix/channels.scm} file;"
  8528. msgstr ""
  8529. #. type: enumerate
  8530. #: guix-git/doc/guix.texi:4309
  8531. msgid "the system-wide @file{/etc/guix/channels.scm} file;"
  8532. msgstr ""
  8533. #. type: enumerate
  8534. #: guix-git/doc/guix.texi:4312
  8535. msgid "the built-in default channels specified in the @code{%default-channels} variable."
  8536. msgstr ""
  8537. #. type: Plain text
  8538. #: guix-git/doc/guix.texi:4319
  8539. msgid "On completion, @command{guix package} will use packages and package versions from this just-retrieved copy of Guix. Not only that, but all the Guix commands and Scheme modules will also be taken from that latest version. New @command{guix} sub-commands added by the update also become available."
  8540. msgstr ""
  8541. #. type: Plain text
  8542. #: guix-git/doc/guix.texi:4325
  8543. msgid "Any user can update their Guix copy using @command{guix pull}, and the effect is limited to the user who ran @command{guix pull}. For instance, when user @code{root} runs @command{guix pull}, this has no effect on the version of Guix that user @code{alice} sees, and vice versa."
  8544. msgstr ""
  8545. #. type: Plain text
  8546. #: guix-git/doc/guix.texi:4331
  8547. msgid "The result of running @command{guix pull} is a @dfn{profile} available under @file{~/.config/guix/current} containing the latest Guix. Thus, make sure to add it to the beginning of your search path so that you use the latest version, and similarly for the Info manual (@pxref{Documentation}):"
  8548. msgstr ""
  8549. #. type: example
  8550. #: guix-git/doc/guix.texi:4335
  8551. #, no-wrap
  8552. msgid ""
  8553. "export PATH=\"$HOME/.config/guix/current/bin:$PATH\"\n"
  8554. "export INFOPATH=\"$HOME/.config/guix/current/share/info:$INFOPATH\"\n"
  8555. msgstr ""
  8556. #. type: Plain text
  8557. #: guix-git/doc/guix.texi:4339
  8558. msgid "The @option{--list-generations} or @option{-l} option lists past generations produced by @command{guix pull}, along with details about their provenance:"
  8559. msgstr ""
  8560. #. type: example
  8561. #: guix-git/doc/guix.texi:4347
  8562. #, no-wrap
  8563. msgid ""
  8564. "$ guix pull -l\n"
  8565. "Generation 1\tJun 10 2018 00:18:18\n"
  8566. " guix 65956ad\n"
  8567. " repository URL: https://git.savannah.gnu.org/git/guix.git\n"
  8568. " branch: origin/master\n"
  8569. " commit: 65956ad3526ba09e1f7a40722c96c6ef7c0936fe\n"
  8570. "\n"
  8571. msgstr ""
  8572. #. type: example
  8573. #: guix-git/doc/guix.texi:4357
  8574. #, no-wrap
  8575. msgid ""
  8576. "Generation 2\tJun 11 2018 11:02:49\n"
  8577. " guix e0cc7f6\n"
  8578. " repository URL: https://git.savannah.gnu.org/git/guix.git\n"
  8579. " branch: origin/master\n"
  8580. " commit: e0cc7f669bec22c37481dd03a7941c7d11a64f1d\n"
  8581. " 2 new packages: keepalived, libnfnetlink\n"
  8582. " 6 packages upgraded: emacs-nix-mode@@2.0.4,\n"
  8583. " guile2.0-guix@@0.14.0-12.77a1aac, guix@@0.14.0-12.77a1aac,\n"
  8584. " heimdal@@7.5.0, milkytracker@@1.02.00, nix@@2.0.4\n"
  8585. "\n"
  8586. msgstr ""
  8587. #. type: example
  8588. #: guix-git/doc/guix.texi:4365
  8589. #, no-wrap
  8590. msgid ""
  8591. "Generation 3\tJun 13 2018 23:31:07\t(current)\n"
  8592. " guix 844cc1c\n"
  8593. " repository URL: https://git.savannah.gnu.org/git/guix.git\n"
  8594. " branch: origin/master\n"
  8595. " commit: 844cc1c8f394f03b404c5bb3aee086922373490c\n"
  8596. " 28 new packages: emacs-helm-ls-git, emacs-helm-mu, @dots{}\n"
  8597. " 69 packages upgraded: borg@@1.1.6, cheese@@3.28.0, @dots{}\n"
  8598. msgstr ""
  8599. #. type: Plain text
  8600. #: guix-git/doc/guix.texi:4369
  8601. msgid "@xref{Invoking guix describe, @command{guix describe}}, for other ways to describe the current status of Guix."
  8602. msgstr ""
  8603. #. type: Plain text
  8604. #: guix-git/doc/guix.texi:4374
  8605. msgid "This @code{~/.config/guix/current} profile works exactly like the profiles created by @command{guix package} (@pxref{Invoking guix package}). That is, you can list generations, roll back to the previous generation---i.e., the previous Guix---and so on:"
  8606. msgstr ""
  8607. #. type: example
  8608. #: guix-git/doc/guix.texi:4380
  8609. #, no-wrap
  8610. msgid ""
  8611. "$ guix pull --roll-back\n"
  8612. "switched from generation 3 to 2\n"
  8613. "$ guix pull --delete-generations=1\n"
  8614. "deleting /var/guix/profiles/per-user/charlie/current-guix-1-link\n"
  8615. msgstr ""
  8616. #. type: Plain text
  8617. #: guix-git/doc/guix.texi:4384
  8618. msgid "You can also use @command{guix package} (@pxref{Invoking guix package}) to manage the profile by naming it explicitly:"
  8619. msgstr ""
  8620. #. type: example
  8621. #: guix-git/doc/guix.texi:4389
  8622. #, no-wrap
  8623. msgid ""
  8624. "$ guix package -p ~/.config/guix/current --roll-back\n"
  8625. "switched from generation 3 to 2\n"
  8626. "$ guix package -p ~/.config/guix/current --delete-generations=1\n"
  8627. "deleting /var/guix/profiles/per-user/charlie/current-guix-1-link\n"
  8628. msgstr ""
  8629. #. type: Plain text
  8630. #: guix-git/doc/guix.texi:4393
  8631. msgid "The @command{guix pull} command is usually invoked with no arguments, but it supports the following options:"
  8632. msgstr ""
  8633. #. type: item
  8634. #: guix-git/doc/guix.texi:4395 guix-git/doc/guix.texi:4553
  8635. #, no-wrap
  8636. msgid "--url=@var{url}"
  8637. msgstr ""
  8638. #. type: itemx
  8639. #: guix-git/doc/guix.texi:4396 guix-git/doc/guix.texi:4554
  8640. #, no-wrap
  8641. msgid "--commit=@var{commit}"
  8642. msgstr ""
  8643. #. type: itemx
  8644. #: guix-git/doc/guix.texi:4397 guix-git/doc/guix.texi:4555
  8645. #, no-wrap
  8646. msgid "--branch=@var{branch}"
  8647. msgstr ""
  8648. #. type: table
  8649. #: guix-git/doc/guix.texi:4401
  8650. msgid "Download code for the @code{guix} channel from the specified @var{url}, at the given @var{commit} (a valid Git commit ID represented as a hexadecimal string), or @var{branch}."
  8651. msgstr ""
  8652. #. type: cindex
  8653. #: guix-git/doc/guix.texi:4402 guix-git/doc/guix.texi:4999
  8654. #, no-wrap
  8655. msgid "@file{channels.scm}, configuration file"
  8656. msgstr ""
  8657. #. type: cindex
  8658. #: guix-git/doc/guix.texi:4403 guix-git/doc/guix.texi:5000
  8659. #, no-wrap
  8660. msgid "configuration file for channels"
  8661. msgstr ""
  8662. #. type: table
  8663. #: guix-git/doc/guix.texi:4407
  8664. msgid "These options are provided for convenience, but you can also specify your configuration in the @file{~/.config/guix/channels.scm} file or using the @option{--channels} option (see below)."
  8665. msgstr ""
  8666. #. type: item
  8667. #: guix-git/doc/guix.texi:4408 guix-git/doc/guix.texi:4560
  8668. #, no-wrap
  8669. msgid "--channels=@var{file}"
  8670. msgstr ""
  8671. #. type: itemx
  8672. #: guix-git/doc/guix.texi:4409 guix-git/doc/guix.texi:4561
  8673. #, no-wrap
  8674. msgid "-C @var{file}"
  8675. msgstr ""
  8676. #. type: table
  8677. #: guix-git/doc/guix.texi:4415
  8678. msgid "Read the list of channels from @var{file} instead of @file{~/.config/guix/channels.scm} or @file{/etc/guix/channels.scm}. @var{file} must contain Scheme code that evaluates to a list of channel objects. @xref{Channels}, for more information."
  8679. msgstr ""
  8680. #. type: cindex
  8681. #: guix-git/doc/guix.texi:4416
  8682. #, no-wrap
  8683. msgid "channel news"
  8684. msgstr ""
  8685. #. type: item
  8686. #: guix-git/doc/guix.texi:4417
  8687. #, no-wrap
  8688. msgid "--news"
  8689. msgstr ""
  8690. #. type: itemx
  8691. #: guix-git/doc/guix.texi:4418 guix-git/doc/guix.texi:5826
  8692. #: guix-git/doc/guix.texi:33896
  8693. #, no-wrap
  8694. msgid "-N"
  8695. msgstr ""
  8696. #. type: table
  8697. #: guix-git/doc/guix.texi:4422
  8698. msgid "Display the list of packages added or upgraded since the previous generation, as well as, occasionally, news written by channel authors for their users (@pxref{Channels, Writing Channel News})."
  8699. msgstr ""
  8700. #. type: table
  8701. #: guix-git/doc/guix.texi:4426
  8702. msgid "The package information is the same as displayed upon @command{guix pull} completion, but without ellipses; it is also similar to the output of @command{guix pull -l} for the last generation (see below)."
  8703. msgstr ""
  8704. #. type: table
  8705. #: guix-git/doc/guix.texi:4433
  8706. msgid "List all the generations of @file{~/.config/guix/current} or, if @var{pattern} is provided, the subset of generations that match @var{pattern}. The syntax of @var{pattern} is the same as with @code{guix package --list-generations} (@pxref{Invoking guix package})."
  8707. msgstr ""
  8708. #. type: table
  8709. #: guix-git/doc/guix.texi:4440
  8710. msgid "Roll back to the previous @dfn{generation} of @file{~/.config/guix/current}---i.e., undo the last transaction."
  8711. msgstr ""
  8712. #. type: table
  8713. #: guix-git/doc/guix.texi:4464
  8714. msgid "If the current generation matches, it is @emph{not} deleted."
  8715. msgstr ""
  8716. #. type: table
  8717. #: guix-git/doc/guix.texi:4470
  8718. msgid "@xref{Invoking guix describe}, for a way to display information about the current generation only."
  8719. msgstr ""
  8720. #. type: table
  8721. #: guix-git/doc/guix.texi:4474
  8722. msgid "Use @var{profile} instead of @file{~/.config/guix/current}."
  8723. msgstr ""
  8724. #. type: item
  8725. #: guix-git/doc/guix.texi:4475 guix-git/doc/guix.texi:10317
  8726. #, no-wrap
  8727. msgid "--dry-run"
  8728. msgstr ""
  8729. #. type: itemx
  8730. #: guix-git/doc/guix.texi:4476 guix-git/doc/guix.texi:10318
  8731. #: guix-git/doc/guix.texi:12241
  8732. #, no-wrap
  8733. msgid "-n"
  8734. msgstr ""
  8735. #. type: table
  8736. #: guix-git/doc/guix.texi:4479
  8737. msgid "Show which channel commit(s) would be used and what would be built or substituted but do not actually do it."
  8738. msgstr ""
  8739. #. type: item
  8740. #: guix-git/doc/guix.texi:4480 guix-git/doc/guix.texi:33915
  8741. #, no-wrap
  8742. msgid "--allow-downgrades"
  8743. msgstr ""
  8744. #. type: table
  8745. #: guix-git/doc/guix.texi:4483
  8746. msgid "Allow pulling older or unrelated revisions of channels than those currently in use."
  8747. msgstr ""
  8748. #. type: cindex
  8749. #: guix-git/doc/guix.texi:4484
  8750. #, no-wrap
  8751. msgid "downgrade attacks, protection against"
  8752. msgstr ""
  8753. #. type: table
  8754. #: guix-git/doc/guix.texi:4489
  8755. msgid "By default, @command{guix pull} protects against so-called ``downgrade attacks'' whereby the Git repository of a channel would be reset to an earlier or unrelated revision of itself, potentially leading you to install older, known-vulnerable versions of software packages."
  8756. msgstr ""
  8757. #. type: quotation
  8758. #: guix-git/doc/guix.texi:4493 guix-git/doc/guix.texi:33929
  8759. msgid "Make sure you understand its security implications before using @option{--allow-downgrades}."
  8760. msgstr ""
  8761. #. type: item
  8762. #: guix-git/doc/guix.texi:4495
  8763. #, no-wrap
  8764. msgid "--disable-authentication"
  8765. msgstr ""
  8766. #. type: table
  8767. #: guix-git/doc/guix.texi:4497
  8768. msgid "Allow pulling channel code without authenticating it."
  8769. msgstr ""
  8770. #. type: cindex
  8771. #: guix-git/doc/guix.texi:4498 guix-git/doc/guix.texi:5145
  8772. #, no-wrap
  8773. msgid "authentication, of channel code"
  8774. msgstr ""
  8775. #. type: table
  8776. #: guix-git/doc/guix.texi:4503
  8777. msgid "By default, @command{guix pull} authenticates code downloaded from channels by verifying that its commits are signed by authorized developers, and raises an error if this is not the case. This option instructs it to not perform any such verification."
  8778. msgstr ""
  8779. #. type: quotation
  8780. #: guix-git/doc/guix.texi:4507
  8781. msgid "Make sure you understand its security implications before using @option{--disable-authentication}."
  8782. msgstr ""
  8783. #. type: itemx
  8784. #: guix-git/doc/guix.texi:4510 guix-git/doc/guix.texi:5809
  8785. #: guix-git/doc/guix.texi:6209 guix-git/doc/guix.texi:10868
  8786. #: guix-git/doc/guix.texi:12386 guix-git/doc/guix.texi:12637
  8787. #: guix-git/doc/guix.texi:13314 guix-git/doc/guix.texi:33844
  8788. #, no-wrap
  8789. msgid "-s @var{system}"
  8790. msgstr ""
  8791. #. type: table
  8792. #: guix-git/doc/guix.texi:4513 guix-git/doc/guix.texi:6212
  8793. msgid "Attempt to build for @var{system}---e.g., @code{i686-linux}---instead of the system type of the build host."
  8794. msgstr ""
  8795. #. type: table
  8796. #: guix-git/doc/guix.texi:4517
  8797. msgid "Use the bootstrap Guile to build the latest Guix. This option is only useful to Guix developers."
  8798. msgstr ""
  8799. #. type: Plain text
  8800. #: guix-git/doc/guix.texi:4523
  8801. msgid "The @dfn{channel} mechanism allows you to instruct @command{guix pull} which repository and branch to pull from, as well as @emph{additional} repositories containing package modules that should be deployed. @xref{Channels}, for more information."
  8802. msgstr ""
  8803. #. type: Plain text
  8804. #: guix-git/doc/guix.texi:4526
  8805. msgid "In addition, @command{guix pull} supports all the common build options (@pxref{Common Build Options})."
  8806. msgstr ""
  8807. #. type: section
  8808. #: guix-git/doc/guix.texi:4528
  8809. #, no-wrap
  8810. msgid "Invoking @command{guix time-machine}"
  8811. msgstr ""
  8812. #. type: command{#1}
  8813. #: guix-git/doc/guix.texi:4530
  8814. #, no-wrap
  8815. msgid "guix time-machine"
  8816. msgstr ""
  8817. #. type: cindex
  8818. #: guix-git/doc/guix.texi:4531 guix-git/doc/guix.texi:5103
  8819. #, no-wrap
  8820. msgid "pinning, channels"
  8821. msgstr ""
  8822. #. type: cindex
  8823. #: guix-git/doc/guix.texi:4532 guix-git/doc/guix.texi:4714
  8824. #: guix-git/doc/guix.texi:5104
  8825. #, no-wrap
  8826. msgid "replicating Guix"
  8827. msgstr ""
  8828. #. type: cindex
  8829. #: guix-git/doc/guix.texi:4533 guix-git/doc/guix.texi:5105
  8830. #, no-wrap
  8831. msgid "reproducibility, of Guix"
  8832. msgstr ""
  8833. #. type: Plain text
  8834. #: guix-git/doc/guix.texi:4541
  8835. msgid "The @command{guix time-machine} command provides access to other revisions of Guix, for example to install older versions of packages, or to reproduce a computation in an identical environment. The revision of Guix to be used is defined by a commit or by a channel description file created by @command{guix describe} (@pxref{Invoking guix describe})."
  8836. msgstr ""
  8837. #. type: Plain text
  8838. #: guix-git/doc/guix.texi:4543 guix-git/doc/guix.texi:5558
  8839. #: guix-git/doc/guix.texi:6332 guix-git/doc/guix.texi:10114
  8840. #: guix-git/doc/guix.texi:10237 guix-git/doc/guix.texi:11159
  8841. #: guix-git/doc/guix.texi:11236 guix-git/doc/guix.texi:12216
  8842. #: guix-git/doc/guix.texi:12695 guix-git/doc/guix.texi:13068
  8843. #: guix-git/doc/guix.texi:13157 guix-git/doc/guix.texi:13196
  8844. #: guix-git/doc/guix.texi:13293
  8845. msgid "The general syntax is:"
  8846. msgstr ""
  8847. #. type: example
  8848. #: guix-git/doc/guix.texi:4546
  8849. #, no-wrap
  8850. msgid "guix time-machine @var{options}@dots{} -- @var{command} @var {arg}@dots{}\n"
  8851. msgstr ""
  8852. #. type: Plain text
  8853. #: guix-git/doc/guix.texi:4551
  8854. msgid "where @var{command} and @var{arg}@dots{} are passed unmodified to the @command{guix} command of the specified revision. The @var{options} that define this revision are the same as for @command{guix pull} (@pxref{Invoking guix pull}):"
  8855. msgstr ""
  8856. #. type: table
  8857. #: guix-git/doc/guix.texi:4559
  8858. msgid "Use the @code{guix} channel from the specified @var{url}, at the given @var{commit} (a valid Git commit ID represented as a hexadecimal string), or @var{branch}."
  8859. msgstr ""
  8860. #. type: table
  8861. #: guix-git/doc/guix.texi:4565
  8862. msgid "Read the list of channels from @var{file}. @var{file} must contain Scheme code that evaluates to a list of channel objects. @xref{Channels} for more information."
  8863. msgstr ""
  8864. #. type: Plain text
  8865. #: guix-git/doc/guix.texi:4569
  8866. msgid "As for @command{guix pull}, the absence of any options means that the latest commit on the master branch will be used. The command"
  8867. msgstr ""
  8868. #. type: example
  8869. #: guix-git/doc/guix.texi:4572
  8870. #, no-wrap
  8871. msgid "guix time-machine -- build hello\n"
  8872. msgstr ""
  8873. #. type: Plain text
  8874. #: guix-git/doc/guix.texi:4577
  8875. msgid "will thus build the package @code{hello} as defined in the master branch, which is in general a newer revision of Guix than you have installed. Time travel works in both directions!"
  8876. msgstr ""
  8877. #. type: Plain text
  8878. #: guix-git/doc/guix.texi:4581
  8879. msgid "Note that @command{guix time-machine} can trigger builds of channels and their dependencies, and these are controlled by the standard build options (@pxref{Common Build Options})."
  8880. msgstr ""
  8881. #. type: quotation
  8882. #: guix-git/doc/guix.texi:4589
  8883. msgid "The functionality described here is a ``technology preview'' as of version @value{VERSION}. As such, the interface is subject to change."
  8884. msgstr ""
  8885. #. type: cindex
  8886. #: guix-git/doc/guix.texi:4591 guix-git/doc/guix.texi:10151
  8887. #, no-wrap
  8888. msgid "inferiors"
  8889. msgstr ""
  8890. #. type: cindex
  8891. #: guix-git/doc/guix.texi:4592
  8892. #, no-wrap
  8893. msgid "composition of Guix revisions"
  8894. msgstr ""
  8895. #. type: Plain text
  8896. #: guix-git/doc/guix.texi:4597
  8897. msgid "Sometimes you might need to mix packages from the revision of Guix you're currently running with packages available in a different revision of Guix. Guix @dfn{inferiors} allow you to achieve that by composing different Guix revisions in arbitrary ways."
  8898. msgstr ""
  8899. #. type: cindex
  8900. #: guix-git/doc/guix.texi:4598 guix-git/doc/guix.texi:4663
  8901. #, no-wrap
  8902. msgid "inferior packages"
  8903. msgstr ""
  8904. #. type: Plain text
  8905. #: guix-git/doc/guix.texi:4604
  8906. msgid "Technically, an ``inferior'' is essentially a separate Guix process connected to your main Guix process through a REPL (@pxref{Invoking guix repl}). The @code{(guix inferior)} module allows you to create inferiors and to communicate with them. It also provides a high-level interface to browse and manipulate the packages that an inferior provides---@dfn{inferior packages}."
  8907. msgstr ""
  8908. #. type: Plain text
  8909. #: guix-git/doc/guix.texi:4614
  8910. msgid "When combined with channels (@pxref{Channels}), inferiors provide a simple way to interact with a separate revision of Guix. For example, let's assume you want to install in your profile the current @code{guile} package, along with the @code{guile-json} as it existed in an older revision of Guix---perhaps because the newer @code{guile-json} has an incompatible API and you want to run your code against the old API@. To do that, you could write a manifest for use by @code{guix package --manifest} (@pxref{Invoking guix package}); in that manifest, you would create an inferior for that old Guix revision you care about, and you would look up the @code{guile-json} package in the inferior:"
  8911. msgstr ""
  8912. #. type: lisp
  8913. #: guix-git/doc/guix.texi:4618
  8914. #, no-wrap
  8915. msgid ""
  8916. "(use-modules (guix inferior) (guix channels)\n"
  8917. " (srfi srfi-1)) ;for 'first'\n"
  8918. "\n"
  8919. msgstr ""
  8920. #. type: lisp
  8921. #: guix-git/doc/guix.texi:4627
  8922. #, no-wrap
  8923. msgid ""
  8924. "(define channels\n"
  8925. " ;; This is the old revision from which we want to\n"
  8926. " ;; extract guile-json.\n"
  8927. " (list (channel\n"
  8928. " (name 'guix)\n"
  8929. " (url \"https://git.savannah.gnu.org/git/guix.git\")\n"
  8930. " (commit\n"
  8931. " \"65956ad3526ba09e1f7a40722c96c6ef7c0936fe\"))))\n"
  8932. "\n"
  8933. msgstr ""
  8934. #. type: lisp
  8935. #: guix-git/doc/guix.texi:4631
  8936. #, no-wrap
  8937. msgid ""
  8938. "(define inferior\n"
  8939. " ;; An inferior representing the above revision.\n"
  8940. " (inferior-for-channels channels))\n"
  8941. "\n"
  8942. msgstr ""
  8943. #. type: lisp
  8944. #: guix-git/doc/guix.texi:4637
  8945. #, no-wrap
  8946. msgid ""
  8947. ";; Now create a manifest with the current \"guile\" package\n"
  8948. ";; and the old \"guile-json\" package.\n"
  8949. "(packages->manifest\n"
  8950. " (list (first (lookup-inferior-packages inferior \"guile-json\"))\n"
  8951. " (specification->package \"guile\")))\n"
  8952. msgstr ""
  8953. #. type: Plain text
  8954. #: guix-git/doc/guix.texi:4642
  8955. msgid "On its first run, @command{guix package --manifest} might have to build the channel you specified before it can create the inferior; subsequent runs will be much faster because the Guix revision will be cached."
  8956. msgstr ""
  8957. #. type: Plain text
  8958. #: guix-git/doc/guix.texi:4645
  8959. msgid "The @code{(guix inferior)} module provides the following procedures to open an inferior:"
  8960. msgstr ""
  8961. #. type: deffn
  8962. #: guix-git/doc/guix.texi:4646
  8963. #, no-wrap
  8964. msgid "{Scheme Procedure} inferior-for-channels @var{channels} @"
  8965. msgstr ""
  8966. #. type: deffn
  8967. #: guix-git/doc/guix.texi:4651
  8968. msgid "[#:cache-directory] [#:ttl] Return an inferior for @var{channels}, a list of channels. Use the cache at @var{cache-directory}, where entries can be reclaimed after @var{ttl} seconds. This procedure opens a new connection to the build daemon."
  8969. msgstr ""
  8970. #. type: deffn
  8971. #: guix-git/doc/guix.texi:4654
  8972. msgid "As a side effect, this procedure may build or substitute binaries for @var{channels}, which can take time."
  8973. msgstr ""
  8974. #. type: deffn
  8975. #: guix-git/doc/guix.texi:4656
  8976. #, no-wrap
  8977. msgid "{Scheme Procedure} open-inferior @var{directory} @"
  8978. msgstr ""
  8979. #. type: deffn
  8980. #: guix-git/doc/guix.texi:4661
  8981. msgid "[#:command \"bin/guix\"] Open the inferior Guix in @var{directory}, running @code{@var{directory}/@var{command} repl} or equivalent. Return @code{#f} if the inferior could not be launched."
  8982. msgstr ""
  8983. #. type: Plain text
  8984. #: guix-git/doc/guix.texi:4666
  8985. msgid "The procedures listed below allow you to obtain and manipulate inferior packages."
  8986. msgstr ""
  8987. #. type: deffn
  8988. #: guix-git/doc/guix.texi:4667
  8989. #, no-wrap
  8990. msgid "{Scheme Procedure} inferior-packages @var{inferior}"
  8991. msgstr ""
  8992. #. type: deffn
  8993. #: guix-git/doc/guix.texi:4669
  8994. msgid "Return the list of packages known to @var{inferior}."
  8995. msgstr ""
  8996. #. type: deffn
  8997. #: guix-git/doc/guix.texi:4671
  8998. #, no-wrap
  8999. msgid "{Scheme Procedure} lookup-inferior-packages @var{inferior} @var{name} @"
  9000. msgstr ""
  9001. #. type: deffn
  9002. #: guix-git/doc/guix.texi:4676
  9003. msgid "[@var{version}] Return the sorted list of inferior packages matching @var{name} in @var{inferior}, with highest version numbers first. If @var{version} is true, return only packages with a version number prefixed by @var{version}."
  9004. msgstr ""
  9005. #. type: deffn
  9006. #: guix-git/doc/guix.texi:4678
  9007. #, no-wrap
  9008. msgid "{Scheme Procedure} inferior-package? @var{obj}"
  9009. msgstr ""
  9010. #. type: deffn
  9011. #: guix-git/doc/guix.texi:4680
  9012. msgid "Return true if @var{obj} is an inferior package."
  9013. msgstr ""
  9014. #. type: deffn
  9015. #: guix-git/doc/guix.texi:4682
  9016. #, no-wrap
  9017. msgid "{Scheme Procedure} inferior-package-name @var{package}"
  9018. msgstr ""
  9019. #. type: deffnx
  9020. #: guix-git/doc/guix.texi:4683
  9021. #, no-wrap
  9022. msgid "{Scheme Procedure} inferior-package-version @var{package}"
  9023. msgstr ""
  9024. #. type: deffnx
  9025. #: guix-git/doc/guix.texi:4684
  9026. #, no-wrap
  9027. msgid "{Scheme Procedure} inferior-package-synopsis @var{package}"
  9028. msgstr ""
  9029. #. type: deffnx
  9030. #: guix-git/doc/guix.texi:4685
  9031. #, no-wrap
  9032. msgid "{Scheme Procedure} inferior-package-description @var{package}"
  9033. msgstr ""
  9034. #. type: deffnx
  9035. #: guix-git/doc/guix.texi:4686
  9036. #, no-wrap
  9037. msgid "{Scheme Procedure} inferior-package-home-page @var{package}"
  9038. msgstr ""
  9039. #. type: deffnx
  9040. #: guix-git/doc/guix.texi:4687
  9041. #, no-wrap
  9042. msgid "{Scheme Procedure} inferior-package-location @var{package}"
  9043. msgstr ""
  9044. #. type: deffnx
  9045. #: guix-git/doc/guix.texi:4688
  9046. #, no-wrap
  9047. msgid "{Scheme Procedure} inferior-package-inputs @var{package}"
  9048. msgstr ""
  9049. #. type: deffnx
  9050. #: guix-git/doc/guix.texi:4689
  9051. #, no-wrap
  9052. msgid "{Scheme Procedure} inferior-package-native-inputs @var{package}"
  9053. msgstr ""
  9054. #. type: deffnx
  9055. #: guix-git/doc/guix.texi:4690
  9056. #, no-wrap
  9057. msgid "{Scheme Procedure} inferior-package-propagated-inputs @var{package}"
  9058. msgstr ""
  9059. #. type: deffnx
  9060. #: guix-git/doc/guix.texi:4691
  9061. #, no-wrap
  9062. msgid "{Scheme Procedure} inferior-package-transitive-propagated-inputs @var{package}"
  9063. msgstr ""
  9064. #. type: deffnx
  9065. #: guix-git/doc/guix.texi:4692
  9066. #, no-wrap
  9067. msgid "{Scheme Procedure} inferior-package-native-search-paths @var{package}"
  9068. msgstr ""
  9069. #. type: deffnx
  9070. #: guix-git/doc/guix.texi:4693
  9071. #, no-wrap
  9072. msgid "{Scheme Procedure} inferior-package-transitive-native-search-paths @var{package}"
  9073. msgstr ""
  9074. #. type: deffnx
  9075. #: guix-git/doc/guix.texi:4694
  9076. #, no-wrap
  9077. msgid "{Scheme Procedure} inferior-package-search-paths @var{package}"
  9078. msgstr ""
  9079. #. type: deffn
  9080. #: guix-git/doc/guix.texi:4699
  9081. msgid "These procedures are the counterpart of package record accessors (@pxref{package Reference}). Most of them work by querying the inferior @var{package} comes from, so the inferior must still be live when you call these procedures."
  9082. msgstr ""
  9083. #. type: Plain text
  9084. #: guix-git/doc/guix.texi:4709
  9085. msgid "Inferior packages can be used transparently like any other package or file-like object in G-expressions (@pxref{G-Expressions}). They are also transparently handled by the @code{packages->manifest} procedure, which is commonly used in manifests (@pxref{Invoking guix package, the @option{--manifest} option of @command{guix package}}). Thus you can insert an inferior package pretty much anywhere you would insert a regular package: in manifests, in the @code{packages} field of your @code{operating-system} declaration, and so on."
  9086. msgstr ""
  9087. #. type: section
  9088. #: guix-git/doc/guix.texi:4711
  9089. #, no-wrap
  9090. msgid "Invoking @command{guix describe}"
  9091. msgstr ""
  9092. #. type: Plain text
  9093. #: guix-git/doc/guix.texi:4722
  9094. msgid "Often you may want to answer questions like: ``Which revision of Guix am I using?'' or ``Which channels am I using?'' This is useful information in many situations: if you want to @emph{replicate} an environment on a different machine or user account, if you want to report a bug or to determine what change in the channels you are using caused it, or if you want to record your system state for reproducibility purposes. The @command{guix describe} command answers these questions."
  9095. msgstr ""
  9096. #. type: Plain text
  9097. #: guix-git/doc/guix.texi:4726
  9098. msgid "When run from a @command{guix pull}ed @command{guix}, @command{guix describe} displays the channel(s) that it was built from, including their repository URL and commit IDs (@pxref{Channels}):"
  9099. msgstr ""
  9100. #. type: example
  9101. #: guix-git/doc/guix.texi:4734
  9102. #, no-wrap
  9103. msgid ""
  9104. "$ guix describe\n"
  9105. "Generation 10\tSep 03 2018 17:32:44\t(current)\n"
  9106. " guix e0fa68c\n"
  9107. " repository URL: https://git.savannah.gnu.org/git/guix.git\n"
  9108. " branch: master\n"
  9109. " commit: e0fa68c7718fffd33d81af415279d6ddb518f727\n"
  9110. msgstr ""
  9111. #. type: Plain text
  9112. #: guix-git/doc/guix.texi:4743
  9113. msgid "If you're familiar with the Git version control system, this is similar in spirit to @command{git describe}; the output is also similar to that of @command{guix pull --list-generations}, but limited to the current generation (@pxref{Invoking guix pull, the @option{--list-generations} option}). Because the Git commit ID shown above unambiguously refers to a snapshot of Guix, this information is all it takes to describe the revision of Guix you're using, and also to replicate it."
  9114. msgstr ""
  9115. #. type: Plain text
  9116. #: guix-git/doc/guix.texi:4746
  9117. msgid "To make it easier to replicate Guix, @command{guix describe} can also be asked to return a list of channels instead of the human-readable description above:"
  9118. msgstr ""
  9119. #. type: example
  9120. #: guix-git/doc/guix.texi:4759
  9121. #, no-wrap
  9122. msgid ""
  9123. "$ guix describe -f channels\n"
  9124. "(list (channel\n"
  9125. " (name 'guix)\n"
  9126. " (url \"https://git.savannah.gnu.org/git/guix.git\")\n"
  9127. " (commit\n"
  9128. " \"e0fa68c7718fffd33d81af415279d6ddb518f727\")\n"
  9129. " (introduction\n"
  9130. " (make-channel-introduction\n"
  9131. " \"9edb3f66fd807b096b48283debdcddccfea34bad\"\n"
  9132. " (openpgp-fingerprint\n"
  9133. " \"BBB0 2DDF 2CEA F6A8 0D1D E643 A2A0 6DF2 A33A 54FA\")))))\n"
  9134. msgstr ""
  9135. #. type: Plain text
  9136. #: guix-git/doc/guix.texi:4768
  9137. msgid "You can save this to a file and feed it to @command{guix pull -C} on some other machine or at a later point in time, which will instantiate @emph{this exact Guix revision} (@pxref{Invoking guix pull, the @option{-C} option}). From there on, since you're able to deploy the same revision of Guix, you can just as well @emph{replicate a complete software environment}. We humbly think that this is @emph{awesome}, and we hope you'll like it too!"
  9138. msgstr ""
  9139. #. type: Plain text
  9140. #: guix-git/doc/guix.texi:4771
  9141. msgid "The details of the options supported by @command{guix describe} are as follows:"
  9142. msgstr ""
  9143. #. type: item
  9144. #: guix-git/doc/guix.texi:4773 guix-git/doc/guix.texi:6010
  9145. #: guix-git/doc/guix.texi:13426
  9146. #, no-wrap
  9147. msgid "--format=@var{format}"
  9148. msgstr ""
  9149. #. type: itemx
  9150. #: guix-git/doc/guix.texi:4774 guix-git/doc/guix.texi:6011
  9151. #: guix-git/doc/guix.texi:13427
  9152. #, no-wrap
  9153. msgid "-f @var{format}"
  9154. msgstr ""
  9155. #. type: table
  9156. #: guix-git/doc/guix.texi:4776 guix-git/doc/guix.texi:13429
  9157. msgid "Produce output in the specified @var{format}, one of:"
  9158. msgstr ""
  9159. #. type: item
  9160. #: guix-git/doc/guix.texi:4778
  9161. #, no-wrap
  9162. msgid "human"
  9163. msgstr ""
  9164. #. type: table
  9165. #: guix-git/doc/guix.texi:4780
  9166. msgid "produce human-readable output;"
  9167. msgstr ""
  9168. #. type: cindex
  9169. #: guix-git/doc/guix.texi:4780 guix-git/doc/guix.texi:4998
  9170. #, no-wrap
  9171. msgid "channels"
  9172. msgstr ""
  9173. #. type: table
  9174. #: guix-git/doc/guix.texi:4784
  9175. msgid "produce a list of channel specifications that can be passed to @command{guix pull -C} or installed as @file{~/.config/guix/channels.scm} (@pxref{Invoking guix pull});"
  9176. msgstr ""
  9177. #. type: item
  9178. #: guix-git/doc/guix.texi:4784
  9179. #, no-wrap
  9180. msgid "channels-sans-intro"
  9181. msgstr ""
  9182. #. type: table
  9183. #: guix-git/doc/guix.texi:4790
  9184. msgid "like @code{channels}, but omit the @code{introduction} field; use it to produce a channel specification suitable for Guix version 1.1.0 or earlier---the @code{introduction} field has to do with channel authentication (@pxref{Channels, Channel Authentication}) and is not supported by these older versions;"
  9185. msgstr ""
  9186. #. type: item
  9187. #: guix-git/doc/guix.texi:4790 guix-git/doc/guix.texi:11454
  9188. #, no-wrap
  9189. msgid "json"
  9190. msgstr ""
  9191. #. type: cindex
  9192. #: guix-git/doc/guix.texi:4791
  9193. #, no-wrap
  9194. msgid "JSON"
  9195. msgstr ""
  9196. #. type: table
  9197. #: guix-git/doc/guix.texi:4793
  9198. msgid "produce a list of channel specifications in JSON format;"
  9199. msgstr ""
  9200. #. type: item
  9201. #: guix-git/doc/guix.texi:4793 guix-git/doc/guix.texi:13431
  9202. #, no-wrap
  9203. msgid "recutils"
  9204. msgstr ""
  9205. #. type: table
  9206. #: guix-git/doc/guix.texi:4795
  9207. msgid "produce a list of channel specifications in Recutils format."
  9208. msgstr ""
  9209. #. type: item
  9210. #: guix-git/doc/guix.texi:4797
  9211. #, no-wrap
  9212. msgid "--list-formats"
  9213. msgstr ""
  9214. #. type: table
  9215. #: guix-git/doc/guix.texi:4799
  9216. msgid "Display available formats for @option{--format} option."
  9217. msgstr ""
  9218. #. type: table
  9219. #: guix-git/doc/guix.texi:4803
  9220. msgid "Display information about @var{profile}."
  9221. msgstr ""
  9222. #. type: section
  9223. #: guix-git/doc/guix.texi:4806
  9224. #, no-wrap
  9225. msgid "Invoking @command{guix archive}"
  9226. msgstr ""
  9227. #. type: command{#1}
  9228. #: guix-git/doc/guix.texi:4808
  9229. #, no-wrap
  9230. msgid "guix archive"
  9231. msgstr ""
  9232. #. type: cindex
  9233. #: guix-git/doc/guix.texi:4809
  9234. #, no-wrap
  9235. msgid "archive"
  9236. msgstr ""
  9237. #. type: Plain text
  9238. #: guix-git/doc/guix.texi:4815
  9239. msgid "The @command{guix archive} command allows users to @dfn{export} files from the store into a single archive, and to later @dfn{import} them on a machine that runs Guix. In particular, it allows store files to be transferred from one machine to the store on another machine."
  9240. msgstr ""
  9241. #. type: quotation
  9242. #: guix-git/doc/guix.texi:4819
  9243. msgid "If you're looking for a way to produce archives in a format suitable for tools other than Guix, @pxref{Invoking guix pack}."
  9244. msgstr ""
  9245. #. type: cindex
  9246. #: guix-git/doc/guix.texi:4821
  9247. #, no-wrap
  9248. msgid "exporting store items"
  9249. msgstr ""
  9250. #. type: Plain text
  9251. #: guix-git/doc/guix.texi:4823
  9252. msgid "To export store files as an archive to standard output, run:"
  9253. msgstr ""
  9254. #. type: example
  9255. #: guix-git/doc/guix.texi:4826
  9256. #, no-wrap
  9257. msgid "guix archive --export @var{options} @var{specifications}...\n"
  9258. msgstr ""
  9259. #. type: Plain text
  9260. #: guix-git/doc/guix.texi:4833
  9261. msgid "@var{specifications} may be either store file names or package specifications, as for @command{guix package} (@pxref{Invoking guix package}). For instance, the following command creates an archive containing the @code{gui} output of the @code{git} package and the main output of @code{emacs}:"
  9262. msgstr ""
  9263. #. type: example
  9264. #: guix-git/doc/guix.texi:4836
  9265. #, no-wrap
  9266. msgid "guix archive --export git:gui /gnu/store/...-emacs-24.3 > great.nar\n"
  9267. msgstr ""
  9268. #. type: Plain text
  9269. #: guix-git/doc/guix.texi:4841
  9270. msgid "If the specified packages are not built yet, @command{guix archive} automatically builds them. The build process may be controlled with the common build options (@pxref{Common Build Options})."
  9271. msgstr ""
  9272. #. type: Plain text
  9273. #: guix-git/doc/guix.texi:4844
  9274. msgid "To transfer the @code{emacs} package to a machine connected over SSH, one would run:"
  9275. msgstr ""
  9276. #. type: example
  9277. #: guix-git/doc/guix.texi:4847
  9278. #, no-wrap
  9279. msgid "guix archive --export -r emacs | ssh the-machine guix archive --import\n"
  9280. msgstr ""
  9281. #. type: Plain text
  9282. #: guix-git/doc/guix.texi:4852
  9283. msgid "Similarly, a complete user profile may be transferred from one machine to another like this:"
  9284. msgstr ""
  9285. #. type: example
  9286. #: guix-git/doc/guix.texi:4856
  9287. #, no-wrap
  9288. msgid ""
  9289. "guix archive --export -r $(readlink -f ~/.guix-profile) | \\\n"
  9290. " ssh the-machine guix archive --import\n"
  9291. msgstr ""
  9292. #. type: Plain text
  9293. #: guix-git/doc/guix.texi:4866
  9294. msgid "However, note that, in both examples, all of @code{emacs} and the profile as well as all of their dependencies are transferred (due to @option{-r}), regardless of what is already available in the store on the target machine. The @option{--missing} option can help figure out which items are missing from the target store. The @command{guix copy} command simplifies and optimizes this whole process, so this is probably what you should use in this case (@pxref{Invoking guix copy})."
  9295. msgstr ""
  9296. #. type: cindex
  9297. #: guix-git/doc/guix.texi:4867
  9298. #, no-wrap
  9299. msgid "nar, archive format"
  9300. msgstr ""
  9301. #. type: cindex
  9302. #: guix-git/doc/guix.texi:4868
  9303. #, no-wrap
  9304. msgid "normalized archive (nar)"
  9305. msgstr ""
  9306. #. type: cindex
  9307. #: guix-git/doc/guix.texi:4869
  9308. #, no-wrap
  9309. msgid "nar bundle, archive format"
  9310. msgstr ""
  9311. #. type: Plain text
  9312. #: guix-git/doc/guix.texi:4874
  9313. msgid "Each store item is written in the @dfn{normalized archive} or @dfn{nar} format (described below), and the output of @command{guix archive --export} (and input of @command{guix archive --import}) is a @dfn{nar bundle}."
  9314. msgstr ""
  9315. #. type: Plain text
  9316. #: guix-git/doc/guix.texi:4884
  9317. msgid "The nar format is comparable in spirit to `tar', but with differences that make it more appropriate for our purposes. First, rather than recording all Unix metadata for each file, the nar format only mentions the file type (regular, directory, or symbolic link); Unix permissions and owner/group are dismissed. Second, the order in which directory entries are stored always follows the order of file names according to the C locale collation order. This makes archive production fully deterministic."
  9318. msgstr ""
  9319. #. type: Plain text
  9320. #: guix-git/doc/guix.texi:4888
  9321. msgid "That nar bundle format is essentially the concatenation of zero or more nars along with metadata for each store item it contains: its file name, references, corresponding derivation, and a digital signature."
  9322. msgstr ""
  9323. #. type: Plain text
  9324. #: guix-git/doc/guix.texi:4894
  9325. msgid "When exporting, the daemon digitally signs the contents of the archive, and that digital signature is appended. When importing, the daemon verifies the signature and rejects the import in case of an invalid signature or if the signing key is not authorized."
  9326. msgstr ""
  9327. #. type: Plain text
  9328. #: guix-git/doc/guix.texi:4896
  9329. msgid "The main options are:"
  9330. msgstr ""
  9331. #. type: item
  9332. #: guix-git/doc/guix.texi:4898
  9333. #, no-wrap
  9334. msgid "--export"
  9335. msgstr ""
  9336. #. type: table
  9337. #: guix-git/doc/guix.texi:4901
  9338. msgid "Export the specified store files or packages (see below). Write the resulting archive to the standard output."
  9339. msgstr ""
  9340. #. type: table
  9341. #: guix-git/doc/guix.texi:4904
  9342. msgid "Dependencies are @emph{not} included in the output, unless @option{--recursive} is passed."
  9343. msgstr ""
  9344. #. type: itemx
  9345. #: guix-git/doc/guix.texi:4905 guix-git/doc/guix.texi:11192
  9346. #: guix-git/doc/guix.texi:11294 guix-git/doc/guix.texi:11319
  9347. #: guix-git/doc/guix.texi:11351 guix-git/doc/guix.texi:11529
  9348. #: guix-git/doc/guix.texi:11570 guix-git/doc/guix.texi:11617
  9349. #: guix-git/doc/guix.texi:11642 guix-git/doc/guix.texi:11658
  9350. #: guix-git/doc/guix.texi:11706 guix-git/doc/guix.texi:11736
  9351. #, no-wrap
  9352. msgid "-r"
  9353. msgstr ""
  9354. #. type: item
  9355. #: guix-git/doc/guix.texi:4906 guix-git/doc/guix.texi:11191
  9356. #: guix-git/doc/guix.texi:11293 guix-git/doc/guix.texi:11318
  9357. #: guix-git/doc/guix.texi:11350 guix-git/doc/guix.texi:11528
  9358. #: guix-git/doc/guix.texi:11569 guix-git/doc/guix.texi:11616
  9359. #: guix-git/doc/guix.texi:11641 guix-git/doc/guix.texi:11657
  9360. #: guix-git/doc/guix.texi:11705 guix-git/doc/guix.texi:11735
  9361. #: guix-git/doc/guix.texi:11784
  9362. #, no-wrap
  9363. msgid "--recursive"
  9364. msgstr ""
  9365. #. type: table
  9366. #: guix-git/doc/guix.texi:4911
  9367. msgid "When combined with @option{--export}, this instructs @command{guix archive} to include dependencies of the given items in the archive. Thus, the resulting archive is self-contained: it contains the closure of the exported store items."
  9368. msgstr ""
  9369. #. type: item
  9370. #: guix-git/doc/guix.texi:4912
  9371. #, no-wrap
  9372. msgid "--import"
  9373. msgstr ""
  9374. #. type: table
  9375. #: guix-git/doc/guix.texi:4917
  9376. msgid "Read an archive from the standard input, and import the files listed therein into the store. Abort if the archive has an invalid digital signature, or if it is signed by a public key not among the authorized keys (see @option{--authorize} below)."
  9377. msgstr ""
  9378. #. type: item
  9379. #: guix-git/doc/guix.texi:4918
  9380. #, no-wrap
  9381. msgid "--missing"
  9382. msgstr ""
  9383. #. type: table
  9384. #: guix-git/doc/guix.texi:4922
  9385. msgid "Read a list of store file names from the standard input, one per line, and write on the standard output the subset of these files missing from the store."
  9386. msgstr ""
  9387. #. type: item
  9388. #: guix-git/doc/guix.texi:4923
  9389. #, no-wrap
  9390. msgid "--generate-key[=@var{parameters}]"
  9391. msgstr ""
  9392. #. type: cindex
  9393. #: guix-git/doc/guix.texi:4924
  9394. #, no-wrap
  9395. msgid "signing, archives"
  9396. msgstr ""
  9397. #. type: table
  9398. #: guix-git/doc/guix.texi:4931
  9399. msgid "Generate a new key pair for the daemon. This is a prerequisite before archives can be exported with @option{--export}. This operation is usually instantaneous but it can take time if the system's entropy pool needs to be refilled. On Guix System, @code{guix-service-type} takes care of generating this key pair the first boot."
  9400. msgstr ""
  9401. #. type: table
  9402. #: guix-git/doc/guix.texi:4941
  9403. msgid "The generated key pair is typically stored under @file{/etc/guix}, in @file{signing-key.pub} (public key) and @file{signing-key.sec} (private key, which must be kept secret). When @var{parameters} is omitted, an ECDSA key using the Ed25519 curve is generated, or, for Libgcrypt versions before 1.6.0, it is a 4096-bit RSA key. Alternatively, @var{parameters} can specify @code{genkey} parameters suitable for Libgcrypt (@pxref{General public-key related Functions, @code{gcry_pk_genkey},, gcrypt, The Libgcrypt Reference Manual})."
  9404. msgstr ""
  9405. #. type: item
  9406. #: guix-git/doc/guix.texi:4942
  9407. #, no-wrap
  9408. msgid "--authorize"
  9409. msgstr ""
  9410. #. type: cindex
  9411. #: guix-git/doc/guix.texi:4943
  9412. #, no-wrap
  9413. msgid "authorizing, archives"
  9414. msgstr ""
  9415. #. type: table
  9416. #: guix-git/doc/guix.texi:4947
  9417. msgid "Authorize imports signed by the public key passed on standard input. The public key must be in ``s-expression advanced format''---i.e., the same format as the @file{signing-key.pub} file."
  9418. msgstr ""
  9419. #. type: table
  9420. #: guix-git/doc/guix.texi:4954
  9421. msgid "The list of authorized keys is kept in the human-editable file @file{/etc/guix/acl}. The file contains @url{https://people.csail.mit.edu/rivest/Sexp.txt, ``advanced-format s-expressions''} and is structured as an access-control list in the @url{https://theworld.com/~cme/spki.txt, Simple Public-Key Infrastructure (SPKI)}."
  9422. msgstr ""
  9423. #. type: item
  9424. #: guix-git/doc/guix.texi:4955
  9425. #, no-wrap
  9426. msgid "--extract=@var{directory}"
  9427. msgstr ""
  9428. #. type: itemx
  9429. #: guix-git/doc/guix.texi:4956
  9430. #, no-wrap
  9431. msgid "-x @var{directory}"
  9432. msgstr ""
  9433. #. type: table
  9434. #: guix-git/doc/guix.texi:4960
  9435. msgid "Read a single-item archive as served by substitute servers (@pxref{Substitutes}) and extract it to @var{directory}. This is a low-level operation needed in only very narrow use cases; see below."
  9436. msgstr ""
  9437. #. type: table
  9438. #: guix-git/doc/guix.texi:4963
  9439. msgid "For example, the following command extracts the substitute for Emacs served by @code{@value{SUBSTITUTE-SERVER-1}} to @file{/tmp/emacs}:"
  9440. msgstr ""
  9441. #. type: example
  9442. #: guix-git/doc/guix.texi:4968
  9443. #, no-wrap
  9444. msgid ""
  9445. "$ wget -O - \\\n"
  9446. " https://@value{SUBSTITUTE-SERVER-1}/nar/gzip/@dots{}-emacs-24.5 \\\n"
  9447. " | gunzip | guix archive -x /tmp/emacs\n"
  9448. msgstr ""
  9449. #. type: table
  9450. #: guix-git/doc/guix.texi:4975
  9451. msgid "Single-item archives are different from multiple-item archives produced by @command{guix archive --export}; they contain a single store item, and they do @emph{not} embed a signature. Thus this operation does @emph{no} signature verification and its output should be considered unsafe."
  9452. msgstr ""
  9453. #. type: table
  9454. #: guix-git/doc/guix.texi:4979
  9455. msgid "The primary purpose of this operation is to facilitate inspection of archive contents coming from possibly untrusted substitute servers (@pxref{Invoking guix challenge})."
  9456. msgstr ""
  9457. #. type: item
  9458. #: guix-git/doc/guix.texi:4980
  9459. #, no-wrap
  9460. msgid "--list"
  9461. msgstr ""
  9462. #. type: itemx
  9463. #: guix-git/doc/guix.texi:4981 guix-git/doc/guix.texi:11516
  9464. #: guix-git/doc/guix.texi:11563
  9465. #, no-wrap
  9466. msgid "-t"
  9467. msgstr ""
  9468. #. type: table
  9469. #: guix-git/doc/guix.texi:4985
  9470. msgid "Read a single-item archive as served by substitute servers (@pxref{Substitutes}) and print the list of files it contains, as in this example:"
  9471. msgstr ""
  9472. #. type: example
  9473. #: guix-git/doc/guix.texi:4990
  9474. #, no-wrap
  9475. msgid ""
  9476. "$ wget -O - \\\n"
  9477. " https://@value{SUBSTITUTE-SERVER-1}/nar/lzip/@dots{}-emacs-26.3 \\\n"
  9478. " | lzip -d | guix archive -t\n"
  9479. msgstr ""
  9480. #. type: cindex
  9481. #: guix-git/doc/guix.texi:5001
  9482. #, no-wrap
  9483. msgid "@command{guix pull}, configuration file"
  9484. msgstr ""
  9485. #. type: cindex
  9486. #: guix-git/doc/guix.texi:5002
  9487. #, no-wrap
  9488. msgid "configuration of @command{guix pull}"
  9489. msgstr ""
  9490. #. type: Plain text
  9491. #: guix-git/doc/guix.texi:5013
  9492. msgid "Guix and its package collection are updated by running @command{guix pull} (@pxref{Invoking guix pull}). By default @command{guix pull} downloads and deploys Guix itself from the official GNU@tie{}Guix repository. This can be customized by defining @dfn{channels} in the @file{~/.config/guix/channels.scm} file. A channel specifies a URL and branch of a Git repository to be deployed, and @command{guix pull} can be instructed to pull from one or more channels. In other words, channels can be used to @emph{customize} and to @emph{extend} Guix, as we will see below. Guix is able to take into account security concerns and deal with authenticated updates."
  9493. msgstr ""
  9494. #. type: cindex
  9495. #: guix-git/doc/guix.texi:5031
  9496. #, no-wrap
  9497. msgid "extending the package collection (channels)"
  9498. msgstr ""
  9499. #. type: cindex
  9500. #: guix-git/doc/guix.texi:5032
  9501. #, no-wrap
  9502. msgid "variant packages (channels)"
  9503. msgstr ""
  9504. #. type: Plain text
  9505. #: guix-git/doc/guix.texi:5036
  9506. msgid "You can specify @emph{additional channels} to pull from. To use a channel, write @code{~/.config/guix/channels.scm} to instruct @command{guix pull} to pull from it @emph{in addition} to the default Guix channel(s):"
  9507. msgstr ""
  9508. #. type: vindex
  9509. #: guix-git/doc/guix.texi:5037
  9510. #, no-wrap
  9511. msgid "%default-channels"
  9512. msgstr ""
  9513. #. type: lisp
  9514. #: guix-git/doc/guix.texi:5044
  9515. #, no-wrap
  9516. msgid ""
  9517. ";; Add variant packages to those Guix provides.\n"
  9518. "(cons (channel\n"
  9519. " (name 'variant-packages)\n"
  9520. " (url \"https://example.org/variant-packages.git\"))\n"
  9521. " %default-channels)\n"
  9522. msgstr ""
  9523. #. type: Plain text
  9524. #: guix-git/doc/guix.texi:5054
  9525. msgid "Note that the snippet above is (as always!)@: Scheme code; we use @code{cons} to add a channel the list of channels that the variable @code{%default-channels} is bound to (@pxref{Pairs, @code{cons} and lists,, guile, GNU Guile Reference Manual}). With this file in place, @command{guix pull} builds not only Guix but also the package modules from your own repository. The result in @file{~/.config/guix/current} is the union of Guix with your own package modules:"
  9526. msgstr ""
  9527. #. type: example
  9528. #: guix-git/doc/guix.texi:5069
  9529. #, no-wrap
  9530. msgid ""
  9531. "$ guix pull --list-generations\n"
  9532. "@dots{}\n"
  9533. "Generation 19\tAug 27 2018 16:20:48\n"
  9534. " guix d894ab8\n"
  9535. " repository URL: https://git.savannah.gnu.org/git/guix.git\n"
  9536. " branch: master\n"
  9537. " commit: d894ab8e9bfabcefa6c49d9ba2e834dd5a73a300\n"
  9538. " variant-packages dd3df5e\n"
  9539. " repository URL: https://example.org/variant-packages.git\n"
  9540. " branch: master\n"
  9541. " commit: dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb\n"
  9542. " 11 new packages: variant-gimp, variant-emacs-with-cool-features, @dots{}\n"
  9543. " 4 packages upgraded: emacs-racket-mode@@0.0.2-2.1b78827, @dots{}\n"
  9544. msgstr ""
  9545. #. type: Plain text
  9546. #: guix-git/doc/guix.texi:5077
  9547. msgid "The output of @command{guix pull} above shows that Generation@tie{}19 includes both Guix and packages from the @code{variant-personal-packages} channel. Among the new and upgraded packages that are listed, some like @code{variant-gimp} and @code{variant-emacs-with-cool-features} might come from @code{variant-packages}, while others come from the Guix default channel."
  9548. msgstr ""
  9549. #. type: Plain text
  9550. #: guix-git/doc/guix.texi:5086
  9551. msgid "The channel called @code{guix} specifies where Guix itself---its command-line tools as well as its package collection---should be downloaded. For instance, suppose you want to update from another copy of the Guix repository at @code{example.org}, and specifically the @code{super-hacks} branch, you can write in @code{~/.config/guix/channels.scm} this specification:"
  9552. msgstr ""
  9553. #. type: lisp
  9554. #: guix-git/doc/guix.texi:5093
  9555. #, no-wrap
  9556. msgid ""
  9557. ";; Tell 'guix pull' to use another repo.\n"
  9558. "(list (channel\n"
  9559. " (name 'guix)\n"
  9560. " (url \"https://example.org/another-guix.git\")\n"
  9561. " (branch \"super-hacks\")))\n"
  9562. msgstr ""
  9563. #. type: Plain text
  9564. #: guix-git/doc/guix.texi:5099
  9565. msgid "From there on, @command{guix pull} will fetch code from the @code{super-hacks} branch of the repository at @code{example.org}. The authentication concern is addressed below ((@pxref{Channel Authentication})."
  9566. msgstr ""
  9567. #. type: Plain text
  9568. #: guix-git/doc/guix.texi:5110
  9569. msgid "The @command{guix pull --list-generations} output above shows precisely which commits were used to build this instance of Guix. We can thus replicate it, say, on another machine, by providing a channel specification in @file{~/.config/guix/channels.scm} that is ``pinned'' to these commits:"
  9570. msgstr ""
  9571. #. type: lisp
  9572. #: guix-git/doc/guix.texi:5121
  9573. #, no-wrap
  9574. msgid ""
  9575. ";; Deploy specific commits of my channels of interest.\n"
  9576. "(list (channel\n"
  9577. " (name 'guix)\n"
  9578. " (url \"https://git.savannah.gnu.org/git/guix.git\")\n"
  9579. " (commit \"6298c3ffd9654d3231a6f25390b056483e8f407c\"))\n"
  9580. " (channel\n"
  9581. " (name 'variant-packages)\n"
  9582. " (url \"https://example.org/variant-packages.git\")\n"
  9583. " (commit \"dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb\")))\n"
  9584. msgstr ""
  9585. #. type: Plain text
  9586. #: guix-git/doc/guix.texi:5128
  9587. msgid "The @command{guix describe --format=channels} command can even generate this list of channels directly (@pxref{Invoking guix describe}). The resulting file can be used with the -C options of @command{guix pull} (@pxref{Invoking guix pull}) or @command{guix time-machine} (@pxref{Invoking guix time-machine})."
  9588. msgstr ""
  9589. #. type: Plain text
  9590. #: guix-git/doc/guix.texi:5135
  9591. msgid "At this point the two machines run the @emph{exact same Guix}, with access to the @emph{exact same packages}. The output of @command{guix build gimp} on one machine will be exactly the same, bit for bit, as the output of the same command on the other machine. It also means both machines have access to all the source code of Guix and, transitively, to all the source code of every package it defines."
  9592. msgstr ""
  9593. #. type: Plain text
  9594. #: guix-git/doc/guix.texi:5140
  9595. msgid "This gives you super powers, allowing you to track the provenance of binary artifacts with very fine grain, and to reproduce software environments at will---some sort of ``meta reproducibility'' capabilities, if you will. @xref{Inferiors}, for another way to take advantage of these super powers."
  9596. msgstr ""
  9597. #. type: anchor{#1}
  9598. #: guix-git/doc/guix.texi:5145
  9599. msgid "channel-authentication"
  9600. msgstr ""
  9601. #. type: Plain text
  9602. #: guix-git/doc/guix.texi:5151
  9603. msgid "The @command{guix pull} and @command{guix time-machine} commands @dfn{authenticate} the code retrieved from channels: they make sure each commit that is fetched is signed by an authorized developer. The goal is to protect from unauthorized modifications to the channel that would lead users to run malicious code."
  9604. msgstr ""
  9605. #. type: Plain text
  9606. #: guix-git/doc/guix.texi:5156
  9607. msgid "As a user, you must provide a @dfn{channel introduction} in your channels file so that Guix knows how to authenticate its first commit. A channel specification, including its introduction, looks something along these lines:"
  9608. msgstr ""
  9609. #. type: lisp
  9610. #: guix-git/doc/guix.texi:5166
  9611. #, no-wrap
  9612. msgid ""
  9613. "(channel\n"
  9614. " (name 'some-channel)\n"
  9615. " (url \"https://example.org/some-channel.git\")\n"
  9616. " (introduction\n"
  9617. " (make-channel-introduction\n"
  9618. " \"6f0d8cc0d88abb59c324b2990bfee2876016bb86\"\n"
  9619. " (openpgp-fingerprint\n"
  9620. " \"CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5\"))))\n"
  9621. msgstr ""
  9622. #. type: Plain text
  9623. #: guix-git/doc/guix.texi:5172
  9624. msgid "The specification above shows the name and URL of the channel. The call to @code{make-channel-introduction} above specifies that authentication of this channel starts at commit @code{6f0d8cc@dots{}}, which is signed by the OpenPGP key with fingerprint @code{CABB A931@dots{}}."
  9625. msgstr ""
  9626. #. type: Plain text
  9627. #: guix-git/doc/guix.texi:5178
  9628. msgid "For the main channel, called @code{guix}, you automatically get that information from your Guix installation. For other channels, include the channel introduction provided by the channel authors in your @file{channels.scm} file. Make sure you retrieve the channel introduction from a trusted source since that is the root of your trust."
  9629. msgstr ""
  9630. #. type: Plain text
  9631. #: guix-git/doc/guix.texi:5180
  9632. msgid "If you're curious about the authentication mechanics, read on!"
  9633. msgstr ""
  9634. #. type: Plain text
  9635. #: guix-git/doc/guix.texi:5191
  9636. msgid "When running @command{guix pull}, Guix will first compile the definitions of every available package. This is an expensive operation for which substitutes (@pxref{Substitutes}) may be available. The following snippet in @file{channels.scm} will ensure that @command{guix pull} uses the latest commit with available substitutes for the package definitions: this is done by querying the continuous integration server at @url{https://ci.guix.gnu.org}."
  9637. msgstr ""
  9638. #. type: lisp
  9639. #: guix-git/doc/guix.texi:5194
  9640. #, no-wrap
  9641. msgid ""
  9642. "(use-modules (guix ci))\n"
  9643. "\n"
  9644. msgstr ""
  9645. #. type: lisp
  9646. #: guix-git/doc/guix.texi:5198
  9647. #, no-wrap
  9648. msgid ""
  9649. "(list (channel-with-substitutes-available\n"
  9650. " %default-guix-channel\n"
  9651. " \"https://ci.guix.gnu.org\"))\n"
  9652. msgstr ""
  9653. #. type: Plain text
  9654. #: guix-git/doc/guix.texi:5205
  9655. msgid "Note that this does not mean that all the packages that you will install after running @command{guix pull} will have available substitutes. It only ensures that @command{guix pull} will not try to compile package definitions. This is particularly useful when using machines with limited resources."
  9656. msgstr ""
  9657. #. type: cindex
  9658. #: guix-git/doc/guix.texi:5209
  9659. #, no-wrap
  9660. msgid "personal packages (channels)"
  9661. msgstr ""
  9662. #. type: cindex
  9663. #: guix-git/doc/guix.texi:5210
  9664. #, no-wrap
  9665. msgid "channels, for personal packages"
  9666. msgstr ""
  9667. #. type: Plain text
  9668. #: guix-git/doc/guix.texi:5218
  9669. msgid "Let's say you have a bunch of custom package variants or personal packages that you think would make little sense to contribute to the Guix project, but would like to have these packages transparently available to you at the command line. You would first write modules containing those package definitions (@pxref{Package Modules}), maintain them in a Git repository, and then you and anyone else can use it as an additional channel to get packages from. Neat, no?"
  9670. msgstr ""
  9671. #. type: quotation
  9672. #: guix-git/doc/guix.texi:5222 guix-git/doc/guix.texi:6068
  9673. #: guix-git/doc/guix.texi:13784 guix-git/doc/guix.texi:19856
  9674. #: guix-git/doc/guix.texi:19863
  9675. #, no-wrap
  9676. msgid "Warning"
  9677. msgstr ""
  9678. #. type: quotation
  9679. #: guix-git/doc/guix.texi:5226
  9680. msgid "Before you, dear user, shout---``woow this is @emph{soooo coool}!''---and publish your personal channel to the world, we would like to share a few words of caution:"
  9681. msgstr ""
  9682. #. type: itemize
  9683. #: guix-git/doc/guix.texi:5234
  9684. msgid "Before publishing a channel, please consider contributing your package definitions to Guix proper (@pxref{Contributing}). Guix as a project is open to free software of all sorts, and packages in Guix proper are readily available to all Guix users and benefit from the project's quality assurance process."
  9685. msgstr ""
  9686. #. type: itemize
  9687. #: guix-git/doc/guix.texi:5243
  9688. msgid "When you maintain package definitions outside Guix, we, Guix developers, consider that @emph{the compatibility burden is on you}. Remember that package modules and package definitions are just Scheme code that uses various programming interfaces (APIs). We want to remain free to change these APIs to keep improving Guix, possibly in ways that break your channel. We never change APIs gratuitously, but we will @emph{not} commit to freezing APIs either."
  9689. msgstr ""
  9690. #. type: itemize
  9691. #: guix-git/doc/guix.texi:5247
  9692. msgid "Corollary: if you're using an external channel and that channel breaks, please @emph{report the issue to the channel authors}, not to the Guix project."
  9693. msgstr ""
  9694. #. type: quotation
  9695. #: guix-git/doc/guix.texi:5254
  9696. msgid "You've been warned! Having said this, we believe external channels are a practical way to exert your freedom to augment Guix' package collection and to share your improvements, which are basic tenets of @uref{https://www.gnu.org/philosophy/free-sw.html, free software}. Please email us at @email{guix-devel@@gnu.org} if you'd like to discuss this."
  9697. msgstr ""
  9698. #. type: Plain text
  9699. #: guix-git/doc/guix.texi:5266
  9700. msgid "To create a channel, create a Git repository containing your own package modules and make it available. The repository can contain anything, but a useful channel will contain Guile modules that export packages. Once you start using a channel, Guix will behave as if the root directory of that channel's Git repository has been added to the Guile load path (@pxref{Load Paths,,, guile, GNU Guile Reference Manual}). For example, if your channel contains a file at @file{my-packages/my-tools.scm} that defines a Guile module, then the module will be available under the name @code{(my-packages my-tools)}, and you will be able to use it like any other module (@pxref{Modules,,, guile, GNU Guile Reference Manual})."
  9701. msgstr ""
  9702. #. type: Plain text
  9703. #: guix-git/doc/guix.texi:5271
  9704. msgid "As a channel author, consider bundling authentication material with your channel so that users can authenticate it. @xref{Channel Authentication}, and @ref{Specifying Channel Authorizations}, for info on how to do it."
  9705. msgstr ""
  9706. #. type: cindex
  9707. #: guix-git/doc/guix.texi:5276
  9708. #, no-wrap
  9709. msgid "subdirectory, channels"
  9710. msgstr ""
  9711. #. type: Plain text
  9712. #: guix-git/doc/guix.texi:5280
  9713. msgid "As a channel author, you may want to keep your channel modules in a sub-directory. If your modules are in the sub-directory @file{guix}, you must add a meta-data file @file{.guix-channel} that contains:"
  9714. msgstr ""
  9715. #. type: lisp
  9716. #: guix-git/doc/guix.texi:5285
  9717. #, no-wrap
  9718. msgid ""
  9719. "(channel\n"
  9720. " (version 0)\n"
  9721. " (directory \"guix\"))\n"
  9722. msgstr ""
  9723. #. type: cindex
  9724. #: guix-git/doc/guix.texi:5290
  9725. #, no-wrap
  9726. msgid "dependencies, channels"
  9727. msgstr ""
  9728. #. type: cindex
  9729. #: guix-git/doc/guix.texi:5291
  9730. #, no-wrap
  9731. msgid "meta-data, channels"
  9732. msgstr ""
  9733. #. type: Plain text
  9734. #: guix-git/doc/guix.texi:5296
  9735. msgid "Channel authors may decide to augment a package collection provided by other channels. They can declare their channel to be dependent on other channels in a meta-data file @file{.guix-channel}, which is to be placed in the root of the channel repository."
  9736. msgstr ""
  9737. #. type: Plain text
  9738. #: guix-git/doc/guix.texi:5298
  9739. msgid "The meta-data file should contain a simple S-expression like this:"
  9740. msgstr ""
  9741. #. type: lisp
  9742. #: guix-git/doc/guix.texi:5306
  9743. #, no-wrap
  9744. msgid ""
  9745. "(channel\n"
  9746. " (version 0)\n"
  9747. " (dependencies\n"
  9748. " (channel\n"
  9749. " (name some-collection)\n"
  9750. " (url \"https://example.org/first-collection.git\")\n"
  9751. "\n"
  9752. msgstr ""
  9753. #. type: lisp
  9754. #: guix-git/doc/guix.texi:5318
  9755. #, no-wrap
  9756. msgid ""
  9757. " ;; The 'introduction' bit below is optional: you would\n"
  9758. " ;; provide it for dependencies that can be authenticated.\n"
  9759. " (introduction\n"
  9760. " (channel-introduction\n"
  9761. " (version 0)\n"
  9762. " (commit \"a8883b58dc82e167c96506cf05095f37c2c2c6cd\")\n"
  9763. " (signer \"CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5\"))))\n"
  9764. " (channel\n"
  9765. " (name some-other-collection)\n"
  9766. " (url \"https://example.org/second-collection.git\")\n"
  9767. " (branch \"testing\"))))\n"
  9768. msgstr ""
  9769. #. type: Plain text
  9770. #: guix-git/doc/guix.texi:5324
  9771. msgid "In the above example this channel is declared to depend on two other channels, which will both be fetched automatically. The modules provided by the channel will be compiled in an environment where the modules of all these declared channels are available."
  9772. msgstr ""
  9773. #. type: Plain text
  9774. #: guix-git/doc/guix.texi:5328
  9775. msgid "For the sake of reliability and maintainability, you should avoid dependencies on channels that you don't control, and you should aim to keep the number of dependencies to a minimum."
  9776. msgstr ""
  9777. #. type: cindex
  9778. #: guix-git/doc/guix.texi:5332
  9779. #, no-wrap
  9780. msgid "channel authorizations"
  9781. msgstr ""
  9782. #. type: anchor{#1}
  9783. #: guix-git/doc/guix.texi:5346
  9784. msgid "channel-authorizations"
  9785. msgstr ""
  9786. #. type: Plain text
  9787. #: guix-git/doc/guix.texi:5346
  9788. msgid "As we saw above, Guix ensures the source code it pulls from channels comes from authorized developers. As a channel author, you need to specify the list of authorized developers in the @file{.guix-authorizations} file in the channel's Git repository. The authentication rule is simple: each commit must be signed by a key listed in the @file{.guix-authorizations} file of its parent commit(s)@footnote{Git commits form a @dfn{directed acyclic graph} (DAG). Each commit can have zero or more parents; ``regular'' commits have one parent and merge commits have two parent commits. Read @uref{https://eagain.net/articles/git-for-computer-scientists/, @i{Git for Computer Scientists}} for a great overview.} The @file{.guix-authorizations} file looks like this:"
  9789. msgstr ""
  9790. #. type: lisp
  9791. #: guix-git/doc/guix.texi:5349
  9792. #, no-wrap
  9793. msgid ""
  9794. ";; Example '.guix-authorizations' file.\n"
  9795. "\n"
  9796. msgstr ""
  9797. #. type: lisp
  9798. #: guix-git/doc/guix.texi:5352
  9799. #, no-wrap
  9800. msgid ""
  9801. "(authorizations\n"
  9802. " (version 0) ;current file format version\n"
  9803. "\n"
  9804. msgstr ""
  9805. #. type: lisp
  9806. #: guix-git/doc/guix.texi:5359
  9807. #, no-wrap
  9808. msgid ""
  9809. " ((\"AD17 A21E F8AE D8F1 CC02 DBD9 F8AE D8F1 765C 61E3\"\n"
  9810. " (name \"alice\"))\n"
  9811. " (\"2A39 3FFF 68F4 EF7A 3D29 12AF 68F4 EF7A 22FB B2D5\"\n"
  9812. " (name \"bob\"))\n"
  9813. " (\"CABB A931 C0FF EEC6 900D 0CFB 090B 1199 3D9A EBB5\"\n"
  9814. " (name \"charlie\"))))\n"
  9815. msgstr ""
  9816. #. type: Plain text
  9817. #: guix-git/doc/guix.texi:5363
  9818. msgid "Each fingerprint is followed by optional key/value pairs, as in the example above. Currently these key/value pairs are ignored."
  9819. msgstr ""
  9820. #. type: Plain text
  9821. #: guix-git/doc/guix.texi:5368
  9822. msgid "This authentication rule creates a chicken-and-egg issue: how do we authenticate the first commit? Related to that: how do we deal with channels whose repository history contains unsigned commits and lack @file{.guix-authorizations}? And how do we fork existing channels?"
  9823. msgstr ""
  9824. #. type: cindex
  9825. #: guix-git/doc/guix.texi:5369
  9826. #, no-wrap
  9827. msgid "channel introduction"
  9828. msgstr ""
  9829. #. type: Plain text
  9830. #: guix-git/doc/guix.texi:5376
  9831. msgid "Channel introductions answer these questions by describing the first commit of a channel that should be authenticated. The first time a channel is fetched with @command{guix pull} or @command{guix time-machine}, the command looks up the introductory commit and verifies that it is signed by the specified OpenPGP key. From then on, it authenticates commits according to the rule above."
  9832. msgstr ""
  9833. #. type: Plain text
  9834. #: guix-git/doc/guix.texi:5383
  9835. msgid "Additionally, your channel must provide all the OpenPGP keys that were ever mentioned in @file{.guix-authorizations}, stored as @file{.key} files, which can be either binary or ``ASCII-armored''. By default, those @file{.key} files are searched for in the branch named @code{keyring} but you can specify a different branch name in @code{.guix-channel} like so:"
  9836. msgstr ""
  9837. #. type: lisp
  9838. #: guix-git/doc/guix.texi:5388
  9839. #, no-wrap
  9840. msgid ""
  9841. "(channel\n"
  9842. " (version 0)\n"
  9843. " (keyring-reference \"my-keyring-branch\"))\n"
  9844. msgstr ""
  9845. #. type: Plain text
  9846. #: guix-git/doc/guix.texi:5392
  9847. msgid "To summarize, as the author of a channel, there are three things you have to do to allow users to authenticate your code:"
  9848. msgstr ""
  9849. #. type: enumerate
  9850. #: guix-git/doc/guix.texi:5398
  9851. msgid "Export the OpenPGP keys of past and present committers with @command{gpg --export} and store them in @file{.key} files, by default in a branch named @code{keyring} (we recommend making it an @dfn{orphan branch})."
  9852. msgstr ""
  9853. #. type: enumerate
  9854. #: guix-git/doc/guix.texi:5403
  9855. msgid "Introduce an initial @file{.guix-authorizations} in the channel's repository. Do that in a signed commit (@pxref{Commit Access}, for information on how to sign Git commits.)"
  9856. msgstr ""
  9857. #. type: enumerate
  9858. #: guix-git/doc/guix.texi:5409
  9859. msgid "Advertise the channel introduction, for instance on your channel's web page. The channel introduction, as we saw above, is the commit/key pair---i.e., the commit that introduced @file{.guix-authorizations}, and the fingerprint of the OpenPGP used to sign it."
  9860. msgstr ""
  9861. #. type: Plain text
  9862. #: guix-git/doc/guix.texi:5414
  9863. msgid "Before pushing to your public Git repository, you can run @command{guix git-authenticate} to verify that you did sign all the commits you are about to push with an authorized key:"
  9864. msgstr ""
  9865. #. type: example
  9866. #: guix-git/doc/guix.texi:5417
  9867. #, no-wrap
  9868. msgid "guix git authenticate @var{commit} @var{signer}\n"
  9869. msgstr ""
  9870. #. type: Plain text
  9871. #: guix-git/doc/guix.texi:5422
  9872. msgid "where @var{commit} and @var{signer} are your channel introduction. @xref{Invoking guix git authenticate}, for details."
  9873. msgstr ""
  9874. #. type: Plain text
  9875. #: guix-git/doc/guix.texi:5429
  9876. msgid "Publishing a signed channel requires discipline: any mistake, such as an unsigned commit or a commit signed by an unauthorized key, will prevent users from pulling from your channel---well, that's the whole point of authentication! Pay attention to merges in particular: merge commits are considered authentic if and only if they are signed by a key present in the @file{.guix-authorizations} file of @emph{both} branches."
  9877. msgstr ""
  9878. #. type: cindex
  9879. #: guix-git/doc/guix.texi:5433
  9880. #, no-wrap
  9881. msgid "primary URL, channels"
  9882. msgstr ""
  9883. #. type: Plain text
  9884. #: guix-git/doc/guix.texi:5436
  9885. msgid "Channel authors can indicate the primary URL of their channel's Git repository in the @file{.guix-channel} file, like so:"
  9886. msgstr ""
  9887. #. type: lisp
  9888. #: guix-git/doc/guix.texi:5441
  9889. #, no-wrap
  9890. msgid ""
  9891. "(channel\n"
  9892. " (version 0)\n"
  9893. " (url \"https://example.org/guix.git\"))\n"
  9894. msgstr ""
  9895. #. type: Plain text
  9896. #: guix-git/doc/guix.texi:5448
  9897. msgid "This allows @command{guix pull} to determine whether it is pulling code from a mirror of the channel; when that is the case, it warns the user that the mirror might be stale and displays the primary URL@. That way, users cannot be tricked into fetching code from a stale mirror that does not receive security updates."
  9898. msgstr ""
  9899. #. type: Plain text
  9900. #: guix-git/doc/guix.texi:5452
  9901. msgid "This feature only makes sense for authenticated repositories, such as the official @code{guix} channel, for which @command{guix pull} ensures the code it fetches is authentic."
  9902. msgstr ""
  9903. #. type: cindex
  9904. #: guix-git/doc/guix.texi:5456
  9905. #, no-wrap
  9906. msgid "news, for channels"
  9907. msgstr ""
  9908. #. type: Plain text
  9909. #: guix-git/doc/guix.texi:5460
  9910. msgid "Channel authors may occasionally want to communicate to their users information about important changes in the channel. You'd send them all an email, but that's not convenient."
  9911. msgstr ""
  9912. #. type: Plain text
  9913. #: guix-git/doc/guix.texi:5465
  9914. msgid "Instead, channels can provide a @dfn{news file}; when the channel users run @command{guix pull}, that news file is automatically read and @command{guix pull --news} can display the announcements that correspond to the new commits that have been pulled, if any."
  9915. msgstr ""
  9916. #. type: Plain text
  9917. #: guix-git/doc/guix.texi:5468
  9918. msgid "To do that, channel authors must first declare the name of the news file in their @file{.guix-channel} file:"
  9919. msgstr ""
  9920. #. type: lisp
  9921. #: guix-git/doc/guix.texi:5473
  9922. #, no-wrap
  9923. msgid ""
  9924. "(channel\n"
  9925. " (version 0)\n"
  9926. " (news-file \"etc/news.txt\"))\n"
  9927. msgstr ""
  9928. #. type: Plain text
  9929. #: guix-git/doc/guix.texi:5477
  9930. msgid "The news file itself, @file{etc/news.txt} in this example, must look something like this:"
  9931. msgstr ""
  9932. #. type: lisp
  9933. #: guix-git/doc/guix.texi:5490
  9934. #, no-wrap
  9935. msgid ""
  9936. "(channel-news\n"
  9937. " (version 0)\n"
  9938. " (entry (tag \"the-bug-fix\")\n"
  9939. " (title (en \"Fixed terrible bug\")\n"
  9940. " (fr \"Oh la la\"))\n"
  9941. " (body (en \"@@emph@{Good news@}! It's fixed!\")\n"
  9942. " (eo \"Certe ĝi pli bone funkcias nun!\")))\n"
  9943. " (entry (commit \"bdcabe815cd28144a2d2b4bc3c5057b051fa9906\")\n"
  9944. " (title (en \"Added a great package\")\n"
  9945. " (ca \"Què vol dir guix?\"))\n"
  9946. " (body (en \"Don't miss the @@code@{hello@} package!\"))))\n"
  9947. msgstr ""
  9948. #. type: Plain text
  9949. #: guix-git/doc/guix.texi:5497
  9950. msgid "While the news file is using the Scheme syntax, avoid naming it with a @file{.scm} extension or else it will get picked up when building the channel and yield an error since it is not a valid module. Alternatively, you can move the channel module to a subdirectory and store the news file in another directory."
  9951. msgstr ""
  9952. #. type: Plain text
  9953. #: guix-git/doc/guix.texi:5502
  9954. msgid "The file consists of a list of @dfn{news entries}. Each entry is associated with a commit or tag: it describes changes made in this commit, possibly in preceding commits as well. Users see entries only the first time they obtain the commit the entry refers to."
  9955. msgstr ""
  9956. #. type: Plain text
  9957. #: guix-git/doc/guix.texi:5508
  9958. msgid "The @code{title} field should be a one-line summary while @code{body} can be arbitrarily long, and both can contain Texinfo markup (@pxref{Overview,,, texinfo, GNU Texinfo}). Both the title and body are a list of language tag/message tuples, which allows @command{guix pull} to display news in the language that corresponds to the user's locale."
  9959. msgstr ""
  9960. #. type: Plain text
  9961. #: guix-git/doc/guix.texi:5514
  9962. msgid "If you want to translate news using a gettext-based workflow, you can extract translatable strings with @command{xgettext} (@pxref{xgettext Invocation,,, gettext, GNU Gettext Utilities}). For example, assuming you write news entries in English first, the command below creates a PO file containing the strings to translate:"
  9963. msgstr ""
  9964. #. type: example
  9965. #: guix-git/doc/guix.texi:5517
  9966. #, no-wrap
  9967. msgid "xgettext -o news.po -l scheme -ken etc/news.txt\n"
  9968. msgstr ""
  9969. #. type: Plain text
  9970. #: guix-git/doc/guix.texi:5521
  9971. msgid "To sum up, yes, you could use your channel as a blog. But beware, this is @emph{not quite} what your users might expect."
  9972. msgstr ""
  9973. #. type: cindex
  9974. #: guix-git/doc/guix.texi:5526
  9975. #, no-wrap
  9976. msgid "software development"
  9977. msgstr ""
  9978. #. type: Plain text
  9979. #: guix-git/doc/guix.texi:5530
  9980. msgid "If you are a software developer, Guix provides tools that you should find helpful---independently of the language you're developing in. This is what this chapter is about."
  9981. msgstr ""
  9982. #. type: Plain text
  9983. #: guix-git/doc/guix.texi:5536
  9984. msgid "The @command{guix environment} command provides a convenient way to set up @dfn{development environments} containing all the dependencies and tools necessary to work on the software package of your choice. The @command{guix pack} command allows you to create @dfn{application bundles} that can be easily distributed to users who do not run Guix."
  9985. msgstr ""
  9986. #. type: section
  9987. #: guix-git/doc/guix.texi:5545
  9988. #, no-wrap
  9989. msgid "Invoking @command{guix environment}"
  9990. msgstr ""
  9991. #. type: cindex
  9992. #: guix-git/doc/guix.texi:5547
  9993. #, no-wrap
  9994. msgid "reproducible build environments"
  9995. msgstr ""
  9996. #. type: cindex
  9997. #: guix-git/doc/guix.texi:5548
  9998. #, no-wrap
  9999. msgid "development environments"
  10000. msgstr ""
  10001. #. type: command{#1}
  10002. #: guix-git/doc/guix.texi:5549
  10003. #, no-wrap
  10004. msgid "guix environment"
  10005. msgstr ""
  10006. #. type: cindex
  10007. #: guix-git/doc/guix.texi:5550
  10008. #, no-wrap
  10009. msgid "environment, package build environment"
  10010. msgstr ""
  10011. #. type: Plain text
  10012. #: guix-git/doc/guix.texi:5556
  10013. msgid "The purpose of @command{guix environment} is to assist hackers in creating reproducible development environments without polluting their package profile. The @command{guix environment} tool takes one or more packages, builds all of their inputs, and creates a shell environment to use them."
  10014. msgstr ""
  10015. #. type: example
  10016. #: guix-git/doc/guix.texi:5561
  10017. #, no-wrap
  10018. msgid "guix environment @var{options} @var{package}@dots{}\n"
  10019. msgstr ""
  10020. #. type: Plain text
  10021. #: guix-git/doc/guix.texi:5565
  10022. msgid "The following example spawns a new shell set up for the development of GNU@tie{}Guile:"
  10023. msgstr ""
  10024. #. type: example
  10025. #: guix-git/doc/guix.texi:5568
  10026. #, no-wrap
  10027. msgid "guix environment guile\n"
  10028. msgstr ""
  10029. #. type: Plain text
  10030. #: guix-git/doc/guix.texi:5585
  10031. msgid "If the needed dependencies are not built yet, @command{guix environment} automatically builds them. The environment of the new shell is an augmented version of the environment that @command{guix environment} was run in. It contains the necessary search paths for building the given package added to the existing environment variables. To create a ``pure'' environment, in which the original environment variables have been unset, use the @option{--pure} option@footnote{Users sometimes wrongfully augment environment variables such as @env{PATH} in their @file{~/.bashrc} file. As a consequence, when @command{guix environment} launches it, Bash may read @file{~/.bashrc}, thereby introducing ``impurities'' in these environment variables. It is an error to define such environment variables in @file{.bashrc}; instead, they should be defined in @file{.bash_profile}, which is sourced only by log-in shells. @xref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}, for details on Bash start-up files.}."
  10032. msgstr ""
  10033. #. type: Plain text
  10034. #: guix-git/doc/guix.texi:5591
  10035. msgid "Exiting from a Guix environment is the same as exiting from the shell, and will place the user back in the old environment before @command{guix environment} was invoked. The next garbage collection (@pxref{Invoking guix gc}) will clean up packages that were installed from within the environment and are no longer used outside of it."
  10036. msgstr ""
  10037. #. type: vindex
  10038. #: guix-git/doc/guix.texi:5592
  10039. #, no-wrap
  10040. msgid "GUIX_ENVIRONMENT"
  10041. msgstr ""
  10042. #. type: Plain text
  10043. #: guix-git/doc/guix.texi:5598
  10044. msgid "@command{guix environment} defines the @env{GUIX_ENVIRONMENT} variable in the shell it spawns; its value is the file name of the profile of this environment. This allows users to, say, define a specific prompt for development environments in their @file{.bashrc} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}):"
  10045. msgstr ""
  10046. #. type: example
  10047. #: guix-git/doc/guix.texi:5604
  10048. #, no-wrap
  10049. msgid ""
  10050. "if [ -n \"$GUIX_ENVIRONMENT\" ]\n"
  10051. "then\n"
  10052. " export PS1=\"\\u@@\\h \\w [dev]\\$ \"\n"
  10053. "fi\n"
  10054. msgstr ""
  10055. #. type: Plain text
  10056. #: guix-git/doc/guix.texi:5608
  10057. msgid "...@: or to browse the profile:"
  10058. msgstr ""
  10059. #. type: example
  10060. #: guix-git/doc/guix.texi:5611
  10061. #, no-wrap
  10062. msgid "$ ls \"$GUIX_ENVIRONMENT/bin\"\n"
  10063. msgstr ""
  10064. #. type: Plain text
  10065. #: guix-git/doc/guix.texi:5617
  10066. msgid "Additionally, more than one package may be specified, in which case the union of the inputs for the given packages are used. For example, the command below spawns a shell where all of the dependencies of both Guile and Emacs are available:"
  10067. msgstr ""
  10068. #. type: example
  10069. #: guix-git/doc/guix.texi:5620
  10070. #, no-wrap
  10071. msgid "guix environment guile emacs\n"
  10072. msgstr ""
  10073. #. type: Plain text
  10074. #: guix-git/doc/guix.texi:5625
  10075. msgid "Sometimes an interactive shell session is not desired. An arbitrary command may be invoked by placing the @code{--} token to separate the command from the rest of the arguments:"
  10076. msgstr ""
  10077. #. type: example
  10078. #: guix-git/doc/guix.texi:5628
  10079. #, no-wrap
  10080. msgid "guix environment guile -- make -j4\n"
  10081. msgstr ""
  10082. #. type: Plain text
  10083. #: guix-git/doc/guix.texi:5634
  10084. msgid "In other situations, it is more convenient to specify the list of packages needed in the environment. For example, the following command runs @command{python} from an environment containing Python@tie{}2.7 and NumPy:"
  10085. msgstr ""
  10086. #. type: example
  10087. #: guix-git/doc/guix.texi:5637
  10088. #, no-wrap
  10089. msgid "guix environment --ad-hoc python2-numpy python-2.7 -- python\n"
  10090. msgstr ""
  10091. #. type: Plain text
  10092. #: guix-git/doc/guix.texi:5648
  10093. msgid "Furthermore, one might want the dependencies of a package and also some additional packages that are not build-time or runtime dependencies, but are useful when developing nonetheless. Because of this, the @option{--ad-hoc} flag is positional. Packages appearing before @option{--ad-hoc} are interpreted as packages whose dependencies will be added to the environment. Packages appearing after are interpreted as packages that will be added to the environment directly. For example, the following command creates a Guix development environment that additionally includes Git and strace:"
  10094. msgstr ""
  10095. #. type: example
  10096. #: guix-git/doc/guix.texi:5651
  10097. #, no-wrap
  10098. msgid "guix environment --pure guix --ad-hoc git strace\n"
  10099. msgstr ""
  10100. #. type: item
  10101. #: guix-git/doc/guix.texi:5653 guix-git/doc/guix.texi:5814
  10102. #: guix-git/doc/guix.texi:13182 guix-git/doc/guix.texi:33803
  10103. #, no-wrap
  10104. msgid "container"
  10105. msgstr ""
  10106. #. type: Plain text
  10107. #: guix-git/doc/guix.texi:5661
  10108. msgid "Sometimes it is desirable to isolate the environment as much as possible, for maximal purity and reproducibility. In particular, when using Guix on a host distro that is not Guix System, it is desirable to prevent access to @file{/usr/bin} and other system-wide resources from the development environment. For example, the following command spawns a Guile REPL in a ``container'' where only the store and the current working directory are mounted:"
  10109. msgstr ""
  10110. #. type: example
  10111. #: guix-git/doc/guix.texi:5664
  10112. #, no-wrap
  10113. msgid "guix environment --ad-hoc --container guile -- guile\n"
  10114. msgstr ""
  10115. #. type: quotation
  10116. #: guix-git/doc/guix.texi:5668
  10117. msgid "The @option{--container} option requires Linux-libre 3.19 or newer."
  10118. msgstr ""
  10119. #. type: cindex
  10120. #: guix-git/doc/guix.texi:5670
  10121. #, no-wrap
  10122. msgid "certificates"
  10123. msgstr ""
  10124. #. type: Plain text
  10125. #: guix-git/doc/guix.texi:5677
  10126. msgid "Another typical use case for containers is to run security-sensitive applications such as a web browser. To run Eolie, we must expose and share some files and directories; we include @code{nss-certs} and expose @file{/etc/ssl/certs/} for HTTPS authentication; finally we preserve the @env{DISPLAY} environment variable since containerized graphical applications won't display without it."
  10127. msgstr ""
  10128. #. type: example
  10129. #: guix-git/doc/guix.texi:5684
  10130. #, no-wrap
  10131. msgid ""
  10132. "guix environment --preserve='^DISPLAY$' --container --network \\\n"
  10133. " --expose=/etc/machine-id \\\n"
  10134. " --expose=/etc/ssl/certs/ \\\n"
  10135. " --share=$HOME/.local/share/eolie/=$HOME/.local/share/eolie/ \\\n"
  10136. " --ad-hoc eolie nss-certs dbus -- eolie\n"
  10137. msgstr ""
  10138. #. type: Plain text
  10139. #: guix-git/doc/guix.texi:5687
  10140. msgid "The available options are summarized below."
  10141. msgstr ""
  10142. #. type: item
  10143. #: guix-git/doc/guix.texi:5689 guix-git/doc/guix.texi:6254
  10144. #: guix-git/doc/guix.texi:10937 guix-git/doc/guix.texi:33900
  10145. #, no-wrap
  10146. msgid "--root=@var{file}"
  10147. msgstr ""
  10148. #. type: itemx
  10149. #: guix-git/doc/guix.texi:5690 guix-git/doc/guix.texi:6255
  10150. #: guix-git/doc/guix.texi:10938 guix-git/doc/guix.texi:33901
  10151. #, no-wrap
  10152. msgid "-r @var{file}"
  10153. msgstr ""
  10154. #. type: cindex
  10155. #: guix-git/doc/guix.texi:5691
  10156. #, no-wrap
  10157. msgid "persistent environment"
  10158. msgstr ""
  10159. #. type: cindex
  10160. #: guix-git/doc/guix.texi:5692
  10161. #, no-wrap
  10162. msgid "garbage collector root, for environments"
  10163. msgstr ""
  10164. #. type: table
  10165. #: guix-git/doc/guix.texi:5695
  10166. msgid "Make @var{file} a symlink to the profile for this environment, and register it as a garbage collector root."
  10167. msgstr ""
  10168. #. type: table
  10169. #: guix-git/doc/guix.texi:5698
  10170. msgid "This is useful if you want to protect your environment from garbage collection, to make it ``persistent''."
  10171. msgstr ""
  10172. #. type: table
  10173. #: guix-git/doc/guix.texi:5704
  10174. msgid "When this option is omitted, the environment is protected from garbage collection only for the duration of the @command{guix environment} session. This means that next time you recreate the same environment, you could have to rebuild or re-download packages. @xref{Invoking guix gc}, for more on GC roots."
  10175. msgstr ""
  10176. #. type: item
  10177. #: guix-git/doc/guix.texi:5705 guix-git/doc/guix.texi:6186
  10178. #: guix-git/doc/guix.texi:10783 guix-git/doc/guix.texi:11829
  10179. #: guix-git/doc/guix.texi:12626 guix-git/doc/guix.texi:33835
  10180. #, no-wrap
  10181. msgid "--expression=@var{expr}"
  10182. msgstr ""
  10183. #. type: itemx
  10184. #: guix-git/doc/guix.texi:5706 guix-git/doc/guix.texi:6187
  10185. #: guix-git/doc/guix.texi:10784 guix-git/doc/guix.texi:11830
  10186. #: guix-git/doc/guix.texi:12627 guix-git/doc/guix.texi:33836
  10187. #, no-wrap
  10188. msgid "-e @var{expr}"
  10189. msgstr ""
  10190. #. type: table
  10191. #: guix-git/doc/guix.texi:5709
  10192. msgid "Create an environment for the package or list of packages that @var{expr} evaluates to."
  10193. msgstr ""
  10194. #. type: table
  10195. #: guix-git/doc/guix.texi:5711
  10196. msgid "For example, running:"
  10197. msgstr ""
  10198. #. type: example
  10199. #: guix-git/doc/guix.texi:5714
  10200. #, no-wrap
  10201. msgid "guix environment -e '(@@ (gnu packages maths) petsc-openmpi)'\n"
  10202. msgstr ""
  10203. #. type: table
  10204. #: guix-git/doc/guix.texi:5718
  10205. msgid "starts a shell with the environment for this specific variant of the PETSc package."
  10206. msgstr ""
  10207. #. type: table
  10208. #: guix-git/doc/guix.texi:5720
  10209. msgid "Running:"
  10210. msgstr ""
  10211. #. type: example
  10212. #: guix-git/doc/guix.texi:5723
  10213. #, no-wrap
  10214. msgid "guix environment --ad-hoc -e '(@@ (gnu) %base-packages)'\n"
  10215. msgstr ""
  10216. #. type: table
  10217. #: guix-git/doc/guix.texi:5726
  10218. msgid "starts a shell with all the base system packages available."
  10219. msgstr ""
  10220. #. type: table
  10221. #: guix-git/doc/guix.texi:5729
  10222. msgid "The above commands only use the default output of the given packages. To select other outputs, two element tuples can be specified:"
  10223. msgstr ""
  10224. #. type: example
  10225. #: guix-git/doc/guix.texi:5732
  10226. #, no-wrap
  10227. msgid "guix environment --ad-hoc -e '(list (@@ (gnu packages bash) bash) \"include\")'\n"
  10228. msgstr ""
  10229. #. type: item
  10230. #: guix-git/doc/guix.texi:5734
  10231. #, no-wrap
  10232. msgid "--load=@var{file}"
  10233. msgstr ""
  10234. #. type: itemx
  10235. #: guix-git/doc/guix.texi:5735
  10236. #, no-wrap
  10237. msgid "-l @var{file}"
  10238. msgstr ""
  10239. #. type: table
  10240. #: guix-git/doc/guix.texi:5738
  10241. msgid "Create an environment for the package or list of packages that the code within @var{file} evaluates to."
  10242. msgstr ""
  10243. #. type: lisp
  10244. #: guix-git/doc/guix.texi:5744
  10245. #, no-wrap
  10246. msgid "@verbatiminclude environment-gdb.scm\n"
  10247. msgstr ""
  10248. #. type: table
  10249. #: guix-git/doc/guix.texi:5751
  10250. msgid "Create an environment for the packages contained in the manifest object returned by the Scheme code in @var{file}. This option can be repeated several times, in which case the manifests are concatenated."
  10251. msgstr ""
  10252. #. type: table
  10253. #: guix-git/doc/guix.texi:5755
  10254. msgid "This is similar to the same-named option in @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) and uses the same manifest files."
  10255. msgstr ""
  10256. #. type: item
  10257. #: guix-git/doc/guix.texi:5756
  10258. #, no-wrap
  10259. msgid "--ad-hoc"
  10260. msgstr ""
  10261. #. type: table
  10262. #: guix-git/doc/guix.texi:5761
  10263. msgid "Include all specified packages in the resulting environment, as if an @i{ad hoc} package were defined with them as inputs. This option is useful for quickly creating an environment without having to write a package expression to contain the desired inputs."
  10264. msgstr ""
  10265. #. type: table
  10266. #: guix-git/doc/guix.texi:5763
  10267. msgid "For instance, the command:"
  10268. msgstr ""
  10269. #. type: example
  10270. #: guix-git/doc/guix.texi:5766
  10271. #, no-wrap
  10272. msgid "guix environment --ad-hoc guile guile-sdl -- guile\n"
  10273. msgstr ""
  10274. #. type: table
  10275. #: guix-git/doc/guix.texi:5770
  10276. msgid "runs @command{guile} in an environment where Guile and Guile-SDL are available."
  10277. msgstr ""
  10278. #. type: table
  10279. #: guix-git/doc/guix.texi:5775
  10280. msgid "Note that this example implicitly asks for the default output of @code{guile} and @code{guile-sdl}, but it is possible to ask for a specific output---e.g., @code{glib:bin} asks for the @code{bin} output of @code{glib} (@pxref{Packages with Multiple Outputs})."
  10281. msgstr ""
  10282. #. type: table
  10283. #: guix-git/doc/guix.texi:5781
  10284. msgid "This option may be composed with the default behavior of @command{guix environment}. Packages appearing before @option{--ad-hoc} are interpreted as packages whose dependencies will be added to the environment, the default behavior. Packages appearing after are interpreted as packages that will be added to the environment directly."
  10285. msgstr ""
  10286. #. type: item
  10287. #: guix-git/doc/guix.texi:5782
  10288. #, no-wrap
  10289. msgid "--pure"
  10290. msgstr ""
  10291. #. type: table
  10292. #: guix-git/doc/guix.texi:5786
  10293. msgid "Unset existing environment variables when building the new environment, except those specified with @option{--preserve} (see below). This has the effect of creating an environment in which search paths only contain package inputs."
  10294. msgstr ""
  10295. #. type: item
  10296. #: guix-git/doc/guix.texi:5787
  10297. #, no-wrap
  10298. msgid "--preserve=@var{regexp}"
  10299. msgstr ""
  10300. #. type: itemx
  10301. #: guix-git/doc/guix.texi:5788
  10302. #, no-wrap
  10303. msgid "-E @var{regexp}"
  10304. msgstr ""
  10305. #. type: table
  10306. #: guix-git/doc/guix.texi:5793
  10307. msgid "When used alongside @option{--pure}, preserve the environment variables matching @var{regexp}---in other words, put them on a ``white list'' of environment variables that must be preserved. This option can be repeated several times."
  10308. msgstr ""
  10309. #. type: example
  10310. #: guix-git/doc/guix.texi:5797
  10311. #, no-wrap
  10312. msgid ""
  10313. "guix environment --pure --preserve=^SLURM --ad-hoc openmpi @dots{} \\\n"
  10314. " -- mpirun @dots{}\n"
  10315. msgstr ""
  10316. #. type: table
  10317. #: guix-git/doc/guix.texi:5803
  10318. msgid "This example runs @command{mpirun} in a context where the only environment variables defined are @env{PATH}, environment variables whose name starts with @samp{SLURM}, as well as the usual ``precious'' variables (@env{HOME}, @env{USER}, etc.)."
  10319. msgstr ""
  10320. #. type: item
  10321. #: guix-git/doc/guix.texi:5804
  10322. #, no-wrap
  10323. msgid "--search-paths"
  10324. msgstr ""
  10325. #. type: table
  10326. #: guix-git/doc/guix.texi:5807
  10327. msgid "Display the environment variable definitions that make up the environment."
  10328. msgstr ""
  10329. #. type: table
  10330. #: guix-git/doc/guix.texi:5811
  10331. msgid "Attempt to build for @var{system}---e.g., @code{i686-linux}."
  10332. msgstr ""
  10333. #. type: item
  10334. #: guix-git/doc/guix.texi:5812
  10335. #, no-wrap
  10336. msgid "--container"
  10337. msgstr ""
  10338. #. type: itemx
  10339. #: guix-git/doc/guix.texi:5813
  10340. #, no-wrap
  10341. msgid "-C"
  10342. msgstr ""
  10343. #. type: table
  10344. #: guix-git/doc/guix.texi:5820
  10345. msgid "Run @var{command} within an isolated container. The current working directory outside the container is mapped inside the container. Additionally, unless overridden with @option{--user}, a dummy home directory is created that matches the current user's home directory, and @file{/etc/passwd} is configured accordingly."
  10346. msgstr ""
  10347. #. type: table
  10348. #: guix-git/doc/guix.texi:5824
  10349. msgid "The spawned process runs as the current user outside the container. Inside the container, it has the same UID and GID as the current user, unless @option{--user} is passed (see below)."
  10350. msgstr ""
  10351. #. type: item
  10352. #: guix-git/doc/guix.texi:5825 guix-git/doc/guix.texi:33895
  10353. #, no-wrap
  10354. msgid "--network"
  10355. msgstr ""
  10356. #. type: table
  10357. #: guix-git/doc/guix.texi:5830
  10358. msgid "For containers, share the network namespace with the host system. Containers created without this flag only have access to the loopback device."
  10359. msgstr ""
  10360. #. type: item
  10361. #: guix-git/doc/guix.texi:5831
  10362. #, no-wrap
  10363. msgid "--link-profile"
  10364. msgstr ""
  10365. #. type: itemx
  10366. #: guix-git/doc/guix.texi:5832
  10367. #, no-wrap
  10368. msgid "-P"
  10369. msgstr ""
  10370. #. type: table
  10371. #: guix-git/doc/guix.texi:5840
  10372. msgid "For containers, link the environment profile to @file{~/.guix-profile} within the container and set @code{GUIX_ENVIRONMENT} to that. This is equivalent to making @file{~/.guix-profile} a symlink to the actual profile within the container. Linking will fail and abort the environment if the directory already exists, which will certainly be the case if @command{guix environment} was invoked in the user's home directory."
  10373. msgstr ""
  10374. #. type: table
  10375. #: guix-git/doc/guix.texi:5846
  10376. msgid "Certain packages are configured to look in @file{~/.guix-profile} for configuration files and data;@footnote{For example, the @code{fontconfig} package inspects @file{~/.guix-profile/share/fonts} for additional fonts.} @option{--link-profile} allows these programs to behave as expected within the environment."
  10377. msgstr ""
  10378. #. type: item
  10379. #: guix-git/doc/guix.texi:5847 guix-git/doc/guix.texi:12759
  10380. #, no-wrap
  10381. msgid "--user=@var{user}"
  10382. msgstr ""
  10383. #. type: itemx
  10384. #: guix-git/doc/guix.texi:5848 guix-git/doc/guix.texi:12760
  10385. #, no-wrap
  10386. msgid "-u @var{user}"
  10387. msgstr ""
  10388. #. type: table
  10389. #: guix-git/doc/guix.texi:5855
  10390. msgid "For containers, use the username @var{user} in place of the current user. The generated @file{/etc/passwd} entry within the container will contain the name @var{user}, the home directory will be @file{/home/@var{user}}, and no user GECOS data will be copied. Furthermore, the UID and GID inside the container are 1000. @var{user} need not exist on the system."
  10391. msgstr ""
  10392. #. type: table
  10393. #: guix-git/doc/guix.texi:5860
  10394. msgid "Additionally, any shared or exposed path (see @option{--share} and @option{--expose} respectively) whose target is within the current user's home directory will be remapped relative to @file{/home/USER}; this includes the automatic mapping of the current working directory."
  10395. msgstr ""
  10396. #. type: example
  10397. #: guix-git/doc/guix.texi:5867
  10398. #, no-wrap
  10399. msgid ""
  10400. "# will expose paths as /home/foo/wd, /home/foo/test, and /home/foo/target\n"
  10401. "cd $HOME/wd\n"
  10402. "guix environment --container --user=foo \\\n"
  10403. " --expose=$HOME/test \\\n"
  10404. " --expose=/tmp/target=$HOME/target\n"
  10405. msgstr ""
  10406. #. type: table
  10407. #: guix-git/doc/guix.texi:5872
  10408. msgid "While this will limit the leaking of user identity through home paths and each of the user fields, this is only one useful component of a broader privacy/anonymity solution---not one in and of itself."
  10409. msgstr ""
  10410. #. type: item
  10411. #: guix-git/doc/guix.texi:5873
  10412. #, no-wrap
  10413. msgid "--no-cwd"
  10414. msgstr ""
  10415. #. type: table
  10416. #: guix-git/doc/guix.texi:5880
  10417. msgid "For containers, the default behavior is to share the current working directory with the isolated container and immediately change to that directory within the container. If this is undesirable, @option{--no-cwd} will cause the current working directory to @emph{not} be automatically shared and will change to the user's home directory within the container instead. See also @option{--user}."
  10418. msgstr ""
  10419. #. type: item
  10420. #: guix-git/doc/guix.texi:5881
  10421. #, no-wrap
  10422. msgid "--expose=@var{source}[=@var{target}]"
  10423. msgstr ""
  10424. #. type: itemx
  10425. #: guix-git/doc/guix.texi:5882
  10426. #, no-wrap
  10427. msgid "--share=@var{source}[=@var{target}]"
  10428. msgstr ""
  10429. #. type: table
  10430. #: guix-git/doc/guix.texi:5888
  10431. msgid "For containers, @option{--expose} (resp. @option{--share}) exposes the file system @var{source} from the host system as the read-only (resp. writable) file system @var{target} within the container. If @var{target} is not specified, @var{source} is used as the target mount point in the container."
  10432. msgstr ""
  10433. #. type: table
  10434. #: guix-git/doc/guix.texi:5892
  10435. msgid "The example below spawns a Guile REPL in a container in which the user's home directory is accessible read-only via the @file{/exchange} directory:"
  10436. msgstr ""
  10437. #. type: example
  10438. #: guix-git/doc/guix.texi:5895
  10439. #, no-wrap
  10440. msgid "guix environment --container --expose=$HOME=/exchange --ad-hoc guile -- guile\n"
  10441. msgstr ""
  10442. #. type: Plain text
  10443. #: guix-git/doc/guix.texi:5903
  10444. msgid "@command{guix environment} also supports all of the common build options that @command{guix build} supports (@pxref{Common Build Options}) as well as package transformation options (@pxref{Package Transformation Options})."
  10445. msgstr ""
  10446. #. type: section
  10447. #: guix-git/doc/guix.texi:5905
  10448. #, no-wrap
  10449. msgid "Invoking @command{guix pack}"
  10450. msgstr ""
  10451. #. type: Plain text
  10452. #: guix-git/doc/guix.texi:5911
  10453. msgid "Occasionally you want to pass software to people who are not (yet!) lucky enough to be using Guix. You'd tell them to run @command{guix package -i @var{something}}, but that's not possible in this case. This is where @command{guix pack} comes in."
  10454. msgstr ""
  10455. #. type: quotation
  10456. #: guix-git/doc/guix.texi:5916
  10457. msgid "If you are looking for ways to exchange binaries among machines that already run Guix, @pxref{Invoking guix copy}, @ref{Invoking guix publish}, and @ref{Invoking guix archive}."
  10458. msgstr ""
  10459. #. type: cindex
  10460. #: guix-git/doc/guix.texi:5918
  10461. #, no-wrap
  10462. msgid "pack"
  10463. msgstr ""
  10464. #. type: cindex
  10465. #: guix-git/doc/guix.texi:5919
  10466. #, no-wrap
  10467. msgid "bundle"
  10468. msgstr ""
  10469. #. type: cindex
  10470. #: guix-git/doc/guix.texi:5920
  10471. #, no-wrap
  10472. msgid "application bundle"
  10473. msgstr ""
  10474. #. type: cindex
  10475. #: guix-git/doc/guix.texi:5921
  10476. #, no-wrap
  10477. msgid "software bundle"
  10478. msgstr ""
  10479. #. type: Plain text
  10480. #: guix-git/doc/guix.texi:5930
  10481. msgid "The @command{guix pack} command creates a shrink-wrapped @dfn{pack} or @dfn{software bundle}: it creates a tarball or some other archive containing the binaries of the software you're interested in, and all its dependencies. The resulting archive can be used on any machine that does not have Guix, and people can run the exact same binaries as those you have with Guix. The pack itself is created in a bit-reproducible fashion, so anyone can verify that it really contains the build results that you pretend to be shipping."
  10482. msgstr ""
  10483. #. type: Plain text
  10484. #: guix-git/doc/guix.texi:5933
  10485. msgid "For example, to create a bundle containing Guile, Emacs, Geiser, and all their dependencies, you can run:"
  10486. msgstr ""
  10487. #. type: example
  10488. #: guix-git/doc/guix.texi:5938
  10489. #, no-wrap
  10490. msgid ""
  10491. "$ guix pack guile emacs emacs-geiser\n"
  10492. "@dots{}\n"
  10493. "/gnu/store/@dots{}-pack.tar.gz\n"
  10494. msgstr ""
  10495. #. type: Plain text
  10496. #: guix-git/doc/guix.texi:5946
  10497. msgid "The result here is a tarball containing a @file{/gnu/store} directory with all the relevant packages. The resulting tarball contains a @dfn{profile} with the three packages of interest; the profile is the same as would be created by @command{guix package -i}. It is this mechanism that is used to create Guix's own standalone binary tarball (@pxref{Binary Installation})."
  10498. msgstr ""
  10499. #. type: Plain text
  10500. #: guix-git/doc/guix.texi:5951
  10501. msgid "Users of this pack would have to run @file{/gnu/store/@dots{}-profile/bin/guile} to run Guile, which you may find inconvenient. To work around it, you can create, say, a @file{/opt/gnu/bin} symlink to the profile:"
  10502. msgstr ""
  10503. #. type: example
  10504. #: guix-git/doc/guix.texi:5954
  10505. #, no-wrap
  10506. msgid "guix pack -S /opt/gnu/bin=bin guile emacs emacs-geiser\n"
  10507. msgstr ""
  10508. #. type: Plain text
  10509. #: guix-git/doc/guix.texi:5958
  10510. msgid "That way, users can happily type @file{/opt/gnu/bin/guile} and enjoy."
  10511. msgstr ""
  10512. #. type: cindex
  10513. #: guix-git/doc/guix.texi:5959
  10514. #, no-wrap
  10515. msgid "relocatable binaries, with @command{guix pack}"
  10516. msgstr ""
  10517. #. type: Plain text
  10518. #: guix-git/doc/guix.texi:5967
  10519. msgid "What if the recipient of your pack does not have root privileges on their machine, and thus cannot unpack it in the root file system? In that case, you will want to use the @option{--relocatable} option (see below). This option produces @dfn{relocatable binaries}, meaning they they can be placed anywhere in the file system hierarchy: in the example above, users can unpack your tarball in their home directory and directly run @file{./opt/gnu/bin/guile}."
  10520. msgstr ""
  10521. #. type: cindex
  10522. #: guix-git/doc/guix.texi:5968
  10523. #, no-wrap
  10524. msgid "Docker, build an image with guix pack"
  10525. msgstr ""
  10526. #. type: Plain text
  10527. #: guix-git/doc/guix.texi:5971
  10528. msgid "Alternatively, you can produce a pack in the Docker image format using the following command:"
  10529. msgstr ""
  10530. #. type: example
  10531. #: guix-git/doc/guix.texi:5974
  10532. #, no-wrap
  10533. msgid "guix pack -f docker -S /bin=bin guile guile-readline\n"
  10534. msgstr ""
  10535. #. type: Plain text
  10536. #: guix-git/doc/guix.texi:5979
  10537. msgid "The result is a tarball that can be passed to the @command{docker load} command, followed by @code{docker run}:"
  10538. msgstr ""
  10539. #. type: example
  10540. #: guix-git/doc/guix.texi:5983
  10541. #, no-wrap
  10542. msgid ""
  10543. "docker load < @var{file}\n"
  10544. "docker run -ti guile-guile-readline /bin/guile\n"
  10545. msgstr ""
  10546. #. type: Plain text
  10547. #: guix-git/doc/guix.texi:5990
  10548. msgid "where @var{file} is the image returned by @var{guix pack}, and @code{guile-guile-readline} is its ``image tag''. See the @uref{https://docs.docker.com/engine/reference/commandline/load/, Docker documentation} for more information."
  10549. msgstr ""
  10550. #. type: cindex
  10551. #: guix-git/doc/guix.texi:5991
  10552. #, no-wrap
  10553. msgid "Singularity, build an image with guix pack"
  10554. msgstr ""
  10555. #. type: cindex
  10556. #: guix-git/doc/guix.texi:5992
  10557. #, no-wrap
  10558. msgid "SquashFS, build an image with guix pack"
  10559. msgstr ""
  10560. #. type: Plain text
  10561. #: guix-git/doc/guix.texi:5995
  10562. msgid "Yet another option is to produce a SquashFS image with the following command:"
  10563. msgstr ""
  10564. #. type: example
  10565. #: guix-git/doc/guix.texi:5998
  10566. #, no-wrap
  10567. msgid "guix pack -f squashfs bash guile emacs emacs-geiser\n"
  10568. msgstr ""
  10569. #. type: Plain text
  10570. #: guix-git/doc/guix.texi:6006
  10571. msgid "The result is a SquashFS file system image that can either be mounted or directly be used as a file system container image with the @uref{https://www.sylabs.io/docs/, Singularity container execution environment}, using commands like @command{singularity shell} or @command{singularity exec}."
  10572. msgstr ""
  10573. #. type: Plain text
  10574. #: guix-git/doc/guix.texi:6008
  10575. msgid "Several command-line options allow you to customize your pack:"
  10576. msgstr ""
  10577. #. type: table
  10578. #: guix-git/doc/guix.texi:6013
  10579. msgid "Produce a pack in the given @var{format}."
  10580. msgstr ""
  10581. #. type: table
  10582. #: guix-git/doc/guix.texi:6015
  10583. msgid "The available formats are:"
  10584. msgstr ""
  10585. #. type: item
  10586. #: guix-git/doc/guix.texi:6017
  10587. #, no-wrap
  10588. msgid "tarball"
  10589. msgstr ""
  10590. #. type: table
  10591. #: guix-git/doc/guix.texi:6020
  10592. msgid "This is the default format. It produces a tarball containing all the specified binaries and symlinks."
  10593. msgstr ""
  10594. #. type: item
  10595. #: guix-git/doc/guix.texi:6021
  10596. #, no-wrap
  10597. msgid "docker"
  10598. msgstr ""
  10599. #. type: table
  10600. #: guix-git/doc/guix.texi:6027
  10601. msgid "This produces a tarball that follows the @uref{https://github.com/docker/docker/blob/master/image/spec/v1.2.md, Docker Image Specification}. The ``repository name'' as it appears in the output of the @command{docker images} command is computed from package names passed on the command line or in the manifest file."
  10602. msgstr ""
  10603. #. type: item
  10604. #: guix-git/doc/guix.texi:6028
  10605. #, no-wrap
  10606. msgid "squashfs"
  10607. msgstr ""
  10608. #. type: table
  10609. #: guix-git/doc/guix.texi:6032
  10610. msgid "This produces a SquashFS image containing all the specified binaries and symlinks, as well as empty mount points for virtual file systems like procfs."
  10611. msgstr ""
  10612. #. type: quotation
  10613. #: guix-git/doc/guix.texi:6038
  10614. msgid "Singularity @emph{requires} you to provide @file{/bin/sh} in the image. For that reason, @command{guix pack -f squashfs} always implies @code{-S /bin=bin}. Thus, your @command{guix pack} invocation must always start with something like:"
  10615. msgstr ""
  10616. #. type: example
  10617. #: guix-git/doc/guix.texi:6041
  10618. #, no-wrap
  10619. msgid "guix pack -f squashfs bash @dots{}\n"
  10620. msgstr ""
  10621. #. type: quotation
  10622. #: guix-git/doc/guix.texi:6046
  10623. msgid "If you forget the @code{bash} (or similar) package, @command{singularity run} and @command{singularity exec} will fail with an unhelpful ``no such file or directory'' message."
  10624. msgstr ""
  10625. #. type: item
  10626. #: guix-git/doc/guix.texi:6048
  10627. #, no-wrap
  10628. msgid "deb"
  10629. msgstr ""
  10630. #. type: table
  10631. #: guix-git/doc/guix.texi:6056
  10632. msgid "This produces a Debian archive (a package with the @samp{.deb} file extension) containing all the specified binaries and symbolic links, that can be installed on top of any dpkg-based GNU(/Linux) distribution. Advanced options can be revealed via the @option{--help-deb-format} option. They allow embedding control files for more fine-grained control, such as activating specific triggers or providing a maintainer configure script to run arbitrary setup code upon installation."
  10633. msgstr ""
  10634. #. type: example
  10635. #: guix-git/doc/guix.texi:6059
  10636. #, no-wrap
  10637. msgid "guix pack -f deb -C xz -S /usr/bin/hello=bin/hello hello\n"
  10638. msgstr ""
  10639. #. type: quotation
  10640. #: guix-git/doc/guix.texi:6066
  10641. msgid "Because archives produced with @command{guix pack} contain a collection of store items and because each @command{dpkg} package must not have conflicting files, in practice that means you likely won't be able to install more than one such archive on a given system."
  10642. msgstr ""
  10643. #. type: quotation
  10644. #: guix-git/doc/guix.texi:6074
  10645. msgid "@command{dpkg} will assume ownership of any files contained in the pack that it does @emph{not} know about. It is unwise to install Guix-produced @samp{.deb} files on a system where @file{/gnu/store} is shared by other software, such as a Guix installation or other, non-deb packs."
  10646. msgstr ""
  10647. #. type: cindex
  10648. #: guix-git/doc/guix.texi:6078
  10649. #, no-wrap
  10650. msgid "relocatable binaries"
  10651. msgstr ""
  10652. #. type: item
  10653. #: guix-git/doc/guix.texi:6079
  10654. #, no-wrap
  10655. msgid "--relocatable"
  10656. msgstr ""
  10657. #. type: table
  10658. #: guix-git/doc/guix.texi:6083
  10659. msgid "Produce @dfn{relocatable binaries}---i.e., binaries that can be placed anywhere in the file system hierarchy and run from there."
  10660. msgstr ""
  10661. #. type: table
  10662. #: guix-git/doc/guix.texi:6091
  10663. msgid "When this option is passed once, the resulting binaries require support for @dfn{user namespaces} in the kernel Linux; when passed @emph{twice}@footnote{Here's a trick to memorize it: @code{-RR}, which adds PRoot support, can be thought of as the abbreviation of ``Really Relocatable''. Neat, isn't it?}, relocatable binaries fall to back to other techniques if user namespaces are unavailable, and essentially work anywhere---see below for the implications."
  10664. msgstr ""
  10665. #. type: table
  10666. #: guix-git/doc/guix.texi:6093
  10667. msgid "For example, if you create a pack containing Bash with:"
  10668. msgstr ""
  10669. #. type: example
  10670. #: guix-git/doc/guix.texi:6096
  10671. #, no-wrap
  10672. msgid "guix pack -RR -S /mybin=bin bash\n"
  10673. msgstr ""
  10674. #. type: table
  10675. #: guix-git/doc/guix.texi:6101
  10676. msgid "...@: you can copy that pack to a machine that lacks Guix, and from your home directory as a normal user, run:"
  10677. msgstr ""
  10678. #. type: example
  10679. #: guix-git/doc/guix.texi:6105
  10680. #, no-wrap
  10681. msgid ""
  10682. "tar xf pack.tar.gz\n"
  10683. "./mybin/sh\n"
  10684. msgstr ""
  10685. #. type: table
  10686. #: guix-git/doc/guix.texi:6113
  10687. msgid "In that shell, if you type @code{ls /gnu/store}, you'll notice that @file{/gnu/store} shows up and contains all the dependencies of @code{bash}, even though the machine actually lacks @file{/gnu/store} altogether! That is probably the simplest way to deploy Guix-built software on a non-Guix machine."
  10688. msgstr ""
  10689. #. type: quotation
  10690. #: guix-git/doc/guix.texi:6119
  10691. msgid "By default, relocatable binaries rely on the @dfn{user namespace} feature of the kernel Linux, which allows unprivileged users to mount or change root. Old versions of Linux did not support it, and some GNU/Linux distributions turn it off."
  10692. msgstr ""
  10693. #. type: quotation
  10694. #: guix-git/doc/guix.texi:6125
  10695. msgid "To produce relocatable binaries that work even in the absence of user namespaces, pass @option{--relocatable} or @option{-R} @emph{twice}. In that case, binaries will try user namespace support and fall back to another @dfn{execution engine} if user namespaces are not supported. The following execution engines are supported:"
  10696. msgstr ""
  10697. #. type: item
  10698. #: guix-git/doc/guix.texi:6127 guix-git/doc/guix.texi:16403
  10699. #, no-wrap
  10700. msgid "default"
  10701. msgstr ""
  10702. #. type: table
  10703. #: guix-git/doc/guix.texi:6130
  10704. msgid "Try user namespaces and fall back to PRoot if user namespaces are not supported (see below)."
  10705. msgstr ""
  10706. #. type: item
  10707. #: guix-git/doc/guix.texi:6131
  10708. #, no-wrap
  10709. msgid "performance"
  10710. msgstr ""
  10711. #. type: table
  10712. #: guix-git/doc/guix.texi:6134
  10713. msgid "Try user namespaces and fall back to Fakechroot if user namespaces are not supported (see below)."
  10714. msgstr ""
  10715. #. type: item
  10716. #: guix-git/doc/guix.texi:6135
  10717. #, no-wrap
  10718. msgid "userns"
  10719. msgstr ""
  10720. #. type: table
  10721. #: guix-git/doc/guix.texi:6138
  10722. msgid "Run the program through user namespaces and abort if they are not supported."
  10723. msgstr ""
  10724. #. type: item
  10725. #: guix-git/doc/guix.texi:6139
  10726. #, no-wrap
  10727. msgid "proot"
  10728. msgstr ""
  10729. #. type: table
  10730. #: guix-git/doc/guix.texi:6146
  10731. msgid "Run through PRoot. The @uref{https://proot-me.github.io/, PRoot} program provides the necessary support for file system virtualization. It achieves that by using the @code{ptrace} system call on the running program. This approach has the advantage to work without requiring special kernel support, but it incurs run-time overhead every time a system call is made."
  10732. msgstr ""
  10733. #. type: item
  10734. #: guix-git/doc/guix.texi:6147
  10735. #, no-wrap
  10736. msgid "fakechroot"
  10737. msgstr ""
  10738. #. type: table
  10739. #: guix-git/doc/guix.texi:6155
  10740. msgid "Run through Fakechroot. @uref{https://github.com/dex4er/fakechroot/, Fakechroot} virtualizes file system accesses by intercepting calls to C library functions such as @code{open}, @code{stat}, @code{exec}, and so on. Unlike PRoot, it incurs very little overhead. However, it does not always work: for example, some file system accesses made from within the C library are not intercepted, and file system accesses made @i{via} direct syscalls are not intercepted either, leading to erratic behavior."
  10741. msgstr ""
  10742. #. type: vindex
  10743. #: guix-git/doc/guix.texi:6157
  10744. #, no-wrap
  10745. msgid "GUIX_EXECUTION_ENGINE"
  10746. msgstr ""
  10747. #. type: quotation
  10748. #: guix-git/doc/guix.texi:6161
  10749. msgid "When running a wrapped program, you can explicitly request one of the execution engines listed above by setting the @env{GUIX_EXECUTION_ENGINE} environment variable accordingly."
  10750. msgstr ""
  10751. #. type: cindex
  10752. #: guix-git/doc/guix.texi:6163
  10753. #, no-wrap
  10754. msgid "entry point, for Docker images"
  10755. msgstr ""
  10756. #. type: item
  10757. #: guix-git/doc/guix.texi:6164
  10758. #, no-wrap
  10759. msgid "--entry-point=@var{command}"
  10760. msgstr ""
  10761. #. type: table
  10762. #: guix-git/doc/guix.texi:6169
  10763. msgid "Use @var{command} as the @dfn{entry point} of the resulting pack, if the pack format supports it---currently @code{docker} and @code{squashfs} (Singularity) support it. @var{command} must be relative to the profile contained in the pack."
  10764. msgstr ""
  10765. #. type: table
  10766. #: guix-git/doc/guix.texi:6173
  10767. msgid "The entry point specifies the command that tools like @code{docker run} or @code{singularity run} automatically start by default. For example, you can do:"
  10768. msgstr ""
  10769. #. type: example
  10770. #: guix-git/doc/guix.texi:6176
  10771. #, no-wrap
  10772. msgid "guix pack -f docker --entry-point=bin/guile guile\n"
  10773. msgstr ""
  10774. #. type: table
  10775. #: guix-git/doc/guix.texi:6180
  10776. msgid "The resulting pack can easily be loaded and @code{docker run} with no extra arguments will spawn @code{bin/guile}:"
  10777. msgstr ""
  10778. #. type: example
  10779. #: guix-git/doc/guix.texi:6184
  10780. #, no-wrap
  10781. msgid ""
  10782. "docker load -i pack.tar.gz\n"
  10783. "docker run @var{image-id}\n"
  10784. msgstr ""
  10785. #. type: table
  10786. #: guix-git/doc/guix.texi:6189 guix-git/doc/guix.texi:11832
  10787. #: guix-git/doc/guix.texi:12629
  10788. msgid "Consider the package @var{expr} evaluates to."
  10789. msgstr ""
  10790. #. type: table
  10791. #: guix-git/doc/guix.texi:6193
  10792. msgid "This has the same purpose as the same-named option in @command{guix build} (@pxref{Additional Build Options, @option{--expression} in @command{guix build}})."
  10793. msgstr ""
  10794. #. type: table
  10795. #: guix-git/doc/guix.texi:6199
  10796. msgid "Use the packages contained in the manifest object returned by the Scheme code in @var{file}. This option can be repeated several times, in which case the manifests are concatenated."
  10797. msgstr ""
  10798. #. type: table
  10799. #: guix-git/doc/guix.texi:6207
  10800. msgid "This has a similar purpose as the same-named option in @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) and uses the same manifest files. It allows you to define a collection of packages once and use it both for creating profiles and for creating archives for use on machines that do not have Guix installed. Note that you can specify @emph{either} a manifest file @emph{or} a list of packages, but not both."
  10801. msgstr ""
  10802. #. type: item
  10803. #: guix-git/doc/guix.texi:6213 guix-git/doc/guix.texi:10901
  10804. #, no-wrap
  10805. msgid "--target=@var{triplet}"
  10806. msgstr ""
  10807. #. type: cindex
  10808. #: guix-git/doc/guix.texi:6214 guix-git/doc/guix.texi:6665
  10809. #: guix-git/doc/guix.texi:10902
  10810. #, no-wrap
  10811. msgid "cross-compilation"
  10812. msgstr ""
  10813. #. type: table
  10814. #: guix-git/doc/guix.texi:6218
  10815. msgid "Cross-build for @var{triplet}, which must be a valid GNU triplet, such as @code{\"aarch64-linux-gnu\"} (@pxref{Specifying target triplets, GNU configuration triplets,, autoconf, Autoconf})."
  10816. msgstr ""
  10817. #. type: item
  10818. #: guix-git/doc/guix.texi:6219
  10819. #, no-wrap
  10820. msgid "--compression=@var{tool}"
  10821. msgstr ""
  10822. #. type: itemx
  10823. #: guix-git/doc/guix.texi:6220
  10824. #, no-wrap
  10825. msgid "-C @var{tool}"
  10826. msgstr ""
  10827. #. type: table
  10828. #: guix-git/doc/guix.texi:6224
  10829. msgid "Compress the resulting tarball using @var{tool}---one of @code{gzip}, @code{zstd}, @code{bzip2}, @code{xz}, @code{lzip}, or @code{none} for no compression."
  10830. msgstr ""
  10831. #. type: item
  10832. #: guix-git/doc/guix.texi:6225
  10833. #, no-wrap
  10834. msgid "--symlink=@var{spec}"
  10835. msgstr ""
  10836. #. type: itemx
  10837. #: guix-git/doc/guix.texi:6226
  10838. #, no-wrap
  10839. msgid "-S @var{spec}"
  10840. msgstr ""
  10841. #. type: table
  10842. #: guix-git/doc/guix.texi:6229
  10843. msgid "Add the symlinks specified by @var{spec} to the pack. This option can appear several times."
  10844. msgstr ""
  10845. #. type: table
  10846. #: guix-git/doc/guix.texi:6233
  10847. msgid "@var{spec} has the form @code{@var{source}=@var{target}}, where @var{source} is the symlink that will be created and @var{target} is the symlink target."
  10848. msgstr ""
  10849. #. type: table
  10850. #: guix-git/doc/guix.texi:6236
  10851. msgid "For instance, @code{-S /opt/gnu/bin=bin} creates a @file{/opt/gnu/bin} symlink pointing to the @file{bin} sub-directory of the profile."
  10852. msgstr ""
  10853. #. type: item
  10854. #: guix-git/doc/guix.texi:6237 guix-git/doc/guix.texi:33854
  10855. #, no-wrap
  10856. msgid "--save-provenance"
  10857. msgstr ""
  10858. #. type: table
  10859. #: guix-git/doc/guix.texi:6241
  10860. msgid "Save provenance information for the packages passed on the command line. Provenance information includes the URL and commit of the channels in use (@pxref{Channels})."
  10861. msgstr ""
  10862. #. type: table
  10863. #: guix-git/doc/guix.texi:6247
  10864. msgid "Provenance information is saved in the @file{/gnu/store/@dots{}-profile/manifest} file in the pack, along with the usual package metadata---the name and version of each package, their propagated inputs, and so on. It is useful information to the recipient of the pack, who then knows how the pack was (supposedly) obtained."
  10865. msgstr ""
  10866. #. type: table
  10867. #: guix-git/doc/guix.texi:6253
  10868. msgid "This option is not enabled by default because, like timestamps, provenance information contributes nothing to the build process. In other words, there is an infinity of channel URLs and commit IDs that can lead to the same pack. Recording such ``silent'' metadata in the output thus potentially breaks the source-to-binary bitwise reproducibility property."
  10869. msgstr ""
  10870. #. type: cindex
  10871. #: guix-git/doc/guix.texi:6256
  10872. #, no-wrap
  10873. msgid "garbage collector root, for packs"
  10874. msgstr ""
  10875. #. type: table
  10876. #: guix-git/doc/guix.texi:6259
  10877. msgid "Make @var{file} a symlink to the resulting pack, and register it as a garbage collector root."
  10878. msgstr ""
  10879. #. type: item
  10880. #: guix-git/doc/guix.texi:6260
  10881. #, no-wrap
  10882. msgid "--localstatedir"
  10883. msgstr ""
  10884. #. type: itemx
  10885. #: guix-git/doc/guix.texi:6261
  10886. #, no-wrap
  10887. msgid "--profile-name=@var{name}"
  10888. msgstr ""
  10889. #. type: table
  10890. #: guix-git/doc/guix.texi:6266
  10891. msgid "Include the ``local state directory'', @file{/var/guix}, in the resulting pack, and notably the @file{/var/guix/profiles/per-user/root/@var{name}} profile---by default @var{name} is @code{guix-profile}, which corresponds to @file{~root/.guix-profile}."
  10892. msgstr ""
  10893. #. type: table
  10894. #: guix-git/doc/guix.texi:6272
  10895. msgid "@file{/var/guix} contains the store database (@pxref{The Store}) as well as garbage-collector roots (@pxref{Invoking guix gc}). Providing it in the pack means that the store is ``complete'' and manageable by Guix; not providing it pack means that the store is ``dead'': items cannot be added to it or removed from it after extraction of the pack."
  10896. msgstr ""
  10897. #. type: table
  10898. #: guix-git/doc/guix.texi:6275
  10899. msgid "One use case for this is the Guix self-contained binary tarball (@pxref{Binary Installation})."
  10900. msgstr ""
  10901. #. type: item
  10902. #: guix-git/doc/guix.texi:6276 guix-git/doc/guix.texi:33848
  10903. #, no-wrap
  10904. msgid "--derivation"
  10905. msgstr ""
  10906. #. type: itemx
  10907. #: guix-git/doc/guix.texi:6277 guix-git/doc/guix.texi:10933
  10908. #: guix-git/doc/guix.texi:33849
  10909. #, no-wrap
  10910. msgid "-d"
  10911. msgstr ""
  10912. #. type: table
  10913. #: guix-git/doc/guix.texi:6279
  10914. msgid "Print the name of the derivation that builds the pack."
  10915. msgstr ""
  10916. #. type: table
  10917. #: guix-git/doc/guix.texi:6283
  10918. msgid "Use the bootstrap binaries to build the pack. This option is only useful to Guix developers."
  10919. msgstr ""
  10920. #. type: Plain text
  10921. #: guix-git/doc/guix.texi:6288
  10922. msgid "In addition, @command{guix pack} supports all the common build options (@pxref{Common Build Options}) and all the package transformation options (@pxref{Package Transformation Options})."
  10923. msgstr ""
  10924. #. type: cindex
  10925. #: guix-git/doc/guix.texi:6293
  10926. #, no-wrap
  10927. msgid "GCC"
  10928. msgstr ""
  10929. #. type: cindex
  10930. #: guix-git/doc/guix.texi:6294
  10931. #, no-wrap
  10932. msgid "ld-wrapper"
  10933. msgstr ""
  10934. #. type: cindex
  10935. #: guix-git/doc/guix.texi:6295
  10936. #, no-wrap
  10937. msgid "linker wrapper"
  10938. msgstr ""
  10939. #. type: cindex
  10940. #: guix-git/doc/guix.texi:6296
  10941. #, no-wrap
  10942. msgid "toolchain, for C development"
  10943. msgstr ""
  10944. #. type: cindex
  10945. #: guix-git/doc/guix.texi:6297
  10946. #, no-wrap
  10947. msgid "toolchain, for Fortran development"
  10948. msgstr ""
  10949. #. type: Plain text
  10950. #: guix-git/doc/guix.texi:6304
  10951. msgid "If you need a complete toolchain for compiling and linking C or C++ source code, use the @code{gcc-toolchain} package. This package provides a complete GCC toolchain for C/C++ development, including GCC itself, the GNU C Library (headers and binaries, plus debugging symbols in the @code{debug} output), Binutils, and a linker wrapper."
  10952. msgstr ""
  10953. #. type: Plain text
  10954. #: guix-git/doc/guix.texi:6310
  10955. msgid "The wrapper's purpose is to inspect the @code{-L} and @code{-l} switches passed to the linker, add corresponding @code{-rpath} arguments, and invoke the actual linker with this new set of arguments. You can instruct the wrapper to refuse to link against libraries not in the store by setting the @env{GUIX_LD_WRAPPER_ALLOW_IMPURITIES} environment variable to @code{no}."
  10956. msgstr ""
  10957. #. type: Plain text
  10958. #: guix-git/doc/guix.texi:6314
  10959. msgid "The package @code{gfortran-toolchain} provides a complete GCC toolchain for Fortran development. For other languages, please use @samp{guix search gcc toolchain} (@pxref{guix-search,, Invoking guix package})."
  10960. msgstr ""
  10961. #. type: section
  10962. #: guix-git/doc/guix.texi:6317
  10963. #, no-wrap
  10964. msgid "Invoking @command{guix git authenticate}"
  10965. msgstr ""
  10966. #. type: Plain text
  10967. #: guix-git/doc/guix.texi:6325
  10968. msgid "The @command{guix git authenticate} command authenticates a Git checkout following the same rule as for channels (@pxref{channel-authentication, channel authentication}). That is, starting from a given commit, it ensures that all subsequent commits are signed by an OpenPGP key whose fingerprint appears in the @file{.guix-authorizations} file of its parent commit(s)."
  10969. msgstr ""
  10970. #. type: Plain text
  10971. #: guix-git/doc/guix.texi:6330
  10972. msgid "You will find this command useful if you maintain a channel. But in fact, this authentication mechanism is useful in a broader context, so you might want to use it for Git repositories that have nothing to do with Guix."
  10973. msgstr ""
  10974. #. type: example
  10975. #: guix-git/doc/guix.texi:6335
  10976. #, no-wrap
  10977. msgid "guix git authenticate @var{commit} @var{signer} [@var{options}@dots{}]\n"
  10978. msgstr ""
  10979. #. type: Plain text
  10980. #: guix-git/doc/guix.texi:6344
  10981. msgid "By default, this command authenticates the Git checkout in the current directory; it outputs nothing and exits with exit code zero on success and non-zero on failure. @var{commit} above denotes the first commit where authentication takes place, and @var{signer} is the OpenPGP fingerprint of public key used to sign @var{commit}. Together, they form a ``channel introduction'' (@pxref{channel-authentication, channel introduction}). The options below allow you to fine-tune the process."
  10982. msgstr ""
  10983. #. type: item
  10984. #: guix-git/doc/guix.texi:6346
  10985. #, no-wrap
  10986. msgid "--repository=@var{directory}"
  10987. msgstr ""
  10988. #. type: itemx
  10989. #: guix-git/doc/guix.texi:6347
  10990. #, no-wrap
  10991. msgid "-r @var{directory}"
  10992. msgstr ""
  10993. #. type: table
  10994. #: guix-git/doc/guix.texi:6350
  10995. msgid "Open the Git repository in @var{directory} instead of the current directory."
  10996. msgstr ""
  10997. #. type: item
  10998. #: guix-git/doc/guix.texi:6351
  10999. #, no-wrap
  11000. msgid "--keyring=@var{reference}"
  11001. msgstr ""
  11002. #. type: itemx
  11003. #: guix-git/doc/guix.texi:6352
  11004. #, no-wrap
  11005. msgid "-k @var{reference}"
  11006. msgstr ""
  11007. #. type: table
  11008. #: guix-git/doc/guix.texi:6358
  11009. msgid "Load OpenPGP keyring from @var{reference}, the reference of a branch such as @code{origin/keyring} or @code{my-keyring}. The branch must contain OpenPGP public keys in @file{.key} files, either in binary form or ``ASCII-armored''. By default the keyring is loaded from the branch named @code{keyring}."
  11010. msgstr ""
  11011. #. type: item
  11012. #: guix-git/doc/guix.texi:6359
  11013. #, no-wrap
  11014. msgid "--stats"
  11015. msgstr ""
  11016. #. type: table
  11017. #: guix-git/doc/guix.texi:6361
  11018. msgid "Display commit signing statistics upon completion."
  11019. msgstr ""
  11020. #. type: item
  11021. #: guix-git/doc/guix.texi:6362
  11022. #, no-wrap
  11023. msgid "--cache-key=@var{key}"
  11024. msgstr ""
  11025. #. type: table
  11026. #: guix-git/doc/guix.texi:6366
  11027. msgid "Previously-authenticated commits are cached in a file under @file{~/.cache/guix/authentication}. This option forces the cache to be stored in file @var{key} in that directory."
  11028. msgstr ""
  11029. #. type: item
  11030. #: guix-git/doc/guix.texi:6367
  11031. #, no-wrap
  11032. msgid "--historical-authorizations=@var{file}"
  11033. msgstr ""
  11034. #. type: table
  11035. #: guix-git/doc/guix.texi:6374
  11036. msgid "By default, any commit whose parent commit(s) lack the @file{.guix-authorizations} file is considered inauthentic. In contrast, this option considers the authorizations in @var{file} for any commit that lacks @file{.guix-authorizations}. The format of @var{file} is the same as that of @file{.guix-authorizations} (@pxref{channel-authorizations, @file{.guix-authorizations} format})."
  11037. msgstr ""
  11038. #. type: Plain text
  11039. #: guix-git/doc/guix.texi:6387
  11040. msgid "GNU Guix provides several Scheme programming interfaces (APIs) to define, build, and query packages. The first interface allows users to write high-level package definitions. These definitions refer to familiar packaging concepts, such as the name and version of a package, its build system, and its dependencies. These definitions can then be turned into concrete build actions."
  11041. msgstr ""
  11042. #. type: Plain text
  11043. #: guix-git/doc/guix.texi:6393
  11044. msgid "Build actions are performed by the Guix daemon, on behalf of users. In a standard setup, the daemon has write access to the store---the @file{/gnu/store} directory---whereas users do not. The recommended setup also has the daemon perform builds in chroots, under specific build users, to minimize interference with the rest of the system."
  11045. msgstr ""
  11046. #. type: Plain text
  11047. #: guix-git/doc/guix.texi:6402
  11048. msgid "Lower-level APIs are available to interact with the daemon and the store. To instruct the daemon to perform a build action, users actually provide it with a @dfn{derivation}. A derivation is a low-level representation of the build actions to be taken, and the environment in which they should occur---derivations are to package definitions what assembly is to C programs. The term ``derivation'' comes from the fact that build results @emph{derive} from them."
  11049. msgstr ""
  11050. #. type: Plain text
  11051. #: guix-git/doc/guix.texi:6405
  11052. msgid "This chapter describes all these APIs in turn, starting from high-level package definitions."
  11053. msgstr ""
  11054. #. type: menuentry
  11055. #: guix-git/doc/guix.texi:6418
  11056. msgid "Programming Guix in Guile"
  11057. msgstr ""
  11058. #. type: Plain text
  11059. #: guix-git/doc/guix.texi:6434
  11060. msgid "From a programming viewpoint, the package definitions of the GNU distribution are provided by Guile modules in the @code{(gnu packages @dots{})} name space@footnote{Note that packages under the @code{(gnu packages @dots{})} module name space are not necessarily ``GNU packages''. This module naming scheme follows the usual Guile module naming convention: @code{gnu} means that these modules are distributed as part of the GNU system, and @code{packages} identifies modules that define packages.} (@pxref{Modules, Guile modules,, guile, GNU Guile Reference Manual}). For instance, the @code{(gnu packages emacs)} module exports a variable named @code{emacs}, which is bound to a @code{<package>} object (@pxref{Defining Packages})."
  11061. msgstr ""
  11062. #. type: Plain text
  11063. #: guix-git/doc/guix.texi:6441
  11064. msgid "The @code{(gnu packages @dots{})} module name space is automatically scanned for packages by the command-line tools. For instance, when running @code{guix install emacs}, all the @code{(gnu packages @dots{})} modules are scanned until one that exports a package object whose name is @code{emacs} is found. This package search facility is implemented in the @code{(gnu packages)} module."
  11065. msgstr ""
  11066. #. type: cindex
  11067. #: guix-git/doc/guix.texi:6443
  11068. #, no-wrap
  11069. msgid "package module search path"
  11070. msgstr ""
  11071. #. type: Plain text
  11072. #: guix-git/doc/guix.texi:6452
  11073. msgid "Users can store package definitions in modules with different names---e.g., @code{(my-packages emacs)}@footnote{Note that the file name and module name must match. For instance, the @code{(my-packages emacs)} module must be stored in a @file{my-packages/emacs.scm} file relative to the load path specified with @option{--load-path} or @env{GUIX_PACKAGE_PATH}. @xref{Modules and the File System,,, guile, GNU Guile Reference Manual}, for details.}. There are two ways to make these package definitions visible to the user interfaces:"
  11074. msgstr ""
  11075. #. type: enumerate
  11076. #: guix-git/doc/guix.texi:6459
  11077. msgid "By adding the directory containing your package modules to the search path with the @code{-L} flag of @command{guix package} and other commands (@pxref{Common Build Options}), or by setting the @env{GUIX_PACKAGE_PATH} environment variable described below."
  11078. msgstr ""
  11079. #. type: enumerate
  11080. #: guix-git/doc/guix.texi:6465
  11081. msgid "By defining a @dfn{channel} and configuring @command{guix pull} so that it pulls from it. A channel is essentially a Git repository containing package modules. @xref{Channels}, for more information on how to define and use channels."
  11082. msgstr ""
  11083. #. type: Plain text
  11084. #: guix-git/doc/guix.texi:6468
  11085. msgid "@env{GUIX_PACKAGE_PATH} works similarly to other search path variables:"
  11086. msgstr ""
  11087. #. type: defvr
  11088. #: guix-git/doc/guix.texi:6469
  11089. #, no-wrap
  11090. msgid "{Environment Variable} GUIX_PACKAGE_PATH"
  11091. msgstr ""
  11092. #. type: defvr
  11093. #: guix-git/doc/guix.texi:6473
  11094. msgid "This is a colon-separated list of directories to search for additional package modules. Directories listed in this variable take precedence over the own modules of the distribution."
  11095. msgstr ""
  11096. #. type: Plain text
  11097. #: guix-git/doc/guix.texi:6481
  11098. msgid "The distribution is fully @dfn{bootstrapped} and @dfn{self-contained}: each package is built based solely on other packages in the distribution. The root of this dependency graph is a small set of @dfn{bootstrap binaries}, provided by the @code{(gnu packages bootstrap)} module. For more information on bootstrapping, @pxref{Bootstrapping}."
  11099. msgstr ""
  11100. #. type: Plain text
  11101. #: guix-git/doc/guix.texi:6489
  11102. msgid "The high-level interface to package definitions is implemented in the @code{(guix packages)} and @code{(guix build-system)} modules. As an example, the package definition, or @dfn{recipe}, for the GNU Hello package looks like this:"
  11103. msgstr ""
  11104. #. type: lisp
  11105. #: guix-git/doc/guix.texi:6497
  11106. #, no-wrap
  11107. msgid ""
  11108. "(define-module (gnu packages hello)\n"
  11109. " #:use-module (guix packages)\n"
  11110. " #:use-module (guix download)\n"
  11111. " #:use-module (guix build-system gnu)\n"
  11112. " #:use-module (guix licenses)\n"
  11113. " #:use-module (gnu packages gawk))\n"
  11114. "\n"
  11115. msgstr ""
  11116. #. type: lisp
  11117. #: guix-git/doc/guix.texi:6516
  11118. #, no-wrap
  11119. msgid ""
  11120. "(define-public hello\n"
  11121. " (package\n"
  11122. " (name \"hello\")\n"
  11123. " (version \"2.10\")\n"
  11124. " (source (origin\n"
  11125. " (method url-fetch)\n"
  11126. " (uri (string-append \"mirror://gnu/hello/hello-\" version\n"
  11127. " \".tar.gz\"))\n"
  11128. " (sha256\n"
  11129. " (base32\n"
  11130. " \"0ssi1wpaf7plaswqqjwigppsg5fyh99vdlb9kzl7c9lng89ndq1i\"))))\n"
  11131. " (build-system gnu-build-system)\n"
  11132. " (arguments '(#:configure-flags '(\"--enable-silent-rules\")))\n"
  11133. " (inputs `((\"gawk\" ,gawk)))\n"
  11134. " (synopsis \"Hello, GNU world: An example GNU package\")\n"
  11135. " (description \"Guess what GNU Hello prints!\")\n"
  11136. " (home-page \"https://www.gnu.org/software/hello/\")\n"
  11137. " (license gpl3+)))\n"
  11138. msgstr ""
  11139. #. type: Plain text
  11140. #: guix-git/doc/guix.texi:6526
  11141. msgid "Without being a Scheme expert, the reader may have guessed the meaning of the various fields here. This expression binds the variable @code{hello} to a @code{<package>} object, which is essentially a record (@pxref{SRFI-9, Scheme records,, guile, GNU Guile Reference Manual}). This package object can be inspected using procedures found in the @code{(guix packages)} module; for instance, @code{(package-name hello)} returns---surprise!---@code{\"hello\"}."
  11142. msgstr ""
  11143. #. type: Plain text
  11144. #: guix-git/doc/guix.texi:6530
  11145. msgid "With luck, you may be able to import part or all of the definition of the package you are interested in from another repository, using the @code{guix import} command (@pxref{Invoking guix import})."
  11146. msgstr ""
  11147. #. type: Plain text
  11148. #: guix-git/doc/guix.texi:6536
  11149. msgid "In the example above, @code{hello} is defined in a module of its own, @code{(gnu packages hello)}. Technically, this is not strictly necessary, but it is convenient to do so: all the packages defined in modules under @code{(gnu packages @dots{})} are automatically known to the command-line tools (@pxref{Package Modules})."
  11150. msgstr ""
  11151. #. type: Plain text
  11152. #: guix-git/doc/guix.texi:6538
  11153. msgid "There are a few points worth noting in the above package definition:"
  11154. msgstr ""
  11155. #. type: itemize
  11156. #: guix-git/doc/guix.texi:6545
  11157. msgid "The @code{source} field of the package is an @code{<origin>} object (@pxref{origin Reference}, for the complete reference). Here, the @code{url-fetch} method from @code{(guix download)} is used, meaning that the source is a file to be downloaded over FTP or HTTP."
  11158. msgstr ""
  11159. #. type: itemize
  11160. #: guix-git/doc/guix.texi:6548
  11161. msgid "The @code{mirror://gnu} prefix instructs @code{url-fetch} to use one of the GNU mirrors defined in @code{(guix download)}."
  11162. msgstr ""
  11163. #. type: itemize
  11164. #: guix-git/doc/guix.texi:6555
  11165. msgid "The @code{sha256} field specifies the expected SHA256 hash of the file being downloaded. It is mandatory, and allows Guix to check the integrity of the file. The @code{(base32 @dots{})} form introduces the base32 representation of the hash. You can obtain this information with @code{guix download} (@pxref{Invoking guix download}) and @code{guix hash} (@pxref{Invoking guix hash})."
  11166. msgstr ""
  11167. #. type: cindex
  11168. #: guix-git/doc/guix.texi:6556
  11169. #, no-wrap
  11170. msgid "patches"
  11171. msgstr ""
  11172. #. type: itemize
  11173. #: guix-git/doc/guix.texi:6560
  11174. msgid "When needed, the @code{origin} form can also have a @code{patches} field listing patches to be applied, and a @code{snippet} field giving a Scheme expression to modify the source code."
  11175. msgstr ""
  11176. #. type: cindex
  11177. #: guix-git/doc/guix.texi:6562
  11178. #, no-wrap
  11179. msgid "GNU Build System"
  11180. msgstr ""
  11181. #. type: itemize
  11182. #: guix-git/doc/guix.texi:6568
  11183. msgid "The @code{build-system} field specifies the procedure to build the package (@pxref{Build Systems}). Here, @code{gnu-build-system} represents the familiar GNU Build System, where packages may be configured, built, and installed with the usual @code{./configure && make && make check && make install} command sequence."
  11184. msgstr ""
  11185. #. type: itemize
  11186. #: guix-git/doc/guix.texi:6572
  11187. msgid "When you start packaging non-trivial software, you may need tools to manipulate those build phases, manipulate files, and so on. @xref{Build Utilities}, for more on this."
  11188. msgstr ""
  11189. #. type: itemize
  11190. #: guix-git/doc/guix.texi:6578
  11191. msgid "The @code{arguments} field specifies options for the build system (@pxref{Build Systems}). Here it is interpreted by @code{gnu-build-system} as a request run @file{configure} with the @option{--enable-silent-rules} flag."
  11192. msgstr ""
  11193. #. type: findex
  11194. #: guix-git/doc/guix.texi:6579 guix-git/doc/guix.texi:6582
  11195. #, no-wrap
  11196. msgid "quote"
  11197. msgstr ""
  11198. #. type: cindex
  11199. #: guix-git/doc/guix.texi:6580
  11200. #, no-wrap
  11201. msgid "quoting"
  11202. msgstr ""
  11203. #. type: findex
  11204. #: guix-git/doc/guix.texi:6581
  11205. #, no-wrap
  11206. msgid "'"
  11207. msgstr ""
  11208. #. type: itemize
  11209. #: guix-git/doc/guix.texi:6590
  11210. msgid "What about these quote (@code{'}) characters? They are Scheme syntax to introduce a literal list; @code{'} is synonymous with @code{quote}. @xref{Expression Syntax, quoting,, guile, GNU Guile Reference Manual}, for details. Here the value of the @code{arguments} field is a list of arguments passed to the build system down the road, as with @code{apply} (@pxref{Fly Evaluation, @code{apply},, guile, GNU Guile Reference Manual})."
  11211. msgstr ""
  11212. #. type: itemize
  11213. #: guix-git/doc/guix.texi:6596
  11214. msgid "The hash-colon (@code{#:}) sequence defines a Scheme @dfn{keyword} (@pxref{Keywords,,, guile, GNU Guile Reference Manual}), and @code{#:configure-flags} is a keyword used to pass a keyword argument to the build system (@pxref{Coding With Keywords,,, guile, GNU Guile Reference Manual})."
  11215. msgstr ""
  11216. #. type: itemize
  11217. #: guix-git/doc/guix.texi:6602
  11218. msgid "The @code{inputs} field specifies inputs to the build process---i.e., build-time or run-time dependencies of the package. Here, we define an input called @code{\"gawk\"} whose value is that of the @code{gawk} variable; @code{gawk} is itself bound to a @code{<package>} object."
  11219. msgstr ""
  11220. #. type: cindex
  11221. #: guix-git/doc/guix.texi:6603
  11222. #, no-wrap
  11223. msgid "backquote (quasiquote)"
  11224. msgstr ""
  11225. #. type: findex
  11226. #: guix-git/doc/guix.texi:6604
  11227. #, no-wrap
  11228. msgid "`"
  11229. msgstr ""
  11230. #. type: findex
  11231. #: guix-git/doc/guix.texi:6605
  11232. #, no-wrap
  11233. msgid "quasiquote"
  11234. msgstr ""
  11235. #. type: cindex
  11236. #: guix-git/doc/guix.texi:6606
  11237. #, no-wrap
  11238. msgid "comma (unquote)"
  11239. msgstr ""
  11240. #. type: findex
  11241. #: guix-git/doc/guix.texi:6607
  11242. #, no-wrap
  11243. msgid ","
  11244. msgstr ""
  11245. #. type: findex
  11246. #: guix-git/doc/guix.texi:6608
  11247. #, no-wrap
  11248. msgid "unquote"
  11249. msgstr ""
  11250. #. type: findex
  11251. #: guix-git/doc/guix.texi:6609
  11252. #, no-wrap
  11253. msgid ",@@"
  11254. msgstr ""
  11255. #. type: findex
  11256. #: guix-git/doc/guix.texi:6610
  11257. #, no-wrap
  11258. msgid "unquote-splicing"
  11259. msgstr ""
  11260. #. type: itemize
  11261. #: guix-git/doc/guix.texi:6616
  11262. msgid "Again, @code{`} (a backquote, synonymous with @code{quasiquote}) allows us to introduce a literal list in the @code{inputs} field, while @code{,} (a comma, synonymous with @code{unquote}) allows us to insert a value in that list (@pxref{Expression Syntax, unquote,, guile, GNU Guile Reference Manual})."
  11263. msgstr ""
  11264. #. type: itemize
  11265. #: guix-git/doc/guix.texi:6620
  11266. msgid "Note that GCC, Coreutils, Bash, and other essential tools do not need to be specified as inputs here. Instead, @code{gnu-build-system} takes care of ensuring that they are present (@pxref{Build Systems})."
  11267. msgstr ""
  11268. #. type: itemize
  11269. #: guix-git/doc/guix.texi:6624
  11270. msgid "However, any other dependencies need to be specified in the @code{inputs} field. Any dependency not specified here will simply be unavailable to the build process, possibly leading to a build failure."
  11271. msgstr ""
  11272. #. type: Plain text
  11273. #: guix-git/doc/guix.texi:6627
  11274. msgid "@xref{package Reference}, for a full description of possible fields."
  11275. msgstr ""
  11276. #. type: Plain text
  11277. #: guix-git/doc/guix.texi:6638
  11278. msgid "Once a package definition is in place, the package may actually be built using the @code{guix build} command-line tool (@pxref{Invoking guix build}), troubleshooting any build failures you encounter (@pxref{Debugging Build Failures}). You can easily jump back to the package definition using the @command{guix edit} command (@pxref{Invoking guix edit}). @xref{Packaging Guidelines}, for more information on how to test package definitions, and @ref{Invoking guix lint}, for information on how to check a definition for style conformance."
  11279. msgstr ""
  11280. #. type: vindex
  11281. #: guix-git/doc/guix.texi:6638
  11282. #, no-wrap
  11283. msgid "GUIX_PACKAGE_PATH"
  11284. msgstr ""
  11285. #. type: Plain text
  11286. #: guix-git/doc/guix.texi:6642
  11287. msgid "Lastly, @pxref{Channels}, for information on how to extend the distribution by adding your own package definitions in a ``channel''."
  11288. msgstr ""
  11289. #. type: Plain text
  11290. #: guix-git/doc/guix.texi:6646
  11291. msgid "Finally, updating the package definition to a new upstream version can be partly automated by the @command{guix refresh} command (@pxref{Invoking guix refresh})."
  11292. msgstr ""
  11293. #. type: Plain text
  11294. #: guix-git/doc/guix.texi:6652
  11295. msgid "Behind the scenes, a derivation corresponding to the @code{<package>} object is first computed by the @code{package-derivation} procedure. That derivation is stored in a @file{.drv} file under @file{/gnu/store}. The build actions it prescribes may then be realized by using the @code{build-derivations} procedure (@pxref{The Store})."
  11296. msgstr ""
  11297. #. type: deffn
  11298. #: guix-git/doc/guix.texi:6653
  11299. #, no-wrap
  11300. msgid "{Scheme Procedure} package-derivation @var{store} @var{package} [@var{system}]"
  11301. msgstr ""
  11302. #. type: deffn
  11303. #: guix-git/doc/guix.texi:6656
  11304. msgid "Return the @code{<derivation>} object of @var{package} for @var{system} (@pxref{Derivations})."
  11305. msgstr ""
  11306. #. type: deffn
  11307. #: guix-git/doc/guix.texi:6662
  11308. msgid "@var{package} must be a valid @code{<package>} object, and @var{system} must be a string denoting the target system type---e.g., @code{\"x86_64-linux\"} for an x86_64 Linux-based GNU system. @var{store} must be a connection to the daemon, which operates on the store (@pxref{The Store})."
  11309. msgstr ""
  11310. #. type: Plain text
  11311. #: guix-git/doc/guix.texi:6668
  11312. msgid "Similarly, it is possible to compute a derivation that cross-builds a package for some other system:"
  11313. msgstr ""
  11314. #. type: deffn
  11315. #: guix-git/doc/guix.texi:6669
  11316. #, no-wrap
  11317. msgid "{Scheme Procedure} package-cross-derivation @var{store} @"
  11318. msgstr ""
  11319. #. type: deffn
  11320. #: guix-git/doc/guix.texi:6673
  11321. msgid "@var{package} @var{target} [@var{system}] Return the @code{<derivation>} object of @var{package} cross-built from @var{system} to @var{target}."
  11322. msgstr ""
  11323. #. type: deffn
  11324. #: guix-git/doc/guix.texi:6677
  11325. msgid "@var{target} must be a valid GNU triplet denoting the target hardware and operating system, such as @code{\"aarch64-linux-gnu\"} (@pxref{Specifying Target Triplets,,, autoconf, Autoconf})."
  11326. msgstr ""
  11327. #. type: Plain text
  11328. #: guix-git/doc/guix.texi:6681
  11329. msgid "Once you have package definitions, you can easily define @emph{variants} of those packages. @xref{Defining Package Variants}, for more on that."
  11330. msgstr ""
  11331. #. type: subsection
  11332. #: guix-git/doc/guix.texi:6689
  11333. #, no-wrap
  11334. msgid "@code{package} Reference"
  11335. msgstr ""
  11336. #. type: Plain text
  11337. #: guix-git/doc/guix.texi:6693
  11338. msgid "This section summarizes all the options available in @code{package} declarations (@pxref{Defining Packages})."
  11339. msgstr ""
  11340. #. type: deftp
  11341. #: guix-git/doc/guix.texi:6694
  11342. #, no-wrap
  11343. msgid "{Data Type} package"
  11344. msgstr ""
  11345. #. type: deftp
  11346. #: guix-git/doc/guix.texi:6696
  11347. msgid "This is the data type representing a package recipe."
  11348. msgstr ""
  11349. #. type: table
  11350. #: guix-git/doc/guix.texi:6700
  11351. msgid "The name of the package, as a string."
  11352. msgstr ""
  11353. #. type: code{#1}
  11354. #: guix-git/doc/guix.texi:6701
  11355. #, no-wrap
  11356. msgid "version"
  11357. msgstr ""
  11358. #. type: table
  11359. #: guix-git/doc/guix.texi:6704
  11360. msgid "The version of the package, as a string. @xref{Version Numbers}, for guidelines."
  11361. msgstr ""
  11362. #. type: code{#1}
  11363. #: guix-git/doc/guix.texi:6705 guix-git/doc/guix.texi:12105
  11364. #: guix-git/doc/guix.texi:14363 guix-git/doc/guix.texi:14866
  11365. #, no-wrap
  11366. msgid "source"
  11367. msgstr ""
  11368. #. type: table
  11369. #: guix-git/doc/guix.texi:6712
  11370. msgid "An object telling how the source code for the package should be acquired. Most of the time, this is an @code{origin} object, which denotes a file fetched from the Internet (@pxref{origin Reference}). It can also be any other ``file-like'' object such as a @code{local-file}, which denotes a file from the local file system (@pxref{G-Expressions, @code{local-file}})."
  11371. msgstr ""
  11372. #. type: code{#1}
  11373. #: guix-git/doc/guix.texi:6713
  11374. #, no-wrap
  11375. msgid "build-system"
  11376. msgstr ""
  11377. #. type: table
  11378. #: guix-git/doc/guix.texi:6716
  11379. msgid "The build system that should be used to build the package (@pxref{Build Systems})."
  11380. msgstr ""
  11381. #. type: item
  11382. #: guix-git/doc/guix.texi:6717 guix-git/doc/guix.texi:16851
  11383. #, no-wrap
  11384. msgid "@code{arguments} (default: @code{'()})"
  11385. msgstr ""
  11386. #. type: table
  11387. #: guix-git/doc/guix.texi:6720
  11388. msgid "The arguments that should be passed to the build system. This is a list, typically containing sequential keyword-value pairs."
  11389. msgstr ""
  11390. #. type: item
  11391. #: guix-git/doc/guix.texi:6721
  11392. #, no-wrap
  11393. msgid "@code{inputs} (default: @code{'()})"
  11394. msgstr ""
  11395. #. type: itemx
  11396. #: guix-git/doc/guix.texi:6722
  11397. #, no-wrap
  11398. msgid "@code{native-inputs} (default: @code{'()})"
  11399. msgstr ""
  11400. #. type: itemx
  11401. #: guix-git/doc/guix.texi:6723
  11402. #, no-wrap
  11403. msgid "@code{propagated-inputs} (default: @code{'()})"
  11404. msgstr ""
  11405. #. type: cindex
  11406. #: guix-git/doc/guix.texi:6724
  11407. #, no-wrap
  11408. msgid "inputs, of packages"
  11409. msgstr ""
  11410. #. type: table
  11411. #: guix-git/doc/guix.texi:6732
  11412. msgid "These fields list dependencies of the package. Each one is a list of tuples, where each tuple has a label for the input (a string) as its first element, a package, origin, or derivation as its second element, and optionally the name of the output thereof that should be used, which defaults to @code{\"out\"} (@pxref{Packages with Multiple Outputs}, for more on package outputs). For example, the list below specifies three inputs:"
  11413. msgstr ""
  11414. #. type: lisp
  11415. #: guix-git/doc/guix.texi:6737
  11416. #, no-wrap
  11417. msgid ""
  11418. "`((\"libffi\" ,libffi)\n"
  11419. " (\"libunistring\" ,libunistring)\n"
  11420. " (\"glib:bin\" ,glib \"bin\")) ;the \"bin\" output of Glib\n"
  11421. msgstr ""
  11422. #. type: cindex
  11423. #: guix-git/doc/guix.texi:6739
  11424. #, no-wrap
  11425. msgid "cross compilation, package dependencies"
  11426. msgstr ""
  11427. #. type: table
  11428. #: guix-git/doc/guix.texi:6745
  11429. msgid "The distinction between @code{native-inputs} and @code{inputs} is necessary when considering cross-compilation. When cross-compiling, dependencies listed in @code{inputs} are built for the @emph{target} architecture; conversely, dependencies listed in @code{native-inputs} are built for the architecture of the @emph{build} machine."
  11430. msgstr ""
  11431. #. type: table
  11432. #: guix-git/doc/guix.texi:6750
  11433. msgid "@code{native-inputs} is typically used to list tools needed at build time, but not at run time, such as Autoconf, Automake, pkg-config, Gettext, or Bison. @command{guix lint} can report likely mistakes in this area (@pxref{Invoking guix lint})."
  11434. msgstr ""
  11435. #. type: anchor{#1}
  11436. #: guix-git/doc/guix.texi:6758
  11437. msgid "package-propagated-inputs"
  11438. msgstr ""
  11439. #. type: table
  11440. #: guix-git/doc/guix.texi:6758
  11441. msgid "Lastly, @code{propagated-inputs} is similar to @code{inputs}, but the specified packages will be automatically installed to profiles (@pxref{Features, the role of profiles in Guix}) alongside the package they belong to (@pxref{package-cmd-propagated-inputs, @command{guix package}}, for information on how @command{guix package} deals with propagated inputs)."
  11442. msgstr ""
  11443. #. type: table
  11444. #: guix-git/doc/guix.texi:6762
  11445. msgid "For example this is necessary when packaging a C/C++ library that needs headers of another library to compile, or when a pkg-config file refers to another one @i{via} its @code{Requires} field."
  11446. msgstr ""
  11447. #. type: table
  11448. #: guix-git/doc/guix.texi:6769
  11449. msgid "Another example where @code{propagated-inputs} is useful is for languages that lack a facility to record the run-time search path akin to the @code{RUNPATH} of ELF files; this includes Guile, Python, Perl, and more. When packaging libraries written in those languages, ensure they can find library code they depend on at run time by listing run-time dependencies in @code{propagated-inputs} rather than @code{inputs}."
  11450. msgstr ""
  11451. #. type: item
  11452. #: guix-git/doc/guix.texi:6770
  11453. #, no-wrap
  11454. msgid "@code{outputs} (default: @code{'(\"out\")})"
  11455. msgstr ""
  11456. #. type: table
  11457. #: guix-git/doc/guix.texi:6773
  11458. msgid "The list of output names of the package. @xref{Packages with Multiple Outputs}, for typical uses of additional outputs."
  11459. msgstr ""
  11460. #. type: item
  11461. #: guix-git/doc/guix.texi:6774
  11462. #, no-wrap
  11463. msgid "@code{native-search-paths} (default: @code{'()})"
  11464. msgstr ""
  11465. #. type: itemx
  11466. #: guix-git/doc/guix.texi:6775
  11467. #, no-wrap
  11468. msgid "@code{search-paths} (default: @code{'()})"
  11469. msgstr ""
  11470. #. type: table
  11471. #: guix-git/doc/guix.texi:6778
  11472. msgid "A list of @code{search-path-specification} objects describing search-path environment variables honored by the package."
  11473. msgstr ""
  11474. #. type: item
  11475. #: guix-git/doc/guix.texi:6779
  11476. #, no-wrap
  11477. msgid "@code{replacement} (default: @code{#f})"
  11478. msgstr ""
  11479. #. type: table
  11480. #: guix-git/doc/guix.texi:6783
  11481. msgid "This must be either @code{#f} or a package object that will be used as a @dfn{replacement} for this package. @xref{Security Updates, grafts}, for details."
  11482. msgstr ""
  11483. #. type: item
  11484. #: guix-git/doc/guix.texi:6784 guix-git/doc/guix.texi:12097
  11485. #, no-wrap
  11486. msgid "synopsis"
  11487. msgstr ""
  11488. #. type: table
  11489. #: guix-git/doc/guix.texi:6786
  11490. msgid "A one-line description of the package."
  11491. msgstr ""
  11492. #. type: code{#1}
  11493. #: guix-git/doc/guix.texi:6787 guix-git/doc/guix.texi:12098
  11494. #: guix-git/doc/guix.texi:34550 guix-git/doc/guix.texi:34701
  11495. #, no-wrap
  11496. msgid "description"
  11497. msgstr ""
  11498. #. type: table
  11499. #: guix-git/doc/guix.texi:6789
  11500. msgid "A more elaborate description of the package."
  11501. msgstr ""
  11502. #. type: code{#1}
  11503. #: guix-git/doc/guix.texi:6790
  11504. #, no-wrap
  11505. msgid "license"
  11506. msgstr ""
  11507. #. type: cindex
  11508. #: guix-git/doc/guix.texi:6791
  11509. #, no-wrap
  11510. msgid "license, of packages"
  11511. msgstr ""
  11512. #. type: table
  11513. #: guix-git/doc/guix.texi:6794
  11514. msgid "The license of the package; a value from @code{(guix licenses)}, or a list of such values."
  11515. msgstr ""
  11516. #. type: itemx
  11517. #: guix-git/doc/guix.texi:6795 guix-git/doc/guix.texi:12106
  11518. #, no-wrap
  11519. msgid "home-page"
  11520. msgstr ""
  11521. #. type: table
  11522. #: guix-git/doc/guix.texi:6797
  11523. msgid "The URL to the home-page of the package, as a string."
  11524. msgstr ""
  11525. #. type: item
  11526. #: guix-git/doc/guix.texi:6798
  11527. #, no-wrap
  11528. msgid "@code{supported-systems} (default: @code{%supported-systems})"
  11529. msgstr ""
  11530. #. type: table
  11531. #: guix-git/doc/guix.texi:6801
  11532. msgid "The list of systems supported by the package, as strings of the form @code{architecture-kernel}, for example @code{\"x86_64-linux\"}."
  11533. msgstr ""
  11534. #. type: item
  11535. #: guix-git/doc/guix.texi:6802
  11536. #, no-wrap
  11537. msgid "@code{location} (default: source location of the @code{package} form)"
  11538. msgstr ""
  11539. #. type: table
  11540. #: guix-git/doc/guix.texi:6806
  11541. msgid "The source location of the package. It is useful to override this when inheriting from another package, in which case this field is not automatically corrected."
  11542. msgstr ""
  11543. #. type: deffn
  11544. #: guix-git/doc/guix.texi:6809
  11545. #, no-wrap
  11546. msgid "{Scheme Syntax} this-package"
  11547. msgstr ""
  11548. #. type: deffn
  11549. #: guix-git/doc/guix.texi:6812
  11550. msgid "When used in the @emph{lexical scope} of a package field definition, this identifier resolves to the package being defined."
  11551. msgstr ""
  11552. #. type: deffn
  11553. #: guix-git/doc/guix.texi:6815
  11554. msgid "The example below shows how to add a package as a native input of itself when cross-compiling:"
  11555. msgstr ""
  11556. #. type: lisp
  11557. #: guix-git/doc/guix.texi:6820
  11558. #, no-wrap
  11559. msgid ""
  11560. "(package\n"
  11561. " (name \"guile\")\n"
  11562. " ;; ...\n"
  11563. "\n"
  11564. msgstr ""
  11565. #. type: lisp
  11566. #: guix-git/doc/guix.texi:6826
  11567. #, no-wrap
  11568. msgid ""
  11569. " ;; When cross-compiled, Guile, for example, depends on\n"
  11570. " ;; a native version of itself. Add it here.\n"
  11571. " (native-inputs (if (%current-target-system)\n"
  11572. " `((\"self\" ,this-package))\n"
  11573. " '())))\n"
  11574. msgstr ""
  11575. #. type: deffn
  11576. #: guix-git/doc/guix.texi:6829
  11577. msgid "It is an error to refer to @code{this-package} outside a package definition."
  11578. msgstr ""
  11579. #. type: Plain text
  11580. #: guix-git/doc/guix.texi:6835
  11581. msgid "Because packages are regular Scheme objects that capture a complete dependency graph and associated build procedures, it is often useful to write procedures that take a package and return a modified version thereof according to some parameters. Below are a few examples."
  11582. msgstr ""
  11583. #. type: cindex
  11584. #: guix-git/doc/guix.texi:6836
  11585. #, no-wrap
  11586. msgid "tool chain, choosing a package's tool chain"
  11587. msgstr ""
  11588. #. type: deffn
  11589. #: guix-git/doc/guix.texi:6837
  11590. #, no-wrap
  11591. msgid "{Scheme Procedure} package-with-c-toolchain @var{package} @var{toolchain}"
  11592. msgstr ""
  11593. #. type: deffn
  11594. #: guix-git/doc/guix.texi:6842
  11595. msgid "Return a variant of @var{package} that uses @var{toolchain} instead of the default GNU C/C++ toolchain. @var{toolchain} must be a list of inputs (label/package tuples) providing equivalent functionality, such as the @code{gcc-toolchain} package."
  11596. msgstr ""
  11597. #. type: deffn
  11598. #: guix-git/doc/guix.texi:6846
  11599. msgid "The example below returns a variant of the @code{hello} package built with GCC@tie{}10.x and the rest of the GNU tool chain (Binutils and the GNU C Library) instead of the default tool chain:"
  11600. msgstr ""
  11601. #. type: lisp
  11602. #: guix-git/doc/guix.texi:6850
  11603. #, no-wrap
  11604. msgid ""
  11605. "(let ((toolchain (specification->package \"gcc-toolchain@@10\")))\n"
  11606. " (package-with-c-toolchain hello `((\"toolchain\" ,toolchain))))\n"
  11607. msgstr ""
  11608. #. type: deffn
  11609. #: guix-git/doc/guix.texi:6858
  11610. msgid "The build tool chain is part of the @dfn{implicit inputs} of packages---it's usually not listed as part of the various ``inputs'' fields and is instead pulled in by the build system. Consequently, this procedure works by changing the build system of @var{package} so that it pulls in @var{toolchain} instead of the defaults. @ref{Build Systems}, for more on build systems."
  11611. msgstr ""
  11612. #. type: subsection
  11613. #: guix-git/doc/guix.texi:6861
  11614. #, no-wrap
  11615. msgid "@code{origin} Reference"
  11616. msgstr ""
  11617. #. type: Plain text
  11618. #: guix-git/doc/guix.texi:6869
  11619. msgid "This section documents @dfn{origins}. An @code{origin} declaration specifies data that must be ``produced''---downloaded, usually---and whose content hash is known in advance. Origins are primarily used to represent the source code of packages (@pxref{Defining Packages}). For that reason, the @code{origin} form allows you to declare patches to apply to the original source code as well as code snippets to modify it."
  11620. msgstr ""
  11621. #. type: deftp
  11622. #: guix-git/doc/guix.texi:6870
  11623. #, no-wrap
  11624. msgid "{Data Type} origin"
  11625. msgstr ""
  11626. #. type: deftp
  11627. #: guix-git/doc/guix.texi:6872
  11628. msgid "This is the data type representing a source code origin."
  11629. msgstr ""
  11630. #. type: code{#1}
  11631. #: guix-git/doc/guix.texi:6874 guix-git/doc/guix.texi:25394
  11632. #, no-wrap
  11633. msgid "uri"
  11634. msgstr ""
  11635. #. type: table
  11636. #: guix-git/doc/guix.texi:6879
  11637. msgid "An object containing the URI of the source. The object type depends on the @code{method} (see below). For example, when using the @var{url-fetch} method of @code{(guix download)}, the valid @code{uri} values are: a URL represented as a string, or a list thereof."
  11638. msgstr ""
  11639. #. type: cindex
  11640. #: guix-git/doc/guix.texi:6880
  11641. #, no-wrap
  11642. msgid "fixed-output derivations, for download"
  11643. msgstr ""
  11644. #. type: code{#1}
  11645. #: guix-git/doc/guix.texi:6881
  11646. #, no-wrap
  11647. msgid "method"
  11648. msgstr ""
  11649. #. type: table
  11650. #: guix-git/doc/guix.texi:6888
  11651. msgid "A monadic procedure that handles the given URI@. The procedure must accept at least three arguments: the value of the @code{uri} field and the hash algorithm and hash value specified by the @code{hash} field. It must return a store item or a derivation in the store monad (@pxref{The Store Monad}); most methods return a fixed-output derivation (@pxref{Derivations})."
  11652. msgstr ""
  11653. #. type: table
  11654. #: guix-git/doc/guix.texi:6892
  11655. msgid "Commonly used methods include @code{url-fetch}, which fetches data from a URL, and @code{git-fetch}, which fetches data from a Git repository (see below)."
  11656. msgstr ""
  11657. #. type: code{#1}
  11658. #: guix-git/doc/guix.texi:6893
  11659. #, no-wrap
  11660. msgid "sha256"
  11661. msgstr ""
  11662. #. type: table
  11663. #: guix-git/doc/guix.texi:6897
  11664. msgid "A bytevector containing the SHA-256 hash of the source. This is equivalent to providing a @code{content-hash} SHA256 object in the @code{hash} field described below."
  11665. msgstr ""
  11666. #. type: code{#1}
  11667. #: guix-git/doc/guix.texi:6898
  11668. #, no-wrap
  11669. msgid "hash"
  11670. msgstr ""
  11671. #. type: table
  11672. #: guix-git/doc/guix.texi:6901
  11673. msgid "The @code{content-hash} object of the source---see below for how to use @code{content-hash}."
  11674. msgstr ""
  11675. #. type: table
  11676. #: guix-git/doc/guix.texi:6905
  11677. msgid "You can obtain this information using @code{guix download} (@pxref{Invoking guix download}) or @code{guix hash} (@pxref{Invoking guix hash})."
  11678. msgstr ""
  11679. #. type: item
  11680. #: guix-git/doc/guix.texi:6906
  11681. #, no-wrap
  11682. msgid "@code{file-name} (default: @code{#f})"
  11683. msgstr ""
  11684. #. type: table
  11685. #: guix-git/doc/guix.texi:6912
  11686. msgid "The file name under which the source code should be saved. When this is @code{#f}, a sensible default value will be used in most cases. In case the source is fetched from a URL, the file name from the URL will be used. For version control checkouts, it is recommended to provide the file name explicitly because the default is not very descriptive."
  11687. msgstr ""
  11688. #. type: item
  11689. #: guix-git/doc/guix.texi:6913
  11690. #, no-wrap
  11691. msgid "@code{patches} (default: @code{'()})"
  11692. msgstr ""
  11693. #. type: table
  11694. #: guix-git/doc/guix.texi:6916
  11695. msgid "A list of file names, origins, or file-like objects (@pxref{G-Expressions, file-like objects}) pointing to patches to be applied to the source."
  11696. msgstr ""
  11697. #. type: table
  11698. #: guix-git/doc/guix.texi:6920
  11699. msgid "This list of patches must be unconditional. In particular, it cannot depend on the value of @code{%current-system} or @code{%current-target-system}."
  11700. msgstr ""
  11701. #. type: item
  11702. #: guix-git/doc/guix.texi:6921
  11703. #, no-wrap
  11704. msgid "@code{snippet} (default: @code{#f})"
  11705. msgstr ""
  11706. #. type: table
  11707. #: guix-git/doc/guix.texi:6925
  11708. msgid "A G-expression (@pxref{G-Expressions}) or S-expression that will be run in the source directory. This is a convenient way to modify the source, sometimes more convenient than a patch."
  11709. msgstr ""
  11710. #. type: item
  11711. #: guix-git/doc/guix.texi:6926
  11712. #, no-wrap
  11713. msgid "@code{patch-flags} (default: @code{'(\"-p1\")})"
  11714. msgstr ""
  11715. #. type: table
  11716. #: guix-git/doc/guix.texi:6929
  11717. msgid "A list of command-line flags that should be passed to the @code{patch} command."
  11718. msgstr ""
  11719. #. type: item
  11720. #: guix-git/doc/guix.texi:6930
  11721. #, no-wrap
  11722. msgid "@code{patch-inputs} (default: @code{#f})"
  11723. msgstr ""
  11724. #. type: table
  11725. #: guix-git/doc/guix.texi:6934
  11726. msgid "Input packages or derivations to the patching process. When this is @code{#f}, the usual set of inputs necessary for patching are provided, such as GNU@tie{}Patch."
  11727. msgstr ""
  11728. #. type: item
  11729. #: guix-git/doc/guix.texi:6935 guix-git/doc/guix.texi:25267
  11730. #, no-wrap
  11731. msgid "@code{modules} (default: @code{'()})"
  11732. msgstr ""
  11733. #. type: table
  11734. #: guix-git/doc/guix.texi:6938
  11735. msgid "A list of Guile modules that should be loaded during the patching process and while running the code in the @code{snippet} field."
  11736. msgstr ""
  11737. #. type: item
  11738. #: guix-git/doc/guix.texi:6939
  11739. #, no-wrap
  11740. msgid "@code{patch-guile} (default: @code{#f})"
  11741. msgstr ""
  11742. #. type: table
  11743. #: guix-git/doc/guix.texi:6942
  11744. msgid "The Guile package that should be used in the patching process. When this is @code{#f}, a sensible default is used."
  11745. msgstr ""
  11746. #. type: deftp
  11747. #: guix-git/doc/guix.texi:6945
  11748. #, no-wrap
  11749. msgid "{Data Type} content-hash @var{value} [@var{algorithm}]"
  11750. msgstr ""
  11751. #. type: deftp
  11752. #: guix-git/doc/guix.texi:6949
  11753. msgid "Construct a content hash object for the given @var{algorithm}, and with @var{value} as its hash value. When @var{algorithm} is omitted, assume it is @code{sha256}."
  11754. msgstr ""
  11755. #. type: deftp
  11756. #: guix-git/doc/guix.texi:6952
  11757. msgid "@var{value} can be a literal string, in which case it is base32-decoded, or it can be a bytevector."
  11758. msgstr ""
  11759. #. type: deftp
  11760. #: guix-git/doc/guix.texi:6954
  11761. msgid "The following forms are all equivalent:"
  11762. msgstr ""
  11763. #. type: lisp
  11764. #: guix-git/doc/guix.texi:6963
  11765. #, no-wrap
  11766. msgid ""
  11767. "(content-hash \"05zxkyz9bv3j9h0xyid1rhvh3klhsmrpkf3bcs6frvlgyr2gwilj\")\n"
  11768. "(content-hash \"05zxkyz9bv3j9h0xyid1rhvh3klhsmrpkf3bcs6frvlgyr2gwilj\"\n"
  11769. " sha256)\n"
  11770. "(content-hash (base32\n"
  11771. " \"05zxkyz9bv3j9h0xyid1rhvh3klhsmrpkf3bcs6frvlgyr2gwilj\"))\n"
  11772. "(content-hash (base64 \"kkb+RPaP7uyMZmu4eXPVkM4BN8yhRd8BTHLslb6f/Rc=\")\n"
  11773. " sha256)\n"
  11774. msgstr ""
  11775. #. type: deftp
  11776. #: guix-git/doc/guix.texi:6968
  11777. msgid "Technically, @code{content-hash} is currently implemented as a macro. It performs sanity checks at macro-expansion time, when possible, such as ensuring that @var{value} has the right size for @var{algorithm}."
  11778. msgstr ""
  11779. #. type: Plain text
  11780. #: guix-git/doc/guix.texi:6974
  11781. msgid "As we have seen above, how exactly the data an origin refers to is retrieved is determined by its @code{method} field. The @code{(guix download)} module provides the most common method, @code{url-fetch}, described below."
  11782. msgstr ""
  11783. #. type: deffn
  11784. #: guix-git/doc/guix.texi:6975
  11785. #, no-wrap
  11786. msgid "{Scheme Procedure} url-fetch @var{url} @var{hash-algo} @var{hash} @"
  11787. msgstr ""
  11788. #. type: deffn
  11789. #: guix-git/doc/guix.texi:6983
  11790. msgid "[name] [#:executable? #f] Return a fixed-output derivation that fetches data from @var{url} (a string, or a list of strings denoting alternate URLs), which is expected to have hash @var{hash} of type @var{hash-algo} (a symbol). By default, the file name is the base name of URL; optionally, @var{name} can specify a different file name. When @var{executable?} is true, make the downloaded file executable."
  11791. msgstr ""
  11792. #. type: deffn
  11793. #: guix-git/doc/guix.texi:6986
  11794. msgid "When one of the URL starts with @code{mirror://}, then its host part is interpreted as the name of a mirror scheme, taken from @file{%mirror-file}."
  11795. msgstr ""
  11796. #. type: deffn
  11797. #: guix-git/doc/guix.texi:6989
  11798. msgid "Alternatively, when URL starts with @code{file://}, return the corresponding file name in the store."
  11799. msgstr ""
  11800. #. type: Plain text
  11801. #: guix-git/doc/guix.texi:6995
  11802. msgid "Likewise, the @code{(guix git-download)} module defines the @code{git-fetch} origin method, which fetches data from a Git version control repository, and the @code{git-reference} data type to describe the repository and revision to fetch."
  11803. msgstr ""
  11804. #. type: deffn
  11805. #: guix-git/doc/guix.texi:6996
  11806. #, no-wrap
  11807. msgid "{Scheme Procedure} git-fetch @var{ref} @var{hash-algo} @var{hash}"
  11808. msgstr ""
  11809. #. type: deffn
  11810. #: guix-git/doc/guix.texi:7001
  11811. msgid "Return a fixed-output derivation that fetches @var{ref}, a @code{<git-reference>} object. The output is expected to have recursive hash @var{hash} of type @var{hash-algo} (a symbol). Use @var{name} as the file name, or a generic name if @code{#f}."
  11812. msgstr ""
  11813. #. type: deftp
  11814. #: guix-git/doc/guix.texi:7003
  11815. #, no-wrap
  11816. msgid "{Data Type} git-reference"
  11817. msgstr ""
  11818. #. type: deftp
  11819. #: guix-git/doc/guix.texi:7006
  11820. msgid "This data type represents a Git reference for @code{git-fetch} to retrieve."
  11821. msgstr ""
  11822. #. type: code{#1}
  11823. #: guix-git/doc/guix.texi:7008 guix-git/doc/guix.texi:23029
  11824. #, no-wrap
  11825. msgid "url"
  11826. msgstr ""
  11827. #. type: table
  11828. #: guix-git/doc/guix.texi:7010
  11829. msgid "The URL of the Git repository to clone."
  11830. msgstr ""
  11831. #. type: code{#1}
  11832. #: guix-git/doc/guix.texi:7011
  11833. #, no-wrap
  11834. msgid "commit"
  11835. msgstr ""
  11836. #. type: table
  11837. #: guix-git/doc/guix.texi:7015
  11838. msgid "This string denotes either the commit to fetch (a hexadecimal string, either the full SHA1 commit or a ``short'' commit string; the latter is not recommended) or the tag to fetch."
  11839. msgstr ""
  11840. #. type: item
  11841. #: guix-git/doc/guix.texi:7016
  11842. #, no-wrap
  11843. msgid "@code{recursive?} (default: @code{#f})"
  11844. msgstr ""
  11845. #. type: table
  11846. #: guix-git/doc/guix.texi:7018
  11847. msgid "This Boolean indicates whether to recursively fetch Git sub-modules."
  11848. msgstr ""
  11849. #. type: deftp
  11850. #: guix-git/doc/guix.texi:7022
  11851. msgid "The example below denotes the @code{v2.10} tag of the GNU@tie{}Hello repository:"
  11852. msgstr ""
  11853. #. type: lisp
  11854. #: guix-git/doc/guix.texi:7027
  11855. #, no-wrap
  11856. msgid ""
  11857. "(git-reference\n"
  11858. " (url \"https://git.savannah.gnu.org/git/hello.git\")\n"
  11859. " (commit \"v2.10\"))\n"
  11860. msgstr ""
  11861. #. type: deftp
  11862. #: guix-git/doc/guix.texi:7031
  11863. msgid "This is equivalent to the reference below, which explicitly names the commit:"
  11864. msgstr ""
  11865. #. type: lisp
  11866. #: guix-git/doc/guix.texi:7036
  11867. #, no-wrap
  11868. msgid ""
  11869. "(git-reference\n"
  11870. " (url \"https://git.savannah.gnu.org/git/hello.git\")\n"
  11871. " (commit \"dc7dc56a00e48fe6f231a58f6537139fe2908fb9\"))\n"
  11872. msgstr ""
  11873. #. type: Plain text
  11874. #: guix-git/doc/guix.texi:7042
  11875. msgid "For Mercurial repositories, the module @code{(guix hg-download)} defines the @code{hg-fetch} origin method and @code{hg-reference} data type for support of the Mercurial version control system."
  11876. msgstr ""
  11877. #. type: deffn
  11878. #: guix-git/doc/guix.texi:7043
  11879. #, no-wrap
  11880. msgid "{Scheme Procedure} hg-fetch @var{ref} @var{hash-algo} @var{hash} @"
  11881. msgstr ""
  11882. #. type: deffn
  11883. #: guix-git/doc/guix.texi:7049
  11884. msgid "[name] Return a fixed-output derivation that fetches @var{ref}, a @code{<hg-reference>} object. The output is expected to have recursive hash @var{hash} of type @var{hash-algo} (a symbol). Use @var{name} as the file name, or a generic name if @code{#false}."
  11885. msgstr ""
  11886. #. type: cindex
  11887. #: guix-git/doc/guix.texi:7054
  11888. #, no-wrap
  11889. msgid "customizing packages"
  11890. msgstr ""
  11891. #. type: cindex
  11892. #: guix-git/doc/guix.texi:7055
  11893. #, no-wrap
  11894. msgid "variants, of packages"
  11895. msgstr ""
  11896. #. type: Plain text
  11897. #: guix-git/doc/guix.texi:7065
  11898. msgid "One of the nice things with Guix is that, given a package definition, you can easily @emph{derive} variants of that package---for a different upstream version, with different dependencies, different compilation options, and so on. Some of these custom packages can be defined straight from the command line (@pxref{Package Transformation Options}). This section describes how to define package variants in code. This can be useful in ``manifests'' (@pxref{profile-manifest, @option{--manifest}}) and in your own package collection (@pxref{Creating a Channel}), among others!"
  11899. msgstr ""
  11900. #. type: cindex
  11901. #: guix-git/doc/guix.texi:7066
  11902. #, no-wrap
  11903. msgid "inherit, for package definitions"
  11904. msgstr ""
  11905. #. type: Plain text
  11906. #: guix-git/doc/guix.texi:7073
  11907. msgid "As discussed earlier, packages are first-class objects in the Scheme language. The @code{(guix packages)} module provides the @code{package} construct to define new package objects (@pxref{package Reference}). The easiest way to define a package variant is using the @code{inherit} keyword together with @code{package}. This allows you to inherit from a package definition while overriding the fields you want."
  11908. msgstr ""
  11909. #. type: Plain text
  11910. #: guix-git/doc/guix.texi:7078
  11911. msgid "For example, given the @code{hello} variable, which contains a definition for the current version of GNU@tie{}Hello, here's how you would define a variant for version 2.2 (released in 2006, it's vintage!):"
  11912. msgstr ""
  11913. #. type: lisp
  11914. #: guix-git/doc/guix.texi:7081
  11915. #, no-wrap
  11916. msgid ""
  11917. "(use-modules (gnu packages base)) ;for 'hello'\n"
  11918. "\n"
  11919. msgstr ""
  11920. #. type: lisp
  11921. #: guix-git/doc/guix.texi:7093
  11922. #, no-wrap
  11923. msgid ""
  11924. "(define hello-2.2\n"
  11925. " (package\n"
  11926. " (inherit hello)\n"
  11927. " (version \"2.2\")\n"
  11928. " (source (origin\n"
  11929. " (method url-fetch)\n"
  11930. " (uri (string-append \"mirror://gnu/hello/hello-\" version\n"
  11931. " \".tar.gz\"))\n"
  11932. " (sha256\n"
  11933. " (base32\n"
  11934. " \"0lappv4slgb5spyqbh6yl5r013zv72yqg2pcl30mginf3wdqd8k9\"))))))\n"
  11935. msgstr ""
  11936. #. type: Plain text
  11937. #: guix-git/doc/guix.texi:7102
  11938. msgid "The example above corresponds to what the @option{--with-source} package transformation option does. Essentially @code{hello-2.2} preserves all the fields of @code{hello}, except @code{version} and @code{source}, which it overrides. Note that the original @code{hello} variable is still there, in the @code{(gnu packages base)} module, unchanged. When you define a custom package like this, you are really @emph{adding} a new package definition; the original one remains available."
  11939. msgstr ""
  11940. #. type: Plain text
  11941. #: guix-git/doc/guix.texi:7108
  11942. msgid "You can just as well define variants with a different set of dependencies than the original package. For example, the default @code{gdb} package depends on @code{guile}, but since that is an optional dependency, you can define a variant that removes that dependency like so:"
  11943. msgstr ""
  11944. #. type: lisp
  11945. #: guix-git/doc/guix.texi:7112
  11946. #, no-wrap
  11947. msgid ""
  11948. "(use-modules (gnu packages gdb) ;for 'gdb'\n"
  11949. " (srfi srfi-1)) ;for 'alist-delete'\n"
  11950. "\n"
  11951. msgstr ""
  11952. #. type: lisp
  11953. #: guix-git/doc/guix.texi:7118
  11954. #, no-wrap
  11955. msgid ""
  11956. "(define gdb-sans-guile\n"
  11957. " (package\n"
  11958. " (inherit gdb)\n"
  11959. " (inputs (alist-delete \"guile\"\n"
  11960. " (package-inputs gdb)))))\n"
  11961. msgstr ""
  11962. #. type: Plain text
  11963. #: guix-git/doc/guix.texi:7124
  11964. msgid "The @code{alist-delete} call above removes the tuple from the @code{inputs} field that has @code{\"guile\"} as its first element (@pxref{SRFI-1 Association Lists,,, guile, GNU Guile Reference Manual})."
  11965. msgstr ""
  11966. #. type: Plain text
  11967. #: guix-git/doc/guix.texi:7132
  11968. msgid "In some cases, you may find it useful to write functions (``procedures'', in Scheme parlance) that return a package based on some parameters. For example, consider the @code{luasocket} library for the Lua programming language. We want to create @code{luasocket} packages for major versions of Lua. One way to do that is to define a procedure that takes a Lua package and returns a @code{luasocket} package that depends on it:"
  11969. msgstr ""
  11970. #. type: lisp
  11971. #: guix-git/doc/guix.texi:7143
  11972. #, no-wrap
  11973. msgid ""
  11974. "(define (make-lua-socket name lua)\n"
  11975. " ;; Return a luasocket package built with LUA.\n"
  11976. " (package\n"
  11977. " (name name)\n"
  11978. " (version \"3.0\")\n"
  11979. " ;; several fields omitted\n"
  11980. " (inputs\n"
  11981. " `((\"lua\" ,lua)))\n"
  11982. " (synopsis \"Socket library for Lua\")))\n"
  11983. "\n"
  11984. msgstr ""
  11985. #. type: lisp
  11986. #: guix-git/doc/guix.texi:7146
  11987. #, no-wrap
  11988. msgid ""
  11989. "(define-public lua5.1-socket\n"
  11990. " (make-lua-socket \"lua5.1-socket\" lua-5.1))\n"
  11991. "\n"
  11992. msgstr ""
  11993. #. type: lisp
  11994. #: guix-git/doc/guix.texi:7149
  11995. #, no-wrap
  11996. msgid ""
  11997. "(define-public lua5.2-socket\n"
  11998. " (make-lua-socket \"lua5.2-socket\" lua-5.2))\n"
  11999. msgstr ""
  12000. #. type: Plain text
  12001. #: guix-git/doc/guix.texi:7157
  12002. msgid "Here we have defined packages @code{lua5.1-socket} and @code{lua5.2-socket} by calling @code{make-lua-socket} with different arguments. @xref{Procedures,,, guile, GNU Guile Reference Manual}, for more info on procedures. Having top-level public definitions for these two packages means that they can be referred to from the command line (@pxref{Package Modules})."
  12003. msgstr ""
  12004. #. type: cindex
  12005. #: guix-git/doc/guix.texi:7158
  12006. #, no-wrap
  12007. msgid "package transformations"
  12008. msgstr ""
  12009. #. type: Plain text
  12010. #: guix-git/doc/guix.texi:7163
  12011. msgid "These are pretty simple package variants. As a convenience, the @code{(guix transformations)} module provides a high-level interface that directly maps to the more sophisticated package transformation options (@pxref{Package Transformation Options}):"
  12012. msgstr ""
  12013. #. type: deffn
  12014. #: guix-git/doc/guix.texi:7164
  12015. #, no-wrap
  12016. msgid "{Scheme Procedure} options->transformation @var{opts}"
  12017. msgstr ""
  12018. #. type: deffn
  12019. #: guix-git/doc/guix.texi:7168
  12020. msgid "Return a procedure that, when passed an object to build (package, derivation, etc.), applies the transformations specified by @var{opts} and returns the resulting objects. @var{opts} must be a list of symbol/string pairs such as:"
  12021. msgstr ""
  12022. #. type: lisp
  12023. #: guix-git/doc/guix.texi:7172
  12024. #, no-wrap
  12025. msgid ""
  12026. "((with-branch . \"guile-gcrypt=master\")\n"
  12027. " (without-tests . \"libgcrypt\"))\n"
  12028. msgstr ""
  12029. #. type: deffn
  12030. #: guix-git/doc/guix.texi:7176
  12031. msgid "Each symbol names a transformation and the corresponding string is an argument to that transformation."
  12032. msgstr ""
  12033. #. type: Plain text
  12034. #: guix-git/doc/guix.texi:7179
  12035. msgid "For instance, a manifest equivalent to this command:"
  12036. msgstr ""
  12037. #. type: example
  12038. #: guix-git/doc/guix.texi:7184
  12039. #, no-wrap
  12040. msgid ""
  12041. "guix build guix \\\n"
  12042. " --with-branch=guile-gcrypt=master \\\n"
  12043. " --with-debug-info=zlib\n"
  12044. msgstr ""
  12045. #. type: Plain text
  12046. #: guix-git/doc/guix.texi:7188
  12047. msgid "... would look like this:"
  12048. msgstr ""
  12049. #. type: lisp
  12050. #: guix-git/doc/guix.texi:7191
  12051. #, no-wrap
  12052. msgid ""
  12053. "(use-modules (guix transformations))\n"
  12054. "\n"
  12055. msgstr ""
  12056. #. type: lisp
  12057. #: guix-git/doc/guix.texi:7197
  12058. #, no-wrap
  12059. msgid ""
  12060. "(define transform\n"
  12061. " ;; The package transformation procedure.\n"
  12062. " (options->transformation\n"
  12063. " '((with-branch . \"guile-gcrypt=master\")\n"
  12064. " (with-debug-info . \"zlib\"))))\n"
  12065. "\n"
  12066. msgstr ""
  12067. #. type: lisp
  12068. #: guix-git/doc/guix.texi:7200
  12069. #, no-wrap
  12070. msgid ""
  12071. "(packages->manifest\n"
  12072. " (list (transform (specification->package \"guix\"))))\n"
  12073. msgstr ""
  12074. #. type: cindex
  12075. #: guix-git/doc/guix.texi:7202
  12076. #, no-wrap
  12077. msgid "input rewriting"
  12078. msgstr ""
  12079. #. type: cindex
  12080. #: guix-git/doc/guix.texi:7203
  12081. #, no-wrap
  12082. msgid "dependency graph rewriting"
  12083. msgstr ""
  12084. #. type: Plain text
  12085. #: guix-git/doc/guix.texi:7210
  12086. msgid "The @code{options->transformation} procedure is convenient, but it's perhaps also not as flexible as you may like. How is it implemented? The astute reader probably noticed that most package transformation options go beyond the superficial changes shown in the first examples of this section: they involve @dfn{input rewriting}, whereby the dependency graph of a package is rewritten by replacing specific inputs by others."
  12087. msgstr ""
  12088. #. type: Plain text
  12089. #: guix-git/doc/guix.texi:7214
  12090. msgid "Dependency graph rewriting, for the purposes of swapping packages in the graph, is what the @code{package-input-rewriting} procedure in @code{(guix packages)} implements."
  12091. msgstr ""
  12092. #. type: deffn
  12093. #: guix-git/doc/guix.texi:7215
  12094. #, no-wrap
  12095. msgid "{Scheme Procedure} package-input-rewriting @var{replacements} @"
  12096. msgstr ""
  12097. #. type: deffn
  12098. #: guix-git/doc/guix.texi:7222
  12099. msgid "[@var{rewrite-name}] [#:deep? #t] Return a procedure that, when passed a package, replaces its direct and indirect dependencies, including implicit inputs when @var{deep?} is true, according to @var{replacements}. @var{replacements} is a list of package pairs; the first element of each pair is the package to replace, and the second one is the replacement."
  12100. msgstr ""
  12101. #. type: deffn
  12102. #: guix-git/doc/guix.texi:7225
  12103. msgid "Optionally, @var{rewrite-name} is a one-argument procedure that takes the name of a package and returns its new name after rewrite."
  12104. msgstr ""
  12105. #. type: table
  12106. #: guix-git/doc/guix.texi:7229 guix-git/doc/guix.texi:10579
  12107. msgid "Consider this example:"
  12108. msgstr ""
  12109. #. type: lisp
  12110. #: guix-git/doc/guix.texi:7235
  12111. #, no-wrap
  12112. msgid ""
  12113. "(define libressl-instead-of-openssl\n"
  12114. " ;; This is a procedure to replace OPENSSL by LIBRESSL,\n"
  12115. " ;; recursively.\n"
  12116. " (package-input-rewriting `((,openssl . ,libressl))))\n"
  12117. "\n"
  12118. msgstr ""
  12119. #. type: lisp
  12120. #: guix-git/doc/guix.texi:7238
  12121. #, no-wrap
  12122. msgid ""
  12123. "(define git-with-libressl\n"
  12124. " (libressl-instead-of-openssl git))\n"
  12125. msgstr ""
  12126. #. type: Plain text
  12127. #: guix-git/doc/guix.texi:7246
  12128. msgid "Here we first define a rewriting procedure that replaces @var{openssl} with @var{libressl}. Then we use it to define a @dfn{variant} of the @var{git} package that uses @var{libressl} instead of @var{openssl}. This is exactly what the @option{--with-input} command-line option does (@pxref{Package Transformation Options, @option{--with-input}})."
  12129. msgstr ""
  12130. #. type: Plain text
  12131. #: guix-git/doc/guix.texi:7249
  12132. msgid "The following variant of @code{package-input-rewriting} can match packages to be replaced by name rather than by identity."
  12133. msgstr ""
  12134. #. type: deffn
  12135. #: guix-git/doc/guix.texi:7250
  12136. #, no-wrap
  12137. msgid "{Scheme Procedure} package-input-rewriting/spec @var{replacements} [#:deep? #t]"
  12138. msgstr ""
  12139. #. type: deffn
  12140. #: guix-git/doc/guix.texi:7257
  12141. msgid "Return a procedure that, given a package, applies the given @var{replacements} to all the package graph, including implicit inputs unless @var{deep?} is false. @var{replacements} is a list of spec/procedures pair; each spec is a package specification such as @code{\"gcc\"} or @code{\"guile@@2\"}, and each procedure takes a matching package and returns a replacement for that package."
  12142. msgstr ""
  12143. #. type: Plain text
  12144. #: guix-git/doc/guix.texi:7260
  12145. msgid "The example above could be rewritten this way:"
  12146. msgstr ""
  12147. #. type: lisp
  12148. #: guix-git/doc/guix.texi:7265
  12149. #, no-wrap
  12150. msgid ""
  12151. "(define libressl-instead-of-openssl\n"
  12152. " ;; Replace all the packages called \"openssl\" with LibreSSL.\n"
  12153. " (package-input-rewriting/spec `((\"openssl\" . ,(const libressl)))))\n"
  12154. msgstr ""
  12155. #. type: Plain text
  12156. #: guix-git/doc/guix.texi:7270
  12157. msgid "The key difference here is that, this time, packages are matched by spec and not by identity. In other words, any package in the graph that is called @code{openssl} will be replaced."
  12158. msgstr ""
  12159. #. type: Plain text
  12160. #: guix-git/doc/guix.texi:7274
  12161. msgid "A more generic procedure to rewrite a package dependency graph is @code{package-mapping}: it supports arbitrary changes to nodes in the graph."
  12162. msgstr ""
  12163. #. type: deffn
  12164. #: guix-git/doc/guix.texi:7275
  12165. #, no-wrap
  12166. msgid "{Scheme Procedure} package-mapping @var{proc} [@var{cut?}] [#:deep? #f]"
  12167. msgstr ""
  12168. #. type: deffn
  12169. #: guix-git/doc/guix.texi:7280
  12170. msgid "Return a procedure that, given a package, applies @var{proc} to all the packages depended on and returns the resulting package. The procedure stops recursion when @var{cut?} returns true for a given package. When @var{deep?} is true, @var{proc} is applied to implicit inputs as well."
  12171. msgstr ""
  12172. #. type: cindex
  12173. #: guix-git/doc/guix.texi:7286
  12174. #, no-wrap
  12175. msgid "build system"
  12176. msgstr ""
  12177. #. type: Plain text
  12178. #: guix-git/doc/guix.texi:7291
  12179. msgid "Each package definition specifies a @dfn{build system} and arguments for that build system (@pxref{Defining Packages}). This @code{build-system} field represents the build procedure of the package, as well as implicit dependencies of that build procedure."
  12180. msgstr ""
  12181. #. type: Plain text
  12182. #: guix-git/doc/guix.texi:7295
  12183. msgid "Build systems are @code{<build-system>} objects. The interface to create and manipulate them is provided by the @code{(guix build-system)} module, and actual build systems are exported by specific modules."
  12184. msgstr ""
  12185. #. type: cindex
  12186. #: guix-git/doc/guix.texi:7296
  12187. #, no-wrap
  12188. msgid "bag (low-level package representation)"
  12189. msgstr ""
  12190. #. type: Plain text
  12191. #: guix-git/doc/guix.texi:7306
  12192. msgid "Under the hood, build systems first compile package objects to @dfn{bags}. A @dfn{bag} is like a package, but with less ornamentation---in other words, a bag is a lower-level representation of a package, which includes all the inputs of that package, including some that were implicitly added by the build system. This intermediate representation is then compiled to a derivation (@pxref{Derivations}). The @code{package-with-c-toolchain} is an example of a way to change the implicit inputs that a package's build system pulls in (@pxref{package Reference, @code{package-with-c-toolchain}})."
  12193. msgstr ""
  12194. #. type: Plain text
  12195. #: guix-git/doc/guix.texi:7314
  12196. msgid "Build systems accept an optional list of @dfn{arguments}. In package definitions, these are passed @i{via} the @code{arguments} field (@pxref{Defining Packages}). They are typically keyword arguments (@pxref{Optional Arguments, keyword arguments in Guile,, guile, GNU Guile Reference Manual}). The value of these arguments is usually evaluated in the @dfn{build stratum}---i.e., by a Guile process launched by the daemon (@pxref{Derivations})."
  12197. msgstr ""
  12198. #. type: Plain text
  12199. #: guix-git/doc/guix.texi:7318
  12200. msgid "The main build system is @code{gnu-build-system}, which implements the standard build procedure for GNU and many other packages. It is provided by the @code{(guix build-system gnu)} module."
  12201. msgstr ""
  12202. #. type: defvr
  12203. #: guix-git/doc/guix.texi:7319
  12204. #, no-wrap
  12205. msgid "{Scheme Variable} gnu-build-system"
  12206. msgstr ""
  12207. #. type: defvr
  12208. #: guix-git/doc/guix.texi:7323
  12209. msgid "@code{gnu-build-system} represents the GNU Build System, and variants thereof (@pxref{Configuration, configuration and makefile conventions,, standards, GNU Coding Standards})."
  12210. msgstr ""
  12211. #. type: cindex
  12212. #: guix-git/doc/guix.texi:7324 guix-git/doc/guix.texi:8264
  12213. #: guix-git/doc/guix.texi:8719
  12214. #, no-wrap
  12215. msgid "build phases"
  12216. msgstr ""
  12217. #. type: defvr
  12218. #: guix-git/doc/guix.texi:7331
  12219. msgid "In a nutshell, packages using it are configured, built, and installed with the usual @code{./configure && make && make check && make install} command sequence. In practice, a few additional steps are often needed. All these steps are split up in separate @dfn{phases}. @xref{Build Phases}, for more info on build phases and ways to customize them."
  12220. msgstr ""
  12221. #. type: defvr
  12222. #: guix-git/doc/guix.texi:7338
  12223. msgid "In addition, this build system ensures that the ``standard'' environment for GNU packages is available. This includes tools such as GCC, libc, Coreutils, Bash, Make, Diffutils, grep, and sed (see the @code{(guix build-system gnu)} module for a complete list). We call these the @dfn{implicit inputs} of a package, because package definitions do not have to mention them."
  12224. msgstr ""
  12225. #. type: defvr
  12226. #: guix-git/doc/guix.texi:7342
  12227. msgid "This build system supports a number of keyword arguments, which can be passed @i{via} the @code{arguments} field of a package. Here are some of the main parameters:"
  12228. msgstr ""
  12229. #. type: item
  12230. #: guix-git/doc/guix.texi:7344
  12231. #, no-wrap
  12232. msgid "#:phases"
  12233. msgstr ""
  12234. #. type: table
  12235. #: guix-git/doc/guix.texi:7347
  12236. msgid "This argument specifies build-side code that evaluates to an alist of build phases. @xref{Build Phases}, for more information."
  12237. msgstr ""
  12238. #. type: item
  12239. #: guix-git/doc/guix.texi:7348
  12240. #, no-wrap
  12241. msgid "#:configure-flags"
  12242. msgstr ""
  12243. #. type: table
  12244. #: guix-git/doc/guix.texi:7351
  12245. msgid "This is a list of flags (strings) passed to the @command{configure} script. @xref{Defining Packages}, for an example."
  12246. msgstr ""
  12247. #. type: item
  12248. #: guix-git/doc/guix.texi:7352
  12249. #, no-wrap
  12250. msgid "#:make-flags"
  12251. msgstr ""
  12252. #. type: table
  12253. #: guix-git/doc/guix.texi:7356
  12254. msgid "This list of strings contains flags passed as arguments to @command{make} invocations in the @code{build}, @code{check}, and @code{install} phases."
  12255. msgstr ""
  12256. #. type: item
  12257. #: guix-git/doc/guix.texi:7357
  12258. #, no-wrap
  12259. msgid "#:out-of-source?"
  12260. msgstr ""
  12261. #. type: table
  12262. #: guix-git/doc/guix.texi:7360
  12263. msgid "This Boolean, @code{#f} by default, indicates whether to run builds in a build directory separate from the source tree."
  12264. msgstr ""
  12265. #. type: table
  12266. #: guix-git/doc/guix.texi:7365
  12267. msgid "When it is true, the @code{configure} phase creates a separate build directory, changes to that directory, and runs the @code{configure} script from there. This is useful for packages that require it, such as @code{glibc}."
  12268. msgstr ""
  12269. #. type: item
  12270. #: guix-git/doc/guix.texi:7366
  12271. #, no-wrap
  12272. msgid "#:tests?"
  12273. msgstr ""
  12274. #. type: table
  12275. #: guix-git/doc/guix.texi:7369
  12276. msgid "This Boolean, @code{#t} by default, indicates whether the @code{check} phase should run the package's test suite."
  12277. msgstr ""
  12278. #. type: item
  12279. #: guix-git/doc/guix.texi:7370
  12280. #, no-wrap
  12281. msgid "#:test-target"
  12282. msgstr ""
  12283. #. type: table
  12284. #: guix-git/doc/guix.texi:7373
  12285. msgid "This string, @code{\"check\"} by default, gives the name of the makefile target used by the @code{check} phase."
  12286. msgstr ""
  12287. #. type: item
  12288. #: guix-git/doc/guix.texi:7374
  12289. #, no-wrap
  12290. msgid "#:parallel-build?"
  12291. msgstr ""
  12292. #. type: itemx
  12293. #: guix-git/doc/guix.texi:7375
  12294. #, no-wrap
  12295. msgid "#:parallel-tests?"
  12296. msgstr ""
  12297. #. type: table
  12298. #: guix-git/doc/guix.texi:7382
  12299. msgid "These Boolean values specify whether to build, respectively run the test suite, in parallel, with the @code{-j} flag of @command{make}. When they are true, @code{make} is passed @code{-j@var{n}}, where @var{n} is the number specified as the @option{--cores} option of @command{guix-daemon} or that of the @command{guix} client command (@pxref{Common Build Options, @option{--cores}})."
  12300. msgstr ""
  12301. #. type: cindex
  12302. #: guix-git/doc/guix.texi:7383
  12303. #, no-wrap
  12304. msgid "RUNPATH, validation"
  12305. msgstr ""
  12306. #. type: item
  12307. #: guix-git/doc/guix.texi:7384
  12308. #, no-wrap
  12309. msgid "#:validate-runpath?"
  12310. msgstr ""
  12311. #. type: table
  12312. #: guix-git/doc/guix.texi:7388
  12313. msgid "This Boolean, @code{#t} by default, determines whether to ``validate'' the @code{RUNPATH} of ELF binaries (@code{.so} shared libraries as well as executables) previously installed by the @code{install} phase."
  12314. msgstr ""
  12315. #. type: table
  12316. #: guix-git/doc/guix.texi:7396
  12317. msgid "This validation step consists in making sure that all the shared libraries needed by an ELF binary, which are listed as @code{DT_NEEDED} entries in its @code{PT_DYNAMIC} segment, appear in the @code{DT_RUNPATH} entry of that binary. In other words, it ensures that running or using those binaries will not result in a ``file not found'' error at run time. @xref{Options, @option{-rpath},, ld, The GNU Linker}, for more information on @code{RUNPATH}."
  12318. msgstr ""
  12319. #. type: item
  12320. #: guix-git/doc/guix.texi:7397
  12321. #, no-wrap
  12322. msgid "#:substitutable?"
  12323. msgstr ""
  12324. #. type: table
  12325. #: guix-git/doc/guix.texi:7401
  12326. msgid "This Boolean, @code{#t} by default, tells whether the package outputs should be substitutable---i.e., whether users should be able to obtain substitutes for them instead of building locally (@pxref{Substitutes})."
  12327. msgstr ""
  12328. #. type: item
  12329. #: guix-git/doc/guix.texi:7402
  12330. #, no-wrap
  12331. msgid "#:allowed-references"
  12332. msgstr ""
  12333. #. type: itemx
  12334. #: guix-git/doc/guix.texi:7403
  12335. #, no-wrap
  12336. msgid "#:disallowed-references"
  12337. msgstr ""
  12338. #. type: table
  12339. #: guix-git/doc/guix.texi:7408
  12340. msgid "When true, these arguments must be a list of dependencies that must not appear among the references of the build results. If, upon build completion, some of these references are retained, the build process fails."
  12341. msgstr ""
  12342. #. type: table
  12343. #: guix-git/doc/guix.texi:7413
  12344. msgid "This is useful to ensure that a package does not erroneously keep a reference to some of it build-time inputs, in cases where doing so would, for example, unnecessarily increase its size (@pxref{Invoking guix size})."
  12345. msgstr ""
  12346. #. type: defvr
  12347. #: guix-git/doc/guix.texi:7416
  12348. msgid "Most other build systems support these keyword arguments."
  12349. msgstr ""
  12350. #. type: Plain text
  12351. #: guix-git/doc/guix.texi:7423
  12352. msgid "Other @code{<build-system>} objects are defined to support other conventions and tools used by free software packages. They inherit most of @code{gnu-build-system}, and differ mainly in the set of inputs implicitly added to the build process, and in the list of phases executed. Some of these build systems are listed below."
  12353. msgstr ""
  12354. #. type: defvr
  12355. #: guix-git/doc/guix.texi:7424
  12356. #, no-wrap
  12357. msgid "{Scheme Variable} ant-build-system"
  12358. msgstr ""
  12359. #. type: defvr
  12360. #: guix-git/doc/guix.texi:7428
  12361. msgid "This variable is exported by @code{(guix build-system ant)}. It implements the build procedure for Java packages that can be built with @url{https://ant.apache.org/, Ant build tool}."
  12362. msgstr ""
  12363. #. type: defvr
  12364. #: guix-git/doc/guix.texi:7433
  12365. msgid "It adds both @code{ant} and the @dfn{Java Development Kit} (JDK) as provided by the @code{icedtea} package to the set of inputs. Different packages can be specified with the @code{#:ant} and @code{#:jdk} parameters, respectively."
  12366. msgstr ""
  12367. #. type: defvr
  12368. #: guix-git/doc/guix.texi:7439
  12369. msgid "When the original package does not provide a suitable Ant build file, the parameter @code{#:jar-name} can be used to generate a minimal Ant build file @file{build.xml} with tasks to build the specified jar archive. In this case the parameter @code{#:source-dir} can be used to specify the source sub-directory, defaulting to ``src''."
  12370. msgstr ""
  12371. #. type: defvr
  12372. #: guix-git/doc/guix.texi:7447
  12373. msgid "The @code{#:main-class} parameter can be used with the minimal ant buildfile to specify the main class of the resulting jar. This makes the jar file executable. The @code{#:test-include} parameter can be used to specify the list of junit tests to run. It defaults to @code{(list \"**/*Test.java\")}. The @code{#:test-exclude} can be used to disable some tests. It defaults to @code{(list \"**/Abstract*.java\")}, because abstract classes cannot be run as tests."
  12374. msgstr ""
  12375. #. type: defvr
  12376. #: guix-git/doc/guix.texi:7451
  12377. msgid "The parameter @code{#:build-target} can be used to specify the Ant task that should be run during the @code{build} phase. By default the ``jar'' task will be run."
  12378. msgstr ""
  12379. #. type: defvr
  12380. #: guix-git/doc/guix.texi:7454
  12381. #, no-wrap
  12382. msgid "{Scheme Variable} android-ndk-build-system"
  12383. msgstr ""
  12384. #. type: cindex
  12385. #: guix-git/doc/guix.texi:7455
  12386. #, no-wrap
  12387. msgid "Android distribution"
  12388. msgstr ""
  12389. #. type: cindex
  12390. #: guix-git/doc/guix.texi:7456
  12391. #, no-wrap
  12392. msgid "Android NDK build system"
  12393. msgstr ""
  12394. #. type: defvr
  12395. #: guix-git/doc/guix.texi:7460
  12396. msgid "This variable is exported by @code{(guix build-system android-ndk)}. It implements a build procedure for Android NDK (native development kit) packages using a Guix-specific build process."
  12397. msgstr ""
  12398. #. type: defvr
  12399. #: guix-git/doc/guix.texi:7464
  12400. msgid "The build system assumes that packages install their public interface (header) files to the subdirectory @file{include} of the @code{out} output and their libraries to the subdirectory @file{lib} the @code{out} output."
  12401. msgstr ""
  12402. #. type: defvr
  12403. #: guix-git/doc/guix.texi:7467
  12404. msgid "It's also assumed that the union of all the dependencies of a package has no conflicting files."
  12405. msgstr ""
  12406. #. type: defvr
  12407. #: guix-git/doc/guix.texi:7470
  12408. msgid "For the time being, cross-compilation is not supported - so right now the libraries and header files are assumed to be host tools."
  12409. msgstr ""
  12410. #. type: defvr
  12411. #: guix-git/doc/guix.texi:7473
  12412. #, no-wrap
  12413. msgid "{Scheme Variable} asdf-build-system/source"
  12414. msgstr ""
  12415. #. type: defvrx
  12416. #: guix-git/doc/guix.texi:7474
  12417. #, no-wrap
  12418. msgid "{Scheme Variable} asdf-build-system/sbcl"
  12419. msgstr ""
  12420. #. type: defvrx
  12421. #: guix-git/doc/guix.texi:7475
  12422. #, no-wrap
  12423. msgid "{Scheme Variable} asdf-build-system/ecl"
  12424. msgstr ""
  12425. #. type: defvr
  12426. #: guix-git/doc/guix.texi:7481
  12427. msgid "These variables, exported by @code{(guix build-system asdf)}, implement build procedures for Common Lisp packages using @url{https://common-lisp.net/project/asdf/, ``ASDF''}. ASDF is a system definition facility for Common Lisp programs and libraries."
  12428. msgstr ""
  12429. #. type: defvr
  12430. #: guix-git/doc/guix.texi:7488
  12431. msgid "The @code{asdf-build-system/source} system installs the packages in source form, and can be loaded using any common lisp implementation, via ASDF@. The others, such as @code{asdf-build-system/sbcl}, install binary systems in the format which a particular implementation understands. These build systems can also be used to produce executable programs, or lisp images which contain a set of packages pre-loaded."
  12432. msgstr ""
  12433. #. type: defvr
  12434. #: guix-git/doc/guix.texi:7492
  12435. msgid "The build system uses naming conventions. For binary packages, the package name should be prefixed with the lisp implementation, such as @code{sbcl-} for @code{asdf-build-system/sbcl}."
  12436. msgstr ""
  12437. #. type: defvr
  12438. #: guix-git/doc/guix.texi:7496
  12439. msgid "Additionally, the corresponding source package should be labeled using the same convention as python packages (see @ref{Python Modules}), using the @code{cl-} prefix."
  12440. msgstr ""
  12441. #. type: defvr
  12442. #: guix-git/doc/guix.texi:7504
  12443. msgid "In order to create executable programs and images, the build-side procedures @code{build-program} and @code{build-image} can be used. They should be called in a build phase after the @code{create-asdf-configuration} phase, so that the system which was just built can be used within the resulting image. @code{build-program} requires a list of Common Lisp expressions to be passed as the @code{#:entry-program} argument."
  12444. msgstr ""
  12445. #. type: defvr
  12446. #: guix-git/doc/guix.texi:7513
  12447. msgid "By default, all the @file{.asd} files present in the sources are read to find system definitions. The @code{#:asd-files} parameter can be used to specify the list of @file{.asd} files to read. Furthermore, if the package defines a system for its tests in a separate file, it will be loaded before the tests are run if it is specified by the @code{#:test-asd-file} parameter. If it is not set, the files @code{<system>-tests.asd}, @code{<system>-test.asd}, @code{tests.asd}, and @code{test.asd} will be tried if they exist."
  12448. msgstr ""
  12449. #. type: defvr
  12450. #: guix-git/doc/guix.texi:7518
  12451. msgid "If for some reason the package must be named in a different way than the naming conventions suggest, or if several systems must be compiled, the @code{#:asd-systems} parameter can be used to specify the list of system names."
  12452. msgstr ""
  12453. #. type: defvr
  12454. #: guix-git/doc/guix.texi:7521
  12455. #, no-wrap
  12456. msgid "{Scheme Variable} cargo-build-system"
  12457. msgstr ""
  12458. #. type: cindex
  12459. #: guix-git/doc/guix.texi:7522
  12460. #, no-wrap
  12461. msgid "Rust programming language"
  12462. msgstr ""
  12463. #. type: cindex
  12464. #: guix-git/doc/guix.texi:7523
  12465. #, no-wrap
  12466. msgid "Cargo (Rust build system)"
  12467. msgstr ""
  12468. #. type: defvr
  12469. #: guix-git/doc/guix.texi:7527
  12470. msgid "This variable is exported by @code{(guix build-system cargo)}. It supports builds of packages using Cargo, the build tool of the @uref{https://www.rust-lang.org, Rust programming language}."
  12471. msgstr ""
  12472. #. type: defvr
  12473. #: guix-git/doc/guix.texi:7530
  12474. msgid "It adds @code{rustc} and @code{cargo} to the set of inputs. A different Rust package can be specified with the @code{#:rust} parameter."
  12475. msgstr ""
  12476. #. type: defvr
  12477. #: guix-git/doc/guix.texi:7540
  12478. msgid "Regular cargo dependencies should be added to the package definition similarly to other packages; those needed only at build time to native-inputs, others to inputs. If you need to add source-only crates then you should add them to via the @code{#:cargo-inputs} parameter as a list of name and spec pairs, where the spec can be a package or a source definition. Note that the spec must evaluate to a path to a gzipped tarball which includes a @code{Cargo.toml} file at its root, or it will be ignored. Similarly, cargo dev-dependencies should be added to the package definition via the @code{#:cargo-development-inputs} parameter."
  12479. msgstr ""
  12480. #. type: defvr
  12481. #: guix-git/doc/guix.texi:7550
  12482. msgid "In its @code{configure} phase, this build system will make any source inputs specified in the @code{#:cargo-inputs} and @code{#:cargo-development-inputs} parameters available to cargo. It will also remove an included @code{Cargo.lock} file to be recreated by @code{cargo} during the @code{build} phase. The @code{package} phase will run @code{cargo package} to create a source crate for future use. The @code{install} phase installs the binaries defined by the crate. Unless @code{install-source? #f} is defined it will also install a source crate repository of itself and unpacked sources, to ease in future hacking on rust packages."
  12483. msgstr ""
  12484. #. type: defvr
  12485. #: guix-git/doc/guix.texi:7552
  12486. #, no-wrap
  12487. msgid "{Scheme Variable} chicken-build-system"
  12488. msgstr ""
  12489. #. type: defvr
  12490. #: guix-git/doc/guix.texi:7557
  12491. msgid "This variable is exported by @code{(guix build-system chicken)}. It builds @uref{https://call-cc.org/, CHICKEN Scheme} modules, also called ``eggs'' or ``extensions''. CHICKEN generates C source code, which then gets compiled by a C compiler, in this case GCC."
  12492. msgstr ""
  12493. #. type: defvr
  12494. #: guix-git/doc/guix.texi:7560
  12495. msgid "This build system adds @code{chicken} to the package inputs, as well as the packages of @code{gnu-build-system}."
  12496. msgstr ""
  12497. #. type: defvr
  12498. #: guix-git/doc/guix.texi:7564
  12499. msgid "The build system can't (yet) deduce the egg's name automatically, so just like with @code{go-build-system} and its @code{#:import-path}, you should define @code{#:egg-name} in the package's @code{arguments} field."
  12500. msgstr ""
  12501. #. type: defvr
  12502. #: guix-git/doc/guix.texi:7566
  12503. msgid "For example, if you are packaging the @code{srfi-1} egg:"
  12504. msgstr ""
  12505. #. type: lisp
  12506. #: guix-git/doc/guix.texi:7569
  12507. #, no-wrap
  12508. msgid "(arguments '(#:egg-name \"srfi-1\"))\n"
  12509. msgstr ""
  12510. #. type: defvr
  12511. #: guix-git/doc/guix.texi:7574
  12512. msgid "Egg dependencies must be defined in @code{propagated-inputs}, not @code{inputs} because CHICKEN doesn't embed absolute references in compiled eggs. Test dependencies should go to @code{native-inputs}, as usual."
  12513. msgstr ""
  12514. #. type: defvr
  12515. #: guix-git/doc/guix.texi:7576
  12516. #, no-wrap
  12517. msgid "{Scheme Variable} copy-build-system"
  12518. msgstr ""
  12519. #. type: defvr
  12520. #: guix-git/doc/guix.texi:7580
  12521. msgid "This variable is exported by @code{(guix build-system copy)}. It supports builds of simple packages that don't require much compiling, mostly just moving files around."
  12522. msgstr ""
  12523. #. type: defvr
  12524. #: guix-git/doc/guix.texi:7585
  12525. msgid "It adds much of the @code{gnu-build-system} packages to the set of inputs. Because of this, the @code{copy-build-system} does not require all the boilerplate code often needed for the @code{trivial-build-system}."
  12526. msgstr ""
  12527. #. type: defvr
  12528. #: guix-git/doc/guix.texi:7590
  12529. msgid "To further simplify the file installation process, an @code{#:install-plan} argument is exposed to let the packager specify which files go where. The install plan is a list of @code{(@var{source} @var{target} [@var{filters}])}. @var{filters} are optional."
  12530. msgstr ""
  12531. #. type: item
  12532. #: guix-git/doc/guix.texi:7592
  12533. #, no-wrap
  12534. msgid "When @var{source} matches a file or directory without trailing slash, install it to @var{target}."
  12535. msgstr ""
  12536. #. type: item
  12537. #: guix-git/doc/guix.texi:7594
  12538. #, no-wrap
  12539. msgid "If @var{target} has a trailing slash, install @var{source} basename beneath @var{target}."
  12540. msgstr ""
  12541. #. type: item
  12542. #: guix-git/doc/guix.texi:7595
  12543. #, no-wrap
  12544. msgid "Otherwise install @var{source} as @var{target}."
  12545. msgstr ""
  12546. #. type: item
  12547. #: guix-git/doc/guix.texi:7598
  12548. #, no-wrap
  12549. msgid "When @var{source} is a directory with a trailing slash, or when @var{filters} are used,"
  12550. msgstr ""
  12551. #. type: itemize
  12552. #: guix-git/doc/guix.texi:7601
  12553. msgid "the trailing slash of @var{target} is implied with the same meaning as above."
  12554. msgstr ""
  12555. #. type: item
  12556. #: guix-git/doc/guix.texi:7602
  12557. #, no-wrap
  12558. msgid "Without @var{filters}, install the full @var{source} @emph{content} to @var{target}."
  12559. msgstr ""
  12560. #. type: item
  12561. #: guix-git/doc/guix.texi:7603
  12562. #, no-wrap
  12563. msgid "With @var{filters} among @code{#:include}, @code{#:include-regexp}, @code{#:exclude},"
  12564. msgstr ""
  12565. #. type: itemize
  12566. #: guix-git/doc/guix.texi:7606
  12567. msgid "@code{#:exclude-regexp}, only select files are installed depending on the filters. Each filters is specified by a list of strings."
  12568. msgstr ""
  12569. #. type: item
  12570. #: guix-git/doc/guix.texi:7607
  12571. #, no-wrap
  12572. msgid "With @code{#:include}, install all the files which the path suffix matches"
  12573. msgstr ""
  12574. #. type: itemize
  12575. #: guix-git/doc/guix.texi:7609
  12576. msgid "at least one of the elements in the given list."
  12577. msgstr ""
  12578. #. type: item
  12579. #: guix-git/doc/guix.texi:7609
  12580. #, no-wrap
  12581. msgid "With @code{#:include-regexp}, install all the files which the"
  12582. msgstr ""
  12583. #. type: itemize
  12584. #: guix-git/doc/guix.texi:7612
  12585. msgid "subpaths match at least one of the regular expressions in the given list."
  12586. msgstr ""
  12587. #. type: item
  12588. #: guix-git/doc/guix.texi:7612
  12589. #, no-wrap
  12590. msgid "The @code{#:exclude} and @code{#:exclude-regexp} filters"
  12591. msgstr ""
  12592. #. type: itemize
  12593. #: guix-git/doc/guix.texi:7617
  12594. msgid "are the complement of their inclusion counterpart. Without @code{#:include} flags, install all files but those matching the exclusion filters. If both inclusions and exclusions are specified, the exclusions are done on top of the inclusions."
  12595. msgstr ""
  12596. #. type: itemize
  12597. #: guix-git/doc/guix.texi:7621
  12598. msgid "In all cases, the paths relative to @var{source} are preserved within @var{target}."
  12599. msgstr ""
  12600. #. type: defvr
  12601. #: guix-git/doc/guix.texi:7624
  12602. msgid "Examples:"
  12603. msgstr ""
  12604. #. type: item
  12605. #: guix-git/doc/guix.texi:7626
  12606. #, no-wrap
  12607. msgid "@code{(\"foo/bar\" \"share/my-app/\")}: Install @file{bar} to @file{share/my-app/bar}."
  12608. msgstr ""
  12609. #. type: item
  12610. #: guix-git/doc/guix.texi:7627
  12611. #, no-wrap
  12612. msgid "@code{(\"foo/bar\" \"share/my-app/baz\")}: Install @file{bar} to @file{share/my-app/baz}."
  12613. msgstr ""
  12614. #. type: item
  12615. #: guix-git/doc/guix.texi:7628
  12616. #, no-wrap
  12617. msgid "@code{(\"foo/\" \"share/my-app\")}: Install the content of @file{foo} inside @file{share/my-app},"
  12618. msgstr ""
  12619. #. type: itemize
  12620. #: guix-git/doc/guix.texi:7630
  12621. msgid "e.g., install @file{foo/sub/file} to @file{share/my-app/sub/file}."
  12622. msgstr ""
  12623. #. type: item
  12624. #: guix-git/doc/guix.texi:7630
  12625. #, no-wrap
  12626. msgid "@code{(\"foo/\" \"share/my-app\" #:include (\"sub/file\"))}: Install only @file{foo/sub/file} to"
  12627. msgstr ""
  12628. #. type: itemize
  12629. #: guix-git/doc/guix.texi:7632
  12630. msgid "@file{share/my-app/sub/file}."
  12631. msgstr ""
  12632. #. type: item
  12633. #: guix-git/doc/guix.texi:7632
  12634. #, no-wrap
  12635. msgid "@code{(\"foo/sub\" \"share/my-app\" #:include (\"file\"))}: Install @file{foo/sub/file} to"
  12636. msgstr ""
  12637. #. type: itemize
  12638. #: guix-git/doc/guix.texi:7634
  12639. msgid "@file{share/my-app/file}."
  12640. msgstr ""
  12641. #. type: cindex
  12642. #: guix-git/doc/guix.texi:7638
  12643. #, no-wrap
  12644. msgid "Clojure (programming language)"
  12645. msgstr ""
  12646. #. type: cindex
  12647. #: guix-git/doc/guix.texi:7639
  12648. #, no-wrap
  12649. msgid "simple Clojure build system"
  12650. msgstr ""
  12651. #. type: defvr
  12652. #: guix-git/doc/guix.texi:7640
  12653. #, no-wrap
  12654. msgid "{Scheme Variable} clojure-build-system"
  12655. msgstr ""
  12656. #. type: defvr
  12657. #: guix-git/doc/guix.texi:7645
  12658. msgid "This variable is exported by @code{(guix build-system clojure)}. It implements a simple build procedure for @uref{https://clojure.org/, Clojure} packages using plain old @code{compile} in Clojure. Cross-compilation is not supported yet."
  12659. msgstr ""
  12660. #. type: defvr
  12661. #: guix-git/doc/guix.texi:7649
  12662. msgid "It adds @code{clojure}, @code{icedtea} and @code{zip} to the set of inputs. Different packages can be specified with the @code{#:clojure}, @code{#:jdk} and @code{#:zip} parameters, respectively."
  12663. msgstr ""
  12664. #. type: defvr
  12665. #: guix-git/doc/guix.texi:7655
  12666. msgid "A list of source directories, test directories and jar names can be specified with the @code{#:source-dirs}, @code{#:test-dirs} and @code{#:jar-names} parameters, respectively. Compile directory and main class can be specified with the @code{#:compile-dir} and @code{#:main-class} parameters, respectively. Other parameters are documented below."
  12667. msgstr ""
  12668. #. type: defvr
  12669. #: guix-git/doc/guix.texi:7658
  12670. msgid "This build system is an extension of @code{ant-build-system}, but with the following phases changed:"
  12671. msgstr ""
  12672. #. type: item
  12673. #: guix-git/doc/guix.texi:7661 guix-git/doc/guix.texi:8227
  12674. #: guix-git/doc/guix.texi:8274 guix-git/doc/guix.texi:8343
  12675. #: guix-git/doc/guix.texi:33640
  12676. #, no-wrap
  12677. msgid "build"
  12678. msgstr ""
  12679. #. type: table
  12680. #: guix-git/doc/guix.texi:7670
  12681. msgid "This phase calls @code{compile} in Clojure to compile source files and runs @command{jar} to create jars from both source files and compiled files according to the include list and exclude list specified in @code{#:aot-include} and @code{#:aot-exclude}, respectively. The exclude list has priority over the include list. These lists consist of symbols representing Clojure libraries or the special keyword @code{#:all} representing all Clojure libraries found under the source directories. The parameter @code{#:omit-source?} decides if source should be included into the jars."
  12682. msgstr ""
  12683. #. type: item
  12684. #: guix-git/doc/guix.texi:7671 guix-git/doc/guix.texi:8231
  12685. #: guix-git/doc/guix.texi:8348
  12686. #, no-wrap
  12687. msgid "check"
  12688. msgstr ""
  12689. #. type: table
  12690. #: guix-git/doc/guix.texi:7678
  12691. msgid "This phase runs tests according to the include list and exclude list specified in @code{#:test-include} and @code{#:test-exclude}, respectively. Their meanings are analogous to that of @code{#:aot-include} and @code{#:aot-exclude}, except that the special keyword @code{#:all} now stands for all Clojure libraries found under the test directories. The parameter @code{#:tests?} decides if tests should be run."
  12692. msgstr ""
  12693. #. type: item
  12694. #: guix-git/doc/guix.texi:7679 guix-git/doc/guix.texi:8235
  12695. #: guix-git/doc/guix.texi:8278 guix-git/doc/guix.texi:8354
  12696. #, no-wrap
  12697. msgid "install"
  12698. msgstr ""
  12699. #. type: table
  12700. #: guix-git/doc/guix.texi:7681
  12701. msgid "This phase installs all jars built previously."
  12702. msgstr ""
  12703. #. type: defvr
  12704. #: guix-git/doc/guix.texi:7684
  12705. msgid "Apart from the above, this build system also contains an additional phase:"
  12706. msgstr ""
  12707. #. type: item
  12708. #: guix-git/doc/guix.texi:7687
  12709. #, no-wrap
  12710. msgid "install-doc"
  12711. msgstr ""
  12712. #. type: table
  12713. #: guix-git/doc/guix.texi:7692
  12714. msgid "This phase installs all top-level files with base name matching @code{%doc-regex}. A different regex can be specified with the @code{#:doc-regex} parameter. All files (recursively) inside the documentation directories specified in @code{#:doc-dirs} are installed as well."
  12715. msgstr ""
  12716. #. type: defvr
  12717. #: guix-git/doc/guix.texi:7695
  12718. #, no-wrap
  12719. msgid "{Scheme Variable} cmake-build-system"
  12720. msgstr ""
  12721. #. type: defvr
  12722. #: guix-git/doc/guix.texi:7699
  12723. msgid "This variable is exported by @code{(guix build-system cmake)}. It implements the build procedure for packages using the @url{https://www.cmake.org, CMake build tool}."
  12724. msgstr ""
  12725. #. type: defvr
  12726. #: guix-git/doc/guix.texi:7703
  12727. msgid "It automatically adds the @code{cmake} package to the set of inputs. Which package is used can be specified with the @code{#:cmake} parameter."
  12728. msgstr ""
  12729. #. type: defvr
  12730. #: guix-git/doc/guix.texi:7710
  12731. msgid "The @code{#:configure-flags} parameter is taken as a list of flags passed to the @command{cmake} command. The @code{#:build-type} parameter specifies in abstract terms the flags passed to the compiler; it defaults to @code{\"RelWithDebInfo\"} (short for ``release mode with debugging information''), which roughly means that code is compiled with @code{-O2 -g}, as is the case for Autoconf-based packages by default."
  12732. msgstr ""
  12733. #. type: defvr
  12734. #: guix-git/doc/guix.texi:7712
  12735. #, no-wrap
  12736. msgid "{Scheme Variable} dune-build-system"
  12737. msgstr ""
  12738. #. type: defvr
  12739. #: guix-git/doc/guix.texi:7719
  12740. msgid "This variable is exported by @code{(guix build-system dune)}. It supports builds of packages using @uref{https://dune.build/, Dune}, a build tool for the OCaml programming language. It is implemented as an extension of the @code{ocaml-build-system} which is described below. As such, the @code{#:ocaml} and @code{#:findlib} parameters can be passed to this build system."
  12741. msgstr ""
  12742. #. type: defvr
  12743. #: guix-git/doc/guix.texi:7723
  12744. msgid "It automatically adds the @code{dune} package to the set of inputs. Which package is used can be specified with the @code{#:dune} parameter."
  12745. msgstr ""
  12746. #. type: defvr
  12747. #: guix-git/doc/guix.texi:7727
  12748. msgid "There is no @code{configure} phase because dune packages typically don't need to be configured. The @code{#:build-flags} parameter is taken as a list of flags passed to the @code{dune} command during the build."
  12749. msgstr ""
  12750. #. type: defvr
  12751. #: guix-git/doc/guix.texi:7731
  12752. msgid "The @code{#:jbuild?} parameter can be passed to use the @code{jbuild} command instead of the more recent @code{dune} command while building a package. Its default value is @code{#f}."
  12753. msgstr ""
  12754. #. type: defvr
  12755. #: guix-git/doc/guix.texi:7736
  12756. msgid "The @code{#:package} parameter can be passed to specify a package name, which is useful when a package contains multiple packages and you want to build only one of them. This is equivalent to passing the @code{-p} argument to @code{dune}."
  12757. msgstr ""
  12758. #. type: defvr
  12759. #: guix-git/doc/guix.texi:7741
  12760. msgid "The @code{#:profile} parameter can be passed to specify the @uref{https://dune.readthedocs.io/en/stable/dune-files.html#profile, dune build profile}. This is equivalent to passing the @code{--profile} argument to @code{dune}. Its default value is @code{\"release\"}."
  12761. msgstr ""
  12762. #. type: defvr
  12763. #: guix-git/doc/guix.texi:7744
  12764. #, no-wrap
  12765. msgid "{Scheme Variable} go-build-system"
  12766. msgstr ""
  12767. #. type: defvr
  12768. #: guix-git/doc/guix.texi:7749
  12769. msgid "This variable is exported by @code{(guix build-system go)}. It implements a build procedure for Go packages using the standard @url{https://golang.org/cmd/go/#hdr-Compile_packages_and_dependencies, Go build mechanisms}."
  12770. msgstr ""
  12771. #. type: defvr
  12772. #: guix-git/doc/guix.texi:7760
  12773. msgid "The user is expected to provide a value for the key @code{#:import-path} and, in some cases, @code{#:unpack-path}. The @url{https://golang.org/doc/code.html#ImportPaths, import path} corresponds to the file system path expected by the package's build scripts and any referring packages, and provides a unique way to refer to a Go package. It is typically based on a combination of the package source code's remote URI and file system hierarchy structure. In some cases, you will need to unpack the package's source code to a different directory structure than the one indicated by the import path, and @code{#:unpack-path} should be used in such cases."
  12774. msgstr ""
  12775. #. type: defvr
  12776. #: guix-git/doc/guix.texi:7765
  12777. msgid "Packages that provide Go libraries should install their source code into the built output. The key @code{#:install-source?}, which defaults to @code{#t}, controls whether or not the source code is installed. It can be set to @code{#f} for packages that only provide executable files."
  12778. msgstr ""
  12779. #. type: defvr
  12780. #: guix-git/doc/guix.texi:7767
  12781. #, no-wrap
  12782. msgid "{Scheme Variable} glib-or-gtk-build-system"
  12783. msgstr ""
  12784. #. type: defvr
  12785. #: guix-git/doc/guix.texi:7770
  12786. msgid "This variable is exported by @code{(guix build-system glib-or-gtk)}. It is intended for use with packages making use of GLib or GTK+."
  12787. msgstr ""
  12788. #. type: defvr
  12789. #: guix-git/doc/guix.texi:7773
  12790. msgid "This build system adds the following two phases to the ones defined by @code{gnu-build-system}:"
  12791. msgstr ""
  12792. #. type: item
  12793. #: guix-git/doc/guix.texi:7775 guix-git/doc/guix.texi:8251
  12794. #, no-wrap
  12795. msgid "glib-or-gtk-wrap"
  12796. msgstr ""
  12797. #. type: table
  12798. #: guix-git/doc/guix.texi:7782
  12799. msgid "The phase @code{glib-or-gtk-wrap} ensures that programs in @file{bin/} are able to find GLib ``schemas'' and @uref{https://developer.gnome.org/gtk3/stable/gtk-running.html, GTK+ modules}. This is achieved by wrapping the programs in launch scripts that appropriately set the @env{XDG_DATA_DIRS} and @env{GTK_PATH} environment variables."
  12800. msgstr ""
  12801. #. type: table
  12802. #: guix-git/doc/guix.texi:7789
  12803. msgid "It is possible to exclude specific package outputs from that wrapping process by listing their names in the @code{#:glib-or-gtk-wrap-excluded-outputs} parameter. This is useful when an output is known not to contain any GLib or GTK+ binaries, and where wrapping would gratuitously add a dependency of that output on GLib and GTK+."
  12804. msgstr ""
  12805. #. type: item
  12806. #: guix-git/doc/guix.texi:7790 guix-git/doc/guix.texi:8255
  12807. #, no-wrap
  12808. msgid "glib-or-gtk-compile-schemas"
  12809. msgstr ""
  12810. #. type: table
  12811. #: guix-git/doc/guix.texi:7798
  12812. msgid "The phase @code{glib-or-gtk-compile-schemas} makes sure that all @uref{https://developer.gnome.org/gio/stable/glib-compile-schemas.html, GSettings schemas} of GLib are compiled. Compilation is performed by the @command{glib-compile-schemas} program. It is provided by the package @code{glib:bin} which is automatically imported by the build system. The @code{glib} package providing @command{glib-compile-schemas} can be specified with the @code{#:glib} parameter."
  12813. msgstr ""
  12814. #. type: defvr
  12815. #: guix-git/doc/guix.texi:7801
  12816. msgid "Both phases are executed after the @code{install} phase."
  12817. msgstr ""
  12818. #. type: defvr
  12819. #: guix-git/doc/guix.texi:7803
  12820. #, no-wrap
  12821. msgid "{Scheme Variable} guile-build-system"
  12822. msgstr ""
  12823. #. type: defvr
  12824. #: guix-git/doc/guix.texi:7810
  12825. msgid "This build system is for Guile packages that consist exclusively of Scheme code and that are so lean that they don't even have a makefile, let alone a @file{configure} script. It compiles Scheme code using @command{guild compile} (@pxref{Compilation,,, guile, GNU Guile Reference Manual}) and installs the @file{.scm} and @file{.go} files in the right place. It also installs documentation."
  12826. msgstr ""
  12827. #. type: defvr
  12828. #: guix-git/doc/guix.texi:7813
  12829. msgid "This build system supports cross-compilation by using the @option{--target} option of @samp{guild compile}."
  12830. msgstr ""
  12831. #. type: defvr
  12832. #: guix-git/doc/guix.texi:7816
  12833. msgid "Packages built with @code{guile-build-system} must provide a Guile package in their @code{native-inputs} field."
  12834. msgstr ""
  12835. #. type: defvr
  12836. #: guix-git/doc/guix.texi:7818
  12837. #, no-wrap
  12838. msgid "{Scheme Variable} julia-build-system"
  12839. msgstr ""
  12840. #. type: defvr
  12841. #: guix-git/doc/guix.texi:7825
  12842. msgid "This variable is exported by @code{(guix build-system julia)}. It implements the build procedure used by @uref{https://julialang.org/, julia} packages, which essentially is similar to running @samp{julia -e 'using Pkg; Pkg.add(package)'} in an environment where @env{JULIA_LOAD_PATH} contains the paths to all Julia package inputs. Tests are run by calling @code{/test/runtests.jl}."
  12843. msgstr ""
  12844. #. type: defvr
  12845. #: guix-git/doc/guix.texi:7829
  12846. msgid "The Julia package name is read from the file @file{Project.toml}. This value can be overridden by passing the argument @code{#:julia-package-name} (which must be correctly capitalized)."
  12847. msgstr ""
  12848. #. type: defvr
  12849. #: guix-git/doc/guix.texi:7833
  12850. msgid "Julia packages usually manage their binary dependencies via @code{JLLWrappers.jl}, a Julia package that creates a module (named after the wrapped library followed by @code{_jll.jl}."
  12851. msgstr ""
  12852. #. type: defvr
  12853. #: guix-git/doc/guix.texi:7838
  12854. msgid "To add the binary path @code{_jll.jl} packages, you need to patch the files under @file{src/wrappers/}, replacing the call to the macro @code{JLLWrappers.@@generate_wrapper_header}, adding as a second argument containing the store path the binary."
  12855. msgstr ""
  12856. #. type: defvr
  12857. #: guix-git/doc/guix.texi:7842
  12858. msgid "As an example, in the MbedTLS Julia package, we add a build phase (@pxref{Build Phases}) to insert the absolute file name of the wrapped MbedTLS package:"
  12859. msgstr ""
  12860. #. type: lisp
  12861. #: guix-git/doc/guix.texi:7854
  12862. #, no-wrap
  12863. msgid ""
  12864. "(add-after 'unpack 'override-binary-path\n"
  12865. " (lambda* (#:key inputs #:allow-other-keys)\n"
  12866. " (for-each (lambda (wrapper)\n"
  12867. " (substitute* wrapper\n"
  12868. " ((\"generate_wrapper_header.*\")\n"
  12869. " (string-append\n"
  12870. " \"generate_wrapper_header(\\\"MbedTLS\\\", \\\"\"\n"
  12871. " (assoc-ref inputs \"mbedtls-apache\") \"\\\")\\n\"))))\n"
  12872. " ;; There's a Julia file for each platform, override them all.\n"
  12873. " (find-files \"src/wrappers/\" \"\\\\.jl$\"))))\n"
  12874. msgstr ""
  12875. #. type: defvr
  12876. #: guix-git/doc/guix.texi:7862
  12877. msgid "Some older packages that aren't using @file{Package.toml} yet, will require this file to be created, too. The function @code{julia-create-package-toml} helps creating the file. You need to pass the outputs and the source of the package, its name (the same as the @code{file-name} parameter), the package uuid, the package version, and a list of dependencies specified by their name and their uuid."
  12878. msgstr ""
  12879. #. type: defvr
  12880. #: guix-git/doc/guix.texi:7864
  12881. #, no-wrap
  12882. msgid "{Scheme Variable} maven-build-system"
  12883. msgstr ""
  12884. #. type: defvr
  12885. #: guix-git/doc/guix.texi:7871
  12886. msgid "This variable is exported by @code{(guix build-system maven)}. It implements a build procedure for @uref{https://maven.apache.org, Maven} packages. Maven is a dependency and lifecycle management tool for Java. A user of Maven specifies dependencies and plugins in a @file{pom.xml} file that Maven reads. When Maven does not have one of the dependencies or plugins in its repository, it will download them and use them to build the package."
  12887. msgstr ""
  12888. #. type: defvr
  12889. #: guix-git/doc/guix.texi:7881
  12890. msgid "The maven build system ensures that maven will not try to download any dependency by running in offline mode. Maven will fail if a dependency is missing. Before running Maven, the @file{pom.xml} (and subprojects) are modified to specify the version of dependencies and plugins that match the versions available in the guix build environment. Dependencies and plugins must be installed in the fake maven repository at @file{lib/m2}, and are symlinked into a proper repository before maven is run. Maven is instructed to use that repository for the build and installs built artifacts there. Changed files are copied to the @file{lib/m2} directory of the package output."
  12891. msgstr ""
  12892. #. type: defvr
  12893. #: guix-git/doc/guix.texi:7884
  12894. msgid "You can specify a @file{pom.xml} file with the @code{#:pom-file} argument, or let the build system use the default @file{pom.xml} file in the sources."
  12895. msgstr ""
  12896. #. type: defvr
  12897. #: guix-git/doc/guix.texi:7890
  12898. msgid "In case you need to specify a dependency's version manually, you can use the @code{#:local-packages} argument. It takes an association list where the key is the groupId of the package and its value is an association list where the key is the artifactId of the package and its value is the version you want to override in the @file{pom.xml}."
  12899. msgstr ""
  12900. #. type: defvr
  12901. #: guix-git/doc/guix.texi:7896
  12902. msgid "Some packages use dependencies or plugins that are not useful at runtime nor at build time in Guix. You can alter the @file{pom.xml} file to remove them using the @code{#:exclude} argument. Its value is an association list where the key is the groupId of the plugin or dependency you want to remove, and the value is a list of artifactId you want to remove."
  12903. msgstr ""
  12904. #. type: defvr
  12905. #: guix-git/doc/guix.texi:7899
  12906. msgid "You can override the default @code{jdk} and @code{maven} packages with the corresponding argument, @code{#:jdk} and @code{#:maven}."
  12907. msgstr ""
  12908. #. type: defvr
  12909. #: guix-git/doc/guix.texi:7904
  12910. msgid "The @code{#:maven-plugins} argument is a list of maven plugins used during the build, with the same format as the @code{inputs} fields of the package declaration. Its default value is @code{(default-maven-plugins)} which is also exported."
  12911. msgstr ""
  12912. #. type: defvr
  12913. #: guix-git/doc/guix.texi:7906
  12914. #, no-wrap
  12915. msgid "{Scheme Variable} minetest-mod-build-system"
  12916. msgstr ""
  12917. #. type: defvr
  12918. #: guix-git/doc/guix.texi:7912
  12919. msgid "This variable is exported by @code{(guix build-system minetest)}. It implements a build procedure for @uref{https://www.minetest.net, Minetest} mods, which consists of copying Lua code, images and other resources to the location Minetest searches for mods. The build system also minimises PNG images and verifies that Minetest can load the mod without errors."
  12920. msgstr ""
  12921. #. type: defvr
  12922. #: guix-git/doc/guix.texi:7914
  12923. #, no-wrap
  12924. msgid "{Scheme Variable} minify-build-system"
  12925. msgstr ""
  12926. #. type: defvr
  12927. #: guix-git/doc/guix.texi:7917
  12928. msgid "This variable is exported by @code{(guix build-system minify)}. It implements a minification procedure for simple JavaScript packages."
  12929. msgstr ""
  12930. #. type: defvr
  12931. #: guix-git/doc/guix.texi:7923
  12932. msgid "It adds @code{uglify-js} to the set of inputs and uses it to compress all JavaScript files in the @file{src} directory. A different minifier package can be specified with the @code{#:uglify-js} parameter, but it is expected that the package writes the minified code to the standard output."
  12933. msgstr ""
  12934. #. type: defvr
  12935. #: guix-git/doc/guix.texi:7927
  12936. msgid "When the input JavaScript files are not all located in the @file{src} directory, the parameter @code{#:javascript-files} can be used to specify a list of file names to feed to the minifier."
  12937. msgstr ""
  12938. #. type: defvr
  12939. #: guix-git/doc/guix.texi:7929
  12940. #, no-wrap
  12941. msgid "{Scheme Variable} ocaml-build-system"
  12942. msgstr ""
  12943. #. type: defvr
  12944. #: guix-git/doc/guix.texi:7935
  12945. msgid "This variable is exported by @code{(guix build-system ocaml)}. It implements a build procedure for @uref{https://ocaml.org, OCaml} packages, which consists of choosing the correct set of commands to run for each package. OCaml packages can expect many different commands to be run. This build system will try some of them."
  12946. msgstr ""
  12947. #. type: defvr
  12948. #: guix-git/doc/guix.texi:7945
  12949. msgid "When the package has a @file{setup.ml} file present at the top-level, it will run @code{ocaml setup.ml -configure}, @code{ocaml setup.ml -build} and @code{ocaml setup.ml -install}. The build system will assume that this file was generated by @uref{http://oasis.forge.ocamlcore.org/, OASIS} and will take care of setting the prefix and enabling tests if they are not disabled. You can pass configure and build flags with the @code{#:configure-flags} and @code{#:build-flags}. The @code{#:test-flags} key can be passed to change the set of flags used to enable tests. The @code{#:use-make?} key can be used to bypass this system in the build and install phases."
  12950. msgstr ""
  12951. #. type: defvr
  12952. #: guix-git/doc/guix.texi:7950
  12953. msgid "When the package has a @file{configure} file, it is assumed that it is a hand-made configure script that requires a different argument format than in the @code{gnu-build-system}. You can add more flags with the @code{#:configure-flags} key."
  12954. msgstr ""
  12955. #. type: defvr
  12956. #: guix-git/doc/guix.texi:7954
  12957. msgid "When the package has a @file{Makefile} file (or @code{#:use-make?} is @code{#t}), it will be used and more flags can be passed to the build and install phases with the @code{#:make-flags} key."
  12958. msgstr ""
  12959. #. type: defvr
  12960. #: guix-git/doc/guix.texi:7962
  12961. msgid "Finally, some packages do not have these files and use a somewhat standard location for its build system. In that case, the build system will run @code{ocaml pkg/pkg.ml} or @code{ocaml pkg/build.ml} and take care of providing the path to the required findlib module. Additional flags can be passed via the @code{#:build-flags} key. Install is taken care of by @command{opam-installer}. In this case, the @code{opam} package must be added to the @code{native-inputs} field of the package definition."
  12962. msgstr ""
  12963. #. type: defvr
  12964. #: guix-git/doc/guix.texi:7970
  12965. msgid "Note that most OCaml packages assume they will be installed in the same directory as OCaml, which is not what we want in guix. In particular, they will install @file{.so} files in their module's directory, which is usually fine because it is in the OCaml compiler directory. In guix though, these libraries cannot be found and we use @env{CAML_LD_LIBRARY_PATH}. This variable points to @file{lib/ocaml/site-lib/stubslibs} and this is where @file{.so} libraries should be installed."
  12966. msgstr ""
  12967. #. type: defvr
  12968. #: guix-git/doc/guix.texi:7972
  12969. #, no-wrap
  12970. msgid "{Scheme Variable} python-build-system"
  12971. msgstr ""
  12972. #. type: defvr
  12973. #: guix-git/doc/guix.texi:7977
  12974. msgid "This variable is exported by @code{(guix build-system python)}. It implements the more or less standard build procedure used by Python packages, which consists in running @code{python setup.py build} and then @code{python setup.py install --prefix=/gnu/store/@dots{}}."
  12975. msgstr ""
  12976. #. type: defvr
  12977. #: guix-git/doc/guix.texi:7981
  12978. msgid "For packages that install stand-alone Python programs under @code{bin/}, it takes care of wrapping these programs so that their @env{PYTHONPATH} environment variable points to all the Python libraries they depend on."
  12979. msgstr ""
  12980. #. type: defvr
  12981. #: guix-git/doc/guix.texi:7987
  12982. msgid "Which Python package is used to perform the build can be specified with the @code{#:python} parameter. This is a useful way to force a package to be built for a specific version of the Python interpreter, which might be necessary if the package is only compatible with a single interpreter version."
  12983. msgstr ""
  12984. #. type: defvr
  12985. #: guix-git/doc/guix.texi:7992
  12986. msgid "By default guix calls @code{setup.py} under control of @code{setuptools}, much like @command{pip} does. Some packages are not compatible with setuptools (and pip), thus you can disable this by setting the @code{#:use-setuptools?} parameter to @code{#f}."
  12987. msgstr ""
  12988. #. type: defvr
  12989. #: guix-git/doc/guix.texi:7994
  12990. #, no-wrap
  12991. msgid "{Scheme Variable} perl-build-system"
  12992. msgstr ""
  12993. #. type: defvr
  12994. #: guix-git/doc/guix.texi:8006
  12995. msgid "This variable is exported by @code{(guix build-system perl)}. It implements the standard build procedure for Perl packages, which either consists in running @code{perl Build.PL --prefix=/gnu/store/@dots{}}, followed by @code{Build} and @code{Build install}; or in running @code{perl Makefile.PL PREFIX=/gnu/store/@dots{}}, followed by @code{make} and @code{make install}, depending on which of @code{Build.PL} or @code{Makefile.PL} is present in the package distribution. Preference is given to the former if both @code{Build.PL} and @code{Makefile.PL} exist in the package distribution. This preference can be reversed by specifying @code{#t} for the @code{#:make-maker?} parameter."
  12996. msgstr ""
  12997. #. type: defvr
  12998. #: guix-git/doc/guix.texi:8010
  12999. msgid "The initial @code{perl Makefile.PL} or @code{perl Build.PL} invocation passes flags specified by the @code{#:make-maker-flags} or @code{#:module-build-flags} parameter, respectively."
  13000. msgstr ""
  13001. #. type: defvr
  13002. #: guix-git/doc/guix.texi:8012
  13003. msgid "Which Perl package is used can be specified with @code{#:perl}."
  13004. msgstr ""
  13005. #. type: defvr
  13006. #: guix-git/doc/guix.texi:8014
  13007. #, no-wrap
  13008. msgid "{Scheme Variable} renpy-build-system"
  13009. msgstr ""
  13010. #. type: defvr
  13011. #: guix-git/doc/guix.texi:8018
  13012. msgid "This variable is exported by @code{(guix build-system renpy)}. It implements the more or less standard build procedure used by Ren'py games, which consists of loading @code{#:game} once, thereby creating bytecode for it."
  13013. msgstr ""
  13014. #. type: defvr
  13015. #: guix-git/doc/guix.texi:8021
  13016. msgid "It further creates a wrapper script in @code{bin/} and a desktop entry in @code{share/applications}, both of which can be used to launch the game."
  13017. msgstr ""
  13018. #. type: defvr
  13019. #: guix-git/doc/guix.texi:8025
  13020. msgid "Which Ren'py package is used can be specified with @code{#:renpy}. Games can also be installed in outputs other than ``out'' by using @code{#:output}."
  13021. msgstr ""
  13022. #. type: defvr
  13023. #: guix-git/doc/guix.texi:8027
  13024. #, no-wrap
  13025. msgid "{Scheme Variable} qt-build-system"
  13026. msgstr ""
  13027. #. type: defvr
  13028. #: guix-git/doc/guix.texi:8030
  13029. msgid "This variable is exported by @code{(guix build-system qt)}. It is intended for use with applications using Qt or KDE."
  13030. msgstr ""
  13031. #. type: defvr
  13032. #: guix-git/doc/guix.texi:8033
  13033. msgid "This build system adds the following two phases to the ones defined by @code{cmake-build-system}:"
  13034. msgstr ""
  13035. #. type: item
  13036. #: guix-git/doc/guix.texi:8035
  13037. #, no-wrap
  13038. msgid "check-setup"
  13039. msgstr ""
  13040. #. type: table
  13041. #: guix-git/doc/guix.texi:8042
  13042. msgid "The phase @code{check-setup} prepares the environment for running the checks as commonly used by Qt test programs. For now this only sets some environment variables: @code{QT_QPA_PLATFORM=offscreen}, @code{DBUS_FATAL_WARNINGS=0} and @code{CTEST_OUTPUT_ON_FAILURE=1}."
  13043. msgstr ""
  13044. #. type: table
  13045. #: guix-git/doc/guix.texi:8045
  13046. msgid "This phase is added before the @code{check} phase. It's a separate phase to ease adjusting if necessary."
  13047. msgstr ""
  13048. #. type: item
  13049. #: guix-git/doc/guix.texi:8046
  13050. #, no-wrap
  13051. msgid "qt-wrap"
  13052. msgstr ""
  13053. #. type: table
  13054. #: guix-git/doc/guix.texi:8052
  13055. msgid "The phase @code{qt-wrap} searches for Qt5 plugin paths, QML paths and some XDG in the inputs and output. In case some path is found, all programs in the output's @file{bin/}, @file{sbin/}, @file{libexec/} and @file{lib/libexec/} directories are wrapped in scripts defining the necessary environment variables."
  13056. msgstr ""
  13057. #. type: table
  13058. #: guix-git/doc/guix.texi:8058
  13059. msgid "It is possible to exclude specific package outputs from that wrapping process by listing their names in the @code{#:qt-wrap-excluded-outputs} parameter. This is useful when an output is known not to contain any Qt binaries, and where wrapping would gratuitously add a dependency of that output on Qt, KDE, or such."
  13060. msgstr ""
  13061. #. type: table
  13062. #: guix-git/doc/guix.texi:8060
  13063. msgid "This phase is added after the @code{install} phase."
  13064. msgstr ""
  13065. #. type: defvr
  13066. #: guix-git/doc/guix.texi:8063
  13067. #, no-wrap
  13068. msgid "{Scheme Variable} r-build-system"
  13069. msgstr ""
  13070. #. type: defvr
  13071. #: guix-git/doc/guix.texi:8071
  13072. msgid "This variable is exported by @code{(guix build-system r)}. It implements the build procedure used by @uref{https://r-project.org, R} packages, which essentially is little more than running @samp{R CMD INSTALL --library=/gnu/store/@dots{}} in an environment where @env{R_LIBS_SITE} contains the paths to all R package inputs. Tests are run after installation using the R function @code{tools::testInstalledPackage}."
  13073. msgstr ""
  13074. #. type: defvr
  13075. #: guix-git/doc/guix.texi:8073
  13076. #, no-wrap
  13077. msgid "{Scheme Variable} rakudo-build-system"
  13078. msgstr ""
  13079. #. type: defvr
  13080. #: guix-git/doc/guix.texi:8081
  13081. msgid "This variable is exported by @code{(guix build-system rakudo)}. It implements the build procedure used by @uref{https://rakudo.org/, Rakudo} for @uref{https://perl6.org/, Perl6} packages. It installs the package to @code{/gnu/store/@dots{}/NAME-VERSION/share/perl6} and installs the binaries, library files and the resources, as well as wrap the files under the @code{bin/} directory. Tests can be skipped by passing @code{#f} to the @code{tests?} parameter."
  13082. msgstr ""
  13083. #. type: defvr
  13084. #: guix-git/doc/guix.texi:8089
  13085. msgid "Which rakudo package is used can be specified with @code{rakudo}. Which perl6-tap-harness package used for the tests can be specified with @code{#:prove6} or removed by passing @code{#f} to the @code{with-prove6?} parameter. Which perl6-zef package used for tests and installing can be specified with @code{#:zef} or removed by passing @code{#f} to the @code{with-zef?} parameter."
  13086. msgstr ""
  13087. #. type: defvr
  13088. #: guix-git/doc/guix.texi:8091
  13089. #, no-wrap
  13090. msgid "{Scheme Variable} texlive-build-system"
  13091. msgstr ""
  13092. #. type: defvr
  13093. #: guix-git/doc/guix.texi:8096
  13094. msgid "This variable is exported by @code{(guix build-system texlive)}. It is used to build TeX packages in batch mode with a specified engine. The build system sets the @env{TEXINPUTS} variable to find all TeX source files in the inputs."
  13095. msgstr ""
  13096. #. type: defvr
  13097. #: guix-git/doc/guix.texi:8105
  13098. msgid "By default it runs @code{luatex} on all files ending on @code{ins}. A different engine and format can be specified with the @code{#:tex-format} argument. Different build targets can be specified with the @code{#:build-targets} argument, which expects a list of file names. The build system adds only @code{texlive-bin} and @code{texlive-latex-base} (both from @code{(gnu packages tex}) to the inputs. Both can be overridden with the arguments @code{#:texlive-bin} and @code{#:texlive-latex-base}, respectively."
  13099. msgstr ""
  13100. #. type: defvr
  13101. #: guix-git/doc/guix.texi:8108
  13102. msgid "The @code{#:tex-directory} parameter tells the build system where to install the built files under the texmf tree."
  13103. msgstr ""
  13104. #. type: defvr
  13105. #: guix-git/doc/guix.texi:8110
  13106. #, no-wrap
  13107. msgid "{Scheme Variable} ruby-build-system"
  13108. msgstr ""
  13109. #. type: defvr
  13110. #: guix-git/doc/guix.texi:8114
  13111. msgid "This variable is exported by @code{(guix build-system ruby)}. It implements the RubyGems build procedure used by Ruby packages, which involves running @code{gem build} followed by @code{gem install}."
  13112. msgstr ""
  13113. #. type: defvr
  13114. #: guix-git/doc/guix.texi:8122
  13115. msgid "The @code{source} field of a package that uses this build system typically references a gem archive, since this is the format that Ruby developers use when releasing their software. The build system unpacks the gem archive, potentially patches the source, runs the test suite, repackages the gem, and installs it. Additionally, directories and tarballs may be referenced to allow building unreleased gems from Git or a traditional source release tarball."
  13116. msgstr ""
  13117. #. type: defvr
  13118. #: guix-git/doc/guix.texi:8126
  13119. msgid "Which Ruby package is used can be specified with the @code{#:ruby} parameter. A list of additional flags to be passed to the @command{gem} command can be specified with the @code{#:gem-flags} parameter."
  13120. msgstr ""
  13121. #. type: defvr
  13122. #: guix-git/doc/guix.texi:8128
  13123. #, no-wrap
  13124. msgid "{Scheme Variable} waf-build-system"
  13125. msgstr ""
  13126. #. type: defvr
  13127. #: guix-git/doc/guix.texi:8134
  13128. msgid "This variable is exported by @code{(guix build-system waf)}. It implements a build procedure around the @code{waf} script. The common phases---@code{configure}, @code{build}, and @code{install}---are implemented by passing their names as arguments to the @code{waf} script."
  13129. msgstr ""
  13130. #. type: defvr
  13131. #: guix-git/doc/guix.texi:8138
  13132. msgid "The @code{waf} script is executed by the Python interpreter. Which Python package is used to run the script can be specified with the @code{#:python} parameter."
  13133. msgstr ""
  13134. #. type: defvr
  13135. #: guix-git/doc/guix.texi:8140
  13136. #, no-wrap
  13137. msgid "{Scheme Variable} scons-build-system"
  13138. msgstr ""
  13139. #. type: defvr
  13140. #: guix-git/doc/guix.texi:8146
  13141. msgid "This variable is exported by @code{(guix build-system scons)}. It implements the build procedure used by the SCons software construction tool. This build system runs @code{scons} to build the package, @code{scons test} to run tests, and then @code{scons install} to install the package."
  13142. msgstr ""
  13143. #. type: defvr
  13144. #: guix-git/doc/guix.texi:8153
  13145. msgid "Additional flags to be passed to @code{scons} can be specified with the @code{#:scons-flags} parameter. The default build and install targets can be overridden with @code{#:build-targets} and @code{#:install-targets} respectively. The version of Python used to run SCons can be specified by selecting the appropriate SCons package with the @code{#:scons} parameter."
  13146. msgstr ""
  13147. #. type: defvr
  13148. #: guix-git/doc/guix.texi:8155
  13149. #, no-wrap
  13150. msgid "{Scheme Variable} haskell-build-system"
  13151. msgstr ""
  13152. #. type: defvr
  13153. #: guix-git/doc/guix.texi:8169
  13154. msgid "This variable is exported by @code{(guix build-system haskell)}. It implements the Cabal build procedure used by Haskell packages, which involves running @code{runhaskell Setup.hs configure --prefix=/gnu/store/@dots{}} and @code{runhaskell Setup.hs build}. Instead of installing the package by running @code{runhaskell Setup.hs install}, to avoid trying to register libraries in the read-only compiler store directory, the build system uses @code{runhaskell Setup.hs copy}, followed by @code{runhaskell Setup.hs register}. In addition, the build system generates the package documentation by running @code{runhaskell Setup.hs haddock}, unless @code{#:haddock? #f} is passed. Optional Haddock parameters can be passed with the help of the @code{#:haddock-flags} parameter. If the file @code{Setup.hs} is not found, the build system looks for @code{Setup.lhs} instead."
  13155. msgstr ""
  13156. #. type: defvr
  13157. #: guix-git/doc/guix.texi:8172
  13158. msgid "Which Haskell compiler is used can be specified with the @code{#:haskell} parameter which defaults to @code{ghc}."
  13159. msgstr ""
  13160. #. type: defvr
  13161. #: guix-git/doc/guix.texi:8174
  13162. #, no-wrap
  13163. msgid "{Scheme Variable} dub-build-system"
  13164. msgstr ""
  13165. #. type: defvr
  13166. #: guix-git/doc/guix.texi:8179
  13167. msgid "This variable is exported by @code{(guix build-system dub)}. It implements the Dub build procedure used by D packages, which involves running @code{dub build} and @code{dub run}. Installation is done by copying the files manually."
  13168. msgstr ""
  13169. #. type: defvr
  13170. #: guix-git/doc/guix.texi:8182
  13171. msgid "Which D compiler is used can be specified with the @code{#:ldc} parameter which defaults to @code{ldc}."
  13172. msgstr ""
  13173. #. type: anchor{#1}
  13174. #: guix-git/doc/guix.texi:8185
  13175. msgid "emacs-build-system"
  13176. msgstr ""
  13177. #. type: defvr
  13178. #: guix-git/doc/guix.texi:8185
  13179. #, no-wrap
  13180. msgid "{Scheme Variable} emacs-build-system"
  13181. msgstr ""
  13182. #. type: defvr
  13183. #: guix-git/doc/guix.texi:8189
  13184. msgid "This variable is exported by @code{(guix build-system emacs)}. It implements an installation procedure similar to the packaging system of Emacs itself (@pxref{Packages,,, emacs, The GNU Emacs Manual})."
  13185. msgstr ""
  13186. #. type: defvr
  13187. #: guix-git/doc/guix.texi:8195
  13188. msgid "It first creates the @code{@code{package}-autoloads.el} file, then it byte compiles all Emacs Lisp files. Differently from the Emacs packaging system, the Info documentation files are moved to the standard documentation directory and the @file{dir} file is deleted. The Elisp package files are installed directly under @file{share/emacs/site-lisp}."
  13189. msgstr ""
  13190. #. type: defvr
  13191. #: guix-git/doc/guix.texi:8197
  13192. #, no-wrap
  13193. msgid "{Scheme Variable} font-build-system"
  13194. msgstr ""
  13195. #. type: defvr
  13196. #: guix-git/doc/guix.texi:8203
  13197. msgid "This variable is exported by @code{(guix build-system font)}. It implements an installation procedure for font packages where upstream provides pre-compiled TrueType, OpenType, etc.@: font files that merely need to be copied into place. It copies font files to standard locations in the output directory."
  13198. msgstr ""
  13199. #. type: defvr
  13200. #: guix-git/doc/guix.texi:8205
  13201. #, no-wrap
  13202. msgid "{Scheme Variable} meson-build-system"
  13203. msgstr ""
  13204. #. type: defvr
  13205. #: guix-git/doc/guix.texi:8209
  13206. msgid "This variable is exported by @code{(guix build-system meson)}. It implements the build procedure for packages that use @url{https://mesonbuild.com, Meson} as their build system."
  13207. msgstr ""
  13208. #. type: defvr
  13209. #: guix-git/doc/guix.texi:8215
  13210. msgid "It adds both Meson and @uref{https://ninja-build.org/, Ninja} to the set of inputs, and they can be changed with the parameters @code{#:meson} and @code{#:ninja} if needed. The default Meson is @code{meson-for-build}, which is special because it doesn't clear the @code{RUNPATH} of binaries and libraries when they are installed."
  13211. msgstr ""
  13212. #. type: defvr
  13213. #: guix-git/doc/guix.texi:8218
  13214. msgid "This build system is an extension of @code{gnu-build-system}, but with the following phases changed to some specific for Meson:"
  13215. msgstr ""
  13216. #. type: item
  13217. #: guix-git/doc/guix.texi:8221 guix-git/doc/guix.texi:8270
  13218. #: guix-git/doc/guix.texi:8338
  13219. #, no-wrap
  13220. msgid "configure"
  13221. msgstr ""
  13222. #. type: table
  13223. #: guix-git/doc/guix.texi:8226
  13224. msgid "The phase runs @code{meson} with the flags specified in @code{#:configure-flags}. The flag @option{--buildtype} is always set to @code{debugoptimized} unless something else is specified in @code{#:build-type}."
  13225. msgstr ""
  13226. #. type: table
  13227. #: guix-git/doc/guix.texi:8230
  13228. msgid "The phase runs @code{ninja} to build the package in parallel by default, but this can be changed with @code{#:parallel-build?}."
  13229. msgstr ""
  13230. #. type: table
  13231. #: guix-git/doc/guix.texi:8234
  13232. msgid "The phase runs @code{ninja} with the target specified in @code{#:test-target}, which is @code{\"test\"} by default."
  13233. msgstr ""
  13234. #. type: table
  13235. #: guix-git/doc/guix.texi:8237
  13236. msgid "The phase runs @code{ninja install} and can not be changed."
  13237. msgstr ""
  13238. #. type: defvr
  13239. #: guix-git/doc/guix.texi:8240
  13240. msgid "Apart from that, the build system also adds the following phases:"
  13241. msgstr ""
  13242. #. type: item
  13243. #: guix-git/doc/guix.texi:8243
  13244. #, no-wrap
  13245. msgid "fix-runpath"
  13246. msgstr ""
  13247. #. type: table
  13248. #: guix-git/doc/guix.texi:8250
  13249. msgid "This phase ensures that all binaries can find the libraries they need. It searches for required libraries in subdirectories of the package being built, and adds those to @code{RUNPATH} where needed. It also removes references to libraries left over from the build phase by @code{meson-for-build}, such as test dependencies, that aren't actually required for the program to run."
  13250. msgstr ""
  13251. #. type: table
  13252. #: guix-git/doc/guix.texi:8254 guix-git/doc/guix.texi:8258
  13253. msgid "This phase is the phase provided by @code{glib-or-gtk-build-system}, and it is not enabled by default. It can be enabled with @code{#:glib-or-gtk?}."
  13254. msgstr ""
  13255. #. type: defvr
  13256. #: guix-git/doc/guix.texi:8261
  13257. #, no-wrap
  13258. msgid "{Scheme Variable} linux-module-build-system"
  13259. msgstr ""
  13260. #. type: defvr
  13261. #: guix-git/doc/guix.texi:8263
  13262. msgid "@code{linux-module-build-system} allows building Linux kernel modules."
  13263. msgstr ""
  13264. #. type: defvr
  13265. #: guix-git/doc/guix.texi:8267
  13266. msgid "This build system is an extension of @code{gnu-build-system}, but with the following phases changed:"
  13267. msgstr ""
  13268. #. type: table
  13269. #: guix-git/doc/guix.texi:8273
  13270. msgid "This phase configures the environment so that the Linux kernel's Makefile can be used to build the external kernel module."
  13271. msgstr ""
  13272. #. type: table
  13273. #: guix-git/doc/guix.texi:8277
  13274. msgid "This phase uses the Linux kernel's Makefile in order to build the external kernel module."
  13275. msgstr ""
  13276. #. type: table
  13277. #: guix-git/doc/guix.texi:8281
  13278. msgid "This phase uses the Linux kernel's Makefile in order to install the external kernel module."
  13279. msgstr ""
  13280. #. type: defvr
  13281. #: guix-git/doc/guix.texi:8286
  13282. msgid "It is possible and useful to specify the Linux kernel to use for building the module (in the @code{arguments} form of a package using the @code{linux-module-build-system}, use the key @code{#:linux} to specify it)."
  13283. msgstr ""
  13284. #. type: defvr
  13285. #: guix-git/doc/guix.texi:8288
  13286. #, no-wrap
  13287. msgid "{Scheme Variable} node-build-system"
  13288. msgstr ""
  13289. #. type: defvr
  13290. #: guix-git/doc/guix.texi:8293
  13291. msgid "This variable is exported by @code{(guix build-system node)}. It implements the build procedure used by @uref{https://nodejs.org, Node.js}, which implements an approximation of the @code{npm install} command, followed by an @code{npm test} command."
  13292. msgstr ""
  13293. #. type: defvr
  13294. #: guix-git/doc/guix.texi:8297
  13295. msgid "Which Node.js package is used to interpret the @code{npm} commands can be specified with the @code{#:node} parameter which defaults to @code{node}."
  13296. msgstr ""
  13297. #. type: Plain text
  13298. #: guix-git/doc/guix.texi:8303
  13299. msgid "Lastly, for packages that do not need anything as sophisticated, a ``trivial'' build system is provided. It is trivial in the sense that it provides basically no support: it does not pull any implicit inputs, and does not have a notion of build phases."
  13300. msgstr ""
  13301. #. type: defvr
  13302. #: guix-git/doc/guix.texi:8304
  13303. #, no-wrap
  13304. msgid "{Scheme Variable} trivial-build-system"
  13305. msgstr ""
  13306. #. type: defvr
  13307. #: guix-git/doc/guix.texi:8306
  13308. msgid "This variable is exported by @code{(guix build-system trivial)}."
  13309. msgstr ""
  13310. #. type: defvr
  13311. #: guix-git/doc/guix.texi:8311
  13312. msgid "This build system requires a @code{#:builder} argument. This argument must be a Scheme expression that builds the package output(s)---as with @code{build-expression->derivation} (@pxref{Derivations, @code{build-expression->derivation}})."
  13313. msgstr ""
  13314. #. type: cindex
  13315. #: guix-git/doc/guix.texi:8316
  13316. #, no-wrap
  13317. msgid "build phases, for packages"
  13318. msgstr ""
  13319. #. type: Plain text
  13320. #: guix-git/doc/guix.texi:8322
  13321. msgid "Almost all package build systems implement a notion @dfn{build phases}: a sequence of actions that the build system executes, when you build the package, leading to the installed byproducts in the store. A notable exception is the ``bare-bones'' @code{trivial-build-system} (@pxref{Build Systems})."
  13322. msgstr ""
  13323. #. type: Plain text
  13324. #: guix-git/doc/guix.texi:8326
  13325. msgid "As discussed in the previous section, those build systems provide a standard list of phases. For @code{gnu-build-system}, the main build phases are the following:"
  13326. msgstr ""
  13327. #. type: item
  13328. #: guix-git/doc/guix.texi:8328
  13329. #, no-wrap
  13330. msgid "unpack"
  13331. msgstr ""
  13332. #. type: table
  13333. #: guix-git/doc/guix.texi:8332
  13334. msgid "Unpack the source tarball, and change the current directory to the extracted source tree. If the source is actually a directory, copy it to the build tree, and enter that directory."
  13335. msgstr ""
  13336. #. type: item
  13337. #: guix-git/doc/guix.texi:8333
  13338. #, no-wrap
  13339. msgid "patch-source-shebangs"
  13340. msgstr ""
  13341. #. type: table
  13342. #: guix-git/doc/guix.texi:8337
  13343. msgid "Patch shebangs encountered in source files so they refer to the right store file names. For instance, this changes @code{#!/bin/sh} to @code{#!/gnu/store/@dots{}-bash-4.3/bin/sh}."
  13344. msgstr ""
  13345. #. type: table
  13346. #: guix-git/doc/guix.texi:8342
  13347. msgid "Run the @file{configure} script with a number of default options, such as @option{--prefix=/gnu/store/@dots{}}, as well as the options specified by the @code{#:configure-flags} argument."
  13348. msgstr ""
  13349. #. type: table
  13350. #: guix-git/doc/guix.texi:8347
  13351. msgid "Run @code{make} with the list of flags specified with @code{#:make-flags}. If the @code{#:parallel-build?} argument is true (the default), build with @code{make -j}."
  13352. msgstr ""
  13353. #. type: table
  13354. #: guix-git/doc/guix.texi:8353
  13355. msgid "Run @code{make check}, or some other target specified with @code{#:test-target}, unless @code{#:tests? #f} is passed. If the @code{#:parallel-tests?} argument is true (the default), run @code{make check -j}."
  13356. msgstr ""
  13357. #. type: table
  13358. #: guix-git/doc/guix.texi:8356
  13359. msgid "Run @code{make install} with the flags listed in @code{#:make-flags}."
  13360. msgstr ""
  13361. #. type: item
  13362. #: guix-git/doc/guix.texi:8357
  13363. #, no-wrap
  13364. msgid "patch-shebangs"
  13365. msgstr ""
  13366. #. type: table
  13367. #: guix-git/doc/guix.texi:8359
  13368. msgid "Patch shebangs on the installed executable files."
  13369. msgstr ""
  13370. #. type: item
  13371. #: guix-git/doc/guix.texi:8360
  13372. #, no-wrap
  13373. msgid "strip"
  13374. msgstr ""
  13375. #. type: table
  13376. #: guix-git/doc/guix.texi:8364
  13377. msgid "Strip debugging symbols from ELF files (unless @code{#:strip-binaries?} is false), copying them to the @code{debug} output when available (@pxref{Installing Debugging Files})."
  13378. msgstr ""
  13379. #. type: Plain text
  13380. #: guix-git/doc/guix.texi:8373
  13381. msgid "Other build systems have similar phases, with some variations. For example, @code{cmake-build-system} has same-named phases but its @code{configure} phases runs @code{cmake} instead of @code{./configure}. Others, such as @code{python-build-system}, have a wholly different list of standard phases. All this code runs on the @dfn{build side}: it is evaluated when you actually build the package, in a dedicated build process spawned by the build daemon (@pxref{Invoking guix-daemon})."
  13382. msgstr ""
  13383. #. type: Plain text
  13384. #: guix-git/doc/guix.texi:8380
  13385. msgid "Build phases are represented as association lists or ``alists'' (@pxref{Association Lists,,, guile, GNU Guile Reference Manual}) where each key is a symbol for the name of the phase and the associated value is a procedure that accepts an arbitrary number of arguments. By convention, those procedures receive information about the build in the form of @dfn{keyword parameters}, which they can use or ignore."
  13386. msgstr ""
  13387. #. type: vindex
  13388. #: guix-git/doc/guix.texi:8381
  13389. #, no-wrap
  13390. msgid "%standard-phases"
  13391. msgstr ""
  13392. #. type: Plain text
  13393. #: guix-git/doc/guix.texi:8387
  13394. msgid "For example, here is how @code{(guix build gnu-build-system)} defines @code{%standard-phases}, the variable holding its alist of build phases@footnote{We present a simplified view of those build phases, but do take a look at @code{(guix build gnu-build-system)} to see all the details!}:"
  13395. msgstr ""
  13396. #. type: lisp
  13397. #: guix-git/doc/guix.texi:8390
  13398. #, no-wrap
  13399. msgid ""
  13400. ";; The build phases of 'gnu-build-system'.\n"
  13401. "\n"
  13402. msgstr ""
  13403. #. type: lisp
  13404. #: guix-git/doc/guix.texi:8394
  13405. #, no-wrap
  13406. msgid ""
  13407. "(define* (unpack #:key source #:allow-other-keys)\n"
  13408. " ;; Extract the source tarball.\n"
  13409. " (invoke \"tar\" \"xvf\" source))\n"
  13410. "\n"
  13411. msgstr ""
  13412. #. type: lisp
  13413. #: guix-git/doc/guix.texi:8400
  13414. #, no-wrap
  13415. msgid ""
  13416. "(define* (configure #:key outputs #:allow-other-keys)\n"
  13417. " ;; Run the 'configure' script. Install to output \"out\".\n"
  13418. " (let ((out (assoc-ref outputs \"out\")))\n"
  13419. " (invoke \"./configure\"\n"
  13420. " (string-append \"--prefix=\" out))))\n"
  13421. "\n"
  13422. msgstr ""
  13423. #. type: lisp
  13424. #: guix-git/doc/guix.texi:8404
  13425. #, no-wrap
  13426. msgid ""
  13427. "(define* (build #:allow-other-keys)\n"
  13428. " ;; Compile.\n"
  13429. " (invoke \"make\"))\n"
  13430. "\n"
  13431. msgstr ""
  13432. #. type: lisp
  13433. #: guix-git/doc/guix.texi:8411
  13434. #, no-wrap
  13435. msgid ""
  13436. "(define* (check #:key (test-target \"check\") (tests? #true)\n"
  13437. " #:allow-other-keys)\n"
  13438. " ;; Run the test suite.\n"
  13439. " (if tests?\n"
  13440. " (invoke \"make\" test-target)\n"
  13441. " (display \"test suite not run\\n\")))\n"
  13442. "\n"
  13443. msgstr ""
  13444. #. type: lisp
  13445. #: guix-git/doc/guix.texi:8415
  13446. #, no-wrap
  13447. msgid ""
  13448. "(define* (install #:allow-other-keys)\n"
  13449. " ;; Install files to the prefix 'configure' specified.\n"
  13450. " (invoke \"make\" \"install\"))\n"
  13451. "\n"
  13452. msgstr ""
  13453. #. type: lisp
  13454. #: guix-git/doc/guix.texi:8424
  13455. #, no-wrap
  13456. msgid ""
  13457. "(define %standard-phases\n"
  13458. " ;; The list of standard phases (quite a few are omitted\n"
  13459. " ;; for brevity). Each element is a symbol/procedure pair.\n"
  13460. " (list (cons 'unpack unpack)\n"
  13461. " (cons 'configure configure)\n"
  13462. " (cons 'build build)\n"
  13463. " (cons 'check check)\n"
  13464. " (cons 'install install)))\n"
  13465. msgstr ""
  13466. #. type: Plain text
  13467. #: guix-git/doc/guix.texi:8434
  13468. msgid "This shows how @code{%standard-phases} is defined as a list of symbol/procedure pairs (@pxref{Pairs,,, guile, GNU Guile Reference Manual}). The first pair associates the @code{unpack} procedure with the @code{unpack} symbol---a name; the second pair defines the @code{configure} phase similarly, and so on. When building a package that uses @code{gnu-build-system} with its default list of phases, those phases are executed sequentially. You can see the name of each phase started and completed in the build log of packages that you build."
  13469. msgstr ""
  13470. #. type: Plain text
  13471. #: guix-git/doc/guix.texi:8440
  13472. msgid "Let's now look at the procedures themselves. Each one is defined with @code{define*}: @code{#:key} lists keyword parameters the procedure accepts, possibly with a default value, and @code{#:allow-other-keys} specifies that other keyword parameters are ignored (@pxref{Optional Arguments,,, guile, GNU Guile Reference Manual})."
  13473. msgstr ""
  13474. #. type: Plain text
  13475. #: guix-git/doc/guix.texi:8456
  13476. msgid "The @code{unpack} procedure honors the @code{source} parameter, which the build system uses to pass the file name of the source tarball (or version control checkout), and it ignores other parameters. The @code{configure} phase only cares about the @code{outputs} parameter, an alist mapping package output names to their store file name (@pxref{Packages with Multiple Outputs}). It extracts the file name of for @code{out}, the default output, and passes it to @command{./configure} as the installation prefix, meaning that @command{make install} will eventually copy all the files in that directory (@pxref{Configuration, configuration and makefile conventions,, standards, GNU Coding Standards}). @code{build} and @code{install} ignore all their arguments. @code{check} honors the @code{test-target} argument, which specifies the name of the Makefile target to run tests; it prints a message and skips tests when @code{tests?} is false."
  13477. msgstr ""
  13478. #. type: cindex
  13479. #: guix-git/doc/guix.texi:8457
  13480. #, no-wrap
  13481. msgid "build phases, customizing"
  13482. msgstr ""
  13483. #. type: Plain text
  13484. #: guix-git/doc/guix.texi:8466
  13485. msgid "The list of phases used for a particular package can be changed with the @code{#:phases} parameter of the build system. Changing the set of build phases boils down to building a new alist of phases based on the @code{%standard-phases} alist described above. This can be done with standard alist procedures such as @code{alist-delete} (@pxref{SRFI-1 Association Lists,,, guile, GNU Guile Reference Manual}); however, it is more convenient to do so with @code{modify-phases} (@pxref{Build Utilities, @code{modify-phases}})."
  13486. msgstr ""
  13487. #. type: Plain text
  13488. #: guix-git/doc/guix.texi:8471
  13489. msgid "Here is an example of a package definition that removes the @code{configure} phase of @code{%standard-phases} and inserts a new phase before the @code{build} phase, called @code{set-prefix-in-makefile}:"
  13490. msgstr ""
  13491. #. type: lisp
  13492. #: guix-git/doc/guix.texi:8491
  13493. #, no-wrap
  13494. msgid ""
  13495. "(define-public example\n"
  13496. " (package\n"
  13497. " (name \"example\")\n"
  13498. " ;; other fields omitted\n"
  13499. " (build-system gnu-build-system)\n"
  13500. " (arguments\n"
  13501. " '(#:phases (modify-phases %standard-phases\n"
  13502. " (delete 'configure)\n"
  13503. " (add-before 'build 'set-prefix-in-makefile\n"
  13504. " (lambda* (#:key outputs #:allow-other-keys)\n"
  13505. " ;; Modify the makefile so that its\n"
  13506. " ;; 'PREFIX' variable points to \"out\".\n"
  13507. " (let ((out (assoc-ref outputs \"out\")))\n"
  13508. " (substitute* \"Makefile\"\n"
  13509. " ((\"PREFIX =.*\")\n"
  13510. " (string-append \"PREFIX = \"\n"
  13511. " out \"\\n\")))\n"
  13512. " #true))))))))\n"
  13513. msgstr ""
  13514. #. type: Plain text
  13515. #: guix-git/doc/guix.texi:8497
  13516. msgid "The new phase that is inserted is written as an anonymous procedure, introduced with @code{lambda*}; it honors the @code{outputs} parameter we have seen before. @xref{Build Utilities}, for more about the helpers used by this phase, and for more examples of @code{modify-phases}."
  13517. msgstr ""
  13518. #. type: cindex
  13519. #: guix-git/doc/guix.texi:8498 guix-git/doc/guix.texi:9471
  13520. #, no-wrap
  13521. msgid "code staging"
  13522. msgstr ""
  13523. #. type: cindex
  13524. #: guix-git/doc/guix.texi:8499 guix-git/doc/guix.texi:9472
  13525. #, no-wrap
  13526. msgid "staging, of code"
  13527. msgstr ""
  13528. #. type: Plain text
  13529. #: guix-git/doc/guix.texi:8506
  13530. msgid "Keep in mind that build phases are code evaluated at the time the package is actually built. This explains why the whole @code{modify-phases} expression above is quoted (it comes after the @code{'} or apostrophe): it is @dfn{staged} for later execution. @xref{G-Expressions}, for an explanation of code staging and the @dfn{code strata} involved."
  13531. msgstr ""
  13532. #. type: Plain text
  13533. #: guix-git/doc/guix.texi:8516
  13534. msgid "As soon as you start writing non-trivial package definitions (@pxref{Defining Packages}) or other build actions (@pxref{G-Expressions}), you will likely start looking for helpers for ``shell-like'' actions---creating directories, copying and deleting files recursively, manipulating build phases, and so on. The @code{(guix build utils)} module provides such utility procedures."
  13535. msgstr ""
  13536. #. type: Plain text
  13537. #: guix-git/doc/guix.texi:8520
  13538. msgid "Most build systems load @code{(guix build utils)} (@pxref{Build Systems}). Thus, when writing custom build phases for your package definitions, you can usually assume those procedures are in scope."
  13539. msgstr ""
  13540. #. type: Plain text
  13541. #: guix-git/doc/guix.texi:8525
  13542. msgid "When writing G-expressions, you can import @code{(guix build utils)} on the ``build side'' using @code{with-imported-modules} and then put it in scope with the @code{use-modules} form (@pxref{Using Guile Modules,,, guile, GNU Guile Reference Manual}):"
  13543. msgstr ""
  13544. #. type: lisp
  13545. #: guix-git/doc/guix.texi:8532
  13546. #, no-wrap
  13547. msgid ""
  13548. "(with-imported-modules '((guix build utils)) ;import it\n"
  13549. " (computed-file \"empty-tree\"\n"
  13550. " #~(begin\n"
  13551. " ;; Put it in scope.\n"
  13552. " (use-modules (guix build utils))\n"
  13553. "\n"
  13554. msgstr ""
  13555. #. type: lisp
  13556. #: guix-git/doc/guix.texi:8535
  13557. #, no-wrap
  13558. msgid ""
  13559. " ;; Happily use its 'mkdir-p' procedure.\n"
  13560. " (mkdir-p (string-append #$output \"/a/b/c\")))))\n"
  13561. msgstr ""
  13562. #. type: Plain text
  13563. #: guix-git/doc/guix.texi:8539
  13564. msgid "The remainder of this section is the reference for most of the utility procedures provided by @code{(guix build utils)}."
  13565. msgstr ""
  13566. #. type: subsection
  13567. #: guix-git/doc/guix.texi:8542
  13568. #, no-wrap
  13569. msgid "Dealing with Store File Names"
  13570. msgstr ""
  13571. #. type: Plain text
  13572. #: guix-git/doc/guix.texi:8545
  13573. msgid "This section documents procedures that deal with store file names."
  13574. msgstr ""
  13575. #. type: deffn
  13576. #: guix-git/doc/guix.texi:8546
  13577. #, no-wrap
  13578. msgid "{Scheme Procedure} %store-directory"
  13579. msgstr ""
  13580. #. type: deffn
  13581. #: guix-git/doc/guix.texi:8548
  13582. msgid "Return the directory name of the store."
  13583. msgstr ""
  13584. #. type: deffn
  13585. #: guix-git/doc/guix.texi:8550
  13586. #, no-wrap
  13587. msgid "{Scheme Procedure} store-file-name? @var{file}"
  13588. msgstr ""
  13589. #. type: deffn
  13590. #: guix-git/doc/guix.texi:8552
  13591. msgid "Return true if @var{file} is in the store."
  13592. msgstr ""
  13593. #. type: deffn
  13594. #: guix-git/doc/guix.texi:8554
  13595. #, no-wrap
  13596. msgid "{Scheme Procedure} strip-store-file-name @var{file}"
  13597. msgstr ""
  13598. #. type: deffn
  13599. #: guix-git/doc/guix.texi:8557
  13600. msgid "Strip the @file{/gnu/store} and hash from @var{file}, a store file name. The result is typically a @code{\"@var{package}-@var{version}\"} string."
  13601. msgstr ""
  13602. #. type: deffn
  13603. #: guix-git/doc/guix.texi:8559
  13604. #, no-wrap
  13605. msgid "{Scheme Procedure} package-name->name+version @var{name}"
  13606. msgstr ""
  13607. #. type: deffn
  13608. #: guix-git/doc/guix.texi:8564
  13609. msgid "Given @var{name}, a package name like @code{\"foo-0.9.1b\"}, return two values: @code{\"foo\"} and @code{\"0.9.1b\"}. When the version part is unavailable, @var{name} and @code{#f} are returned. The first hyphen followed by a digit is considered to introduce the version part."
  13610. msgstr ""
  13611. #. type: subsection
  13612. #: guix-git/doc/guix.texi:8566
  13613. #, no-wrap
  13614. msgid "File Types"
  13615. msgstr ""
  13616. #. type: Plain text
  13617. #: guix-git/doc/guix.texi:8569
  13618. msgid "The procedures below deal with files and file types."
  13619. msgstr ""
  13620. #. type: deffn
  13621. #: guix-git/doc/guix.texi:8570
  13622. #, no-wrap
  13623. msgid "{Scheme Procedure} directory-exists? @var{dir}"
  13624. msgstr ""
  13625. #. type: deffn
  13626. #: guix-git/doc/guix.texi:8572
  13627. msgid "Return @code{#t} if @var{dir} exists and is a directory."
  13628. msgstr ""
  13629. #. type: deffn
  13630. #: guix-git/doc/guix.texi:8574
  13631. #, no-wrap
  13632. msgid "{Scheme Procedure} executable-file? @var{file}"
  13633. msgstr ""
  13634. #. type: deffn
  13635. #: guix-git/doc/guix.texi:8576
  13636. msgid "Return @code{#t} if @var{file} exists and is executable."
  13637. msgstr ""
  13638. #. type: deffn
  13639. #: guix-git/doc/guix.texi:8578
  13640. #, no-wrap
  13641. msgid "{Scheme Procedure} symbolic-link? @var{file}"
  13642. msgstr ""
  13643. #. type: deffn
  13644. #: guix-git/doc/guix.texi:8580
  13645. msgid "Return @code{#t} if @var{file} is a symbolic link (aka. a ``symlink'')."
  13646. msgstr ""
  13647. #. type: deffn
  13648. #: guix-git/doc/guix.texi:8582
  13649. #, no-wrap
  13650. msgid "{Scheme Procedure} elf-file? @var{file}"
  13651. msgstr ""
  13652. #. type: deffnx
  13653. #: guix-git/doc/guix.texi:8583
  13654. #, no-wrap
  13655. msgid "{Scheme Procedure} ar-file? @var{file}"
  13656. msgstr ""
  13657. #. type: deffnx
  13658. #: guix-git/doc/guix.texi:8584
  13659. #, no-wrap
  13660. msgid "{Scheme Procedure} gzip-file? @var{file}"
  13661. msgstr ""
  13662. #. type: deffn
  13663. #: guix-git/doc/guix.texi:8587
  13664. msgid "Return @code{#t} if @var{file} is, respectively, an ELF file, an @code{ar} archive (such as a @file{.a} static library), or a gzip file."
  13665. msgstr ""
  13666. #. type: deffn
  13667. #: guix-git/doc/guix.texi:8589
  13668. #, no-wrap
  13669. msgid "{Scheme Procedure} reset-gzip-timestamp @var{file} [#:keep-mtime? #t]"
  13670. msgstr ""
  13671. #. type: deffn
  13672. #: guix-git/doc/guix.texi:8593
  13673. msgid "If @var{file} is a gzip file, reset its embedded timestamp (as with @command{gzip --no-name}) and return true. Otherwise return @code{#f}. When @var{keep-mtime?} is true, preserve @var{file}'s modification time."
  13674. msgstr ""
  13675. #. type: subsection
  13676. #: guix-git/doc/guix.texi:8595
  13677. #, no-wrap
  13678. msgid "File Manipulation"
  13679. msgstr ""
  13680. #. type: Plain text
  13681. #: guix-git/doc/guix.texi:8602
  13682. msgid "The following procedures and macros help create, modify, and delete files. They provide functionality comparable to common shell utilities such as @command{mkdir -p}, @command{cp -r}, @command{rm -r}, and @command{sed}. They complement Guile's extensive, but low-level, file system interface (@pxref{POSIX,,, guile, GNU Guile Reference Manual})."
  13683. msgstr ""
  13684. #. type: deffn
  13685. #: guix-git/doc/guix.texi:8603
  13686. #, no-wrap
  13687. msgid "{Scheme Syntax} with-directory-excursion @var{directory} @var{body}@dots{}"
  13688. msgstr ""
  13689. #. type: deffn
  13690. #: guix-git/doc/guix.texi:8605
  13691. msgid "Run @var{body} with @var{directory} as the process's current directory."
  13692. msgstr ""
  13693. #. type: deffn
  13694. #: guix-git/doc/guix.texi:8612
  13695. msgid "Essentially, this macro changes the current directory to @var{directory} before evaluating @var{body}, using @code{chdir} (@pxref{Processes,,, guile, GNU Guile Reference Manual}). It changes back to the initial directory when the dynamic extent of @var{body} is left, be it @i{via} normal procedure return or @i{via} a non-local exit such as an exception."
  13696. msgstr ""
  13697. #. type: deffn
  13698. #: guix-git/doc/guix.texi:8614
  13699. #, no-wrap
  13700. msgid "{Scheme Procedure} mkdir-p @var{dir}"
  13701. msgstr ""
  13702. #. type: deffn
  13703. #: guix-git/doc/guix.texi:8616
  13704. msgid "Create directory @var{dir} and all its ancestors."
  13705. msgstr ""
  13706. #. type: deffn
  13707. #: guix-git/doc/guix.texi:8618
  13708. #, no-wrap
  13709. msgid "{Scheme Procedure} install-file @var{file} @var{directory}"
  13710. msgstr ""
  13711. #. type: deffn
  13712. #: guix-git/doc/guix.texi:8621
  13713. msgid "Create @var{directory} if it does not exist and copy @var{file} in there under the same name."
  13714. msgstr ""
  13715. #. type: deffn
  13716. #: guix-git/doc/guix.texi:8623
  13717. #, no-wrap
  13718. msgid "{Scheme Procedure} make-file-writable @var{file}"
  13719. msgstr ""
  13720. #. type: deffn
  13721. #: guix-git/doc/guix.texi:8625
  13722. msgid "Make @var{file} writable for its owner."
  13723. msgstr ""
  13724. #. type: deffn
  13725. #: guix-git/doc/guix.texi:8627
  13726. #, no-wrap
  13727. msgid "{Scheme Procedure} copy-recursively @var{source} @var{destination} @"
  13728. msgstr ""
  13729. #. type: deffn
  13730. #: guix-git/doc/guix.texi:8634
  13731. msgid "[#:log (current-output-port)] [#:follow-symlinks? #f] [#:keep-mtime? #f] Copy @var{source} directory to @var{destination}. Follow symlinks if @var{follow-symlinks?} is true; otherwise, just preserve them. When @var{keep-mtime?} is true, keep the modification time of the files in @var{source} on those of @var{destination}. Write verbose output to the @var{log} port."
  13732. msgstr ""
  13733. #. type: deffn
  13734. #: guix-git/doc/guix.texi:8636
  13735. #, no-wrap
  13736. msgid "{Scheme Procedure} delete-file-recursively @var{dir} @"
  13737. msgstr ""
  13738. #. type: deffn
  13739. #: guix-git/doc/guix.texi:8641
  13740. msgid "[#:follow-mounts? #f] Delete @var{dir} recursively, like @command{rm -rf}, without following symlinks. Don't follow mount points either, unless @var{follow-mounts?} is true. Report but ignore errors."
  13741. msgstr ""
  13742. #. type: deffn
  13743. #: guix-git/doc/guix.texi:8643
  13744. #, no-wrap
  13745. msgid "{Scheme Syntax} substitute* @var{file} @"
  13746. msgstr ""
  13747. #. type: deffn
  13748. #: guix-git/doc/guix.texi:8648
  13749. msgid "((@var{regexp} @var{match-var}@dots{}) @var{body}@dots{}) @dots{} Substitute @var{regexp} in @var{file} by the string returned by @var{body}. @var{body} is evaluated with each @var{match-var} bound to the corresponding positional regexp sub-expression. For example:"
  13750. msgstr ""
  13751. #. type: lisp
  13752. #: guix-git/doc/guix.texi:8655
  13753. #, no-wrap
  13754. msgid ""
  13755. "(substitute* file\n"
  13756. " ((\"hello\")\n"
  13757. " \"good morning\\n\")\n"
  13758. " ((\"foo([a-z]+)bar(.*)$\" all letters end)\n"
  13759. " (string-append \"baz\" letter end)))\n"
  13760. msgstr ""
  13761. #. type: deffn
  13762. #: guix-git/doc/guix.texi:8661
  13763. msgid "Here, anytime a line of @var{file} contains @code{hello}, it is replaced by @code{good morning}. Anytime a line of @var{file} matches the second regexp, @code{all} is bound to the complete match, @code{letters} is bound to the first sub-expression, and @code{end} is bound to the last one."
  13764. msgstr ""
  13765. #. type: deffn
  13766. #: guix-git/doc/guix.texi:8664
  13767. msgid "When one of the @var{match-var} is @code{_}, no variable is bound to the corresponding match substring."
  13768. msgstr ""
  13769. #. type: deffn
  13770. #: guix-git/doc/guix.texi:8667
  13771. msgid "Alternatively, @var{file} may be a list of file names, in which case they are all subject to the substitutions."
  13772. msgstr ""
  13773. #. type: deffn
  13774. #: guix-git/doc/guix.texi:8670
  13775. msgid "Be careful about using @code{$} to match the end of a line; by itself it won't match the terminating newline of a line."
  13776. msgstr ""
  13777. #. type: subsection
  13778. #: guix-git/doc/guix.texi:8672
  13779. #, no-wrap
  13780. msgid "File Search"
  13781. msgstr ""
  13782. #. type: cindex
  13783. #: guix-git/doc/guix.texi:8674
  13784. #, no-wrap
  13785. msgid "file, searching"
  13786. msgstr ""
  13787. #. type: Plain text
  13788. #: guix-git/doc/guix.texi:8676
  13789. msgid "This section documents procedures to search and filter files."
  13790. msgstr ""
  13791. #. type: deffn
  13792. #: guix-git/doc/guix.texi:8677
  13793. #, no-wrap
  13794. msgid "{Scheme Procedure} file-name-predicate @var{regexp}"
  13795. msgstr ""
  13796. #. type: deffn
  13797. #: guix-git/doc/guix.texi:8680
  13798. msgid "Return a predicate that returns true when passed a file name whose base name matches @var{regexp}."
  13799. msgstr ""
  13800. #. type: deffn
  13801. #: guix-git/doc/guix.texi:8682
  13802. #, no-wrap
  13803. msgid "{Scheme Procedure} find-files @var{dir} [@var{pred}] @"
  13804. msgstr ""
  13805. #. type: deffn
  13806. #: guix-git/doc/guix.texi:8693
  13807. msgid "[#:stat lstat] [#:directories? #f] [#:fail-on-error? #f] Return the lexicographically sorted list of files under @var{dir} for which @var{pred} returns true. @var{pred} is passed two arguments: the absolute file name, and its stat buffer; the default predicate always returns true. @var{pred} can also be a regular expression, in which case it is equivalent to @code{(file-name-predicate @var{pred})}. @var{stat} is used to obtain file information; using @code{lstat} means that symlinks are not followed. If @var{directories?} is true, then directories will also be included. If @var{fail-on-error?} is true, raise an exception upon error."
  13808. msgstr ""
  13809. #. type: Plain text
  13810. #: guix-git/doc/guix.texi:8697
  13811. msgid "Here are a few examples where we assume that the current directory is the root of the Guix source tree:"
  13812. msgstr ""
  13813. #. type: lisp
  13814. #: guix-git/doc/guix.texi:8702
  13815. #, no-wrap
  13816. msgid ""
  13817. ";; List all the regular files in the current directory.\n"
  13818. "(find-files \".\")\n"
  13819. "@result{} (\"./.dir-locals.el\" \"./.gitignore\" @dots{})\n"
  13820. "\n"
  13821. msgstr ""
  13822. #. type: lisp
  13823. #: guix-git/doc/guix.texi:8706
  13824. #, no-wrap
  13825. msgid ""
  13826. ";; List all the .scm files under gnu/services.\n"
  13827. "(find-files \"gnu/services\" \"\\\\.scm$\")\n"
  13828. "@result{} (\"gnu/services/admin.scm\" \"gnu/services/audio.scm\" @dots{})\n"
  13829. "\n"
  13830. msgstr ""
  13831. #. type: lisp
  13832. #: guix-git/doc/guix.texi:8710
  13833. #, no-wrap
  13834. msgid ""
  13835. ";; List ar files in the current directory.\n"
  13836. "(find-files \".\" (lambda (file stat) (ar-file? file)))\n"
  13837. "@result{} (\"./libformat.a\" \"./libstore.a\" @dots{})\n"
  13838. msgstr ""
  13839. #. type: deffn
  13840. #: guix-git/doc/guix.texi:8712
  13841. #, no-wrap
  13842. msgid "{Scheme Procedure} which @var{program}"
  13843. msgstr ""
  13844. #. type: deffn
  13845. #: guix-git/doc/guix.texi:8715
  13846. msgid "Return the complete file name for @var{program} as found in @code{$PATH}, or @code{#f} if @var{program} could not be found."
  13847. msgstr ""
  13848. #. type: Plain text
  13849. #: guix-git/doc/guix.texi:8726
  13850. msgid "The @code{(guix build utils)} also contains tools to manipulate build phases as used by build systems (@pxref{Build Systems}). Build phases are represented as association lists or ``alists'' (@pxref{Association Lists,,, guile, GNU Guile Reference Manual}) where each key is a symbol naming the phase and the associated value is a procedure (@pxref{Build Phases})."
  13851. msgstr ""
  13852. #. type: Plain text
  13853. #: guix-git/doc/guix.texi:8730
  13854. msgid "Guile core and the @code{(srfi srfi-1)} module both provide tools to manipulate alists. The @code{(guix build utils)} module complements those with tools written with build phases in mind."
  13855. msgstr ""
  13856. #. type: cindex
  13857. #: guix-git/doc/guix.texi:8731
  13858. #, no-wrap
  13859. msgid "build phases, modifying"
  13860. msgstr ""
  13861. #. type: deffn
  13862. #: guix-git/doc/guix.texi:8732
  13863. #, no-wrap
  13864. msgid "{Scheme Syntax} modify-phases @var{phases} @var{clause}@dots{}"
  13865. msgstr ""
  13866. #. type: deffn
  13867. #: guix-git/doc/guix.texi:8735
  13868. msgid "Modify @var{phases} sequentially as per each @var{clause}, which may have one of the following forms:"
  13869. msgstr ""
  13870. #. type: lisp
  13871. #: guix-git/doc/guix.texi:8741
  13872. #, no-wrap
  13873. msgid ""
  13874. "(delete @var{old-phase-name})\n"
  13875. "(replace @var{old-phase-name} @var{new-phase})\n"
  13876. "(add-before @var{old-phase-name} @var{new-phase-name} @var{new-phase})\n"
  13877. "(add-after @var{old-phase-name} @var{new-phase-name} @var{new-phase})\n"
  13878. msgstr ""
  13879. #. type: deffn
  13880. #: guix-git/doc/guix.texi:8745
  13881. msgid "Where every @var{phase-name} above is an expression evaluating to a symbol, and @var{new-phase} an expression evaluating to a procedure."
  13882. msgstr ""
  13883. #. type: Plain text
  13884. #: guix-git/doc/guix.texi:8756
  13885. msgid "The example below is taken from the definition of the @code{grep} package. It adds a phase to run after the @code{install} phase, called @code{fix-egrep-and-fgrep}. That phase is a procedure (@code{lambda*} is for anonymous procedures) that takes a @code{#:outputs} keyword argument and ignores extra keyword arguments (@pxref{Optional Arguments,,, guile, GNU Guile Reference Manual}, for more on @code{lambda*} and optional and keyword arguments.) The phase uses @code{substitute*} to modify the installed @file{egrep} and @file{fgrep} scripts so that they refer to @code{grep} by its absolute file name:"
  13886. msgstr ""
  13887. #. type: lisp
  13888. #: guix-git/doc/guix.texi:8770
  13889. #, no-wrap
  13890. msgid ""
  13891. "(modify-phases %standard-phases\n"
  13892. " (add-after 'install 'fix-egrep-and-fgrep\n"
  13893. " ;; Patch 'egrep' and 'fgrep' to execute 'grep' via its\n"
  13894. " ;; absolute file name instead of searching for it in $PATH.\n"
  13895. " (lambda* (#:key outputs #:allow-other-keys)\n"
  13896. " (let* ((out (assoc-ref outputs \"out\"))\n"
  13897. " (bin (string-append out \"/bin\")))\n"
  13898. " (substitute* (list (string-append bin \"/egrep\")\n"
  13899. " (string-append bin \"/fgrep\"))\n"
  13900. " ((\"^exec grep\")\n"
  13901. " (string-append \"exec \" bin \"/grep\")))\n"
  13902. " #t))))\n"
  13903. msgstr ""
  13904. #. type: Plain text
  13905. #: guix-git/doc/guix.texi:8777
  13906. msgid "In the example below, phases are modified in two ways: the standard @code{configure} phase is deleted, presumably because the package does not have a @file{configure} script or anything similar, and the default @code{install} phase is replaced by one that manually copies the executable files to be installed:"
  13907. msgstr ""
  13908. #. type: lisp
  13909. #: guix-git/doc/guix.texi:8790
  13910. #, no-wrap
  13911. msgid ""
  13912. "(modify-phases %standard-phases\n"
  13913. " (delete 'configure) ;no 'configure' script\n"
  13914. " (replace 'install\n"
  13915. " (lambda* (#:key outputs #:allow-other-keys)\n"
  13916. " ;; The package's Makefile doesn't provide an \"install\"\n"
  13917. " ;; rule so do it by ourselves.\n"
  13918. " (let ((bin (string-append (assoc-ref outputs \"out\")\n"
  13919. " \"/bin\")))\n"
  13920. " (install-file \"footswitch\" bin)\n"
  13921. " (install-file \"scythe\" bin)\n"
  13922. " #t))))\n"
  13923. msgstr ""
  13924. #. type: cindex
  13925. #: guix-git/doc/guix.texi:8798
  13926. #, no-wrap
  13927. msgid "store items"
  13928. msgstr ""
  13929. #. type: cindex
  13930. #: guix-git/doc/guix.texi:8799
  13931. #, no-wrap
  13932. msgid "store paths"
  13933. msgstr ""
  13934. #. type: Plain text
  13935. #: guix-git/doc/guix.texi:8810
  13936. msgid "Conceptually, the @dfn{store} is the place where derivations that have been built successfully are stored---by default, @file{/gnu/store}. Sub-directories in the store are referred to as @dfn{store items} or sometimes @dfn{store paths}. The store has an associated database that contains information such as the store paths referred to by each store path, and the list of @emph{valid} store items---results of successful builds. This database resides in @file{@var{localstatedir}/guix/db}, where @var{localstatedir} is the state directory specified @i{via} @option{--localstatedir} at configure time, usually @file{/var}."
  13937. msgstr ""
  13938. #. type: Plain text
  13939. #: guix-git/doc/guix.texi:8815
  13940. msgid "The store is @emph{always} accessed by the daemon on behalf of its clients (@pxref{Invoking guix-daemon}). To manipulate the store, clients connect to the daemon over a Unix-domain socket, send requests to it, and read the result---these are remote procedure calls, or RPCs."
  13941. msgstr ""
  13942. #. type: quotation
  13943. #: guix-git/doc/guix.texi:8820
  13944. msgid "Users must @emph{never} modify files under @file{/gnu/store} directly. This would lead to inconsistencies and break the immutability assumptions of Guix's functional model (@pxref{Introduction})."
  13945. msgstr ""
  13946. #. type: quotation
  13947. #: guix-git/doc/guix.texi:8824
  13948. msgid "@xref{Invoking guix gc, @command{guix gc --verify}}, for information on how to check the integrity of the store and attempt recovery from accidental modifications."
  13949. msgstr ""
  13950. #. type: Plain text
  13951. #: guix-git/doc/guix.texi:8831
  13952. msgid "The @code{(guix store)} module provides procedures to connect to the daemon, and to perform RPCs. These are described below. By default, @code{open-connection}, and thus all the @command{guix} commands, connect to the local daemon or to the URI specified by the @env{GUIX_DAEMON_SOCKET} environment variable."
  13953. msgstr ""
  13954. #. type: defvr
  13955. #: guix-git/doc/guix.texi:8832
  13956. #, no-wrap
  13957. msgid "{Environment Variable} GUIX_DAEMON_SOCKET"
  13958. msgstr ""
  13959. #. type: defvr
  13960. #: guix-git/doc/guix.texi:8837
  13961. msgid "When set, the value of this variable should be a file name or a URI designating the daemon endpoint. When it is a file name, it denotes a Unix-domain socket to connect to. In addition to file names, the supported URI schemes are:"
  13962. msgstr ""
  13963. #. type: code{#1}
  13964. #: guix-git/doc/guix.texi:8839 guix-git/doc/guix.texi:25026
  13965. #, no-wrap
  13966. msgid "file"
  13967. msgstr ""
  13968. #. type: itemx
  13969. #: guix-git/doc/guix.texi:8840
  13970. #, no-wrap
  13971. msgid "unix"
  13972. msgstr ""
  13973. #. type: table
  13974. #: guix-git/doc/guix.texi:8844
  13975. msgid "These are for Unix-domain sockets. @code{file:///var/guix/daemon-socket/socket} is equivalent to @file{/var/guix/daemon-socket/socket}."
  13976. msgstr ""
  13977. #. type: table
  13978. #: guix-git/doc/guix.texi:8853
  13979. msgid "These URIs denote connections over TCP/IP, without encryption nor authentication of the remote host. The URI must specify the host name and optionally a port number (by default port 44146 is used):"
  13980. msgstr ""
  13981. #. type: example
  13982. #: guix-git/doc/guix.texi:8856
  13983. #, no-wrap
  13984. msgid "guix://master.guix.example.org:1234\n"
  13985. msgstr ""
  13986. #. type: table
  13987. #: guix-git/doc/guix.texi:8861
  13988. msgid "This setup is suitable on local networks, such as clusters, where only trusted nodes may connect to the build daemon at @code{master.guix.example.org}."
  13989. msgstr ""
  13990. #. type: table
  13991. #: guix-git/doc/guix.texi:8865
  13992. msgid "The @option{--listen} option of @command{guix-daemon} can be used to instruct it to listen for TCP connections (@pxref{Invoking guix-daemon, @option{--listen}})."
  13993. msgstr ""
  13994. #. type: item
  13995. #: guix-git/doc/guix.texi:8866
  13996. #, no-wrap
  13997. msgid "ssh"
  13998. msgstr ""
  13999. #. type: cindex
  14000. #: guix-git/doc/guix.texi:8867
  14001. #, no-wrap
  14002. msgid "SSH access to build daemons"
  14003. msgstr ""
  14004. #. type: table
  14005. #: guix-git/doc/guix.texi:8873
  14006. msgid "These URIs allow you to connect to a remote daemon over SSH@. This feature requires Guile-SSH (@pxref{Requirements}) and a working @command{guile} binary in @env{PATH} on the destination machine. It supports public key and GSSAPI authentication. A typical URL might look like this:"
  14007. msgstr ""
  14008. #. type: example
  14009. #: guix-git/doc/guix.texi:8876
  14010. #, no-wrap
  14011. msgid "ssh://charlie@@guix.example.org:22\n"
  14012. msgstr ""
  14013. #. type: table
  14014. #: guix-git/doc/guix.texi:8880
  14015. msgid "As for @command{guix copy}, the usual OpenSSH client configuration files are honored (@pxref{Invoking guix copy})."
  14016. msgstr ""
  14017. #. type: defvr
  14018. #: guix-git/doc/guix.texi:8883
  14019. msgid "Additional URI schemes may be supported in the future."
  14020. msgstr ""
  14021. #. type: quotation
  14022. #: guix-git/doc/guix.texi:8890
  14023. msgid "The ability to connect to remote build daemons is considered experimental as of @value{VERSION}. Please get in touch with us to share any problems or suggestions you may have (@pxref{Contributing})."
  14024. msgstr ""
  14025. #. type: deffn
  14026. #: guix-git/doc/guix.texi:8893
  14027. #, no-wrap
  14028. msgid "{Scheme Procedure} open-connection [@var{uri}] [#:reserve-space? #t]"
  14029. msgstr ""
  14030. #. type: deffn
  14031. #: guix-git/doc/guix.texi:8898
  14032. msgid "Connect to the daemon over the Unix-domain socket at @var{uri} (a string). When @var{reserve-space?} is true, instruct it to reserve a little bit of extra space on the file system so that the garbage collector can still operate should the disk become full. Return a server object."
  14033. msgstr ""
  14034. #. type: deffn
  14035. #: guix-git/doc/guix.texi:8901
  14036. msgid "@var{file} defaults to @code{%default-socket-path}, which is the normal location given the options that were passed to @command{configure}."
  14037. msgstr ""
  14038. #. type: deffn
  14039. #: guix-git/doc/guix.texi:8903
  14040. #, no-wrap
  14041. msgid "{Scheme Procedure} close-connection @var{server}"
  14042. msgstr ""
  14043. #. type: deffn
  14044. #: guix-git/doc/guix.texi:8905
  14045. msgid "Close the connection to @var{server}."
  14046. msgstr ""
  14047. #. type: defvr
  14048. #: guix-git/doc/guix.texi:8907
  14049. #, no-wrap
  14050. msgid "{Scheme Variable} current-build-output-port"
  14051. msgstr ""
  14052. #. type: defvr
  14053. #: guix-git/doc/guix.texi:8910
  14054. msgid "This variable is bound to a SRFI-39 parameter, which refers to the port where build and error logs sent by the daemon should be written."
  14055. msgstr ""
  14056. #. type: Plain text
  14057. #: guix-git/doc/guix.texi:8914
  14058. msgid "Procedures that make RPCs all take a server object as their first argument."
  14059. msgstr ""
  14060. #. type: deffn
  14061. #: guix-git/doc/guix.texi:8915
  14062. #, no-wrap
  14063. msgid "{Scheme Procedure} valid-path? @var{server} @var{path}"
  14064. msgstr ""
  14065. #. type: cindex
  14066. #: guix-git/doc/guix.texi:8916
  14067. #, no-wrap
  14068. msgid "invalid store items"
  14069. msgstr ""
  14070. #. type: deffn
  14071. #: guix-git/doc/guix.texi:8921
  14072. msgid "Return @code{#t} when @var{path} designates a valid store item and @code{#f} otherwise (an invalid item may exist on disk but still be invalid, for instance because it is the result of an aborted or failed build)."
  14073. msgstr ""
  14074. #. type: deffn
  14075. #: guix-git/doc/guix.texi:8924
  14076. msgid "A @code{&store-protocol-error} condition is raised if @var{path} is not prefixed by the store directory (@file{/gnu/store})."
  14077. msgstr ""
  14078. #. type: deffn
  14079. #: guix-git/doc/guix.texi:8926
  14080. #, no-wrap
  14081. msgid "{Scheme Procedure} add-text-to-store @var{server} @var{name} @var{text} [@var{references}]"
  14082. msgstr ""
  14083. #. type: deffn
  14084. #: guix-git/doc/guix.texi:8930
  14085. msgid "Add @var{text} under file @var{name} in the store, and return its store path. @var{references} is the list of store paths referred to by the resulting store path."
  14086. msgstr ""
  14087. #. type: deffn
  14088. #: guix-git/doc/guix.texi:8932
  14089. #, no-wrap
  14090. msgid "{Scheme Procedure} build-derivations @var{store} @var{derivations} @"
  14091. msgstr ""
  14092. #. type: deffn
  14093. #: guix-git/doc/guix.texi:8937
  14094. msgid "[@var{mode}] Build @var{derivations}, a list of @code{<derivation>} objects, @file{.drv} file names, or derivation/output pairs, using the specified @var{mode}---@code{(build-mode normal)} by default."
  14095. msgstr ""
  14096. #. type: Plain text
  14097. #: guix-git/doc/guix.texi:8943
  14098. msgid "Note that the @code{(guix monads)} module provides a monad as well as monadic versions of the above procedures, with the goal of making it more convenient to work with code that accesses the store (@pxref{The Store Monad})."
  14099. msgstr ""
  14100. #. type: i{#1}
  14101. #: guix-git/doc/guix.texi:8946
  14102. msgid "This section is currently incomplete."
  14103. msgstr ""
  14104. #. type: cindex
  14105. #: guix-git/doc/guix.texi:8950
  14106. #, no-wrap
  14107. msgid "derivations"
  14108. msgstr ""
  14109. #. type: Plain text
  14110. #: guix-git/doc/guix.texi:8954
  14111. msgid "Low-level build actions and the environment in which they are performed are represented by @dfn{derivations}. A derivation contains the following pieces of information:"
  14112. msgstr ""
  14113. #. type: itemize
  14114. #: guix-git/doc/guix.texi:8959
  14115. msgid "The outputs of the derivation---derivations produce at least one file or directory in the store, but may produce more."
  14116. msgstr ""
  14117. #. type: cindex
  14118. #: guix-git/doc/guix.texi:8961
  14119. #, no-wrap
  14120. msgid "build-time dependencies"
  14121. msgstr ""
  14122. #. type: cindex
  14123. #: guix-git/doc/guix.texi:8962
  14124. #, no-wrap
  14125. msgid "dependencies, build-time"
  14126. msgstr ""
  14127. #. type: itemize
  14128. #: guix-git/doc/guix.texi:8966
  14129. msgid "The inputs of the derivations---i.e., its build-time dependencies---which may be other derivations or plain files in the store (patches, build scripts, etc.)."
  14130. msgstr ""
  14131. #. type: itemize
  14132. #: guix-git/doc/guix.texi:8969
  14133. msgid "The system type targeted by the derivation---e.g., @code{x86_64-linux}."
  14134. msgstr ""
  14135. #. type: itemize
  14136. #: guix-git/doc/guix.texi:8973
  14137. msgid "The file name of a build script in the store, along with the arguments to be passed."
  14138. msgstr ""
  14139. #. type: itemize
  14140. #: guix-git/doc/guix.texi:8976
  14141. msgid "A list of environment variables to be defined."
  14142. msgstr ""
  14143. #. type: cindex
  14144. #: guix-git/doc/guix.texi:8979
  14145. #, no-wrap
  14146. msgid "derivation path"
  14147. msgstr ""
  14148. #. type: Plain text
  14149. #: guix-git/doc/guix.texi:8987
  14150. msgid "Derivations allow clients of the daemon to communicate build actions to the store. They exist in two forms: as an in-memory representation, both on the client- and daemon-side, and as files in the store whose name end in @file{.drv}---these files are referred to as @dfn{derivation paths}. Derivations paths can be passed to the @code{build-derivations} procedure to perform the build actions they prescribe (@pxref{The Store})."
  14151. msgstr ""
  14152. #. type: cindex
  14153. #: guix-git/doc/guix.texi:8988
  14154. #, no-wrap
  14155. msgid "fixed-output derivations"
  14156. msgstr ""
  14157. #. type: Plain text
  14158. #: guix-git/doc/guix.texi:8995
  14159. msgid "Operations such as file downloads and version-control checkouts for which the expected content hash is known in advance are modeled as @dfn{fixed-output derivations}. Unlike regular derivations, the outputs of a fixed-output derivation are independent of its inputs---e.g., a source code download produces the same result regardless of the download method and tools being used."
  14160. msgstr ""
  14161. #. type: item
  14162. #: guix-git/doc/guix.texi:8996 guix-git/doc/guix.texi:12539
  14163. #, no-wrap
  14164. msgid "references"
  14165. msgstr ""
  14166. #. type: cindex
  14167. #: guix-git/doc/guix.texi:8997
  14168. #, no-wrap
  14169. msgid "run-time dependencies"
  14170. msgstr ""
  14171. #. type: cindex
  14172. #: guix-git/doc/guix.texi:8998
  14173. #, no-wrap
  14174. msgid "dependencies, run-time"
  14175. msgstr ""
  14176. #. type: Plain text
  14177. #: guix-git/doc/guix.texi:9005
  14178. msgid "The outputs of derivations---i.e., the build results---have a set of @dfn{references}, as reported by the @code{references} RPC or the @command{guix gc --references} command (@pxref{Invoking guix gc}). References are the set of run-time dependencies of the build results. References are a subset of the inputs of the derivation; this subset is automatically computed by the build daemon by scanning all the files in the outputs."
  14179. msgstr ""
  14180. #. type: Plain text
  14181. #: guix-git/doc/guix.texi:9010
  14182. msgid "The @code{(guix derivations)} module provides a representation of derivations as Scheme objects, along with procedures to create and otherwise manipulate derivations. The lowest-level primitive to create a derivation is the @code{derivation} procedure:"
  14183. msgstr ""
  14184. #. type: deffn
  14185. #: guix-git/doc/guix.texi:9011
  14186. #, no-wrap
  14187. msgid "{Scheme Procedure} derivation @var{store} @var{name} @var{builder} @"
  14188. msgstr ""
  14189. #. type: deffn
  14190. #: guix-git/doc/guix.texi:9020
  14191. msgid "@var{args} [#:outputs '(\"out\")] [#:hash #f] [#:hash-algo #f] @ [#:recursive? #f] [#:inputs '()] [#:env-vars '()] @ [#:system (%current-system)] [#:references-graphs #f] @ [#:allowed-references #f] [#:disallowed-references #f] @ [#:leaked-env-vars #f] [#:local-build? #f] @ [#:substitutable? #t] [#:properties '()] Build a derivation with the given arguments, and return the resulting @code{<derivation>} object."
  14192. msgstr ""
  14193. #. type: deffn
  14194. #: guix-git/doc/guix.texi:9027
  14195. msgid "When @var{hash} and @var{hash-algo} are given, a @dfn{fixed-output derivation} is created---i.e., one whose result is known in advance, such as a file download. If, in addition, @var{recursive?} is true, then that fixed output may be an executable file or a directory and @var{hash} must be the hash of an archive containing this output."
  14196. msgstr ""
  14197. #. type: deffn
  14198. #: guix-git/doc/guix.texi:9032
  14199. msgid "When @var{references-graphs} is true, it must be a list of file name/store path pairs. In that case, the reference graph of each store path is exported in the build environment in the corresponding file, in a simple text format."
  14200. msgstr ""
  14201. #. type: deffn
  14202. #: guix-git/doc/guix.texi:9037
  14203. msgid "When @var{allowed-references} is true, it must be a list of store items or outputs that the derivation's output may refer to. Likewise, @var{disallowed-references}, if true, must be a list of things the outputs may @emph{not} refer to."
  14204. msgstr ""
  14205. #. type: deffn
  14206. #: guix-git/doc/guix.texi:9044
  14207. msgid "When @var{leaked-env-vars} is true, it must be a list of strings denoting environment variables that are allowed to ``leak'' from the daemon's environment to the build environment. This is only applicable to fixed-output derivations---i.e., when @var{hash} is true. The main use is to allow variables such as @code{http_proxy} to be passed to derivations that download files."
  14208. msgstr ""
  14209. #. type: deffn
  14210. #: guix-git/doc/guix.texi:9049
  14211. msgid "When @var{local-build?} is true, declare that the derivation is not a good candidate for offloading and should rather be built locally (@pxref{Daemon Offload Setup}). This is the case for small derivations where the costs of data transfers would outweigh the benefits."
  14212. msgstr ""
  14213. #. type: deffn
  14214. #: guix-git/doc/guix.texi:9054
  14215. msgid "When @var{substitutable?} is false, declare that substitutes of the derivation's output should not be used (@pxref{Substitutes}). This is useful, for instance, when building packages that capture details of the host CPU instruction set."
  14216. msgstr ""
  14217. #. type: deffn
  14218. #: guix-git/doc/guix.texi:9057
  14219. msgid "@var{properties} must be an association list describing ``properties'' of the derivation. It is kept as-is, uninterpreted, in the derivation."
  14220. msgstr ""
  14221. #. type: Plain text
  14222. #: guix-git/doc/guix.texi:9063
  14223. msgid "Here's an example with a shell script as its builder, assuming @var{store} is an open connection to the daemon, and @var{bash} points to a Bash executable in the store:"
  14224. msgstr ""
  14225. #. type: lisp
  14226. #: guix-git/doc/guix.texi:9068
  14227. #, no-wrap
  14228. msgid ""
  14229. "(use-modules (guix utils)\n"
  14230. " (guix store)\n"
  14231. " (guix derivations))\n"
  14232. "\n"
  14233. msgstr ""
  14234. #. type: lisp
  14235. #: guix-git/doc/guix.texi:9077
  14236. #, no-wrap
  14237. msgid ""
  14238. "(let ((builder ; add the Bash script to the store\n"
  14239. " (add-text-to-store store \"my-builder.sh\"\n"
  14240. " \"echo hello world > $out\\n\" '())))\n"
  14241. " (derivation store \"foo\"\n"
  14242. " bash `(\"-e\" ,builder)\n"
  14243. " #:inputs `((,bash) (,builder))\n"
  14244. " #:env-vars '((\"HOME\" . \"/homeless\"))))\n"
  14245. "@result{} #<derivation /gnu/store/@dots{}-foo.drv => /gnu/store/@dots{}-foo>\n"
  14246. msgstr ""
  14247. #. type: Plain text
  14248. #: guix-git/doc/guix.texi:9084
  14249. msgid "As can be guessed, this primitive is cumbersome to use directly. A better approach is to write build scripts in Scheme, of course! The best course of action for that is to write the build code as a ``G-expression'', and to pass it to @code{gexp->derivation}. For more information, @pxref{G-Expressions}."
  14250. msgstr ""
  14251. #. type: Plain text
  14252. #: guix-git/doc/guix.texi:9089
  14253. msgid "Once upon a time, @code{gexp->derivation} did not exist and constructing derivations with build code written in Scheme was achieved with @code{build-expression->derivation}, documented below. This procedure is now deprecated in favor of the much nicer @code{gexp->derivation}."
  14254. msgstr ""
  14255. #. type: deffn
  14256. #: guix-git/doc/guix.texi:9090
  14257. #, no-wrap
  14258. msgid "{Scheme Procedure} build-expression->derivation @var{store} @"
  14259. msgstr ""
  14260. #. type: deffn
  14261. #: guix-git/doc/guix.texi:9106
  14262. msgid "@var{name} @var{exp} @ [#:system (%current-system)] [#:inputs '()] @ [#:outputs '(\"out\")] [#:hash #f] [#:hash-algo #f] @ [#:recursive? #f] [#:env-vars '()] [#:modules '()] @ [#:references-graphs #f] [#:allowed-references #f] @ [#:disallowed-references #f] @ [#:local-build? #f] [#:substitutable? #t] [#:guile-for-build #f] Return a derivation that executes Scheme expression @var{exp} as a builder for derivation @var{name}. @var{inputs} must be a list of @code{(name drv-path sub-drv)} tuples; when @var{sub-drv} is omitted, @code{\"out\"} is assumed. @var{modules} is a list of names of Guile modules from the current search path to be copied in the store, compiled, and made available in the load path during the execution of @var{exp}---e.g., @code{((guix build utils) (guix build gnu-build-system))}."
  14263. msgstr ""
  14264. #. type: deffn
  14265. #: guix-git/doc/guix.texi:9114
  14266. msgid "@var{exp} is evaluated in an environment where @code{%outputs} is bound to a list of output/path pairs, and where @code{%build-inputs} is bound to a list of string/output-path pairs made from @var{inputs}. Optionally, @var{env-vars} is a list of string pairs specifying the name and value of environment variables visible to the builder. The builder terminates by passing the result of @var{exp} to @code{exit}; thus, when @var{exp} returns @code{#f}, the build is considered to have failed."
  14267. msgstr ""
  14268. #. type: deffn
  14269. #: guix-git/doc/guix.texi:9118
  14270. msgid "@var{exp} is built using @var{guile-for-build} (a derivation). When @var{guile-for-build} is omitted or is @code{#f}, the value of the @code{%guile-for-build} fluid is used instead."
  14271. msgstr ""
  14272. #. type: deffn
  14273. #: guix-git/doc/guix.texi:9123
  14274. msgid "See the @code{derivation} procedure for the meaning of @var{references-graphs}, @var{allowed-references}, @var{disallowed-references}, @var{local-build?}, and @var{substitutable?}."
  14275. msgstr ""
  14276. #. type: Plain text
  14277. #: guix-git/doc/guix.texi:9128
  14278. msgid "Here's an example of a single-output derivation that creates a directory containing one file:"
  14279. msgstr ""
  14280. #. type: lisp
  14281. #: guix-git/doc/guix.texi:9136
  14282. #, no-wrap
  14283. msgid ""
  14284. "(let ((builder '(let ((out (assoc-ref %outputs \"out\")))\n"
  14285. " (mkdir out) ; create /gnu/store/@dots{}-goo\n"
  14286. " (call-with-output-file (string-append out \"/test\")\n"
  14287. " (lambda (p)\n"
  14288. " (display '(hello guix) p))))))\n"
  14289. " (build-expression->derivation store \"goo\" builder))\n"
  14290. "\n"
  14291. msgstr ""
  14292. #. type: lisp
  14293. #: guix-git/doc/guix.texi:9138
  14294. #, no-wrap
  14295. msgid "@result{} #<derivation /gnu/store/@dots{}-goo.drv => @dots{}>\n"
  14296. msgstr ""
  14297. #. type: cindex
  14298. #: guix-git/doc/guix.texi:9144
  14299. #, no-wrap
  14300. msgid "monad"
  14301. msgstr ""
  14302. #. type: Plain text
  14303. #: guix-git/doc/guix.texi:9150
  14304. msgid "The procedures that operate on the store described in the previous sections all take an open connection to the build daemon as their first argument. Although the underlying model is functional, they either have side effects or depend on the current state of the store."
  14305. msgstr ""
  14306. #. type: Plain text
  14307. #: guix-git/doc/guix.texi:9156
  14308. msgid "The former is inconvenient: the connection to the build daemon has to be carried around in all those functions, making it impossible to compose functions that do not take that parameter with functions that do. The latter can be problematic: since store operations have side effects and/or depend on external state, they have to be properly sequenced."
  14309. msgstr ""
  14310. #. type: cindex
  14311. #: guix-git/doc/guix.texi:9157
  14312. #, no-wrap
  14313. msgid "monadic values"
  14314. msgstr ""
  14315. #. type: cindex
  14316. #: guix-git/doc/guix.texi:9158
  14317. #, no-wrap
  14318. msgid "monadic functions"
  14319. msgstr ""
  14320. #. type: Plain text
  14321. #: guix-git/doc/guix.texi:9168
  14322. msgid "This is where the @code{(guix monads)} module comes in. This module provides a framework for working with @dfn{monads}, and a particularly useful monad for our uses, the @dfn{store monad}. Monads are a construct that allows two things: associating ``context'' with values (in our case, the context is the store), and building sequences of computations (here computations include accesses to the store). Values in a monad---values that carry this additional context---are called @dfn{monadic values}; procedures that return such values are called @dfn{monadic procedures}."
  14323. msgstr ""
  14324. #. type: Plain text
  14325. #: guix-git/doc/guix.texi:9170
  14326. msgid "Consider this ``normal'' procedure:"
  14327. msgstr ""
  14328. #. type: lisp
  14329. #: guix-git/doc/guix.texi:9179
  14330. #, no-wrap
  14331. msgid ""
  14332. "(define (sh-symlink store)\n"
  14333. " ;; Return a derivation that symlinks the 'bash' executable.\n"
  14334. " (let* ((drv (package-derivation store bash))\n"
  14335. " (out (derivation->output-path drv))\n"
  14336. " (sh (string-append out \"/bin/bash\")))\n"
  14337. " (build-expression->derivation store \"sh\"\n"
  14338. " `(symlink ,sh %output))))\n"
  14339. msgstr ""
  14340. #. type: Plain text
  14341. #: guix-git/doc/guix.texi:9183
  14342. msgid "Using @code{(guix monads)} and @code{(guix gexp)}, it may be rewritten as a monadic function:"
  14343. msgstr ""
  14344. #. type: lisp
  14345. #: guix-git/doc/guix.texi:9191
  14346. #, no-wrap
  14347. msgid ""
  14348. "(define (sh-symlink)\n"
  14349. " ;; Same, but return a monadic value.\n"
  14350. " (mlet %store-monad ((drv (package->derivation bash)))\n"
  14351. " (gexp->derivation \"sh\"\n"
  14352. " #~(symlink (string-append #$drv \"/bin/bash\")\n"
  14353. " #$output))))\n"
  14354. msgstr ""
  14355. #. type: Plain text
  14356. #: guix-git/doc/guix.texi:9198
  14357. msgid "There are several things to note in the second version: the @code{store} parameter is now implicit and is ``threaded'' in the calls to the @code{package->derivation} and @code{gexp->derivation} monadic procedures, and the monadic value returned by @code{package->derivation} is @dfn{bound} using @code{mlet} instead of plain @code{let}."
  14358. msgstr ""
  14359. #. type: Plain text
  14360. #: guix-git/doc/guix.texi:9202
  14361. msgid "As it turns out, the call to @code{package->derivation} can even be omitted since it will take place implicitly, as we will see later (@pxref{G-Expressions}):"
  14362. msgstr ""
  14363. #. type: lisp
  14364. #: guix-git/doc/guix.texi:9208
  14365. #, no-wrap
  14366. msgid ""
  14367. "(define (sh-symlink)\n"
  14368. " (gexp->derivation \"sh\"\n"
  14369. " #~(symlink (string-append #$bash \"/bin/bash\")\n"
  14370. " #$output)))\n"
  14371. msgstr ""
  14372. #. type: Plain text
  14373. #: guix-git/doc/guix.texi:9217
  14374. msgid "Calling the monadic @code{sh-symlink} has no effect. As someone once said, ``you exit a monad like you exit a building on fire: by running''. So, to exit the monad and get the desired effect, one must use @code{run-with-store}:"
  14375. msgstr ""
  14376. #. type: lisp
  14377. #: guix-git/doc/guix.texi:9221
  14378. #, no-wrap
  14379. msgid ""
  14380. "(run-with-store (open-connection) (sh-symlink))\n"
  14381. "@result{} /gnu/store/...-sh-symlink\n"
  14382. msgstr ""
  14383. #. type: Plain text
  14384. #: guix-git/doc/guix.texi:9227
  14385. msgid "Note that the @code{(guix monad-repl)} module extends the Guile REPL with new ``meta-commands'' to make it easier to deal with monadic procedures: @code{run-in-store}, and @code{enter-store-monad}. The former is used to ``run'' a single monadic value through the store:"
  14386. msgstr ""
  14387. #. type: example
  14388. #: guix-git/doc/guix.texi:9231
  14389. #, no-wrap
  14390. msgid ""
  14391. "scheme@@(guile-user)> ,run-in-store (package->derivation hello)\n"
  14392. "$1 = #<derivation /gnu/store/@dots{}-hello-2.9.drv => @dots{}>\n"
  14393. msgstr ""
  14394. #. type: Plain text
  14395. #: guix-git/doc/guix.texi:9235
  14396. msgid "The latter enters a recursive REPL, where all the return values are automatically run through the store:"
  14397. msgstr ""
  14398. #. type: example
  14399. #: guix-git/doc/guix.texi:9244
  14400. #, no-wrap
  14401. msgid ""
  14402. "scheme@@(guile-user)> ,enter-store-monad\n"
  14403. "store-monad@@(guile-user) [1]> (package->derivation hello)\n"
  14404. "$2 = #<derivation /gnu/store/@dots{}-hello-2.9.drv => @dots{}>\n"
  14405. "store-monad@@(guile-user) [1]> (text-file \"foo\" \"Hello!\")\n"
  14406. "$3 = \"/gnu/store/@dots{}-foo\"\n"
  14407. "store-monad@@(guile-user) [1]> ,q\n"
  14408. "scheme@@(guile-user)>\n"
  14409. msgstr ""
  14410. #. type: Plain text
  14411. #: guix-git/doc/guix.texi:9249
  14412. msgid "Note that non-monadic values cannot be returned in the @code{store-monad} REPL."
  14413. msgstr ""
  14414. #. type: Plain text
  14415. #: guix-git/doc/guix.texi:9252
  14416. msgid "The main syntactic forms to deal with monads in general are provided by the @code{(guix monads)} module and are described below."
  14417. msgstr ""
  14418. #. type: deffn
  14419. #: guix-git/doc/guix.texi:9253
  14420. #, no-wrap
  14421. msgid "{Scheme Syntax} with-monad @var{monad} @var{body} ..."
  14422. msgstr ""
  14423. #. type: deffn
  14424. #: guix-git/doc/guix.texi:9256
  14425. msgid "Evaluate any @code{>>=} or @code{return} forms in @var{body} as being in @var{monad}."
  14426. msgstr ""
  14427. #. type: deffn
  14428. #: guix-git/doc/guix.texi:9258
  14429. #, no-wrap
  14430. msgid "{Scheme Syntax} return @var{val}"
  14431. msgstr ""
  14432. #. type: deffn
  14433. #: guix-git/doc/guix.texi:9260
  14434. msgid "Return a monadic value that encapsulates @var{val}."
  14435. msgstr ""
  14436. #. type: deffn
  14437. #: guix-git/doc/guix.texi:9262
  14438. #, no-wrap
  14439. msgid "{Scheme Syntax} >>= @var{mval} @var{mproc} ..."
  14440. msgstr ""
  14441. #. type: deffn
  14442. #: guix-git/doc/guix.texi:9269
  14443. msgid "@dfn{Bind} monadic value @var{mval}, passing its ``contents'' to monadic procedures @var{mproc}@dots{}@footnote{This operation is commonly referred to as ``bind'', but that name denotes an unrelated procedure in Guile. Thus we use this somewhat cryptic symbol inherited from the Haskell language.}. There can be one @var{mproc} or several of them, as in this example:"
  14444. msgstr ""
  14445. #. type: lisp
  14446. #: guix-git/doc/guix.texi:9277
  14447. #, no-wrap
  14448. msgid ""
  14449. "(run-with-state\n"
  14450. " (with-monad %state-monad\n"
  14451. " (>>= (return 1)\n"
  14452. " (lambda (x) (return (+ 1 x)))\n"
  14453. " (lambda (x) (return (* 2 x)))))\n"
  14454. " 'some-state)\n"
  14455. "\n"
  14456. msgstr ""
  14457. #. type: lisp
  14458. #: guix-git/doc/guix.texi:9280
  14459. #, no-wrap
  14460. msgid ""
  14461. "@result{} 4\n"
  14462. "@result{} some-state\n"
  14463. msgstr ""
  14464. #. type: deffn
  14465. #: guix-git/doc/guix.texi:9283
  14466. #, no-wrap
  14467. msgid "{Scheme Syntax} mlet @var{monad} ((@var{var} @var{mval}) ...) @"
  14468. msgstr ""
  14469. #. type: deffn
  14470. #: guix-git/doc/guix.texi:9285
  14471. msgid "@var{body} ..."
  14472. msgstr ""
  14473. #. type: deffnx
  14474. #: guix-git/doc/guix.texi:9285
  14475. #, no-wrap
  14476. msgid "{Scheme Syntax} mlet* @var{monad} ((@var{var} @var{mval}) ...) @"
  14477. msgstr ""
  14478. #. type: deffn
  14479. #: guix-git/doc/guix.texi:9297
  14480. msgid "@var{body} ... Bind the variables @var{var} to the monadic values @var{mval} in @var{body}, which is a sequence of expressions. As with the bind operator, this can be thought of as ``unpacking'' the raw, non-monadic value ``contained'' in @var{mval} and making @var{var} refer to that raw, non-monadic value within the scope of the @var{body}. The form (@var{var} -> @var{val}) binds @var{var} to the ``normal'' value @var{val}, as per @code{let}. The binding operations occur in sequence from left to right. The last expression of @var{body} must be a monadic expression, and its result will become the result of the @code{mlet} or @code{mlet*} when run in the @var{monad}."
  14481. msgstr ""
  14482. #. type: deffn
  14483. #: guix-git/doc/guix.texi:9300
  14484. msgid "@code{mlet*} is to @code{mlet} what @code{let*} is to @code{let} (@pxref{Local Bindings,,, guile, GNU Guile Reference Manual})."
  14485. msgstr ""
  14486. #. type: deffn
  14487. #: guix-git/doc/guix.texi:9302
  14488. #, no-wrap
  14489. msgid "{Scheme System} mbegin @var{monad} @var{mexp} ..."
  14490. msgstr ""
  14491. #. type: deffn
  14492. #: guix-git/doc/guix.texi:9306
  14493. msgid "Bind @var{mexp} and the following monadic expressions in sequence, returning the result of the last expression. Every expression in the sequence must be a monadic expression."
  14494. msgstr ""
  14495. #. type: deffn
  14496. #: guix-git/doc/guix.texi:9310
  14497. msgid "This is akin to @code{mlet}, except that the return values of the monadic expressions are ignored. In that sense, it is analogous to @code{begin}, but applied to monadic expressions."
  14498. msgstr ""
  14499. #. type: deffn
  14500. #: guix-git/doc/guix.texi:9312
  14501. #, no-wrap
  14502. msgid "{Scheme System} mwhen @var{condition} @var{mexp0} @var{mexp*} ..."
  14503. msgstr ""
  14504. #. type: deffn
  14505. #: guix-git/doc/guix.texi:9317
  14506. msgid "When @var{condition} is true, evaluate the sequence of monadic expressions @var{mexp0}..@var{mexp*} as in an @code{mbegin}. When @var{condition} is false, return @code{*unspecified*} in the current monad. Every expression in the sequence must be a monadic expression."
  14507. msgstr ""
  14508. #. type: deffn
  14509. #: guix-git/doc/guix.texi:9319
  14510. #, no-wrap
  14511. msgid "{Scheme System} munless @var{condition} @var{mexp0} @var{mexp*} ..."
  14512. msgstr ""
  14513. #. type: deffn
  14514. #: guix-git/doc/guix.texi:9324
  14515. msgid "When @var{condition} is false, evaluate the sequence of monadic expressions @var{mexp0}..@var{mexp*} as in an @code{mbegin}. When @var{condition} is true, return @code{*unspecified*} in the current monad. Every expression in the sequence must be a monadic expression."
  14516. msgstr ""
  14517. #. type: cindex
  14518. #: guix-git/doc/guix.texi:9326
  14519. #, no-wrap
  14520. msgid "state monad"
  14521. msgstr ""
  14522. #. type: Plain text
  14523. #: guix-git/doc/guix.texi:9330
  14524. msgid "The @code{(guix monads)} module provides the @dfn{state monad}, which allows an additional value---the state---to be @emph{threaded} through monadic procedure calls."
  14525. msgstr ""
  14526. #. type: defvr
  14527. #: guix-git/doc/guix.texi:9331
  14528. #, no-wrap
  14529. msgid "{Scheme Variable} %state-monad"
  14530. msgstr ""
  14531. #. type: defvr
  14532. #: guix-git/doc/guix.texi:9334
  14533. msgid "The state monad. Procedures in the state monad can access and change the state that is threaded."
  14534. msgstr ""
  14535. #. type: defvr
  14536. #: guix-git/doc/guix.texi:9338
  14537. msgid "Consider the example below. The @code{square} procedure returns a value in the state monad. It returns the square of its argument, but also increments the current state value:"
  14538. msgstr ""
  14539. #. type: lisp
  14540. #: guix-git/doc/guix.texi:9345
  14541. #, no-wrap
  14542. msgid ""
  14543. "(define (square x)\n"
  14544. " (mlet %state-monad ((count (current-state)))\n"
  14545. " (mbegin %state-monad\n"
  14546. " (set-current-state (+ 1 count))\n"
  14547. " (return (* x x)))))\n"
  14548. "\n"
  14549. msgstr ""
  14550. #. type: lisp
  14551. #: guix-git/doc/guix.texi:9349
  14552. #, no-wrap
  14553. msgid ""
  14554. "(run-with-state (sequence %state-monad (map square (iota 3))) 0)\n"
  14555. "@result{} (0 1 4)\n"
  14556. "@result{} 3\n"
  14557. msgstr ""
  14558. #. type: defvr
  14559. #: guix-git/doc/guix.texi:9353
  14560. msgid "When ``run'' through @code{%state-monad}, we obtain that additional state value, which is the number of @code{square} calls."
  14561. msgstr ""
  14562. #. type: deffn
  14563. #: guix-git/doc/guix.texi:9355
  14564. #, no-wrap
  14565. msgid "{Monadic Procedure} current-state"
  14566. msgstr ""
  14567. #. type: deffn
  14568. #: guix-git/doc/guix.texi:9357
  14569. msgid "Return the current state as a monadic value."
  14570. msgstr ""
  14571. #. type: deffn
  14572. #: guix-git/doc/guix.texi:9359
  14573. #, no-wrap
  14574. msgid "{Monadic Procedure} set-current-state @var{value}"
  14575. msgstr ""
  14576. #. type: deffn
  14577. #: guix-git/doc/guix.texi:9362
  14578. msgid "Set the current state to @var{value} and return the previous state as a monadic value."
  14579. msgstr ""
  14580. #. type: deffn
  14581. #: guix-git/doc/guix.texi:9364
  14582. #, no-wrap
  14583. msgid "{Monadic Procedure} state-push @var{value}"
  14584. msgstr ""
  14585. #. type: deffn
  14586. #: guix-git/doc/guix.texi:9367
  14587. msgid "Push @var{value} to the current state, which is assumed to be a list, and return the previous state as a monadic value."
  14588. msgstr ""
  14589. #. type: deffn
  14590. #: guix-git/doc/guix.texi:9369
  14591. #, no-wrap
  14592. msgid "{Monadic Procedure} state-pop"
  14593. msgstr ""
  14594. #. type: deffn
  14595. #: guix-git/doc/guix.texi:9372
  14596. msgid "Pop a value from the current state and return it as a monadic value. The state is assumed to be a list."
  14597. msgstr ""
  14598. #. type: deffn
  14599. #: guix-git/doc/guix.texi:9374
  14600. #, no-wrap
  14601. msgid "{Scheme Procedure} run-with-state @var{mval} [@var{state}]"
  14602. msgstr ""
  14603. #. type: deffn
  14604. #: guix-git/doc/guix.texi:9377
  14605. msgid "Run monadic value @var{mval} starting with @var{state} as the initial state. Return two values: the resulting value, and the resulting state."
  14606. msgstr ""
  14607. #. type: Plain text
  14608. #: guix-git/doc/guix.texi:9381
  14609. msgid "The main interface to the store monad, provided by the @code{(guix store)} module, is as follows."
  14610. msgstr ""
  14611. #. type: defvr
  14612. #: guix-git/doc/guix.texi:9382
  14613. #, no-wrap
  14614. msgid "{Scheme Variable} %store-monad"
  14615. msgstr ""
  14616. #. type: defvr
  14617. #: guix-git/doc/guix.texi:9384
  14618. msgid "The store monad---an alias for @code{%state-monad}."
  14619. msgstr ""
  14620. #. type: defvr
  14621. #: guix-git/doc/guix.texi:9388
  14622. msgid "Values in the store monad encapsulate accesses to the store. When its effect is needed, a value of the store monad must be ``evaluated'' by passing it to the @code{run-with-store} procedure (see below)."
  14623. msgstr ""
  14624. #. type: deffn
  14625. #: guix-git/doc/guix.texi:9390
  14626. #, no-wrap
  14627. msgid "{Scheme Procedure} run-with-store @var{store} @var{mval} [#:guile-for-build] [#:system (%current-system)]"
  14628. msgstr ""
  14629. #. type: deffn
  14630. #: guix-git/doc/guix.texi:9393
  14631. msgid "Run @var{mval}, a monadic value in the store monad, in @var{store}, an open store connection."
  14632. msgstr ""
  14633. #. type: deffn
  14634. #: guix-git/doc/guix.texi:9395
  14635. #, no-wrap
  14636. msgid "{Monadic Procedure} text-file @var{name} @var{text} [@var{references}]"
  14637. msgstr ""
  14638. #. type: deffn
  14639. #: guix-git/doc/guix.texi:9399
  14640. msgid "Return as a monadic value the absolute file name in the store of the file containing @var{text}, a string. @var{references} is a list of store items that the resulting text file refers to; it defaults to the empty list."
  14641. msgstr ""
  14642. #. type: deffn
  14643. #: guix-git/doc/guix.texi:9401
  14644. #, no-wrap
  14645. msgid "{Monadic Procedure} binary-file @var{name} @var{data} [@var{references}]"
  14646. msgstr ""
  14647. #. type: deffn
  14648. #: guix-git/doc/guix.texi:9405
  14649. msgid "Return as a monadic value the absolute file name in the store of the file containing @var{data}, a bytevector. @var{references} is a list of store items that the resulting binary file refers to; it defaults to the empty list."
  14650. msgstr ""
  14651. #. type: deffn
  14652. #: guix-git/doc/guix.texi:9407
  14653. #, no-wrap
  14654. msgid "{Monadic Procedure} interned-file @var{file} [@var{name}] @"
  14655. msgstr ""
  14656. #. type: deffn
  14657. #: guix-git/doc/guix.texi:9412
  14658. msgid "[#:recursive? #t] [#:select? (const #t)] Return the name of @var{file} once interned in the store. Use @var{name} as its store name, or the basename of @var{file} if @var{name} is omitted."
  14659. msgstr ""
  14660. #. type: deffn
  14661. #: guix-git/doc/guix.texi:9416 guix-git/doc/guix.texi:9839
  14662. msgid "When @var{recursive?} is true, the contents of @var{file} are added recursively; if @var{file} designates a flat file and @var{recursive?} is true, its contents are added, and its permission bits are kept."
  14663. msgstr ""
  14664. #. type: deffn
  14665. #: guix-git/doc/guix.texi:9421 guix-git/doc/guix.texi:9844
  14666. msgid "When @var{recursive?} is true, call @code{(@var{select?} @var{file} @var{stat})} for each directory entry, where @var{file} is the entry's absolute file name and @var{stat} is the result of @code{lstat}; exclude entries for which @var{select?} does not return true."
  14667. msgstr ""
  14668. #. type: deffn
  14669. #: guix-git/doc/guix.texi:9423
  14670. msgid "The example below adds a file to the store, under two different names:"
  14671. msgstr ""
  14672. #. type: lisp
  14673. #: guix-git/doc/guix.texi:9429
  14674. #, no-wrap
  14675. msgid ""
  14676. "(run-with-store (open-connection)\n"
  14677. " (mlet %store-monad ((a (interned-file \"README\"))\n"
  14678. " (b (interned-file \"README\" \"LEGU-MIN\")))\n"
  14679. " (return (list a b))))\n"
  14680. "\n"
  14681. msgstr ""
  14682. #. type: lisp
  14683. #: guix-git/doc/guix.texi:9431
  14684. #, no-wrap
  14685. msgid "@result{} (\"/gnu/store/rwm@dots{}-README\" \"/gnu/store/44i@dots{}-LEGU-MIN\")\n"
  14686. msgstr ""
  14687. #. type: Plain text
  14688. #: guix-git/doc/guix.texi:9437
  14689. msgid "The @code{(guix packages)} module exports the following package-related monadic procedures:"
  14690. msgstr ""
  14691. #. type: deffn
  14692. #: guix-git/doc/guix.texi:9438
  14693. #, no-wrap
  14694. msgid "{Monadic Procedure} package-file @var{package} [@var{file}] @"
  14695. msgstr ""
  14696. #. type: deffn
  14697. #: guix-git/doc/guix.texi:9446
  14698. msgid "[#:system (%current-system)] [#:target #f] @ [#:output \"out\"] Return as a monadic value in the absolute file name of @var{file} within the @var{output} directory of @var{package}. When @var{file} is omitted, return the name of the @var{output} directory of @var{package}. When @var{target} is true, use it as a cross-compilation target triplet."
  14699. msgstr ""
  14700. #. type: deffn
  14701. #: guix-git/doc/guix.texi:9450
  14702. msgid "Note that this procedure does @emph{not} build @var{package}. Thus, the result might or might not designate an existing file. We recommend not using this procedure unless you know what you are doing."
  14703. msgstr ""
  14704. #. type: deffn
  14705. #: guix-git/doc/guix.texi:9452
  14706. #, no-wrap
  14707. msgid "{Monadic Procedure} package->derivation @var{package} [@var{system}]"
  14708. msgstr ""
  14709. #. type: deffnx
  14710. #: guix-git/doc/guix.texi:9453
  14711. #, no-wrap
  14712. msgid "{Monadic Procedure} package->cross-derivation @var{package} @"
  14713. msgstr ""
  14714. #. type: deffn
  14715. #: guix-git/doc/guix.texi:9457
  14716. msgid "@var{target} [@var{system}] Monadic version of @code{package-derivation} and @code{package-cross-derivation} (@pxref{Defining Packages})."
  14717. msgstr ""
  14718. #. type: cindex
  14719. #: guix-git/doc/guix.texi:9463
  14720. #, no-wrap
  14721. msgid "G-expression"
  14722. msgstr ""
  14723. #. type: cindex
  14724. #: guix-git/doc/guix.texi:9464
  14725. #, no-wrap
  14726. msgid "build code quoting"
  14727. msgstr ""
  14728. #. type: Plain text
  14729. #: guix-git/doc/guix.texi:9470
  14730. msgid "So we have ``derivations'', which represent a sequence of build actions to be performed to produce an item in the store (@pxref{Derivations}). These build actions are performed when asking the daemon to actually build the derivations; they are run by the daemon in a container (@pxref{Invoking guix-daemon})."
  14731. msgstr ""
  14732. #. type: cindex
  14733. #: guix-git/doc/guix.texi:9473
  14734. #, no-wrap
  14735. msgid "strata of code"
  14736. msgstr ""
  14737. #. type: Plain text
  14738. #: guix-git/doc/guix.texi:9485
  14739. msgid "It should come as no surprise that we like to write these build actions in Scheme. When we do that, we end up with two @dfn{strata} of Scheme code@footnote{The term @dfn{stratum} in this context was coined by Manuel Serrano et al.@: in the context of their work on Hop. Oleg Kiselyov, who has written insightful @url{http://okmij.org/ftp/meta-programming/#meta-scheme, essays and code on this topic}, refers to this kind of code generation as @dfn{staging}.}: the ``host code''---code that defines packages, talks to the daemon, etc.---and the ``build code''---code that actually performs build actions, such as making directories, invoking @command{make}, and so on (@pxref{Build Phases})."
  14740. msgstr ""
  14741. #. type: Plain text
  14742. #: guix-git/doc/guix.texi:9492
  14743. msgid "To describe a derivation and its build actions, one typically needs to embed build code inside host code. It boils down to manipulating build code as data, and the homoiconicity of Scheme---code has a direct representation as data---comes in handy for that. But we need more than the normal @code{quasiquote} mechanism in Scheme to construct build expressions."
  14744. msgstr ""
  14745. #. type: Plain text
  14746. #: guix-git/doc/guix.texi:9501
  14747. msgid "The @code{(guix gexp)} module implements @dfn{G-expressions}, a form of S-expressions adapted to build expressions. G-expressions, or @dfn{gexps}, consist essentially of three syntactic forms: @code{gexp}, @code{ungexp}, and @code{ungexp-splicing} (or simply: @code{#~}, @code{#$}, and @code{#$@@}), which are comparable to @code{quasiquote}, @code{unquote}, and @code{unquote-splicing}, respectively (@pxref{Expression Syntax, @code{quasiquote},, guile, GNU Guile Reference Manual}). However, there are major differences:"
  14748. msgstr ""
  14749. #. type: itemize
  14750. #: guix-git/doc/guix.texi:9506
  14751. msgid "Gexps are meant to be written to a file and run or manipulated by other processes."
  14752. msgstr ""
  14753. #. type: itemize
  14754. #: guix-git/doc/guix.texi:9511
  14755. msgid "When a high-level object such as a package or derivation is unquoted inside a gexp, the result is as if its output file name had been introduced."
  14756. msgstr ""
  14757. #. type: itemize
  14758. #: guix-git/doc/guix.texi:9516
  14759. msgid "Gexps carry information about the packages or derivations they refer to, and these dependencies are automatically added as inputs to the build processes that use them."
  14760. msgstr ""
  14761. #. type: cindex
  14762. #: guix-git/doc/guix.texi:9518 guix-git/doc/guix.texi:10075
  14763. #, no-wrap
  14764. msgid "lowering, of high-level objects in gexps"
  14765. msgstr ""
  14766. #. type: Plain text
  14767. #: guix-git/doc/guix.texi:9528
  14768. msgid "This mechanism is not limited to package and derivation objects: @dfn{compilers} able to ``lower'' other high-level objects to derivations or files in the store can be defined, such that these objects can also be inserted into gexps. For example, a useful type of high-level objects that can be inserted in a gexp is ``file-like objects'', which make it easy to add files to the store and to refer to them in derivations and such (see @code{local-file} and @code{plain-file} below)."
  14769. msgstr ""
  14770. #. type: Plain text
  14771. #: guix-git/doc/guix.texi:9530
  14772. msgid "To illustrate the idea, here is an example of a gexp:"
  14773. msgstr ""
  14774. #. type: lisp
  14775. #: guix-git/doc/guix.texi:9538
  14776. #, no-wrap
  14777. msgid ""
  14778. "(define build-exp\n"
  14779. " #~(begin\n"
  14780. " (mkdir #$output)\n"
  14781. " (chdir #$output)\n"
  14782. " (symlink (string-append #$coreutils \"/bin/ls\")\n"
  14783. " \"list-files\")))\n"
  14784. msgstr ""
  14785. #. type: Plain text
  14786. #: guix-git/doc/guix.texi:9543
  14787. msgid "This gexp can be passed to @code{gexp->derivation}; we obtain a derivation that builds a directory containing exactly one symlink to @file{/gnu/store/@dots{}-coreutils-8.22/bin/ls}:"
  14788. msgstr ""
  14789. #. type: lisp
  14790. #: guix-git/doc/guix.texi:9546
  14791. #, no-wrap
  14792. msgid "(gexp->derivation \"the-thing\" build-exp)\n"
  14793. msgstr ""
  14794. #. type: Plain text
  14795. #: guix-git/doc/guix.texi:9554
  14796. msgid "As one would expect, the @code{\"/gnu/store/@dots{}-coreutils-8.22\"} string is substituted to the reference to the @var{coreutils} package in the actual build code, and @var{coreutils} is automatically made an input to the derivation. Likewise, @code{#$output} (equivalent to @code{(ungexp output)}) is replaced by a string containing the directory name of the output of the derivation."
  14797. msgstr ""
  14798. #. type: cindex
  14799. #: guix-git/doc/guix.texi:9555
  14800. #, no-wrap
  14801. msgid "cross compilation"
  14802. msgstr ""
  14803. #. type: Plain text
  14804. #: guix-git/doc/guix.texi:9561
  14805. msgid "In a cross-compilation context, it is useful to distinguish between references to the @emph{native} build of a package---that can run on the host---versus references to cross builds of a package. To that end, the @code{#+} plays the same role as @code{#$}, but is a reference to a native package build:"
  14806. msgstr ""
  14807. #. type: lisp
  14808. #: guix-git/doc/guix.texi:9572
  14809. #, no-wrap
  14810. msgid ""
  14811. "(gexp->derivation \"vi\"\n"
  14812. " #~(begin\n"
  14813. " (mkdir #$output)\n"
  14814. " (mkdir (string-append #$output \"/bin\"))\n"
  14815. " (system* (string-append #+coreutils \"/bin/ln\")\n"
  14816. " \"-s\"\n"
  14817. " (string-append #$emacs \"/bin/emacs\")\n"
  14818. " (string-append #$output \"/bin/vi\")))\n"
  14819. " #:target \"aarch64-linux-gnu\")\n"
  14820. msgstr ""
  14821. #. type: Plain text
  14822. #: guix-git/doc/guix.texi:9578
  14823. msgid "In the example above, the native build of @var{coreutils} is used, so that @command{ln} can actually run on the host; but then the cross-compiled build of @var{emacs} is referenced."
  14824. msgstr ""
  14825. #. type: cindex
  14826. #: guix-git/doc/guix.texi:9579
  14827. #, no-wrap
  14828. msgid "imported modules, for gexps"
  14829. msgstr ""
  14830. #. type: findex
  14831. #: guix-git/doc/guix.texi:9580
  14832. #, no-wrap
  14833. msgid "with-imported-modules"
  14834. msgstr ""
  14835. #. type: Plain text
  14836. #: guix-git/doc/guix.texi:9585
  14837. msgid "Another gexp feature is @dfn{imported modules}: sometimes you want to be able to use certain Guile modules from the ``host environment'' in the gexp, so those modules should be imported in the ``build environment''. The @code{with-imported-modules} form allows you to express that:"
  14838. msgstr ""
  14839. #. type: lisp
  14840. #: guix-git/doc/guix.texi:9596
  14841. #, no-wrap
  14842. msgid ""
  14843. "(let ((build (with-imported-modules '((guix build utils))\n"
  14844. " #~(begin\n"
  14845. " (use-modules (guix build utils))\n"
  14846. " (mkdir-p (string-append #$output \"/bin\"))))))\n"
  14847. " (gexp->derivation \"empty-dir\"\n"
  14848. " #~(begin\n"
  14849. " #$build\n"
  14850. " (display \"success!\\n\")\n"
  14851. " #t)))\n"
  14852. msgstr ""
  14853. #. type: Plain text
  14854. #: guix-git/doc/guix.texi:9602
  14855. msgid "In this example, the @code{(guix build utils)} module is automatically pulled into the isolated build environment of our gexp, such that @code{(use-modules (guix build utils))} works as expected."
  14856. msgstr ""
  14857. #. type: cindex
  14858. #: guix-git/doc/guix.texi:9603
  14859. #, no-wrap
  14860. msgid "module closure"
  14861. msgstr ""
  14862. #. type: findex
  14863. #: guix-git/doc/guix.texi:9604
  14864. #, no-wrap
  14865. msgid "source-module-closure"
  14866. msgstr ""
  14867. #. type: Plain text
  14868. #: guix-git/doc/guix.texi:9611
  14869. msgid "Usually you want the @emph{closure} of the module to be imported---i.e., the module itself and all the modules it depends on---rather than just the module; failing to do that, attempts to use the module will fail because of missing dependent modules. The @code{source-module-closure} procedure computes the closure of a module by looking at its source file headers, which comes in handy in this case:"
  14870. msgstr ""
  14871. #. type: lisp
  14872. #: guix-git/doc/guix.texi:9614
  14873. #, no-wrap
  14874. msgid ""
  14875. "(use-modules (guix modules)) ;for 'source-module-closure'\n"
  14876. "\n"
  14877. msgstr ""
  14878. #. type: lisp
  14879. #: guix-git/doc/guix.texi:9623
  14880. #, no-wrap
  14881. msgid ""
  14882. "(with-imported-modules (source-module-closure\n"
  14883. " '((guix build utils)\n"
  14884. " (gnu build vm)))\n"
  14885. " (gexp->derivation \"something-with-vms\"\n"
  14886. " #~(begin\n"
  14887. " (use-modules (guix build utils)\n"
  14888. " (gnu build vm))\n"
  14889. " @dots{})))\n"
  14890. msgstr ""
  14891. #. type: cindex
  14892. #: guix-git/doc/guix.texi:9625
  14893. #, no-wrap
  14894. msgid "extensions, for gexps"
  14895. msgstr ""
  14896. #. type: findex
  14897. #: guix-git/doc/guix.texi:9626
  14898. #, no-wrap
  14899. msgid "with-extensions"
  14900. msgstr ""
  14901. #. type: Plain text
  14902. #: guix-git/doc/guix.texi:9631
  14903. msgid "In the same vein, sometimes you want to import not just pure-Scheme modules, but also ``extensions'' such as Guile bindings to C libraries or other ``full-blown'' packages. Say you need the @code{guile-json} package available on the build side, here's how you would do it:"
  14904. msgstr ""
  14905. #. type: lisp
  14906. #: guix-git/doc/guix.texi:9634
  14907. #, no-wrap
  14908. msgid ""
  14909. "(use-modules (gnu packages guile)) ;for 'guile-json'\n"
  14910. "\n"
  14911. msgstr ""
  14912. #. type: lisp
  14913. #: guix-git/doc/guix.texi:9640
  14914. #, no-wrap
  14915. msgid ""
  14916. "(with-extensions (list guile-json)\n"
  14917. " (gexp->derivation \"something-with-json\"\n"
  14918. " #~(begin\n"
  14919. " (use-modules (json))\n"
  14920. " @dots{})))\n"
  14921. msgstr ""
  14922. #. type: Plain text
  14923. #: guix-git/doc/guix.texi:9643
  14924. msgid "The syntactic form to construct gexps is summarized below."
  14925. msgstr ""
  14926. #. type: deffn
  14927. #: guix-git/doc/guix.texi:9644
  14928. #, no-wrap
  14929. msgid "{Scheme Syntax} #~@var{exp}"
  14930. msgstr ""
  14931. #. type: deffnx
  14932. #: guix-git/doc/guix.texi:9645
  14933. #, no-wrap
  14934. msgid "{Scheme Syntax} (gexp @var{exp})"
  14935. msgstr ""
  14936. #. type: deffn
  14937. #: guix-git/doc/guix.texi:9648
  14938. msgid "Return a G-expression containing @var{exp}. @var{exp} may contain one or more of the following forms:"
  14939. msgstr ""
  14940. #. type: item
  14941. #: guix-git/doc/guix.texi:9650
  14942. #, no-wrap
  14943. msgid "#$@var{obj}"
  14944. msgstr ""
  14945. #. type: itemx
  14946. #: guix-git/doc/guix.texi:9651
  14947. #, no-wrap
  14948. msgid "(ungexp @var{obj})"
  14949. msgstr ""
  14950. #. type: table
  14951. #: guix-git/doc/guix.texi:9656
  14952. msgid "Introduce a reference to @var{obj}. @var{obj} may have one of the supported types, for example a package or a derivation, in which case the @code{ungexp} form is replaced by its output file name---e.g., @code{\"/gnu/store/@dots{}-coreutils-8.22}."
  14953. msgstr ""
  14954. #. type: table
  14955. #: guix-git/doc/guix.texi:9659
  14956. msgid "If @var{obj} is a list, it is traversed and references to supported objects are substituted similarly."
  14957. msgstr ""
  14958. #. type: table
  14959. #: guix-git/doc/guix.texi:9662
  14960. msgid "If @var{obj} is another gexp, its contents are inserted and its dependencies are added to those of the containing gexp."
  14961. msgstr ""
  14962. #. type: table
  14963. #: guix-git/doc/guix.texi:9664
  14964. msgid "If @var{obj} is another kind of object, it is inserted as is."
  14965. msgstr ""
  14966. #. type: item
  14967. #: guix-git/doc/guix.texi:9665
  14968. #, no-wrap
  14969. msgid "#$@var{obj}:@var{output}"
  14970. msgstr ""
  14971. #. type: itemx
  14972. #: guix-git/doc/guix.texi:9666
  14973. #, no-wrap
  14974. msgid "(ungexp @var{obj} @var{output})"
  14975. msgstr ""
  14976. #. type: table
  14977. #: guix-git/doc/guix.texi:9670
  14978. msgid "This is like the form above, but referring explicitly to the @var{output} of @var{obj}---this is useful when @var{obj} produces multiple outputs (@pxref{Packages with Multiple Outputs})."
  14979. msgstr ""
  14980. #. type: item
  14981. #: guix-git/doc/guix.texi:9671
  14982. #, no-wrap
  14983. msgid "#+@var{obj}"
  14984. msgstr ""
  14985. #. type: itemx
  14986. #: guix-git/doc/guix.texi:9672
  14987. #, no-wrap
  14988. msgid "#+@var{obj}:output"
  14989. msgstr ""
  14990. #. type: itemx
  14991. #: guix-git/doc/guix.texi:9673
  14992. #, no-wrap
  14993. msgid "(ungexp-native @var{obj})"
  14994. msgstr ""
  14995. #. type: itemx
  14996. #: guix-git/doc/guix.texi:9674
  14997. #, no-wrap
  14998. msgid "(ungexp-native @var{obj} @var{output})"
  14999. msgstr ""
  15000. #. type: table
  15001. #: guix-git/doc/guix.texi:9677
  15002. msgid "Same as @code{ungexp}, but produces a reference to the @emph{native} build of @var{obj} when used in a cross compilation context."
  15003. msgstr ""
  15004. #. type: item
  15005. #: guix-git/doc/guix.texi:9678
  15006. #, no-wrap
  15007. msgid "#$output[:@var{output}]"
  15008. msgstr ""
  15009. #. type: itemx
  15010. #: guix-git/doc/guix.texi:9679
  15011. #, no-wrap
  15012. msgid "(ungexp output [@var{output}])"
  15013. msgstr ""
  15014. #. type: table
  15015. #: guix-git/doc/guix.texi:9682
  15016. msgid "Insert a reference to derivation output @var{output}, or to the main output when @var{output} is omitted."
  15017. msgstr ""
  15018. #. type: table
  15019. #: guix-git/doc/guix.texi:9684
  15020. msgid "This only makes sense for gexps passed to @code{gexp->derivation}."
  15021. msgstr ""
  15022. #. type: item
  15023. #: guix-git/doc/guix.texi:9685
  15024. #, no-wrap
  15025. msgid "#$@@@var{lst}"
  15026. msgstr ""
  15027. #. type: itemx
  15028. #: guix-git/doc/guix.texi:9686
  15029. #, no-wrap
  15030. msgid "(ungexp-splicing @var{lst})"
  15031. msgstr ""
  15032. #. type: table
  15033. #: guix-git/doc/guix.texi:9689
  15034. msgid "Like the above, but splices the contents of @var{lst} inside the containing list."
  15035. msgstr ""
  15036. #. type: item
  15037. #: guix-git/doc/guix.texi:9690
  15038. #, no-wrap
  15039. msgid "#+@@@var{lst}"
  15040. msgstr ""
  15041. #. type: itemx
  15042. #: guix-git/doc/guix.texi:9691
  15043. #, no-wrap
  15044. msgid "(ungexp-native-splicing @var{lst})"
  15045. msgstr ""
  15046. #. type: table
  15047. #: guix-git/doc/guix.texi:9694
  15048. msgid "Like the above, but refers to native builds of the objects listed in @var{lst}."
  15049. msgstr ""
  15050. #. type: deffn
  15051. #: guix-git/doc/guix.texi:9699
  15052. msgid "G-expressions created by @code{gexp} or @code{#~} are run-time objects of the @code{gexp?} type (see below)."
  15053. msgstr ""
  15054. #. type: deffn
  15055. #: guix-git/doc/guix.texi:9701
  15056. #, no-wrap
  15057. msgid "{Scheme Syntax} with-imported-modules @var{modules} @var{body}@dots{}"
  15058. msgstr ""
  15059. #. type: deffn
  15060. #: guix-git/doc/guix.texi:9704
  15061. msgid "Mark the gexps defined in @var{body}@dots{} as requiring @var{modules} in their execution environment."
  15062. msgstr ""
  15063. #. type: deffn
  15064. #: guix-git/doc/guix.texi:9708
  15065. msgid "Each item in @var{modules} can be the name of a module, such as @code{(guix build utils)}, or it can be a module name, followed by an arrow, followed by a file-like object:"
  15066. msgstr ""
  15067. #. type: lisp
  15068. #: guix-git/doc/guix.texi:9714
  15069. #, no-wrap
  15070. msgid ""
  15071. "`((guix build utils)\n"
  15072. " (guix gcrypt)\n"
  15073. " ((guix config) => ,(scheme-file \"config.scm\"\n"
  15074. " #~(define-module @dots{}))))\n"
  15075. msgstr ""
  15076. #. type: deffn
  15077. #: guix-git/doc/guix.texi:9719
  15078. msgid "In the example above, the first two modules are taken from the search path, and the last one is created from the given file-like object."
  15079. msgstr ""
  15080. #. type: deffn
  15081. #: guix-git/doc/guix.texi:9723
  15082. msgid "This form has @emph{lexical} scope: it has an effect on the gexps directly defined in @var{body}@dots{}, but not on those defined, say, in procedures called from @var{body}@dots{}."
  15083. msgstr ""
  15084. #. type: deffn
  15085. #: guix-git/doc/guix.texi:9725
  15086. #, no-wrap
  15087. msgid "{Scheme Syntax} with-extensions @var{extensions} @var{body}@dots{}"
  15088. msgstr ""
  15089. #. type: deffn
  15090. #: guix-git/doc/guix.texi:9730
  15091. msgid "Mark the gexps defined in @var{body}@dots{} as requiring @var{extensions} in their build and execution environment. @var{extensions} is typically a list of package objects such as those defined in the @code{(gnu packages guile)} module."
  15092. msgstr ""
  15093. #. type: deffn
  15094. #: guix-git/doc/guix.texi:9735
  15095. msgid "Concretely, the packages listed in @var{extensions} are added to the load path while compiling imported modules in @var{body}@dots{}; they are also added to the load path of the gexp returned by @var{body}@dots{}."
  15096. msgstr ""
  15097. #. type: deffn
  15098. #: guix-git/doc/guix.texi:9737
  15099. #, no-wrap
  15100. msgid "{Scheme Procedure} gexp? @var{obj}"
  15101. msgstr ""
  15102. #. type: deffn
  15103. #: guix-git/doc/guix.texi:9739
  15104. msgid "Return @code{#t} if @var{obj} is a G-expression."
  15105. msgstr ""
  15106. #. type: Plain text
  15107. #: guix-git/doc/guix.texi:9745
  15108. msgid "G-expressions are meant to be written to disk, either as code building some derivation, or as plain files in the store. The monadic procedures below allow you to do that (@pxref{The Store Monad}, for more information about monads)."
  15109. msgstr ""
  15110. #. type: deffn
  15111. #: guix-git/doc/guix.texi:9746
  15112. #, no-wrap
  15113. msgid "{Monadic Procedure} gexp->derivation @var{name} @var{exp} @"
  15114. msgstr ""
  15115. #. type: deffn
  15116. #: guix-git/doc/guix.texi:9764
  15117. msgid "[#:system (%current-system)] [#:target #f] [#:graft? #t] @ [#:hash #f] [#:hash-algo #f] @ [#:recursive? #f] [#:env-vars '()] [#:modules '()] @ [#:module-path @code{%load-path}] @ [#:effective-version \"2.2\"] @ [#:references-graphs #f] [#:allowed-references #f] @ [#:disallowed-references #f] @ [#:leaked-env-vars #f] @ [#:script-name (string-append @var{name} \"-builder\")] @ [#:deprecation-warnings #f] @ [#:local-build? #f] [#:substitutable? #t] @ [#:properties '()] [#:guile-for-build #f] Return a derivation @var{name} that runs @var{exp} (a gexp) with @var{guile-for-build} (a derivation) on @var{system}; @var{exp} is stored in a file called @var{script-name}. When @var{target} is true, it is used as the cross-compilation target triplet for packages referred to by @var{exp}."
  15118. msgstr ""
  15119. #. type: deffn
  15120. #: guix-git/doc/guix.texi:9772
  15121. msgid "@var{modules} is deprecated in favor of @code{with-imported-modules}. Its meaning is to make @var{modules} available in the evaluation context of @var{exp}; @var{modules} is a list of names of Guile modules searched in @var{module-path} to be copied in the store, compiled, and made available in the load path during the execution of @var{exp}---e.g., @code{((guix build utils) (guix build gnu-build-system))}."
  15122. msgstr ""
  15123. #. type: deffn
  15124. #: guix-git/doc/guix.texi:9775
  15125. msgid "@var{effective-version} determines the string to use when adding extensions of @var{exp} (see @code{with-extensions}) to the search path---e.g., @code{\"2.2\"}."
  15126. msgstr ""
  15127. #. type: deffn
  15128. #: guix-git/doc/guix.texi:9778
  15129. msgid "@var{graft?} determines whether packages referred to by @var{exp} should be grafted when applicable."
  15130. msgstr ""
  15131. #. type: deffn
  15132. #: guix-git/doc/guix.texi:9781
  15133. msgid "When @var{references-graphs} is true, it must be a list of tuples of one of the following forms:"
  15134. msgstr ""
  15135. #. type: example
  15136. #: guix-git/doc/guix.texi:9788
  15137. #, no-wrap
  15138. msgid ""
  15139. "(@var{file-name} @var{package})\n"
  15140. "(@var{file-name} @var{package} @var{output})\n"
  15141. "(@var{file-name} @var{derivation})\n"
  15142. "(@var{file-name} @var{derivation} @var{output})\n"
  15143. "(@var{file-name} @var{store-item})\n"
  15144. msgstr ""
  15145. #. type: deffn
  15146. #: guix-git/doc/guix.texi:9794
  15147. msgid "The right-hand-side of each element of @var{references-graphs} is automatically made an input of the build process of @var{exp}. In the build environment, each @var{file-name} contains the reference graph of the corresponding item, in a simple text format."
  15148. msgstr ""
  15149. #. type: deffn
  15150. #: guix-git/doc/guix.texi:9800
  15151. msgid "@var{allowed-references} must be either @code{#f} or a list of output names and packages. In the latter case, the list denotes store items that the result is allowed to refer to. Any reference to another store item will lead to a build error. Similarly for @var{disallowed-references}, which can list items that must not be referenced by the outputs."
  15152. msgstr ""
  15153. #. type: deffn
  15154. #: guix-git/doc/guix.texi:9803
  15155. msgid "@var{deprecation-warnings} determines whether to show deprecation warnings while compiling modules. It can be @code{#f}, @code{#t}, or @code{'detailed}."
  15156. msgstr ""
  15157. #. type: deffn
  15158. #: guix-git/doc/guix.texi:9805
  15159. msgid "The other arguments are as for @code{derivation} (@pxref{Derivations})."
  15160. msgstr ""
  15161. #. type: cindex
  15162. #: guix-git/doc/guix.texi:9807
  15163. #, no-wrap
  15164. msgid "file-like objects"
  15165. msgstr ""
  15166. #. type: Plain text
  15167. #: guix-git/doc/guix.texi:9812
  15168. msgid "The @code{local-file}, @code{plain-file}, @code{computed-file}, @code{program-file}, and @code{scheme-file} procedures below return @dfn{file-like objects}. That is, when unquoted in a G-expression, these objects lead to a file in the store. Consider this G-expression:"
  15169. msgstr ""
  15170. #. type: lisp
  15171. #: guix-git/doc/guix.texi:9816
  15172. #, no-wrap
  15173. msgid ""
  15174. "#~(system* #$(file-append glibc \"/sbin/nscd\") \"-f\"\n"
  15175. " #$(local-file \"/tmp/my-nscd.conf\"))\n"
  15176. msgstr ""
  15177. #. type: Plain text
  15178. #: guix-git/doc/guix.texi:9825
  15179. msgid "The effect here is to ``intern'' @file{/tmp/my-nscd.conf} by copying it to the store. Once expanded, for instance @i{via} @code{gexp->derivation}, the G-expression refers to that copy under @file{/gnu/store}; thus, modifying or removing the file in @file{/tmp} does not have any effect on what the G-expression does. @code{plain-file} can be used similarly; it differs in that the file content is directly passed as a string."
  15180. msgstr ""
  15181. #. type: deffn
  15182. #: guix-git/doc/guix.texi:9826
  15183. #, no-wrap
  15184. msgid "{Scheme Procedure} local-file @var{file} [@var{name}] @"
  15185. msgstr ""
  15186. #. type: deffn
  15187. #: guix-git/doc/guix.texi:9835
  15188. msgid "[#:recursive? #f] [#:select? (const #t)] Return an object representing local file @var{file} to add to the store; this object can be used in a gexp. If @var{file} is a literal string denoting a relative file name, it is looked up relative to the source file where it appears; if @var{file} is not a literal string, it is looked up relative to the current working directory at run time. @var{file} will be added to the store under @var{name}--by default the base name of @var{file}."
  15189. msgstr ""
  15190. #. type: deffn
  15191. #: guix-git/doc/guix.texi:9847
  15192. msgid "This is the declarative counterpart of the @code{interned-file} monadic procedure (@pxref{The Store Monad, @code{interned-file}})."
  15193. msgstr ""
  15194. #. type: deffn
  15195. #: guix-git/doc/guix.texi:9849
  15196. #, no-wrap
  15197. msgid "{Scheme Procedure} plain-file @var{name} @var{content}"
  15198. msgstr ""
  15199. #. type: deffn
  15200. #: guix-git/doc/guix.texi:9852
  15201. msgid "Return an object representing a text file called @var{name} with the given @var{content} (a string or a bytevector) to be added to the store."
  15202. msgstr ""
  15203. #. type: deffn
  15204. #: guix-git/doc/guix.texi:9854
  15205. msgid "This is the declarative counterpart of @code{text-file}."
  15206. msgstr ""
  15207. #. type: deffn
  15208. #: guix-git/doc/guix.texi:9856
  15209. #, no-wrap
  15210. msgid "{Scheme Procedure} computed-file @var{name} @var{gexp} @"
  15211. msgstr ""
  15212. #. type: deffn
  15213. #: guix-git/doc/guix.texi:9863
  15214. msgid "[#:local-build? #t] [#:options '()] Return an object representing the store item @var{name}, a file or directory computed by @var{gexp}. When @var{local-build?} is true (the default), the derivation is built locally. @var{options} is a list of additional arguments to pass to @code{gexp->derivation}."
  15215. msgstr ""
  15216. #. type: deffn
  15217. #: guix-git/doc/guix.texi:9865
  15218. msgid "This is the declarative counterpart of @code{gexp->derivation}."
  15219. msgstr ""
  15220. #. type: deffn
  15221. #: guix-git/doc/guix.texi:9867
  15222. #, no-wrap
  15223. msgid "{Monadic Procedure} gexp->script @var{name} @var{exp} @"
  15224. msgstr ""
  15225. #. type: deffn
  15226. #: guix-git/doc/guix.texi:9873
  15227. msgid "[#:guile (default-guile)] [#:module-path %load-path] @ [#:system (%current-system)] [#:target #f] Return an executable script @var{name} that runs @var{exp} using @var{guile}, with @var{exp}'s imported modules in its search path. Look up @var{exp}'s modules in @var{module-path}."
  15228. msgstr ""
  15229. #. type: deffn
  15230. #: guix-git/doc/guix.texi:9876
  15231. msgid "The example below builds a script that simply invokes the @command{ls} command:"
  15232. msgstr ""
  15233. #. type: lisp
  15234. #: guix-git/doc/guix.texi:9879
  15235. #, no-wrap
  15236. msgid ""
  15237. "(use-modules (guix gexp) (gnu packages base))\n"
  15238. "\n"
  15239. msgstr ""
  15240. #. type: lisp
  15241. #: guix-git/doc/guix.texi:9883
  15242. #, no-wrap
  15243. msgid ""
  15244. "(gexp->script \"list-files\"\n"
  15245. " #~(execl #$(file-append coreutils \"/bin/ls\")\n"
  15246. " \"ls\"))\n"
  15247. msgstr ""
  15248. #. type: deffn
  15249. #: guix-git/doc/guix.texi:9888
  15250. msgid "When ``running'' it through the store (@pxref{The Store Monad, @code{run-with-store}}), we obtain a derivation that produces an executable file @file{/gnu/store/@dots{}-list-files} along these lines:"
  15251. msgstr ""
  15252. #. type: example
  15253. #: guix-git/doc/guix.texi:9893
  15254. #, no-wrap
  15255. msgid ""
  15256. "#!/gnu/store/@dots{}-guile-2.0.11/bin/guile -ds\n"
  15257. "!#\n"
  15258. "(execl \"/gnu/store/@dots{}-coreutils-8.22\"/bin/ls\" \"ls\")\n"
  15259. msgstr ""
  15260. #. type: deffn
  15261. #: guix-git/doc/guix.texi:9896
  15262. #, no-wrap
  15263. msgid "{Scheme Procedure} program-file @var{name} @var{exp} @"
  15264. msgstr ""
  15265. #. type: deffn
  15266. #: guix-git/doc/guix.texi:9901
  15267. msgid "[#:guile #f] [#:module-path %load-path] Return an object representing the executable store item @var{name} that runs @var{gexp}. @var{guile} is the Guile package used to execute that script. Imported modules of @var{gexp} are looked up in @var{module-path}."
  15268. msgstr ""
  15269. #. type: deffn
  15270. #: guix-git/doc/guix.texi:9903
  15271. msgid "This is the declarative counterpart of @code{gexp->script}."
  15272. msgstr ""
  15273. #. type: deffn
  15274. #: guix-git/doc/guix.texi:9905
  15275. #, no-wrap
  15276. msgid "{Monadic Procedure} gexp->file @var{name} @var{exp} @"
  15277. msgstr ""
  15278. #. type: deffn
  15279. #: guix-git/doc/guix.texi:9912
  15280. msgid "[#:set-load-path? #t] [#:module-path %load-path] @ [#:splice? #f] @ [#:guile (default-guile)] Return a derivation that builds a file @var{name} containing @var{exp}. When @var{splice?} is true, @var{exp} is considered to be a list of expressions that will be spliced in the resulting file."
  15281. msgstr ""
  15282. #. type: deffn
  15283. #: guix-git/doc/guix.texi:9917
  15284. msgid "When @var{set-load-path?} is true, emit code in the resulting file to set @code{%load-path} and @code{%load-compiled-path} to honor @var{exp}'s imported modules. Look up @var{exp}'s modules in @var{module-path}."
  15285. msgstr ""
  15286. #. type: deffn
  15287. #: guix-git/doc/guix.texi:9920
  15288. msgid "The resulting file holds references to all the dependencies of @var{exp} or a subset thereof."
  15289. msgstr ""
  15290. #. type: deffn
  15291. #: guix-git/doc/guix.texi:9922
  15292. #, no-wrap
  15293. msgid "{Scheme Procedure} scheme-file @var{name} @var{exp} @"
  15294. msgstr ""
  15295. #. type: deffn
  15296. #: guix-git/doc/guix.texi:9926
  15297. msgid "[#:splice? #f] [#:set-load-path? #t] Return an object representing the Scheme file @var{name} that contains @var{exp}."
  15298. msgstr ""
  15299. #. type: deffn
  15300. #: guix-git/doc/guix.texi:9928
  15301. msgid "This is the declarative counterpart of @code{gexp->file}."
  15302. msgstr ""
  15303. #. type: deffn
  15304. #: guix-git/doc/guix.texi:9930
  15305. #, no-wrap
  15306. msgid "{Monadic Procedure} text-file* @var{name} @var{text} @dots{}"
  15307. msgstr ""
  15308. #. type: deffn
  15309. #: guix-git/doc/guix.texi:9936
  15310. msgid "Return as a monadic value a derivation that builds a text file containing all of @var{text}. @var{text} may list, in addition to strings, objects of any type that can be used in a gexp: packages, derivations, local file objects, etc. The resulting store file holds references to all these."
  15311. msgstr ""
  15312. #. type: deffn
  15313. #: guix-git/doc/guix.texi:9941
  15314. msgid "This variant should be preferred over @code{text-file} anytime the file to create will reference items from the store. This is typically the case when building a configuration file that embeds store file names, like this:"
  15315. msgstr ""
  15316. #. type: lisp
  15317. #: guix-git/doc/guix.texi:9949
  15318. #, no-wrap
  15319. msgid ""
  15320. "(define (profile.sh)\n"
  15321. " ;; Return the name of a shell script in the store that\n"
  15322. " ;; initializes the 'PATH' environment variable.\n"
  15323. " (text-file* \"profile.sh\"\n"
  15324. " \"export PATH=\" coreutils \"/bin:\"\n"
  15325. " grep \"/bin:\" sed \"/bin\\n\"))\n"
  15326. msgstr ""
  15327. #. type: deffn
  15328. #: guix-git/doc/guix.texi:9954
  15329. msgid "In this example, the resulting @file{/gnu/store/@dots{}-profile.sh} file will reference @var{coreutils}, @var{grep}, and @var{sed}, thereby preventing them from being garbage-collected during its lifetime."
  15330. msgstr ""
  15331. #. type: deffn
  15332. #: guix-git/doc/guix.texi:9956
  15333. #, no-wrap
  15334. msgid "{Scheme Procedure} mixed-text-file @var{name} @var{text} @dots{}"
  15335. msgstr ""
  15336. #. type: deffn
  15337. #: guix-git/doc/guix.texi:9960
  15338. msgid "Return an object representing store file @var{name} containing @var{text}. @var{text} is a sequence of strings and file-like objects, as in:"
  15339. msgstr ""
  15340. #. type: lisp
  15341. #: guix-git/doc/guix.texi:9964
  15342. #, no-wrap
  15343. msgid ""
  15344. "(mixed-text-file \"profile\"\n"
  15345. " \"export PATH=\" coreutils \"/bin:\" grep \"/bin\")\n"
  15346. msgstr ""
  15347. #. type: deffn
  15348. #: guix-git/doc/guix.texi:9967
  15349. msgid "This is the declarative counterpart of @code{text-file*}."
  15350. msgstr ""
  15351. #. type: deffn
  15352. #: guix-git/doc/guix.texi:9969
  15353. #, no-wrap
  15354. msgid "{Scheme Procedure} file-union @var{name} @var{files}"
  15355. msgstr ""
  15356. #. type: deffn
  15357. #: guix-git/doc/guix.texi:9974
  15358. msgid "Return a @code{<computed-file>} that builds a directory containing all of @var{files}. Each item in @var{files} must be a two-element list where the first element is the file name to use in the new directory, and the second element is a gexp denoting the target file. Here's an example:"
  15359. msgstr ""
  15360. #. type: lisp
  15361. #: guix-git/doc/guix.texi:9981
  15362. #, no-wrap
  15363. msgid ""
  15364. "(file-union \"etc\"\n"
  15365. " `((\"hosts\" ,(plain-file \"hosts\"\n"
  15366. " \"127.0.0.1 localhost\"))\n"
  15367. " (\"bashrc\" ,(plain-file \"bashrc\"\n"
  15368. " \"alias ls='ls --color=auto'\"))))\n"
  15369. msgstr ""
  15370. #. type: deffn
  15371. #: guix-git/doc/guix.texi:9984
  15372. msgid "This yields an @code{etc} directory containing these two files."
  15373. msgstr ""
  15374. #. type: deffn
  15375. #: guix-git/doc/guix.texi:9986
  15376. #, no-wrap
  15377. msgid "{Scheme Procedure} directory-union @var{name} @var{things}"
  15378. msgstr ""
  15379. #. type: deffn
  15380. #: guix-git/doc/guix.texi:9989
  15381. msgid "Return a directory that is the union of @var{things}, where @var{things} is a list of file-like objects denoting directories. For example:"
  15382. msgstr ""
  15383. #. type: lisp
  15384. #: guix-git/doc/guix.texi:9992
  15385. #, no-wrap
  15386. msgid "(directory-union \"guile+emacs\" (list guile emacs))\n"
  15387. msgstr ""
  15388. #. type: deffn
  15389. #: guix-git/doc/guix.texi:9995
  15390. msgid "yields a directory that is the union of the @code{guile} and @code{emacs} packages."
  15391. msgstr ""
  15392. #. type: deffn
  15393. #: guix-git/doc/guix.texi:9997
  15394. #, no-wrap
  15395. msgid "{Scheme Procedure} file-append @var{obj} @var{suffix} @dots{}"
  15396. msgstr ""
  15397. #. type: deffn
  15398. #: guix-git/doc/guix.texi:10001
  15399. msgid "Return a file-like object that expands to the concatenation of @var{obj} and @var{suffix}, where @var{obj} is a lowerable object and each @var{suffix} is a string."
  15400. msgstr ""
  15401. #. type: deffn
  15402. #: guix-git/doc/guix.texi:10003
  15403. msgid "As an example, consider this gexp:"
  15404. msgstr ""
  15405. #. type: lisp
  15406. #: guix-git/doc/guix.texi:10008
  15407. #, no-wrap
  15408. msgid ""
  15409. "(gexp->script \"run-uname\"\n"
  15410. " #~(system* #$(file-append coreutils\n"
  15411. " \"/bin/uname\")))\n"
  15412. msgstr ""
  15413. #. type: deffn
  15414. #: guix-git/doc/guix.texi:10011
  15415. msgid "The same effect could be achieved with:"
  15416. msgstr ""
  15417. #. type: lisp
  15418. #: guix-git/doc/guix.texi:10016
  15419. #, no-wrap
  15420. msgid ""
  15421. "(gexp->script \"run-uname\"\n"
  15422. " #~(system* (string-append #$coreutils\n"
  15423. " \"/bin/uname\")))\n"
  15424. msgstr ""
  15425. #. type: deffn
  15426. #: guix-git/doc/guix.texi:10022
  15427. msgid "There is one difference though: in the @code{file-append} case, the resulting script contains the absolute file name as a string, whereas in the second case, the resulting script contains a @code{(string-append @dots{})} expression to construct the file name @emph{at run time}."
  15428. msgstr ""
  15429. #. type: deffn
  15430. #: guix-git/doc/guix.texi:10024
  15431. #, no-wrap
  15432. msgid "{Scheme Syntax} let-system @var{system} @var{body}@dots{}"
  15433. msgstr ""
  15434. #. type: deffnx
  15435. #: guix-git/doc/guix.texi:10025
  15436. #, no-wrap
  15437. msgid "{Scheme Syntax} let-system (@var{system} @var{target}) @var{body}@dots{}"
  15438. msgstr ""
  15439. #. type: deffn
  15440. #: guix-git/doc/guix.texi:10028
  15441. msgid "Bind @var{system} to the currently targeted system---e.g., @code{\"x86_64-linux\"}---within @var{body}."
  15442. msgstr ""
  15443. #. type: deffn
  15444. #: guix-git/doc/guix.texi:10033
  15445. msgid "In the second case, additionally bind @var{target} to the current cross-compilation target---a GNU triplet such as @code{\"arm-linux-gnueabihf\"}---or @code{#f} if we are not cross-compiling."
  15446. msgstr ""
  15447. #. type: deffn
  15448. #: guix-git/doc/guix.texi:10036
  15449. msgid "@code{let-system} is useful in the occasional case where the object spliced into the gexp depends on the target system, as in this example:"
  15450. msgstr ""
  15451. #. type: lisp
  15452. #: guix-git/doc/guix.texi:10047
  15453. #, no-wrap
  15454. msgid ""
  15455. "#~(system*\n"
  15456. " #+(let-system system\n"
  15457. " (cond ((string-prefix? \"armhf-\" system)\n"
  15458. " (file-append qemu \"/bin/qemu-system-arm\"))\n"
  15459. " ((string-prefix? \"x86_64-\" system)\n"
  15460. " (file-append qemu \"/bin/qemu-system-x86_64\"))\n"
  15461. " (else\n"
  15462. " (error \"dunno!\"))))\n"
  15463. " \"-net\" \"user\" #$image)\n"
  15464. msgstr ""
  15465. #. type: deffn
  15466. #: guix-git/doc/guix.texi:10050
  15467. #, no-wrap
  15468. msgid "{Scheme Syntax} with-parameters ((@var{parameter} @var{value}) @dots{}) @var{exp}"
  15469. msgstr ""
  15470. #. type: deffn
  15471. #: guix-git/doc/guix.texi:10056
  15472. msgid "This macro is similar to the @code{parameterize} form for dynamically-bound @dfn{parameters} (@pxref{Parameters,,, guile, GNU Guile Reference Manual}). The key difference is that it takes effect when the file-like object returned by @var{exp} is lowered to a derivation or store item."
  15473. msgstr ""
  15474. #. type: deffn
  15475. #: guix-git/doc/guix.texi:10059
  15476. msgid "A typical use of @code{with-parameters} is to force the system in effect for a given object:"
  15477. msgstr ""
  15478. #. type: lisp
  15479. #: guix-git/doc/guix.texi:10063
  15480. #, no-wrap
  15481. msgid ""
  15482. "(with-parameters ((%current-system \"i686-linux\"))\n"
  15483. " coreutils)\n"
  15484. msgstr ""
  15485. #. type: deffn
  15486. #: guix-git/doc/guix.texi:10067
  15487. msgid "The example above returns an object that corresponds to the i686 build of Coreutils, regardless of the current value of @code{%current-system}."
  15488. msgstr ""
  15489. #. type: Plain text
  15490. #: guix-git/doc/guix.texi:10074
  15491. msgid "Of course, in addition to gexps embedded in ``host'' code, there are also modules containing build tools. To make it clear that they are meant to be used in the build stratum, these modules are kept in the @code{(guix build @dots{})} name space."
  15492. msgstr ""
  15493. #. type: Plain text
  15494. #: guix-git/doc/guix.texi:10080
  15495. msgid "Internally, high-level objects are @dfn{lowered}, using their compiler, to either derivations or store items. For instance, lowering a package yields a derivation, and lowering a @code{plain-file} yields a store item. This is achieved using the @code{lower-object} monadic procedure."
  15496. msgstr ""
  15497. #. type: deffn
  15498. #: guix-git/doc/guix.texi:10081
  15499. #, no-wrap
  15500. msgid "{Monadic Procedure} lower-object @var{obj} [@var{system}] @"
  15501. msgstr ""
  15502. #. type: deffn
  15503. #: guix-git/doc/guix.texi:10087
  15504. msgid "[#:target #f] Return as a value in @code{%store-monad} the derivation or store item corresponding to @var{obj} for @var{system}, cross-compiling for @var{target} if @var{target} is true. @var{obj} must be an object that has an associated gexp compiler, such as a @code{<package>}."
  15505. msgstr ""
  15506. #. type: deffn
  15507. #: guix-git/doc/guix.texi:10089
  15508. #, no-wrap
  15509. msgid "{Procedure} gexp->approximate-sexp @var{gexp}"
  15510. msgstr ""
  15511. #. type: deffn
  15512. #: guix-git/doc/guix.texi:10097
  15513. msgid "Sometimes, it may be useful to convert a G-exp into a S-exp. For example, some linters (@pxref{Invoking guix lint}) peek into the build phases of a package to detect potential problems. This conversion can be achieved with this procedure. However, some information can be lost in the process. More specifically, lowerable objects will be silently replaced with some arbitrary object -- currently the list @code{(*approximate*)}, but this may change."
  15514. msgstr ""
  15515. #. type: section
  15516. #: guix-git/doc/guix.texi:10100
  15517. #, no-wrap
  15518. msgid "Invoking @command{guix repl}"
  15519. msgstr ""
  15520. #. type: cindex
  15521. #: guix-git/doc/guix.texi:10102
  15522. #, no-wrap
  15523. msgid "REPL, read-eval-print loop, script"
  15524. msgstr ""
  15525. #. type: Plain text
  15526. #: guix-git/doc/guix.texi:10112
  15527. msgid "The @command{guix repl} command makes it easier to program Guix in Guile by launching a Guile @dfn{read-eval-print loop} (REPL) for interactive programming (@pxref{Using Guile Interactively,,, guile, GNU Guile Reference Manual}), or by running Guile scripts (@pxref{Running Guile Scripts,,, guile, GNU Guile Reference Manual}). Compared to just launching the @command{guile} command, @command{guix repl} guarantees that all the Guix modules and all its dependencies are available in the search path."
  15528. msgstr ""
  15529. #. type: example
  15530. #: guix-git/doc/guix.texi:10117
  15531. #, no-wrap
  15532. msgid "guix repl @var{options} [@var{file} @var{args}]\n"
  15533. msgstr ""
  15534. #. type: Plain text
  15535. #: guix-git/doc/guix.texi:10121
  15536. msgid "When a @var{file} argument is provided, @var{file} is executed as a Guile scripts:"
  15537. msgstr ""
  15538. #. type: example
  15539. #: guix-git/doc/guix.texi:10124
  15540. #, no-wrap
  15541. msgid "guix repl my-script.scm\n"
  15542. msgstr ""
  15543. #. type: Plain text
  15544. #: guix-git/doc/guix.texi:10128
  15545. msgid "To pass arguments to the script, use @code{--} to prevent them from being interpreted as arguments to @command{guix repl} itself:"
  15546. msgstr ""
  15547. #. type: example
  15548. #: guix-git/doc/guix.texi:10131
  15549. #, no-wrap
  15550. msgid "guix repl -- my-script.scm --input=foo.txt\n"
  15551. msgstr ""
  15552. #. type: Plain text
  15553. #: guix-git/doc/guix.texi:10136
  15554. msgid "To make a script executable directly from the shell, using the guix executable that is on the user's search path, add the following two lines at the top of the script:"
  15555. msgstr ""
  15556. #. type: example
  15557. #: guix-git/doc/guix.texi:10140
  15558. #, no-wrap
  15559. msgid ""
  15560. "@code{#!/usr/bin/env -S guix repl --}\n"
  15561. "@code{!#}\n"
  15562. msgstr ""
  15563. #. type: Plain text
  15564. #: guix-git/doc/guix.texi:10143
  15565. msgid "Without a file name argument, a Guile REPL is started:"
  15566. msgstr ""
  15567. #. type: example
  15568. #: guix-git/doc/guix.texi:10149
  15569. #, no-wrap
  15570. msgid ""
  15571. "$ guix repl\n"
  15572. "scheme@@(guile-user)> ,use (gnu packages base)\n"
  15573. "scheme@@(guile-user)> coreutils\n"
  15574. "$1 = #<package coreutils@@8.29 gnu/packages/base.scm:327 3e28300>\n"
  15575. msgstr ""
  15576. #. type: Plain text
  15577. #: guix-git/doc/guix.texi:10156
  15578. msgid "In addition, @command{guix repl} implements a simple machine-readable REPL protocol for use by @code{(guix inferior)}, a facility to interact with @dfn{inferiors}, separate processes running a potentially different revision of Guix."
  15579. msgstr ""
  15580. #. type: Plain text
  15581. #: guix-git/doc/guix.texi:10158
  15582. msgid "The available options are as follows:"
  15583. msgstr ""
  15584. #. type: item
  15585. #: guix-git/doc/guix.texi:10160 guix-git/doc/guix.texi:12595
  15586. #, no-wrap
  15587. msgid "--type=@var{type}"
  15588. msgstr ""
  15589. #. type: itemx
  15590. #: guix-git/doc/guix.texi:10161 guix-git/doc/guix.texi:12596
  15591. #: guix-git/doc/guix.texi:33873
  15592. #, no-wrap
  15593. msgid "-t @var{type}"
  15594. msgstr ""
  15595. #. type: table
  15596. #: guix-git/doc/guix.texi:10163
  15597. msgid "Start a REPL of the given @var{TYPE}, which can be one of the following:"
  15598. msgstr ""
  15599. #. type: item
  15600. #: guix-git/doc/guix.texi:10165
  15601. #, no-wrap
  15602. msgid "guile"
  15603. msgstr ""
  15604. #. type: table
  15605. #: guix-git/doc/guix.texi:10167
  15606. msgid "This is default, and it spawns a standard full-featured Guile REPL."
  15607. msgstr ""
  15608. #. type: item
  15609. #: guix-git/doc/guix.texi:10167
  15610. #, no-wrap
  15611. msgid "machine"
  15612. msgstr ""
  15613. #. type: table
  15614. #: guix-git/doc/guix.texi:10170
  15615. msgid "Spawn a REPL that uses the machine-readable protocol. This is the protocol that the @code{(guix inferior)} module speaks."
  15616. msgstr ""
  15617. #. type: table
  15618. #: guix-git/doc/guix.texi:10176
  15619. msgid "By default, @command{guix repl} reads from standard input and writes to standard output. When this option is passed, it will instead listen for connections on @var{endpoint}. Here are examples of valid options:"
  15620. msgstr ""
  15621. #. type: item
  15622. #: guix-git/doc/guix.texi:10178
  15623. #, no-wrap
  15624. msgid "--listen=tcp:37146"
  15625. msgstr ""
  15626. #. type: table
  15627. #: guix-git/doc/guix.texi:10180
  15628. msgid "Accept connections on localhost on port 37146."
  15629. msgstr ""
  15630. #. type: item
  15631. #: guix-git/doc/guix.texi:10181
  15632. #, no-wrap
  15633. msgid "--listen=unix:/tmp/socket"
  15634. msgstr ""
  15635. #. type: table
  15636. #: guix-git/doc/guix.texi:10183
  15637. msgid "Accept connections on the Unix-domain socket @file{/tmp/socket}."
  15638. msgstr ""
  15639. #. type: item
  15640. #: guix-git/doc/guix.texi:10185 guix-git/doc/guix.texi:10289
  15641. #: guix-git/doc/guix.texi:12064 guix-git/doc/guix.texi:12244
  15642. #: guix-git/doc/guix.texi:12389 guix-git/doc/guix.texi:12643
  15643. #, no-wrap
  15644. msgid "--load-path=@var{directory}"
  15645. msgstr ""
  15646. #. type: itemx
  15647. #: guix-git/doc/guix.texi:10186 guix-git/doc/guix.texi:10290
  15648. #: guix-git/doc/guix.texi:12245 guix-git/doc/guix.texi:12390
  15649. #: guix-git/doc/guix.texi:12644
  15650. #, no-wrap
  15651. msgid "-L @var{directory}"
  15652. msgstr ""
  15653. #. type: table
  15654. #: guix-git/doc/guix.texi:10189 guix-git/doc/guix.texi:10293
  15655. #: guix-git/doc/guix.texi:12067 guix-git/doc/guix.texi:12248
  15656. #: guix-git/doc/guix.texi:12393 guix-git/doc/guix.texi:12647
  15657. msgid "Add @var{directory} to the front of the package module search path (@pxref{Package Modules})."
  15658. msgstr ""
  15659. #. type: table
  15660. #: guix-git/doc/guix.texi:10192
  15661. msgid "This allows users to define their own packages and make them visible to the script or REPL."
  15662. msgstr ""
  15663. #. type: itemx
  15664. #: guix-git/doc/guix.texi:10193 guix-git/doc/guix.texi:10752
  15665. #, no-wrap
  15666. msgid "-q"
  15667. msgstr ""
  15668. #. type: table
  15669. #: guix-git/doc/guix.texi:10196
  15670. msgid "Inhibit loading of the @file{~/.guile} file. By default, that configuration file is loaded when spawning a @code{guile} REPL."
  15671. msgstr ""
  15672. #. type: Plain text
  15673. #: guix-git/doc/guix.texi:10206
  15674. msgid "This section describes Guix command-line utilities. Some of them are primarily targeted at developers and users who write new package definitions, while others are more generally useful. They complement the Scheme programming interface of Guix in a convenient way."
  15675. msgstr ""
  15676. #. type: cindex
  15677. #: guix-git/doc/guix.texi:10228
  15678. #, no-wrap
  15679. msgid "package building"
  15680. msgstr ""
  15681. #. type: command{#1}
  15682. #: guix-git/doc/guix.texi:10229
  15683. #, no-wrap
  15684. msgid "guix build"
  15685. msgstr ""
  15686. #. type: Plain text
  15687. #: guix-git/doc/guix.texi:10235
  15688. msgid "The @command{guix build} command builds packages or derivations and their dependencies, and prints the resulting store paths. Note that it does not modify the user's profile---this is the job of the @command{guix package} command (@pxref{Invoking guix package}). Thus, it is mainly useful for distribution developers."
  15689. msgstr ""
  15690. #. type: example
  15691. #: guix-git/doc/guix.texi:10240
  15692. #, no-wrap
  15693. msgid "guix build @var{options} @var{package-or-derivation}@dots{}\n"
  15694. msgstr ""
  15695. #. type: Plain text
  15696. #: guix-git/doc/guix.texi:10245
  15697. msgid "As an example, the following command builds the latest versions of Emacs and of Guile, displays their build logs, and finally displays the resulting directories:"
  15698. msgstr ""
  15699. #. type: example
  15700. #: guix-git/doc/guix.texi:10248
  15701. #, no-wrap
  15702. msgid "guix build emacs guile\n"
  15703. msgstr ""
  15704. #. type: Plain text
  15705. #: guix-git/doc/guix.texi:10251
  15706. msgid "Similarly, the following command builds all the available packages:"
  15707. msgstr ""
  15708. #. type: example
  15709. #: guix-git/doc/guix.texi:10255
  15710. #, no-wrap
  15711. msgid ""
  15712. "guix build --quiet --keep-going \\\n"
  15713. " $(guix package -A | awk '@{ print $1 \"@@\" $2 @}')\n"
  15714. msgstr ""
  15715. #. type: Plain text
  15716. #: guix-git/doc/guix.texi:10263
  15717. msgid "@var{package-or-derivation} may be either the name of a package found in the software distribution such as @code{coreutils} or @code{coreutils@@8.20}, or a derivation such as @file{/gnu/store/@dots{}-coreutils-8.19.drv}. In the former case, a package with the corresponding name (and optionally version) is searched for among the GNU distribution modules (@pxref{Package Modules})."
  15718. msgstr ""
  15719. #. type: Plain text
  15720. #: guix-git/doc/guix.texi:10268
  15721. msgid "Alternatively, the @option{--expression} option may be used to specify a Scheme expression that evaluates to a package; this is useful when disambiguating among several same-named packages or package variants is needed."
  15722. msgstr ""
  15723. #. type: Plain text
  15724. #: guix-git/doc/guix.texi:10271
  15725. msgid "There may be zero or more @var{options}. The available options are described in the subsections below."
  15726. msgstr ""
  15727. #. type: Plain text
  15728. #: guix-git/doc/guix.texi:10286
  15729. msgid "A number of options that control the build process are common to @command{guix build} and other commands that can spawn builds, such as @command{guix package} or @command{guix archive}. These are the following:"
  15730. msgstr ""
  15731. #. type: table
  15732. #: guix-git/doc/guix.texi:10296 guix-git/doc/guix.texi:12070
  15733. #: guix-git/doc/guix.texi:12251 guix-git/doc/guix.texi:12396
  15734. #: guix-git/doc/guix.texi:12650
  15735. msgid "This allows users to define their own packages and make them visible to the command-line tools."
  15736. msgstr ""
  15737. #. type: item
  15738. #: guix-git/doc/guix.texi:10297
  15739. #, no-wrap
  15740. msgid "--keep-failed"
  15741. msgstr ""
  15742. #. type: itemx
  15743. #: guix-git/doc/guix.texi:10298
  15744. #, no-wrap
  15745. msgid "-K"
  15746. msgstr ""
  15747. #. type: table
  15748. #: guix-git/doc/guix.texi:10304
  15749. msgid "Keep the build tree of failed builds. Thus, if a build fails, its build tree is kept under @file{/tmp}, in a directory whose name is shown at the end of the build log. This is useful when debugging build issues. @xref{Debugging Build Failures}, for tips and tricks on how to debug build issues."
  15750. msgstr ""
  15751. #. type: table
  15752. #: guix-git/doc/guix.texi:10308
  15753. msgid "This option implies @option{--no-offload}, and it has no effect when connecting to a remote daemon with a @code{guix://} URI (@pxref{The Store, the @env{GUIX_DAEMON_SOCKET} variable})."
  15754. msgstr ""
  15755. #. type: item
  15756. #: guix-git/doc/guix.texi:10309
  15757. #, no-wrap
  15758. msgid "--keep-going"
  15759. msgstr ""
  15760. #. type: itemx
  15761. #: guix-git/doc/guix.texi:10310
  15762. #, no-wrap
  15763. msgid "-k"
  15764. msgstr ""
  15765. #. type: table
  15766. #: guix-git/doc/guix.texi:10313
  15767. msgid "Keep going when some of the derivations fail to build; return only once all the builds have either completed or failed."
  15768. msgstr ""
  15769. #. type: table
  15770. #: guix-git/doc/guix.texi:10316
  15771. msgid "The default behavior is to stop as soon as one of the specified derivations has failed."
  15772. msgstr ""
  15773. #. type: table
  15774. #: guix-git/doc/guix.texi:10320
  15775. msgid "Do not build the derivations."
  15776. msgstr ""
  15777. #. type: anchor{#1}
  15778. #: guix-git/doc/guix.texi:10322
  15779. msgid "fallback-option"
  15780. msgstr ""
  15781. #. type: item
  15782. #: guix-git/doc/guix.texi:10322
  15783. #, no-wrap
  15784. msgid "--fallback"
  15785. msgstr ""
  15786. #. type: table
  15787. #: guix-git/doc/guix.texi:10325
  15788. msgid "When substituting a pre-built binary fails, fall back to building packages locally (@pxref{Substitution Failure})."
  15789. msgstr ""
  15790. #. type: anchor{#1}
  15791. #: guix-git/doc/guix.texi:10331
  15792. msgid "client-substitute-urls"
  15793. msgstr ""
  15794. #. type: table
  15795. #: guix-git/doc/guix.texi:10331
  15796. msgid "Consider @var{urls} the whitespace-separated list of substitute source URLs, overriding the default list of URLs of @command{guix-daemon} (@pxref{daemon-substitute-urls,, @command{guix-daemon} URLs})."
  15797. msgstr ""
  15798. #. type: table
  15799. #: guix-git/doc/guix.texi:10335
  15800. msgid "This means that substitutes may be downloaded from @var{urls}, provided they are signed by a key authorized by the system administrator (@pxref{Substitutes})."
  15801. msgstr ""
  15802. #. type: table
  15803. #: guix-git/doc/guix.texi:10338
  15804. msgid "When @var{urls} is the empty string, substitutes are effectively disabled."
  15805. msgstr ""
  15806. #. type: item
  15807. #: guix-git/doc/guix.texi:10344
  15808. #, no-wrap
  15809. msgid "--no-grafts"
  15810. msgstr ""
  15811. #. type: table
  15812. #: guix-git/doc/guix.texi:10348
  15813. msgid "Do not ``graft'' packages. In practice, this means that package updates available as grafts are not applied. @xref{Security Updates}, for more information on grafts."
  15814. msgstr ""
  15815. #. type: item
  15816. #: guix-git/doc/guix.texi:10349
  15817. #, no-wrap
  15818. msgid "--rounds=@var{n}"
  15819. msgstr ""
  15820. #. type: table
  15821. #: guix-git/doc/guix.texi:10352
  15822. msgid "Build each derivation @var{n} times in a row, and raise an error if consecutive build results are not bit-for-bit identical."
  15823. msgstr ""
  15824. #. type: table
  15825. #: guix-git/doc/guix.texi:10357
  15826. msgid "This is a useful way to detect non-deterministic builds processes. Non-deterministic build processes are a problem because they make it practically impossible for users to @emph{verify} whether third-party binaries are genuine. @xref{Invoking guix challenge}, for more."
  15827. msgstr ""
  15828. #. type: table
  15829. #: guix-git/doc/guix.texi:10373
  15830. msgid "By default, the daemon's setting is honored (@pxref{Invoking guix-daemon, @option{--max-silent-time}})."
  15831. msgstr ""
  15832. #. type: table
  15833. #: guix-git/doc/guix.texi:10380
  15834. msgid "By default, the daemon's setting is honored (@pxref{Invoking guix-daemon, @option{--timeout}})."
  15835. msgstr ""
  15836. #. type: cindex
  15837. #: guix-git/doc/guix.texi:10383
  15838. #, no-wrap
  15839. msgid "verbosity, of the command-line tools"
  15840. msgstr ""
  15841. #. type: cindex
  15842. #: guix-git/doc/guix.texi:10384
  15843. #, no-wrap
  15844. msgid "build logs, verbosity"
  15845. msgstr ""
  15846. #. type: item
  15847. #: guix-git/doc/guix.texi:10385
  15848. #, no-wrap
  15849. msgid "-v @var{level}"
  15850. msgstr ""
  15851. #. type: itemx
  15852. #: guix-git/doc/guix.texi:10386
  15853. #, no-wrap
  15854. msgid "--verbosity=@var{level}"
  15855. msgstr ""
  15856. #. type: table
  15857. #: guix-git/doc/guix.texi:10391
  15858. msgid "Use the given verbosity @var{level}, an integer. Choosing 0 means that no output is produced, 1 is for quiet output; 2 is similar to 1 but it additionally displays download URLs; 3 shows all the build log output on standard error."
  15859. msgstr ""
  15860. #. type: table
  15861. #: guix-git/doc/guix.texi:10396
  15862. msgid "Allow the use of up to @var{n} CPU cores for the build. The special value @code{0} means to use as many CPU cores as available."
  15863. msgstr ""
  15864. #. type: table
  15865. #: guix-git/doc/guix.texi:10402
  15866. msgid "Allow at most @var{n} build jobs in parallel. @xref{Invoking guix-daemon, @option{--max-jobs}}, for details about this option and the equivalent @command{guix-daemon} option."
  15867. msgstr ""
  15868. #. type: item
  15869. #: guix-git/doc/guix.texi:10403
  15870. #, no-wrap
  15871. msgid "--debug=@var{level}"
  15872. msgstr ""
  15873. #. type: table
  15874. #: guix-git/doc/guix.texi:10407
  15875. msgid "Produce debugging output coming from the build daemon. @var{level} must be an integer between 0 and 5; higher means more verbose output. Setting a level of 4 or more may be helpful when debugging setup issues with the build daemon."
  15876. msgstr ""
  15877. #. type: Plain text
  15878. #: guix-git/doc/guix.texi:10414
  15879. msgid "Behind the scenes, @command{guix build} is essentially an interface to the @code{package-derivation} procedure of the @code{(guix packages)} module, and to the @code{build-derivations} procedure of the @code{(guix derivations)} module."
  15880. msgstr ""
  15881. #. type: Plain text
  15882. #: guix-git/doc/guix.texi:10418
  15883. msgid "In addition to options explicitly passed on the command line, @command{guix build} and other @command{guix} commands that support building honor the @env{GUIX_BUILD_OPTIONS} environment variable."
  15884. msgstr ""
  15885. #. type: defvr
  15886. #: guix-git/doc/guix.texi:10419
  15887. #, no-wrap
  15888. msgid "{Environment Variable} GUIX_BUILD_OPTIONS"
  15889. msgstr ""
  15890. #. type: defvr
  15891. #: guix-git/doc/guix.texi:10424
  15892. msgid "Users can define this variable to a list of command line options that will automatically be used by @command{guix build} and other @command{guix} commands that can perform builds, as in the example below:"
  15893. msgstr ""
  15894. #. type: example
  15895. #: guix-git/doc/guix.texi:10427
  15896. #, no-wrap
  15897. msgid "$ export GUIX_BUILD_OPTIONS=\"--no-substitutes -c 2 -L /foo/bar\"\n"
  15898. msgstr ""
  15899. #. type: defvr
  15900. #: guix-git/doc/guix.texi:10431
  15901. msgid "These options are parsed independently, and the result is appended to the parsed command-line options."
  15902. msgstr ""
  15903. #. type: cindex
  15904. #: guix-git/doc/guix.texi:10437
  15905. #, no-wrap
  15906. msgid "package variants"
  15907. msgstr ""
  15908. #. type: Plain text
  15909. #: guix-git/doc/guix.texi:10445
  15910. msgid "Another set of command-line options supported by @command{guix build} and also @command{guix package} are @dfn{package transformation options}. These are options that make it possible to define @dfn{package variants}---for instance, packages built from different source code. This is a convenient way to create customized packages on the fly without having to type in the definitions of package variants (@pxref{Defining Packages})."
  15911. msgstr ""
  15912. #. type: Plain text
  15913. #: guix-git/doc/guix.texi:10449
  15914. msgid "Package transformation options are preserved across upgrades: @command{guix upgrade} attempts to apply transformation options initially used when creating the profile to the upgraded packages."
  15915. msgstr ""
  15916. #. type: Plain text
  15917. #: guix-git/doc/guix.texi:10454
  15918. msgid "The available options are listed below. Most commands support them and also support a @option{--help-transform} option that lists all the available options and a synopsis (these options are not shown in the @option{--help} output for brevity)."
  15919. msgstr ""
  15920. #. type: item
  15921. #: guix-git/doc/guix.texi:10457
  15922. #, no-wrap
  15923. msgid "--with-source=@var{source}"
  15924. msgstr ""
  15925. #. type: itemx
  15926. #: guix-git/doc/guix.texi:10458
  15927. #, no-wrap
  15928. msgid "--with-source=@var{package}=@var{source}"
  15929. msgstr ""
  15930. #. type: itemx
  15931. #: guix-git/doc/guix.texi:10459
  15932. #, no-wrap
  15933. msgid "--with-source=@var{package}@@@var{version}=@var{source}"
  15934. msgstr ""
  15935. #. type: table
  15936. #: guix-git/doc/guix.texi:10464
  15937. msgid "Use @var{source} as the source of @var{package}, and @var{version} as its version number. @var{source} must be a file name or a URL, as for @command{guix download} (@pxref{Invoking guix download})."
  15938. msgstr ""
  15939. #. type: table
  15940. #: guix-git/doc/guix.texi:10470
  15941. msgid "When @var{package} is omitted, it is taken to be the package name specified on the command line that matches the base of @var{source}---e.g., if @var{source} is @code{/src/guile-2.0.10.tar.gz}, the corresponding package is @code{guile}."
  15942. msgstr ""
  15943. #. type: table
  15944. #: guix-git/doc/guix.texi:10473
  15945. msgid "Likewise, when @var{version} is omitted, the version string is inferred from @var{source}; in the previous example, it is @code{2.0.10}."
  15946. msgstr ""
  15947. #. type: table
  15948. #: guix-git/doc/guix.texi:10478
  15949. msgid "This option allows users to try out versions of packages other than the one provided by the distribution. The example below downloads @file{ed-1.7.tar.gz} from a GNU mirror and uses that as the source for the @code{ed} package:"
  15950. msgstr ""
  15951. #. type: example
  15952. #: guix-git/doc/guix.texi:10481
  15953. #, no-wrap
  15954. msgid "guix build ed --with-source=mirror://gnu/ed/ed-1.7.tar.gz\n"
  15955. msgstr ""
  15956. #. type: table
  15957. #: guix-git/doc/guix.texi:10485
  15958. msgid "As a developer, @option{--with-source} makes it easy to test release candidates:"
  15959. msgstr ""
  15960. #. type: example
  15961. #: guix-git/doc/guix.texi:10488
  15962. #, no-wrap
  15963. msgid "guix build guile --with-source=../guile-2.0.9.219-e1bb7.tar.xz\n"
  15964. msgstr ""
  15965. #. type: table
  15966. #: guix-git/doc/guix.texi:10491
  15967. msgid "@dots{} or to build from a checkout in a pristine environment:"
  15968. msgstr ""
  15969. #. type: example
  15970. #: guix-git/doc/guix.texi:10495
  15971. #, no-wrap
  15972. msgid ""
  15973. "$ git clone git://git.sv.gnu.org/guix.git\n"
  15974. "$ guix build guix --with-source=guix@@1.0=./guix\n"
  15975. msgstr ""
  15976. #. type: item
  15977. #: guix-git/doc/guix.texi:10497
  15978. #, no-wrap
  15979. msgid "--with-input=@var{package}=@var{replacement}"
  15980. msgstr ""
  15981. #. type: table
  15982. #: guix-git/doc/guix.texi:10502
  15983. msgid "Replace dependency on @var{package} by a dependency on @var{replacement}. @var{package} must be a package name, and @var{replacement} must be a package specification such as @code{guile} or @code{guile@@1.8}."
  15984. msgstr ""
  15985. #. type: table
  15986. #: guix-git/doc/guix.texi:10506
  15987. msgid "For instance, the following command builds Guix, but replaces its dependency on the current stable version of Guile with a dependency on the legacy version of Guile, @code{guile@@2.0}:"
  15988. msgstr ""
  15989. #. type: example
  15990. #: guix-git/doc/guix.texi:10509
  15991. #, no-wrap
  15992. msgid "guix build --with-input=guile=guile@@2.0 guix\n"
  15993. msgstr ""
  15994. #. type: table
  15995. #: guix-git/doc/guix.texi:10514
  15996. msgid "This is a recursive, deep replacement. So in this example, both @code{guix} and its dependency @code{guile-json} (which also depends on @code{guile}) get rebuilt against @code{guile@@2.0}."
  15997. msgstr ""
  15998. #. type: table
  15999. #: guix-git/doc/guix.texi:10517
  16000. msgid "This is implemented using the @code{package-input-rewriting} Scheme procedure (@pxref{Defining Packages, @code{package-input-rewriting}})."
  16001. msgstr ""
  16002. #. type: item
  16003. #: guix-git/doc/guix.texi:10518
  16004. #, no-wrap
  16005. msgid "--with-graft=@var{package}=@var{replacement}"
  16006. msgstr ""
  16007. #. type: table
  16008. #: guix-git/doc/guix.texi:10524
  16009. msgid "This is similar to @option{--with-input} but with an important difference: instead of rebuilding the whole dependency chain, @var{replacement} is built and then @dfn{grafted} onto the binaries that were initially referring to @var{package}. @xref{Security Updates}, for more information on grafts."
  16010. msgstr ""
  16011. #. type: table
  16012. #: guix-git/doc/guix.texi:10528
  16013. msgid "For example, the command below grafts version 3.5.4 of GnuTLS onto Wget and all its dependencies, replacing references to the version of GnuTLS they currently refer to:"
  16014. msgstr ""
  16015. #. type: example
  16016. #: guix-git/doc/guix.texi:10531
  16017. #, no-wrap
  16018. msgid "guix build --with-graft=gnutls=gnutls@@3.5.4 wget\n"
  16019. msgstr ""
  16020. #. type: table
  16021. #: guix-git/doc/guix.texi:10540
  16022. msgid "This has the advantage of being much faster than rebuilding everything. But there is a caveat: it works if and only if @var{package} and @var{replacement} are strictly compatible---for example, if they provide a library, the application binary interface (ABI) of those libraries must be compatible. If @var{replacement} is somehow incompatible with @var{package}, then the resulting package may be unusable. Use with care!"
  16023. msgstr ""
  16024. #. type: cindex
  16025. #: guix-git/doc/guix.texi:10541 guix-git/doc/guix.texi:35239
  16026. #, no-wrap
  16027. msgid "debugging info, rebuilding"
  16028. msgstr ""
  16029. #. type: item
  16030. #: guix-git/doc/guix.texi:10542
  16031. #, no-wrap
  16032. msgid "--with-debug-info=@var{package}"
  16033. msgstr ""
  16034. #. type: table
  16035. #: guix-git/doc/guix.texi:10547
  16036. msgid "Build @var{package} in a way that preserves its debugging info and graft it onto packages that depend on it. This is useful if @var{package} does not already provide debugging info as a @code{debug} output (@pxref{Installing Debugging Files})."
  16037. msgstr ""
  16038. #. type: table
  16039. #: guix-git/doc/guix.texi:10553
  16040. msgid "For example, suppose you're experiencing a crash in Inkscape and would like to see what's up in GLib, a library deep down in Inkscape's dependency graph. GLib lacks a @code{debug} output, so debugging is tough. Fortunately, you rebuild GLib with debugging info and tack it on Inkscape:"
  16041. msgstr ""
  16042. #. type: example
  16043. #: guix-git/doc/guix.texi:10556 guix-git/doc/guix.texi:35270
  16044. #, no-wrap
  16045. msgid "guix install inkscape --with-debug-info=glib\n"
  16046. msgstr ""
  16047. #. type: table
  16048. #: guix-git/doc/guix.texi:10560
  16049. msgid "Only GLib needs to be recompiled so this takes a reasonable amount of time. @xref{Installing Debugging Files}, for more info."
  16050. msgstr ""
  16051. #. type: quotation
  16052. #: guix-git/doc/guix.texi:10566
  16053. msgid "Under the hood, this option works by passing the @samp{#:strip-binaries? #f} to the build system of the package of interest (@pxref{Build Systems}). Most build systems support that option but some do not. In that case, an error is raised."
  16054. msgstr ""
  16055. #. type: quotation
  16056. #: guix-git/doc/guix.texi:10570
  16057. msgid "Likewise, if a C/C++ package is built without @code{-g} (which is rarely the case), debugging info will remain unavailable even when @code{#:strip-binaries?} is false."
  16058. msgstr ""
  16059. #. type: cindex
  16060. #: guix-git/doc/guix.texi:10572
  16061. #, no-wrap
  16062. msgid "tool chain, changing the build tool chain of a package"
  16063. msgstr ""
  16064. #. type: item
  16065. #: guix-git/doc/guix.texi:10573
  16066. #, no-wrap
  16067. msgid "--with-c-toolchain=@var{package}=@var{toolchain}"
  16068. msgstr ""
  16069. #. type: table
  16070. #: guix-git/doc/guix.texi:10577
  16071. msgid "This option changes the compilation of @var{package} and everything that depends on it so that they get built with @var{toolchain} instead of the default GNU tool chain for C/C++."
  16072. msgstr ""
  16073. #. type: example
  16074. #: guix-git/doc/guix.texi:10584
  16075. #, no-wrap
  16076. msgid ""
  16077. "guix build octave-cli \\\n"
  16078. " --with-c-toolchain=fftw=gcc-toolchain@@10 \\\n"
  16079. " --with-c-toolchain=fftwf=gcc-toolchain@@10\n"
  16080. msgstr ""
  16081. #. type: table
  16082. #: guix-git/doc/guix.texi:10591
  16083. msgid "The command above builds a variant of the @code{fftw} and @code{fftwf} packages using version 10 of @code{gcc-toolchain} instead of the default tool chain, and then builds a variant of the GNU@tie{}Octave command-line interface using them. GNU@tie{}Octave itself is also built with @code{gcc-toolchain@@10}."
  16084. msgstr ""
  16085. #. type: table
  16086. #: guix-git/doc/guix.texi:10595
  16087. msgid "This other example builds the Hardware Locality (@code{hwloc}) library and its dependents up to @code{intel-mpi-benchmarks} with the Clang C compiler:"
  16088. msgstr ""
  16089. #. type: example
  16090. #: guix-git/doc/guix.texi:10599
  16091. #, no-wrap
  16092. msgid ""
  16093. "guix build --with-c-toolchain=hwloc=clang-toolchain \\\n"
  16094. " intel-mpi-benchmarks\n"
  16095. msgstr ""
  16096. #. type: quotation
  16097. #: guix-git/doc/guix.texi:10608
  16098. msgid "There can be application binary interface (ABI) incompatibilities among tool chains. This is particularly true of the C++ standard library and run-time support libraries such as that of OpenMP@. By rebuilding all dependents with the same tool chain, @option{--with-c-toolchain} minimizes the risks of incompatibility but cannot entirely eliminate them. Choose @var{package} wisely."
  16099. msgstr ""
  16100. #. type: item
  16101. #: guix-git/doc/guix.texi:10610
  16102. #, no-wrap
  16103. msgid "--with-git-url=@var{package}=@var{url}"
  16104. msgstr ""
  16105. #. type: cindex
  16106. #: guix-git/doc/guix.texi:10611
  16107. #, no-wrap
  16108. msgid "Git, using the latest commit"
  16109. msgstr ""
  16110. #. type: cindex
  16111. #: guix-git/doc/guix.texi:10612
  16112. #, no-wrap
  16113. msgid "latest commit, building"
  16114. msgstr ""
  16115. #. type: table
  16116. #: guix-git/doc/guix.texi:10616
  16117. msgid "Build @var{package} from the latest commit of the @code{master} branch of the Git repository at @var{url}. Git sub-modules of the repository are fetched, recursively."
  16118. msgstr ""
  16119. #. type: table
  16120. #: guix-git/doc/guix.texi:10619
  16121. msgid "For example, the following command builds the NumPy Python library against the latest commit of the master branch of Python itself:"
  16122. msgstr ""
  16123. #. type: example
  16124. #: guix-git/doc/guix.texi:10623
  16125. #, no-wrap
  16126. msgid ""
  16127. "guix build python-numpy \\\n"
  16128. " --with-git-url=python=https://github.com/python/cpython\n"
  16129. msgstr ""
  16130. #. type: table
  16131. #: guix-git/doc/guix.texi:10627
  16132. msgid "This option can also be combined with @option{--with-branch} or @option{--with-commit} (see below)."
  16133. msgstr ""
  16134. #. type: cindex
  16135. #: guix-git/doc/guix.texi:10628 guix-git/doc/guix.texi:27790
  16136. #, no-wrap
  16137. msgid "continuous integration"
  16138. msgstr ""
  16139. #. type: table
  16140. #: guix-git/doc/guix.texi:10634
  16141. msgid "Obviously, since it uses the latest commit of the given branch, the result of such a command varies over time. Nevertheless it is a convenient way to rebuild entire software stacks against the latest commit of one or more packages. This is particularly useful in the context of continuous integration (CI)."
  16142. msgstr ""
  16143. #. type: table
  16144. #: guix-git/doc/guix.texi:10638
  16145. msgid "Checkouts are kept in a cache under @file{~/.cache/guix/checkouts} to speed up consecutive accesses to the same repository. You may want to clean it up once in a while to save disk space."
  16146. msgstr ""
  16147. #. type: item
  16148. #: guix-git/doc/guix.texi:10639
  16149. #, no-wrap
  16150. msgid "--with-branch=@var{package}=@var{branch}"
  16151. msgstr ""
  16152. #. type: table
  16153. #: guix-git/doc/guix.texi:10645
  16154. msgid "Build @var{package} from the latest commit of @var{branch}. If the @code{source} field of @var{package} is an origin with the @code{git-fetch} method (@pxref{origin Reference}) or a @code{git-checkout} object, the repository URL is taken from that @code{source}. Otherwise you have to use @option{--with-git-url} to specify the URL of the Git repository."
  16155. msgstr ""
  16156. #. type: table
  16157. #: guix-git/doc/guix.texi:10650
  16158. msgid "For instance, the following command builds @code{guile-sqlite3} from the latest commit of its @code{master} branch, and then builds @code{guix} (which depends on it) and @code{cuirass} (which depends on @code{guix}) against this specific @code{guile-sqlite3} build:"
  16159. msgstr ""
  16160. #. type: example
  16161. #: guix-git/doc/guix.texi:10653
  16162. #, no-wrap
  16163. msgid "guix build --with-branch=guile-sqlite3=master cuirass\n"
  16164. msgstr ""
  16165. #. type: item
  16166. #: guix-git/doc/guix.texi:10655
  16167. #, no-wrap
  16168. msgid "--with-commit=@var{package}=@var{commit}"
  16169. msgstr ""
  16170. #. type: table
  16171. #: guix-git/doc/guix.texi:10659
  16172. msgid "This is similar to @option{--with-branch}, except that it builds from @var{commit} rather than the tip of a branch. @var{commit} must be a valid Git commit SHA1 identifier or a tag."
  16173. msgstr ""
  16174. #. type: item
  16175. #: guix-git/doc/guix.texi:10660
  16176. #, no-wrap
  16177. msgid "--with-patch=@var{package}=@var{file}"
  16178. msgstr ""
  16179. #. type: table
  16180. #: guix-git/doc/guix.texi:10667
  16181. msgid "Add @var{file} to the list of patches applied to @var{package}, where @var{package} is a spec such as @code{python@@3.8} or @code{glibc}. @var{file} must contain a patch; it is applied with the flags specified in the @code{origin} of @var{package} (@pxref{origin Reference}), which by default includes @code{-p1} (@pxref{patch Directories,,, diffutils, Comparing and Merging Files})."
  16182. msgstr ""
  16183. #. type: table
  16184. #: guix-git/doc/guix.texi:10670
  16185. msgid "As an example, the command below rebuilds Coreutils with the GNU C Library (glibc) patched with the given patch:"
  16186. msgstr ""
  16187. #. type: example
  16188. #: guix-git/doc/guix.texi:10673
  16189. #, no-wrap
  16190. msgid "guix build coreutils --with-patch=glibc=./glibc-frob.patch\n"
  16191. msgstr ""
  16192. #. type: table
  16193. #: guix-git/doc/guix.texi:10677
  16194. msgid "In this example, glibc itself as well as everything that leads to Coreutils in the dependency graph is rebuilt."
  16195. msgstr ""
  16196. #. type: cindex
  16197. #: guix-git/doc/guix.texi:10678
  16198. #, no-wrap
  16199. msgid "upstream, latest version"
  16200. msgstr ""
  16201. #. type: item
  16202. #: guix-git/doc/guix.texi:10679
  16203. #, no-wrap
  16204. msgid "--with-latest=@var{package}"
  16205. msgstr ""
  16206. #. type: table
  16207. #: guix-git/doc/guix.texi:10684
  16208. msgid "So you like living on the bleeding edge? This option is for you! It replaces occurrences of @var{package} in the dependency graph with its latest upstream version, as reported by @command{guix refresh} (@pxref{Invoking guix refresh})."
  16209. msgstr ""
  16210. #. type: table
  16211. #: guix-git/doc/guix.texi:10688
  16212. msgid "It does so by determining the latest upstream release of @var{package} (if possible), downloading it, and authenticating it @emph{if} it comes with an OpenPGP signature."
  16213. msgstr ""
  16214. #. type: table
  16215. #: guix-git/doc/guix.texi:10691
  16216. msgid "As an example, the command below builds Guix against the latest version of Guile-JSON:"
  16217. msgstr ""
  16218. #. type: example
  16219. #: guix-git/doc/guix.texi:10694
  16220. #, no-wrap
  16221. msgid "guix build guix --with-latest=guile-json\n"
  16222. msgstr ""
  16223. #. type: table
  16224. #: guix-git/doc/guix.texi:10703
  16225. msgid "There are limitations. First, in cases where the tool cannot or does not know how to authenticate source code, you are at risk of running malicious code; a warning is emitted in this case. Second, this option simply changes the source used in the existing package definitions, which is not always sufficient: there might be additional dependencies that need to be added, patches to apply, and more generally the quality assurance work that Guix developers normally do will be missing."
  16226. msgstr ""
  16227. #. type: table
  16228. #: guix-git/doc/guix.texi:10708
  16229. msgid "You've been warned! In all the other cases, it's a snappy way to stay on top. We encourage you to submit patches updating the actual package definitions once you have successfully tested an upgrade (@pxref{Contributing})."
  16230. msgstr ""
  16231. #. type: cindex
  16232. #: guix-git/doc/guix.texi:10709
  16233. #, no-wrap
  16234. msgid "test suite, skipping"
  16235. msgstr ""
  16236. #. type: item
  16237. #: guix-git/doc/guix.texi:10710
  16238. #, no-wrap
  16239. msgid "--without-tests=@var{package}"
  16240. msgstr ""
  16241. #. type: table
  16242. #: guix-git/doc/guix.texi:10716
  16243. msgid "Build @var{package} without running its tests. This can be useful in situations where you want to skip the lengthy test suite of a intermediate package, or if a package's test suite fails in a non-deterministic fashion. It should be used with care because running the test suite is a good way to ensure a package is working as intended."
  16244. msgstr ""
  16245. #. type: table
  16246. #: guix-git/doc/guix.texi:10720
  16247. msgid "Turning off tests leads to a different store item. Consequently, when using this option, anything that depends on @var{package} must be rebuilt, as in this example:"
  16248. msgstr ""
  16249. #. type: example
  16250. #: guix-git/doc/guix.texi:10723
  16251. #, no-wrap
  16252. msgid "guix install --without-tests=python python-notebook\n"
  16253. msgstr ""
  16254. #. type: table
  16255. #: guix-git/doc/guix.texi:10729
  16256. msgid "The command above installs @code{python-notebook} on top of @code{python} built without running its test suite. To do so, it also rebuilds everything that depends on @code{python}, including @code{python-notebook} itself."
  16257. msgstr ""
  16258. #. type: table
  16259. #: guix-git/doc/guix.texi:10735
  16260. msgid "Internally, @option{--without-tests} relies on changing the @code{#:tests?} option of a package's @code{check} phase (@pxref{Build Systems}). Note that some packages use a customized @code{check} phase that does not respect a @code{#:tests? #f} setting. Therefore, @option{--without-tests} has no effect on these packages."
  16261. msgstr ""
  16262. #. type: Plain text
  16263. #: guix-git/doc/guix.texi:10742
  16264. msgid "Wondering how to achieve the same effect using Scheme code, for example in your manifest, or how to write your own package transformation? @xref{Defining Package Variants}, for an overview of the programming interfaces available."
  16265. msgstr ""
  16266. #. type: Plain text
  16267. #: guix-git/doc/guix.texi:10748
  16268. msgid "The command-line options presented below are specific to @command{guix build}."
  16269. msgstr ""
  16270. #. type: item
  16271. #: guix-git/doc/guix.texi:10751
  16272. #, no-wrap
  16273. msgid "--quiet"
  16274. msgstr ""
  16275. #. type: table
  16276. #: guix-git/doc/guix.texi:10756
  16277. msgid "Build quietly, without displaying the build log; this is equivalent to @option{--verbosity=0}. Upon completion, the build log is kept in @file{/var} (or similar) and can always be retrieved using the @option{--log-file} option."
  16278. msgstr ""
  16279. #. type: item
  16280. #: guix-git/doc/guix.texi:10757
  16281. #, no-wrap
  16282. msgid "--file=@var{file}"
  16283. msgstr ""
  16284. #. type: table
  16285. #: guix-git/doc/guix.texi:10761
  16286. msgid "Build the package, derivation, or other file-like object that the code within @var{file} evaluates to (@pxref{G-Expressions, file-like objects})."
  16287. msgstr ""
  16288. #. type: table
  16289. #: guix-git/doc/guix.texi:10764
  16290. msgid "As an example, @var{file} might contain a package definition like this (@pxref{Defining Packages}):"
  16291. msgstr ""
  16292. #. type: table
  16293. #: guix-git/doc/guix.texi:10773
  16294. msgid "The @var{file} may also contain a JSON representation of one or more package definitions. Running @code{guix build -f} on @file{hello.json} with the following contents would result in building the packages @code{myhello} and @code{greeter}:"
  16295. msgstr ""
  16296. #. type: item
  16297. #: guix-git/doc/guix.texi:10778
  16298. #, no-wrap
  16299. msgid "--manifest=@var{manifest}"
  16300. msgstr ""
  16301. #. type: itemx
  16302. #: guix-git/doc/guix.texi:10779
  16303. #, no-wrap
  16304. msgid "-m @var{manifest}"
  16305. msgstr ""
  16306. #. type: table
  16307. #: guix-git/doc/guix.texi:10782
  16308. msgid "Build all packages listed in the given @var{manifest} (@pxref{profile-manifest, @option{--manifest}})."
  16309. msgstr ""
  16310. #. type: table
  16311. #: guix-git/doc/guix.texi:10786
  16312. msgid "Build the package or derivation @var{expr} evaluates to."
  16313. msgstr ""
  16314. #. type: table
  16315. #: guix-git/doc/guix.texi:10790
  16316. msgid "For example, @var{expr} may be @code{(@@ (gnu packages guile) guile-1.8)}, which unambiguously designates this specific variant of version 1.8 of Guile."
  16317. msgstr ""
  16318. #. type: table
  16319. #: guix-git/doc/guix.texi:10794
  16320. msgid "Alternatively, @var{expr} may be a G-expression, in which case it is used as a build program passed to @code{gexp->derivation} (@pxref{G-Expressions})."
  16321. msgstr ""
  16322. #. type: table
  16323. #: guix-git/doc/guix.texi:10798
  16324. msgid "Lastly, @var{expr} may refer to a zero-argument monadic procedure (@pxref{The Store Monad}). The procedure must return a derivation as a monadic value, which is then passed through @code{run-with-store}."
  16325. msgstr ""
  16326. #. type: item
  16327. #: guix-git/doc/guix.texi:10799
  16328. #, no-wrap
  16329. msgid "--source"
  16330. msgstr ""
  16331. #. type: itemx
  16332. #: guix-git/doc/guix.texi:10800
  16333. #, no-wrap
  16334. msgid "-S"
  16335. msgstr ""
  16336. #. type: table
  16337. #: guix-git/doc/guix.texi:10803
  16338. msgid "Build the source derivations of the packages, rather than the packages themselves."
  16339. msgstr ""
  16340. #. type: table
  16341. #: guix-git/doc/guix.texi:10807
  16342. msgid "For instance, @code{guix build -S gcc} returns something like @file{/gnu/store/@dots{}-gcc-4.7.2.tar.bz2}, which is the GCC source tarball."
  16343. msgstr ""
  16344. #. type: table
  16345. #: guix-git/doc/guix.texi:10811
  16346. msgid "The returned source tarball is the result of applying any patches and code snippets specified in the package @code{origin} (@pxref{Defining Packages})."
  16347. msgstr ""
  16348. #. type: cindex
  16349. #: guix-git/doc/guix.texi:10812
  16350. #, no-wrap
  16351. msgid "source, verification"
  16352. msgstr ""
  16353. #. type: table
  16354. #: guix-git/doc/guix.texi:10818
  16355. msgid "As with other derivations, the result of building a source derivation can be verified using the @option{--check} option (@pxref{build-check}). This is useful to validate that a (potentially already built or substituted, thus cached) package source matches against its declared hash."
  16356. msgstr ""
  16357. #. type: table
  16358. #: guix-git/doc/guix.texi:10823
  16359. msgid "Note that @command{guix build -S} compiles the sources only of the specified packages. They do not include the sources of statically linked dependencies and by themselves are insufficient for reproducing the packages."
  16360. msgstr ""
  16361. #. type: item
  16362. #: guix-git/doc/guix.texi:10824
  16363. #, no-wrap
  16364. msgid "--sources"
  16365. msgstr ""
  16366. #. type: table
  16367. #: guix-git/doc/guix.texi:10831
  16368. msgid "Fetch and return the source of @var{package-or-derivation} and all their dependencies, recursively. This is a handy way to obtain a local copy of all the source code needed to build @var{packages}, allowing you to eventually build them even without network access. It is an extension of the @option{--source} option and can accept one of the following optional argument values:"
  16369. msgstr ""
  16370. #. type: item
  16371. #: guix-git/doc/guix.texi:10833 guix-git/doc/guix.texi:12450
  16372. #, no-wrap
  16373. msgid "package"
  16374. msgstr ""
  16375. #. type: table
  16376. #: guix-git/doc/guix.texi:10836
  16377. msgid "This value causes the @option{--sources} option to behave in the same way as the @option{--source} option."
  16378. msgstr ""
  16379. #. type: item
  16380. #: guix-git/doc/guix.texi:10837 guix-git/doc/guix.texi:18532
  16381. #, no-wrap
  16382. msgid "all"
  16383. msgstr ""
  16384. #. type: table
  16385. #: guix-git/doc/guix.texi:10840
  16386. msgid "Build the source derivations of all packages, including any source that might be listed as @code{inputs}. This is the default value."
  16387. msgstr ""
  16388. #. type: example
  16389. #: guix-git/doc/guix.texi:10846
  16390. #, no-wrap
  16391. msgid ""
  16392. "$ guix build --sources tzdata\n"
  16393. "The following derivations will be built:\n"
  16394. " /gnu/store/@dots{}-tzdata2015b.tar.gz.drv\n"
  16395. " /gnu/store/@dots{}-tzcode2015b.tar.gz.drv\n"
  16396. msgstr ""
  16397. #. type: item
  16398. #: guix-git/doc/guix.texi:10848
  16399. #, no-wrap
  16400. msgid "transitive"
  16401. msgstr ""
  16402. #. type: table
  16403. #: guix-git/doc/guix.texi:10852
  16404. msgid "Build the source derivations of all packages, as well of all transitive inputs to the packages. This can be used e.g.@: to prefetch package source for later offline building."
  16405. msgstr ""
  16406. #. type: example
  16407. #: guix-git/doc/guix.texi:10863
  16408. #, no-wrap
  16409. msgid ""
  16410. "$ guix build --sources=transitive tzdata\n"
  16411. "The following derivations will be built:\n"
  16412. " /gnu/store/@dots{}-tzcode2015b.tar.gz.drv\n"
  16413. " /gnu/store/@dots{}-findutils-4.4.2.tar.xz.drv\n"
  16414. " /gnu/store/@dots{}-grep-2.21.tar.xz.drv\n"
  16415. " /gnu/store/@dots{}-coreutils-8.23.tar.xz.drv\n"
  16416. " /gnu/store/@dots{}-make-4.1.tar.xz.drv\n"
  16417. " /gnu/store/@dots{}-bash-4.3.tar.xz.drv\n"
  16418. "@dots{}\n"
  16419. msgstr ""
  16420. #. type: table
  16421. #: guix-git/doc/guix.texi:10873
  16422. msgid "Attempt to build for @var{system}---e.g., @code{i686-linux}---instead of the system type of the build host. The @command{guix build} command allows you to repeat this option several times, in which case it builds for all the specified systems; other commands ignore extraneous @option{-s} options."
  16423. msgstr ""
  16424. #. type: quotation
  16425. #: guix-git/doc/guix.texi:10878
  16426. msgid "The @option{--system} flag is for @emph{native} compilation and must not be confused with cross-compilation. See @option{--target} below for information on cross-compilation."
  16427. msgstr ""
  16428. #. type: table
  16429. #: guix-git/doc/guix.texi:10885
  16430. msgid "An example use of this is on Linux-based systems, which can emulate different personalities. For instance, passing @option{--system=i686-linux} on an @code{x86_64-linux} system or @option{--system=armhf-linux} on an @code{aarch64-linux} system allows you to build packages in a complete 32-bit environment."
  16431. msgstr ""
  16432. #. type: quotation
  16433. #: guix-git/doc/guix.texi:10890
  16434. msgid "Building for an @code{armhf-linux} system is unconditionally enabled on @code{aarch64-linux} machines, although certain aarch64 chipsets do not allow for this functionality, notably the ThunderX."
  16435. msgstr ""
  16436. #. type: table
  16437. #: guix-git/doc/guix.texi:10896
  16438. msgid "Similarly, when transparent emulation with QEMU and @code{binfmt_misc} is enabled (@pxref{Virtualization Services, @code{qemu-binfmt-service-type}}), you can build for any system for which a QEMU @code{binfmt_misc} handler is installed."
  16439. msgstr ""
  16440. #. type: table
  16441. #: guix-git/doc/guix.texi:10900
  16442. msgid "Builds for a system other than that of the machine you are using can also be offloaded to a remote machine of the right architecture. @xref{Daemon Offload Setup}, for more information on offloading."
  16443. msgstr ""
  16444. #. type: table
  16445. #: guix-git/doc/guix.texi:10906
  16446. msgid "Cross-build for @var{triplet}, which must be a valid GNU triplet, such as @code{\"aarch64-linux-gnu\"} (@pxref{Specifying Target Triplets, GNU configuration triplets,, autoconf, Autoconf})."
  16447. msgstr ""
  16448. #. type: anchor{#1}
  16449. #: guix-git/doc/guix.texi:10908
  16450. msgid "build-check"
  16451. msgstr ""
  16452. #. type: item
  16453. #: guix-git/doc/guix.texi:10908
  16454. #, no-wrap
  16455. msgid "--check"
  16456. msgstr ""
  16457. #. type: cindex
  16458. #: guix-git/doc/guix.texi:10909
  16459. #, no-wrap
  16460. msgid "determinism, checking"
  16461. msgstr ""
  16462. #. type: cindex
  16463. #: guix-git/doc/guix.texi:10910
  16464. #, no-wrap
  16465. msgid "reproducibility, checking"
  16466. msgstr ""
  16467. #. type: table
  16468. #: guix-git/doc/guix.texi:10914
  16469. msgid "Rebuild @var{package-or-derivation}, which are already available in the store, and raise an error if the build results are not bit-for-bit identical."
  16470. msgstr ""
  16471. #. type: table
  16472. #: guix-git/doc/guix.texi:10919
  16473. msgid "This mechanism allows you to check whether previously installed substitutes are genuine (@pxref{Substitutes}), or whether the build result of a package is deterministic. @xref{Invoking guix challenge}, for more background information and tools."
  16474. msgstr ""
  16475. #. type: item
  16476. #: guix-git/doc/guix.texi:10924
  16477. #, no-wrap
  16478. msgid "--repair"
  16479. msgstr ""
  16480. #. type: cindex
  16481. #: guix-git/doc/guix.texi:10925
  16482. #, no-wrap
  16483. msgid "repairing store items"
  16484. msgstr ""
  16485. #. type: table
  16486. #: guix-git/doc/guix.texi:10929
  16487. msgid "Attempt to repair the specified store items, if they are corrupt, by re-downloading or rebuilding them."
  16488. msgstr ""
  16489. #. type: table
  16490. #: guix-git/doc/guix.texi:10931
  16491. msgid "This operation is not atomic and thus restricted to @code{root}."
  16492. msgstr ""
  16493. #. type: item
  16494. #: guix-git/doc/guix.texi:10932
  16495. #, no-wrap
  16496. msgid "--derivations"
  16497. msgstr ""
  16498. #. type: table
  16499. #: guix-git/doc/guix.texi:10936
  16500. msgid "Return the derivation paths, not the output paths, of the given packages."
  16501. msgstr ""
  16502. #. type: cindex
  16503. #: guix-git/doc/guix.texi:10939
  16504. #, no-wrap
  16505. msgid "GC roots, adding"
  16506. msgstr ""
  16507. #. type: cindex
  16508. #: guix-git/doc/guix.texi:10940
  16509. #, no-wrap
  16510. msgid "garbage collector roots, adding"
  16511. msgstr ""
  16512. #. type: table
  16513. #: guix-git/doc/guix.texi:10943 guix-git/doc/guix.texi:33904
  16514. msgid "Make @var{file} a symlink to the result, and register it as a garbage collector root."
  16515. msgstr ""
  16516. #. type: table
  16517. #: guix-git/doc/guix.texi:10949
  16518. msgid "Consequently, the results of this @command{guix build} invocation are protected from garbage collection until @var{file} is removed. When that option is omitted, build results are eligible for garbage collection as soon as the build completes. @xref{Invoking guix gc}, for more on GC roots."
  16519. msgstr ""
  16520. #. type: item
  16521. #: guix-git/doc/guix.texi:10950
  16522. #, no-wrap
  16523. msgid "--log-file"
  16524. msgstr ""
  16525. #. type: cindex
  16526. #: guix-git/doc/guix.texi:10951
  16527. #, no-wrap
  16528. msgid "build logs, access"
  16529. msgstr ""
  16530. #. type: table
  16531. #: guix-git/doc/guix.texi:10955
  16532. msgid "Return the build log file names or URLs for the given @var{package-or-derivation}, or raise an error if build logs are missing."
  16533. msgstr ""
  16534. #. type: table
  16535. #: guix-git/doc/guix.texi:10958
  16536. msgid "This works regardless of how packages or derivations are specified. For instance, the following invocations are equivalent:"
  16537. msgstr ""
  16538. #. type: example
  16539. #: guix-git/doc/guix.texi:10964
  16540. #, no-wrap
  16541. msgid ""
  16542. "guix build --log-file $(guix build -d guile)\n"
  16543. "guix build --log-file $(guix build guile)\n"
  16544. "guix build --log-file guile\n"
  16545. "guix build --log-file -e '(@@ (gnu packages guile) guile-2.0)'\n"
  16546. msgstr ""
  16547. #. type: table
  16548. #: guix-git/doc/guix.texi:10969
  16549. msgid "If a log is unavailable locally, and unless @option{--no-substitutes} is passed, the command looks for a corresponding log on one of the substitute servers (as specified with @option{--substitute-urls})."
  16550. msgstr ""
  16551. #. type: table
  16552. #: guix-git/doc/guix.texi:10972
  16553. msgid "So for instance, imagine you want to see the build log of GDB on MIPS, but you are actually on an @code{x86_64} machine:"
  16554. msgstr ""
  16555. #. type: example
  16556. #: guix-git/doc/guix.texi:10976
  16557. #, no-wrap
  16558. msgid ""
  16559. "$ guix build --log-file gdb -s aarch64-linux\n"
  16560. "https://@value{SUBSTITUTE-SERVER-1}/log/@dots{}-gdb-7.10\n"
  16561. msgstr ""
  16562. #. type: table
  16563. #: guix-git/doc/guix.texi:10979
  16564. msgid "You can freely access a huge library of build logs!"
  16565. msgstr ""
  16566. #. type: cindex
  16567. #: guix-git/doc/guix.texi:10984
  16568. #, no-wrap
  16569. msgid "build failures, debugging"
  16570. msgstr ""
  16571. #. type: Plain text
  16572. #: guix-git/doc/guix.texi:10990
  16573. msgid "When defining a new package (@pxref{Defining Packages}), you will probably find yourself spending some time debugging and tweaking the build until it succeeds. To do that, you need to operate the build commands yourself in an environment as close as possible to the one the build daemon uses."
  16574. msgstr ""
  16575. #. type: Plain text
  16576. #: guix-git/doc/guix.texi:10995
  16577. msgid "To that end, the first thing to do is to use the @option{--keep-failed} or @option{-K} option of @command{guix build}, which will keep the failed build tree in @file{/tmp} or whatever directory you specified as @env{TMPDIR} (@pxref{Common Build Options, @option{--keep-failed}})."
  16578. msgstr ""
  16579. #. type: Plain text
  16580. #: guix-git/doc/guix.texi:11001
  16581. msgid "From there on, you can @command{cd} to the failed build tree and source the @file{environment-variables} file, which contains all the environment variable definitions that were in place when the build failed. So let's say you're debugging a build failure in package @code{foo}; a typical session would look like this:"
  16582. msgstr ""
  16583. #. type: example
  16584. #: guix-git/doc/guix.texi:11008
  16585. #, no-wrap
  16586. msgid ""
  16587. "$ guix build foo -K\n"
  16588. "@dots{} @i{build fails}\n"
  16589. "$ cd /tmp/guix-build-foo.drv-0\n"
  16590. "$ source ./environment-variables\n"
  16591. "$ cd foo-1.2\n"
  16592. msgstr ""
  16593. #. type: Plain text
  16594. #: guix-git/doc/guix.texi:11012
  16595. msgid "Now, you can invoke commands as if you were the daemon (almost) and troubleshoot your build process."
  16596. msgstr ""
  16597. #. type: Plain text
  16598. #: guix-git/doc/guix.texi:11018
  16599. msgid "Sometimes it happens that, for example, a package's tests pass when you run them manually but they fail when the daemon runs them. This can happen because the daemon runs builds in containers where, unlike in our environment above, network access is missing, @file{/bin/sh} does not exist, etc. (@pxref{Build Environment Setup})."
  16600. msgstr ""
  16601. #. type: Plain text
  16602. #: guix-git/doc/guix.texi:11021
  16603. msgid "In such cases, you may need to run inspect the build process from within a container similar to the one the build daemon creates:"
  16604. msgstr ""
  16605. #. type: example
  16606. #: guix-git/doc/guix.texi:11029
  16607. #, no-wrap
  16608. msgid ""
  16609. "$ guix build -K foo\n"
  16610. "@dots{}\n"
  16611. "$ cd /tmp/guix-build-foo.drv-0\n"
  16612. "$ guix environment --no-grafts -C foo --ad-hoc strace gdb\n"
  16613. "[env]# source ./environment-variables\n"
  16614. "[env]# cd foo-1.2\n"
  16615. msgstr ""
  16616. #. type: Plain text
  16617. #: guix-git/doc/guix.texi:11038
  16618. msgid "Here, @command{guix environment -C} creates a container and spawns a new shell in it (@pxref{Invoking guix environment}). The @command{--ad-hoc strace gdb} part adds the @command{strace} and @command{gdb} commands to the container, which you may find handy while debugging. The @option{--no-grafts} option makes sure we get the exact same environment, with ungrafted packages (@pxref{Security Updates}, for more info on grafts)."
  16619. msgstr ""
  16620. #. type: Plain text
  16621. #: guix-git/doc/guix.texi:11041
  16622. msgid "To get closer to a container like that used by the build daemon, we can remove @file{/bin/sh}:"
  16623. msgstr ""
  16624. #. type: example
  16625. #: guix-git/doc/guix.texi:11044
  16626. #, no-wrap
  16627. msgid "[env]# rm /bin/sh\n"
  16628. msgstr ""
  16629. #. type: Plain text
  16630. #: guix-git/doc/guix.texi:11048
  16631. msgid "(Don't worry, this is harmless: this is all happening in the throw-away container created by @command{guix environment}.)"
  16632. msgstr ""
  16633. #. type: Plain text
  16634. #: guix-git/doc/guix.texi:11051
  16635. msgid "The @command{strace} command is probably not in the search path, but we can run:"
  16636. msgstr ""
  16637. #. type: example
  16638. #: guix-git/doc/guix.texi:11054
  16639. #, no-wrap
  16640. msgid "[env]# $GUIX_ENVIRONMENT/bin/strace -f -o log make check\n"
  16641. msgstr ""
  16642. #. type: Plain text
  16643. #: guix-git/doc/guix.texi:11059
  16644. msgid "In this way, not only you will have reproduced the environment variables the daemon uses, you will also be running the build process in a container similar to the one the daemon uses."
  16645. msgstr ""
  16646. #. type: section
  16647. #: guix-git/doc/guix.texi:11062
  16648. #, no-wrap
  16649. msgid "Invoking @command{guix edit}"
  16650. msgstr ""
  16651. #. type: command{#1}
  16652. #: guix-git/doc/guix.texi:11064
  16653. #, no-wrap
  16654. msgid "guix edit"
  16655. msgstr ""
  16656. #. type: cindex
  16657. #: guix-git/doc/guix.texi:11065
  16658. #, no-wrap
  16659. msgid "package definition, editing"
  16660. msgstr ""
  16661. #. type: Plain text
  16662. #: guix-git/doc/guix.texi:11070
  16663. msgid "So many packages, so many source files! The @command{guix edit} command facilitates the life of users and packagers by pointing their editor at the source file containing the definition of the specified packages. For instance:"
  16664. msgstr ""
  16665. #. type: example
  16666. #: guix-git/doc/guix.texi:11073
  16667. #, no-wrap
  16668. msgid "guix edit gcc@@4.9 vim\n"
  16669. msgstr ""
  16670. #. type: Plain text
  16671. #: guix-git/doc/guix.texi:11079
  16672. msgid "launches the program specified in the @env{VISUAL} or in the @env{EDITOR} environment variable to view the recipe of GCC@tie{}4.9.3 and that of Vim."
  16673. msgstr ""
  16674. #. type: Plain text
  16675. #: guix-git/doc/guix.texi:11085
  16676. msgid "If you are using a Guix Git checkout (@pxref{Building from Git}), or have created your own packages on @env{GUIX_PACKAGE_PATH} (@pxref{Package Modules}), you will be able to edit the package recipes. In other cases, you will be able to examine the read-only recipes for packages currently in the store."
  16677. msgstr ""
  16678. #. type: Plain text
  16679. #: guix-git/doc/guix.texi:11090
  16680. msgid "Instead of @env{GUIX_PACKAGE_PATH}, the command-line option @option{--load-path=@var{directory}} (or in short @option{-L @var{directory}}) allows you to add @var{directory} to the front of the package module search path and so make your own packages visible."
  16681. msgstr ""
  16682. #. type: section
  16683. #: guix-git/doc/guix.texi:11092
  16684. #, no-wrap
  16685. msgid "Invoking @command{guix download}"
  16686. msgstr ""
  16687. #. type: command{#1}
  16688. #: guix-git/doc/guix.texi:11094
  16689. #, no-wrap
  16690. msgid "guix download"
  16691. msgstr ""
  16692. #. type: cindex
  16693. #: guix-git/doc/guix.texi:11095
  16694. #, no-wrap
  16695. msgid "downloading package sources"
  16696. msgstr ""
  16697. #. type: Plain text
  16698. #: guix-git/doc/guix.texi:11102
  16699. msgid "When writing a package definition, developers typically need to download a source tarball, compute its SHA256 hash, and write that hash in the package definition (@pxref{Defining Packages}). The @command{guix download} tool helps with this task: it downloads a file from the given URI, adds it to the store, and prints both its file name in the store and its SHA256 hash."
  16700. msgstr ""
  16701. #. type: Plain text
  16702. #: guix-git/doc/guix.texi:11109
  16703. msgid "The fact that the downloaded file is added to the store saves bandwidth: when the developer eventually tries to build the newly defined package with @command{guix build}, the source tarball will not have to be downloaded again because it is already in the store. It is also a convenient way to temporarily stash files, which may be deleted eventually (@pxref{Invoking guix gc})."
  16704. msgstr ""
  16705. #. type: Plain text
  16706. #: guix-git/doc/guix.texi:11117
  16707. msgid "The @command{guix download} command supports the same URIs as used in package definitions. In particular, it supports @code{mirror://} URIs. @code{https} URIs (HTTP over TLS) are supported @emph{provided} the Guile bindings for GnuTLS are available in the user's environment; when they are not available, an error is raised. @xref{Guile Preparations, how to install the GnuTLS bindings for Guile,, gnutls-guile, GnuTLS-Guile}, for more information."
  16708. msgstr ""
  16709. #. type: Plain text
  16710. #: guix-git/doc/guix.texi:11122
  16711. msgid "@command{guix download} verifies HTTPS server certificates by loading the certificates of X.509 authorities from the directory pointed to by the @env{SSL_CERT_DIR} environment variable (@pxref{X.509 Certificates}), unless @option{--no-check-certificate} is used."
  16712. msgstr ""
  16713. #. type: Plain text
  16714. #: guix-git/doc/guix.texi:11124 guix-git/doc/guix.texi:12749
  16715. msgid "The following options are available:"
  16716. msgstr ""
  16717. #. type: item
  16718. #: guix-git/doc/guix.texi:11126 guix-git/doc/guix.texi:11170
  16719. #, no-wrap
  16720. msgid "--hash=@var{algorithm}"
  16721. msgstr ""
  16722. #. type: itemx
  16723. #: guix-git/doc/guix.texi:11127 guix-git/doc/guix.texi:11171
  16724. #, no-wrap
  16725. msgid "-H @var{algorithm}"
  16726. msgstr ""
  16727. #. type: table
  16728. #: guix-git/doc/guix.texi:11130
  16729. msgid "Compute a hash using the specified @var{algorithm}. @xref{Invoking guix hash}, for more information."
  16730. msgstr ""
  16731. #. type: item
  16732. #: guix-git/doc/guix.texi:11131 guix-git/doc/guix.texi:11180
  16733. #, no-wrap
  16734. msgid "--format=@var{fmt}"
  16735. msgstr ""
  16736. #. type: itemx
  16737. #: guix-git/doc/guix.texi:11132 guix-git/doc/guix.texi:11181
  16738. #, no-wrap
  16739. msgid "-f @var{fmt}"
  16740. msgstr ""
  16741. #. type: table
  16742. #: guix-git/doc/guix.texi:11135
  16743. msgid "Write the hash in the format specified by @var{fmt}. For more information on the valid values for @var{fmt}, @pxref{Invoking guix hash}."
  16744. msgstr ""
  16745. #. type: item
  16746. #: guix-git/doc/guix.texi:11136
  16747. #, no-wrap
  16748. msgid "--no-check-certificate"
  16749. msgstr ""
  16750. #. type: table
  16751. #: guix-git/doc/guix.texi:11138
  16752. msgid "Do not validate the X.509 certificates of HTTPS servers."
  16753. msgstr ""
  16754. #. type: table
  16755. #: guix-git/doc/guix.texi:11142
  16756. msgid "When using this option, you have @emph{absolutely no guarantee} that you are communicating with the authentic server responsible for the given URL, which makes you vulnerable to ``man-in-the-middle'' attacks."
  16757. msgstr ""
  16758. #. type: item
  16759. #: guix-git/doc/guix.texi:11143
  16760. #, no-wrap
  16761. msgid "--output=@var{file}"
  16762. msgstr ""
  16763. #. type: itemx
  16764. #: guix-git/doc/guix.texi:11144
  16765. #, no-wrap
  16766. msgid "-o @var{file}"
  16767. msgstr ""
  16768. #. type: table
  16769. #: guix-git/doc/guix.texi:11147
  16770. msgid "Save the downloaded file to @var{file} instead of adding it to the store."
  16771. msgstr ""
  16772. #. type: section
  16773. #: guix-git/doc/guix.texi:11150
  16774. #, no-wrap
  16775. msgid "Invoking @command{guix hash}"
  16776. msgstr ""
  16777. #. type: command{#1}
  16778. #: guix-git/doc/guix.texi:11152
  16779. #, no-wrap
  16780. msgid "guix hash"
  16781. msgstr ""
  16782. #. type: Plain text
  16783. #: guix-git/doc/guix.texi:11157
  16784. msgid "The @command{guix hash} command computes the hash of a file. It is primarily a convenience tool for anyone contributing to the distribution: it computes the cryptographic hash of a file, which can be used in the definition of a package (@pxref{Defining Packages})."
  16785. msgstr ""
  16786. #. type: example
  16787. #: guix-git/doc/guix.texi:11162
  16788. #, no-wrap
  16789. msgid "guix hash @var{option} @var{file}\n"
  16790. msgstr ""
  16791. #. type: Plain text
  16792. #: guix-git/doc/guix.texi:11167
  16793. msgid "When @var{file} is @code{-} (a hyphen), @command{guix hash} computes the hash of data read from standard input. @command{guix hash} has the following options:"
  16794. msgstr ""
  16795. #. type: table
  16796. #: guix-git/doc/guix.texi:11174
  16797. msgid "Compute a hash using the specified @var{algorithm}, @code{sha256} by default."
  16798. msgstr ""
  16799. #. type: table
  16800. #: guix-git/doc/guix.texi:11179
  16801. msgid "@var{algorithm} must the name of a cryptographic hash algorithm supported by Libgcrypt @i{via} Guile-Gcrypt---e.g., @code{sha512} or @code{sha3-256} (@pxref{Hash Functions,,, guile-gcrypt, Guile-Gcrypt Reference Manual})."
  16802. msgstr ""
  16803. #. type: table
  16804. #: guix-git/doc/guix.texi:11183
  16805. msgid "Write the hash in the format specified by @var{fmt}."
  16806. msgstr ""
  16807. #. type: table
  16808. #: guix-git/doc/guix.texi:11186
  16809. msgid "Supported formats: @code{base64}, @code{nix-base32}, @code{base32}, @code{base16} (@code{hex} and @code{hexadecimal} can be used as well)."
  16810. msgstr ""
  16811. #. type: table
  16812. #: guix-git/doc/guix.texi:11190
  16813. msgid "If the @option{--format} option is not specified, @command{guix hash} will output the hash in @code{nix-base32}. This representation is used in the definitions of packages."
  16814. msgstr ""
  16815. #. type: table
  16816. #: guix-git/doc/guix.texi:11194
  16817. msgid "Compute the hash on @var{file} recursively."
  16818. msgstr ""
  16819. #. type: table
  16820. #: guix-git/doc/guix.texi:11203
  16821. msgid "In this case, the hash is computed on an archive containing @var{file}, including its children if it is a directory. Some of the metadata of @var{file} is part of the archive; for instance, when @var{file} is a regular file, the hash is different depending on whether @var{file} is executable or not. Metadata such as time stamps has no impact on the hash (@pxref{Invoking guix archive})."
  16822. msgstr ""
  16823. #. type: item
  16824. #: guix-git/doc/guix.texi:11204
  16825. #, no-wrap
  16826. msgid "--exclude-vcs"
  16827. msgstr ""
  16828. #. type: itemx
  16829. #: guix-git/doc/guix.texi:11205 guix-git/doc/guix.texi:12236
  16830. #, no-wrap
  16831. msgid "-x"
  16832. msgstr ""
  16833. #. type: table
  16834. #: guix-git/doc/guix.texi:11208
  16835. msgid "When combined with @option{--recursive}, exclude version control system directories (@file{.bzr}, @file{.git}, @file{.hg}, etc.)."
  16836. msgstr ""
  16837. #. type: vindex
  16838. #: guix-git/doc/guix.texi:11209
  16839. #, no-wrap
  16840. msgid "git-fetch"
  16841. msgstr ""
  16842. #. type: table
  16843. #: guix-git/doc/guix.texi:11213
  16844. msgid "As an example, here is how you would compute the hash of a Git checkout, which is useful when using the @code{git-fetch} method (@pxref{origin Reference}):"
  16845. msgstr ""
  16846. #. type: example
  16847. #: guix-git/doc/guix.texi:11218
  16848. #, no-wrap
  16849. msgid ""
  16850. "$ git clone http://example.org/foo.git\n"
  16851. "$ cd foo\n"
  16852. "$ guix hash -rx .\n"
  16853. msgstr ""
  16854. #. type: cindex
  16855. #: guix-git/doc/guix.texi:11222 guix-git/doc/guix.texi:11227
  16856. #, no-wrap
  16857. msgid "Invoking @command{guix import}"
  16858. msgstr ""
  16859. #. type: cindex
  16860. #: guix-git/doc/guix.texi:11224
  16861. #, no-wrap
  16862. msgid "importing packages"
  16863. msgstr ""
  16864. #. type: cindex
  16865. #: guix-git/doc/guix.texi:11225
  16866. #, no-wrap
  16867. msgid "package import"
  16868. msgstr ""
  16869. #. type: cindex
  16870. #: guix-git/doc/guix.texi:11226
  16871. #, no-wrap
  16872. msgid "package conversion"
  16873. msgstr ""
  16874. #. type: Plain text
  16875. #: guix-git/doc/guix.texi:11234
  16876. msgid "The @command{guix import} command is useful for people who would like to add a package to the distribution with as little work as possible---a legitimate demand. The command knows of a few repositories from which it can ``import'' package metadata. The result is a package definition, or a template thereof, in the format we know (@pxref{Defining Packages})."
  16877. msgstr ""
  16878. #. type: example
  16879. #: guix-git/doc/guix.texi:11239
  16880. #, no-wrap
  16881. msgid "guix import @var{importer} @var{options}@dots{}\n"
  16882. msgstr ""
  16883. #. type: Plain text
  16884. #: guix-git/doc/guix.texi:11244
  16885. msgid "@var{importer} specifies the source from which to import package metadata, and @var{options} specifies a package identifier and other options specific to @var{importer}."
  16886. msgstr ""
  16887. #. type: Plain text
  16888. #: guix-git/doc/guix.texi:11248
  16889. msgid "Some of the importers rely on the ability to run the @command{gpgv} command. For these, GnuPG must be installed and in @code{$PATH}; run @code{guix install gnupg} if needed."
  16890. msgstr ""
  16891. #. type: Plain text
  16892. #: guix-git/doc/guix.texi:11250
  16893. msgid "Currently, the available ``importers'' are:"
  16894. msgstr ""
  16895. #. type: item
  16896. #: guix-git/doc/guix.texi:11252 guix-git/doc/guix.texi:11881
  16897. #, no-wrap
  16898. msgid "gnu"
  16899. msgstr ""
  16900. #. type: table
  16901. #: guix-git/doc/guix.texi:11256
  16902. msgid "Import metadata for the given GNU package. This provides a template for the latest version of that GNU package, including the hash of its source tarball, and its canonical synopsis and description."
  16903. msgstr ""
  16904. #. type: table
  16905. #: guix-git/doc/guix.texi:11259
  16906. msgid "Additional information such as the package dependencies and its license needs to be figured out manually."
  16907. msgstr ""
  16908. #. type: table
  16909. #: guix-git/doc/guix.texi:11262
  16910. msgid "For example, the following command returns a package definition for GNU@tie{}Hello:"
  16911. msgstr ""
  16912. #. type: example
  16913. #: guix-git/doc/guix.texi:11265
  16914. #, no-wrap
  16915. msgid "guix import gnu hello\n"
  16916. msgstr ""
  16917. #. type: table
  16918. #: guix-git/doc/guix.texi:11268 guix-git/doc/guix.texi:11510
  16919. #: guix-git/doc/guix.texi:11560 guix-git/doc/guix.texi:11589
  16920. msgid "Specific command-line options are:"
  16921. msgstr ""
  16922. #. type: item
  16923. #: guix-git/doc/guix.texi:11270 guix-git/doc/guix.texi:12044
  16924. #, no-wrap
  16925. msgid "--key-download=@var{policy}"
  16926. msgstr ""
  16927. #. type: table
  16928. #: guix-git/doc/guix.texi:11274
  16929. msgid "As for @command{guix refresh}, specify the policy to handle missing OpenPGP keys when verifying the package signature. @xref{Invoking guix refresh, @option{--key-download}}."
  16930. msgstr ""
  16931. #. type: item
  16932. #: guix-git/doc/guix.texi:11276 guix-git/doc/guix.texi:11277
  16933. #: guix-git/doc/guix.texi:11905
  16934. #, no-wrap
  16935. msgid "pypi"
  16936. msgstr ""
  16937. #. type: table
  16938. #: guix-git/doc/guix.texi:11284
  16939. msgid "Import metadata from the @uref{https://pypi.python.org/, Python Package Index}. Information is taken from the JSON-formatted description available at @code{pypi.python.org} and usually includes all the relevant information, including package dependencies. For maximum efficiency, it is recommended to install the @command{unzip} utility, so that the importer can unzip Python wheels and gather data from them."
  16940. msgstr ""
  16941. #. type: table
  16942. #: guix-git/doc/guix.texi:11287
  16943. msgid "The command below imports metadata for the @code{itsdangerous} Python package:"
  16944. msgstr ""
  16945. #. type: example
  16946. #: guix-git/doc/guix.texi:11290
  16947. #, no-wrap
  16948. msgid "guix import pypi itsdangerous\n"
  16949. msgstr ""
  16950. #. type: table
  16951. #: guix-git/doc/guix.texi:11298 guix-git/doc/guix.texi:11323
  16952. #: guix-git/doc/guix.texi:11355 guix-git/doc/guix.texi:11533
  16953. #: guix-git/doc/guix.texi:11574 guix-git/doc/guix.texi:11621
  16954. #: guix-git/doc/guix.texi:11646 guix-git/doc/guix.texi:11662
  16955. #: guix-git/doc/guix.texi:11710 guix-git/doc/guix.texi:11740
  16956. msgid "Traverse the dependency graph of the given upstream package recursively and generate package expressions for all those packages that are not yet in Guix."
  16957. msgstr ""
  16958. #. type: item
  16959. #: guix-git/doc/guix.texi:11300 guix-git/doc/guix.texi:11301
  16960. #: guix-git/doc/guix.texi:11907
  16961. #, no-wrap
  16962. msgid "gem"
  16963. msgstr ""
  16964. #. type: table
  16965. #: guix-git/doc/guix.texi:11310
  16966. msgid "Import metadata from @uref{https://rubygems.org/, RubyGems}. Information is taken from the JSON-formatted description available at @code{rubygems.org} and includes most relevant information, including runtime dependencies. There are some caveats, however. The metadata doesn't distinguish between synopses and descriptions, so the same string is used for both fields. Additionally, the details of non-Ruby dependencies required to build native extensions is unavailable and left as an exercise to the packager."
  16967. msgstr ""
  16968. #. type: table
  16969. #: guix-git/doc/guix.texi:11312
  16970. msgid "The command below imports metadata for the @code{rails} Ruby package:"
  16971. msgstr ""
  16972. #. type: example
  16973. #: guix-git/doc/guix.texi:11315
  16974. #, no-wrap
  16975. msgid "guix import gem rails\n"
  16976. msgstr ""
  16977. #. type: item
  16978. #: guix-git/doc/guix.texi:11325
  16979. #, no-wrap
  16980. msgid "contentdb"
  16981. msgstr ""
  16982. #. type: cindex
  16983. #: guix-git/doc/guix.texi:11326
  16984. #, no-wrap
  16985. msgid "minetest"
  16986. msgstr ""
  16987. #. type: cindex
  16988. #: guix-git/doc/guix.texi:11327
  16989. #, no-wrap
  16990. msgid "ContentDB"
  16991. msgstr ""
  16992. #. type: table
  16993. #: guix-git/doc/guix.texi:11336
  16994. msgid "Import metadata from @uref{https://content.minetest.net, ContentDB}. Information is taken from the JSON-formatted metadata provided through @uref{https://content.minetest.net/help/api/, ContentDB's API} and includes most relevant information, including dependencies. There are some caveats, however. The license information is often incomplete. The commit hash is sometimes missing. The descriptions are in the Markdown format, but Guix uses Texinfo instead. Texture packs and subgames are unsupported."
  16995. msgstr ""
  16996. #. type: table
  16997. #: guix-git/doc/guix.texi:11338
  16998. msgid "The command below imports metadata for the Mesecons mod by Jeija:"
  16999. msgstr ""
  17000. #. type: example
  17001. #: guix-git/doc/guix.texi:11341
  17002. #, no-wrap
  17003. msgid "guix import minetest Jeija/mesecons\n"
  17004. msgstr ""
  17005. #. type: table
  17006. #: guix-git/doc/guix.texi:11344
  17007. msgid "The author name can also be left out:"
  17008. msgstr ""
  17009. #. type: example
  17010. #: guix-git/doc/guix.texi:11347
  17011. #, no-wrap
  17012. msgid "guix import minetest mesecons\n"
  17013. msgstr ""
  17014. #. type: item
  17015. #: guix-git/doc/guix.texi:11357 guix-git/doc/guix.texi:11903
  17016. #, no-wrap
  17017. msgid "cpan"
  17018. msgstr ""
  17019. #. type: cindex
  17020. #: guix-git/doc/guix.texi:11358
  17021. #, no-wrap
  17022. msgid "CPAN"
  17023. msgstr ""
  17024. #. type: table
  17025. #: guix-git/doc/guix.texi:11366
  17026. msgid "Import metadata from @uref{https://www.metacpan.org/, MetaCPAN}. Information is taken from the JSON-formatted metadata provided through @uref{https://fastapi.metacpan.org/, MetaCPAN's API} and includes most relevant information, such as module dependencies. License information should be checked closely. If Perl is available in the store, then the @code{corelist} utility will be used to filter core modules out of the list of dependencies."
  17027. msgstr ""
  17028. #. type: table
  17029. #: guix-git/doc/guix.texi:11369
  17030. msgid "The command command below imports metadata for the Acme::Boolean Perl module:"
  17031. msgstr ""
  17032. #. type: example
  17033. #: guix-git/doc/guix.texi:11372
  17034. #, no-wrap
  17035. msgid "guix import cpan Acme::Boolean\n"
  17036. msgstr ""
  17037. #. type: item
  17038. #: guix-git/doc/guix.texi:11374 guix-git/doc/guix.texi:11899
  17039. #, no-wrap
  17040. msgid "cran"
  17041. msgstr ""
  17042. #. type: cindex
  17043. #: guix-git/doc/guix.texi:11375
  17044. #, no-wrap
  17045. msgid "CRAN"
  17046. msgstr ""
  17047. #. type: cindex
  17048. #: guix-git/doc/guix.texi:11376
  17049. #, no-wrap
  17050. msgid "Bioconductor"
  17051. msgstr ""
  17052. #. type: table
  17053. #: guix-git/doc/guix.texi:11380
  17054. msgid "Import metadata from @uref{https://cran.r-project.org/, CRAN}, the central repository for the @uref{https://r-project.org, GNU@tie{}R statistical and graphical environment}."
  17055. msgstr ""
  17056. #. type: table
  17057. #: guix-git/doc/guix.texi:11382
  17058. msgid "Information is extracted from the @file{DESCRIPTION} file of the package."
  17059. msgstr ""
  17060. #. type: table
  17061. #: guix-git/doc/guix.texi:11384
  17062. msgid "The command command below imports metadata for the Cairo R package:"
  17063. msgstr ""
  17064. #. type: example
  17065. #: guix-git/doc/guix.texi:11387
  17066. #, no-wrap
  17067. msgid "guix import cran Cairo\n"
  17068. msgstr ""
  17069. #. type: table
  17070. #: guix-git/doc/guix.texi:11392
  17071. msgid "When @option{--recursive} is added, the importer will traverse the dependency graph of the given upstream package recursively and generate package expressions for all those packages that are not yet in Guix."
  17072. msgstr ""
  17073. #. type: table
  17074. #: guix-git/doc/guix.texi:11399
  17075. msgid "When @option{--style=specification} is added, the importer will generate package definitions whose inputs are package specifications instead of references to package variables. This is useful when generated package definitions are to be appended to existing user modules, as the list of used package modules need not be changed. The default is @option{--style=variable}."
  17076. msgstr ""
  17077. #. type: table
  17078. #: guix-git/doc/guix.texi:11404
  17079. msgid "When @option{--archive=bioconductor} is added, metadata is imported from @uref{https://www.bioconductor.org/, Bioconductor}, a repository of R packages for the analysis and comprehension of high-throughput genomic data in bioinformatics."
  17080. msgstr ""
  17081. #. type: table
  17082. #: guix-git/doc/guix.texi:11407
  17083. msgid "Information is extracted from the @file{DESCRIPTION} file contained in the package archive."
  17084. msgstr ""
  17085. #. type: table
  17086. #: guix-git/doc/guix.texi:11409
  17087. msgid "The command below imports metadata for the GenomicRanges R package:"
  17088. msgstr ""
  17089. #. type: example
  17090. #: guix-git/doc/guix.texi:11412
  17091. #, no-wrap
  17092. msgid "guix import cran --archive=bioconductor GenomicRanges\n"
  17093. msgstr ""
  17094. #. type: table
  17095. #: guix-git/doc/guix.texi:11417
  17096. msgid "Finally, you can also import R packages that have not yet been published on CRAN or Bioconductor as long as they are in a git repository. Use @option{--archive=git} followed by the URL of the git repository:"
  17097. msgstr ""
  17098. #. type: example
  17099. #: guix-git/doc/guix.texi:11420
  17100. #, no-wrap
  17101. msgid "guix import cran --archive=git https://github.com/immunogenomics/harmony\n"
  17102. msgstr ""
  17103. #. type: item
  17104. #: guix-git/doc/guix.texi:11422
  17105. #, no-wrap
  17106. msgid "texlive"
  17107. msgstr ""
  17108. #. type: cindex
  17109. #: guix-git/doc/guix.texi:11423
  17110. #, no-wrap
  17111. msgid "TeX Live"
  17112. msgstr ""
  17113. #. type: cindex
  17114. #: guix-git/doc/guix.texi:11424
  17115. #, no-wrap
  17116. msgid "CTAN"
  17117. msgstr ""
  17118. #. type: table
  17119. #: guix-git/doc/guix.texi:11428
  17120. msgid "Import metadata from @uref{https://www.ctan.org/, CTAN}, the comprehensive TeX archive network for TeX packages that are part of the @uref{https://www.tug.org/texlive/, TeX Live distribution}."
  17121. msgstr ""
  17122. #. type: table
  17123. #: guix-git/doc/guix.texi:11433
  17124. msgid "Information about the package is obtained through the XML API provided by CTAN, while the source code is downloaded from the SVN repository of the Tex Live project. This is done because the CTAN does not keep versioned archives."
  17125. msgstr ""
  17126. #. type: table
  17127. #: guix-git/doc/guix.texi:11436
  17128. msgid "The command command below imports metadata for the @code{fontspec} TeX package:"
  17129. msgstr ""
  17130. #. type: example
  17131. #: guix-git/doc/guix.texi:11439
  17132. #, no-wrap
  17133. msgid "guix import texlive fontspec\n"
  17134. msgstr ""
  17135. #. type: table
  17136. #: guix-git/doc/guix.texi:11445
  17137. msgid "When @option{--archive=@var{directory}} is added, the source code is downloaded not from the @file{latex} sub-directory of the @file{texmf-dist/source} tree in the TeX Live SVN repository, but from the specified sibling @var{directory} under the same root."
  17138. msgstr ""
  17139. #. type: table
  17140. #: guix-git/doc/guix.texi:11449
  17141. msgid "The command below imports metadata for the @code{ifxetex} package from CTAN while fetching the sources from the directory @file{texmf/source/generic}:"
  17142. msgstr ""
  17143. #. type: example
  17144. #: guix-git/doc/guix.texi:11452
  17145. #, no-wrap
  17146. msgid "guix import texlive --archive=generic ifxetex\n"
  17147. msgstr ""
  17148. #. type: cindex
  17149. #: guix-git/doc/guix.texi:11455
  17150. #, no-wrap
  17151. msgid "JSON, import"
  17152. msgstr ""
  17153. #. type: table
  17154. #: guix-git/doc/guix.texi:11458
  17155. msgid "Import package metadata from a local JSON file. Consider the following example package definition in JSON format:"
  17156. msgstr ""
  17157. #. type: example
  17158. #: guix-git/doc/guix.texi:11471
  17159. #, no-wrap
  17160. msgid ""
  17161. "@{\n"
  17162. " \"name\": \"hello\",\n"
  17163. " \"version\": \"2.10\",\n"
  17164. " \"source\": \"mirror://gnu/hello/hello-2.10.tar.gz\",\n"
  17165. " \"build-system\": \"gnu\",\n"
  17166. " \"home-page\": \"https://www.gnu.org/software/hello/\",\n"
  17167. " \"synopsis\": \"Hello, GNU world: An example GNU package\",\n"
  17168. " \"description\": \"GNU Hello prints a greeting.\",\n"
  17169. " \"license\": \"GPL-3.0+\",\n"
  17170. " \"native-inputs\": [\"gettext\"]\n"
  17171. "@}\n"
  17172. msgstr ""
  17173. #. type: table
  17174. #: guix-git/doc/guix.texi:11477
  17175. msgid "The field names are the same as for the @code{<package>} record (@xref{Defining Packages}). References to other packages are provided as JSON lists of quoted package specification strings such as @code{guile} or @code{guile@@2.0}."
  17176. msgstr ""
  17177. #. type: table
  17178. #: guix-git/doc/guix.texi:11480
  17179. msgid "The importer also supports a more explicit source definition using the common fields for @code{<origin>} records:"
  17180. msgstr ""
  17181. #. type: example
  17182. #: guix-git/doc/guix.texi:11493
  17183. #, no-wrap
  17184. msgid ""
  17185. "@{\n"
  17186. " @dots{}\n"
  17187. " \"source\": @{\n"
  17188. " \"method\": \"url-fetch\",\n"
  17189. " \"uri\": \"mirror://gnu/hello/hello-2.10.tar.gz\",\n"
  17190. " \"sha256\": @{\n"
  17191. " \"base32\": \"0ssi1wpaf7plaswqqjwigppsg5fyh99vdlb9kzl7c9lng89ndq1i\"\n"
  17192. " @}\n"
  17193. " @}\n"
  17194. " @dots{}\n"
  17195. "@}\n"
  17196. msgstr ""
  17197. #. type: table
  17198. #: guix-git/doc/guix.texi:11497
  17199. msgid "The command below reads metadata from the JSON file @code{hello.json} and outputs a package expression:"
  17200. msgstr ""
  17201. #. type: example
  17202. #: guix-git/doc/guix.texi:11500
  17203. #, no-wrap
  17204. msgid "guix import json hello.json\n"
  17205. msgstr ""
  17206. #. type: item
  17207. #: guix-git/doc/guix.texi:11502 guix-git/doc/guix.texi:11503
  17208. #: guix-git/doc/guix.texi:11911
  17209. #, no-wrap
  17210. msgid "hackage"
  17211. msgstr ""
  17212. #. type: table
  17213. #: guix-git/doc/guix.texi:11508
  17214. msgid "Import metadata from the Haskell community's central package archive @uref{https://hackage.haskell.org/, Hackage}. Information is taken from Cabal files and includes all the relevant information, including package dependencies."
  17215. msgstr ""
  17216. #. type: item
  17217. #: guix-git/doc/guix.texi:11512
  17218. #, no-wrap
  17219. msgid "--stdin"
  17220. msgstr ""
  17221. #. type: itemx
  17222. #: guix-git/doc/guix.texi:11513
  17223. #, no-wrap
  17224. msgid "-s"
  17225. msgstr ""
  17226. #. type: table
  17227. #: guix-git/doc/guix.texi:11515
  17228. msgid "Read a Cabal file from standard input."
  17229. msgstr ""
  17230. #. type: item
  17231. #: guix-git/doc/guix.texi:11515 guix-git/doc/guix.texi:11562
  17232. #, no-wrap
  17233. msgid "--no-test-dependencies"
  17234. msgstr ""
  17235. #. type: table
  17236. #: guix-git/doc/guix.texi:11518 guix-git/doc/guix.texi:11565
  17237. msgid "Do not include dependencies required only by the test suites."
  17238. msgstr ""
  17239. #. type: item
  17240. #: guix-git/doc/guix.texi:11518
  17241. #, no-wrap
  17242. msgid "--cabal-environment=@var{alist}"
  17243. msgstr ""
  17244. #. type: itemx
  17245. #: guix-git/doc/guix.texi:11519
  17246. #, no-wrap
  17247. msgid "-e @var{alist}"
  17248. msgstr ""
  17249. #. type: table
  17250. #: guix-git/doc/guix.texi:11528
  17251. msgid "@var{alist} is a Scheme alist defining the environment in which the Cabal conditionals are evaluated. The accepted keys are: @code{os}, @code{arch}, @code{impl} and a string representing the name of a flag. The value associated with a flag has to be either the symbol @code{true} or @code{false}. The value associated with other keys has to conform to the Cabal file format definition. The default value associated with the keys @code{os}, @code{arch} and @code{impl} is @samp{linux}, @samp{x86_64} and @samp{ghc}, respectively."
  17252. msgstr ""
  17253. #. type: table
  17254. #: guix-git/doc/guix.texi:11538
  17255. msgid "The command below imports metadata for the latest version of the HTTP Haskell package without including test dependencies and specifying the value of the flag @samp{network-uri} as @code{false}:"
  17256. msgstr ""
  17257. #. type: example
  17258. #: guix-git/doc/guix.texi:11541
  17259. #, no-wrap
  17260. msgid "guix import hackage -t -e \"'((\\\"network-uri\\\" . false))\" HTTP\n"
  17261. msgstr ""
  17262. #. type: table
  17263. #: guix-git/doc/guix.texi:11545
  17264. msgid "A specific package version may optionally be specified by following the package name by an at-sign and a version number as in the following example:"
  17265. msgstr ""
  17266. #. type: example
  17267. #: guix-git/doc/guix.texi:11548
  17268. #, no-wrap
  17269. msgid "guix import hackage mtl@@2.1.3.1\n"
  17270. msgstr ""
  17271. #. type: item
  17272. #: guix-git/doc/guix.texi:11550 guix-git/doc/guix.texi:11551
  17273. #: guix-git/doc/guix.texi:11913
  17274. #, no-wrap
  17275. msgid "stackage"
  17276. msgstr ""
  17277. #. type: table
  17278. #: guix-git/doc/guix.texi:11558
  17279. msgid "The @code{stackage} importer is a wrapper around the @code{hackage} one. It takes a package name, looks up the package version included in a long-term support (LTS) @uref{https://www.stackage.org, Stackage} release and uses the @code{hackage} importer to retrieve its metadata. Note that it is up to you to select an LTS release compatible with the GHC compiler used by Guix."
  17280. msgstr ""
  17281. #. type: item
  17282. #: guix-git/doc/guix.texi:11565
  17283. #, no-wrap
  17284. msgid "--lts-version=@var{version}"
  17285. msgstr ""
  17286. #. type: itemx
  17287. #: guix-git/doc/guix.texi:11566
  17288. #, no-wrap
  17289. msgid "-l @var{version}"
  17290. msgstr ""
  17291. #. type: table
  17292. #: guix-git/doc/guix.texi:11569
  17293. msgid "@var{version} is the desired LTS release version. If omitted the latest release is used."
  17294. msgstr ""
  17295. #. type: table
  17296. #: guix-git/doc/guix.texi:11578
  17297. msgid "The command below imports metadata for the HTTP Haskell package included in the LTS Stackage release version 7.18:"
  17298. msgstr ""
  17299. #. type: example
  17300. #: guix-git/doc/guix.texi:11581
  17301. #, no-wrap
  17302. msgid "guix import stackage --lts-version=7.18 HTTP\n"
  17303. msgstr ""
  17304. #. type: item
  17305. #: guix-git/doc/guix.texi:11583 guix-git/doc/guix.texi:11584
  17306. #: guix-git/doc/guix.texi:11897
  17307. #, no-wrap
  17308. msgid "elpa"
  17309. msgstr ""
  17310. #. type: table
  17311. #: guix-git/doc/guix.texi:11587
  17312. msgid "Import metadata from an Emacs Lisp Package Archive (ELPA) package repository (@pxref{Packages,,, emacs, The GNU Emacs Manual})."
  17313. msgstr ""
  17314. #. type: item
  17315. #: guix-git/doc/guix.texi:11591
  17316. #, no-wrap
  17317. msgid "--archive=@var{repo}"
  17318. msgstr ""
  17319. #. type: itemx
  17320. #: guix-git/doc/guix.texi:11592
  17321. #, no-wrap
  17322. msgid "-a @var{repo}"
  17323. msgstr ""
  17324. #. type: table
  17325. #: guix-git/doc/guix.texi:11596
  17326. msgid "@var{repo} identifies the archive repository from which to retrieve the information. Currently the supported repositories and their identifiers are:"
  17327. msgstr ""
  17328. #. type: itemize
  17329. #: guix-git/doc/guix.texi:11600
  17330. msgid "@uref{https://elpa.gnu.org/packages, GNU}, selected by the @code{gnu} identifier. This is the default."
  17331. msgstr ""
  17332. #. type: itemize
  17333. #: guix-git/doc/guix.texi:11606
  17334. msgid "Packages from @code{elpa.gnu.org} are signed with one of the keys contained in the GnuPG keyring at @file{share/emacs/25.1/etc/package-keyring.gpg} (or similar) in the @code{emacs} package (@pxref{Package Installation, ELPA package signatures,, emacs, The GNU Emacs Manual})."
  17335. msgstr ""
  17336. #. type: itemize
  17337. #: guix-git/doc/guix.texi:11610
  17338. msgid "@uref{https://stable.melpa.org/packages, MELPA-Stable}, selected by the @code{melpa-stable} identifier."
  17339. msgstr ""
  17340. #. type: itemize
  17341. #: guix-git/doc/guix.texi:11614
  17342. msgid "@uref{https://melpa.org/packages, MELPA}, selected by the @code{melpa} identifier."
  17343. msgstr ""
  17344. #. type: item
  17345. #: guix-git/doc/guix.texi:11623 guix-git/doc/guix.texi:11624
  17346. #: guix-git/doc/guix.texi:11915
  17347. #, no-wrap
  17348. msgid "crate"
  17349. msgstr ""
  17350. #. type: table
  17351. #: guix-git/doc/guix.texi:11627
  17352. msgid "Import metadata from the crates.io Rust package repository @uref{https://crates.io, crates.io}, as in this example:"
  17353. msgstr ""
  17354. #. type: example
  17355. #: guix-git/doc/guix.texi:11630
  17356. #, no-wrap
  17357. msgid "guix import crate blake2-rfc\n"
  17358. msgstr ""
  17359. #. type: table
  17360. #: guix-git/doc/guix.texi:11633
  17361. msgid "The crate importer also allows you to specify a version string:"
  17362. msgstr ""
  17363. #. type: example
  17364. #: guix-git/doc/guix.texi:11636
  17365. #, no-wrap
  17366. msgid "guix import crate constant-time-eq@@0.1.0\n"
  17367. msgstr ""
  17368. #. type: table
  17369. #: guix-git/doc/guix.texi:11639 guix-git/doc/guix.texi:11655
  17370. #: guix-git/doc/guix.texi:11703 guix-git/doc/guix.texi:11734
  17371. msgid "Additional options include:"
  17372. msgstr ""
  17373. #. type: item
  17374. #: guix-git/doc/guix.texi:11648
  17375. #, no-wrap
  17376. msgid "opam"
  17377. msgstr ""
  17378. #. type: cindex
  17379. #: guix-git/doc/guix.texi:11649
  17380. #, no-wrap
  17381. msgid "OPAM"
  17382. msgstr ""
  17383. #. type: cindex
  17384. #: guix-git/doc/guix.texi:11650
  17385. #, no-wrap
  17386. msgid "OCaml"
  17387. msgstr ""
  17388. #. type: table
  17389. #: guix-git/doc/guix.texi:11653
  17390. msgid "Import metadata from the @uref{https://opam.ocaml.org/, OPAM} package repository used by the OCaml community."
  17391. msgstr ""
  17392. #. type: item
  17393. #: guix-git/doc/guix.texi:11662
  17394. #, no-wrap
  17395. msgid "--repo"
  17396. msgstr ""
  17397. #. type: table
  17398. #: guix-git/doc/guix.texi:11666
  17399. msgid "By default, packages are searched in the official OPAM repository. This option, which can be used more than once, lets you add other repositories which will be searched for packages. It accepts as valid arguments:"
  17400. msgstr ""
  17401. #. type: item
  17402. #: guix-git/doc/guix.texi:11668
  17403. #, no-wrap
  17404. msgid "the name of a known repository - can be one of @code{opam},"
  17405. msgstr ""
  17406. #. type: itemize
  17407. #: guix-git/doc/guix.texi:11671
  17408. msgid "@code{coq} (equivalent to @code{coq-released}), @code{coq-core-dev}, @code{coq-extra-dev} or @code{grew}."
  17409. msgstr ""
  17410. #. type: item
  17411. #: guix-git/doc/guix.texi:11671
  17412. #, no-wrap
  17413. msgid "the URL of a repository as expected by the"
  17414. msgstr ""
  17415. #. type: itemize
  17416. #: guix-git/doc/guix.texi:11675
  17417. msgid "@code{opam repository add} command (for instance, the URL equivalent of the above @code{opam} name would be @uref{https://opam.ocaml.org})."
  17418. msgstr ""
  17419. #. type: item
  17420. #: guix-git/doc/guix.texi:11675
  17421. #, no-wrap
  17422. msgid "the path to a local copy of a repository (a directory containing a"
  17423. msgstr ""
  17424. #. type: itemize
  17425. #: guix-git/doc/guix.texi:11677
  17426. msgid "@file{packages/} sub-directory)."
  17427. msgstr ""
  17428. #. type: table
  17429. #: guix-git/doc/guix.texi:11682
  17430. msgid "Repositories are assumed to be passed to this option by order of preference. The additional repositories will not replace the default @code{opam} repository, which is always kept as a fallback."
  17431. msgstr ""
  17432. #. type: table
  17433. #: guix-git/doc/guix.texi:11687
  17434. msgid "Also, please note that versions are not compared accross repositories. The first repository (from left to right) that has at least one version of a given package will prevail over any others, and the version imported will be the latest one found @emph{in this repository only}."
  17435. msgstr ""
  17436. #. type: cindex
  17437. #: guix-git/doc/guix.texi:11690 guix-git/doc/guix.texi:11691
  17438. #, no-wrap
  17439. msgid "go"
  17440. msgstr ""
  17441. #. type: table
  17442. #: guix-git/doc/guix.texi:11694
  17443. msgid "Import metadata for a Go module using @uref{https://proxy.golang.org, proxy.golang.org}."
  17444. msgstr ""
  17445. #. type: example
  17446. #: guix-git/doc/guix.texi:11697
  17447. #, no-wrap
  17448. msgid "guix import go gopkg.in/yaml.v2\n"
  17449. msgstr ""
  17450. #. type: table
  17451. #: guix-git/doc/guix.texi:11701
  17452. msgid "It is possible to use a package specification with a @code{@@VERSION} suffix to import a specific version."
  17453. msgstr ""
  17454. #. type: item
  17455. #: guix-git/doc/guix.texi:11710
  17456. #, no-wrap
  17457. msgid "--pin-versions"
  17458. msgstr ""
  17459. #. type: table
  17460. #: guix-git/doc/guix.texi:11718
  17461. msgid "When using this option, the importer preserves the exact versions of the Go modules dependencies instead of using their latest available versions. This can be useful when attempting to import packages that recursively depend on former versions of themselves to build. When using this mode, the symbol of the package is made by appending the version to its name, so that multiple versions of the same package can coexist."
  17462. msgstr ""
  17463. #. type: item
  17464. #: guix-git/doc/guix.texi:11720 guix-git/doc/guix.texi:11721
  17465. #: guix-git/doc/guix.texi:11895
  17466. #, no-wrap
  17467. msgid "egg"
  17468. msgstr ""
  17469. #. type: table
  17470. #: guix-git/doc/guix.texi:11728
  17471. msgid "Import metadata for @uref{https://wiki.call-cc.org/eggs, CHICKEN eggs}. The information is taken from @file{PACKAGE.egg} files found in the @uref{git://code.call-cc.org/eggs-5-latest, eggs-5-latest} Git repository. However, it does not provide all the information that we need, there is no ``description'' field, and the licenses used are not always precise (BSD is often used instead of BSD-N)."
  17472. msgstr ""
  17473. #. type: example
  17474. #: guix-git/doc/guix.texi:11731
  17475. #, no-wrap
  17476. msgid "guix import egg sourcehut\n"
  17477. msgstr ""
  17478. #. type: Plain text
  17479. #: guix-git/doc/guix.texi:11746
  17480. msgid "The structure of the @command{guix import} code is modular. It would be useful to have more importers for other package formats, and your help is welcome here (@pxref{Contributing})."
  17481. msgstr ""
  17482. #. type: section
  17483. #: guix-git/doc/guix.texi:11748
  17484. #, no-wrap
  17485. msgid "Invoking @command{guix refresh}"
  17486. msgstr ""
  17487. #. type: command{#1}
  17488. #: guix-git/doc/guix.texi:11750
  17489. #, no-wrap
  17490. msgid "guix refresh"
  17491. msgstr ""
  17492. #. type: Plain text
  17493. #: guix-git/doc/guix.texi:11758
  17494. msgid "The primary audience of the @command{guix refresh} command is packagers. As a user, you may be interested in the @option{--with-latest} option, which can bring you package update superpowers built upon @command{guix refresh} (@pxref{Package Transformation Options, @option{--with-latest}}). By default, @command{guix refresh} reports any packages provided by the distribution that are outdated compared to the latest upstream version, like this:"
  17495. msgstr ""
  17496. #. type: example
  17497. #: guix-git/doc/guix.texi:11763
  17498. #, no-wrap
  17499. msgid ""
  17500. "$ guix refresh\n"
  17501. "gnu/packages/gettext.scm:29:13: gettext would be upgraded from 0.18.1.1 to 0.18.2.1\n"
  17502. "gnu/packages/glib.scm:77:12: glib would be upgraded from 2.34.3 to 2.37.0\n"
  17503. msgstr ""
  17504. #. type: Plain text
  17505. #: guix-git/doc/guix.texi:11767
  17506. msgid "Alternatively, one can specify packages to consider, in which case a warning is emitted for packages that lack an updater:"
  17507. msgstr ""
  17508. #. type: example
  17509. #: guix-git/doc/guix.texi:11772
  17510. #, no-wrap
  17511. msgid ""
  17512. "$ guix refresh coreutils guile guile-ssh\n"
  17513. "gnu/packages/ssh.scm:205:2: warning: no updater for guile-ssh\n"
  17514. "gnu/packages/guile.scm:136:12: guile would be upgraded from 2.0.12 to 2.0.13\n"
  17515. msgstr ""
  17516. #. type: Plain text
  17517. #: guix-git/doc/guix.texi:11781
  17518. msgid "@command{guix refresh} browses the upstream repository of each package and determines the highest version number of the releases therein. The command knows how to update specific types of packages: GNU packages, ELPA packages, etc.---see the documentation for @option{--type} below. There are many packages, though, for which it lacks a method to determine whether a new upstream release is available. However, the mechanism is extensible, so feel free to get in touch with us to add a new method!"
  17519. msgstr ""
  17520. #. type: table
  17521. #: guix-git/doc/guix.texi:11786
  17522. msgid "Consider the packages specified, and all the packages upon which they depend."
  17523. msgstr ""
  17524. #. type: example
  17525. #: guix-git/doc/guix.texi:11794
  17526. #, no-wrap
  17527. msgid ""
  17528. "$ guix refresh --recursive coreutils\n"
  17529. "gnu/packages/acl.scm:40:13: acl would be upgraded from 2.2.53 to 2.3.1\n"
  17530. "gnu/packages/m4.scm:30:12: 1.4.18 is already the latest version of m4\n"
  17531. "gnu/packages/xml.scm:68:2: warning: no updater for expat\n"
  17532. "gnu/packages/multiprecision.scm:40:12: 6.1.2 is already the latest version of gmp\n"
  17533. "@dots{}\n"
  17534. msgstr ""
  17535. #. type: Plain text
  17536. #: guix-git/doc/guix.texi:11802
  17537. msgid "Sometimes the upstream name differs from the package name used in Guix, and @command{guix refresh} needs a little help. Most updaters honor the @code{upstream-name} property in package definitions, which can be used to that effect:"
  17538. msgstr ""
  17539. #. type: lisp
  17540. #: guix-git/doc/guix.texi:11809
  17541. #, no-wrap
  17542. msgid ""
  17543. "(define-public network-manager\n"
  17544. " (package\n"
  17545. " (name \"network-manager\")\n"
  17546. " ;; @dots{}\n"
  17547. " (properties '((upstream-name . \"NetworkManager\")))))\n"
  17548. msgstr ""
  17549. #. type: Plain text
  17550. #: guix-git/doc/guix.texi:11818
  17551. msgid "When passed @option{--update}, it modifies distribution source files to update the version numbers and source tarball hashes of those package recipes (@pxref{Defining Packages}). This is achieved by downloading each package's latest source tarball and its associated OpenPGP signature, authenticating the downloaded tarball against its signature using @command{gpgv}, and finally computing its hash---note that GnuPG must be installed and in @code{$PATH}; run @code{guix install gnupg} if needed."
  17552. msgstr ""
  17553. #. type: Plain text
  17554. #: guix-git/doc/guix.texi:11824
  17555. msgid "When the public key used to sign the tarball is missing from the user's keyring, an attempt is made to automatically retrieve it from a public key server; when this is successful, the key is added to the user's keyring; otherwise, @command{guix refresh} reports an error."
  17556. msgstr ""
  17557. #. type: Plain text
  17558. #: guix-git/doc/guix.texi:11826
  17559. msgid "The following options are supported:"
  17560. msgstr ""
  17561. #. type: table
  17562. #: guix-git/doc/guix.texi:11834 guix-git/doc/guix.texi:12631
  17563. msgid "This is useful to precisely refer to a package, as in this example:"
  17564. msgstr ""
  17565. #. type: example
  17566. #: guix-git/doc/guix.texi:11837
  17567. #, no-wrap
  17568. msgid "guix refresh -l -e '(@@@@ (gnu packages commencement) glibc-final)'\n"
  17569. msgstr ""
  17570. #. type: table
  17571. #: guix-git/doc/guix.texi:11841
  17572. msgid "This command lists the dependents of the ``final'' libc (essentially all the packages)."
  17573. msgstr ""
  17574. #. type: item
  17575. #: guix-git/doc/guix.texi:11842
  17576. #, no-wrap
  17577. msgid "--update"
  17578. msgstr ""
  17579. #. type: itemx
  17580. #: guix-git/doc/guix.texi:11843
  17581. #, no-wrap
  17582. msgid "-u"
  17583. msgstr ""
  17584. #. type: table
  17585. #: guix-git/doc/guix.texi:11847
  17586. msgid "Update distribution source files (package recipes) in place. This is usually run from a checkout of the Guix source tree (@pxref{Running Guix Before It Is Installed}):"
  17587. msgstr ""
  17588. #. type: example
  17589. #: guix-git/doc/guix.texi:11850
  17590. #, no-wrap
  17591. msgid "$ ./pre-inst-env guix refresh -s non-core -u\n"
  17592. msgstr ""
  17593. #. type: table
  17594. #: guix-git/doc/guix.texi:11853
  17595. msgid "@xref{Defining Packages}, for more information on package definitions."
  17596. msgstr ""
  17597. #. type: item
  17598. #: guix-git/doc/guix.texi:11854
  17599. #, no-wrap
  17600. msgid "--select=[@var{subset}]"
  17601. msgstr ""
  17602. #. type: itemx
  17603. #: guix-git/doc/guix.texi:11855
  17604. #, no-wrap
  17605. msgid "-s @var{subset}"
  17606. msgstr ""
  17607. #. type: table
  17608. #: guix-git/doc/guix.texi:11858
  17609. msgid "Select all the packages in @var{subset}, one of @code{core} or @code{non-core}."
  17610. msgstr ""
  17611. #. type: table
  17612. #: guix-git/doc/guix.texi:11865
  17613. msgid "The @code{core} subset refers to all the packages at the core of the distribution---i.e., packages that are used to build ``everything else''. This includes GCC, libc, Binutils, Bash, etc. Usually, changing one of these packages in the distribution entails a rebuild of all the others. Thus, such updates are an inconvenience to users in terms of build time or bandwidth used to achieve the upgrade."
  17614. msgstr ""
  17615. #. type: table
  17616. #: guix-git/doc/guix.texi:11869
  17617. msgid "The @code{non-core} subset refers to the remaining packages. It is typically useful in cases where an update of the core packages would be inconvenient."
  17618. msgstr ""
  17619. #. type: table
  17620. #: guix-git/doc/guix.texi:11874
  17621. msgid "Select all the packages from the manifest in @var{file}. This is useful to check if any packages of the user manifest can be updated."
  17622. msgstr ""
  17623. #. type: item
  17624. #: guix-git/doc/guix.texi:11875
  17625. #, no-wrap
  17626. msgid "--type=@var{updater}"
  17627. msgstr ""
  17628. #. type: itemx
  17629. #: guix-git/doc/guix.texi:11876
  17630. #, no-wrap
  17631. msgid "-t @var{updater}"
  17632. msgstr ""
  17633. #. type: table
  17634. #: guix-git/doc/guix.texi:11879
  17635. msgid "Select only packages handled by @var{updater} (may be a comma-separated list of updaters). Currently, @var{updater} may be one of:"
  17636. msgstr ""
  17637. #. type: table
  17638. #: guix-git/doc/guix.texi:11883
  17639. msgid "the updater for GNU packages;"
  17640. msgstr ""
  17641. #. type: item
  17642. #: guix-git/doc/guix.texi:11883
  17643. #, no-wrap
  17644. msgid "savannah"
  17645. msgstr ""
  17646. #. type: table
  17647. #: guix-git/doc/guix.texi:11885
  17648. msgid "the updater for packages hosted at @uref{https://savannah.gnu.org, Savannah};"
  17649. msgstr ""
  17650. #. type: item
  17651. #: guix-git/doc/guix.texi:11885
  17652. #, no-wrap
  17653. msgid "sourceforge"
  17654. msgstr ""
  17655. #. type: table
  17656. #: guix-git/doc/guix.texi:11887
  17657. msgid "the updater for packages hosted at @uref{https://sourceforge.net, SourceForge};"
  17658. msgstr ""
  17659. #. type: item
  17660. #: guix-git/doc/guix.texi:11887
  17661. #, no-wrap
  17662. msgid "gnome"
  17663. msgstr ""
  17664. #. type: table
  17665. #: guix-git/doc/guix.texi:11889
  17666. msgid "the updater for GNOME packages;"
  17667. msgstr ""
  17668. #. type: item
  17669. #: guix-git/doc/guix.texi:11889
  17670. #, no-wrap
  17671. msgid "kde"
  17672. msgstr ""
  17673. #. type: table
  17674. #: guix-git/doc/guix.texi:11891
  17675. msgid "the updater for KDE packages;"
  17676. msgstr ""
  17677. #. type: item
  17678. #: guix-git/doc/guix.texi:11891
  17679. #, no-wrap
  17680. msgid "xorg"
  17681. msgstr ""
  17682. #. type: table
  17683. #: guix-git/doc/guix.texi:11893
  17684. msgid "the updater for X.org packages;"
  17685. msgstr ""
  17686. #. type: item
  17687. #: guix-git/doc/guix.texi:11893
  17688. #, no-wrap
  17689. msgid "kernel.org"
  17690. msgstr ""
  17691. #. type: table
  17692. #: guix-git/doc/guix.texi:11895
  17693. msgid "the updater for packages hosted on kernel.org;"
  17694. msgstr ""
  17695. #. type: table
  17696. #: guix-git/doc/guix.texi:11897
  17697. msgid "the updater for @uref{https://wiki.call-cc.org/eggs/, Egg} packages;"
  17698. msgstr ""
  17699. #. type: table
  17700. #: guix-git/doc/guix.texi:11899
  17701. msgid "the updater for @uref{https://elpa.gnu.org/, ELPA} packages;"
  17702. msgstr ""
  17703. #. type: table
  17704. #: guix-git/doc/guix.texi:11901
  17705. msgid "the updater for @uref{https://cran.r-project.org/, CRAN} packages;"
  17706. msgstr ""
  17707. #. type: item
  17708. #: guix-git/doc/guix.texi:11901
  17709. #, no-wrap
  17710. msgid "bioconductor"
  17711. msgstr ""
  17712. #. type: table
  17713. #: guix-git/doc/guix.texi:11903
  17714. msgid "the updater for @uref{https://www.bioconductor.org/, Bioconductor} R packages;"
  17715. msgstr ""
  17716. #. type: table
  17717. #: guix-git/doc/guix.texi:11905
  17718. msgid "the updater for @uref{https://www.cpan.org/, CPAN} packages;"
  17719. msgstr ""
  17720. #. type: table
  17721. #: guix-git/doc/guix.texi:11907
  17722. msgid "the updater for @uref{https://pypi.python.org, PyPI} packages."
  17723. msgstr ""
  17724. #. type: table
  17725. #: guix-git/doc/guix.texi:11909
  17726. msgid "the updater for @uref{https://rubygems.org, RubyGems} packages."
  17727. msgstr ""
  17728. #. type: item
  17729. #: guix-git/doc/guix.texi:11909
  17730. #, no-wrap
  17731. msgid "github"
  17732. msgstr ""
  17733. #. type: table
  17734. #: guix-git/doc/guix.texi:11911
  17735. msgid "the updater for @uref{https://github.com, GitHub} packages."
  17736. msgstr ""
  17737. #. type: table
  17738. #: guix-git/doc/guix.texi:11913
  17739. msgid "the updater for @uref{https://hackage.haskell.org, Hackage} packages."
  17740. msgstr ""
  17741. #. type: table
  17742. #: guix-git/doc/guix.texi:11915
  17743. msgid "the updater for @uref{https://www.stackage.org, Stackage} packages."
  17744. msgstr ""
  17745. #. type: table
  17746. #: guix-git/doc/guix.texi:11917
  17747. msgid "the updater for @uref{https://crates.io, Crates} packages."
  17748. msgstr ""
  17749. #. type: item
  17750. #: guix-git/doc/guix.texi:11917
  17751. #, no-wrap
  17752. msgid "launchpad"
  17753. msgstr ""
  17754. #. type: table
  17755. #: guix-git/doc/guix.texi:11919
  17756. msgid "the updater for @uref{https://launchpad.net, Launchpad} packages."
  17757. msgstr ""
  17758. #. type: item
  17759. #: guix-git/doc/guix.texi:11919
  17760. #, no-wrap
  17761. msgid "generic-html"
  17762. msgstr ""
  17763. #. type: table
  17764. #: guix-git/doc/guix.texi:11922
  17765. msgid "a generic updater that crawls the HTML page where the source tarball of the package is hosted, when applicable."
  17766. msgstr ""
  17767. #. type: table
  17768. #: guix-git/doc/guix.texi:11926
  17769. msgid "For instance, the following command only checks for updates of Emacs packages hosted at @code{elpa.gnu.org} and for updates of CRAN packages:"
  17770. msgstr ""
  17771. #. type: example
  17772. #: guix-git/doc/guix.texi:11931
  17773. #, no-wrap
  17774. msgid ""
  17775. "$ guix refresh --type=elpa,cran\n"
  17776. "gnu/packages/statistics.scm:819:13: r-testthat would be upgraded from 0.10.0 to 0.11.0\n"
  17777. "gnu/packages/emacs.scm:856:13: emacs-auctex would be upgraded from 11.88.6 to 11.88.9\n"
  17778. msgstr ""
  17779. #. type: item
  17780. #: guix-git/doc/guix.texi:11933
  17781. #, no-wrap
  17782. msgid "--list-updaters"
  17783. msgstr ""
  17784. #. type: itemx
  17785. #: guix-git/doc/guix.texi:11934
  17786. #, no-wrap
  17787. msgid "-L"
  17788. msgstr ""
  17789. #. type: table
  17790. #: guix-git/doc/guix.texi:11936
  17791. msgid "List available updaters and exit (see @option{--type} above)."
  17792. msgstr ""
  17793. #. type: table
  17794. #: guix-git/doc/guix.texi:11939
  17795. msgid "For each updater, display the fraction of packages it covers; at the end, display the fraction of packages covered by all these updaters."
  17796. msgstr ""
  17797. #. type: Plain text
  17798. #: guix-git/doc/guix.texi:11943
  17799. msgid "In addition, @command{guix refresh} can be passed one or more package names, as in this example:"
  17800. msgstr ""
  17801. #. type: example
  17802. #: guix-git/doc/guix.texi:11946
  17803. #, no-wrap
  17804. msgid "$ ./pre-inst-env guix refresh -u emacs idutils gcc@@4.8\n"
  17805. msgstr ""
  17806. #. type: Plain text
  17807. #: guix-git/doc/guix.texi:11953
  17808. msgid "The command above specifically updates the @code{emacs} and @code{idutils} packages. The @option{--select} option would have no effect in this case. You might also want to update definitions that correspond to the packages installed in your profile:"
  17809. msgstr ""
  17810. #. type: example
  17811. #: guix-git/doc/guix.texi:11957
  17812. #, no-wrap
  17813. msgid ""
  17814. "$ ./pre-inst-env guix refresh -u \\\n"
  17815. " $(guix package --list-installed | cut -f1)\n"
  17816. msgstr ""
  17817. #. type: Plain text
  17818. #: guix-git/doc/guix.texi:11963
  17819. msgid "When considering whether to upgrade a package, it is sometimes convenient to know which packages would be affected by the upgrade and should be checked for compatibility. For this the following option may be used when passing @command{guix refresh} one or more package names:"
  17820. msgstr ""
  17821. #. type: item
  17822. #: guix-git/doc/guix.texi:11966
  17823. #, no-wrap
  17824. msgid "--list-dependent"
  17825. msgstr ""
  17826. #. type: itemx
  17827. #: guix-git/doc/guix.texi:11967 guix-git/doc/guix.texi:12226
  17828. #, no-wrap
  17829. msgid "-l"
  17830. msgstr ""
  17831. #. type: table
  17832. #: guix-git/doc/guix.texi:11970
  17833. msgid "List top-level dependent packages that would need to be rebuilt as a result of upgrading one or more packages."
  17834. msgstr ""
  17835. #. type: table
  17836. #: guix-git/doc/guix.texi:11974
  17837. msgid "@xref{Invoking guix graph, the @code{reverse-package} type of @command{guix graph}}, for information on how to visualize the list of dependents of a package."
  17838. msgstr ""
  17839. #. type: Plain text
  17840. #: guix-git/doc/guix.texi:11980
  17841. msgid "Be aware that the @option{--list-dependent} option only @emph{approximates} the rebuilds that would be required as a result of an upgrade. More rebuilds might be required under some circumstances."
  17842. msgstr ""
  17843. #. type: example
  17844. #: guix-git/doc/guix.texi:11985
  17845. #, no-wrap
  17846. msgid ""
  17847. "$ guix refresh --list-dependent flex\n"
  17848. "Building the following 120 packages would ensure 213 dependent packages are rebuilt:\n"
  17849. "hop@@2.4.0 emacs-geiser@@0.13 notmuch@@0.18 mu@@0.9.9.5 cflow@@1.4 idutils@@4.6 @dots{}\n"
  17850. msgstr ""
  17851. #. type: Plain text
  17852. #: guix-git/doc/guix.texi:11989
  17853. msgid "The command above lists a set of packages that could be built to check for compatibility with an upgraded @code{flex} package."
  17854. msgstr ""
  17855. #. type: item
  17856. #: guix-git/doc/guix.texi:11992
  17857. #, no-wrap
  17858. msgid "--list-transitive"
  17859. msgstr ""
  17860. #. type: table
  17861. #: guix-git/doc/guix.texi:11994
  17862. msgid "List all the packages which one or more packages depend upon."
  17863. msgstr ""
  17864. #. type: example
  17865. #: guix-git/doc/guix.texi:11999
  17866. #, no-wrap
  17867. msgid ""
  17868. "$ guix refresh --list-transitive flex\n"
  17869. "flex@@2.6.4 depends on the following 25 packages: perl@@5.28.0 help2man@@1.47.6\n"
  17870. "bison@@3.0.5 indent@@2.2.10 tar@@1.30 gzip@@1.9 bzip2@@1.0.6 xz@@5.2.4 file@@5.33 @dots{}\n"
  17871. msgstr ""
  17872. #. type: Plain text
  17873. #: guix-git/doc/guix.texi:12005
  17874. msgid "The command above lists a set of packages which, when changed, would cause @code{flex} to be rebuilt."
  17875. msgstr ""
  17876. #. type: Plain text
  17877. #: guix-git/doc/guix.texi:12007
  17878. msgid "The following options can be used to customize GnuPG operation:"
  17879. msgstr ""
  17880. #. type: item
  17881. #: guix-git/doc/guix.texi:12010
  17882. #, no-wrap
  17883. msgid "--gpg=@var{command}"
  17884. msgstr ""
  17885. #. type: table
  17886. #: guix-git/doc/guix.texi:12013
  17887. msgid "Use @var{command} as the GnuPG 2.x command. @var{command} is searched for in @code{$PATH}."
  17888. msgstr ""
  17889. #. type: item
  17890. #: guix-git/doc/guix.texi:12014
  17891. #, no-wrap
  17892. msgid "--keyring=@var{file}"
  17893. msgstr ""
  17894. #. type: table
  17895. #: guix-git/doc/guix.texi:12020
  17896. msgid "Use @var{file} as the keyring for upstream keys. @var{file} must be in the @dfn{keybox format}. Keybox files usually have a name ending in @file{.kbx} and the GNU@tie{}Privacy Guard (GPG) can manipulate these files (@pxref{kbxutil, @command{kbxutil},, gnupg, Using the GNU Privacy Guard}, for information on a tool to manipulate keybox files)."
  17897. msgstr ""
  17898. #. type: table
  17899. #: guix-git/doc/guix.texi:12026
  17900. msgid "When this option is omitted, @command{guix refresh} uses @file{~/.config/guix/upstream/trustedkeys.kbx} as the keyring for upstream signing keys. OpenPGP signatures are checked against keys from this keyring; missing keys are downloaded to this keyring as well (see @option{--key-download} below)."
  17901. msgstr ""
  17902. #. type: table
  17903. #: guix-git/doc/guix.texi:12029
  17904. msgid "You can export keys from your default GPG keyring into a keybox file using commands like this one:"
  17905. msgstr ""
  17906. #. type: example
  17907. #: guix-git/doc/guix.texi:12032
  17908. #, no-wrap
  17909. msgid "gpg --export rms@@gnu.org | kbxutil --import-openpgp >> mykeyring.kbx\n"
  17910. msgstr ""
  17911. #. type: table
  17912. #: guix-git/doc/guix.texi:12035
  17913. msgid "Likewise, you can fetch keys to a specific keybox file like this:"
  17914. msgstr ""
  17915. #. type: example
  17916. #: guix-git/doc/guix.texi:12039
  17917. #, no-wrap
  17918. msgid ""
  17919. "gpg --no-default-keyring --keyring mykeyring.kbx \\\n"
  17920. " --recv-keys @value{OPENPGP-SIGNING-KEY-ID}\n"
  17921. msgstr ""
  17922. #. type: table
  17923. #: guix-git/doc/guix.texi:12043
  17924. msgid "@xref{GPG Configuration Options, @option{--keyring},, gnupg, Using the GNU Privacy Guard}, for more information on GPG's @option{--keyring} option."
  17925. msgstr ""
  17926. #. type: table
  17927. #: guix-git/doc/guix.texi:12047
  17928. msgid "Handle missing OpenPGP keys according to @var{policy}, which may be one of:"
  17929. msgstr ""
  17930. #. type: item
  17931. #: guix-git/doc/guix.texi:12049 guix-git/doc/guix.texi:21092
  17932. #, no-wrap
  17933. msgid "always"
  17934. msgstr ""
  17935. #. type: table
  17936. #: guix-git/doc/guix.texi:12052
  17937. msgid "Always download missing OpenPGP keys from the key server, and add them to the user's GnuPG keyring."
  17938. msgstr ""
  17939. #. type: item
  17940. #: guix-git/doc/guix.texi:12053 guix-git/doc/guix.texi:21094
  17941. #, no-wrap
  17942. msgid "never"
  17943. msgstr ""
  17944. #. type: table
  17945. #: guix-git/doc/guix.texi:12055
  17946. msgid "Never try to download missing OpenPGP keys. Instead just bail out."
  17947. msgstr ""
  17948. #. type: item
  17949. #: guix-git/doc/guix.texi:12056
  17950. #, no-wrap
  17951. msgid "interactive"
  17952. msgstr ""
  17953. #. type: table
  17954. #: guix-git/doc/guix.texi:12059
  17955. msgid "When a package signed with an unknown OpenPGP key is encountered, ask the user whether to download it or not. This is the default behavior."
  17956. msgstr ""
  17957. #. type: item
  17958. #: guix-git/doc/guix.texi:12061
  17959. #, no-wrap
  17960. msgid "--key-server=@var{host}"
  17961. msgstr ""
  17962. #. type: table
  17963. #: guix-git/doc/guix.texi:12063
  17964. msgid "Use @var{host} as the OpenPGP key server when importing a public key."
  17965. msgstr ""
  17966. #. type: Plain text
  17967. #: guix-git/doc/guix.texi:12083
  17968. msgid "The @code{github} updater uses the @uref{https://developer.github.com/v3/, GitHub API} to query for new releases. When used repeatedly e.g.@: when refreshing all packages, GitHub will eventually refuse to answer any further API requests. By default 60 API requests per hour are allowed, and a full refresh on all GitHub packages in Guix requires more than this. Authentication with GitHub through the use of an API token alleviates these limits. To use an API token, set the environment variable @env{GUIX_GITHUB_TOKEN} to a token procured from @uref{https://github.com/settings/tokens} or otherwise."
  17969. msgstr ""
  17970. #. type: section
  17971. #: guix-git/doc/guix.texi:12086
  17972. #, no-wrap
  17973. msgid "Invoking @command{guix lint}"
  17974. msgstr ""
  17975. #. type: command{#1}
  17976. #: guix-git/doc/guix.texi:12088
  17977. #, no-wrap
  17978. msgid "guix lint"
  17979. msgstr ""
  17980. #. type: cindex
  17981. #: guix-git/doc/guix.texi:12089
  17982. #, no-wrap
  17983. msgid "package, checking for errors"
  17984. msgstr ""
  17985. #. type: Plain text
  17986. #: guix-git/doc/guix.texi:12095
  17987. msgid "The @command{guix lint} command is meant to help package developers avoid common errors and use a consistent style. It runs a number of checks on a given set of packages in order to find common mistakes in their definitions. Available @dfn{checkers} include (see @option{--list-checkers} for a complete list):"
  17988. msgstr ""
  17989. #. type: table
  17990. #: guix-git/doc/guix.texi:12101
  17991. msgid "Validate certain typographical and stylistic rules about package descriptions and synopses."
  17992. msgstr ""
  17993. #. type: item
  17994. #: guix-git/doc/guix.texi:12102
  17995. #, no-wrap
  17996. msgid "inputs-should-be-native"
  17997. msgstr ""
  17998. #. type: table
  17999. #: guix-git/doc/guix.texi:12104
  18000. msgid "Identify inputs that should most likely be native inputs."
  18001. msgstr ""
  18002. #. type: itemx
  18003. #: guix-git/doc/guix.texi:12107
  18004. #, no-wrap
  18005. msgid "mirror-url"
  18006. msgstr ""
  18007. #. type: itemx
  18008. #: guix-git/doc/guix.texi:12108
  18009. #, no-wrap
  18010. msgid "github-url"
  18011. msgstr ""
  18012. #. type: itemx
  18013. #: guix-git/doc/guix.texi:12109
  18014. #, no-wrap
  18015. msgid "source-file-name"
  18016. msgstr ""
  18017. #. type: table
  18018. #: guix-git/doc/guix.texi:12116
  18019. msgid "Probe @code{home-page} and @code{source} URLs and report those that are invalid. Suggest a @code{mirror://} URL when applicable. If the @code{source} URL redirects to a GitHub URL, recommend usage of the GitHub URL@. Check that the source file name is meaningful, e.g.@: is not just a version number or ``git-checkout'', without a declared @code{file-name} (@pxref{origin Reference})."
  18020. msgstr ""
  18021. #. type: item
  18022. #: guix-git/doc/guix.texi:12117
  18023. #, no-wrap
  18024. msgid "source-unstable-tarball"
  18025. msgstr ""
  18026. #. type: table
  18027. #: guix-git/doc/guix.texi:12121
  18028. msgid "Parse the @code{source} URL to determine if a tarball from GitHub is autogenerated or if it is a release tarball. Unfortunately GitHub's autogenerated tarballs are sometimes regenerated."
  18029. msgstr ""
  18030. #. type: table
  18031. #: guix-git/doc/guix.texi:12125
  18032. msgid "Check that the derivation of the given packages can be successfully computed for all the supported systems (@pxref{Derivations})."
  18033. msgstr ""
  18034. #. type: item
  18035. #: guix-git/doc/guix.texi:12126
  18036. #, no-wrap
  18037. msgid "profile-collisions"
  18038. msgstr ""
  18039. #. type: table
  18040. #: guix-git/doc/guix.texi:12132
  18041. msgid "Check whether installing the given packages in a profile would lead to collisions. Collisions occur when several packages with the same name but a different version or a different store file name are propagated. @xref{package Reference, @code{propagated-inputs}}, for more information on propagated inputs."
  18042. msgstr ""
  18043. #. type: item
  18044. #: guix-git/doc/guix.texi:12133
  18045. #, no-wrap
  18046. msgid "archival"
  18047. msgstr ""
  18048. #. type: cindex
  18049. #: guix-git/doc/guix.texi:12134
  18050. #, no-wrap
  18051. msgid "Software Heritage, source code archive"
  18052. msgstr ""
  18053. #. type: cindex
  18054. #: guix-git/doc/guix.texi:12135
  18055. #, no-wrap
  18056. msgid "archival of source code, Software Heritage"
  18057. msgstr ""
  18058. #. type: table
  18059. #: guix-git/doc/guix.texi:12138
  18060. msgid "Checks whether the package's source code is archived at @uref{https://www.softwareheritage.org, Software Heritage}."
  18061. msgstr ""
  18062. #. type: table
  18063. #: guix-git/doc/guix.texi:12146
  18064. msgid "When the source code that is not archived comes from a version-control system (VCS)---e.g., it's obtained with @code{git-fetch}, send Software Heritage a ``save'' request so that it eventually archives it. This ensures that the source will remain available in the long term, and that Guix can fall back to Software Heritage should the source code disappear from its original host. The status of recent ``save'' requests can be @uref{https://archive.softwareheritage.org/save/#requests, viewed on-line}."
  18065. msgstr ""
  18066. #. type: table
  18067. #: guix-git/doc/guix.texi:12151
  18068. msgid "When source code is a tarball obtained with @code{url-fetch}, simply print a message when it is not archived. As of this writing, Software Heritage does not allow requests to save arbitrary tarballs; we are working on ways to ensure that non-VCS source code is also archived."
  18069. msgstr ""
  18070. #. type: table
  18071. #: guix-git/doc/guix.texi:12157
  18072. msgid "Software Heritage @uref{https://archive.softwareheritage.org/api/#rate-limiting, limits the request rate per IP address}. When the limit is reached, @command{guix lint} prints a message and the @code{archival} checker stops doing anything until that limit has been reset."
  18073. msgstr ""
  18074. #. type: item
  18075. #: guix-git/doc/guix.texi:12158
  18076. #, no-wrap
  18077. msgid "cve"
  18078. msgstr ""
  18079. #. type: cindex
  18080. #: guix-git/doc/guix.texi:12159 guix-git/doc/guix.texi:35303
  18081. #, no-wrap
  18082. msgid "security vulnerabilities"
  18083. msgstr ""
  18084. #. type: cindex
  18085. #: guix-git/doc/guix.texi:12160
  18086. #, no-wrap
  18087. msgid "CVE, Common Vulnerabilities and Exposures"
  18088. msgstr ""
  18089. #. type: table
  18090. #: guix-git/doc/guix.texi:12165
  18091. msgid "Report known vulnerabilities found in the Common Vulnerabilities and Exposures (CVE) databases of the current and past year @uref{https://nvd.nist.gov/vuln/data-feeds, published by the US NIST}."
  18092. msgstr ""
  18093. #. type: table
  18094. #: guix-git/doc/guix.texi:12167
  18095. msgid "To view information about a particular vulnerability, visit pages such as:"
  18096. msgstr ""
  18097. #. type: indicateurl{#1}
  18098. #: guix-git/doc/guix.texi:12171
  18099. msgid "https://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-YYYY-ABCD"
  18100. msgstr ""
  18101. #. type: indicateurl{#1}
  18102. #: guix-git/doc/guix.texi:12173
  18103. msgid "https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-YYYY-ABCD"
  18104. msgstr ""
  18105. #. type: table
  18106. #: guix-git/doc/guix.texi:12178
  18107. msgid "where @code{CVE-YYYY-ABCD} is the CVE identifier---e.g., @code{CVE-2015-7554}."
  18108. msgstr ""
  18109. #. type: table
  18110. #: guix-git/doc/guix.texi:12183
  18111. msgid "Package developers can specify in package recipes the @uref{https://nvd.nist.gov/products/cpe,Common Platform Enumeration (CPE)} name and version of the package when they differ from the name or version that Guix uses, as in this example:"
  18112. msgstr ""
  18113. #. type: lisp
  18114. #: guix-git/doc/guix.texi:12191
  18115. #, no-wrap
  18116. msgid ""
  18117. "(package\n"
  18118. " (name \"grub\")\n"
  18119. " ;; @dots{}\n"
  18120. " ;; CPE calls this package \"grub2\".\n"
  18121. " (properties '((cpe-name . \"grub2\")\n"
  18122. " (cpe-version . \"2.3\"))))\n"
  18123. msgstr ""
  18124. #. type: table
  18125. #: guix-git/doc/guix.texi:12198
  18126. msgid "Some entries in the CVE database do not specify which version of a package they apply to, and would thus ``stick around'' forever. Package developers who found CVE alerts and verified they can be ignored can declare them as in this example:"
  18127. msgstr ""
  18128. #. type: lisp
  18129. #: guix-git/doc/guix.texi:12208
  18130. #, no-wrap
  18131. msgid ""
  18132. "(package\n"
  18133. " (name \"t1lib\")\n"
  18134. " ;; @dots{}\n"
  18135. " ;; These CVEs no longer apply and can be safely ignored.\n"
  18136. " (properties `((lint-hidden-cve . (\"CVE-2011-0433\"\n"
  18137. " \"CVE-2011-1553\"\n"
  18138. " \"CVE-2011-1554\"\n"
  18139. " \"CVE-2011-5244\")))))\n"
  18140. msgstr ""
  18141. #. type: item
  18142. #: guix-git/doc/guix.texi:12210
  18143. #, no-wrap
  18144. msgid "formatting"
  18145. msgstr ""
  18146. #. type: table
  18147. #: guix-git/doc/guix.texi:12213
  18148. msgid "Warn about obvious source code formatting issues: trailing white space, use of tabulations, etc."
  18149. msgstr ""
  18150. #. type: example
  18151. #: guix-git/doc/guix.texi:12219
  18152. #, no-wrap
  18153. msgid "guix lint @var{options} @var{package}@dots{}\n"
  18154. msgstr ""
  18155. #. type: Plain text
  18156. #: guix-git/doc/guix.texi:12223
  18157. msgid "If no package is given on the command line, then all packages are checked. The @var{options} may be zero or more of the following:"
  18158. msgstr ""
  18159. #. type: item
  18160. #: guix-git/doc/guix.texi:12225
  18161. #, no-wrap
  18162. msgid "--list-checkers"
  18163. msgstr ""
  18164. #. type: table
  18165. #: guix-git/doc/guix.texi:12229
  18166. msgid "List and describe all the available checkers that will be run on packages and exit."
  18167. msgstr ""
  18168. #. type: item
  18169. #: guix-git/doc/guix.texi:12230
  18170. #, no-wrap
  18171. msgid "--checkers"
  18172. msgstr ""
  18173. #. type: itemx
  18174. #: guix-git/doc/guix.texi:12231
  18175. #, no-wrap
  18176. msgid "-c"
  18177. msgstr ""
  18178. #. type: table
  18179. #: guix-git/doc/guix.texi:12234
  18180. msgid "Only enable the checkers specified in a comma-separated list using the names returned by @option{--list-checkers}."
  18181. msgstr ""
  18182. #. type: item
  18183. #: guix-git/doc/guix.texi:12235
  18184. #, no-wrap
  18185. msgid "--exclude"
  18186. msgstr ""
  18187. #. type: table
  18188. #: guix-git/doc/guix.texi:12239
  18189. msgid "Only disable the checkers specified in a comma-separated list using the names returned by @option{--list-checkers}."
  18190. msgstr ""
  18191. #. type: item
  18192. #: guix-git/doc/guix.texi:12240
  18193. #, no-wrap
  18194. msgid "--no-network"
  18195. msgstr ""
  18196. #. type: table
  18197. #: guix-git/doc/guix.texi:12243
  18198. msgid "Only enable the checkers that do not depend on Internet access."
  18199. msgstr ""
  18200. #. type: section
  18201. #: guix-git/doc/guix.texi:12255
  18202. #, no-wrap
  18203. msgid "Invoking @command{guix size}"
  18204. msgstr ""
  18205. #. type: code{#1}
  18206. #: guix-git/doc/guix.texi:12257 guix-git/doc/guix.texi:34216
  18207. #, no-wrap
  18208. msgid "size"
  18209. msgstr ""
  18210. #. type: cindex
  18211. #: guix-git/doc/guix.texi:12258
  18212. #, no-wrap
  18213. msgid "package size"
  18214. msgstr ""
  18215. #. type: command{#1}
  18216. #: guix-git/doc/guix.texi:12260
  18217. #, no-wrap
  18218. msgid "guix size"
  18219. msgstr ""
  18220. #. type: Plain text
  18221. #: guix-git/doc/guix.texi:12267
  18222. msgid "The @command{guix size} command helps package developers profile the disk usage of packages. It is easy to overlook the impact of an additional dependency added to a package, or the impact of using a single output for a package that could easily be split (@pxref{Packages with Multiple Outputs}). Such are the typical issues that @command{guix size} can highlight."
  18223. msgstr ""
  18224. #. type: Plain text
  18225. #: guix-git/doc/guix.texi:12272
  18226. msgid "The command can be passed one or more package specifications such as @code{gcc@@4.8} or @code{guile:debug}, or a file name in the store. Consider this example:"
  18227. msgstr ""
  18228. #. type: example
  18229. #: guix-git/doc/guix.texi:12285
  18230. #, no-wrap
  18231. msgid ""
  18232. "$ guix size coreutils\n"
  18233. "store item total self\n"
  18234. "/gnu/store/@dots{}-gcc-5.5.0-lib 60.4 30.1 38.1%\n"
  18235. "/gnu/store/@dots{}-glibc-2.27 30.3 28.8 36.6%\n"
  18236. "/gnu/store/@dots{}-coreutils-8.28 78.9 15.0 19.0%\n"
  18237. "/gnu/store/@dots{}-gmp-6.1.2 63.1 2.7 3.4%\n"
  18238. "/gnu/store/@dots{}-bash-static-4.4.12 1.5 1.5 1.9%\n"
  18239. "/gnu/store/@dots{}-acl-2.2.52 61.1 0.4 0.5%\n"
  18240. "/gnu/store/@dots{}-attr-2.4.47 60.6 0.2 0.3%\n"
  18241. "/gnu/store/@dots{}-libcap-2.25 60.5 0.2 0.2%\n"
  18242. "total: 78.9 MiB\n"
  18243. msgstr ""
  18244. #. type: Plain text
  18245. #: guix-git/doc/guix.texi:12291
  18246. msgid "The store items listed here constitute the @dfn{transitive closure} of Coreutils---i.e., Coreutils and all its dependencies, recursively---as would be returned by:"
  18247. msgstr ""
  18248. #. type: example
  18249. #: guix-git/doc/guix.texi:12294
  18250. #, no-wrap
  18251. msgid "$ guix gc -R /gnu/store/@dots{}-coreutils-8.23\n"
  18252. msgstr ""
  18253. #. type: Plain text
  18254. #: guix-git/doc/guix.texi:12302
  18255. msgid "Here the output shows three columns next to store items. The first column, labeled ``total'', shows the size in mebibytes (MiB) of the closure of the store item---that is, its own size plus the size of all its dependencies. The next column, labeled ``self'', shows the size of the item itself. The last column shows the ratio of the size of the item itself to the space occupied by all the items listed here."
  18256. msgstr ""
  18257. #. type: Plain text
  18258. #: guix-git/doc/guix.texi:12308
  18259. msgid "In this example, we see that the closure of Coreutils weighs in at 79@tie{}MiB, most of which is taken by libc and GCC's run-time support libraries. (That libc and GCC's libraries represent a large fraction of the closure is not a problem @i{per se} because they are always available on the system anyway.)"
  18260. msgstr ""
  18261. #. type: Plain text
  18262. #: guix-git/doc/guix.texi:12311
  18263. msgid "Since the command also accepts store file names, assessing the size of a build result is straightforward:"
  18264. msgstr ""
  18265. #. type: example
  18266. #: guix-git/doc/guix.texi:12314
  18267. #, no-wrap
  18268. msgid "guix size $(guix system build config.scm)\n"
  18269. msgstr ""
  18270. #. type: Plain text
  18271. #: guix-git/doc/guix.texi:12324
  18272. msgid "When the package(s) passed to @command{guix size} are available in the store@footnote{More precisely, @command{guix size} looks for the @emph{ungrafted} variant of the given package(s), as returned by @code{guix build @var{package} --no-grafts}. @xref{Security Updates}, for information on grafts.}, @command{guix size} queries the daemon to determine its dependencies, and measures its size in the store, similar to @command{du -ms --apparent-size} (@pxref{du invocation,,, coreutils, GNU Coreutils})."
  18273. msgstr ""
  18274. #. type: Plain text
  18275. #: guix-git/doc/guix.texi:12329
  18276. msgid "When the given packages are @emph{not} in the store, @command{guix size} reports information based on the available substitutes (@pxref{Substitutes}). This makes it possible it to profile disk usage of store items that are not even on disk, only available remotely."
  18277. msgstr ""
  18278. #. type: Plain text
  18279. #: guix-git/doc/guix.texi:12331
  18280. msgid "You can also specify several package names:"
  18281. msgstr ""
  18282. #. type: example
  18283. #: guix-git/doc/guix.texi:12341
  18284. #, no-wrap
  18285. msgid ""
  18286. "$ guix size coreutils grep sed bash\n"
  18287. "store item total self\n"
  18288. "/gnu/store/@dots{}-coreutils-8.24 77.8 13.8 13.4%\n"
  18289. "/gnu/store/@dots{}-grep-2.22 73.1 0.8 0.8%\n"
  18290. "/gnu/store/@dots{}-bash-4.3.42 72.3 4.7 4.6%\n"
  18291. "/gnu/store/@dots{}-readline-6.3 67.6 1.2 1.2%\n"
  18292. "@dots{}\n"
  18293. "total: 102.3 MiB\n"
  18294. msgstr ""
  18295. #. type: Plain text
  18296. #: guix-git/doc/guix.texi:12347
  18297. msgid "In this example we see that the combination of the four packages takes 102.3@tie{}MiB in total, which is much less than the sum of each closure since they have a lot of dependencies in common."
  18298. msgstr ""
  18299. #. type: Plain text
  18300. #: guix-git/doc/guix.texi:12353
  18301. msgid "When looking at the profile returned by @command{guix size}, you may find yourself wondering why a given package shows up in the profile at all. To understand it, you can use @command{guix graph --path -t references} to display the shortest path between the two packages (@pxref{Invoking guix graph})."
  18302. msgstr ""
  18303. #. type: Plain text
  18304. #: guix-git/doc/guix.texi:12355
  18305. msgid "The available options are:"
  18306. msgstr ""
  18307. #. type: table
  18308. #: guix-git/doc/guix.texi:12361
  18309. msgid "Use substitute information from @var{urls}. @xref{client-substitute-urls, the same option for @code{guix build}}."
  18310. msgstr ""
  18311. #. type: item
  18312. #: guix-git/doc/guix.texi:12362
  18313. #, no-wrap
  18314. msgid "--sort=@var{key}"
  18315. msgstr ""
  18316. #. type: table
  18317. #: guix-git/doc/guix.texi:12364
  18318. msgid "Sort lines according to @var{key}, one of the following options:"
  18319. msgstr ""
  18320. #. type: item
  18321. #: guix-git/doc/guix.texi:12366
  18322. #, no-wrap
  18323. msgid "self"
  18324. msgstr ""
  18325. #. type: table
  18326. #: guix-git/doc/guix.texi:12368
  18327. msgid "the size of each item (the default);"
  18328. msgstr ""
  18329. #. type: table
  18330. #: guix-git/doc/guix.texi:12370
  18331. msgid "the total size of the item's closure."
  18332. msgstr ""
  18333. #. type: item
  18334. #: guix-git/doc/guix.texi:12372
  18335. #, no-wrap
  18336. msgid "--map-file=@var{file}"
  18337. msgstr ""
  18338. #. type: table
  18339. #: guix-git/doc/guix.texi:12374
  18340. msgid "Write a graphical map of disk usage in PNG format to @var{file}."
  18341. msgstr ""
  18342. #. type: table
  18343. #: guix-git/doc/guix.texi:12376
  18344. msgid "For the example above, the map looks like this:"
  18345. msgstr ""
  18346. #. type: table
  18347. #: guix-git/doc/guix.texi:12379
  18348. msgid "@image{images/coreutils-size-map,5in,, map of Coreutils disk usage produced by @command{guix size}}"
  18349. msgstr ""
  18350. #. type: table
  18351. #: guix-git/doc/guix.texi:12384
  18352. msgid "This option requires that @uref{https://wingolog.org/software/guile-charting/, Guile-Charting} be installed and visible in Guile's module search path. When that is not the case, @command{guix size} fails as it tries to load it."
  18353. msgstr ""
  18354. #. type: table
  18355. #: guix-git/doc/guix.texi:12388
  18356. msgid "Consider packages for @var{system}---e.g., @code{x86_64-linux}."
  18357. msgstr ""
  18358. #. type: section
  18359. #: guix-git/doc/guix.texi:12399
  18360. #, no-wrap
  18361. msgid "Invoking @command{guix graph}"
  18362. msgstr ""
  18363. #. type: cindex
  18364. #: guix-git/doc/guix.texi:12401
  18365. #, no-wrap
  18366. msgid "DAG"
  18367. msgstr ""
  18368. #. type: command{#1}
  18369. #: guix-git/doc/guix.texi:12402
  18370. #, no-wrap
  18371. msgid "guix graph"
  18372. msgstr ""
  18373. #. type: Plain text
  18374. #: guix-git/doc/guix.texi:12417
  18375. msgid "Packages and their dependencies form a @dfn{graph}, specifically a directed acyclic graph (DAG). It can quickly become difficult to have a mental model of the package DAG, so the @command{guix graph} command provides a visual representation of the DAG@. By default, @command{guix graph} emits a DAG representation in the input format of @uref{https://www.graphviz.org/, Graphviz}, so its output can be passed directly to the @command{dot} command of Graphviz. It can also emit an HTML page with embedded JavaScript code to display a ``chord diagram'' in a Web browser, using the @uref{https://d3js.org/, d3.js} library, or emit Cypher queries to construct a graph in a graph database supporting the @uref{https://www.opencypher.org/, openCypher} query language. With @option{--path}, it simply displays the shortest path between two packages. The general syntax is:"
  18376. msgstr ""
  18377. #. type: example
  18378. #: guix-git/doc/guix.texi:12420
  18379. #, no-wrap
  18380. msgid "guix graph @var{options} @var{package}@dots{}\n"
  18381. msgstr ""
  18382. #. type: Plain text
  18383. #: guix-git/doc/guix.texi:12425
  18384. msgid "For example, the following command generates a PDF file representing the package DAG for the GNU@tie{}Core Utilities, showing its build-time dependencies:"
  18385. msgstr ""
  18386. #. type: example
  18387. #: guix-git/doc/guix.texi:12428
  18388. #, no-wrap
  18389. msgid "guix graph coreutils | dot -Tpdf > dag.pdf\n"
  18390. msgstr ""
  18391. #. type: Plain text
  18392. #: guix-git/doc/guix.texi:12431
  18393. msgid "The output looks like this:"
  18394. msgstr ""
  18395. #. type: Plain text
  18396. #: guix-git/doc/guix.texi:12433
  18397. msgid "@image{images/coreutils-graph,2in,,Dependency graph of the GNU Coreutils}"
  18398. msgstr ""
  18399. #. type: Plain text
  18400. #: guix-git/doc/guix.texi:12435
  18401. msgid "Nice little graph, no?"
  18402. msgstr ""
  18403. #. type: Plain text
  18404. #: guix-git/doc/guix.texi:12438
  18405. msgid "You may find it more pleasant to navigate the graph interactively with @command{xdot} (from the @code{xdot} package):"
  18406. msgstr ""
  18407. #. type: example
  18408. #: guix-git/doc/guix.texi:12441
  18409. #, no-wrap
  18410. msgid "guix graph coreutils | xdot -\n"
  18411. msgstr ""
  18412. #. type: Plain text
  18413. #: guix-git/doc/guix.texi:12448
  18414. msgid "But there is more than one graph! The one above is concise: it is the graph of package objects, omitting implicit inputs such as GCC, libc, grep, etc. It is often useful to have such a concise graph, but sometimes one may want to see more details. @command{guix graph} supports several types of graphs, allowing you to choose the level of detail:"
  18415. msgstr ""
  18416. #. type: table
  18417. #: guix-git/doc/guix.texi:12454
  18418. msgid "This is the default type used in the example above. It shows the DAG of package objects, excluding implicit dependencies. It is concise, but filters out many details."
  18419. msgstr ""
  18420. #. type: item
  18421. #: guix-git/doc/guix.texi:12455
  18422. #, no-wrap
  18423. msgid "reverse-package"
  18424. msgstr ""
  18425. #. type: table
  18426. #: guix-git/doc/guix.texi:12457
  18427. msgid "This shows the @emph{reverse} DAG of packages. For example:"
  18428. msgstr ""
  18429. #. type: example
  18430. #: guix-git/doc/guix.texi:12460
  18431. #, no-wrap
  18432. msgid "guix graph --type=reverse-package ocaml\n"
  18433. msgstr ""
  18434. #. type: table
  18435. #: guix-git/doc/guix.texi:12465
  18436. msgid "...@: yields the graph of packages that @emph{explicitly} depend on OCaml (if you are also interested in cases where OCaml is an implicit dependency, see @code{reverse-bag} below)."
  18437. msgstr ""
  18438. #. type: table
  18439. #: guix-git/doc/guix.texi:12470
  18440. msgid "Note that for core packages this can yield huge graphs. If all you want is to know the number of packages that depend on a given package, use @command{guix refresh --list-dependent} (@pxref{Invoking guix refresh, @option{--list-dependent}})."
  18441. msgstr ""
  18442. #. type: item
  18443. #: guix-git/doc/guix.texi:12471
  18444. #, no-wrap
  18445. msgid "bag-emerged"
  18446. msgstr ""
  18447. #. type: table
  18448. #: guix-git/doc/guix.texi:12473
  18449. msgid "This is the package DAG, @emph{including} implicit inputs."
  18450. msgstr ""
  18451. #. type: table
  18452. #: guix-git/doc/guix.texi:12475
  18453. msgid "For instance, the following command:"
  18454. msgstr ""
  18455. #. type: example
  18456. #: guix-git/doc/guix.texi:12478
  18457. #, no-wrap
  18458. msgid "guix graph --type=bag-emerged coreutils\n"
  18459. msgstr ""
  18460. #. type: table
  18461. #: guix-git/doc/guix.texi:12481
  18462. msgid "...@: yields this bigger graph:"
  18463. msgstr ""
  18464. #. type: table
  18465. #: guix-git/doc/guix.texi:12483
  18466. msgid "@image{images/coreutils-bag-graph,,5in,Detailed dependency graph of the GNU Coreutils}"
  18467. msgstr ""
  18468. #. type: table
  18469. #: guix-git/doc/guix.texi:12486
  18470. msgid "At the bottom of the graph, we see all the implicit inputs of @var{gnu-build-system} (@pxref{Build Systems, @code{gnu-build-system}})."
  18471. msgstr ""
  18472. #. type: table
  18473. #: guix-git/doc/guix.texi:12490
  18474. msgid "Now, note that the dependencies of these implicit inputs---that is, the @dfn{bootstrap dependencies} (@pxref{Bootstrapping})---are not shown here, for conciseness."
  18475. msgstr ""
  18476. #. type: item
  18477. #: guix-git/doc/guix.texi:12491
  18478. #, no-wrap
  18479. msgid "bag"
  18480. msgstr ""
  18481. #. type: table
  18482. #: guix-git/doc/guix.texi:12494
  18483. msgid "Similar to @code{bag-emerged}, but this time including all the bootstrap dependencies."
  18484. msgstr ""
  18485. #. type: item
  18486. #: guix-git/doc/guix.texi:12495
  18487. #, no-wrap
  18488. msgid "bag-with-origins"
  18489. msgstr ""
  18490. #. type: table
  18491. #: guix-git/doc/guix.texi:12497
  18492. msgid "Similar to @code{bag}, but also showing origins and their dependencies."
  18493. msgstr ""
  18494. #. type: item
  18495. #: guix-git/doc/guix.texi:12498
  18496. #, no-wrap
  18497. msgid "reverse-bag"
  18498. msgstr ""
  18499. #. type: table
  18500. #: guix-git/doc/guix.texi:12501
  18501. msgid "This shows the @emph{reverse} DAG of packages. Unlike @code{reverse-package}, it also takes implicit dependencies into account. For example:"
  18502. msgstr ""
  18503. #. type: example
  18504. #: guix-git/doc/guix.texi:12504
  18505. #, no-wrap
  18506. msgid "guix graph -t reverse-bag dune\n"
  18507. msgstr ""
  18508. #. type: table
  18509. #: guix-git/doc/guix.texi:12511
  18510. msgid "...@: yields the graph of all packages that depend on Dune, directly or indirectly. Since Dune is an @emph{implicit} dependency of many packages @i{via} @code{dune-build-system}, this shows a large number of packages, whereas @code{reverse-package} would show very few if any."
  18511. msgstr ""
  18512. #. type: table
  18513. #: guix-git/doc/guix.texi:12517
  18514. msgid "This is the most detailed representation: It shows the DAG of derivations (@pxref{Derivations}) and plain store items. Compared to the above representation, many additional nodes are visible, including build scripts, patches, Guile modules, etc."
  18515. msgstr ""
  18516. #. type: table
  18517. #: guix-git/doc/guix.texi:12520
  18518. msgid "For this type of graph, it is also possible to pass a @file{.drv} file name instead of a package name, as in:"
  18519. msgstr ""
  18520. #. type: example
  18521. #: guix-git/doc/guix.texi:12523
  18522. #, no-wrap
  18523. msgid "guix graph -t derivation $(guix system build -d my-config.scm)\n"
  18524. msgstr ""
  18525. #. type: item
  18526. #: guix-git/doc/guix.texi:12525
  18527. #, no-wrap
  18528. msgid "module"
  18529. msgstr ""
  18530. #. type: table
  18531. #: guix-git/doc/guix.texi:12529
  18532. msgid "This is the graph of @dfn{package modules} (@pxref{Package Modules}). For example, the following command shows the graph for the package module that defines the @code{guile} package:"
  18533. msgstr ""
  18534. #. type: example
  18535. #: guix-git/doc/guix.texi:12532
  18536. #, no-wrap
  18537. msgid "guix graph -t module guile | xdot -\n"
  18538. msgstr ""
  18539. #. type: Plain text
  18540. #: guix-git/doc/guix.texi:12537
  18541. msgid "All the types above correspond to @emph{build-time dependencies}. The following graph type represents the @emph{run-time dependencies}:"
  18542. msgstr ""
  18543. #. type: table
  18544. #: guix-git/doc/guix.texi:12542
  18545. msgid "This is the graph of @dfn{references} of a package output, as returned by @command{guix gc --references} (@pxref{Invoking guix gc})."
  18546. msgstr ""
  18547. #. type: table
  18548. #: guix-git/doc/guix.texi:12545
  18549. msgid "If the given package output is not available in the store, @command{guix graph} attempts to obtain dependency information from substitutes."
  18550. msgstr ""
  18551. #. type: table
  18552. #: guix-git/doc/guix.texi:12549
  18553. msgid "Here you can also pass a store file name instead of a package name. For example, the command below produces the reference graph of your profile (which can be big!):"
  18554. msgstr ""
  18555. #. type: example
  18556. #: guix-git/doc/guix.texi:12552
  18557. #, no-wrap
  18558. msgid "guix graph -t references $(readlink -f ~/.guix-profile)\n"
  18559. msgstr ""
  18560. #. type: item
  18561. #: guix-git/doc/guix.texi:12554
  18562. #, no-wrap
  18563. msgid "referrers"
  18564. msgstr ""
  18565. #. type: table
  18566. #: guix-git/doc/guix.texi:12557
  18567. msgid "This is the graph of the @dfn{referrers} of a store item, as returned by @command{guix gc --referrers} (@pxref{Invoking guix gc})."
  18568. msgstr ""
  18569. #. type: table
  18570. #: guix-git/doc/guix.texi:12563
  18571. msgid "This relies exclusively on local information from your store. For instance, let us suppose that the current Inkscape is available in 10 profiles on your machine; @command{guix graph -t referrers inkscape} will show a graph rooted at Inkscape and with those 10 profiles linked to it."
  18572. msgstr ""
  18573. #. type: table
  18574. #: guix-git/doc/guix.texi:12566
  18575. msgid "It can help determine what is preventing a store item from being garbage collected."
  18576. msgstr ""
  18577. #. type: cindex
  18578. #: guix-git/doc/guix.texi:12569
  18579. #, no-wrap
  18580. msgid "shortest path, between packages"
  18581. msgstr ""
  18582. #. type: Plain text
  18583. #: guix-git/doc/guix.texi:12576
  18584. msgid "Often, the graph of the package you are interested in does not fit on your screen, and anyway all you want to know is @emph{why} that package actually depends on some seemingly unrelated package. The @option{--path} option instructs @command{guix graph} to display the shortest path between two packages (or derivations, or store items, etc.):"
  18585. msgstr ""
  18586. #. type: example
  18587. #: guix-git/doc/guix.texi:12590
  18588. #, no-wrap
  18589. msgid ""
  18590. "$ guix graph --path emacs libunistring\n"
  18591. "emacs@@26.3\n"
  18592. "mailutils@@3.9\n"
  18593. "libunistring@@0.9.10\n"
  18594. "$ guix graph --path -t derivation emacs libunistring\n"
  18595. "/gnu/store/@dots{}-emacs-26.3.drv\n"
  18596. "/gnu/store/@dots{}-mailutils-3.9.drv\n"
  18597. "/gnu/store/@dots{}-libunistring-0.9.10.drv\n"
  18598. "$ guix graph --path -t references emacs libunistring\n"
  18599. "/gnu/store/@dots{}-emacs-26.3\n"
  18600. "/gnu/store/@dots{}-libidn2-2.2.0\n"
  18601. "/gnu/store/@dots{}-libunistring-0.9.10\n"
  18602. msgstr ""
  18603. #. type: Plain text
  18604. #: guix-git/doc/guix.texi:12593
  18605. msgid "The available options are the following:"
  18606. msgstr ""
  18607. #. type: table
  18608. #: guix-git/doc/guix.texi:12599
  18609. msgid "Produce a graph output of @var{type}, where @var{type} must be one of the values listed above."
  18610. msgstr ""
  18611. #. type: item
  18612. #: guix-git/doc/guix.texi:12600
  18613. #, no-wrap
  18614. msgid "--list-types"
  18615. msgstr ""
  18616. #. type: table
  18617. #: guix-git/doc/guix.texi:12602
  18618. msgid "List the supported graph types."
  18619. msgstr ""
  18620. #. type: item
  18621. #: guix-git/doc/guix.texi:12603
  18622. #, no-wrap
  18623. msgid "--backend=@var{backend}"
  18624. msgstr ""
  18625. #. type: itemx
  18626. #: guix-git/doc/guix.texi:12604
  18627. #, no-wrap
  18628. msgid "-b @var{backend}"
  18629. msgstr ""
  18630. #. type: table
  18631. #: guix-git/doc/guix.texi:12606
  18632. msgid "Produce a graph using the selected @var{backend}."
  18633. msgstr ""
  18634. #. type: item
  18635. #: guix-git/doc/guix.texi:12607
  18636. #, no-wrap
  18637. msgid "--list-backends"
  18638. msgstr ""
  18639. #. type: table
  18640. #: guix-git/doc/guix.texi:12609
  18641. msgid "List the supported graph backends."
  18642. msgstr ""
  18643. #. type: table
  18644. #: guix-git/doc/guix.texi:12611
  18645. msgid "Currently, the available backends are Graphviz and d3.js."
  18646. msgstr ""
  18647. #. type: item
  18648. #: guix-git/doc/guix.texi:12612
  18649. #, no-wrap
  18650. msgid "--path"
  18651. msgstr ""
  18652. #. type: table
  18653. #: guix-git/doc/guix.texi:12617
  18654. msgid "Display the shortest path between two nodes of the type specified by @option{--type}. The example below shows the shortest path between @code{libreoffice} and @code{llvm} according to the references of @code{libreoffice}:"
  18655. msgstr ""
  18656. #. type: example
  18657. #: guix-git/doc/guix.texi:12624
  18658. #, no-wrap
  18659. msgid ""
  18660. "$ guix graph --path -t references libreoffice llvm\n"
  18661. "/gnu/store/@dots{}-libreoffice-6.4.2.2\n"
  18662. "/gnu/store/@dots{}-libepoxy-1.5.4\n"
  18663. "/gnu/store/@dots{}-mesa-19.3.4\n"
  18664. "/gnu/store/@dots{}-llvm-9.0.1\n"
  18665. msgstr ""
  18666. #. type: example
  18667. #: guix-git/doc/guix.texi:12634
  18668. #, no-wrap
  18669. msgid "guix graph -e '(@@@@ (gnu packages commencement) gnu-make-final)'\n"
  18670. msgstr ""
  18671. #. type: table
  18672. #: guix-git/doc/guix.texi:12639
  18673. msgid "Display the graph for @var{system}---e.g., @code{i686-linux}."
  18674. msgstr ""
  18675. #. type: table
  18676. #: guix-git/doc/guix.texi:12642
  18677. msgid "The package dependency graph is largely architecture-independent, but there are some architecture-dependent bits that this option allows you to visualize."
  18678. msgstr ""
  18679. #. type: Plain text
  18680. #: guix-git/doc/guix.texi:12658
  18681. msgid "On top of that, @command{guix graph} supports all the usual package transformation options (@pxref{Package Transformation Options}). This makes it easy to view the effect of a graph-rewriting transformation such as @option{--with-input}. For example, the command below outputs the graph of @code{git} once @code{openssl} has been replaced by @code{libressl} everywhere in the graph:"
  18682. msgstr ""
  18683. #. type: example
  18684. #: guix-git/doc/guix.texi:12661
  18685. #, no-wrap
  18686. msgid "guix graph git --with-input=openssl=libressl\n"
  18687. msgstr ""
  18688. #. type: Plain text
  18689. #: guix-git/doc/guix.texi:12664
  18690. msgid "So many possibilities, so much fun!"
  18691. msgstr ""
  18692. #. type: section
  18693. #: guix-git/doc/guix.texi:12666
  18694. #, no-wrap
  18695. msgid "Invoking @command{guix publish}"
  18696. msgstr ""
  18697. #. type: command{#1}
  18698. #: guix-git/doc/guix.texi:12668
  18699. #, no-wrap
  18700. msgid "guix publish"
  18701. msgstr ""
  18702. #. type: Plain text
  18703. #: guix-git/doc/guix.texi:12672
  18704. msgid "The purpose of @command{guix publish} is to enable users to easily share their store with others, who can then use it as a substitute server (@pxref{Substitutes})."
  18705. msgstr ""
  18706. #. type: Plain text
  18707. #: guix-git/doc/guix.texi:12678
  18708. msgid "When @command{guix publish} runs, it spawns an HTTP server which allows anyone with network access to obtain substitutes from it. This means that any machine running Guix can also act as if it were a build farm, since the HTTP interface is compatible with Cuirass, the software behind the @code{@value{SUBSTITUTE-SERVER-1}} build farm."
  18709. msgstr ""
  18710. #. type: Plain text
  18711. #: guix-git/doc/guix.texi:12684
  18712. msgid "For security, each substitute is signed, allowing recipients to check their authenticity and integrity (@pxref{Substitutes}). Because @command{guix publish} uses the signing key of the system, which is only readable by the system administrator, it must be started as root; the @option{--user} option makes it drop root privileges early on."
  18713. msgstr ""
  18714. #. type: Plain text
  18715. #: guix-git/doc/guix.texi:12688
  18716. msgid "The signing key pair must be generated before @command{guix publish} is launched, using @command{guix archive --generate-key} (@pxref{Invoking guix archive})."
  18717. msgstr ""
  18718. #. type: Plain text
  18719. #: guix-git/doc/guix.texi:12693
  18720. msgid "When the @option{--advertise} option is passed, the server advertises its availability on the local network using multicast DNS (mDNS) and DNS service discovery (DNS-SD), currently @i{via} Guile-Avahi (@pxref{Top,,, guile-avahi, Using Avahi in Guile Scheme Programs})."
  18721. msgstr ""
  18722. #. type: example
  18723. #: guix-git/doc/guix.texi:12698
  18724. #, no-wrap
  18725. msgid "guix publish @var{options}@dots{}\n"
  18726. msgstr ""
  18727. #. type: Plain text
  18728. #: guix-git/doc/guix.texi:12702
  18729. msgid "Running @command{guix publish} without any additional arguments will spawn an HTTP server on port 8080:"
  18730. msgstr ""
  18731. #. type: example
  18732. #: guix-git/doc/guix.texi:12705
  18733. #, no-wrap
  18734. msgid "guix publish\n"
  18735. msgstr ""
  18736. #. type: Plain text
  18737. #: guix-git/doc/guix.texi:12709
  18738. msgid "Once a publishing server has been authorized, the daemon may download substitutes from it. @xref{Getting Substitutes from Other Servers}."
  18739. msgstr ""
  18740. #. type: Plain text
  18741. #: guix-git/doc/guix.texi:12717
  18742. msgid "By default, @command{guix publish} compresses archives on the fly as it serves them. This ``on-the-fly'' mode is convenient in that it requires no setup and is immediately available. However, when serving lots of clients, we recommend using the @option{--cache} option, which enables caching of the archives before they are sent to clients---see below for details. The @command{guix weather} command provides a handy way to check what a server provides (@pxref{Invoking guix weather})."
  18743. msgstr ""
  18744. #. type: Plain text
  18745. #: guix-git/doc/guix.texi:12724
  18746. msgid "As a bonus, @command{guix publish} also serves as a content-addressed mirror for source files referenced in @code{origin} records (@pxref{origin Reference}). For instance, assuming @command{guix publish} is running on @code{example.org}, the following URL returns the raw @file{hello-2.10.tar.gz} file with the given SHA256 hash (represented in @code{nix-base32} format, @pxref{Invoking guix hash}):"
  18747. msgstr ""
  18748. #. type: example
  18749. #: guix-git/doc/guix.texi:12727
  18750. #, no-wrap
  18751. msgid "http://example.org/file/hello-2.10.tar.gz/sha256/0ssi1@dots{}ndq1i\n"
  18752. msgstr ""
  18753. #. type: Plain text
  18754. #: guix-git/doc/guix.texi:12731
  18755. msgid "Obviously, these URLs only work for files that are in the store; in other cases, they return 404 (``Not Found'')."
  18756. msgstr ""
  18757. #. type: cindex
  18758. #: guix-git/doc/guix.texi:12732
  18759. #, no-wrap
  18760. msgid "build logs, publication"
  18761. msgstr ""
  18762. #. type: Plain text
  18763. #: guix-git/doc/guix.texi:12734
  18764. msgid "Build logs are available from @code{/log} URLs like:"
  18765. msgstr ""
  18766. #. type: example
  18767. #: guix-git/doc/guix.texi:12737
  18768. #, no-wrap
  18769. msgid "http://example.org/log/gwspk@dots{}-guile-2.2.3\n"
  18770. msgstr ""
  18771. #. type: Plain text
  18772. #: guix-git/doc/guix.texi:12747
  18773. msgid "When @command{guix-daemon} is configured to save compressed build logs, as is the case by default (@pxref{Invoking guix-daemon}), @code{/log} URLs return the compressed log as-is, with an appropriate @code{Content-Type} and/or @code{Content-Encoding} header. We recommend running @command{guix-daemon} with @option{--log-compression=gzip} since Web browsers can automatically decompress it, which is not the case with Bzip2 compression."
  18774. msgstr ""
  18775. #. type: item
  18776. #: guix-git/doc/guix.texi:12751
  18777. #, no-wrap
  18778. msgid "--port=@var{port}"
  18779. msgstr ""
  18780. #. type: itemx
  18781. #: guix-git/doc/guix.texi:12752
  18782. #, no-wrap
  18783. msgid "-p @var{port}"
  18784. msgstr ""
  18785. #. type: table
  18786. #: guix-git/doc/guix.texi:12754
  18787. msgid "Listen for HTTP requests on @var{port}."
  18788. msgstr ""
  18789. #. type: item
  18790. #: guix-git/doc/guix.texi:12755
  18791. #, no-wrap
  18792. msgid "--listen=@var{host}"
  18793. msgstr ""
  18794. #. type: table
  18795. #: guix-git/doc/guix.texi:12758
  18796. msgid "Listen on the network interface for @var{host}. The default is to accept connections from any interface."
  18797. msgstr ""
  18798. #. type: table
  18799. #: guix-git/doc/guix.texi:12763
  18800. msgid "Change privileges to @var{user} as soon as possible---i.e., once the server socket is open and the signing key has been read."
  18801. msgstr ""
  18802. #. type: item
  18803. #: guix-git/doc/guix.texi:12764
  18804. #, no-wrap
  18805. msgid "--compression[=@var{method}[:@var{level}]]"
  18806. msgstr ""
  18807. #. type: itemx
  18808. #: guix-git/doc/guix.texi:12765
  18809. #, no-wrap
  18810. msgid "-C [@var{method}[:@var{level}]]"
  18811. msgstr ""
  18812. #. type: table
  18813. #: guix-git/doc/guix.texi:12769
  18814. msgid "Compress data using the given @var{method} and @var{level}. @var{method} is one of @code{lzip}, @code{zstd}, and @code{gzip}; when @var{method} is omitted, @code{gzip} is used."
  18815. msgstr ""
  18816. #. type: table
  18817. #: guix-git/doc/guix.texi:12773
  18818. msgid "When @var{level} is zero, disable compression. The range 1 to 9 corresponds to different compression levels: 1 is the fastest, and 9 is the best (CPU-intensive). The default is 3."
  18819. msgstr ""
  18820. #. type: table
  18821. #: guix-git/doc/guix.texi:12780
  18822. msgid "Usually, @code{lzip} compresses noticeably better than @code{gzip} for a small increase in CPU usage; see @uref{https://nongnu.org/lzip/lzip_benchmark.html,benchmarks on the lzip Web page}. However, @code{lzip} achieves low decompression throughput (on the order of 50@tie{}MiB/s on modern hardware), which can be a bottleneck for someone who downloads over a fast network connection."
  18823. msgstr ""
  18824. #. type: table
  18825. #: guix-git/doc/guix.texi:12784
  18826. msgid "The compression ratio of @code{zstd} is between that of @code{lzip} and that of @code{gzip}; its main advantage is a @uref{https://facebook.github.io/zstd/,high decompression speed}."
  18827. msgstr ""
  18828. #. type: table
  18829. #: guix-git/doc/guix.texi:12793
  18830. msgid "Unless @option{--cache} is used, compression occurs on the fly and the compressed streams are not cached. Thus, to reduce load on the machine that runs @command{guix publish}, it may be a good idea to choose a low compression level, to run @command{guix publish} behind a caching proxy, or to use @option{--cache}. Using @option{--cache} has the advantage that it allows @command{guix publish} to add @code{Content-Length} HTTP header to its responses."
  18831. msgstr ""
  18832. #. type: table
  18833. #: guix-git/doc/guix.texi:12798
  18834. msgid "This option can be repeated, in which case every substitute gets compressed using all the selected methods, and all of them are advertised. This is useful when users may not support all the compression methods: they can select the one they support."
  18835. msgstr ""
  18836. #. type: item
  18837. #: guix-git/doc/guix.texi:12799
  18838. #, no-wrap
  18839. msgid "--cache=@var{directory}"
  18840. msgstr ""
  18841. #. type: itemx
  18842. #: guix-git/doc/guix.texi:12800
  18843. #, no-wrap
  18844. msgid "-c @var{directory}"
  18845. msgstr ""
  18846. #. type: table
  18847. #: guix-git/doc/guix.texi:12803
  18848. msgid "Cache archives and meta-data (@code{.narinfo} URLs) to @var{directory} and only serve archives that are in cache."
  18849. msgstr ""
  18850. #. type: table
  18851. #: guix-git/doc/guix.texi:12811
  18852. msgid "When this option is omitted, archives and meta-data are created on-the-fly. This can reduce the available bandwidth, especially when compression is enabled, since this may become CPU-bound. Another drawback of the default mode is that the length of archives is not known in advance, so @command{guix publish} does not add a @code{Content-Length} HTTP header to its responses, which in turn prevents clients from knowing the amount of data being downloaded."
  18853. msgstr ""
  18854. #. type: table
  18855. #: guix-git/doc/guix.texi:12819
  18856. msgid "Conversely, when @option{--cache} is used, the first request for a store item (@i{via} a @code{.narinfo} URL) triggers a background process to @dfn{bake} the archive---computing its @code{.narinfo} and compressing the archive, if needed. Once the archive is cached in @var{directory}, subsequent requests succeed and are served directly from the cache, which guarantees that clients get the best possible bandwidth."
  18857. msgstr ""
  18858. #. type: table
  18859. #: guix-git/doc/guix.texi:12826
  18860. msgid "That first @code{.narinfo} request nonetheless returns 200, provided the requested store item is ``small enough'', below the cache bypass threshold---see @option{--cache-bypass-threshold} below. That way, clients do not have to wait until the archive is baked. For larger store items, the first @code{.narinfo} request returns 404, meaning that clients have to wait until the archive is baked."
  18861. msgstr ""
  18862. #. type: table
  18863. #: guix-git/doc/guix.texi:12830
  18864. msgid "The ``baking'' process is performed by worker threads. By default, one thread per CPU core is created, but this can be customized. See @option{--workers} below."
  18865. msgstr ""
  18866. #. type: table
  18867. #: guix-git/doc/guix.texi:12833
  18868. msgid "When @option{--ttl} is used, cached entries are automatically deleted when they have expired."
  18869. msgstr ""
  18870. #. type: item
  18871. #: guix-git/doc/guix.texi:12834
  18872. #, no-wrap
  18873. msgid "--workers=@var{N}"
  18874. msgstr ""
  18875. #. type: table
  18876. #: guix-git/doc/guix.texi:12837
  18877. msgid "When @option{--cache} is used, request the allocation of @var{N} worker threads to ``bake'' archives."
  18878. msgstr ""
  18879. #. type: item
  18880. #: guix-git/doc/guix.texi:12838
  18881. #, no-wrap
  18882. msgid "--ttl=@var{ttl}"
  18883. msgstr ""
  18884. #. type: table
  18885. #: guix-git/doc/guix.texi:12842
  18886. msgid "Produce @code{Cache-Control} HTTP headers that advertise a time-to-live (TTL) of @var{ttl}. @var{ttl} must denote a duration: @code{5d} means 5 days, @code{1m} means 1 month, and so on."
  18887. msgstr ""
  18888. #. type: table
  18889. #: guix-git/doc/guix.texi:12847
  18890. msgid "This allows the user's Guix to keep substitute information in cache for @var{ttl}. However, note that @code{guix publish} does not itself guarantee that the store items it provides will indeed remain available for as long as @var{ttl}."
  18891. msgstr ""
  18892. #. type: table
  18893. #: guix-git/doc/guix.texi:12851
  18894. msgid "Additionally, when @option{--cache} is used, cached entries that have not been accessed for @var{ttl} and that no longer have a corresponding item in the store, may be deleted."
  18895. msgstr ""
  18896. #. type: item
  18897. #: guix-git/doc/guix.texi:12852
  18898. #, no-wrap
  18899. msgid "--negative-ttl=@var{ttl}"
  18900. msgstr ""
  18901. #. type: table
  18902. #: guix-git/doc/guix.texi:12857
  18903. msgid "Similarly produce @code{Cache-Control} HTTP headers to advertise the time-to-live (TTL) of @emph{negative} lookups---missing store items, for which the HTTP 404 code is returned. By default, no negative TTL is advertised."
  18904. msgstr ""
  18905. #. type: table
  18906. #: guix-git/doc/guix.texi:12861
  18907. msgid "This parameter can help adjust server load and substitute latency by instructing cooperating clients to be more or less patient when a store item is missing."
  18908. msgstr ""
  18909. #. type: item
  18910. #: guix-git/doc/guix.texi:12862
  18911. #, no-wrap
  18912. msgid "--cache-bypass-threshold=@var{size}"
  18913. msgstr ""
  18914. #. type: table
  18915. #: guix-git/doc/guix.texi:12867
  18916. msgid "When used in conjunction with @option{--cache}, store items smaller than @var{size} are immediately available, even when they are not yet in cache. @var{size} is a size in bytes, or it can be suffixed by @code{M} for megabytes and so on. The default is @code{10M}."
  18917. msgstr ""
  18918. #. type: table
  18919. #: guix-git/doc/guix.texi:12872
  18920. msgid "``Cache bypass'' allows you to reduce the publication delay for clients at the expense of possibly additional I/O and CPU use on the server side: depending on the client access patterns, those store items can end up being baked several times until a copy is available in cache."
  18921. msgstr ""
  18922. #. type: table
  18923. #: guix-git/doc/guix.texi:12876
  18924. msgid "Increasing the threshold may be useful for sites that have few users, or to guarantee that users get substitutes even for store items that are not popular."
  18925. msgstr ""
  18926. #. type: item
  18927. #: guix-git/doc/guix.texi:12877
  18928. #, no-wrap
  18929. msgid "--nar-path=@var{path}"
  18930. msgstr ""
  18931. #. type: table
  18932. #: guix-git/doc/guix.texi:12880
  18933. msgid "Use @var{path} as the prefix for the URLs of ``nar'' files (@pxref{Invoking guix archive, normalized archives})."
  18934. msgstr ""
  18935. #. type: table
  18936. #: guix-git/doc/guix.texi:12884
  18937. msgid "By default, nars are served at a URL such as @code{/nar/gzip/@dots{}-coreutils-8.25}. This option allows you to change the @code{/nar} part to @var{path}."
  18938. msgstr ""
  18939. #. type: item
  18940. #: guix-git/doc/guix.texi:12885
  18941. #, no-wrap
  18942. msgid "--public-key=@var{file}"
  18943. msgstr ""
  18944. #. type: itemx
  18945. #: guix-git/doc/guix.texi:12886
  18946. #, no-wrap
  18947. msgid "--private-key=@var{file}"
  18948. msgstr ""
  18949. #. type: table
  18950. #: guix-git/doc/guix.texi:12889 guix-git/doc/guix.texi:27974
  18951. #: guix-git/doc/guix.texi:28011
  18952. msgid "Use the specific @var{file}s as the public/private key pair used to sign the store items being published."
  18953. msgstr ""
  18954. #. type: table
  18955. #: guix-git/doc/guix.texi:12896
  18956. msgid "The files must correspond to the same key pair (the private key is used for signing and the public key is merely advertised in the signature metadata). They must contain keys in the canonical s-expression format as produced by @command{guix archive --generate-key} (@pxref{Invoking guix archive}). By default, @file{/etc/guix/signing-key.pub} and @file{/etc/guix/signing-key.sec} are used."
  18957. msgstr ""
  18958. #. type: item
  18959. #: guix-git/doc/guix.texi:12897
  18960. #, no-wrap
  18961. msgid "--repl[=@var{port}]"
  18962. msgstr ""
  18963. #. type: itemx
  18964. #: guix-git/doc/guix.texi:12898
  18965. #, no-wrap
  18966. msgid "-r [@var{port}]"
  18967. msgstr ""
  18968. #. type: table
  18969. #: guix-git/doc/guix.texi:12902
  18970. msgid "Spawn a Guile REPL server (@pxref{REPL Servers,,, guile, GNU Guile Reference Manual}) on @var{port} (37146 by default). This is used primarily for debugging a running @command{guix publish} server."
  18971. msgstr ""
  18972. #. type: Plain text
  18973. #: guix-git/doc/guix.texi:12908
  18974. msgid "Enabling @command{guix publish} on Guix System is a one-liner: just instantiate a @code{guix-publish-service-type} service in the @code{services} field of the @code{operating-system} declaration (@pxref{guix-publish-service-type, @code{guix-publish-service-type}})."
  18975. msgstr ""
  18976. #. type: Plain text
  18977. #: guix-git/doc/guix.texi:12911
  18978. msgid "If you are instead running Guix on a ``foreign distro'', follow these instructions:"
  18979. msgstr ""
  18980. #. type: itemize
  18981. #: guix-git/doc/guix.texi:12915
  18982. msgid "If your host distro uses the systemd init system:"
  18983. msgstr ""
  18984. #. type: example
  18985. #: guix-git/doc/guix.texi:12920
  18986. #, no-wrap
  18987. msgid ""
  18988. "# ln -s ~root/.guix-profile/lib/systemd/system/guix-publish.service \\\n"
  18989. " /etc/systemd/system/\n"
  18990. "# systemctl start guix-publish && systemctl enable guix-publish\n"
  18991. msgstr ""
  18992. #. type: example
  18993. #: guix-git/doc/guix.texi:12928
  18994. #, no-wrap
  18995. msgid ""
  18996. "# ln -s ~root/.guix-profile/lib/upstart/system/guix-publish.conf /etc/init/\n"
  18997. "# start guix-publish\n"
  18998. msgstr ""
  18999. #. type: itemize
  19000. #: guix-git/doc/guix.texi:12932
  19001. msgid "Otherwise, proceed similarly with your distro's init system."
  19002. msgstr ""
  19003. #. type: section
  19004. #: guix-git/doc/guix.texi:12935
  19005. #, no-wrap
  19006. msgid "Invoking @command{guix challenge}"
  19007. msgstr ""
  19008. #. type: cindex
  19009. #: guix-git/doc/guix.texi:12938
  19010. #, no-wrap
  19011. msgid "verifiable builds"
  19012. msgstr ""
  19013. #. type: command{#1}
  19014. #: guix-git/doc/guix.texi:12939
  19015. #, no-wrap
  19016. msgid "guix challenge"
  19017. msgstr ""
  19018. #. type: cindex
  19019. #: guix-git/doc/guix.texi:12940
  19020. #, no-wrap
  19021. msgid "challenge"
  19022. msgstr ""
  19023. #. type: Plain text
  19024. #: guix-git/doc/guix.texi:12945
  19025. msgid "Do the binaries provided by this server really correspond to the source code it claims to build? Is a package build process deterministic? These are the questions the @command{guix challenge} command attempts to answer."
  19026. msgstr ""
  19027. #. type: Plain text
  19028. #: guix-git/doc/guix.texi:12953
  19029. msgid "The former is obviously an important question: Before using a substitute server (@pxref{Substitutes}), one had better @emph{verify} that it provides the right binaries, and thus @emph{challenge} it. The latter is what enables the former: If package builds are deterministic, then independent builds of the package should yield the exact same result, bit for bit; if a server provides a binary different from the one obtained locally, it may be either corrupt or malicious."
  19030. msgstr ""
  19031. #. type: Plain text
  19032. #: guix-git/doc/guix.texi:12962
  19033. msgid "We know that the hash that shows up in @file{/gnu/store} file names is the hash of all the inputs of the process that built the file or directory---compilers, libraries, build scripts, etc. (@pxref{Introduction}). Assuming deterministic build processes, one store file name should map to exactly one build output. @command{guix challenge} checks whether there is, indeed, a single mapping by comparing the build outputs of several independent builds of any given store item."
  19034. msgstr ""
  19035. #. type: Plain text
  19036. #: guix-git/doc/guix.texi:12964
  19037. msgid "The command output looks like this:"
  19038. msgstr ""
  19039. #. type: smallexample
  19040. #: guix-git/doc/guix.texi:12976
  19041. #, no-wrap
  19042. msgid ""
  19043. "$ guix challenge --substitute-urls=\"https://@value{SUBSTITUTE-SERVER-1} https://guix.example.org\"\n"
  19044. "updating list of substitutes from 'https://@value{SUBSTITUTE-SERVER-1}'... 100.0%\n"
  19045. "updating list of substitutes from 'https://guix.example.org'... 100.0%\n"
  19046. "/gnu/store/@dots{}-openssl-1.0.2d contents differ:\n"
  19047. " local hash: 0725l22r5jnzazaacncwsvp9kgf42266ayyp814v7djxs7nk963q\n"
  19048. " https://@value{SUBSTITUTE-SERVER-1}/nar/@dots{}-openssl-1.0.2d: 0725l22r5jnzazaacncwsvp9kgf42266ayyp814v7djxs7nk963q\n"
  19049. " https://guix.example.org/nar/@dots{}-openssl-1.0.2d: 1zy4fmaaqcnjrzzajkdn3f5gmjk754b43qkq47llbyak9z0qjyim\n"
  19050. " differing files:\n"
  19051. " /lib/libcrypto.so.1.1\n"
  19052. " /lib/libssl.so.1.1\n"
  19053. "\n"
  19054. msgstr ""
  19055. #. type: smallexample
  19056. #: guix-git/doc/guix.texi:12983
  19057. #, no-wrap
  19058. msgid ""
  19059. "/gnu/store/@dots{}-git-2.5.0 contents differ:\n"
  19060. " local hash: 00p3bmryhjxrhpn2gxs2fy0a15lnip05l97205pgbk5ra395hyha\n"
  19061. " https://@value{SUBSTITUTE-SERVER-1}/nar/@dots{}-git-2.5.0: 069nb85bv4d4a6slrwjdy8v1cn4cwspm3kdbmyb81d6zckj3nq9f\n"
  19062. " https://guix.example.org/nar/@dots{}-git-2.5.0: 0mdqa9w1p6cmli6976v4wi0sw9r4p5prkj7lzfd1877wk11c9c73\n"
  19063. " differing file:\n"
  19064. " /libexec/git-core/git-fsck\n"
  19065. "\n"
  19066. msgstr ""
  19067. #. type: smallexample
  19068. #: guix-git/doc/guix.texi:12990
  19069. #, no-wrap
  19070. msgid ""
  19071. "/gnu/store/@dots{}-pius-2.1.1 contents differ:\n"
  19072. " local hash: 0k4v3m9z1zp8xzzizb7d8kjj72f9172xv078sq4wl73vnq9ig3ax\n"
  19073. " https://@value{SUBSTITUTE-SERVER-1}/nar/@dots{}-pius-2.1.1: 0k4v3m9z1zp8xzzizb7d8kjj72f9172xv078sq4wl73vnq9ig3ax\n"
  19074. " https://guix.example.org/nar/@dots{}-pius-2.1.1: 1cy25x1a4fzq5rk0pmvc8xhwyffnqz95h2bpvqsz2mpvlbccy0gs\n"
  19075. " differing file:\n"
  19076. " /share/man/man1/pius.1.gz\n"
  19077. "\n"
  19078. msgstr ""
  19079. #. type: smallexample
  19080. #: guix-git/doc/guix.texi:12992
  19081. #, no-wrap
  19082. msgid ""
  19083. "@dots{}\n"
  19084. "\n"
  19085. msgstr ""
  19086. #. type: smallexample
  19087. #: guix-git/doc/guix.texi:12997
  19088. #, no-wrap
  19089. msgid ""
  19090. "6,406 store items were analyzed:\n"
  19091. " - 4,749 (74.1%) were identical\n"
  19092. " - 525 (8.2%) differed\n"
  19093. " - 1,132 (17.7%) were inconclusive\n"
  19094. msgstr ""
  19095. #. type: Plain text
  19096. #: guix-git/doc/guix.texi:13005
  19097. msgid "In this example, @command{guix challenge} first scans the store to determine the set of locally-built derivations---as opposed to store items that were downloaded from a substitute server---and then queries all the substitute servers. It then reports those store items for which the servers obtained a result different from the local build."
  19098. msgstr ""
  19099. #. type: cindex
  19100. #: guix-git/doc/guix.texi:13006
  19101. #, no-wrap
  19102. msgid "non-determinism, in package builds"
  19103. msgstr ""
  19104. #. type: Plain text
  19105. #: guix-git/doc/guix.texi:13017
  19106. msgid "As an example, @code{guix.example.org} always gets a different answer. Conversely, @code{@value{SUBSTITUTE-SERVER-1}} agrees with local builds, except in the case of Git. This might indicate that the build process of Git is non-deterministic, meaning that its output varies as a function of various things that Guix does not fully control, in spite of building packages in isolated environments (@pxref{Features}). Most common sources of non-determinism include the addition of timestamps in build results, the inclusion of random numbers, and directory listings sorted by inode number. See @uref{https://reproducible-builds.org/docs/}, for more information."
  19107. msgstr ""
  19108. #. type: Plain text
  19109. #: guix-git/doc/guix.texi:13020
  19110. msgid "To find out what is wrong with this Git binary, the easiest approach is to run:"
  19111. msgstr ""
  19112. #. type: example
  19113. #: guix-git/doc/guix.texi:13025
  19114. #, no-wrap
  19115. msgid ""
  19116. "guix challenge git \\\n"
  19117. " --diff=diffoscope \\\n"
  19118. " --substitute-urls=\"https://@value{SUBSTITUTE-SERVER-1} https://guix.example.org\"\n"
  19119. msgstr ""
  19120. #. type: Plain text
  19121. #: guix-git/doc/guix.texi:13029
  19122. msgid "This automatically invokes @command{diffoscope}, which displays detailed information about files that differ."
  19123. msgstr ""
  19124. #. type: Plain text
  19125. #: guix-git/doc/guix.texi:13032
  19126. msgid "Alternatively, we can do something along these lines (@pxref{Invoking guix archive}):"
  19127. msgstr ""
  19128. #. type: example
  19129. #: guix-git/doc/guix.texi:13037
  19130. #, no-wrap
  19131. msgid ""
  19132. "$ wget -q -O - https://@value{SUBSTITUTE-SERVER-1}/nar/lzip/@dots{}-git-2.5.0 \\\n"
  19133. " | lzip -d | guix archive -x /tmp/git\n"
  19134. "$ diff -ur --no-dereference /gnu/store/@dots{}-git.2.5.0 /tmp/git\n"
  19135. msgstr ""
  19136. #. type: Plain text
  19137. #: guix-git/doc/guix.texi:13046
  19138. msgid "This command shows the difference between the files resulting from the local build, and the files resulting from the build on @code{@value{SUBSTITUTE-SERVER-1}} (@pxref{Overview, Comparing and Merging Files,, diffutils, Comparing and Merging Files}). The @command{diff} command works great for text files. When binary files differ, a better option is @uref{https://diffoscope.org/, Diffoscope}, a tool that helps visualize differences for all kinds of files."
  19139. msgstr ""
  19140. #. type: Plain text
  19141. #: guix-git/doc/guix.texi:13054
  19142. msgid "Once you have done that work, you can tell whether the differences are due to a non-deterministic build process or to a malicious server. We try hard to remove sources of non-determinism in packages to make it easier to verify substitutes, but of course, this is a process that involves not just Guix, but a large part of the free software community. In the meantime, @command{guix challenge} is one tool to help address the problem."
  19143. msgstr ""
  19144. #. type: Plain text
  19145. #: guix-git/doc/guix.texi:13058
  19146. msgid "If you are writing packages for Guix, you are encouraged to check whether @code{@value{SUBSTITUTE-SERVER-1}} and other substitute servers obtain the same build result as you did with:"
  19147. msgstr ""
  19148. #. type: example
  19149. #: guix-git/doc/guix.texi:13061
  19150. #, no-wrap
  19151. msgid "$ guix challenge @var{package}\n"
  19152. msgstr ""
  19153. #. type: Plain text
  19154. #: guix-git/doc/guix.texi:13066
  19155. msgid "where @var{package} is a package specification such as @code{guile@@2.0} or @code{glibc:debug}."
  19156. msgstr ""
  19157. #. type: example
  19158. #: guix-git/doc/guix.texi:13071
  19159. #, no-wrap
  19160. msgid "guix challenge @var{options} [@var{packages}@dots{}]\n"
  19161. msgstr ""
  19162. #. type: Plain text
  19163. #: guix-git/doc/guix.texi:13078
  19164. msgid "When a difference is found between the hash of a locally-built item and that of a server-provided substitute, or among substitutes provided by different servers, the command displays it as in the example above and its exit code is 2 (other non-zero exit codes denote other kinds of errors)."
  19165. msgstr ""
  19166. #. type: Plain text
  19167. #: guix-git/doc/guix.texi:13080
  19168. msgid "The one option that matters is:"
  19169. msgstr ""
  19170. #. type: table
  19171. #: guix-git/doc/guix.texi:13086
  19172. msgid "Consider @var{urls} the whitespace-separated list of substitute source URLs to compare to."
  19173. msgstr ""
  19174. #. type: item
  19175. #: guix-git/doc/guix.texi:13087
  19176. #, no-wrap
  19177. msgid "--diff=@var{mode}"
  19178. msgstr ""
  19179. #. type: table
  19180. #: guix-git/doc/guix.texi:13089
  19181. msgid "Upon mismatches, show differences according to @var{mode}, one of:"
  19182. msgstr ""
  19183. #. type: item
  19184. #: guix-git/doc/guix.texi:13091
  19185. #, no-wrap
  19186. msgid "@code{simple} (the default)"
  19187. msgstr ""
  19188. #. type: table
  19189. #: guix-git/doc/guix.texi:13093
  19190. msgid "Show the list of files that differ."
  19191. msgstr ""
  19192. #. type: code{#1}
  19193. #: guix-git/doc/guix.texi:13094
  19194. #, no-wrap
  19195. msgid "diffoscope"
  19196. msgstr ""
  19197. #. type: var{#1}
  19198. #: guix-git/doc/guix.texi:13095
  19199. #, no-wrap
  19200. msgid "command"
  19201. msgstr ""
  19202. #. type: table
  19203. #: guix-git/doc/guix.texi:13098
  19204. msgid "Invoke @uref{https://diffoscope.org/, Diffoscope}, passing it two directories whose contents do not match."
  19205. msgstr ""
  19206. #. type: table
  19207. #: guix-git/doc/guix.texi:13101
  19208. msgid "When @var{command} is an absolute file name, run @var{command} instead of Diffoscope."
  19209. msgstr ""
  19210. #. type: item
  19211. #: guix-git/doc/guix.texi:13102 guix-git/doc/guix.texi:16437
  19212. #: guix-git/doc/guix.texi:18529
  19213. #, no-wrap
  19214. msgid "none"
  19215. msgstr ""
  19216. #. type: table
  19217. #: guix-git/doc/guix.texi:13104
  19218. msgid "Do not show further details about the differences."
  19219. msgstr ""
  19220. #. type: table
  19221. #: guix-git/doc/guix.texi:13109
  19222. msgid "Thus, unless @option{--diff=none} is passed, @command{guix challenge} downloads the store items from the given substitute servers so that it can compare them."
  19223. msgstr ""
  19224. #. type: item
  19225. #: guix-git/doc/guix.texi:13110
  19226. #, no-wrap
  19227. msgid "--verbose"
  19228. msgstr ""
  19229. #. type: itemx
  19230. #: guix-git/doc/guix.texi:13111
  19231. #, no-wrap
  19232. msgid "-v"
  19233. msgstr ""
  19234. #. type: table
  19235. #: guix-git/doc/guix.texi:13114
  19236. msgid "Show details about matches (identical contents) in addition to information about mismatches."
  19237. msgstr ""
  19238. #. type: section
  19239. #: guix-git/doc/guix.texi:13118
  19240. #, no-wrap
  19241. msgid "Invoking @command{guix copy}"
  19242. msgstr ""
  19243. #. type: cindex
  19244. #: guix-git/doc/guix.texi:13120
  19245. #, no-wrap
  19246. msgid "copy, of store items, over SSH"
  19247. msgstr ""
  19248. #. type: cindex
  19249. #: guix-git/doc/guix.texi:13121
  19250. #, no-wrap
  19251. msgid "SSH, copy of store items"
  19252. msgstr ""
  19253. #. type: cindex
  19254. #: guix-git/doc/guix.texi:13122
  19255. #, no-wrap
  19256. msgid "sharing store items across machines"
  19257. msgstr ""
  19258. #. type: cindex
  19259. #: guix-git/doc/guix.texi:13123
  19260. #, no-wrap
  19261. msgid "transferring store items across machines"
  19262. msgstr ""
  19263. #. type: Plain text
  19264. #: guix-git/doc/guix.texi:13130
  19265. msgid "The @command{guix copy} command copies items from the store of one machine to that of another machine over a secure shell (SSH) connection@footnote{This command is available only when Guile-SSH was found. @xref{Requirements}, for details.}. For example, the following command copies the @code{coreutils} package, the user's profile, and all their dependencies over to @var{host}, logged in as @var{user}:"
  19266. msgstr ""
  19267. #. type: example
  19268. #: guix-git/doc/guix.texi:13134
  19269. #, no-wrap
  19270. msgid ""
  19271. "guix copy --to=@var{user}@@@var{host} \\\n"
  19272. " coreutils $(readlink -f ~/.guix-profile)\n"
  19273. msgstr ""
  19274. #. type: Plain text
  19275. #: guix-git/doc/guix.texi:13138
  19276. msgid "If some of the items to be copied are already present on @var{host}, they are not actually sent."
  19277. msgstr ""
  19278. #. type: Plain text
  19279. #: guix-git/doc/guix.texi:13141
  19280. msgid "The command below retrieves @code{libreoffice} and @code{gimp} from @var{host}, assuming they are available there:"
  19281. msgstr ""
  19282. #. type: example
  19283. #: guix-git/doc/guix.texi:13144
  19284. #, no-wrap
  19285. msgid "guix copy --from=@var{host} libreoffice gimp\n"
  19286. msgstr ""
  19287. #. type: Plain text
  19288. #: guix-git/doc/guix.texi:13149
  19289. msgid "The SSH connection is established using the Guile-SSH client, which is compatible with OpenSSH: it honors @file{~/.ssh/known_hosts} and @file{~/.ssh/config}, and uses the SSH agent for authentication."
  19290. msgstr ""
  19291. #. type: Plain text
  19292. #: guix-git/doc/guix.texi:13155
  19293. msgid "The key used to sign items that are sent must be accepted by the remote machine. Likewise, the key used by the remote machine to sign items you are retrieving must be in @file{/etc/guix/acl} so it is accepted by your own daemon. @xref{Invoking guix archive}, for more information about store item authentication."
  19294. msgstr ""
  19295. #. type: example
  19296. #: guix-git/doc/guix.texi:13160
  19297. #, no-wrap
  19298. msgid "guix copy [--to=@var{spec}|--from=@var{spec}] @var{items}@dots{}\n"
  19299. msgstr ""
  19300. #. type: Plain text
  19301. #: guix-git/doc/guix.texi:13163
  19302. msgid "You must always specify one of the following options:"
  19303. msgstr ""
  19304. #. type: item
  19305. #: guix-git/doc/guix.texi:13165
  19306. #, no-wrap
  19307. msgid "--to=@var{spec}"
  19308. msgstr ""
  19309. #. type: itemx
  19310. #: guix-git/doc/guix.texi:13166
  19311. #, no-wrap
  19312. msgid "--from=@var{spec}"
  19313. msgstr ""
  19314. #. type: table
  19315. #: guix-git/doc/guix.texi:13170
  19316. msgid "Specify the host to send to or receive from. @var{spec} must be an SSH spec such as @code{example.org}, @code{charlie@@example.org}, or @code{charlie@@example.org:2222}."
  19317. msgstr ""
  19318. #. type: Plain text
  19319. #: guix-git/doc/guix.texi:13174
  19320. msgid "The @var{items} can be either package names, such as @code{gimp}, or store items, such as @file{/gnu/store/@dots{}-idutils-4.6}."
  19321. msgstr ""
  19322. #. type: Plain text
  19323. #: guix-git/doc/guix.texi:13178
  19324. msgid "When specifying the name of a package to send, it is first built if needed, unless @option{--dry-run} was specified. Common build options are supported (@pxref{Common Build Options})."
  19325. msgstr ""
  19326. #. type: section
  19327. #: guix-git/doc/guix.texi:13181
  19328. #, no-wrap
  19329. msgid "Invoking @command{guix container}"
  19330. msgstr ""
  19331. #. type: command{#1}
  19332. #: guix-git/doc/guix.texi:13183
  19333. #, no-wrap
  19334. msgid "guix container"
  19335. msgstr ""
  19336. #. type: quotation
  19337. #: guix-git/doc/guix.texi:13187
  19338. msgid "As of version @value{VERSION}, this tool is experimental. The interface is subject to radical change in the future."
  19339. msgstr ""
  19340. #. type: Plain text
  19341. #: guix-git/doc/guix.texi:13194
  19342. msgid "The purpose of @command{guix container} is to manipulate processes running within an isolated environment, commonly known as a ``container'', typically created by the @command{guix environment} (@pxref{Invoking guix environment}) and @command{guix system container} (@pxref{Invoking guix system}) commands."
  19343. msgstr ""
  19344. #. type: example
  19345. #: guix-git/doc/guix.texi:13199
  19346. #, no-wrap
  19347. msgid "guix container @var{action} @var{options}@dots{}\n"
  19348. msgstr ""
  19349. #. type: Plain text
  19350. #: guix-git/doc/guix.texi:13203
  19351. msgid "@var{action} specifies the operation to perform with a container, and @var{options} specifies the context-specific arguments for the action."
  19352. msgstr ""
  19353. #. type: Plain text
  19354. #: guix-git/doc/guix.texi:13205
  19355. msgid "The following actions are available:"
  19356. msgstr ""
  19357. #. type: item
  19358. #: guix-git/doc/guix.texi:13207
  19359. #, no-wrap
  19360. msgid "exec"
  19361. msgstr ""
  19362. #. type: table
  19363. #: guix-git/doc/guix.texi:13209
  19364. msgid "Execute a command within the context of a running container."
  19365. msgstr ""
  19366. #. type: table
  19367. #: guix-git/doc/guix.texi:13211
  19368. msgid "The syntax is:"
  19369. msgstr ""
  19370. #. type: example
  19371. #: guix-git/doc/guix.texi:13214
  19372. #, no-wrap
  19373. msgid "guix container exec @var{pid} @var{program} @var{arguments}@dots{}\n"
  19374. msgstr ""
  19375. #. type: table
  19376. #: guix-git/doc/guix.texi:13220
  19377. msgid "@var{pid} specifies the process ID of the running container. @var{program} specifies an executable file name within the root file system of the container. @var{arguments} are the additional options that will be passed to @var{program}."
  19378. msgstr ""
  19379. #. type: table
  19380. #: guix-git/doc/guix.texi:13224
  19381. msgid "The following command launches an interactive login shell inside a Guix system container, started by @command{guix system container}, and whose process ID is 9001:"
  19382. msgstr ""
  19383. #. type: example
  19384. #: guix-git/doc/guix.texi:13227
  19385. #, no-wrap
  19386. msgid "guix container exec 9001 /run/current-system/profile/bin/bash --login\n"
  19387. msgstr ""
  19388. #. type: table
  19389. #: guix-git/doc/guix.texi:13231
  19390. msgid "Note that the @var{pid} cannot be the parent process of a container. It must be PID 1 of the container or one of its child processes."
  19391. msgstr ""
  19392. #. type: section
  19393. #: guix-git/doc/guix.texi:13235
  19394. #, no-wrap
  19395. msgid "Invoking @command{guix weather}"
  19396. msgstr ""
  19397. #. type: Plain text
  19398. #: guix-git/doc/guix.texi:13244
  19399. msgid "Occasionally you're grumpy because substitutes are lacking and you end up building packages by yourself (@pxref{Substitutes}). The @command{guix weather} command reports on substitute availability on the specified servers so you can have an idea of whether you'll be grumpy today. It can sometimes be useful info as a user, but it is primarily useful to people running @command{guix publish} (@pxref{Invoking guix publish})."
  19400. msgstr ""
  19401. #. type: cindex
  19402. #: guix-git/doc/guix.texi:13245
  19403. #, no-wrap
  19404. msgid "statistics, for substitutes"
  19405. msgstr ""
  19406. #. type: cindex
  19407. #: guix-git/doc/guix.texi:13246
  19408. #, no-wrap
  19409. msgid "availability of substitutes"
  19410. msgstr ""
  19411. #. type: cindex
  19412. #: guix-git/doc/guix.texi:13247
  19413. #, no-wrap
  19414. msgid "substitute availability"
  19415. msgstr ""
  19416. #. type: cindex
  19417. #: guix-git/doc/guix.texi:13248
  19418. #, no-wrap
  19419. msgid "weather, substitute availability"
  19420. msgstr ""
  19421. #. type: Plain text
  19422. #: guix-git/doc/guix.texi:13250
  19423. msgid "Here's a sample run:"
  19424. msgstr ""
  19425. #. type: example
  19426. #: guix-git/doc/guix.texi:13262
  19427. #, no-wrap
  19428. msgid ""
  19429. "$ guix weather --substitute-urls=https://guix.example.org\n"
  19430. "computing 5,872 package derivations for x86_64-linux...\n"
  19431. "looking for 6,128 store items on https://guix.example.org..\n"
  19432. "updating list of substitutes from 'https://guix.example.org'... 100.0%\n"
  19433. "https://guix.example.org\n"
  19434. " 43.4% substitutes available (2,658 out of 6,128)\n"
  19435. " 7,032.5 MiB of nars (compressed)\n"
  19436. " 19,824.2 MiB on disk (uncompressed)\n"
  19437. " 0.030 seconds per request (182.9 seconds in total)\n"
  19438. " 33.5 requests per second\n"
  19439. "\n"
  19440. msgstr ""
  19441. #. type: example
  19442. #: guix-git/doc/guix.texi:13272
  19443. #, no-wrap
  19444. msgid ""
  19445. " 9.8% (342 out of 3,470) of the missing items are queued\n"
  19446. " 867 queued builds\n"
  19447. " x86_64-linux: 518 (59.7%)\n"
  19448. " i686-linux: 221 (25.5%)\n"
  19449. " aarch64-linux: 128 (14.8%)\n"
  19450. " build rate: 23.41 builds per hour\n"
  19451. " x86_64-linux: 11.16 builds per hour\n"
  19452. " i686-linux: 6.03 builds per hour\n"
  19453. " aarch64-linux: 6.41 builds per hour\n"
  19454. msgstr ""
  19455. #. type: cindex
  19456. #: guix-git/doc/guix.texi:13274
  19457. #, no-wrap
  19458. msgid "continuous integration, statistics"
  19459. msgstr ""
  19460. #. type: Plain text
  19461. #: guix-git/doc/guix.texi:13285
  19462. msgid "As you can see, it reports the fraction of all the packages for which substitutes are available on the server---regardless of whether substitutes are enabled, and regardless of whether this server's signing key is authorized. It also reports the size of the compressed archives (``nars'') provided by the server, the size the corresponding store items occupy in the store (assuming deduplication is turned off), and the server's throughput. The second part gives continuous integration (CI) statistics, if the server supports it. In addition, using the @option{--coverage} option, @command{guix weather} can list ``important'' package substitutes missing on the server (see below)."
  19463. msgstr ""
  19464. #. type: Plain text
  19465. #: guix-git/doc/guix.texi:13291
  19466. msgid "To achieve that, @command{guix weather} queries over HTTP(S) meta-data (@dfn{narinfos}) for all the relevant store items. Like @command{guix challenge}, it ignores signatures on those substitutes, which is innocuous since the command only gathers statistics and cannot install those substitutes."
  19467. msgstr ""
  19468. #. type: example
  19469. #: guix-git/doc/guix.texi:13296
  19470. #, no-wrap
  19471. msgid "guix weather @var{options}@dots{} [@var{packages}@dots{}]\n"
  19472. msgstr ""
  19473. #. type: Plain text
  19474. #: guix-git/doc/guix.texi:13304
  19475. msgid "When @var{packages} is omitted, @command{guix weather} checks the availability of substitutes for @emph{all} the packages, or for those specified with @option{--manifest}; otherwise it only considers the specified packages. It is also possible to query specific system types with @option{--system}. @command{guix weather} exits with a non-zero code when the fraction of available substitutes is below 100%."
  19476. msgstr ""
  19477. #. type: Plain text
  19478. #: guix-git/doc/guix.texi:13306
  19479. msgid "The available options are listed below."
  19480. msgstr ""
  19481. #. type: table
  19482. #: guix-git/doc/guix.texi:13312
  19483. msgid "@var{urls} is the space-separated list of substitute server URLs to query. When this option is omitted, the default set of substitute servers is queried."
  19484. msgstr ""
  19485. #. type: table
  19486. #: guix-git/doc/guix.texi:13318
  19487. msgid "Query substitutes for @var{system}---e.g., @code{aarch64-linux}. This option can be repeated, in which case @command{guix weather} will query substitutes for several system types."
  19488. msgstr ""
  19489. #. type: table
  19490. #: guix-git/doc/guix.texi:13324
  19491. msgid "Instead of querying substitutes for all the packages, only ask for those specified in @var{file}. @var{file} must contain a @dfn{manifest}, as with the @code{-m} option of @command{guix package} (@pxref{Invoking guix package})."
  19492. msgstr ""
  19493. #. type: table
  19494. #: guix-git/doc/guix.texi:13327
  19495. msgid "This option can be repeated several times, in which case the manifests are concatenated."
  19496. msgstr ""
  19497. #. type: item
  19498. #: guix-git/doc/guix.texi:13328
  19499. #, no-wrap
  19500. msgid "--coverage[=@var{count}]"
  19501. msgstr ""
  19502. #. type: itemx
  19503. #: guix-git/doc/guix.texi:13329
  19504. #, no-wrap
  19505. msgid "-c [@var{count}]"
  19506. msgstr ""
  19507. #. type: table
  19508. #: guix-git/doc/guix.texi:13335
  19509. msgid "Report on substitute coverage for packages: list packages with at least @var{count} dependents (zero by default) for which substitutes are unavailable. Dependent packages themselves are not listed: if @var{b} depends on @var{a} and @var{a} has no substitutes, only @var{a} is listed, even though @var{b} usually lacks substitutes as well. The result looks like this:"
  19510. msgstr ""
  19511. #. type: example
  19512. #: guix-git/doc/guix.texi:13349
  19513. #, no-wrap
  19514. msgid ""
  19515. "$ guix weather --substitute-urls=@value{SUBSTITUTE-URLS} -c 10\n"
  19516. "computing 8,983 package derivations for x86_64-linux...\n"
  19517. "looking for 9,343 store items on @value{SUBSTITUTE-URLS}...\n"
  19518. "updating substitutes from '@value{SUBSTITUTE-URLS}'... 100.0%\n"
  19519. "@value{SUBSTITUTE-URLS}\n"
  19520. " 64.7% substitutes available (6,047 out of 9,343)\n"
  19521. "@dots{}\n"
  19522. "2502 packages are missing from '@value{SUBSTITUTE-URLS}' for 'x86_64-linux', among which:\n"
  19523. " 58 kcoreaddons@@5.49.0 /gnu/store/@dots{}-kcoreaddons-5.49.0\n"
  19524. " 46 qgpgme@@1.11.1 /gnu/store/@dots{}-qgpgme-1.11.1\n"
  19525. " 37 perl-http-cookiejar@@0.008 /gnu/store/@dots{}-perl-http-cookiejar-0.008\n"
  19526. " @dots{}\n"
  19527. msgstr ""
  19528. #. type: table
  19529. #: guix-git/doc/guix.texi:13355
  19530. msgid "What this example shows is that @code{kcoreaddons} and presumably the 58 packages that depend on it have no substitutes at @code{@value{SUBSTITUTE-SERVER-1}}; likewise for @code{qgpgme} and the 46 packages that depend on it."
  19531. msgstr ""
  19532. #. type: table
  19533. #: guix-git/doc/guix.texi:13359
  19534. msgid "If you are a Guix developer, or if you are taking care of this build farm, you'll probably want to have a closer look at these packages: they may simply fail to build."
  19535. msgstr ""
  19536. #. type: item
  19537. #: guix-git/doc/guix.texi:13360
  19538. #, no-wrap
  19539. msgid "--display-missing"
  19540. msgstr ""
  19541. #. type: table
  19542. #: guix-git/doc/guix.texi:13362
  19543. msgid "Display the list of store items for which substitutes are missing."
  19544. msgstr ""
  19545. #. type: section
  19546. #: guix-git/doc/guix.texi:13365
  19547. #, no-wrap
  19548. msgid "Invoking @command{guix processes}"
  19549. msgstr ""
  19550. #. type: Plain text
  19551. #: guix-git/doc/guix.texi:13373
  19552. msgid "The @command{guix processes} command can be useful to developers and system administrators, especially on multi-user machines and on build farms: it lists the current sessions (connections to the daemon), as well as information about the processes involved@footnote{Remote sessions, when @command{guix-daemon} is started with @option{--listen} specifying a TCP endpoint, are @emph{not} listed.}. Here's an example of the information it returns:"
  19553. msgstr ""
  19554. #. type: example
  19555. #: guix-git/doc/guix.texi:13379
  19556. #, no-wrap
  19557. msgid ""
  19558. "$ sudo guix processes\n"
  19559. "SessionPID: 19002\n"
  19560. "ClientPID: 19090\n"
  19561. "ClientCommand: guix environment --ad-hoc python\n"
  19562. "\n"
  19563. msgstr ""
  19564. #. type: example
  19565. #: guix-git/doc/guix.texi:13383
  19566. #, no-wrap
  19567. msgid ""
  19568. "SessionPID: 19402\n"
  19569. "ClientPID: 19367\n"
  19570. "ClientCommand: guix publish -u guix-publish -p 3000 -C 9 @dots{}\n"
  19571. "\n"
  19572. msgstr ""
  19573. #. type: example
  19574. #: guix-git/doc/guix.texi:13396
  19575. #, no-wrap
  19576. msgid ""
  19577. "SessionPID: 19444\n"
  19578. "ClientPID: 19419\n"
  19579. "ClientCommand: cuirass --cache-directory /var/cache/cuirass @dots{}\n"
  19580. "LockHeld: /gnu/store/@dots{}-perl-ipc-cmd-0.96.lock\n"
  19581. "LockHeld: /gnu/store/@dots{}-python-six-bootstrap-1.11.0.lock\n"
  19582. "LockHeld: /gnu/store/@dots{}-libjpeg-turbo-2.0.0.lock\n"
  19583. "ChildPID: 20495\n"
  19584. "ChildCommand: guix offload x86_64-linux 7200 1 28800\n"
  19585. "ChildPID: 27733\n"
  19586. "ChildCommand: guix offload x86_64-linux 7200 1 28800\n"
  19587. "ChildPID: 27793\n"
  19588. "ChildCommand: guix offload x86_64-linux 7200 1 28800\n"
  19589. msgstr ""
  19590. #. type: Plain text
  19591. #: guix-git/doc/guix.texi:13403
  19592. msgid "In this example we see that @command{guix-daemon} has three clients: @command{guix environment}, @command{guix publish}, and the Cuirass continuous integration tool; their process identifier (PID) is given by the @code{ClientPID} field. The @code{SessionPID} field gives the PID of the @command{guix-daemon} sub-process of this particular session."
  19593. msgstr ""
  19594. #. type: Plain text
  19595. #: guix-git/doc/guix.texi:13410
  19596. msgid "The @code{LockHeld} fields show which store items are currently locked by this session, which corresponds to store items being built or substituted (the @code{LockHeld} field is not displayed when @command{guix processes} is not running as root). Last, by looking at the @code{ChildPID} and @code{ChildCommand} fields, we understand that these three builds are being offloaded (@pxref{Daemon Offload Setup})."
  19597. msgstr ""
  19598. #. type: Plain text
  19599. #: guix-git/doc/guix.texi:13415
  19600. msgid "The output is in Recutils format so we can use the handy @command{recsel} command to select sessions of interest (@pxref{Selection Expressions,,, recutils, GNU recutils manual}). As an example, the command shows the command line and PID of the client that triggered the build of a Perl package:"
  19601. msgstr ""
  19602. #. type: example
  19603. #: guix-git/doc/guix.texi:13421
  19604. #, no-wrap
  19605. msgid ""
  19606. "$ sudo guix processes | \\\n"
  19607. " recsel -p ClientPID,ClientCommand -e 'LockHeld ~ \"perl\"'\n"
  19608. "ClientPID: 19419\n"
  19609. "ClientCommand: cuirass --cache-directory /var/cache/cuirass @dots{}\n"
  19610. msgstr ""
  19611. #. type: Plain text
  19612. #: guix-git/doc/guix.texi:13424
  19613. msgid "Additional options are listed below."
  19614. msgstr ""
  19615. #. type: table
  19616. #: guix-git/doc/guix.texi:13434
  19617. msgid "The default option. It outputs a set of Session recutils records that include each @code{ChildProcess} as a field."
  19618. msgstr ""
  19619. #. type: item
  19620. #: guix-git/doc/guix.texi:13435
  19621. #, no-wrap
  19622. msgid "normalized"
  19623. msgstr ""
  19624. #. type: table
  19625. #: guix-git/doc/guix.texi:13442
  19626. msgid "Normalize the output records into record sets (@pxref{Record Sets,,, recutils, GNU recutils manual}). Normalizing into record sets allows joins across record types. The example below lists the PID of each @code{ChildProcess} and the associated PID for @code{Session} that spawned the @code{ChildProcess} where the @code{Session} was started using @command{guix build}."
  19627. msgstr ""
  19628. #. type: example
  19629. #: guix-git/doc/guix.texi:13452
  19630. #, no-wrap
  19631. msgid ""
  19632. "$ guix processes --format=normalized | \\\n"
  19633. " recsel \\\n"
  19634. " -j Session \\\n"
  19635. " -t ChildProcess \\\n"
  19636. " -p Session.PID,PID \\\n"
  19637. " -e 'Session.ClientCommand ~ \"guix build\"'\n"
  19638. "PID: 4435\n"
  19639. "Session_PID: 4278\n"
  19640. "\n"
  19641. msgstr ""
  19642. #. type: example
  19643. #: guix-git/doc/guix.texi:13455
  19644. #, no-wrap
  19645. msgid ""
  19646. "PID: 4554\n"
  19647. "Session_PID: 4278\n"
  19648. "\n"
  19649. msgstr ""
  19650. #. type: example
  19651. #: guix-git/doc/guix.texi:13458
  19652. #, no-wrap
  19653. msgid ""
  19654. "PID: 4646\n"
  19655. "Session_PID: 4278\n"
  19656. msgstr ""
  19657. #. type: cindex
  19658. #: guix-git/doc/guix.texi:13465
  19659. #, no-wrap
  19660. msgid "system configuration"
  19661. msgstr ""
  19662. #. type: Plain text
  19663. #: guix-git/doc/guix.texi:13471
  19664. msgid "Guix System supports a consistent whole-system configuration mechanism. By that we mean that all aspects of the global system configuration---such as the available system services, timezone and locale settings, user accounts---are declared in a single place. Such a @dfn{system configuration} can be @dfn{instantiated}---i.e., effected."
  19665. msgstr ""
  19666. #. type: Plain text
  19667. #: guix-git/doc/guix.texi:13481
  19668. msgid "One of the advantages of putting all the system configuration under the control of Guix is that it supports transactional system upgrades, and makes it possible to roll back to a previous system instantiation, should something go wrong with the new one (@pxref{Features}). Another advantage is that it makes it easy to replicate the exact same configuration across different machines, or at different points in time, without having to resort to additional administration tools layered on top of the own tools of the system."
  19669. msgstr ""
  19670. #. type: Plain text
  19671. #: guix-git/doc/guix.texi:13486
  19672. msgid "This section describes this mechanism. First we focus on the system administrator's viewpoint---explaining how the system is configured and instantiated. Then we show how this mechanism can be extended, for instance to support new system services."
  19673. msgstr ""
  19674. #. type: Plain text
  19675. #: guix-git/doc/guix.texi:13515
  19676. msgid "The operating system is configured by providing an @code{operating-system} declaration in a file that can then be passed to the @command{guix system} command (@pxref{Invoking guix system}). A simple setup, with the default system services, the default Linux-Libre kernel, initial RAM disk, and boot loader looks like this:"
  19677. msgstr ""
  19678. #. type: code{#1}
  19679. #: guix-git/doc/guix.texi:13516 guix-git/doc/guix.texi:34145
  19680. #, no-wrap
  19681. msgid "operating-system"
  19682. msgstr ""
  19683. #. type: include
  19684. #: guix-git/doc/guix.texi:13518
  19685. #, no-wrap
  19686. msgid "os-config-bare-bones.texi"
  19687. msgstr ""
  19688. #. type: Plain text
  19689. #: guix-git/doc/guix.texi:13525
  19690. msgid "This example should be self-describing. Some of the fields defined above, such as @code{host-name} and @code{bootloader}, are mandatory. Others, such as @code{packages} and @code{services}, can be omitted, in which case they get a default value."
  19691. msgstr ""
  19692. #. type: Plain text
  19693. #: guix-git/doc/guix.texi:13530
  19694. msgid "Below we discuss the effect of some of the most important fields (@pxref{operating-system Reference}, for details about all the available fields), and how to @dfn{instantiate} the operating system using @command{guix system}."
  19695. msgstr ""
  19696. #. type: unnumberedsubsec
  19697. #: guix-git/doc/guix.texi:13531
  19698. #, no-wrap
  19699. msgid "Bootloader"
  19700. msgstr ""
  19701. #. type: cindex
  19702. #: guix-git/doc/guix.texi:13533
  19703. #, no-wrap
  19704. msgid "legacy boot, on Intel machines"
  19705. msgstr ""
  19706. #. type: cindex
  19707. #: guix-git/doc/guix.texi:13534
  19708. #, no-wrap
  19709. msgid "BIOS boot, on Intel machines"
  19710. msgstr ""
  19711. #. type: cindex
  19712. #: guix-git/doc/guix.texi:13535
  19713. #, no-wrap
  19714. msgid "UEFI boot"
  19715. msgstr ""
  19716. #. type: cindex
  19717. #: guix-git/doc/guix.texi:13536
  19718. #, no-wrap
  19719. msgid "EFI boot"
  19720. msgstr ""
  19721. #. type: Plain text
  19722. #: guix-git/doc/guix.texi:13542
  19723. msgid "The @code{bootloader} field describes the method that will be used to boot your system. Machines based on Intel processors can boot in ``legacy'' BIOS mode, as in the example above. However, more recent machines rely instead on the @dfn{Unified Extensible Firmware Interface} (UEFI) to boot. In that case, the @code{bootloader} field should contain something along these lines:"
  19724. msgstr ""
  19725. #. type: lisp
  19726. #: guix-git/doc/guix.texi:13547
  19727. #, no-wrap
  19728. msgid ""
  19729. "(bootloader-configuration\n"
  19730. " (bootloader grub-efi-bootloader)\n"
  19731. " (target \"/boot/efi\"))\n"
  19732. msgstr ""
  19733. #. type: Plain text
  19734. #: guix-git/doc/guix.texi:13551
  19735. msgid "@xref{Bootloader Configuration}, for more information on the available configuration options."
  19736. msgstr ""
  19737. #. type: unnumberedsubsec
  19738. #: guix-git/doc/guix.texi:13552
  19739. #, no-wrap
  19740. msgid "Globally-Visible Packages"
  19741. msgstr ""
  19742. #. type: vindex
  19743. #: guix-git/doc/guix.texi:13554
  19744. #, no-wrap
  19745. msgid "%base-packages"
  19746. msgstr ""
  19747. #. type: Plain text
  19748. #: guix-git/doc/guix.texi:13567
  19749. msgid "The @code{packages} field lists packages that will be globally visible on the system, for all user accounts---i.e., in every user's @env{PATH} environment variable---in addition to the per-user profiles (@pxref{Invoking guix package}). The @code{%base-packages} variable provides all the tools one would expect for basic user and administrator tasks---including the GNU Core Utilities, the GNU Networking Utilities, the @command{mg} lightweight text editor, @command{find}, @command{grep}, etc. The example above adds GNU@tie{}Screen to those, taken from the @code{(gnu packages screen)} module (@pxref{Package Modules}). The @code{(list package output)} syntax can be used to add a specific output of a package:"
  19750. msgstr ""
  19751. #. type: lisp
  19752. #: guix-git/doc/guix.texi:13571
  19753. #, no-wrap
  19754. msgid ""
  19755. "(use-modules (gnu packages))\n"
  19756. "(use-modules (gnu packages dns))\n"
  19757. "\n"
  19758. msgstr ""
  19759. #. type: lisp
  19760. #: guix-git/doc/guix.texi:13576
  19761. #, no-wrap
  19762. msgid ""
  19763. "(operating-system\n"
  19764. " ;; ...\n"
  19765. " (packages (cons (list isc-bind \"utils\")\n"
  19766. " %base-packages)))\n"
  19767. msgstr ""
  19768. #. type: findex
  19769. #: guix-git/doc/guix.texi:13578
  19770. #, no-wrap
  19771. msgid "specification->package"
  19772. msgstr ""
  19773. #. type: Plain text
  19774. #: guix-git/doc/guix.texi:13587
  19775. msgid "Referring to packages by variable name, like @code{isc-bind} above, has the advantage of being unambiguous; it also allows typos and such to be diagnosed right away as ``unbound variables''. The downside is that one needs to know which module defines which package, and to augment the @code{use-package-modules} line accordingly. To avoid that, one can use the @code{specification->package} procedure of the @code{(gnu packages)} module, which returns the best package for a given name or name and version:"
  19776. msgstr ""
  19777. #. type: lisp
  19778. #: guix-git/doc/guix.texi:13590
  19779. #, no-wrap
  19780. msgid ""
  19781. "(use-modules (gnu packages))\n"
  19782. "\n"
  19783. msgstr ""
  19784. #. type: lisp
  19785. #: guix-git/doc/guix.texi:13596
  19786. #, no-wrap
  19787. msgid ""
  19788. "(operating-system\n"
  19789. " ;; ...\n"
  19790. " (packages (append (map specification->package\n"
  19791. " '(\"tcpdump\" \"htop\" \"gnupg@@2.0\"))\n"
  19792. " %base-packages)))\n"
  19793. msgstr ""
  19794. #. type: unnumberedsubsec
  19795. #: guix-git/doc/guix.texi:13598
  19796. #, no-wrap
  19797. msgid "System Services"
  19798. msgstr ""
  19799. #. type: cindex
  19800. #: guix-git/doc/guix.texi:13600 guix-git/doc/guix.texi:32928
  19801. #: guix-git/doc/guix.texi:34374
  19802. #, no-wrap
  19803. msgid "services"
  19804. msgstr ""
  19805. #. type: vindex
  19806. #: guix-git/doc/guix.texi:13601
  19807. #, no-wrap
  19808. msgid "%base-services"
  19809. msgstr ""
  19810. #. type: Plain text
  19811. #: guix-git/doc/guix.texi:13611
  19812. msgid "The @code{services} field lists @dfn{system services} to be made available when the system starts (@pxref{Services}). The @code{operating-system} declaration above specifies that, in addition to the basic services, we want the OpenSSH secure shell daemon listening on port 2222 (@pxref{Networking Services, @code{openssh-service-type}}). Under the hood, @code{openssh-service-type} arranges so that @command{sshd} is started with the right command-line options, possibly with supporting configuration files generated as needed (@pxref{Defining Services})."
  19813. msgstr ""
  19814. #. type: cindex
  19815. #: guix-git/doc/guix.texi:13612
  19816. #, no-wrap
  19817. msgid "customization, of services"
  19818. msgstr ""
  19819. #. type: findex
  19820. #: guix-git/doc/guix.texi:13613
  19821. #, no-wrap
  19822. msgid "modify-services"
  19823. msgstr ""
  19824. #. type: Plain text
  19825. #: guix-git/doc/guix.texi:13617
  19826. msgid "Occasionally, instead of using the base services as is, you will want to customize them. To do this, use @code{modify-services} (@pxref{Service Reference, @code{modify-services}}) to modify the list."
  19827. msgstr ""
  19828. #. type: anchor{#1}
  19829. #: guix-git/doc/guix.texi:13623
  19830. msgid "auto-login to TTY"
  19831. msgstr ""
  19832. #. type: Plain text
  19833. #: guix-git/doc/guix.texi:13623
  19834. msgid "For example, suppose you want to modify @code{guix-daemon} and Mingetty (the console log-in) in the @code{%base-services} list (@pxref{Base Services, @code{%base-services}}). To do that, you can write the following in your operating system declaration:"
  19835. msgstr ""
  19836. #. type: lisp
  19837. #: guix-git/doc/guix.texi:13640
  19838. #, no-wrap
  19839. msgid ""
  19840. "(define %my-services\n"
  19841. " ;; My very own list of services.\n"
  19842. " (modify-services %base-services\n"
  19843. " (guix-service-type config =>\n"
  19844. " (guix-configuration\n"
  19845. " (inherit config)\n"
  19846. " ;; Fetch substitutes from example.org.\n"
  19847. " (substitute-urls\n"
  19848. " (list \"https://example.org/guix\"\n"
  19849. " \"https://ci.guix.gnu.org\"))))\n"
  19850. " (mingetty-service-type config =>\n"
  19851. " (mingetty-configuration\n"
  19852. " (inherit config)\n"
  19853. " ;; Automatially log in as \"guest\".\n"
  19854. " (auto-login \"guest\")))))\n"
  19855. "\n"
  19856. msgstr ""
  19857. #. type: lisp
  19858. #: guix-git/doc/guix.texi:13644
  19859. #, no-wrap
  19860. msgid ""
  19861. "(operating-system\n"
  19862. " ;; @dots{}\n"
  19863. " (services %my-services))\n"
  19864. msgstr ""
  19865. #. type: Plain text
  19866. #: guix-git/doc/guix.texi:13657
  19867. msgid "This changes the configuration---i.e., the service parameters---of the @code{guix-service-type} instance, and that of all the @code{mingetty-service-type} instances in the @code{%base-services} list (@pxref{Auto-Login to a Specific TTY, see the cookbook for how to auto-login one user to a specific TTY,, guix-cookbook, GNU Guix Cookbook})). Observe how this is accomplished: first, we arrange for the original configuration to be bound to the identifier @code{config} in the @var{body}, and then we write the @var{body} so that it evaluates to the desired configuration. In particular, notice how we use @code{inherit} to create a new configuration which has the same values as the old configuration, but with a few modifications."
  19868. msgstr ""
  19869. #. type: Plain text
  19870. #: guix-git/doc/guix.texi:13664
  19871. msgid "The configuration for a typical ``desktop'' usage, with an encrypted root partition, the X11 display server, GNOME and Xfce (users can choose which of these desktop environments to use at the log-in screen by pressing @kbd{F1}), network management, power management, and more, would look like this:"
  19872. msgstr ""
  19873. #. type: include
  19874. #: guix-git/doc/guix.texi:13666
  19875. #, no-wrap
  19876. msgid "os-config-desktop.texi"
  19877. msgstr ""
  19878. #. type: Plain text
  19879. #: guix-git/doc/guix.texi:13671
  19880. msgid "A graphical system with a choice of lightweight window managers instead of full-blown desktop environments would look like this:"
  19881. msgstr ""
  19882. #. type: include
  19883. #: guix-git/doc/guix.texi:13673
  19884. #, no-wrap
  19885. msgid "os-config-lightweight-desktop.texi"
  19886. msgstr ""
  19887. #. type: Plain text
  19888. #: guix-git/doc/guix.texi:13679
  19889. msgid "This example refers to the @file{/boot/efi} file system by its UUID, @code{1234-ABCD}. Replace this UUID with the right UUID on your system, as returned by the @command{blkid} command."
  19890. msgstr ""
  19891. #. type: Plain text
  19892. #: guix-git/doc/guix.texi:13683
  19893. msgid "@xref{Desktop Services}, for the exact list of services provided by @code{%desktop-services}. @xref{X.509 Certificates}, for background information about the @code{nss-certs} package that is used here."
  19894. msgstr ""
  19895. #. type: Plain text
  19896. #: guix-git/doc/guix.texi:13690
  19897. msgid "Again, @code{%desktop-services} is just a list of service objects. If you want to remove services from there, you can do so using the procedures for list filtering (@pxref{SRFI-1 Filtering and Partitioning,,, guile, GNU Guile Reference Manual}). For instance, the following expression returns a list that contains all the services in @code{%desktop-services} minus the Avahi service:"
  19898. msgstr ""
  19899. #. type: lisp
  19900. #: guix-git/doc/guix.texi:13695
  19901. #, no-wrap
  19902. msgid ""
  19903. "(remove (lambda (service)\n"
  19904. " (eq? (service-kind service) avahi-service-type))\n"
  19905. " %desktop-services)\n"
  19906. msgstr ""
  19907. #. type: Plain text
  19908. #: guix-git/doc/guix.texi:13698
  19909. msgid "Alternatively, the @code{modify-services} macro can be used:"
  19910. msgstr ""
  19911. #. type: lisp
  19912. #: guix-git/doc/guix.texi:13702
  19913. #, no-wrap
  19914. msgid ""
  19915. "(modify-services %desktop-services\n"
  19916. " (delete avahi-service-type))\n"
  19917. msgstr ""
  19918. #. type: unnumberedsubsec
  19919. #: guix-git/doc/guix.texi:13705
  19920. #, no-wrap
  19921. msgid "Instantiating the System"
  19922. msgstr ""
  19923. #. type: Plain text
  19924. #: guix-git/doc/guix.texi:13712
  19925. msgid "Assuming the @code{operating-system} declaration is stored in the @file{my-system-config.scm} file, the @command{guix system reconfigure my-system-config.scm} command instantiates that configuration, and makes it the default GRUB boot entry (@pxref{Invoking guix system})."
  19926. msgstr ""
  19927. #. type: Plain text
  19928. #: guix-git/doc/guix.texi:13720
  19929. msgid "The normal way to change the system configuration is by updating this file and re-running @command{guix system reconfigure}. One should never have to touch files in @file{/etc} or to run commands that modify the system state such as @command{useradd} or @command{grub-install}. In fact, you must avoid that since that would not only void your warranty but also prevent you from rolling back to previous versions of your system, should you ever need to."
  19930. msgstr ""
  19931. #. type: cindex
  19932. #: guix-git/doc/guix.texi:13721
  19933. #, no-wrap
  19934. msgid "roll-back, of the operating system"
  19935. msgstr ""
  19936. #. type: Plain text
  19937. #: guix-git/doc/guix.texi:13731
  19938. msgid "Speaking of roll-back, each time you run @command{guix system reconfigure}, a new @dfn{generation} of the system is created---without modifying or deleting previous generations. Old system generations get an entry in the bootloader boot menu, allowing you to boot them in case something went wrong with the latest generation. Reassuring, no? The @command{guix system list-generations} command lists the system generations available on disk. It is also possible to roll back the system via the commands @command{guix system roll-back} and @command{guix system switch-generation}."
  19939. msgstr ""
  19940. #. type: Plain text
  19941. #: guix-git/doc/guix.texi:13737
  19942. msgid "Although the @command{guix system reconfigure} command will not modify previous generations, you must take care when the current generation is not the latest (e.g., after invoking @command{guix system roll-back}), since the operation might overwrite a later generation (@pxref{Invoking guix system})."
  19943. msgstr ""
  19944. #. type: unnumberedsubsec
  19945. #: guix-git/doc/guix.texi:13738
  19946. #, no-wrap
  19947. msgid "The Programming Interface"
  19948. msgstr ""
  19949. #. type: Plain text
  19950. #: guix-git/doc/guix.texi:13743
  19951. msgid "At the Scheme level, the bulk of an @code{operating-system} declaration is instantiated with the following monadic procedure (@pxref{The Store Monad}):"
  19952. msgstr ""
  19953. #. type: deffn
  19954. #: guix-git/doc/guix.texi:13744
  19955. #, no-wrap
  19956. msgid "{Monadic Procedure} operating-system-derivation os"
  19957. msgstr ""
  19958. #. type: deffn
  19959. #: guix-git/doc/guix.texi:13747
  19960. msgid "Return a derivation that builds @var{os}, an @code{operating-system} object (@pxref{Derivations})."
  19961. msgstr ""
  19962. #. type: deffn
  19963. #: guix-git/doc/guix.texi:13751
  19964. msgid "The output of the derivation is a single directory that refers to all the packages, configuration files, and other supporting files needed to instantiate @var{os}."
  19965. msgstr ""
  19966. #. type: Plain text
  19967. #: guix-git/doc/guix.texi:13756
  19968. msgid "This procedure is provided by the @code{(gnu system)} module. Along with @code{(gnu services)} (@pxref{Services}), this module contains the guts of Guix System. Make sure to visit it!"
  19969. msgstr ""
  19970. #. type: section
  19971. #: guix-git/doc/guix.texi:13759
  19972. #, no-wrap
  19973. msgid "@code{operating-system} Reference"
  19974. msgstr ""
  19975. #. type: Plain text
  19976. #: guix-git/doc/guix.texi:13764
  19977. msgid "This section summarizes all the options available in @code{operating-system} declarations (@pxref{Using the Configuration System})."
  19978. msgstr ""
  19979. #. type: deftp
  19980. #: guix-git/doc/guix.texi:13765
  19981. #, no-wrap
  19982. msgid "{Data Type} operating-system"
  19983. msgstr ""
  19984. #. type: deftp
  19985. #: guix-git/doc/guix.texi:13769
  19986. msgid "This is the data type representing an operating system configuration. By that, we mean all the global system configuration, not per-user configuration (@pxref{Using the Configuration System})."
  19987. msgstr ""
  19988. #. type: item
  19989. #: guix-git/doc/guix.texi:13771
  19990. #, no-wrap
  19991. msgid "@code{kernel} (default: @code{linux-libre})"
  19992. msgstr ""
  19993. #. type: table
  19994. #: guix-git/doc/guix.texi:13776
  19995. msgid "The package object of the operating system kernel to use@footnote{Currently only the Linux-libre kernel is fully supported. Using GNU@tie{}mach with the GNU@tie{}Hurd is experimental and only available when building a virtual machine disk image.}."
  19996. msgstr ""
  19997. #. type: code{#1}
  19998. #: guix-git/doc/guix.texi:13777 guix-git/doc/guix.texi:29519
  19999. #, no-wrap
  20000. msgid "hurd"
  20001. msgstr ""
  20002. #. type: item
  20003. #: guix-git/doc/guix.texi:13778
  20004. #, no-wrap
  20005. msgid "@code{hurd} (default: @code{#f})"
  20006. msgstr ""
  20007. #. type: table
  20008. #: guix-git/doc/guix.texi:13783
  20009. msgid "The package object of the Hurd to be started by the kernel. When this field is set, produce a GNU/Hurd operating system. In that case, @code{kernel} must also be set to the @code{gnumach} package---the microkernel the Hurd runs on."
  20010. msgstr ""
  20011. #. type: quotation
  20012. #: guix-git/doc/guix.texi:13786
  20013. msgid "This feature is experimental and only supported for disk images."
  20014. msgstr ""
  20015. #. type: item
  20016. #: guix-git/doc/guix.texi:13788
  20017. #, no-wrap
  20018. msgid "@code{kernel-loadable-modules} (default: '())"
  20019. msgstr ""
  20020. #. type: table
  20021. #: guix-git/doc/guix.texi:13791
  20022. msgid "A list of objects (usually packages) to collect loadable kernel modules from--e.g. @code{(list ddcci-driver-linux)}."
  20023. msgstr ""
  20024. #. type: item
  20025. #: guix-git/doc/guix.texi:13792
  20026. #, no-wrap
  20027. msgid "@code{kernel-arguments} (default: @code{%default-kernel-arguments})"
  20028. msgstr ""
  20029. #. type: table
  20030. #: guix-git/doc/guix.texi:13795
  20031. msgid "List of strings or gexps representing additional arguments to pass on the command-line of the kernel---e.g., @code{(\"console=ttyS0\")}."
  20032. msgstr ""
  20033. #. type: code{#1}
  20034. #: guix-git/doc/guix.texi:13796 guix-git/doc/guix.texi:33141
  20035. #: guix-git/doc/guix.texi:33160
  20036. #, no-wrap
  20037. msgid "bootloader"
  20038. msgstr ""
  20039. #. type: table
  20040. #: guix-git/doc/guix.texi:13798
  20041. msgid "The system bootloader configuration object. @xref{Bootloader Configuration}."
  20042. msgstr ""
  20043. #. type: code{#1}
  20044. #: guix-git/doc/guix.texi:13799 guix-git/doc/guix.texi:33330
  20045. #, no-wrap
  20046. msgid "label"
  20047. msgstr ""
  20048. #. type: table
  20049. #: guix-git/doc/guix.texi:13802
  20050. msgid "This is the label (a string) as it appears in the bootloader's menu entry. The default label includes the kernel name and version."
  20051. msgstr ""
  20052. #. type: item
  20053. #: guix-git/doc/guix.texi:13803 guix-git/doc/guix.texi:15393
  20054. #: guix-git/doc/guix.texi:18353 guix-git/doc/guix.texi:33260
  20055. #, no-wrap
  20056. msgid "@code{keyboard-layout} (default: @code{#f})"
  20057. msgstr ""
  20058. #. type: table
  20059. #: guix-git/doc/guix.texi:13808
  20060. msgid "This field specifies the keyboard layout to use in the console. It can be either @code{#f}, in which case the default keyboard layout is used (usually US English), or a @code{<keyboard-layout>} record. @xref{Keyboard Layout}, for more information."
  20061. msgstr ""
  20062. #. type: table
  20063. #: guix-git/doc/guix.texi:13813
  20064. msgid "This keyboard layout is in effect as soon as the kernel has booted. For instance, it is the keyboard layout in effect when you type a passphrase if your root file system is on a @code{luks-device-mapping} mapped device (@pxref{Mapped Devices})."
  20065. msgstr ""
  20066. #. type: quotation
  20067. #: guix-git/doc/guix.texi:13820
  20068. msgid "This does @emph{not} specify the keyboard layout used by the bootloader, nor that used by the graphical display server. @xref{Bootloader Configuration}, for information on how to specify the bootloader's keyboard layout. @xref{X Window}, for information on how to specify the keyboard layout used by the X Window System."
  20069. msgstr ""
  20070. #. type: item
  20071. #: guix-git/doc/guix.texi:13822
  20072. #, no-wrap
  20073. msgid "@code{initrd-modules} (default: @code{%base-initrd-modules})"
  20074. msgstr ""
  20075. #. type: cindex
  20076. #: guix-git/doc/guix.texi:13823 guix-git/doc/guix.texi:32965
  20077. #: guix-git/doc/guix.texi:33069
  20078. #, no-wrap
  20079. msgid "initrd"
  20080. msgstr ""
  20081. #. type: cindex
  20082. #: guix-git/doc/guix.texi:13824 guix-git/doc/guix.texi:32966
  20083. #: guix-git/doc/guix.texi:33070
  20084. #, no-wrap
  20085. msgid "initial RAM disk"
  20086. msgstr ""
  20087. #. type: table
  20088. #: guix-git/doc/guix.texi:13827
  20089. msgid "The list of Linux kernel modules that need to be available in the initial RAM disk. @xref{Initial RAM Disk}."
  20090. msgstr ""
  20091. #. type: item
  20092. #: guix-git/doc/guix.texi:13828
  20093. #, no-wrap
  20094. msgid "@code{initrd} (default: @code{base-initrd})"
  20095. msgstr ""
  20096. #. type: table
  20097. #: guix-git/doc/guix.texi:13832
  20098. msgid "A procedure that returns an initial RAM disk for the Linux kernel. This field is provided to support low-level customization and should rarely be needed for casual use. @xref{Initial RAM Disk}."
  20099. msgstr ""
  20100. #. type: item
  20101. #: guix-git/doc/guix.texi:13833
  20102. #, no-wrap
  20103. msgid "@code{firmware} (default: @code{%base-firmware})"
  20104. msgstr ""
  20105. #. type: cindex
  20106. #: guix-git/doc/guix.texi:13834
  20107. #, no-wrap
  20108. msgid "firmware"
  20109. msgstr ""
  20110. #. type: table
  20111. #: guix-git/doc/guix.texi:13836
  20112. msgid "List of firmware packages loadable by the operating system kernel."
  20113. msgstr ""
  20114. #. type: table
  20115. #: guix-git/doc/guix.texi:13841
  20116. msgid "The default includes firmware needed for Atheros- and Broadcom-based WiFi devices (Linux-libre modules @code{ath9k} and @code{b43-open}, respectively). @xref{Hardware Considerations}, for more info on supported hardware."
  20117. msgstr ""
  20118. #. type: code{#1}
  20119. #: guix-git/doc/guix.texi:13842 guix-git/doc/guix.texi:34164
  20120. #, no-wrap
  20121. msgid "host-name"
  20122. msgstr ""
  20123. #. type: table
  20124. #: guix-git/doc/guix.texi:13844
  20125. msgid "The host name."
  20126. msgstr ""
  20127. #. type: code{#1}
  20128. #: guix-git/doc/guix.texi:13845
  20129. #, no-wrap
  20130. msgid "hosts-file"
  20131. msgstr ""
  20132. #. type: cindex
  20133. #: guix-git/doc/guix.texi:13846
  20134. #, no-wrap
  20135. msgid "hosts file"
  20136. msgstr ""
  20137. #. type: table
  20138. #: guix-git/doc/guix.texi:13851
  20139. msgid "A file-like object (@pxref{G-Expressions, file-like objects}) for use as @file{/etc/hosts} (@pxref{Host Names,,, libc, The GNU C Library Reference Manual}). The default is a file with entries for @code{localhost} and @var{host-name}."
  20140. msgstr ""
  20141. #. type: item
  20142. #: guix-git/doc/guix.texi:13852
  20143. #, no-wrap
  20144. msgid "@code{mapped-devices} (default: @code{'()})"
  20145. msgstr ""
  20146. #. type: table
  20147. #: guix-git/doc/guix.texi:13854
  20148. msgid "A list of mapped devices. @xref{Mapped Devices}."
  20149. msgstr ""
  20150. #. type: code{#1}
  20151. #: guix-git/doc/guix.texi:13855
  20152. #, no-wrap
  20153. msgid "file-systems"
  20154. msgstr ""
  20155. #. type: table
  20156. #: guix-git/doc/guix.texi:13857
  20157. msgid "A list of file systems. @xref{File Systems}."
  20158. msgstr ""
  20159. #. type: cindex
  20160. #: guix-git/doc/guix.texi:13858
  20161. #, no-wrap
  20162. msgid "swap devices"
  20163. msgstr ""
  20164. #. type: cindex
  20165. #: guix-git/doc/guix.texi:13859
  20166. #, no-wrap
  20167. msgid "swap space"
  20168. msgstr ""
  20169. #. type: item
  20170. #: guix-git/doc/guix.texi:13860
  20171. #, no-wrap
  20172. msgid "@code{swap-devices} (default: @code{'()})"
  20173. msgstr ""
  20174. #. type: table
  20175. #: guix-git/doc/guix.texi:13865
  20176. msgid "A list of UUIDs, file system labels, or strings identifying devices or files to be used for ``swap space'' (@pxref{Memory Concepts,,, libc, The GNU C Library Reference Manual}). Here are some examples:"
  20177. msgstr ""
  20178. #. type: item
  20179. #: guix-git/doc/guix.texi:13867
  20180. #, no-wrap
  20181. msgid "(list (uuid \"4dab5feb-d176-45de-b287-9b0a6e4c01cb\"))"
  20182. msgstr ""
  20183. #. type: table
  20184. #: guix-git/doc/guix.texi:13871
  20185. msgid "Use the swap partition with the given UUID@. You can learn the UUID of a Linux swap partition by running @command{swaplabel @var{device}}, where @var{device} is the @file{/dev} file name of that partition."
  20186. msgstr ""
  20187. #. type: item
  20188. #: guix-git/doc/guix.texi:13872
  20189. #, no-wrap
  20190. msgid "(list (file-system-label \"swap\"))"
  20191. msgstr ""
  20192. #. type: table
  20193. #: guix-git/doc/guix.texi:13876
  20194. msgid "Use the partition with label @code{swap}. Again, the @command{swaplabel} command allows you to view and change the label of a Linux swap partition."
  20195. msgstr ""
  20196. #. type: item
  20197. #: guix-git/doc/guix.texi:13877
  20198. #, no-wrap
  20199. msgid "(list \"/swapfile\")"
  20200. msgstr ""
  20201. #. type: table
  20202. #: guix-git/doc/guix.texi:13879
  20203. msgid "Use the file @file{/swapfile} as swap space."
  20204. msgstr ""
  20205. #. type: item
  20206. #: guix-git/doc/guix.texi:13880
  20207. #, no-wrap
  20208. msgid "(list \"/dev/sda3\" \"/dev/sdb2\")"
  20209. msgstr ""
  20210. #. type: table
  20211. #: guix-git/doc/guix.texi:13884
  20212. msgid "Use the @file{/dev/sda3} and @file{/dev/sdb2} partitions as swap space. We recommend referring to swap devices by UUIDs or labels as shown above instead."
  20213. msgstr ""
  20214. #. type: table
  20215. #: guix-git/doc/guix.texi:13890
  20216. msgid "It is possible to specify a swap file in a file system on a mapped device (under @file{/dev/mapper}), provided that the necessary device mapping and file system are also specified. @xref{Mapped Devices} and @ref{File Systems}."
  20217. msgstr ""
  20218. #. type: item
  20219. #: guix-git/doc/guix.texi:13891
  20220. #, no-wrap
  20221. msgid "@code{users} (default: @code{%base-user-accounts})"
  20222. msgstr ""
  20223. #. type: itemx
  20224. #: guix-git/doc/guix.texi:13892
  20225. #, no-wrap
  20226. msgid "@code{groups} (default: @code{%base-groups})"
  20227. msgstr ""
  20228. #. type: table
  20229. #: guix-git/doc/guix.texi:13894
  20230. msgid "List of user accounts and groups. @xref{User Accounts}."
  20231. msgstr ""
  20232. #. type: table
  20233. #: guix-git/doc/guix.texi:13897
  20234. msgid "If the @code{users} list lacks a user account with UID@tie{}0, a ``root'' account with UID@tie{}0 is automatically added."
  20235. msgstr ""
  20236. #. type: item
  20237. #: guix-git/doc/guix.texi:13898
  20238. #, no-wrap
  20239. msgid "@code{skeletons} (default: @code{(default-skeletons)})"
  20240. msgstr ""
  20241. #. type: table
  20242. #: guix-git/doc/guix.texi:13902
  20243. msgid "A list of target file name/file-like object tuples (@pxref{G-Expressions, file-like objects}). These are the skeleton files that will be added to the home directory of newly-created user accounts."
  20244. msgstr ""
  20245. #. type: table
  20246. #: guix-git/doc/guix.texi:13904
  20247. msgid "For instance, a valid value may look like this:"
  20248. msgstr ""
  20249. #. type: lisp
  20250. #: guix-git/doc/guix.texi:13910
  20251. #, no-wrap
  20252. msgid ""
  20253. "`((\".bashrc\" ,(plain-file \"bashrc\" \"echo Hello\\n\"))\n"
  20254. " (\".guile\" ,(plain-file \"guile\"\n"
  20255. " \"(use-modules (ice-9 readline))\n"
  20256. " (activate-readline)\")))\n"
  20257. msgstr ""
  20258. #. type: item
  20259. #: guix-git/doc/guix.texi:13912
  20260. #, no-wrap
  20261. msgid "@code{issue} (default: @code{%default-issue})"
  20262. msgstr ""
  20263. #. type: table
  20264. #: guix-git/doc/guix.texi:13915
  20265. msgid "A string denoting the contents of the @file{/etc/issue} file, which is displayed when users log in on a text console."
  20266. msgstr ""
  20267. #. type: item
  20268. #: guix-git/doc/guix.texi:13916
  20269. #, no-wrap
  20270. msgid "@code{packages} (default: @code{%base-packages})"
  20271. msgstr ""
  20272. #. type: table
  20273. #: guix-git/doc/guix.texi:13920
  20274. msgid "A list of packages to be installed in the global profile, which is accessible at @file{/run/current-system/profile}. Each element is either a package variable or a package/output tuple. Here's a simple example of both:"
  20275. msgstr ""
  20276. #. type: lisp
  20277. #: guix-git/doc/guix.texi:13925
  20278. #, no-wrap
  20279. msgid ""
  20280. "(cons* git ; the default \"out\" output\n"
  20281. " (list git \"send-email\") ; another output of git\n"
  20282. " %base-packages) ; the default set\n"
  20283. msgstr ""
  20284. #. type: table
  20285. #: guix-git/doc/guix.texi:13930
  20286. msgid "The default set includes core utilities and it is good practice to install non-core utilities in user profiles (@pxref{Invoking guix package})."
  20287. msgstr ""
  20288. #. type: code{#1}
  20289. #: guix-git/doc/guix.texi:13931
  20290. #, no-wrap
  20291. msgid "timezone"
  20292. msgstr ""
  20293. #. type: table
  20294. #: guix-git/doc/guix.texi:13933
  20295. msgid "A timezone identifying string---e.g., @code{\"Europe/Paris\"}."
  20296. msgstr ""
  20297. #. type: table
  20298. #: guix-git/doc/guix.texi:13937
  20299. msgid "You can run the @command{tzselect} command to find out which timezone string corresponds to your region. Choosing an invalid timezone name causes @command{guix system} to fail."
  20300. msgstr ""
  20301. #. type: item
  20302. #: guix-git/doc/guix.texi:13938 guix-git/doc/guix.texi:19958
  20303. #, no-wrap
  20304. msgid "@code{locale} (default: @code{\"en_US.utf8\"})"
  20305. msgstr ""
  20306. #. type: table
  20307. #: guix-git/doc/guix.texi:13941
  20308. msgid "The name of the default locale (@pxref{Locale Names,,, libc, The GNU C Library Reference Manual}). @xref{Locales}, for more information."
  20309. msgstr ""
  20310. #. type: item
  20311. #: guix-git/doc/guix.texi:13942
  20312. #, no-wrap
  20313. msgid "@code{locale-definitions} (default: @code{%default-locale-definitions})"
  20314. msgstr ""
  20315. #. type: table
  20316. #: guix-git/doc/guix.texi:13945
  20317. msgid "The list of locale definitions to be compiled and that may be used at run time. @xref{Locales}."
  20318. msgstr ""
  20319. #. type: item
  20320. #: guix-git/doc/guix.texi:13946
  20321. #, no-wrap
  20322. msgid "@code{locale-libcs} (default: @code{(list @var{glibc})})"
  20323. msgstr ""
  20324. #. type: table
  20325. #: guix-git/doc/guix.texi:13950
  20326. msgid "The list of GNU@tie{}libc packages whose locale data and tools are used to build the locale definitions. @xref{Locales}, for compatibility considerations that justify this option."
  20327. msgstr ""
  20328. #. type: item
  20329. #: guix-git/doc/guix.texi:13951
  20330. #, no-wrap
  20331. msgid "@code{name-service-switch} (default: @code{%default-nss})"
  20332. msgstr ""
  20333. #. type: table
  20334. #: guix-git/doc/guix.texi:13955
  20335. msgid "Configuration of the libc name service switch (NSS)---a @code{<name-service-switch>} object. @xref{Name Service Switch}, for details."
  20336. msgstr ""
  20337. #. type: item
  20338. #: guix-git/doc/guix.texi:13956
  20339. #, no-wrap
  20340. msgid "@code{services} (default: @code{%base-services})"
  20341. msgstr ""
  20342. #. type: table
  20343. #: guix-git/doc/guix.texi:13958
  20344. msgid "A list of service objects denoting system services. @xref{Services}."
  20345. msgstr ""
  20346. #. type: cindex
  20347. #: guix-git/doc/guix.texi:13959
  20348. #, no-wrap
  20349. msgid "essential services"
  20350. msgstr ""
  20351. #. type: item
  20352. #: guix-git/doc/guix.texi:13960
  20353. #, no-wrap
  20354. msgid "@code{essential-services} (default: ...)"
  20355. msgstr ""
  20356. #. type: table
  20357. #: guix-git/doc/guix.texi:13965
  20358. msgid "The list of ``essential services''---i.e., things like instances of @code{system-service-type} and @code{host-name-service-type} (@pxref{Service Reference}), which are derived from the operating system definition itself. As a user you should @emph{never} need to touch this field."
  20359. msgstr ""
  20360. #. type: item
  20361. #: guix-git/doc/guix.texi:13966
  20362. #, no-wrap
  20363. msgid "@code{pam-services} (default: @code{(base-pam-services)})"
  20364. msgstr ""
  20365. #. type: cindex
  20366. #: guix-git/doc/guix.texi:13967
  20367. #, no-wrap
  20368. msgid "PAM"
  20369. msgstr ""
  20370. #. type: cindex
  20371. #: guix-git/doc/guix.texi:13968
  20372. #, no-wrap
  20373. msgid "pluggable authentication modules"
  20374. msgstr ""
  20375. #. type: table
  20376. #: guix-git/doc/guix.texi:13971
  20377. msgid "Linux @dfn{pluggable authentication module} (PAM) services."
  20378. msgstr ""
  20379. #. type: item
  20380. #: guix-git/doc/guix.texi:13972
  20381. #, no-wrap
  20382. msgid "@code{setuid-programs} (default: @code{%setuid-programs})"
  20383. msgstr ""
  20384. #. type: table
  20385. #: guix-git/doc/guix.texi:13975
  20386. msgid "List of @code{<setuid-program>}. @xref{Setuid Programs}, for more information."
  20387. msgstr ""
  20388. #. type: item
  20389. #: guix-git/doc/guix.texi:13976
  20390. #, no-wrap
  20391. msgid "@code{sudoers-file} (default: @code{%sudoers-specification})"
  20392. msgstr ""
  20393. #. type: cindex
  20394. #: guix-git/doc/guix.texi:13977
  20395. #, no-wrap
  20396. msgid "sudoers file"
  20397. msgstr ""
  20398. #. type: table
  20399. #: guix-git/doc/guix.texi:13980
  20400. msgid "The contents of the @file{/etc/sudoers} file as a file-like object (@pxref{G-Expressions, @code{local-file} and @code{plain-file}})."
  20401. msgstr ""
  20402. #. type: table
  20403. #: guix-git/doc/guix.texi:13985
  20404. msgid "This file specifies which users can use the @command{sudo} command, what they are allowed to do, and what privileges they may gain. The default is that only @code{root} and members of the @code{wheel} group may use @code{sudo}."
  20405. msgstr ""
  20406. #. type: deffn
  20407. #: guix-git/doc/guix.texi:13988
  20408. #, no-wrap
  20409. msgid "{Scheme Syntax} this-operating-system"
  20410. msgstr ""
  20411. #. type: deffn
  20412. #: guix-git/doc/guix.texi:13991
  20413. msgid "When used in the @emph{lexical scope} of an operating system field definition, this identifier resolves to the operating system being defined."
  20414. msgstr ""
  20415. #. type: deffn
  20416. #: guix-git/doc/guix.texi:13994
  20417. msgid "The example below shows how to refer to the operating system being defined in the definition of the @code{label} field:"
  20418. msgstr ""
  20419. #. type: lisp
  20420. #: guix-git/doc/guix.texi:13997 guix-git/doc/guix.texi:17574
  20421. #, no-wrap
  20422. msgid ""
  20423. "(use-modules (gnu) (guix))\n"
  20424. "\n"
  20425. msgstr ""
  20426. #. type: lisp
  20427. #: guix-git/doc/guix.texi:14002
  20428. #, no-wrap
  20429. msgid ""
  20430. "(operating-system\n"
  20431. " ;; ...\n"
  20432. " (label (package-full-name\n"
  20433. " (operating-system-kernel this-operating-system))))\n"
  20434. msgstr ""
  20435. #. type: deffn
  20436. #: guix-git/doc/guix.texi:14006
  20437. msgid "It is an error to refer to @code{this-operating-system} outside an operating system definition."
  20438. msgstr ""
  20439. #. type: Plain text
  20440. #: guix-git/doc/guix.texi:14017
  20441. msgid "The list of file systems to be mounted is specified in the @code{file-systems} field of the operating system declaration (@pxref{Using the Configuration System}). Each file system is declared using the @code{file-system} form, like this:"
  20442. msgstr ""
  20443. #. type: lisp
  20444. #: guix-git/doc/guix.texi:14023
  20445. #, no-wrap
  20446. msgid ""
  20447. "(file-system\n"
  20448. " (mount-point \"/home\")\n"
  20449. " (device \"/dev/sda3\")\n"
  20450. " (type \"ext4\"))\n"
  20451. msgstr ""
  20452. #. type: Plain text
  20453. #: guix-git/doc/guix.texi:14027
  20454. msgid "As usual, some of the fields are mandatory---those shown in the example above---while others can be omitted. These are described below."
  20455. msgstr ""
  20456. #. type: deftp
  20457. #: guix-git/doc/guix.texi:14028
  20458. #, no-wrap
  20459. msgid "{Data Type} file-system"
  20460. msgstr ""
  20461. #. type: deftp
  20462. #: guix-git/doc/guix.texi:14031
  20463. msgid "Objects of this type represent file systems to be mounted. They contain the following members:"
  20464. msgstr ""
  20465. #. type: item
  20466. #: guix-git/doc/guix.texi:14033 guix-git/doc/guix.texi:14383
  20467. #, no-wrap
  20468. msgid "type"
  20469. msgstr ""
  20470. #. type: table
  20471. #: guix-git/doc/guix.texi:14036
  20472. msgid "This is a string specifying the type of the file system---e.g., @code{\"ext4\"}."
  20473. msgstr ""
  20474. #. type: code{#1}
  20475. #: guix-git/doc/guix.texi:14037
  20476. #, no-wrap
  20477. msgid "mount-point"
  20478. msgstr ""
  20479. #. type: table
  20480. #: guix-git/doc/guix.texi:14039
  20481. msgid "This designates the place where the file system is to be mounted."
  20482. msgstr ""
  20483. #. type: code{#1}
  20484. #: guix-git/doc/guix.texi:14040
  20485. #, no-wrap
  20486. msgid "device"
  20487. msgstr ""
  20488. #. type: table
  20489. #: guix-git/doc/guix.texi:14050
  20490. msgid "This names the ``source'' of the file system. It can be one of three things: a file system label, a file system UUID, or the name of a @file{/dev} node. Labels and UUIDs offer a way to refer to file systems without having to hard-code their actual device name@footnote{Note that, while it is tempting to use @file{/dev/disk/by-uuid} and similar device names to achieve the same result, this is not recommended: These special device nodes are created by the udev daemon and may be unavailable at the time the device is mounted.}."
  20491. msgstr ""
  20492. #. type: findex
  20493. #: guix-git/doc/guix.texi:14051
  20494. #, no-wrap
  20495. msgid "file-system-label"
  20496. msgstr ""
  20497. #. type: table
  20498. #: guix-git/doc/guix.texi:14056
  20499. msgid "File system labels are created using the @code{file-system-label} procedure, UUIDs are created using @code{uuid}, and @file{/dev} node are plain strings. Here's an example of a file system referred to by its label, as shown by the @command{e2label} command:"
  20500. msgstr ""
  20501. #. type: lisp
  20502. #: guix-git/doc/guix.texi:14062
  20503. #, no-wrap
  20504. msgid ""
  20505. "(file-system\n"
  20506. " (mount-point \"/home\")\n"
  20507. " (type \"ext4\")\n"
  20508. " (device (file-system-label \"my-home\")))\n"
  20509. msgstr ""
  20510. #. type: code{#1}
  20511. #: guix-git/doc/guix.texi:14064 guix-git/doc/guix.texi:31772
  20512. #: guix-git/doc/guix.texi:31788
  20513. #, no-wrap
  20514. msgid "uuid"
  20515. msgstr ""
  20516. #. type: table
  20517. #: guix-git/doc/guix.texi:14072
  20518. msgid "UUIDs are converted from their string representation (as shown by the @command{tune2fs -l} command) using the @code{uuid} form@footnote{The @code{uuid} form expects 16-byte UUIDs as defined in @uref{https://tools.ietf.org/html/rfc4122, RFC@tie{}4122}. This is the form of UUID used by the ext2 family of file systems and others, but it is different from ``UUIDs'' found in FAT file systems, for instance.}, like this:"
  20519. msgstr ""
  20520. #. type: lisp
  20521. #: guix-git/doc/guix.texi:14078
  20522. #, no-wrap
  20523. msgid ""
  20524. "(file-system\n"
  20525. " (mount-point \"/home\")\n"
  20526. " (type \"ext4\")\n"
  20527. " (device (uuid \"4dab5feb-d176-45de-b287-9b0a6e4c01cb\")))\n"
  20528. msgstr ""
  20529. #. type: table
  20530. #: guix-git/doc/guix.texi:14086
  20531. msgid "When the source of a file system is a mapped device (@pxref{Mapped Devices}), its @code{device} field @emph{must} refer to the mapped device name---e.g., @file{\"/dev/mapper/root-partition\"}. This is required so that the system knows that mounting the file system depends on having the corresponding device mapping established."
  20532. msgstr ""
  20533. #. type: item
  20534. #: guix-git/doc/guix.texi:14087
  20535. #, no-wrap
  20536. msgid "@code{flags} (default: @code{'()})"
  20537. msgstr ""
  20538. #. type: table
  20539. #: guix-git/doc/guix.texi:14097
  20540. msgid "This is a list of symbols denoting mount flags. Recognized flags include @code{read-only}, @code{bind-mount}, @code{no-dev} (disallow access to special files), @code{no-suid} (ignore setuid and setgid bits), @code{no-atime} (do not update file access times), @code{strict-atime} (update file access time), @code{lazy-time} (only update time on the in-memory version of the file inode), and @code{no-exec} (disallow program execution). @xref{Mount-Unmount-Remount,,, libc, The GNU C Library Reference Manual}, for more information on these flags."
  20541. msgstr ""
  20542. #. type: item
  20543. #: guix-git/doc/guix.texi:14098
  20544. #, no-wrap
  20545. msgid "@code{options} (default: @code{#f})"
  20546. msgstr ""
  20547. #. type: table
  20548. #: guix-git/doc/guix.texi:14107
  20549. msgid "This is either @code{#f}, or a string denoting mount options passed to the file system driver. @xref{Mount-Unmount-Remount,,, libc, The GNU C Library Reference Manual}, for details and run @command{man 8 mount} for options for various file systems. Note that the @code{file-system-options->alist} and @code{alist->file-system-options} procedures from @code{(gnu system file-systems)} can be used to convert file system options given as an association list to the string representation, and vice-versa."
  20550. msgstr ""
  20551. #. type: item
  20552. #: guix-git/doc/guix.texi:14108
  20553. #, no-wrap
  20554. msgid "@code{mount?} (default: @code{#t})"
  20555. msgstr ""
  20556. #. type: table
  20557. #: guix-git/doc/guix.texi:14113
  20558. msgid "This value indicates whether to automatically mount the file system when the system is brought up. When set to @code{#f}, the file system gets an entry in @file{/etc/fstab} (read by the @command{mount} command) but is not automatically mounted."
  20559. msgstr ""
  20560. #. type: item
  20561. #: guix-git/doc/guix.texi:14114
  20562. #, no-wrap
  20563. msgid "@code{needed-for-boot?} (default: @code{#f})"
  20564. msgstr ""
  20565. #. type: table
  20566. #: guix-git/doc/guix.texi:14119
  20567. msgid "This Boolean value indicates whether the file system is needed when booting. If that is true, then the file system is mounted when the initial RAM disk (initrd) is loaded. This is always the case, for instance, for the root file system."
  20568. msgstr ""
  20569. #. type: item
  20570. #: guix-git/doc/guix.texi:14120
  20571. #, no-wrap
  20572. msgid "@code{check?} (default: @code{#t})"
  20573. msgstr ""
  20574. #. type: table
  20575. #: guix-git/doc/guix.texi:14123
  20576. msgid "This Boolean indicates whether the file system needs to be checked for errors before being mounted."
  20577. msgstr ""
  20578. #. type: item
  20579. #: guix-git/doc/guix.texi:14124
  20580. #, no-wrap
  20581. msgid "@code{create-mount-point?} (default: @code{#f})"
  20582. msgstr ""
  20583. #. type: table
  20584. #: guix-git/doc/guix.texi:14126
  20585. msgid "When true, the mount point is created if it does not exist yet."
  20586. msgstr ""
  20587. #. type: item
  20588. #: guix-git/doc/guix.texi:14127
  20589. #, no-wrap
  20590. msgid "@code{mount-may-fail?} (default: @code{#f})"
  20591. msgstr ""
  20592. #. type: table
  20593. #: guix-git/doc/guix.texi:14132
  20594. msgid "When true, this indicates that mounting this file system can fail but that should not be considered an error. This is useful in unusual cases; an example of this is @code{efivarfs}, a file system that can only be mounted on EFI/UEFI systems."
  20595. msgstr ""
  20596. #. type: item
  20597. #: guix-git/doc/guix.texi:14133
  20598. #, no-wrap
  20599. msgid "@code{dependencies} (default: @code{'()})"
  20600. msgstr ""
  20601. #. type: table
  20602. #: guix-git/doc/guix.texi:14137
  20603. msgid "This is a list of @code{<file-system>} or @code{<mapped-device>} objects representing file systems that must be mounted or mapped devices that must be opened before (and unmounted or closed after) this one."
  20604. msgstr ""
  20605. #. type: table
  20606. #: guix-git/doc/guix.texi:14141
  20607. msgid "As an example, consider a hierarchy of mounts: @file{/sys/fs/cgroup} is a dependency of @file{/sys/fs/cgroup/cpu} and @file{/sys/fs/cgroup/memory}."
  20608. msgstr ""
  20609. #. type: table
  20610. #: guix-git/doc/guix.texi:14144
  20611. msgid "Another example is a file system that depends on a mapped device, for example for an encrypted partition (@pxref{Mapped Devices})."
  20612. msgstr ""
  20613. #. type: deffn
  20614. #: guix-git/doc/guix.texi:14147
  20615. #, no-wrap
  20616. msgid "{Scheme Procedure} file-system-label @var{str}"
  20617. msgstr ""
  20618. #. type: deffn
  20619. #: guix-git/doc/guix.texi:14150
  20620. msgid "This procedure returns an opaque file system label from @var{str}, a string:"
  20621. msgstr ""
  20622. #. type: lisp
  20623. #: guix-git/doc/guix.texi:14154
  20624. #, no-wrap
  20625. msgid ""
  20626. "(file-system-label \"home\")\n"
  20627. "@result{} #<file-system-label \"home\">\n"
  20628. msgstr ""
  20629. #. type: deffn
  20630. #: guix-git/doc/guix.texi:14158
  20631. msgid "File system labels are used to refer to file systems by label rather than by device name. See above for examples."
  20632. msgstr ""
  20633. #. type: Plain text
  20634. #: guix-git/doc/guix.texi:14162
  20635. msgid "The @code{(gnu system file-systems)} exports the following useful variables."
  20636. msgstr ""
  20637. #. type: defvr
  20638. #: guix-git/doc/guix.texi:14163
  20639. #, no-wrap
  20640. msgid "{Scheme Variable} %base-file-systems"
  20641. msgstr ""
  20642. #. type: defvr
  20643. #: guix-git/doc/guix.texi:14168
  20644. msgid "These are essential file systems that are required on normal systems, such as @code{%pseudo-terminal-file-system} and @code{%immutable-store} (see below). Operating system declarations should always contain at least these."
  20645. msgstr ""
  20646. #. type: defvr
  20647. #: guix-git/doc/guix.texi:14170
  20648. #, no-wrap
  20649. msgid "{Scheme Variable} %pseudo-terminal-file-system"
  20650. msgstr ""
  20651. #. type: defvr
  20652. #: guix-git/doc/guix.texi:14176
  20653. msgid "This is the file system to be mounted as @file{/dev/pts}. It supports @dfn{pseudo-terminals} created @i{via} @code{openpty} and similar functions (@pxref{Pseudo-Terminals,,, libc, The GNU C Library Reference Manual}). Pseudo-terminals are used by terminal emulators such as @command{xterm}."
  20654. msgstr ""
  20655. #. type: defvr
  20656. #: guix-git/doc/guix.texi:14178
  20657. #, no-wrap
  20658. msgid "{Scheme Variable} %shared-memory-file-system"
  20659. msgstr ""
  20660. #. type: defvr
  20661. #: guix-git/doc/guix.texi:14182
  20662. msgid "This file system is mounted as @file{/dev/shm} and is used to support memory sharing across processes (@pxref{Memory-mapped I/O, @code{shm_open},, libc, The GNU C Library Reference Manual})."
  20663. msgstr ""
  20664. #. type: defvr
  20665. #: guix-git/doc/guix.texi:14184
  20666. #, no-wrap
  20667. msgid "{Scheme Variable} %immutable-store"
  20668. msgstr ""
  20669. #. type: defvr
  20670. #: guix-git/doc/guix.texi:14189
  20671. msgid "This file system performs a read-only ``bind mount'' of @file{/gnu/store}, making it read-only for all the users including @code{root}. This prevents against accidental modification by software running as @code{root} or by system administrators."
  20672. msgstr ""
  20673. #. type: defvr
  20674. #: guix-git/doc/guix.texi:14192
  20675. msgid "The daemon itself is still able to write to the store: it remounts it read-write in its own ``name space.''"
  20676. msgstr ""
  20677. #. type: defvr
  20678. #: guix-git/doc/guix.texi:14194
  20679. #, no-wrap
  20680. msgid "{Scheme Variable} %binary-format-file-system"
  20681. msgstr ""
  20682. #. type: defvr
  20683. #: guix-git/doc/guix.texi:14198
  20684. msgid "The @code{binfmt_misc} file system, which allows handling of arbitrary executable file types to be delegated to user space. This requires the @code{binfmt.ko} kernel module to be loaded."
  20685. msgstr ""
  20686. #. type: defvr
  20687. #: guix-git/doc/guix.texi:14200
  20688. #, no-wrap
  20689. msgid "{Scheme Variable} %fuse-control-file-system"
  20690. msgstr ""
  20691. #. type: defvr
  20692. #: guix-git/doc/guix.texi:14204
  20693. msgid "The @code{fusectl} file system, which allows unprivileged users to mount and unmount user-space FUSE file systems. This requires the @code{fuse.ko} kernel module to be loaded."
  20694. msgstr ""
  20695. #. type: Plain text
  20696. #: guix-git/doc/guix.texi:14208
  20697. msgid "The @code{(gnu system uuid)} module provides tools to deal with file system ``unique identifiers'' (UUIDs)."
  20698. msgstr ""
  20699. #. type: deffn
  20700. #: guix-git/doc/guix.texi:14209
  20701. #, no-wrap
  20702. msgid "{Scheme Procedure} uuid @var{str} [@var{type}]"
  20703. msgstr ""
  20704. #. type: deffn
  20705. #: guix-git/doc/guix.texi:14212
  20706. msgid "Return an opaque UUID (unique identifier) object of the given @var{type} (a symbol) by parsing @var{str} (a string):"
  20707. msgstr ""
  20708. #. type: lisp
  20709. #: guix-git/doc/guix.texi:14216
  20710. #, no-wrap
  20711. msgid ""
  20712. "(uuid \"4dab5feb-d176-45de-b287-9b0a6e4c01cb\")\n"
  20713. "@result{} #<<uuid> type: dce bv: @dots{}>\n"
  20714. "\n"
  20715. msgstr ""
  20716. #. type: lisp
  20717. #: guix-git/doc/guix.texi:14219
  20718. #, no-wrap
  20719. msgid ""
  20720. "(uuid \"1234-ABCD\" 'fat)\n"
  20721. "@result{} #<<uuid> type: fat bv: @dots{}>\n"
  20722. msgstr ""
  20723. #. type: deffn
  20724. #: guix-git/doc/guix.texi:14223
  20725. msgid "@var{type} may be one of @code{dce}, @code{iso9660}, @code{fat}, @code{ntfs}, or one of the commonly found synonyms for these."
  20726. msgstr ""
  20727. #. type: deffn
  20728. #: guix-git/doc/guix.texi:14226
  20729. msgid "UUIDs are another way to unambiguously refer to file systems in operating system configuration. See the examples above."
  20730. msgstr ""
  20731. #. type: subsection
  20732. #: guix-git/doc/guix.texi:14229 guix-git/doc/guix.texi:14230
  20733. #, no-wrap
  20734. msgid "Btrfs file system"
  20735. msgstr ""
  20736. #. type: Plain text
  20737. #: guix-git/doc/guix.texi:14236
  20738. msgid "The Btrfs has special features, such as subvolumes, that merit being explained in more details. The following section attempts to cover basic as well as complex uses of a Btrfs file system with the Guix System."
  20739. msgstr ""
  20740. #. type: Plain text
  20741. #: guix-git/doc/guix.texi:14239
  20742. msgid "In its simplest usage, a Btrfs file system can be described, for example, by:"
  20743. msgstr ""
  20744. #. type: lisp
  20745. #: guix-git/doc/guix.texi:14245
  20746. #, no-wrap
  20747. msgid ""
  20748. "(file-system\n"
  20749. " (mount-point \"/home\")\n"
  20750. " (type \"btrfs\")\n"
  20751. " (device (file-system-label \"my-home\")))\n"
  20752. msgstr ""
  20753. #. type: Plain text
  20754. #: guix-git/doc/guix.texi:14251
  20755. msgid "The example below is more complex, as it makes use of a Btrfs subvolume, named @code{rootfs}. The parent Btrfs file system is labeled @code{my-btrfs-pool}, and is located on an encrypted device (hence the dependency on @code{mapped-devices}):"
  20756. msgstr ""
  20757. #. type: lisp
  20758. #: guix-git/doc/guix.texi:14259
  20759. #, no-wrap
  20760. msgid ""
  20761. "(file-system\n"
  20762. " (device (file-system-label \"my-btrfs-pool\"))\n"
  20763. " (mount-point \"/\")\n"
  20764. " (type \"btrfs\")\n"
  20765. " (options \"subvol=rootfs\")\n"
  20766. " (dependencies mapped-devices))\n"
  20767. msgstr ""
  20768. #. type: Plain text
  20769. #: guix-git/doc/guix.texi:14270
  20770. msgid "Some bootloaders, for example GRUB, only mount a Btrfs partition at its top level during the early boot, and rely on their configuration to refer to the correct subvolume path within that top level. The bootloaders operating in this way typically produce their configuration on a running system where the Btrfs partitions are already mounted and where the subvolume information is readily available. As an example, @command{grub-mkconfig}, the configuration generator command shipped with GRUB, reads @file{/proc/self/mountinfo} to determine the top-level path of a subvolume."
  20771. msgstr ""
  20772. #. type: Plain text
  20773. #: guix-git/doc/guix.texi:14278
  20774. msgid "The Guix System produces a bootloader configuration using the operating system configuration as its sole input; it is therefore necessary to extract the subvolume name on which @file{/gnu/store} lives (if any) from that operating system configuration. To better illustrate, consider a subvolume named 'rootfs' which contains the root file system data. In such situation, the GRUB bootloader would only see the top level of the root Btrfs partition, e.g.:"
  20775. msgstr ""
  20776. #. type: example
  20777. #: guix-git/doc/guix.texi:14285
  20778. #, no-wrap
  20779. msgid ""
  20780. "/ (top level)\n"
  20781. "├── rootfs (subvolume directory)\n"
  20782. " ├── gnu (normal directory)\n"
  20783. " ├── store (normal directory)\n"
  20784. "[...]\n"
  20785. msgstr ""
  20786. #. type: Plain text
  20787. #: guix-git/doc/guix.texi:14290
  20788. msgid "Thus, the subvolume name must be prepended to the @file{/gnu/store} path of the kernel, initrd binaries and any other files referred to in the GRUB configuration that must be found during the early boot."
  20789. msgstr ""
  20790. #. type: Plain text
  20791. #: guix-git/doc/guix.texi:14293
  20792. msgid "The next example shows a nested hierarchy of subvolumes and directories:"
  20793. msgstr ""
  20794. #. type: example
  20795. #: guix-git/doc/guix.texi:14300
  20796. #, no-wrap
  20797. msgid ""
  20798. "/ (top level)\n"
  20799. "├── rootfs (subvolume)\n"
  20800. " ├── gnu (normal directory)\n"
  20801. " ├── store (subvolume)\n"
  20802. "[...]\n"
  20803. msgstr ""
  20804. #. type: Plain text
  20805. #: guix-git/doc/guix.texi:14307
  20806. msgid "This scenario would work without mounting the 'store' subvolume. Mounting 'rootfs' is sufficient, since the subvolume name matches its intended mount point in the file system hierarchy. Alternatively, the 'store' subvolume could be referred to by setting the @code{subvol} option to either @code{/rootfs/gnu/store} or @code{rootfs/gnu/store}."
  20807. msgstr ""
  20808. #. type: Plain text
  20809. #: guix-git/doc/guix.texi:14309
  20810. msgid "Finally, a more contrived example of nested subvolumes:"
  20811. msgstr ""
  20812. #. type: example
  20813. #: guix-git/doc/guix.texi:14316
  20814. #, no-wrap
  20815. msgid ""
  20816. "/ (top level)\n"
  20817. "├── root-snapshots (subvolume)\n"
  20818. " ├── root-current (subvolume)\n"
  20819. " ├── guix-store (subvolume)\n"
  20820. "[...]\n"
  20821. msgstr ""
  20822. #. type: Plain text
  20823. #: guix-git/doc/guix.texi:14323
  20824. msgid "Here, the 'guix-store' subvolume doesn't match its intended mount point, so it is necessary to mount it. The subvolume must be fully specified, by passing its file name to the @code{subvol} option. To illustrate, the 'guix-store' subvolume could be mounted on @file{/gnu/store} by using a file system declaration such as:"
  20825. msgstr ""
  20826. #. type: lisp
  20827. #: guix-git/doc/guix.texi:14331
  20828. #, no-wrap
  20829. msgid ""
  20830. "(file-system\n"
  20831. " (device (file-system-label \"btrfs-pool-1\"))\n"
  20832. " (mount-point \"/gnu/store\")\n"
  20833. " (type \"btrfs\")\n"
  20834. " (options \"subvol=root-snapshots/root-current/guix-store,\\\n"
  20835. "compress-force=zstd,space_cache=v2\"))\n"
  20836. msgstr ""
  20837. #. type: cindex
  20838. #: guix-git/doc/guix.texi:14336
  20839. #, no-wrap
  20840. msgid "device mapping"
  20841. msgstr ""
  20842. #. type: cindex
  20843. #: guix-git/doc/guix.texi:14337
  20844. #, no-wrap
  20845. msgid "mapped devices"
  20846. msgstr ""
  20847. #. type: Plain text
  20848. #: guix-git/doc/guix.texi:14354
  20849. msgid "The Linux kernel has a notion of @dfn{device mapping}: a block device, such as a hard disk partition, can be @dfn{mapped} into another device, usually in @code{/dev/mapper/}, with additional processing over the data that flows through it@footnote{Note that the GNU@tie{}Hurd makes no difference between the concept of a ``mapped device'' and that of a file system: both boil down to @emph{translating} input/output operations made on a file to operations on its backing store. Thus, the Hurd implements mapped devices, like file systems, using the generic @dfn{translator} mechanism (@pxref{Translators,,, hurd, The GNU Hurd Reference Manual}).}. A typical example is encryption device mapping: all writes to the mapped device are encrypted, and all reads are deciphered, transparently. Guix extends this notion by considering any device or set of devices that are @dfn{transformed} in some way to create a new device; for instance, RAID devices are obtained by @dfn{assembling} several other devices, such as hard disks or partitions, into a new one that behaves as one partition."
  20850. msgstr ""
  20851. #. type: Plain text
  20852. #: guix-git/doc/guix.texi:14357
  20853. msgid "Mapped devices are declared using the @code{mapped-device} form, defined as follows; for examples, see below."
  20854. msgstr ""
  20855. #. type: deftp
  20856. #: guix-git/doc/guix.texi:14358
  20857. #, no-wrap
  20858. msgid "{Data Type} mapped-device"
  20859. msgstr ""
  20860. #. type: deftp
  20861. #: guix-git/doc/guix.texi:14361
  20862. msgid "Objects of this type represent device mappings that will be made when the system boots up."
  20863. msgstr ""
  20864. #. type: table
  20865. #: guix-git/doc/guix.texi:14368
  20866. msgid "This is either a string specifying the name of the block device to be mapped, such as @code{\"/dev/sda3\"}, or a list of such strings when several devices need to be assembled for creating a new one. In case of LVM this is a string specifying name of the volume group to be mapped."
  20867. msgstr ""
  20868. #. type: code{#1}
  20869. #: guix-git/doc/guix.texi:14369 guix-git/doc/guix.texi:33233
  20870. #, no-wrap
  20871. msgid "target"
  20872. msgstr ""
  20873. #. type: table
  20874. #: guix-git/doc/guix.texi:14378
  20875. msgid "This string specifies the name of the resulting mapped device. For kernel mappers such as encrypted devices of type @code{luks-device-mapping}, specifying @code{\"my-partition\"} leads to the creation of the @code{\"/dev/mapper/my-partition\"} device. For RAID devices of type @code{raid-device-mapping}, the full device name such as @code{\"/dev/md0\"} needs to be given. LVM logical volumes of type @code{lvm-device-mapping} need to be specified as @code{\"VGNAME-LVNAME\"}."
  20876. msgstr ""
  20877. #. type: item
  20878. #: guix-git/doc/guix.texi:14379
  20879. #, no-wrap
  20880. msgid "targets"
  20881. msgstr ""
  20882. #. type: table
  20883. #: guix-git/doc/guix.texi:14382
  20884. msgid "This list of strings specifies names of the resulting mapped devices in case there are several. The format is identical to @var{target}."
  20885. msgstr ""
  20886. #. type: table
  20887. #: guix-git/doc/guix.texi:14386
  20888. msgid "This must be a @code{mapped-device-kind} object, which specifies how @var{source} is mapped to @var{target}."
  20889. msgstr ""
  20890. #. type: defvr
  20891. #: guix-git/doc/guix.texi:14389
  20892. #, no-wrap
  20893. msgid "{Scheme Variable} luks-device-mapping"
  20894. msgstr ""
  20895. #. type: defvr
  20896. #: guix-git/doc/guix.texi:14393
  20897. msgid "This defines LUKS block device encryption using the @command{cryptsetup} command from the package with the same name. It relies on the @code{dm-crypt} Linux kernel module."
  20898. msgstr ""
  20899. #. type: defvr
  20900. #: guix-git/doc/guix.texi:14395
  20901. #, no-wrap
  20902. msgid "{Scheme Variable} raid-device-mapping"
  20903. msgstr ""
  20904. #. type: defvr
  20905. #: guix-git/doc/guix.texi:14400
  20906. msgid "This defines a RAID device, which is assembled using the @code{mdadm} command from the package with the same name. It requires a Linux kernel module for the appropriate RAID level to be loaded, such as @code{raid456} for RAID-4, RAID-5 or RAID-6, or @code{raid10} for RAID-10."
  20907. msgstr ""
  20908. #. type: cindex
  20909. #: guix-git/doc/guix.texi:14402
  20910. #, no-wrap
  20911. msgid "LVM, logical volume manager"
  20912. msgstr ""
  20913. #. type: defvr
  20914. #: guix-git/doc/guix.texi:14403
  20915. #, no-wrap
  20916. msgid "{Scheme Variable} lvm-device-mapping"
  20917. msgstr ""
  20918. #. type: defvr
  20919. #: guix-git/doc/guix.texi:14408
  20920. msgid "This defines one or more logical volumes for the Linux @uref{https://www.sourceware.org/lvm2/, Logical Volume Manager (LVM)}. The volume group is activated by the @command{vgchange} command from the @code{lvm2} package."
  20921. msgstr ""
  20922. #. type: cindex
  20923. #: guix-git/doc/guix.texi:14410
  20924. #, no-wrap
  20925. msgid "disk encryption"
  20926. msgstr ""
  20927. #. type: cindex
  20928. #: guix-git/doc/guix.texi:14411
  20929. #, no-wrap
  20930. msgid "LUKS"
  20931. msgstr ""
  20932. #. type: Plain text
  20933. #: guix-git/doc/guix.texi:14419
  20934. msgid "The following example specifies a mapping from @file{/dev/sda3} to @file{/dev/mapper/home} using LUKS---the @url{https://gitlab.com/cryptsetup/cryptsetup,Linux Unified Key Setup}, a standard mechanism for disk encryption. The @file{/dev/mapper/home} device can then be used as the @code{device} of a @code{file-system} declaration (@pxref{File Systems})."
  20935. msgstr ""
  20936. #. type: lisp
  20937. #: guix-git/doc/guix.texi:14425
  20938. #, no-wrap
  20939. msgid ""
  20940. "(mapped-device\n"
  20941. " (source \"/dev/sda3\")\n"
  20942. " (target \"home\")\n"
  20943. " (type luks-device-mapping))\n"
  20944. msgstr ""
  20945. #. type: Plain text
  20946. #: guix-git/doc/guix.texi:14430
  20947. msgid "Alternatively, to become independent of device numbering, one may obtain the LUKS UUID (@dfn{unique identifier}) of the source device by a command like:"
  20948. msgstr ""
  20949. #. type: example
  20950. #: guix-git/doc/guix.texi:14433
  20951. #, no-wrap
  20952. msgid "cryptsetup luksUUID /dev/sda3\n"
  20953. msgstr ""
  20954. #. type: Plain text
  20955. #: guix-git/doc/guix.texi:14436
  20956. msgid "and use it as follows:"
  20957. msgstr ""
  20958. #. type: lisp
  20959. #: guix-git/doc/guix.texi:14442
  20960. #, no-wrap
  20961. msgid ""
  20962. "(mapped-device\n"
  20963. " (source (uuid \"cb67fc72-0d54-4c88-9d4b-b225f30b0f44\"))\n"
  20964. " (target \"home\")\n"
  20965. " (type luks-device-mapping))\n"
  20966. msgstr ""
  20967. #. type: cindex
  20968. #: guix-git/doc/guix.texi:14444
  20969. #, no-wrap
  20970. msgid "swap encryption"
  20971. msgstr ""
  20972. #. type: Plain text
  20973. #: guix-git/doc/guix.texi:14450
  20974. msgid "It is also desirable to encrypt swap space, since swap space may contain sensitive data. One way to accomplish that is to use a swap file in a file system on a device mapped via LUKS encryption. In this way, the swap file is encrypted because the entire device is encrypted. @xref{Preparing for Installation,,Disk Partitioning}, for an example."
  20975. msgstr ""
  20976. #. type: Plain text
  20977. #: guix-git/doc/guix.texi:14453
  20978. msgid "A RAID device formed of the partitions @file{/dev/sda1} and @file{/dev/sdb1} may be declared as follows:"
  20979. msgstr ""
  20980. #. type: lisp
  20981. #: guix-git/doc/guix.texi:14459
  20982. #, no-wrap
  20983. msgid ""
  20984. "(mapped-device\n"
  20985. " (source (list \"/dev/sda1\" \"/dev/sdb1\"))\n"
  20986. " (target \"/dev/md0\")\n"
  20987. " (type raid-device-mapping))\n"
  20988. msgstr ""
  20989. #. type: Plain text
  20990. #: guix-git/doc/guix.texi:14466
  20991. msgid "The @file{/dev/md0} device can then be used as the @code{device} of a @code{file-system} declaration (@pxref{File Systems}). Note that the RAID level need not be given; it is chosen during the initial creation and formatting of the RAID device and is determined automatically later."
  20992. msgstr ""
  20993. #. type: Plain text
  20994. #: guix-git/doc/guix.texi:14469
  20995. msgid "LVM logical volumes ``alpha'' and ``beta'' from volume group ``vg0'' can be declared as follows:"
  20996. msgstr ""
  20997. #. type: lisp
  20998. #: guix-git/doc/guix.texi:14475
  20999. #, no-wrap
  21000. msgid ""
  21001. "(mapped-device\n"
  21002. " (source \"vg0\")\n"
  21003. " (targets (list \"vg0-alpha\" \"vg0-beta\"))\n"
  21004. " (type lvm-device-mapping))\n"
  21005. msgstr ""
  21006. #. type: Plain text
  21007. #: guix-git/doc/guix.texi:14480
  21008. msgid "Devices @file{/dev/mapper/vg0-alpha} and @file{/dev/mapper/vg0-beta} can then be used as the @code{device} of a @code{file-system} declaration (@pxref{File Systems})."
  21009. msgstr ""
  21010. #. type: cindex
  21011. #: guix-git/doc/guix.texi:14484
  21012. #, no-wrap
  21013. msgid "users"
  21014. msgstr ""
  21015. #. type: cindex
  21016. #: guix-git/doc/guix.texi:14485
  21017. #, no-wrap
  21018. msgid "accounts"
  21019. msgstr ""
  21020. #. type: cindex
  21021. #: guix-git/doc/guix.texi:14486
  21022. #, no-wrap
  21023. msgid "user accounts"
  21024. msgstr ""
  21025. #. type: Plain text
  21026. #: guix-git/doc/guix.texi:14490
  21027. msgid "User accounts and groups are entirely managed through the @code{operating-system} declaration. They are specified with the @code{user-account} and @code{user-group} forms:"
  21028. msgstr ""
  21029. #. type: lisp
  21030. #: guix-git/doc/guix.texi:14500
  21031. #, no-wrap
  21032. msgid ""
  21033. "(user-account\n"
  21034. " (name \"alice\")\n"
  21035. " (group \"users\")\n"
  21036. " (supplementary-groups '(\"wheel\" ;allow use of sudo, etc.\n"
  21037. " \"audio\" ;sound card\n"
  21038. " \"video\" ;video devices such as webcams\n"
  21039. " \"cdrom\")) ;the good ol' CD-ROM\n"
  21040. " (comment \"Bob's sister\"))\n"
  21041. msgstr ""
  21042. #. type: Plain text
  21043. #: guix-git/doc/guix.texi:14504
  21044. msgid "Here's a user account that uses a different shell and a custom home directory (the default would be @file{\"/home/bob\"}):"
  21045. msgstr ""
  21046. #. type: lisp
  21047. #: guix-git/doc/guix.texi:14512
  21048. #, no-wrap
  21049. msgid ""
  21050. "(user-account\n"
  21051. " (name \"bob\")\n"
  21052. " (group \"users\")\n"
  21053. " (comment \"Alice's bro\")\n"
  21054. " (shell (file-append zsh \"/bin/zsh\"))\n"
  21055. " (home-directory \"/home/robert\"))\n"
  21056. msgstr ""
  21057. #. type: Plain text
  21058. #: guix-git/doc/guix.texi:14521
  21059. msgid "When booting or upon completion of @command{guix system reconfigure}, the system ensures that only the user accounts and groups specified in the @code{operating-system} declaration exist, and with the specified properties. Thus, account or group creations or modifications made by directly invoking commands such as @command{useradd} are lost upon reconfiguration or reboot. This ensures that the system remains exactly as declared."
  21060. msgstr ""
  21061. #. type: deftp
  21062. #: guix-git/doc/guix.texi:14522
  21063. #, no-wrap
  21064. msgid "{Data Type} user-account"
  21065. msgstr ""
  21066. #. type: deftp
  21067. #: guix-git/doc/guix.texi:14525
  21068. msgid "Objects of this type represent user accounts. The following members may be specified:"
  21069. msgstr ""
  21070. #. type: table
  21071. #: guix-git/doc/guix.texi:14529
  21072. msgid "The name of the user account."
  21073. msgstr ""
  21074. #. type: itemx
  21075. #: guix-git/doc/guix.texi:14530 guix-git/doc/guix.texi:32919
  21076. #, no-wrap
  21077. msgid "group"
  21078. msgstr ""
  21079. #. type: cindex
  21080. #: guix-git/doc/guix.texi:14531 guix-git/doc/guix.texi:14610
  21081. #, no-wrap
  21082. msgid "groups"
  21083. msgstr ""
  21084. #. type: table
  21085. #: guix-git/doc/guix.texi:14534
  21086. msgid "This is the name (a string) or identifier (a number) of the user group this account belongs to."
  21087. msgstr ""
  21088. #. type: item
  21089. #: guix-git/doc/guix.texi:14535
  21090. #, no-wrap
  21091. msgid "@code{supplementary-groups} (default: @code{'()})"
  21092. msgstr ""
  21093. #. type: table
  21094. #: guix-git/doc/guix.texi:14538
  21095. msgid "Optionally, this can be defined as a list of group names that this account belongs to."
  21096. msgstr ""
  21097. #. type: item
  21098. #: guix-git/doc/guix.texi:14539
  21099. #, no-wrap
  21100. msgid "@code{uid} (default: @code{#f})"
  21101. msgstr ""
  21102. #. type: table
  21103. #: guix-git/doc/guix.texi:14543
  21104. msgid "This is the user ID for this account (a number), or @code{#f}. In the latter case, a number is automatically chosen by the system when the account is created."
  21105. msgstr ""
  21106. #. type: item
  21107. #: guix-git/doc/guix.texi:14544
  21108. #, no-wrap
  21109. msgid "@code{comment} (default: @code{\"\"})"
  21110. msgstr ""
  21111. #. type: table
  21112. #: guix-git/doc/guix.texi:14546
  21113. msgid "A comment about the account, such as the account owner's full name."
  21114. msgstr ""
  21115. #. type: code{#1}
  21116. #: guix-git/doc/guix.texi:14547
  21117. #, no-wrap
  21118. msgid "home-directory"
  21119. msgstr ""
  21120. #. type: table
  21121. #: guix-git/doc/guix.texi:14549
  21122. msgid "This is the name of the home directory for the account."
  21123. msgstr ""
  21124. #. type: item
  21125. #: guix-git/doc/guix.texi:14550
  21126. #, no-wrap
  21127. msgid "@code{create-home-directory?} (default: @code{#t})"
  21128. msgstr ""
  21129. #. type: table
  21130. #: guix-git/doc/guix.texi:14553
  21131. msgid "Indicates whether the home directory of this account should be created if it does not exist yet."
  21132. msgstr ""
  21133. #. type: item
  21134. #: guix-git/doc/guix.texi:14554
  21135. #, no-wrap
  21136. msgid "@code{shell} (default: Bash)"
  21137. msgstr ""
  21138. #. type: table
  21139. #: guix-git/doc/guix.texi:14558
  21140. msgid "This is a G-expression denoting the file name of a program to be used as the shell (@pxref{G-Expressions}). For example, you would refer to the Bash executable like this:"
  21141. msgstr ""
  21142. #. type: lisp
  21143. #: guix-git/doc/guix.texi:14561
  21144. #, no-wrap
  21145. msgid "(file-append bash \"/bin/bash\")\n"
  21146. msgstr ""
  21147. #. type: table
  21148. #: guix-git/doc/guix.texi:14565
  21149. msgid "... and to the Zsh executable like that:"
  21150. msgstr ""
  21151. #. type: lisp
  21152. #: guix-git/doc/guix.texi:14568
  21153. #, no-wrap
  21154. msgid "(file-append zsh \"/bin/zsh\")\n"
  21155. msgstr ""
  21156. #. type: item
  21157. #: guix-git/doc/guix.texi:14570 guix-git/doc/guix.texi:14628
  21158. #, no-wrap
  21159. msgid "@code{system?} (default: @code{#f})"
  21160. msgstr ""
  21161. #. type: table
  21162. #: guix-git/doc/guix.texi:14574
  21163. msgid "This Boolean value indicates whether the account is a ``system'' account. System accounts are sometimes treated specially; for instance, graphical login managers do not list them."
  21164. msgstr ""
  21165. #. type: anchor{#1}
  21166. #: guix-git/doc/guix.texi:14576
  21167. msgid "user-account-password"
  21168. msgstr ""
  21169. #. type: cindex
  21170. #: guix-git/doc/guix.texi:14576
  21171. #, no-wrap
  21172. msgid "password, for user accounts"
  21173. msgstr ""
  21174. #. type: item
  21175. #: guix-git/doc/guix.texi:14577 guix-git/doc/guix.texi:14632
  21176. #, no-wrap
  21177. msgid "@code{password} (default: @code{#f})"
  21178. msgstr ""
  21179. #. type: table
  21180. #: guix-git/doc/guix.texi:14583
  21181. msgid "You would normally leave this field to @code{#f}, initialize user passwords as @code{root} with the @command{passwd} command, and then let users change it with @command{passwd}. Passwords set with @command{passwd} are of course preserved across reboot and reconfiguration."
  21182. msgstr ""
  21183. #. type: table
  21184. #: guix-git/doc/guix.texi:14587
  21185. msgid "If you @emph{do} want to set an initial password for an account, then this field must contain the encrypted password, as a string. You can use the @code{crypt} procedure for this purpose:"
  21186. msgstr ""
  21187. #. type: lisp
  21188. #: guix-git/doc/guix.texi:14592
  21189. #, no-wrap
  21190. msgid ""
  21191. "(user-account\n"
  21192. " (name \"charlie\")\n"
  21193. " (group \"users\")\n"
  21194. "\n"
  21195. msgstr ""
  21196. #. type: lisp
  21197. #: guix-git/doc/guix.texi:14595
  21198. #, no-wrap
  21199. msgid ""
  21200. " ;; Specify a SHA-512-hashed initial password.\n"
  21201. " (password (crypt \"InitialPassword!\" \"$6$abc\")))\n"
  21202. msgstr ""
  21203. #. type: quotation
  21204. #: guix-git/doc/guix.texi:14601
  21205. msgid "The hash of this initial password will be available in a file in @file{/gnu/store}, readable by all the users, so this method must be used with care."
  21206. msgstr ""
  21207. #. type: table
  21208. #: guix-git/doc/guix.texi:14606
  21209. msgid "@xref{Passphrase Storage,,, libc, The GNU C Library Reference Manual}, for more information on password encryption, and @ref{Encryption,,, guile, GNU Guile Reference Manual}, for information on Guile's @code{crypt} procedure."
  21210. msgstr ""
  21211. #. type: Plain text
  21212. #: guix-git/doc/guix.texi:14612
  21213. msgid "User group declarations are even simpler:"
  21214. msgstr ""
  21215. #. type: lisp
  21216. #: guix-git/doc/guix.texi:14615
  21217. #, no-wrap
  21218. msgid "(user-group (name \"students\"))\n"
  21219. msgstr ""
  21220. #. type: deftp
  21221. #: guix-git/doc/guix.texi:14617
  21222. #, no-wrap
  21223. msgid "{Data Type} user-group"
  21224. msgstr ""
  21225. #. type: deftp
  21226. #: guix-git/doc/guix.texi:14619
  21227. msgid "This type is for, well, user groups. There are just a few fields:"
  21228. msgstr ""
  21229. #. type: table
  21230. #: guix-git/doc/guix.texi:14623
  21231. msgid "The name of the group."
  21232. msgstr ""
  21233. #. type: item
  21234. #: guix-git/doc/guix.texi:14624 guix-git/doc/guix.texi:29606
  21235. #, no-wrap
  21236. msgid "@code{id} (default: @code{#f})"
  21237. msgstr ""
  21238. #. type: table
  21239. #: guix-git/doc/guix.texi:14627
  21240. msgid "The group identifier (a number). If @code{#f}, a new number is automatically allocated when the group is created."
  21241. msgstr ""
  21242. #. type: table
  21243. #: guix-git/doc/guix.texi:14631
  21244. msgid "This Boolean value indicates whether the group is a ``system'' group. System groups have low numerical IDs."
  21245. msgstr ""
  21246. #. type: table
  21247. #: guix-git/doc/guix.texi:14635
  21248. msgid "What, user groups can have a password? Well, apparently yes. Unless @code{#f}, this field specifies the password of the group."
  21249. msgstr ""
  21250. #. type: Plain text
  21251. #: guix-git/doc/guix.texi:14641
  21252. msgid "For convenience, a variable lists all the basic user groups one may expect:"
  21253. msgstr ""
  21254. #. type: defvr
  21255. #: guix-git/doc/guix.texi:14642
  21256. #, no-wrap
  21257. msgid "{Scheme Variable} %base-groups"
  21258. msgstr ""
  21259. #. type: defvr
  21260. #: guix-git/doc/guix.texi:14647
  21261. msgid "This is the list of basic user groups that users and/or packages expect to be present on the system. This includes groups such as ``root'', ``wheel'', and ``users'', as well as groups used to control access to specific devices such as ``audio'', ``disk'', and ``cdrom''."
  21262. msgstr ""
  21263. #. type: defvr
  21264. #: guix-git/doc/guix.texi:14649
  21265. #, no-wrap
  21266. msgid "{Scheme Variable} %base-user-accounts"
  21267. msgstr ""
  21268. #. type: defvr
  21269. #: guix-git/doc/guix.texi:14652
  21270. msgid "This is the list of basic system accounts that programs may expect to find on a GNU/Linux system, such as the ``nobody'' account."
  21271. msgstr ""
  21272. #. type: defvr
  21273. #: guix-git/doc/guix.texi:14655
  21274. msgid "Note that the ``root'' account is not included here. It is a special-case and is automatically added whether or not it is specified."
  21275. msgstr ""
  21276. #. type: cindex
  21277. #: guix-git/doc/guix.texi:14661
  21278. #, no-wrap
  21279. msgid "keymap"
  21280. msgstr ""
  21281. #. type: Plain text
  21282. #: guix-git/doc/guix.texi:14669
  21283. msgid "To specify what each key of your keyboard does, you need to tell the operating system what @dfn{keyboard layout} you want to use. The default, when nothing is specified, is the US English QWERTY layout for 105-key PC keyboards. However, German speakers will usually prefer the German QWERTZ layout, French speakers will want the AZERTY layout, and so on; hackers might prefer Dvorak or bépo, and they might even want to further customize the effect of some of the keys. This section explains how to get that done."
  21284. msgstr ""
  21285. #. type: cindex
  21286. #: guix-git/doc/guix.texi:14670
  21287. #, no-wrap
  21288. msgid "keyboard layout, definition"
  21289. msgstr ""
  21290. #. type: Plain text
  21291. #: guix-git/doc/guix.texi:14672
  21292. msgid "There are three components that will want to know about your keyboard layout:"
  21293. msgstr ""
  21294. #. type: itemize
  21295. #: guix-git/doc/guix.texi:14679
  21296. msgid "The @emph{bootloader} may want to know what keyboard layout you want to use (@pxref{Bootloader Configuration, @code{keyboard-layout}}). This is useful if you want, for instance, to make sure that you can type the passphrase of your encrypted root partition using the right layout."
  21297. msgstr ""
  21298. #. type: itemize
  21299. #: guix-git/doc/guix.texi:14684
  21300. msgid "The @emph{operating system kernel}, Linux, will need that so that the console is properly configured (@pxref{operating-system Reference, @code{keyboard-layout}})."
  21301. msgstr ""
  21302. #. type: itemize
  21303. #: guix-git/doc/guix.texi:14688
  21304. msgid "The @emph{graphical display server}, usually Xorg, also has its own idea of the keyboard layout (@pxref{X Window, @code{keyboard-layout}})."
  21305. msgstr ""
  21306. #. type: Plain text
  21307. #: guix-git/doc/guix.texi:14692
  21308. msgid "Guix allows you to configure all three separately but, fortunately, it allows you to share the same keyboard layout for all three components."
  21309. msgstr ""
  21310. #. type: cindex
  21311. #: guix-git/doc/guix.texi:14693
  21312. #, no-wrap
  21313. msgid "XKB, keyboard layouts"
  21314. msgstr ""
  21315. #. type: Plain text
  21316. #: guix-git/doc/guix.texi:14701
  21317. msgid "Keyboard layouts are represented by records created by the @code{keyboard-layout} procedure of @code{(gnu system keyboard)}. Following the X Keyboard extension (XKB), each layout has four attributes: a name (often a language code such as ``fi'' for Finnish or ``jp'' for Japanese), an optional variant name, an optional keyboard model name, and a possibly empty list of additional options. In most cases the layout name is all you care about."
  21318. msgstr ""
  21319. #. type: deffn
  21320. #: guix-git/doc/guix.texi:14702
  21321. #, no-wrap
  21322. msgid "{Scheme Procedure} keyboard-layout @var{name} [@var{variant}] @"
  21323. msgstr ""
  21324. #. type: deffn
  21325. #: guix-git/doc/guix.texi:14705
  21326. msgid "[#:model] [#:options '()] Return a new keyboard layout with the given @var{name} and @var{variant}."
  21327. msgstr ""
  21328. #. type: deffn
  21329. #: guix-git/doc/guix.texi:14709
  21330. msgid "@var{name} must be a string such as @code{\"fr\"}; @var{variant} must be a string such as @code{\"bepo\"} or @code{\"nodeadkeys\"}. See the @code{xkeyboard-config} package for valid options."
  21331. msgstr ""
  21332. #. type: Plain text
  21333. #: guix-git/doc/guix.texi:14712
  21334. msgid "Here are a few examples:"
  21335. msgstr ""
  21336. #. type: lisp
  21337. #: guix-git/doc/guix.texi:14717
  21338. #, no-wrap
  21339. msgid ""
  21340. ";; The German QWERTZ layout. Here we assume a standard\n"
  21341. ";; \"pc105\" keyboard model.\n"
  21342. "(keyboard-layout \"de\")\n"
  21343. "\n"
  21344. msgstr ""
  21345. #. type: lisp
  21346. #: guix-git/doc/guix.texi:14720
  21347. #, no-wrap
  21348. msgid ""
  21349. ";; The bépo variant of the French layout.\n"
  21350. "(keyboard-layout \"fr\" \"bepo\")\n"
  21351. "\n"
  21352. msgstr ""
  21353. #. type: lisp
  21354. #: guix-git/doc/guix.texi:14723
  21355. #, no-wrap
  21356. msgid ""
  21357. ";; The Catalan layout.\n"
  21358. "(keyboard-layout \"es\" \"cat\")\n"
  21359. "\n"
  21360. msgstr ""
  21361. #. type: lisp
  21362. #: guix-git/doc/guix.texi:14726
  21363. #, no-wrap
  21364. msgid ""
  21365. ";; Arabic layout with \"Alt-Shift\" to switch to US layout.\n"
  21366. "(keyboard-layout \"ar,us\" #:options '(\"grp:alt_shift_toggle\"))\n"
  21367. "\n"
  21368. msgstr ""
  21369. #. type: lisp
  21370. #: guix-git/doc/guix.texi:14733
  21371. #, no-wrap
  21372. msgid ""
  21373. ";; The Latin American Spanish layout. In addition, the\n"
  21374. ";; \"Caps Lock\" key is used as an additional \"Ctrl\" key,\n"
  21375. ";; and the \"Menu\" key is used as a \"Compose\" key to enter\n"
  21376. ";; accented letters.\n"
  21377. "(keyboard-layout \"latam\"\n"
  21378. " #:options '(\"ctrl:nocaps\" \"compose:menu\"))\n"
  21379. "\n"
  21380. msgstr ""
  21381. #. type: lisp
  21382. #: guix-git/doc/guix.texi:14736
  21383. #, no-wrap
  21384. msgid ""
  21385. ";; The Russian layout for a ThinkPad keyboard.\n"
  21386. "(keyboard-layout \"ru\" #:model \"thinkpad\")\n"
  21387. "\n"
  21388. msgstr ""
  21389. #. type: lisp
  21390. #: guix-git/doc/guix.texi:14741
  21391. #, no-wrap
  21392. msgid ""
  21393. ";; The \"US international\" layout, which is the US layout plus\n"
  21394. ";; dead keys to enter accented characters. This is for an\n"
  21395. ";; Apple MacBook keyboard.\n"
  21396. "(keyboard-layout \"us\" \"intl\" #:model \"macbook78\")\n"
  21397. msgstr ""
  21398. #. type: Plain text
  21399. #: guix-git/doc/guix.texi:14745
  21400. msgid "See the @file{share/X11/xkb} directory of the @code{xkeyboard-config} package for a complete list of supported layouts, variants, and models."
  21401. msgstr ""
  21402. #. type: cindex
  21403. #: guix-git/doc/guix.texi:14746
  21404. #, no-wrap
  21405. msgid "keyboard layout, configuration"
  21406. msgstr ""
  21407. #. type: Plain text
  21408. #: guix-git/doc/guix.texi:14750
  21409. msgid "Let's say you want your system to use the Turkish keyboard layout throughout your system---bootloader, console, and Xorg. Here's what your system configuration would look like:"
  21410. msgstr ""
  21411. #. type: findex
  21412. #: guix-git/doc/guix.texi:14751
  21413. #, no-wrap
  21414. msgid "set-xorg-configuration"
  21415. msgstr ""
  21416. #. type: lisp
  21417. #: guix-git/doc/guix.texi:14755
  21418. #, no-wrap
  21419. msgid ""
  21420. ";; Using the Turkish layout for the bootloader, the console,\n"
  21421. ";; and for Xorg.\n"
  21422. "\n"
  21423. msgstr ""
  21424. #. type: lisp
  21425. #: guix-git/doc/guix.texi:14767
  21426. #, no-wrap
  21427. msgid ""
  21428. "(operating-system\n"
  21429. " ;; ...\n"
  21430. " (keyboard-layout (keyboard-layout \"tr\")) ;for the console\n"
  21431. " (bootloader (bootloader-configuration\n"
  21432. " (bootloader grub-efi-bootloader)\n"
  21433. " (target \"/boot/efi\")\n"
  21434. " (keyboard-layout keyboard-layout))) ;for GRUB\n"
  21435. " (services (cons (set-xorg-configuration\n"
  21436. " (xorg-configuration ;for Xorg\n"
  21437. " (keyboard-layout keyboard-layout)))\n"
  21438. " %desktop-services)))\n"
  21439. msgstr ""
  21440. #. type: Plain text
  21441. #: guix-git/doc/guix.texi:14774
  21442. msgid "In the example above, for GRUB and for Xorg, we just refer to the @code{keyboard-layout} field defined above, but we could just as well refer to a different layout. The @code{set-xorg-configuration} procedure communicates the desired Xorg configuration to the graphical log-in manager, by default GDM."
  21443. msgstr ""
  21444. #. type: Plain text
  21445. #: guix-git/doc/guix.texi:14777
  21446. msgid "We've discussed how to specify the @emph{default} keyboard layout of your system when it starts, but you can also adjust it at run time:"
  21447. msgstr ""
  21448. #. type: itemize
  21449. #: guix-git/doc/guix.texi:14782
  21450. msgid "If you're using GNOME, its settings panel has a ``Region & Language'' entry where you can select one or more keyboard layouts."
  21451. msgstr ""
  21452. #. type: itemize
  21453. #: guix-git/doc/guix.texi:14787
  21454. msgid "Under Xorg, the @command{setxkbmap} command (from the same-named package) allows you to change the current layout. For example, this is how you would change the layout to US Dvorak:"
  21455. msgstr ""
  21456. #. type: example
  21457. #: guix-git/doc/guix.texi:14790
  21458. #, no-wrap
  21459. msgid "setxkbmap us dvorak\n"
  21460. msgstr ""
  21461. #. type: itemize
  21462. #: guix-git/doc/guix.texi:14797
  21463. msgid "The @code{loadkeys} command changes the keyboard layout in effect in the Linux console. However, note that @code{loadkeys} does @emph{not} use the XKB keyboard layout categorization described above. The command below loads the French bépo layout:"
  21464. msgstr ""
  21465. #. type: example
  21466. #: guix-git/doc/guix.texi:14800
  21467. #, no-wrap
  21468. msgid "loadkeys fr-bepo\n"
  21469. msgstr ""
  21470. #. type: cindex
  21471. #: guix-git/doc/guix.texi:14806
  21472. #, no-wrap
  21473. msgid "locale"
  21474. msgstr ""
  21475. #. type: Plain text
  21476. #: guix-git/doc/guix.texi:14813
  21477. msgid "A @dfn{locale} defines cultural conventions for a particular language and region of the world (@pxref{Locales,,, libc, The GNU C Library Reference Manual}). Each locale has a name that typically has the form @code{@var{language}_@var{territory}.@var{codeset}}---e.g., @code{fr_LU.utf8} designates the locale for the French language, with cultural conventions from Luxembourg, and using the UTF-8 encoding."
  21478. msgstr ""
  21479. #. type: cindex
  21480. #: guix-git/doc/guix.texi:14814
  21481. #, no-wrap
  21482. msgid "locale definition"
  21483. msgstr ""
  21484. #. type: Plain text
  21485. #: guix-git/doc/guix.texi:14818
  21486. msgid "Usually, you will want to specify the default locale for the machine using the @code{locale} field of the @code{operating-system} declaration (@pxref{operating-system Reference, @code{locale}})."
  21487. msgstr ""
  21488. #. type: Plain text
  21489. #: guix-git/doc/guix.texi:14827
  21490. msgid "The selected locale is automatically added to the @dfn{locale definitions} known to the system if needed, with its codeset inferred from its name---e.g., @code{bo_CN.utf8} will be assumed to use the @code{UTF-8} codeset. Additional locale definitions can be specified in the @code{locale-definitions} slot of @code{operating-system}---this is useful, for instance, if the codeset could not be inferred from the locale name. The default set of locale definitions includes some widely used locales, but not all the available locales, in order to save space."
  21491. msgstr ""
  21492. #. type: Plain text
  21493. #: guix-git/doc/guix.texi:14830
  21494. msgid "For instance, to add the North Frisian locale for Germany, the value of that field may be:"
  21495. msgstr ""
  21496. #. type: lisp
  21497. #: guix-git/doc/guix.texi:14835
  21498. #, no-wrap
  21499. msgid ""
  21500. "(cons (locale-definition\n"
  21501. " (name \"fy_DE.utf8\") (source \"fy_DE\"))\n"
  21502. " %default-locale-definitions)\n"
  21503. msgstr ""
  21504. #. type: Plain text
  21505. #: guix-git/doc/guix.texi:14839
  21506. msgid "Likewise, to save space, one might want @code{locale-definitions} to list only the locales that are actually used, as in:"
  21507. msgstr ""
  21508. #. type: lisp
  21509. #: guix-git/doc/guix.texi:14844
  21510. #, no-wrap
  21511. msgid ""
  21512. "(list (locale-definition\n"
  21513. " (name \"ja_JP.eucjp\") (source \"ja_JP\")\n"
  21514. " (charset \"EUC-JP\")))\n"
  21515. msgstr ""
  21516. #. type: Plain text
  21517. #: guix-git/doc/guix.texi:14853
  21518. msgid "The compiled locale definitions are available at @file{/run/current-system/locale/X.Y}, where @code{X.Y} is the libc version, which is the default location where the GNU@tie{}libc provided by Guix looks for locale data. This can be overridden using the @env{LOCPATH} environment variable (@pxref{locales-and-locpath, @env{LOCPATH} and locale packages})."
  21519. msgstr ""
  21520. #. type: Plain text
  21521. #: guix-git/doc/guix.texi:14856
  21522. msgid "The @code{locale-definition} form is provided by the @code{(gnu system locale)} module. Details are given below."
  21523. msgstr ""
  21524. #. type: deftp
  21525. #: guix-git/doc/guix.texi:14857
  21526. #, no-wrap
  21527. msgid "{Data Type} locale-definition"
  21528. msgstr ""
  21529. #. type: deftp
  21530. #: guix-git/doc/guix.texi:14859
  21531. msgid "This is the data type of a locale definition."
  21532. msgstr ""
  21533. #. type: table
  21534. #: guix-git/doc/guix.texi:14865
  21535. msgid "The name of the locale. @xref{Locale Names,,, libc, The GNU C Library Reference Manual}, for more information on locale names."
  21536. msgstr ""
  21537. #. type: table
  21538. #: guix-git/doc/guix.texi:14869
  21539. msgid "The name of the source for that locale. This is typically the @code{@var{language}_@var{territory}} part of the locale name."
  21540. msgstr ""
  21541. #. type: item
  21542. #: guix-git/doc/guix.texi:14870
  21543. #, no-wrap
  21544. msgid "@code{charset} (default: @code{\"UTF-8\"})"
  21545. msgstr ""
  21546. #. type: table
  21547. #: guix-git/doc/guix.texi:14874
  21548. msgid "The ``character set'' or ``code set'' for that locale, @uref{https://www.iana.org/assignments/character-sets, as defined by IANA}."
  21549. msgstr ""
  21550. #. type: defvr
  21551. #: guix-git/doc/guix.texi:14878
  21552. #, no-wrap
  21553. msgid "{Scheme Variable} %default-locale-definitions"
  21554. msgstr ""
  21555. #. type: defvr
  21556. #: guix-git/doc/guix.texi:14882
  21557. msgid "A list of commonly used UTF-8 locales, used as the default value of the @code{locale-definitions} field of @code{operating-system} declarations."
  21558. msgstr ""
  21559. #. type: cindex
  21560. #: guix-git/doc/guix.texi:14883
  21561. #, no-wrap
  21562. msgid "locale name"
  21563. msgstr ""
  21564. #. type: cindex
  21565. #: guix-git/doc/guix.texi:14884
  21566. #, no-wrap
  21567. msgid "normalized codeset in locale names"
  21568. msgstr ""
  21569. #. type: defvr
  21570. #: guix-git/doc/guix.texi:14890
  21571. msgid "These locale definitions use the @dfn{normalized codeset} for the part that follows the dot in the name (@pxref{Using gettextized software, normalized codeset,, libc, The GNU C Library Reference Manual}). So for instance it has @code{uk_UA.utf8} but @emph{not}, say, @code{uk_UA.UTF-8}."
  21572. msgstr ""
  21573. #. type: subsection
  21574. #: guix-git/doc/guix.texi:14892
  21575. #, no-wrap
  21576. msgid "Locale Data Compatibility Considerations"
  21577. msgstr ""
  21578. #. type: cindex
  21579. #: guix-git/doc/guix.texi:14894
  21580. #, no-wrap
  21581. msgid "incompatibility, of locale data"
  21582. msgstr ""
  21583. #. type: Plain text
  21584. #: guix-git/doc/guix.texi:14901
  21585. msgid "@code{operating-system} declarations provide a @code{locale-libcs} field to specify the GNU@tie{}libc packages that are used to compile locale declarations (@pxref{operating-system Reference}). ``Why would I care?'', you may ask. Well, it turns out that the binary format of locale data is occasionally incompatible from one libc version to another."
  21586. msgstr ""
  21587. #. type: Plain text
  21588. #: guix-git/doc/guix.texi:14913
  21589. msgid "For instance, a program linked against libc version 2.21 is unable to read locale data produced with libc 2.22; worse, that program @emph{aborts} instead of simply ignoring the incompatible locale data@footnote{Versions 2.23 and later of GNU@tie{}libc will simply skip the incompatible locale data, which is already an improvement.}. Similarly, a program linked against libc 2.22 can read most, but not all, of the locale data from libc 2.21 (specifically, @env{LC_COLLATE} data is incompatible); thus calls to @code{setlocale} may fail, but programs will not abort."
  21590. msgstr ""
  21591. #. type: Plain text
  21592. #: guix-git/doc/guix.texi:14918
  21593. msgid "The ``problem'' with Guix is that users have a lot of freedom: They can choose whether and when to upgrade software in their profiles, and might be using a libc version different from the one the system administrator used to build the system-wide locale data."
  21594. msgstr ""
  21595. #. type: Plain text
  21596. #: guix-git/doc/guix.texi:14922
  21597. msgid "Fortunately, unprivileged users can also install their own locale data and define @env{GUIX_LOCPATH} accordingly (@pxref{locales-and-locpath, @env{GUIX_LOCPATH} and locale packages})."
  21598. msgstr ""
  21599. #. type: Plain text
  21600. #: guix-git/doc/guix.texi:14929
  21601. msgid "Still, it is best if the system-wide locale data at @file{/run/current-system/locale} is built for all the libc versions actually in use on the system, so that all the programs can access it---this is especially crucial on a multi-user system. To do that, the administrator can specify several libc packages in the @code{locale-libcs} field of @code{operating-system}:"
  21602. msgstr ""
  21603. #. type: lisp
  21604. #: guix-git/doc/guix.texi:14932
  21605. #, no-wrap
  21606. msgid ""
  21607. "(use-package-modules base)\n"
  21608. "\n"
  21609. msgstr ""
  21610. #. type: lisp
  21611. #: guix-git/doc/guix.texi:14936
  21612. #, no-wrap
  21613. msgid ""
  21614. "(operating-system\n"
  21615. " ;; @dots{}\n"
  21616. " (locale-libcs (list glibc-2.21 (canonical-package glibc))))\n"
  21617. msgstr ""
  21618. #. type: Plain text
  21619. #: guix-git/doc/guix.texi:14941
  21620. msgid "This example would lead to a system containing locale definitions for both libc 2.21 and the current version of libc in @file{/run/current-system/locale}."
  21621. msgstr ""
  21622. #. type: cindex
  21623. #: guix-git/doc/guix.texi:14946
  21624. #, no-wrap
  21625. msgid "system services"
  21626. msgstr ""
  21627. #. type: Plain text
  21628. #: guix-git/doc/guix.texi:14952
  21629. msgid "An important part of preparing an @code{operating-system} declaration is listing @dfn{system services} and their configuration (@pxref{Using the Configuration System}). System services are typically daemons launched when the system boots, or other actions needed at that time---e.g., configuring network access."
  21630. msgstr ""
  21631. #. type: Plain text
  21632. #: guix-git/doc/guix.texi:14959
  21633. msgid "Guix has a broad definition of ``service'' (@pxref{Service Composition}), but many services are managed by the GNU@tie{}Shepherd (@pxref{Shepherd Services}). On a running system, the @command{herd} command allows you to list the available services, show their status, start and stop them, or do other specific operations (@pxref{Jump Start,,, shepherd, The GNU Shepherd Manual}). For example:"
  21634. msgstr ""
  21635. #. type: example
  21636. #: guix-git/doc/guix.texi:14962
  21637. #, no-wrap
  21638. msgid "# herd status\n"
  21639. msgstr ""
  21640. #. type: Plain text
  21641. #: guix-git/doc/guix.texi:14967
  21642. msgid "The above command, run as @code{root}, lists the currently defined services. The @command{herd doc} command shows a synopsis of the given service and its associated actions:"
  21643. msgstr ""
  21644. #. type: example
  21645. #: guix-git/doc/guix.texi:14971
  21646. #, no-wrap
  21647. msgid ""
  21648. "# herd doc nscd\n"
  21649. "Run libc's name service cache daemon (nscd).\n"
  21650. "\n"
  21651. msgstr ""
  21652. #. type: example
  21653. #: guix-git/doc/guix.texi:14974
  21654. #, no-wrap
  21655. msgid ""
  21656. "# herd doc nscd action invalidate\n"
  21657. "invalidate: Invalidate the given cache--e.g., 'hosts' for host name lookups.\n"
  21658. msgstr ""
  21659. #. type: Plain text
  21660. #: guix-git/doc/guix.texi:14979
  21661. msgid "The @command{start}, @command{stop}, and @command{restart} sub-commands have the effect you would expect. For instance, the commands below stop the nscd service and restart the Xorg display server:"
  21662. msgstr ""
  21663. #. type: example
  21664. #: guix-git/doc/guix.texi:14986
  21665. #, no-wrap
  21666. msgid ""
  21667. "# herd stop nscd\n"
  21668. "Service nscd has been stopped.\n"
  21669. "# herd restart xorg-server\n"
  21670. "Service xorg-server has been stopped.\n"
  21671. "Service xorg-server has been started.\n"
  21672. msgstr ""
  21673. #. type: Plain text
  21674. #: guix-git/doc/guix.texi:14991
  21675. msgid "The following sections document the available services, starting with the core services, that may be used in an @code{operating-system} declaration."
  21676. msgstr ""
  21677. #. type: subsection
  21678. #: guix-git/doc/guix.texi:15026 guix-git/doc/guix.texi:23041
  21679. #: guix-git/doc/guix.texi:23042
  21680. #, no-wrap
  21681. msgid "File-Sharing Services"
  21682. msgstr ""
  21683. #. type: menuentry
  21684. #: guix-git/doc/guix.texi:15026
  21685. msgid "File-sharing services."
  21686. msgstr ""
  21687. #. type: Plain text
  21688. #: guix-git/doc/guix.texi:15034
  21689. msgid "The @code{(gnu services base)} module provides definitions for the basic services that one expects from the system. The services exported by this module are listed below."
  21690. msgstr ""
  21691. #. type: defvr
  21692. #: guix-git/doc/guix.texi:15035
  21693. #, no-wrap
  21694. msgid "{Scheme Variable} %base-services"
  21695. msgstr ""
  21696. #. type: defvr
  21697. #: guix-git/doc/guix.texi:15041
  21698. msgid "This variable contains a list of basic services (@pxref{Service Types and Services}, for more information on service objects) one would expect from the system: a login service (mingetty) on each tty, syslogd, the libc name service cache daemon (nscd), the udev device manager, and more."
  21699. msgstr ""
  21700. #. type: defvr
  21701. #: guix-git/doc/guix.texi:15046
  21702. msgid "This is the default value of the @code{services} field of @code{operating-system} declarations. Usually, when customizing a system, you will want to append services to @code{%base-services}, like this:"
  21703. msgstr ""
  21704. #. type: lisp
  21705. #: guix-git/doc/guix.texi:15051
  21706. #, no-wrap
  21707. msgid ""
  21708. "(append (list (service avahi-service-type)\n"
  21709. " (service openssh-service-type))\n"
  21710. " %base-services)\n"
  21711. msgstr ""
  21712. #. type: defvr
  21713. #: guix-git/doc/guix.texi:15054
  21714. #, no-wrap
  21715. msgid "{Scheme Variable} special-files-service-type"
  21716. msgstr ""
  21717. #. type: defvr
  21718. #: guix-git/doc/guix.texi:15057
  21719. msgid "This is the service that sets up ``special files'' such as @file{/bin/sh}; an instance of it is part of @code{%base-services}."
  21720. msgstr ""
  21721. #. type: defvr
  21722. #: guix-git/doc/guix.texi:15061
  21723. msgid "The value associated with @code{special-files-service-type} services must be a list of tuples where the first element is the ``special file'' and the second element is its target. By default it is:"
  21724. msgstr ""
  21725. #. type: file{#1}
  21726. #: guix-git/doc/guix.texi:15062
  21727. #, no-wrap
  21728. msgid "/bin/sh"
  21729. msgstr ""
  21730. #. type: cindex
  21731. #: guix-git/doc/guix.texi:15063
  21732. #, no-wrap
  21733. msgid "@file{sh}, in @file{/bin}"
  21734. msgstr ""
  21735. #. type: lisp
  21736. #: guix-git/doc/guix.texi:15066
  21737. #, no-wrap
  21738. msgid "`((\"/bin/sh\" ,(file-append bash \"/bin/sh\")))\n"
  21739. msgstr ""
  21740. #. type: file{#1}
  21741. #: guix-git/doc/guix.texi:15068
  21742. #, no-wrap
  21743. msgid "/usr/bin/env"
  21744. msgstr ""
  21745. #. type: cindex
  21746. #: guix-git/doc/guix.texi:15069
  21747. #, no-wrap
  21748. msgid "@file{env}, in @file{/usr/bin}"
  21749. msgstr ""
  21750. #. type: defvr
  21751. #: guix-git/doc/guix.texi:15072
  21752. msgid "If you want to add, say, @code{/usr/bin/env} to your system, you can change it to:"
  21753. msgstr ""
  21754. #. type: lisp
  21755. #: guix-git/doc/guix.texi:15076
  21756. #, no-wrap
  21757. msgid ""
  21758. "`((\"/bin/sh\" ,(file-append bash \"/bin/sh\"))\n"
  21759. " (\"/usr/bin/env\" ,(file-append coreutils \"/bin/env\")))\n"
  21760. msgstr ""
  21761. #. type: defvr
  21762. #: guix-git/doc/guix.texi:15083
  21763. msgid "Since this is part of @code{%base-services}, you can use @code{modify-services} to customize the set of special files (@pxref{Service Reference, @code{modify-services}}). But the simple way to add a special file is @i{via} the @code{extra-special-file} procedure (see below)."
  21764. msgstr ""
  21765. #. type: deffn
  21766. #: guix-git/doc/guix.texi:15085
  21767. #, no-wrap
  21768. msgid "{Scheme Procedure} extra-special-file @var{file} @var{target}"
  21769. msgstr ""
  21770. #. type: deffn
  21771. #: guix-git/doc/guix.texi:15087
  21772. msgid "Use @var{target} as the ``special file'' @var{file}."
  21773. msgstr ""
  21774. #. type: deffn
  21775. #: guix-git/doc/guix.texi:15091
  21776. msgid "For example, adding the following lines to the @code{services} field of your operating system declaration leads to a @file{/usr/bin/env} symlink:"
  21777. msgstr ""
  21778. #. type: lisp
  21779. #: guix-git/doc/guix.texi:15095
  21780. #, no-wrap
  21781. msgid ""
  21782. "(extra-special-file \"/usr/bin/env\"\n"
  21783. " (file-append coreutils \"/bin/env\"))\n"
  21784. msgstr ""
  21785. #. type: deffn
  21786. #: guix-git/doc/guix.texi:15098
  21787. #, no-wrap
  21788. msgid "{Scheme Procedure} host-name-service @var{name}"
  21789. msgstr ""
  21790. #. type: deffn
  21791. #: guix-git/doc/guix.texi:15100
  21792. msgid "Return a service that sets the host name to @var{name}."
  21793. msgstr ""
  21794. #. type: defvr
  21795. #: guix-git/doc/guix.texi:15102
  21796. #, no-wrap
  21797. msgid "{Scheme Variable} console-font-service-type"
  21798. msgstr ""
  21799. #. type: defvr
  21800. #: guix-git/doc/guix.texi:15107
  21801. msgid "Install the given fonts on the specified ttys (fonts are per virtual console on the kernel Linux). The value of this service is a list of tty/font pairs. The font can be the name of a font provided by the @code{kbd} package or any valid argument to @command{setfont}, as in this example:"
  21802. msgstr ""
  21803. #. type: lisp
  21804. #: guix-git/doc/guix.texi:15116
  21805. #, no-wrap
  21806. msgid ""
  21807. "`((\"tty1\" . \"LatGrkCyr-8x16\")\n"
  21808. " (\"tty2\" . ,(file-append\n"
  21809. " font-tamzen\n"
  21810. " \"/share/kbd/consolefonts/TamzenForPowerline10x20.psf\"))\n"
  21811. " (\"tty3\" . ,(file-append\n"
  21812. " font-terminus\n"
  21813. " \"/share/consolefonts/ter-132n\"))) ; for HDPI\n"
  21814. msgstr ""
  21815. #. type: deffn
  21816. #: guix-git/doc/guix.texi:15119
  21817. #, no-wrap
  21818. msgid "{Scheme Procedure} login-service @var{config}"
  21819. msgstr ""
  21820. #. type: deffn
  21821. #: guix-git/doc/guix.texi:15123
  21822. msgid "Return a service to run login according to @var{config}, a @code{<login-configuration>} object, which specifies the message of the day, among other things."
  21823. msgstr ""
  21824. #. type: deftp
  21825. #: guix-git/doc/guix.texi:15125
  21826. #, no-wrap
  21827. msgid "{Data Type} login-configuration"
  21828. msgstr ""
  21829. #. type: deftp
  21830. #: guix-git/doc/guix.texi:15127
  21831. msgid "This is the data type representing the configuration of login."
  21832. msgstr ""
  21833. #. type: code{#1}
  21834. #: guix-git/doc/guix.texi:15130
  21835. #, no-wrap
  21836. msgid "motd"
  21837. msgstr ""
  21838. #. type: cindex
  21839. #: guix-git/doc/guix.texi:15131
  21840. #, no-wrap
  21841. msgid "message of the day"
  21842. msgstr ""
  21843. #. type: table
  21844. #: guix-git/doc/guix.texi:15133
  21845. msgid "A file-like object containing the ``message of the day''."
  21846. msgstr ""
  21847. #. type: item
  21848. #: guix-git/doc/guix.texi:15134 guix-git/doc/guix.texi:18130
  21849. #, no-wrap
  21850. msgid "@code{allow-empty-passwords?} (default: @code{#t})"
  21851. msgstr ""
  21852. #. type: table
  21853. #: guix-git/doc/guix.texi:15137
  21854. msgid "Allow empty passwords by default so that first-time users can log in when the 'root' account has just been created."
  21855. msgstr ""
  21856. #. type: deffn
  21857. #: guix-git/doc/guix.texi:15141
  21858. #, no-wrap
  21859. msgid "{Scheme Procedure} mingetty-service @var{config}"
  21860. msgstr ""
  21861. #. type: deffn
  21862. #: guix-git/doc/guix.texi:15145
  21863. msgid "Return a service to run mingetty according to @var{config}, a @code{<mingetty-configuration>} object, which specifies the tty to run, among other things."
  21864. msgstr ""
  21865. #. type: deftp
  21866. #: guix-git/doc/guix.texi:15147
  21867. #, no-wrap
  21868. msgid "{Data Type} mingetty-configuration"
  21869. msgstr ""
  21870. #. type: deftp
  21871. #: guix-git/doc/guix.texi:15150
  21872. msgid "This is the data type representing the configuration of Mingetty, which provides the default implementation of virtual console log-in."
  21873. msgstr ""
  21874. #. type: code{#1}
  21875. #: guix-git/doc/guix.texi:15153 guix-git/doc/guix.texi:15192
  21876. #: guix-git/doc/guix.texi:32192
  21877. #, no-wrap
  21878. msgid "tty"
  21879. msgstr ""
  21880. #. type: table
  21881. #: guix-git/doc/guix.texi:15155
  21882. msgid "The name of the console this Mingetty runs on---e.g., @code{\"tty1\"}."
  21883. msgstr ""
  21884. #. type: item
  21885. #: guix-git/doc/guix.texi:15156 guix-git/doc/guix.texi:15221
  21886. #: guix-git/doc/guix.texi:15380
  21887. #, no-wrap
  21888. msgid "@code{auto-login} (default: @code{#f})"
  21889. msgstr ""
  21890. #. type: table
  21891. #: guix-git/doc/guix.texi:15160
  21892. msgid "When true, this field must be a string denoting the user name under which the system automatically logs in. When it is @code{#f}, a user name and password must be entered to log in."
  21893. msgstr ""
  21894. #. type: item
  21895. #: guix-git/doc/guix.texi:15161
  21896. #, no-wrap
  21897. msgid "@code{login-program} (default: @code{#f})"
  21898. msgstr ""
  21899. #. type: table
  21900. #: guix-git/doc/guix.texi:15165
  21901. msgid "This must be either @code{#f}, in which case the default log-in program is used (@command{login} from the Shadow tool suite), or a gexp denoting the name of the log-in program."
  21902. msgstr ""
  21903. #. type: item
  21904. #: guix-git/doc/guix.texi:15166
  21905. #, no-wrap
  21906. msgid "@code{login-pause?} (default: @code{#f})"
  21907. msgstr ""
  21908. #. type: table
  21909. #: guix-git/doc/guix.texi:15169
  21910. msgid "When set to @code{#t} in conjunction with @var{auto-login}, the user will have to press a key before the log-in shell is launched."
  21911. msgstr ""
  21912. #. type: item
  21913. #: guix-git/doc/guix.texi:15170
  21914. #, no-wrap
  21915. msgid "@code{clear-on-logout?} (default: @code{#t})"
  21916. msgstr ""
  21917. #. type: table
  21918. #: guix-git/doc/guix.texi:15172
  21919. msgid "When set to @code{#t}, the screen will be cleared after logout."
  21920. msgstr ""
  21921. #. type: item
  21922. #: guix-git/doc/guix.texi:15173
  21923. #, no-wrap
  21924. msgid "@code{mingetty} (default: @var{mingetty})"
  21925. msgstr ""
  21926. #. type: table
  21927. #: guix-git/doc/guix.texi:15175
  21928. msgid "The Mingetty package to use."
  21929. msgstr ""
  21930. #. type: deffn
  21931. #: guix-git/doc/guix.texi:15179
  21932. #, no-wrap
  21933. msgid "{Scheme Procedure} agetty-service @var{config}"
  21934. msgstr ""
  21935. #. type: deffn
  21936. #: guix-git/doc/guix.texi:15183
  21937. msgid "Return a service to run agetty according to @var{config}, an @code{<agetty-configuration>} object, which specifies the tty to run, among other things."
  21938. msgstr ""
  21939. #. type: deftp
  21940. #: guix-git/doc/guix.texi:15185
  21941. #, no-wrap
  21942. msgid "{Data Type} agetty-configuration"
  21943. msgstr ""
  21944. #. type: deftp
  21945. #: guix-git/doc/guix.texi:15189
  21946. msgid "This is the data type representing the configuration of agetty, which implements virtual and serial console log-in. See the @code{agetty(8)} man page for more information."
  21947. msgstr ""
  21948. #. type: table
  21949. #: guix-git/doc/guix.texi:15196
  21950. msgid "The name of the console this agetty runs on, as a string---e.g., @code{\"ttyS0\"}. This argument is optional, it will default to a reasonable default serial port used by the kernel Linux."
  21951. msgstr ""
  21952. #. type: table
  21953. #: guix-git/doc/guix.texi:15200
  21954. msgid "For this, if there is a value for an option @code{agetty.tty} in the kernel command line, agetty will extract the device name of the serial port from it and use that."
  21955. msgstr ""
  21956. #. type: table
  21957. #: guix-git/doc/guix.texi:15204
  21958. msgid "If not and if there is a value for an option @code{console} with a tty in the Linux command line, agetty will extract the device name of the serial port from it and use that."
  21959. msgstr ""
  21960. #. type: table
  21961. #: guix-git/doc/guix.texi:15208
  21962. msgid "In both cases, agetty will leave the other serial device settings (baud rate etc.)@: alone---in the hope that Linux pinned them to the correct values."
  21963. msgstr ""
  21964. #. type: item
  21965. #: guix-git/doc/guix.texi:15209 guix-git/doc/guix.texi:32353
  21966. #, no-wrap
  21967. msgid "@code{baud-rate} (default: @code{#f})"
  21968. msgstr ""
  21969. #. type: table
  21970. #: guix-git/doc/guix.texi:15212
  21971. msgid "A string containing a comma-separated list of one or more baud rates, in descending order."
  21972. msgstr ""
  21973. #. type: item
  21974. #: guix-git/doc/guix.texi:15213
  21975. #, no-wrap
  21976. msgid "@code{term} (default: @code{#f})"
  21977. msgstr ""
  21978. #. type: table
  21979. #: guix-git/doc/guix.texi:15216
  21980. msgid "A string containing the value used for the @env{TERM} environment variable."
  21981. msgstr ""
  21982. #. type: item
  21983. #: guix-git/doc/guix.texi:15217
  21984. #, no-wrap
  21985. msgid "@code{eight-bits?} (default: @code{#f})"
  21986. msgstr ""
  21987. #. type: table
  21988. #: guix-git/doc/guix.texi:15220
  21989. msgid "When @code{#t}, the tty is assumed to be 8-bit clean, and parity detection is disabled."
  21990. msgstr ""
  21991. #. type: table
  21992. #: guix-git/doc/guix.texi:15224 guix-git/doc/guix.texi:15383
  21993. msgid "When passed a login name, as a string, the specified user will be logged in automatically without prompting for their login name or password."
  21994. msgstr ""
  21995. #. type: item
  21996. #: guix-git/doc/guix.texi:15225
  21997. #, no-wrap
  21998. msgid "@code{no-reset?} (default: @code{#f})"
  21999. msgstr ""
  22000. #. type: table
  22001. #: guix-git/doc/guix.texi:15227
  22002. msgid "When @code{#t}, don't reset terminal cflags (control modes)."
  22003. msgstr ""
  22004. #. type: item
  22005. #: guix-git/doc/guix.texi:15228
  22006. #, no-wrap
  22007. msgid "@code{host} (default: @code{#f})"
  22008. msgstr ""
  22009. #. type: table
  22010. #: guix-git/doc/guix.texi:15231
  22011. msgid "This accepts a string containing the ``login_host'', which will be written into the @file{/var/run/utmpx} file."
  22012. msgstr ""
  22013. #. type: item
  22014. #: guix-git/doc/guix.texi:15232
  22015. #, no-wrap
  22016. msgid "@code{remote?} (default: @code{#f})"
  22017. msgstr ""
  22018. #. type: table
  22019. #: guix-git/doc/guix.texi:15236
  22020. msgid "When set to @code{#t} in conjunction with @var{host}, this will add an @code{-r} fakehost option to the command line of the login program specified in @var{login-program}."
  22021. msgstr ""
  22022. #. type: item
  22023. #: guix-git/doc/guix.texi:15237
  22024. #, no-wrap
  22025. msgid "@code{flow-control?} (default: @code{#f})"
  22026. msgstr ""
  22027. #. type: table
  22028. #: guix-git/doc/guix.texi:15239
  22029. msgid "When set to @code{#t}, enable hardware (RTS/CTS) flow control."
  22030. msgstr ""
  22031. #. type: item
  22032. #: guix-git/doc/guix.texi:15240
  22033. #, no-wrap
  22034. msgid "@code{no-issue?} (default: @code{#f})"
  22035. msgstr ""
  22036. #. type: table
  22037. #: guix-git/doc/guix.texi:15243
  22038. msgid "When set to @code{#t}, the contents of the @file{/etc/issue} file will not be displayed before presenting the login prompt."
  22039. msgstr ""
  22040. #. type: item
  22041. #: guix-git/doc/guix.texi:15244
  22042. #, no-wrap
  22043. msgid "@code{init-string} (default: @code{#f})"
  22044. msgstr ""
  22045. #. type: table
  22046. #: guix-git/doc/guix.texi:15247
  22047. msgid "This accepts a string that will be sent to the tty or modem before sending anything else. It can be used to initialize a modem."
  22048. msgstr ""
  22049. #. type: item
  22050. #: guix-git/doc/guix.texi:15248
  22051. #, no-wrap
  22052. msgid "@code{no-clear?} (default: @code{#f})"
  22053. msgstr ""
  22054. #. type: table
  22055. #: guix-git/doc/guix.texi:15251
  22056. msgid "When set to @code{#t}, agetty will not clear the screen before showing the login prompt."
  22057. msgstr ""
  22058. #. type: item
  22059. #: guix-git/doc/guix.texi:15252
  22060. #, no-wrap
  22061. msgid "@code{login-program} (default: (file-append shadow \"/bin/login\"))"
  22062. msgstr ""
  22063. #. type: table
  22064. #: guix-git/doc/guix.texi:15256
  22065. msgid "This must be either a gexp denoting the name of a log-in program, or unset, in which case the default value is the @command{login} from the Shadow tool suite."
  22066. msgstr ""
  22067. #. type: item
  22068. #: guix-git/doc/guix.texi:15257
  22069. #, no-wrap
  22070. msgid "@code{local-line} (default: @code{#f})"
  22071. msgstr ""
  22072. #. type: table
  22073. #: guix-git/doc/guix.texi:15261
  22074. msgid "Control the CLOCAL line flag. This accepts one of three symbols as arguments, @code{'auto}, @code{'always}, or @code{'never}. If @code{#f}, the default value chosen by agetty is @code{'auto}."
  22075. msgstr ""
  22076. #. type: item
  22077. #: guix-git/doc/guix.texi:15262
  22078. #, no-wrap
  22079. msgid "@code{extract-baud?} (default: @code{#f})"
  22080. msgstr ""
  22081. #. type: table
  22082. #: guix-git/doc/guix.texi:15265
  22083. msgid "When set to @code{#t}, instruct agetty to try to extract the baud rate from the status messages produced by certain types of modems."
  22084. msgstr ""
  22085. #. type: item
  22086. #: guix-git/doc/guix.texi:15266
  22087. #, no-wrap
  22088. msgid "@code{skip-login?} (default: @code{#f})"
  22089. msgstr ""
  22090. #. type: table
  22091. #: guix-git/doc/guix.texi:15270
  22092. msgid "When set to @code{#t}, do not prompt the user for a login name. This can be used with @var{login-program} field to use non-standard login systems."
  22093. msgstr ""
  22094. #. type: item
  22095. #: guix-git/doc/guix.texi:15271
  22096. #, no-wrap
  22097. msgid "@code{no-newline?} (default: @code{#f})"
  22098. msgstr ""
  22099. #. type: table
  22100. #: guix-git/doc/guix.texi:15274
  22101. msgid "When set to @code{#t}, do not print a newline before printing the @file{/etc/issue} file."
  22102. msgstr ""
  22103. #. type: item
  22104. #: guix-git/doc/guix.texi:15276
  22105. #, no-wrap
  22106. msgid "@code{login-options} (default: @code{#f})"
  22107. msgstr ""
  22108. #. type: table
  22109. #: guix-git/doc/guix.texi:15281
  22110. msgid "This option accepts a string containing options that are passed to the login program. When used with the @var{login-program}, be aware that a malicious user could try to enter a login name containing embedded options that could be parsed by the login program."
  22111. msgstr ""
  22112. #. type: item
  22113. #: guix-git/doc/guix.texi:15282
  22114. #, no-wrap
  22115. msgid "@code{login-pause} (default: @code{#f})"
  22116. msgstr ""
  22117. #. type: table
  22118. #: guix-git/doc/guix.texi:15286
  22119. msgid "When set to @code{#t}, wait for any key before showing the login prompt. This can be used in conjunction with @var{auto-login} to save memory by lazily spawning shells."
  22120. msgstr ""
  22121. #. type: item
  22122. #: guix-git/doc/guix.texi:15287
  22123. #, no-wrap
  22124. msgid "@code{chroot} (default: @code{#f})"
  22125. msgstr ""
  22126. #. type: table
  22127. #: guix-git/doc/guix.texi:15290
  22128. msgid "Change root to the specified directory. This option accepts a directory path as a string."
  22129. msgstr ""
  22130. #. type: item
  22131. #: guix-git/doc/guix.texi:15291
  22132. #, no-wrap
  22133. msgid "@code{hangup?} (default: @code{#f})"
  22134. msgstr ""
  22135. #. type: table
  22136. #: guix-git/doc/guix.texi:15294
  22137. msgid "Use the Linux system call @code{vhangup} to do a virtual hangup of the specified terminal."
  22138. msgstr ""
  22139. #. type: item
  22140. #: guix-git/doc/guix.texi:15295
  22141. #, no-wrap
  22142. msgid "@code{keep-baud?} (default: @code{#f})"
  22143. msgstr ""
  22144. #. type: table
  22145. #: guix-git/doc/guix.texi:15299
  22146. msgid "When set to @code{#t}, try to keep the existing baud rate. The baud rates from @var{baud-rate} are used when agetty receives a @key{BREAK} character."
  22147. msgstr ""
  22148. #. type: item
  22149. #: guix-git/doc/guix.texi:15300
  22150. #, no-wrap
  22151. msgid "@code{timeout} (default: @code{#f})"
  22152. msgstr ""
  22153. #. type: table
  22154. #: guix-git/doc/guix.texi:15303
  22155. msgid "When set to an integer value, terminate if no user name could be read within @var{timeout} seconds."
  22156. msgstr ""
  22157. #. type: item
  22158. #: guix-git/doc/guix.texi:15304
  22159. #, no-wrap
  22160. msgid "@code{detect-case?} (default: @code{#f})"
  22161. msgstr ""
  22162. #. type: table
  22163. #: guix-git/doc/guix.texi:15310
  22164. msgid "When set to @code{#t}, turn on support for detecting an uppercase-only terminal. This setting will detect a login name containing only uppercase letters as indicating an uppercase-only terminal and turn on some upper-to-lower case conversions. Note that this will not support Unicode characters."
  22165. msgstr ""
  22166. #. type: item
  22167. #: guix-git/doc/guix.texi:15311
  22168. #, no-wrap
  22169. msgid "@code{wait-cr?} (default: @code{#f})"
  22170. msgstr ""
  22171. #. type: table
  22172. #: guix-git/doc/guix.texi:15316
  22173. msgid "When set to @code{#t}, wait for the user or modem to send a carriage-return or linefeed character before displaying @file{/etc/issue} or login prompt. This is typically used with the @var{init-string} option."
  22174. msgstr ""
  22175. #. type: item
  22176. #: guix-git/doc/guix.texi:15317
  22177. #, no-wrap
  22178. msgid "@code{no-hints?} (default: @code{#f})"
  22179. msgstr ""
  22180. #. type: table
  22181. #: guix-git/doc/guix.texi:15320
  22182. msgid "When set to @code{#t}, do not print hints about Num, Caps, and Scroll locks."
  22183. msgstr ""
  22184. #. type: item
  22185. #: guix-git/doc/guix.texi:15321
  22186. #, no-wrap
  22187. msgid "@code{no-hostname?} (default: @code{#f})"
  22188. msgstr ""
  22189. #. type: table
  22190. #: guix-git/doc/guix.texi:15324
  22191. msgid "By default, the hostname is printed. When this option is set to @code{#t}, no hostname will be shown at all."
  22192. msgstr ""
  22193. #. type: item
  22194. #: guix-git/doc/guix.texi:15325
  22195. #, no-wrap
  22196. msgid "@code{long-hostname?} (default: @code{#f})"
  22197. msgstr ""
  22198. #. type: table
  22199. #: guix-git/doc/guix.texi:15329
  22200. msgid "By default, the hostname is only printed until the first dot. When this option is set to @code{#t}, the fully qualified hostname by @code{gethostname} or @code{getaddrinfo} is shown."
  22201. msgstr ""
  22202. #. type: item
  22203. #: guix-git/doc/guix.texi:15330
  22204. #, no-wrap
  22205. msgid "@code{erase-characters} (default: @code{#f})"
  22206. msgstr ""
  22207. #. type: table
  22208. #: guix-git/doc/guix.texi:15333
  22209. msgid "This option accepts a string of additional characters that should be interpreted as backspace when the user types their login name."
  22210. msgstr ""
  22211. #. type: item
  22212. #: guix-git/doc/guix.texi:15334
  22213. #, no-wrap
  22214. msgid "@code{kill-characters} (default: @code{#f})"
  22215. msgstr ""
  22216. #. type: table
  22217. #: guix-git/doc/guix.texi:15338
  22218. msgid "This option accepts a string that should be interpreted to mean ``ignore all previous characters'' (also called a ``kill'' character) when the user types their login name."
  22219. msgstr ""
  22220. #. type: item
  22221. #: guix-git/doc/guix.texi:15339
  22222. #, no-wrap
  22223. msgid "@code{chdir} (default: @code{#f})"
  22224. msgstr ""
  22225. #. type: table
  22226. #: guix-git/doc/guix.texi:15342
  22227. msgid "This option accepts, as a string, a directory path that will be changed to before login."
  22228. msgstr ""
  22229. #. type: item
  22230. #: guix-git/doc/guix.texi:15343
  22231. #, no-wrap
  22232. msgid "@code{delay} (default: @code{#f})"
  22233. msgstr ""
  22234. #. type: table
  22235. #: guix-git/doc/guix.texi:15346
  22236. msgid "This options accepts, as an integer, the number of seconds to sleep before opening the tty and displaying the login prompt."
  22237. msgstr ""
  22238. #. type: item
  22239. #: guix-git/doc/guix.texi:15347
  22240. #, no-wrap
  22241. msgid "@code{nice} (default: @code{#f})"
  22242. msgstr ""
  22243. #. type: table
  22244. #: guix-git/doc/guix.texi:15350
  22245. msgid "This option accepts, as an integer, the nice value with which to run the @command{login} program."
  22246. msgstr ""
  22247. #. type: item
  22248. #: guix-git/doc/guix.texi:15351 guix-git/doc/guix.texi:15639
  22249. #: guix-git/doc/guix.texi:16510 guix-git/doc/guix.texi:24024
  22250. #: guix-git/doc/guix.texi:25500 guix-git/doc/guix.texi:27907
  22251. #: guix-git/doc/guix.texi:28702 guix-git/doc/guix.texi:30402
  22252. #: guix-git/doc/guix.texi:32683
  22253. #, no-wrap
  22254. msgid "@code{extra-options} (default: @code{'()})"
  22255. msgstr ""
  22256. #. type: table
  22257. #: guix-git/doc/guix.texi:15354
  22258. msgid "This option provides an ``escape hatch'' for the user to provide arbitrary command-line arguments to @command{agetty} as a list of strings."
  22259. msgstr ""
  22260. #. type: deffn
  22261. #: guix-git/doc/guix.texi:15358
  22262. #, no-wrap
  22263. msgid "{Scheme Procedure} kmscon-service-type @var{config}"
  22264. msgstr ""
  22265. #. type: deffn
  22266. #: guix-git/doc/guix.texi:15362
  22267. msgid "Return a service to run @uref{https://www.freedesktop.org/wiki/Software/kmscon,kmscon} according to @var{config}, a @code{<kmscon-configuration>} object, which specifies the tty to run, among other things."
  22268. msgstr ""
  22269. #. type: deftp
  22270. #: guix-git/doc/guix.texi:15364
  22271. #, no-wrap
  22272. msgid "{Data Type} kmscon-configuration"
  22273. msgstr ""
  22274. #. type: deftp
  22275. #: guix-git/doc/guix.texi:15367
  22276. msgid "This is the data type representing the configuration of Kmscon, which implements virtual console log-in."
  22277. msgstr ""
  22278. #. type: code{#1}
  22279. #: guix-git/doc/guix.texi:15370
  22280. #, no-wrap
  22281. msgid "virtual-terminal"
  22282. msgstr ""
  22283. #. type: table
  22284. #: guix-git/doc/guix.texi:15372
  22285. msgid "The name of the console this Kmscon runs on---e.g., @code{\"tty1\"}."
  22286. msgstr ""
  22287. #. type: item
  22288. #: guix-git/doc/guix.texi:15373
  22289. #, no-wrap
  22290. msgid "@code{login-program} (default: @code{#~(string-append #$shadow \"/bin/login\")})"
  22291. msgstr ""
  22292. #. type: table
  22293. #: guix-git/doc/guix.texi:15376
  22294. msgid "A gexp denoting the name of the log-in program. The default log-in program is @command{login} from the Shadow tool suite."
  22295. msgstr ""
  22296. #. type: item
  22297. #: guix-git/doc/guix.texi:15377
  22298. #, no-wrap
  22299. msgid "@code{login-arguments} (default: @code{'(\"-p\")})"
  22300. msgstr ""
  22301. #. type: table
  22302. #: guix-git/doc/guix.texi:15379
  22303. msgid "A list of arguments to pass to @command{login}."
  22304. msgstr ""
  22305. #. type: item
  22306. #: guix-git/doc/guix.texi:15384
  22307. #, no-wrap
  22308. msgid "@code{hardware-acceleration?} (default: #f)"
  22309. msgstr ""
  22310. #. type: table
  22311. #: guix-git/doc/guix.texi:15386
  22312. msgid "Whether to use hardware acceleration."
  22313. msgstr ""
  22314. #. type: item
  22315. #: guix-git/doc/guix.texi:15387
  22316. #, no-wrap
  22317. msgid "@code{font-engine} (default: @code{\"pango\"})"
  22318. msgstr ""
  22319. #. type: table
  22320. #: guix-git/doc/guix.texi:15389
  22321. msgid "Font engine used in Kmscon."
  22322. msgstr ""
  22323. #. type: item
  22324. #: guix-git/doc/guix.texi:15390
  22325. #, no-wrap
  22326. msgid "@code{font-size} (default: @code{12})"
  22327. msgstr ""
  22328. #. type: table
  22329. #: guix-git/doc/guix.texi:15392
  22330. msgid "Font size used in Kmscon."
  22331. msgstr ""
  22332. #. type: table
  22333. #: guix-git/doc/guix.texi:15396
  22334. msgid "If this is @code{#f}, Kmscon uses the default keyboard layout---usually US English (``qwerty'') for a 105-key PC keyboard."
  22335. msgstr ""
  22336. #. type: table
  22337. #: guix-git/doc/guix.texi:15400
  22338. msgid "Otherwise this must be a @code{keyboard-layout} object specifying the keyboard layout. @xref{Keyboard Layout}, for more information on how to specify the keyboard layout."
  22339. msgstr ""
  22340. #. type: item
  22341. #: guix-git/doc/guix.texi:15401
  22342. #, no-wrap
  22343. msgid "@code{kmscon} (default: @var{kmscon})"
  22344. msgstr ""
  22345. #. type: table
  22346. #: guix-git/doc/guix.texi:15403
  22347. msgid "The Kmscon package to use."
  22348. msgstr ""
  22349. #. type: cindex
  22350. #: guix-git/doc/guix.texi:15407
  22351. #, no-wrap
  22352. msgid "name service cache daemon"
  22353. msgstr ""
  22354. #. type: cindex
  22355. #: guix-git/doc/guix.texi:15408
  22356. #, no-wrap
  22357. msgid "nscd"
  22358. msgstr ""
  22359. #. type: deffn
  22360. #: guix-git/doc/guix.texi:15409
  22361. #, no-wrap
  22362. msgid "{Scheme Procedure} nscd-service [@var{config}] [#:glibc glibc] @"
  22363. msgstr ""
  22364. #. type: deffn
  22365. #: guix-git/doc/guix.texi:15414
  22366. msgid "[#:name-services '()] Return a service that runs the libc name service cache daemon (nscd) with the given @var{config}---an @code{<nscd-configuration>} object. @xref{Name Service Switch}, for an example."
  22367. msgstr ""
  22368. #. type: deffn
  22369. #: guix-git/doc/guix.texi:15416
  22370. msgid "For convenience, the Shepherd service for nscd provides the following actions:"
  22371. msgstr ""
  22372. #. type: item
  22373. #: guix-git/doc/guix.texi:15418
  22374. #, no-wrap
  22375. msgid "invalidate"
  22376. msgstr ""
  22377. #. type: cindex
  22378. #: guix-git/doc/guix.texi:15419
  22379. #, no-wrap
  22380. msgid "cache invalidation, nscd"
  22381. msgstr ""
  22382. #. type: cindex
  22383. #: guix-git/doc/guix.texi:15420
  22384. #, no-wrap
  22385. msgid "nscd, cache invalidation"
  22386. msgstr ""
  22387. #. type: table
  22388. #: guix-git/doc/guix.texi:15422
  22389. msgid "This invalidate the given cache. For instance, running:"
  22390. msgstr ""
  22391. #. type: example
  22392. #: guix-git/doc/guix.texi:15425
  22393. #, no-wrap
  22394. msgid "herd invalidate nscd hosts\n"
  22395. msgstr ""
  22396. #. type: table
  22397. #: guix-git/doc/guix.texi:15429
  22398. msgid "invalidates the host name lookup cache of nscd."
  22399. msgstr ""
  22400. #. type: item
  22401. #: guix-git/doc/guix.texi:15430
  22402. #, no-wrap
  22403. msgid "statistics"
  22404. msgstr ""
  22405. #. type: table
  22406. #: guix-git/doc/guix.texi:15433
  22407. msgid "Running @command{herd statistics nscd} displays information about nscd usage and caches."
  22408. msgstr ""
  22409. #. type: defvr
  22410. #: guix-git/doc/guix.texi:15437
  22411. #, no-wrap
  22412. msgid "{Scheme Variable} %nscd-default-configuration"
  22413. msgstr ""
  22414. #. type: defvr
  22415. #: guix-git/doc/guix.texi:15441
  22416. msgid "This is the default @code{<nscd-configuration>} value (see below) used by @code{nscd-service}. It uses the caches defined by @code{%nscd-default-caches}; see below."
  22417. msgstr ""
  22418. #. type: deftp
  22419. #: guix-git/doc/guix.texi:15443
  22420. #, no-wrap
  22421. msgid "{Data Type} nscd-configuration"
  22422. msgstr ""
  22423. #. type: deftp
  22424. #: guix-git/doc/guix.texi:15446
  22425. msgid "This is the data type representing the name service cache daemon (nscd) configuration."
  22426. msgstr ""
  22427. #. type: item
  22428. #: guix-git/doc/guix.texi:15449
  22429. #, no-wrap
  22430. msgid "@code{name-services} (default: @code{'()})"
  22431. msgstr ""
  22432. #. type: table
  22433. #: guix-git/doc/guix.texi:15452
  22434. msgid "List of packages denoting @dfn{name services} that must be visible to the nscd---e.g., @code{(list @var{nss-mdns})}."
  22435. msgstr ""
  22436. #. type: item
  22437. #: guix-git/doc/guix.texi:15453
  22438. #, no-wrap
  22439. msgid "@code{glibc} (default: @var{glibc})"
  22440. msgstr ""
  22441. #. type: table
  22442. #: guix-git/doc/guix.texi:15456
  22443. msgid "Package object denoting the GNU C Library providing the @command{nscd} command."
  22444. msgstr ""
  22445. #. type: item
  22446. #: guix-git/doc/guix.texi:15457
  22447. #, no-wrap
  22448. msgid "@code{log-file} (default: @code{\"/var/log/nscd.log\"})"
  22449. msgstr ""
  22450. #. type: table
  22451. #: guix-git/doc/guix.texi:15460
  22452. msgid "Name of the nscd log file. This is where debugging output goes when @code{debug-level} is strictly positive."
  22453. msgstr ""
  22454. #. type: item
  22455. #: guix-git/doc/guix.texi:15461
  22456. #, no-wrap
  22457. msgid "@code{debug-level} (default: @code{0})"
  22458. msgstr ""
  22459. #. type: table
  22460. #: guix-git/doc/guix.texi:15464
  22461. msgid "Integer denoting the debugging levels. Higher numbers mean that more debugging output is logged."
  22462. msgstr ""
  22463. #. type: item
  22464. #: guix-git/doc/guix.texi:15465
  22465. #, no-wrap
  22466. msgid "@code{caches} (default: @code{%nscd-default-caches})"
  22467. msgstr ""
  22468. #. type: table
  22469. #: guix-git/doc/guix.texi:15468
  22470. msgid "List of @code{<nscd-cache>} objects denoting things to be cached; see below."
  22471. msgstr ""
  22472. #. type: deftp
  22473. #: guix-git/doc/guix.texi:15472
  22474. #, no-wrap
  22475. msgid "{Data Type} nscd-cache"
  22476. msgstr ""
  22477. #. type: deftp
  22478. #: guix-git/doc/guix.texi:15474
  22479. msgid "Data type representing a cache database of nscd and its parameters."
  22480. msgstr ""
  22481. #. type: cindex
  22482. #: guix-git/doc/guix.texi:15477 guix-git/doc/guix.texi:19914
  22483. #, no-wrap
  22484. msgid "database"
  22485. msgstr ""
  22486. #. type: table
  22487. #: guix-git/doc/guix.texi:15482
  22488. msgid "This is a symbol representing the name of the database to be cached. Valid values are @code{passwd}, @code{group}, @code{hosts}, and @code{services}, which designate the corresponding NSS database (@pxref{NSS Basics,,, libc, The GNU C Library Reference Manual})."
  22489. msgstr ""
  22490. #. type: code{#1}
  22491. #: guix-git/doc/guix.texi:15483
  22492. #, no-wrap
  22493. msgid "positive-time-to-live"
  22494. msgstr ""
  22495. #. type: itemx
  22496. #: guix-git/doc/guix.texi:15484
  22497. #, no-wrap
  22498. msgid "@code{negative-time-to-live} (default: @code{20})"
  22499. msgstr ""
  22500. #. type: table
  22501. #: guix-git/doc/guix.texi:15487
  22502. msgid "A number representing the number of seconds during which a positive or negative lookup result remains in cache."
  22503. msgstr ""
  22504. #. type: item
  22505. #: guix-git/doc/guix.texi:15488
  22506. #, no-wrap
  22507. msgid "@code{check-files?} (default: @code{#t})"
  22508. msgstr ""
  22509. #. type: table
  22510. #: guix-git/doc/guix.texi:15491
  22511. msgid "Whether to check for updates of the files corresponding to @var{database}."
  22512. msgstr ""
  22513. #. type: table
  22514. #: guix-git/doc/guix.texi:15495
  22515. msgid "For instance, when @var{database} is @code{hosts}, setting this flag instructs nscd to check for updates in @file{/etc/hosts} and to take them into account."
  22516. msgstr ""
  22517. #. type: item
  22518. #: guix-git/doc/guix.texi:15496
  22519. #, no-wrap
  22520. msgid "@code{persistent?} (default: @code{#t})"
  22521. msgstr ""
  22522. #. type: table
  22523. #: guix-git/doc/guix.texi:15498
  22524. msgid "Whether the cache should be stored persistently on disk."
  22525. msgstr ""
  22526. #. type: item
  22527. #: guix-git/doc/guix.texi:15499
  22528. #, no-wrap
  22529. msgid "@code{shared?} (default: @code{#t})"
  22530. msgstr ""
  22531. #. type: table
  22532. #: guix-git/doc/guix.texi:15501
  22533. msgid "Whether the cache should be shared among users."
  22534. msgstr ""
  22535. #. type: item
  22536. #: guix-git/doc/guix.texi:15502
  22537. #, no-wrap
  22538. msgid "@code{max-database-size} (default: 32@tie{}MiB)"
  22539. msgstr ""
  22540. #. type: table
  22541. #: guix-git/doc/guix.texi:15504
  22542. msgid "Maximum size in bytes of the database cache."
  22543. msgstr ""
  22544. #. type: defvr
  22545. #: guix-git/doc/guix.texi:15511
  22546. #, no-wrap
  22547. msgid "{Scheme Variable} %nscd-default-caches"
  22548. msgstr ""
  22549. #. type: defvr
  22550. #: guix-git/doc/guix.texi:15514
  22551. msgid "List of @code{<nscd-cache>} objects used by default by @code{nscd-configuration} (see above)."
  22552. msgstr ""
  22553. #. type: defvr
  22554. #: guix-git/doc/guix.texi:15520
  22555. msgid "It enables persistent and aggressive caching of service and host name lookups. The latter provides better host name lookup performance, resilience in the face of unreliable name servers, and also better privacy---often the result of host name lookups is in local cache, so external name servers do not even need to be queried."
  22556. msgstr ""
  22557. #. type: anchor{#1}
  22558. #: guix-git/doc/guix.texi:15523
  22559. msgid "syslog-configuration-type"
  22560. msgstr ""
  22561. #. type: cindex
  22562. #: guix-git/doc/guix.texi:15523 guix-git/doc/guix.texi:15539
  22563. #, no-wrap
  22564. msgid "syslog"
  22565. msgstr ""
  22566. #. type: cindex
  22567. #: guix-git/doc/guix.texi:15524 guix-git/doc/guix.texi:16110
  22568. #, no-wrap
  22569. msgid "logging"
  22570. msgstr ""
  22571. #. type: deftp
  22572. #: guix-git/doc/guix.texi:15525
  22573. #, no-wrap
  22574. msgid "{Data Type} syslog-configuration"
  22575. msgstr ""
  22576. #. type: deftp
  22577. #: guix-git/doc/guix.texi:15527
  22578. msgid "This data type represents the configuration of the syslog daemon."
  22579. msgstr ""
  22580. #. type: item
  22581. #: guix-git/doc/guix.texi:15529
  22582. #, no-wrap
  22583. msgid "@code{syslogd} (default: @code{#~(string-append #$inetutils \"/libexec/syslogd\")})"
  22584. msgstr ""
  22585. #. type: table
  22586. #: guix-git/doc/guix.texi:15531
  22587. msgid "The syslog daemon to use."
  22588. msgstr ""
  22589. #. type: item
  22590. #: guix-git/doc/guix.texi:15532
  22591. #, no-wrap
  22592. msgid "@code{config-file} (default: @code{%default-syslog.conf})"
  22593. msgstr ""
  22594. #. type: table
  22595. #: guix-git/doc/guix.texi:15534
  22596. msgid "The syslog configuration file to use."
  22597. msgstr ""
  22598. #. type: anchor{#1}
  22599. #: guix-git/doc/guix.texi:15539
  22600. msgid "syslog-service"
  22601. msgstr ""
  22602. #. type: deffn
  22603. #: guix-git/doc/guix.texi:15540
  22604. #, no-wrap
  22605. msgid "{Scheme Procedure} syslog-service @var{config}"
  22606. msgstr ""
  22607. #. type: deffn
  22608. #: guix-git/doc/guix.texi:15542
  22609. msgid "Return a service that runs a syslog daemon according to @var{config}."
  22610. msgstr ""
  22611. #. type: deffn
  22612. #: guix-git/doc/guix.texi:15545
  22613. msgid "@xref{syslogd invocation,,, inetutils, GNU Inetutils}, for more information on the configuration file syntax."
  22614. msgstr ""
  22615. #. type: defvr
  22616. #: guix-git/doc/guix.texi:15547
  22617. #, no-wrap
  22618. msgid "{Scheme Variable} guix-service-type"
  22619. msgstr ""
  22620. #. type: defvr
  22621. #: guix-git/doc/guix.texi:15551
  22622. msgid "This is the type of the service that runs the build daemon, @command{guix-daemon} (@pxref{Invoking guix-daemon}). Its value must be a @code{guix-configuration} record as described below."
  22623. msgstr ""
  22624. #. type: anchor{#1}
  22625. #: guix-git/doc/guix.texi:15554
  22626. msgid "guix-configuration-type"
  22627. msgstr ""
  22628. #. type: deftp
  22629. #: guix-git/doc/guix.texi:15554
  22630. #, no-wrap
  22631. msgid "{Data Type} guix-configuration"
  22632. msgstr ""
  22633. #. type: deftp
  22634. #: guix-git/doc/guix.texi:15557
  22635. msgid "This data type represents the configuration of the Guix build daemon. @xref{Invoking guix-daemon}, for more information."
  22636. msgstr ""
  22637. #. type: item
  22638. #: guix-git/doc/guix.texi:15559
  22639. #, no-wrap
  22640. msgid "@code{guix} (default: @var{guix})"
  22641. msgstr ""
  22642. #. type: table
  22643. #: guix-git/doc/guix.texi:15561 guix-git/doc/guix.texi:15838
  22644. msgid "The Guix package to use."
  22645. msgstr ""
  22646. #. type: item
  22647. #: guix-git/doc/guix.texi:15562
  22648. #, no-wrap
  22649. msgid "@code{build-group} (default: @code{\"guixbuild\"})"
  22650. msgstr ""
  22651. #. type: table
  22652. #: guix-git/doc/guix.texi:15564
  22653. msgid "Name of the group for build user accounts."
  22654. msgstr ""
  22655. #. type: item
  22656. #: guix-git/doc/guix.texi:15565
  22657. #, no-wrap
  22658. msgid "@code{build-accounts} (default: @code{10})"
  22659. msgstr ""
  22660. #. type: table
  22661. #: guix-git/doc/guix.texi:15567
  22662. msgid "Number of build user accounts to create."
  22663. msgstr ""
  22664. #. type: item
  22665. #: guix-git/doc/guix.texi:15568
  22666. #, no-wrap
  22667. msgid "@code{authorize-key?} (default: @code{#t})"
  22668. msgstr ""
  22669. #. type: table
  22670. #: guix-git/doc/guix.texi:15575
  22671. msgid "Whether to authorize the substitute keys listed in @code{authorized-keys}---by default that of @code{@value{SUBSTITUTE-SERVER-1}} and @code{@value{SUBSTITUTE-SERVER-2}} (@pxref{Substitutes})."
  22672. msgstr ""
  22673. #. type: table
  22674. #: guix-git/doc/guix.texi:15581
  22675. msgid "When @code{authorize-key?} is true, @file{/etc/guix/acl} cannot be changed by invoking @command{guix archive --authorize}. You must instead adjust @code{guix-configuration} as you wish and reconfigure the system. This ensures that your operating system configuration file is self-contained."
  22676. msgstr ""
  22677. #. type: quotation
  22678. #: guix-git/doc/guix.texi:15588
  22679. msgid "When booting or reconfiguring to a system where @code{authorize-key?} is true, the existing @file{/etc/guix/acl} file is backed up as @file{/etc/guix/acl.bak} if it was determined to be a manually modified file. This is to facilitate migration from earlier versions, which allowed for in-place modifications to @file{/etc/guix/acl}."
  22680. msgstr ""
  22681. #. type: vindex
  22682. #: guix-git/doc/guix.texi:15590
  22683. #, no-wrap
  22684. msgid "%default-authorized-guix-keys"
  22685. msgstr ""
  22686. #. type: item
  22687. #: guix-git/doc/guix.texi:15591
  22688. #, no-wrap
  22689. msgid "@code{authorized-keys} (default: @code{%default-authorized-guix-keys})"
  22690. msgstr ""
  22691. #. type: table
  22692. #: guix-git/doc/guix.texi:15597
  22693. msgid "The list of authorized key files for archive imports, as a list of string-valued gexps (@pxref{Invoking guix archive}). By default, it contains that of @code{@value{SUBSTITUTE-SERVER-1}} and @code{@value{SUBSTITUTE-SERVER-2}} (@pxref{Substitutes}). See @code{substitute-urls} below for an example on how to change it."
  22694. msgstr ""
  22695. #. type: item
  22696. #: guix-git/doc/guix.texi:15598
  22697. #, no-wrap
  22698. msgid "@code{use-substitutes?} (default: @code{#t})"
  22699. msgstr ""
  22700. #. type: table
  22701. #: guix-git/doc/guix.texi:15600
  22702. msgid "Whether to use substitutes."
  22703. msgstr ""
  22704. #. type: item
  22705. #: guix-git/doc/guix.texi:15601 guix-git/doc/guix.texi:28004
  22706. #, no-wrap
  22707. msgid "@code{substitute-urls} (default: @code{%default-substitute-urls})"
  22708. msgstr ""
  22709. #. type: table
  22710. #: guix-git/doc/guix.texi:15603 guix-git/doc/guix.texi:28006
  22711. msgid "The list of URLs where to look for substitutes by default."
  22712. msgstr ""
  22713. #. type: table
  22714. #: guix-git/doc/guix.texi:15610
  22715. msgid "Suppose you would like to fetch substitutes from @code{guix.example.org} in addition to @code{@value{SUBSTITUTE-SERVER-1}}. You will need to do two things: (1) add @code{guix.example.org} to @code{substitute-urls}, and (2) authorize its signing key, having done appropriate checks (@pxref{Substitute Server Authorization}). The configuration below does exactly that:"
  22716. msgstr ""
  22717. #. type: lisp
  22718. #: guix-git/doc/guix.texi:15619
  22719. #, no-wrap
  22720. msgid ""
  22721. "(guix-configuration\n"
  22722. " (substitute-urls\n"
  22723. " (append (list \"https://guix.example.org\")\n"
  22724. " %default-substitute-urls))\n"
  22725. " (authorized-keys\n"
  22726. " (append (list (local-file \"./guix.example.org-key.pub\"))\n"
  22727. " %default-authorized-guix-keys)))\n"
  22728. msgstr ""
  22729. #. type: table
  22730. #: guix-git/doc/guix.texi:15624
  22731. msgid "This example assumes that the file @file{./guix.example.org-key.pub} contains the public key that @code{guix.example.org} uses to sign substitutes."
  22732. msgstr ""
  22733. #. type: item
  22734. #: guix-git/doc/guix.texi:15625
  22735. #, no-wrap
  22736. msgid "@code{max-silent-time} (default: @code{0})"
  22737. msgstr ""
  22738. #. type: itemx
  22739. #: guix-git/doc/guix.texi:15626
  22740. #, no-wrap
  22741. msgid "@code{timeout} (default: @code{0})"
  22742. msgstr ""
  22743. #. type: table
  22744. #: guix-git/doc/guix.texi:15630
  22745. msgid "The number of seconds of silence and the number of seconds of activity, respectively, after which a build process times out. A value of zero disables the timeout."
  22746. msgstr ""
  22747. #. type: item
  22748. #: guix-git/doc/guix.texi:15631
  22749. #, no-wrap
  22750. msgid "@code{log-compression} (default: @code{'bzip2})"
  22751. msgstr ""
  22752. #. type: table
  22753. #: guix-git/doc/guix.texi:15634
  22754. msgid "The type of compression used for build logs---one of @code{gzip}, @code{bzip2}, or @code{none}."
  22755. msgstr ""
  22756. #. type: item
  22757. #: guix-git/doc/guix.texi:15635
  22758. #, no-wrap
  22759. msgid "@code{discover?} (default: @code{#f})"
  22760. msgstr ""
  22761. #. type: table
  22762. #: guix-git/doc/guix.texi:15641
  22763. msgid "List of extra command-line options for @command{guix-daemon}."
  22764. msgstr ""
  22765. #. type: item
  22766. #: guix-git/doc/guix.texi:15642
  22767. #, no-wrap
  22768. msgid "@code{log-file} (default: @code{\"/var/log/guix-daemon.log\"})"
  22769. msgstr ""
  22770. #. type: table
  22771. #: guix-git/doc/guix.texi:15645
  22772. msgid "File where @command{guix-daemon}'s standard output and standard error are written."
  22773. msgstr ""
  22774. #. type: cindex
  22775. #: guix-git/doc/guix.texi:15646
  22776. #, no-wrap
  22777. msgid "HTTP proxy, for @code{guix-daemon}"
  22778. msgstr ""
  22779. #. type: cindex
  22780. #: guix-git/doc/guix.texi:15647
  22781. #, no-wrap
  22782. msgid "proxy, for @code{guix-daemon} HTTP access"
  22783. msgstr ""
  22784. #. type: item
  22785. #: guix-git/doc/guix.texi:15648
  22786. #, no-wrap
  22787. msgid "@code{http-proxy} (default: @code{#f})"
  22788. msgstr ""
  22789. #. type: table
  22790. #: guix-git/doc/guix.texi:15651
  22791. msgid "The URL of the HTTP and HTTPS proxy used for downloading fixed-output derivations and substitutes."
  22792. msgstr ""
  22793. #. type: table
  22794. #: guix-git/doc/guix.texi:15654
  22795. msgid "It is also possible to change the daemon's proxy at run time through the @code{set-http-proxy} action, which restarts it:"
  22796. msgstr ""
  22797. #. type: example
  22798. #: guix-git/doc/guix.texi:15657
  22799. #, no-wrap
  22800. msgid "herd set-http-proxy guix-daemon http://localhost:8118\n"
  22801. msgstr ""
  22802. #. type: table
  22803. #: guix-git/doc/guix.texi:15660
  22804. msgid "To clear the proxy settings, run:"
  22805. msgstr ""
  22806. #. type: example
  22807. #: guix-git/doc/guix.texi:15663
  22808. #, no-wrap
  22809. msgid "herd set-http-proxy guix-daemon\n"
  22810. msgstr ""
  22811. #. type: item
  22812. #: guix-git/doc/guix.texi:15665
  22813. #, no-wrap
  22814. msgid "@code{tmpdir} (default: @code{#f})"
  22815. msgstr ""
  22816. #. type: table
  22817. #: guix-git/doc/guix.texi:15667
  22818. msgid "A directory path where the @command{guix-daemon} will perform builds."
  22819. msgstr ""
  22820. #. type: deffn
  22821. #: guix-git/doc/guix.texi:15671
  22822. #, no-wrap
  22823. msgid "{Scheme Procedure} udev-service [#:udev @var{eudev} #:rules @code{'()}]"
  22824. msgstr ""
  22825. #. type: deffn
  22826. #: guix-git/doc/guix.texi:15677
  22827. msgid "Run @var{udev}, which populates the @file{/dev} directory dynamically. udev rules can be provided as a list of files through the @var{rules} variable. The procedures @code{udev-rule}, @code{udev-rules-service} and @code{file->udev-rule} from @code{(gnu services base)} simplify the creation of such rule files."
  22828. msgstr ""
  22829. #. type: deffn
  22830. #: guix-git/doc/guix.texi:15680
  22831. msgid "The @command{herd rules udev} command, as root, returns the name of the directory containing all the active udev rules."
  22832. msgstr ""
  22833. #. type: deffn
  22834. #: guix-git/doc/guix.texi:15682
  22835. #, no-wrap
  22836. msgid "{Scheme Procedure} udev-rule [@var{file-name} @var{contents}]"
  22837. msgstr ""
  22838. #. type: deffn
  22839. #: guix-git/doc/guix.texi:15685
  22840. msgid "Return a udev-rule file named @var{file-name} containing the rules defined by the @var{contents} literal."
  22841. msgstr ""
  22842. #. type: deffn
  22843. #: guix-git/doc/guix.texi:15689
  22844. msgid "In the following example, a rule for a USB device is defined to be stored in the file @file{90-usb-thing.rules}. The rule runs a script upon detecting a USB device with a given product identifier."
  22845. msgstr ""
  22846. #. type: lisp
  22847. #: guix-git/doc/guix.texi:15697
  22848. #, no-wrap
  22849. msgid ""
  22850. "(define %example-udev-rule\n"
  22851. " (udev-rule\n"
  22852. " \"90-usb-thing.rules\"\n"
  22853. " (string-append \"ACTION==\\\"add\\\", SUBSYSTEM==\\\"usb\\\", \"\n"
  22854. " \"ATTR@{product@}==\\\"Example\\\", \"\n"
  22855. " \"RUN+=\\\"/path/to/script\\\"\")))\n"
  22856. msgstr ""
  22857. #. type: deffn
  22858. #: guix-git/doc/guix.texi:15700
  22859. #, no-wrap
  22860. msgid "{Scheme Procedure} udev-rules-service [@var{name} @var{rules}] @"
  22861. msgstr ""
  22862. #. type: deffn
  22863. #: guix-git/doc/guix.texi:15707
  22864. msgid "[#:groups @var{groups}] Return a service that extends @code{udev-service-type } with @var{rules} and @code{account-service-type} with @var{groups} as system groups. This works by creating a singleton service type @code{@var{name}-udev-rules}, of which the returned service is an instance."
  22865. msgstr ""
  22866. #. type: deffn
  22867. #: guix-git/doc/guix.texi:15710
  22868. msgid "Here we show how it can be used to extend @code{udev-service-type} with the previously defined rule @code{%example-udev-rule}."
  22869. msgstr ""
  22870. #. type: lisp
  22871. #: guix-git/doc/guix.texi:15717
  22872. #, no-wrap
  22873. msgid ""
  22874. "(operating-system\n"
  22875. " ;; @dots{}\n"
  22876. " (services\n"
  22877. " (cons (udev-rules-service 'usb-thing %example-udev-rule)\n"
  22878. " %desktop-services)))\n"
  22879. msgstr ""
  22880. #. type: deffn
  22881. #: guix-git/doc/guix.texi:15720
  22882. #, no-wrap
  22883. msgid "{Scheme Procedure} file->udev-rule [@var{file-name} @var{file}]"
  22884. msgstr ""
  22885. #. type: deffn
  22886. #: guix-git/doc/guix.texi:15723
  22887. msgid "Return a udev file named @var{file-name} containing the rules defined within @var{file}, a file-like object."
  22888. msgstr ""
  22889. #. type: deffn
  22890. #: guix-git/doc/guix.texi:15725
  22891. msgid "The following example showcases how we can use an existing rule file."
  22892. msgstr ""
  22893. #. type: lisp
  22894. #: guix-git/doc/guix.texi:15730
  22895. #, no-wrap
  22896. msgid ""
  22897. "(use-modules (guix download) ;for url-fetch\n"
  22898. " (guix packages) ;for origin\n"
  22899. " @dots{})\n"
  22900. "\n"
  22901. msgstr ""
  22902. #. type: lisp
  22903. #: guix-git/doc/guix.texi:15741
  22904. #, no-wrap
  22905. msgid ""
  22906. "(define %android-udev-rules\n"
  22907. " (file->udev-rule\n"
  22908. " \"51-android-udev.rules\"\n"
  22909. " (let ((version \"20170910\"))\n"
  22910. " (origin\n"
  22911. " (method url-fetch)\n"
  22912. " (uri (string-append \"https://raw.githubusercontent.com/M0Rf30/\"\n"
  22913. " \"android-udev-rules/\" version \"/51-android.rules\"))\n"
  22914. " (sha256\n"
  22915. " (base32 \"0lmmagpyb6xsq6zcr2w1cyx9qmjqmajkvrdbhjx32gqf1d9is003\"))))))\n"
  22916. msgstr ""
  22917. #. type: Plain text
  22918. #: guix-git/doc/guix.texi:15750
  22919. msgid "Additionally, Guix package definitions can be included in @var{rules} in order to extend the udev rules with the definitions found under their @file{lib/udev/rules.d} sub-directory. In lieu of the previous @var{file->udev-rule} example, we could have used the @var{android-udev-rules} package which exists in Guix in the @code{(gnu packages android)} module."
  22920. msgstr ""
  22921. #. type: Plain text
  22922. #: guix-git/doc/guix.texi:15759
  22923. msgid "The following example shows how to use the @var{android-udev-rules} package so that the Android tool @command{adb} can detect devices without root privileges. It also details how to create the @code{adbusers} group, which is required for the proper functioning of the rules defined within the @code{android-udev-rules} package. To create such a group, we must define it both as part of the @code{supplementary-groups} of our @code{user-account} declaration, as well as in the @var{groups} of the @code{udev-rules-service} procedure."
  22924. msgstr ""
  22925. #. type: lisp
  22926. #: guix-git/doc/guix.texi:15764
  22927. #, no-wrap
  22928. msgid ""
  22929. "(use-modules (gnu packages android) ;for android-udev-rules\n"
  22930. " (gnu system shadow) ;for user-group\n"
  22931. " @dots{})\n"
  22932. "\n"
  22933. msgstr ""
  22934. #. type: lisp
  22935. #: guix-git/doc/guix.texi:15777
  22936. #, no-wrap
  22937. msgid ""
  22938. "(operating-system\n"
  22939. " ;; @dots{}\n"
  22940. " (users (cons (user-account\n"
  22941. " ;; @dots{}\n"
  22942. " (supplementary-groups\n"
  22943. " '(\"adbusers\" ;for adb\n"
  22944. " \"wheel\" \"netdev\" \"audio\" \"video\")))))\n"
  22945. " ;; @dots{}\n"
  22946. " (services\n"
  22947. " (cons (udev-rules-service 'android android-udev-rules\n"
  22948. " #:groups '(\"adbusers\"))\n"
  22949. " %desktop-services)))\n"
  22950. msgstr ""
  22951. #. type: defvr
  22952. #: guix-git/doc/guix.texi:15779
  22953. #, no-wrap
  22954. msgid "{Scheme Variable} urandom-seed-service-type"
  22955. msgstr ""
  22956. #. type: defvr
  22957. #: guix-git/doc/guix.texi:15784
  22958. msgid "Save some entropy in @code{%random-seed-file} to seed @file{/dev/urandom} when rebooting. It also tries to seed @file{/dev/urandom} from @file{/dev/hwrng} while booting, if @file{/dev/hwrng} exists and is readable."
  22959. msgstr ""
  22960. #. type: defvr
  22961. #: guix-git/doc/guix.texi:15786
  22962. #, no-wrap
  22963. msgid "{Scheme Variable} %random-seed-file"
  22964. msgstr ""
  22965. #. type: defvr
  22966. #: guix-git/doc/guix.texi:15790
  22967. msgid "This is the name of the file where some random bytes are saved by @var{urandom-seed-service} to seed @file{/dev/urandom} when rebooting. It defaults to @file{/var/lib/random-seed}."
  22968. msgstr ""
  22969. #. type: cindex
  22970. #: guix-git/doc/guix.texi:15792
  22971. #, no-wrap
  22972. msgid "mouse"
  22973. msgstr ""
  22974. #. type: cindex
  22975. #: guix-git/doc/guix.texi:15793
  22976. #, no-wrap
  22977. msgid "gpm"
  22978. msgstr ""
  22979. #. type: defvr
  22980. #: guix-git/doc/guix.texi:15794
  22981. #, no-wrap
  22982. msgid "{Scheme Variable} gpm-service-type"
  22983. msgstr ""
  22984. #. type: defvr
  22985. #: guix-git/doc/guix.texi:15799
  22986. msgid "This is the type of the service that runs GPM, the @dfn{general-purpose mouse daemon}, which provides mouse support to the Linux console. GPM allows users to use the mouse in the console, notably to select, copy, and paste text."
  22987. msgstr ""
  22988. #. type: defvr
  22989. #: guix-git/doc/guix.texi:15802
  22990. msgid "The value for services of this type must be a @code{gpm-configuration} (see below). This service is not part of @code{%base-services}."
  22991. msgstr ""
  22992. #. type: deftp
  22993. #: guix-git/doc/guix.texi:15804
  22994. #, no-wrap
  22995. msgid "{Data Type} gpm-configuration"
  22996. msgstr ""
  22997. #. type: deftp
  22998. #: guix-git/doc/guix.texi:15806
  22999. msgid "Data type representing the configuration of GPM."
  23000. msgstr ""
  23001. #. type: item
  23002. #: guix-git/doc/guix.texi:15808
  23003. #, no-wrap
  23004. msgid "@code{options} (default: @code{%default-gpm-options})"
  23005. msgstr ""
  23006. #. type: table
  23007. #: guix-git/doc/guix.texi:15813
  23008. msgid "Command-line options passed to @command{gpm}. The default set of options instruct @command{gpm} to listen to mouse events on @file{/dev/input/mice}. @xref{Command Line,,, gpm, gpm manual}, for more information."
  23009. msgstr ""
  23010. #. type: item
  23011. #: guix-git/doc/guix.texi:15814
  23012. #, no-wrap
  23013. msgid "@code{gpm} (default: @code{gpm})"
  23014. msgstr ""
  23015. #. type: table
  23016. #: guix-git/doc/guix.texi:15816
  23017. msgid "The GPM package to use."
  23018. msgstr ""
  23019. #. type: anchor{#1}
  23020. #: guix-git/doc/guix.texi:15821
  23021. msgid "guix-publish-service-type"
  23022. msgstr ""
  23023. #. type: deffn
  23024. #: guix-git/doc/guix.texi:15821
  23025. #, no-wrap
  23026. msgid "{Scheme Variable} guix-publish-service-type"
  23027. msgstr ""
  23028. #. type: deffn
  23029. #: guix-git/doc/guix.texi:15825
  23030. msgid "This is the service type for @command{guix publish} (@pxref{Invoking guix publish}). Its value must be a @code{guix-publish-configuration} object, as described below."
  23031. msgstr ""
  23032. #. type: deffn
  23033. #: guix-git/doc/guix.texi:15829
  23034. msgid "This assumes that @file{/etc/guix} already contains a signing key pair as created by @command{guix archive --generate-key} (@pxref{Invoking guix archive}). If that is not the case, the service will fail to start."
  23035. msgstr ""
  23036. #. type: deftp
  23037. #: guix-git/doc/guix.texi:15831
  23038. #, no-wrap
  23039. msgid "{Data Type} guix-publish-configuration"
  23040. msgstr ""
  23041. #. type: deftp
  23042. #: guix-git/doc/guix.texi:15834
  23043. msgid "Data type representing the configuration of the @code{guix publish} service."
  23044. msgstr ""
  23045. #. type: item
  23046. #: guix-git/doc/guix.texi:15836
  23047. #, no-wrap
  23048. msgid "@code{guix} (default: @code{guix})"
  23049. msgstr ""
  23050. #. type: item
  23051. #: guix-git/doc/guix.texi:15839 guix-git/doc/guix.texi:30257
  23052. #, no-wrap
  23053. msgid "@code{port} (default: @code{80})"
  23054. msgstr ""
  23055. #. type: table
  23056. #: guix-git/doc/guix.texi:15841
  23057. msgid "The TCP port to listen for connections."
  23058. msgstr ""
  23059. #. type: item
  23060. #: guix-git/doc/guix.texi:15842 guix-git/doc/guix.texi:27887
  23061. #, no-wrap
  23062. msgid "@code{host} (default: @code{\"localhost\"})"
  23063. msgstr ""
  23064. #. type: table
  23065. #: guix-git/doc/guix.texi:15845
  23066. msgid "The host (and thus, network interface) to listen to. Use @code{\"0.0.0.0\"} to listen on all the network interfaces."
  23067. msgstr ""
  23068. #. type: item
  23069. #: guix-git/doc/guix.texi:15846
  23070. #, no-wrap
  23071. msgid "@code{advertise?} (default: @code{#f})"
  23072. msgstr ""
  23073. #. type: table
  23074. #: guix-git/doc/guix.texi:15849
  23075. msgid "When true, advertise the service on the local network @i{via} the DNS-SD protocol, using Avahi."
  23076. msgstr ""
  23077. #. type: table
  23078. #: guix-git/doc/guix.texi:15853
  23079. msgid "This allows neighboring Guix devices with discovery on (see @code{guix-configuration} above) to discover this @command{guix publish} instance and to automatically download substitutes from it."
  23080. msgstr ""
  23081. #. type: item
  23082. #: guix-git/doc/guix.texi:15854
  23083. #, no-wrap
  23084. msgid "@code{compression} (default: @code{'((\"gzip\" 3) (\"zstd\" 3))})"
  23085. msgstr ""
  23086. #. type: table
  23087. #: guix-git/doc/guix.texi:15858
  23088. msgid "This is a list of compression method/level tuple used when compressing substitutes. For example, to compress all substitutes with @emph{both} lzip at level 7 and gzip at level 9, write:"
  23089. msgstr ""
  23090. #. type: lisp
  23091. #: guix-git/doc/guix.texi:15861
  23092. #, no-wrap
  23093. msgid "'((\"lzip\" 7) (\"gzip\" 9))\n"
  23094. msgstr ""
  23095. #. type: table
  23096. #: guix-git/doc/guix.texi:15867
  23097. msgid "Level 9 achieves the best compression ratio at the expense of increased CPU usage, whereas level 1 achieves fast compression. @xref{Invoking guix publish}, for more information on the available compression methods and the tradeoffs involved."
  23098. msgstr ""
  23099. #. type: table
  23100. #: guix-git/doc/guix.texi:15869
  23101. msgid "An empty list disables compression altogether."
  23102. msgstr ""
  23103. #. type: item
  23104. #: guix-git/doc/guix.texi:15870
  23105. #, no-wrap
  23106. msgid "@code{nar-path} (default: @code{\"nar\"})"
  23107. msgstr ""
  23108. #. type: table
  23109. #: guix-git/doc/guix.texi:15873
  23110. msgid "The URL path at which ``nars'' can be fetched. @xref{Invoking guix publish, @option{--nar-path}}, for details."
  23111. msgstr ""
  23112. #. type: item
  23113. #: guix-git/doc/guix.texi:15874
  23114. #, no-wrap
  23115. msgid "@code{cache} (default: @code{#f})"
  23116. msgstr ""
  23117. #. type: table
  23118. #: guix-git/doc/guix.texi:15880
  23119. msgid "When it is @code{#f}, disable caching and instead generate archives on demand. Otherwise, this should be the name of a directory---e.g., @code{\"/var/cache/guix/publish\"}---where @command{guix publish} caches archives and meta-data ready to be sent. @xref{Invoking guix publish, @option{--cache}}, for more information on the tradeoffs involved."
  23120. msgstr ""
  23121. #. type: item
  23122. #: guix-git/doc/guix.texi:15881
  23123. #, no-wrap
  23124. msgid "@code{workers} (default: @code{#f})"
  23125. msgstr ""
  23126. #. type: table
  23127. #: guix-git/doc/guix.texi:15885
  23128. msgid "When it is an integer, this is the number of worker threads used for caching; when @code{#f}, the number of processors is used. @xref{Invoking guix publish, @option{--workers}}, for more information."
  23129. msgstr ""
  23130. #. type: item
  23131. #: guix-git/doc/guix.texi:15886
  23132. #, no-wrap
  23133. msgid "@code{cache-bypass-threshold} (default: 10 MiB)"
  23134. msgstr ""
  23135. #. type: table
  23136. #: guix-git/doc/guix.texi:15891
  23137. msgid "When @code{cache} is true, this is the maximum size in bytes of a store item for which @command{guix publish} may bypass its cache in case of a cache miss. @xref{Invoking guix publish, @option{--cache-bypass-threshold}}, for more information."
  23138. msgstr ""
  23139. #. type: item
  23140. #: guix-git/doc/guix.texi:15892
  23141. #, no-wrap
  23142. msgid "@code{ttl} (default: @code{#f})"
  23143. msgstr ""
  23144. #. type: table
  23145. #: guix-git/doc/guix.texi:15896
  23146. msgid "When it is an integer, this denotes the @dfn{time-to-live} in seconds of the published archives. @xref{Invoking guix publish, @option{--ttl}}, for more information."
  23147. msgstr ""
  23148. #. type: anchor{#1}
  23149. #: guix-git/doc/guix.texi:15900
  23150. msgid "rngd-service"
  23151. msgstr ""
  23152. #. type: deffn
  23153. #: guix-git/doc/guix.texi:15900
  23154. #, no-wrap
  23155. msgid "{Scheme Procedure} rngd-service [#:rng-tools @var{rng-tools}] @"
  23156. msgstr ""
  23157. #. type: deffn
  23158. #: guix-git/doc/guix.texi:15905
  23159. msgid "[#:device \"/dev/hwrng\"] Return a service that runs the @command{rngd} program from @var{rng-tools} to add @var{device} to the kernel's entropy pool. The service will fail if @var{device} does not exist."
  23160. msgstr ""
  23161. #. type: anchor{#1}
  23162. #: guix-git/doc/guix.texi:15908
  23163. msgid "pam-limits-service"
  23164. msgstr ""
  23165. #. type: cindex
  23166. #: guix-git/doc/guix.texi:15908
  23167. #, no-wrap
  23168. msgid "session limits"
  23169. msgstr ""
  23170. #. type: cindex
  23171. #: guix-git/doc/guix.texi:15909
  23172. #, no-wrap
  23173. msgid "ulimit"
  23174. msgstr ""
  23175. #. type: cindex
  23176. #: guix-git/doc/guix.texi:15910
  23177. #, no-wrap
  23178. msgid "priority"
  23179. msgstr ""
  23180. #. type: cindex
  23181. #: guix-git/doc/guix.texi:15911
  23182. #, no-wrap
  23183. msgid "realtime"
  23184. msgstr ""
  23185. #. type: cindex
  23186. #: guix-git/doc/guix.texi:15912
  23187. #, no-wrap
  23188. msgid "jackd"
  23189. msgstr ""
  23190. #. type: cindex
  23191. #: guix-git/doc/guix.texi:15913
  23192. #, no-wrap
  23193. msgid "nofile"
  23194. msgstr ""
  23195. #. type: cindex
  23196. #: guix-git/doc/guix.texi:15914
  23197. #, no-wrap
  23198. msgid "open file descriptors"
  23199. msgstr ""
  23200. #. type: deffn
  23201. #: guix-git/doc/guix.texi:15915
  23202. #, no-wrap
  23203. msgid "{Scheme Procedure} pam-limits-service [#:limits @code{'()}]"
  23204. msgstr ""
  23205. #. type: deffn
  23206. #: guix-git/doc/guix.texi:15922
  23207. msgid "Return a service that installs a configuration file for the @uref{http://linux-pam.org/Linux-PAM-html/sag-pam_limits.html, @code{pam_limits} module}. The procedure optionally takes a list of @code{pam-limits-entry} values, which can be used to specify @code{ulimit} limits and @code{nice} priority limits to user sessions."
  23208. msgstr ""
  23209. #. type: deffn
  23210. #: guix-git/doc/guix.texi:15925
  23211. msgid "The following limits definition sets two hard and soft limits for all login sessions of users in the @code{realtime} group:"
  23212. msgstr ""
  23213. #. type: lisp
  23214. #: guix-git/doc/guix.texi:15931
  23215. #, no-wrap
  23216. msgid ""
  23217. "(pam-limits-service\n"
  23218. " (list\n"
  23219. " (pam-limits-entry \"@@realtime\" 'both 'rtprio 99)\n"
  23220. " (pam-limits-entry \"@@realtime\" 'both 'memlock 'unlimited)))\n"
  23221. msgstr ""
  23222. #. type: deffn
  23223. #: guix-git/doc/guix.texi:15937
  23224. msgid "The first entry increases the maximum realtime priority for non-privileged processes; the second entry lifts any restriction of the maximum address space that can be locked in memory. These settings are commonly used for real-time audio systems."
  23225. msgstr ""
  23226. #. type: deffn
  23227. #: guix-git/doc/guix.texi:15940
  23228. msgid "Another useful example is raising the maximum number of open file descriptors that can be used:"
  23229. msgstr ""
  23230. #. type: lisp
  23231. #: guix-git/doc/guix.texi:15945
  23232. #, no-wrap
  23233. msgid ""
  23234. "(pam-limits-service\n"
  23235. " (list\n"
  23236. " (pam-limits-entry \"*\" 'both 'nofile 100000)))\n"
  23237. msgstr ""
  23238. #. type: deffn
  23239. #: guix-git/doc/guix.texi:15953
  23240. msgid "In the above example, the asterisk means the limit should apply to any user. It is important to ensure the chosen value doesn't exceed the maximum system value visible in the @file{/proc/sys/fs/file-max} file, else the users would be prevented from login in. For more information about the Pluggable Authentication Module (PAM) limits, refer to the @samp{pam_limits} man page from the @code{linux-pam} package."
  23241. msgstr ""
  23242. #. type: cindex
  23243. #: guix-git/doc/guix.texi:15958
  23244. #, no-wrap
  23245. msgid "cron"
  23246. msgstr ""
  23247. #. type: cindex
  23248. #: guix-git/doc/guix.texi:15959
  23249. #, no-wrap
  23250. msgid "mcron"
  23251. msgstr ""
  23252. #. type: cindex
  23253. #: guix-git/doc/guix.texi:15960
  23254. #, no-wrap
  23255. msgid "scheduling jobs"
  23256. msgstr ""
  23257. #. type: Plain text
  23258. #: guix-git/doc/guix.texi:15967
  23259. msgid "The @code{(gnu services mcron)} module provides an interface to GNU@tie{}mcron, a daemon to run jobs at scheduled times (@pxref{Top,,, mcron, GNU@tie{}mcron}). GNU@tie{}mcron is similar to the traditional Unix @command{cron} daemon; the main difference is that it is implemented in Guile Scheme, which provides a lot of flexibility when specifying the scheduling of jobs and their actions."
  23260. msgstr ""
  23261. #. type: Plain text
  23262. #: guix-git/doc/guix.texi:15975
  23263. msgid "The example below defines an operating system that runs the @command{updatedb} (@pxref{Invoking updatedb,,, find, Finding Files}) and the @command{guix gc} commands (@pxref{Invoking guix gc}) daily, as well as the @command{mkid} command on behalf of an unprivileged user (@pxref{mkid invocation,,, idutils, ID Database Utilities}). It uses gexps to introduce job definitions that are passed to mcron (@pxref{G-Expressions})."
  23264. msgstr ""
  23265. #. type: lisp
  23266. #: guix-git/doc/guix.texi:15979
  23267. #, no-wrap
  23268. msgid ""
  23269. "(use-modules (guix) (gnu) (gnu services mcron))\n"
  23270. "(use-package-modules base idutils)\n"
  23271. "\n"
  23272. msgstr ""
  23273. #. type: lisp
  23274. #: guix-git/doc/guix.texi:15989
  23275. #, no-wrap
  23276. msgid ""
  23277. "(define updatedb-job\n"
  23278. " ;; Run 'updatedb' at 3AM every day. Here we write the\n"
  23279. " ;; job's action as a Scheme procedure.\n"
  23280. " #~(job '(next-hour '(3))\n"
  23281. " (lambda ()\n"
  23282. " (execl (string-append #$findutils \"/bin/updatedb\")\n"
  23283. " \"updatedb\"\n"
  23284. " \"--prunepaths=/tmp /var/tmp /gnu/store\"))\n"
  23285. " \"updatedb\"))\n"
  23286. "\n"
  23287. msgstr ""
  23288. #. type: lisp
  23289. #: guix-git/doc/guix.texi:15995
  23290. #, no-wrap
  23291. msgid ""
  23292. "(define garbage-collector-job\n"
  23293. " ;; Collect garbage 5 minutes after midnight every day.\n"
  23294. " ;; The job's action is a shell command.\n"
  23295. " #~(job \"5 0 * * *\" ;Vixie cron syntax\n"
  23296. " \"guix gc -F 1G\"))\n"
  23297. "\n"
  23298. msgstr ""
  23299. #. type: lisp
  23300. #: guix-git/doc/guix.texi:16002
  23301. #, no-wrap
  23302. msgid ""
  23303. "(define idutils-job\n"
  23304. " ;; Update the index database as user \"charlie\" at 12:15PM\n"
  23305. " ;; and 19:15PM. This runs from the user's home directory.\n"
  23306. " #~(job '(next-minute-from (next-hour '(12 19)) '(15))\n"
  23307. " (string-append #$idutils \"/bin/mkid src\")\n"
  23308. " #:user \"charlie\"))\n"
  23309. "\n"
  23310. msgstr ""
  23311. #. type: lisp
  23312. #: guix-git/doc/guix.texi:16005
  23313. #, no-wrap
  23314. msgid ""
  23315. "(operating-system\n"
  23316. " ;; @dots{}\n"
  23317. "\n"
  23318. msgstr ""
  23319. #. type: lisp
  23320. #: guix-git/doc/guix.texi:16015
  23321. #, no-wrap
  23322. msgid ""
  23323. " ;; %BASE-SERVICES already includes an instance of\n"
  23324. " ;; 'mcron-service-type', which we extend with additional\n"
  23325. " ;; jobs using 'simple-service'.\n"
  23326. " (services (cons (simple-service 'my-cron-jobs\n"
  23327. " mcron-service-type\n"
  23328. " (list garbage-collector-job\n"
  23329. " updatedb-job\n"
  23330. " idutils-job))\n"
  23331. " %base-services)))\n"
  23332. msgstr ""
  23333. #. type: quotation
  23334. #: guix-git/doc/guix.texi:16017
  23335. #, no-wrap
  23336. msgid "Tip"
  23337. msgstr ""
  23338. #. type: quotation
  23339. #: guix-git/doc/guix.texi:16023
  23340. msgid "When providing the action of a job specification as a procedure, you should provide an explicit name for the job via the optional 3rd argument as done in the @code{updatedb-job} example above. Otherwise, the job would appear as ``Lambda function'' in the output of @command{herd schedule mcron}, which is not nearly descriptive enough!"
  23341. msgstr ""
  23342. #. type: Plain text
  23343. #: guix-git/doc/guix.texi:16030
  23344. msgid "For more complex jobs defined in Scheme where you need control over the top level, for instance to introduce a @code{use-modules} form, you can move your code to a separate program using the @code{program-file} procedure of the @code{(guix gexp)} module (@pxref{G-Expressions}). The example below illustrates that."
  23345. msgstr ""
  23346. #. type: lisp
  23347. #: guix-git/doc/guix.texi:16046
  23348. #, no-wrap
  23349. msgid ""
  23350. "(define %battery-alert-job\n"
  23351. " ;; Beep when the battery percentage falls below %MIN-LEVEL.\n"
  23352. " #~(job\n"
  23353. " '(next-minute (range 0 60 1))\n"
  23354. " #$(program-file\n"
  23355. " \"battery-alert.scm\"\n"
  23356. " (with-imported-modules (source-module-closure\n"
  23357. " '((guix build utils)))\n"
  23358. " #~(begin\n"
  23359. " (use-modules (guix build utils)\n"
  23360. " (ice-9 popen)\n"
  23361. " (ice-9 regex)\n"
  23362. " (ice-9 textual-ports)\n"
  23363. " (srfi srfi-2))\n"
  23364. "\n"
  23365. msgstr ""
  23366. #. type: lisp
  23367. #: guix-git/doc/guix.texi:16048
  23368. #, no-wrap
  23369. msgid ""
  23370. " (define %min-level 20)\n"
  23371. "\n"
  23372. msgstr ""
  23373. #. type: lisp
  23374. #: guix-git/doc/guix.texi:16059
  23375. #, no-wrap
  23376. msgid ""
  23377. " (setenv \"LC_ALL\" \"C\") ;ensure English output\n"
  23378. " (and-let* ((input-pipe (open-pipe*\n"
  23379. " OPEN_READ\n"
  23380. " #$(file-append acpi \"/bin/acpi\")))\n"
  23381. " (output (get-string-all input-pipe))\n"
  23382. " (m (string-match \"Discharging, ([0-9]+)%\" output))\n"
  23383. " (level (string->number (match:substring m 1)))\n"
  23384. " ((< level %min-level)))\n"
  23385. " (format #t \"warning: Battery level is low (~a%)~%\" level)\n"
  23386. " (invoke #$(file-append beep \"/bin/beep\") \"-r5\")))))))\n"
  23387. msgstr ""
  23388. #. type: Plain text
  23389. #: guix-git/doc/guix.texi:16064
  23390. msgid "@xref{Guile Syntax, mcron job specifications,, mcron, GNU@tie{}mcron}, for more information on mcron job specifications. Below is the reference of the mcron service."
  23391. msgstr ""
  23392. #. type: Plain text
  23393. #: guix-git/doc/guix.texi:16067
  23394. msgid "On a running system, you can use the @code{schedule} action of the service to visualize the mcron jobs that will be executed next:"
  23395. msgstr ""
  23396. #. type: example
  23397. #: guix-git/doc/guix.texi:16070
  23398. #, no-wrap
  23399. msgid "# herd schedule mcron\n"
  23400. msgstr ""
  23401. #. type: Plain text
  23402. #: guix-git/doc/guix.texi:16075
  23403. msgid "The example above lists the next five tasks that will be executed, but you can also specify the number of tasks to display:"
  23404. msgstr ""
  23405. #. type: example
  23406. #: guix-git/doc/guix.texi:16078
  23407. #, no-wrap
  23408. msgid "# herd schedule mcron 10\n"
  23409. msgstr ""
  23410. #. type: defvr
  23411. #: guix-git/doc/guix.texi:16080
  23412. #, no-wrap
  23413. msgid "{Scheme Variable} mcron-service-type"
  23414. msgstr ""
  23415. #. type: defvr
  23416. #: guix-git/doc/guix.texi:16083
  23417. msgid "This is the type of the @code{mcron} service, whose value is an @code{mcron-configuration} object."
  23418. msgstr ""
  23419. #. type: defvr
  23420. #: guix-git/doc/guix.texi:16088
  23421. msgid "This service type can be the target of a service extension that provides it additional job specifications (@pxref{Service Composition}). In other words, it is possible to define services that provide additional mcron jobs to run."
  23422. msgstr ""
  23423. #. type: deftp
  23424. #: guix-git/doc/guix.texi:16090
  23425. #, no-wrap
  23426. msgid "{Data Type} mcron-configuration"
  23427. msgstr ""
  23428. #. type: deftp
  23429. #: guix-git/doc/guix.texi:16092
  23430. msgid "Data type representing the configuration of mcron."
  23431. msgstr ""
  23432. #. type: item
  23433. #: guix-git/doc/guix.texi:16094
  23434. #, no-wrap
  23435. msgid "@code{mcron} (default: @var{mcron})"
  23436. msgstr ""
  23437. #. type: table
  23438. #: guix-git/doc/guix.texi:16096
  23439. msgid "The mcron package to use."
  23440. msgstr ""
  23441. #. type: code{#1}
  23442. #: guix-git/doc/guix.texi:16097 guix-git/doc/guix.texi:16166
  23443. #, no-wrap
  23444. msgid "jobs"
  23445. msgstr ""
  23446. #. type: table
  23447. #: guix-git/doc/guix.texi:16101
  23448. msgid "This is a list of gexps (@pxref{G-Expressions}), where each gexp corresponds to an mcron job specification (@pxref{Syntax, mcron job specifications,, mcron, GNU@tie{}mcron})."
  23449. msgstr ""
  23450. #. type: cindex
  23451. #: guix-git/doc/guix.texi:16108
  23452. #, no-wrap
  23453. msgid "rottlog"
  23454. msgstr ""
  23455. #. type: cindex
  23456. #: guix-git/doc/guix.texi:16109
  23457. #, no-wrap
  23458. msgid "log rotation"
  23459. msgstr ""
  23460. #. type: Plain text
  23461. #: guix-git/doc/guix.texi:16116
  23462. msgid "Log files such as those found in @file{/var/log} tend to grow endlessly, so it's a good idea to @dfn{rotate} them once in a while---i.e., archive their contents in separate files, possibly compressed. The @code{(gnu services admin)} module provides an interface to GNU@tie{}Rot[t]log, a log rotation tool (@pxref{Top,,, rottlog, GNU Rot[t]log Manual})."
  23463. msgstr ""
  23464. #. type: Plain text
  23465. #: guix-git/doc/guix.texi:16122
  23466. msgid "This service is part of @code{%base-services}, and thus enabled by default, with the default settings, for commonly encountered log files. The example below shows how to extend it with an additional @dfn{rotation}, should you need to do that (usually, services that produce log files already take care of that):"
  23467. msgstr ""
  23468. #. type: lisp
  23469. #: guix-git/doc/guix.texi:16126
  23470. #, no-wrap
  23471. msgid ""
  23472. "(use-modules (guix) (gnu))\n"
  23473. "(use-service-modules admin)\n"
  23474. "\n"
  23475. msgstr ""
  23476. #. type: lisp
  23477. #: guix-git/doc/guix.texi:16130
  23478. #, no-wrap
  23479. msgid ""
  23480. "(define my-log-files\n"
  23481. " ;; Log files that I want to rotate.\n"
  23482. " '(\"/var/log/something.log\" \"/var/log/another.log\"))\n"
  23483. "\n"
  23484. msgstr ""
  23485. #. type: lisp
  23486. #: guix-git/doc/guix.texi:16139
  23487. #, no-wrap
  23488. msgid ""
  23489. "(operating-system\n"
  23490. " ;; @dots{}\n"
  23491. " (services (cons (simple-service 'rotate-my-stuff\n"
  23492. " rottlog-service-type\n"
  23493. " (list (log-rotation\n"
  23494. " (frequency 'daily)\n"
  23495. " (files my-log-files))))\n"
  23496. " %base-services)))\n"
  23497. msgstr ""
  23498. #. type: defvr
  23499. #: guix-git/doc/guix.texi:16141
  23500. #, no-wrap
  23501. msgid "{Scheme Variable} rottlog-service-type"
  23502. msgstr ""
  23503. #. type: defvr
  23504. #: guix-git/doc/guix.texi:16144
  23505. msgid "This is the type of the Rottlog service, whose value is a @code{rottlog-configuration} object."
  23506. msgstr ""
  23507. #. type: defvr
  23508. #: guix-git/doc/guix.texi:16147
  23509. msgid "Other services can extend this one with new @code{log-rotation} objects (see below), thereby augmenting the set of files to be rotated."
  23510. msgstr ""
  23511. #. type: defvr
  23512. #: guix-git/doc/guix.texi:16150
  23513. msgid "This service type can define mcron jobs (@pxref{Scheduled Job Execution}) to run the rottlog service."
  23514. msgstr ""
  23515. #. type: deftp
  23516. #: guix-git/doc/guix.texi:16152
  23517. #, no-wrap
  23518. msgid "{Data Type} rottlog-configuration"
  23519. msgstr ""
  23520. #. type: deftp
  23521. #: guix-git/doc/guix.texi:16154
  23522. msgid "Data type representing the configuration of rottlog."
  23523. msgstr ""
  23524. #. type: item
  23525. #: guix-git/doc/guix.texi:16156
  23526. #, no-wrap
  23527. msgid "@code{rottlog} (default: @code{rottlog})"
  23528. msgstr ""
  23529. #. type: table
  23530. #: guix-git/doc/guix.texi:16158
  23531. msgid "The Rottlog package to use."
  23532. msgstr ""
  23533. #. type: item
  23534. #: guix-git/doc/guix.texi:16159
  23535. #, no-wrap
  23536. msgid "@code{rc-file} (default: @code{(file-append rottlog \"/etc/rc\")})"
  23537. msgstr ""
  23538. #. type: table
  23539. #: guix-git/doc/guix.texi:16162
  23540. msgid "The Rottlog configuration file to use (@pxref{Mandatory RC Variables,,, rottlog, GNU Rot[t]log Manual})."
  23541. msgstr ""
  23542. #. type: item
  23543. #: guix-git/doc/guix.texi:16163
  23544. #, no-wrap
  23545. msgid "@code{rotations} (default: @code{%default-rotations})"
  23546. msgstr ""
  23547. #. type: table
  23548. #: guix-git/doc/guix.texi:16165
  23549. msgid "A list of @code{log-rotation} objects as defined below."
  23550. msgstr ""
  23551. #. type: table
  23552. #: guix-git/doc/guix.texi:16169
  23553. msgid "This is a list of gexps where each gexp corresponds to an mcron job specification (@pxref{Scheduled Job Execution})."
  23554. msgstr ""
  23555. #. type: deftp
  23556. #: guix-git/doc/guix.texi:16172
  23557. #, no-wrap
  23558. msgid "{Data Type} log-rotation"
  23559. msgstr ""
  23560. #. type: deftp
  23561. #: guix-git/doc/guix.texi:16174
  23562. msgid "Data type representing the rotation of a group of log files."
  23563. msgstr ""
  23564. #. type: deftp
  23565. #: guix-git/doc/guix.texi:16178
  23566. msgid "Taking an example from the Rottlog manual (@pxref{Period Related File Examples,,, rottlog, GNU Rot[t]log Manual}), a log rotation might be defined like this:"
  23567. msgstr ""
  23568. #. type: lisp
  23569. #: guix-git/doc/guix.texi:16187
  23570. #, no-wrap
  23571. msgid ""
  23572. "(log-rotation\n"
  23573. " (frequency 'daily)\n"
  23574. " (files '(\"/var/log/apache/*\"))\n"
  23575. " (options '(\"storedir apache-archives\"\n"
  23576. " \"rotate 6\"\n"
  23577. " \"notifempty\"\n"
  23578. " \"nocompress\")))\n"
  23579. msgstr ""
  23580. #. type: deftp
  23581. #: guix-git/doc/guix.texi:16190
  23582. msgid "The list of fields is as follows:"
  23583. msgstr ""
  23584. #. type: item
  23585. #: guix-git/doc/guix.texi:16192
  23586. #, no-wrap
  23587. msgid "@code{frequency} (default: @code{'weekly})"
  23588. msgstr ""
  23589. #. type: table
  23590. #: guix-git/doc/guix.texi:16194
  23591. msgid "The log rotation frequency, a symbol."
  23592. msgstr ""
  23593. #. type: code{#1}
  23594. #: guix-git/doc/guix.texi:16195
  23595. #, no-wrap
  23596. msgid "files"
  23597. msgstr ""
  23598. #. type: table
  23599. #: guix-git/doc/guix.texi:16197
  23600. msgid "The list of files or file glob patterns to rotate."
  23601. msgstr ""
  23602. #. type: item
  23603. #: guix-git/doc/guix.texi:16198
  23604. #, no-wrap
  23605. msgid "@code{options} (default: @code{'()})"
  23606. msgstr ""
  23607. #. type: table
  23608. #: guix-git/doc/guix.texi:16201
  23609. msgid "The list of rottlog options for this rotation (@pxref{Configuration parameters,,, rottlog, GNU Rot[t]lg Manual})."
  23610. msgstr ""
  23611. #. type: item
  23612. #: guix-git/doc/guix.texi:16202
  23613. #, no-wrap
  23614. msgid "@code{post-rotate} (default: @code{#f})"
  23615. msgstr ""
  23616. #. type: table
  23617. #: guix-git/doc/guix.texi:16204
  23618. msgid "Either @code{#f} or a gexp to execute once the rotation has completed."
  23619. msgstr ""
  23620. #. type: defvr
  23621. #: guix-git/doc/guix.texi:16207
  23622. #, no-wrap
  23623. msgid "{Scheme Variable} %default-rotations"
  23624. msgstr ""
  23625. #. type: defvr
  23626. #: guix-git/doc/guix.texi:16210
  23627. msgid "Specifies weekly rotation of @code{%rotated-files} and of @file{/var/log/guix-daemon.log}."
  23628. msgstr ""
  23629. #. type: defvr
  23630. #: guix-git/doc/guix.texi:16212
  23631. #, no-wrap
  23632. msgid "{Scheme Variable} %rotated-files"
  23633. msgstr ""
  23634. #. type: defvr
  23635. #: guix-git/doc/guix.texi:16216
  23636. msgid "The list of syslog-controlled files to be rotated. By default it is: @code{'(\"/var/log/messages\" \"/var/log/secure\" \"/var/log/debug\" \\ \"/var/log/maillog\")}."
  23637. msgstr ""
  23638. #. type: Plain text
  23639. #: guix-git/doc/guix.texi:16223
  23640. msgid "The @code{(gnu services networking)} module provides services to configure the network interface."
  23641. msgstr ""
  23642. #. type: cindex
  23643. #: guix-git/doc/guix.texi:16224
  23644. #, no-wrap
  23645. msgid "DHCP, networking service"
  23646. msgstr ""
  23647. #. type: defvr
  23648. #: guix-git/doc/guix.texi:16225
  23649. #, no-wrap
  23650. msgid "{Scheme Variable} dhcp-client-service-type"
  23651. msgstr ""
  23652. #. type: defvr
  23653. #: guix-git/doc/guix.texi:16229
  23654. msgid "This is the type of services that run @var{dhcp}, a Dynamic Host Configuration Protocol (DHCP) client, on all the non-loopback network interfaces. Its value is the DHCP client package to use, @code{isc-dhcp} by default."
  23655. msgstr ""
  23656. #. type: deffn
  23657. #: guix-git/doc/guix.texi:16231
  23658. #, no-wrap
  23659. msgid "{Scheme Procedure} dhcpd-service-type"
  23660. msgstr ""
  23661. #. type: deffn
  23662. #: guix-git/doc/guix.texi:16235
  23663. msgid "This type defines a service that runs a DHCP daemon. To create a service of this type, you must supply a @code{<dhcpd-configuration>}. For example:"
  23664. msgstr ""
  23665. #. type: lisp
  23666. #: guix-git/doc/guix.texi:16241
  23667. #, no-wrap
  23668. msgid ""
  23669. "(service dhcpd-service-type\n"
  23670. " (dhcpd-configuration\n"
  23671. " (config-file (local-file \"my-dhcpd.conf\"))\n"
  23672. " (interfaces '(\"enp0s25\"))))\n"
  23673. msgstr ""
  23674. #. type: deftp
  23675. #: guix-git/doc/guix.texi:16244
  23676. #, no-wrap
  23677. msgid "{Data Type} dhcpd-configuration"
  23678. msgstr ""
  23679. #. type: item
  23680. #: guix-git/doc/guix.texi:16246
  23681. #, no-wrap
  23682. msgid "@code{package} (default: @code{isc-dhcp})"
  23683. msgstr ""
  23684. #. type: table
  23685. #: guix-git/doc/guix.texi:16251
  23686. msgid "The package that provides the DHCP daemon. This package is expected to provide the daemon at @file{sbin/dhcpd} relative to its output directory. The default package is the @uref{https://www.isc.org/products/DHCP, ISC's DHCP server}."
  23687. msgstr ""
  23688. #. type: item
  23689. #: guix-git/doc/guix.texi:16251 guix-git/doc/guix.texi:16507
  23690. #: guix-git/doc/guix.texi:21722
  23691. #, no-wrap
  23692. msgid "@code{config-file} (default: @code{#f})"
  23693. msgstr ""
  23694. #. type: table
  23695. #: guix-git/doc/guix.texi:16256
  23696. msgid "The configuration file to use. This is required. It will be passed to @code{dhcpd} via its @code{-cf} option. This may be any ``file-like'' object (@pxref{G-Expressions, file-like objects}). See @code{man dhcpd.conf} for details on the configuration file syntax."
  23697. msgstr ""
  23698. #. type: item
  23699. #: guix-git/doc/guix.texi:16256
  23700. #, no-wrap
  23701. msgid "@code{version} (default: @code{\"4\"})"
  23702. msgstr ""
  23703. #. type: table
  23704. #: guix-git/doc/guix.texi:16261
  23705. msgid "The DHCP version to use. The ISC DHCP server supports the values ``4'', ``6'', and ``4o6''. These correspond to the @code{dhcpd} program options @code{-4}, @code{-6}, and @code{-4o6}. See @code{man dhcpd} for details."
  23706. msgstr ""
  23707. #. type: item
  23708. #: guix-git/doc/guix.texi:16261
  23709. #, no-wrap
  23710. msgid "@code{run-directory} (default: @code{\"/run/dhcpd\"})"
  23711. msgstr ""
  23712. #. type: table
  23713. #: guix-git/doc/guix.texi:16264
  23714. msgid "The run directory to use. At service activation time, this directory will be created if it does not exist."
  23715. msgstr ""
  23716. #. type: item
  23717. #: guix-git/doc/guix.texi:16264
  23718. #, no-wrap
  23719. msgid "@code{pid-file} (default: @code{\"/run/dhcpd/dhcpd.pid\"})"
  23720. msgstr ""
  23721. #. type: table
  23722. #: guix-git/doc/guix.texi:16267
  23723. msgid "The PID file to use. This corresponds to the @code{-pf} option of @code{dhcpd}. See @code{man dhcpd} for details."
  23724. msgstr ""
  23725. #. type: item
  23726. #: guix-git/doc/guix.texi:16267
  23727. #, no-wrap
  23728. msgid "@code{interfaces} (default: @code{'()})"
  23729. msgstr ""
  23730. #. type: table
  23731. #: guix-git/doc/guix.texi:16273
  23732. msgid "The names of the network interfaces on which dhcpd should listen for broadcasts. If this list is not empty, then its elements (which must be strings) will be appended to the @code{dhcpd} invocation when starting the daemon. It may not be necessary to explicitly specify any interfaces here; see @code{man dhcpd} for details."
  23733. msgstr ""
  23734. #. type: defvr
  23735. #: guix-git/doc/guix.texi:16276
  23736. #, no-wrap
  23737. msgid "{Scheme Variable} static-networking-service-type"
  23738. msgstr ""
  23739. #. type: defvr
  23740. #: guix-git/doc/guix.texi:16279
  23741. msgid "This is the type for statically-configured network interfaces."
  23742. msgstr ""
  23743. #. type: deffn
  23744. #: guix-git/doc/guix.texi:16281
  23745. #, no-wrap
  23746. msgid "{Scheme Procedure} static-networking-service @var{interface} @var{ip} @"
  23747. msgstr ""
  23748. #. type: deffn
  23749. #: guix-git/doc/guix.texi:16289
  23750. msgid "[#:netmask #f] [#:gateway #f] [#:name-servers @code{'()}] @ [#:requirement @code{'(udev)}] Return a service that starts @var{interface} with address @var{ip}. If @var{netmask} is true, use it as the network mask. If @var{gateway} is true, it must be a string specifying the default network gateway. @var{requirement} can be used to declare a dependency on another service before configuring the interface."
  23751. msgstr ""
  23752. #. type: deffn
  23753. #: guix-git/doc/guix.texi:16294
  23754. msgid "This procedure can be called several times, one for each network interface of interest. Behind the scenes what it does is extend @code{static-networking-service-type} with additional network interfaces to handle."
  23755. msgstr ""
  23756. #. type: defvr
  23757. #: guix-git/doc/guix.texi:16296 guix-git/doc/guix.texi:29568
  23758. msgid "For example:"
  23759. msgstr ""
  23760. #. type: lisp
  23761. #: guix-git/doc/guix.texi:16301
  23762. #, no-wrap
  23763. msgid ""
  23764. "(static-networking-service \"eno1\" \"192.168.1.82\"\n"
  23765. " #:gateway \"192.168.1.2\"\n"
  23766. " #:name-servers '(\"192.168.1.2\"))\n"
  23767. msgstr ""
  23768. #. type: cindex
  23769. #: guix-git/doc/guix.texi:16304
  23770. #, no-wrap
  23771. msgid "wicd"
  23772. msgstr ""
  23773. #. type: cindex
  23774. #: guix-git/doc/guix.texi:16307
  23775. #, no-wrap
  23776. msgid "network management"
  23777. msgstr ""
  23778. #. type: deffn
  23779. #: guix-git/doc/guix.texi:16308
  23780. #, no-wrap
  23781. msgid "{Scheme Procedure} wicd-service [#:wicd @var{wicd}]"
  23782. msgstr ""
  23783. #. type: deffn
  23784. #: guix-git/doc/guix.texi:16311
  23785. msgid "Return a service that runs @url{https://launchpad.net/wicd,Wicd}, a network management daemon that aims to simplify wired and wireless networking."
  23786. msgstr ""
  23787. #. type: deffn
  23788. #: guix-git/doc/guix.texi:16316
  23789. msgid "This service adds the @var{wicd} package to the global profile, providing several commands to interact with the daemon and configure networking: @command{wicd-client}, a graphical user interface, and the @command{wicd-cli} and @command{wicd-curses} user interfaces."
  23790. msgstr ""
  23791. #. type: cindex
  23792. #: guix-git/doc/guix.texi:16318
  23793. #, no-wrap
  23794. msgid "ModemManager"
  23795. msgstr ""
  23796. #. type: defvr
  23797. #: guix-git/doc/guix.texi:16320
  23798. #, no-wrap
  23799. msgid "{Scheme Variable} modem-manager-service-type"
  23800. msgstr ""
  23801. #. type: defvr
  23802. #: guix-git/doc/guix.texi:16325
  23803. msgid "This is the service type for the @uref{https://wiki.gnome.org/Projects/ModemManager, ModemManager} service. The value for this service type is a @code{modem-manager-configuration} record."
  23804. msgstr ""
  23805. #. type: defvr
  23806. #: guix-git/doc/guix.texi:16328 guix-git/doc/guix.texi:16357
  23807. #: guix-git/doc/guix.texi:16389
  23808. msgid "This service is part of @code{%desktop-services} (@pxref{Desktop Services})."
  23809. msgstr ""
  23810. #. type: deftp
  23811. #: guix-git/doc/guix.texi:16330
  23812. #, no-wrap
  23813. msgid "{Data Type} modem-manager-configuration"
  23814. msgstr ""
  23815. #. type: deftp
  23816. #: guix-git/doc/guix.texi:16332
  23817. msgid "Data type representing the configuration of ModemManager."
  23818. msgstr ""
  23819. #. type: item
  23820. #: guix-git/doc/guix.texi:16334
  23821. #, no-wrap
  23822. msgid "@code{modem-manager} (default: @code{modem-manager})"
  23823. msgstr ""
  23824. #. type: table
  23825. #: guix-git/doc/guix.texi:16336
  23826. msgid "The ModemManager package to use."
  23827. msgstr ""
  23828. #. type: cindex
  23829. #: guix-git/doc/guix.texi:16340
  23830. #, no-wrap
  23831. msgid "USB_ModeSwitch"
  23832. msgstr ""
  23833. #. type: cindex
  23834. #: guix-git/doc/guix.texi:16341
  23835. #, no-wrap
  23836. msgid "Modeswitching"
  23837. msgstr ""
  23838. #. type: defvr
  23839. #: guix-git/doc/guix.texi:16343
  23840. #, no-wrap
  23841. msgid "{Scheme Variable} usb-modeswitch-service-type"
  23842. msgstr ""
  23843. #. type: defvr
  23844. #: guix-git/doc/guix.texi:16348
  23845. msgid "This is the service type for the @uref{https://www.draisberghof.de/usb_modeswitch/, USB_ModeSwitch} service. The value for this service type is a @code{usb-modeswitch-configuration} record."
  23846. msgstr ""
  23847. #. type: defvr
  23848. #: guix-git/doc/guix.texi:16354
  23849. msgid "When plugged in, some USB modems (and other USB devices) initially present themselves as a read-only storage medium and not as a modem. They need to be @dfn{modeswitched} before they are usable. The USB_ModeSwitch service type installs udev rules to automatically modeswitch these devices when they are plugged in."
  23850. msgstr ""
  23851. #. type: deftp
  23852. #: guix-git/doc/guix.texi:16359
  23853. #, no-wrap
  23854. msgid "{Data Type} usb-modeswitch-configuration"
  23855. msgstr ""
  23856. #. type: deftp
  23857. #: guix-git/doc/guix.texi:16361
  23858. msgid "Data type representing the configuration of USB_ModeSwitch."
  23859. msgstr ""
  23860. #. type: item
  23861. #: guix-git/doc/guix.texi:16363
  23862. #, no-wrap
  23863. msgid "@code{usb-modeswitch} (default: @code{usb-modeswitch})"
  23864. msgstr ""
  23865. #. type: table
  23866. #: guix-git/doc/guix.texi:16365
  23867. msgid "The USB_ModeSwitch package providing the binaries for modeswitching."
  23868. msgstr ""
  23869. #. type: item
  23870. #: guix-git/doc/guix.texi:16366
  23871. #, no-wrap
  23872. msgid "@code{usb-modeswitch-data} (default: @code{usb-modeswitch-data})"
  23873. msgstr ""
  23874. #. type: table
  23875. #: guix-git/doc/guix.texi:16369
  23876. msgid "The package providing the device data and udev rules file used by USB_ModeSwitch."
  23877. msgstr ""
  23878. #. type: item
  23879. #: guix-git/doc/guix.texi:16370
  23880. #, no-wrap
  23881. msgid "@code{config-file} (default: @code{#~(string-append #$usb-modeswitch:dispatcher \"/etc/usb_modeswitch.conf\")})"
  23882. msgstr ""
  23883. #. type: table
  23884. #: guix-git/doc/guix.texi:16375
  23885. msgid "Which config file to use for the USB_ModeSwitch dispatcher. By default the config file shipped with USB_ModeSwitch is used which disables logging to @file{/var/log} among other default settings. If set to @code{#f}, no config file is used."
  23886. msgstr ""
  23887. #. type: cindex
  23888. #: guix-git/doc/guix.texi:16379
  23889. #, no-wrap
  23890. msgid "NetworkManager"
  23891. msgstr ""
  23892. #. type: defvr
  23893. #: guix-git/doc/guix.texi:16381
  23894. #, no-wrap
  23895. msgid "{Scheme Variable} network-manager-service-type"
  23896. msgstr ""
  23897. #. type: defvr
  23898. #: guix-git/doc/guix.texi:16386
  23899. msgid "This is the service type for the @uref{https://wiki.gnome.org/Projects/NetworkManager, NetworkManager} service. The value for this service type is a @code{network-manager-configuration} record."
  23900. msgstr ""
  23901. #. type: deftp
  23902. #: guix-git/doc/guix.texi:16391
  23903. #, no-wrap
  23904. msgid "{Data Type} network-manager-configuration"
  23905. msgstr ""
  23906. #. type: deftp
  23907. #: guix-git/doc/guix.texi:16393
  23908. msgid "Data type representing the configuration of NetworkManager."
  23909. msgstr ""
  23910. #. type: item
  23911. #: guix-git/doc/guix.texi:16395
  23912. #, no-wrap
  23913. msgid "@code{network-manager} (default: @code{network-manager})"
  23914. msgstr ""
  23915. #. type: table
  23916. #: guix-git/doc/guix.texi:16397
  23917. msgid "The NetworkManager package to use."
  23918. msgstr ""
  23919. #. type: item
  23920. #: guix-git/doc/guix.texi:16398
  23921. #, no-wrap
  23922. msgid "@code{dns} (default: @code{\"default\"})"
  23923. msgstr ""
  23924. #. type: table
  23925. #: guix-git/doc/guix.texi:16401
  23926. msgid "Processing mode for DNS, which affects how NetworkManager uses the @code{resolv.conf} configuration file."
  23927. msgstr ""
  23928. #. type: table
  23929. #: guix-git/doc/guix.texi:16406
  23930. msgid "NetworkManager will update @code{resolv.conf} to reflect the nameservers provided by currently active connections."
  23931. msgstr ""
  23932. #. type: item
  23933. #: guix-git/doc/guix.texi:16407
  23934. #, no-wrap
  23935. msgid "dnsmasq"
  23936. msgstr ""
  23937. #. type: table
  23938. #: guix-git/doc/guix.texi:16411
  23939. msgid "NetworkManager will run @code{dnsmasq} as a local caching nameserver, using a @dfn{conditional forwarding} configuration if you are connected to a VPN, and then update @code{resolv.conf} to point to the local nameserver."
  23940. msgstr ""
  23941. #. type: table
  23942. #: guix-git/doc/guix.texi:16417
  23943. msgid "With this setting, you can share your network connection. For example when you want to share your network connection to another laptop @i{via} an Ethernet cable, you can open @command{nm-connection-editor} and configure the Wired connection's method for IPv4 and IPv6 to be ``Shared to other computers'' and reestablish the connection (or reboot)."
  23944. msgstr ""
  23945. #. type: table
  23946. #: guix-git/doc/guix.texi:16424
  23947. msgid "You can also set up a @dfn{host-to-guest connection} to QEMU VMs (@pxref{Installing Guix in a VM}). With a host-to-guest connection, you can e.g.@: access a Web server running on the VM (@pxref{Web Services}) from a Web browser on your host system, or connect to the VM @i{via} SSH (@pxref{Networking Services, @code{openssh-service-type}}). To set up a host-to-guest connection, run this command once:"
  23948. msgstr ""
  23949. #. type: example
  23950. #: guix-git/doc/guix.texi:16431
  23951. #, no-wrap
  23952. msgid ""
  23953. "nmcli connection add type tun \\\n"
  23954. " connection.interface-name tap0 \\\n"
  23955. " tun.mode tap tun.owner $(id -u) \\\n"
  23956. " ipv4.method shared \\\n"
  23957. " ipv4.addresses 172.28.112.1/24\n"
  23958. msgstr ""
  23959. #. type: table
  23960. #: guix-git/doc/guix.texi:16436
  23961. msgid "Then each time you launch your QEMU VM (@pxref{Running Guix in a VM}), pass @option{-nic tap,ifname=tap0,script=no,downscript=no} to @command{qemu-system-...}."
  23962. msgstr ""
  23963. #. type: table
  23964. #: guix-git/doc/guix.texi:16439
  23965. msgid "NetworkManager will not modify @code{resolv.conf}."
  23966. msgstr ""
  23967. #. type: item
  23968. #: guix-git/doc/guix.texi:16441
  23969. #, no-wrap
  23970. msgid "@code{vpn-plugins} (default: @code{'()})"
  23971. msgstr ""
  23972. #. type: table
  23973. #: guix-git/doc/guix.texi:16445
  23974. msgid "This is the list of available plugins for virtual private networks (VPNs). An example of this is the @code{network-manager-openvpn} package, which allows NetworkManager to manage VPNs @i{via} OpenVPN."
  23975. msgstr ""
  23976. #. type: cindex
  23977. #: guix-git/doc/guix.texi:16449
  23978. #, no-wrap
  23979. msgid "Connman"
  23980. msgstr ""
  23981. #. type: deffn
  23982. #: guix-git/doc/guix.texi:16450
  23983. #, no-wrap
  23984. msgid "{Scheme Variable} connman-service-type"
  23985. msgstr ""
  23986. #. type: deffn
  23987. #: guix-git/doc/guix.texi:16453
  23988. msgid "This is the service type to run @url{https://01.org/connman,Connman}, a network connection manager."
  23989. msgstr ""
  23990. #. type: deffn
  23991. #: guix-git/doc/guix.texi:16456
  23992. msgid "Its value must be an @code{connman-configuration} record as in this example:"
  23993. msgstr ""
  23994. #. type: lisp
  23995. #: guix-git/doc/guix.texi:16461
  23996. #, no-wrap
  23997. msgid ""
  23998. "(service connman-service-type\n"
  23999. " (connman-configuration\n"
  24000. " (disable-vpn? #t)))\n"
  24001. msgstr ""
  24002. #. type: deffn
  24003. #: guix-git/doc/guix.texi:16464
  24004. msgid "See below for details about @code{connman-configuration}."
  24005. msgstr ""
  24006. #. type: deftp
  24007. #: guix-git/doc/guix.texi:16466
  24008. #, no-wrap
  24009. msgid "{Data Type} connman-configuration"
  24010. msgstr ""
  24011. #. type: deftp
  24012. #: guix-git/doc/guix.texi:16468
  24013. msgid "Data Type representing the configuration of connman."
  24014. msgstr ""
  24015. #. type: item
  24016. #: guix-git/doc/guix.texi:16470
  24017. #, no-wrap
  24018. msgid "@code{connman} (default: @var{connman})"
  24019. msgstr ""
  24020. #. type: table
  24021. #: guix-git/doc/guix.texi:16472
  24022. msgid "The connman package to use."
  24023. msgstr ""
  24024. #. type: item
  24025. #: guix-git/doc/guix.texi:16473
  24026. #, no-wrap
  24027. msgid "@code{disable-vpn?} (default: @code{#f})"
  24028. msgstr ""
  24029. #. type: table
  24030. #: guix-git/doc/guix.texi:16475
  24031. msgid "When true, disable connman's vpn plugin."
  24032. msgstr ""
  24033. #. type: cindex
  24034. #: guix-git/doc/guix.texi:16478
  24035. #, no-wrap
  24036. msgid "WPA Supplicant"
  24037. msgstr ""
  24038. #. type: defvr
  24039. #: guix-git/doc/guix.texi:16479
  24040. #, no-wrap
  24041. msgid "{Scheme Variable} wpa-supplicant-service-type"
  24042. msgstr ""
  24043. #. type: defvr
  24044. #: guix-git/doc/guix.texi:16483
  24045. msgid "This is the service type to run @url{https://w1.fi/wpa_supplicant/,WPA supplicant}, an authentication daemon required to authenticate against encrypted WiFi or ethernet networks."
  24046. msgstr ""
  24047. #. type: deftp
  24048. #: guix-git/doc/guix.texi:16485
  24049. #, no-wrap
  24050. msgid "{Data Type} wpa-supplicant-configuration"
  24051. msgstr ""
  24052. #. type: deftp
  24053. #: guix-git/doc/guix.texi:16487
  24054. msgid "Data type representing the configuration of WPA Supplicant."
  24055. msgstr ""
  24056. #. type: deftp
  24057. #: guix-git/doc/guix.texi:16489 guix-git/doc/guix.texi:31581
  24058. msgid "It takes the following parameters:"
  24059. msgstr ""
  24060. #. type: item
  24061. #: guix-git/doc/guix.texi:16491
  24062. #, no-wrap
  24063. msgid "@code{wpa-supplicant} (default: @code{wpa-supplicant})"
  24064. msgstr ""
  24065. #. type: table
  24066. #: guix-git/doc/guix.texi:16493
  24067. msgid "The WPA Supplicant package to use."
  24068. msgstr ""
  24069. #. type: item
  24070. #: guix-git/doc/guix.texi:16494
  24071. #, no-wrap
  24072. msgid "@code{requirement} (default: @code{'(user-processes loopback syslogd)}"
  24073. msgstr ""
  24074. #. type: table
  24075. #: guix-git/doc/guix.texi:16496
  24076. msgid "List of services that should be started before WPA Supplicant starts."
  24077. msgstr ""
  24078. #. type: item
  24079. #: guix-git/doc/guix.texi:16497
  24080. #, no-wrap
  24081. msgid "@code{dbus?} (default: @code{#t})"
  24082. msgstr ""
  24083. #. type: table
  24084. #: guix-git/doc/guix.texi:16499
  24085. msgid "Whether to listen for requests on D-Bus."
  24086. msgstr ""
  24087. #. type: item
  24088. #: guix-git/doc/guix.texi:16500
  24089. #, no-wrap
  24090. msgid "@code{pid-file} (default: @code{\"/var/run/wpa_supplicant.pid\"})"
  24091. msgstr ""
  24092. #. type: table
  24093. #: guix-git/doc/guix.texi:16502
  24094. msgid "Where to store the PID file."
  24095. msgstr ""
  24096. #. type: item
  24097. #: guix-git/doc/guix.texi:16503 guix-git/doc/guix.texi:30026
  24098. #: guix-git/doc/guix.texi:30168
  24099. #, no-wrap
  24100. msgid "@code{interface} (default: @code{#f})"
  24101. msgstr ""
  24102. #. type: table
  24103. #: guix-git/doc/guix.texi:16506
  24104. msgid "If this is set, it must specify the name of a network interface that WPA supplicant will control."
  24105. msgstr ""
  24106. #. type: table
  24107. #: guix-git/doc/guix.texi:16509
  24108. msgid "Optional configuration file to use."
  24109. msgstr ""
  24110. #. type: table
  24111. #: guix-git/doc/guix.texi:16512
  24112. msgid "List of additional command-line arguments to pass to the daemon."
  24113. msgstr ""
  24114. #. type: cindex
  24115. #: guix-git/doc/guix.texi:16515
  24116. #, no-wrap
  24117. msgid "hostapd service, for Wi-Fi access points"
  24118. msgstr ""
  24119. #. type: cindex
  24120. #: guix-git/doc/guix.texi:16516
  24121. #, no-wrap
  24122. msgid "Wi-Fi access points, hostapd service"
  24123. msgstr ""
  24124. #. type: defvr
  24125. #: guix-git/doc/guix.texi:16517
  24126. #, no-wrap
  24127. msgid "{Scheme Variable} hostapd-service-type"
  24128. msgstr ""
  24129. #. type: defvr
  24130. #: guix-git/doc/guix.texi:16522
  24131. msgid "This is the service type to run the @uref{https://w1.fi/hostapd/, hostapd} daemon to set up WiFi (IEEE 802.11) access points and authentication servers. Its associated value must be a @code{hostapd-configuration} as shown below:"
  24132. msgstr ""
  24133. #. type: lisp
  24134. #: guix-git/doc/guix.texi:16530
  24135. #, no-wrap
  24136. msgid ""
  24137. ";; Use wlan1 to run the access point for \"My Network\".\n"
  24138. "(service hostapd-service-type\n"
  24139. " (hostapd-configuration\n"
  24140. " (interface \"wlan1\")\n"
  24141. " (ssid \"My Network\")\n"
  24142. " (channel 12)))\n"
  24143. msgstr ""
  24144. #. type: deftp
  24145. #: guix-git/doc/guix.texi:16533
  24146. #, no-wrap
  24147. msgid "{Data Type} hostapd-configuration"
  24148. msgstr ""
  24149. #. type: deftp
  24150. #: guix-git/doc/guix.texi:16536
  24151. msgid "This data type represents the configuration of the hostapd service, with the following fields:"
  24152. msgstr ""
  24153. #. type: item
  24154. #: guix-git/doc/guix.texi:16538
  24155. #, no-wrap
  24156. msgid "@code{package} (default: @code{hostapd})"
  24157. msgstr ""
  24158. #. type: table
  24159. #: guix-git/doc/guix.texi:16540
  24160. msgid "The hostapd package to use."
  24161. msgstr ""
  24162. #. type: item
  24163. #: guix-git/doc/guix.texi:16541
  24164. #, no-wrap
  24165. msgid "@code{interface} (default: @code{\"wlan0\"})"
  24166. msgstr ""
  24167. #. type: table
  24168. #: guix-git/doc/guix.texi:16543
  24169. msgid "The network interface to run the WiFi access point."
  24170. msgstr ""
  24171. #. type: code{#1}
  24172. #: guix-git/doc/guix.texi:16544
  24173. #, no-wrap
  24174. msgid "ssid"
  24175. msgstr ""
  24176. #. type: table
  24177. #: guix-git/doc/guix.texi:16547
  24178. msgid "The SSID (@dfn{service set identifier}), a string that identifies this network."
  24179. msgstr ""
  24180. #. type: item
  24181. #: guix-git/doc/guix.texi:16548
  24182. #, no-wrap
  24183. msgid "@code{broadcast-ssid?} (default: @code{#t})"
  24184. msgstr ""
  24185. #. type: table
  24186. #: guix-git/doc/guix.texi:16550
  24187. msgid "Whether to broadcast this SSID."
  24188. msgstr ""
  24189. #. type: item
  24190. #: guix-git/doc/guix.texi:16551
  24191. #, no-wrap
  24192. msgid "@code{channel} (default: @code{1})"
  24193. msgstr ""
  24194. #. type: table
  24195. #: guix-git/doc/guix.texi:16553
  24196. msgid "The WiFi channel to use."
  24197. msgstr ""
  24198. #. type: item
  24199. #: guix-git/doc/guix.texi:16554
  24200. #, no-wrap
  24201. msgid "@code{driver} (default: @code{\"nl80211\"})"
  24202. msgstr ""
  24203. #. type: table
  24204. #: guix-git/doc/guix.texi:16558
  24205. msgid "The driver interface type. @code{\"nl80211\"} is used with all Linux mac80211 drivers. Use @code{\"none\"} if building hostapd as a standalone RADIUS server that does # not control any wireless/wired driver."
  24206. msgstr ""
  24207. #. type: item
  24208. #: guix-git/doc/guix.texi:16559 guix-git/doc/guix.texi:22571
  24209. #: guix-git/doc/guix.texi:25649
  24210. #, no-wrap
  24211. msgid "@code{extra-settings} (default: @code{\"\"})"
  24212. msgstr ""
  24213. #. type: table
  24214. #: guix-git/doc/guix.texi:16563
  24215. msgid "Extra settings to append as-is to the hostapd configuration file. See @uref{https://w1.fi/cgit/hostap/plain/hostapd/hostapd.conf} for the configuration file reference."
  24216. msgstr ""
  24217. #. type: defvr
  24218. #: guix-git/doc/guix.texi:16566
  24219. #, no-wrap
  24220. msgid "{Scheme Variable} simulated-wifi-service-type"
  24221. msgstr ""
  24222. #. type: defvr
  24223. #: guix-git/doc/guix.texi:16573
  24224. msgid "This is the type of a service to simulate WiFi networking, which can be useful in virtual machines for testing purposes. The service loads the Linux kernel @uref{https://www.kernel.org/doc/html/latest/networking/mac80211_hwsim/mac80211_hwsim.html, @code{mac80211_hwsim} module} and starts hostapd to create a pseudo WiFi network that can be seen on @code{wlan0}, by default."
  24225. msgstr ""
  24226. #. type: defvr
  24227. #: guix-git/doc/guix.texi:16575
  24228. msgid "The service's value is a @code{hostapd-configuration} record."
  24229. msgstr ""
  24230. #. type: cindex
  24231. #: guix-git/doc/guix.texi:16577
  24232. #, no-wrap
  24233. msgid "iptables"
  24234. msgstr ""
  24235. #. type: defvr
  24236. #: guix-git/doc/guix.texi:16578
  24237. #, no-wrap
  24238. msgid "{Scheme Variable} iptables-service-type"
  24239. msgstr ""
  24240. #. type: defvr
  24241. #: guix-git/doc/guix.texi:16584
  24242. msgid "This is the service type to set up an iptables configuration. iptables is a packet filtering framework supported by the Linux kernel. This service supports configuring iptables for both IPv4 and IPv6. A simple example configuration rejecting all incoming connections except those to the ssh port 22 is shown below."
  24243. msgstr ""
  24244. #. type: lisp
  24245. #: guix-git/doc/guix.texi:16606
  24246. #, no-wrap
  24247. msgid ""
  24248. "(service iptables-service-type\n"
  24249. " (iptables-configuration\n"
  24250. " (ipv4-rules (plain-file \"iptables.rules\" \"*filter\n"
  24251. ":INPUT ACCEPT\n"
  24252. ":FORWARD ACCEPT\n"
  24253. ":OUTPUT ACCEPT\n"
  24254. "-A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT\n"
  24255. "-A INPUT -p tcp --dport 22 -j ACCEPT\n"
  24256. "-A INPUT -j REJECT --reject-with icmp-port-unreachable\n"
  24257. "COMMIT\n"
  24258. "\"))\n"
  24259. " (ipv6-rules (plain-file \"ip6tables.rules\" \"*filter\n"
  24260. ":INPUT ACCEPT\n"
  24261. ":FORWARD ACCEPT\n"
  24262. ":OUTPUT ACCEPT\n"
  24263. "-A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT\n"
  24264. "-A INPUT -p tcp --dport 22 -j ACCEPT\n"
  24265. "-A INPUT -j REJECT --reject-with icmp6-port-unreachable\n"
  24266. "COMMIT\n"
  24267. "\"))))\n"
  24268. msgstr ""
  24269. #. type: deftp
  24270. #: guix-git/doc/guix.texi:16609
  24271. #, no-wrap
  24272. msgid "{Data Type} iptables-configuration"
  24273. msgstr ""
  24274. #. type: deftp
  24275. #: guix-git/doc/guix.texi:16611
  24276. msgid "The data type representing the configuration of iptables."
  24277. msgstr ""
  24278. #. type: item
  24279. #: guix-git/doc/guix.texi:16613
  24280. #, no-wrap
  24281. msgid "@code{iptables} (default: @code{iptables})"
  24282. msgstr ""
  24283. #. type: table
  24284. #: guix-git/doc/guix.texi:16616
  24285. msgid "The iptables package that provides @code{iptables-restore} and @code{ip6tables-restore}."
  24286. msgstr ""
  24287. #. type: item
  24288. #: guix-git/doc/guix.texi:16616
  24289. #, no-wrap
  24290. msgid "@code{ipv4-rules} (default: @code{%iptables-accept-all-rules})"
  24291. msgstr ""
  24292. #. type: table
  24293. #: guix-git/doc/guix.texi:16620
  24294. msgid "The iptables rules to use. It will be passed to @code{iptables-restore}. This may be any ``file-like'' object (@pxref{G-Expressions, file-like objects})."
  24295. msgstr ""
  24296. #. type: item
  24297. #: guix-git/doc/guix.texi:16620
  24298. #, no-wrap
  24299. msgid "@code{ipv6-rules} (default: @code{%iptables-accept-all-rules})"
  24300. msgstr ""
  24301. #. type: table
  24302. #: guix-git/doc/guix.texi:16624
  24303. msgid "The ip6tables rules to use. It will be passed to @code{ip6tables-restore}. This may be any ``file-like'' object (@pxref{G-Expressions, file-like objects})."
  24304. msgstr ""
  24305. #. type: cindex
  24306. #: guix-git/doc/guix.texi:16627
  24307. #, no-wrap
  24308. msgid "nftables"
  24309. msgstr ""
  24310. #. type: defvr
  24311. #: guix-git/doc/guix.texi:16628
  24312. #, no-wrap
  24313. msgid "{Scheme Variable} nftables-service-type"
  24314. msgstr ""
  24315. #. type: defvr
  24316. #: guix-git/doc/guix.texi:16636
  24317. msgid "This is the service type to set up a nftables configuration. nftables is a netfilter project that aims to replace the existing iptables, ip6tables, arptables and ebtables framework. It provides a new packet filtering framework, a new user-space utility @command{nft}, and a compatibility layer for iptables. This service comes with a default ruleset @code{%default-nftables-ruleset} that rejecting all incoming connections except those to the ssh port 22. To use it, simply write:"
  24318. msgstr ""
  24319. #. type: lisp
  24320. #: guix-git/doc/guix.texi:16639
  24321. #, no-wrap
  24322. msgid "(service nftables-service-type)\n"
  24323. msgstr ""
  24324. #. type: deftp
  24325. #: guix-git/doc/guix.texi:16642
  24326. #, no-wrap
  24327. msgid "{Data Type} nftables-configuration"
  24328. msgstr ""
  24329. #. type: deftp
  24330. #: guix-git/doc/guix.texi:16644
  24331. msgid "The data type representing the configuration of nftables."
  24332. msgstr ""
  24333. #. type: item
  24334. #: guix-git/doc/guix.texi:16646
  24335. #, no-wrap
  24336. msgid "@code{package} (default: @code{nftables})"
  24337. msgstr ""
  24338. #. type: table
  24339. #: guix-git/doc/guix.texi:16648
  24340. msgid "The nftables package that provides @command{nft}."
  24341. msgstr ""
  24342. #. type: item
  24343. #: guix-git/doc/guix.texi:16648
  24344. #, no-wrap
  24345. msgid "@code{ruleset} (default: @code{%default-nftables-ruleset})"
  24346. msgstr ""
  24347. #. type: table
  24348. #: guix-git/doc/guix.texi:16651
  24349. msgid "The nftables ruleset to use. This may be any ``file-like'' object (@pxref{G-Expressions, file-like objects})."
  24350. msgstr ""
  24351. #. type: cindex
  24352. #: guix-git/doc/guix.texi:16654
  24353. #, no-wrap
  24354. msgid "NTP (Network Time Protocol), service"
  24355. msgstr ""
  24356. #. type: cindex
  24357. #: guix-git/doc/guix.texi:16655
  24358. #, no-wrap
  24359. msgid "ntpd, service for the Network Time Protocol daemon"
  24360. msgstr ""
  24361. #. type: cindex
  24362. #: guix-git/doc/guix.texi:16656
  24363. #, no-wrap
  24364. msgid "real time clock"
  24365. msgstr ""
  24366. #. type: defvr
  24367. #: guix-git/doc/guix.texi:16657
  24368. #, no-wrap
  24369. msgid "{Scheme Variable} ntp-service-type"
  24370. msgstr ""
  24371. #. type: defvr
  24372. #: guix-git/doc/guix.texi:16661
  24373. msgid "This is the type of the service running the @uref{https://www.ntp.org, Network Time Protocol (NTP)} daemon, @command{ntpd}. The daemon will keep the system clock synchronized with that of the specified NTP servers."
  24374. msgstr ""
  24375. #. type: defvr
  24376. #: guix-git/doc/guix.texi:16664
  24377. msgid "The value of this service is an @code{ntpd-configuration} object, as described below."
  24378. msgstr ""
  24379. #. type: deftp
  24380. #: guix-git/doc/guix.texi:16666
  24381. #, no-wrap
  24382. msgid "{Data Type} ntp-configuration"
  24383. msgstr ""
  24384. #. type: deftp
  24385. #: guix-git/doc/guix.texi:16668
  24386. msgid "This is the data type for the NTP service configuration."
  24387. msgstr ""
  24388. #. type: item
  24389. #: guix-git/doc/guix.texi:16670
  24390. #, no-wrap
  24391. msgid "@code{servers} (default: @code{%ntp-servers})"
  24392. msgstr ""
  24393. #. type: table
  24394. #: guix-git/doc/guix.texi:16674
  24395. msgid "This is the list of servers (@code{<ntp-server>} records) with which @command{ntpd} will be synchronized. See the @code{ntp-server} data type definition below."
  24396. msgstr ""
  24397. #. type: item
  24398. #: guix-git/doc/guix.texi:16675
  24399. #, no-wrap
  24400. msgid "@code{allow-large-adjustment?} (default: @code{#t})"
  24401. msgstr ""
  24402. #. type: table
  24403. #: guix-git/doc/guix.texi:16678
  24404. msgid "This determines whether @command{ntpd} is allowed to make an initial adjustment of more than 1,000 seconds."
  24405. msgstr ""
  24406. #. type: item
  24407. #: guix-git/doc/guix.texi:16679
  24408. #, no-wrap
  24409. msgid "@code{ntp} (default: @code{ntp})"
  24410. msgstr ""
  24411. #. type: table
  24412. #: guix-git/doc/guix.texi:16681
  24413. msgid "The NTP package to use."
  24414. msgstr ""
  24415. #. type: defvr
  24416. #: guix-git/doc/guix.texi:16684
  24417. #, no-wrap
  24418. msgid "{Scheme Variable} %ntp-servers"
  24419. msgstr ""
  24420. #. type: defvr
  24421. #: guix-git/doc/guix.texi:16687
  24422. msgid "List of host names used as the default NTP servers. These are servers of the @uref{https://www.ntppool.org/en/, NTP Pool Project}."
  24423. msgstr ""
  24424. #. type: deftp
  24425. #: guix-git/doc/guix.texi:16689
  24426. #, no-wrap
  24427. msgid "{Data Type} ntp-server"
  24428. msgstr ""
  24429. #. type: deftp
  24430. #: guix-git/doc/guix.texi:16691
  24431. msgid "The data type representing the configuration of a NTP server."
  24432. msgstr ""
  24433. #. type: item
  24434. #: guix-git/doc/guix.texi:16693
  24435. #, no-wrap
  24436. msgid "@code{type} (default: @code{'server})"
  24437. msgstr ""
  24438. #. type: table
  24439. #: guix-git/doc/guix.texi:16696
  24440. msgid "The type of the NTP server, given as a symbol. One of @code{'pool}, @code{'server}, @code{'peer}, @code{'broadcast} or @code{'manycastclient}."
  24441. msgstr ""
  24442. #. type: code{#1}
  24443. #: guix-git/doc/guix.texi:16697
  24444. #, no-wrap
  24445. msgid "address"
  24446. msgstr ""
  24447. #. type: table
  24448. #: guix-git/doc/guix.texi:16699
  24449. msgid "The address of the server, as a string."
  24450. msgstr ""
  24451. #. type: code{#1}
  24452. #: guix-git/doc/guix.texi:16700 guix-git/doc/guix.texi:32416
  24453. #: guix-git/doc/guix.texi:32436
  24454. #, no-wrap
  24455. msgid "options"
  24456. msgstr ""
  24457. #. type: table
  24458. #: guix-git/doc/guix.texi:16705
  24459. msgid "NTPD options to use with that specific server, given as a list of option names and/or of option names and values tuples. The following example define a server to use with the options @option{iburst} and @option{prefer}, as well as @option{version} 3 and a @option{maxpoll} time of 16 seconds."
  24460. msgstr ""
  24461. #. type: example
  24462. #: guix-git/doc/guix.texi:16711
  24463. #, no-wrap
  24464. msgid ""
  24465. "(ntp-server\n"
  24466. " (type 'server)\n"
  24467. " (address \"some.ntp.server.org\")\n"
  24468. " (options `(iburst (version 3) (maxpoll 16) prefer))))\n"
  24469. msgstr ""
  24470. #. type: cindex
  24471. #: guix-git/doc/guix.texi:16715
  24472. #, no-wrap
  24473. msgid "OpenNTPD"
  24474. msgstr ""
  24475. #. type: deffn
  24476. #: guix-git/doc/guix.texi:16716
  24477. #, no-wrap
  24478. msgid "{Scheme Procedure} openntpd-service-type"
  24479. msgstr ""
  24480. #. type: deffn
  24481. #: guix-git/doc/guix.texi:16720
  24482. msgid "Run the @command{ntpd}, the Network Time Protocol (NTP) daemon, as implemented by @uref{http://www.openntpd.org, OpenNTPD}. The daemon will keep the system clock synchronized with that of the given servers."
  24483. msgstr ""
  24484. #. type: lisp
  24485. #: guix-git/doc/guix.texi:16729
  24486. #, no-wrap
  24487. msgid ""
  24488. "(service\n"
  24489. " openntpd-service-type\n"
  24490. " (openntpd-configuration\n"
  24491. " (listen-on '(\"127.0.0.1\" \"::1\"))\n"
  24492. " (sensor '(\"udcf0 correction 70000\"))\n"
  24493. " (constraint-from '(\"www.gnu.org\"))\n"
  24494. " (constraints-from '(\"https://www.google.com/\"))))\n"
  24495. "\n"
  24496. msgstr ""
  24497. #. type: defvr
  24498. #: guix-git/doc/guix.texi:16733
  24499. #, no-wrap
  24500. msgid "{Scheme Variable} %openntpd-servers"
  24501. msgstr ""
  24502. #. type: defvr
  24503. #: guix-git/doc/guix.texi:16736
  24504. msgid "This variable is a list of the server addresses defined in @code{%ntp-servers}."
  24505. msgstr ""
  24506. #. type: deftp
  24507. #: guix-git/doc/guix.texi:16738
  24508. #, no-wrap
  24509. msgid "{Data Type} openntpd-configuration"
  24510. msgstr ""
  24511. #. type: item
  24512. #: guix-git/doc/guix.texi:16740
  24513. #, no-wrap
  24514. msgid "@code{openntpd} (default: @code{(file-append openntpd \"/sbin/ntpd\")})"
  24515. msgstr ""
  24516. #. type: table
  24517. #: guix-git/doc/guix.texi:16742
  24518. msgid "The openntpd executable to use."
  24519. msgstr ""
  24520. #. type: item
  24521. #: guix-git/doc/guix.texi:16742
  24522. #, no-wrap
  24523. msgid "@code{listen-on} (default: @code{'(\"127.0.0.1\" \"::1\")})"
  24524. msgstr ""
  24525. #. type: table
  24526. #: guix-git/doc/guix.texi:16744
  24527. msgid "A list of local IP addresses or hostnames the ntpd daemon should listen on."
  24528. msgstr ""
  24529. #. type: item
  24530. #: guix-git/doc/guix.texi:16744
  24531. #, no-wrap
  24532. msgid "@code{query-from} (default: @code{'()})"
  24533. msgstr ""
  24534. #. type: table
  24535. #: guix-git/doc/guix.texi:16746
  24536. msgid "A list of local IP address the ntpd daemon should use for outgoing queries."
  24537. msgstr ""
  24538. #. type: item
  24539. #: guix-git/doc/guix.texi:16746
  24540. #, no-wrap
  24541. msgid "@code{sensor} (default: @code{'()})"
  24542. msgstr ""
  24543. #. type: table
  24544. #: guix-git/doc/guix.texi:16751
  24545. msgid "Specify a list of timedelta sensor devices ntpd should use. @code{ntpd} will listen to each sensor that actually exists and ignore non-existent ones. See @uref{https://man.openbsd.org/ntpd.conf, upstream documentation} for more information."
  24546. msgstr ""
  24547. #. type: item
  24548. #: guix-git/doc/guix.texi:16751
  24549. #, no-wrap
  24550. msgid "@code{server} (default: @code{'()})"
  24551. msgstr ""
  24552. #. type: table
  24553. #: guix-git/doc/guix.texi:16753
  24554. msgid "Specify a list of IP addresses or hostnames of NTP servers to synchronize to."
  24555. msgstr ""
  24556. #. type: item
  24557. #: guix-git/doc/guix.texi:16753
  24558. #, no-wrap
  24559. msgid "@code{servers} (default: @code{%openntp-servers})"
  24560. msgstr ""
  24561. #. type: table
  24562. #: guix-git/doc/guix.texi:16755
  24563. msgid "Specify a list of IP addresses or hostnames of NTP pools to synchronize to."
  24564. msgstr ""
  24565. #. type: item
  24566. #: guix-git/doc/guix.texi:16755
  24567. #, no-wrap
  24568. msgid "@code{constraint-from} (default: @code{'()})"
  24569. msgstr ""
  24570. #. type: table
  24571. #: guix-git/doc/guix.texi:16762
  24572. msgid "@code{ntpd} can be configured to query the ‘Date’ from trusted HTTPS servers via TLS. This time information is not used for precision but acts as an authenticated constraint, thereby reducing the impact of unauthenticated NTP man-in-the-middle attacks. Specify a list of URLs, IP addresses or hostnames of HTTPS servers to provide a constraint."
  24573. msgstr ""
  24574. #. type: item
  24575. #: guix-git/doc/guix.texi:16762
  24576. #, no-wrap
  24577. msgid "@code{constraints-from} (default: @code{'()})"
  24578. msgstr ""
  24579. #. type: table
  24580. #: guix-git/doc/guix.texi:16766
  24581. msgid "As with constraint from, specify a list of URLs, IP addresses or hostnames of HTTPS servers to provide a constraint. Should the hostname resolve to multiple IP addresses, @code{ntpd} will calculate a median constraint from all of them."
  24582. msgstr ""
  24583. #. type: cindex
  24584. #: guix-git/doc/guix.texi:16769
  24585. #, no-wrap
  24586. msgid "inetd"
  24587. msgstr ""
  24588. #. type: deffn
  24589. #: guix-git/doc/guix.texi:16770
  24590. #, no-wrap
  24591. msgid "{Scheme variable} inetd-service-type"
  24592. msgstr ""
  24593. #. type: deffn
  24594. #: guix-git/doc/guix.texi:16775
  24595. msgid "This service runs the @command{inetd} (@pxref{inetd invocation,,, inetutils, GNU Inetutils}) daemon. @command{inetd} listens for connections on internet sockets, and lazily starts the specified server program when a connection is made on one of these sockets."
  24596. msgstr ""
  24597. #. type: deffn
  24598. #: guix-git/doc/guix.texi:16781
  24599. msgid "The value of this service is an @code{inetd-configuration} object. The following example configures the @command{inetd} daemon to provide the built-in @command{echo} service, as well as an smtp service which forwards smtp traffic over ssh to a server @code{smtp-server} behind a gateway @code{hostname}:"
  24600. msgstr ""
  24601. #. type: lisp
  24602. #: guix-git/doc/guix.texi:16804
  24603. #, no-wrap
  24604. msgid ""
  24605. "(service\n"
  24606. " inetd-service-type\n"
  24607. " (inetd-configuration\n"
  24608. " (entries (list\n"
  24609. " (inetd-entry\n"
  24610. " (name \"echo\")\n"
  24611. " (socket-type 'stream)\n"
  24612. " (protocol \"tcp\")\n"
  24613. " (wait? #f)\n"
  24614. " (user \"root\"))\n"
  24615. " (inetd-entry\n"
  24616. " (node \"127.0.0.1\")\n"
  24617. " (name \"smtp\")\n"
  24618. " (socket-type 'stream)\n"
  24619. " (protocol \"tcp\")\n"
  24620. " (wait? #f)\n"
  24621. " (user \"root\")\n"
  24622. " (program (file-append openssh \"/bin/ssh\"))\n"
  24623. " (arguments\n"
  24624. " '(\"ssh\" \"-qT\" \"-i\" \"/path/to/ssh_key\"\n"
  24625. " \"-W\" \"smtp-server:25\" \"user@@hostname\")))))))\n"
  24626. msgstr ""
  24627. #. type: deffn
  24628. #: guix-git/doc/guix.texi:16807
  24629. msgid "See below for more details about @code{inetd-configuration}."
  24630. msgstr ""
  24631. #. type: deftp
  24632. #: guix-git/doc/guix.texi:16809
  24633. #, no-wrap
  24634. msgid "{Data Type} inetd-configuration"
  24635. msgstr ""
  24636. #. type: deftp
  24637. #: guix-git/doc/guix.texi:16811
  24638. msgid "Data type representing the configuration of @command{inetd}."
  24639. msgstr ""
  24640. #. type: item
  24641. #: guix-git/doc/guix.texi:16813
  24642. #, no-wrap
  24643. msgid "@code{program} (default: @code{(file-append inetutils \"/libexec/inetd\")})"
  24644. msgstr ""
  24645. #. type: table
  24646. #: guix-git/doc/guix.texi:16815
  24647. msgid "The @command{inetd} executable to use."
  24648. msgstr ""
  24649. #. type: item
  24650. #: guix-git/doc/guix.texi:16816 guix-git/doc/guix.texi:26491
  24651. #, no-wrap
  24652. msgid "@code{entries} (default: @code{'()})"
  24653. msgstr ""
  24654. #. type: table
  24655. #: guix-git/doc/guix.texi:16819
  24656. msgid "A list of @command{inetd} service entries. Each entry should be created by the @code{inetd-entry} constructor."
  24657. msgstr ""
  24658. #. type: deftp
  24659. #: guix-git/doc/guix.texi:16822
  24660. #, no-wrap
  24661. msgid "{Data Type} inetd-entry"
  24662. msgstr ""
  24663. #. type: deftp
  24664. #: guix-git/doc/guix.texi:16826
  24665. msgid "Data type representing an entry in the @command{inetd} configuration. Each entry corresponds to a socket where @command{inetd} will listen for requests."
  24666. msgstr ""
  24667. #. type: item
  24668. #: guix-git/doc/guix.texi:16828
  24669. #, no-wrap
  24670. msgid "@code{node} (default: @code{#f})"
  24671. msgstr ""
  24672. #. type: table
  24673. #: guix-git/doc/guix.texi:16833
  24674. msgid "Optional string, a comma-separated list of local addresses @command{inetd} should use when listening for this service. @xref{Configuration file,,, inetutils, GNU Inetutils} for a complete description of all options."
  24675. msgstr ""
  24676. #. type: table
  24677. #: guix-git/doc/guix.texi:16835
  24678. msgid "A string, the name must correspond to an entry in @code{/etc/services}."
  24679. msgstr ""
  24680. #. type: code{#1}
  24681. #: guix-git/doc/guix.texi:16835
  24682. #, no-wrap
  24683. msgid "socket-type"
  24684. msgstr ""
  24685. #. type: table
  24686. #: guix-git/doc/guix.texi:16838
  24687. msgid "One of @code{'stream}, @code{'dgram}, @code{'raw}, @code{'rdm} or @code{'seqpacket}."
  24688. msgstr ""
  24689. #. type: code{#1}
  24690. #: guix-git/doc/guix.texi:16838
  24691. #, no-wrap
  24692. msgid "protocol"
  24693. msgstr ""
  24694. #. type: table
  24695. #: guix-git/doc/guix.texi:16840
  24696. msgid "A string, must correspond to an entry in @code{/etc/protocols}."
  24697. msgstr ""
  24698. #. type: item
  24699. #: guix-git/doc/guix.texi:16840
  24700. #, no-wrap
  24701. msgid "@code{wait?} (default: @code{#t})"
  24702. msgstr ""
  24703. #. type: table
  24704. #: guix-git/doc/guix.texi:16843
  24705. msgid "Whether @command{inetd} should wait for the server to exit before listening to new service requests."
  24706. msgstr ""
  24707. #. type: table
  24708. #: guix-git/doc/guix.texi:16848
  24709. msgid "A string containing the user (and, optionally, group) name of the user as whom the server should run. The group name can be specified in a suffix, separated by a colon or period, i.e.@: @code{\"user\"}, @code{\"user:group\"} or @code{\"user.group\"}."
  24710. msgstr ""
  24711. #. type: item
  24712. #: guix-git/doc/guix.texi:16848
  24713. #, no-wrap
  24714. msgid "@code{program} (default: @code{\"internal\"})"
  24715. msgstr ""
  24716. #. type: table
  24717. #: guix-git/doc/guix.texi:16851
  24718. msgid "The server program which will serve the requests, or @code{\"internal\"} if @command{inetd} should use a built-in service."
  24719. msgstr ""
  24720. #. type: table
  24721. #: guix-git/doc/guix.texi:16856
  24722. msgid "A list strings or file-like objects, which are the server program's arguments, starting with the zeroth argument, i.e.@: the name of the program itself. For @command{inetd}'s internal services, this entry must be @code{'()} or @code{'(\"internal\")}."
  24723. msgstr ""
  24724. #. type: deftp
  24725. #: guix-git/doc/guix.texi:16860
  24726. msgid "@xref{Configuration file,,, inetutils, GNU Inetutils} for a more detailed discussion of each configuration field."
  24727. msgstr ""
  24728. #. type: cindex
  24729. #: guix-git/doc/guix.texi:16862
  24730. #, no-wrap
  24731. msgid "opendht, distributed hash table network service"
  24732. msgstr ""
  24733. #. type: cindex
  24734. #: guix-git/doc/guix.texi:16863
  24735. #, no-wrap
  24736. msgid "dhtproxy, for use with jami"
  24737. msgstr ""
  24738. #. type: defvr
  24739. #: guix-git/doc/guix.texi:16864
  24740. #, no-wrap
  24741. msgid "{Scheme Variable} opendht-service-type"
  24742. msgstr ""
  24743. #. type: defvr
  24744. #: guix-git/doc/guix.texi:16869
  24745. msgid "This is the type of the service running a @uref{https://opendht.net, OpenDHT} node, @command{dhtnode}. The daemon can be used to host your own proxy service to the distributed hash table (DHT), for example to connect to with Jami, among other applications."
  24746. msgstr ""
  24747. #. type: quotation
  24748. #: guix-git/doc/guix.texi:16879
  24749. msgid "When using the OpenDHT proxy server, the IP addresses it ``sees'' from the clients should be addresses reachable from other peers. In practice this means that a publicly reachable address is best suited for a proxy server, outside of your private network. For example, hosting the proxy server on a IPv4 private local network and exposing it via port forwarding could work for external peers, but peers local to the proxy would have their private addresses shared with the external peers, leading to connectivity problems."
  24750. msgstr ""
  24751. #. type: defvr
  24752. #: guix-git/doc/guix.texi:16883
  24753. msgid "The value of this service is a @code{opendht-configuration} object, as described below."
  24754. msgstr ""
  24755. #. type: deftp
  24756. #: guix-git/doc/guix.texi:16885
  24757. #, no-wrap
  24758. msgid "{Data Type} opendht-configuration"
  24759. msgstr ""
  24760. #. type: deftp
  24761. #: guix-git/doc/guix.texi:16887
  24762. msgid "This is the data type for the OpenDHT service configuration."
  24763. msgstr ""
  24764. #. type: deftp
  24765. #: guix-git/doc/guix.texi:16892
  24766. msgid "Available @code{opendht-configuration} fields are:"
  24767. msgstr ""
  24768. #. type: deftypevr
  24769. #: guix-git/doc/guix.texi:16893
  24770. #, no-wrap
  24771. msgid "{@code{opendht-configuration} parameter} package opendht"
  24772. msgstr ""
  24773. #. type: deftypevr
  24774. #: guix-git/doc/guix.texi:16895
  24775. msgid "The @code{opendht} package to use."
  24776. msgstr ""
  24777. #. type: deftypevr
  24778. #: guix-git/doc/guix.texi:16898
  24779. #, no-wrap
  24780. msgid "{@code{opendht-configuration} parameter} boolean peer-discovery?"
  24781. msgstr ""
  24782. #. type: deftypevr
  24783. #: guix-git/doc/guix.texi:16900
  24784. msgid "Whether to enable the multicast local peer discovery mechanism."
  24785. msgstr ""
  24786. #. type: deftypevr
  24787. #: guix-git/doc/guix.texi:16902 guix-git/doc/guix.texi:16910
  24788. #: guix-git/doc/guix.texi:16918 guix-git/doc/guix.texi:18562
  24789. #: guix-git/doc/guix.texi:18632 guix-git/doc/guix.texi:18674
  24790. #: guix-git/doc/guix.texi:18694 guix-git/doc/guix.texi:18700
  24791. #: guix-git/doc/guix.texi:18716 guix-git/doc/guix.texi:18804
  24792. #: guix-git/doc/guix.texi:18892 guix-git/doc/guix.texi:19205
  24793. #: guix-git/doc/guix.texi:19218 guix-git/doc/guix.texi:20335
  24794. #: guix-git/doc/guix.texi:21813 guix-git/doc/guix.texi:21919
  24795. #: guix-git/doc/guix.texi:21984 guix-git/doc/guix.texi:21993
  24796. #: guix-git/doc/guix.texi:23226 guix-git/doc/guix.texi:23270
  24797. #: guix-git/doc/guix.texi:23287 guix-git/doc/guix.texi:23295
  24798. #: guix-git/doc/guix.texi:23310 guix-git/doc/guix.texi:23328
  24799. #: guix-git/doc/guix.texi:23352 guix-git/doc/guix.texi:23405
  24800. #: guix-git/doc/guix.texi:23538 guix-git/doc/guix.texi:23572
  24801. #: guix-git/doc/guix.texi:23608 guix-git/doc/guix.texi:23624
  24802. #: guix-git/doc/guix.texi:23652 guix-git/doc/guix.texi:23713
  24803. #: guix-git/doc/guix.texi:23796 guix-git/doc/guix.texi:27206
  24804. #: guix-git/doc/guix.texi:27220 guix-git/doc/guix.texi:27242
  24805. #: guix-git/doc/guix.texi:27361 guix-git/doc/guix.texi:27375
  24806. #: guix-git/doc/guix.texi:27396 guix-git/doc/guix.texi:27417
  24807. #: guix-git/doc/guix.texi:27424 guix-git/doc/guix.texi:27469
  24808. #: guix-git/doc/guix.texi:27476 guix-git/doc/guix.texi:28259
  24809. #: guix-git/doc/guix.texi:28273 guix-git/doc/guix.texi:28445
  24810. #: guix-git/doc/guix.texi:28490 guix-git/doc/guix.texi:28577
  24811. #: guix-git/doc/guix.texi:28779 guix-git/doc/guix.texi:28812
  24812. #: guix-git/doc/guix.texi:28952 guix-git/doc/guix.texi:28963
  24813. #: guix-git/doc/guix.texi:29214 guix-git/doc/guix.texi:30680
  24814. #: guix-git/doc/guix.texi:30689 guix-git/doc/guix.texi:30697
  24815. #: guix-git/doc/guix.texi:30705 guix-git/doc/guix.texi:30721
  24816. #: guix-git/doc/guix.texi:30737 guix-git/doc/guix.texi:30745
  24817. #: guix-git/doc/guix.texi:30753 guix-git/doc/guix.texi:30762
  24818. #: guix-git/doc/guix.texi:30771 guix-git/doc/guix.texi:30787
  24819. #: guix-git/doc/guix.texi:30851 guix-git/doc/guix.texi:30957
  24820. #: guix-git/doc/guix.texi:30965 guix-git/doc/guix.texi:30973
  24821. #: guix-git/doc/guix.texi:30998 guix-git/doc/guix.texi:31052
  24822. #: guix-git/doc/guix.texi:31100 guix-git/doc/guix.texi:31301
  24823. #: guix-git/doc/guix.texi:31308
  24824. msgid "Defaults to @samp{#f}."
  24825. msgstr ""
  24826. #. type: deftypevr
  24827. #: guix-git/doc/guix.texi:16905
  24828. #, no-wrap
  24829. msgid "{@code{opendht-configuration} parameter} boolean enable-logging?"
  24830. msgstr ""
  24831. #. type: deftypevr
  24832. #: guix-git/doc/guix.texi:16908
  24833. msgid "Whether to enable logging messages to syslog. It is disabled by default as it is rather verbose."
  24834. msgstr ""
  24835. #. type: deftypevr
  24836. #: guix-git/doc/guix.texi:16913
  24837. #, no-wrap
  24838. msgid "{@code{opendht-configuration} parameter} boolean debug?"
  24839. msgstr ""
  24840. #. type: deftypevr
  24841. #: guix-git/doc/guix.texi:16916
  24842. msgid "Whether to enable debug-level logging messages. This has no effect if logging is disabled."
  24843. msgstr ""
  24844. #. type: deftypevr
  24845. #: guix-git/doc/guix.texi:16921
  24846. #, no-wrap
  24847. msgid "{@code{opendht-configuration} parameter} maybe-string bootstrap-host"
  24848. msgstr ""
  24849. #. type: deftypevr
  24850. #: guix-git/doc/guix.texi:16927
  24851. msgid "The node host name that is used to make the first connection to the network. A specific port value can be provided by appending the @code{:PORT} suffix. By default, it uses the Jami bootstrap nodes, but any host can be specified here. It's also possible to disable bootsrapping by setting this to the @code{'disabled} symbol."
  24852. msgstr ""
  24853. #. type: deftypevr
  24854. #: guix-git/doc/guix.texi:16929
  24855. msgid "Defaults to @samp{\"bootstrap.jami.net:4222\"}."
  24856. msgstr ""
  24857. #. type: deftypevr
  24858. #: guix-git/doc/guix.texi:16932
  24859. #, no-wrap
  24860. msgid "{@code{opendht-configuration} parameter} maybe-number port"
  24861. msgstr ""
  24862. #. type: deftypevr
  24863. #: guix-git/doc/guix.texi:16935
  24864. msgid "The UDP port to bind to. When set to @code{'disabled}, an available port is automatically selected."
  24865. msgstr ""
  24866. #. type: deftypevr
  24867. #: guix-git/doc/guix.texi:16937
  24868. msgid "Defaults to @samp{4222}."
  24869. msgstr ""
  24870. #. type: deftypevr
  24871. #: guix-git/doc/guix.texi:16940
  24872. #, no-wrap
  24873. msgid "{@code{opendht-configuration} parameter} maybe-number proxy-server-port"
  24874. msgstr ""
  24875. #. type: deftypevr
  24876. #: guix-git/doc/guix.texi:16942
  24877. msgid "Spawn a proxy server listening on the specified port."
  24878. msgstr ""
  24879. #. type: deftypevr
  24880. #: guix-git/doc/guix.texi:16944 guix-git/doc/guix.texi:16951
  24881. #: guix-git/doc/guix.texi:23234 guix-git/doc/guix.texi:23278
  24882. #: guix-git/doc/guix.texi:23491 guix-git/doc/guix.texi:23547
  24883. #: guix-git/doc/guix.texi:23721 guix-git/doc/guix.texi:23732
  24884. #: guix-git/doc/guix.texi:23805 guix-git/doc/guix.texi:24530
  24885. #: guix-git/doc/guix.texi:24573 guix-git/doc/guix.texi:24581
  24886. #: guix-git/doc/guix.texi:24589 guix-git/doc/guix.texi:24597
  24887. #: guix-git/doc/guix.texi:24606 guix-git/doc/guix.texi:24614
  24888. #: guix-git/doc/guix.texi:24621 guix-git/doc/guix.texi:24629
  24889. #: guix-git/doc/guix.texi:24637 guix-git/doc/guix.texi:24647
  24890. #: guix-git/doc/guix.texi:24654 guix-git/doc/guix.texi:24678
  24891. #: guix-git/doc/guix.texi:24686 guix-git/doc/guix.texi:24712
  24892. #: guix-git/doc/guix.texi:24721 guix-git/doc/guix.texi:24730
  24893. #: guix-git/doc/guix.texi:24739 guix-git/doc/guix.texi:24748
  24894. #: guix-git/doc/guix.texi:24757 guix-git/doc/guix.texi:24765
  24895. #: guix-git/doc/guix.texi:24773 guix-git/doc/guix.texi:24780
  24896. #: guix-git/doc/guix.texi:24788 guix-git/doc/guix.texi:24795
  24897. #: guix-git/doc/guix.texi:24803 guix-git/doc/guix.texi:24811
  24898. #: guix-git/doc/guix.texi:24820 guix-git/doc/guix.texi:24829
  24899. #: guix-git/doc/guix.texi:24837 guix-git/doc/guix.texi:24845
  24900. #: guix-git/doc/guix.texi:24853 guix-git/doc/guix.texi:24864
  24901. #: guix-git/doc/guix.texi:24874 guix-git/doc/guix.texi:24885
  24902. #: guix-git/doc/guix.texi:24894 guix-git/doc/guix.texi:24904
  24903. #: guix-git/doc/guix.texi:24912 guix-git/doc/guix.texi:24923
  24904. #: guix-git/doc/guix.texi:24932 guix-git/doc/guix.texi:24942
  24905. #: guix-git/doc/guix.texi:28172 guix-git/doc/guix.texi:28179
  24906. #: guix-git/doc/guix.texi:28186 guix-git/doc/guix.texi:28193
  24907. #: guix-git/doc/guix.texi:28200 guix-git/doc/guix.texi:28207
  24908. #: guix-git/doc/guix.texi:28215 guix-git/doc/guix.texi:28223
  24909. #: guix-git/doc/guix.texi:28230 guix-git/doc/guix.texi:28237
  24910. #: guix-git/doc/guix.texi:28244 guix-git/doc/guix.texi:28251
  24911. #: guix-git/doc/guix.texi:28281 guix-git/doc/guix.texi:28319
  24912. #: guix-git/doc/guix.texi:28326 guix-git/doc/guix.texi:28335
  24913. #: guix-git/doc/guix.texi:28357 guix-git/doc/guix.texi:28365
  24914. #: guix-git/doc/guix.texi:28372 guix-git/doc/guix.texi:28527
  24915. #: guix-git/doc/guix.texi:28547 guix-git/doc/guix.texi:28562
  24916. #: guix-git/doc/guix.texi:28569 guix-git/doc/guix.texi:31253
  24917. #: guix-git/doc/guix.texi:31261 guix-git/doc/guix.texi:31269
  24918. #: guix-git/doc/guix.texi:31277 guix-git/doc/guix.texi:31285
  24919. #: guix-git/doc/guix.texi:31293
  24920. msgid "Defaults to @samp{disabled}."
  24921. msgstr ""
  24922. #. type: deftypevr
  24923. #: guix-git/doc/guix.texi:16947
  24924. #, no-wrap
  24925. msgid "{@code{opendht-configuration} parameter} maybe-number proxy-server-port-tls"
  24926. msgstr ""
  24927. #. type: deftypevr
  24928. #: guix-git/doc/guix.texi:16949
  24929. msgid "Spawn a proxy server listening to TLS connections on the specified port."
  24930. msgstr ""
  24931. #. type: cindex
  24932. #: guix-git/doc/guix.texi:16955
  24933. #, no-wrap
  24934. msgid "Tor"
  24935. msgstr ""
  24936. #. type: defvr
  24937. #: guix-git/doc/guix.texi:16956
  24938. #, no-wrap
  24939. msgid "{Scheme Variable} tor-service-type"
  24940. msgstr ""
  24941. #. type: defvr
  24942. #: guix-git/doc/guix.texi:16961
  24943. msgid "This is the type for a service that runs the @uref{https://torproject.org, Tor} anonymous networking daemon. The service is configured using a @code{<tor-configuration>} record. By default, the Tor daemon runs as the @code{tor} unprivileged user, which is a member of the @code{tor} group."
  24944. msgstr ""
  24945. #. type: deftp
  24946. #: guix-git/doc/guix.texi:16964
  24947. #, no-wrap
  24948. msgid "{Data Type} tor-configuration"
  24949. msgstr ""
  24950. #. type: item
  24951. #: guix-git/doc/guix.texi:16966
  24952. #, no-wrap
  24953. msgid "@code{tor} (default: @code{tor})"
  24954. msgstr ""
  24955. #. type: table
  24956. #: guix-git/doc/guix.texi:16971
  24957. msgid "The package that provides the Tor daemon. This package is expected to provide the daemon at @file{bin/tor} relative to its output directory. The default package is the @uref{https://www.torproject.org, Tor Project's} implementation."
  24958. msgstr ""
  24959. #. type: item
  24960. #: guix-git/doc/guix.texi:16972
  24961. #, no-wrap
  24962. msgid "@code{config-file} (default: @code{(plain-file \"empty\" \"\")})"
  24963. msgstr ""
  24964. #. type: table
  24965. #: guix-git/doc/guix.texi:16978
  24966. msgid "The configuration file to use. It will be appended to a default configuration file, and the final configuration file will be passed to @code{tor} via its @code{-f} option. This may be any ``file-like'' object (@pxref{G-Expressions, file-like objects}). See @code{man tor} for details on the configuration file syntax."
  24967. msgstr ""
  24968. #. type: item
  24969. #: guix-git/doc/guix.texi:16979
  24970. #, no-wrap
  24971. msgid "@code{hidden-services} (default: @code{'()})"
  24972. msgstr ""
  24973. #. type: table
  24974. #: guix-git/doc/guix.texi:16985
  24975. msgid "The list of @code{<hidden-service>} records to use. For any hidden service you include in this list, appropriate configuration to enable the hidden service will be automatically added to the default configuration file. You may conveniently create @code{<hidden-service>} records using the @code{tor-hidden-service} procedure described below."
  24976. msgstr ""
  24977. #. type: item
  24978. #: guix-git/doc/guix.texi:16986
  24979. #, no-wrap
  24980. msgid "@code{socks-socket-type} (default: @code{'tcp})"
  24981. msgstr ""
  24982. #. type: table
  24983. #: guix-git/doc/guix.texi:16993
  24984. msgid "The default socket type that Tor should use for its SOCKS socket. This must be either @code{'tcp} or @code{'unix}. If it is @code{'tcp}, then by default Tor will listen on TCP port 9050 on the loopback interface (i.e., localhost). If it is @code{'unix}, then Tor will listen on the UNIX domain socket @file{/var/run/tor/socks-sock}, which will be made writable by members of the @code{tor} group."
  24985. msgstr ""
  24986. #. type: table
  24987. #: guix-git/doc/guix.texi:16998
  24988. msgid "If you want to customize the SOCKS socket in more detail, leave @code{socks-socket-type} at its default value of @code{'tcp} and use @code{config-file} to override the default by providing your own @code{SocksPort} option."
  24989. msgstr ""
  24990. #. type: item
  24991. #: guix-git/doc/guix.texi:16999
  24992. #, no-wrap
  24993. msgid "@code{control-socket?} (default: @code{#f})"
  24994. msgstr ""
  24995. #. type: table
  24996. #: guix-git/doc/guix.texi:17005
  24997. msgid "Whether or not to provide a ``control socket'' by which Tor can be controlled to, for instance, dynamically instantiate tor onion services. If @code{#t}, Tor will listen for control commands on the UNIX domain socket @file{/var/run/tor/control-sock}, which will be made writable by members of the @code{tor} group."
  24998. msgstr ""
  24999. #. type: cindex
  25000. #: guix-git/doc/guix.texi:17009
  25001. #, no-wrap
  25002. msgid "hidden service"
  25003. msgstr ""
  25004. #. type: deffn
  25005. #: guix-git/doc/guix.texi:17010
  25006. #, no-wrap
  25007. msgid "{Scheme Procedure} tor-hidden-service @var{name} @var{mapping}"
  25008. msgstr ""
  25009. #. type: deffn
  25010. #: guix-git/doc/guix.texi:17013
  25011. msgid "Define a new Tor @dfn{hidden service} called @var{name} and implementing @var{mapping}. @var{mapping} is a list of port/host tuples, such as:"
  25012. msgstr ""
  25013. #. type: example
  25014. #: guix-git/doc/guix.texi:17017
  25015. #, no-wrap
  25016. msgid ""
  25017. " '((22 \"127.0.0.1:22\")\n"
  25018. " (80 \"127.0.0.1:8080\"))\n"
  25019. msgstr ""
  25020. #. type: deffn
  25021. #: guix-git/doc/guix.texi:17021
  25022. msgid "In this example, port 22 of the hidden service is mapped to local port 22, and port 80 is mapped to local port 8080."
  25023. msgstr ""
  25024. #. type: deffn
  25025. #: guix-git/doc/guix.texi:17025
  25026. msgid "This creates a @file{/var/lib/tor/hidden-services/@var{name}} directory, where the @file{hostname} file contains the @code{.onion} host name for the hidden service."
  25027. msgstr ""
  25028. #. type: deffn
  25029. #: guix-git/doc/guix.texi:17028
  25030. msgid "See @uref{https://www.torproject.org/docs/tor-hidden-service.html.en, the Tor project's documentation} for more information."
  25031. msgstr ""
  25032. #. type: Plain text
  25033. #: guix-git/doc/guix.texi:17031
  25034. msgid "The @code{(gnu services rsync)} module provides the following services:"
  25035. msgstr ""
  25036. #. type: Plain text
  25037. #: guix-git/doc/guix.texi:17035
  25038. msgid "You might want an rsync daemon if you have files that you want available so anyone (or just yourself) can download existing files or upload new files."
  25039. msgstr ""
  25040. #. type: deffn
  25041. #: guix-git/doc/guix.texi:17036
  25042. #, no-wrap
  25043. msgid "{Scheme Variable} rsync-service-type"
  25044. msgstr ""
  25045. #. type: deffn
  25046. #: guix-git/doc/guix.texi:17040
  25047. msgid "This is the service type for the @uref{https://rsync.samba.org, rsync} daemon, The value for this service type is a @command{rsync-configuration} record as in this example:"
  25048. msgstr ""
  25049. #. type: lisp
  25050. #: guix-git/doc/guix.texi:17043
  25051. #, no-wrap
  25052. msgid "(service rsync-service-type)\n"
  25053. msgstr ""
  25054. #. type: deffn
  25055. #: guix-git/doc/guix.texi:17046
  25056. msgid "See below for details about @code{rsync-configuration}."
  25057. msgstr ""
  25058. #. type: deftp
  25059. #: guix-git/doc/guix.texi:17048
  25060. #, no-wrap
  25061. msgid "{Data Type} rsync-configuration"
  25062. msgstr ""
  25063. #. type: deftp
  25064. #: guix-git/doc/guix.texi:17050
  25065. msgid "Data type representing the configuration for @code{rsync-service}."
  25066. msgstr ""
  25067. #. type: item
  25068. #: guix-git/doc/guix.texi:17052
  25069. #, no-wrap
  25070. msgid "@code{package} (default: @var{rsync})"
  25071. msgstr ""
  25072. #. type: table
  25073. #: guix-git/doc/guix.texi:17054
  25074. msgid "@code{rsync} package to use."
  25075. msgstr ""
  25076. #. type: item
  25077. #: guix-git/doc/guix.texi:17055
  25078. #, no-wrap
  25079. msgid "@code{port-number} (default: @code{873})"
  25080. msgstr ""
  25081. #. type: table
  25082. #: guix-git/doc/guix.texi:17059
  25083. msgid "TCP port on which @command{rsync} listens for incoming connections. If port is less than @code{1024} @command{rsync} needs to be started as the @code{root} user and group."
  25084. msgstr ""
  25085. #. type: item
  25086. #: guix-git/doc/guix.texi:17060
  25087. #, no-wrap
  25088. msgid "@code{pid-file} (default: @code{\"/var/run/rsyncd/rsyncd.pid\"})"
  25089. msgstr ""
  25090. #. type: table
  25091. #: guix-git/doc/guix.texi:17062
  25092. msgid "Name of the file where @command{rsync} writes its PID."
  25093. msgstr ""
  25094. #. type: item
  25095. #: guix-git/doc/guix.texi:17063
  25096. #, no-wrap
  25097. msgid "@code{lock-file} (default: @code{\"/var/run/rsyncd/rsyncd.lock\"})"
  25098. msgstr ""
  25099. #. type: table
  25100. #: guix-git/doc/guix.texi:17065
  25101. msgid "Name of the file where @command{rsync} writes its lock file."
  25102. msgstr ""
  25103. #. type: item
  25104. #: guix-git/doc/guix.texi:17066
  25105. #, no-wrap
  25106. msgid "@code{log-file} (default: @code{\"/var/log/rsyncd.log\"})"
  25107. msgstr ""
  25108. #. type: table
  25109. #: guix-git/doc/guix.texi:17068
  25110. msgid "Name of the file where @command{rsync} writes its log file."
  25111. msgstr ""
  25112. #. type: item
  25113. #: guix-git/doc/guix.texi:17069
  25114. #, no-wrap
  25115. msgid "@code{use-chroot?} (default: @var{#t})"
  25116. msgstr ""
  25117. #. type: table
  25118. #: guix-git/doc/guix.texi:17071
  25119. msgid "Whether to use chroot for @command{rsync} shared directory."
  25120. msgstr ""
  25121. #. type: item
  25122. #: guix-git/doc/guix.texi:17072
  25123. #, no-wrap
  25124. msgid "@code{share-path} (default: @file{/srv/rsync})"
  25125. msgstr ""
  25126. #. type: table
  25127. #: guix-git/doc/guix.texi:17074
  25128. msgid "Location of the @command{rsync} shared directory."
  25129. msgstr ""
  25130. #. type: item
  25131. #: guix-git/doc/guix.texi:17075
  25132. #, no-wrap
  25133. msgid "@code{share-comment} (default: @code{\"Rsync share\"})"
  25134. msgstr ""
  25135. #. type: table
  25136. #: guix-git/doc/guix.texi:17077
  25137. msgid "Comment of the @command{rsync} shared directory."
  25138. msgstr ""
  25139. #. type: item
  25140. #: guix-git/doc/guix.texi:17078
  25141. #, no-wrap
  25142. msgid "@code{read-only?} (default: @var{#f})"
  25143. msgstr ""
  25144. #. type: table
  25145. #: guix-git/doc/guix.texi:17080
  25146. msgid "Read-write permissions to shared directory."
  25147. msgstr ""
  25148. #. type: item
  25149. #: guix-git/doc/guix.texi:17081
  25150. #, no-wrap
  25151. msgid "@code{timeout} (default: @code{300})"
  25152. msgstr ""
  25153. #. type: table
  25154. #: guix-git/doc/guix.texi:17083
  25155. msgid "I/O timeout in seconds."
  25156. msgstr ""
  25157. #. type: item
  25158. #: guix-git/doc/guix.texi:17084
  25159. #, no-wrap
  25160. msgid "@code{user} (default: @var{\"root\"})"
  25161. msgstr ""
  25162. #. type: table
  25163. #: guix-git/doc/guix.texi:17086
  25164. msgid "Owner of the @code{rsync} process."
  25165. msgstr ""
  25166. #. type: item
  25167. #: guix-git/doc/guix.texi:17087
  25168. #, no-wrap
  25169. msgid "@code{group} (default: @var{\"root\"})"
  25170. msgstr ""
  25171. #. type: table
  25172. #: guix-git/doc/guix.texi:17089
  25173. msgid "Group of the @code{rsync} process."
  25174. msgstr ""
  25175. #. type: item
  25176. #: guix-git/doc/guix.texi:17090
  25177. #, no-wrap
  25178. msgid "@code{uid} (default: @var{\"rsyncd\"})"
  25179. msgstr ""
  25180. #. type: table
  25181. #: guix-git/doc/guix.texi:17093
  25182. msgid "User name or user ID that file transfers to and from that module should take place as when the daemon was run as @code{root}."
  25183. msgstr ""
  25184. #. type: item
  25185. #: guix-git/doc/guix.texi:17094
  25186. #, no-wrap
  25187. msgid "@code{gid} (default: @var{\"rsyncd\"})"
  25188. msgstr ""
  25189. #. type: table
  25190. #: guix-git/doc/guix.texi:17096 guix-git/doc/guix.texi:17539
  25191. msgid "Group name or group ID that will be used when accessing the module."
  25192. msgstr ""
  25193. #. type: Plain text
  25194. #: guix-git/doc/guix.texi:17101
  25195. msgid "The @code{(gnu services syncthing)} module provides the following services:"
  25196. msgstr ""
  25197. #. type: cindex
  25198. #: guix-git/doc/guix.texi:17101
  25199. #, no-wrap
  25200. msgid "syncthing"
  25201. msgstr ""
  25202. #. type: Plain text
  25203. #: guix-git/doc/guix.texi:17106
  25204. msgid "You might want a syncthing daemon if you have files between two or more computers and want to sync them in real time, safely protected from prying eyes."
  25205. msgstr ""
  25206. #. type: deffn
  25207. #: guix-git/doc/guix.texi:17107
  25208. #, no-wrap
  25209. msgid "{Scheme Variable} syncthing-service-type"
  25210. msgstr ""
  25211. #. type: deffn
  25212. #: guix-git/doc/guix.texi:17111
  25213. msgid "This is the service type for the @uref{https://syncthing.net/, syncthing} daemon, The value for this service type is a @command{syncthing-configuration} record as in this example:"
  25214. msgstr ""
  25215. #. type: lisp
  25216. #: guix-git/doc/guix.texi:17115
  25217. #, no-wrap
  25218. msgid ""
  25219. "(service syncthing-service-type\n"
  25220. " (syncthing-configuration (user \"alice\")))\n"
  25221. msgstr ""
  25222. #. type: deffn
  25223. #: guix-git/doc/guix.texi:17118
  25224. msgid "See below for details about @code{syncthing-configuration}."
  25225. msgstr ""
  25226. #. type: deftp
  25227. #: guix-git/doc/guix.texi:17119
  25228. #, no-wrap
  25229. msgid "{Data Type} syncthing-configuration"
  25230. msgstr ""
  25231. #. type: deftp
  25232. #: guix-git/doc/guix.texi:17121
  25233. msgid "Data type representing the configuration for @code{syncthing-service-type}."
  25234. msgstr ""
  25235. #. type: item
  25236. #: guix-git/doc/guix.texi:17123
  25237. #, no-wrap
  25238. msgid "@code{syncthing} (default: @var{syncthing})"
  25239. msgstr ""
  25240. #. type: table
  25241. #: guix-git/doc/guix.texi:17125
  25242. msgid "@code{syncthing} package to use."
  25243. msgstr ""
  25244. #. type: item
  25245. #: guix-git/doc/guix.texi:17126
  25246. #, no-wrap
  25247. msgid "@code{arguments} (default: @var{'()})"
  25248. msgstr ""
  25249. #. type: table
  25250. #: guix-git/doc/guix.texi:17128
  25251. msgid "List of command-line arguments passing to @code{syncthing} binary."
  25252. msgstr ""
  25253. #. type: item
  25254. #: guix-git/doc/guix.texi:17129
  25255. #, no-wrap
  25256. msgid "@code{logflags} (default: @var{0})"
  25257. msgstr ""
  25258. #. type: table
  25259. #: guix-git/doc/guix.texi:17132
  25260. msgid "Sum of logging flags, see @uref{https://docs.syncthing.net/users/syncthing.html#cmdoption-logflags, Syncthing documentation logflags}."
  25261. msgstr ""
  25262. #. type: item
  25263. #: guix-git/doc/guix.texi:17133
  25264. #, no-wrap
  25265. msgid "@code{user} (default: @var{#f})"
  25266. msgstr ""
  25267. #. type: table
  25268. #: guix-git/doc/guix.texi:17136
  25269. msgid "The user as which the Syncthing service is to be run. This assumes that the specified user exists."
  25270. msgstr ""
  25271. #. type: item
  25272. #: guix-git/doc/guix.texi:17137
  25273. #, no-wrap
  25274. msgid "@code{group} (default: @var{\"users\"})"
  25275. msgstr ""
  25276. #. type: table
  25277. #: guix-git/doc/guix.texi:17140
  25278. msgid "The group as which the Syncthing service is to be run. This assumes that the specified group exists."
  25279. msgstr ""
  25280. #. type: item
  25281. #: guix-git/doc/guix.texi:17141
  25282. #, no-wrap
  25283. msgid "@code{home} (default: @var{#f})"
  25284. msgstr ""
  25285. #. type: table
  25286. #: guix-git/doc/guix.texi:17144
  25287. msgid "Common configuration and data directory. The default configuration directory is @file{$HOME} of the specified Syncthing @code{user}."
  25288. msgstr ""
  25289. #. type: Plain text
  25290. #: guix-git/doc/guix.texi:17150
  25291. msgid "Furthermore, @code{(gnu services ssh)} provides the following services."
  25292. msgstr ""
  25293. #. type: cindex
  25294. #: guix-git/doc/guix.texi:17150 guix-git/doc/guix.texi:17189
  25295. #: guix-git/doc/guix.texi:34307
  25296. #, no-wrap
  25297. msgid "SSH"
  25298. msgstr ""
  25299. #. type: cindex
  25300. #: guix-git/doc/guix.texi:17151 guix-git/doc/guix.texi:17190
  25301. #: guix-git/doc/guix.texi:34308
  25302. #, no-wrap
  25303. msgid "SSH server"
  25304. msgstr ""
  25305. #. type: deffn
  25306. #: guix-git/doc/guix.texi:17153
  25307. #, no-wrap
  25308. msgid "{Scheme Procedure} lsh-service [#:host-key \"/etc/lsh/host-key\"] @"
  25309. msgstr ""
  25310. #. type: deffn
  25311. #: guix-git/doc/guix.texi:17162
  25312. msgid "[#:daemonic? #t] [#:interfaces '()] [#:port-number 22] @ [#:allow-empty-passwords? #f] [#:root-login? #f] @ [#:syslog-output? #t] [#:x11-forwarding? #t] @ [#:tcp/ip-forwarding? #t] [#:password-authentication? #t] @ [#:public-key-authentication? #t] [#:initialize? #t] Run the @command{lshd} program from @var{lsh} to listen on port @var{port-number}. @var{host-key} must designate a file containing the host key, and readable only by root."
  25313. msgstr ""
  25314. #. type: deffn
  25315. #: guix-git/doc/guix.texi:17168
  25316. msgid "When @var{daemonic?} is true, @command{lshd} will detach from the controlling terminal and log its output to syslogd, unless one sets @var{syslog-output?} to false. Obviously, it also makes lsh-service depend on existence of syslogd service. When @var{pid-file?} is true, @command{lshd} writes its PID to the file called @var{pid-file}."
  25317. msgstr ""
  25318. #. type: deffn
  25319. #: guix-git/doc/guix.texi:17172
  25320. msgid "When @var{initialize?} is true, automatically create the seed and host key upon service activation if they do not exist yet. This may take long and require interaction."
  25321. msgstr ""
  25322. #. type: deffn
  25323. #: guix-git/doc/guix.texi:17177
  25324. msgid "When @var{initialize?} is false, it is up to the user to initialize the randomness generator (@pxref{lsh-make-seed,,, lsh, LSH Manual}), and to create a key pair with the private key stored in file @var{host-key} (@pxref{lshd basics,,, lsh, LSH Manual})."
  25325. msgstr ""
  25326. #. type: deffn
  25327. #: guix-git/doc/guix.texi:17181
  25328. msgid "When @var{interfaces} is empty, lshd listens for connections on all the network interfaces; otherwise, @var{interfaces} must be a list of host names or addresses."
  25329. msgstr ""
  25330. #. type: deffn
  25331. #: guix-git/doc/guix.texi:17185
  25332. msgid "@var{allow-empty-passwords?} specifies whether to accept log-ins with empty passwords, and @var{root-login?} specifies whether to accept log-ins as root."
  25333. msgstr ""
  25334. #. type: deffn
  25335. #: guix-git/doc/guix.texi:17187
  25336. msgid "The other options should be self-descriptive."
  25337. msgstr ""
  25338. #. type: deffn
  25339. #: guix-git/doc/guix.texi:17191
  25340. #, no-wrap
  25341. msgid "{Scheme Variable} openssh-service-type"
  25342. msgstr ""
  25343. #. type: deffn
  25344. #: guix-git/doc/guix.texi:17195
  25345. msgid "This is the type for the @uref{http://www.openssh.org, OpenSSH} secure shell daemon, @command{sshd}. Its value must be an @code{openssh-configuration} record as in this example:"
  25346. msgstr ""
  25347. #. type: lisp
  25348. #: guix-git/doc/guix.texi:17204
  25349. #, no-wrap
  25350. msgid ""
  25351. "(service openssh-service-type\n"
  25352. " (openssh-configuration\n"
  25353. " (x11-forwarding? #t)\n"
  25354. " (permit-root-login 'prohibit-password)\n"
  25355. " (authorized-keys\n"
  25356. " `((\"alice\" ,(local-file \"alice.pub\"))\n"
  25357. " (\"bob\" ,(local-file \"bob.pub\"))))))\n"
  25358. msgstr ""
  25359. #. type: deffn
  25360. #: guix-git/doc/guix.texi:17207
  25361. msgid "See below for details about @code{openssh-configuration}."
  25362. msgstr ""
  25363. #. type: deffn
  25364. #: guix-git/doc/guix.texi:17210
  25365. msgid "This service can be extended with extra authorized keys, as in this example:"
  25366. msgstr ""
  25367. #. type: lisp
  25368. #: guix-git/doc/guix.texi:17215
  25369. #, no-wrap
  25370. msgid ""
  25371. "(service-extension openssh-service-type\n"
  25372. " (const `((\"charlie\"\n"
  25373. " ,(local-file \"charlie.pub\")))))\n"
  25374. msgstr ""
  25375. #. type: deftp
  25376. #: guix-git/doc/guix.texi:17218
  25377. #, no-wrap
  25378. msgid "{Data Type} openssh-configuration"
  25379. msgstr ""
  25380. #. type: deftp
  25381. #: guix-git/doc/guix.texi:17220
  25382. msgid "This is the configuration record for OpenSSH's @command{sshd}."
  25383. msgstr ""
  25384. #. type: item
  25385. #: guix-git/doc/guix.texi:17222
  25386. #, no-wrap
  25387. msgid "@code{openssh} (default @var{openssh})"
  25388. msgstr ""
  25389. #. type: table
  25390. #: guix-git/doc/guix.texi:17224
  25391. msgid "The Openssh package to use."
  25392. msgstr ""
  25393. #. type: item
  25394. #: guix-git/doc/guix.texi:17225
  25395. #, no-wrap
  25396. msgid "@code{pid-file} (default: @code{\"/var/run/sshd.pid\"})"
  25397. msgstr ""
  25398. #. type: table
  25399. #: guix-git/doc/guix.texi:17227
  25400. msgid "Name of the file where @command{sshd} writes its PID."
  25401. msgstr ""
  25402. #. type: item
  25403. #: guix-git/doc/guix.texi:17228
  25404. #, no-wrap
  25405. msgid "@code{port-number} (default: @code{22})"
  25406. msgstr ""
  25407. #. type: table
  25408. #: guix-git/doc/guix.texi:17230
  25409. msgid "TCP port on which @command{sshd} listens for incoming connections."
  25410. msgstr ""
  25411. #. type: item
  25412. #: guix-git/doc/guix.texi:17231
  25413. #, no-wrap
  25414. msgid "@code{permit-root-login} (default: @code{#f})"
  25415. msgstr ""
  25416. #. type: table
  25417. #: guix-git/doc/guix.texi:17236
  25418. msgid "This field determines whether and when to allow logins as root. If @code{#f}, root logins are disallowed; if @code{#t}, they are allowed. If it's the symbol @code{'prohibit-password}, then root logins are permitted but not with password-based authentication."
  25419. msgstr ""
  25420. #. type: item
  25421. #: guix-git/doc/guix.texi:17237 guix-git/doc/guix.texi:17398
  25422. #, no-wrap
  25423. msgid "@code{allow-empty-passwords?} (default: @code{#f})"
  25424. msgstr ""
  25425. #. type: table
  25426. #: guix-git/doc/guix.texi:17240
  25427. msgid "When true, users with empty passwords may log in. When false, they may not."
  25428. msgstr ""
  25429. #. type: item
  25430. #: guix-git/doc/guix.texi:17241 guix-git/doc/guix.texi:17401
  25431. #, no-wrap
  25432. msgid "@code{password-authentication?} (default: @code{#t})"
  25433. msgstr ""
  25434. #. type: table
  25435. #: guix-git/doc/guix.texi:17244
  25436. msgid "When true, users may log in with their password. When false, they have other authentication methods."
  25437. msgstr ""
  25438. #. type: item
  25439. #: guix-git/doc/guix.texi:17245
  25440. #, no-wrap
  25441. msgid "@code{public-key-authentication?} (default: @code{#t})"
  25442. msgstr ""
  25443. #. type: table
  25444. #: guix-git/doc/guix.texi:17248
  25445. msgid "When true, users may log in using public key authentication. When false, users have to use other authentication method."
  25446. msgstr ""
  25447. #. type: table
  25448. #: guix-git/doc/guix.texi:17251
  25449. msgid "Authorized public keys are stored in @file{~/.ssh/authorized_keys}. This is used only by protocol version 2."
  25450. msgstr ""
  25451. #. type: item
  25452. #: guix-git/doc/guix.texi:17252
  25453. #, no-wrap
  25454. msgid "@code{x11-forwarding?} (default: @code{#f})"
  25455. msgstr ""
  25456. #. type: table
  25457. #: guix-git/doc/guix.texi:17256
  25458. msgid "When true, forwarding of X11 graphical client connections is enabled---in other words, @command{ssh} options @option{-X} and @option{-Y} will work."
  25459. msgstr ""
  25460. #. type: item
  25461. #: guix-git/doc/guix.texi:17257
  25462. #, no-wrap
  25463. msgid "@code{allow-agent-forwarding?} (default: @code{#t})"
  25464. msgstr ""
  25465. #. type: table
  25466. #: guix-git/doc/guix.texi:17259
  25467. msgid "Whether to allow agent forwarding."
  25468. msgstr ""
  25469. #. type: item
  25470. #: guix-git/doc/guix.texi:17260
  25471. #, no-wrap
  25472. msgid "@code{allow-tcp-forwarding?} (default: @code{#t})"
  25473. msgstr ""
  25474. #. type: table
  25475. #: guix-git/doc/guix.texi:17262
  25476. msgid "Whether to allow TCP forwarding."
  25477. msgstr ""
  25478. #. type: item
  25479. #: guix-git/doc/guix.texi:17263
  25480. #, no-wrap
  25481. msgid "@code{gateway-ports?} (default: @code{#f})"
  25482. msgstr ""
  25483. #. type: table
  25484. #: guix-git/doc/guix.texi:17265
  25485. msgid "Whether to allow gateway ports."
  25486. msgstr ""
  25487. #. type: item
  25488. #: guix-git/doc/guix.texi:17266
  25489. #, no-wrap
  25490. msgid "@code{challenge-response-authentication?} (default: @code{#f})"
  25491. msgstr ""
  25492. #. type: table
  25493. #: guix-git/doc/guix.texi:17269
  25494. msgid "Specifies whether challenge response authentication is allowed (e.g.@: via PAM)."
  25495. msgstr ""
  25496. #. type: item
  25497. #: guix-git/doc/guix.texi:17270
  25498. #, no-wrap
  25499. msgid "@code{use-pam?} (default: @code{#t})"
  25500. msgstr ""
  25501. #. type: table
  25502. #: guix-git/doc/guix.texi:17276
  25503. msgid "Enables the Pluggable Authentication Module interface. If set to @code{#t}, this will enable PAM authentication using @code{challenge-response-authentication?} and @code{password-authentication?}, in addition to PAM account and session module processing for all authentication types."
  25504. msgstr ""
  25505. #. type: table
  25506. #: guix-git/doc/guix.texi:17281
  25507. msgid "Because PAM challenge response authentication usually serves an equivalent role to password authentication, you should disable either @code{challenge-response-authentication?} or @code{password-authentication?}."
  25508. msgstr ""
  25509. #. type: item
  25510. #: guix-git/doc/guix.texi:17282
  25511. #, no-wrap
  25512. msgid "@code{print-last-log?} (default: @code{#t})"
  25513. msgstr ""
  25514. #. type: table
  25515. #: guix-git/doc/guix.texi:17285
  25516. msgid "Specifies whether @command{sshd} should print the date and time of the last user login when a user logs in interactively."
  25517. msgstr ""
  25518. #. type: item
  25519. #: guix-git/doc/guix.texi:17286
  25520. #, no-wrap
  25521. msgid "@code{subsystems} (default: @code{'((\"sftp\" \"internal-sftp\"))})"
  25522. msgstr ""
  25523. #. type: table
  25524. #: guix-git/doc/guix.texi:17288
  25525. msgid "Configures external subsystems (e.g.@: file transfer daemon)."
  25526. msgstr ""
  25527. #. type: table
  25528. #: guix-git/doc/guix.texi:17292
  25529. msgid "This is a list of two-element lists, each of which containing the subsystem name and a command (with optional arguments) to execute upon subsystem request."
  25530. msgstr ""
  25531. #. type: table
  25532. #: guix-git/doc/guix.texi:17295
  25533. msgid "The command @command{internal-sftp} implements an in-process SFTP server. Alternatively, one can specify the @command{sftp-server} command:"
  25534. msgstr ""
  25535. #. type: lisp
  25536. #: guix-git/doc/guix.texi:17300
  25537. #, no-wrap
  25538. msgid ""
  25539. "(service openssh-service-type\n"
  25540. " (openssh-configuration\n"
  25541. " (subsystems\n"
  25542. " `((\"sftp\" ,(file-append openssh \"/libexec/sftp-server\"))))))\n"
  25543. msgstr ""
  25544. #. type: item
  25545. #: guix-git/doc/guix.texi:17302
  25546. #, no-wrap
  25547. msgid "@code{accepted-environment} (default: @code{'()})"
  25548. msgstr ""
  25549. #. type: table
  25550. #: guix-git/doc/guix.texi:17304
  25551. msgid "List of strings describing which environment variables may be exported."
  25552. msgstr ""
  25553. #. type: table
  25554. #: guix-git/doc/guix.texi:17307
  25555. msgid "Each string gets on its own line. See the @code{AcceptEnv} option in @code{man sshd_config}."
  25556. msgstr ""
  25557. #. type: table
  25558. #: guix-git/doc/guix.texi:17312
  25559. msgid "This example allows ssh-clients to export the @env{COLORTERM} variable. It is set by terminal emulators, which support colors. You can use it in your shell's resource file to enable colors for the prompt and commands if this variable is set."
  25560. msgstr ""
  25561. #. type: lisp
  25562. #: guix-git/doc/guix.texi:17317
  25563. #, no-wrap
  25564. msgid ""
  25565. "(service openssh-service-type\n"
  25566. " (openssh-configuration\n"
  25567. " (accepted-environment '(\"COLORTERM\"))))\n"
  25568. msgstr ""
  25569. #. type: item
  25570. #: guix-git/doc/guix.texi:17319
  25571. #, no-wrap
  25572. msgid "@code{authorized-keys} (default: @code{'()})"
  25573. msgstr ""
  25574. #. type: cindex
  25575. #: guix-git/doc/guix.texi:17320
  25576. #, no-wrap
  25577. msgid "authorized keys, SSH"
  25578. msgstr ""
  25579. #. type: cindex
  25580. #: guix-git/doc/guix.texi:17321
  25581. #, no-wrap
  25582. msgid "SSH authorized keys"
  25583. msgstr ""
  25584. #. type: table
  25585. #: guix-git/doc/guix.texi:17325
  25586. msgid "This is the list of authorized keys. Each element of the list is a user name followed by one or more file-like objects that represent SSH public keys. For example:"
  25587. msgstr ""
  25588. #. type: lisp
  25589. #: guix-git/doc/guix.texi:17332
  25590. #, no-wrap
  25591. msgid ""
  25592. "(openssh-configuration\n"
  25593. " (authorized-keys\n"
  25594. " `((\"rekado\" ,(local-file \"rekado.pub\"))\n"
  25595. " (\"chris\" ,(local-file \"chris.pub\"))\n"
  25596. " (\"root\" ,(local-file \"rekado.pub\") ,(local-file \"chris.pub\")))))\n"
  25597. msgstr ""
  25598. #. type: table
  25599. #: guix-git/doc/guix.texi:17337
  25600. msgid "registers the specified public keys for user accounts @code{rekado}, @code{chris}, and @code{root}."
  25601. msgstr ""
  25602. #. type: table
  25603. #: guix-git/doc/guix.texi:17340
  25604. msgid "Additional authorized keys can be specified @i{via} @code{service-extension}."
  25605. msgstr ""
  25606. #. type: table
  25607. #: guix-git/doc/guix.texi:17343
  25608. msgid "Note that this does @emph{not} interfere with the use of @file{~/.ssh/authorized_keys}."
  25609. msgstr ""
  25610. #. type: item
  25611. #: guix-git/doc/guix.texi:17344 guix-git/doc/guix.texi:17775
  25612. #, no-wrap
  25613. msgid "@code{log-level} (default: @code{'info})"
  25614. msgstr ""
  25615. #. type: table
  25616. #: guix-git/doc/guix.texi:17348
  25617. msgid "This is a symbol specifying the logging level: @code{quiet}, @code{fatal}, @code{error}, @code{info}, @code{verbose}, @code{debug}, etc. See the man page for @file{sshd_config} for the full list of level names."
  25618. msgstr ""
  25619. #. type: item
  25620. #: guix-git/doc/guix.texi:17349 guix-git/doc/guix.texi:20171
  25621. #: guix-git/doc/guix.texi:25311
  25622. #, no-wrap
  25623. msgid "@code{extra-content} (default: @code{\"\"})"
  25624. msgstr ""
  25625. #. type: table
  25626. #: guix-git/doc/guix.texi:17354
  25627. msgid "This field can be used to append arbitrary text to the configuration file. It is especially useful for elaborate configurations that cannot be expressed otherwise. This configuration, for example, would generally disable root logins, but permit them from one specific IP address:"
  25628. msgstr ""
  25629. #. type: lisp
  25630. #: guix-git/doc/guix.texi:17360
  25631. #, no-wrap
  25632. msgid ""
  25633. "(openssh-configuration\n"
  25634. " (extra-content \"\\\n"
  25635. "Match Address 192.168.0.1\n"
  25636. " PermitRootLogin yes\"))\n"
  25637. msgstr ""
  25638. #. type: deffn
  25639. #: guix-git/doc/guix.texi:17365
  25640. #, no-wrap
  25641. msgid "{Scheme Procedure} dropbear-service [@var{config}]"
  25642. msgstr ""
  25643. #. type: deffn
  25644. #: guix-git/doc/guix.texi:17369
  25645. msgid "Run the @uref{https://matt.ucc.asn.au/dropbear/dropbear.html,Dropbear SSH daemon} with the given @var{config}, a @code{<dropbear-configuration>} object."
  25646. msgstr ""
  25647. #. type: deffn
  25648. #: guix-git/doc/guix.texi:17372
  25649. msgid "For example, to specify a Dropbear service listening on port 1234, add this call to the operating system's @code{services} field:"
  25650. msgstr ""
  25651. #. type: lisp
  25652. #: guix-git/doc/guix.texi:17376
  25653. #, no-wrap
  25654. msgid ""
  25655. "(dropbear-service (dropbear-configuration\n"
  25656. " (port-number 1234)))\n"
  25657. msgstr ""
  25658. #. type: deftp
  25659. #: guix-git/doc/guix.texi:17379
  25660. #, no-wrap
  25661. msgid "{Data Type} dropbear-configuration"
  25662. msgstr ""
  25663. #. type: deftp
  25664. #: guix-git/doc/guix.texi:17381
  25665. msgid "This data type represents the configuration of a Dropbear SSH daemon."
  25666. msgstr ""
  25667. #. type: item
  25668. #: guix-git/doc/guix.texi:17383
  25669. #, no-wrap
  25670. msgid "@code{dropbear} (default: @var{dropbear})"
  25671. msgstr ""
  25672. #. type: table
  25673. #: guix-git/doc/guix.texi:17385
  25674. msgid "The Dropbear package to use."
  25675. msgstr ""
  25676. #. type: item
  25677. #: guix-git/doc/guix.texi:17386
  25678. #, no-wrap
  25679. msgid "@code{port-number} (default: 22)"
  25680. msgstr ""
  25681. #. type: table
  25682. #: guix-git/doc/guix.texi:17388
  25683. msgid "The TCP port where the daemon waits for incoming connections."
  25684. msgstr ""
  25685. #. type: item
  25686. #: guix-git/doc/guix.texi:17389
  25687. #, no-wrap
  25688. msgid "@code{syslog-output?} (default: @code{#t})"
  25689. msgstr ""
  25690. #. type: table
  25691. #: guix-git/doc/guix.texi:17391
  25692. msgid "Whether to enable syslog output."
  25693. msgstr ""
  25694. #. type: item
  25695. #: guix-git/doc/guix.texi:17392
  25696. #, no-wrap
  25697. msgid "@code{pid-file} (default: @code{\"/var/run/dropbear.pid\"})"
  25698. msgstr ""
  25699. #. type: table
  25700. #: guix-git/doc/guix.texi:17394
  25701. msgid "File name of the daemon's PID file."
  25702. msgstr ""
  25703. #. type: item
  25704. #: guix-git/doc/guix.texi:17395
  25705. #, no-wrap
  25706. msgid "@code{root-login?} (default: @code{#f})"
  25707. msgstr ""
  25708. #. type: table
  25709. #: guix-git/doc/guix.texi:17397
  25710. msgid "Whether to allow @code{root} logins."
  25711. msgstr ""
  25712. #. type: table
  25713. #: guix-git/doc/guix.texi:17400
  25714. msgid "Whether to allow empty passwords."
  25715. msgstr ""
  25716. #. type: table
  25717. #: guix-git/doc/guix.texi:17403
  25718. msgid "Whether to enable password-based authentication."
  25719. msgstr ""
  25720. #. type: cindex
  25721. #: guix-git/doc/guix.texi:17406
  25722. #, no-wrap
  25723. msgid "AutoSSH"
  25724. msgstr ""
  25725. #. type: deffn
  25726. #: guix-git/doc/guix.texi:17407
  25727. #, no-wrap
  25728. msgid "{Scheme Variable} autossh-service-type"
  25729. msgstr ""
  25730. #. type: deffn
  25731. #: guix-git/doc/guix.texi:17415
  25732. msgid "This is the type for the @uref{https://www.harding.motd.ca/autossh, AutoSSH} program that runs a copy of @command{ssh} and monitors it, restarting it as necessary should it die or stop passing traffic. AutoSSH can be run manually from the command-line by passing arguments to the binary @command{autossh} from the package @code{autossh}, but it can also be run as a Guix service. This latter use case is documented here."
  25733. msgstr ""
  25734. #. type: deffn
  25735. #: guix-git/doc/guix.texi:17419
  25736. msgid "AutoSSH can be used to forward local traffic to a remote machine using an SSH tunnel, and it respects the @file{~/.ssh/config} of the user it is run as."
  25737. msgstr ""
  25738. #. type: deffn
  25739. #: guix-git/doc/guix.texi:17424
  25740. msgid "For example, to specify a service running autossh as the user @code{pino} and forwarding all local connections to port @code{8081} to @code{remote:8081} using an SSH tunnel, add this call to the operating system's @code{services} field:"
  25741. msgstr ""
  25742. #. type: lisp
  25743. #: guix-git/doc/guix.texi:17430
  25744. #, no-wrap
  25745. msgid ""
  25746. "(service autossh-service-type\n"
  25747. " (autossh-configuration\n"
  25748. " (user \"pino\")\n"
  25749. " (ssh-options (list \"-T\" \"-N\" \"-L\" \"8081:localhost:8081\" \"remote.net\"))))\n"
  25750. msgstr ""
  25751. #. type: deftp
  25752. #: guix-git/doc/guix.texi:17433
  25753. #, no-wrap
  25754. msgid "{Data Type} autossh-configuration"
  25755. msgstr ""
  25756. #. type: deftp
  25757. #: guix-git/doc/guix.texi:17435
  25758. msgid "This data type represents the configuration of an AutoSSH service."
  25759. msgstr ""
  25760. #. type: item
  25761. #: guix-git/doc/guix.texi:17438
  25762. #, no-wrap
  25763. msgid "@code{user} (default @code{\"autossh\"})"
  25764. msgstr ""
  25765. #. type: table
  25766. #: guix-git/doc/guix.texi:17441
  25767. msgid "The user as which the AutoSSH service is to be run. This assumes that the specified user exists."
  25768. msgstr ""
  25769. #. type: item
  25770. #: guix-git/doc/guix.texi:17442
  25771. #, no-wrap
  25772. msgid "@code{poll} (default @code{600})"
  25773. msgstr ""
  25774. #. type: table
  25775. #: guix-git/doc/guix.texi:17444
  25776. msgid "Specifies the connection poll time in seconds."
  25777. msgstr ""
  25778. #. type: item
  25779. #: guix-git/doc/guix.texi:17445
  25780. #, no-wrap
  25781. msgid "@code{first-poll} (default @code{#f})"
  25782. msgstr ""
  25783. #. type: table
  25784. #: guix-git/doc/guix.texi:17451
  25785. msgid "Specifies how many seconds AutoSSH waits before the first connection test. After this first test, polling is resumed at the pace defined in @code{poll}. When set to @code{#f}, the first poll is not treated specially and will also use the connection poll specified in @code{poll}."
  25786. msgstr ""
  25787. #. type: item
  25788. #: guix-git/doc/guix.texi:17452
  25789. #, no-wrap
  25790. msgid "@code{gate-time} (default @code{30})"
  25791. msgstr ""
  25792. #. type: table
  25793. #: guix-git/doc/guix.texi:17455
  25794. msgid "Specifies how many seconds an SSH connection must be active before it is considered successful."
  25795. msgstr ""
  25796. #. type: item
  25797. #: guix-git/doc/guix.texi:17456
  25798. #, no-wrap
  25799. msgid "@code{log-level} (default @code{1})"
  25800. msgstr ""
  25801. #. type: table
  25802. #: guix-git/doc/guix.texi:17459
  25803. msgid "The log level, corresponding to the levels used by syslog---so @code{0} is the most silent while @code{7} is the chattiest."
  25804. msgstr ""
  25805. #. type: item
  25806. #: guix-git/doc/guix.texi:17460
  25807. #, no-wrap
  25808. msgid "@code{max-start} (default @code{#f})"
  25809. msgstr ""
  25810. #. type: table
  25811. #: guix-git/doc/guix.texi:17463
  25812. msgid "The maximum number of times SSH may be (re)started before AutoSSH exits. When set to @code{#f}, no maximum is configured and AutoSSH may restart indefinitely."
  25813. msgstr ""
  25814. #. type: item
  25815. #: guix-git/doc/guix.texi:17464
  25816. #, no-wrap
  25817. msgid "@code{message} (default @code{\"\"})"
  25818. msgstr ""
  25819. #. type: table
  25820. #: guix-git/doc/guix.texi:17466
  25821. msgid "The message to append to the echo message sent when testing connections."
  25822. msgstr ""
  25823. #. type: item
  25824. #: guix-git/doc/guix.texi:17467
  25825. #, no-wrap
  25826. msgid "@code{port} (default @code{\"0\"})"
  25827. msgstr ""
  25828. #. type: table
  25829. #: guix-git/doc/guix.texi:17477
  25830. msgid "The ports used for monitoring the connection. When set to @code{\"0\"}, monitoring is disabled. When set to @code{\"@var{n}\"} where @var{n} is a positive integer, ports @var{n} and @var{n}+1 are used for monitoring the connection, such that port @var{n} is the base monitoring port and @code{n+1} is the echo port. When set to @code{\"@var{n}:@var{m}\"} where @var{n} and @var{m} are positive integers, the ports @var{n} and @var{m} are used for monitoring the connection, such that port @var{n} is the base monitoring port and @var{m} is the echo port."
  25831. msgstr ""
  25832. #. type: item
  25833. #: guix-git/doc/guix.texi:17478
  25834. #, no-wrap
  25835. msgid "@code{ssh-options} (default @code{'()})"
  25836. msgstr ""
  25837. #. type: table
  25838. #: guix-git/doc/guix.texi:17482
  25839. msgid "The list of command-line arguments to pass to @command{ssh} when it is run. Options @option{-f} and @option{-M} are reserved for AutoSSH and may cause undefined behaviour."
  25840. msgstr ""
  25841. #. type: cindex
  25842. #: guix-git/doc/guix.texi:17486
  25843. #, no-wrap
  25844. msgid "WebSSH"
  25845. msgstr ""
  25846. #. type: deffn
  25847. #: guix-git/doc/guix.texi:17487
  25848. #, no-wrap
  25849. msgid "{Scheme Variable} webssh-service-type"
  25850. msgstr ""
  25851. #. type: deffn
  25852. #: guix-git/doc/guix.texi:17493
  25853. msgid "This is the type for the @uref{https://webssh.huashengdun.org/, WebSSH} program that runs a web SSH client. WebSSH can be run manually from the command-line by passing arguments to the binary @command{wssh} from the package @code{webssh}, but it can also be run as a Guix service. This latter use case is documented here."
  25854. msgstr ""
  25855. #. type: deffn
  25856. #: guix-git/doc/guix.texi:17499
  25857. msgid "For example, to specify a service running WebSSH on loopback interface on port @code{8888} with reject policy with a list of allowed to connection hosts, and NGINX as a reverse-proxy to this service listening for HTTPS connection, add this call to the operating system's @code{services} field:"
  25858. msgstr ""
  25859. #. type: lisp
  25860. #: guix-git/doc/guix.texi:17507
  25861. #, no-wrap
  25862. msgid ""
  25863. "(service webssh-service-type\n"
  25864. " (webssh-configuration (address \"127.0.0.1\")\n"
  25865. " (port 8888)\n"
  25866. " (policy 'reject)\n"
  25867. " (known-hosts '(\"localhost ecdsa-sha2-nistp256 AAAA…\"\n"
  25868. " \"127.0.0.1 ecdsa-sha2-nistp256 AAAA…\"))))\n"
  25869. "\n"
  25870. msgstr ""
  25871. #. type: lisp
  25872. #: guix-git/doc/guix.texi:17523
  25873. #, no-wrap
  25874. msgid ""
  25875. "(service nginx-service-type\n"
  25876. " (nginx-configuration\n"
  25877. " (server-blocks\n"
  25878. " (list\n"
  25879. " (nginx-server-configuration\n"
  25880. " (inherit %webssh-configuration-nginx)\n"
  25881. " (server-name '(\"webssh.example.com\"))\n"
  25882. " (listen '(\"443 ssl\"))\n"
  25883. " (ssl-certificate (letsencrypt-certificate \"webssh.example.com\"))\n"
  25884. " (ssl-certificate-key (letsencrypt-key \"webssh.example.com\"))\n"
  25885. " (locations\n"
  25886. " (cons (nginx-location-configuration\n"
  25887. " (uri \"/.well-known\")\n"
  25888. " (body '(\"root /var/www;\")))\n"
  25889. " (nginx-server-configuration-locations %webssh-configuration-nginx))))))))\n"
  25890. msgstr ""
  25891. #. type: deftp
  25892. #: guix-git/doc/guix.texi:17526
  25893. #, no-wrap
  25894. msgid "{Data Type} webssh-configuration"
  25895. msgstr ""
  25896. #. type: deftp
  25897. #: guix-git/doc/guix.texi:17528
  25898. msgid "Data type representing the configuration for @code{webssh-service}."
  25899. msgstr ""
  25900. #. type: item
  25901. #: guix-git/doc/guix.texi:17530
  25902. #, no-wrap
  25903. msgid "@code{package} (default: @var{webssh})"
  25904. msgstr ""
  25905. #. type: table
  25906. #: guix-git/doc/guix.texi:17532
  25907. msgid "@code{webssh} package to use."
  25908. msgstr ""
  25909. #. type: item
  25910. #: guix-git/doc/guix.texi:17533
  25911. #, no-wrap
  25912. msgid "@code{user-name} (default: @var{\"webssh\"})"
  25913. msgstr ""
  25914. #. type: table
  25915. #: guix-git/doc/guix.texi:17536
  25916. msgid "User name or user ID that file transfers to and from that module should take place."
  25917. msgstr ""
  25918. #. type: item
  25919. #: guix-git/doc/guix.texi:17537
  25920. #, no-wrap
  25921. msgid "@code{group-name} (default: @var{\"webssh\"})"
  25922. msgstr ""
  25923. #. type: item
  25924. #: guix-git/doc/guix.texi:17540
  25925. #, no-wrap
  25926. msgid "@code{address} (default: @var{#f})"
  25927. msgstr ""
  25928. #. type: table
  25929. #: guix-git/doc/guix.texi:17542
  25930. msgid "IP address on which @command{webssh} listens for incoming connections."
  25931. msgstr ""
  25932. #. type: item
  25933. #: guix-git/doc/guix.texi:17543
  25934. #, no-wrap
  25935. msgid "@code{port} (default: @var{8888})"
  25936. msgstr ""
  25937. #. type: table
  25938. #: guix-git/doc/guix.texi:17545
  25939. msgid "TCP port on which @command{webssh} listens for incoming connections."
  25940. msgstr ""
  25941. #. type: item
  25942. #: guix-git/doc/guix.texi:17546
  25943. #, no-wrap
  25944. msgid "@code{policy} (default: @var{#f})"
  25945. msgstr ""
  25946. #. type: table
  25947. #: guix-git/doc/guix.texi:17548
  25948. msgid "Connection policy. @var{reject} policy requires to specify @var{known-hosts}."
  25949. msgstr ""
  25950. #. type: item
  25951. #: guix-git/doc/guix.texi:17549
  25952. #, no-wrap
  25953. msgid "@code{known-hosts} (default: @var{'()})"
  25954. msgstr ""
  25955. #. type: table
  25956. #: guix-git/doc/guix.texi:17551
  25957. msgid "List of hosts which allowed for SSH connection from @command{webssh}."
  25958. msgstr ""
  25959. #. type: item
  25960. #: guix-git/doc/guix.texi:17552
  25961. #, no-wrap
  25962. msgid "@code{log-file} (default: @file{\"/var/log/webssh.log\"})"
  25963. msgstr ""
  25964. #. type: table
  25965. #: guix-git/doc/guix.texi:17554
  25966. msgid "Name of the file where @command{webssh} writes its log file."
  25967. msgstr ""
  25968. #. type: item
  25969. #: guix-git/doc/guix.texi:17555
  25970. #, no-wrap
  25971. msgid "@code{log-level} (default: @var{#f})"
  25972. msgstr ""
  25973. #. type: table
  25974. #: guix-git/doc/guix.texi:17557
  25975. msgid "Logging level."
  25976. msgstr ""
  25977. #. type: defvr
  25978. #: guix-git/doc/guix.texi:17561
  25979. #, no-wrap
  25980. msgid "{Scheme Variable} %facebook-host-aliases"
  25981. msgstr ""
  25982. #. type: defvr
  25983. #: guix-git/doc/guix.texi:17567
  25984. msgid "This variable contains a string for use in @file{/etc/hosts} (@pxref{Host Names,,, libc, The GNU C Library Reference Manual}). Each line contains a entry that maps a known server name of the Facebook on-line service---e.g., @code{www.facebook.com}---to the local host---@code{127.0.0.1} or its IPv6 equivalent, @code{::1}."
  25985. msgstr ""
  25986. #. type: defvr
  25987. #: guix-git/doc/guix.texi:17571
  25988. msgid "This variable is typically used in the @code{hosts-file} field of an @code{operating-system} declaration (@pxref{operating-system Reference, @file{/etc/hosts}}):"
  25989. msgstr ""
  25990. #. type: lisp
  25991. #: guix-git/doc/guix.texi:17584
  25992. #, no-wrap
  25993. msgid ""
  25994. "(operating-system\n"
  25995. " (host-name \"mymachine\")\n"
  25996. " ;; ...\n"
  25997. " (hosts-file\n"
  25998. " ;; Create a /etc/hosts file with aliases for \"localhost\"\n"
  25999. " ;; and \"mymachine\", as well as for Facebook servers.\n"
  26000. " (plain-file \"hosts\"\n"
  26001. " (string-append (local-host-aliases host-name)\n"
  26002. " %facebook-host-aliases))))\n"
  26003. msgstr ""
  26004. #. type: defvr
  26005. #: guix-git/doc/guix.texi:17588
  26006. msgid "This mechanism can prevent programs running locally, such as Web browsers, from accessing Facebook."
  26007. msgstr ""
  26008. #. type: Plain text
  26009. #: guix-git/doc/guix.texi:17591
  26010. msgid "The @code{(gnu services avahi)} provides the following definition."
  26011. msgstr ""
  26012. #. type: defvr
  26013. #: guix-git/doc/guix.texi:17592
  26014. #, no-wrap
  26015. msgid "{Scheme Variable} avahi-service-type"
  26016. msgstr ""
  26017. #. type: defvr
  26018. #: guix-git/doc/guix.texi:17597
  26019. msgid "This is the service that runs @command{avahi-daemon}, a system-wide mDNS/DNS-SD responder that allows for service discovery and ``zero-configuration'' host name lookups (see @uref{https://avahi.org/}). Its value must be an @code{avahi-configuration} record---see below."
  26020. msgstr ""
  26021. #. type: defvr
  26022. #: guix-git/doc/guix.texi:17602
  26023. msgid "This service extends the name service cache daemon (nscd) so that it can resolve @code{.local} host names using @uref{https://0pointer.de/lennart/projects/nss-mdns/, nss-mdns}. @xref{Name Service Switch}, for information on host name resolution."
  26024. msgstr ""
  26025. #. type: defvr
  26026. #: guix-git/doc/guix.texi:17605
  26027. msgid "Additionally, add the @var{avahi} package to the system profile so that commands such as @command{avahi-browse} are directly usable."
  26028. msgstr ""
  26029. #. type: deftp
  26030. #: guix-git/doc/guix.texi:17607
  26031. #, no-wrap
  26032. msgid "{Data Type} avahi-configuration"
  26033. msgstr ""
  26034. #. type: deftp
  26035. #: guix-git/doc/guix.texi:17609
  26036. msgid "Data type representation the configuration for Avahi."
  26037. msgstr ""
  26038. #. type: item
  26039. #: guix-git/doc/guix.texi:17612
  26040. #, no-wrap
  26041. msgid "@code{host-name} (default: @code{#f})"
  26042. msgstr ""
  26043. #. type: table
  26044. #: guix-git/doc/guix.texi:17615
  26045. msgid "If different from @code{#f}, use that as the host name to publish for this machine; otherwise, use the machine's actual host name."
  26046. msgstr ""
  26047. #. type: item
  26048. #: guix-git/doc/guix.texi:17616 guix-git/doc/guix.texi:27965
  26049. #, no-wrap
  26050. msgid "@code{publish?} (default: @code{#t})"
  26051. msgstr ""
  26052. #. type: table
  26053. #: guix-git/doc/guix.texi:17619
  26054. msgid "When true, allow host names and services to be published (broadcast) over the network."
  26055. msgstr ""
  26056. #. type: item
  26057. #: guix-git/doc/guix.texi:17620
  26058. #, no-wrap
  26059. msgid "@code{publish-workstation?} (default: @code{#t})"
  26060. msgstr ""
  26061. #. type: table
  26062. #: guix-git/doc/guix.texi:17624
  26063. msgid "When true, @command{avahi-daemon} publishes the machine's host name and IP address via mDNS on the local network. To view the host names published on your local network, you can run:"
  26064. msgstr ""
  26065. #. type: example
  26066. #: guix-git/doc/guix.texi:17627
  26067. #, no-wrap
  26068. msgid "avahi-browse _workstation._tcp\n"
  26069. msgstr ""
  26070. #. type: item
  26071. #: guix-git/doc/guix.texi:17629
  26072. #, no-wrap
  26073. msgid "@code{wide-area?} (default: @code{#f})"
  26074. msgstr ""
  26075. #. type: table
  26076. #: guix-git/doc/guix.texi:17631
  26077. msgid "When true, DNS-SD over unicast DNS is enabled."
  26078. msgstr ""
  26079. #. type: item
  26080. #: guix-git/doc/guix.texi:17632
  26081. #, no-wrap
  26082. msgid "@code{ipv4?} (default: @code{#t})"
  26083. msgstr ""
  26084. #. type: itemx
  26085. #: guix-git/doc/guix.texi:17633
  26086. #, no-wrap
  26087. msgid "@code{ipv6?} (default: @code{#t})"
  26088. msgstr ""
  26089. #. type: table
  26090. #: guix-git/doc/guix.texi:17635
  26091. msgid "These fields determine whether to use IPv4/IPv6 sockets."
  26092. msgstr ""
  26093. #. type: item
  26094. #: guix-git/doc/guix.texi:17636
  26095. #, no-wrap
  26096. msgid "@code{domains-to-browse} (default: @code{'()})"
  26097. msgstr ""
  26098. #. type: table
  26099. #: guix-git/doc/guix.texi:17638
  26100. msgid "This is a list of domains to browse."
  26101. msgstr ""
  26102. #. type: deffn
  26103. #: guix-git/doc/guix.texi:17641
  26104. #, no-wrap
  26105. msgid "{Scheme Variable} openvswitch-service-type"
  26106. msgstr ""
  26107. #. type: deffn
  26108. #: guix-git/doc/guix.texi:17645
  26109. msgid "This is the type of the @uref{https://www.openvswitch.org, Open vSwitch} service, whose value should be an @code{openvswitch-configuration} object."
  26110. msgstr ""
  26111. #. type: deftp
  26112. #: guix-git/doc/guix.texi:17647
  26113. #, no-wrap
  26114. msgid "{Data Type} openvswitch-configuration"
  26115. msgstr ""
  26116. #. type: deftp
  26117. #: guix-git/doc/guix.texi:17651
  26118. msgid "Data type representing the configuration of Open vSwitch, a multilayer virtual switch which is designed to enable massive network automation through programmatic extension."
  26119. msgstr ""
  26120. #. type: item
  26121. #: guix-git/doc/guix.texi:17653
  26122. #, no-wrap
  26123. msgid "@code{package} (default: @var{openvswitch})"
  26124. msgstr ""
  26125. #. type: table
  26126. #: guix-git/doc/guix.texi:17655
  26127. msgid "Package object of the Open vSwitch."
  26128. msgstr ""
  26129. #. type: defvr
  26130. #: guix-git/doc/guix.texi:17659
  26131. #, no-wrap
  26132. msgid "{Scheme Variable} pagekite-service-type"
  26133. msgstr ""
  26134. #. type: defvr
  26135. #: guix-git/doc/guix.texi:17664
  26136. msgid "This is the service type for the @uref{https://pagekite.net, PageKite} service, a tunneling solution for making localhost servers publicly visible, even from behind restrictive firewalls or NAT without forwarded ports. The value for this service type is a @code{pagekite-configuration} record."
  26137. msgstr ""
  26138. #. type: defvr
  26139. #: guix-git/doc/guix.texi:17666
  26140. msgid "Here's an example exposing the local HTTP and SSH daemons:"
  26141. msgstr ""
  26142. #. type: lisp
  26143. #: guix-git/doc/guix.texi:17673
  26144. #, no-wrap
  26145. msgid ""
  26146. "(service pagekite-service-type\n"
  26147. " (pagekite-configuration\n"
  26148. " (kites '(\"http:@@kitename:localhost:80:@@kitesecret\"\n"
  26149. " \"raw/22:@@kitename:localhost:22:@@kitesecret\"))\n"
  26150. " (extra-file \"/etc/pagekite.rc\")))\n"
  26151. msgstr ""
  26152. #. type: deftp
  26153. #: guix-git/doc/guix.texi:17676
  26154. #, no-wrap
  26155. msgid "{Data Type} pagekite-configuration"
  26156. msgstr ""
  26157. #. type: deftp
  26158. #: guix-git/doc/guix.texi:17678
  26159. msgid "Data type representing the configuration of PageKite."
  26160. msgstr ""
  26161. #. type: item
  26162. #: guix-git/doc/guix.texi:17680
  26163. #, no-wrap
  26164. msgid "@code{package} (default: @var{pagekite})"
  26165. msgstr ""
  26166. #. type: table
  26167. #: guix-git/doc/guix.texi:17682
  26168. msgid "Package object of PageKite."
  26169. msgstr ""
  26170. #. type: item
  26171. #: guix-git/doc/guix.texi:17683
  26172. #, no-wrap
  26173. msgid "@code{kitename} (default: @code{#f})"
  26174. msgstr ""
  26175. #. type: table
  26176. #: guix-git/doc/guix.texi:17685
  26177. msgid "PageKite name for authenticating to the frontend server."
  26178. msgstr ""
  26179. #. type: item
  26180. #: guix-git/doc/guix.texi:17686
  26181. #, no-wrap
  26182. msgid "@code{kitesecret} (default: @code{#f})"
  26183. msgstr ""
  26184. #. type: table
  26185. #: guix-git/doc/guix.texi:17689
  26186. msgid "Shared secret for authenticating to the frontend server. You should probably put this inside @code{extra-file} instead."
  26187. msgstr ""
  26188. #. type: item
  26189. #: guix-git/doc/guix.texi:17690
  26190. #, no-wrap
  26191. msgid "@code{frontend} (default: @code{#f})"
  26192. msgstr ""
  26193. #. type: table
  26194. #: guix-git/doc/guix.texi:17693
  26195. msgid "Connect to the named PageKite frontend server instead of the @uref{https://pagekite.net,,pagekite.net} service."
  26196. msgstr ""
  26197. #. type: item
  26198. #: guix-git/doc/guix.texi:17694
  26199. #, no-wrap
  26200. msgid "@code{kites} (default: @code{'(\"http:@@kitename:localhost:80:@@kitesecret\")})"
  26201. msgstr ""
  26202. #. type: table
  26203. #: guix-git/doc/guix.texi:17697
  26204. msgid "List of service kites to use. Exposes HTTP on port 80 by default. The format is @code{proto:kitename:host:port:secret}."
  26205. msgstr ""
  26206. #. type: item
  26207. #: guix-git/doc/guix.texi:17698
  26208. #, no-wrap
  26209. msgid "@code{extra-file} (default: @code{#f})"
  26210. msgstr ""
  26211. #. type: table
  26212. #: guix-git/doc/guix.texi:17701
  26213. msgid "Extra configuration file to read, which you are expected to create manually. Use this to add additional options and manage shared secrets out-of-band."
  26214. msgstr ""
  26215. #. type: defvr
  26216. #: guix-git/doc/guix.texi:17705
  26217. #, no-wrap
  26218. msgid "{Scheme Variable} yggdrasil-service-type"
  26219. msgstr ""
  26220. #. type: defvr
  26221. #: guix-git/doc/guix.texi:17709
  26222. msgid "The service type for connecting to the @uref{https://yggdrasil-network.github.io/, Yggdrasil network}, an early-stage implementation of a fully end-to-end encrypted IPv6 network."
  26223. msgstr ""
  26224. #. type: quotation
  26225. #: guix-git/doc/guix.texi:17716
  26226. msgid "Yggdrasil provides name-independent routing with cryptographically generated addresses. Static addressing means you can keep the same address as long as you want, even if you move to a new location, or generate a new address (by generating new keys) whenever you want. @uref{https://yggdrasil-network.github.io/2018/07/28/addressing.html}"
  26227. msgstr ""
  26228. #. type: defvr
  26229. #: guix-git/doc/guix.texi:17720
  26230. msgid "Pass it a value of @code{yggdrasil-configuration} to connect it to public peers and/or local peers."
  26231. msgstr ""
  26232. #. type: defvr
  26233. #: guix-git/doc/guix.texi:17724
  26234. msgid "Here is an example using public peers and a static address. The static signing and encryption keys are defined in @file{/etc/yggdrasil-private.conf} (the default value for @code{config-file})."
  26235. msgstr ""
  26236. #. type: lisp
  26237. #: guix-git/doc/guix.texi:17736
  26238. #, no-wrap
  26239. msgid ""
  26240. ";; part of the operating-system declaration\n"
  26241. "(service yggdrasil-service-type\n"
  26242. " (yggdrasil-configuration\n"
  26243. " (autoconf? #f) ;; use only the public peers\n"
  26244. " (json-config\n"
  26245. " ;; choose one from\n"
  26246. " ;; https://github.com/yggdrasil-network/public-peers\n"
  26247. " '((peers . #(\"tcp://1.2.3.4:1337\"))))\n"
  26248. " ;; /etc/yggdrasil-private.conf is the default value for config-file\n"
  26249. " ))\n"
  26250. msgstr ""
  26251. #. type: example
  26252. #: guix-git/doc/guix.texi:17743
  26253. #, no-wrap
  26254. msgid ""
  26255. "# sample content for /etc/yggdrasil-private.conf\n"
  26256. "@{\n"
  26257. " # Your public encryption key. Your peers may ask you for this to put\n"
  26258. " # into their AllowedEncryptionPublicKeys configuration.\n"
  26259. " EncryptionPublicKey: 378dc5...\n"
  26260. "\n"
  26261. msgstr ""
  26262. #. type: example
  26263. #: guix-git/doc/guix.texi:17746
  26264. #, no-wrap
  26265. msgid ""
  26266. " # Your private encryption key. DO NOT share this with anyone!\n"
  26267. " EncryptionPrivateKey: 0777...\n"
  26268. "\n"
  26269. msgstr ""
  26270. #. type: example
  26271. #: guix-git/doc/guix.texi:17750
  26272. #, no-wrap
  26273. msgid ""
  26274. " # Your public signing key. You should not ordinarily need to share\n"
  26275. " # this with anyone.\n"
  26276. " SigningPublicKey: e1664...\n"
  26277. "\n"
  26278. msgstr ""
  26279. #. type: example
  26280. #: guix-git/doc/guix.texi:17754
  26281. #, no-wrap
  26282. msgid ""
  26283. " # Your private signing key. DO NOT share this with anyone!\n"
  26284. " SigningPrivateKey: 0589d...\n"
  26285. "@}\n"
  26286. msgstr ""
  26287. #. type: deftp
  26288. #: guix-git/doc/guix.texi:17757
  26289. #, no-wrap
  26290. msgid "{Data Type} yggdrasil-configuration"
  26291. msgstr ""
  26292. #. type: deftp
  26293. #: guix-git/doc/guix.texi:17759
  26294. msgid "Data type representing the configuration of Yggdrasil."
  26295. msgstr ""
  26296. #. type: item
  26297. #: guix-git/doc/guix.texi:17761
  26298. #, no-wrap
  26299. msgid "@code{package} (default: @code{yggdrasil})"
  26300. msgstr ""
  26301. #. type: table
  26302. #: guix-git/doc/guix.texi:17763
  26303. msgid "Package object of Yggdrasil."
  26304. msgstr ""
  26305. #. type: item
  26306. #: guix-git/doc/guix.texi:17764
  26307. #, no-wrap
  26308. msgid "@code{json-config} (default: @code{'()})"
  26309. msgstr ""
  26310. #. type: table
  26311. #: guix-git/doc/guix.texi:17770
  26312. msgid "Contents of @file{/etc/yggdrasil.conf}. Will be merged with @file{/etc/yggdrasil-private.conf}. Note that these settings are stored in the Guix store, which is readable to all users. @strong{Do not store your private keys in it}. See the output of @code{yggdrasil -genconf} for a quick overview of valid keys and their default values."
  26313. msgstr ""
  26314. #. type: item
  26315. #: guix-git/doc/guix.texi:17771
  26316. #, no-wrap
  26317. msgid "@code{autoconf?} (default: @code{#f})"
  26318. msgstr ""
  26319. #. type: table
  26320. #: guix-git/doc/guix.texi:17774
  26321. msgid "Whether to use automatic mode. Enabling it makes Yggdrasil use adynamic IP and peer with IPv6 neighbors."
  26322. msgstr ""
  26323. #. type: table
  26324. #: guix-git/doc/guix.texi:17777
  26325. msgid "How much detail to include in logs. Use @code{'debug} for more detail."
  26326. msgstr ""
  26327. #. type: item
  26328. #: guix-git/doc/guix.texi:17778
  26329. #, no-wrap
  26330. msgid "@code{log-to} (default: @code{'stdout})"
  26331. msgstr ""
  26332. #. type: table
  26333. #: guix-git/doc/guix.texi:17782
  26334. msgid "Where to send logs. By default, the service logs standard output to @file{/var/log/yggdrasil.log}. The alternative is @code{'syslog}, which sends output to the running syslog service."
  26335. msgstr ""
  26336. #. type: item
  26337. #: guix-git/doc/guix.texi:17783
  26338. #, no-wrap
  26339. msgid "@code{config-file} (default: @code{\"/etc/yggdrasil-private.conf\"})"
  26340. msgstr ""
  26341. #. type: table
  26342. #: guix-git/doc/guix.texi:17790
  26343. msgid "What HJSON file to load sensitive data from. This is where private keys should be stored, which are necessary to specify if you don't want a randomized address after each restart. Use @code{#f} to disable. Options defined in this file take precedence over @code{json-config}. Use the output of @code{yggdrasil -genconf} as a starting point. To configure a static address, delete everything except these options:"
  26344. msgstr ""
  26345. #. type: code{#1}
  26346. #: guix-git/doc/guix.texi:17792
  26347. #, no-wrap
  26348. msgid "EncryptionPublicKey"
  26349. msgstr ""
  26350. #. type: code{#1}
  26351. #: guix-git/doc/guix.texi:17793
  26352. #, no-wrap
  26353. msgid "EncryptionPrivateKey"
  26354. msgstr ""
  26355. #. type: code{#1}
  26356. #: guix-git/doc/guix.texi:17794
  26357. #, no-wrap
  26358. msgid "SigningPublicKey"
  26359. msgstr ""
  26360. #. type: code{#1}
  26361. #: guix-git/doc/guix.texi:17795
  26362. #, no-wrap
  26363. msgid "SigningPrivateKey"
  26364. msgstr ""
  26365. #. type: cindex
  26366. #: guix-git/doc/guix.texi:17800
  26367. #, no-wrap
  26368. msgid "IPFS"
  26369. msgstr ""
  26370. #. type: defvr
  26371. #: guix-git/doc/guix.texi:17801
  26372. #, no-wrap
  26373. msgid "{Scheme Variable} ipfs-service-type"
  26374. msgstr ""
  26375. #. type: defvr
  26376. #: guix-git/doc/guix.texi:17805
  26377. msgid "The service type for connecting to the @uref{https://ipfs.io,IPFS network}, a global, versioned, peer-to-peer file system. Pass it a @code{ipfs-configuration} to change the ports used for the gateway and API."
  26378. msgstr ""
  26379. #. type: defvr
  26380. #: guix-git/doc/guix.texi:17807
  26381. msgid "Here's an example configuration, using some non-standard ports:"
  26382. msgstr ""
  26383. #. type: lisp
  26384. #: guix-git/doc/guix.texi:17813
  26385. #, no-wrap
  26386. msgid ""
  26387. "(service ipfs-service-type\n"
  26388. " (ipfs-configuration\n"
  26389. " (gateway \"/ip4/127.0.0.1/tcp/8880\")\n"
  26390. " (api \"/ip4/127.0.0.1/tcp/8881\")))\n"
  26391. msgstr ""
  26392. #. type: deftp
  26393. #: guix-git/doc/guix.texi:17816
  26394. #, no-wrap
  26395. msgid "{Data Type} ipfs-configuration"
  26396. msgstr ""
  26397. #. type: deftp
  26398. #: guix-git/doc/guix.texi:17818
  26399. msgid "Data type representing the configuration of IPFS."
  26400. msgstr ""
  26401. #. type: item
  26402. #: guix-git/doc/guix.texi:17820
  26403. #, no-wrap
  26404. msgid "@code{package} (default: @code{go-ipfs})"
  26405. msgstr ""
  26406. #. type: table
  26407. #: guix-git/doc/guix.texi:17822
  26408. msgid "Package object of IPFS."
  26409. msgstr ""
  26410. #. type: item
  26411. #: guix-git/doc/guix.texi:17823
  26412. #, no-wrap
  26413. msgid "@code{gateway} (default: @code{\"/ip4/127.0.0.1/tcp/8082\"})"
  26414. msgstr ""
  26415. #. type: table
  26416. #: guix-git/doc/guix.texi:17825
  26417. msgid "Address of the gateway, in ‘multiaddress’ format."
  26418. msgstr ""
  26419. #. type: item
  26420. #: guix-git/doc/guix.texi:17826
  26421. #, no-wrap
  26422. msgid "@code{api} (default: @code{\"/ip4/127.0.0.1/tcp/5001\"})"
  26423. msgstr ""
  26424. #. type: table
  26425. #: guix-git/doc/guix.texi:17828
  26426. msgid "Address of the API endpoint, in ‘multiaddress’ format."
  26427. msgstr ""
  26428. #. type: cindex
  26429. #: guix-git/doc/guix.texi:17831
  26430. #, no-wrap
  26431. msgid "keepalived"
  26432. msgstr ""
  26433. #. type: deffn
  26434. #: guix-git/doc/guix.texi:17832
  26435. #, no-wrap
  26436. msgid "{Scheme Variable} keepalived-service-type"
  26437. msgstr ""
  26438. #. type: deffn
  26439. #: guix-git/doc/guix.texi:17837
  26440. msgid "This is the type for the @uref{https://www.keepalived.org/, Keepalived} routing software, @command{keepalived}. Its value must be an @code{keepalived-configuration} record as in this example for master machine:"
  26441. msgstr ""
  26442. #. type: lisp
  26443. #: guix-git/doc/guix.texi:17842
  26444. #, no-wrap
  26445. msgid ""
  26446. "(service keepalived-service-type\n"
  26447. " (keepalived-configuration\n"
  26448. " (config-file (local-file \"keepalived-master.conf\"))))\n"
  26449. msgstr ""
  26450. #. type: deffn
  26451. #: guix-git/doc/guix.texi:17845
  26452. msgid "where @file{keepalived-master.conf}:"
  26453. msgstr ""
  26454. #. type: example
  26455. #: guix-git/doc/guix.texi:17857
  26456. #, no-wrap
  26457. msgid ""
  26458. "vrrp_instance my-group @{\n"
  26459. " state MASTER\n"
  26460. " interface enp9s0\n"
  26461. " virtual_router_id 100\n"
  26462. " priority 100\n"
  26463. " unicast_peer @{ 10.0.0.2 @}\n"
  26464. " virtual_ipaddress @{\n"
  26465. " 10.0.0.4/24\n"
  26466. " @}\n"
  26467. "@}\n"
  26468. msgstr ""
  26469. #. type: deffn
  26470. #: guix-git/doc/guix.texi:17860
  26471. msgid "and for backup machine:"
  26472. msgstr ""
  26473. #. type: lisp
  26474. #: guix-git/doc/guix.texi:17865
  26475. #, no-wrap
  26476. msgid ""
  26477. "(service keepalived-service-type\n"
  26478. " (keepalived-configuration\n"
  26479. " (config-file (local-file \"keepalived-backup.conf\"))))\n"
  26480. msgstr ""
  26481. #. type: deffn
  26482. #: guix-git/doc/guix.texi:17868
  26483. msgid "where @file{keepalived-backup.conf}:"
  26484. msgstr ""
  26485. #. type: example
  26486. #: guix-git/doc/guix.texi:17880
  26487. #, no-wrap
  26488. msgid ""
  26489. "vrrp_instance my-group @{\n"
  26490. " state BACKUP\n"
  26491. " interface enp9s0\n"
  26492. " virtual_router_id 100\n"
  26493. " priority 99\n"
  26494. " unicast_peer @{ 10.0.0.3 @}\n"
  26495. " virtual_ipaddress @{\n"
  26496. " 10.0.0.4/24\n"
  26497. " @}\n"
  26498. "@}\n"
  26499. msgstr ""
  26500. #. type: cindex
  26501. #: guix-git/doc/guix.texi:17886
  26502. #, no-wrap
  26503. msgid "unattended upgrades"
  26504. msgstr ""
  26505. #. type: cindex
  26506. #: guix-git/doc/guix.texi:17887
  26507. #, no-wrap
  26508. msgid "upgrades, unattended"
  26509. msgstr ""
  26510. #. type: Plain text
  26511. #: guix-git/doc/guix.texi:17892
  26512. msgid "Guix provides a service to perform @emph{unattended upgrades}: periodically, the system automatically reconfigures itself from the latest Guix. Guix System has several properties that make unattended upgrades safe:"
  26513. msgstr ""
  26514. #. type: itemize
  26515. #: guix-git/doc/guix.texi:17897
  26516. msgid "upgrades are transactional (either the upgrade succeeds or it fails, but you cannot end up with an ``in-between'' system state);"
  26517. msgstr ""
  26518. #. type: itemize
  26519. #: guix-git/doc/guix.texi:17901
  26520. msgid "the upgrade log is kept---you can view it with @command{guix system list-generations}---and you can roll back to any previous generation, should the upgraded system fail to behave as intended;"
  26521. msgstr ""
  26522. #. type: itemize
  26523. #: guix-git/doc/guix.texi:17904
  26524. msgid "channel code is authenticated so you know you can only run genuine code (@pxref{Channels});"
  26525. msgstr ""
  26526. #. type: itemize
  26527. #: guix-git/doc/guix.texi:17907
  26528. msgid "@command{guix system reconfigure} prevents downgrades, which makes it immune to @dfn{downgrade attacks}."
  26529. msgstr ""
  26530. #. type: Plain text
  26531. #: guix-git/doc/guix.texi:17912
  26532. msgid "To set up unattended upgrades, add an instance of @code{unattended-upgrade-service-type} like the one below to the list of your operating system services:"
  26533. msgstr ""
  26534. #. type: lisp
  26535. #: guix-git/doc/guix.texi:17915
  26536. #, no-wrap
  26537. msgid "(service unattended-upgrade-service-type)\n"
  26538. msgstr ""
  26539. #. type: Plain text
  26540. #: guix-git/doc/guix.texi:17922
  26541. msgid "The defaults above set up weekly upgrades: every Sunday at midnight. You do not need to provide the operating system configuration file: it uses @file{/run/current-system/configuration.scm}, which ensures it always uses your latest configuration---@pxref{provenance-service-type}, for more information about this file."
  26542. msgstr ""
  26543. #. type: Plain text
  26544. #: guix-git/doc/guix.texi:17928
  26545. msgid "There are several things that can be configured, in particular the periodicity and services (daemons) to be restarted upon completion. When the upgrade is successful, the service takes care of deleting system generations older that some threshold, as per @command{guix system delete-generations}. See the reference below for details."
  26546. msgstr ""
  26547. #. type: Plain text
  26548. #: guix-git/doc/guix.texi:17932
  26549. msgid "To ensure that upgrades are actually happening, you can run @command{guix system describe}. To investigate upgrade failures, visit the unattended upgrade log file (see below)."
  26550. msgstr ""
  26551. #. type: defvr
  26552. #: guix-git/doc/guix.texi:17933
  26553. #, no-wrap
  26554. msgid "{Scheme Variable} unattended-upgrade-service-type"
  26555. msgstr ""
  26556. #. type: defvr
  26557. #: guix-git/doc/guix.texi:17937
  26558. msgid "This is the service type for unattended upgrades. It sets up an mcron job (@pxref{Scheduled Job Execution}) that runs @command{guix system reconfigure} from the latest version of the specified channels."
  26559. msgstr ""
  26560. #. type: defvr
  26561. #: guix-git/doc/guix.texi:17940
  26562. msgid "Its value must be a @code{unattended-upgrade-configuration} record (see below)."
  26563. msgstr ""
  26564. #. type: deftp
  26565. #: guix-git/doc/guix.texi:17942
  26566. #, no-wrap
  26567. msgid "{Data Type} unattended-upgrade-configuration"
  26568. msgstr ""
  26569. #. type: deftp
  26570. #: guix-git/doc/guix.texi:17945
  26571. msgid "This data type represents the configuration of the unattended upgrade service. The following fields are available:"
  26572. msgstr ""
  26573. #. type: item
  26574. #: guix-git/doc/guix.texi:17947
  26575. #, no-wrap
  26576. msgid "@code{schedule} (default: @code{\"30 01 * * 0\"})"
  26577. msgstr ""
  26578. #. type: table
  26579. #: guix-git/doc/guix.texi:17951
  26580. msgid "This is the schedule of upgrades, expressed as a gexp containing an mcron job schedule (@pxref{Guile Syntax, mcron job specifications,, mcron, GNU@tie{}mcron})."
  26581. msgstr ""
  26582. #. type: item
  26583. #: guix-git/doc/guix.texi:17952
  26584. #, no-wrap
  26585. msgid "@code{channels} (default: @code{#~%default-channels})"
  26586. msgstr ""
  26587. #. type: table
  26588. #: guix-git/doc/guix.texi:17956
  26589. msgid "This gexp specifies the channels to use for the upgrade (@pxref{Channels}). By default, the tip of the official @code{guix} channel is used."
  26590. msgstr ""
  26591. #. type: item
  26592. #: guix-git/doc/guix.texi:17957
  26593. #, no-wrap
  26594. msgid "@code{operating-system-file} (default: @code{\"/run/current-system/configuration.scm\"})"
  26595. msgstr ""
  26596. #. type: table
  26597. #: guix-git/doc/guix.texi:17960
  26598. msgid "This field specifies the operating system configuration file to use. The default is to reuse the config file of the current configuration."
  26599. msgstr ""
  26600. #. type: table
  26601. #: guix-git/doc/guix.texi:17966
  26602. msgid "There are cases, though, where referring to @file{/run/current-system/configuration.scm} is not enough, for instance because that file refers to extra files (SSH public keys, extra configuration files, etc.) @i{via} @code{local-file} and similar constructs. For those cases, we recommend something along these lines:"
  26603. msgstr ""
  26604. #. type: lisp
  26605. #: guix-git/doc/guix.texi:17972
  26606. #, no-wrap
  26607. msgid ""
  26608. "(unattended-upgrade-configuration\n"
  26609. " (operating-system-file\n"
  26610. " (file-append (local-file \".\" \"config-dir\" #:recursive? #t)\n"
  26611. " \"/config.scm\")))\n"
  26612. msgstr ""
  26613. #. type: table
  26614. #: guix-git/doc/guix.texi:17979
  26615. msgid "The effect here is to import all of the current directory into the store, and to refer to @file{config.scm} within that directory. Therefore, uses of @code{local-file} within @file{config.scm} will work as expected. @xref{G-Expressions}, for information about @code{local-file} and @code{file-append}."
  26616. msgstr ""
  26617. #. type: item
  26618. #: guix-git/doc/guix.texi:17980
  26619. #, no-wrap
  26620. msgid "@code{services-to-restart} (default: @code{'(mcron)})"
  26621. msgstr ""
  26622. #. type: table
  26623. #: guix-git/doc/guix.texi:17983
  26624. msgid "This field specifies the Shepherd services to restart when the upgrade completes."
  26625. msgstr ""
  26626. #. type: table
  26627. #: guix-git/doc/guix.texi:17990
  26628. msgid "Those services are restarted right away upon completion, as with @command{herd restart}, which ensures that the latest version is running---remember that by default @command{guix system reconfigure} only restarts services that are not currently running, which is conservative: it minimizes disruption but leaves outdated services running."
  26629. msgstr ""
  26630. #. type: table
  26631. #: guix-git/doc/guix.texi:17994
  26632. msgid "Use @command{herd status} to find out candidates for restarting. @xref{Services}, for general information about services. Common services to restart would include @code{ntpd} and @code{ssh-daemon}."
  26633. msgstr ""
  26634. #. type: table
  26635. #: guix-git/doc/guix.texi:17997
  26636. msgid "By default, the @code{mcron} service is restarted. This ensures that the latest version of the unattended upgrade job will be used next time."
  26637. msgstr ""
  26638. #. type: item
  26639. #: guix-git/doc/guix.texi:17998
  26640. #, no-wrap
  26641. msgid "@code{system-expiration} (default: @code{(* 3 30 24 3600)})"
  26642. msgstr ""
  26643. #. type: table
  26644. #: guix-git/doc/guix.texi:18002
  26645. msgid "This is the expiration time in seconds for system generations. System generations older that this amount of time are deleted with @command{guix system delete-generations} when an upgrade completes."
  26646. msgstr ""
  26647. #. type: quotation
  26648. #: guix-git/doc/guix.texi:18007
  26649. msgid "The unattended upgrade service does not run the garbage collector. You will probably want to set up your own mcron job to run @command{guix gc} periodically."
  26650. msgstr ""
  26651. #. type: item
  26652. #: guix-git/doc/guix.texi:18009
  26653. #, no-wrap
  26654. msgid "@code{maximum-duration} (default: @code{3600})"
  26655. msgstr ""
  26656. #. type: table
  26657. #: guix-git/doc/guix.texi:18012
  26658. msgid "Maximum duration in seconds for the upgrade; past that time, the upgrade aborts."
  26659. msgstr ""
  26660. #. type: table
  26661. #: guix-git/doc/guix.texi:18015
  26662. msgid "This is primarily useful to ensure the upgrade does not end up rebuilding or re-downloading ``the world''."
  26663. msgstr ""
  26664. #. type: item
  26665. #: guix-git/doc/guix.texi:18016
  26666. #, no-wrap
  26667. msgid "@code{log-file} (default: @code{\"/var/log/unattended-upgrade.log\"})"
  26668. msgstr ""
  26669. #. type: table
  26670. #: guix-git/doc/guix.texi:18018
  26671. msgid "File where unattended upgrades are logged."
  26672. msgstr ""
  26673. #. type: cindex
  26674. #: guix-git/doc/guix.texi:18024
  26675. #, no-wrap
  26676. msgid "X11"
  26677. msgstr ""
  26678. #. type: cindex
  26679. #: guix-git/doc/guix.texi:18025
  26680. #, no-wrap
  26681. msgid "X Window System"
  26682. msgstr ""
  26683. #. type: cindex
  26684. #: guix-git/doc/guix.texi:18026 guix-git/doc/guix.texi:18286
  26685. #, no-wrap
  26686. msgid "login manager"
  26687. msgstr ""
  26688. #. type: Plain text
  26689. #: guix-git/doc/guix.texi:18031
  26690. msgid "Support for the X Window graphical display system---specifically Xorg---is provided by the @code{(gnu services xorg)} module. Note that there is no @code{xorg-service} procedure. Instead, the X server is started by the @dfn{login manager}, by default the GNOME Display Manager (GDM)."
  26691. msgstr ""
  26692. #. type: cindex
  26693. #: guix-git/doc/guix.texi:18032
  26694. #, no-wrap
  26695. msgid "GDM"
  26696. msgstr ""
  26697. #. type: cindex
  26698. #: guix-git/doc/guix.texi:18033
  26699. #, no-wrap
  26700. msgid "GNOME, login manager"
  26701. msgstr ""
  26702. #. type: Plain text
  26703. #: guix-git/doc/guix.texi:18037
  26704. msgid "GDM of course allows users to log in into window managers and desktop environments other than GNOME; for those using GNOME, GDM is required for features such as automatic screen locking."
  26705. msgstr ""
  26706. #. type: cindex
  26707. #: guix-git/doc/guix.texi:18038
  26708. #, no-wrap
  26709. msgid "window manager"
  26710. msgstr ""
  26711. #. type: Plain text
  26712. #: guix-git/doc/guix.texi:18043
  26713. msgid "To use X11, you must install at least one @dfn{window manager}---for example the @code{windowmaker} or @code{openbox} packages---preferably by adding it to the @code{packages} field of your operating system definition (@pxref{operating-system Reference, system-wide packages})."
  26714. msgstr ""
  26715. #. type: defvr
  26716. #: guix-git/doc/guix.texi:18044
  26717. #, no-wrap
  26718. msgid "{Scheme Variable} gdm-service-type"
  26719. msgstr ""
  26720. #. type: defvr
  26721. #: guix-git/doc/guix.texi:18049
  26722. msgid "This is the type for the @uref{https://wiki.gnome.org/Projects/GDM/, GNOME Desktop Manager} (GDM), a program that manages graphical display servers and handles graphical user logins. Its value must be a @code{gdm-configuration} (see below)."
  26723. msgstr ""
  26724. #. type: cindex
  26725. #: guix-git/doc/guix.texi:18050
  26726. #, no-wrap
  26727. msgid "session types (X11)"
  26728. msgstr ""
  26729. #. type: cindex
  26730. #: guix-git/doc/guix.texi:18051
  26731. #, no-wrap
  26732. msgid "X11 session types"
  26733. msgstr ""
  26734. #. type: defvr
  26735. #: guix-git/doc/guix.texi:18057
  26736. msgid "GDM looks for @dfn{session types} described by the @file{.desktop} files in @file{/run/current-system/profile/share/xsessions} and allows users to choose a session from the log-in screen. Packages such as @code{gnome}, @code{xfce}, and @code{i3} provide @file{.desktop} files; adding them to the system-wide set of packages automatically makes them available at the log-in screen."
  26737. msgstr ""
  26738. #. type: defvr
  26739. #: guix-git/doc/guix.texi:18061
  26740. msgid "In addition, @file{~/.xsession} files are honored. When available, @file{~/.xsession} must be an executable that starts a window manager and/or other X clients."
  26741. msgstr ""
  26742. #. type: deftp
  26743. #: guix-git/doc/guix.texi:18063
  26744. #, no-wrap
  26745. msgid "{Data Type} gdm-configuration"
  26746. msgstr ""
  26747. #. type: item
  26748. #: guix-git/doc/guix.texi:18065 guix-git/doc/guix.texi:18141
  26749. #, no-wrap
  26750. msgid "@code{auto-login?} (default: @code{#f})"
  26751. msgstr ""
  26752. #. type: itemx
  26753. #: guix-git/doc/guix.texi:18066
  26754. #, no-wrap
  26755. msgid "@code{default-user} (default: @code{#f})"
  26756. msgstr ""
  26757. #. type: table
  26758. #: guix-git/doc/guix.texi:18068
  26759. msgid "When @code{auto-login?} is false, GDM presents a log-in screen."
  26760. msgstr ""
  26761. #. type: table
  26762. #: guix-git/doc/guix.texi:18071
  26763. msgid "When @code{auto-login?} is true, GDM logs in directly as @code{default-user}."
  26764. msgstr ""
  26765. #. type: item
  26766. #: guix-git/doc/guix.texi:18072 guix-git/doc/guix.texi:23920
  26767. #: guix-git/doc/guix.texi:25628 guix-git/doc/guix.texi:30046
  26768. #: guix-git/doc/guix.texi:30075 guix-git/doc/guix.texi:30104
  26769. #: guix-git/doc/guix.texi:30131 guix-git/doc/guix.texi:30186
  26770. #: guix-git/doc/guix.texi:30211 guix-git/doc/guix.texi:30238
  26771. #: guix-git/doc/guix.texi:30264 guix-git/doc/guix.texi:30306
  26772. #, no-wrap
  26773. msgid "@code{debug?} (default: @code{#f})"
  26774. msgstr ""
  26775. #. type: table
  26776. #: guix-git/doc/guix.texi:18074
  26777. msgid "When true, GDM writes debug messages to its log."
  26778. msgstr ""
  26779. #. type: item
  26780. #: guix-git/doc/guix.texi:18075
  26781. #, no-wrap
  26782. msgid "@code{gnome-shell-assets} (default: ...)"
  26783. msgstr ""
  26784. #. type: table
  26785. #: guix-git/doc/guix.texi:18077
  26786. msgid "List of GNOME Shell assets needed by GDM: icon theme, fonts, etc."
  26787. msgstr ""
  26788. #. type: item
  26789. #: guix-git/doc/guix.texi:18078
  26790. #, no-wrap
  26791. msgid "@code{xorg-configuration} (default: @code{(xorg-configuration)})"
  26792. msgstr ""
  26793. #. type: table
  26794. #: guix-git/doc/guix.texi:18080 guix-git/doc/guix.texi:18168
  26795. #: guix-git/doc/guix.texi:18252
  26796. msgid "Configuration of the Xorg graphical server."
  26797. msgstr ""
  26798. #. type: item
  26799. #: guix-git/doc/guix.texi:18081
  26800. #, no-wrap
  26801. msgid "@code{xsession} (default: @code{(xinitrc)})"
  26802. msgstr ""
  26803. #. type: table
  26804. #: guix-git/doc/guix.texi:18083 guix-git/doc/guix.texi:18267
  26805. msgid "Script to run before starting a X session."
  26806. msgstr ""
  26807. #. type: item
  26808. #: guix-git/doc/guix.texi:18084
  26809. #, no-wrap
  26810. msgid "@code{dbus-daemon} (default: @code{dbus-daemon-wrapper})"
  26811. msgstr ""
  26812. #. type: table
  26813. #: guix-git/doc/guix.texi:18086
  26814. msgid "File name of the @code{dbus-daemon} executable."
  26815. msgstr ""
  26816. #. type: item
  26817. #: guix-git/doc/guix.texi:18087
  26818. #, no-wrap
  26819. msgid "@code{gdm} (default: @code{gdm})"
  26820. msgstr ""
  26821. #. type: table
  26822. #: guix-git/doc/guix.texi:18089
  26823. msgid "The GDM package to use."
  26824. msgstr ""
  26825. #. type: defvr
  26826. #: guix-git/doc/guix.texi:18092
  26827. #, no-wrap
  26828. msgid "{Scheme Variable} slim-service-type"
  26829. msgstr ""
  26830. #. type: defvr
  26831. #: guix-git/doc/guix.texi:18094
  26832. msgid "This is the type for the SLiM graphical login manager for X11."
  26833. msgstr ""
  26834. #. type: defvr
  26835. #: guix-git/doc/guix.texi:18098
  26836. msgid "Like GDM, SLiM looks for session types described by @file{.desktop} files and allows users to choose a session from the log-in screen using @kbd{F1}. It also honors @file{~/.xsession} files."
  26837. msgstr ""
  26838. #. type: defvr
  26839. #: guix-git/doc/guix.texi:18105
  26840. msgid "Unlike GDM, SLiM does not spawn the user session on a different VT after logging in, which means that you can only start one graphical session. If you want to be able to run multiple graphical sessions at the same time you have to add multiple SLiM services to your system services. The following example shows how to replace the default GDM service with two SLiM services on tty7 and tty8."
  26841. msgstr ""
  26842. #. type: lisp
  26843. #: guix-git/doc/guix.texi:18111
  26844. #, no-wrap
  26845. msgid ""
  26846. "(use-modules (gnu services)\n"
  26847. " (gnu services desktop)\n"
  26848. " (gnu services xorg)\n"
  26849. " (srfi srfi-1)) ;for 'remove'\n"
  26850. "\n"
  26851. msgstr ""
  26852. #. type: lisp
  26853. #: guix-git/doc/guix.texi:18122
  26854. #, no-wrap
  26855. msgid ""
  26856. "(operating-system\n"
  26857. " ;; ...\n"
  26858. " (services (cons* (service slim-service-type (slim-configuration\n"
  26859. " (display \":0\")\n"
  26860. " (vt \"vt7\")))\n"
  26861. " (service slim-service-type (slim-configuration\n"
  26862. " (display \":1\")\n"
  26863. " (vt \"vt8\")))\n"
  26864. " (modify-services %desktop-services\n"
  26865. " (delete gdm-service-type)))))\n"
  26866. msgstr ""
  26867. #. type: deftp
  26868. #: guix-git/doc/guix.texi:18126
  26869. #, no-wrap
  26870. msgid "{Data Type} slim-configuration"
  26871. msgstr ""
  26872. #. type: deftp
  26873. #: guix-git/doc/guix.texi:18128
  26874. msgid "Data type representing the configuration of @code{slim-service-type}."
  26875. msgstr ""
  26876. #. type: table
  26877. #: guix-git/doc/guix.texi:18132
  26878. msgid "Whether to allow logins with empty passwords."
  26879. msgstr ""
  26880. #. type: item
  26881. #: guix-git/doc/guix.texi:18133
  26882. #, no-wrap
  26883. msgid "@code{gnupg?} (default: @code{#f})"
  26884. msgstr ""
  26885. #. type: table
  26886. #: guix-git/doc/guix.texi:18140
  26887. msgid "If enabled, @code{pam-gnupg} will attempt to automatically unlock the user's GPG keys with the login password via @code{gpg-agent}. The keygrips of all keys to be unlocked should be written to @file{~/.pam-gnupg}, and can be queried with @code{gpg -K --with-keygrip}. Presetting passphrases must be enabled by adding @code{allow-preset-passphrase} in @file{~/.gnupg/gpg-agent.conf}."
  26888. msgstr ""
  26889. #. type: itemx
  26890. #: guix-git/doc/guix.texi:18142
  26891. #, no-wrap
  26892. msgid "@code{default-user} (default: @code{\"\"})"
  26893. msgstr ""
  26894. #. type: table
  26895. #: guix-git/doc/guix.texi:18144
  26896. msgid "When @code{auto-login?} is false, SLiM presents a log-in screen."
  26897. msgstr ""
  26898. #. type: table
  26899. #: guix-git/doc/guix.texi:18147
  26900. msgid "When @code{auto-login?} is true, SLiM logs in directly as @code{default-user}."
  26901. msgstr ""
  26902. #. type: item
  26903. #: guix-git/doc/guix.texi:18148
  26904. #, no-wrap
  26905. msgid "@code{theme} (default: @code{%default-slim-theme})"
  26906. msgstr ""
  26907. #. type: itemx
  26908. #: guix-git/doc/guix.texi:18149
  26909. #, no-wrap
  26910. msgid "@code{theme-name} (default: @code{%default-slim-theme-name})"
  26911. msgstr ""
  26912. #. type: table
  26913. #: guix-git/doc/guix.texi:18151
  26914. msgid "The graphical theme to use and its name."
  26915. msgstr ""
  26916. #. type: item
  26917. #: guix-git/doc/guix.texi:18152
  26918. #, no-wrap
  26919. msgid "@code{auto-login-session} (default: @code{#f})"
  26920. msgstr ""
  26921. #. type: table
  26922. #: guix-git/doc/guix.texi:18155
  26923. msgid "If true, this must be the name of the executable to start as the default session---e.g., @code{(file-append windowmaker \"/bin/windowmaker\")}."
  26924. msgstr ""
  26925. #. type: table
  26926. #: guix-git/doc/guix.texi:18159
  26927. msgid "If false, a session described by one of the available @file{.desktop} files in @code{/run/current-system/profile} and @code{~/.guix-profile} will be used."
  26928. msgstr ""
  26929. #. type: quotation
  26930. #: guix-git/doc/guix.texi:18164
  26931. msgid "You must install at least one window manager in the system profile or in your user profile. Failing to do that, if @code{auto-login-session} is false, you will be unable to log in."
  26932. msgstr ""
  26933. #. type: item
  26934. #: guix-git/doc/guix.texi:18166 guix-git/doc/guix.texi:18250
  26935. #, no-wrap
  26936. msgid "@code{xorg-configuration} (default @code{(xorg-configuration)})"
  26937. msgstr ""
  26938. #. type: item
  26939. #: guix-git/doc/guix.texi:18169
  26940. #, no-wrap
  26941. msgid "@code{display} (default @code{\":0\"})"
  26942. msgstr ""
  26943. #. type: table
  26944. #: guix-git/doc/guix.texi:18171
  26945. msgid "The display on which to start the Xorg graphical server."
  26946. msgstr ""
  26947. #. type: item
  26948. #: guix-git/doc/guix.texi:18172
  26949. #, no-wrap
  26950. msgid "@code{vt} (default @code{\"vt7\"})"
  26951. msgstr ""
  26952. #. type: table
  26953. #: guix-git/doc/guix.texi:18174
  26954. msgid "The VT on which to start the Xorg graphical server."
  26955. msgstr ""
  26956. #. type: item
  26957. #: guix-git/doc/guix.texi:18175
  26958. #, no-wrap
  26959. msgid "@code{xauth} (default: @code{xauth})"
  26960. msgstr ""
  26961. #. type: table
  26962. #: guix-git/doc/guix.texi:18177
  26963. msgid "The XAuth package to use."
  26964. msgstr ""
  26965. #. type: item
  26966. #: guix-git/doc/guix.texi:18178
  26967. #, no-wrap
  26968. msgid "@code{shepherd} (default: @code{shepherd})"
  26969. msgstr ""
  26970. #. type: table
  26971. #: guix-git/doc/guix.texi:18181
  26972. msgid "The Shepherd package used when invoking @command{halt} and @command{reboot}."
  26973. msgstr ""
  26974. #. type: item
  26975. #: guix-git/doc/guix.texi:18182
  26976. #, no-wrap
  26977. msgid "@code{sessreg} (default: @code{sessreg})"
  26978. msgstr ""
  26979. #. type: table
  26980. #: guix-git/doc/guix.texi:18184
  26981. msgid "The sessreg package used in order to register the session."
  26982. msgstr ""
  26983. #. type: item
  26984. #: guix-git/doc/guix.texi:18185
  26985. #, no-wrap
  26986. msgid "@code{slim} (default: @code{slim})"
  26987. msgstr ""
  26988. #. type: table
  26989. #: guix-git/doc/guix.texi:18187
  26990. msgid "The SLiM package to use."
  26991. msgstr ""
  26992. #. type: defvr
  26993. #: guix-git/doc/guix.texi:18190
  26994. #, no-wrap
  26995. msgid "{Scheme Variable} %default-theme"
  26996. msgstr ""
  26997. #. type: defvrx
  26998. #: guix-git/doc/guix.texi:18191
  26999. #, no-wrap
  27000. msgid "{Scheme Variable} %default-theme-name"
  27001. msgstr ""
  27002. #. type: defvr
  27003. #: guix-git/doc/guix.texi:18193
  27004. msgid "The default SLiM theme and its name."
  27005. msgstr ""
  27006. #. type: deftp
  27007. #: guix-git/doc/guix.texi:18196 guix-git/doc/guix.texi:18303
  27008. #, no-wrap
  27009. msgid "{Data Type} sddm-configuration"
  27010. msgstr ""
  27011. #. type: deftp
  27012. #: guix-git/doc/guix.texi:18198
  27013. msgid "This is the data type representing the SDDM service configuration."
  27014. msgstr ""
  27015. #. type: item
  27016. #: guix-git/doc/guix.texi:18200
  27017. #, no-wrap
  27018. msgid "@code{display-server} (default: \"x11\")"
  27019. msgstr ""
  27020. #. type: table
  27021. #: guix-git/doc/guix.texi:18203
  27022. msgid "Select display server to use for the greeter. Valid values are @samp{\"x11\"} or @samp{\"wayland\"}."
  27023. msgstr ""
  27024. #. type: item
  27025. #: guix-git/doc/guix.texi:18204
  27026. #, no-wrap
  27027. msgid "@code{numlock} (default: \"on\")"
  27028. msgstr ""
  27029. #. type: table
  27030. #: guix-git/doc/guix.texi:18206
  27031. msgid "Valid values are @samp{\"on\"}, @samp{\"off\"} or @samp{\"none\"}."
  27032. msgstr ""
  27033. #. type: item
  27034. #: guix-git/doc/guix.texi:18207
  27035. #, no-wrap
  27036. msgid "@code{halt-command} (default @code{#~(string-apppend #$shepherd \"/sbin/halt\")})"
  27037. msgstr ""
  27038. #. type: table
  27039. #: guix-git/doc/guix.texi:18209
  27040. msgid "Command to run when halting."
  27041. msgstr ""
  27042. #. type: item
  27043. #: guix-git/doc/guix.texi:18210
  27044. #, no-wrap
  27045. msgid "@code{reboot-command} (default @code{#~(string-append #$shepherd \"/sbin/reboot\")})"
  27046. msgstr ""
  27047. #. type: table
  27048. #: guix-git/doc/guix.texi:18212
  27049. msgid "Command to run when rebooting."
  27050. msgstr ""
  27051. #. type: item
  27052. #: guix-git/doc/guix.texi:18213
  27053. #, no-wrap
  27054. msgid "@code{theme} (default \"maldives\")"
  27055. msgstr ""
  27056. #. type: table
  27057. #: guix-git/doc/guix.texi:18216
  27058. msgid "Theme to use. Default themes provided by SDDM are @samp{\"elarun\"}, @samp{\"maldives\"} or @samp{\"maya\"}."
  27059. msgstr ""
  27060. #. type: item
  27061. #: guix-git/doc/guix.texi:18217
  27062. #, no-wrap
  27063. msgid "@code{themes-directory} (default \"/run/current-system/profile/share/sddm/themes\")"
  27064. msgstr ""
  27065. #. type: table
  27066. #: guix-git/doc/guix.texi:18219
  27067. msgid "Directory to look for themes."
  27068. msgstr ""
  27069. #. type: item
  27070. #: guix-git/doc/guix.texi:18220
  27071. #, no-wrap
  27072. msgid "@code{faces-directory} (default \"/run/current-system/profile/share/sddm/faces\")"
  27073. msgstr ""
  27074. #. type: table
  27075. #: guix-git/doc/guix.texi:18222
  27076. msgid "Directory to look for faces."
  27077. msgstr ""
  27078. #. type: item
  27079. #: guix-git/doc/guix.texi:18223
  27080. #, no-wrap
  27081. msgid "@code{default-path} (default \"/run/current-system/profile/bin\")"
  27082. msgstr ""
  27083. #. type: table
  27084. #: guix-git/doc/guix.texi:18225
  27085. msgid "Default PATH to use."
  27086. msgstr ""
  27087. #. type: item
  27088. #: guix-git/doc/guix.texi:18226
  27089. #, no-wrap
  27090. msgid "@code{minimum-uid} (default: 1000)"
  27091. msgstr ""
  27092. #. type: table
  27093. #: guix-git/doc/guix.texi:18228
  27094. msgid "Minimum UID displayed in SDDM and allowed for log-in."
  27095. msgstr ""
  27096. #. type: item
  27097. #: guix-git/doc/guix.texi:18229
  27098. #, no-wrap
  27099. msgid "@code{maximum-uid} (default: 2000)"
  27100. msgstr ""
  27101. #. type: table
  27102. #: guix-git/doc/guix.texi:18231
  27103. msgid "Maximum UID to display in SDDM."
  27104. msgstr ""
  27105. #. type: item
  27106. #: guix-git/doc/guix.texi:18232
  27107. #, no-wrap
  27108. msgid "@code{remember-last-user?} (default #t)"
  27109. msgstr ""
  27110. #. type: table
  27111. #: guix-git/doc/guix.texi:18234
  27112. msgid "Remember last user."
  27113. msgstr ""
  27114. #. type: item
  27115. #: guix-git/doc/guix.texi:18235
  27116. #, no-wrap
  27117. msgid "@code{remember-last-session?} (default #t)"
  27118. msgstr ""
  27119. #. type: table
  27120. #: guix-git/doc/guix.texi:18237
  27121. msgid "Remember last session."
  27122. msgstr ""
  27123. #. type: item
  27124. #: guix-git/doc/guix.texi:18238
  27125. #, no-wrap
  27126. msgid "@code{hide-users} (default \"\")"
  27127. msgstr ""
  27128. #. type: table
  27129. #: guix-git/doc/guix.texi:18240
  27130. msgid "Usernames to hide from SDDM greeter."
  27131. msgstr ""
  27132. #. type: item
  27133. #: guix-git/doc/guix.texi:18241
  27134. #, no-wrap
  27135. msgid "@code{hide-shells} (default @code{#~(string-append #$shadow \"/sbin/nologin\")})"
  27136. msgstr ""
  27137. #. type: table
  27138. #: guix-git/doc/guix.texi:18243
  27139. msgid "Users with shells listed will be hidden from the SDDM greeter."
  27140. msgstr ""
  27141. #. type: item
  27142. #: guix-git/doc/guix.texi:18244
  27143. #, no-wrap
  27144. msgid "@code{session-command} (default @code{#~(string-append #$sddm \"/share/sddm/scripts/wayland-session\")})"
  27145. msgstr ""
  27146. #. type: table
  27147. #: guix-git/doc/guix.texi:18246
  27148. msgid "Script to run before starting a wayland session."
  27149. msgstr ""
  27150. #. type: item
  27151. #: guix-git/doc/guix.texi:18247
  27152. #, no-wrap
  27153. msgid "@code{sessions-directory} (default \"/run/current-system/profile/share/wayland-sessions\")"
  27154. msgstr ""
  27155. #. type: table
  27156. #: guix-git/doc/guix.texi:18249
  27157. msgid "Directory to look for desktop files starting wayland sessions."
  27158. msgstr ""
  27159. #. type: item
  27160. #: guix-git/doc/guix.texi:18253
  27161. #, no-wrap
  27162. msgid "@code{xauth-path} (default @code{#~(string-append #$xauth \"/bin/xauth\")})"
  27163. msgstr ""
  27164. #. type: table
  27165. #: guix-git/doc/guix.texi:18255
  27166. msgid "Path to xauth."
  27167. msgstr ""
  27168. #. type: item
  27169. #: guix-git/doc/guix.texi:18256
  27170. #, no-wrap
  27171. msgid "@code{xephyr-path} (default @code{#~(string-append #$xorg-server \"/bin/Xephyr\")})"
  27172. msgstr ""
  27173. #. type: table
  27174. #: guix-git/doc/guix.texi:18258
  27175. msgid "Path to Xephyr."
  27176. msgstr ""
  27177. #. type: item
  27178. #: guix-git/doc/guix.texi:18259
  27179. #, no-wrap
  27180. msgid "@code{xdisplay-start} (default @code{#~(string-append #$sddm \"/share/sddm/scripts/Xsetup\")})"
  27181. msgstr ""
  27182. #. type: table
  27183. #: guix-git/doc/guix.texi:18261
  27184. msgid "Script to run after starting xorg-server."
  27185. msgstr ""
  27186. #. type: item
  27187. #: guix-git/doc/guix.texi:18262
  27188. #, no-wrap
  27189. msgid "@code{xdisplay-stop} (default @code{#~(string-append #$sddm \"/share/sddm/scripts/Xstop\")})"
  27190. msgstr ""
  27191. #. type: table
  27192. #: guix-git/doc/guix.texi:18264
  27193. msgid "Script to run before stopping xorg-server."
  27194. msgstr ""
  27195. #. type: item
  27196. #: guix-git/doc/guix.texi:18265
  27197. #, no-wrap
  27198. msgid "@code{xsession-command} (default: @code{xinitrc})"
  27199. msgstr ""
  27200. #. type: item
  27201. #: guix-git/doc/guix.texi:18268
  27202. #, no-wrap
  27203. msgid "@code{xsessions-directory} (default: \"/run/current-system/profile/share/xsessions\")"
  27204. msgstr ""
  27205. #. type: table
  27206. #: guix-git/doc/guix.texi:18270
  27207. msgid "Directory to look for desktop files starting X sessions."
  27208. msgstr ""
  27209. #. type: item
  27210. #: guix-git/doc/guix.texi:18271
  27211. #, no-wrap
  27212. msgid "@code{minimum-vt} (default: 7)"
  27213. msgstr ""
  27214. #. type: table
  27215. #: guix-git/doc/guix.texi:18273
  27216. msgid "Minimum VT to use."
  27217. msgstr ""
  27218. #. type: item
  27219. #: guix-git/doc/guix.texi:18274
  27220. #, no-wrap
  27221. msgid "@code{auto-login-user} (default \"\")"
  27222. msgstr ""
  27223. #. type: table
  27224. #: guix-git/doc/guix.texi:18276
  27225. msgid "User to use for auto-login."
  27226. msgstr ""
  27227. #. type: item
  27228. #: guix-git/doc/guix.texi:18277
  27229. #, no-wrap
  27230. msgid "@code{auto-login-session} (default \"\")"
  27231. msgstr ""
  27232. #. type: table
  27233. #: guix-git/doc/guix.texi:18279
  27234. msgid "Desktop file to use for auto-login."
  27235. msgstr ""
  27236. #. type: item
  27237. #: guix-git/doc/guix.texi:18280
  27238. #, no-wrap
  27239. msgid "@code{relogin?} (default #f)"
  27240. msgstr ""
  27241. #. type: table
  27242. #: guix-git/doc/guix.texi:18282
  27243. msgid "Relogin after logout."
  27244. msgstr ""
  27245. #. type: cindex
  27246. #: guix-git/doc/guix.texi:18287
  27247. #, no-wrap
  27248. msgid "X11 login"
  27249. msgstr ""
  27250. #. type: defvr
  27251. #: guix-git/doc/guix.texi:18288
  27252. #, no-wrap
  27253. msgid "{Scheme Variable} sddm-service-type"
  27254. msgstr ""
  27255. #. type: defvr
  27256. #: guix-git/doc/guix.texi:18292
  27257. msgid "This is the type of the service to run the @uref{https://github.com/sddm/sddm,SDDM display manager}. Its value must be a @code{sddm-configuration} record (see below)."
  27258. msgstr ""
  27259. #. type: defvr
  27260. #: guix-git/doc/guix.texi:18294
  27261. msgid "Here's an example use:"
  27262. msgstr ""
  27263. #. type: lisp
  27264. #: guix-git/doc/guix.texi:18300
  27265. #, no-wrap
  27266. msgid ""
  27267. "(service sddm-service-type\n"
  27268. " (sddm-configuration\n"
  27269. " (auto-login-user \"alice\")\n"
  27270. " (auto-login-session \"xfce.desktop\")))\n"
  27271. msgstr ""
  27272. #. type: deftp
  27273. #: guix-git/doc/guix.texi:18306
  27274. msgid "This data type represents the configuration of the SDDM login manager. The available fields are:"
  27275. msgstr ""
  27276. #. type: item
  27277. #: guix-git/doc/guix.texi:18308
  27278. #, no-wrap
  27279. msgid "@code{sddm} (default: @code{sddm})"
  27280. msgstr ""
  27281. #. type: table
  27282. #: guix-git/doc/guix.texi:18310
  27283. msgid "The SDDM package to use."
  27284. msgstr ""
  27285. #. type: item
  27286. #: guix-git/doc/guix.texi:18311
  27287. #, no-wrap
  27288. msgid "@code{display-server} (default: @code{\"x11\"})"
  27289. msgstr ""
  27290. #. type: table
  27291. #: guix-git/doc/guix.texi:18313
  27292. msgid "This must be either @code{\"x11\"} or @code{\"wayland\"}."
  27293. msgstr ""
  27294. #. type: item
  27295. #: guix-git/doc/guix.texi:18316
  27296. #, no-wrap
  27297. msgid "@code{auto-login-user} (default: @code{\"\"})"
  27298. msgstr ""
  27299. #. type: table
  27300. #: guix-git/doc/guix.texi:18319
  27301. msgid "If non-empty, this is the user account under which to log in automatically."
  27302. msgstr ""
  27303. #. type: item
  27304. #: guix-git/doc/guix.texi:18320
  27305. #, no-wrap
  27306. msgid "@code{auto-login-session} (default: @code{\"\"})"
  27307. msgstr ""
  27308. #. type: table
  27309. #: guix-git/doc/guix.texi:18323
  27310. msgid "If non-empty, this is the @file{.desktop} file name to use as the auto-login session."
  27311. msgstr ""
  27312. #. type: cindex
  27313. #: guix-git/doc/guix.texi:18326
  27314. #, no-wrap
  27315. msgid "Xorg, configuration"
  27316. msgstr ""
  27317. #. type: deftp
  27318. #: guix-git/doc/guix.texi:18327
  27319. #, no-wrap
  27320. msgid "{Data Type} xorg-configuration"
  27321. msgstr ""
  27322. #. type: deftp
  27323. #: guix-git/doc/guix.texi:18332
  27324. msgid "This data type represents the configuration of the Xorg graphical display server. Note that there is no Xorg service; instead, the X server is started by a ``display manager'' such as GDM, SDDM, and SLiM@. Thus, the configuration of these display managers aggregates an @code{xorg-configuration} record."
  27325. msgstr ""
  27326. #. type: item
  27327. #: guix-git/doc/guix.texi:18334
  27328. #, no-wrap
  27329. msgid "@code{modules} (default: @code{%default-xorg-modules})"
  27330. msgstr ""
  27331. #. type: table
  27332. #: guix-git/doc/guix.texi:18337
  27333. msgid "This is a list of @dfn{module packages} loaded by the Xorg server---e.g., @code{xf86-video-vesa}, @code{xf86-input-keyboard}, and so on."
  27334. msgstr ""
  27335. #. type: item
  27336. #: guix-git/doc/guix.texi:18338
  27337. #, no-wrap
  27338. msgid "@code{fonts} (default: @code{%default-xorg-fonts})"
  27339. msgstr ""
  27340. #. type: table
  27341. #: guix-git/doc/guix.texi:18340
  27342. msgid "This is a list of font directories to add to the server's @dfn{font path}."
  27343. msgstr ""
  27344. #. type: item
  27345. #: guix-git/doc/guix.texi:18341
  27346. #, no-wrap
  27347. msgid "@code{drivers} (default: @code{'()})"
  27348. msgstr ""
  27349. #. type: table
  27350. #: guix-git/doc/guix.texi:18345
  27351. msgid "This must be either the empty list, in which case Xorg chooses a graphics driver automatically, or a list of driver names that will be tried in this order---e.g., @code{(\"modesetting\" \"vesa\")}."
  27352. msgstr ""
  27353. #. type: item
  27354. #: guix-git/doc/guix.texi:18346
  27355. #, no-wrap
  27356. msgid "@code{resolutions} (default: @code{'()})"
  27357. msgstr ""
  27358. #. type: table
  27359. #: guix-git/doc/guix.texi:18350
  27360. msgid "When @code{resolutions} is the empty list, Xorg chooses an appropriate screen resolution. Otherwise, it must be a list of resolutions---e.g., @code{((1024 768) (640 480))}."
  27361. msgstr ""
  27362. #. type: cindex
  27363. #: guix-git/doc/guix.texi:18351
  27364. #, no-wrap
  27365. msgid "keyboard layout, for Xorg"
  27366. msgstr ""
  27367. #. type: cindex
  27368. #: guix-git/doc/guix.texi:18352
  27369. #, no-wrap
  27370. msgid "keymap, for Xorg"
  27371. msgstr ""
  27372. #. type: table
  27373. #: guix-git/doc/guix.texi:18356
  27374. msgid "If this is @code{#f}, Xorg uses the default keyboard layout---usually US English (``qwerty'') for a 105-key PC keyboard."
  27375. msgstr ""
  27376. #. type: table
  27377. #: guix-git/doc/guix.texi:18360
  27378. msgid "Otherwise this must be a @code{keyboard-layout} object specifying the keyboard layout in use when Xorg is running. @xref{Keyboard Layout}, for more information on how to specify the keyboard layout."
  27379. msgstr ""
  27380. #. type: item
  27381. #: guix-git/doc/guix.texi:18361 guix-git/doc/guix.texi:20066
  27382. #: guix-git/doc/guix.texi:32678
  27383. #, no-wrap
  27384. msgid "@code{extra-config} (default: @code{'()})"
  27385. msgstr ""
  27386. #. type: table
  27387. #: guix-git/doc/guix.texi:18364 guix-git/doc/guix.texi:32682
  27388. msgid "This is a list of strings or objects appended to the configuration file. It is used to pass extra text to be added verbatim to the configuration file."
  27389. msgstr ""
  27390. #. type: item
  27391. #: guix-git/doc/guix.texi:18365
  27392. #, no-wrap
  27393. msgid "@code{server} (default: @code{xorg-server})"
  27394. msgstr ""
  27395. #. type: table
  27396. #: guix-git/doc/guix.texi:18367
  27397. msgid "This is the package providing the Xorg server."
  27398. msgstr ""
  27399. #. type: item
  27400. #: guix-git/doc/guix.texi:18368
  27401. #, no-wrap
  27402. msgid "@code{server-arguments} (default: @code{%default-xorg-server-arguments})"
  27403. msgstr ""
  27404. #. type: table
  27405. #: guix-git/doc/guix.texi:18371
  27406. msgid "This is the list of command-line arguments to pass to the X server. The default is @code{-nolisten tcp}."
  27407. msgstr ""
  27408. #. type: deffn
  27409. #: guix-git/doc/guix.texi:18374
  27410. #, no-wrap
  27411. msgid "{Scheme Procedure} set-xorg-configuration @var{config} @"
  27412. msgstr ""
  27413. #. type: deffn
  27414. #: guix-git/doc/guix.texi:18378
  27415. msgid "[@var{login-manager-service-type}] Tell the log-in manager (of type @var{login-manager-service-type}) to use @var{config}, an @code{<xorg-configuration>} record."
  27416. msgstr ""
  27417. #. type: deffn
  27418. #: guix-git/doc/guix.texi:18382
  27419. msgid "Since the Xorg configuration is embedded in the log-in manager's configuration---e.g., @code{gdm-configuration}---this procedure provides a shorthand to set the Xorg configuration."
  27420. msgstr ""
  27421. #. type: deffn
  27422. #: guix-git/doc/guix.texi:18384
  27423. #, no-wrap
  27424. msgid "{Scheme Procedure} xorg-start-command [@var{config}]"
  27425. msgstr ""
  27426. #. type: deffn
  27427. #: guix-git/doc/guix.texi:18388
  27428. msgid "Return a @code{startx} script in which the modules, fonts, etc. specified in @var{config}, are available. The result should be used in place of @code{startx}."
  27429. msgstr ""
  27430. #. type: deffn
  27431. #: guix-git/doc/guix.texi:18390
  27432. msgid "Usually the X server is started by a login manager."
  27433. msgstr ""
  27434. #. type: deffn
  27435. #: guix-git/doc/guix.texi:18393
  27436. #, no-wrap
  27437. msgid "{Scheme Procedure} screen-locker-service @var{package} [@var{program}]"
  27438. msgstr ""
  27439. #. type: deffn
  27440. #: guix-git/doc/guix.texi:18397
  27441. msgid "Add @var{package}, a package for a screen locker or screen saver whose command is @var{program}, to the set of setuid programs and add a PAM entry for it. For example:"
  27442. msgstr ""
  27443. #. type: lisp
  27444. #: guix-git/doc/guix.texi:18400
  27445. #, no-wrap
  27446. msgid "(screen-locker-service xlockmore \"xlock\")\n"
  27447. msgstr ""
  27448. #. type: deffn
  27449. #: guix-git/doc/guix.texi:18403
  27450. msgid "makes the good ol' XlockMore usable."
  27451. msgstr ""
  27452. #. type: cindex
  27453. #: guix-git/doc/guix.texi:18409
  27454. #, no-wrap
  27455. msgid "printer support with CUPS"
  27456. msgstr ""
  27457. #. type: Plain text
  27458. #: guix-git/doc/guix.texi:18413
  27459. msgid "The @code{(gnu services cups)} module provides a Guix service definition for the CUPS printing service. To add printer support to a Guix system, add a @code{cups-service} to the operating system definition:"
  27460. msgstr ""
  27461. #. type: deffn
  27462. #: guix-git/doc/guix.texi:18414
  27463. #, no-wrap
  27464. msgid "{Scheme Variable} cups-service-type"
  27465. msgstr ""
  27466. #. type: deffn
  27467. #: guix-git/doc/guix.texi:18418
  27468. msgid "The service type for the CUPS print server. Its value should be a valid CUPS configuration (see below). To use the default settings, simply write:"
  27469. msgstr ""
  27470. #. type: lisp
  27471. #: guix-git/doc/guix.texi:18420
  27472. #, no-wrap
  27473. msgid "(service cups-service-type)\n"
  27474. msgstr ""
  27475. #. type: Plain text
  27476. #: guix-git/doc/guix.texi:18430
  27477. msgid "The CUPS configuration controls the basic things about your CUPS installation: what interfaces it listens on, what to do if a print job fails, how much logging to do, and so on. To actually add a printer, you have to visit the @url{http://localhost:631} URL, or use a tool such as GNOME's printer configuration services. By default, configuring a CUPS service will generate a self-signed certificate if needed, for secure connections to the print server."
  27478. msgstr ""
  27479. #. type: Plain text
  27480. #: guix-git/doc/guix.texi:18436
  27481. msgid "Suppose you want to enable the Web interface of CUPS and also add support for Epson printers @i{via} the @code{epson-inkjet-printer-escpr} package and for HP printers @i{via} the @code{hplip-minimal} package. You can do that directly, like this (you need to use the @code{(gnu packages cups)} module):"
  27482. msgstr ""
  27483. #. type: lisp
  27484. #: guix-git/doc/guix.texi:18443
  27485. #, no-wrap
  27486. msgid ""
  27487. "(service cups-service-type\n"
  27488. " (cups-configuration\n"
  27489. " (web-interface? #t)\n"
  27490. " (extensions\n"
  27491. " (list cups-filters epson-inkjet-printer-escpr hplip-minimal))))\n"
  27492. msgstr ""
  27493. #. type: Plain text
  27494. #: guix-git/doc/guix.texi:18448
  27495. msgid "Note: If you wish to use the Qt5 based GUI which comes with the hplip package then it is suggested that you install the @code{hplip} package, either in your OS configuration file or as your user."
  27496. msgstr ""
  27497. #. type: Plain text
  27498. #: guix-git/doc/guix.texi:18455
  27499. msgid "The available configuration parameters follow. Each parameter definition is preceded by its type; for example, @samp{string-list foo} indicates that the @code{foo} parameter should be specified as a list of strings. There is also a way to specify the configuration as a string, if you have an old @code{cupsd.conf} file that you want to port over from some other system; see the end for more details."
  27500. msgstr ""
  27501. #. type: Plain text
  27502. #: guix-git/doc/guix.texi:18466
  27503. msgid "Available @code{cups-configuration} fields are:"
  27504. msgstr ""
  27505. #. type: deftypevr
  27506. #: guix-git/doc/guix.texi:18467
  27507. #, no-wrap
  27508. msgid "{@code{cups-configuration} parameter} package cups"
  27509. msgstr ""
  27510. #. type: deftypevr
  27511. #: guix-git/doc/guix.texi:18469 guix-git/doc/guix.texi:19231
  27512. msgid "The CUPS package."
  27513. msgstr ""
  27514. #. type: deftypevr
  27515. #: guix-git/doc/guix.texi:18471
  27516. #, no-wrap
  27517. msgid "{@code{cups-configuration} parameter} package-list extensions (default: @code{(list brlaser cups-filters epson-inkjet-printer-escpr foomatic-filters hplip-minimal splix)})"
  27518. msgstr ""
  27519. #. type: deftypevr
  27520. #: guix-git/doc/guix.texi:18473
  27521. msgid "Drivers and other extensions to the CUPS package."
  27522. msgstr ""
  27523. #. type: deftypevr
  27524. #: guix-git/doc/guix.texi:18475
  27525. #, no-wrap
  27526. msgid "{@code{cups-configuration} parameter} files-configuration files-configuration"
  27527. msgstr ""
  27528. #. type: deftypevr
  27529. #: guix-git/doc/guix.texi:18478
  27530. msgid "Configuration of where to write logs, what directories to use for print spools, and related privileged configuration parameters."
  27531. msgstr ""
  27532. #. type: deftypevr
  27533. #: guix-git/doc/guix.texi:18480
  27534. msgid "Available @code{files-configuration} fields are:"
  27535. msgstr ""
  27536. #. type: deftypevr
  27537. #: guix-git/doc/guix.texi:18481
  27538. #, no-wrap
  27539. msgid "{@code{files-configuration} parameter} log-location access-log"
  27540. msgstr ""
  27541. #. type: deftypevr
  27542. #: guix-git/doc/guix.texi:18489
  27543. msgid "Defines the access log filename. Specifying a blank filename disables access log generation. The value @code{stderr} causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background. The value @code{syslog} causes log entries to be sent to the system log daemon. The server name may be included in filenames using the string @code{%s}, as in @code{/var/log/cups/%s-access_log}."
  27544. msgstr ""
  27545. #. type: deftypevr
  27546. #: guix-git/doc/guix.texi:18491
  27547. msgid "Defaults to @samp{\"/var/log/cups/access_log\"}."
  27548. msgstr ""
  27549. #. type: deftypevr
  27550. #: guix-git/doc/guix.texi:18493
  27551. #, no-wrap
  27552. msgid "{@code{files-configuration} parameter} file-name cache-dir"
  27553. msgstr ""
  27554. #. type: deftypevr
  27555. #: guix-git/doc/guix.texi:18495
  27556. msgid "Where CUPS should cache data."
  27557. msgstr ""
  27558. #. type: deftypevr
  27559. #: guix-git/doc/guix.texi:18497
  27560. msgid "Defaults to @samp{\"/var/cache/cups\"}."
  27561. msgstr ""
  27562. #. type: deftypevr
  27563. #: guix-git/doc/guix.texi:18499
  27564. #, no-wrap
  27565. msgid "{@code{files-configuration} parameter} string config-file-perm"
  27566. msgstr ""
  27567. #. type: deftypevr
  27568. #: guix-git/doc/guix.texi:18502
  27569. msgid "Specifies the permissions for all configuration files that the scheduler writes."
  27570. msgstr ""
  27571. #. type: deftypevr
  27572. #: guix-git/doc/guix.texi:18508
  27573. msgid "Note that the permissions for the printers.conf file are currently masked to only allow access from the scheduler user (typically root). This is done because printer device URIs sometimes contain sensitive authentication information that should not be generally known on the system. There is no way to disable this security feature."
  27574. msgstr ""
  27575. #. type: deftypevr
  27576. #: guix-git/doc/guix.texi:18510
  27577. msgid "Defaults to @samp{\"0640\"}."
  27578. msgstr ""
  27579. #. type: deftypevr
  27580. #: guix-git/doc/guix.texi:18512
  27581. #, no-wrap
  27582. msgid "{@code{files-configuration} parameter} log-location error-log"
  27583. msgstr ""
  27584. #. type: deftypevr
  27585. #: guix-git/doc/guix.texi:18520
  27586. msgid "Defines the error log filename. Specifying a blank filename disables error log generation. The value @code{stderr} causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background. The value @code{syslog} causes log entries to be sent to the system log daemon. The server name may be included in filenames using the string @code{%s}, as in @code{/var/log/cups/%s-error_log}."
  27587. msgstr ""
  27588. #. type: deftypevr
  27589. #: guix-git/doc/guix.texi:18522
  27590. msgid "Defaults to @samp{\"/var/log/cups/error_log\"}."
  27591. msgstr ""
  27592. #. type: deftypevr
  27593. #: guix-git/doc/guix.texi:18524
  27594. #, no-wrap
  27595. msgid "{@code{files-configuration} parameter} string fatal-errors"
  27596. msgstr ""
  27597. #. type: deftypevr
  27598. #: guix-git/doc/guix.texi:18527
  27599. msgid "Specifies which errors are fatal, causing the scheduler to exit. The kind strings are:"
  27600. msgstr ""
  27601. #. type: table
  27602. #: guix-git/doc/guix.texi:18531
  27603. msgid "No errors are fatal."
  27604. msgstr ""
  27605. #. type: table
  27606. #: guix-git/doc/guix.texi:18534
  27607. msgid "All of the errors below are fatal."
  27608. msgstr ""
  27609. #. type: item
  27610. #: guix-git/doc/guix.texi:18535
  27611. #, no-wrap
  27612. msgid "browse"
  27613. msgstr ""
  27614. #. type: table
  27615. #: guix-git/doc/guix.texi:18538
  27616. msgid "Browsing initialization errors are fatal, for example failed connections to the DNS-SD daemon."
  27617. msgstr ""
  27618. #. type: item
  27619. #: guix-git/doc/guix.texi:18539
  27620. #, no-wrap
  27621. msgid "config"
  27622. msgstr ""
  27623. #. type: table
  27624. #: guix-git/doc/guix.texi:18541
  27625. msgid "Configuration file syntax errors are fatal."
  27626. msgstr ""
  27627. #. type: item
  27628. #: guix-git/doc/guix.texi:18542
  27629. #, no-wrap
  27630. msgid "listen"
  27631. msgstr ""
  27632. #. type: table
  27633. #: guix-git/doc/guix.texi:18545
  27634. msgid "Listen or Port errors are fatal, except for IPv6 failures on the loopback or @code{any} addresses."
  27635. msgstr ""
  27636. #. type: item
  27637. #: guix-git/doc/guix.texi:18546
  27638. #, no-wrap
  27639. msgid "log"
  27640. msgstr ""
  27641. #. type: table
  27642. #: guix-git/doc/guix.texi:18548
  27643. msgid "Log file creation or write errors are fatal."
  27644. msgstr ""
  27645. #. type: item
  27646. #: guix-git/doc/guix.texi:18549
  27647. #, no-wrap
  27648. msgid "permissions"
  27649. msgstr ""
  27650. #. type: table
  27651. #: guix-git/doc/guix.texi:18552
  27652. msgid "Bad startup file permissions are fatal, for example shared TLS certificate and key files with world-read permissions."
  27653. msgstr ""
  27654. #. type: deftypevr
  27655. #: guix-git/doc/guix.texi:18555
  27656. msgid "Defaults to @samp{\"all -browse\"}."
  27657. msgstr ""
  27658. #. type: deftypevr
  27659. #: guix-git/doc/guix.texi:18557
  27660. #, no-wrap
  27661. msgid "{@code{files-configuration} parameter} boolean file-device?"
  27662. msgstr ""
  27663. #. type: deftypevr
  27664. #: guix-git/doc/guix.texi:18560
  27665. msgid "Specifies whether the file pseudo-device can be used for new printer queues. The URI @uref{file:///dev/null} is always allowed."
  27666. msgstr ""
  27667. #. type: deftypevr
  27668. #: guix-git/doc/guix.texi:18564
  27669. #, no-wrap
  27670. msgid "{@code{files-configuration} parameter} string group"
  27671. msgstr ""
  27672. #. type: deftypevr
  27673. #: guix-git/doc/guix.texi:18567
  27674. msgid "Specifies the group name or ID that will be used when executing external programs."
  27675. msgstr ""
  27676. #. type: deftypevr
  27677. #: guix-git/doc/guix.texi:18569 guix-git/doc/guix.texi:18649
  27678. msgid "Defaults to @samp{\"lp\"}."
  27679. msgstr ""
  27680. #. type: deftypevr
  27681. #: guix-git/doc/guix.texi:18571
  27682. #, no-wrap
  27683. msgid "{@code{files-configuration} parameter} string log-file-perm"
  27684. msgstr ""
  27685. #. type: deftypevr
  27686. #: guix-git/doc/guix.texi:18573
  27687. msgid "Specifies the permissions for all log files that the scheduler writes."
  27688. msgstr ""
  27689. #. type: deftypevr
  27690. #: guix-git/doc/guix.texi:18575
  27691. msgid "Defaults to @samp{\"0644\"}."
  27692. msgstr ""
  27693. #. type: deftypevr
  27694. #: guix-git/doc/guix.texi:18577
  27695. #, no-wrap
  27696. msgid "{@code{files-configuration} parameter} log-location page-log"
  27697. msgstr ""
  27698. #. type: deftypevr
  27699. #: guix-git/doc/guix.texi:18585
  27700. msgid "Defines the page log filename. Specifying a blank filename disables page log generation. The value @code{stderr} causes log entries to be sent to the standard error file when the scheduler is running in the foreground, or to the system log daemon when run in the background. The value @code{syslog} causes log entries to be sent to the system log daemon. The server name may be included in filenames using the string @code{%s}, as in @code{/var/log/cups/%s-page_log}."
  27701. msgstr ""
  27702. #. type: deftypevr
  27703. #: guix-git/doc/guix.texi:18587
  27704. msgid "Defaults to @samp{\"/var/log/cups/page_log\"}."
  27705. msgstr ""
  27706. #. type: deftypevr
  27707. #: guix-git/doc/guix.texi:18589
  27708. #, no-wrap
  27709. msgid "{@code{files-configuration} parameter} string remote-root"
  27710. msgstr ""
  27711. #. type: deftypevr
  27712. #: guix-git/doc/guix.texi:18592
  27713. msgid "Specifies the username that is associated with unauthenticated accesses by clients claiming to be the root user. The default is @code{remroot}."
  27714. msgstr ""
  27715. #. type: deftypevr
  27716. #: guix-git/doc/guix.texi:18594
  27717. msgid "Defaults to @samp{\"remroot\"}."
  27718. msgstr ""
  27719. #. type: deftypevr
  27720. #: guix-git/doc/guix.texi:18596
  27721. #, no-wrap
  27722. msgid "{@code{files-configuration} parameter} file-name request-root"
  27723. msgstr ""
  27724. #. type: deftypevr
  27725. #: guix-git/doc/guix.texi:18599
  27726. msgid "Specifies the directory that contains print jobs and other HTTP request data."
  27727. msgstr ""
  27728. #. type: deftypevr
  27729. #: guix-git/doc/guix.texi:18601
  27730. msgid "Defaults to @samp{\"/var/spool/cups\"}."
  27731. msgstr ""
  27732. #. type: deftypevr
  27733. #: guix-git/doc/guix.texi:18603
  27734. #, no-wrap
  27735. msgid "{@code{files-configuration} parameter} sandboxing sandboxing"
  27736. msgstr ""
  27737. #. type: deftypevr
  27738. #: guix-git/doc/guix.texi:18608
  27739. msgid "Specifies the level of security sandboxing that is applied to print filters, backends, and other child processes of the scheduler; either @code{relaxed} or @code{strict}. This directive is currently only used/supported on macOS."
  27740. msgstr ""
  27741. #. type: deftypevr
  27742. #: guix-git/doc/guix.texi:18610
  27743. msgid "Defaults to @samp{strict}."
  27744. msgstr ""
  27745. #. type: deftypevr
  27746. #: guix-git/doc/guix.texi:18612
  27747. #, no-wrap
  27748. msgid "{@code{files-configuration} parameter} file-name server-keychain"
  27749. msgstr ""
  27750. #. type: deftypevr
  27751. #: guix-git/doc/guix.texi:18617
  27752. msgid "Specifies the location of TLS certificates and private keys. CUPS will look for public and private keys in this directory: @file{.crt} files for PEM-encoded certificates and corresponding @file{.key} files for PEM-encoded private keys."
  27753. msgstr ""
  27754. #. type: deftypevr
  27755. #: guix-git/doc/guix.texi:18619
  27756. msgid "Defaults to @samp{\"/etc/cups/ssl\"}."
  27757. msgstr ""
  27758. #. type: deftypevr
  27759. #: guix-git/doc/guix.texi:18621
  27760. #, no-wrap
  27761. msgid "{@code{files-configuration} parameter} file-name server-root"
  27762. msgstr ""
  27763. #. type: deftypevr
  27764. #: guix-git/doc/guix.texi:18623
  27765. msgid "Specifies the directory containing the server configuration files."
  27766. msgstr ""
  27767. #. type: deftypevr
  27768. #: guix-git/doc/guix.texi:18625
  27769. msgid "Defaults to @samp{\"/etc/cups\"}."
  27770. msgstr ""
  27771. #. type: deftypevr
  27772. #: guix-git/doc/guix.texi:18627
  27773. #, no-wrap
  27774. msgid "{@code{files-configuration} parameter} boolean sync-on-close?"
  27775. msgstr ""
  27776. #. type: deftypevr
  27777. #: guix-git/doc/guix.texi:18630
  27778. msgid "Specifies whether the scheduler calls fsync(2) after writing configuration or state files."
  27779. msgstr ""
  27780. #. type: deftypevr
  27781. #: guix-git/doc/guix.texi:18634
  27782. #, no-wrap
  27783. msgid "{@code{files-configuration} parameter} space-separated-string-list system-group"
  27784. msgstr ""
  27785. #. type: deftypevr
  27786. #: guix-git/doc/guix.texi:18636
  27787. msgid "Specifies the group(s) to use for @code{@@SYSTEM} group authentication."
  27788. msgstr ""
  27789. #. type: deftypevr
  27790. #: guix-git/doc/guix.texi:18638
  27791. #, no-wrap
  27792. msgid "{@code{files-configuration} parameter} file-name temp-dir"
  27793. msgstr ""
  27794. #. type: deftypevr
  27795. #: guix-git/doc/guix.texi:18640
  27796. msgid "Specifies the directory where temporary files are stored."
  27797. msgstr ""
  27798. #. type: deftypevr
  27799. #: guix-git/doc/guix.texi:18642
  27800. msgid "Defaults to @samp{\"/var/spool/cups/tmp\"}."
  27801. msgstr ""
  27802. #. type: deftypevr
  27803. #: guix-git/doc/guix.texi:18644
  27804. #, no-wrap
  27805. msgid "{@code{files-configuration} parameter} string user"
  27806. msgstr ""
  27807. #. type: deftypevr
  27808. #: guix-git/doc/guix.texi:18647
  27809. msgid "Specifies the user name or ID that is used when running external programs."
  27810. msgstr ""
  27811. #. type: deftypevr
  27812. #: guix-git/doc/guix.texi:18651
  27813. #, no-wrap
  27814. msgid "{@code{files-configuration} parameter} string set-env"
  27815. msgstr ""
  27816. #. type: deftypevr
  27817. #: guix-git/doc/guix.texi:18653
  27818. msgid "Set the specified environment variable to be passed to child processes."
  27819. msgstr ""
  27820. #. type: deftypevr
  27821. #: guix-git/doc/guix.texi:18655
  27822. msgid "Defaults to @samp{\"variable value\"}."
  27823. msgstr ""
  27824. #. type: deftypevr
  27825. #: guix-git/doc/guix.texi:18658
  27826. #, no-wrap
  27827. msgid "{@code{cups-configuration} parameter} access-log-level access-log-level"
  27828. msgstr ""
  27829. #. type: deftypevr
  27830. #: guix-git/doc/guix.texi:18665
  27831. msgid "Specifies the logging level for the AccessLog file. The @code{config} level logs when printers and classes are added, deleted, or modified and when configuration files are accessed or updated. The @code{actions} level logs when print jobs are submitted, held, released, modified, or canceled, and any of the conditions for @code{config}. The @code{all} level logs all requests."
  27832. msgstr ""
  27833. #. type: deftypevr
  27834. #: guix-git/doc/guix.texi:18667
  27835. msgid "Defaults to @samp{actions}."
  27836. msgstr ""
  27837. #. type: deftypevr
  27838. #: guix-git/doc/guix.texi:18669
  27839. #, no-wrap
  27840. msgid "{@code{cups-configuration} parameter} boolean auto-purge-jobs?"
  27841. msgstr ""
  27842. #. type: deftypevr
  27843. #: guix-git/doc/guix.texi:18672
  27844. msgid "Specifies whether to purge job history data automatically when it is no longer required for quotas."
  27845. msgstr ""
  27846. #. type: deftypevr
  27847. #: guix-git/doc/guix.texi:18676
  27848. #, no-wrap
  27849. msgid "{@code{cups-configuration} parameter} comma-separated-string-list browse-dns-sd-sub-types"
  27850. msgstr ""
  27851. #. type: deftypevr
  27852. #: guix-git/doc/guix.texi:18680
  27853. msgid "Specifies a list of DNS-SD sub-types to advertise for each shared printer. For example, @samp{\"_cups\" \"_print\"} will tell network clients that both CUPS sharing and IPP Everywhere are supported."
  27854. msgstr ""
  27855. #. type: deftypevr
  27856. #: guix-git/doc/guix.texi:18682
  27857. msgid "Defaults to @samp{\"_cups\"}."
  27858. msgstr ""
  27859. #. type: deftypevr
  27860. #: guix-git/doc/guix.texi:18684
  27861. #, no-wrap
  27862. msgid "{@code{cups-configuration} parameter} browse-local-protocols browse-local-protocols"
  27863. msgstr ""
  27864. #. type: deftypevr
  27865. #: guix-git/doc/guix.texi:18686
  27866. msgid "Specifies which protocols to use for local printer sharing."
  27867. msgstr ""
  27868. #. type: deftypevr
  27869. #: guix-git/doc/guix.texi:18688
  27870. msgid "Defaults to @samp{dnssd}."
  27871. msgstr ""
  27872. #. type: deftypevr
  27873. #: guix-git/doc/guix.texi:18690
  27874. #, no-wrap
  27875. msgid "{@code{cups-configuration} parameter} boolean browse-web-if?"
  27876. msgstr ""
  27877. #. type: deftypevr
  27878. #: guix-git/doc/guix.texi:18692
  27879. msgid "Specifies whether the CUPS web interface is advertised."
  27880. msgstr ""
  27881. #. type: deftypevr
  27882. #: guix-git/doc/guix.texi:18696
  27883. #, no-wrap
  27884. msgid "{@code{cups-configuration} parameter} boolean browsing?"
  27885. msgstr ""
  27886. #. type: deftypevr
  27887. #: guix-git/doc/guix.texi:18698
  27888. msgid "Specifies whether shared printers are advertised."
  27889. msgstr ""
  27890. #. type: deftypevr
  27891. #: guix-git/doc/guix.texi:18702
  27892. #, no-wrap
  27893. msgid "{@code{cups-configuration} parameter} string classification"
  27894. msgstr ""
  27895. #. type: deftypevr
  27896. #: guix-git/doc/guix.texi:18707
  27897. msgid "Specifies the security classification of the server. Any valid banner name can be used, including @samp{\"classified\"}, @samp{\"confidential\"}, @samp{\"secret\"}, @samp{\"topsecret\"}, and @samp{\"unclassified\"}, or the banner can be omitted to disable secure printing functions."
  27898. msgstr ""
  27899. #. type: deftypevr
  27900. #: guix-git/doc/guix.texi:18709 guix-git/doc/guix.texi:19040
  27901. #: guix-git/doc/guix.texi:21023 guix-git/doc/guix.texi:21035
  27902. #: guix-git/doc/guix.texi:21063 guix-git/doc/guix.texi:21820
  27903. #: guix-git/doc/guix.texi:21834 guix-git/doc/guix.texi:21841
  27904. #: guix-git/doc/guix.texi:21848 guix-git/doc/guix.texi:21878
  27905. #: guix-git/doc/guix.texi:21976 guix-git/doc/guix.texi:24095
  27906. #: guix-git/doc/guix.texi:24121 guix-git/doc/guix.texi:24157
  27907. #: guix-git/doc/guix.texi:24203 guix-git/doc/guix.texi:24222
  27908. #: guix-git/doc/guix.texi:24261 guix-git/doc/guix.texi:24320
  27909. #: guix-git/doc/guix.texi:24330 guix-git/doc/guix.texi:28918
  27910. #: guix-git/doc/guix.texi:28926 guix-git/doc/guix.texi:28934
  27911. #: guix-git/doc/guix.texi:28942 guix-git/doc/guix.texi:29221
  27912. #: guix-git/doc/guix.texi:30523 guix-git/doc/guix.texi:30531
  27913. #: guix-git/doc/guix.texi:30539 guix-git/doc/guix.texi:30647
  27914. #: guix-git/doc/guix.texi:30672 guix-git/doc/guix.texi:30803
  27915. #: guix-git/doc/guix.texi:30811 guix-git/doc/guix.texi:30819
  27916. #: guix-git/doc/guix.texi:30827 guix-git/doc/guix.texi:30835
  27917. #: guix-git/doc/guix.texi:30843 guix-git/doc/guix.texi:30866
  27918. #: guix-git/doc/guix.texi:30874 guix-git/doc/guix.texi:30926
  27919. #: guix-git/doc/guix.texi:30942 guix-git/doc/guix.texi:30950
  27920. #: guix-git/doc/guix.texi:30989 guix-git/doc/guix.texi:31012
  27921. #: guix-git/doc/guix.texi:31034 guix-git/doc/guix.texi:31041
  27922. #: guix-git/doc/guix.texi:31076 guix-git/doc/guix.texi:31084
  27923. #: guix-git/doc/guix.texi:31108 guix-git/doc/guix.texi:31140
  27924. #: guix-git/doc/guix.texi:31169 guix-git/doc/guix.texi:31176
  27925. #: guix-git/doc/guix.texi:31183 guix-git/doc/guix.texi:31191
  27926. #: guix-git/doc/guix.texi:31205 guix-git/doc/guix.texi:31214
  27927. #: guix-git/doc/guix.texi:31224 guix-git/doc/guix.texi:31231
  27928. #: guix-git/doc/guix.texi:31238 guix-git/doc/guix.texi:31245
  27929. #: guix-git/doc/guix.texi:31316 guix-git/doc/guix.texi:31323
  27930. #: guix-git/doc/guix.texi:31330 guix-git/doc/guix.texi:31339
  27931. #: guix-git/doc/guix.texi:31355 guix-git/doc/guix.texi:31362
  27932. #: guix-git/doc/guix.texi:31369 guix-git/doc/guix.texi:31376
  27933. #: guix-git/doc/guix.texi:31384 guix-git/doc/guix.texi:31392
  27934. msgid "Defaults to @samp{\"\"}."
  27935. msgstr ""
  27936. #. type: deftypevr
  27937. #: guix-git/doc/guix.texi:18711
  27938. #, no-wrap
  27939. msgid "{@code{cups-configuration} parameter} boolean classify-override?"
  27940. msgstr ""
  27941. #. type: deftypevr
  27942. #: guix-git/doc/guix.texi:18714
  27943. msgid "Specifies whether users may override the classification (cover page) of individual print jobs using the @code{job-sheets} option."
  27944. msgstr ""
  27945. #. type: deftypevr
  27946. #: guix-git/doc/guix.texi:18718
  27947. #, no-wrap
  27948. msgid "{@code{cups-configuration} parameter} default-auth-type default-auth-type"
  27949. msgstr ""
  27950. #. type: deftypevr
  27951. #: guix-git/doc/guix.texi:18720
  27952. msgid "Specifies the default type of authentication to use."
  27953. msgstr ""
  27954. #. type: deftypevr
  27955. #: guix-git/doc/guix.texi:18722
  27956. msgid "Defaults to @samp{Basic}."
  27957. msgstr ""
  27958. #. type: deftypevr
  27959. #: guix-git/doc/guix.texi:18724
  27960. #, no-wrap
  27961. msgid "{@code{cups-configuration} parameter} default-encryption default-encryption"
  27962. msgstr ""
  27963. #. type: deftypevr
  27964. #: guix-git/doc/guix.texi:18726
  27965. msgid "Specifies whether encryption will be used for authenticated requests."
  27966. msgstr ""
  27967. #. type: deftypevr
  27968. #: guix-git/doc/guix.texi:18728
  27969. msgid "Defaults to @samp{Required}."
  27970. msgstr ""
  27971. #. type: deftypevr
  27972. #: guix-git/doc/guix.texi:18730
  27973. #, no-wrap
  27974. msgid "{@code{cups-configuration} parameter} string default-language"
  27975. msgstr ""
  27976. #. type: deftypevr
  27977. #: guix-git/doc/guix.texi:18732
  27978. msgid "Specifies the default language to use for text and web content."
  27979. msgstr ""
  27980. #. type: deftypevr
  27981. #: guix-git/doc/guix.texi:18734
  27982. msgid "Defaults to @samp{\"en\"}."
  27983. msgstr ""
  27984. #. type: deftypevr
  27985. #: guix-git/doc/guix.texi:18736
  27986. #, no-wrap
  27987. msgid "{@code{cups-configuration} parameter} string default-paper-size"
  27988. msgstr ""
  27989. #. type: deftypevr
  27990. #: guix-git/doc/guix.texi:18741
  27991. msgid "Specifies the default paper size for new print queues. @samp{\"Auto\"} uses a locale-specific default, while @samp{\"None\"} specifies there is no default paper size. Specific size names are typically @samp{\"Letter\"} or @samp{\"A4\"}."
  27992. msgstr ""
  27993. #. type: deftypevr
  27994. #: guix-git/doc/guix.texi:18743
  27995. msgid "Defaults to @samp{\"Auto\"}."
  27996. msgstr ""
  27997. #. type: deftypevr
  27998. #: guix-git/doc/guix.texi:18745
  27999. #, no-wrap
  28000. msgid "{@code{cups-configuration} parameter} string default-policy"
  28001. msgstr ""
  28002. #. type: deftypevr
  28003. #: guix-git/doc/guix.texi:18747
  28004. msgid "Specifies the default access policy to use."
  28005. msgstr ""
  28006. #. type: deftypevr
  28007. #: guix-git/doc/guix.texi:18749
  28008. msgid "Defaults to @samp{\"default\"}."
  28009. msgstr ""
  28010. #. type: deftypevr
  28011. #: guix-git/doc/guix.texi:18751
  28012. #, no-wrap
  28013. msgid "{@code{cups-configuration} parameter} boolean default-shared?"
  28014. msgstr ""
  28015. #. type: deftypevr
  28016. #: guix-git/doc/guix.texi:18753
  28017. msgid "Specifies whether local printers are shared by default."
  28018. msgstr ""
  28019. #. type: deftypevr
  28020. #: guix-git/doc/guix.texi:18755 guix-git/doc/guix.texi:18835
  28021. #: guix-git/doc/guix.texi:19125 guix-git/doc/guix.texi:21910
  28022. #: guix-git/doc/guix.texi:21961 guix-git/doc/guix.texi:21968
  28023. #: guix-git/doc/guix.texi:23250 guix-git/doc/guix.texi:23438
  28024. #: guix-git/doc/guix.texi:23555 guix-git/doc/guix.texi:23591
  28025. #: guix-git/doc/guix.texi:23642 guix-git/doc/guix.texi:23661
  28026. #: guix-git/doc/guix.texi:23671 guix-git/doc/guix.texi:23681
  28027. #: guix-git/doc/guix.texi:23740 guix-git/doc/guix.texi:23762
  28028. #: guix-git/doc/guix.texi:23787 guix-git/doc/guix.texi:23813
  28029. #: guix-git/doc/guix.texi:23831 guix-git/doc/guix.texi:27019
  28030. #: guix-git/doc/guix.texi:27047 guix-git/doc/guix.texi:27183
  28031. #: guix-git/doc/guix.texi:27190 guix-git/doc/guix.texi:27198
  28032. #: guix-git/doc/guix.texi:27235 guix-git/doc/guix.texi:27249
  28033. #: guix-git/doc/guix.texi:27338 guix-git/doc/guix.texi:27345
  28034. #: guix-git/doc/guix.texi:27353 guix-git/doc/guix.texi:28126
  28035. #: guix-git/doc/guix.texi:28266 guix-git/doc/guix.texi:28452
  28036. #: guix-git/doc/guix.texi:28459 guix-git/doc/guix.texi:28481
  28037. #: guix-git/doc/guix.texi:28520 guix-git/doc/guix.texi:28540
  28038. #: guix-git/doc/guix.texi:28554 guix-git/doc/guix.texi:28767
  28039. #: guix-git/doc/guix.texi:30625 guix-git/doc/guix.texi:30713
  28040. #: guix-git/doc/guix.texi:30729 guix-git/doc/guix.texi:30779
  28041. msgid "Defaults to @samp{#t}."
  28042. msgstr ""
  28043. #. type: deftypevr
  28044. #: guix-git/doc/guix.texi:18757
  28045. #, no-wrap
  28046. msgid "{@code{cups-configuration} parameter} non-negative-integer dirty-clean-interval"
  28047. msgstr ""
  28048. #. type: deftypevr
  28049. #: guix-git/doc/guix.texi:18761
  28050. msgid "Specifies the delay for updating of configuration and state files, in seconds. A value of 0 causes the update to happen as soon as possible, typically within a few milliseconds."
  28051. msgstr ""
  28052. #. type: deftypevr
  28053. #: guix-git/doc/guix.texi:18763 guix-git/doc/guix.texi:18811
  28054. #: guix-git/doc/guix.texi:18820 guix-git/doc/guix.texi:19132
  28055. #: guix-git/doc/guix.texi:23600 guix-git/doc/guix.texi:23633
  28056. msgid "Defaults to @samp{30}."
  28057. msgstr ""
  28058. #. type: deftypevr
  28059. #: guix-git/doc/guix.texi:18765
  28060. #, no-wrap
  28061. msgid "{@code{cups-configuration} parameter} error-policy error-policy"
  28062. msgstr ""
  28063. #. type: deftypevr
  28064. #: guix-git/doc/guix.texi:18771
  28065. msgid "Specifies what to do when an error occurs. Possible values are @code{abort-job}, which will discard the failed print job; @code{retry-job}, which will retry the job at a later time; @code{retry-current-job}, which retries the failed job immediately; and @code{stop-printer}, which stops the printer."
  28066. msgstr ""
  28067. #. type: deftypevr
  28068. #: guix-git/doc/guix.texi:18773
  28069. msgid "Defaults to @samp{stop-printer}."
  28070. msgstr ""
  28071. #. type: deftypevr
  28072. #: guix-git/doc/guix.texi:18775
  28073. #, no-wrap
  28074. msgid "{@code{cups-configuration} parameter} non-negative-integer filter-limit"
  28075. msgstr ""
  28076. #. type: deftypevr
  28077. #: guix-git/doc/guix.texi:18783
  28078. msgid "Specifies the maximum cost of filters that are run concurrently, which can be used to minimize disk, memory, and CPU resource problems. A limit of 0 disables filter limiting. An average print to a non-PostScript printer needs a filter limit of about 200. A PostScript printer needs about half that (100). Setting the limit below these thresholds will effectively limit the scheduler to printing a single job at any time."
  28079. msgstr ""
  28080. #. type: deftypevr
  28081. #: guix-git/doc/guix.texi:18785 guix-git/doc/guix.texi:18793
  28082. #: guix-git/doc/guix.texi:18842 guix-git/doc/guix.texi:18958
  28083. #: guix-git/doc/guix.texi:18972 guix-git/doc/guix.texi:18979
  28084. #: guix-git/doc/guix.texi:20465 guix-git/doc/guix.texi:20481
  28085. #: guix-git/doc/guix.texi:21138 guix-git/doc/guix.texi:21150
  28086. #: guix-git/doc/guix.texi:21929 guix-git/doc/guix.texi:21938
  28087. #: guix-git/doc/guix.texi:21946 guix-git/doc/guix.texi:21954
  28088. #: guix-git/doc/guix.texi:28142 guix-git/doc/guix.texi:28467
  28089. #: guix-git/doc/guix.texi:30618 guix-git/doc/guix.texi:30918
  28090. #: guix-git/doc/guix.texi:31092
  28091. msgid "Defaults to @samp{0}."
  28092. msgstr ""
  28093. #. type: deftypevr
  28094. #: guix-git/doc/guix.texi:18787
  28095. #, no-wrap
  28096. msgid "{@code{cups-configuration} parameter} non-negative-integer filter-nice"
  28097. msgstr ""
  28098. #. type: deftypevr
  28099. #: guix-git/doc/guix.texi:18791
  28100. msgid "Specifies the scheduling priority of filters that are run to print a job. The nice value ranges from 0, the highest priority, to 19, the lowest priority."
  28101. msgstr ""
  28102. #. type: deftypevr
  28103. #: guix-git/doc/guix.texi:18795
  28104. #, no-wrap
  28105. msgid "{@code{cups-configuration} parameter} host-name-lookups host-name-lookups"
  28106. msgstr ""
  28107. #. type: deftypevr
  28108. #: guix-git/doc/guix.texi:18802
  28109. msgid "Specifies whether to do reverse lookups on connecting clients. The @code{double} setting causes @code{cupsd} to verify that the hostname resolved from the address matches one of the addresses returned for that hostname. Double lookups also prevent clients with unregistered addresses from connecting to your server. Only set this option to @code{#t} or @code{double} if absolutely required."
  28110. msgstr ""
  28111. #. type: deftypevr
  28112. #: guix-git/doc/guix.texi:18806
  28113. #, no-wrap
  28114. msgid "{@code{cups-configuration} parameter} non-negative-integer job-kill-delay"
  28115. msgstr ""
  28116. #. type: deftypevr
  28117. #: guix-git/doc/guix.texi:18809
  28118. msgid "Specifies the number of seconds to wait before killing the filters and backend associated with a canceled or held job."
  28119. msgstr ""
  28120. #. type: deftypevr
  28121. #: guix-git/doc/guix.texi:18813
  28122. #, no-wrap
  28123. msgid "{@code{cups-configuration} parameter} non-negative-integer job-retry-interval"
  28124. msgstr ""
  28125. #. type: deftypevr
  28126. #: guix-git/doc/guix.texi:18818
  28127. msgid "Specifies the interval between retries of jobs in seconds. This is typically used for fax queues but can also be used with normal print queues whose error policy is @code{retry-job} or @code{retry-current-job}."
  28128. msgstr ""
  28129. #. type: deftypevr
  28130. #: guix-git/doc/guix.texi:18822
  28131. #, no-wrap
  28132. msgid "{@code{cups-configuration} parameter} non-negative-integer job-retry-limit"
  28133. msgstr ""
  28134. #. type: deftypevr
  28135. #: guix-git/doc/guix.texi:18827
  28136. msgid "Specifies the number of retries that are done for jobs. This is typically used for fax queues but can also be used with normal print queues whose error policy is @code{retry-job} or @code{retry-current-job}."
  28137. msgstr ""
  28138. #. type: deftypevr
  28139. #: guix-git/doc/guix.texi:18829 guix-git/doc/guix.texi:23564
  28140. #: guix-git/doc/guix.texi:29019 guix-git/doc/guix.texi:29039
  28141. #: guix-git/doc/guix.texi:29055 guix-git/doc/guix.texi:29069
  28142. #: guix-git/doc/guix.texi:29076 guix-git/doc/guix.texi:29083
  28143. #: guix-git/doc/guix.texi:29090 guix-git/doc/guix.texi:29250
  28144. #: guix-git/doc/guix.texi:29266 guix-git/doc/guix.texi:29273
  28145. #: guix-git/doc/guix.texi:29280 guix-git/doc/guix.texi:29291
  28146. #: guix-git/doc/guix.texi:30570 guix-git/doc/guix.texi:30578
  28147. #: guix-git/doc/guix.texi:30586 guix-git/doc/guix.texi:30610
  28148. msgid "Defaults to @samp{5}."
  28149. msgstr ""
  28150. #. type: deftypevr
  28151. #: guix-git/doc/guix.texi:18831
  28152. #, no-wrap
  28153. msgid "{@code{cups-configuration} parameter} boolean keep-alive?"
  28154. msgstr ""
  28155. #. type: deftypevr
  28156. #: guix-git/doc/guix.texi:18833
  28157. msgid "Specifies whether to support HTTP keep-alive connections."
  28158. msgstr ""
  28159. #. type: deftypevr
  28160. #: guix-git/doc/guix.texi:18837
  28161. #, no-wrap
  28162. msgid "{@code{cups-configuration} parameter} non-negative-integer limit-request-body"
  28163. msgstr ""
  28164. #. type: deftypevr
  28165. #: guix-git/doc/guix.texi:18840
  28166. msgid "Specifies the maximum size of print files, IPP requests, and HTML form data. A limit of 0 disables the limit check."
  28167. msgstr ""
  28168. #. type: deftypevr
  28169. #: guix-git/doc/guix.texi:18844
  28170. #, no-wrap
  28171. msgid "{@code{cups-configuration} parameter} multiline-string-list listen"
  28172. msgstr ""
  28173. #. type: deftypevr
  28174. #: guix-git/doc/guix.texi:18851
  28175. msgid "Listens on the specified interfaces for connections. Valid values are of the form @var{address}:@var{port}, where @var{address} is either an IPv6 address enclosed in brackets, an IPv4 address, or @code{*} to indicate all addresses. Values can also be file names of local UNIX domain sockets. The Listen directive is similar to the Port directive but allows you to restrict access to specific interfaces or networks."
  28176. msgstr ""
  28177. #. type: deftypevr
  28178. #: guix-git/doc/guix.texi:18853
  28179. #, no-wrap
  28180. msgid "{@code{cups-configuration} parameter} non-negative-integer listen-back-log"
  28181. msgstr ""
  28182. #. type: deftypevr
  28183. #: guix-git/doc/guix.texi:18860
  28184. msgid "Specifies the number of pending connections that will be allowed. This normally only affects very busy servers that have reached the MaxClients limit, but can also be triggered by large numbers of simultaneous connections. When the limit is reached, the operating system will refuse additional connections until the scheduler can accept the pending ones."
  28185. msgstr ""
  28186. #. type: deftypevr
  28187. #: guix-git/doc/guix.texi:18862
  28188. msgid "Defaults to @samp{128}."
  28189. msgstr ""
  28190. #. type: deftypevr
  28191. #: guix-git/doc/guix.texi:18864
  28192. #, no-wrap
  28193. msgid "{@code{cups-configuration} parameter} location-access-control-list location-access-controls"
  28194. msgstr ""
  28195. #. type: deftypevr
  28196. #: guix-git/doc/guix.texi:18866
  28197. msgid "Specifies a set of additional access controls."
  28198. msgstr ""
  28199. #. type: deftypevr
  28200. #: guix-git/doc/guix.texi:18868
  28201. msgid "Available @code{location-access-controls} fields are:"
  28202. msgstr ""
  28203. #. type: deftypevr
  28204. #: guix-git/doc/guix.texi:18869
  28205. #, no-wrap
  28206. msgid "{@code{location-access-controls} parameter} file-name path"
  28207. msgstr ""
  28208. #. type: deftypevr
  28209. #: guix-git/doc/guix.texi:18871
  28210. msgid "Specifies the URI path to which the access control applies."
  28211. msgstr ""
  28212. #. type: deftypevr
  28213. #: guix-git/doc/guix.texi:18873
  28214. #, no-wrap
  28215. msgid "{@code{location-access-controls} parameter} access-control-list access-controls"
  28216. msgstr ""
  28217. #. type: deftypevr
  28218. #: guix-git/doc/guix.texi:18876
  28219. msgid "Access controls for all access to this path, in the same format as the @code{access-controls} of @code{operation-access-control}."
  28220. msgstr ""
  28221. #. type: deftypevr
  28222. #: guix-git/doc/guix.texi:18878 guix-git/doc/guix.texi:18884
  28223. #: guix-git/doc/guix.texi:18898 guix-git/doc/guix.texi:18905
  28224. #: guix-git/doc/guix.texi:19047 guix-git/doc/guix.texi:19106
  28225. #: guix-git/doc/guix.texi:19184 guix-git/doc/guix.texi:19198
  28226. #: guix-git/doc/guix.texi:20345 guix-git/doc/guix.texi:20354
  28227. #: guix-git/doc/guix.texi:21624 guix-git/doc/guix.texi:21827
  28228. #: guix-git/doc/guix.texi:21855 guix-git/doc/guix.texi:21885
  28229. #: guix-git/doc/guix.texi:22000 guix-git/doc/guix.texi:22013
  28230. #: guix-git/doc/guix.texi:22020 guix-git/doc/guix.texi:23770
  28231. #: guix-git/doc/guix.texi:24165 guix-git/doc/guix.texi:24269
  28232. #: guix-git/doc/guix.texi:24696 guix-git/doc/guix.texi:24704
  28233. #: guix-git/doc/guix.texi:24949 guix-git/doc/guix.texi:27078
  28234. #: guix-git/doc/guix.texi:27256 guix-git/doc/guix.texi:27455
  28235. #: guix-git/doc/guix.texi:28910 guix-git/doc/guix.texi:28970
  28236. #: guix-git/doc/guix.texi:28978 guix-git/doc/guix.texi:30633
  28237. #: guix-git/doc/guix.texi:30640 guix-git/doc/guix.texi:30982
  28238. #: guix-git/doc/guix.texi:31060 guix-git/doc/guix.texi:31154
  28239. #: guix-git/doc/guix.texi:31162 guix-git/doc/guix.texi:31198
  28240. #: guix-git/doc/guix.texi:31348 guix-git/doc/guix.texi:31399
  28241. #: guix-git/doc/guix.texi:31408
  28242. msgid "Defaults to @samp{()}."
  28243. msgstr ""
  28244. #. type: deftypevr
  28245. #: guix-git/doc/guix.texi:18880
  28246. #, no-wrap
  28247. msgid "{@code{location-access-controls} parameter} method-access-control-list method-access-controls"
  28248. msgstr ""
  28249. #. type: deftypevr
  28250. #: guix-git/doc/guix.texi:18882
  28251. msgid "Access controls for method-specific access to this path."
  28252. msgstr ""
  28253. #. type: deftypevr
  28254. #: guix-git/doc/guix.texi:18886
  28255. msgid "Available @code{method-access-controls} fields are:"
  28256. msgstr ""
  28257. #. type: deftypevr
  28258. #: guix-git/doc/guix.texi:18887
  28259. #, no-wrap
  28260. msgid "{@code{method-access-controls} parameter} boolean reverse?"
  28261. msgstr ""
  28262. #. type: deftypevr
  28263. #: guix-git/doc/guix.texi:18890
  28264. msgid "If @code{#t}, apply access controls to all methods except the listed methods. Otherwise apply to only the listed methods."
  28265. msgstr ""
  28266. #. type: deftypevr
  28267. #: guix-git/doc/guix.texi:18894
  28268. #, no-wrap
  28269. msgid "{@code{method-access-controls} parameter} method-list methods"
  28270. msgstr ""
  28271. #. type: deftypevr
  28272. #: guix-git/doc/guix.texi:18896
  28273. msgid "Methods to which this access control applies."
  28274. msgstr ""
  28275. #. type: deftypevr
  28276. #: guix-git/doc/guix.texi:18900
  28277. #, no-wrap
  28278. msgid "{@code{method-access-controls} parameter} access-control-list access-controls"
  28279. msgstr ""
  28280. #. type: deftypevr
  28281. #: guix-git/doc/guix.texi:18903
  28282. msgid "Access control directives, as a list of strings. Each string should be one directive, such as @samp{\"Order allow,deny\"}."
  28283. msgstr ""
  28284. #. type: deftypevr
  28285. #: guix-git/doc/guix.texi:18909
  28286. #, no-wrap
  28287. msgid "{@code{cups-configuration} parameter} non-negative-integer log-debug-history"
  28288. msgstr ""
  28289. #. type: deftypevr
  28290. #: guix-git/doc/guix.texi:18913
  28291. msgid "Specifies the number of debugging messages that are retained for logging if an error occurs in a print job. Debug messages are logged regardless of the LogLevel setting."
  28292. msgstr ""
  28293. #. type: deftypevr
  28294. #: guix-git/doc/guix.texi:18915 guix-git/doc/guix.texi:18936
  28295. #: guix-git/doc/guix.texi:18943 guix-git/doc/guix.texi:21384
  28296. #: guix-git/doc/guix.texi:23302 guix-git/doc/guix.texi:23317
  28297. #: guix-git/doc/guix.texi:27440
  28298. msgid "Defaults to @samp{100}."
  28299. msgstr ""
  28300. #. type: deftypevr
  28301. #: guix-git/doc/guix.texi:18917
  28302. #, no-wrap
  28303. msgid "{@code{cups-configuration} parameter} log-level log-level"
  28304. msgstr ""
  28305. #. type: deftypevr
  28306. #: guix-git/doc/guix.texi:18920
  28307. msgid "Specifies the level of logging for the ErrorLog file. The value @code{none} stops all logging while @code{debug2} logs everything."
  28308. msgstr ""
  28309. #. type: deftypevr
  28310. #: guix-git/doc/guix.texi:18922 guix-git/doc/guix.texi:23779
  28311. msgid "Defaults to @samp{info}."
  28312. msgstr ""
  28313. #. type: deftypevr
  28314. #: guix-git/doc/guix.texi:18924
  28315. #, no-wrap
  28316. msgid "{@code{cups-configuration} parameter} log-time-format log-time-format"
  28317. msgstr ""
  28318. #. type: deftypevr
  28319. #: guix-git/doc/guix.texi:18927
  28320. msgid "Specifies the format of the date and time in the log files. The value @code{standard} logs whole seconds while @code{usecs} logs microseconds."
  28321. msgstr ""
  28322. #. type: deftypevr
  28323. #: guix-git/doc/guix.texi:18929
  28324. msgid "Defaults to @samp{standard}."
  28325. msgstr ""
  28326. #. type: deftypevr
  28327. #: guix-git/doc/guix.texi:18931
  28328. #, no-wrap
  28329. msgid "{@code{cups-configuration} parameter} non-negative-integer max-clients"
  28330. msgstr ""
  28331. #. type: deftypevr
  28332. #: guix-git/doc/guix.texi:18934
  28333. msgid "Specifies the maximum number of simultaneous clients that are allowed by the scheduler."
  28334. msgstr ""
  28335. #. type: deftypevr
  28336. #: guix-git/doc/guix.texi:18938
  28337. #, no-wrap
  28338. msgid "{@code{cups-configuration} parameter} non-negative-integer max-clients-per-host"
  28339. msgstr ""
  28340. #. type: deftypevr
  28341. #: guix-git/doc/guix.texi:18941
  28342. msgid "Specifies the maximum number of simultaneous clients that are allowed from a single address."
  28343. msgstr ""
  28344. #. type: deftypevr
  28345. #: guix-git/doc/guix.texi:18945
  28346. #, no-wrap
  28347. msgid "{@code{cups-configuration} parameter} non-negative-integer max-copies"
  28348. msgstr ""
  28349. #. type: deftypevr
  28350. #: guix-git/doc/guix.texi:18948
  28351. msgid "Specifies the maximum number of copies that a user can print of each job."
  28352. msgstr ""
  28353. #. type: deftypevr
  28354. #: guix-git/doc/guix.texi:18950
  28355. msgid "Defaults to @samp{9999}."
  28356. msgstr ""
  28357. #. type: deftypevr
  28358. #: guix-git/doc/guix.texi:18952
  28359. #, no-wrap
  28360. msgid "{@code{cups-configuration} parameter} non-negative-integer max-hold-time"
  28361. msgstr ""
  28362. #. type: deftypevr
  28363. #: guix-git/doc/guix.texi:18956
  28364. msgid "Specifies the maximum time a job may remain in the @code{indefinite} hold state before it is canceled. A value of 0 disables cancellation of held jobs."
  28365. msgstr ""
  28366. #. type: deftypevr
  28367. #: guix-git/doc/guix.texi:18960
  28368. #, no-wrap
  28369. msgid "{@code{cups-configuration} parameter} non-negative-integer max-jobs"
  28370. msgstr ""
  28371. #. type: deftypevr
  28372. #: guix-git/doc/guix.texi:18963
  28373. msgid "Specifies the maximum number of simultaneous jobs that are allowed. Set to 0 to allow an unlimited number of jobs."
  28374. msgstr ""
  28375. #. type: deftypevr
  28376. #: guix-git/doc/guix.texi:18965
  28377. msgid "Defaults to @samp{500}."
  28378. msgstr ""
  28379. #. type: deftypevr
  28380. #: guix-git/doc/guix.texi:18967
  28381. #, no-wrap
  28382. msgid "{@code{cups-configuration} parameter} non-negative-integer max-jobs-per-printer"
  28383. msgstr ""
  28384. #. type: deftypevr
  28385. #: guix-git/doc/guix.texi:18970
  28386. msgid "Specifies the maximum number of simultaneous jobs that are allowed per printer. A value of 0 allows up to MaxJobs jobs per printer."
  28387. msgstr ""
  28388. #. type: deftypevr
  28389. #: guix-git/doc/guix.texi:18974
  28390. #, no-wrap
  28391. msgid "{@code{cups-configuration} parameter} non-negative-integer max-jobs-per-user"
  28392. msgstr ""
  28393. #. type: deftypevr
  28394. #: guix-git/doc/guix.texi:18977
  28395. msgid "Specifies the maximum number of simultaneous jobs that are allowed per user. A value of 0 allows up to MaxJobs jobs per user."
  28396. msgstr ""
  28397. #. type: deftypevr
  28398. #: guix-git/doc/guix.texi:18981
  28399. #, no-wrap
  28400. msgid "{@code{cups-configuration} parameter} non-negative-integer max-job-time"
  28401. msgstr ""
  28402. #. type: deftypevr
  28403. #: guix-git/doc/guix.texi:18984
  28404. msgid "Specifies the maximum time a job may take to print before it is canceled, in seconds. Set to 0 to disable cancellation of ``stuck'' jobs."
  28405. msgstr ""
  28406. #. type: deftypevr
  28407. #: guix-git/doc/guix.texi:18986
  28408. msgid "Defaults to @samp{10800}."
  28409. msgstr ""
  28410. #. type: deftypevr
  28411. #: guix-git/doc/guix.texi:18988
  28412. #, no-wrap
  28413. msgid "{@code{cups-configuration} parameter} non-negative-integer max-log-size"
  28414. msgstr ""
  28415. #. type: deftypevr
  28416. #: guix-git/doc/guix.texi:18991
  28417. msgid "Specifies the maximum size of the log files before they are rotated, in bytes. The value 0 disables log rotation."
  28418. msgstr ""
  28419. #. type: deftypevr
  28420. #: guix-git/doc/guix.texi:18993
  28421. msgid "Defaults to @samp{1048576}."
  28422. msgstr ""
  28423. #. type: deftypevr
  28424. #: guix-git/doc/guix.texi:18995
  28425. #, no-wrap
  28426. msgid "{@code{cups-configuration} parameter} non-negative-integer multiple-operation-timeout"
  28427. msgstr ""
  28428. #. type: deftypevr
  28429. #: guix-git/doc/guix.texi:18998
  28430. msgid "Specifies the maximum amount of time to allow between files in a multiple file print job, in seconds."
  28431. msgstr ""
  28432. #. type: deftypevr
  28433. #: guix-git/doc/guix.texi:19000 guix-git/doc/guix.texi:19211
  28434. #: guix-git/doc/guix.texi:27012
  28435. msgid "Defaults to @samp{300}."
  28436. msgstr ""
  28437. #. type: deftypevr
  28438. #: guix-git/doc/guix.texi:19002
  28439. #, no-wrap
  28440. msgid "{@code{cups-configuration} parameter} string page-log-format"
  28441. msgstr ""
  28442. #. type: deftypevr
  28443. #: guix-git/doc/guix.texi:19007
  28444. msgid "Specifies the format of PageLog lines. Sequences beginning with percent (@samp{%}) characters are replaced with the corresponding information, while all other characters are copied literally. The following percent sequences are recognized:"
  28445. msgstr ""
  28446. #. type: item
  28447. #: guix-git/doc/guix.texi:19009
  28448. #, no-wrap
  28449. msgid "%%"
  28450. msgstr ""
  28451. #. type: table
  28452. #: guix-git/doc/guix.texi:19011
  28453. msgid "insert a single percent character"
  28454. msgstr ""
  28455. #. type: item
  28456. #: guix-git/doc/guix.texi:19012
  28457. #, no-wrap
  28458. msgid "%@{name@}"
  28459. msgstr ""
  28460. #. type: table
  28461. #: guix-git/doc/guix.texi:19014
  28462. msgid "insert the value of the specified IPP attribute"
  28463. msgstr ""
  28464. #. type: item
  28465. #: guix-git/doc/guix.texi:19015
  28466. #, no-wrap
  28467. msgid "%C"
  28468. msgstr ""
  28469. #. type: table
  28470. #: guix-git/doc/guix.texi:19017
  28471. msgid "insert the number of copies for the current page"
  28472. msgstr ""
  28473. #. type: item
  28474. #: guix-git/doc/guix.texi:19018
  28475. #, no-wrap
  28476. msgid "%P"
  28477. msgstr ""
  28478. #. type: table
  28479. #: guix-git/doc/guix.texi:19020
  28480. msgid "insert the current page number"
  28481. msgstr ""
  28482. #. type: item
  28483. #: guix-git/doc/guix.texi:19021
  28484. #, no-wrap
  28485. msgid "%T"
  28486. msgstr ""
  28487. #. type: table
  28488. #: guix-git/doc/guix.texi:19023
  28489. msgid "insert the current date and time in common log format"
  28490. msgstr ""
  28491. #. type: item
  28492. #: guix-git/doc/guix.texi:19024
  28493. #, no-wrap
  28494. msgid "%j"
  28495. msgstr ""
  28496. #. type: table
  28497. #: guix-git/doc/guix.texi:19026
  28498. msgid "insert the job ID"
  28499. msgstr ""
  28500. #. type: item
  28501. #: guix-git/doc/guix.texi:19027 guix-git/doc/guix.texi:20983
  28502. #, no-wrap
  28503. msgid "%p"
  28504. msgstr ""
  28505. #. type: table
  28506. #: guix-git/doc/guix.texi:19029
  28507. msgid "insert the printer name"
  28508. msgstr ""
  28509. #. type: item
  28510. #: guix-git/doc/guix.texi:19030 guix-git/doc/guix.texi:21006
  28511. #, no-wrap
  28512. msgid "%u"
  28513. msgstr ""
  28514. #. type: table
  28515. #: guix-git/doc/guix.texi:19032
  28516. msgid "insert the username"
  28517. msgstr ""
  28518. #. type: deftypevr
  28519. #: guix-git/doc/guix.texi:19038
  28520. msgid "A value of the empty string disables page logging. The string @code{%p %u %j %T %P %C %@{job-billing@} %@{job-originating-host-name@} %@{job-name@} %@{media@} %@{sides@}} creates a page log with the standard items."
  28521. msgstr ""
  28522. #. type: deftypevr
  28523. #: guix-git/doc/guix.texi:19042
  28524. #, no-wrap
  28525. msgid "{@code{cups-configuration} parameter} environment-variables environment-variables"
  28526. msgstr ""
  28527. #. type: deftypevr
  28528. #: guix-git/doc/guix.texi:19045
  28529. msgid "Passes the specified environment variable(s) to child processes; a list of strings."
  28530. msgstr ""
  28531. #. type: deftypevr
  28532. #: guix-git/doc/guix.texi:19049
  28533. #, no-wrap
  28534. msgid "{@code{cups-configuration} parameter} policy-configuration-list policies"
  28535. msgstr ""
  28536. #. type: deftypevr
  28537. #: guix-git/doc/guix.texi:19051
  28538. msgid "Specifies named access control policies."
  28539. msgstr ""
  28540. #. type: deftypevr
  28541. #: guix-git/doc/guix.texi:19053
  28542. msgid "Available @code{policy-configuration} fields are:"
  28543. msgstr ""
  28544. #. type: deftypevr
  28545. #: guix-git/doc/guix.texi:19054
  28546. #, no-wrap
  28547. msgid "{@code{policy-configuration} parameter} string name"
  28548. msgstr ""
  28549. #. type: deftypevr
  28550. #: guix-git/doc/guix.texi:19056
  28551. msgid "Name of the policy."
  28552. msgstr ""
  28553. #. type: deftypevr
  28554. #: guix-git/doc/guix.texi:19058
  28555. #, no-wrap
  28556. msgid "{@code{policy-configuration} parameter} string job-private-access"
  28557. msgstr ""
  28558. #. type: deftypevr
  28559. #: guix-git/doc/guix.texi:19068
  28560. msgid "Specifies an access list for a job's private values. @code{@@ACL} maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values. @code{@@OWNER} maps to the job's owner. @code{@@SYSTEM} maps to the groups listed for the @code{system-group} field of the @code{files-configuration}, which is reified into the @code{cups-files.conf(5)} file. Other possible elements of the access list include specific user names, and @code{@@@var{group}} to indicate members of a specific group. The access list may also be simply @code{all} or @code{default}."
  28561. msgstr ""
  28562. #. type: deftypevr
  28563. #: guix-git/doc/guix.texi:19070 guix-git/doc/guix.texi:19092
  28564. msgid "Defaults to @samp{\"@@OWNER @@SYSTEM\"}."
  28565. msgstr ""
  28566. #. type: deftypevr
  28567. #: guix-git/doc/guix.texi:19072
  28568. #, no-wrap
  28569. msgid "{@code{policy-configuration} parameter} string job-private-values"
  28570. msgstr ""
  28571. #. type: deftypevr
  28572. #: guix-git/doc/guix.texi:19075 guix-git/doc/guix.texi:19097
  28573. msgid "Specifies the list of job values to make private, or @code{all}, @code{default}, or @code{none}."
  28574. msgstr ""
  28575. #. type: deftypevr
  28576. #: guix-git/doc/guix.texi:19078
  28577. msgid "Defaults to @samp{\"job-name job-originating-host-name job-originating-user-name phone\"}."
  28578. msgstr ""
  28579. #. type: deftypevr
  28580. #: guix-git/doc/guix.texi:19080
  28581. #, no-wrap
  28582. msgid "{@code{policy-configuration} parameter} string subscription-private-access"
  28583. msgstr ""
  28584. #. type: deftypevr
  28585. #: guix-git/doc/guix.texi:19090
  28586. msgid "Specifies an access list for a subscription's private values. @code{@@ACL} maps to the printer's requesting-user-name-allowed or requesting-user-name-denied values. @code{@@OWNER} maps to the job's owner. @code{@@SYSTEM} maps to the groups listed for the @code{system-group} field of the @code{files-configuration}, which is reified into the @code{cups-files.conf(5)} file. Other possible elements of the access list include specific user names, and @code{@@@var{group}} to indicate members of a specific group. The access list may also be simply @code{all} or @code{default}."
  28587. msgstr ""
  28588. #. type: deftypevr
  28589. #: guix-git/doc/guix.texi:19094
  28590. #, no-wrap
  28591. msgid "{@code{policy-configuration} parameter} string subscription-private-values"
  28592. msgstr ""
  28593. #. type: deftypevr
  28594. #: guix-git/doc/guix.texi:19100
  28595. msgid "Defaults to @samp{\"notify-events notify-pull-method notify-recipient-uri notify-subscriber-user-name notify-user-data\"}."
  28596. msgstr ""
  28597. #. type: deftypevr
  28598. #: guix-git/doc/guix.texi:19102
  28599. #, no-wrap
  28600. msgid "{@code{policy-configuration} parameter} operation-access-control-list access-controls"
  28601. msgstr ""
  28602. #. type: deftypevr
  28603. #: guix-git/doc/guix.texi:19104
  28604. msgid "Access control by IPP operation."
  28605. msgstr ""
  28606. #. type: deftypevr
  28607. #: guix-git/doc/guix.texi:19109
  28608. #, no-wrap
  28609. msgid "{@code{cups-configuration} parameter} boolean-or-non-negative-integer preserve-job-files"
  28610. msgstr ""
  28611. #. type: deftypevr
  28612. #: guix-git/doc/guix.texi:19114
  28613. msgid "Specifies whether job files (documents) are preserved after a job is printed. If a numeric value is specified, job files are preserved for the indicated number of seconds after printing. Otherwise a boolean value applies indefinitely."
  28614. msgstr ""
  28615. #. type: deftypevr
  28616. #: guix-git/doc/guix.texi:19116
  28617. msgid "Defaults to @samp{86400}."
  28618. msgstr ""
  28619. #. type: deftypevr
  28620. #: guix-git/doc/guix.texi:19118
  28621. #, no-wrap
  28622. msgid "{@code{cups-configuration} parameter} boolean-or-non-negative-integer preserve-job-history"
  28623. msgstr ""
  28624. #. type: deftypevr
  28625. #: guix-git/doc/guix.texi:19123
  28626. msgid "Specifies whether the job history is preserved after a job is printed. If a numeric value is specified, the job history is preserved for the indicated number of seconds after printing. If @code{#t}, the job history is preserved until the MaxJobs limit is reached."
  28627. msgstr ""
  28628. #. type: deftypevr
  28629. #: guix-git/doc/guix.texi:19127
  28630. #, no-wrap
  28631. msgid "{@code{cups-configuration} parameter} non-negative-integer reload-timeout"
  28632. msgstr ""
  28633. #. type: deftypevr
  28634. #: guix-git/doc/guix.texi:19130
  28635. msgid "Specifies the amount of time to wait for job completion before restarting the scheduler."
  28636. msgstr ""
  28637. #. type: deftypevr
  28638. #: guix-git/doc/guix.texi:19134
  28639. #, no-wrap
  28640. msgid "{@code{cups-configuration} parameter} string rip-cache"
  28641. msgstr ""
  28642. #. type: deftypevr
  28643. #: guix-git/doc/guix.texi:19137
  28644. msgid "Specifies the maximum amount of memory to use when converting documents into bitmaps for a printer."
  28645. msgstr ""
  28646. #. type: deftypevr
  28647. #: guix-git/doc/guix.texi:19139
  28648. msgid "Defaults to @samp{\"128m\"}."
  28649. msgstr ""
  28650. #. type: deftypevr
  28651. #: guix-git/doc/guix.texi:19141
  28652. #, no-wrap
  28653. msgid "{@code{cups-configuration} parameter} string server-admin"
  28654. msgstr ""
  28655. #. type: deftypevr
  28656. #: guix-git/doc/guix.texi:19143
  28657. msgid "Specifies the email address of the server administrator."
  28658. msgstr ""
  28659. #. type: deftypevr
  28660. #: guix-git/doc/guix.texi:19145
  28661. msgid "Defaults to @samp{\"root@@localhost.localdomain\"}."
  28662. msgstr ""
  28663. #. type: deftypevr
  28664. #: guix-git/doc/guix.texi:19147
  28665. #, no-wrap
  28666. msgid "{@code{cups-configuration} parameter} host-name-list-or-* server-alias"
  28667. msgstr ""
  28668. #. type: deftypevr
  28669. #: guix-git/doc/guix.texi:19155
  28670. msgid "The ServerAlias directive is used for HTTP Host header validation when clients connect to the scheduler from external interfaces. Using the special name @code{*} can expose your system to known browser-based DNS rebinding attacks, even when accessing sites through a firewall. If the auto-discovery of alternate names does not work, we recommend listing each alternate name with a ServerAlias directive instead of using @code{*}."
  28671. msgstr ""
  28672. #. type: deftypevr
  28673. #: guix-git/doc/guix.texi:19157
  28674. msgid "Defaults to @samp{*}."
  28675. msgstr ""
  28676. #. type: deftypevr
  28677. #: guix-git/doc/guix.texi:19159
  28678. #, no-wrap
  28679. msgid "{@code{cups-configuration} parameter} string server-name"
  28680. msgstr ""
  28681. #. type: deftypevr
  28682. #: guix-git/doc/guix.texi:19161
  28683. msgid "Specifies the fully-qualified host name of the server."
  28684. msgstr ""
  28685. #. type: deftypevr
  28686. #: guix-git/doc/guix.texi:19163 guix-git/doc/guix.texi:24292
  28687. #: guix-git/doc/guix.texi:24337
  28688. msgid "Defaults to @samp{\"localhost\"}."
  28689. msgstr ""
  28690. #. type: deftypevr
  28691. #: guix-git/doc/guix.texi:19165
  28692. #, no-wrap
  28693. msgid "{@code{cups-configuration} parameter} server-tokens server-tokens"
  28694. msgstr ""
  28695. #. type: deftypevr
  28696. #: guix-git/doc/guix.texi:19173
  28697. msgid "Specifies what information is included in the Server header of HTTP responses. @code{None} disables the Server header. @code{ProductOnly} reports @code{CUPS}. @code{Major} reports @code{CUPS 2}. @code{Minor} reports @code{CUPS 2.0}. @code{Minimal} reports @code{CUPS 2.0.0}. @code{OS} reports @code{CUPS 2.0.0 (@var{uname})} where @var{uname} is the output of the @code{uname} command. @code{Full} reports @code{CUPS 2.0.0 (@var{uname}) IPP/2.0}."
  28698. msgstr ""
  28699. #. type: deftypevr
  28700. #: guix-git/doc/guix.texi:19175
  28701. msgid "Defaults to @samp{Minimal}."
  28702. msgstr ""
  28703. #. type: deftypevr
  28704. #: guix-git/doc/guix.texi:19177
  28705. #, no-wrap
  28706. msgid "{@code{cups-configuration} parameter} multiline-string-list ssl-listen"
  28707. msgstr ""
  28708. #. type: deftypevr
  28709. #: guix-git/doc/guix.texi:19182
  28710. msgid "Listens on the specified interfaces for encrypted connections. Valid values are of the form @var{address}:@var{port}, where @var{address} is either an IPv6 address enclosed in brackets, an IPv4 address, or @code{*} to indicate all addresses."
  28711. msgstr ""
  28712. #. type: deftypevr
  28713. #: guix-git/doc/guix.texi:19186
  28714. #, no-wrap
  28715. msgid "{@code{cups-configuration} parameter} ssl-options ssl-options"
  28716. msgstr ""
  28717. #. type: deftypevr
  28718. #: guix-git/doc/guix.texi:19196
  28719. msgid "Sets encryption options. By default, CUPS only supports encryption using TLS v1.0 or higher using known secure cipher suites. Security is reduced when @code{Allow} options are used, and enhanced when @code{Deny} options are used. The @code{AllowRC4} option enables the 128-bit RC4 cipher suites, which are required for some older clients. The @code{AllowSSL3} option enables SSL v3.0, which is required for some older clients that do not support TLS v1.0. The @code{DenyCBC} option disables all CBC cipher suites. The @code{DenyTLS1.0} option disables TLS v1.0 support - this sets the minimum protocol version to TLS v1.1."
  28720. msgstr ""
  28721. #. type: deftypevr
  28722. #: guix-git/doc/guix.texi:19200
  28723. #, no-wrap
  28724. msgid "{@code{cups-configuration} parameter} boolean strict-conformance?"
  28725. msgstr ""
  28726. #. type: deftypevr
  28727. #: guix-git/doc/guix.texi:19203
  28728. msgid "Specifies whether the scheduler requires clients to strictly adhere to the IPP specifications."
  28729. msgstr ""
  28730. #. type: deftypevr
  28731. #: guix-git/doc/guix.texi:19207
  28732. #, no-wrap
  28733. msgid "{@code{cups-configuration} parameter} non-negative-integer timeout"
  28734. msgstr ""
  28735. #. type: deftypevr
  28736. #: guix-git/doc/guix.texi:19209
  28737. msgid "Specifies the HTTP request timeout, in seconds."
  28738. msgstr ""
  28739. #. type: deftypevr
  28740. #: guix-git/doc/guix.texi:19214
  28741. #, no-wrap
  28742. msgid "{@code{cups-configuration} parameter} boolean web-interface?"
  28743. msgstr ""
  28744. #. type: deftypevr
  28745. #: guix-git/doc/guix.texi:19216
  28746. msgid "Specifies whether the web interface is enabled."
  28747. msgstr ""
  28748. #. type: Plain text
  28749. #: guix-git/doc/guix.texi:19226
  28750. msgid "At this point you're probably thinking ``oh dear, Guix manual, I like you but you can stop already with the configuration options''. Indeed. However, one more point: it could be that you have an existing @code{cupsd.conf} that you want to use. In that case, you can pass an @code{opaque-cups-configuration} as the configuration of a @code{cups-service-type}."
  28751. msgstr ""
  28752. #. type: Plain text
  28753. #: guix-git/doc/guix.texi:19228
  28754. msgid "Available @code{opaque-cups-configuration} fields are:"
  28755. msgstr ""
  28756. #. type: deftypevr
  28757. #: guix-git/doc/guix.texi:19229
  28758. #, no-wrap
  28759. msgid "{@code{opaque-cups-configuration} parameter} package cups"
  28760. msgstr ""
  28761. #. type: deftypevr
  28762. #: guix-git/doc/guix.texi:19233
  28763. #, no-wrap
  28764. msgid "{@code{opaque-cups-configuration} parameter} string cupsd.conf"
  28765. msgstr ""
  28766. #. type: deftypevr
  28767. #: guix-git/doc/guix.texi:19235
  28768. msgid "The contents of the @code{cupsd.conf}, as a string."
  28769. msgstr ""
  28770. #. type: deftypevr
  28771. #: guix-git/doc/guix.texi:19237
  28772. #, no-wrap
  28773. msgid "{@code{opaque-cups-configuration} parameter} string cups-files.conf"
  28774. msgstr ""
  28775. #. type: deftypevr
  28776. #: guix-git/doc/guix.texi:19239
  28777. msgid "The contents of the @code{cups-files.conf} file, as a string."
  28778. msgstr ""
  28779. #. type: Plain text
  28780. #: guix-git/doc/guix.texi:19244
  28781. msgid "For example, if your @code{cupsd.conf} and @code{cups-files.conf} are in strings of the same name, you could instantiate a CUPS service like this:"
  28782. msgstr ""
  28783. #. type: lisp
  28784. #: guix-git/doc/guix.texi:19250
  28785. #, no-wrap
  28786. msgid ""
  28787. "(service cups-service-type\n"
  28788. " (opaque-cups-configuration\n"
  28789. " (cupsd.conf cupsd.conf)\n"
  28790. " (cups-files.conf cups-files.conf)))\n"
  28791. msgstr ""
  28792. #. type: Plain text
  28793. #: guix-git/doc/guix.texi:19261
  28794. msgid "The @code{(gnu services desktop)} module provides services that are usually useful in the context of a ``desktop'' setup---that is, on a machine running a graphical display server, possibly with graphical user interfaces, etc. It also defines services that provide specific desktop environments like GNOME, Xfce or MATE."
  28795. msgstr ""
  28796. #. type: Plain text
  28797. #: guix-git/doc/guix.texi:19265
  28798. msgid "To simplify things, the module defines a variable containing the set of services that users typically expect on a machine with a graphical environment and networking:"
  28799. msgstr ""
  28800. #. type: defvr
  28801. #: guix-git/doc/guix.texi:19266
  28802. #, no-wrap
  28803. msgid "{Scheme Variable} %desktop-services"
  28804. msgstr ""
  28805. #. type: defvr
  28806. #: guix-git/doc/guix.texi:19269
  28807. msgid "This is a list of services that builds upon @code{%base-services} and adds or adjusts services for a typical ``desktop'' setup."
  28808. msgstr ""
  28809. #. type: defvr
  28810. #: guix-git/doc/guix.texi:19280
  28811. msgid "In particular, it adds a graphical login manager (@pxref{X Window, @code{gdm-service-type}}), screen lockers, a network management tool (@pxref{Networking Services, @code{network-manager-service-type}}) with modem support (@pxref{Networking Services, @code{modem-manager-service-type}}), energy and color management services, the @code{elogind} login and seat manager, the Polkit privilege service, the GeoClue location service, the AccountsService daemon that allows authorized users change system passwords, an NTP client (@pxref{Networking Services}), the Avahi daemon, and has the name service switch service configured to be able to use @code{nss-mdns} (@pxref{Name Service Switch, mDNS})."
  28812. msgstr ""
  28813. #. type: Plain text
  28814. #: guix-git/doc/guix.texi:19285
  28815. msgid "The @code{%desktop-services} variable can be used as the @code{services} field of an @code{operating-system} declaration (@pxref{operating-system Reference, @code{services}})."
  28816. msgstr ""
  28817. #. type: Plain text
  28818. #: guix-git/doc/guix.texi:19308
  28819. msgid "Additionally, the @code{gnome-desktop-service-type}, @code{xfce-desktop-service}, @code{mate-desktop-service-type}, @code{lxqt-desktop-service-type} and @code{enlightenment-desktop-service-type} procedures can add GNOME, Xfce, MATE and/or Enlightenment to a system. To ``add GNOME'' means that system-level services like the backlight adjustment helpers and the power management utilities are added to the system, extending @code{polkit} and @code{dbus} appropriately, allowing GNOME to operate with elevated privileges on a limited number of special-purpose system interfaces. Additionally, adding a service made by @code{gnome-desktop-service-type} adds the GNOME metapackage to the system profile. Likewise, adding the Xfce service not only adds the @code{xfce} metapackage to the system profile, but it also gives the Thunar file manager the ability to open a ``root-mode'' file management window, if the user authenticates using the administrator's password via the standard polkit graphical interface. To ``add MATE'' means that @code{polkit} and @code{dbus} are extended appropriately, allowing MATE to operate with elevated privileges on a limited number of special-purpose system interfaces. Additionally, adding a service of type @code{mate-desktop-service-type} adds the MATE metapackage to the system profile. ``Adding Enlightenment'' means that @code{dbus} is extended appropriately, and several of Enlightenment's binaries are set as setuid, allowing Enlightenment's screen locker and other functionality to work as expected."
  28820. msgstr ""
  28821. #. type: Plain text
  28822. #: guix-git/doc/guix.texi:19317
  28823. msgid "The desktop environments in Guix use the Xorg display server by default. If you'd like to use the newer display server protocol called Wayland, you need to use the @code{sddm-service} instead of GDM as the graphical login manager. You should then select the ``GNOME (Wayland)'' session in SDDM@. Alternatively you can also try starting GNOME on Wayland manually from a TTY with the command ``XDG_SESSION_TYPE=wayland exec dbus-run-session gnome-session``. Currently only GNOME has support for Wayland."
  28824. msgstr ""
  28825. #. type: defvr
  28826. #: guix-git/doc/guix.texi:19318
  28827. #, no-wrap
  28828. msgid "{Scheme Variable} gnome-desktop-service-type"
  28829. msgstr ""
  28830. #. type: defvr
  28831. #: guix-git/doc/guix.texi:19322
  28832. msgid "This is the type of the service that adds the @uref{https://www.gnome.org, GNOME} desktop environment. Its value is a @code{gnome-desktop-configuration} object (see below)."
  28833. msgstr ""
  28834. #. type: defvr
  28835. #: guix-git/doc/guix.texi:19325
  28836. msgid "This service adds the @code{gnome} package to the system profile, and extends polkit with the actions from @code{gnome-settings-daemon}."
  28837. msgstr ""
  28838. #. type: deftp
  28839. #: guix-git/doc/guix.texi:19327
  28840. #, no-wrap
  28841. msgid "{Data Type} gnome-desktop-configuration"
  28842. msgstr ""
  28843. #. type: deftp
  28844. #: guix-git/doc/guix.texi:19329
  28845. msgid "Configuration record for the GNOME desktop environment."
  28846. msgstr ""
  28847. #. type: item
  28848. #: guix-git/doc/guix.texi:19331
  28849. #, no-wrap
  28850. msgid "@code{gnome} (default: @code{gnome})"
  28851. msgstr ""
  28852. #. type: table
  28853. #: guix-git/doc/guix.texi:19333
  28854. msgid "The GNOME package to use."
  28855. msgstr ""
  28856. #. type: defvr
  28857. #: guix-git/doc/guix.texi:19336
  28858. #, no-wrap
  28859. msgid "{Scheme Variable} xfce-desktop-service-type"
  28860. msgstr ""
  28861. #. type: defvr
  28862. #: guix-git/doc/guix.texi:19340
  28863. msgid "This is the type of a service to run the @uref{Xfce, https://xfce.org/} desktop environment. Its value is an @code{xfce-desktop-configuration} object (see below)."
  28864. msgstr ""
  28865. #. type: defvr
  28866. #: guix-git/doc/guix.texi:19345
  28867. msgid "This service adds the @code{xfce} package to the system profile, and extends polkit with the ability for @code{thunar} to manipulate the file system as root from within a user session, after the user has authenticated with the administrator's password."
  28868. msgstr ""
  28869. #. type: defvr
  28870. #: guix-git/doc/guix.texi:19351
  28871. msgid "Note that @code{xfce4-panel} and its plugin packages should be installed in the same profile to ensure compatibility. When using this service, you should add extra plugins (@code{xfce4-whiskermenu-plugin}, @code{xfce4-weather-plugin}, etc.) to the @code{packages} field of your @code{operating-system}."
  28872. msgstr ""
  28873. #. type: deftp
  28874. #: guix-git/doc/guix.texi:19353
  28875. #, no-wrap
  28876. msgid "{Data Type} xfce-desktop-configuration"
  28877. msgstr ""
  28878. #. type: deftp
  28879. #: guix-git/doc/guix.texi:19355
  28880. msgid "Configuration record for the Xfce desktop environment."
  28881. msgstr ""
  28882. #. type: item
  28883. #: guix-git/doc/guix.texi:19357
  28884. #, no-wrap
  28885. msgid "@code{xfce} (default: @code{xfce})"
  28886. msgstr ""
  28887. #. type: table
  28888. #: guix-git/doc/guix.texi:19359
  28889. msgid "The Xfce package to use."
  28890. msgstr ""
  28891. #. type: deffn
  28892. #: guix-git/doc/guix.texi:19362
  28893. #, no-wrap
  28894. msgid "{Scheme Variable} mate-desktop-service-type"
  28895. msgstr ""
  28896. #. type: deffn
  28897. #: guix-git/doc/guix.texi:19366
  28898. msgid "This is the type of the service that runs the @uref{https://mate-desktop.org/, MATE desktop environment}. Its value is a @code{mate-desktop-configuration} object (see below)."
  28899. msgstr ""
  28900. #. type: deffn
  28901. #: guix-git/doc/guix.texi:19370
  28902. msgid "This service adds the @code{mate} package to the system profile, and extends polkit with the actions from @code{mate-settings-daemon}."
  28903. msgstr ""
  28904. #. type: deftp
  28905. #: guix-git/doc/guix.texi:19372
  28906. #, no-wrap
  28907. msgid "{Data Type} mate-desktop-configuration"
  28908. msgstr ""
  28909. #. type: deftp
  28910. #: guix-git/doc/guix.texi:19374
  28911. msgid "Configuration record for the MATE desktop environment."
  28912. msgstr ""
  28913. #. type: item
  28914. #: guix-git/doc/guix.texi:19376
  28915. #, no-wrap
  28916. msgid "@code{mate} (default: @code{mate})"
  28917. msgstr ""
  28918. #. type: table
  28919. #: guix-git/doc/guix.texi:19378
  28920. msgid "The MATE package to use."
  28921. msgstr ""
  28922. #. type: deffn
  28923. #: guix-git/doc/guix.texi:19381
  28924. #, no-wrap
  28925. msgid "{Scheme Variable} lxqt-desktop-service-type"
  28926. msgstr ""
  28927. #. type: deffn
  28928. #: guix-git/doc/guix.texi:19385
  28929. msgid "This is the type of the service that runs the @uref{https://lxqt-project.org, LXQt desktop environment}. Its value is a @code{lxqt-desktop-configuration} object (see below)."
  28930. msgstr ""
  28931. #. type: deffn
  28932. #: guix-git/doc/guix.texi:19388
  28933. msgid "This service adds the @code{lxqt} package to the system profile."
  28934. msgstr ""
  28935. #. type: deftp
  28936. #: guix-git/doc/guix.texi:19390
  28937. #, no-wrap
  28938. msgid "{Data Type} lxqt-desktop-configuration"
  28939. msgstr ""
  28940. #. type: deftp
  28941. #: guix-git/doc/guix.texi:19392
  28942. msgid "Configuration record for the LXQt desktop environment."
  28943. msgstr ""
  28944. #. type: item
  28945. #: guix-git/doc/guix.texi:19394
  28946. #, no-wrap
  28947. msgid "@code{lxqt} (default: @code{lxqt})"
  28948. msgstr ""
  28949. #. type: table
  28950. #: guix-git/doc/guix.texi:19396
  28951. msgid "The LXQT package to use."
  28952. msgstr ""
  28953. #. type: deffn
  28954. #: guix-git/doc/guix.texi:19399
  28955. #, no-wrap
  28956. msgid "{Scheme Variable} enlightenment-desktop-service-type"
  28957. msgstr ""
  28958. #. type: deffn
  28959. #: guix-git/doc/guix.texi:19402
  28960. msgid "Return a service that adds the @code{enlightenment} package to the system profile, and extends dbus with actions from @code{efl}."
  28961. msgstr ""
  28962. #. type: deftp
  28963. #: guix-git/doc/guix.texi:19404
  28964. #, no-wrap
  28965. msgid "{Data Type} enlightenment-desktop-service-configuration"
  28966. msgstr ""
  28967. #. type: item
  28968. #: guix-git/doc/guix.texi:19406
  28969. #, no-wrap
  28970. msgid "@code{enlightenment} (default: @code{enlightenment})"
  28971. msgstr ""
  28972. #. type: table
  28973. #: guix-git/doc/guix.texi:19408
  28974. msgid "The enlightenment package to use."
  28975. msgstr ""
  28976. #. type: Plain text
  28977. #: guix-git/doc/guix.texi:19416
  28978. msgid "Because the GNOME, Xfce and MATE desktop services pull in so many packages, the default @code{%desktop-services} variable doesn't include any of them by default. To add GNOME, Xfce or MATE, just @code{cons} them onto @code{%desktop-services} in the @code{services} field of your @code{operating-system}:"
  28979. msgstr ""
  28980. #. type: lisp
  28981. #: guix-git/doc/guix.texi:19427
  28982. #, no-wrap
  28983. msgid ""
  28984. "(use-modules (gnu))\n"
  28985. "(use-service-modules desktop)\n"
  28986. "(operating-system\n"
  28987. " ...\n"
  28988. " ;; cons* adds items to the list given as its last argument.\n"
  28989. " (services (cons* (service gnome-desktop-service-type)\n"
  28990. " (service xfce-desktop-service)\n"
  28991. " %desktop-services))\n"
  28992. " ...)\n"
  28993. msgstr ""
  28994. #. type: Plain text
  28995. #: guix-git/doc/guix.texi:19431
  28996. msgid "These desktop environments will then be available as options in the graphical login window."
  28997. msgstr ""
  28998. #. type: Plain text
  28999. #: guix-git/doc/guix.texi:19435
  29000. msgid "The actual service definitions included in @code{%desktop-services} and provided by @code{(gnu services dbus)} and @code{(gnu services desktop)} are described below."
  29001. msgstr ""
  29002. #. type: deffn
  29003. #: guix-git/doc/guix.texi:19436
  29004. #, no-wrap
  29005. msgid "{Scheme Procedure} dbus-service [#:dbus @var{dbus}] [#:services '()]"
  29006. msgstr ""
  29007. #. type: deffn
  29008. #: guix-git/doc/guix.texi:19439
  29009. msgid "Return a service that runs the ``system bus'', using @var{dbus}, with support for @var{services}."
  29010. msgstr ""
  29011. #. type: deffn
  29012. #: guix-git/doc/guix.texi:19443
  29013. msgid "@uref{https://dbus.freedesktop.org/, D-Bus} is an inter-process communication facility. Its system bus is used to allow system services to communicate and to be notified of system-wide events."
  29014. msgstr ""
  29015. #. type: deffn
  29016. #: guix-git/doc/guix.texi:19448
  29017. msgid "@var{services} must be a list of packages that provide an @file{etc/dbus-1/system.d} directory containing additional D-Bus configuration and policy files. For example, to allow avahi-daemon to use the system bus, @var{services} must be equal to @code{(list avahi)}."
  29018. msgstr ""
  29019. #. type: deffn
  29020. #: guix-git/doc/guix.texi:19450
  29021. #, no-wrap
  29022. msgid "{Scheme Procedure} elogind-service [#:config @var{config}]"
  29023. msgstr ""
  29024. #. type: deffn
  29025. #: guix-git/doc/guix.texi:19456
  29026. msgid "Return a service that runs the @code{elogind} login and seat management daemon. @uref{https://github.com/elogind/elogind, Elogind} exposes a D-Bus interface that can be used to know which users are logged in, know what kind of sessions they have open, suspend the system, inhibit system suspend, reboot the system, and other tasks."
  29027. msgstr ""
  29028. #. type: deffn
  29029. #: guix-git/doc/guix.texi:19460
  29030. msgid "Elogind handles most system-level power events for a computer, for example suspending the system when a lid is closed, or shutting it down when the power button is pressed."
  29031. msgstr ""
  29032. #. type: deffn
  29033. #: guix-git/doc/guix.texi:19465
  29034. msgid "The @var{config} keyword argument specifies the configuration for elogind, and should be the result of an @code{(elogind-configuration (@var{parameter} @var{value})...)} invocation. Available parameters and their default values are:"
  29035. msgstr ""
  29036. #. type: item
  29037. #: guix-git/doc/guix.texi:19467
  29038. #, no-wrap
  29039. msgid "kill-user-processes?"
  29040. msgstr ""
  29041. #. type: code{#1}
  29042. #: guix-git/doc/guix.texi:19469 guix-git/doc/guix.texi:19489
  29043. #: guix-git/doc/guix.texi:19491 guix-git/doc/guix.texi:19493
  29044. #: guix-git/doc/guix.texi:19505
  29045. msgid "#f"
  29046. msgstr ""
  29047. #. type: item
  29048. #: guix-git/doc/guix.texi:19469
  29049. #, no-wrap
  29050. msgid "kill-only-users"
  29051. msgstr ""
  29052. #. type: code{#1}
  29053. #: guix-git/doc/guix.texi:19471 guix-git/doc/guix.texi:19511
  29054. msgid "()"
  29055. msgstr ""
  29056. #. type: item
  29057. #: guix-git/doc/guix.texi:19471
  29058. #, no-wrap
  29059. msgid "kill-exclude-users"
  29060. msgstr ""
  29061. #. type: code{#1}
  29062. #: guix-git/doc/guix.texi:19473
  29063. msgid "(\"root\")"
  29064. msgstr ""
  29065. #. type: item
  29066. #: guix-git/doc/guix.texi:19473
  29067. #, no-wrap
  29068. msgid "inhibit-delay-max-seconds"
  29069. msgstr ""
  29070. #. type: code{#1}
  29071. #: guix-git/doc/guix.texi:19475
  29072. msgid "5"
  29073. msgstr ""
  29074. #. type: item
  29075. #: guix-git/doc/guix.texi:19475
  29076. #, no-wrap
  29077. msgid "handle-power-key"
  29078. msgstr ""
  29079. #. type: code{#1}
  29080. #: guix-git/doc/guix.texi:19477
  29081. msgid "poweroff"
  29082. msgstr ""
  29083. #. type: item
  29084. #: guix-git/doc/guix.texi:19477
  29085. #, no-wrap
  29086. msgid "handle-suspend-key"
  29087. msgstr ""
  29088. #. type: code{#1}
  29089. #: guix-git/doc/guix.texi:19479 guix-git/doc/guix.texi:19483
  29090. msgid "suspend"
  29091. msgstr ""
  29092. #. type: item
  29093. #: guix-git/doc/guix.texi:19479
  29094. #, no-wrap
  29095. msgid "handle-hibernate-key"
  29096. msgstr ""
  29097. #. type: code{#1}
  29098. #: guix-git/doc/guix.texi:19481
  29099. msgid "hibernate"
  29100. msgstr ""
  29101. #. type: item
  29102. #: guix-git/doc/guix.texi:19481
  29103. #, no-wrap
  29104. msgid "handle-lid-switch"
  29105. msgstr ""
  29106. #. type: item
  29107. #: guix-git/doc/guix.texi:19483
  29108. #, no-wrap
  29109. msgid "handle-lid-switch-docked"
  29110. msgstr ""
  29111. #. type: code{#1}
  29112. #: guix-git/doc/guix.texi:19485 guix-git/doc/guix.texi:19487
  29113. #: guix-git/doc/guix.texi:19499
  29114. msgid "ignore"
  29115. msgstr ""
  29116. #. type: item
  29117. #: guix-git/doc/guix.texi:19485
  29118. #, no-wrap
  29119. msgid "handle-lid-switch-external-power"
  29120. msgstr ""
  29121. #. type: item
  29122. #: guix-git/doc/guix.texi:19487
  29123. #, no-wrap
  29124. msgid "power-key-ignore-inhibited?"
  29125. msgstr ""
  29126. #. type: item
  29127. #: guix-git/doc/guix.texi:19489
  29128. #, no-wrap
  29129. msgid "suspend-key-ignore-inhibited?"
  29130. msgstr ""
  29131. #. type: item
  29132. #: guix-git/doc/guix.texi:19491
  29133. #, no-wrap
  29134. msgid "hibernate-key-ignore-inhibited?"
  29135. msgstr ""
  29136. #. type: item
  29137. #: guix-git/doc/guix.texi:19493
  29138. #, no-wrap
  29139. msgid "lid-switch-ignore-inhibited?"
  29140. msgstr ""
  29141. #. type: code{#1}
  29142. #: guix-git/doc/guix.texi:19495 guix-git/doc/guix.texi:19507
  29143. msgid "#t"
  29144. msgstr ""
  29145. #. type: item
  29146. #: guix-git/doc/guix.texi:19495
  29147. #, no-wrap
  29148. msgid "holdoff-timeout-seconds"
  29149. msgstr ""
  29150. #. type: code{#1}
  29151. #: guix-git/doc/guix.texi:19497
  29152. msgid "30"
  29153. msgstr ""
  29154. #. type: item
  29155. #: guix-git/doc/guix.texi:19497
  29156. #, no-wrap
  29157. msgid "idle-action"
  29158. msgstr ""
  29159. #. type: item
  29160. #: guix-git/doc/guix.texi:19499
  29161. #, no-wrap
  29162. msgid "idle-action-seconds"
  29163. msgstr ""
  29164. #. type: code{#1}
  29165. #: guix-git/doc/guix.texi:19501
  29166. msgid "(* 30 60)"
  29167. msgstr ""
  29168. #. type: item
  29169. #: guix-git/doc/guix.texi:19501
  29170. #, no-wrap
  29171. msgid "runtime-directory-size-percent"
  29172. msgstr ""
  29173. #. type: code{#1}
  29174. #: guix-git/doc/guix.texi:19503
  29175. msgid "10"
  29176. msgstr ""
  29177. #. type: item
  29178. #: guix-git/doc/guix.texi:19503
  29179. #, no-wrap
  29180. msgid "runtime-directory-size"
  29181. msgstr ""
  29182. #. type: item
  29183. #: guix-git/doc/guix.texi:19505
  29184. #, no-wrap
  29185. msgid "remove-ipc?"
  29186. msgstr ""
  29187. #. type: item
  29188. #: guix-git/doc/guix.texi:19507
  29189. #, no-wrap
  29190. msgid "suspend-state"
  29191. msgstr ""
  29192. #. type: code{#1}
  29193. #: guix-git/doc/guix.texi:19509
  29194. msgid "(\"mem\" \"standby\" \"freeze\")"
  29195. msgstr ""
  29196. #. type: item
  29197. #: guix-git/doc/guix.texi:19509
  29198. #, no-wrap
  29199. msgid "suspend-mode"
  29200. msgstr ""
  29201. #. type: item
  29202. #: guix-git/doc/guix.texi:19511
  29203. #, no-wrap
  29204. msgid "hibernate-state"
  29205. msgstr ""
  29206. #. type: code{#1}
  29207. #: guix-git/doc/guix.texi:19513 guix-git/doc/guix.texi:19517
  29208. msgid "(\"disk\")"
  29209. msgstr ""
  29210. #. type: item
  29211. #: guix-git/doc/guix.texi:19513
  29212. #, no-wrap
  29213. msgid "hibernate-mode"
  29214. msgstr ""
  29215. #. type: code{#1}
  29216. #: guix-git/doc/guix.texi:19515
  29217. msgid "(\"platform\" \"shutdown\")"
  29218. msgstr ""
  29219. #. type: item
  29220. #: guix-git/doc/guix.texi:19515
  29221. #, no-wrap
  29222. msgid "hybrid-sleep-state"
  29223. msgstr ""
  29224. #. type: item
  29225. #: guix-git/doc/guix.texi:19517
  29226. #, no-wrap
  29227. msgid "hybrid-sleep-mode"
  29228. msgstr ""
  29229. #. type: code{#1}
  29230. #: guix-git/doc/guix.texi:19519
  29231. msgid "(\"suspend\" \"platform\" \"shutdown\")"
  29232. msgstr ""
  29233. #. type: deffn
  29234. #: guix-git/doc/guix.texi:19522
  29235. #, no-wrap
  29236. msgid "{Scheme Procedure} accountsservice-service @"
  29237. msgstr ""
  29238. #. type: deffn
  29239. #: guix-git/doc/guix.texi:19530
  29240. msgid "[#:accountsservice @var{accountsservice}] Return a service that runs AccountsService, a system service that can list available accounts, change their passwords, and so on. AccountsService integrates with PolicyKit to enable unprivileged users to acquire the capability to modify their system configuration. @uref{https://www.freedesktop.org/wiki/Software/AccountsService/, the accountsservice web site} for more information."
  29241. msgstr ""
  29242. #. type: deffn
  29243. #: guix-git/doc/guix.texi:19533
  29244. msgid "The @var{accountsservice} keyword argument is the @code{accountsservice} package to expose as a service."
  29245. msgstr ""
  29246. #. type: deffn
  29247. #: guix-git/doc/guix.texi:19535
  29248. #, no-wrap
  29249. msgid "{Scheme Procedure} polkit-service @"
  29250. msgstr ""
  29251. #. type: deffn
  29252. #: guix-git/doc/guix.texi:19544
  29253. msgid "[#:polkit @var{polkit}] Return a service that runs the @uref{https://www.freedesktop.org/wiki/Software/polkit/, Polkit privilege management service}, which allows system administrators to grant access to privileged operations in a structured way. By querying the Polkit service, a privileged system component can know when it should grant additional capabilities to ordinary users. For example, an ordinary user can be granted the capability to suspend the system if the user is logged in locally."
  29254. msgstr ""
  29255. #. type: defvr
  29256. #: guix-git/doc/guix.texi:19546
  29257. #, no-wrap
  29258. msgid "{Scheme Variable} polkit-wheel-service"
  29259. msgstr ""
  29260. #. type: defvr
  29261. #: guix-git/doc/guix.texi:19551
  29262. msgid "Service that adds the @code{wheel} group as admins to the Polkit service. This makes it so that users in the @code{wheel} group are queried for their own passwords when performing administrative actions instead of @code{root}'s, similar to the behaviour used by @code{sudo}."
  29263. msgstr ""
  29264. #. type: defvr
  29265. #: guix-git/doc/guix.texi:19553
  29266. #, no-wrap
  29267. msgid "{Scheme Variable} upower-service-type"
  29268. msgstr ""
  29269. #. type: defvr
  29270. #: guix-git/doc/guix.texi:19557
  29271. msgid "Service that runs @uref{https://upower.freedesktop.org/, @command{upowerd}}, a system-wide monitor for power consumption and battery levels, with the given configuration settings."
  29272. msgstr ""
  29273. #. type: defvr
  29274. #: guix-git/doc/guix.texi:19560
  29275. msgid "It implements the @code{org.freedesktop.UPower} D-Bus interface, and is notably used by GNOME."
  29276. msgstr ""
  29277. #. type: deftp
  29278. #: guix-git/doc/guix.texi:19562
  29279. #, no-wrap
  29280. msgid "{Data Type} upower-configuration"
  29281. msgstr ""
  29282. #. type: deftp
  29283. #: guix-git/doc/guix.texi:19564
  29284. msgid "Data type representation the configuration for UPower."
  29285. msgstr ""
  29286. #. type: item
  29287. #: guix-git/doc/guix.texi:19567
  29288. #, no-wrap
  29289. msgid "@code{upower} (default: @var{upower})"
  29290. msgstr ""
  29291. #. type: table
  29292. #: guix-git/doc/guix.texi:19569
  29293. msgid "Package to use for @code{upower}."
  29294. msgstr ""
  29295. #. type: item
  29296. #: guix-git/doc/guix.texi:19570
  29297. #, no-wrap
  29298. msgid "@code{watts-up-pro?} (default: @code{#f})"
  29299. msgstr ""
  29300. #. type: table
  29301. #: guix-git/doc/guix.texi:19572
  29302. msgid "Enable the Watts Up Pro device."
  29303. msgstr ""
  29304. #. type: item
  29305. #: guix-git/doc/guix.texi:19573
  29306. #, no-wrap
  29307. msgid "@code{poll-batteries?} (default: @code{#t})"
  29308. msgstr ""
  29309. #. type: table
  29310. #: guix-git/doc/guix.texi:19575
  29311. msgid "Enable polling the kernel for battery level changes."
  29312. msgstr ""
  29313. #. type: item
  29314. #: guix-git/doc/guix.texi:19576
  29315. #, no-wrap
  29316. msgid "@code{ignore-lid?} (default: @code{#f})"
  29317. msgstr ""
  29318. #. type: table
  29319. #: guix-git/doc/guix.texi:19578
  29320. msgid "Ignore the lid state, this can be useful if it's incorrect on a device."
  29321. msgstr ""
  29322. #. type: item
  29323. #: guix-git/doc/guix.texi:19579
  29324. #, no-wrap
  29325. msgid "@code{use-percentage-for-policy?} (default: @code{#f})"
  29326. msgstr ""
  29327. #. type: table
  29328. #: guix-git/doc/guix.texi:19582
  29329. msgid "Whether battery percentage based policy should be used. The default is to use the time left, change to @code{#t} to use the percentage."
  29330. msgstr ""
  29331. #. type: item
  29332. #: guix-git/doc/guix.texi:19583
  29333. #, no-wrap
  29334. msgid "@code{percentage-low} (default: @code{10})"
  29335. msgstr ""
  29336. #. type: table
  29337. #: guix-git/doc/guix.texi:19586
  29338. msgid "When @code{use-percentage-for-policy?} is @code{#t}, this sets the percentage at which the battery is considered low."
  29339. msgstr ""
  29340. #. type: item
  29341. #: guix-git/doc/guix.texi:19587
  29342. #, no-wrap
  29343. msgid "@code{percentage-critical} (default: @code{3})"
  29344. msgstr ""
  29345. #. type: table
  29346. #: guix-git/doc/guix.texi:19590
  29347. msgid "When @code{use-percentage-for-policy?} is @code{#t}, this sets the percentage at which the battery is considered critical."
  29348. msgstr ""
  29349. #. type: item
  29350. #: guix-git/doc/guix.texi:19591
  29351. #, no-wrap
  29352. msgid "@code{percentage-action} (default: @code{2})"
  29353. msgstr ""
  29354. #. type: table
  29355. #: guix-git/doc/guix.texi:19594
  29356. msgid "When @code{use-percentage-for-policy?} is @code{#t}, this sets the percentage at which action will be taken."
  29357. msgstr ""
  29358. #. type: item
  29359. #: guix-git/doc/guix.texi:19595
  29360. #, no-wrap
  29361. msgid "@code{time-low} (default: @code{1200})"
  29362. msgstr ""
  29363. #. type: table
  29364. #: guix-git/doc/guix.texi:19598
  29365. msgid "When @code{use-time-for-policy?} is @code{#f}, this sets the time remaining in seconds at which the battery is considered low."
  29366. msgstr ""
  29367. #. type: item
  29368. #: guix-git/doc/guix.texi:19599
  29369. #, no-wrap
  29370. msgid "@code{time-critical} (default: @code{300})"
  29371. msgstr ""
  29372. #. type: table
  29373. #: guix-git/doc/guix.texi:19602
  29374. msgid "When @code{use-time-for-policy?} is @code{#f}, this sets the time remaining in seconds at which the battery is considered critical."
  29375. msgstr ""
  29376. #. type: item
  29377. #: guix-git/doc/guix.texi:19603
  29378. #, no-wrap
  29379. msgid "@code{time-action} (default: @code{120})"
  29380. msgstr ""
  29381. #. type: table
  29382. #: guix-git/doc/guix.texi:19606
  29383. msgid "When @code{use-time-for-policy?} is @code{#f}, this sets the time remaining in seconds at which action will be taken."
  29384. msgstr ""
  29385. #. type: item
  29386. #: guix-git/doc/guix.texi:19607
  29387. #, no-wrap
  29388. msgid "@code{critical-power-action} (default: @code{'hybrid-sleep})"
  29389. msgstr ""
  29390. #. type: table
  29391. #: guix-git/doc/guix.texi:19610
  29392. msgid "The action taken when @code{percentage-action} or @code{time-action} is reached (depending on the configuration of @code{use-percentage-for-policy?})."
  29393. msgstr ""
  29394. #. type: table
  29395. #: guix-git/doc/guix.texi:19612
  29396. msgid "Possible values are:"
  29397. msgstr ""
  29398. #. type: code{#1}
  29399. #: guix-git/doc/guix.texi:19616
  29400. msgid "'power-off"
  29401. msgstr ""
  29402. #. type: code{#1}
  29403. #: guix-git/doc/guix.texi:19619
  29404. msgid "'hibernate"
  29405. msgstr ""
  29406. #. type: itemize
  29407. #: guix-git/doc/guix.texi:19622
  29408. msgid "@code{'hybrid-sleep}."
  29409. msgstr ""
  29410. #. type: deffn
  29411. #: guix-git/doc/guix.texi:19627
  29412. #, no-wrap
  29413. msgid "{Scheme Procedure} udisks-service [#:udisks @var{udisks}]"
  29414. msgstr ""
  29415. #. type: deffn
  29416. #: guix-git/doc/guix.texi:19637
  29417. msgid "Return a service for @uref{https://udisks.freedesktop.org/docs/latest/, UDisks}, a @dfn{disk management} daemon that provides user interfaces with notifications and ways to mount/unmount disks. Programs that talk to UDisks include the @command{udisksctl} command, part of UDisks, and GNOME Disks. Note that Udisks relies on the @command{mount} command, so it will only be able to use the file-system utilities installed in the system profile. For example if you want to be able to mount NTFS file-systems in read and write fashion, you'll need to have @code{ntfs-3g} installed system-wide."
  29418. msgstr ""
  29419. #. type: deffn
  29420. #: guix-git/doc/guix.texi:19639
  29421. #, no-wrap
  29422. msgid "{Scheme Variable} colord-service-type"
  29423. msgstr ""
  29424. #. type: deffn
  29425. #: guix-git/doc/guix.texi:19646
  29426. msgid "This is the type of the service that runs @command{colord}, a system service with a D-Bus interface to manage the color profiles of input and output devices such as screens and scanners. It is notably used by the GNOME Color Manager graphical tool. See @uref{https://www.freedesktop.org/software/colord/, the colord web site} for more information."
  29427. msgstr ""
  29428. #. type: cindex
  29429. #: guix-git/doc/guix.texi:19648
  29430. #, no-wrap
  29431. msgid "scanner access"
  29432. msgstr ""
  29433. #. type: defvr
  29434. #: guix-git/doc/guix.texi:19649
  29435. #, no-wrap
  29436. msgid "{Scheme Variable} sane-service-type"
  29437. msgstr ""
  29438. #. type: defvr
  29439. #: guix-git/doc/guix.texi:19655
  29440. msgid "This service provides access to scanners @i{via} @uref{http://www.sane-project.org, SANE} by installing the necessary udev rules. It is included in @code{%desktop-services} (@pxref{Desktop Services}) and relies by default on @code{sane-backends-minimal} package (see below) for hardware support."
  29441. msgstr ""
  29442. #. type: defvr
  29443. #: guix-git/doc/guix.texi:19657
  29444. #, no-wrap
  29445. msgid "{Scheme Variable} sane-backends-minimal"
  29446. msgstr ""
  29447. #. type: defvr
  29448. #: guix-git/doc/guix.texi:19660
  29449. msgid "The default package which the @code{sane-service-type} installs. It supports many recent scanners."
  29450. msgstr ""
  29451. #. type: defvr
  29452. #: guix-git/doc/guix.texi:19662
  29453. #, no-wrap
  29454. msgid "{Scheme Variable} sane-backends"
  29455. msgstr ""
  29456. #. type: defvr
  29457. #: guix-git/doc/guix.texi:19669
  29458. msgid "This package includes support for all scanners that @code{sane-backends-minimal} supports, plus older Hewlett-Packard scanners supported by @code{hplip} package. In order to use this on a system which relies on @code{%desktop-services}, you may use @code{modify-services} (@pxref{Service Reference, @code{modify-services}}) as illustrated below:"
  29459. msgstr ""
  29460. #. type: lisp
  29461. #: guix-git/doc/guix.texi:19678
  29462. #, no-wrap
  29463. msgid ""
  29464. "(use-modules (gnu))\n"
  29465. "(use-service-modules\n"
  29466. " @dots{}\n"
  29467. " desktop)\n"
  29468. "(use-package-modules\n"
  29469. " @dots{}\n"
  29470. " scanner)\n"
  29471. "\n"
  29472. msgstr ""
  29473. #. type: lisp
  29474. #: guix-git/doc/guix.texi:19683
  29475. #, no-wrap
  29476. msgid ""
  29477. "(define %my-desktop-services\n"
  29478. " ;; List of desktop services that supports a broader range of scanners.\n"
  29479. " (modify-services %desktop-services\n"
  29480. " (sane-service-type _ => sane-backends)))\n"
  29481. "\n"
  29482. msgstr ""
  29483. #. type: lisp
  29484. #: guix-git/doc/guix.texi:19687
  29485. #, no-wrap
  29486. msgid ""
  29487. "(operating-system\n"
  29488. " @dots{}\n"
  29489. " (services %my-desktop-services)\n"
  29490. msgstr ""
  29491. #. type: deffn
  29492. #: guix-git/doc/guix.texi:19690
  29493. #, no-wrap
  29494. msgid "{Scheme Procedure} geoclue-application name [#:allowed? #t] [#:system? #f] [#:users '()]"
  29495. msgstr ""
  29496. #. type: deffn
  29497. #: guix-git/doc/guix.texi:19699
  29498. msgid "Return a configuration allowing an application to access GeoClue location data. @var{name} is the Desktop ID of the application, without the @code{.desktop} part. If @var{allowed?} is true, the application will have access to location information by default. The boolean @var{system?} value indicates whether an application is a system component or not. Finally @var{users} is a list of UIDs of all users for which this application is allowed location info access. An empty users list means that all users are allowed."
  29499. msgstr ""
  29500. #. type: defvr
  29501. #: guix-git/doc/guix.texi:19701
  29502. #, no-wrap
  29503. msgid "{Scheme Variable} %standard-geoclue-applications"
  29504. msgstr ""
  29505. #. type: defvr
  29506. #: guix-git/doc/guix.texi:19708
  29507. msgid "The standard list of well-known GeoClue application configurations, granting authority to the GNOME date-and-time utility to ask for the current location in order to set the time zone, and allowing the IceCat and Epiphany web browsers to request location information. IceCat and Epiphany both query the user before allowing a web page to know the user's location."
  29508. msgstr ""
  29509. #. type: deffn
  29510. #: guix-git/doc/guix.texi:19710
  29511. #, no-wrap
  29512. msgid "{Scheme Procedure} geoclue-service [#:colord @var{colord}] @"
  29513. msgstr ""
  29514. #. type: deffn
  29515. #: guix-git/doc/guix.texi:19723
  29516. msgid "[#:whitelist '()] @ [#:wifi-geolocation-url \"https://location.services.mozilla.com/v1/geolocate?key=geoclue\"] @ [#:submit-data? #f] [#:wifi-submission-url \"https://location.services.mozilla.com/v1/submit?key=geoclue\"] @ [#:submission-nick \"geoclue\"] @ [#:applications %standard-geoclue-applications] Return a service that runs the GeoClue location service. This service provides a D-Bus interface to allow applications to request access to a user's physical location, and optionally to add information to online location databases. See @uref{https://wiki.freedesktop.org/www/Software/GeoClue/, the GeoClue web site} for more information."
  29517. msgstr ""
  29518. #. type: deffn
  29519. #: guix-git/doc/guix.texi:19725
  29520. #, no-wrap
  29521. msgid "{Scheme Procedure} bluetooth-service [#:bluez @var{bluez}] @"
  29522. msgstr ""
  29523. #. type: deffn
  29524. #: guix-git/doc/guix.texi:19732
  29525. msgid "[@w{#:auto-enable? #f}] Return a service that runs the @command{bluetoothd} daemon, which manages all the Bluetooth devices and provides a number of D-Bus interfaces. When AUTO-ENABLE? is true, the bluetooth controller is powered automatically at boot, which can be useful when using a bluetooth keyboard or mouse."
  29526. msgstr ""
  29527. #. type: deffn
  29528. #: guix-git/doc/guix.texi:19734
  29529. msgid "Users need to be in the @code{lp} group to access the D-Bus service."
  29530. msgstr ""
  29531. #. type: defvr
  29532. #: guix-git/doc/guix.texi:19736
  29533. #, no-wrap
  29534. msgid "{Scheme Variable} gnome-keyring-service-type"
  29535. msgstr ""
  29536. #. type: defvr
  29537. #: guix-git/doc/guix.texi:19740
  29538. msgid "This is the type of the service that adds the @uref{https://wiki.gnome.org/Projects/GnomeKeyring, GNOME Keyring}. Its value is a @code{gnome-keyring-configuration} object (see below)."
  29539. msgstr ""
  29540. #. type: defvr
  29541. #: guix-git/doc/guix.texi:19744
  29542. msgid "This service adds the @code{gnome-keyring} package to the system profile and extends PAM with entries using @code{pam_gnome_keyring.so}, unlocking a user's login keyring when they log in or setting its password with passwd."
  29543. msgstr ""
  29544. #. type: deftp
  29545. #: guix-git/doc/guix.texi:19746
  29546. #, no-wrap
  29547. msgid "{Data Type} gnome-keyring-configuration"
  29548. msgstr ""
  29549. #. type: deftp
  29550. #: guix-git/doc/guix.texi:19748
  29551. msgid "Configuration record for the GNOME Keyring service."
  29552. msgstr ""
  29553. #. type: item
  29554. #: guix-git/doc/guix.texi:19750
  29555. #, no-wrap
  29556. msgid "@code{keyring} (default: @code{gnome-keyring})"
  29557. msgstr ""
  29558. #. type: table
  29559. #: guix-git/doc/guix.texi:19752
  29560. msgid "The GNOME keyring package to use."
  29561. msgstr ""
  29562. #. type: code{#1}
  29563. #: guix-git/doc/guix.texi:19753
  29564. #, no-wrap
  29565. msgid "pam-services"
  29566. msgstr ""
  29567. #. type: table
  29568. #: guix-git/doc/guix.texi:19758
  29569. msgid "A list of @code{(@var{service} . @var{kind})} pairs denoting PAM services to extend, where @var{service} is the name of an existing service to extend and @var{kind} is one of @code{login} or @code{passwd}."
  29570. msgstr ""
  29571. #. type: table
  29572. #: guix-git/doc/guix.texi:19764
  29573. msgid "If @code{login} is given, it adds an optional @code{pam_gnome_keyring.so} to the auth block without arguments and to the session block with @code{auto_start}. If @code{passwd} is given, it adds an optional @code{pam_gnome_keyring.so} to the password block without arguments."
  29574. msgstr ""
  29575. #. type: table
  29576. #: guix-git/doc/guix.texi:19767
  29577. msgid "By default, this field contains ``gdm-password'' with the value @code{login} and ``passwd'' is with the value @code{passwd}."
  29578. msgstr ""
  29579. #. type: cindex
  29580. #: guix-git/doc/guix.texi:19774
  29581. #, no-wrap
  29582. msgid "sound support"
  29583. msgstr ""
  29584. #. type: cindex
  29585. #: guix-git/doc/guix.texi:19775
  29586. #, no-wrap
  29587. msgid "ALSA"
  29588. msgstr ""
  29589. #. type: cindex
  29590. #: guix-git/doc/guix.texi:19776
  29591. #, no-wrap
  29592. msgid "PulseAudio, sound support"
  29593. msgstr ""
  29594. #. type: Plain text
  29595. #: guix-git/doc/guix.texi:19781
  29596. msgid "The @code{(gnu services sound)} module provides a service to configure the Advanced Linux Sound Architecture (ALSA) system, which makes PulseAudio the preferred ALSA output driver."
  29597. msgstr ""
  29598. #. type: deffn
  29599. #: guix-git/doc/guix.texi:19782
  29600. #, no-wrap
  29601. msgid "{Scheme Variable} alsa-service-type"
  29602. msgstr ""
  29603. #. type: deffn
  29604. #: guix-git/doc/guix.texi:19787
  29605. msgid "This is the type for the @uref{https://alsa-project.org/, Advanced Linux Sound Architecture} (ALSA) system, which generates the @file{/etc/asound.conf} configuration file. The value for this type is a @command{alsa-configuration} record as in this example:"
  29606. msgstr ""
  29607. #. type: lisp
  29608. #: guix-git/doc/guix.texi:19790
  29609. #, no-wrap
  29610. msgid "(service alsa-service-type)\n"
  29611. msgstr ""
  29612. #. type: deffn
  29613. #: guix-git/doc/guix.texi:19793
  29614. msgid "See below for details about @code{alsa-configuration}."
  29615. msgstr ""
  29616. #. type: deftp
  29617. #: guix-git/doc/guix.texi:19795
  29618. #, no-wrap
  29619. msgid "{Data Type} alsa-configuration"
  29620. msgstr ""
  29621. #. type: deftp
  29622. #: guix-git/doc/guix.texi:19797
  29623. msgid "Data type representing the configuration for @code{alsa-service}."
  29624. msgstr ""
  29625. #. type: item
  29626. #: guix-git/doc/guix.texi:19799
  29627. #, no-wrap
  29628. msgid "@code{alsa-plugins} (default: @var{alsa-plugins})"
  29629. msgstr ""
  29630. #. type: table
  29631. #: guix-git/doc/guix.texi:19801
  29632. msgid "@code{alsa-plugins} package to use."
  29633. msgstr ""
  29634. #. type: item
  29635. #: guix-git/doc/guix.texi:19802
  29636. #, no-wrap
  29637. msgid "@code{pulseaudio?} (default: @var{#t})"
  29638. msgstr ""
  29639. #. type: table
  29640. #: guix-git/doc/guix.texi:19805
  29641. msgid "Whether ALSA applications should transparently be made to use the @uref{https://www.pulseaudio.org/, PulseAudio} sound server."
  29642. msgstr ""
  29643. #. type: table
  29644. #: guix-git/doc/guix.texi:19809
  29645. msgid "Using PulseAudio allows you to run several sound-producing applications at the same time and to individual control them @i{via} @command{pavucontrol}, among other things."
  29646. msgstr ""
  29647. #. type: item
  29648. #: guix-git/doc/guix.texi:19810
  29649. #, no-wrap
  29650. msgid "@code{extra-options} (default: @var{\"\"})"
  29651. msgstr ""
  29652. #. type: table
  29653. #: guix-git/doc/guix.texi:19812
  29654. msgid "String to append to the @file{/etc/asound.conf} file."
  29655. msgstr ""
  29656. #. type: Plain text
  29657. #: guix-git/doc/guix.texi:19818
  29658. msgid "Individual users who want to override the system configuration of ALSA can do it with the @file{~/.asoundrc} file:"
  29659. msgstr ""
  29660. #. type: example
  29661. #: guix-git/doc/guix.texi:19824
  29662. #, no-wrap
  29663. msgid ""
  29664. "# In guix, we have to specify the absolute path for plugins.\n"
  29665. "pcm_type.jack @{\n"
  29666. " lib \"/home/alice/.guix-profile/lib/alsa-lib/libasound_module_pcm_jack.so\"\n"
  29667. "@}\n"
  29668. "\n"
  29669. msgstr ""
  29670. #. type: example
  29671. #: guix-git/doc/guix.texi:19833
  29672. #, no-wrap
  29673. msgid ""
  29674. "# Routing ALSA to jack:\n"
  29675. "# <http://jackaudio.org/faq/routing_alsa.html>.\n"
  29676. "pcm.rawjack @{\n"
  29677. " type jack\n"
  29678. " playback_ports @{\n"
  29679. " 0 system:playback_1\n"
  29680. " 1 system:playback_2\n"
  29681. " @}\n"
  29682. "\n"
  29683. msgstr ""
  29684. #. type: example
  29685. #: guix-git/doc/guix.texi:19839
  29686. #, no-wrap
  29687. msgid ""
  29688. " capture_ports @{\n"
  29689. " 0 system:capture_1\n"
  29690. " 1 system:capture_2\n"
  29691. " @}\n"
  29692. "@}\n"
  29693. "\n"
  29694. msgstr ""
  29695. #. type: example
  29696. #: guix-git/doc/guix.texi:19846
  29697. #, no-wrap
  29698. msgid ""
  29699. "pcm.!default @{\n"
  29700. " type plug\n"
  29701. " slave @{\n"
  29702. " pcm \"rawjack\"\n"
  29703. " @}\n"
  29704. "@}\n"
  29705. msgstr ""
  29706. #. type: Plain text
  29707. #: guix-git/doc/guix.texi:19850
  29708. msgid "See @uref{https://www.alsa-project.org/main/index.php/Asoundrc} for the details."
  29709. msgstr ""
  29710. #. type: deffn
  29711. #: guix-git/doc/guix.texi:19851
  29712. #, no-wrap
  29713. msgid "{Scheme Variable} pulseaudio-service-type"
  29714. msgstr ""
  29715. #. type: deffn
  29716. #: guix-git/doc/guix.texi:19855
  29717. msgid "This is the type for the @uref{https://www.pulseaudio.org/, PulseAudio} sound server. It exists to allow system overrides of the default settings via @code{pulseaudio-configuration}, see below."
  29718. msgstr ""
  29719. #. type: quotation
  29720. #: guix-git/doc/guix.texi:19861
  29721. msgid "This service overrides per-user configuration files. If you want PulseAudio to honor configuration files in @file{~/.config/pulse} you have to unset the environment variables @env{PULSE_CONFIG} and @env{PULSE_CLIENTCONFIG} in your @file{~/.bash_profile}."
  29722. msgstr ""
  29723. #. type: quotation
  29724. #: guix-git/doc/guix.texi:19869
  29725. msgid "This service on its own does not ensure, that the @code{pulseaudio} package exists on your machine. It merely adds configuration files for it, as detailed below. In the (admittedly unlikely) case, that you find yourself without a @code{pulseaudio} package, consider enabling it through the @code{alsa-service-type} above."
  29726. msgstr ""
  29727. #. type: deftp
  29728. #: guix-git/doc/guix.texi:19872
  29729. #, no-wrap
  29730. msgid "{Data Type} pulseaudio-configuration"
  29731. msgstr ""
  29732. #. type: deftp
  29733. #: guix-git/doc/guix.texi:19874
  29734. msgid "Data type representing the configuration for @code{pulseaudio-service}."
  29735. msgstr ""
  29736. #. type: item
  29737. #: guix-git/doc/guix.texi:19876
  29738. #, no-wrap
  29739. msgid "@code{client-conf} (default: @code{'()})"
  29740. msgstr ""
  29741. #. type: table
  29742. #: guix-git/doc/guix.texi:19881
  29743. msgid "List of settings to set in @file{client.conf}. Accepts a list of strings or a symbol-value pairs. A string will be inserted as-is with a newline added. A pair will be formatted as ``key = value'', again with a newline added."
  29744. msgstr ""
  29745. #. type: item
  29746. #: guix-git/doc/guix.texi:19882
  29747. #, no-wrap
  29748. msgid "@code{daemon-conf} (default: @code{'((flat-volumes . no))})"
  29749. msgstr ""
  29750. #. type: table
  29751. #: guix-git/doc/guix.texi:19885
  29752. msgid "List of settings to set in @file{daemon.conf}, formatted just like @var{client-conf}."
  29753. msgstr ""
  29754. #. type: item
  29755. #: guix-git/doc/guix.texi:19886
  29756. #, no-wrap
  29757. msgid "@code{script-file} (default: @code{(file-append pulseaudio \"/etc/pulse/default.pa\")})"
  29758. msgstr ""
  29759. #. type: table
  29760. #: guix-git/doc/guix.texi:19888
  29761. msgid "Script file to use as @file{default.pa}."
  29762. msgstr ""
  29763. #. type: item
  29764. #: guix-git/doc/guix.texi:19889
  29765. #, no-wrap
  29766. msgid "@code{system-script-file} (default: @code{(file-append pulseaudio \"/etc/pulse/system.pa\")})"
  29767. msgstr ""
  29768. #. type: table
  29769. #: guix-git/doc/guix.texi:19891
  29770. msgid "Script file to use as @file{system.pa}."
  29771. msgstr ""
  29772. #. type: deffn
  29773. #: guix-git/doc/guix.texi:19894
  29774. #, no-wrap
  29775. msgid "{Scheme Variable} ladspa-service-type"
  29776. msgstr ""
  29777. #. type: deffn
  29778. #: guix-git/doc/guix.texi:19897
  29779. msgid "This service sets the @var{LADSPA_PATH} variable, so that programs, which respect it, e.g. PulseAudio, can load LADSPA plugins."
  29780. msgstr ""
  29781. #. type: deffn
  29782. #: guix-git/doc/guix.texi:19900
  29783. msgid "The following example will setup the service to enable modules from the @code{swh-plugins} package:"
  29784. msgstr ""
  29785. #. type: lisp
  29786. #: guix-git/doc/guix.texi:19904
  29787. #, no-wrap
  29788. msgid ""
  29789. "(service ladspa-service-type\n"
  29790. " (ladspa-configuration (plugins (list swh-plugins))))\n"
  29791. msgstr ""
  29792. #. type: deffn
  29793. #: guix-git/doc/guix.texi:19908
  29794. msgid "See @uref{http://plugin.org.uk/ladspa-swh/docs/ladspa-swh.html} for the details."
  29795. msgstr ""
  29796. #. type: cindex
  29797. #: guix-git/doc/guix.texi:19915
  29798. #, no-wrap
  29799. msgid "SQL"
  29800. msgstr ""
  29801. #. type: Plain text
  29802. #: guix-git/doc/guix.texi:19917
  29803. msgid "The @code{(gnu services databases)} module provides the following services."
  29804. msgstr ""
  29805. #. type: subsubheading
  29806. #: guix-git/doc/guix.texi:19918
  29807. #, no-wrap
  29808. msgid "PostgreSQL"
  29809. msgstr ""
  29810. #. type: Plain text
  29811. #: guix-git/doc/guix.texi:19922
  29812. msgid "The following example describes a PostgreSQL service with the default configuration."
  29813. msgstr ""
  29814. #. type: lisp
  29815. #: guix-git/doc/guix.texi:19927
  29816. #, no-wrap
  29817. msgid ""
  29818. "(service postgresql-service-type\n"
  29819. " (postgresql-configuration\n"
  29820. " (postgresql postgresql-10)))\n"
  29821. msgstr ""
  29822. #. type: Plain text
  29823. #: guix-git/doc/guix.texi:19933
  29824. msgid "If the services fails to start, it may be due to an incompatible cluster already present in @var{data-directory}. Adjust it (or, if you don't need the cluster anymore, delete @var{data-directory}), then restart the service."
  29825. msgstr ""
  29826. #. type: Plain text
  29827. #: guix-git/doc/guix.texi:19940
  29828. msgid "Peer authentication is used by default and the @code{postgres} user account has no shell, which prevents the direct execution of @code{psql} commands as this user. To use @code{psql}, you can temporarily log in as @code{postgres} using a shell, create a PostgreSQL superuser with the same name as one of the system users and then create the associated database."
  29829. msgstr ""
  29830. #. type: example
  29831. #: guix-git/doc/guix.texi:19945
  29832. #, no-wrap
  29833. msgid ""
  29834. "sudo -u postgres -s /bin/sh\n"
  29835. "createuser --interactive\n"
  29836. "createdb $MY_USER_LOGIN # Replace appropriately.\n"
  29837. msgstr ""
  29838. #. type: deftp
  29839. #: guix-git/doc/guix.texi:19947
  29840. #, no-wrap
  29841. msgid "{Data Type} postgresql-configuration"
  29842. msgstr ""
  29843. #. type: deftp
  29844. #: guix-git/doc/guix.texi:19950
  29845. msgid "Data type representing the configuration for the @code{postgresql-service-type}."
  29846. msgstr ""
  29847. #. type: code{#1}
  29848. #: guix-git/doc/guix.texi:19952
  29849. #, no-wrap
  29850. msgid "postgresql"
  29851. msgstr ""
  29852. #. type: table
  29853. #: guix-git/doc/guix.texi:19954
  29854. msgid "PostgreSQL package to use for the service."
  29855. msgstr ""
  29856. #. type: item
  29857. #: guix-git/doc/guix.texi:19955
  29858. #, no-wrap
  29859. msgid "@code{port} (default: @code{5432})"
  29860. msgstr ""
  29861. #. type: table
  29862. #: guix-git/doc/guix.texi:19957
  29863. msgid "Port on which PostgreSQL should listen."
  29864. msgstr ""
  29865. #. type: table
  29866. #: guix-git/doc/guix.texi:19960
  29867. msgid "Locale to use as the default when creating the database cluster."
  29868. msgstr ""
  29869. #. type: item
  29870. #: guix-git/doc/guix.texi:19961
  29871. #, no-wrap
  29872. msgid "@code{config-file} (default: @code{(postgresql-config-file)})"
  29873. msgstr ""
  29874. #. type: table
  29875. #: guix-git/doc/guix.texi:19965
  29876. msgid "The configuration file to use when running PostgreSQL@. The default behaviour uses the postgresql-config-file record with the default values for the fields."
  29877. msgstr ""
  29878. #. type: item
  29879. #: guix-git/doc/guix.texi:19966
  29880. #, no-wrap
  29881. msgid "@code{log-directory} (default: @code{\"/var/log/postgresql\"})"
  29882. msgstr ""
  29883. #. type: table
  29884. #: guix-git/doc/guix.texi:19970
  29885. msgid "The directory where @command{pg_ctl} output will be written in a file named @code{\"pg_ctl.log\"}. This file can be useful to debug PostgreSQL configuration errors for instance."
  29886. msgstr ""
  29887. #. type: item
  29888. #: guix-git/doc/guix.texi:19971
  29889. #, no-wrap
  29890. msgid "@code{data-directory} (default: @code{\"/var/lib/postgresql/data\"})"
  29891. msgstr ""
  29892. #. type: table
  29893. #: guix-git/doc/guix.texi:19973
  29894. msgid "Directory in which to store the data."
  29895. msgstr ""
  29896. #. type: item
  29897. #: guix-git/doc/guix.texi:19974
  29898. #, no-wrap
  29899. msgid "@code{extension-packages} (default: @code{'()})"
  29900. msgstr ""
  29901. #. type: cindex
  29902. #: guix-git/doc/guix.texi:19975
  29903. #, no-wrap
  29904. msgid "postgresql extension-packages"
  29905. msgstr ""
  29906. #. type: table
  29907. #: guix-git/doc/guix.texi:19980
  29908. msgid "Additional extensions are loaded from packages listed in @var{extension-packages}. Extensions are available at runtime. For instance, to create a geographic database using the @code{postgis} extension, a user can configure the postgresql-service as in this example:"
  29909. msgstr ""
  29910. #. type: cindex
  29911. #: guix-git/doc/guix.texi:19981
  29912. #, no-wrap
  29913. msgid "postgis"
  29914. msgstr ""
  29915. #. type: lisp
  29916. #: guix-git/doc/guix.texi:19984
  29917. #, no-wrap
  29918. msgid ""
  29919. "(use-package-modules databases geo)\n"
  29920. "\n"
  29921. msgstr ""
  29922. #. type: lisp
  29923. #: guix-git/doc/guix.texi:19997
  29924. #, no-wrap
  29925. msgid ""
  29926. "(operating-system\n"
  29927. " ...\n"
  29928. " ;; postgresql is required to run `psql' but postgis is not required for\n"
  29929. " ;; proper operation.\n"
  29930. " (packages (cons* postgresql %base-packages))\n"
  29931. " (services\n"
  29932. " (cons*\n"
  29933. " (service postgresql-service-type\n"
  29934. " (postgresql-configuration\n"
  29935. " (postgresql postgresql-10)\n"
  29936. " (extension-packages (list postgis))))\n"
  29937. " %base-services)))\n"
  29938. msgstr ""
  29939. #. type: table
  29940. #: guix-git/doc/guix.texi:20001
  29941. msgid "Then the extension becomes visible and you can initialise an empty geographic database in this way:"
  29942. msgstr ""
  29943. #. type: example
  29944. #: guix-git/doc/guix.texi:20008
  29945. #, no-wrap
  29946. msgid ""
  29947. "psql -U postgres\n"
  29948. "> create database postgistest;\n"
  29949. "> \\connect postgistest;\n"
  29950. "> create extension postgis;\n"
  29951. "> create extension postgis_topology;\n"
  29952. msgstr ""
  29953. #. type: table
  29954. #: guix-git/doc/guix.texi:20013
  29955. msgid "There is no need to add this field for contrib extensions such as hstore or dblink as they are already loadable by postgresql. This field is only required to add extensions provided by other packages."
  29956. msgstr ""
  29957. #. type: deftp
  29958. #: guix-git/doc/guix.texi:20017
  29959. #, no-wrap
  29960. msgid "{Data Type} postgresql-config-file"
  29961. msgstr ""
  29962. #. type: deftp
  29963. #: guix-git/doc/guix.texi:20023
  29964. msgid "Data type representing the PostgreSQL configuration file. As shown in the following example, this can be used to customize the configuration of PostgreSQL@. Note that you can use any G-expression or filename in place of this record, if you already have a configuration file you'd like to use for example."
  29965. msgstr ""
  29966. #. type: lisp
  29967. #: guix-git/doc/guix.texi:20043
  29968. #, no-wrap
  29969. msgid ""
  29970. "(service postgresql-service-type\n"
  29971. " (postgresql-configuration\n"
  29972. " (config-file\n"
  29973. " (postgresql-config-file\n"
  29974. " (log-destination \"stderr\")\n"
  29975. " (hba-file\n"
  29976. " (plain-file \"pg_hba.conf\"\n"
  29977. " \"\n"
  29978. "local\tall\tall\t\t\ttrust\n"
  29979. "host\tall\tall\t127.0.0.1/32 \tmd5\n"
  29980. "host\tall\tall\t::1/128 \tmd5\"))\n"
  29981. " (extra-config\n"
  29982. " '((\"session_preload_libraries\" \"auto_explain\")\n"
  29983. " (\"random_page_cost\" 2)\n"
  29984. " (\"auto_explain.log_min_duration\" \"100 ms\")\n"
  29985. " (\"work_mem\" \"500 MB\")\n"
  29986. " (\"logging_collector\" #t)\n"
  29987. " (\"log_directory\" \"/var/log/postgresql\")))))))\n"
  29988. msgstr ""
  29989. #. type: item
  29990. #: guix-git/doc/guix.texi:20046
  29991. #, no-wrap
  29992. msgid "@code{log-destination} (default: @code{\"syslog\"})"
  29993. msgstr ""
  29994. #. type: table
  29995. #: guix-git/doc/guix.texi:20049
  29996. msgid "The logging method to use for PostgreSQL@. Multiple values are accepted, separated by commas."
  29997. msgstr ""
  29998. #. type: item
  29999. #: guix-git/doc/guix.texi:20050
  30000. #, no-wrap
  30001. msgid "@code{hba-file} (default: @code{%default-postgres-hba})"
  30002. msgstr ""
  30003. #. type: table
  30004. #: guix-git/doc/guix.texi:20053
  30005. msgid "Filename or G-expression for the host-based authentication configuration."
  30006. msgstr ""
  30007. #. type: item
  30008. #: guix-git/doc/guix.texi:20054
  30009. #, no-wrap
  30010. msgid "@code{ident-file} (default: @code{%default-postgres-ident})"
  30011. msgstr ""
  30012. #. type: table
  30013. #: guix-git/doc/guix.texi:20056
  30014. msgid "Filename or G-expression for the user name mapping configuration."
  30015. msgstr ""
  30016. #. type: item
  30017. #: guix-git/doc/guix.texi:20057
  30018. #, no-wrap
  30019. msgid "@code{socket-directory} (default: @code{#false})"
  30020. msgstr ""
  30021. #. type: table
  30022. #: guix-git/doc/guix.texi:20062
  30023. msgid "Specifies the directory of the Unix-domain socket(s) on which PostgreSQL is to listen for connections from client applications. If set to @code{\"\"} PostgreSQL does not listen on any Unix-domain sockets, in which case only TCP/IP sockets can be used to connect to the server."
  30024. msgstr ""
  30025. #. type: table
  30026. #: guix-git/doc/guix.texi:20065
  30027. msgid "By default, the @code{#false} value means the PostgreSQL default value will be used, which is currently @samp{/tmp}."
  30028. msgstr ""
  30029. #. type: table
  30030. #: guix-git/doc/guix.texi:20070
  30031. msgid "List of additional keys and values to include in the PostgreSQL config file. Each entry in the list should be a list where the first element is the key, and the remaining elements are the values."
  30032. msgstr ""
  30033. #. type: table
  30034. #: guix-git/doc/guix.texi:20076
  30035. msgid "The values can be numbers, booleans or strings and will be mapped to PostgreSQL parameters types @code{Boolean}, @code{String}, @code{Numeric}, @code{Numeric with Unit} and @code{Enumerated} described @uref{https://www.postgresql.org/docs/current/config-setting.html, here}."
  30036. msgstr ""
  30037. #. type: deffn
  30038. #: guix-git/doc/guix.texi:20080
  30039. #, no-wrap
  30040. msgid "{Scheme Variable} postgresql-role-service-type"
  30041. msgstr ""
  30042. #. type: deffn
  30043. #: guix-git/doc/guix.texi:20083
  30044. msgid "This service allows to create PostgreSQL roles and databases after PostgreSQL service start. Here is an example of its use."
  30045. msgstr ""
  30046. #. type: lisp
  30047. #: guix-git/doc/guix.texi:20091
  30048. #, no-wrap
  30049. msgid ""
  30050. "(service postgresql-role-service-type\n"
  30051. " (postgresql-role-configuration\n"
  30052. " (roles\n"
  30053. " (list (postgresql-role\n"
  30054. " (name \"test\")\n"
  30055. " (create-database? #t))))))\n"
  30056. msgstr ""
  30057. #. type: deffn
  30058. #: guix-git/doc/guix.texi:20095
  30059. msgid "This service can be extended with extra roles, as in this example:"
  30060. msgstr ""
  30061. #. type: lisp
  30062. #: guix-git/doc/guix.texi:20101
  30063. #, no-wrap
  30064. msgid ""
  30065. "(service-extension postgresql-role-service-type\n"
  30066. " (const (postgresql-role\n"
  30067. " (name \"alice\")\n"
  30068. " (create-database? #t))))\n"
  30069. msgstr ""
  30070. #. type: deftp
  30071. #: guix-git/doc/guix.texi:20104
  30072. #, no-wrap
  30073. msgid "{Data Type} postgresql-role"
  30074. msgstr ""
  30075. #. type: deftp
  30076. #: guix-git/doc/guix.texi:20110
  30077. msgid "PostgreSQL manages database access permissions using the concept of roles. A role can be thought of as either a database user, or a group of database users, depending on how the role is set up. Roles can own database objects (for example, tables) and can assign privileges on those objects to other roles to control who has access to which objects."
  30078. msgstr ""
  30079. #. type: table
  30080. #: guix-git/doc/guix.texi:20114
  30081. msgid "The role name."
  30082. msgstr ""
  30083. #. type: item
  30084. #: guix-git/doc/guix.texi:20115
  30085. #, no-wrap
  30086. msgid "@code{permissions} (default: @code{'(createdb login)})"
  30087. msgstr ""
  30088. #. type: table
  30089. #: guix-git/doc/guix.texi:20119
  30090. msgid "The role permissions list. Supported permissions are @code{bypassrls}, @code{createdb}, @code{createrole}, @code{login}, @code{replication} and @code{superuser}."
  30091. msgstr ""
  30092. #. type: item
  30093. #: guix-git/doc/guix.texi:20120
  30094. #, no-wrap
  30095. msgid "@code{create-database?} (default: @code{#f})"
  30096. msgstr ""
  30097. #. type: table
  30098. #: guix-git/doc/guix.texi:20122
  30099. msgid "Whether to create a database with the same name as the role."
  30100. msgstr ""
  30101. #. type: deftp
  30102. #: guix-git/doc/guix.texi:20126
  30103. #, no-wrap
  30104. msgid "{Data Type} postgresql-role-configuration"
  30105. msgstr ""
  30106. #. type: deftp
  30107. #: guix-git/doc/guix.texi:20129
  30108. msgid "Data type representing the configuration of @var{postgresql-role-service-type}."
  30109. msgstr ""
  30110. #. type: item
  30111. #: guix-git/doc/guix.texi:20131
  30112. #, no-wrap
  30113. msgid "@code{host} (default: @code{\"/var/run/postgresql\"})"
  30114. msgstr ""
  30115. #. type: table
  30116. #: guix-git/doc/guix.texi:20133
  30117. msgid "The PostgreSQL host to connect to."
  30118. msgstr ""
  30119. #. type: item
  30120. #: guix-git/doc/guix.texi:20134
  30121. #, no-wrap
  30122. msgid "@code{log} (default: @code{\"/var/log/postgresql_roles.log\"})"
  30123. msgstr ""
  30124. #. type: table
  30125. #: guix-git/doc/guix.texi:20136
  30126. msgid "File name of the log file."
  30127. msgstr ""
  30128. #. type: item
  30129. #: guix-git/doc/guix.texi:20137
  30130. #, no-wrap
  30131. msgid "@code{roles} (default: @code{'()})"
  30132. msgstr ""
  30133. #. type: table
  30134. #: guix-git/doc/guix.texi:20139
  30135. msgid "The initial PostgreSQL roles to create."
  30136. msgstr ""
  30137. #. type: subsubheading
  30138. #: guix-git/doc/guix.texi:20142
  30139. #, no-wrap
  30140. msgid "MariaDB/MySQL"
  30141. msgstr ""
  30142. #. type: defvr
  30143. #: guix-git/doc/guix.texi:20144
  30144. #, no-wrap
  30145. msgid "{Scheme Variable} mysql-service-type"
  30146. msgstr ""
  30147. #. type: defvr
  30148. #: guix-git/doc/guix.texi:20148
  30149. msgid "This is the service type for a MySQL or MariaDB database server. Its value is a @code{mysql-configuration} object that specifies which package to use, as well as various settings for the @command{mysqld} daemon."
  30150. msgstr ""
  30151. #. type: deftp
  30152. #: guix-git/doc/guix.texi:20150
  30153. #, no-wrap
  30154. msgid "{Data Type} mysql-configuration"
  30155. msgstr ""
  30156. #. type: deftp
  30157. #: guix-git/doc/guix.texi:20152
  30158. msgid "Data type representing the configuration of @var{mysql-service-type}."
  30159. msgstr ""
  30160. #. type: item
  30161. #: guix-git/doc/guix.texi:20154
  30162. #, no-wrap
  30163. msgid "@code{mysql} (default: @var{mariadb})"
  30164. msgstr ""
  30165. #. type: table
  30166. #: guix-git/doc/guix.texi:20157
  30167. msgid "Package object of the MySQL database server, can be either @var{mariadb} or @var{mysql}."
  30168. msgstr ""
  30169. #. type: table
  30170. #: guix-git/doc/guix.texi:20160
  30171. msgid "For MySQL, a temporary root password will be displayed at activation time. For MariaDB, the root password is empty."
  30172. msgstr ""
  30173. #. type: item
  30174. #: guix-git/doc/guix.texi:20161 guix-git/doc/guix.texi:23981
  30175. #, no-wrap
  30176. msgid "@code{bind-address} (default: @code{\"127.0.0.1\"})"
  30177. msgstr ""
  30178. #. type: table
  30179. #: guix-git/doc/guix.texi:20164
  30180. msgid "The IP on which to listen for network connections. Use @code{\"0.0.0.0\"} to bind to all available network interfaces."
  30181. msgstr ""
  30182. #. type: item
  30183. #: guix-git/doc/guix.texi:20165
  30184. #, no-wrap
  30185. msgid "@code{port} (default: @code{3306})"
  30186. msgstr ""
  30187. #. type: table
  30188. #: guix-git/doc/guix.texi:20167
  30189. msgid "TCP port on which the database server listens for incoming connections."
  30190. msgstr ""
  30191. #. type: item
  30192. #: guix-git/doc/guix.texi:20168
  30193. #, no-wrap
  30194. msgid "@code{socket} (default: @code{\"/run/mysqld/mysqld.sock\"})"
  30195. msgstr ""
  30196. #. type: table
  30197. #: guix-git/doc/guix.texi:20170
  30198. msgid "Socket file to use for local (non-network) connections."
  30199. msgstr ""
  30200. #. type: table
  30201. #: guix-git/doc/guix.texi:20173
  30202. msgid "Additional settings for the @file{my.cnf} configuration file."
  30203. msgstr ""
  30204. #. type: item
  30205. #: guix-git/doc/guix.texi:20174
  30206. #, no-wrap
  30207. msgid "@code{extra-environment} (default: @code{#~'()})"
  30208. msgstr ""
  30209. #. type: table
  30210. #: guix-git/doc/guix.texi:20176
  30211. msgid "List of environment variables passed to the @command{mysqld} process."
  30212. msgstr ""
  30213. #. type: item
  30214. #: guix-git/doc/guix.texi:20177
  30215. #, no-wrap
  30216. msgid "@code{auto-upgrade?} (default: @code{#t})"
  30217. msgstr ""
  30218. #. type: table
  30219. #: guix-git/doc/guix.texi:20182
  30220. msgid "Whether to automatically run @command{mysql_upgrade} after starting the service. This is necessary to upgrade the @dfn{system schema} after ``major'' updates (such as switching from MariaDB 10.4 to 10.5), but can be disabled if you would rather do that manually."
  30221. msgstr ""
  30222. #. type: subsubheading
  30223. #: guix-git/doc/guix.texi:20186
  30224. #, no-wrap
  30225. msgid "Memcached"
  30226. msgstr ""
  30227. #. type: defvr
  30228. #: guix-git/doc/guix.texi:20188
  30229. #, no-wrap
  30230. msgid "{Scheme Variable} memcached-service-type"
  30231. msgstr ""
  30232. #. type: defvr
  30233. #: guix-git/doc/guix.texi:20192
  30234. msgid "This is the service type for the @uref{https://memcached.org/, Memcached} service, which provides a distributed in memory cache. The value for the service type is a @code{memcached-configuration} object."
  30235. msgstr ""
  30236. #. type: lisp
  30237. #: guix-git/doc/guix.texi:20196
  30238. #, no-wrap
  30239. msgid "(service memcached-service-type)\n"
  30240. msgstr ""
  30241. #. type: deftp
  30242. #: guix-git/doc/guix.texi:20198
  30243. #, no-wrap
  30244. msgid "{Data Type} memcached-configuration"
  30245. msgstr ""
  30246. #. type: deftp
  30247. #: guix-git/doc/guix.texi:20200
  30248. msgid "Data type representing the configuration of memcached."
  30249. msgstr ""
  30250. #. type: item
  30251. #: guix-git/doc/guix.texi:20202
  30252. #, no-wrap
  30253. msgid "@code{memcached} (default: @code{memcached})"
  30254. msgstr ""
  30255. #. type: table
  30256. #: guix-git/doc/guix.texi:20204
  30257. msgid "The Memcached package to use."
  30258. msgstr ""
  30259. #. type: item
  30260. #: guix-git/doc/guix.texi:20205
  30261. #, no-wrap
  30262. msgid "@code{interfaces} (default: @code{'(\"0.0.0.0\")})"
  30263. msgstr ""
  30264. #. type: table
  30265. #: guix-git/doc/guix.texi:20207
  30266. msgid "Network interfaces on which to listen."
  30267. msgstr ""
  30268. #. type: item
  30269. #: guix-git/doc/guix.texi:20208
  30270. #, no-wrap
  30271. msgid "@code{tcp-port} (default: @code{11211})"
  30272. msgstr ""
  30273. #. type: table
  30274. #: guix-git/doc/guix.texi:20210
  30275. msgid "Port on which to accept connections."
  30276. msgstr ""
  30277. #. type: item
  30278. #: guix-git/doc/guix.texi:20211
  30279. #, no-wrap
  30280. msgid "@code{udp-port} (default: @code{11211})"
  30281. msgstr ""
  30282. #. type: table
  30283. #: guix-git/doc/guix.texi:20214
  30284. msgid "Port on which to accept UDP connections on, a value of 0 will disable listening on a UDP socket."
  30285. msgstr ""
  30286. #. type: item
  30287. #: guix-git/doc/guix.texi:20215
  30288. #, no-wrap
  30289. msgid "@code{additional-options} (default: @code{'()})"
  30290. msgstr ""
  30291. #. type: table
  30292. #: guix-git/doc/guix.texi:20217
  30293. msgid "Additional command line options to pass to @code{memcached}."
  30294. msgstr ""
  30295. #. type: subsubheading
  30296. #: guix-git/doc/guix.texi:20220
  30297. #, no-wrap
  30298. msgid "Redis"
  30299. msgstr ""
  30300. #. type: defvr
  30301. #: guix-git/doc/guix.texi:20222
  30302. #, no-wrap
  30303. msgid "{Scheme Variable} redis-service-type"
  30304. msgstr ""
  30305. #. type: defvr
  30306. #: guix-git/doc/guix.texi:20225
  30307. msgid "This is the service type for the @uref{https://redis.io/, Redis} key/value store, whose value is a @code{redis-configuration} object."
  30308. msgstr ""
  30309. #. type: deftp
  30310. #: guix-git/doc/guix.texi:20227
  30311. #, no-wrap
  30312. msgid "{Data Type} redis-configuration"
  30313. msgstr ""
  30314. #. type: deftp
  30315. #: guix-git/doc/guix.texi:20229
  30316. msgid "Data type representing the configuration of redis."
  30317. msgstr ""
  30318. #. type: item
  30319. #: guix-git/doc/guix.texi:20231
  30320. #, no-wrap
  30321. msgid "@code{redis} (default: @code{redis})"
  30322. msgstr ""
  30323. #. type: table
  30324. #: guix-git/doc/guix.texi:20233
  30325. msgid "The Redis package to use."
  30326. msgstr ""
  30327. #. type: item
  30328. #: guix-git/doc/guix.texi:20234
  30329. #, no-wrap
  30330. msgid "@code{bind} (default: @code{\"127.0.0.1\"})"
  30331. msgstr ""
  30332. #. type: table
  30333. #: guix-git/doc/guix.texi:20236
  30334. msgid "Network interface on which to listen."
  30335. msgstr ""
  30336. #. type: item
  30337. #: guix-git/doc/guix.texi:20237
  30338. #, no-wrap
  30339. msgid "@code{port} (default: @code{6379})"
  30340. msgstr ""
  30341. #. type: table
  30342. #: guix-git/doc/guix.texi:20240
  30343. msgid "Port on which to accept connections on, a value of 0 will disable listening on a TCP socket."
  30344. msgstr ""
  30345. #. type: item
  30346. #: guix-git/doc/guix.texi:20241
  30347. #, no-wrap
  30348. msgid "@code{working-directory} (default: @code{\"/var/lib/redis\"})"
  30349. msgstr ""
  30350. #. type: table
  30351. #: guix-git/doc/guix.texi:20243
  30352. msgid "Directory in which to store the database and related files."
  30353. msgstr ""
  30354. #. type: cindex
  30355. #: guix-git/doc/guix.texi:20249
  30356. #, no-wrap
  30357. msgid "mail"
  30358. msgstr ""
  30359. #. type: cindex
  30360. #: guix-git/doc/guix.texi:20250
  30361. #, no-wrap
  30362. msgid "email"
  30363. msgstr ""
  30364. #. type: Plain text
  30365. #: guix-git/doc/guix.texi:20255
  30366. msgid "The @code{(gnu services mail)} module provides Guix service definitions for email services: IMAP, POP3, and LMTP servers, as well as mail transport agents (MTAs). Lots of acronyms! These services are detailed in the subsections below."
  30367. msgstr ""
  30368. #. type: subsubheading
  30369. #: guix-git/doc/guix.texi:20256
  30370. #, no-wrap
  30371. msgid "Dovecot Service"
  30372. msgstr ""
  30373. #. type: deffn
  30374. #: guix-git/doc/guix.texi:20258
  30375. #, no-wrap
  30376. msgid "{Scheme Procedure} dovecot-service [#:config (dovecot-configuration)]"
  30377. msgstr ""
  30378. #. type: deffn
  30379. #: guix-git/doc/guix.texi:20260
  30380. msgid "Return a service that runs the Dovecot IMAP/POP3/LMTP mail server."
  30381. msgstr ""
  30382. #. type: Plain text
  30383. #: guix-git/doc/guix.texi:20270
  30384. msgid "By default, Dovecot does not need much configuration; the default configuration object created by @code{(dovecot-configuration)} will suffice if your mail is delivered to @code{~/Maildir}. A self-signed certificate will be generated for TLS-protected connections, though Dovecot will also listen on cleartext ports by default. There are a number of options, though, which mail administrators might need to change, and as is the case with other services, Guix allows the system administrator to specify these parameters via a uniform Scheme interface."
  30385. msgstr ""
  30386. #. type: Plain text
  30387. #: guix-git/doc/guix.texi:20273
  30388. msgid "For example, to specify that mail is located at @code{maildir~/.mail}, one would instantiate the Dovecot service like this:"
  30389. msgstr ""
  30390. #. type: lisp
  30391. #: guix-git/doc/guix.texi:20278
  30392. #, no-wrap
  30393. msgid ""
  30394. "(dovecot-service #:config\n"
  30395. " (dovecot-configuration\n"
  30396. " (mail-location \"maildir:~/.mail\")))\n"
  30397. msgstr ""
  30398. #. type: Plain text
  30399. #: guix-git/doc/guix.texi:20286
  30400. msgid "The available configuration parameters follow. Each parameter definition is preceded by its type; for example, @samp{string-list foo} indicates that the @code{foo} parameter should be specified as a list of strings. There is also a way to specify the configuration as a string, if you have an old @code{dovecot.conf} file that you want to port over from some other system; see the end for more details."
  30401. msgstr ""
  30402. #. type: Plain text
  30403. #: guix-git/doc/guix.texi:20296
  30404. msgid "Available @code{dovecot-configuration} fields are:"
  30405. msgstr ""
  30406. #. type: deftypevr
  30407. #: guix-git/doc/guix.texi:20297
  30408. #, no-wrap
  30409. msgid "{@code{dovecot-configuration} parameter} package dovecot"
  30410. msgstr ""
  30411. #. type: deftypevr
  30412. #: guix-git/doc/guix.texi:20299 guix-git/doc/guix.texi:21648
  30413. msgid "The dovecot package."
  30414. msgstr ""
  30415. #. type: deftypevr
  30416. #: guix-git/doc/guix.texi:20301
  30417. #, no-wrap
  30418. msgid "{@code{dovecot-configuration} parameter} comma-separated-string-list listen"
  30419. msgstr ""
  30420. #. type: deftypevr
  30421. #: guix-git/doc/guix.texi:20307
  30422. msgid "A list of IPs or hosts where to listen for connections. @samp{*} listens on all IPv4 interfaces, @samp{::} listens on all IPv6 interfaces. If you want to specify non-default ports or anything more complex, customize the address and port fields of the @samp{inet-listener} of the specific services you are interested in."
  30423. msgstr ""
  30424. #. type: deftypevr
  30425. #: guix-git/doc/guix.texi:20309
  30426. #, no-wrap
  30427. msgid "{@code{dovecot-configuration} parameter} protocol-configuration-list protocols"
  30428. msgstr ""
  30429. #. type: deftypevr
  30430. #: guix-git/doc/guix.texi:20312
  30431. msgid "List of protocols we want to serve. Available protocols include @samp{imap}, @samp{pop3}, and @samp{lmtp}."
  30432. msgstr ""
  30433. #. type: deftypevr
  30434. #: guix-git/doc/guix.texi:20314
  30435. msgid "Available @code{protocol-configuration} fields are:"
  30436. msgstr ""
  30437. #. type: deftypevr
  30438. #: guix-git/doc/guix.texi:20315
  30439. #, no-wrap
  30440. msgid "{@code{protocol-configuration} parameter} string name"
  30441. msgstr ""
  30442. #. type: deftypevr
  30443. #: guix-git/doc/guix.texi:20317
  30444. msgid "The name of the protocol."
  30445. msgstr ""
  30446. #. type: deftypevr
  30447. #: guix-git/doc/guix.texi:20319
  30448. #, no-wrap
  30449. msgid "{@code{protocol-configuration} parameter} string auth-socket-path"
  30450. msgstr ""
  30451. #. type: deftypevr
  30452. #: guix-git/doc/guix.texi:20323
  30453. msgid "UNIX socket path to the master authentication server to find users. This is used by imap (for shared users) and lda. It defaults to @samp{\"/var/run/dovecot/auth-userdb\"}."
  30454. msgstr ""
  30455. #. type: deftypevr
  30456. #: guix-git/doc/guix.texi:20325
  30457. #, no-wrap
  30458. msgid "{@code{protocol-configuration} parameter} boolean imap-metadata?"
  30459. msgstr ""
  30460. #. type: deftypevr
  30461. #: guix-git/doc/guix.texi:20330
  30462. msgid "Whether to enable the @code{IMAP METADATA} extension as defined in @uref{https://tools.ietf.org/html/rfc5464,RFC@tie{}5464}, which provides a means for clients to set and retrieve per-mailbox, per-user metadata and annotations over IMAP."
  30463. msgstr ""
  30464. #. type: deftypevr
  30465. #: guix-git/doc/guix.texi:20333
  30466. msgid "If this is @samp{#t}, you must also specify a dictionary @i{via} the @code{mail-attribute-dict} setting."
  30467. msgstr ""
  30468. #. type: deftypevr
  30469. #: guix-git/doc/guix.texi:20338
  30470. #, no-wrap
  30471. msgid "{@code{protocol-configuration} parameter} space-separated-string-list managesieve-notify-capabilities"
  30472. msgstr ""
  30473. #. type: deftypevr
  30474. #: guix-git/doc/guix.texi:20343
  30475. msgid "Which NOTIFY capabilities to report to clients that first connect to the ManageSieve service, before authentication. These may differ from the capabilities offered to authenticated users. If this field is left empty, report what the Sieve interpreter supports by default."
  30476. msgstr ""
  30477. #. type: deftypevr
  30478. #: guix-git/doc/guix.texi:20347
  30479. #, no-wrap
  30480. msgid "{@code{protocol-configuration} parameter} space-separated-string-list managesieve-sieve-capability"
  30481. msgstr ""
  30482. #. type: deftypevr
  30483. #: guix-git/doc/guix.texi:20352
  30484. msgid "Which SIEVE capabilities to report to clients that first connect to the ManageSieve service, before authentication. These may differ from the capabilities offered to authenticated users. If this field is left empty, report what the Sieve interpreter supports by default."
  30485. msgstr ""
  30486. #. type: deftypevr
  30487. #: guix-git/doc/guix.texi:20357
  30488. #, no-wrap
  30489. msgid "{@code{protocol-configuration} parameter} space-separated-string-list mail-plugins"
  30490. msgstr ""
  30491. #. type: deftypevr
  30492. #: guix-git/doc/guix.texi:20359
  30493. msgid "Space separated list of plugins to load."
  30494. msgstr ""
  30495. #. type: deftypevr
  30496. #: guix-git/doc/guix.texi:20361
  30497. #, no-wrap
  30498. msgid "{@code{protocol-configuration} parameter} non-negative-integer mail-max-userip-connections"
  30499. msgstr ""
  30500. #. type: deftypevr
  30501. #: guix-git/doc/guix.texi:20365
  30502. msgid "Maximum number of IMAP connections allowed for a user from each IP address. NOTE: The username is compared case-sensitively. Defaults to @samp{10}."
  30503. msgstr ""
  30504. #. type: deftypevr
  30505. #: guix-git/doc/guix.texi:20369
  30506. #, no-wrap
  30507. msgid "{@code{dovecot-configuration} parameter} service-configuration-list services"
  30508. msgstr ""
  30509. #. type: deftypevr
  30510. #: guix-git/doc/guix.texi:20373
  30511. msgid "List of services to enable. Available services include @samp{imap}, @samp{imap-login}, @samp{pop3}, @samp{pop3-login}, @samp{auth}, and @samp{lmtp}."
  30512. msgstr ""
  30513. #. type: deftypevr
  30514. #: guix-git/doc/guix.texi:20375
  30515. msgid "Available @code{service-configuration} fields are:"
  30516. msgstr ""
  30517. #. type: deftypevr
  30518. #: guix-git/doc/guix.texi:20376
  30519. #, no-wrap
  30520. msgid "{@code{service-configuration} parameter} string kind"
  30521. msgstr ""
  30522. #. type: deftypevr
  30523. #: guix-git/doc/guix.texi:20381
  30524. msgid "The service kind. Valid values include @code{director}, @code{imap-login}, @code{pop3-login}, @code{lmtp}, @code{imap}, @code{pop3}, @code{auth}, @code{auth-worker}, @code{dict}, @code{tcpwrap}, @code{quota-warning}, or anything else."
  30525. msgstr ""
  30526. #. type: deftypevr
  30527. #: guix-git/doc/guix.texi:20383
  30528. #, no-wrap
  30529. msgid "{@code{service-configuration} parameter} listener-configuration-list listeners"
  30530. msgstr ""
  30531. #. type: deftypevr
  30532. #: guix-git/doc/guix.texi:20388
  30533. msgid "Listeners for the service. A listener is either a @code{unix-listener-configuration}, a @code{fifo-listener-configuration}, or an @code{inet-listener-configuration}. Defaults to @samp{()}."
  30534. msgstr ""
  30535. #. type: deftypevr
  30536. #: guix-git/doc/guix.texi:20390
  30537. msgid "Available @code{unix-listener-configuration} fields are:"
  30538. msgstr ""
  30539. #. type: deftypevr
  30540. #: guix-git/doc/guix.texi:20391
  30541. #, no-wrap
  30542. msgid "{@code{unix-listener-configuration} parameter} string path"
  30543. msgstr ""
  30544. #. type: deftypevr
  30545. #: guix-git/doc/guix.texi:20394 guix-git/doc/guix.texi:20417
  30546. msgid "Path to the file, relative to @code{base-dir} field. This is also used as the section name."
  30547. msgstr ""
  30548. #. type: deftypevr
  30549. #: guix-git/doc/guix.texi:20396
  30550. #, no-wrap
  30551. msgid "{@code{unix-listener-configuration} parameter} string mode"
  30552. msgstr ""
  30553. #. type: deftypevr
  30554. #: guix-git/doc/guix.texi:20399 guix-git/doc/guix.texi:20422
  30555. msgid "The access mode for the socket. Defaults to @samp{\"0600\"}."
  30556. msgstr ""
  30557. #. type: deftypevr
  30558. #: guix-git/doc/guix.texi:20401
  30559. #, no-wrap
  30560. msgid "{@code{unix-listener-configuration} parameter} string user"
  30561. msgstr ""
  30562. #. type: deftypevr
  30563. #: guix-git/doc/guix.texi:20404 guix-git/doc/guix.texi:20427
  30564. msgid "The user to own the socket. Defaults to @samp{\"\"}."
  30565. msgstr ""
  30566. #. type: deftypevr
  30567. #: guix-git/doc/guix.texi:20406
  30568. #, no-wrap
  30569. msgid "{@code{unix-listener-configuration} parameter} string group"
  30570. msgstr ""
  30571. #. type: deftypevr
  30572. #: guix-git/doc/guix.texi:20409 guix-git/doc/guix.texi:20432
  30573. msgid "The group to own the socket. Defaults to @samp{\"\"}."
  30574. msgstr ""
  30575. #. type: deftypevr
  30576. #: guix-git/doc/guix.texi:20413
  30577. msgid "Available @code{fifo-listener-configuration} fields are:"
  30578. msgstr ""
  30579. #. type: deftypevr
  30580. #: guix-git/doc/guix.texi:20414
  30581. #, no-wrap
  30582. msgid "{@code{fifo-listener-configuration} parameter} string path"
  30583. msgstr ""
  30584. #. type: deftypevr
  30585. #: guix-git/doc/guix.texi:20419
  30586. #, no-wrap
  30587. msgid "{@code{fifo-listener-configuration} parameter} string mode"
  30588. msgstr ""
  30589. #. type: deftypevr
  30590. #: guix-git/doc/guix.texi:20424
  30591. #, no-wrap
  30592. msgid "{@code{fifo-listener-configuration} parameter} string user"
  30593. msgstr ""
  30594. #. type: deftypevr
  30595. #: guix-git/doc/guix.texi:20429
  30596. #, no-wrap
  30597. msgid "{@code{fifo-listener-configuration} parameter} string group"
  30598. msgstr ""
  30599. #. type: deftypevr
  30600. #: guix-git/doc/guix.texi:20436
  30601. msgid "Available @code{inet-listener-configuration} fields are:"
  30602. msgstr ""
  30603. #. type: deftypevr
  30604. #: guix-git/doc/guix.texi:20437
  30605. #, no-wrap
  30606. msgid "{@code{inet-listener-configuration} parameter} string protocol"
  30607. msgstr ""
  30608. #. type: deftypevr
  30609. #: guix-git/doc/guix.texi:20439
  30610. msgid "The protocol to listen for."
  30611. msgstr ""
  30612. #. type: deftypevr
  30613. #: guix-git/doc/guix.texi:20441
  30614. #, no-wrap
  30615. msgid "{@code{inet-listener-configuration} parameter} string address"
  30616. msgstr ""
  30617. #. type: deftypevr
  30618. #: guix-git/doc/guix.texi:20444
  30619. msgid "The address on which to listen, or empty for all addresses. Defaults to @samp{\"\"}."
  30620. msgstr ""
  30621. #. type: deftypevr
  30622. #: guix-git/doc/guix.texi:20446
  30623. #, no-wrap
  30624. msgid "{@code{inet-listener-configuration} parameter} non-negative-integer port"
  30625. msgstr ""
  30626. #. type: deftypevr
  30627. #: guix-git/doc/guix.texi:20448
  30628. msgid "The port on which to listen."
  30629. msgstr ""
  30630. #. type: deftypevr
  30631. #: guix-git/doc/guix.texi:20450
  30632. #, no-wrap
  30633. msgid "{@code{inet-listener-configuration} parameter} boolean ssl?"
  30634. msgstr ""
  30635. #. type: deftypevr
  30636. #: guix-git/doc/guix.texi:20454
  30637. msgid "Whether to use SSL for this service; @samp{yes}, @samp{no}, or @samp{required}. Defaults to @samp{#t}."
  30638. msgstr ""
  30639. #. type: deftypevr
  30640. #: guix-git/doc/guix.texi:20458
  30641. #, no-wrap
  30642. msgid "{@code{service-configuration} parameter} non-negative-integer client-limit"
  30643. msgstr ""
  30644. #. type: deftypevr
  30645. #: guix-git/doc/guix.texi:20463
  30646. msgid "Maximum number of simultaneous client connections per process. Once this number of connections is received, the next incoming connection will prompt Dovecot to spawn another process. If set to 0, @code{default-client-limit} is used instead."
  30647. msgstr ""
  30648. #. type: deftypevr
  30649. #: guix-git/doc/guix.texi:20468
  30650. #, no-wrap
  30651. msgid "{@code{service-configuration} parameter} non-negative-integer service-count"
  30652. msgstr ""
  30653. #. type: deftypevr
  30654. #: guix-git/doc/guix.texi:20473
  30655. msgid "Number of connections to handle before starting a new process. Typically the only useful values are 0 (unlimited) or 1. 1 is more secure, but 0 is faster. <doc/wiki/LoginProcess.txt>. Defaults to @samp{1}."
  30656. msgstr ""
  30657. #. type: deftypevr
  30658. #: guix-git/doc/guix.texi:20476
  30659. #, no-wrap
  30660. msgid "{@code{service-configuration} parameter} non-negative-integer process-limit"
  30661. msgstr ""
  30662. #. type: deftypevr
  30663. #: guix-git/doc/guix.texi:20479
  30664. msgid "Maximum number of processes that can exist for this service. If set to 0, @code{default-process-limit} is used instead."
  30665. msgstr ""
  30666. #. type: deftypevr
  30667. #: guix-git/doc/guix.texi:20484
  30668. #, no-wrap
  30669. msgid "{@code{service-configuration} parameter} non-negative-integer process-min-avail"
  30670. msgstr ""
  30671. #. type: deftypevr
  30672. #: guix-git/doc/guix.texi:20487
  30673. msgid "Number of processes to always keep waiting for more connections. Defaults to @samp{0}."
  30674. msgstr ""
  30675. #. type: deftypevr
  30676. #: guix-git/doc/guix.texi:20489
  30677. #, no-wrap
  30678. msgid "{@code{service-configuration} parameter} non-negative-integer vsz-limit"
  30679. msgstr ""
  30680. #. type: deftypevr
  30681. #: guix-git/doc/guix.texi:20493
  30682. msgid "If you set @samp{service-count 0}, you probably need to grow this. Defaults to @samp{256000000}."
  30683. msgstr ""
  30684. #. type: deftypevr
  30685. #: guix-git/doc/guix.texi:20497
  30686. #, no-wrap
  30687. msgid "{@code{dovecot-configuration} parameter} dict-configuration dict"
  30688. msgstr ""
  30689. #. type: deftypevr
  30690. #: guix-git/doc/guix.texi:20500
  30691. msgid "Dict configuration, as created by the @code{dict-configuration} constructor."
  30692. msgstr ""
  30693. #. type: deftypevr
  30694. #: guix-git/doc/guix.texi:20502
  30695. msgid "Available @code{dict-configuration} fields are:"
  30696. msgstr ""
  30697. #. type: deftypevr
  30698. #: guix-git/doc/guix.texi:20503
  30699. #, no-wrap
  30700. msgid "{@code{dict-configuration} parameter} free-form-fields entries"
  30701. msgstr ""
  30702. #. type: deftypevr
  30703. #: guix-git/doc/guix.texi:20506
  30704. msgid "A list of key-value pairs that this dict should hold. Defaults to @samp{()}."
  30705. msgstr ""
  30706. #. type: deftypevr
  30707. #: guix-git/doc/guix.texi:20510
  30708. #, no-wrap
  30709. msgid "{@code{dovecot-configuration} parameter} passdb-configuration-list passdbs"
  30710. msgstr ""
  30711. #. type: deftypevr
  30712. #: guix-git/doc/guix.texi:20513
  30713. msgid "A list of passdb configurations, each one created by the @code{passdb-configuration} constructor."
  30714. msgstr ""
  30715. #. type: deftypevr
  30716. #: guix-git/doc/guix.texi:20515
  30717. msgid "Available @code{passdb-configuration} fields are:"
  30718. msgstr ""
  30719. #. type: deftypevr
  30720. #: guix-git/doc/guix.texi:20516
  30721. #, no-wrap
  30722. msgid "{@code{passdb-configuration} parameter} string driver"
  30723. msgstr ""
  30724. #. type: deftypevr
  30725. #: guix-git/doc/guix.texi:20521
  30726. msgid "The driver that the passdb should use. Valid values include @samp{pam}, @samp{passwd}, @samp{shadow}, @samp{bsdauth}, and @samp{static}. Defaults to @samp{\"pam\"}."
  30727. msgstr ""
  30728. #. type: deftypevr
  30729. #: guix-git/doc/guix.texi:20523
  30730. #, no-wrap
  30731. msgid "{@code{passdb-configuration} parameter} space-separated-string-list args"
  30732. msgstr ""
  30733. #. type: deftypevr
  30734. #: guix-git/doc/guix.texi:20526
  30735. msgid "Space separated list of arguments to the passdb driver. Defaults to @samp{\"\"}."
  30736. msgstr ""
  30737. #. type: deftypevr
  30738. #: guix-git/doc/guix.texi:20530
  30739. #, no-wrap
  30740. msgid "{@code{dovecot-configuration} parameter} userdb-configuration-list userdbs"
  30741. msgstr ""
  30742. #. type: deftypevr
  30743. #: guix-git/doc/guix.texi:20533
  30744. msgid "List of userdb configurations, each one created by the @code{userdb-configuration} constructor."
  30745. msgstr ""
  30746. #. type: deftypevr
  30747. #: guix-git/doc/guix.texi:20535
  30748. msgid "Available @code{userdb-configuration} fields are:"
  30749. msgstr ""
  30750. #. type: deftypevr
  30751. #: guix-git/doc/guix.texi:20536
  30752. #, no-wrap
  30753. msgid "{@code{userdb-configuration} parameter} string driver"
  30754. msgstr ""
  30755. #. type: deftypevr
  30756. #: guix-git/doc/guix.texi:20540
  30757. msgid "The driver that the userdb should use. Valid values include @samp{passwd} and @samp{static}. Defaults to @samp{\"passwd\"}."
  30758. msgstr ""
  30759. #. type: deftypevr
  30760. #: guix-git/doc/guix.texi:20542
  30761. #, no-wrap
  30762. msgid "{@code{userdb-configuration} parameter} space-separated-string-list args"
  30763. msgstr ""
  30764. #. type: deftypevr
  30765. #: guix-git/doc/guix.texi:20545
  30766. msgid "Space separated list of arguments to the userdb driver. Defaults to @samp{\"\"}."
  30767. msgstr ""
  30768. #. type: deftypevr
  30769. #: guix-git/doc/guix.texi:20547
  30770. #, no-wrap
  30771. msgid "{@code{userdb-configuration} parameter} free-form-args override-fields"
  30772. msgstr ""
  30773. #. type: deftypevr
  30774. #: guix-git/doc/guix.texi:20550
  30775. msgid "Override fields from passwd. Defaults to @samp{()}."
  30776. msgstr ""
  30777. #. type: deftypevr
  30778. #: guix-git/doc/guix.texi:20554
  30779. #, no-wrap
  30780. msgid "{@code{dovecot-configuration} parameter} plugin-configuration plugin-configuration"
  30781. msgstr ""
  30782. #. type: deftypevr
  30783. #: guix-git/doc/guix.texi:20557
  30784. msgid "Plug-in configuration, created by the @code{plugin-configuration} constructor."
  30785. msgstr ""
  30786. #. type: deftypevr
  30787. #: guix-git/doc/guix.texi:20559
  30788. #, no-wrap
  30789. msgid "{@code{dovecot-configuration} parameter} list-of-namespace-configuration namespaces"
  30790. msgstr ""
  30791. #. type: deftypevr
  30792. #: guix-git/doc/guix.texi:20562
  30793. msgid "List of namespaces. Each item in the list is created by the @code{namespace-configuration} constructor."
  30794. msgstr ""
  30795. #. type: deftypevr
  30796. #: guix-git/doc/guix.texi:20564
  30797. msgid "Available @code{namespace-configuration} fields are:"
  30798. msgstr ""
  30799. #. type: deftypevr
  30800. #: guix-git/doc/guix.texi:20565
  30801. #, no-wrap
  30802. msgid "{@code{namespace-configuration} parameter} string name"
  30803. msgstr ""
  30804. #. type: deftypevr
  30805. #: guix-git/doc/guix.texi:20567
  30806. msgid "Name for this namespace."
  30807. msgstr ""
  30808. #. type: deftypevr
  30809. #: guix-git/doc/guix.texi:20569
  30810. #, no-wrap
  30811. msgid "{@code{namespace-configuration} parameter} string type"
  30812. msgstr ""
  30813. #. type: deftypevr
  30814. #: guix-git/doc/guix.texi:20572
  30815. msgid "Namespace type: @samp{private}, @samp{shared} or @samp{public}. Defaults to @samp{\"private\"}."
  30816. msgstr ""
  30817. #. type: deftypevr
  30818. #: guix-git/doc/guix.texi:20574
  30819. #, no-wrap
  30820. msgid "{@code{namespace-configuration} parameter} string separator"
  30821. msgstr ""
  30822. #. type: deftypevr
  30823. #: guix-git/doc/guix.texi:20580
  30824. msgid "Hierarchy separator to use. You should use the same separator for all namespaces or some clients get confused. @samp{/} is usually a good one. The default however depends on the underlying mail storage format. Defaults to @samp{\"\"}."
  30825. msgstr ""
  30826. #. type: deftypevr
  30827. #: guix-git/doc/guix.texi:20582
  30828. #, no-wrap
  30829. msgid "{@code{namespace-configuration} parameter} string prefix"
  30830. msgstr ""
  30831. #. type: deftypevr
  30832. #: guix-git/doc/guix.texi:20586
  30833. msgid "Prefix required to access this namespace. This needs to be different for all namespaces. For example @samp{Public/}. Defaults to @samp{\"\"}."
  30834. msgstr ""
  30835. #. type: deftypevr
  30836. #: guix-git/doc/guix.texi:20588
  30837. #, no-wrap
  30838. msgid "{@code{namespace-configuration} parameter} string location"
  30839. msgstr ""
  30840. #. type: deftypevr
  30841. #: guix-git/doc/guix.texi:20592
  30842. msgid "Physical location of the mailbox. This is in the same format as mail_location, which is also the default for it. Defaults to @samp{\"\"}."
  30843. msgstr ""
  30844. #. type: deftypevr
  30845. #: guix-git/doc/guix.texi:20594
  30846. #, no-wrap
  30847. msgid "{@code{namespace-configuration} parameter} boolean inbox?"
  30848. msgstr ""
  30849. #. type: deftypevr
  30850. #: guix-git/doc/guix.texi:20598
  30851. msgid "There can be only one INBOX, and this setting defines which namespace has it. Defaults to @samp{#f}."
  30852. msgstr ""
  30853. #. type: deftypevr
  30854. #: guix-git/doc/guix.texi:20600
  30855. #, no-wrap
  30856. msgid "{@code{namespace-configuration} parameter} boolean hidden?"
  30857. msgstr ""
  30858. #. type: deftypevr
  30859. #: guix-git/doc/guix.texi:20608
  30860. msgid "If namespace is hidden, it's not advertised to clients via NAMESPACE extension. You'll most likely also want to set @samp{list? #f}. This is mostly useful when converting from another server with different namespaces which you want to deprecate but still keep working. For example you can create hidden namespaces with prefixes @samp{~/mail/}, @samp{~%u/mail/} and @samp{mail/}. Defaults to @samp{#f}."
  30861. msgstr ""
  30862. #. type: deftypevr
  30863. #: guix-git/doc/guix.texi:20610
  30864. #, no-wrap
  30865. msgid "{@code{namespace-configuration} parameter} boolean list?"
  30866. msgstr ""
  30867. #. type: deftypevr
  30868. #: guix-git/doc/guix.texi:20616
  30869. msgid "Show the mailboxes under this namespace with the LIST command. This makes the namespace visible for clients that do not support the NAMESPACE extension. The special @code{children} value lists child mailboxes, but hides the namespace prefix. Defaults to @samp{#t}."
  30870. msgstr ""
  30871. #. type: deftypevr
  30872. #: guix-git/doc/guix.texi:20618
  30873. #, no-wrap
  30874. msgid "{@code{namespace-configuration} parameter} boolean subscriptions?"
  30875. msgstr ""
  30876. #. type: deftypevr
  30877. #: guix-git/doc/guix.texi:20623
  30878. msgid "Namespace handles its own subscriptions. If set to @code{#f}, the parent namespace handles them. The empty prefix should always have this as @code{#t}). Defaults to @samp{#t}."
  30879. msgstr ""
  30880. #. type: deftypevr
  30881. #: guix-git/doc/guix.texi:20625
  30882. #, no-wrap
  30883. msgid "{@code{namespace-configuration} parameter} mailbox-configuration-list mailboxes"
  30884. msgstr ""
  30885. #. type: deftypevr
  30886. #: guix-git/doc/guix.texi:20628
  30887. msgid "List of predefined mailboxes in this namespace. Defaults to @samp{()}."
  30888. msgstr ""
  30889. #. type: deftypevr
  30890. #: guix-git/doc/guix.texi:20630
  30891. msgid "Available @code{mailbox-configuration} fields are:"
  30892. msgstr ""
  30893. #. type: deftypevr
  30894. #: guix-git/doc/guix.texi:20631
  30895. #, no-wrap
  30896. msgid "{@code{mailbox-configuration} parameter} string name"
  30897. msgstr ""
  30898. #. type: deftypevr
  30899. #: guix-git/doc/guix.texi:20633
  30900. msgid "Name for this mailbox."
  30901. msgstr ""
  30902. #. type: deftypevr
  30903. #: guix-git/doc/guix.texi:20635
  30904. #, no-wrap
  30905. msgid "{@code{mailbox-configuration} parameter} string auto"
  30906. msgstr ""
  30907. #. type: deftypevr
  30908. #: guix-git/doc/guix.texi:20639
  30909. msgid "@samp{create} will automatically create this mailbox. @samp{subscribe} will both create and subscribe to the mailbox. Defaults to @samp{\"no\"}."
  30910. msgstr ""
  30911. #. type: deftypevr
  30912. #: guix-git/doc/guix.texi:20641
  30913. #, no-wrap
  30914. msgid "{@code{mailbox-configuration} parameter} space-separated-string-list special-use"
  30915. msgstr ""
  30916. #. type: deftypevr
  30917. #: guix-git/doc/guix.texi:20646
  30918. msgid "List of IMAP @code{SPECIAL-USE} attributes as specified by RFC 6154. Valid values are @code{\\All}, @code{\\Archive}, @code{\\Drafts}, @code{\\Flagged}, @code{\\Junk}, @code{\\Sent}, and @code{\\Trash}. Defaults to @samp{()}."
  30919. msgstr ""
  30920. #. type: deftypevr
  30921. #: guix-git/doc/guix.texi:20652
  30922. #, no-wrap
  30923. msgid "{@code{dovecot-configuration} parameter} file-name base-dir"
  30924. msgstr ""
  30925. #. type: deftypevr
  30926. #: guix-git/doc/guix.texi:20655
  30927. msgid "Base directory where to store runtime data. Defaults to @samp{\"/var/run/dovecot/\"}."
  30928. msgstr ""
  30929. #. type: deftypevr
  30930. #: guix-git/doc/guix.texi:20657
  30931. #, no-wrap
  30932. msgid "{@code{dovecot-configuration} parameter} string login-greeting"
  30933. msgstr ""
  30934. #. type: deftypevr
  30935. #: guix-git/doc/guix.texi:20660
  30936. msgid "Greeting message for clients. Defaults to @samp{\"Dovecot ready.\"}."
  30937. msgstr ""
  30938. #. type: deftypevr
  30939. #: guix-git/doc/guix.texi:20662
  30940. #, no-wrap
  30941. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list login-trusted-networks"
  30942. msgstr ""
  30943. #. type: deftypevr
  30944. #: guix-git/doc/guix.texi:20669
  30945. msgid "List of trusted network ranges. Connections from these IPs are allowed to override their IP addresses and ports (for logging and for authentication checks). @samp{disable-plaintext-auth} is also ignored for these networks. Typically you would specify your IMAP proxy servers here. Defaults to @samp{()}."
  30946. msgstr ""
  30947. #. type: deftypevr
  30948. #: guix-git/doc/guix.texi:20671
  30949. #, no-wrap
  30950. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list login-access-sockets"
  30951. msgstr ""
  30952. #. type: deftypevr
  30953. #: guix-git/doc/guix.texi:20674
  30954. msgid "List of login access check sockets (e.g.@: tcpwrap). Defaults to @samp{()}."
  30955. msgstr ""
  30956. #. type: deftypevr
  30957. #: guix-git/doc/guix.texi:20676
  30958. #, no-wrap
  30959. msgid "{@code{dovecot-configuration} parameter} boolean verbose-proctitle?"
  30960. msgstr ""
  30961. #. type: deftypevr
  30962. #: guix-git/doc/guix.texi:20682
  30963. msgid "Show more verbose process titles (in ps). Currently shows user name and IP address. Useful for seeing who is actually using the IMAP processes (e.g.@: shared mailboxes or if the same uid is used for multiple accounts). Defaults to @samp{#f}."
  30964. msgstr ""
  30965. #. type: deftypevr
  30966. #: guix-git/doc/guix.texi:20684
  30967. #, no-wrap
  30968. msgid "{@code{dovecot-configuration} parameter} boolean shutdown-clients?"
  30969. msgstr ""
  30970. #. type: deftypevr
  30971. #: guix-git/doc/guix.texi:20690
  30972. msgid "Should all processes be killed when Dovecot master process shuts down. Setting this to @code{#f} means that Dovecot can be upgraded without forcing existing client connections to close (although that could also be a problem if the upgrade is e.g.@: due to a security fix). Defaults to @samp{#t}."
  30973. msgstr ""
  30974. #. type: deftypevr
  30975. #: guix-git/doc/guix.texi:20692
  30976. #, no-wrap
  30977. msgid "{@code{dovecot-configuration} parameter} non-negative-integer doveadm-worker-count"
  30978. msgstr ""
  30979. #. type: deftypevr
  30980. #: guix-git/doc/guix.texi:20696
  30981. msgid "If non-zero, run mail commands via this many connections to doveadm server, instead of running them directly in the same process. Defaults to @samp{0}."
  30982. msgstr ""
  30983. #. type: deftypevr
  30984. #: guix-git/doc/guix.texi:20698
  30985. #, no-wrap
  30986. msgid "{@code{dovecot-configuration} parameter} string doveadm-socket-path"
  30987. msgstr ""
  30988. #. type: deftypevr
  30989. #: guix-git/doc/guix.texi:20701
  30990. msgid "UNIX socket or host:port used for connecting to doveadm server. Defaults to @samp{\"doveadm-server\"}."
  30991. msgstr ""
  30992. #. type: deftypevr
  30993. #: guix-git/doc/guix.texi:20703
  30994. #, no-wrap
  30995. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list import-environment"
  30996. msgstr ""
  30997. #. type: deftypevr
  30998. #: guix-git/doc/guix.texi:20707
  30999. msgid "List of environment variables that are preserved on Dovecot startup and passed down to all of its child processes. You can also give key=value pairs to always set specific settings."
  31000. msgstr ""
  31001. #. type: deftypevr
  31002. #: guix-git/doc/guix.texi:20709
  31003. #, no-wrap
  31004. msgid "{@code{dovecot-configuration} parameter} boolean disable-plaintext-auth?"
  31005. msgstr ""
  31006. #. type: deftypevr
  31007. #: guix-git/doc/guix.texi:20716
  31008. msgid "Disable LOGIN command and all other plaintext authentications unless SSL/TLS is used (LOGINDISABLED capability). Note that if the remote IP matches the local IP (i.e.@: you're connecting from the same computer), the connection is considered secure and plaintext authentication is allowed. See also ssl=required setting. Defaults to @samp{#t}."
  31009. msgstr ""
  31010. #. type: deftypevr
  31011. #: guix-git/doc/guix.texi:20718
  31012. #, no-wrap
  31013. msgid "{@code{dovecot-configuration} parameter} non-negative-integer auth-cache-size"
  31014. msgstr ""
  31015. #. type: deftypevr
  31016. #: guix-git/doc/guix.texi:20723
  31017. msgid "Authentication cache size (e.g.@: @samp{#e10e6}). 0 means it's disabled. Note that bsdauth, PAM and vpopmail require @samp{cache-key} to be set for caching to be used. Defaults to @samp{0}."
  31018. msgstr ""
  31019. #. type: deftypevr
  31020. #: guix-git/doc/guix.texi:20725
  31021. #, no-wrap
  31022. msgid "{@code{dovecot-configuration} parameter} string auth-cache-ttl"
  31023. msgstr ""
  31024. #. type: deftypevr
  31025. #: guix-git/doc/guix.texi:20733
  31026. msgid "Time to live for cached data. After TTL expires the cached record is no longer used, *except* if the main database lookup returns internal failure. We also try to handle password changes automatically: If user's previous authentication was successful, but this one wasn't, the cache isn't used. For now this works only with plaintext authentication. Defaults to @samp{\"1 hour\"}."
  31027. msgstr ""
  31028. #. type: deftypevr
  31029. #: guix-git/doc/guix.texi:20735
  31030. #, no-wrap
  31031. msgid "{@code{dovecot-configuration} parameter} string auth-cache-negative-ttl"
  31032. msgstr ""
  31033. #. type: deftypevr
  31034. #: guix-git/doc/guix.texi:20739
  31035. msgid "TTL for negative hits (user not found, password mismatch). 0 disables caching them completely. Defaults to @samp{\"1 hour\"}."
  31036. msgstr ""
  31037. #. type: deftypevr
  31038. #: guix-git/doc/guix.texi:20741
  31039. #, no-wrap
  31040. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list auth-realms"
  31041. msgstr ""
  31042. #. type: deftypevr
  31043. #: guix-git/doc/guix.texi:20747
  31044. msgid "List of realms for SASL authentication mechanisms that need them. You can leave it empty if you don't want to support multiple realms. Many clients simply use the first one listed here, so keep the default realm first. Defaults to @samp{()}."
  31045. msgstr ""
  31046. #. type: deftypevr
  31047. #: guix-git/doc/guix.texi:20749
  31048. #, no-wrap
  31049. msgid "{@code{dovecot-configuration} parameter} string auth-default-realm"
  31050. msgstr ""
  31051. #. type: deftypevr
  31052. #: guix-git/doc/guix.texi:20754
  31053. msgid "Default realm/domain to use if none was specified. This is used for both SASL realms and appending @@domain to username in plaintext logins. Defaults to @samp{\"\"}."
  31054. msgstr ""
  31055. #. type: deftypevr
  31056. #: guix-git/doc/guix.texi:20756
  31057. #, no-wrap
  31058. msgid "{@code{dovecot-configuration} parameter} string auth-username-chars"
  31059. msgstr ""
  31060. #. type: deftypevr
  31061. #: guix-git/doc/guix.texi:20763
  31062. msgid "List of allowed characters in username. If the user-given username contains a character not listed in here, the login automatically fails. This is just an extra check to make sure user can't exploit any potential quote escaping vulnerabilities with SQL/LDAP databases. If you want to allow all characters, set this value to empty. Defaults to @samp{\"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ01234567890.-_@@\"}."
  31063. msgstr ""
  31064. #. type: deftypevr
  31065. #: guix-git/doc/guix.texi:20765
  31066. #, no-wrap
  31067. msgid "{@code{dovecot-configuration} parameter} string auth-username-translation"
  31068. msgstr ""
  31069. #. type: deftypevr
  31070. #: guix-git/doc/guix.texi:20771
  31071. msgid "Username character translations before it's looked up from databases. The value contains series of from -> to characters. For example @samp{#@@/@@} means that @samp{#} and @samp{/} characters are translated to @samp{@@}. Defaults to @samp{\"\"}."
  31072. msgstr ""
  31073. #. type: deftypevr
  31074. #: guix-git/doc/guix.texi:20773
  31075. #, no-wrap
  31076. msgid "{@code{dovecot-configuration} parameter} string auth-username-format"
  31077. msgstr ""
  31078. #. type: deftypevr
  31079. #: guix-git/doc/guix.texi:20780
  31080. msgid "Username formatting before it's looked up from databases. You can use the standard variables here, e.g.@: %Lu would lowercase the username, %n would drop away the domain if it was given, or @samp{%n-AT-%d} would change the @samp{@@} into @samp{-AT-}. This translation is done after @samp{auth-username-translation} changes. Defaults to @samp{\"%Lu\"}."
  31081. msgstr ""
  31082. #. type: deftypevr
  31083. #: guix-git/doc/guix.texi:20782
  31084. #, no-wrap
  31085. msgid "{@code{dovecot-configuration} parameter} string auth-master-user-separator"
  31086. msgstr ""
  31087. #. type: deftypevr
  31088. #: guix-git/doc/guix.texi:20790
  31089. msgid "If you want to allow master users to log in by specifying the master username within the normal username string (i.e.@: not using SASL mechanism's support for it), you can specify the separator character here. The format is then <username><separator><master username>. UW-IMAP uses @samp{*} as the separator, so that could be a good choice. Defaults to @samp{\"\"}."
  31090. msgstr ""
  31091. #. type: deftypevr
  31092. #: guix-git/doc/guix.texi:20792
  31093. #, no-wrap
  31094. msgid "{@code{dovecot-configuration} parameter} string auth-anonymous-username"
  31095. msgstr ""
  31096. #. type: deftypevr
  31097. #: guix-git/doc/guix.texi:20796
  31098. msgid "Username to use for users logging in with ANONYMOUS SASL mechanism. Defaults to @samp{\"anonymous\"}."
  31099. msgstr ""
  31100. #. type: deftypevr
  31101. #: guix-git/doc/guix.texi:20798
  31102. #, no-wrap
  31103. msgid "{@code{dovecot-configuration} parameter} non-negative-integer auth-worker-max-count"
  31104. msgstr ""
  31105. #. type: deftypevr
  31106. #: guix-git/doc/guix.texi:20803
  31107. msgid "Maximum number of dovecot-auth worker processes. They're used to execute blocking passdb and userdb queries (e.g.@: MySQL and PAM). They're automatically created and destroyed as needed. Defaults to @samp{30}."
  31108. msgstr ""
  31109. #. type: deftypevr
  31110. #: guix-git/doc/guix.texi:20805
  31111. #, no-wrap
  31112. msgid "{@code{dovecot-configuration} parameter} string auth-gssapi-hostname"
  31113. msgstr ""
  31114. #. type: deftypevr
  31115. #: guix-git/doc/guix.texi:20810
  31116. msgid "Host name to use in GSSAPI principal names. The default is to use the name returned by gethostname(). Use @samp{$ALL} (with quotes) to allow all keytab entries. Defaults to @samp{\"\"}."
  31117. msgstr ""
  31118. #. type: deftypevr
  31119. #: guix-git/doc/guix.texi:20812
  31120. #, no-wrap
  31121. msgid "{@code{dovecot-configuration} parameter} string auth-krb5-keytab"
  31122. msgstr ""
  31123. #. type: deftypevr
  31124. #: guix-git/doc/guix.texi:20818
  31125. msgid "Kerberos keytab to use for the GSSAPI mechanism. Will use the system default (usually @file{/etc/krb5.keytab}) if not specified. You may need to change the auth service to run as root to be able to read this file. Defaults to @samp{\"\"}."
  31126. msgstr ""
  31127. #. type: deftypevr
  31128. #: guix-git/doc/guix.texi:20820
  31129. #, no-wrap
  31130. msgid "{@code{dovecot-configuration} parameter} boolean auth-use-winbind?"
  31131. msgstr ""
  31132. #. type: deftypevr
  31133. #: guix-git/doc/guix.texi:20825
  31134. msgid "Do NTLM and GSS-SPNEGO authentication using Samba's winbind daemon and @samp{ntlm-auth} helper. <doc/wiki/Authentication/Mechanisms/Winbind.txt>. Defaults to @samp{#f}."
  31135. msgstr ""
  31136. #. type: deftypevr
  31137. #: guix-git/doc/guix.texi:20827
  31138. #, no-wrap
  31139. msgid "{@code{dovecot-configuration} parameter} file-name auth-winbind-helper-path"
  31140. msgstr ""
  31141. #. type: deftypevr
  31142. #: guix-git/doc/guix.texi:20830
  31143. msgid "Path for Samba's @samp{ntlm-auth} helper binary. Defaults to @samp{\"/usr/bin/ntlm_auth\"}."
  31144. msgstr ""
  31145. #. type: deftypevr
  31146. #: guix-git/doc/guix.texi:20832
  31147. #, no-wrap
  31148. msgid "{@code{dovecot-configuration} parameter} string auth-failure-delay"
  31149. msgstr ""
  31150. #. type: deftypevr
  31151. #: guix-git/doc/guix.texi:20835
  31152. msgid "Time to delay before replying to failed authentications. Defaults to @samp{\"2 secs\"}."
  31153. msgstr ""
  31154. #. type: deftypevr
  31155. #: guix-git/doc/guix.texi:20837
  31156. #, no-wrap
  31157. msgid "{@code{dovecot-configuration} parameter} boolean auth-ssl-require-client-cert?"
  31158. msgstr ""
  31159. #. type: deftypevr
  31160. #: guix-git/doc/guix.texi:20841
  31161. msgid "Require a valid SSL client certificate or the authentication fails. Defaults to @samp{#f}."
  31162. msgstr ""
  31163. #. type: deftypevr
  31164. #: guix-git/doc/guix.texi:20843
  31165. #, no-wrap
  31166. msgid "{@code{dovecot-configuration} parameter} boolean auth-ssl-username-from-cert?"
  31167. msgstr ""
  31168. #. type: deftypevr
  31169. #: guix-git/doc/guix.texi:20848
  31170. msgid "Take the username from client's SSL certificate, using @code{X509_NAME_get_text_by_NID()} which returns the subject's DN's CommonName. Defaults to @samp{#f}."
  31171. msgstr ""
  31172. #. type: deftypevr
  31173. #: guix-git/doc/guix.texi:20850
  31174. #, no-wrap
  31175. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list auth-mechanisms"
  31176. msgstr ""
  31177. #. type: deftypevr
  31178. #: guix-git/doc/guix.texi:20856
  31179. msgid "List of wanted authentication mechanisms. Supported mechanisms are: @samp{plain}, @samp{login}, @samp{digest-md5}, @samp{cram-md5}, @samp{ntlm}, @samp{rpa}, @samp{apop}, @samp{anonymous}, @samp{gssapi}, @samp{otp}, @samp{skey}, and @samp{gss-spnego}. NOTE: See also @samp{disable-plaintext-auth} setting."
  31180. msgstr ""
  31181. #. type: deftypevr
  31182. #: guix-git/doc/guix.texi:20858
  31183. #, no-wrap
  31184. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list director-servers"
  31185. msgstr ""
  31186. #. type: deftypevr
  31187. #: guix-git/doc/guix.texi:20863
  31188. msgid "List of IPs or hostnames to all director servers, including ourself. Ports can be specified as ip:port. The default port is the same as what director service's @samp{inet-listener} is using. Defaults to @samp{()}."
  31189. msgstr ""
  31190. #. type: deftypevr
  31191. #: guix-git/doc/guix.texi:20865
  31192. #, no-wrap
  31193. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list director-mail-servers"
  31194. msgstr ""
  31195. #. type: deftypevr
  31196. #: guix-git/doc/guix.texi:20869
  31197. msgid "List of IPs or hostnames to all backend mail servers. Ranges are allowed too, like 10.0.0.10-10.0.0.30. Defaults to @samp{()}."
  31198. msgstr ""
  31199. #. type: deftypevr
  31200. #: guix-git/doc/guix.texi:20871
  31201. #, no-wrap
  31202. msgid "{@code{dovecot-configuration} parameter} string director-user-expire"
  31203. msgstr ""
  31204. #. type: deftypevr
  31205. #: guix-git/doc/guix.texi:20875
  31206. msgid "How long to redirect users to a specific server after it no longer has any connections. Defaults to @samp{\"15 min\"}."
  31207. msgstr ""
  31208. #. type: deftypevr
  31209. #: guix-git/doc/guix.texi:20877
  31210. #, no-wrap
  31211. msgid "{@code{dovecot-configuration} parameter} string director-username-hash"
  31212. msgstr ""
  31213. #. type: deftypevr
  31214. #: guix-git/doc/guix.texi:20882
  31215. msgid "How the username is translated before being hashed. Useful values include %Ln if user can log in with or without @@domain, %Ld if mailboxes are shared within domain. Defaults to @samp{\"%Lu\"}."
  31216. msgstr ""
  31217. #. type: deftypevr
  31218. #: guix-git/doc/guix.texi:20884
  31219. #, no-wrap
  31220. msgid "{@code{dovecot-configuration} parameter} string log-path"
  31221. msgstr ""
  31222. #. type: deftypevr
  31223. #: guix-git/doc/guix.texi:20888
  31224. msgid "Log file to use for error messages. @samp{syslog} logs to syslog, @samp{/dev/stderr} logs to stderr. Defaults to @samp{\"syslog\"}."
  31225. msgstr ""
  31226. #. type: deftypevr
  31227. #: guix-git/doc/guix.texi:20890
  31228. #, no-wrap
  31229. msgid "{@code{dovecot-configuration} parameter} string info-log-path"
  31230. msgstr ""
  31231. #. type: deftypevr
  31232. #: guix-git/doc/guix.texi:20894
  31233. msgid "Log file to use for informational messages. Defaults to @samp{log-path}. Defaults to @samp{\"\"}."
  31234. msgstr ""
  31235. #. type: deftypevr
  31236. #: guix-git/doc/guix.texi:20896
  31237. #, no-wrap
  31238. msgid "{@code{dovecot-configuration} parameter} string debug-log-path"
  31239. msgstr ""
  31240. #. type: deftypevr
  31241. #: guix-git/doc/guix.texi:20900
  31242. msgid "Log file to use for debug messages. Defaults to @samp{info-log-path}. Defaults to @samp{\"\"}."
  31243. msgstr ""
  31244. #. type: deftypevr
  31245. #: guix-git/doc/guix.texi:20902
  31246. #, no-wrap
  31247. msgid "{@code{dovecot-configuration} parameter} string syslog-facility"
  31248. msgstr ""
  31249. #. type: deftypevr
  31250. #: guix-git/doc/guix.texi:20907
  31251. msgid "Syslog facility to use if you're logging to syslog. Usually if you don't want to use @samp{mail}, you'll use local0..local7. Also other standard facilities are supported. Defaults to @samp{\"mail\"}."
  31252. msgstr ""
  31253. #. type: deftypevr
  31254. #: guix-git/doc/guix.texi:20909
  31255. #, no-wrap
  31256. msgid "{@code{dovecot-configuration} parameter} boolean auth-verbose?"
  31257. msgstr ""
  31258. #. type: deftypevr
  31259. #: guix-git/doc/guix.texi:20913
  31260. msgid "Log unsuccessful authentication attempts and the reasons why they failed. Defaults to @samp{#f}."
  31261. msgstr ""
  31262. #. type: deftypevr
  31263. #: guix-git/doc/guix.texi:20915
  31264. #, no-wrap
  31265. msgid "{@code{dovecot-configuration} parameter} string auth-verbose-passwords"
  31266. msgstr ""
  31267. #. type: deftypevr
  31268. #: guix-git/doc/guix.texi:20922
  31269. msgid "In case of password mismatches, log the attempted password. Valid values are no, plain and sha1. sha1 can be useful for detecting brute force password attempts vs. user simply trying the same password over and over again. You can also truncate the value to n chars by appending \":n\" (e.g.@: sha1:6). Defaults to @samp{\"no\"}."
  31270. msgstr ""
  31271. #. type: deftypevr
  31272. #: guix-git/doc/guix.texi:20924
  31273. #, no-wrap
  31274. msgid "{@code{dovecot-configuration} parameter} boolean auth-debug?"
  31275. msgstr ""
  31276. #. type: deftypevr
  31277. #: guix-git/doc/guix.texi:20928
  31278. msgid "Even more verbose logging for debugging purposes. Shows for example SQL queries. Defaults to @samp{#f}."
  31279. msgstr ""
  31280. #. type: deftypevr
  31281. #: guix-git/doc/guix.texi:20930
  31282. #, no-wrap
  31283. msgid "{@code{dovecot-configuration} parameter} boolean auth-debug-passwords?"
  31284. msgstr ""
  31285. #. type: deftypevr
  31286. #: guix-git/doc/guix.texi:20935
  31287. msgid "In case of password mismatches, log the passwords and used scheme so the problem can be debugged. Enabling this also enables @samp{auth-debug}. Defaults to @samp{#f}."
  31288. msgstr ""
  31289. #. type: deftypevr
  31290. #: guix-git/doc/guix.texi:20937
  31291. #, no-wrap
  31292. msgid "{@code{dovecot-configuration} parameter} boolean mail-debug?"
  31293. msgstr ""
  31294. #. type: deftypevr
  31295. #: guix-git/doc/guix.texi:20941
  31296. msgid "Enable mail process debugging. This can help you figure out why Dovecot isn't finding your mails. Defaults to @samp{#f}."
  31297. msgstr ""
  31298. #. type: deftypevr
  31299. #: guix-git/doc/guix.texi:20943
  31300. #, no-wrap
  31301. msgid "{@code{dovecot-configuration} parameter} boolean verbose-ssl?"
  31302. msgstr ""
  31303. #. type: deftypevr
  31304. #: guix-git/doc/guix.texi:20946
  31305. msgid "Show protocol level SSL errors. Defaults to @samp{#f}."
  31306. msgstr ""
  31307. #. type: deftypevr
  31308. #: guix-git/doc/guix.texi:20948
  31309. #, no-wrap
  31310. msgid "{@code{dovecot-configuration} parameter} string log-timestamp"
  31311. msgstr ""
  31312. #. type: deftypevr
  31313. #: guix-git/doc/guix.texi:20952
  31314. msgid "Prefix for each line written to log file. % codes are in strftime(3) format. Defaults to @samp{\"\\\"%b %d %H:%M:%S \\\"\"}."
  31315. msgstr ""
  31316. #. type: deftypevr
  31317. #: guix-git/doc/guix.texi:20954
  31318. #, no-wrap
  31319. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list login-log-format-elements"
  31320. msgstr ""
  31321. #. type: deftypevr
  31322. #: guix-git/doc/guix.texi:20958
  31323. msgid "List of elements we want to log. The elements which have a non-empty variable value are joined together to form a comma-separated string."
  31324. msgstr ""
  31325. #. type: deftypevr
  31326. #: guix-git/doc/guix.texi:20960
  31327. #, no-wrap
  31328. msgid "{@code{dovecot-configuration} parameter} string login-log-format"
  31329. msgstr ""
  31330. #. type: deftypevr
  31331. #: guix-git/doc/guix.texi:20964
  31332. msgid "Login log format. %s contains @samp{login-log-format-elements} string, %$ contains the data we want to log. Defaults to @samp{\"%$: %s\"}."
  31333. msgstr ""
  31334. #. type: deftypevr
  31335. #: guix-git/doc/guix.texi:20966
  31336. #, no-wrap
  31337. msgid "{@code{dovecot-configuration} parameter} string mail-log-prefix"
  31338. msgstr ""
  31339. #. type: deftypevr
  31340. #: guix-git/doc/guix.texi:20970
  31341. msgid "Log prefix for mail processes. See doc/wiki/Variables.txt for list of possible variables you can use. Defaults to @samp{\"\\\"%s(%u)<%@{pid@}><%@{session@}>: \\\"\"}."
  31342. msgstr ""
  31343. #. type: deftypevr
  31344. #: guix-git/doc/guix.texi:20972
  31345. #, no-wrap
  31346. msgid "{@code{dovecot-configuration} parameter} string deliver-log-format"
  31347. msgstr ""
  31348. #. type: deftypevr
  31349. #: guix-git/doc/guix.texi:20974
  31350. msgid "Format to use for logging mail deliveries. You can use variables:"
  31351. msgstr ""
  31352. #. type: item
  31353. #: guix-git/doc/guix.texi:20975
  31354. #, no-wrap
  31355. msgid "%$"
  31356. msgstr ""
  31357. #. type: table
  31358. #: guix-git/doc/guix.texi:20977
  31359. msgid "Delivery status message (e.g.@: @samp{saved to INBOX})"
  31360. msgstr ""
  31361. #. type: item
  31362. #: guix-git/doc/guix.texi:20977
  31363. #, no-wrap
  31364. msgid "%m"
  31365. msgstr ""
  31366. #. type: table
  31367. #: guix-git/doc/guix.texi:20979
  31368. msgid "Message-ID"
  31369. msgstr ""
  31370. #. type: item
  31371. #: guix-git/doc/guix.texi:20979 guix-git/doc/guix.texi:21522
  31372. #, no-wrap
  31373. msgid "%s"
  31374. msgstr ""
  31375. #. type: table
  31376. #: guix-git/doc/guix.texi:20981
  31377. msgid "Subject"
  31378. msgstr ""
  31379. #. type: item
  31380. #: guix-git/doc/guix.texi:20981
  31381. #, no-wrap
  31382. msgid "%f"
  31383. msgstr ""
  31384. #. type: table
  31385. #: guix-git/doc/guix.texi:20983
  31386. msgid "From address"
  31387. msgstr ""
  31388. #. type: table
  31389. #: guix-git/doc/guix.texi:20985
  31390. msgid "Physical size"
  31391. msgstr ""
  31392. #. type: item
  31393. #: guix-git/doc/guix.texi:20985
  31394. #, no-wrap
  31395. msgid "%w"
  31396. msgstr ""
  31397. #. type: table
  31398. #: guix-git/doc/guix.texi:20987
  31399. msgid "Virtual size."
  31400. msgstr ""
  31401. #. type: deftypevr
  31402. #: guix-git/doc/guix.texi:20989
  31403. msgid "Defaults to @samp{\"msgid=%m: %$\"}."
  31404. msgstr ""
  31405. #. type: deftypevr
  31406. #: guix-git/doc/guix.texi:20991
  31407. #, no-wrap
  31408. msgid "{@code{dovecot-configuration} parameter} string mail-location"
  31409. msgstr ""
  31410. #. type: deftypevr
  31411. #: guix-git/doc/guix.texi:20996
  31412. msgid "Location for users' mailboxes. The default is empty, which means that Dovecot tries to find the mailboxes automatically. This won't work if the user doesn't yet have any mail, so you should explicitly tell Dovecot the full location."
  31413. msgstr ""
  31414. #. type: deftypevr
  31415. #: guix-git/doc/guix.texi:21002
  31416. msgid "If you're using mbox, giving a path to the INBOX file (e.g.@: @file{/var/mail/%u}) isn't enough. You'll also need to tell Dovecot where the other mailboxes are kept. This is called the @emph{root mail directory}, and it must be the first path given in the @samp{mail-location} setting."
  31417. msgstr ""
  31418. #. type: deftypevr
  31419. #: guix-git/doc/guix.texi:21004
  31420. msgid "There are a few special variables you can use, e.g.:"
  31421. msgstr ""
  31422. #. type: table
  31423. #: guix-git/doc/guix.texi:21008
  31424. msgid "username"
  31425. msgstr ""
  31426. #. type: item
  31427. #: guix-git/doc/guix.texi:21008 guix-git/doc/guix.texi:21518
  31428. #, no-wrap
  31429. msgid "%n"
  31430. msgstr ""
  31431. #. type: table
  31432. #: guix-git/doc/guix.texi:21010
  31433. msgid "user part in user@@domain, same as %u if there's no domain"
  31434. msgstr ""
  31435. #. type: item
  31436. #: guix-git/doc/guix.texi:21010
  31437. #, no-wrap
  31438. msgid "%d"
  31439. msgstr ""
  31440. #. type: table
  31441. #: guix-git/doc/guix.texi:21012
  31442. msgid "domain part in user@@domain, empty if there's no domain"
  31443. msgstr ""
  31444. #. type: item
  31445. #: guix-git/doc/guix.texi:21012
  31446. #, no-wrap
  31447. msgid "%h"
  31448. msgstr ""
  31449. #. type: table
  31450. #: guix-git/doc/guix.texi:21014
  31451. msgid "home director"
  31452. msgstr ""
  31453. #. type: deftypevr
  31454. #: guix-git/doc/guix.texi:21017
  31455. msgid "See doc/wiki/Variables.txt for full list. Some examples:"
  31456. msgstr ""
  31457. #. type: item
  31458. #: guix-git/doc/guix.texi:21018
  31459. #, no-wrap
  31460. msgid "maildir:~/Maildir"
  31461. msgstr ""
  31462. #. type: item
  31463. #: guix-git/doc/guix.texi:21019
  31464. #, no-wrap
  31465. msgid "mbox:~/mail:INBOX=/var/mail/%u"
  31466. msgstr ""
  31467. #. type: item
  31468. #: guix-git/doc/guix.texi:21020
  31469. #, no-wrap
  31470. msgid "mbox:/var/mail/%d/%1n/%n:INDEX=/var/indexes/%d/%1n/%"
  31471. msgstr ""
  31472. #. type: deftypevr
  31473. #: guix-git/doc/guix.texi:21025
  31474. #, no-wrap
  31475. msgid "{@code{dovecot-configuration} parameter} string mail-uid"
  31476. msgstr ""
  31477. #. type: deftypevr
  31478. #: guix-git/doc/guix.texi:21030
  31479. msgid "System user and group used to access mails. If you use multiple, userdb can override these by returning uid or gid fields. You can use either numbers or names. <doc/wiki/UserIds.txt>. Defaults to @samp{\"\"}."
  31480. msgstr ""
  31481. #. type: deftypevr
  31482. #: guix-git/doc/guix.texi:21032
  31483. #, no-wrap
  31484. msgid "{@code{dovecot-configuration} parameter} string mail-gid"
  31485. msgstr ""
  31486. #. type: deftypevr
  31487. #: guix-git/doc/guix.texi:21037
  31488. #, no-wrap
  31489. msgid "{@code{dovecot-configuration} parameter} string mail-privileged-group"
  31490. msgstr ""
  31491. #. type: deftypevr
  31492. #: guix-git/doc/guix.texi:21043
  31493. msgid "Group to enable temporarily for privileged operations. Currently this is used only with INBOX when either its initial creation or dotlocking fails. Typically this is set to @samp{\"mail\"} to give access to @file{/var/mail}. Defaults to @samp{\"\"}."
  31494. msgstr ""
  31495. #. type: deftypevr
  31496. #: guix-git/doc/guix.texi:21045
  31497. #, no-wrap
  31498. msgid "{@code{dovecot-configuration} parameter} string mail-access-groups"
  31499. msgstr ""
  31500. #. type: deftypevr
  31501. #: guix-git/doc/guix.texi:21053
  31502. msgid "Grant access to these supplementary groups for mail processes. Typically these are used to set up access to shared mailboxes. Note that it may be dangerous to set these if users can create symlinks (e.g.@: if @samp{mail} group is set here, @code{ln -s /var/mail ~/mail/var} could allow a user to delete others' mailboxes, or @code{ln -s /secret/shared/box ~/mail/mybox} would allow reading it). Defaults to @samp{\"\"}."
  31503. msgstr ""
  31504. #. type: deftypevr
  31505. #: guix-git/doc/guix.texi:21055
  31506. #, no-wrap
  31507. msgid "{@code{dovecot-configuration} parameter} string mail-attribute-dict"
  31508. msgstr ""
  31509. #. type: deftypevr
  31510. #: guix-git/doc/guix.texi:21058
  31511. msgid "The location of a dictionary used to store @code{IMAP METADATA} as defined by @uref{https://tools.ietf.org/html/rfc5464, RFC@tie{}5464}."
  31512. msgstr ""
  31513. #. type: deftypevr
  31514. #: guix-git/doc/guix.texi:21061
  31515. msgid "The IMAP METADATA commands are available only if the ``imap'' protocol configuration's @code{imap-metadata?} field is @samp{#t}."
  31516. msgstr ""
  31517. #. type: deftypevr
  31518. #: guix-git/doc/guix.texi:21066
  31519. #, no-wrap
  31520. msgid "{@code{dovecot-configuration} parameter} boolean mail-full-filesystem-access?"
  31521. msgstr ""
  31522. #. type: deftypevr
  31523. #: guix-git/doc/guix.texi:21072
  31524. msgid "Allow full file system access to clients. There's no access checks other than what the operating system does for the active UID/GID@. It works with both maildir and mboxes, allowing you to prefix mailboxes names with e.g.@: @file{/path/} or @file{~user/}. Defaults to @samp{#f}."
  31525. msgstr ""
  31526. #. type: deftypevr
  31527. #: guix-git/doc/guix.texi:21074
  31528. #, no-wrap
  31529. msgid "{@code{dovecot-configuration} parameter} boolean mmap-disable?"
  31530. msgstr ""
  31531. #. type: deftypevr
  31532. #: guix-git/doc/guix.texi:21078
  31533. msgid "Don't use @code{mmap()} at all. This is required if you store indexes to shared file systems (NFS or clustered file system). Defaults to @samp{#f}."
  31534. msgstr ""
  31535. #. type: deftypevr
  31536. #: guix-git/doc/guix.texi:21080
  31537. #, no-wrap
  31538. msgid "{@code{dovecot-configuration} parameter} boolean dotlock-use-excl?"
  31539. msgstr ""
  31540. #. type: deftypevr
  31541. #: guix-git/doc/guix.texi:21085
  31542. msgid "Rely on @samp{O_EXCL} to work when creating dotlock files. NFS supports @samp{O_EXCL} since version 3, so this should be safe to use nowadays by default. Defaults to @samp{#t}."
  31543. msgstr ""
  31544. #. type: deftypevr
  31545. #: guix-git/doc/guix.texi:21087
  31546. #, no-wrap
  31547. msgid "{@code{dovecot-configuration} parameter} string mail-fsync"
  31548. msgstr ""
  31549. #. type: deftypevr
  31550. #: guix-git/doc/guix.texi:21089
  31551. msgid "When to use fsync() or fdatasync() calls:"
  31552. msgstr ""
  31553. #. type: item
  31554. #: guix-git/doc/guix.texi:21090
  31555. #, no-wrap
  31556. msgid "optimized"
  31557. msgstr ""
  31558. #. type: table
  31559. #: guix-git/doc/guix.texi:21092
  31560. msgid "Whenever necessary to avoid losing important data"
  31561. msgstr ""
  31562. #. type: table
  31563. #: guix-git/doc/guix.texi:21094
  31564. msgid "Useful with e.g.@: NFS when @code{write()}s are delayed"
  31565. msgstr ""
  31566. #. type: table
  31567. #: guix-git/doc/guix.texi:21096
  31568. msgid "Never use it (best performance, but crashes can lose data)."
  31569. msgstr ""
  31570. #. type: deftypevr
  31571. #: guix-git/doc/guix.texi:21098
  31572. msgid "Defaults to @samp{\"optimized\"}."
  31573. msgstr ""
  31574. #. type: deftypevr
  31575. #: guix-git/doc/guix.texi:21100
  31576. #, no-wrap
  31577. msgid "{@code{dovecot-configuration} parameter} boolean mail-nfs-storage?"
  31578. msgstr ""
  31579. #. type: deftypevr
  31580. #: guix-git/doc/guix.texi:21105
  31581. msgid "Mail storage exists in NFS@. Set this to yes to make Dovecot flush NFS caches whenever needed. If you're using only a single mail server this isn't needed. Defaults to @samp{#f}."
  31582. msgstr ""
  31583. #. type: deftypevr
  31584. #: guix-git/doc/guix.texi:21107
  31585. #, no-wrap
  31586. msgid "{@code{dovecot-configuration} parameter} boolean mail-nfs-index?"
  31587. msgstr ""
  31588. #. type: deftypevr
  31589. #: guix-git/doc/guix.texi:21111
  31590. msgid "Mail index files also exist in NFS@. Setting this to yes requires @samp{mmap-disable? #t} and @samp{fsync-disable? #f}. Defaults to @samp{#f}."
  31591. msgstr ""
  31592. #. type: deftypevr
  31593. #: guix-git/doc/guix.texi:21113
  31594. #, no-wrap
  31595. msgid "{@code{dovecot-configuration} parameter} string lock-method"
  31596. msgstr ""
  31597. #. type: deftypevr
  31598. #: guix-git/doc/guix.texi:21119
  31599. msgid "Locking method for index files. Alternatives are fcntl, flock and dotlock. Dotlocking uses some tricks which may create more disk I/O than other locking methods. NFS users: flock doesn't work, remember to change @samp{mmap-disable}. Defaults to @samp{\"fcntl\"}."
  31600. msgstr ""
  31601. #. type: deftypevr
  31602. #: guix-git/doc/guix.texi:21121
  31603. #, no-wrap
  31604. msgid "{@code{dovecot-configuration} parameter} file-name mail-temp-dir"
  31605. msgstr ""
  31606. #. type: deftypevr
  31607. #: guix-git/doc/guix.texi:21125
  31608. msgid "Directory in which LDA/LMTP temporarily stores incoming mails >128 kB. Defaults to @samp{\"/tmp\"}."
  31609. msgstr ""
  31610. #. type: deftypevr
  31611. #: guix-git/doc/guix.texi:21127
  31612. #, no-wrap
  31613. msgid "{@code{dovecot-configuration} parameter} non-negative-integer first-valid-uid"
  31614. msgstr ""
  31615. #. type: deftypevr
  31616. #: guix-git/doc/guix.texi:21133
  31617. msgid "Valid UID range for users. This is mostly to make sure that users can't log in as daemons or other system users. Note that denying root logins is hardcoded to dovecot binary and can't be done even if @samp{first-valid-uid} is set to 0. Defaults to @samp{500}."
  31618. msgstr ""
  31619. #. type: deftypevr
  31620. #: guix-git/doc/guix.texi:21135
  31621. #, no-wrap
  31622. msgid "{@code{dovecot-configuration} parameter} non-negative-integer last-valid-uid"
  31623. msgstr ""
  31624. #. type: deftypevr
  31625. #: guix-git/doc/guix.texi:21140
  31626. #, no-wrap
  31627. msgid "{@code{dovecot-configuration} parameter} non-negative-integer first-valid-gid"
  31628. msgstr ""
  31629. #. type: deftypevr
  31630. #: guix-git/doc/guix.texi:21145
  31631. msgid "Valid GID range for users. Users having non-valid GID as primary group ID aren't allowed to log in. If user belongs to supplementary groups with non-valid GIDs, those groups are not set. Defaults to @samp{1}."
  31632. msgstr ""
  31633. #. type: deftypevr
  31634. #: guix-git/doc/guix.texi:21147
  31635. #, no-wrap
  31636. msgid "{@code{dovecot-configuration} parameter} non-negative-integer last-valid-gid"
  31637. msgstr ""
  31638. #. type: deftypevr
  31639. #: guix-git/doc/guix.texi:21152
  31640. #, no-wrap
  31641. msgid "{@code{dovecot-configuration} parameter} non-negative-integer mail-max-keyword-length"
  31642. msgstr ""
  31643. #. type: deftypevr
  31644. #: guix-git/doc/guix.texi:21156
  31645. msgid "Maximum allowed length for mail keyword name. It's only forced when trying to create new keywords. Defaults to @samp{50}."
  31646. msgstr ""
  31647. #. type: deftypevr
  31648. #: guix-git/doc/guix.texi:21158
  31649. #, no-wrap
  31650. msgid "{@code{dovecot-configuration} parameter} colon-separated-file-name-list valid-chroot-dirs"
  31651. msgstr ""
  31652. #. type: deftypevr
  31653. #: guix-git/doc/guix.texi:21168
  31654. msgid "List of directories under which chrooting is allowed for mail processes (i.e.@: @file{/var/mail} will allow chrooting to @file{/var/mail/foo/bar} too). This setting doesn't affect @samp{login-chroot} @samp{mail-chroot} or auth chroot settings. If this setting is empty, @samp{/./} in home dirs are ignored. WARNING: Never add directories here which local users can modify, that may lead to root exploit. Usually this should be done only if you don't allow shell access for users. <doc/wiki/Chrooting.txt>. Defaults to @samp{()}."
  31655. msgstr ""
  31656. #. type: deftypevr
  31657. #: guix-git/doc/guix.texi:21170
  31658. #, no-wrap
  31659. msgid "{@code{dovecot-configuration} parameter} string mail-chroot"
  31660. msgstr ""
  31661. #. type: deftypevr
  31662. #: guix-git/doc/guix.texi:21179
  31663. msgid "Default chroot directory for mail processes. This can be overridden for specific users in user database by giving @samp{/./} in user's home directory (e.g.@: @samp{/home/./user} chroots into @file{/home}). Note that usually there is no real need to do chrooting, Dovecot doesn't allow users to access files outside their mail directory anyway. If your home directories are prefixed with the chroot directory, append @samp{/.} to @samp{mail-chroot}. <doc/wiki/Chrooting.txt>. Defaults to @samp{\"\"}."
  31664. msgstr ""
  31665. #. type: deftypevr
  31666. #: guix-git/doc/guix.texi:21181
  31667. #, no-wrap
  31668. msgid "{@code{dovecot-configuration} parameter} file-name auth-socket-path"
  31669. msgstr ""
  31670. #. type: deftypevr
  31671. #: guix-git/doc/guix.texi:21185
  31672. msgid "UNIX socket path to master authentication server to find users. This is used by imap (for shared users) and lda. Defaults to @samp{\"/var/run/dovecot/auth-userdb\"}."
  31673. msgstr ""
  31674. #. type: deftypevr
  31675. #: guix-git/doc/guix.texi:21187
  31676. #, no-wrap
  31677. msgid "{@code{dovecot-configuration} parameter} file-name mail-plugin-dir"
  31678. msgstr ""
  31679. #. type: deftypevr
  31680. #: guix-git/doc/guix.texi:21190
  31681. msgid "Directory where to look up mail plugins. Defaults to @samp{\"/usr/lib/dovecot\"}."
  31682. msgstr ""
  31683. #. type: deftypevr
  31684. #: guix-git/doc/guix.texi:21192
  31685. #, no-wrap
  31686. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list mail-plugins"
  31687. msgstr ""
  31688. #. type: deftypevr
  31689. #: guix-git/doc/guix.texi:21196
  31690. msgid "List of plugins to load for all services. Plugins specific to IMAP, LDA, etc.@: are added to this list in their own .conf files. Defaults to @samp{()}."
  31691. msgstr ""
  31692. #. type: deftypevr
  31693. #: guix-git/doc/guix.texi:21198
  31694. #, no-wrap
  31695. msgid "{@code{dovecot-configuration} parameter} non-negative-integer mail-cache-min-mail-count"
  31696. msgstr ""
  31697. #. type: deftypevr
  31698. #: guix-git/doc/guix.texi:21203
  31699. msgid "The minimum number of mails in a mailbox before updates are done to cache file. This allows optimizing Dovecot's behavior to do less disk writes at the cost of more disk reads. Defaults to @samp{0}."
  31700. msgstr ""
  31701. #. type: deftypevr
  31702. #: guix-git/doc/guix.texi:21205
  31703. #, no-wrap
  31704. msgid "{@code{dovecot-configuration} parameter} string mailbox-idle-check-interval"
  31705. msgstr ""
  31706. #. type: deftypevr
  31707. #: guix-git/doc/guix.texi:21212
  31708. msgid "When IDLE command is running, mailbox is checked once in a while to see if there are any new mails or other changes. This setting defines the minimum time to wait between those checks. Dovecot can also use dnotify, inotify and kqueue to find out immediately when changes occur. Defaults to @samp{\"30 secs\"}."
  31709. msgstr ""
  31710. #. type: deftypevr
  31711. #: guix-git/doc/guix.texi:21214
  31712. #, no-wrap
  31713. msgid "{@code{dovecot-configuration} parameter} boolean mail-save-crlf?"
  31714. msgstr ""
  31715. #. type: deftypevr
  31716. #: guix-git/doc/guix.texi:21221
  31717. msgid "Save mails with CR+LF instead of plain LF@. This makes sending those mails take less CPU, especially with sendfile() syscall with Linux and FreeBSD@. But it also creates a bit more disk I/O which may just make it slower. Also note that if other software reads the mboxes/maildirs, they may handle the extra CRs wrong and cause problems. Defaults to @samp{#f}."
  31718. msgstr ""
  31719. #. type: deftypevr
  31720. #: guix-git/doc/guix.texi:21223
  31721. #, no-wrap
  31722. msgid "{@code{dovecot-configuration} parameter} boolean maildir-stat-dirs?"
  31723. msgstr ""
  31724. #. type: deftypevr
  31725. #: guix-git/doc/guix.texi:21231
  31726. msgid "By default LIST command returns all entries in maildir beginning with a dot. Enabling this option makes Dovecot return only entries which are directories. This is done by stat()ing each entry, so it causes more disk I/O. (For systems setting struct @samp{dirent->d_type} this check is free and it's done always regardless of this setting). Defaults to @samp{#f}."
  31727. msgstr ""
  31728. #. type: deftypevr
  31729. #: guix-git/doc/guix.texi:21233
  31730. #, no-wrap
  31731. msgid "{@code{dovecot-configuration} parameter} boolean maildir-copy-with-hardlinks?"
  31732. msgstr ""
  31733. #. type: deftypevr
  31734. #: guix-git/doc/guix.texi:21238
  31735. msgid "When copying a message, do it with hard links whenever possible. This makes the performance much better, and it's unlikely to have any side effects. Defaults to @samp{#t}."
  31736. msgstr ""
  31737. #. type: deftypevr
  31738. #: guix-git/doc/guix.texi:21240
  31739. #, no-wrap
  31740. msgid "{@code{dovecot-configuration} parameter} boolean maildir-very-dirty-syncs?"
  31741. msgstr ""
  31742. #. type: deftypevr
  31743. #: guix-git/doc/guix.texi:21245
  31744. msgid "Assume Dovecot is the only MUA accessing Maildir: Scan cur/ directory only when its mtime changes unexpectedly or when we can't find the mail otherwise. Defaults to @samp{#f}."
  31745. msgstr ""
  31746. #. type: deftypevr
  31747. #: guix-git/doc/guix.texi:21247
  31748. #, no-wrap
  31749. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list mbox-read-locks"
  31750. msgstr ""
  31751. #. type: deftypevr
  31752. #: guix-git/doc/guix.texi:21250
  31753. msgid "Which locking methods to use for locking mbox. There are four available:"
  31754. msgstr ""
  31755. #. type: item
  31756. #: guix-git/doc/guix.texi:21252
  31757. #, no-wrap
  31758. msgid "dotlock"
  31759. msgstr ""
  31760. #. type: table
  31761. #: guix-git/doc/guix.texi:21256
  31762. msgid "Create <mailbox>.lock file. This is the oldest and most NFS-safe solution. If you want to use /var/mail/ like directory, the users will need write access to that directory."
  31763. msgstr ""
  31764. #. type: item
  31765. #: guix-git/doc/guix.texi:21256
  31766. #, no-wrap
  31767. msgid "dotlock-try"
  31768. msgstr ""
  31769. #. type: table
  31770. #: guix-git/doc/guix.texi:21259
  31771. msgid "Same as dotlock, but if it fails because of permissions or because there isn't enough disk space, just skip it."
  31772. msgstr ""
  31773. #. type: item
  31774. #: guix-git/doc/guix.texi:21259
  31775. #, no-wrap
  31776. msgid "fcntl"
  31777. msgstr ""
  31778. #. type: table
  31779. #: guix-git/doc/guix.texi:21261
  31780. msgid "Use this if possible. Works with NFS too if lockd is used."
  31781. msgstr ""
  31782. #. type: item
  31783. #: guix-git/doc/guix.texi:21261
  31784. #, no-wrap
  31785. msgid "flock"
  31786. msgstr ""
  31787. #. type: table
  31788. #: guix-git/doc/guix.texi:21263 guix-git/doc/guix.texi:21265
  31789. msgid "May not exist in all systems. Doesn't work with NFS."
  31790. msgstr ""
  31791. #. type: item
  31792. #: guix-git/doc/guix.texi:21263
  31793. #, no-wrap
  31794. msgid "lockf"
  31795. msgstr ""
  31796. #. type: deftypevr
  31797. #: guix-git/doc/guix.texi:21271
  31798. msgid "You can use multiple locking methods; if you do the order they're declared in is important to avoid deadlocks if other MTAs/MUAs are using multiple locking methods as well. Some operating systems don't allow using some of them simultaneously."
  31799. msgstr ""
  31800. #. type: deftypevr
  31801. #: guix-git/doc/guix.texi:21273
  31802. #, no-wrap
  31803. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list mbox-write-locks"
  31804. msgstr ""
  31805. #. type: deftypevr
  31806. #: guix-git/doc/guix.texi:21277
  31807. #, no-wrap
  31808. msgid "{@code{dovecot-configuration} parameter} string mbox-lock-timeout"
  31809. msgstr ""
  31810. #. type: deftypevr
  31811. #: guix-git/doc/guix.texi:21280
  31812. msgid "Maximum time to wait for lock (all of them) before aborting. Defaults to @samp{\"5 mins\"}."
  31813. msgstr ""
  31814. #. type: deftypevr
  31815. #: guix-git/doc/guix.texi:21282
  31816. #, no-wrap
  31817. msgid "{@code{dovecot-configuration} parameter} string mbox-dotlock-change-timeout"
  31818. msgstr ""
  31819. #. type: deftypevr
  31820. #: guix-git/doc/guix.texi:21286
  31821. msgid "If dotlock exists but the mailbox isn't modified in any way, override the lock file after this much time. Defaults to @samp{\"2 mins\"}."
  31822. msgstr ""
  31823. #. type: deftypevr
  31824. #: guix-git/doc/guix.texi:21288
  31825. #, no-wrap
  31826. msgid "{@code{dovecot-configuration} parameter} boolean mbox-dirty-syncs?"
  31827. msgstr ""
  31828. #. type: deftypevr
  31829. #: guix-git/doc/guix.texi:21299
  31830. msgid "When mbox changes unexpectedly we have to fully read it to find out what changed. If the mbox is large this can take a long time. Since the change is usually just a newly appended mail, it'd be faster to simply read the new mails. If this setting is enabled, Dovecot does this but still safely fallbacks to re-reading the whole mbox file whenever something in mbox isn't how it's expected to be. The only real downside to this setting is that if some other MUA changes message flags, Dovecot doesn't notice it immediately. Note that a full sync is done with SELECT, EXAMINE, EXPUNGE and CHECK commands. Defaults to @samp{#t}."
  31831. msgstr ""
  31832. #. type: deftypevr
  31833. #: guix-git/doc/guix.texi:21301
  31834. #, no-wrap
  31835. msgid "{@code{dovecot-configuration} parameter} boolean mbox-very-dirty-syncs?"
  31836. msgstr ""
  31837. #. type: deftypevr
  31838. #: guix-git/doc/guix.texi:21306
  31839. msgid "Like @samp{mbox-dirty-syncs}, but don't do full syncs even with SELECT, EXAMINE, EXPUNGE or CHECK commands. If this is set, @samp{mbox-dirty-syncs} is ignored. Defaults to @samp{#f}."
  31840. msgstr ""
  31841. #. type: deftypevr
  31842. #: guix-git/doc/guix.texi:21308
  31843. #, no-wrap
  31844. msgid "{@code{dovecot-configuration} parameter} boolean mbox-lazy-writes?"
  31845. msgstr ""
  31846. #. type: deftypevr
  31847. #: guix-git/doc/guix.texi:21314
  31848. msgid "Delay writing mbox headers until doing a full write sync (EXPUNGE and CHECK commands and when closing the mailbox). This is especially useful for POP3 where clients often delete all mails. The downside is that our changes aren't immediately visible to other MUAs. Defaults to @samp{#t}."
  31849. msgstr ""
  31850. #. type: deftypevr
  31851. #: guix-git/doc/guix.texi:21316
  31852. #, no-wrap
  31853. msgid "{@code{dovecot-configuration} parameter} non-negative-integer mbox-min-index-size"
  31854. msgstr ""
  31855. #. type: deftypevr
  31856. #: guix-git/doc/guix.texi:21321
  31857. msgid "If mbox size is smaller than this (e.g.@: 100k), don't write index files. If an index file already exists it's still read, just not updated. Defaults to @samp{0}."
  31858. msgstr ""
  31859. #. type: deftypevr
  31860. #: guix-git/doc/guix.texi:21323
  31861. #, no-wrap
  31862. msgid "{@code{dovecot-configuration} parameter} non-negative-integer mdbox-rotate-size"
  31863. msgstr ""
  31864. #. type: deftypevr
  31865. #: guix-git/doc/guix.texi:21326
  31866. msgid "Maximum dbox file size until it's rotated. Defaults to @samp{10000000}."
  31867. msgstr ""
  31868. #. type: deftypevr
  31869. #: guix-git/doc/guix.texi:21328
  31870. #, no-wrap
  31871. msgid "{@code{dovecot-configuration} parameter} string mdbox-rotate-interval"
  31872. msgstr ""
  31873. #. type: deftypevr
  31874. #: guix-git/doc/guix.texi:21333
  31875. msgid "Maximum dbox file age until it's rotated. Typically in days. Day begins from midnight, so 1d = today, 2d = yesterday, etc. 0 = check disabled. Defaults to @samp{\"1d\"}."
  31876. msgstr ""
  31877. #. type: deftypevr
  31878. #: guix-git/doc/guix.texi:21335
  31879. #, no-wrap
  31880. msgid "{@code{dovecot-configuration} parameter} boolean mdbox-preallocate-space?"
  31881. msgstr ""
  31882. #. type: deftypevr
  31883. #: guix-git/doc/guix.texi:21340
  31884. msgid "When creating new mdbox files, immediately preallocate their size to @samp{mdbox-rotate-size}. This setting currently works only in Linux with some file systems (ext4, xfs). Defaults to @samp{#f}."
  31885. msgstr ""
  31886. #. type: deftypevr
  31887. #: guix-git/doc/guix.texi:21342
  31888. #, no-wrap
  31889. msgid "{@code{dovecot-configuration} parameter} string mail-attachment-dir"
  31890. msgstr ""
  31891. #. type: deftypevr
  31892. #: guix-git/doc/guix.texi:21346
  31893. msgid "sdbox and mdbox support saving mail attachments to external files, which also allows single instance storage for them. Other backends don't support this for now."
  31894. msgstr ""
  31895. #. type: deftypevr
  31896. #: guix-git/doc/guix.texi:21348
  31897. msgid "WARNING: This feature hasn't been tested much yet. Use at your own risk."
  31898. msgstr ""
  31899. #. type: deftypevr
  31900. #: guix-git/doc/guix.texi:21351
  31901. msgid "Directory root where to store mail attachments. Disabled, if empty. Defaults to @samp{\"\"}."
  31902. msgstr ""
  31903. #. type: deftypevr
  31904. #: guix-git/doc/guix.texi:21353
  31905. #, no-wrap
  31906. msgid "{@code{dovecot-configuration} parameter} non-negative-integer mail-attachment-min-size"
  31907. msgstr ""
  31908. #. type: deftypevr
  31909. #: guix-git/doc/guix.texi:21358
  31910. msgid "Attachments smaller than this aren't saved externally. It's also possible to write a plugin to disable saving specific attachments externally. Defaults to @samp{128000}."
  31911. msgstr ""
  31912. #. type: deftypevr
  31913. #: guix-git/doc/guix.texi:21360
  31914. #, no-wrap
  31915. msgid "{@code{dovecot-configuration} parameter} string mail-attachment-fs"
  31916. msgstr ""
  31917. #. type: deftypevr
  31918. #: guix-git/doc/guix.texi:21362
  31919. msgid "File system backend to use for saving attachments:"
  31920. msgstr ""
  31921. #. type: item
  31922. #: guix-git/doc/guix.texi:21363
  31923. #, no-wrap
  31924. msgid "posix"
  31925. msgstr ""
  31926. #. type: table
  31927. #: guix-git/doc/guix.texi:21365
  31928. msgid "No SiS done by Dovecot (but this might help FS's own deduplication)"
  31929. msgstr ""
  31930. #. type: item
  31931. #: guix-git/doc/guix.texi:21365
  31932. #, no-wrap
  31933. msgid "sis posix"
  31934. msgstr ""
  31935. #. type: table
  31936. #: guix-git/doc/guix.texi:21367
  31937. msgid "SiS with immediate byte-by-byte comparison during saving"
  31938. msgstr ""
  31939. #. type: item
  31940. #: guix-git/doc/guix.texi:21367
  31941. #, no-wrap
  31942. msgid "sis-queue posix"
  31943. msgstr ""
  31944. #. type: table
  31945. #: guix-git/doc/guix.texi:21369
  31946. msgid "SiS with delayed comparison and deduplication."
  31947. msgstr ""
  31948. #. type: deftypevr
  31949. #: guix-git/doc/guix.texi:21371
  31950. msgid "Defaults to @samp{\"sis posix\"}."
  31951. msgstr ""
  31952. #. type: deftypevr
  31953. #: guix-git/doc/guix.texi:21373
  31954. #, no-wrap
  31955. msgid "{@code{dovecot-configuration} parameter} string mail-attachment-hash"
  31956. msgstr ""
  31957. #. type: deftypevr
  31958. #: guix-git/doc/guix.texi:21379
  31959. msgid "Hash format to use in attachment filenames. You can add any text and variables: @code{%@{md4@}}, @code{%@{md5@}}, @code{%@{sha1@}}, @code{%@{sha256@}}, @code{%@{sha512@}}, @code{%@{size@}}. Variables can be truncated, e.g.@: @code{%@{sha256:80@}} returns only first 80 bits. Defaults to @samp{\"%@{sha1@}\"}."
  31960. msgstr ""
  31961. #. type: deftypevr
  31962. #: guix-git/doc/guix.texi:21381
  31963. #, no-wrap
  31964. msgid "{@code{dovecot-configuration} parameter} non-negative-integer default-process-limit"
  31965. msgstr ""
  31966. #. type: deftypevr
  31967. #: guix-git/doc/guix.texi:21386
  31968. #, no-wrap
  31969. msgid "{@code{dovecot-configuration} parameter} non-negative-integer default-client-limit"
  31970. msgstr ""
  31971. #. type: deftypevr
  31972. #: guix-git/doc/guix.texi:21389 guix-git/doc/guix.texi:29004
  31973. msgid "Defaults to @samp{1000}."
  31974. msgstr ""
  31975. #. type: deftypevr
  31976. #: guix-git/doc/guix.texi:21391
  31977. #, no-wrap
  31978. msgid "{@code{dovecot-configuration} parameter} non-negative-integer default-vsz-limit"
  31979. msgstr ""
  31980. #. type: deftypevr
  31981. #: guix-git/doc/guix.texi:21396
  31982. msgid "Default VSZ (virtual memory size) limit for service processes. This is mainly intended to catch and kill processes that leak memory before they eat up everything. Defaults to @samp{256000000}."
  31983. msgstr ""
  31984. #. type: deftypevr
  31985. #: guix-git/doc/guix.texi:21398
  31986. #, no-wrap
  31987. msgid "{@code{dovecot-configuration} parameter} string default-login-user"
  31988. msgstr ""
  31989. #. type: deftypevr
  31990. #: guix-git/doc/guix.texi:21403
  31991. msgid "Login user is internally used by login processes. This is the most untrusted user in Dovecot system. It shouldn't have access to anything at all. Defaults to @samp{\"dovenull\"}."
  31992. msgstr ""
  31993. #. type: deftypevr
  31994. #: guix-git/doc/guix.texi:21405
  31995. #, no-wrap
  31996. msgid "{@code{dovecot-configuration} parameter} string default-internal-user"
  31997. msgstr ""
  31998. #. type: deftypevr
  31999. #: guix-git/doc/guix.texi:21410
  32000. msgid "Internal user is used by unprivileged processes. It should be separate from login user, so that login processes can't disturb other processes. Defaults to @samp{\"dovecot\"}."
  32001. msgstr ""
  32002. #. type: deftypevr
  32003. #: guix-git/doc/guix.texi:21412
  32004. #, no-wrap
  32005. msgid "{@code{dovecot-configuration} parameter} string ssl?"
  32006. msgstr ""
  32007. #. type: deftypevr
  32008. #: guix-git/doc/guix.texi:21415
  32009. msgid "SSL/TLS support: yes, no, required. <doc/wiki/SSL.txt>. Defaults to @samp{\"required\"}."
  32010. msgstr ""
  32011. #. type: deftypevr
  32012. #: guix-git/doc/guix.texi:21417
  32013. #, no-wrap
  32014. msgid "{@code{dovecot-configuration} parameter} string ssl-cert"
  32015. msgstr ""
  32016. #. type: deftypevr
  32017. #: guix-git/doc/guix.texi:21420
  32018. msgid "PEM encoded X.509 SSL/TLS certificate (public key). Defaults to @samp{\"</etc/dovecot/default.pem\"}."
  32019. msgstr ""
  32020. #. type: deftypevr
  32021. #: guix-git/doc/guix.texi:21422
  32022. #, no-wrap
  32023. msgid "{@code{dovecot-configuration} parameter} string ssl-key"
  32024. msgstr ""
  32025. #. type: deftypevr
  32026. #: guix-git/doc/guix.texi:21427
  32027. msgid "PEM encoded SSL/TLS private key. The key is opened before dropping root privileges, so keep the key file unreadable by anyone but root. Defaults to @samp{\"</etc/dovecot/private/default.pem\"}."
  32028. msgstr ""
  32029. #. type: deftypevr
  32030. #: guix-git/doc/guix.texi:21429
  32031. #, no-wrap
  32032. msgid "{@code{dovecot-configuration} parameter} string ssl-key-password"
  32033. msgstr ""
  32034. #. type: deftypevr
  32035. #: guix-git/doc/guix.texi:21435
  32036. msgid "If key file is password protected, give the password here. Alternatively give it when starting dovecot with -p parameter. Since this file is often world-readable, you may want to place this setting instead to a different. Defaults to @samp{\"\"}."
  32037. msgstr ""
  32038. #. type: deftypevr
  32039. #: guix-git/doc/guix.texi:21437
  32040. #, no-wrap
  32041. msgid "{@code{dovecot-configuration} parameter} string ssl-ca"
  32042. msgstr ""
  32043. #. type: deftypevr
  32044. #: guix-git/doc/guix.texi:21443
  32045. msgid "PEM encoded trusted certificate authority. Set this only if you intend to use @samp{ssl-verify-client-cert? #t}. The file should contain the CA certificate(s) followed by the matching CRL(s). (e.g.@: @samp{ssl-ca </etc/ssl/certs/ca.pem}). Defaults to @samp{\"\"}."
  32046. msgstr ""
  32047. #. type: deftypevr
  32048. #: guix-git/doc/guix.texi:21445
  32049. #, no-wrap
  32050. msgid "{@code{dovecot-configuration} parameter} boolean ssl-require-crl?"
  32051. msgstr ""
  32052. #. type: deftypevr
  32053. #: guix-git/doc/guix.texi:21448
  32054. msgid "Require that CRL check succeeds for client certificates. Defaults to @samp{#t}."
  32055. msgstr ""
  32056. #. type: deftypevr
  32057. #: guix-git/doc/guix.texi:21450
  32058. #, no-wrap
  32059. msgid "{@code{dovecot-configuration} parameter} boolean ssl-verify-client-cert?"
  32060. msgstr ""
  32061. #. type: deftypevr
  32062. #: guix-git/doc/guix.texi:21454
  32063. msgid "Request client to send a certificate. If you also want to require it, set @samp{auth-ssl-require-client-cert? #t} in auth section. Defaults to @samp{#f}."
  32064. msgstr ""
  32065. #. type: deftypevr
  32066. #: guix-git/doc/guix.texi:21456
  32067. #, no-wrap
  32068. msgid "{@code{dovecot-configuration} parameter} string ssl-cert-username-field"
  32069. msgstr ""
  32070. #. type: deftypevr
  32071. #: guix-git/doc/guix.texi:21461
  32072. msgid "Which field from certificate to use for username. commonName and x500UniqueIdentifier are the usual choices. You'll also need to set @samp{auth-ssl-username-from-cert? #t}. Defaults to @samp{\"commonName\"}."
  32073. msgstr ""
  32074. #. type: deftypevr
  32075. #: guix-git/doc/guix.texi:21463
  32076. #, no-wrap
  32077. msgid "{@code{dovecot-configuration} parameter} string ssl-min-protocol"
  32078. msgstr ""
  32079. #. type: deftypevr
  32080. #: guix-git/doc/guix.texi:21466
  32081. msgid "Minimum SSL protocol version to accept. Defaults to @samp{\"TLSv1\"}."
  32082. msgstr ""
  32083. #. type: deftypevr
  32084. #: guix-git/doc/guix.texi:21468
  32085. #, no-wrap
  32086. msgid "{@code{dovecot-configuration} parameter} string ssl-cipher-list"
  32087. msgstr ""
  32088. #. type: deftypevr
  32089. #: guix-git/doc/guix.texi:21471
  32090. msgid "SSL ciphers to use. Defaults to @samp{\"ALL:!kRSA:!SRP:!kDHd:!DSS:!aNULL:!eNULL:!EXPORT:!DES:!3DES:!MD5:!PSK:!RC4:!ADH:!LOW@@STRENGTH\"}."
  32091. msgstr ""
  32092. #. type: deftypevr
  32093. #: guix-git/doc/guix.texi:21473
  32094. #, no-wrap
  32095. msgid "{@code{dovecot-configuration} parameter} string ssl-crypto-device"
  32096. msgstr ""
  32097. #. type: deftypevr
  32098. #: guix-git/doc/guix.texi:21476
  32099. msgid "SSL crypto device to use, for valid values run \"openssl engine\". Defaults to @samp{\"\"}."
  32100. msgstr ""
  32101. #. type: deftypevr
  32102. #: guix-git/doc/guix.texi:21478
  32103. #, no-wrap
  32104. msgid "{@code{dovecot-configuration} parameter} string postmaster-address"
  32105. msgstr ""
  32106. #. type: deftypevr
  32107. #: guix-git/doc/guix.texi:21482
  32108. msgid "Address to use when sending rejection mails. %d expands to recipient domain. Defaults to @samp{\"postmaster@@%d\"}."
  32109. msgstr ""
  32110. #. type: deftypevr
  32111. #: guix-git/doc/guix.texi:21484
  32112. #, no-wrap
  32113. msgid "{@code{dovecot-configuration} parameter} string hostname"
  32114. msgstr ""
  32115. #. type: deftypevr
  32116. #: guix-git/doc/guix.texi:21488
  32117. msgid "Hostname to use in various parts of sent mails (e.g.@: in Message-Id) and in LMTP replies. Default is the system's real hostname@@domain. Defaults to @samp{\"\"}."
  32118. msgstr ""
  32119. #. type: deftypevr
  32120. #: guix-git/doc/guix.texi:21490
  32121. #, no-wrap
  32122. msgid "{@code{dovecot-configuration} parameter} boolean quota-full-tempfail?"
  32123. msgstr ""
  32124. #. type: deftypevr
  32125. #: guix-git/doc/guix.texi:21494
  32126. msgid "If user is over quota, return with temporary failure instead of bouncing the mail. Defaults to @samp{#f}."
  32127. msgstr ""
  32128. #. type: deftypevr
  32129. #: guix-git/doc/guix.texi:21496
  32130. #, no-wrap
  32131. msgid "{@code{dovecot-configuration} parameter} file-name sendmail-path"
  32132. msgstr ""
  32133. #. type: deftypevr
  32134. #: guix-git/doc/guix.texi:21499
  32135. msgid "Binary to use for sending mails. Defaults to @samp{\"/usr/sbin/sendmail\"}."
  32136. msgstr ""
  32137. #. type: deftypevr
  32138. #: guix-git/doc/guix.texi:21501
  32139. #, no-wrap
  32140. msgid "{@code{dovecot-configuration} parameter} string submission-host"
  32141. msgstr ""
  32142. #. type: deftypevr
  32143. #: guix-git/doc/guix.texi:21505
  32144. msgid "If non-empty, send mails via this SMTP host[:port] instead of sendmail. Defaults to @samp{\"\"}."
  32145. msgstr ""
  32146. #. type: deftypevr
  32147. #: guix-git/doc/guix.texi:21507
  32148. #, no-wrap
  32149. msgid "{@code{dovecot-configuration} parameter} string rejection-subject"
  32150. msgstr ""
  32151. #. type: deftypevr
  32152. #: guix-git/doc/guix.texi:21511
  32153. msgid "Subject: header to use for rejection mails. You can use the same variables as for @samp{rejection-reason} below. Defaults to @samp{\"Rejected: %s\"}."
  32154. msgstr ""
  32155. #. type: deftypevr
  32156. #: guix-git/doc/guix.texi:21513
  32157. #, no-wrap
  32158. msgid "{@code{dovecot-configuration} parameter} string rejection-reason"
  32159. msgstr ""
  32160. #. type: deftypevr
  32161. #: guix-git/doc/guix.texi:21516
  32162. msgid "Human readable error message for rejection mails. You can use variables:"
  32163. msgstr ""
  32164. #. type: table
  32165. #: guix-git/doc/guix.texi:21520
  32166. msgid "CRLF"
  32167. msgstr ""
  32168. #. type: item
  32169. #: guix-git/doc/guix.texi:21520
  32170. #, no-wrap
  32171. msgid "%r"
  32172. msgstr ""
  32173. #. type: table
  32174. #: guix-git/doc/guix.texi:21522
  32175. msgid "reason"
  32176. msgstr ""
  32177. #. type: table
  32178. #: guix-git/doc/guix.texi:21524
  32179. msgid "original subject"
  32180. msgstr ""
  32181. #. type: item
  32182. #: guix-git/doc/guix.texi:21524
  32183. #, no-wrap
  32184. msgid "%t"
  32185. msgstr ""
  32186. #. type: table
  32187. #: guix-git/doc/guix.texi:21526
  32188. msgid "recipient"
  32189. msgstr ""
  32190. #. type: deftypevr
  32191. #: guix-git/doc/guix.texi:21528
  32192. msgid "Defaults to @samp{\"Your message to <%t> was automatically rejected:%n%r\"}."
  32193. msgstr ""
  32194. #. type: deftypevr
  32195. #: guix-git/doc/guix.texi:21530
  32196. #, no-wrap
  32197. msgid "{@code{dovecot-configuration} parameter} string recipient-delimiter"
  32198. msgstr ""
  32199. #. type: deftypevr
  32200. #: guix-git/doc/guix.texi:21534
  32201. msgid "Delimiter character between local-part and detail in email address. Defaults to @samp{\"+\"}."
  32202. msgstr ""
  32203. #. type: deftypevr
  32204. #: guix-git/doc/guix.texi:21536
  32205. #, no-wrap
  32206. msgid "{@code{dovecot-configuration} parameter} string lda-original-recipient-header"
  32207. msgstr ""
  32208. #. type: deftypevr
  32209. #: guix-git/doc/guix.texi:21542
  32210. msgid "Header where the original recipient address (SMTP's RCPT TO: address) is taken from if not available elsewhere. With dovecot-lda -a parameter overrides this. A commonly used header for this is X-Original-To. Defaults to @samp{\"\"}."
  32211. msgstr ""
  32212. #. type: deftypevr
  32213. #: guix-git/doc/guix.texi:21544
  32214. #, no-wrap
  32215. msgid "{@code{dovecot-configuration} parameter} boolean lda-mailbox-autocreate?"
  32216. msgstr ""
  32217. #. type: deftypevr
  32218. #: guix-git/doc/guix.texi:21548
  32219. msgid "Should saving a mail to a nonexistent mailbox automatically create it?. Defaults to @samp{#f}."
  32220. msgstr ""
  32221. #. type: deftypevr
  32222. #: guix-git/doc/guix.texi:21550
  32223. #, no-wrap
  32224. msgid "{@code{dovecot-configuration} parameter} boolean lda-mailbox-autosubscribe?"
  32225. msgstr ""
  32226. #. type: deftypevr
  32227. #: guix-git/doc/guix.texi:21554
  32228. msgid "Should automatically created mailboxes be also automatically subscribed?. Defaults to @samp{#f}."
  32229. msgstr ""
  32230. #. type: deftypevr
  32231. #: guix-git/doc/guix.texi:21556
  32232. #, no-wrap
  32233. msgid "{@code{dovecot-configuration} parameter} non-negative-integer imap-max-line-length"
  32234. msgstr ""
  32235. #. type: deftypevr
  32236. #: guix-git/doc/guix.texi:21562
  32237. msgid "Maximum IMAP command line length. Some clients generate very long command lines with huge mailboxes, so you may need to raise this if you get \"Too long argument\" or \"IMAP command line too large\" errors often. Defaults to @samp{64000}."
  32238. msgstr ""
  32239. #. type: deftypevr
  32240. #: guix-git/doc/guix.texi:21564
  32241. #, no-wrap
  32242. msgid "{@code{dovecot-configuration} parameter} string imap-logout-format"
  32243. msgstr ""
  32244. #. type: deftypevr
  32245. #: guix-git/doc/guix.texi:21566
  32246. msgid "IMAP logout format string:"
  32247. msgstr ""
  32248. #. type: item
  32249. #: guix-git/doc/guix.texi:21567
  32250. #, no-wrap
  32251. msgid "%i"
  32252. msgstr ""
  32253. #. type: table
  32254. #: guix-git/doc/guix.texi:21569
  32255. msgid "total number of bytes read from client"
  32256. msgstr ""
  32257. #. type: item
  32258. #: guix-git/doc/guix.texi:21569
  32259. #, no-wrap
  32260. msgid "%o"
  32261. msgstr ""
  32262. #. type: table
  32263. #: guix-git/doc/guix.texi:21571
  32264. msgid "total number of bytes sent to client."
  32265. msgstr ""
  32266. #. type: deftypevr
  32267. #: guix-git/doc/guix.texi:21574
  32268. msgid "See @file{doc/wiki/Variables.txt} for a list of all the variables you can use. Defaults to @samp{\"in=%i out=%o deleted=%@{deleted@} expunged=%@{expunged@} trashed=%@{trashed@} hdr_count=%@{fetch_hdr_count@} hdr_bytes=%@{fetch_hdr_bytes@} body_count=%@{fetch_body_count@} body_bytes=%@{fetch_body_bytes@}\"}."
  32269. msgstr ""
  32270. #. type: deftypevr
  32271. #: guix-git/doc/guix.texi:21576
  32272. #, no-wrap
  32273. msgid "{@code{dovecot-configuration} parameter} string imap-capability"
  32274. msgstr ""
  32275. #. type: deftypevr
  32276. #: guix-git/doc/guix.texi:21580
  32277. msgid "Override the IMAP CAPABILITY response. If the value begins with '+', add the given capabilities on top of the defaults (e.g.@: +XFOO XBAR). Defaults to @samp{\"\"}."
  32278. msgstr ""
  32279. #. type: deftypevr
  32280. #: guix-git/doc/guix.texi:21582
  32281. #, no-wrap
  32282. msgid "{@code{dovecot-configuration} parameter} string imap-idle-notify-interval"
  32283. msgstr ""
  32284. #. type: deftypevr
  32285. #: guix-git/doc/guix.texi:21586
  32286. msgid "How long to wait between \"OK Still here\" notifications when client is IDLEing. Defaults to @samp{\"2 mins\"}."
  32287. msgstr ""
  32288. #. type: deftypevr
  32289. #: guix-git/doc/guix.texi:21588
  32290. #, no-wrap
  32291. msgid "{@code{dovecot-configuration} parameter} string imap-id-send"
  32292. msgstr ""
  32293. #. type: deftypevr
  32294. #: guix-git/doc/guix.texi:21594
  32295. msgid "ID field names and values to send to clients. Using * as the value makes Dovecot use the default value. The following fields have default values currently: name, version, os, os-version, support-url, support-email. Defaults to @samp{\"\"}."
  32296. msgstr ""
  32297. #. type: deftypevr
  32298. #: guix-git/doc/guix.texi:21596
  32299. #, no-wrap
  32300. msgid "{@code{dovecot-configuration} parameter} string imap-id-log"
  32301. msgstr ""
  32302. #. type: deftypevr
  32303. #: guix-git/doc/guix.texi:21599
  32304. msgid "ID fields sent by client to log. * means everything. Defaults to @samp{\"\"}."
  32305. msgstr ""
  32306. #. type: deftypevr
  32307. #: guix-git/doc/guix.texi:21601
  32308. #, no-wrap
  32309. msgid "{@code{dovecot-configuration} parameter} space-separated-string-list imap-client-workarounds"
  32310. msgstr ""
  32311. #. type: deftypevr
  32312. #: guix-git/doc/guix.texi:21603
  32313. msgid "Workarounds for various client bugs:"
  32314. msgstr ""
  32315. #. type: item
  32316. #: guix-git/doc/guix.texi:21605
  32317. #, no-wrap
  32318. msgid "delay-newmail"
  32319. msgstr ""
  32320. #. type: table
  32321. #: guix-git/doc/guix.texi:21612
  32322. msgid "Send EXISTS/RECENT new mail notifications only when replying to NOOP and CHECK commands. Some clients ignore them otherwise, for example OSX Mail (<v2.1). Outlook Express breaks more badly though, without this it may show user \"Message no longer in server\" errors. Note that OE6 still breaks even with this workaround if synchronization is set to \"Headers Only\"."
  32323. msgstr ""
  32324. #. type: item
  32325. #: guix-git/doc/guix.texi:21613
  32326. #, no-wrap
  32327. msgid "tb-extra-mailbox-sep"
  32328. msgstr ""
  32329. #. type: table
  32330. #: guix-git/doc/guix.texi:21617
  32331. msgid "Thunderbird gets somehow confused with LAYOUT=fs (mbox and dbox) and adds extra @samp{/} suffixes to mailbox names. This option causes Dovecot to ignore the extra @samp{/} instead of treating it as invalid mailbox name."
  32332. msgstr ""
  32333. #. type: item
  32334. #: guix-git/doc/guix.texi:21618
  32335. #, no-wrap
  32336. msgid "tb-lsub-flags"
  32337. msgstr ""
  32338. #. type: table
  32339. #: guix-git/doc/guix.texi:21622
  32340. msgid "Show \\Noselect flags for LSUB replies with LAYOUT=fs (e.g.@: mbox). This makes Thunderbird realize they aren't selectable and show them greyed out, instead of only later giving \"not selectable\" popup error."
  32341. msgstr ""
  32342. #. type: deftypevr
  32343. #: guix-git/doc/guix.texi:21626
  32344. #, no-wrap
  32345. msgid "{@code{dovecot-configuration} parameter} string imap-urlauth-host"
  32346. msgstr ""
  32347. #. type: deftypevr
  32348. #: guix-git/doc/guix.texi:21629
  32349. msgid "Host allowed in URLAUTH URLs sent by client. \"*\" allows all. Defaults to @samp{\"\"}."
  32350. msgstr ""
  32351. #. type: Plain text
  32352. #: guix-git/doc/guix.texi:21637
  32353. msgid "Whew! Lots of configuration options. The nice thing about it though is that Guix has a complete interface to Dovecot's configuration language. This allows not only a nice way to declare configurations, but also offers reflective capabilities as well: users can write code to inspect and transform configurations from within Scheme."
  32354. msgstr ""
  32355. #. type: Plain text
  32356. #: guix-git/doc/guix.texi:21643
  32357. msgid "However, it could be that you just want to get a @code{dovecot.conf} up and running. In that case, you can pass an @code{opaque-dovecot-configuration} as the @code{#:config} parameter to @code{dovecot-service}. As its name indicates, an opaque configuration does not have easy reflective capabilities."
  32358. msgstr ""
  32359. #. type: Plain text
  32360. #: guix-git/doc/guix.texi:21645
  32361. msgid "Available @code{opaque-dovecot-configuration} fields are:"
  32362. msgstr ""
  32363. #. type: deftypevr
  32364. #: guix-git/doc/guix.texi:21646
  32365. #, no-wrap
  32366. msgid "{@code{opaque-dovecot-configuration} parameter} package dovecot"
  32367. msgstr ""
  32368. #. type: deftypevr
  32369. #: guix-git/doc/guix.texi:21650
  32370. #, no-wrap
  32371. msgid "{@code{opaque-dovecot-configuration} parameter} string string"
  32372. msgstr ""
  32373. #. type: deftypevr
  32374. #: guix-git/doc/guix.texi:21652
  32375. msgid "The contents of the @code{dovecot.conf}, as a string."
  32376. msgstr ""
  32377. #. type: Plain text
  32378. #: guix-git/doc/guix.texi:21656
  32379. msgid "For example, if your @code{dovecot.conf} is just the empty string, you could instantiate a dovecot service like this:"
  32380. msgstr ""
  32381. #. type: lisp
  32382. #: guix-git/doc/guix.texi:21661
  32383. #, no-wrap
  32384. msgid ""
  32385. "(dovecot-service #:config\n"
  32386. " (opaque-dovecot-configuration\n"
  32387. " (string \"\")))\n"
  32388. msgstr ""
  32389. #. type: subsubheading
  32390. #: guix-git/doc/guix.texi:21663
  32391. #, no-wrap
  32392. msgid "OpenSMTPD Service"
  32393. msgstr ""
  32394. #. type: deffn
  32395. #: guix-git/doc/guix.texi:21665
  32396. #, no-wrap
  32397. msgid "{Scheme Variable} opensmtpd-service-type"
  32398. msgstr ""
  32399. #. type: deffn
  32400. #: guix-git/doc/guix.texi:21669
  32401. msgid "This is the type of the @uref{https://www.opensmtpd.org, OpenSMTPD} service, whose value should be an @code{opensmtpd-configuration} object as in this example:"
  32402. msgstr ""
  32403. #. type: lisp
  32404. #: guix-git/doc/guix.texi:21674
  32405. #, no-wrap
  32406. msgid ""
  32407. "(service opensmtpd-service-type\n"
  32408. " (opensmtpd-configuration\n"
  32409. " (config-file (local-file \"./my-smtpd.conf\"))))\n"
  32410. msgstr ""
  32411. #. type: deftp
  32412. #: guix-git/doc/guix.texi:21677
  32413. #, no-wrap
  32414. msgid "{Data Type} opensmtpd-configuration"
  32415. msgstr ""
  32416. #. type: deftp
  32417. #: guix-git/doc/guix.texi:21679
  32418. msgid "Data type representing the configuration of opensmtpd."
  32419. msgstr ""
  32420. #. type: item
  32421. #: guix-git/doc/guix.texi:21681
  32422. #, no-wrap
  32423. msgid "@code{package} (default: @var{opensmtpd})"
  32424. msgstr ""
  32425. #. type: table
  32426. #: guix-git/doc/guix.texi:21683
  32427. msgid "Package object of the OpenSMTPD SMTP server."
  32428. msgstr ""
  32429. #. type: item
  32430. #: guix-git/doc/guix.texi:21684
  32431. #, no-wrap
  32432. msgid "@code{config-file} (default: @code{%default-opensmtpd-file})"
  32433. msgstr ""
  32434. #. type: table
  32435. #: guix-git/doc/guix.texi:21689
  32436. msgid "File-like object of the OpenSMTPD configuration file to use. By default it listens on the loopback network interface, and allows for mail from users and daemons on the local machine, as well as permitting email to remote servers. Run @command{man smtpd.conf} for more information."
  32437. msgstr ""
  32438. #. type: subsubheading
  32439. #: guix-git/doc/guix.texi:21693
  32440. #, no-wrap
  32441. msgid "Exim Service"
  32442. msgstr ""
  32443. #. type: cindex
  32444. #: guix-git/doc/guix.texi:21695
  32445. #, no-wrap
  32446. msgid "mail transfer agent (MTA)"
  32447. msgstr ""
  32448. #. type: cindex
  32449. #: guix-git/doc/guix.texi:21696
  32450. #, no-wrap
  32451. msgid "MTA (mail transfer agent)"
  32452. msgstr ""
  32453. #. type: cindex
  32454. #: guix-git/doc/guix.texi:21697
  32455. #, no-wrap
  32456. msgid "SMTP"
  32457. msgstr ""
  32458. #. type: deffn
  32459. #: guix-git/doc/guix.texi:21699
  32460. #, no-wrap
  32461. msgid "{Scheme Variable} exim-service-type"
  32462. msgstr ""
  32463. #. type: deffn
  32464. #: guix-git/doc/guix.texi:21703
  32465. msgid "This is the type of the @uref{https://exim.org, Exim} mail transfer agent (MTA), whose value should be an @code{exim-configuration} object as in this example:"
  32466. msgstr ""
  32467. #. type: lisp
  32468. #: guix-git/doc/guix.texi:21708
  32469. #, no-wrap
  32470. msgid ""
  32471. "(service exim-service-type\n"
  32472. " (exim-configuration\n"
  32473. " (config-file (local-file \"./my-exim.conf\"))))\n"
  32474. msgstr ""
  32475. #. type: Plain text
  32476. #: guix-git/doc/guix.texi:21714
  32477. msgid "In order to use an @code{exim-service-type} service you must also have a @code{mail-aliases-service-type} service present in your @code{operating-system} (even if it has no aliases)."
  32478. msgstr ""
  32479. #. type: deftp
  32480. #: guix-git/doc/guix.texi:21715
  32481. #, no-wrap
  32482. msgid "{Data Type} exim-configuration"
  32483. msgstr ""
  32484. #. type: deftp
  32485. #: guix-git/doc/guix.texi:21717
  32486. msgid "Data type representing the configuration of exim."
  32487. msgstr ""
  32488. #. type: item
  32489. #: guix-git/doc/guix.texi:21719
  32490. #, no-wrap
  32491. msgid "@code{package} (default: @var{exim})"
  32492. msgstr ""
  32493. #. type: table
  32494. #: guix-git/doc/guix.texi:21721
  32495. msgid "Package object of the Exim server."
  32496. msgstr ""
  32497. #. type: table
  32498. #: guix-git/doc/guix.texi:21728
  32499. msgid "File-like object of the Exim configuration file to use. If its value is @code{#f} then use the default configuration file from the package provided in @code{package}. The resulting configuration file is loaded after setting the @code{exim_user} and @code{exim_group} configuration variables."
  32500. msgstr ""
  32501. #. type: subsubheading
  32502. #: guix-git/doc/guix.texi:21732
  32503. #, no-wrap
  32504. msgid "Getmail service"
  32505. msgstr ""
  32506. #. type: cindex
  32507. #: guix-git/doc/guix.texi:21734
  32508. #, no-wrap
  32509. msgid "IMAP"
  32510. msgstr ""
  32511. #. type: cindex
  32512. #: guix-git/doc/guix.texi:21735
  32513. #, no-wrap
  32514. msgid "POP"
  32515. msgstr ""
  32516. #. type: deffn
  32517. #: guix-git/doc/guix.texi:21737
  32518. #, no-wrap
  32519. msgid "{Scheme Variable} getmail-service-type"
  32520. msgstr ""
  32521. #. type: deffn
  32522. #: guix-git/doc/guix.texi:21740
  32523. msgid "This is the type of the @uref{http://pyropus.ca/software/getmail/, Getmail} mail retriever, whose value should be an @code{getmail-configuration}."
  32524. msgstr ""
  32525. #. type: Plain text
  32526. #: guix-git/doc/guix.texi:21743
  32527. msgid "Available @code{getmail-configuration} fields are:"
  32528. msgstr ""
  32529. #. type: deftypevr
  32530. #: guix-git/doc/guix.texi:21744
  32531. #, no-wrap
  32532. msgid "{@code{getmail-configuration} parameter} symbol name"
  32533. msgstr ""
  32534. #. type: deftypevr
  32535. #: guix-git/doc/guix.texi:21746
  32536. msgid "A symbol to identify the getmail service."
  32537. msgstr ""
  32538. #. type: deftypevr
  32539. #: guix-git/doc/guix.texi:21748
  32540. msgid "Defaults to @samp{\"unset\"}."
  32541. msgstr ""
  32542. #. type: deftypevr
  32543. #: guix-git/doc/guix.texi:21751
  32544. #, no-wrap
  32545. msgid "{@code{getmail-configuration} parameter} package package"
  32546. msgstr ""
  32547. #. type: deftypevr
  32548. #: guix-git/doc/guix.texi:21753
  32549. msgid "The getmail package to use."
  32550. msgstr ""
  32551. #. type: deftypevr
  32552. #: guix-git/doc/guix.texi:21756
  32553. #, no-wrap
  32554. msgid "{@code{getmail-configuration} parameter} string user"
  32555. msgstr ""
  32556. #. type: deftypevr
  32557. #: guix-git/doc/guix.texi:21758
  32558. msgid "The user to run getmail as."
  32559. msgstr ""
  32560. #. type: deftypevr
  32561. #: guix-git/doc/guix.texi:21760 guix-git/doc/guix.texi:21767
  32562. msgid "Defaults to @samp{\"getmail\"}."
  32563. msgstr ""
  32564. #. type: deftypevr
  32565. #: guix-git/doc/guix.texi:21763
  32566. #, no-wrap
  32567. msgid "{@code{getmail-configuration} parameter} string group"
  32568. msgstr ""
  32569. #. type: deftypevr
  32570. #: guix-git/doc/guix.texi:21765
  32571. msgid "The group to run getmail as."
  32572. msgstr ""
  32573. #. type: deftypevr
  32574. #: guix-git/doc/guix.texi:21770
  32575. #, no-wrap
  32576. msgid "{@code{getmail-configuration} parameter} string directory"
  32577. msgstr ""
  32578. #. type: deftypevr
  32579. #: guix-git/doc/guix.texi:21772
  32580. msgid "The getmail directory to use."
  32581. msgstr ""
  32582. #. type: deftypevr
  32583. #: guix-git/doc/guix.texi:21774
  32584. msgid "Defaults to @samp{\"/var/lib/getmail/default\"}."
  32585. msgstr ""
  32586. #. type: deftypevr
  32587. #: guix-git/doc/guix.texi:21777
  32588. #, no-wrap
  32589. msgid "{@code{getmail-configuration} parameter} getmail-configuration-file rcfile"
  32590. msgstr ""
  32591. #. type: deftypevr
  32592. #: guix-git/doc/guix.texi:21779
  32593. msgid "The getmail configuration file to use."
  32594. msgstr ""
  32595. #. type: deftypevr
  32596. #: guix-git/doc/guix.texi:21781
  32597. msgid "Available @code{getmail-configuration-file} fields are:"
  32598. msgstr ""
  32599. #. type: deftypevr
  32600. #: guix-git/doc/guix.texi:21782
  32601. #, no-wrap
  32602. msgid "{@code{getmail-configuration-file} parameter} getmail-retriever-configuration retriever"
  32603. msgstr ""
  32604. #. type: deftypevr
  32605. #: guix-git/doc/guix.texi:21784
  32606. msgid "What mail account to retrieve mail from, and how to access that account."
  32607. msgstr ""
  32608. #. type: deftypevr
  32609. #: guix-git/doc/guix.texi:21786
  32610. msgid "Available @code{getmail-retriever-configuration} fields are:"
  32611. msgstr ""
  32612. #. type: deftypevr
  32613. #: guix-git/doc/guix.texi:21787
  32614. #, no-wrap
  32615. msgid "{@code{getmail-retriever-configuration} parameter} string type"
  32616. msgstr ""
  32617. #. type: deftypevr
  32618. #: guix-git/doc/guix.texi:21790
  32619. msgid "The type of mail retriever to use. Valid values include @samp{passwd} and @samp{static}."
  32620. msgstr ""
  32621. #. type: deftypevr
  32622. #: guix-git/doc/guix.texi:21792
  32623. msgid "Defaults to @samp{\"SimpleIMAPSSLRetriever\"}."
  32624. msgstr ""
  32625. #. type: deftypevr
  32626. #: guix-git/doc/guix.texi:21795
  32627. #, no-wrap
  32628. msgid "{@code{getmail-retriever-configuration} parameter} string server"
  32629. msgstr ""
  32630. #. type: deftypevr
  32631. #: guix-git/doc/guix.texi:21797 guix-git/doc/guix.texi:21804
  32632. msgid "Username to login to the mail server with."
  32633. msgstr ""
  32634. #. type: deftypevr
  32635. #: guix-git/doc/guix.texi:21799 guix-git/doc/guix.texi:21806
  32636. #: guix-git/doc/guix.texi:21870
  32637. msgid "Defaults to @samp{unset}."
  32638. msgstr ""
  32639. #. type: deftypevr
  32640. #: guix-git/doc/guix.texi:21802
  32641. #, no-wrap
  32642. msgid "{@code{getmail-retriever-configuration} parameter} string username"
  32643. msgstr ""
  32644. #. type: deftypevr
  32645. #: guix-git/doc/guix.texi:21809
  32646. #, no-wrap
  32647. msgid "{@code{getmail-retriever-configuration} parameter} non-negative-integer port"
  32648. msgstr ""
  32649. #. type: deftypevr
  32650. #: guix-git/doc/guix.texi:21811
  32651. msgid "Port number to connect to."
  32652. msgstr ""
  32653. #. type: deftypevr
  32654. #: guix-git/doc/guix.texi:21816
  32655. #, no-wrap
  32656. msgid "{@code{getmail-retriever-configuration} parameter} string password"
  32657. msgstr ""
  32658. #. type: deftypevr
  32659. #: guix-git/doc/guix.texi:21818 guix-git/doc/guix.texi:21825
  32660. msgid "Override fields from passwd."
  32661. msgstr ""
  32662. #. type: deftypevr
  32663. #: guix-git/doc/guix.texi:21823
  32664. #, no-wrap
  32665. msgid "{@code{getmail-retriever-configuration} parameter} list password-command"
  32666. msgstr ""
  32667. #. type: deftypevr
  32668. #: guix-git/doc/guix.texi:21830
  32669. #, no-wrap
  32670. msgid "{@code{getmail-retriever-configuration} parameter} string keyfile"
  32671. msgstr ""
  32672. #. type: deftypevr
  32673. #: guix-git/doc/guix.texi:21832
  32674. msgid "PEM-formatted key file to use for the TLS negotiation."
  32675. msgstr ""
  32676. #. type: deftypevr
  32677. #: guix-git/doc/guix.texi:21837
  32678. #, no-wrap
  32679. msgid "{@code{getmail-retriever-configuration} parameter} string certfile"
  32680. msgstr ""
  32681. #. type: deftypevr
  32682. #: guix-git/doc/guix.texi:21839
  32683. msgid "PEM-formatted certificate file to use for the TLS negotiation."
  32684. msgstr ""
  32685. #. type: deftypevr
  32686. #: guix-git/doc/guix.texi:21844
  32687. #, no-wrap
  32688. msgid "{@code{getmail-retriever-configuration} parameter} string ca-certs"
  32689. msgstr ""
  32690. #. type: deftypevr
  32691. #: guix-git/doc/guix.texi:21846
  32692. msgid "CA certificates to use."
  32693. msgstr ""
  32694. #. type: deftypevr
  32695. #: guix-git/doc/guix.texi:21851
  32696. #, no-wrap
  32697. msgid "{@code{getmail-retriever-configuration} parameter} parameter-alist extra-parameters"
  32698. msgstr ""
  32699. #. type: deftypevr
  32700. #: guix-git/doc/guix.texi:21853
  32701. msgid "Extra retriever parameters."
  32702. msgstr ""
  32703. #. type: deftypevr
  32704. #: guix-git/doc/guix.texi:21860
  32705. #, no-wrap
  32706. msgid "{@code{getmail-configuration-file} parameter} getmail-destination-configuration destination"
  32707. msgstr ""
  32708. #. type: deftypevr
  32709. #: guix-git/doc/guix.texi:21862
  32710. msgid "What to do with retrieved messages."
  32711. msgstr ""
  32712. #. type: deftypevr
  32713. #: guix-git/doc/guix.texi:21864
  32714. msgid "Available @code{getmail-destination-configuration} fields are:"
  32715. msgstr ""
  32716. #. type: deftypevr
  32717. #: guix-git/doc/guix.texi:21865
  32718. #, no-wrap
  32719. msgid "{@code{getmail-destination-configuration} parameter} string type"
  32720. msgstr ""
  32721. #. type: deftypevr
  32722. #: guix-git/doc/guix.texi:21868
  32723. msgid "The type of mail destination. Valid values include @samp{Maildir}, @samp{Mboxrd} and @samp{MDA_external}."
  32724. msgstr ""
  32725. #. type: deftypevr
  32726. #: guix-git/doc/guix.texi:21873
  32727. #, no-wrap
  32728. msgid "{@code{getmail-destination-configuration} parameter} string-or-filelike path"
  32729. msgstr ""
  32730. #. type: deftypevr
  32731. #: guix-git/doc/guix.texi:21876
  32732. msgid "The path option for the mail destination. The behaviour depends on the chosen type."
  32733. msgstr ""
  32734. #. type: deftypevr
  32735. #: guix-git/doc/guix.texi:21881
  32736. #, no-wrap
  32737. msgid "{@code{getmail-destination-configuration} parameter} parameter-alist extra-parameters"
  32738. msgstr ""
  32739. #. type: deftypevr
  32740. #: guix-git/doc/guix.texi:21883
  32741. msgid "Extra destination parameters"
  32742. msgstr ""
  32743. #. type: deftypevr
  32744. #: guix-git/doc/guix.texi:21890
  32745. #, no-wrap
  32746. msgid "{@code{getmail-configuration-file} parameter} getmail-options-configuration options"
  32747. msgstr ""
  32748. #. type: deftypevr
  32749. #: guix-git/doc/guix.texi:21892
  32750. msgid "Configure getmail."
  32751. msgstr ""
  32752. #. type: deftypevr
  32753. #: guix-git/doc/guix.texi:21894
  32754. msgid "Available @code{getmail-options-configuration} fields are:"
  32755. msgstr ""
  32756. #. type: deftypevr
  32757. #: guix-git/doc/guix.texi:21895
  32758. #, no-wrap
  32759. msgid "{@code{getmail-options-configuration} parameter} non-negative-integer verbose"
  32760. msgstr ""
  32761. #. type: deftypevr
  32762. #: guix-git/doc/guix.texi:21900
  32763. msgid "If set to @samp{0}, getmail will only print warnings and errors. A value of @samp{1} means that messages will be printed about retrieving and deleting messages. If set to @samp{2}, getmail will print messages about each of its actions."
  32764. msgstr ""
  32765. #. type: deftypevr
  32766. #: guix-git/doc/guix.texi:21902 guix-git/doc/guix.texi:28474
  32767. #: guix-git/doc/guix.texi:29062 guix-git/doc/guix.texi:29207
  32768. msgid "Defaults to @samp{1}."
  32769. msgstr ""
  32770. #. type: deftypevr
  32771. #: guix-git/doc/guix.texi:21905
  32772. #, no-wrap
  32773. msgid "{@code{getmail-options-configuration} parameter} boolean read-all"
  32774. msgstr ""
  32775. #. type: deftypevr
  32776. #: guix-git/doc/guix.texi:21908
  32777. msgid "If true, getmail will retrieve all available messages. Otherwise it will only retrieve messages it hasn't seen previously."
  32778. msgstr ""
  32779. #. type: deftypevr
  32780. #: guix-git/doc/guix.texi:21913
  32781. #, no-wrap
  32782. msgid "{@code{getmail-options-configuration} parameter} boolean delete"
  32783. msgstr ""
  32784. #. type: deftypevr
  32785. #: guix-git/doc/guix.texi:21917
  32786. msgid "If set to true, messages will be deleted from the server after retrieving and successfully delivering them. Otherwise, messages will be left on the server."
  32787. msgstr ""
  32788. #. type: deftypevr
  32789. #: guix-git/doc/guix.texi:21922
  32790. #, no-wrap
  32791. msgid "{@code{getmail-options-configuration} parameter} non-negative-integer delete-after"
  32792. msgstr ""
  32793. #. type: deftypevr
  32794. #: guix-git/doc/guix.texi:21927
  32795. msgid "Getmail will delete messages this number of days after seeing them, if they have been delivered. This means messages will be left on the server this number of days after delivering them. A value of @samp{0} disabled this feature."
  32796. msgstr ""
  32797. #. type: deftypevr
  32798. #: guix-git/doc/guix.texi:21932
  32799. #, no-wrap
  32800. msgid "{@code{getmail-options-configuration} parameter} non-negative-integer delete-bigger-than"
  32801. msgstr ""
  32802. #. type: deftypevr
  32803. #: guix-git/doc/guix.texi:21936
  32804. msgid "Delete messages larger than this of bytes after retrieving them, even if the delete and delete-after options are disabled. A value of @samp{0} disables this feature."
  32805. msgstr ""
  32806. #. type: deftypevr
  32807. #: guix-git/doc/guix.texi:21941
  32808. #, no-wrap
  32809. msgid "{@code{getmail-options-configuration} parameter} non-negative-integer max-bytes-per-session"
  32810. msgstr ""
  32811. #. type: deftypevr
  32812. #: guix-git/doc/guix.texi:21944
  32813. msgid "Retrieve messages totalling up to this number of bytes before closing the session with the server. A value of @samp{0} disables this feature."
  32814. msgstr ""
  32815. #. type: deftypevr
  32816. #: guix-git/doc/guix.texi:21949
  32817. #, no-wrap
  32818. msgid "{@code{getmail-options-configuration} parameter} non-negative-integer max-message-size"
  32819. msgstr ""
  32820. #. type: deftypevr
  32821. #: guix-git/doc/guix.texi:21952
  32822. msgid "Don't retrieve messages larger than this number of bytes. A value of @samp{0} disables this feature."
  32823. msgstr ""
  32824. #. type: deftypevr
  32825. #: guix-git/doc/guix.texi:21957
  32826. #, no-wrap
  32827. msgid "{@code{getmail-options-configuration} parameter} boolean delivered-to"
  32828. msgstr ""
  32829. #. type: deftypevr
  32830. #: guix-git/doc/guix.texi:21959
  32831. msgid "If true, getmail will add a Delivered-To header to messages."
  32832. msgstr ""
  32833. #. type: deftypevr
  32834. #: guix-git/doc/guix.texi:21964
  32835. #, no-wrap
  32836. msgid "{@code{getmail-options-configuration} parameter} boolean received"
  32837. msgstr ""
  32838. #. type: deftypevr
  32839. #: guix-git/doc/guix.texi:21966
  32840. msgid "If set, getmail adds a Received header to the messages."
  32841. msgstr ""
  32842. #. type: deftypevr
  32843. #: guix-git/doc/guix.texi:21971
  32844. #, no-wrap
  32845. msgid "{@code{getmail-options-configuration} parameter} string message-log"
  32846. msgstr ""
  32847. #. type: deftypevr
  32848. #: guix-git/doc/guix.texi:21974
  32849. msgid "Getmail will record a log of its actions to the named file. A value of @samp{\"\"} disables this feature."
  32850. msgstr ""
  32851. #. type: deftypevr
  32852. #: guix-git/doc/guix.texi:21979
  32853. #, no-wrap
  32854. msgid "{@code{getmail-options-configuration} parameter} boolean message-log-syslog"
  32855. msgstr ""
  32856. #. type: deftypevr
  32857. #: guix-git/doc/guix.texi:21982
  32858. msgid "If true, getmail will record a log of its actions using the system logger."
  32859. msgstr ""
  32860. #. type: deftypevr
  32861. #: guix-git/doc/guix.texi:21987
  32862. #, no-wrap
  32863. msgid "{@code{getmail-options-configuration} parameter} boolean message-log-verbose"
  32864. msgstr ""
  32865. #. type: deftypevr
  32866. #: guix-git/doc/guix.texi:21991
  32867. msgid "If true, getmail will log information about messages not retrieved and the reason for not retrieving them, as well as starting and ending information lines."
  32868. msgstr ""
  32869. #. type: deftypevr
  32870. #: guix-git/doc/guix.texi:21996
  32871. #, no-wrap
  32872. msgid "{@code{getmail-options-configuration} parameter} parameter-alist extra-parameters"
  32873. msgstr ""
  32874. #. type: deftypevr
  32875. #: guix-git/doc/guix.texi:21998
  32876. msgid "Extra options to include."
  32877. msgstr ""
  32878. #. type: deftypevr
  32879. #: guix-git/doc/guix.texi:22007
  32880. #, no-wrap
  32881. msgid "{@code{getmail-configuration} parameter} list idle"
  32882. msgstr ""
  32883. #. type: deftypevr
  32884. #: guix-git/doc/guix.texi:22011
  32885. msgid "A list of mailboxes that getmail should wait on the server for new mail notifications. This depends on the server supporting the IDLE extension."
  32886. msgstr ""
  32887. #. type: deftypevr
  32888. #: guix-git/doc/guix.texi:22016
  32889. #, no-wrap
  32890. msgid "{@code{getmail-configuration} parameter} list environment-variables"
  32891. msgstr ""
  32892. #. type: deftypevr
  32893. #: guix-git/doc/guix.texi:22018
  32894. msgid "Environment variables to set for getmail."
  32895. msgstr ""
  32896. #. type: subsubheading
  32897. #: guix-git/doc/guix.texi:22023
  32898. #, no-wrap
  32899. msgid "Mail Aliases Service"
  32900. msgstr ""
  32901. #. type: cindex
  32902. #: guix-git/doc/guix.texi:22025
  32903. #, no-wrap
  32904. msgid "email aliases"
  32905. msgstr ""
  32906. #. type: cindex
  32907. #: guix-git/doc/guix.texi:22026
  32908. #, no-wrap
  32909. msgid "aliases, for email addresses"
  32910. msgstr ""
  32911. #. type: deffn
  32912. #: guix-git/doc/guix.texi:22028
  32913. #, no-wrap
  32914. msgid "{Scheme Variable} mail-aliases-service-type"
  32915. msgstr ""
  32916. #. type: deffn
  32917. #: guix-git/doc/guix.texi:22031
  32918. msgid "This is the type of the service which provides @code{/etc/aliases}, specifying how to deliver mail to users on this system."
  32919. msgstr ""
  32920. #. type: lisp
  32921. #: guix-git/doc/guix.texi:22036
  32922. #, no-wrap
  32923. msgid ""
  32924. "(service mail-aliases-service-type\n"
  32925. " '((\"postmaster\" \"bob\")\n"
  32926. " (\"bob\" \"bob@@example.com\" \"bob@@example2.com\")))\n"
  32927. msgstr ""
  32928. #. type: Plain text
  32929. #: guix-git/doc/guix.texi:22044
  32930. msgid "The configuration for a @code{mail-aliases-service-type} service is an association list denoting how to deliver mail that comes to this system. Each entry is of the form @code{(alias addresses ...)}, with @code{alias} specifying the local alias and @code{addresses} specifying where to deliver this user's mail."
  32931. msgstr ""
  32932. #. type: Plain text
  32933. #: guix-git/doc/guix.texi:22050
  32934. msgid "The aliases aren't required to exist as users on the local system. In the above example, there doesn't need to be a @code{postmaster} entry in the @code{operating-system}'s @code{user-accounts} in order to deliver the @code{postmaster} mail to @code{bob} (which subsequently would deliver mail to @code{bob@@example.com} and @code{bob@@example2.com})."
  32935. msgstr ""
  32936. #. type: cindex
  32937. #: guix-git/doc/guix.texi:22051 guix-git/doc/guix.texi:22052
  32938. #, no-wrap
  32939. msgid "GNU Mailutils IMAP4 Daemon"
  32940. msgstr ""
  32941. #. type: deffn
  32942. #: guix-git/doc/guix.texi:22054
  32943. #, no-wrap
  32944. msgid "{Scheme Variable} imap4d-service-type"
  32945. msgstr ""
  32946. #. type: deffn
  32947. #: guix-git/doc/guix.texi:22058
  32948. msgid "This is the type of the GNU Mailutils IMAP4 Daemon (@pxref{imap4d,,, mailutils, GNU Mailutils Manual}), whose value should be an @code{imap4d-configuration} object as in this example:"
  32949. msgstr ""
  32950. #. type: lisp
  32951. #: guix-git/doc/guix.texi:22063
  32952. #, no-wrap
  32953. msgid ""
  32954. "(service imap4d-service-type\n"
  32955. " (imap4d-configuration\n"
  32956. " (config-file (local-file \"imap4d.conf\"))))\n"
  32957. msgstr ""
  32958. #. type: deftp
  32959. #: guix-git/doc/guix.texi:22066
  32960. #, no-wrap
  32961. msgid "{Data Type} imap4d-configuration"
  32962. msgstr ""
  32963. #. type: deftp
  32964. #: guix-git/doc/guix.texi:22068
  32965. msgid "Data type representing the configuration of @command{imap4d}."
  32966. msgstr ""
  32967. #. type: item
  32968. #: guix-git/doc/guix.texi:22070
  32969. #, no-wrap
  32970. msgid "@code{package} (default: @code{mailutils})"
  32971. msgstr ""
  32972. #. type: table
  32973. #: guix-git/doc/guix.texi:22072
  32974. msgid "The package that provides @command{imap4d}."
  32975. msgstr ""
  32976. #. type: item
  32977. #: guix-git/doc/guix.texi:22073
  32978. #, no-wrap
  32979. msgid "@code{config-file} (default: @code{%default-imap4d-config-file})"
  32980. msgstr ""
  32981. #. type: table
  32982. #: guix-git/doc/guix.texi:22077
  32983. msgid "File-like object of the configuration file to use, by default it will listen on TCP port 143 of @code{localhost}. @xref{Conf-imap4d,,, mailutils, GNU Mailutils Manual}, for details."
  32984. msgstr ""
  32985. #. type: subsubheading
  32986. #: guix-git/doc/guix.texi:22081
  32987. #, no-wrap
  32988. msgid "Radicale Service"
  32989. msgstr ""
  32990. #. type: cindex
  32991. #: guix-git/doc/guix.texi:22082
  32992. #, no-wrap
  32993. msgid "CalDAV"
  32994. msgstr ""
  32995. #. type: cindex
  32996. #: guix-git/doc/guix.texi:22083
  32997. #, no-wrap
  32998. msgid "CardDAV"
  32999. msgstr ""
  33000. #. type: deffn
  33001. #: guix-git/doc/guix.texi:22085
  33002. #, no-wrap
  33003. msgid "{Scheme Variable} radicale-service-type"
  33004. msgstr ""
  33005. #. type: deffn
  33006. #: guix-git/doc/guix.texi:22088
  33007. msgid "This is the type of the @uref{https://radicale.org, Radicale} CalDAV/CardDAV server whose value should be a @code{radicale-configuration}."
  33008. msgstr ""
  33009. #. type: deftp
  33010. #: guix-git/doc/guix.texi:22090
  33011. #, no-wrap
  33012. msgid "{Data Type} radicale-configuration"
  33013. msgstr ""
  33014. #. type: deftp
  33015. #: guix-git/doc/guix.texi:22092
  33016. msgid "Data type representing the configuration of @command{radicale}."
  33017. msgstr ""
  33018. #. type: item
  33019. #: guix-git/doc/guix.texi:22094
  33020. #, no-wrap
  33021. msgid "@code{package} (default: @code{radicale})"
  33022. msgstr ""
  33023. #. type: table
  33024. #: guix-git/doc/guix.texi:22096
  33025. msgid "The package that provides @command{radicale}."
  33026. msgstr ""
  33027. #. type: item
  33028. #: guix-git/doc/guix.texi:22097
  33029. #, no-wrap
  33030. msgid "@code{config-file} (default: @code{%default-radicale-config-file})"
  33031. msgstr ""
  33032. #. type: table
  33033. #: guix-git/doc/guix.texi:22101
  33034. msgid "File-like object of the configuration file to use, by default it will listen on TCP port 5232 of @code{localhost} and use the @code{htpasswd} file at @file{/var/lib/radicale/users} with no (@code{plain}) encryption."
  33035. msgstr ""
  33036. #. type: cindex
  33037. #: guix-git/doc/guix.texi:22108
  33038. #, no-wrap
  33039. msgid "messaging"
  33040. msgstr ""
  33041. #. type: cindex
  33042. #: guix-git/doc/guix.texi:22109
  33043. #, no-wrap
  33044. msgid "jabber"
  33045. msgstr ""
  33046. #. type: cindex
  33047. #: guix-git/doc/guix.texi:22110
  33048. #, no-wrap
  33049. msgid "XMPP"
  33050. msgstr ""
  33051. #. type: Plain text
  33052. #: guix-git/doc/guix.texi:22114
  33053. msgid "The @code{(gnu services messaging)} module provides Guix service definitions for messaging services. Currently it provides the following services:"
  33054. msgstr ""
  33055. #. type: subsubheading
  33056. #: guix-git/doc/guix.texi:22115
  33057. #, no-wrap
  33058. msgid "Prosody Service"
  33059. msgstr ""
  33060. #. type: deffn
  33061. #: guix-git/doc/guix.texi:22117
  33062. #, no-wrap
  33063. msgid "{Scheme Variable} prosody-service-type"
  33064. msgstr ""
  33065. #. type: deffn
  33066. #: guix-git/doc/guix.texi:22121
  33067. msgid "This is the type for the @uref{https://prosody.im, Prosody XMPP communication server}. Its value must be a @code{prosody-configuration} record as in this example:"
  33068. msgstr ""
  33069. #. type: lisp
  33070. #: guix-git/doc/guix.texi:22136
  33071. #, no-wrap
  33072. msgid ""
  33073. "(service prosody-service-type\n"
  33074. " (prosody-configuration\n"
  33075. " (modules-enabled (cons* \"groups\" \"mam\" %default-modules-enabled))\n"
  33076. " (int-components\n"
  33077. " (list\n"
  33078. " (int-component-configuration\n"
  33079. " (hostname \"conference.example.net\")\n"
  33080. " (plugin \"muc\")\n"
  33081. " (mod-muc (mod-muc-configuration)))))\n"
  33082. " (virtualhosts\n"
  33083. " (list\n"
  33084. " (virtualhost-configuration\n"
  33085. " (domain \"example.net\"))))))\n"
  33086. msgstr ""
  33087. #. type: deffn
  33088. #: guix-git/doc/guix.texi:22139
  33089. msgid "See below for details about @code{prosody-configuration}."
  33090. msgstr ""
  33091. #. type: Plain text
  33092. #: guix-git/doc/guix.texi:22145
  33093. msgid "By default, Prosody does not need much configuration. Only one @code{virtualhosts} field is needed: it specifies the domain you wish Prosody to serve."
  33094. msgstr ""
  33095. #. type: Plain text
  33096. #: guix-git/doc/guix.texi:22148
  33097. msgid "You can perform various sanity checks on the generated configuration with the @code{prosodyctl check} command."
  33098. msgstr ""
  33099. #. type: Plain text
  33100. #: guix-git/doc/guix.texi:22152
  33101. msgid "Prosodyctl will also help you to import certificates from the @code{letsencrypt} directory so that the @code{prosody} user can access them. See @url{https://prosody.im/doc/letsencrypt}."
  33102. msgstr ""
  33103. #. type: example
  33104. #: guix-git/doc/guix.texi:22155
  33105. #, no-wrap
  33106. msgid "prosodyctl --root cert import /etc/letsencrypt/live\n"
  33107. msgstr ""
  33108. #. type: Plain text
  33109. #: guix-git/doc/guix.texi:22162
  33110. msgid "The available configuration parameters follow. Each parameter definition is preceded by its type; for example, @samp{string-list foo} indicates that the @code{foo} parameter should be specified as a list of strings. Types starting with @code{maybe-} denote parameters that won't show up in @code{prosody.cfg.lua} when their value is @code{'disabled}."
  33111. msgstr ""
  33112. #. type: Plain text
  33113. #: guix-git/doc/guix.texi:22166
  33114. msgid "There is also a way to specify the configuration as a string, if you have an old @code{prosody.cfg.lua} file that you want to port over from some other system; see the end for more details."
  33115. msgstr ""
  33116. #. type: Plain text
  33117. #: guix-git/doc/guix.texi:22169
  33118. msgid "The @code{file-object} type designates either a file-like object (@pxref{G-Expressions, file-like objects}) or a file name."
  33119. msgstr ""
  33120. #. type: Plain text
  33121. #: guix-git/doc/guix.texi:22179
  33122. msgid "Available @code{prosody-configuration} fields are:"
  33123. msgstr ""
  33124. #. type: deftypevr
  33125. #: guix-git/doc/guix.texi:22180
  33126. #, no-wrap
  33127. msgid "{@code{prosody-configuration} parameter} package prosody"
  33128. msgstr ""
  33129. #. type: deftypevr
  33130. #: guix-git/doc/guix.texi:22182
  33131. msgid "The Prosody package."
  33132. msgstr ""
  33133. #. type: deftypevr
  33134. #: guix-git/doc/guix.texi:22184
  33135. #, no-wrap
  33136. msgid "{@code{prosody-configuration} parameter} file-name data-path"
  33137. msgstr ""
  33138. #. type: deftypevr
  33139. #: guix-git/doc/guix.texi:22188
  33140. msgid "Location of the Prosody data storage directory. See @url{https://prosody.im/doc/configure}. Defaults to @samp{\"/var/lib/prosody\"}."
  33141. msgstr ""
  33142. #. type: deftypevr
  33143. #: guix-git/doc/guix.texi:22190
  33144. #, no-wrap
  33145. msgid "{@code{prosody-configuration} parameter} file-object-list plugin-paths"
  33146. msgstr ""
  33147. #. type: deftypevr
  33148. #: guix-git/doc/guix.texi:22194
  33149. msgid "Additional plugin directories. They are searched in all the specified paths in order. See @url{https://prosody.im/doc/plugins_directory}. Defaults to @samp{()}."
  33150. msgstr ""
  33151. #. type: deftypevr
  33152. #: guix-git/doc/guix.texi:22196
  33153. #, no-wrap
  33154. msgid "{@code{prosody-configuration} parameter} file-name certificates"
  33155. msgstr ""
  33156. #. type: deftypevr
  33157. #: guix-git/doc/guix.texi:22201
  33158. msgid "Every virtual host and component needs a certificate so that clients and servers can securely verify its identity. Prosody will automatically load certificates/keys from the directory specified here. Defaults to @samp{\"/etc/prosody/certs\"}."
  33159. msgstr ""
  33160. #. type: deftypevr
  33161. #: guix-git/doc/guix.texi:22203
  33162. #, no-wrap
  33163. msgid "{@code{prosody-configuration} parameter} string-list admins"
  33164. msgstr ""
  33165. #. type: deftypevr
  33166. #: guix-git/doc/guix.texi:22209
  33167. msgid "This is a list of accounts that are admins for the server. Note that you must create the accounts separately. See @url{https://prosody.im/doc/admins} and @url{https://prosody.im/doc/creating_accounts}. Example: @code{(admins '(\"user1@@example.com\" \"user2@@example.net\"))} Defaults to @samp{()}."
  33168. msgstr ""
  33169. #. type: deftypevr
  33170. #: guix-git/doc/guix.texi:22211
  33171. #, no-wrap
  33172. msgid "{@code{prosody-configuration} parameter} boolean use-libevent?"
  33173. msgstr ""
  33174. #. type: deftypevr
  33175. #: guix-git/doc/guix.texi:22215
  33176. msgid "Enable use of libevent for better performance under high load. See @url{https://prosody.im/doc/libevent}. Defaults to @samp{#f}."
  33177. msgstr ""
  33178. #. type: deftypevr
  33179. #: guix-git/doc/guix.texi:22217
  33180. #, no-wrap
  33181. msgid "{@code{prosody-configuration} parameter} module-list modules-enabled"
  33182. msgstr ""
  33183. #. type: deftypevr
  33184. #: guix-git/doc/guix.texi:22223
  33185. msgid "This is the list of modules Prosody will load on startup. It looks for @code{mod_modulename.lua} in the plugins folder, so make sure that exists too. Documentation on modules can be found at: @url{https://prosody.im/doc/modules}. Defaults to @samp{(\"roster\" \"saslauth\" \"tls\" \"dialback\" \"disco\" \"carbons\" \"private\" \"blocklist\" \"vcard\" \"version\" \"uptime\" \"time\" \"ping\" \"pep\" \"register\" \"admin_adhoc\")}."
  33186. msgstr ""
  33187. #. type: deftypevr
  33188. #: guix-git/doc/guix.texi:22225
  33189. #, no-wrap
  33190. msgid "{@code{prosody-configuration} parameter} string-list modules-disabled"
  33191. msgstr ""
  33192. #. type: deftypevr
  33193. #: guix-git/doc/guix.texi:22229
  33194. msgid "@samp{\"offline\"}, @samp{\"c2s\"} and @samp{\"s2s\"} are auto-loaded, but should you want to disable them then add them to this list. Defaults to @samp{()}."
  33195. msgstr ""
  33196. #. type: deftypevr
  33197. #: guix-git/doc/guix.texi:22231
  33198. #, no-wrap
  33199. msgid "{@code{prosody-configuration} parameter} file-object groups-file"
  33200. msgstr ""
  33201. #. type: deftypevr
  33202. #: guix-git/doc/guix.texi:22236
  33203. msgid "Path to a text file where the shared groups are defined. If this path is empty then @samp{mod_groups} does nothing. See @url{https://prosody.im/doc/modules/mod_groups}. Defaults to @samp{\"/var/lib/prosody/sharedgroups.txt\"}."
  33204. msgstr ""
  33205. #. type: deftypevr
  33206. #: guix-git/doc/guix.texi:22238
  33207. #, no-wrap
  33208. msgid "{@code{prosody-configuration} parameter} boolean allow-registration?"
  33209. msgstr ""
  33210. #. type: deftypevr
  33211. #: guix-git/doc/guix.texi:22242
  33212. msgid "Disable account creation by default, for security. See @url{https://prosody.im/doc/creating_accounts}. Defaults to @samp{#f}."
  33213. msgstr ""
  33214. #. type: deftypevr
  33215. #: guix-git/doc/guix.texi:22244
  33216. #, no-wrap
  33217. msgid "{@code{prosody-configuration} parameter} maybe-ssl-configuration ssl"
  33218. msgstr ""
  33219. #. type: deftypevr
  33220. #: guix-git/doc/guix.texi:22249
  33221. msgid "These are the SSL/TLS-related settings. Most of them are disabled so to use Prosody's defaults. If you do not completely understand these options, do not add them to your config, it is easy to lower the security of your server using them. See @url{https://prosody.im/doc/advanced_ssl_config}."
  33222. msgstr ""
  33223. #. type: deftypevr
  33224. #: guix-git/doc/guix.texi:22251
  33225. msgid "Available @code{ssl-configuration} fields are:"
  33226. msgstr ""
  33227. #. type: deftypevr
  33228. #: guix-git/doc/guix.texi:22252
  33229. #, no-wrap
  33230. msgid "{@code{ssl-configuration} parameter} maybe-string protocol"
  33231. msgstr ""
  33232. #. type: deftypevr
  33233. #: guix-git/doc/guix.texi:22254
  33234. msgid "This determines what handshake to use."
  33235. msgstr ""
  33236. #. type: deftypevr
  33237. #: guix-git/doc/guix.texi:22256
  33238. #, no-wrap
  33239. msgid "{@code{ssl-configuration} parameter} maybe-file-name key"
  33240. msgstr ""
  33241. #. type: deftypevr
  33242. #: guix-git/doc/guix.texi:22258
  33243. msgid "Path to your private key file."
  33244. msgstr ""
  33245. #. type: deftypevr
  33246. #: guix-git/doc/guix.texi:22260
  33247. #, no-wrap
  33248. msgid "{@code{ssl-configuration} parameter} maybe-file-name certificate"
  33249. msgstr ""
  33250. #. type: deftypevr
  33251. #: guix-git/doc/guix.texi:22262
  33252. msgid "Path to your certificate file."
  33253. msgstr ""
  33254. #. type: deftypevr
  33255. #: guix-git/doc/guix.texi:22264
  33256. #, no-wrap
  33257. msgid "{@code{ssl-configuration} parameter} file-object capath"
  33258. msgstr ""
  33259. #. type: deftypevr
  33260. #: guix-git/doc/guix.texi:22268
  33261. msgid "Path to directory containing root certificates that you wish Prosody to trust when verifying the certificates of remote servers. Defaults to @samp{\"/etc/ssl/certs\"}."
  33262. msgstr ""
  33263. #. type: deftypevr
  33264. #: guix-git/doc/guix.texi:22270
  33265. #, no-wrap
  33266. msgid "{@code{ssl-configuration} parameter} maybe-file-object cafile"
  33267. msgstr ""
  33268. #. type: deftypevr
  33269. #: guix-git/doc/guix.texi:22273
  33270. msgid "Path to a file containing root certificates that you wish Prosody to trust. Similar to @code{capath} but with all certificates concatenated together."
  33271. msgstr ""
  33272. #. type: deftypevr
  33273. #: guix-git/doc/guix.texi:22275
  33274. #, no-wrap
  33275. msgid "{@code{ssl-configuration} parameter} maybe-string-list verify"
  33276. msgstr ""
  33277. #. type: deftypevr
  33278. #: guix-git/doc/guix.texi:22278
  33279. msgid "A list of verification options (these mostly map to OpenSSL's @code{set_verify()} flags)."
  33280. msgstr ""
  33281. #. type: deftypevr
  33282. #: guix-git/doc/guix.texi:22280
  33283. #, no-wrap
  33284. msgid "{@code{ssl-configuration} parameter} maybe-string-list options"
  33285. msgstr ""
  33286. #. type: deftypevr
  33287. #: guix-git/doc/guix.texi:22284
  33288. msgid "A list of general options relating to SSL/TLS@. These map to OpenSSL's @code{set_options()}. For a full list of options available in LuaSec, see the LuaSec source."
  33289. msgstr ""
  33290. #. type: deftypevr
  33291. #: guix-git/doc/guix.texi:22286
  33292. #, no-wrap
  33293. msgid "{@code{ssl-configuration} parameter} maybe-non-negative-integer depth"
  33294. msgstr ""
  33295. #. type: deftypevr
  33296. #: guix-git/doc/guix.texi:22289
  33297. msgid "How long a chain of certificate authorities to check when looking for a trusted root certificate."
  33298. msgstr ""
  33299. #. type: deftypevr
  33300. #: guix-git/doc/guix.texi:22291
  33301. #, no-wrap
  33302. msgid "{@code{ssl-configuration} parameter} maybe-string ciphers"
  33303. msgstr ""
  33304. #. type: deftypevr
  33305. #: guix-git/doc/guix.texi:22294
  33306. msgid "An OpenSSL cipher string. This selects what ciphers Prosody will offer to clients, and in what order."
  33307. msgstr ""
  33308. #. type: deftypevr
  33309. #: guix-git/doc/guix.texi:22296
  33310. #, no-wrap
  33311. msgid "{@code{ssl-configuration} parameter} maybe-file-name dhparam"
  33312. msgstr ""
  33313. #. type: deftypevr
  33314. #: guix-git/doc/guix.texi:22300
  33315. msgid "A path to a file containing parameters for Diffie-Hellman key exchange. You can create such a file with: @code{openssl dhparam -out /etc/prosody/certs/dh-2048.pem 2048}"
  33316. msgstr ""
  33317. #. type: deftypevr
  33318. #: guix-git/doc/guix.texi:22302
  33319. #, no-wrap
  33320. msgid "{@code{ssl-configuration} parameter} maybe-string curve"
  33321. msgstr ""
  33322. #. type: deftypevr
  33323. #: guix-git/doc/guix.texi:22305
  33324. msgid "Curve for Elliptic curve Diffie-Hellman. Prosody's default is @samp{\"secp384r1\"}."
  33325. msgstr ""
  33326. #. type: deftypevr
  33327. #: guix-git/doc/guix.texi:22307
  33328. #, no-wrap
  33329. msgid "{@code{ssl-configuration} parameter} maybe-string-list verifyext"
  33330. msgstr ""
  33331. #. type: deftypevr
  33332. #: guix-git/doc/guix.texi:22309
  33333. msgid "A list of ``extra'' verification options."
  33334. msgstr ""
  33335. #. type: deftypevr
  33336. #: guix-git/doc/guix.texi:22311
  33337. #, no-wrap
  33338. msgid "{@code{ssl-configuration} parameter} maybe-string password"
  33339. msgstr ""
  33340. #. type: deftypevr
  33341. #: guix-git/doc/guix.texi:22313
  33342. msgid "Password for encrypted private keys."
  33343. msgstr ""
  33344. #. type: deftypevr
  33345. #: guix-git/doc/guix.texi:22317
  33346. #, no-wrap
  33347. msgid "{@code{prosody-configuration} parameter} boolean c2s-require-encryption?"
  33348. msgstr ""
  33349. #. type: deftypevr
  33350. #: guix-git/doc/guix.texi:22321
  33351. msgid "Whether to force all client-to-server connections to be encrypted or not. See @url{https://prosody.im/doc/modules/mod_tls}. Defaults to @samp{#f}."
  33352. msgstr ""
  33353. #. type: deftypevr
  33354. #: guix-git/doc/guix.texi:22323
  33355. #, no-wrap
  33356. msgid "{@code{prosody-configuration} parameter} string-list disable-sasl-mechanisms"
  33357. msgstr ""
  33358. #. type: deftypevr
  33359. #: guix-git/doc/guix.texi:22327
  33360. msgid "Set of mechanisms that will never be offered. See @url{https://prosody.im/doc/modules/mod_saslauth}. Defaults to @samp{(\"DIGEST-MD5\")}."
  33361. msgstr ""
  33362. #. type: deftypevr
  33363. #: guix-git/doc/guix.texi:22329
  33364. #, no-wrap
  33365. msgid "{@code{prosody-configuration} parameter} boolean s2s-require-encryption?"
  33366. msgstr ""
  33367. #. type: deftypevr
  33368. #: guix-git/doc/guix.texi:22333
  33369. msgid "Whether to force all server-to-server connections to be encrypted or not. See @url{https://prosody.im/doc/modules/mod_tls}. Defaults to @samp{#f}."
  33370. msgstr ""
  33371. #. type: deftypevr
  33372. #: guix-git/doc/guix.texi:22335
  33373. #, no-wrap
  33374. msgid "{@code{prosody-configuration} parameter} boolean s2s-secure-auth?"
  33375. msgstr ""
  33376. #. type: deftypevr
  33377. #: guix-git/doc/guix.texi:22341
  33378. msgid "Whether to require encryption and certificate authentication. This provides ideal security, but requires servers you communicate with to support encryption AND present valid, trusted certificates. See @url{https://prosody.im/doc/s2s#security}. Defaults to @samp{#f}."
  33379. msgstr ""
  33380. #. type: deftypevr
  33381. #: guix-git/doc/guix.texi:22343
  33382. #, no-wrap
  33383. msgid "{@code{prosody-configuration} parameter} string-list s2s-insecure-domains"
  33384. msgstr ""
  33385. #. type: deftypevr
  33386. #: guix-git/doc/guix.texi:22349
  33387. msgid "Many servers don't support encryption or have invalid or self-signed certificates. You can list domains here that will not be required to authenticate using certificates. They will be authenticated using DNS@. See @url{https://prosody.im/doc/s2s#security}. Defaults to @samp{()}."
  33388. msgstr ""
  33389. #. type: deftypevr
  33390. #: guix-git/doc/guix.texi:22351
  33391. #, no-wrap
  33392. msgid "{@code{prosody-configuration} parameter} string-list s2s-secure-domains"
  33393. msgstr ""
  33394. #. type: deftypevr
  33395. #: guix-git/doc/guix.texi:22356
  33396. msgid "Even if you leave @code{s2s-secure-auth?} disabled, you can still require valid certificates for some domains by specifying a list here. See @url{https://prosody.im/doc/s2s#security}. Defaults to @samp{()}."
  33397. msgstr ""
  33398. #. type: deftypevr
  33399. #: guix-git/doc/guix.texi:22358
  33400. #, no-wrap
  33401. msgid "{@code{prosody-configuration} parameter} string authentication"
  33402. msgstr ""
  33403. #. type: deftypevr
  33404. #: guix-git/doc/guix.texi:22366
  33405. msgid "Select the authentication backend to use. The default provider stores passwords in plaintext and uses Prosody's configured data storage to store the authentication data. If you do not trust your server please see @url{https://prosody.im/doc/modules/mod_auth_internal_hashed} for information about using the hashed backend. See also @url{https://prosody.im/doc/authentication} Defaults to @samp{\"internal_plain\"}."
  33406. msgstr ""
  33407. #. type: deftypevr
  33408. #: guix-git/doc/guix.texi:22368
  33409. #, no-wrap
  33410. msgid "{@code{prosody-configuration} parameter} maybe-string log"
  33411. msgstr ""
  33412. #. type: deftypevr
  33413. #: guix-git/doc/guix.texi:22372
  33414. msgid "Set logging options. Advanced logging configuration is not yet supported by the Prosody service. See @url{https://prosody.im/doc/logging}. Defaults to @samp{\"*syslog\"}."
  33415. msgstr ""
  33416. #. type: deftypevr
  33417. #: guix-git/doc/guix.texi:22374
  33418. #, no-wrap
  33419. msgid "{@code{prosody-configuration} parameter} file-name pidfile"
  33420. msgstr ""
  33421. #. type: deftypevr
  33422. #: guix-git/doc/guix.texi:22377
  33423. msgid "File to write pid in. See @url{https://prosody.im/doc/modules/mod_posix}. Defaults to @samp{\"/var/run/prosody/prosody.pid\"}."
  33424. msgstr ""
  33425. #. type: deftypevr
  33426. #: guix-git/doc/guix.texi:22379
  33427. #, no-wrap
  33428. msgid "{@code{prosody-configuration} parameter} maybe-non-negative-integer http-max-content-size"
  33429. msgstr ""
  33430. #. type: deftypevr
  33431. #: guix-git/doc/guix.texi:22381
  33432. msgid "Maximum allowed size of the HTTP body (in bytes)."
  33433. msgstr ""
  33434. #. type: deftypevr
  33435. #: guix-git/doc/guix.texi:22383
  33436. #, no-wrap
  33437. msgid "{@code{prosody-configuration} parameter} maybe-string http-external-url"
  33438. msgstr ""
  33439. #. type: deftypevr
  33440. #: guix-git/doc/guix.texi:22388
  33441. msgid "Some modules expose their own URL in various ways. This URL is built from the protocol, host and port used. If Prosody sits behind a proxy, the public URL will be @code{http-external-url} instead. See @url{https://prosody.im/doc/http#external_url}."
  33442. msgstr ""
  33443. #. type: deftypevr
  33444. #: guix-git/doc/guix.texi:22390
  33445. #, no-wrap
  33446. msgid "{@code{prosody-configuration} parameter} virtualhost-configuration-list virtualhosts"
  33447. msgstr ""
  33448. #. type: deftypevr
  33449. #: guix-git/doc/guix.texi:22395
  33450. msgid "A host in Prosody is a domain on which user accounts can be created. For example if you want your users to have addresses like @samp{\"john.smith@@example.com\"} then you need to add a host @samp{\"example.com\"}. All options in this list will apply only to this host."
  33451. msgstr ""
  33452. #. type: deftypevr
  33453. #: guix-git/doc/guix.texi:22401
  33454. msgid "Note: the name @emph{virtual} host is used in configuration to avoid confusion with the actual physical host that Prosody is installed on. A single Prosody instance can serve many domains, each one defined as a VirtualHost entry in Prosody's configuration. Conversely a server that hosts a single domain would have just one VirtualHost entry."
  33455. msgstr ""
  33456. #. type: deftypevr
  33457. #: guix-git/doc/guix.texi:22403
  33458. msgid "See @url{https://prosody.im/doc/configure#virtual_host_settings}."
  33459. msgstr ""
  33460. #. type: deftypevr
  33461. #: guix-git/doc/guix.texi:22405
  33462. msgid "Available @code{virtualhost-configuration} fields are:"
  33463. msgstr ""
  33464. #. type: deftypevr
  33465. #: guix-git/doc/guix.texi:22407 guix-git/doc/guix.texi:22429
  33466. #: guix-git/doc/guix.texi:22482
  33467. msgid "all these @code{prosody-configuration} fields: @code{admins}, @code{use-libevent?}, @code{modules-enabled}, @code{modules-disabled}, @code{groups-file}, @code{allow-registration?}, @code{ssl}, @code{c2s-require-encryption?}, @code{disable-sasl-mechanisms}, @code{s2s-require-encryption?}, @code{s2s-secure-auth?}, @code{s2s-insecure-domains}, @code{s2s-secure-domains}, @code{authentication}, @code{log}, @code{http-max-content-size}, @code{http-external-url}, @code{raw-content}, plus:"
  33468. msgstr ""
  33469. #. type: deftypevr
  33470. #: guix-git/doc/guix.texi:22407
  33471. #, no-wrap
  33472. msgid "{@code{virtualhost-configuration} parameter} string domain"
  33473. msgstr ""
  33474. #. type: deftypevr
  33475. #: guix-git/doc/guix.texi:22409
  33476. msgid "Domain you wish Prosody to serve."
  33477. msgstr ""
  33478. #. type: deftypevr
  33479. #: guix-git/doc/guix.texi:22413
  33480. #, no-wrap
  33481. msgid "{@code{prosody-configuration} parameter} int-component-configuration-list int-components"
  33482. msgstr ""
  33483. #. type: deftypevr
  33484. #: guix-git/doc/guix.texi:22418
  33485. msgid "Components are extra services on a server which are available to clients, usually on a subdomain of the main server (such as @samp{\"mycomponent.example.com\"}). Example components might be chatroom servers, user directories, or gateways to other protocols."
  33486. msgstr ""
  33487. #. type: deftypevr
  33488. #: guix-git/doc/guix.texi:22422
  33489. msgid "Internal components are implemented with Prosody-specific plugins. To add an internal component, you simply fill the hostname field, and the plugin you wish to use for the component."
  33490. msgstr ""
  33491. #. type: deftypevr
  33492. #: guix-git/doc/guix.texi:22425
  33493. msgid "See @url{https://prosody.im/doc/components}. Defaults to @samp{()}."
  33494. msgstr ""
  33495. #. type: deftypevr
  33496. #: guix-git/doc/guix.texi:22427
  33497. msgid "Available @code{int-component-configuration} fields are:"
  33498. msgstr ""
  33499. #. type: deftypevr
  33500. #: guix-git/doc/guix.texi:22429
  33501. #, no-wrap
  33502. msgid "{@code{int-component-configuration} parameter} string hostname"
  33503. msgstr ""
  33504. #. type: deftypevr
  33505. #: guix-git/doc/guix.texi:22431 guix-git/doc/guix.texi:22488
  33506. msgid "Hostname of the component."
  33507. msgstr ""
  33508. #. type: deftypevr
  33509. #: guix-git/doc/guix.texi:22433
  33510. #, no-wrap
  33511. msgid "{@code{int-component-configuration} parameter} string plugin"
  33512. msgstr ""
  33513. #. type: deftypevr
  33514. #: guix-git/doc/guix.texi:22435
  33515. msgid "Plugin you wish to use for the component."
  33516. msgstr ""
  33517. #. type: deftypevr
  33518. #: guix-git/doc/guix.texi:22437
  33519. #, no-wrap
  33520. msgid "{@code{int-component-configuration} parameter} maybe-mod-muc-configuration mod-muc"
  33521. msgstr ""
  33522. #. type: deftypevr
  33523. #: guix-git/doc/guix.texi:22440
  33524. msgid "Multi-user chat (MUC) is Prosody's module for allowing you to create hosted chatrooms/conferences for XMPP users."
  33525. msgstr ""
  33526. #. type: deftypevr
  33527. #: guix-git/doc/guix.texi:22444
  33528. msgid "General information on setting up and using multi-user chatrooms can be found in the ``Chatrooms'' documentation (@url{https://prosody.im/doc/chatrooms}), which you should read if you are new to XMPP chatrooms."
  33529. msgstr ""
  33530. #. type: deftypevr
  33531. #: guix-git/doc/guix.texi:22446
  33532. msgid "See also @url{https://prosody.im/doc/modules/mod_muc}."
  33533. msgstr ""
  33534. #. type: deftypevr
  33535. #: guix-git/doc/guix.texi:22448
  33536. msgid "Available @code{mod-muc-configuration} fields are:"
  33537. msgstr ""
  33538. #. type: deftypevr
  33539. #: guix-git/doc/guix.texi:22449
  33540. #, no-wrap
  33541. msgid "{@code{mod-muc-configuration} parameter} string name"
  33542. msgstr ""
  33543. #. type: deftypevr
  33544. #: guix-git/doc/guix.texi:22452
  33545. msgid "The name to return in service discovery responses. Defaults to @samp{\"Prosody Chatrooms\"}."
  33546. msgstr ""
  33547. #. type: deftypevr
  33548. #: guix-git/doc/guix.texi:22454
  33549. #, no-wrap
  33550. msgid "{@code{mod-muc-configuration} parameter} string-or-boolean restrict-room-creation"
  33551. msgstr ""
  33552. #. type: deftypevr
  33553. #: guix-git/doc/guix.texi:22461
  33554. msgid "If @samp{#t}, this will only allow admins to create new chatrooms. Otherwise anyone can create a room. The value @samp{\"local\"} restricts room creation to users on the service's parent domain. E.g.@: @samp{user@@example.com} can create rooms on @samp{rooms.example.com}. The value @samp{\"admin\"} restricts to service administrators only. Defaults to @samp{#f}."
  33555. msgstr ""
  33556. #. type: deftypevr
  33557. #: guix-git/doc/guix.texi:22463
  33558. #, no-wrap
  33559. msgid "{@code{mod-muc-configuration} parameter} non-negative-integer max-history-messages"
  33560. msgstr ""
  33561. #. type: deftypevr
  33562. #: guix-git/doc/guix.texi:22467
  33563. msgid "Maximum number of history messages that will be sent to the member that has just joined the room. Defaults to @samp{20}."
  33564. msgstr ""
  33565. #. type: deftypevr
  33566. #: guix-git/doc/guix.texi:22473
  33567. #, no-wrap
  33568. msgid "{@code{prosody-configuration} parameter} ext-component-configuration-list ext-components"
  33569. msgstr ""
  33570. #. type: deftypevr
  33571. #: guix-git/doc/guix.texi:22478
  33572. msgid "External components use XEP-0114, which most standalone components support. To add an external component, you simply fill the hostname field. See @url{https://prosody.im/doc/components}. Defaults to @samp{()}."
  33573. msgstr ""
  33574. #. type: deftypevr
  33575. #: guix-git/doc/guix.texi:22480
  33576. msgid "Available @code{ext-component-configuration} fields are:"
  33577. msgstr ""
  33578. #. type: deftypevr
  33579. #: guix-git/doc/guix.texi:22482
  33580. #, no-wrap
  33581. msgid "{@code{ext-component-configuration} parameter} string component-secret"
  33582. msgstr ""
  33583. #. type: deftypevr
  33584. #: guix-git/doc/guix.texi:22484
  33585. msgid "Password which the component will use to log in."
  33586. msgstr ""
  33587. #. type: deftypevr
  33588. #: guix-git/doc/guix.texi:22486
  33589. #, no-wrap
  33590. msgid "{@code{ext-component-configuration} parameter} string hostname"
  33591. msgstr ""
  33592. #. type: deftypevr
  33593. #: guix-git/doc/guix.texi:22492
  33594. #, no-wrap
  33595. msgid "{@code{prosody-configuration} parameter} non-negative-integer-list component-ports"
  33596. msgstr ""
  33597. #. type: deftypevr
  33598. #: guix-git/doc/guix.texi:22495
  33599. msgid "Port(s) Prosody listens on for component connections. Defaults to @samp{(5347)}."
  33600. msgstr ""
  33601. #. type: deftypevr
  33602. #: guix-git/doc/guix.texi:22497
  33603. #, no-wrap
  33604. msgid "{@code{prosody-configuration} parameter} string component-interface"
  33605. msgstr ""
  33606. #. type: deftypevr
  33607. #: guix-git/doc/guix.texi:22500
  33608. msgid "Interface Prosody listens on for component connections. Defaults to @samp{\"127.0.0.1\"}."
  33609. msgstr ""
  33610. #. type: deftypevr
  33611. #: guix-git/doc/guix.texi:22502
  33612. #, no-wrap
  33613. msgid "{@code{prosody-configuration} parameter} maybe-raw-content raw-content"
  33614. msgstr ""
  33615. #. type: deftypevr
  33616. #: guix-git/doc/guix.texi:22504
  33617. msgid "Raw content that will be added to the configuration file."
  33618. msgstr ""
  33619. #. type: Plain text
  33620. #: guix-git/doc/guix.texi:22512
  33621. msgid "It could be that you just want to get a @code{prosody.cfg.lua} up and running. In that case, you can pass an @code{opaque-prosody-configuration} record as the value of @code{prosody-service-type}. As its name indicates, an opaque configuration does not have easy reflective capabilities. Available @code{opaque-prosody-configuration} fields are:"
  33622. msgstr ""
  33623. #. type: deftypevr
  33624. #: guix-git/doc/guix.texi:22513
  33625. #, no-wrap
  33626. msgid "{@code{opaque-prosody-configuration} parameter} package prosody"
  33627. msgstr ""
  33628. #. type: deftypevr
  33629. #: guix-git/doc/guix.texi:22515
  33630. msgid "The prosody package."
  33631. msgstr ""
  33632. #. type: deftypevr
  33633. #: guix-git/doc/guix.texi:22517
  33634. #, no-wrap
  33635. msgid "{@code{opaque-prosody-configuration} parameter} string prosody.cfg.lua"
  33636. msgstr ""
  33637. #. type: deftypevr
  33638. #: guix-git/doc/guix.texi:22519
  33639. msgid "The contents of the @code{prosody.cfg.lua} to use."
  33640. msgstr ""
  33641. #. type: Plain text
  33642. #: guix-git/doc/guix.texi:22523
  33643. msgid "For example, if your @code{prosody.cfg.lua} is just the empty string, you could instantiate a prosody service like this:"
  33644. msgstr ""
  33645. #. type: lisp
  33646. #: guix-git/doc/guix.texi:22528
  33647. #, no-wrap
  33648. msgid ""
  33649. "(service prosody-service-type\n"
  33650. " (opaque-prosody-configuration\n"
  33651. " (prosody.cfg.lua \"\")))\n"
  33652. msgstr ""
  33653. #. type: subsubheading
  33654. #: guix-git/doc/guix.texi:22532
  33655. #, no-wrap
  33656. msgid "BitlBee Service"
  33657. msgstr ""
  33658. #. type: cindex
  33659. #: guix-git/doc/guix.texi:22534 guix-git/doc/guix.texi:22578
  33660. #, no-wrap
  33661. msgid "IRC (Internet Relay Chat)"
  33662. msgstr ""
  33663. #. type: cindex
  33664. #: guix-git/doc/guix.texi:22535
  33665. #, no-wrap
  33666. msgid "IRC gateway"
  33667. msgstr ""
  33668. #. type: Plain text
  33669. #: guix-git/doc/guix.texi:22538
  33670. msgid "@url{https://bitlbee.org,BitlBee} is a gateway that provides an IRC interface to a variety of messaging protocols such as XMPP."
  33671. msgstr ""
  33672. #. type: defvr
  33673. #: guix-git/doc/guix.texi:22539
  33674. #, no-wrap
  33675. msgid "{Scheme Variable} bitlbee-service-type"
  33676. msgstr ""
  33677. #. type: defvr
  33678. #: guix-git/doc/guix.texi:22543
  33679. msgid "This is the service type for the @url{https://bitlbee.org,BitlBee} IRC gateway daemon. Its value is a @code{bitlbee-configuration} (see below)."
  33680. msgstr ""
  33681. #. type: defvr
  33682. #: guix-git/doc/guix.texi:22546
  33683. msgid "To have BitlBee listen on port 6667 on localhost, add this line to your services:"
  33684. msgstr ""
  33685. #. type: lisp
  33686. #: guix-git/doc/guix.texi:22549
  33687. #, no-wrap
  33688. msgid "(service bitlbee-service-type)\n"
  33689. msgstr ""
  33690. #. type: deftp
  33691. #: guix-git/doc/guix.texi:22552
  33692. #, no-wrap
  33693. msgid "{Data Type} bitlbee-configuration"
  33694. msgstr ""
  33695. #. type: deftp
  33696. #: guix-git/doc/guix.texi:22554
  33697. msgid "This is the configuration for BitlBee, with the following fields:"
  33698. msgstr ""
  33699. #. type: item
  33700. #: guix-git/doc/guix.texi:22556
  33701. #, no-wrap
  33702. msgid "@code{interface} (default: @code{\"127.0.0.1\"})"
  33703. msgstr ""
  33704. #. type: itemx
  33705. #: guix-git/doc/guix.texi:22557
  33706. #, no-wrap
  33707. msgid "@code{port} (default: @code{6667})"
  33708. msgstr ""
  33709. #. type: table
  33710. #: guix-git/doc/guix.texi:22560
  33711. msgid "Listen on the network interface corresponding to the IP address specified in @var{interface}, on @var{port}."
  33712. msgstr ""
  33713. #. type: table
  33714. #: guix-git/doc/guix.texi:22564
  33715. msgid "When @var{interface} is @code{127.0.0.1}, only local clients can connect; when it is @code{0.0.0.0}, connections can come from any networking interface."
  33716. msgstr ""
  33717. #. type: item
  33718. #: guix-git/doc/guix.texi:22565
  33719. #, no-wrap
  33720. msgid "@code{bitlbee} (default: @code{bitlbee})"
  33721. msgstr ""
  33722. #. type: table
  33723. #: guix-git/doc/guix.texi:22567
  33724. msgid "The BitlBee package to use."
  33725. msgstr ""
  33726. #. type: item
  33727. #: guix-git/doc/guix.texi:22568
  33728. #, no-wrap
  33729. msgid "@code{plugins} (default: @code{'()})"
  33730. msgstr ""
  33731. #. type: table
  33732. #: guix-git/doc/guix.texi:22570
  33733. msgid "List of plugin packages to use---e.g., @code{bitlbee-discord}."
  33734. msgstr ""
  33735. #. type: table
  33736. #: guix-git/doc/guix.texi:22573
  33737. msgid "Configuration snippet added as-is to the BitlBee configuration file."
  33738. msgstr ""
  33739. #. type: subsubheading
  33740. #: guix-git/doc/guix.texi:22576
  33741. #, no-wrap
  33742. msgid "Quassel Service"
  33743. msgstr ""
  33744. #. type: Plain text
  33745. #: guix-git/doc/guix.texi:22582
  33746. msgid "@url{https://quassel-irc.org/,Quassel} is a distributed IRC client, meaning that one or more clients can attach to and detach from the central core."
  33747. msgstr ""
  33748. #. type: defvr
  33749. #: guix-git/doc/guix.texi:22583
  33750. #, no-wrap
  33751. msgid "{Scheme Variable} quassel-service-type"
  33752. msgstr ""
  33753. #. type: defvr
  33754. #: guix-git/doc/guix.texi:22587
  33755. msgid "This is the service type for the @url{https://quassel-irc.org/,Quassel} IRC backend daemon. Its value is a @code{quassel-configuration} (see below)."
  33756. msgstr ""
  33757. #. type: deftp
  33758. #: guix-git/doc/guix.texi:22589
  33759. #, no-wrap
  33760. msgid "{Data Type} quassel-configuration"
  33761. msgstr ""
  33762. #. type: deftp
  33763. #: guix-git/doc/guix.texi:22591
  33764. msgid "This is the configuration for Quassel, with the following fields:"
  33765. msgstr ""
  33766. #. type: item
  33767. #: guix-git/doc/guix.texi:22593
  33768. #, no-wrap
  33769. msgid "@code{quassel} (default: @code{quassel})"
  33770. msgstr ""
  33771. #. type: table
  33772. #: guix-git/doc/guix.texi:22595
  33773. msgid "The Quassel package to use."
  33774. msgstr ""
  33775. #. type: item
  33776. #: guix-git/doc/guix.texi:22596
  33777. #, no-wrap
  33778. msgid "@code{interface} (default: @code{\"::,0.0.0.0\"})"
  33779. msgstr ""
  33780. #. type: item
  33781. #: guix-git/doc/guix.texi:22597
  33782. #, no-wrap
  33783. msgid "@code{port} (default: @code{4242})"
  33784. msgstr ""
  33785. #. type: table
  33786. #: guix-git/doc/guix.texi:22601
  33787. msgid "Listen on the network interface(s) corresponding to the IPv4 or IPv6 interfaces specified in the comma delimited @var{interface}, on @var{port}."
  33788. msgstr ""
  33789. #. type: item
  33790. #: guix-git/doc/guix.texi:22602
  33791. #, no-wrap
  33792. msgid "@code{loglevel} (default: @code{\"Info\"})"
  33793. msgstr ""
  33794. #. type: table
  33795. #: guix-git/doc/guix.texi:22605
  33796. msgid "The level of logging desired. Accepted values are Debug, Info, Warning and Error."
  33797. msgstr ""
  33798. #. type: cindex
  33799. #: guix-git/doc/guix.texi:22611
  33800. #, no-wrap
  33801. msgid "telephony, services"
  33802. msgstr ""
  33803. #. type: Plain text
  33804. #: guix-git/doc/guix.texi:22615
  33805. msgid "The @code{(gnu services telephony)} module contains Guix service definitions for telephony services. Currently it provides the following services:"
  33806. msgstr ""
  33807. #. type: subsubheading
  33808. #: guix-git/doc/guix.texi:22616
  33809. #, no-wrap
  33810. msgid "Jami"
  33811. msgstr ""
  33812. #. type: cindex
  33813. #: guix-git/doc/guix.texi:22618
  33814. #, no-wrap
  33815. msgid "jami, service"
  33816. msgstr ""
  33817. #. type: Plain text
  33818. #: guix-git/doc/guix.texi:22624
  33819. msgid "This section describes how to configure a Jami server that can be used to host video (or audio) conferences, among other uses. The following example demonstrates how to specify Jami account archives (backups) to be provisioned automatically:"
  33820. msgstr ""
  33821. #. type: lisp
  33822. #: guix-git/doc/guix.texi:22633
  33823. #, no-wrap
  33824. msgid ""
  33825. "(service jami-service-type\n"
  33826. " (jami-configuration\n"
  33827. " (accounts\n"
  33828. " (list (jami-account\n"
  33829. " (archive \"/etc/jami/unencrypted-account-1.gz\"))\n"
  33830. " (jami-account\n"
  33831. " (archive \"/etc/jami/unencrypted-account-2.gz\"))))))\n"
  33832. msgstr ""
  33833. #. type: Plain text
  33834. #: guix-git/doc/guix.texi:22638
  33835. msgid "When the accounts field is specified, the Jami account files of the service found under @file{/var/lib/jami} are recreated every time the service starts."
  33836. msgstr ""
  33837. #. type: Plain text
  33838. #: guix-git/doc/guix.texi:22643
  33839. msgid "Jami accounts and their corresponding backup archives can be generated using either the @code{jami-qt} or @code{jami-gnome} Jami clients. The accounts should not be password-protected, but it is wise to ensure their files are only readable by @samp{root}."
  33840. msgstr ""
  33841. #. type: Plain text
  33842. #: guix-git/doc/guix.texi:22646
  33843. msgid "The next example shows how to declare that only some contacts should be allowed to communicate with a given account:"
  33844. msgstr ""
  33845. #. type: lisp
  33846. #: guix-git/doc/guix.texi:22658
  33847. #, no-wrap
  33848. msgid ""
  33849. "(service jami-service-type\n"
  33850. " (jami-configuration\n"
  33851. " (accounts\n"
  33852. " (list (jami-account\n"
  33853. " (archive \"/etc/jami/unencrypted-account-1.gz\")\n"
  33854. " (peer-discovery? #t)\n"
  33855. " (rendezvous-point? #t)\n"
  33856. " (allowed-contacts\n"
  33857. " '(\"1dbcb0f5f37324228235564b79f2b9737e9a008f\"\n"
  33858. " \"2dbcb0f5f37324228235564b79f2b9737e9a008f\")))))))\n"
  33859. msgstr ""
  33860. #. type: Plain text
  33861. #: guix-git/doc/guix.texi:22664
  33862. msgid "In this mode, only the declared @code{allowed-contacts} can initiate communication with the Jami account. This can be used, for example, with rendezvous point accounts to create a private video conferencing space."
  33863. msgstr ""
  33864. #. type: Plain text
  33865. #: guix-git/doc/guix.texi:22667
  33866. msgid "To put the system administrator in full control of the conferences hosted on their system, the Jami service supports the following actions:"
  33867. msgstr ""
  33868. #. type: example
  33869. #: guix-git/doc/guix.texi:22679
  33870. #, no-wrap
  33871. msgid ""
  33872. "# herd doc jami list-actions\n"
  33873. "(list-accounts\n"
  33874. " list-account-details\n"
  33875. " list-banned-contacts\n"
  33876. " list-contacts\n"
  33877. " list-moderators\n"
  33878. " add-moderator\n"
  33879. " ban-contact\n"
  33880. " enable-account\n"
  33881. " disable-account)\n"
  33882. msgstr ""
  33883. #. type: Plain text
  33884. #: guix-git/doc/guix.texi:22686
  33885. msgid "The above actions aim to provide the most valuable actions for moderation purposes, not to cover the whole Jami API. Users wanting to interact with the Jami daemon from Guile may be interested in experimenting with the @code{(gnu build jami-service)} module, which powers the above Shepherd actions."
  33886. msgstr ""
  33887. #. type: Plain text
  33888. #: guix-git/doc/guix.texi:22692
  33889. msgid "The @code{add-moderator} and @code{ban-contact} actions accept a contact @emph{fingerprint} (40 characters long hash) as first argument and an account fingerprint or username as second argument:"
  33890. msgstr ""
  33891. #. type: example
  33892. #: guix-git/doc/guix.texi:22696
  33893. #, no-wrap
  33894. msgid ""
  33895. "# herd add-moderator jami 1dbcb0f5f37324228235564b79f2b9737e9a008f \\\n"
  33896. " f3345f2775ddfe07a4b0d95daea111d15fbc1199\n"
  33897. "\n"
  33898. msgstr ""
  33899. #. type: example
  33900. #: guix-git/doc/guix.texi:22700
  33901. #, no-wrap
  33902. msgid ""
  33903. "# herd list-moderators jami\n"
  33904. "Moderators for account f3345f2775ddfe07a4b0d95daea111d15fbc1199:\n"
  33905. " - 1dbcb0f5f37324228235564b79f2b9737e9a008f\n"
  33906. "\n"
  33907. msgstr ""
  33908. #. type: Plain text
  33909. #: guix-git/doc/guix.texi:22705
  33910. msgid "In the case of @code{ban-contact}, the second username argument is optional; when omitted, the account is banned from all Jami accounts:"
  33911. msgstr ""
  33912. #. type: example
  33913. #: guix-git/doc/guix.texi:22708
  33914. #, no-wrap
  33915. msgid ""
  33916. "# herd ban-contact jami 1dbcb0f5f37324228235564b79f2b9737e9a008f\n"
  33917. "\n"
  33918. msgstr ""
  33919. #. type: example
  33920. #: guix-git/doc/guix.texi:22712
  33921. #, no-wrap
  33922. msgid ""
  33923. "# herd list-banned-contacts jami\n"
  33924. "Banned contacts for account f3345f2775ddfe07a4b0d95daea111d15fbc1199:\n"
  33925. " - 1dbcb0f5f37324228235564b79f2b9737e9a008f\n"
  33926. "\n"
  33927. msgstr ""
  33928. #. type: Plain text
  33929. #: guix-git/doc/guix.texi:22716
  33930. msgid "Banned contacts are also stripped from their moderation privileges."
  33931. msgstr ""
  33932. #. type: Plain text
  33933. #: guix-git/doc/guix.texi:22721
  33934. msgid "The @code{disable-account} action allows to completely disconnect an account from the network, making it unreachable, while @code{enable-account} does the inverse. They accept a single account username or fingerprint as first argument:"
  33935. msgstr ""
  33936. #. type: example
  33937. #: guix-git/doc/guix.texi:22724
  33938. #, no-wrap
  33939. msgid ""
  33940. "# herd disable-account jami f3345f2775ddfe07a4b0d95daea111d15fbc1199\n"
  33941. "\n"
  33942. msgstr ""
  33943. #. type: example
  33944. #: guix-git/doc/guix.texi:22728
  33945. #, no-wrap
  33946. msgid ""
  33947. "# herd list-accounts jami\n"
  33948. "The following Jami accounts are available:\n"
  33949. " - f3345f2775ddfe07a4b0d95daea111d15fbc1199 (dummy) [disabled]\n"
  33950. "\n"
  33951. msgstr ""
  33952. #. type: Plain text
  33953. #: guix-git/doc/guix.texi:22739
  33954. msgid "The @code{list-account-details} action prints the detailed parameters of each accounts in the Recutils format, which means the @command{recsel} command can be used to select accounts of interest (@pxref{Selection Expressions,,,recutils, GNU recutils manual}). Note that period characters (@samp{.}) found in the account parameter keys are mapped to underscores (@samp{_}) in the output, to meet the requirements of the Recutils format. The following example shows how to print the account fingerprints for all accounts operating in the rendezvous point mode:"
  33955. msgstr ""
  33956. #. type: example
  33957. #: guix-git/doc/guix.texi:22744
  33958. #, no-wrap
  33959. msgid ""
  33960. "# herd list-account-details jami | \\\n"
  33961. " recsel -p Account.username -e 'Account.rendezVous ~ \"true\"'\n"
  33962. "Account_username: f3345f2775ddfe07a4b0d95daea111d15fbc1199\n"
  33963. msgstr ""
  33964. #. type: Plain text
  33965. #: guix-git/doc/guix.texi:22747
  33966. msgid "The remaining actions should be self-explanatory."
  33967. msgstr ""
  33968. #. type: Plain text
  33969. #: guix-git/doc/guix.texi:22749
  33970. msgid "The complete set of available configuration options is detailed below."
  33971. msgstr ""
  33972. #. type: deftp
  33973. #: guix-git/doc/guix.texi:22753
  33974. #, no-wrap
  33975. msgid "{Data Type} jami-configuration"
  33976. msgstr ""
  33977. #. type: deftp
  33978. #: guix-git/doc/guix.texi:22755
  33979. msgid "Available @code{jami-configuration} fields are:"
  33980. msgstr ""
  33981. #. type: item
  33982. #: guix-git/doc/guix.texi:22757
  33983. #, no-wrap
  33984. msgid "@code{jamid} (default: @code{libring}) (type: package)"
  33985. msgstr ""
  33986. #. type: table
  33987. #: guix-git/doc/guix.texi:22759
  33988. msgid "The Jami daemon package to use."
  33989. msgstr ""
  33990. #. type: item
  33991. #: guix-git/doc/guix.texi:22760
  33992. #, no-wrap
  33993. msgid "@code{dbus} (default: @code{dbus}) (type: package)"
  33994. msgstr ""
  33995. #. type: table
  33996. #: guix-git/doc/guix.texi:22762
  33997. msgid "The D-Bus package to use to start the required D-Bus session."
  33998. msgstr ""
  33999. #. type: item
  34000. #: guix-git/doc/guix.texi:22763
  34001. #, no-wrap
  34002. msgid "@code{nss-certs} (default: @code{nss-certs}) (type: package)"
  34003. msgstr ""
  34004. #. type: table
  34005. #: guix-git/doc/guix.texi:22765
  34006. msgid "The nss-certs package to use to provide TLS certificates."
  34007. msgstr ""
  34008. #. type: item
  34009. #: guix-git/doc/guix.texi:22766
  34010. #, no-wrap
  34011. msgid "@code{enable-logging?} (default: @code{#t}) (type: boolean)"
  34012. msgstr ""
  34013. #. type: table
  34014. #: guix-git/doc/guix.texi:22768
  34015. msgid "Whether to enable logging to syslog."
  34016. msgstr ""
  34017. #. type: item
  34018. #: guix-git/doc/guix.texi:22769
  34019. #, no-wrap
  34020. msgid "@code{debug?} (default: @code{#f}) (type: boolean)"
  34021. msgstr ""
  34022. #. type: table
  34023. #: guix-git/doc/guix.texi:22771
  34024. msgid "Whether to enable debug level messages."
  34025. msgstr ""
  34026. #. type: item
  34027. #: guix-git/doc/guix.texi:22772
  34028. #, no-wrap
  34029. msgid "@code{auto-answer?} (default: @code{#f}) (type: boolean)"
  34030. msgstr ""
  34031. #. type: table
  34032. #: guix-git/doc/guix.texi:22774
  34033. msgid "Whether to force automatic answer to incoming calls."
  34034. msgstr ""
  34035. #. type: item
  34036. #: guix-git/doc/guix.texi:22775
  34037. #, no-wrap
  34038. msgid "@code{accounts} (default: @code{disabled}) (type: maybe-jami-account-list)"
  34039. msgstr ""
  34040. #. type: table
  34041. #: guix-git/doc/guix.texi:22780
  34042. msgid "A list of Jami accounts to be (re-)provisioned every time the Jami daemon service starts. When providing this field, the account directories under @file{/var/lib/jami/} are recreated every time the service starts, ensuring a consistent state."
  34043. msgstr ""
  34044. #. type: deftp
  34045. #: guix-git/doc/guix.texi:22786
  34046. #, no-wrap
  34047. msgid "{Data Type} jami-account"
  34048. msgstr ""
  34049. #. type: deftp
  34050. #: guix-git/doc/guix.texi:22788
  34051. msgid "Available @code{jami-account} fields are:"
  34052. msgstr ""
  34053. #. type: item
  34054. #: guix-git/doc/guix.texi:22790
  34055. #, no-wrap
  34056. msgid "@code{archive} (type: string-or-computed-file)"
  34057. msgstr ""
  34058. #. type: table
  34059. #: guix-git/doc/guix.texi:22796
  34060. msgid "The account archive (backup) file name of the account. This is used to provision the account when the service starts. The account archive should @emph{not} be encrypted. It is highly recommended to make it readable only to the @samp{root} user (i.e., not in the store), to guard against leaking the secret key material of the Jami account it contains."
  34061. msgstr ""
  34062. #. type: item
  34063. #: guix-git/doc/guix.texi:22797
  34064. #, no-wrap
  34065. msgid "@code{allowed-contacts} (default: @code{disabled}) (type: maybe-account-fingerprint-list)"
  34066. msgstr ""
  34067. #. type: table
  34068. #: guix-git/doc/guix.texi:22804
  34069. msgid "The list of allowed contacts for the account, entered as their 40 characters long fingerprint. Messages or calls from accounts not in that list will be rejected. When unspecified, the configuration of the account archive is used as-is with respect to contacts and public inbound calls/messaging allowance, which typically defaults to allow any contact to communicate with the account."
  34070. msgstr ""
  34071. #. type: item
  34072. #: guix-git/doc/guix.texi:22805
  34073. #, no-wrap
  34074. msgid "@code{moderators} (default: @code{disabled}) (type: maybe-account-fingerprint-list)"
  34075. msgstr ""
  34076. #. type: table
  34077. #: guix-git/doc/guix.texi:22811
  34078. msgid "The list of contacts that should have moderation privileges (to ban, mute, etc. other users) in rendezvous conferences, entered as their 40 characters long fingerprint. When unspecified, the configuration of the account archive is used as-is with respect to moderation, which typically defaults to allow anyone to moderate."
  34079. msgstr ""
  34080. #. type: item
  34081. #: guix-git/doc/guix.texi:22812
  34082. #, no-wrap
  34083. msgid "@code{rendezvous-point?} (default: @code{disabled}) (type: maybe-boolean)"
  34084. msgstr ""
  34085. #. type: table
  34086. #: guix-git/doc/guix.texi:22816
  34087. msgid "Whether the account should operate in the rendezvous mode. In this mode, all the incoming audio/video calls are mixed into a conference. When left unspecified, the value from the account archive prevails."
  34088. msgstr ""
  34089. #. type: item
  34090. #: guix-git/doc/guix.texi:22817
  34091. #, no-wrap
  34092. msgid "@code{peer-discovery?} (default: @code{disabled}) (type: maybe-boolean)"
  34093. msgstr ""
  34094. #. type: table
  34095. #: guix-git/doc/guix.texi:22823
  34096. msgid "Whether peer discovery should be enabled. Peer discovery is used to discover other OpenDHT nodes on the local network, which can be useful to maintain communication between devices on such network even when the connection to the the Internet has been lost. When left unspecified, the value from the account archive prevails."
  34097. msgstr ""
  34098. #. type: item
  34099. #: guix-git/doc/guix.texi:22824
  34100. #, no-wrap
  34101. msgid "@code{bootstrap-hostnames} (default: @code{disabled}) (type: maybe-string-list)"
  34102. msgstr ""
  34103. #. type: table
  34104. #: guix-git/doc/guix.texi:22828
  34105. msgid "A list of hostnames or IPs pointing to OpenDHT nodes, that should be used to initially join the OpenDHT network. When left unspecified, the value from the account archive prevails."
  34106. msgstr ""
  34107. #. type: item
  34108. #: guix-git/doc/guix.texi:22829
  34109. #, no-wrap
  34110. msgid "@code{name-server-uri} (default: @code{disabled}) (type: maybe-string)"
  34111. msgstr ""
  34112. #. type: table
  34113. #: guix-git/doc/guix.texi:22832
  34114. msgid "The URI of the name server to use, that can be used to retrieve the account fingerprint for a registered username."
  34115. msgstr ""
  34116. #. type: cindex
  34117. #: guix-git/doc/guix.texi:22837 guix-git/doc/guix.texi:22839
  34118. #, no-wrap
  34119. msgid "Murmur (VoIP server)"
  34120. msgstr ""
  34121. #. type: cindex
  34122. #: guix-git/doc/guix.texi:22840
  34123. #, no-wrap
  34124. msgid "VoIP server"
  34125. msgstr ""
  34126. #. type: Plain text
  34127. #: guix-git/doc/guix.texi:22844
  34128. msgid "This section describes how to set up and run a Murmur server. Murmur is the server of the @uref{https://mumble.info, Mumble} voice-over-IP (VoIP) suite."
  34129. msgstr ""
  34130. #. type: deftp
  34131. #: guix-git/doc/guix.texi:22845
  34132. #, no-wrap
  34133. msgid "{Data Type} murmur-configuration"
  34134. msgstr ""
  34135. #. type: deftp
  34136. #: guix-git/doc/guix.texi:22848
  34137. msgid "The service type for the Murmur server. An example configuration can look like this:"
  34138. msgstr ""
  34139. #. type: lisp
  34140. #: guix-git/doc/guix.texi:22857
  34141. #, no-wrap
  34142. msgid ""
  34143. "(service murmur-service-type\n"
  34144. " (murmur-configuration\n"
  34145. " (welcome-text\n"
  34146. " \"Welcome to this Mumble server running on Guix!\")\n"
  34147. " (cert-required? #t) ;disallow text password logins\n"
  34148. " (ssl-cert \"/etc/letsencrypt/live/mumble.example.com/fullchain.pem\")\n"
  34149. " (ssl-key \"/etc/letsencrypt/live/mumble.example.com/privkey.pem\")))\n"
  34150. msgstr ""
  34151. #. type: deftp
  34152. #: guix-git/doc/guix.texi:22861
  34153. msgid "After reconfiguring your system, you can manually set the murmur @code{SuperUser} password with the command that is printed during the activation phase."
  34154. msgstr ""
  34155. #. type: deftp
  34156. #: guix-git/doc/guix.texi:22870
  34157. msgid "It is recommended to register a normal Mumble user account and grant it admin or moderator rights. You can use the @code{mumble} client to login as new normal user, register yourself, and log out. For the next step login with the name @code{SuperUser} use the @code{SuperUser} password that you set previously, and grant your newly registered mumble user administrator or moderator rights and create some channels."
  34158. msgstr ""
  34159. #. type: deftp
  34160. #: guix-git/doc/guix.texi:22872
  34161. msgid "Available @code{murmur-configuration} fields are:"
  34162. msgstr ""
  34163. #. type: item
  34164. #: guix-git/doc/guix.texi:22874
  34165. #, no-wrap
  34166. msgid "@code{package} (default: @code{mumble})"
  34167. msgstr ""
  34168. #. type: table
  34169. #: guix-git/doc/guix.texi:22876
  34170. msgid "Package that contains @code{bin/murmurd}."
  34171. msgstr ""
  34172. #. type: item
  34173. #: guix-git/doc/guix.texi:22877
  34174. #, no-wrap
  34175. msgid "@code{user} (default: @code{\"murmur\"})"
  34176. msgstr ""
  34177. #. type: table
  34178. #: guix-git/doc/guix.texi:22879
  34179. msgid "User who will run the Murmur server."
  34180. msgstr ""
  34181. #. type: item
  34182. #: guix-git/doc/guix.texi:22880
  34183. #, no-wrap
  34184. msgid "@code{group} (default: @code{\"murmur\"})"
  34185. msgstr ""
  34186. #. type: table
  34187. #: guix-git/doc/guix.texi:22882
  34188. msgid "Group of the user who will run the murmur server."
  34189. msgstr ""
  34190. #. type: item
  34191. #: guix-git/doc/guix.texi:22883
  34192. #, no-wrap
  34193. msgid "@code{port} (default: @code{64738})"
  34194. msgstr ""
  34195. #. type: table
  34196. #: guix-git/doc/guix.texi:22885
  34197. msgid "Port on which the server will listen."
  34198. msgstr ""
  34199. #. type: item
  34200. #: guix-git/doc/guix.texi:22886
  34201. #, no-wrap
  34202. msgid "@code{welcome-text} (default: @code{\"\"})"
  34203. msgstr ""
  34204. #. type: table
  34205. #: guix-git/doc/guix.texi:22888
  34206. msgid "Welcome text sent to clients when they connect."
  34207. msgstr ""
  34208. #. type: item
  34209. #: guix-git/doc/guix.texi:22889
  34210. #, no-wrap
  34211. msgid "@code{server-password} (default: @code{\"\"})"
  34212. msgstr ""
  34213. #. type: table
  34214. #: guix-git/doc/guix.texi:22891
  34215. msgid "Password the clients have to enter in order to connect."
  34216. msgstr ""
  34217. #. type: item
  34218. #: guix-git/doc/guix.texi:22892
  34219. #, no-wrap
  34220. msgid "@code{max-users} (default: @code{100})"
  34221. msgstr ""
  34222. #. type: table
  34223. #: guix-git/doc/guix.texi:22894
  34224. msgid "Maximum of users that can be connected to the server at once."
  34225. msgstr ""
  34226. #. type: item
  34227. #: guix-git/doc/guix.texi:22895
  34228. #, no-wrap
  34229. msgid "@code{max-user-bandwidth} (default: @code{#f})"
  34230. msgstr ""
  34231. #. type: table
  34232. #: guix-git/doc/guix.texi:22897
  34233. msgid "Maximum voice traffic a user can send per second."
  34234. msgstr ""
  34235. #. type: item
  34236. #: guix-git/doc/guix.texi:22898
  34237. #, no-wrap
  34238. msgid "@code{database-file} (default: @code{\"/var/lib/murmur/db.sqlite\"})"
  34239. msgstr ""
  34240. #. type: table
  34241. #: guix-git/doc/guix.texi:22901
  34242. msgid "File name of the sqlite database. The service's user will become the owner of the directory."
  34243. msgstr ""
  34244. #. type: item
  34245. #: guix-git/doc/guix.texi:22902
  34246. #, no-wrap
  34247. msgid "@code{log-file} (default: @code{\"/var/log/murmur/murmur.log\"})"
  34248. msgstr ""
  34249. #. type: table
  34250. #: guix-git/doc/guix.texi:22905
  34251. msgid "File name of the log file. The service's user will become the owner of the directory."
  34252. msgstr ""
  34253. #. type: item
  34254. #: guix-git/doc/guix.texi:22906
  34255. #, no-wrap
  34256. msgid "@code{autoban-attempts} (default: @code{10})"
  34257. msgstr ""
  34258. #. type: table
  34259. #: guix-git/doc/guix.texi:22909
  34260. msgid "Maximum number of logins a user can make in @code{autoban-timeframe} without getting auto banned for @code{autoban-time}."
  34261. msgstr ""
  34262. #. type: item
  34263. #: guix-git/doc/guix.texi:22910
  34264. #, no-wrap
  34265. msgid "@code{autoban-timeframe} (default: @code{120})"
  34266. msgstr ""
  34267. #. type: table
  34268. #: guix-git/doc/guix.texi:22912
  34269. msgid "Timeframe for autoban in seconds."
  34270. msgstr ""
  34271. #. type: item
  34272. #: guix-git/doc/guix.texi:22913
  34273. #, no-wrap
  34274. msgid "@code{autoban-time} (default: @code{300})"
  34275. msgstr ""
  34276. #. type: table
  34277. #: guix-git/doc/guix.texi:22916
  34278. msgid "Amount of time in seconds for which a client gets banned when violating the autoban limits."
  34279. msgstr ""
  34280. #. type: item
  34281. #: guix-git/doc/guix.texi:22917
  34282. #, no-wrap
  34283. msgid "@code{opus-threshold} (default: @code{100})"
  34284. msgstr ""
  34285. #. type: table
  34286. #: guix-git/doc/guix.texi:22920
  34287. msgid "Percentage of clients that need to support opus before switching over to opus audio codec."
  34288. msgstr ""
  34289. #. type: item
  34290. #: guix-git/doc/guix.texi:22921
  34291. #, no-wrap
  34292. msgid "@code{channel-nesting-limit} (default: @code{10})"
  34293. msgstr ""
  34294. #. type: table
  34295. #: guix-git/doc/guix.texi:22923
  34296. msgid "How deep channels can be nested at maximum."
  34297. msgstr ""
  34298. #. type: item
  34299. #: guix-git/doc/guix.texi:22924
  34300. #, no-wrap
  34301. msgid "@code{channelname-regex} (default: @code{#f})"
  34302. msgstr ""
  34303. #. type: table
  34304. #: guix-git/doc/guix.texi:22926
  34305. msgid "A string in form of a Qt regular expression that channel names must conform to."
  34306. msgstr ""
  34307. #. type: item
  34308. #: guix-git/doc/guix.texi:22927
  34309. #, no-wrap
  34310. msgid "@code{username-regex} (default: @code{#f})"
  34311. msgstr ""
  34312. #. type: table
  34313. #: guix-git/doc/guix.texi:22929
  34314. msgid "A string in form of a Qt regular expression that user names must conform to."
  34315. msgstr ""
  34316. #. type: item
  34317. #: guix-git/doc/guix.texi:22930
  34318. #, no-wrap
  34319. msgid "@code{text-message-length} (default: @code{5000})"
  34320. msgstr ""
  34321. #. type: table
  34322. #: guix-git/doc/guix.texi:22932
  34323. msgid "Maximum size in bytes that a user can send in one text chat message."
  34324. msgstr ""
  34325. #. type: item
  34326. #: guix-git/doc/guix.texi:22933
  34327. #, no-wrap
  34328. msgid "@code{image-message-length} (default: @code{(* 128 1024)})"
  34329. msgstr ""
  34330. #. type: table
  34331. #: guix-git/doc/guix.texi:22935
  34332. msgid "Maximum size in bytes that a user can send in one image message."
  34333. msgstr ""
  34334. #. type: item
  34335. #: guix-git/doc/guix.texi:22936
  34336. #, no-wrap
  34337. msgid "@code{cert-required?} (default: @code{#f})"
  34338. msgstr ""
  34339. #. type: table
  34340. #: guix-git/doc/guix.texi:22939
  34341. msgid "If it is set to @code{#t} clients that use weak password authentication will not be accepted. Users must have completed the certificate wizard to join."
  34342. msgstr ""
  34343. #. type: item
  34344. #: guix-git/doc/guix.texi:22940
  34345. #, no-wrap
  34346. msgid "@code{remember-channel?} (default: @code{#f})"
  34347. msgstr ""
  34348. #. type: table
  34349. #: guix-git/doc/guix.texi:22943
  34350. msgid "Should murmur remember the last channel each user was in when they disconnected and put them into the remembered channel when they rejoin."
  34351. msgstr ""
  34352. #. type: item
  34353. #: guix-git/doc/guix.texi:22944
  34354. #, no-wrap
  34355. msgid "@code{allow-html?} (default: @code{#f})"
  34356. msgstr ""
  34357. #. type: table
  34358. #: guix-git/doc/guix.texi:22946
  34359. msgid "Should html be allowed in text messages, user comments, and channel descriptions."
  34360. msgstr ""
  34361. #. type: item
  34362. #: guix-git/doc/guix.texi:22947
  34363. #, no-wrap
  34364. msgid "@code{allow-ping?} (default: @code{#f})"
  34365. msgstr ""
  34366. #. type: table
  34367. #: guix-git/doc/guix.texi:22951
  34368. msgid "Setting to true exposes the current user count, the maximum user count, and the server's maximum bandwidth per client to unauthenticated users. In the Mumble client, this information is shown in the Connect dialog."
  34369. msgstr ""
  34370. #. type: table
  34371. #: guix-git/doc/guix.texi:22953
  34372. msgid "Disabling this setting will prevent public listing of the server."
  34373. msgstr ""
  34374. #. type: item
  34375. #: guix-git/doc/guix.texi:22954
  34376. #, no-wrap
  34377. msgid "@code{bonjour?} (default: @code{#f})"
  34378. msgstr ""
  34379. #. type: table
  34380. #: guix-git/doc/guix.texi:22956
  34381. msgid "Should the server advertise itself in the local network through the bonjour protocol."
  34382. msgstr ""
  34383. #. type: item
  34384. #: guix-git/doc/guix.texi:22957
  34385. #, no-wrap
  34386. msgid "@code{send-version?} (default: @code{#f})"
  34387. msgstr ""
  34388. #. type: table
  34389. #: guix-git/doc/guix.texi:22959
  34390. msgid "Should the murmur server version be exposed in ping requests."
  34391. msgstr ""
  34392. #. type: item
  34393. #: guix-git/doc/guix.texi:22960
  34394. #, no-wrap
  34395. msgid "@code{log-days} (default: @code{31})"
  34396. msgstr ""
  34397. #. type: table
  34398. #: guix-git/doc/guix.texi:22964
  34399. msgid "Murmur also stores logs in the database, which are accessible via RPC. The default is 31 days of months, but you can set this setting to 0 to keep logs forever, or -1 to disable logging to the database."
  34400. msgstr ""
  34401. #. type: item
  34402. #: guix-git/doc/guix.texi:22965
  34403. #, no-wrap
  34404. msgid "@code{obfuscate-ips?} (default: @code{#t})"
  34405. msgstr ""
  34406. #. type: table
  34407. #: guix-git/doc/guix.texi:22967
  34408. msgid "Should logged ips be obfuscated to protect the privacy of users."
  34409. msgstr ""
  34410. #. type: item
  34411. #: guix-git/doc/guix.texi:22968
  34412. #, no-wrap
  34413. msgid "@code{ssl-cert} (default: @code{#f})"
  34414. msgstr ""
  34415. #. type: table
  34416. #: guix-git/doc/guix.texi:22970
  34417. msgid "File name of the SSL/TLS certificate used for encrypted connections."
  34418. msgstr ""
  34419. #. type: lisp
  34420. #: guix-git/doc/guix.texi:22973
  34421. #, no-wrap
  34422. msgid "(ssl-cert \"/etc/letsencrypt/live/example.com/fullchain.pem\")\n"
  34423. msgstr ""
  34424. #. type: item
  34425. #: guix-git/doc/guix.texi:22974
  34426. #, no-wrap
  34427. msgid "@code{ssl-key} (default: @code{#f})"
  34428. msgstr ""
  34429. #. type: table
  34430. #: guix-git/doc/guix.texi:22976
  34431. msgid "Filepath to the ssl private key used for encrypted connections."
  34432. msgstr ""
  34433. #. type: lisp
  34434. #: guix-git/doc/guix.texi:22978
  34435. #, no-wrap
  34436. msgid "(ssl-key \"/etc/letsencrypt/live/example.com/privkey.pem\")\n"
  34437. msgstr ""
  34438. #. type: item
  34439. #: guix-git/doc/guix.texi:22980
  34440. #, no-wrap
  34441. msgid "@code{ssl-dh-params} (default: @code{#f})"
  34442. msgstr ""
  34443. #. type: table
  34444. #: guix-git/doc/guix.texi:22985
  34445. msgid "File name of a PEM-encoded file with Diffie-Hellman parameters for the SSL/TLS encryption. Alternatively you set it to @code{\"@@ffdhe2048\"}, @code{\"@@ffdhe3072\"}, @code{\"@@ffdhe4096\"}, @code{\"@@ffdhe6144\"} or @code{\"@@ffdhe8192\"} to use bundled parameters from RFC 7919."
  34446. msgstr ""
  34447. #. type: item
  34448. #: guix-git/doc/guix.texi:22986
  34449. #, no-wrap
  34450. msgid "@code{ssl-ciphers} (default: @code{#f})"
  34451. msgstr ""
  34452. #. type: table
  34453. #: guix-git/doc/guix.texi:22989
  34454. msgid "The @code{ssl-ciphers} option chooses the cipher suites to make available for use in SSL/TLS."
  34455. msgstr ""
  34456. #. type: table
  34457. #: guix-git/doc/guix.texi:22993
  34458. msgid "This option is specified using @uref{https://www.openssl.org/docs/apps/ciphers.html#CIPHER-LIST-FORMAT, OpenSSL cipher list notation}."
  34459. msgstr ""
  34460. #. type: table
  34461. #: guix-git/doc/guix.texi:22998
  34462. msgid "It is recommended that you try your cipher string using 'openssl ciphers <string>' before setting it here, to get a feel for which cipher suites you will get. After setting this option, it is recommend that you inspect your Murmur log to ensure that Murmur is using the cipher suites that you expected it to."
  34463. msgstr ""
  34464. #. type: table
  34465. #: guix-git/doc/guix.texi:23002
  34466. msgid "Note: Changing this option may impact the backwards compatibility of your Murmur server, and can remove the ability for older Mumble clients to be able to connect to it."
  34467. msgstr ""
  34468. #. type: item
  34469. #: guix-git/doc/guix.texi:23003
  34470. #, no-wrap
  34471. msgid "@code{public-registration} (default: @code{#f})"
  34472. msgstr ""
  34473. #. type: table
  34474. #: guix-git/doc/guix.texi:23005
  34475. msgid "Must be a @code{<murmur-public-registration-configuration>} record or @code{#f}."
  34476. msgstr ""
  34477. #. type: table
  34478. #: guix-git/doc/guix.texi:23010
  34479. msgid "You can optionally register your server in the public server list that the @code{mumble} client shows on startup. You cannot register your server if you have set a @code{server-password}, or set @code{allow-ping} to @code{#f}."
  34480. msgstr ""
  34481. #. type: table
  34482. #: guix-git/doc/guix.texi:23012
  34483. msgid "It might take a few hours until it shows up in the public list."
  34484. msgstr ""
  34485. #. type: item
  34486. #: guix-git/doc/guix.texi:23013 guix-git/doc/guix.texi:25249
  34487. #, no-wrap
  34488. msgid "@code{file} (default: @code{#f})"
  34489. msgstr ""
  34490. #. type: table
  34491. #: guix-git/doc/guix.texi:23015
  34492. msgid "Optional alternative override for this configuration."
  34493. msgstr ""
  34494. #. type: deftp
  34495. #: guix-git/doc/guix.texi:23018
  34496. #, no-wrap
  34497. msgid "{Data Type} murmur-public-registration-configuration"
  34498. msgstr ""
  34499. #. type: deftp
  34500. #: guix-git/doc/guix.texi:23020
  34501. msgid "Configuration for public registration of a murmur service."
  34502. msgstr ""
  34503. #. type: table
  34504. #: guix-git/doc/guix.texi:23024
  34505. msgid "This is a display name for your server. Not to be confused with the hostname."
  34506. msgstr ""
  34507. #. type: itemx
  34508. #: guix-git/doc/guix.texi:23025 guix-git/doc/guix.texi:31777
  34509. #: guix-git/doc/guix.texi:32925
  34510. #, no-wrap
  34511. msgid "password"
  34512. msgstr ""
  34513. #. type: table
  34514. #: guix-git/doc/guix.texi:23028
  34515. msgid "A password to identify your registration. Subsequent updates will need the same password. Don't lose your password."
  34516. msgstr ""
  34517. #. type: table
  34518. #: guix-git/doc/guix.texi:23032
  34519. msgid "This should be a @code{http://} or @code{https://} link to your web site."
  34520. msgstr ""
  34521. #. type: item
  34522. #: guix-git/doc/guix.texi:23033 guix-git/doc/guix.texi:26128
  34523. #, no-wrap
  34524. msgid "@code{hostname} (default: @code{#f})"
  34525. msgstr ""
  34526. #. type: table
  34527. #: guix-git/doc/guix.texi:23036
  34528. msgid "By default your server will be listed by its IP address. If it is set your server will be linked by this host name instead."
  34529. msgstr ""
  34530. #. type: Plain text
  34531. #: guix-git/doc/guix.texi:23046
  34532. msgid "The @code{(gnu services file-sharing)} module provides services that assist with transferring files over peer-to-peer file-sharing networks."
  34533. msgstr ""
  34534. #. type: subsubheading
  34535. #: guix-git/doc/guix.texi:23047
  34536. #, no-wrap
  34537. msgid "Transmission Daemon Service"
  34538. msgstr ""
  34539. #. type: Plain text
  34540. #: guix-git/doc/guix.texi:23055
  34541. msgid "@uref{https://transmissionbt.com/, Transmission} is a flexible BitTorrent client that offers a variety of graphical and command-line interfaces. A @code{transmission-daemon-service-type} service provides Transmission's headless variant, @command{transmission-daemon}, as a system service, allowing users to share files via BitTorrent even when they are not logged in."
  34542. msgstr ""
  34543. #. type: deffn
  34544. #: guix-git/doc/guix.texi:23056
  34545. #, no-wrap
  34546. msgid "{Scheme Variable} transmission-daemon-service-type"
  34547. msgstr ""
  34548. #. type: deffn
  34549. #: guix-git/doc/guix.texi:23060
  34550. msgid "The service type for the Transmission Daemon BitTorrent client. Its value must be a @code{transmission-daemon-configuration} object as in this example:"
  34551. msgstr ""
  34552. #. type: lisp
  34553. #: guix-git/doc/guix.texi:23071
  34554. #, no-wrap
  34555. msgid ""
  34556. "(service transmission-daemon-service-type\n"
  34557. " (transmission-daemon-configuration\n"
  34558. " ;; Restrict access to the RPC (\"control\") interface\n"
  34559. " (rpc-authentication-required? #t)\n"
  34560. " (rpc-username \"transmission\")\n"
  34561. " (rpc-password\n"
  34562. " (transmission-password-hash\n"
  34563. " \"transmission\" ; desired password\n"
  34564. " \"uKd1uMs9\")) ; arbitrary salt value\n"
  34565. "\n"
  34566. msgstr ""
  34567. #. type: lisp
  34568. #: guix-git/doc/guix.texi:23076
  34569. #, no-wrap
  34570. msgid ""
  34571. " ;; Accept requests from this and other hosts on the\n"
  34572. " ;; local network\n"
  34573. " (rpc-whitelist-enabled? #t)\n"
  34574. " (rpc-whitelist '(\"::1\" \"127.0.0.1\" \"192.168.0.*\"))\n"
  34575. "\n"
  34576. msgstr ""
  34577. #. type: lisp
  34578. #: guix-git/doc/guix.texi:23080
  34579. #, no-wrap
  34580. msgid ""
  34581. " ;; Limit bandwidth use during work hours\n"
  34582. " (alt-speed-down (* 1024 2)) ; 2 MB/s\n"
  34583. " (alt-speed-up 512) ; 512 kB/s\n"
  34584. "\n"
  34585. msgstr ""
  34586. #. type: lisp
  34587. #: guix-git/doc/guix.texi:23087
  34588. #, no-wrap
  34589. msgid ""
  34590. " (alt-speed-time-enabled? #t)\n"
  34591. " (alt-speed-time-day 'weekdays)\n"
  34592. " (alt-speed-time-begin\n"
  34593. " (+ (* 60 8) 30)) ; 8:30 am\n"
  34594. " (alt-speed-time-end\n"
  34595. " (+ (* 60 (+ 12 5)) 30)))) ; 5:30 pm\n"
  34596. msgstr ""
  34597. #. type: Plain text
  34598. #: guix-git/doc/guix.texi:23100
  34599. msgid "Once the service is started, users can interact with the daemon through its Web interface (at @code{http://localhost:9091/}) or by using the @command{transmission-remote} command-line tool, available in the @code{transmission} package. (Emacs users may want to also consider the @code{emacs-transmission} package.) Both communicate with the daemon through its remote procedure call (RPC) interface, which by default is available to all users on the system; you may wish to change this by assigning values to the @code{rpc-authentication-required?}, @code{rpc-username} and @code{rpc-password} settings, as shown in the example above and documented further below."
  34600. msgstr ""
  34601. #. type: Plain text
  34602. #: guix-git/doc/guix.texi:23108
  34603. msgid "The value for @code{rpc-password} must be a password hash of the type generated and used by Transmission clients. This can be copied verbatim from an existing @file{settings.json} file, if another Transmission client is already being used. Otherwise, the @code{transmission-password-hash} and @code{transmission-random-salt} procedures provided by this module can be used to obtain a suitable hash value."
  34604. msgstr ""
  34605. #. type: deffn
  34606. #: guix-git/doc/guix.texi:23109
  34607. #, no-wrap
  34608. msgid "{Scheme Procedure} transmission-password-hash @var{password} @var{salt}"
  34609. msgstr ""
  34610. #. type: deffn
  34611. #: guix-git/doc/guix.texi:23113
  34612. msgid "Returns a string containing the result of hashing @var{password} together with @var{salt}, in the format recognized by Transmission clients for their @code{rpc-password} configuration setting."
  34613. msgstr ""
  34614. #. type: deffn
  34615. #: guix-git/doc/guix.texi:23117
  34616. msgid "@var{salt} must be an eight-character string. The @code{transmission-random-salt} procedure can be used to generate a suitable salt value at random."
  34617. msgstr ""
  34618. #. type: deffn
  34619. #: guix-git/doc/guix.texi:23119
  34620. #, no-wrap
  34621. msgid "{Scheme Procedure} transmission-random-salt"
  34622. msgstr ""
  34623. #. type: deffn
  34624. #: guix-git/doc/guix.texi:23123
  34625. msgid "Returns a string containing a random, eight-character salt value of the type generated and used by Transmission clients, suitable for passing to the @code{transmission-password-hash} procedure."
  34626. msgstr ""
  34627. #. type: Plain text
  34628. #: guix-git/doc/guix.texi:23129
  34629. msgid "These procedures are accessible from within a Guile REPL started with the @command{guix repl} command (@pxref{Invoking guix repl}). This is useful for obtaining a random salt value to provide as the second parameter to `transmission-password-hash`, as in this example session:"
  34630. msgstr ""
  34631. #. type: example
  34632. #: guix-git/doc/guix.texi:23135
  34633. #, no-wrap
  34634. msgid ""
  34635. "$ guix repl\n"
  34636. "scheme@@(guix-user)> ,use (gnu services file-sharing)\n"
  34637. "scheme@@(guix-user)> (transmission-random-salt)\n"
  34638. "$1 = \"uKd1uMs9\"\n"
  34639. msgstr ""
  34640. #. type: Plain text
  34641. #: guix-git/doc/guix.texi:23138
  34642. msgid "Alternatively, a complete password hash can generated in a single step:"
  34643. msgstr ""
  34644. #. type: example
  34645. #: guix-git/doc/guix.texi:23143
  34646. #, no-wrap
  34647. msgid ""
  34648. "scheme@@(guix-user)> (transmission-password-hash \"transmission\"\n"
  34649. "(transmission-random-salt))\n"
  34650. "$2 = \"@{c8bbc6d1740cd8dc819a6e25563b67812c1c19c9VtFPfdsX\"\n"
  34651. msgstr ""
  34652. #. type: Plain text
  34653. #: guix-git/doc/guix.texi:23148
  34654. msgid "The resulting string can be used as-is for the value of @code{rpc-password}, allowing the password to be kept hidden even in the operating-system configuration."
  34655. msgstr ""
  34656. #. type: Plain text
  34657. #: guix-git/doc/guix.texi:23157
  34658. msgid "Torrent files downloaded by the daemon are directly accessible only to users in the ``transmission'' user group, who receive read-only access to the directory specified by the @code{download-dir} configuration setting (and also the directory specified by @code{incomplete-dir}, if @code{incomplete-dir-enabled?} is @code{#t}). Downloaded files can be moved to another directory or deleted altogether using @command{transmission-remote} with its @code{--move} and @code{--remove-and-delete} options."
  34659. msgstr ""
  34660. #. type: Plain text
  34661. #: guix-git/doc/guix.texi:23164
  34662. msgid "If the @code{watch-dir-enabled?} setting is set to @code{#t}, users in the ``transmission'' group are able also to place @file{.torrent} files in the directory specified by @code{watch-dir} to have the corresponding torrents added by the daemon. (The @code{trash-original-torrent-files?} setting controls whether the daemon deletes these files after processing them.)"
  34663. msgstr ""
  34664. #. type: Plain text
  34665. #: guix-git/doc/guix.texi:23169
  34666. msgid "Some of the daemon's configuration settings can be changed temporarily by @command{transmission-remote} and similar tools. To undo these changes, use the service's @code{reload} action to have the daemon reload its settings from disk:"
  34667. msgstr ""
  34668. #. type: example
  34669. #: guix-git/doc/guix.texi:23172
  34670. #, no-wrap
  34671. msgid "# herd reload transmission-daemon\n"
  34672. msgstr ""
  34673. #. type: Plain text
  34674. #: guix-git/doc/guix.texi:23176
  34675. msgid "The full set of available configuration settings is defined by the @code{transmission-daemon-configuration} data type."
  34676. msgstr ""
  34677. #. type: deftp
  34678. #: guix-git/doc/guix.texi:23177
  34679. #, no-wrap
  34680. msgid "{Data Type} transmission-daemon-configuration"
  34681. msgstr ""
  34682. #. type: deftp
  34683. #: guix-git/doc/guix.texi:23181
  34684. msgid "The data type representing configuration settings for Transmission Daemon. These correspond directly to the settings recognized by Transmission clients in their @file{settings.json} file."
  34685. msgstr ""
  34686. #. type: Plain text
  34687. #: guix-git/doc/guix.texi:23195
  34688. msgid "Available @code{transmission-daemon-configuration} fields are:"
  34689. msgstr ""
  34690. #. type: deftypevr
  34691. #: guix-git/doc/guix.texi:23196
  34692. #, no-wrap
  34693. msgid "{@code{transmission-daemon-configuration} parameter} package transmission"
  34694. msgstr ""
  34695. #. type: deftypevr
  34696. #: guix-git/doc/guix.texi:23198
  34697. msgid "The Transmission package to use."
  34698. msgstr ""
  34699. #. type: deftypevr
  34700. #: guix-git/doc/guix.texi:23201
  34701. #, no-wrap
  34702. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer stop-wait-period"
  34703. msgstr ""
  34704. #. type: deftypevr
  34705. #: guix-git/doc/guix.texi:23207
  34706. msgid "The period, in seconds, to wait when stopping the service for @command{transmission-daemon} to exit before killing its process. This allows the daemon time to complete its housekeeping and send a final update to trackers as it shuts down. On slow hosts, or hosts with a slow network connection, this value may need to be increased."
  34707. msgstr ""
  34708. #. type: deftypevr
  34709. #: guix-git/doc/guix.texi:23209 guix-git/doc/guix.texi:23581
  34710. #: guix-git/doc/guix.texi:30881 guix-git/doc/guix.texi:31116
  34711. #: guix-git/doc/guix.texi:31124 guix-git/doc/guix.texi:31132
  34712. msgid "Defaults to @samp{10}."
  34713. msgstr ""
  34714. #. type: deftypevr
  34715. #: guix-git/doc/guix.texi:23212
  34716. #, no-wrap
  34717. msgid "{@code{transmission-daemon-configuration} parameter} string download-dir"
  34718. msgstr ""
  34719. #. type: deftypevr
  34720. #: guix-git/doc/guix.texi:23214
  34721. msgid "The directory to which torrent files are downloaded."
  34722. msgstr ""
  34723. #. type: deftypevr
  34724. #: guix-git/doc/guix.texi:23216
  34725. msgid "Defaults to @samp{\"/var/lib/transmission-daemon/downloads\"}."
  34726. msgstr ""
  34727. #. type: deftypevr
  34728. #: guix-git/doc/guix.texi:23219
  34729. #, no-wrap
  34730. msgid "{@code{transmission-daemon-configuration} parameter} boolean incomplete-dir-enabled?"
  34731. msgstr ""
  34732. #. type: deftypevr
  34733. #: guix-git/doc/guix.texi:23224
  34734. msgid "If @code{#t}, files will be held in @code{incomplete-dir} while their torrent is being downloaded, then moved to @code{download-dir} once the torrent is complete. Otherwise, files for all torrents (including those still being downloaded) will be placed in @code{download-dir}."
  34735. msgstr ""
  34736. #. type: deftypevr
  34737. #: guix-git/doc/guix.texi:23229
  34738. #, no-wrap
  34739. msgid "{@code{transmission-daemon-configuration} parameter} maybe-string incomplete-dir"
  34740. msgstr ""
  34741. #. type: deftypevr
  34742. #: guix-git/doc/guix.texi:23232
  34743. msgid "The directory in which files from incompletely downloaded torrents will be held when @code{incomplete-dir-enabled?} is @code{#t}."
  34744. msgstr ""
  34745. #. type: deftypevr
  34746. #: guix-git/doc/guix.texi:23237
  34747. #, no-wrap
  34748. msgid "{@code{transmission-daemon-configuration} parameter} umask umask"
  34749. msgstr ""
  34750. #. type: deftypevr
  34751. #: guix-git/doc/guix.texi:23240
  34752. msgid "The file mode creation mask used for downloaded files. (See the @command{umask} man page for more information.)"
  34753. msgstr ""
  34754. #. type: deftypevr
  34755. #: guix-git/doc/guix.texi:23242
  34756. msgid "Defaults to @samp{18}."
  34757. msgstr ""
  34758. #. type: deftypevr
  34759. #: guix-git/doc/guix.texi:23245
  34760. #, no-wrap
  34761. msgid "{@code{transmission-daemon-configuration} parameter} boolean rename-partial-files?"
  34762. msgstr ""
  34763. #. type: deftypevr
  34764. #: guix-git/doc/guix.texi:23248
  34765. msgid "When @code{#t}, ``.part'' is appended to the name of partially downloaded files."
  34766. msgstr ""
  34767. #. type: deftypevr
  34768. #: guix-git/doc/guix.texi:23253
  34769. #, no-wrap
  34770. msgid "{@code{transmission-daemon-configuration} parameter} preallocation-mode preallocation"
  34771. msgstr ""
  34772. #. type: deftypevr
  34773. #: guix-git/doc/guix.texi:23258
  34774. msgid "The mode by which space should be preallocated for downloaded files, one of @code{none}, @code{fast} (or @code{sparse}) and @code{full}. Specifying @code{full} will minimize disk fragmentation at a cost to file-creation speed."
  34775. msgstr ""
  34776. #. type: deftypevr
  34777. #: guix-git/doc/guix.texi:23260
  34778. msgid "Defaults to @samp{fast}."
  34779. msgstr ""
  34780. #. type: deftypevr
  34781. #: guix-git/doc/guix.texi:23263
  34782. #, no-wrap
  34783. msgid "{@code{transmission-daemon-configuration} parameter} boolean watch-dir-enabled?"
  34784. msgstr ""
  34785. #. type: deftypevr
  34786. #: guix-git/doc/guix.texi:23268
  34787. msgid "If @code{#t}, the directory specified by @code{watch-dir} will be watched for new @file{.torrent} files and the torrents they describe added automatically (and the original files removed, if @code{trash-original-torrent-files?} is @code{#t})."
  34788. msgstr ""
  34789. #. type: deftypevr
  34790. #: guix-git/doc/guix.texi:23273
  34791. #, no-wrap
  34792. msgid "{@code{transmission-daemon-configuration} parameter} maybe-string watch-dir"
  34793. msgstr ""
  34794. #. type: deftypevr
  34795. #: guix-git/doc/guix.texi:23276
  34796. msgid "The directory to be watched for @file{.torrent} files indicating new torrents to be added, when @code{watch-dir-enabled} is @code{#t}."
  34797. msgstr ""
  34798. #. type: deftypevr
  34799. #: guix-git/doc/guix.texi:23281
  34800. #, no-wrap
  34801. msgid "{@code{transmission-daemon-configuration} parameter} boolean trash-original-torrent-files?"
  34802. msgstr ""
  34803. #. type: deftypevr
  34804. #: guix-git/doc/guix.texi:23285
  34805. msgid "When @code{#t}, @file{.torrent} files will be deleted from the watch directory once their torrent has been added (see @code{watch-directory-enabled?})."
  34806. msgstr ""
  34807. #. type: deftypevr
  34808. #: guix-git/doc/guix.texi:23290
  34809. #, no-wrap
  34810. msgid "{@code{transmission-daemon-configuration} parameter} boolean speed-limit-down-enabled?"
  34811. msgstr ""
  34812. #. type: deftypevr
  34813. #: guix-git/doc/guix.texi:23293
  34814. msgid "When @code{#t}, the daemon's download speed will be limited to the rate specified by @code{speed-limit-down}."
  34815. msgstr ""
  34816. #. type: deftypevr
  34817. #: guix-git/doc/guix.texi:23298
  34818. #, no-wrap
  34819. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer speed-limit-down"
  34820. msgstr ""
  34821. #. type: deftypevr
  34822. #: guix-git/doc/guix.texi:23300
  34823. msgid "The default global-maximum download speed, in kilobytes per second."
  34824. msgstr ""
  34825. #. type: deftypevr
  34826. #: guix-git/doc/guix.texi:23305
  34827. #, no-wrap
  34828. msgid "{@code{transmission-daemon-configuration} parameter} boolean speed-limit-up-enabled?"
  34829. msgstr ""
  34830. #. type: deftypevr
  34831. #: guix-git/doc/guix.texi:23308
  34832. msgid "When @code{#t}, the daemon's upload speed will be limited to the rate specified by @code{speed-limit-up}."
  34833. msgstr ""
  34834. #. type: deftypevr
  34835. #: guix-git/doc/guix.texi:23313
  34836. #, no-wrap
  34837. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer speed-limit-up"
  34838. msgstr ""
  34839. #. type: deftypevr
  34840. #: guix-git/doc/guix.texi:23315
  34841. msgid "The default global-maximum upload speed, in kilobytes per second."
  34842. msgstr ""
  34843. #. type: deftypevr
  34844. #: guix-git/doc/guix.texi:23320
  34845. #, no-wrap
  34846. msgid "{@code{transmission-daemon-configuration} parameter} boolean alt-speed-enabled?"
  34847. msgstr ""
  34848. #. type: deftypevr
  34849. #: guix-git/doc/guix.texi:23326
  34850. msgid "When @code{#t}, the alternate speed limits @code{alt-speed-down} and @code{alt-speed-up} are used (in place of @code{speed-limit-down} and @code{speed-limit-up}, if they are enabled) to constrain the daemon's bandwidth usage. This can be scheduled to occur automatically at certain times during the week; see @code{alt-speed-time-enabled?}."
  34851. msgstr ""
  34852. #. type: deftypevr
  34853. #: guix-git/doc/guix.texi:23331
  34854. #, no-wrap
  34855. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer alt-speed-down"
  34856. msgstr ""
  34857. #. type: deftypevr
  34858. #: guix-git/doc/guix.texi:23333
  34859. msgid "The alternate global-maximum download speed, in kilobytes per second."
  34860. msgstr ""
  34861. #. type: deftypevr
  34862. #: guix-git/doc/guix.texi:23335 guix-git/doc/guix.texi:23342
  34863. #: guix-git/doc/guix.texi:23514 guix-git/doc/guix.texi:30888
  34864. #: guix-git/doc/guix.texi:30903
  34865. msgid "Defaults to @samp{50}."
  34866. msgstr ""
  34867. #. type: deftypevr
  34868. #: guix-git/doc/guix.texi:23338
  34869. #, no-wrap
  34870. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer alt-speed-up"
  34871. msgstr ""
  34872. #. type: deftypevr
  34873. #: guix-git/doc/guix.texi:23340
  34874. msgid "The alternate global-maximum upload speed, in kilobytes per second."
  34875. msgstr ""
  34876. #. type: deftypevr
  34877. #: guix-git/doc/guix.texi:23345
  34878. #, no-wrap
  34879. msgid "{@code{transmission-daemon-configuration} parameter} boolean alt-speed-time-enabled?"
  34880. msgstr ""
  34881. #. type: deftypevr
  34882. #: guix-git/doc/guix.texi:23350
  34883. msgid "When @code{#t}, the alternate speed limits @code{alt-speed-down} and @code{alt-speed-up} will be enabled automatically during the periods specified by @code{alt-speed-time-day}, @code{alt-speed-time-begin} and @code{alt-time-speed-end}."
  34884. msgstr ""
  34885. #. type: deftypevr
  34886. #: guix-git/doc/guix.texi:23355
  34887. #, no-wrap
  34888. msgid "{@code{transmission-daemon-configuration} parameter} day-list alt-speed-time-day"
  34889. msgstr ""
  34890. #. type: deftypevr
  34891. #: guix-git/doc/guix.texi:23360
  34892. msgid "The days of the week on which the alternate-speed schedule should be used, specified either as a list of days (@code{sunday}, @code{monday}, and so on) or using one of the symbols @code{weekdays}, @code{weekends} or @code{all}."
  34893. msgstr ""
  34894. #. type: deftypevr
  34895. #: guix-git/doc/guix.texi:23362
  34896. msgid "Defaults to @samp{all}."
  34897. msgstr ""
  34898. #. type: deftypevr
  34899. #: guix-git/doc/guix.texi:23365
  34900. #, no-wrap
  34901. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer alt-speed-time-begin"
  34902. msgstr ""
  34903. #. type: deftypevr
  34904. #: guix-git/doc/guix.texi:23368
  34905. msgid "The time of day at which to enable the alternate speed limits, expressed as a number of minutes since midnight."
  34906. msgstr ""
  34907. #. type: deftypevr
  34908. #: guix-git/doc/guix.texi:23370
  34909. msgid "Defaults to @samp{540}."
  34910. msgstr ""
  34911. #. type: deftypevr
  34912. #: guix-git/doc/guix.texi:23373
  34913. #, no-wrap
  34914. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer alt-speed-time-end"
  34915. msgstr ""
  34916. #. type: deftypevr
  34917. #: guix-git/doc/guix.texi:23376
  34918. msgid "The time of day at which to disable the alternate speed limits, expressed as a number of minutes since midnight."
  34919. msgstr ""
  34920. #. type: deftypevr
  34921. #: guix-git/doc/guix.texi:23378
  34922. msgid "Defaults to @samp{1020}."
  34923. msgstr ""
  34924. #. type: deftypevr
  34925. #: guix-git/doc/guix.texi:23381
  34926. #, no-wrap
  34927. msgid "{@code{transmission-daemon-configuration} parameter} string bind-address-ipv4"
  34928. msgstr ""
  34929. #. type: deftypevr
  34930. #: guix-git/doc/guix.texi:23384
  34931. msgid "The IP address at which to listen for peer connections, or ``0.0.0.0'' to listen at all available IP addresses."
  34932. msgstr ""
  34933. #. type: deftypevr
  34934. #: guix-git/doc/guix.texi:23386 guix-git/doc/guix.texi:23689
  34935. #: guix-git/doc/guix.texi:28802
  34936. msgid "Defaults to @samp{\"0.0.0.0\"}."
  34937. msgstr ""
  34938. #. type: deftypevr
  34939. #: guix-git/doc/guix.texi:23389
  34940. #, no-wrap
  34941. msgid "{@code{transmission-daemon-configuration} parameter} string bind-address-ipv6"
  34942. msgstr ""
  34943. #. type: deftypevr
  34944. #: guix-git/doc/guix.texi:23392
  34945. msgid "The IPv6 address at which to listen for peer connections, or ``::'' to listen at all available IPv6 addresses."
  34946. msgstr ""
  34947. #. type: deftypevr
  34948. #: guix-git/doc/guix.texi:23394
  34949. msgid "Defaults to @samp{\"::\"}."
  34950. msgstr ""
  34951. #. type: deftypevr
  34952. #: guix-git/doc/guix.texi:23397
  34953. #, no-wrap
  34954. msgid "{@code{transmission-daemon-configuration} parameter} boolean peer-port-random-on-start?"
  34955. msgstr ""
  34956. #. type: deftypevr
  34957. #: guix-git/doc/guix.texi:23403
  34958. msgid "If @code{#t}, when the daemon starts it will select a port at random on which to listen for peer connections, from the range specified (inclusively) by @code{peer-port-random-low} and @code{peer-port-random-high}. Otherwise, it listens on the port specified by @code{peer-port}."
  34959. msgstr ""
  34960. #. type: deftypevr
  34961. #: guix-git/doc/guix.texi:23408
  34962. #, no-wrap
  34963. msgid "{@code{transmission-daemon-configuration} parameter} port-number peer-port-random-low"
  34964. msgstr ""
  34965. #. type: deftypevr
  34966. #: guix-git/doc/guix.texi:23411
  34967. msgid "The lowest selectable port number when @code{peer-port-random-on-start?} is @code{#t}."
  34968. msgstr ""
  34969. #. type: deftypevr
  34970. #: guix-git/doc/guix.texi:23413
  34971. msgid "Defaults to @samp{49152}."
  34972. msgstr ""
  34973. #. type: deftypevr
  34974. #: guix-git/doc/guix.texi:23416
  34975. #, no-wrap
  34976. msgid "{@code{transmission-daemon-configuration} parameter} port-number peer-port-random-high"
  34977. msgstr ""
  34978. #. type: deftypevr
  34979. #: guix-git/doc/guix.texi:23419
  34980. msgid "The highest selectable port number when @code{peer-port-random-on-start} is @code{#t}."
  34981. msgstr ""
  34982. #. type: deftypevr
  34983. #: guix-git/doc/guix.texi:23421
  34984. msgid "Defaults to @samp{65535}."
  34985. msgstr ""
  34986. #. type: deftypevr
  34987. #: guix-git/doc/guix.texi:23424
  34988. #, no-wrap
  34989. msgid "{@code{transmission-daemon-configuration} parameter} port-number peer-port"
  34990. msgstr ""
  34991. #. type: deftypevr
  34992. #: guix-git/doc/guix.texi:23427
  34993. msgid "The port on which to listen for peer connections when @code{peer-port-random-on-start?} is @code{#f}."
  34994. msgstr ""
  34995. #. type: deftypevr
  34996. #: guix-git/doc/guix.texi:23429
  34997. msgid "Defaults to @samp{51413}."
  34998. msgstr ""
  34999. #. type: deftypevr
  35000. #: guix-git/doc/guix.texi:23432
  35001. #, no-wrap
  35002. msgid "{@code{transmission-daemon-configuration} parameter} boolean port-forwarding-enabled?"
  35003. msgstr ""
  35004. #. type: deftypevr
  35005. #: guix-git/doc/guix.texi:23436
  35006. msgid "If @code{#t}, the daemon will attempt to configure port-forwarding on an upstream gateway automatically using @acronym{UPnP} and @acronym{NAT-PMP}."
  35007. msgstr ""
  35008. #. type: deftypevr
  35009. #: guix-git/doc/guix.texi:23441
  35010. #, no-wrap
  35011. msgid "{@code{transmission-daemon-configuration} parameter} encryption-mode encryption"
  35012. msgstr ""
  35013. #. type: deftypevr
  35014. #: guix-git/doc/guix.texi:23446
  35015. msgid "The encryption preference for peer connections, one of @code{prefer-unencrypted-connections}, @code{prefer-encrypted-connections} or @code{require-encrypted-connections}."
  35016. msgstr ""
  35017. #. type: deftypevr
  35018. #: guix-git/doc/guix.texi:23448
  35019. msgid "Defaults to @samp{prefer-encrypted-connections}."
  35020. msgstr ""
  35021. #. type: deftypevr
  35022. #: guix-git/doc/guix.texi:23451
  35023. #, no-wrap
  35024. msgid "{@code{transmission-daemon-configuration} parameter} maybe-string peer-congestion-algorithm"
  35025. msgstr ""
  35026. #. type: deftypevr
  35027. #: guix-git/doc/guix.texi:23456
  35028. msgid "The TCP congestion-control algorithm to use for peer connections, specified using a string recognized by the operating system in calls to @code{setsockopt} (or set to @code{disabled}, in which case the operating-system default is used)."
  35029. msgstr ""
  35030. #. type: deftypevr
  35031. #: guix-git/doc/guix.texi:23465
  35032. msgid "Note that on GNU/Linux systems, the kernel must be configured to allow processes to use a congestion-control algorithm not in the default set; otherwise, it will deny these requests with ``Operation not permitted''. To see which algorithms are available on your system and which are currently permitted for use, look at the contents of the files @file{tcp_available_congestion_control} and @file{tcp_allowed_congestion_control} in the @file{/proc/sys/net/ipv4} directory."
  35033. msgstr ""
  35034. #. type: deftypevr
  35035. #: guix-git/doc/guix.texi:23473
  35036. msgid "As an example, to have Transmission Daemon use @uref{http://www-ece.rice.edu/networks/TCP-LP/,the TCP Low Priority congestion-control algorithm}, you'll need to modify your kernel configuration to build in support for the algorithm, then update your operating-system configuration to allow its use by adding a @code{sysctl-service-type} service (or updating the existing one's configuration) with lines like the following:"
  35037. msgstr ""
  35038. #. type: lisp
  35039. #: guix-git/doc/guix.texi:23480
  35040. #, no-wrap
  35041. msgid ""
  35042. "(service sysctl-service-type\n"
  35043. " (sysctl-configuration\n"
  35044. " (settings\n"
  35045. " (\"net.ipv4.tcp_allowed_congestion_control\" .\n"
  35046. " \"reno cubic lp\"))))\n"
  35047. msgstr ""
  35048. #. type: deftypevr
  35049. #: guix-git/doc/guix.texi:23483
  35050. msgid "The Transmission Daemon configuration can then be updated with"
  35051. msgstr ""
  35052. #. type: lisp
  35053. #: guix-git/doc/guix.texi:23486
  35054. #, no-wrap
  35055. msgid "(peer-congestion-algorithm \"lp\")\n"
  35056. msgstr ""
  35057. #. type: deftypevr
  35058. #: guix-git/doc/guix.texi:23489
  35059. msgid "and the system reconfigured to have the changes take effect."
  35060. msgstr ""
  35061. #. type: deftypevr
  35062. #: guix-git/doc/guix.texi:23494
  35063. #, no-wrap
  35064. msgid "{@code{transmission-daemon-configuration} parameter} tcp-type-of-service peer-socket-tos"
  35065. msgstr ""
  35066. #. type: deftypevr
  35067. #: guix-git/doc/guix.texi:23498
  35068. msgid "The type of service to request in outgoing @acronym{TCP} packets, one of @code{default}, @code{low-cost}, @code{throughput}, @code{low-delay} and @code{reliability}."
  35069. msgstr ""
  35070. #. type: deftypevr
  35071. #: guix-git/doc/guix.texi:23500
  35072. msgid "Defaults to @samp{default}."
  35073. msgstr ""
  35074. #. type: deftypevr
  35075. #: guix-git/doc/guix.texi:23503
  35076. #, no-wrap
  35077. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer peer-limit-global"
  35078. msgstr ""
  35079. #. type: deftypevr
  35080. #: guix-git/doc/guix.texi:23505
  35081. msgid "The global limit on the number of connected peers."
  35082. msgstr ""
  35083. #. type: deftypevr
  35084. #: guix-git/doc/guix.texi:23507
  35085. msgid "Defaults to @samp{200}."
  35086. msgstr ""
  35087. #. type: deftypevr
  35088. #: guix-git/doc/guix.texi:23510
  35089. #, no-wrap
  35090. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer peer-limit-per-torrent"
  35091. msgstr ""
  35092. #. type: deftypevr
  35093. #: guix-git/doc/guix.texi:23512
  35094. msgid "The per-torrent limit on the number of connected peers."
  35095. msgstr ""
  35096. #. type: deftypevr
  35097. #: guix-git/doc/guix.texi:23517
  35098. #, no-wrap
  35099. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer upload-slots-per-torrent"
  35100. msgstr ""
  35101. #. type: deftypevr
  35102. #: guix-git/doc/guix.texi:23520
  35103. msgid "The maximum number of peers to which the daemon will upload data simultaneously for each torrent."
  35104. msgstr ""
  35105. #. type: deftypevr
  35106. #: guix-git/doc/guix.texi:23522
  35107. msgid "Defaults to @samp{14}."
  35108. msgstr ""
  35109. #. type: deftypevr
  35110. #: guix-git/doc/guix.texi:23525
  35111. #, no-wrap
  35112. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer peer-id-ttl-hours"
  35113. msgstr ""
  35114. #. type: deftypevr
  35115. #: guix-git/doc/guix.texi:23528
  35116. msgid "The maximum lifespan, in hours, of the peer ID associated with each public torrent before it is regenerated."
  35117. msgstr ""
  35118. #. type: deftypevr
  35119. #: guix-git/doc/guix.texi:23530
  35120. msgid "Defaults to @samp{6}."
  35121. msgstr ""
  35122. #. type: deftypevr
  35123. #: guix-git/doc/guix.texi:23533
  35124. #, no-wrap
  35125. msgid "{@code{transmission-daemon-configuration} parameter} boolean blocklist-enabled?"
  35126. msgstr ""
  35127. #. type: deftypevr
  35128. #: guix-git/doc/guix.texi:23536
  35129. msgid "When @code{#t}, the daemon will ignore peers mentioned in the blocklist it has most recently downloaded from @code{blocklist-url}."
  35130. msgstr ""
  35131. #. type: deftypevr
  35132. #: guix-git/doc/guix.texi:23541
  35133. #, no-wrap
  35134. msgid "{@code{transmission-daemon-configuration} parameter} maybe-string blocklist-url"
  35135. msgstr ""
  35136. #. type: deftypevr
  35137. #: guix-git/doc/guix.texi:23545
  35138. msgid "The URL of a peer blocklist (in @acronym{P2P}-plaintext or eMule @file{.dat} format) to be periodically downloaded and applied when @code{blocklist-enabled?} is @code{#t}."
  35139. msgstr ""
  35140. #. type: deftypevr
  35141. #: guix-git/doc/guix.texi:23550
  35142. #, no-wrap
  35143. msgid "{@code{transmission-daemon-configuration} parameter} boolean download-queue-enabled?"
  35144. msgstr ""
  35145. #. type: deftypevr
  35146. #: guix-git/doc/guix.texi:23553
  35147. msgid "If @code{#t}, the daemon will be limited to downloading at most @code{download-queue-size} non-stalled torrents simultaneously."
  35148. msgstr ""
  35149. #. type: deftypevr
  35150. #: guix-git/doc/guix.texi:23558
  35151. #, no-wrap
  35152. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer download-queue-size"
  35153. msgstr ""
  35154. #. type: deftypevr
  35155. #: guix-git/doc/guix.texi:23562
  35156. msgid "The size of the daemon's download queue, which limits the number of non-stalled torrents it will download at any one time when @code{download-queue-enabled?} is @code{#t}."
  35157. msgstr ""
  35158. #. type: deftypevr
  35159. #: guix-git/doc/guix.texi:23567
  35160. #, no-wrap
  35161. msgid "{@code{transmission-daemon-configuration} parameter} boolean seed-queue-enabled?"
  35162. msgstr ""
  35163. #. type: deftypevr
  35164. #: guix-git/doc/guix.texi:23570
  35165. msgid "If @code{#t}, the daemon will be limited to seeding at most @code{seed-queue-size} non-stalled torrents simultaneously."
  35166. msgstr ""
  35167. #. type: deftypevr
  35168. #: guix-git/doc/guix.texi:23575
  35169. #, no-wrap
  35170. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer seed-queue-size"
  35171. msgstr ""
  35172. #. type: deftypevr
  35173. #: guix-git/doc/guix.texi:23579
  35174. msgid "The size of the daemon's seed queue, which limits the number of non-stalled torrents it will seed at any one time when @code{seed-queue-enabled?} is @code{#t}."
  35175. msgstr ""
  35176. #. type: deftypevr
  35177. #: guix-git/doc/guix.texi:23584
  35178. #, no-wrap
  35179. msgid "{@code{transmission-daemon-configuration} parameter} boolean queue-stalled-enabled?"
  35180. msgstr ""
  35181. #. type: deftypevr
  35182. #: guix-git/doc/guix.texi:23589
  35183. msgid "When @code{#t}, the daemon will consider torrents for which it has not shared data in the past @code{queue-stalled-minutes} minutes to be stalled and not count them against its @code{download-queue-size} and @code{seed-queue-size} limits."
  35184. msgstr ""
  35185. #. type: deftypevr
  35186. #: guix-git/doc/guix.texi:23594
  35187. #, no-wrap
  35188. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer queue-stalled-minutes"
  35189. msgstr ""
  35190. #. type: deftypevr
  35191. #: guix-git/doc/guix.texi:23598
  35192. msgid "The maximum period, in minutes, a torrent may be idle before it is considered to be stalled, when @code{queue-stalled-enabled?} is @code{#t}."
  35193. msgstr ""
  35194. #. type: deftypevr
  35195. #: guix-git/doc/guix.texi:23603
  35196. #, no-wrap
  35197. msgid "{@code{transmission-daemon-configuration} parameter} boolean ratio-limit-enabled?"
  35198. msgstr ""
  35199. #. type: deftypevr
  35200. #: guix-git/doc/guix.texi:23606
  35201. msgid "When @code{#t}, a torrent being seeded will automatically be paused once it reaches the ratio specified by @code{ratio-limit}."
  35202. msgstr ""
  35203. #. type: deftypevr
  35204. #: guix-git/doc/guix.texi:23611
  35205. #, no-wrap
  35206. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-rational ratio-limit"
  35207. msgstr ""
  35208. #. type: deftypevr
  35209. #: guix-git/doc/guix.texi:23614
  35210. msgid "The ratio at which a torrent being seeded will be paused, when @code{ratio-limit-enabled?} is @code{#t}."
  35211. msgstr ""
  35212. #. type: deftypevr
  35213. #: guix-git/doc/guix.texi:23616
  35214. msgid "Defaults to @samp{2.0}."
  35215. msgstr ""
  35216. #. type: deftypevr
  35217. #: guix-git/doc/guix.texi:23619
  35218. #, no-wrap
  35219. msgid "{@code{transmission-daemon-configuration} parameter} boolean idle-seeding-limit-enabled?"
  35220. msgstr ""
  35221. #. type: deftypevr
  35222. #: guix-git/doc/guix.texi:23622
  35223. msgid "When @code{#t}, a torrent being seeded will automatically be paused once it has been idle for @code{idle-seeding-limit} minutes."
  35224. msgstr ""
  35225. #. type: deftypevr
  35226. #: guix-git/doc/guix.texi:23627
  35227. #, no-wrap
  35228. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer idle-seeding-limit"
  35229. msgstr ""
  35230. #. type: deftypevr
  35231. #: guix-git/doc/guix.texi:23631
  35232. msgid "The maximum period, in minutes, a torrent being seeded may be idle before it is paused, when @code{idle-seeding-limit-enabled?} is @code{#t}."
  35233. msgstr ""
  35234. #. type: deftypevr
  35235. #: guix-git/doc/guix.texi:23636
  35236. #, no-wrap
  35237. msgid "{@code{transmission-daemon-configuration} parameter} boolean dht-enabled?"
  35238. msgstr ""
  35239. #. type: deftypevr
  35240. #: guix-git/doc/guix.texi:23640
  35241. msgid "Enable @uref{http://bittorrent.org/beps/bep_0005.html,the distributed hash table (@acronym{DHT}) protocol}, which supports the use of trackerless torrents."
  35242. msgstr ""
  35243. #. type: deftypevr
  35244. #: guix-git/doc/guix.texi:23645
  35245. #, no-wrap
  35246. msgid "{@code{transmission-daemon-configuration} parameter} boolean lpd-enabled?"
  35247. msgstr ""
  35248. #. type: deftypevr
  35249. #: guix-git/doc/guix.texi:23650
  35250. msgid "Enable @uref{https://en.wikipedia.org/wiki/Local_Peer_Discovery,local peer discovery} (@acronym{LPD}), which allows the discovery of peers on the local network and may reduce the amount of data sent over the public Internet."
  35251. msgstr ""
  35252. #. type: deftypevr
  35253. #: guix-git/doc/guix.texi:23655
  35254. #, no-wrap
  35255. msgid "{@code{transmission-daemon-configuration} parameter} boolean pex-enabled?"
  35256. msgstr ""
  35257. #. type: deftypevr
  35258. #: guix-git/doc/guix.texi:23659
  35259. msgid "Enable @uref{https://en.wikipedia.org/wiki/Peer_exchange,peer exchange} (@acronym{PEX}), which reduces the daemon's reliance on external trackers and may improve its performance."
  35260. msgstr ""
  35261. #. type: deftypevr
  35262. #: guix-git/doc/guix.texi:23664
  35263. #, no-wrap
  35264. msgid "{@code{transmission-daemon-configuration} parameter} boolean utp-enabled?"
  35265. msgstr ""
  35266. #. type: deftypevr
  35267. #: guix-git/doc/guix.texi:23669
  35268. msgid "Enable @uref{http://bittorrent.org/beps/bep_0029.html,the micro transport protocol} (@acronym{uTP}), which aims to reduce the impact of BitTorrent traffic on other users of the local network while maintaining full utilization of the available bandwidth."
  35269. msgstr ""
  35270. #. type: deftypevr
  35271. #: guix-git/doc/guix.texi:23674
  35272. #, no-wrap
  35273. msgid "{@code{transmission-daemon-configuration} parameter} boolean rpc-enabled?"
  35274. msgstr ""
  35275. #. type: deftypevr
  35276. #: guix-git/doc/guix.texi:23679
  35277. msgid "If @code{#t}, enable the remote procedure call (@acronym{RPC}) interface, which allows remote control of the daemon via its Web interface, the @command{transmission-remote} command-line client, and similar tools."
  35278. msgstr ""
  35279. #. type: deftypevr
  35280. #: guix-git/doc/guix.texi:23684
  35281. #, no-wrap
  35282. msgid "{@code{transmission-daemon-configuration} parameter} string rpc-bind-address"
  35283. msgstr ""
  35284. #. type: deftypevr
  35285. #: guix-git/doc/guix.texi:23687
  35286. msgid "The IP address at which to listen for @acronym{RPC} connections, or ``0.0.0.0'' to listen at all available IP addresses."
  35287. msgstr ""
  35288. #. type: deftypevr
  35289. #: guix-git/doc/guix.texi:23692
  35290. #, no-wrap
  35291. msgid "{@code{transmission-daemon-configuration} parameter} port-number rpc-port"
  35292. msgstr ""
  35293. #. type: deftypevr
  35294. #: guix-git/doc/guix.texi:23694
  35295. msgid "The port on which to listen for @acronym{RPC} connections."
  35296. msgstr ""
  35297. #. type: deftypevr
  35298. #: guix-git/doc/guix.texi:23696
  35299. msgid "Defaults to @samp{9091}."
  35300. msgstr ""
  35301. #. type: deftypevr
  35302. #: guix-git/doc/guix.texi:23699
  35303. #, no-wrap
  35304. msgid "{@code{transmission-daemon-configuration} parameter} string rpc-url"
  35305. msgstr ""
  35306. #. type: deftypevr
  35307. #: guix-git/doc/guix.texi:23701
  35308. msgid "The path prefix to use in the @acronym{RPC}-endpoint @acronym{URL}."
  35309. msgstr ""
  35310. #. type: deftypevr
  35311. #: guix-git/doc/guix.texi:23703
  35312. msgid "Defaults to @samp{\"/transmission/\"}."
  35313. msgstr ""
  35314. #. type: deftypevr
  35315. #: guix-git/doc/guix.texi:23706
  35316. #, no-wrap
  35317. msgid "{@code{transmission-daemon-configuration} parameter} boolean rpc-authentication-required?"
  35318. msgstr ""
  35319. #. type: deftypevr
  35320. #: guix-git/doc/guix.texi:23711
  35321. msgid "When @code{#t}, clients must authenticate (see @code{rpc-username} and @code{rpc-password}) when using the @acronym{RPC} interface. Note this has the side effect of disabling host-name whitelisting (see @code{rpc-host-whitelist-enabled?}."
  35322. msgstr ""
  35323. #. type: deftypevr
  35324. #: guix-git/doc/guix.texi:23716
  35325. #, no-wrap
  35326. msgid "{@code{transmission-daemon-configuration} parameter} maybe-string rpc-username"
  35327. msgstr ""
  35328. #. type: deftypevr
  35329. #: guix-git/doc/guix.texi:23719
  35330. msgid "The username required by clients to access the @acronym{RPC} interface when @code{rpc-authentication-required?} is @code{#t}."
  35331. msgstr ""
  35332. #. type: deftypevr
  35333. #: guix-git/doc/guix.texi:23724
  35334. #, no-wrap
  35335. msgid "{@code{transmission-daemon-configuration} parameter} maybe-transmission-password-hash rpc-password"
  35336. msgstr ""
  35337. #. type: deftypevr
  35338. #: guix-git/doc/guix.texi:23730
  35339. msgid "The password required by clients to access the @acronym{RPC} interface when @code{rpc-authentication-required?} is @code{#t}. This must be specified using a password hash in the format recognized by Transmission clients, either copied from an existing @file{settings.json} file or generated using the @code{transmission-password-hash} procedure."
  35340. msgstr ""
  35341. #. type: deftypevr
  35342. #: guix-git/doc/guix.texi:23735
  35343. #, no-wrap
  35344. msgid "{@code{transmission-daemon-configuration} parameter} boolean rpc-whitelist-enabled?"
  35345. msgstr ""
  35346. #. type: deftypevr
  35347. #: guix-git/doc/guix.texi:23738
  35348. msgid "When @code{#t}, @acronym{RPC} requests will be accepted only when they originate from an address specified in @code{rpc-whitelist}."
  35349. msgstr ""
  35350. #. type: deftypevr
  35351. #: guix-git/doc/guix.texi:23743
  35352. #, no-wrap
  35353. msgid "{@code{transmission-daemon-configuration} parameter} string-list rpc-whitelist"
  35354. msgstr ""
  35355. #. type: deftypevr
  35356. #: guix-git/doc/guix.texi:23747
  35357. msgid "The list of IP and IPv6 addresses from which @acronym{RPC} requests will be accepted when @code{rpc-whitelist-enabled?} is @code{#t}. Wildcards may be specified using @samp{*}."
  35358. msgstr ""
  35359. #. type: deftypevr
  35360. #: guix-git/doc/guix.texi:23749
  35361. msgid "Defaults to @samp{(\"127.0.0.1\" \"::1\")}."
  35362. msgstr ""
  35363. #. type: deftypevr
  35364. #: guix-git/doc/guix.texi:23752
  35365. #, no-wrap
  35366. msgid "{@code{transmission-daemon-configuration} parameter} boolean rpc-host-whitelist-enabled?"
  35367. msgstr ""
  35368. #. type: deftypevr
  35369. #: guix-git/doc/guix.texi:23757
  35370. msgid "When @code{#t}, @acronym{RPC} requests will be accepted only when they are addressed to a host named in @code{rpc-host-whitelist}. Note that requests to ``localhost'' or ``localhost.'', or to a numeric address, are always accepted regardless of these settings."
  35371. msgstr ""
  35372. #. type: deftypevr
  35373. #: guix-git/doc/guix.texi:23760
  35374. msgid "Note also this functionality is disabled when @code{rpc-authentication-required?} is @code{#t}."
  35375. msgstr ""
  35376. #. type: deftypevr
  35377. #: guix-git/doc/guix.texi:23765
  35378. #, no-wrap
  35379. msgid "{@code{transmission-daemon-configuration} parameter} string-list rpc-host-whitelist"
  35380. msgstr ""
  35381. #. type: deftypevr
  35382. #: guix-git/doc/guix.texi:23768
  35383. msgid "The list of host names recognized by the @acronym{RPC} server when @code{rpc-host-whitelist-enabled?} is @code{#t}."
  35384. msgstr ""
  35385. #. type: deftypevr
  35386. #: guix-git/doc/guix.texi:23773
  35387. #, no-wrap
  35388. msgid "{@code{transmission-daemon-configuration} parameter} message-level message-level"
  35389. msgstr ""
  35390. #. type: deftypevr
  35391. #: guix-git/doc/guix.texi:23777
  35392. msgid "The minimum severity level of messages to be logged (to @file{/var/log/transmission.log}) by the daemon, one of @code{none} (no logging), @code{error}, @code{info} and @code{debug}."
  35393. msgstr ""
  35394. #. type: deftypevr
  35395. #: guix-git/doc/guix.texi:23782
  35396. #, no-wrap
  35397. msgid "{@code{transmission-daemon-configuration} parameter} boolean start-added-torrents?"
  35398. msgstr ""
  35399. #. type: deftypevr
  35400. #: guix-git/doc/guix.texi:23785
  35401. msgid "When @code{#t}, torrents are started as soon as they are added; otherwise, they are added in ``paused'' state."
  35402. msgstr ""
  35403. #. type: deftypevr
  35404. #: guix-git/doc/guix.texi:23790
  35405. #, no-wrap
  35406. msgid "{@code{transmission-daemon-configuration} parameter} boolean script-torrent-done-enabled?"
  35407. msgstr ""
  35408. #. type: deftypevr
  35409. #: guix-git/doc/guix.texi:23794
  35410. msgid "When @code{#t}, the script specified by @code{script-torrent-done-filename} will be invoked each time a torrent completes."
  35411. msgstr ""
  35412. #. type: deftypevr
  35413. #: guix-git/doc/guix.texi:23799
  35414. #, no-wrap
  35415. msgid "{@code{transmission-daemon-configuration} parameter} maybe-file-object script-torrent-done-filename"
  35416. msgstr ""
  35417. #. type: deftypevr
  35418. #: guix-git/doc/guix.texi:23803
  35419. msgid "A file name or file-like object specifying a script to run each time a torrent completes, when @code{script-torrent-done-enabled?} is @code{#t}."
  35420. msgstr ""
  35421. #. type: deftypevr
  35422. #: guix-git/doc/guix.texi:23808
  35423. #, no-wrap
  35424. msgid "{@code{transmission-daemon-configuration} parameter} boolean scrape-paused-torrents-enabled?"
  35425. msgstr ""
  35426. #. type: deftypevr
  35427. #: guix-git/doc/guix.texi:23811
  35428. msgid "When @code{#t}, the daemon will scrape trackers for a torrent even when the torrent is paused."
  35429. msgstr ""
  35430. #. type: deftypevr
  35431. #: guix-git/doc/guix.texi:23816
  35432. #, no-wrap
  35433. msgid "{@code{transmission-daemon-configuration} parameter} non-negative-integer cache-size-mb"
  35434. msgstr ""
  35435. #. type: deftypevr
  35436. #: guix-git/doc/guix.texi:23820
  35437. msgid "The amount of memory, in megabytes, to allocate for the daemon's in-memory cache. A larger value may increase performance by reducing the frequency of disk I/O."
  35438. msgstr ""
  35439. #. type: deftypevr
  35440. #: guix-git/doc/guix.texi:23822
  35441. msgid "Defaults to @samp{4}."
  35442. msgstr ""
  35443. #. type: deftypevr
  35444. #: guix-git/doc/guix.texi:23825
  35445. #, no-wrap
  35446. msgid "{@code{transmission-daemon-configuration} parameter} boolean prefetch-enabled?"
  35447. msgstr ""
  35448. #. type: deftypevr
  35449. #: guix-git/doc/guix.texi:23829
  35450. msgid "When @code{#t}, the daemon will try to improve I/O performance by hinting to the operating system which data is likely to be read next from disk to satisfy requests from peers."
  35451. msgstr ""
  35452. #. type: subsubheading
  35453. #: guix-git/doc/guix.texi:23842
  35454. #, no-wrap
  35455. msgid "Tailon Service"
  35456. msgstr ""
  35457. #. type: Plain text
  35458. #: guix-git/doc/guix.texi:23846
  35459. msgid "@uref{https://tailon.readthedocs.io/, Tailon} is a web application for viewing and searching log files."
  35460. msgstr ""
  35461. #. type: Plain text
  35462. #: guix-git/doc/guix.texi:23849
  35463. msgid "The following example will configure the service with default values. By default, Tailon can be accessed on port 8080 (@code{http://localhost:8080})."
  35464. msgstr ""
  35465. #. type: lisp
  35466. #: guix-git/doc/guix.texi:23852
  35467. #, no-wrap
  35468. msgid "(service tailon-service-type)\n"
  35469. msgstr ""
  35470. #. type: Plain text
  35471. #: guix-git/doc/guix.texi:23856
  35472. msgid "The following example customises more of the Tailon configuration, adding @command{sed} to the list of allowed commands."
  35473. msgstr ""
  35474. #. type: lisp
  35475. #: guix-git/doc/guix.texi:23863
  35476. #, no-wrap
  35477. msgid ""
  35478. "(service tailon-service-type\n"
  35479. " (tailon-configuration\n"
  35480. " (config-file\n"
  35481. " (tailon-configuration-file\n"
  35482. " (allowed-commands '(\"tail\" \"grep\" \"awk\" \"sed\"))))))\n"
  35483. msgstr ""
  35484. #. type: deftp
  35485. #: guix-git/doc/guix.texi:23866
  35486. #, no-wrap
  35487. msgid "{Data Type} tailon-configuration"
  35488. msgstr ""
  35489. #. type: deftp
  35490. #: guix-git/doc/guix.texi:23869
  35491. msgid "Data type representing the configuration of Tailon. This type has the following parameters:"
  35492. msgstr ""
  35493. #. type: item
  35494. #: guix-git/doc/guix.texi:23871
  35495. #, no-wrap
  35496. msgid "@code{config-file} (default: @code{(tailon-configuration-file)})"
  35497. msgstr ""
  35498. #. type: table
  35499. #: guix-git/doc/guix.texi:23875
  35500. msgid "The configuration file to use for Tailon. This can be set to a @dfn{tailon-configuration-file} record value, or any gexp (@pxref{G-Expressions})."
  35501. msgstr ""
  35502. #. type: table
  35503. #: guix-git/doc/guix.texi:23878
  35504. msgid "For example, to instead use a local file, the @code{local-file} function can be used:"
  35505. msgstr ""
  35506. #. type: lisp
  35507. #: guix-git/doc/guix.texi:23883
  35508. #, no-wrap
  35509. msgid ""
  35510. "(service tailon-service-type\n"
  35511. " (tailon-configuration\n"
  35512. " (config-file (local-file \"./my-tailon.conf\"))))\n"
  35513. msgstr ""
  35514. #. type: item
  35515. #: guix-git/doc/guix.texi:23885
  35516. #, no-wrap
  35517. msgid "@code{package} (default: @code{tailon})"
  35518. msgstr ""
  35519. #. type: table
  35520. #: guix-git/doc/guix.texi:23887
  35521. msgid "The tailon package to use."
  35522. msgstr ""
  35523. #. type: deftp
  35524. #: guix-git/doc/guix.texi:23891
  35525. #, no-wrap
  35526. msgid "{Data Type} tailon-configuration-file"
  35527. msgstr ""
  35528. #. type: deftp
  35529. #: guix-git/doc/guix.texi:23894
  35530. msgid "Data type representing the configuration options for Tailon. This type has the following parameters:"
  35531. msgstr ""
  35532. #. type: item
  35533. #: guix-git/doc/guix.texi:23896
  35534. #, no-wrap
  35535. msgid "@code{files} (default: @code{(list \"/var/log\")})"
  35536. msgstr ""
  35537. #. type: table
  35538. #: guix-git/doc/guix.texi:23901
  35539. msgid "List of files to display. The list can include strings for a single file or directory, or a list, where the first item is the name of a subsection, and the remaining items are the files or directories in that subsection."
  35540. msgstr ""
  35541. #. type: item
  35542. #: guix-git/doc/guix.texi:23902
  35543. #, no-wrap
  35544. msgid "@code{bind} (default: @code{\"localhost:8080\"})"
  35545. msgstr ""
  35546. #. type: table
  35547. #: guix-git/doc/guix.texi:23904
  35548. msgid "Address and port to which Tailon should bind on."
  35549. msgstr ""
  35550. #. type: item
  35551. #: guix-git/doc/guix.texi:23905
  35552. #, no-wrap
  35553. msgid "@code{relative-root} (default: @code{#f})"
  35554. msgstr ""
  35555. #. type: table
  35556. #: guix-git/doc/guix.texi:23907
  35557. msgid "URL path to use for Tailon, set to @code{#f} to not use a path."
  35558. msgstr ""
  35559. #. type: item
  35560. #: guix-git/doc/guix.texi:23908
  35561. #, no-wrap
  35562. msgid "@code{allow-transfers?} (default: @code{#t})"
  35563. msgstr ""
  35564. #. type: table
  35565. #: guix-git/doc/guix.texi:23910
  35566. msgid "Allow downloading the log files in the web interface."
  35567. msgstr ""
  35568. #. type: item
  35569. #: guix-git/doc/guix.texi:23911
  35570. #, no-wrap
  35571. msgid "@code{follow-names?} (default: @code{#t})"
  35572. msgstr ""
  35573. #. type: table
  35574. #: guix-git/doc/guix.texi:23913
  35575. msgid "Allow tailing of not-yet existent files."
  35576. msgstr ""
  35577. #. type: item
  35578. #: guix-git/doc/guix.texi:23914
  35579. #, no-wrap
  35580. msgid "@code{tail-lines} (default: @code{200})"
  35581. msgstr ""
  35582. #. type: table
  35583. #: guix-git/doc/guix.texi:23916
  35584. msgid "Number of lines to read initially from each file."
  35585. msgstr ""
  35586. #. type: item
  35587. #: guix-git/doc/guix.texi:23917
  35588. #, no-wrap
  35589. msgid "@code{allowed-commands} (default: @code{(list \"tail\" \"grep\" \"awk\")})"
  35590. msgstr ""
  35591. #. type: table
  35592. #: guix-git/doc/guix.texi:23919
  35593. msgid "Commands to allow running. By default, @code{sed} is disabled."
  35594. msgstr ""
  35595. #. type: table
  35596. #: guix-git/doc/guix.texi:23922
  35597. msgid "Set @code{debug?} to @code{#t} to show debug messages."
  35598. msgstr ""
  35599. #. type: item
  35600. #: guix-git/doc/guix.texi:23923
  35601. #, no-wrap
  35602. msgid "@code{wrap-lines} (default: @code{#t})"
  35603. msgstr ""
  35604. #. type: table
  35605. #: guix-git/doc/guix.texi:23927
  35606. msgid "Initial line wrapping state in the web interface. Set to @code{#t} to initially wrap lines (the default), or to @code{#f} to initially not wrap lines."
  35607. msgstr ""
  35608. #. type: item
  35609. #: guix-git/doc/guix.texi:23928
  35610. #, no-wrap
  35611. msgid "@code{http-auth} (default: @code{#f})"
  35612. msgstr ""
  35613. #. type: table
  35614. #: guix-git/doc/guix.texi:23932
  35615. msgid "HTTP authentication type to use. Set to @code{#f} to disable authentication (the default). Supported values are @code{\"digest\"} or @code{\"basic\"}."
  35616. msgstr ""
  35617. #. type: item
  35618. #: guix-git/doc/guix.texi:23933
  35619. #, no-wrap
  35620. msgid "@code{users} (default: @code{#f})"
  35621. msgstr ""
  35622. #. type: table
  35623. #: guix-git/doc/guix.texi:23938
  35624. msgid "If HTTP authentication is enabled (see @code{http-auth}), access will be restricted to the credentials provided here. To configure users, use a list of pairs, where the first element of the pair is the username, and the 2nd element of the pair is the password."
  35625. msgstr ""
  35626. #. type: lisp
  35627. #: guix-git/doc/guix.texi:23944
  35628. #, no-wrap
  35629. msgid ""
  35630. "(tailon-configuration-file\n"
  35631. " (http-auth \"basic\")\n"
  35632. " (users '((\"user1\" . \"password1\")\n"
  35633. " (\"user2\" . \"password2\"))))\n"
  35634. msgstr ""
  35635. #. type: subsubheading
  35636. #: guix-git/doc/guix.texi:23950
  35637. #, no-wrap
  35638. msgid "Darkstat Service"
  35639. msgstr ""
  35640. #. type: cindex
  35641. #: guix-git/doc/guix.texi:23951
  35642. #, no-wrap
  35643. msgid "darkstat"
  35644. msgstr ""
  35645. #. type: Plain text
  35646. #: guix-git/doc/guix.texi:23954
  35647. msgid "Darkstat is a packet sniffer that captures network traffic, calculates statistics about usage, and serves reports over HTTP."
  35648. msgstr ""
  35649. #. type: defvar
  35650. #: guix-git/doc/guix.texi:23955
  35651. #, no-wrap
  35652. msgid "{Scheme Variable} darkstat-service-type"
  35653. msgstr ""
  35654. #. type: defvar
  35655. #: guix-git/doc/guix.texi:23960
  35656. msgid "This is the service type for the @uref{https://unix4lyfe.org/darkstat/, darkstat} service, its value must be a @code{darkstat-configuration} record as in this example:"
  35657. msgstr ""
  35658. #. type: lisp
  35659. #: guix-git/doc/guix.texi:23965
  35660. #, no-wrap
  35661. msgid ""
  35662. "(service darkstat-service-type\n"
  35663. " (darkstat-configuration\n"
  35664. " (interface \"eno1\")))\n"
  35665. msgstr ""
  35666. #. type: deftp
  35667. #: guix-git/doc/guix.texi:23968
  35668. #, no-wrap
  35669. msgid "{Data Type} darkstat-configuration"
  35670. msgstr ""
  35671. #. type: deftp
  35672. #: guix-git/doc/guix.texi:23970
  35673. msgid "Data type representing the configuration of @command{darkstat}."
  35674. msgstr ""
  35675. #. type: item
  35676. #: guix-git/doc/guix.texi:23972
  35677. #, no-wrap
  35678. msgid "@code{package} (default: @code{darkstat})"
  35679. msgstr ""
  35680. #. type: table
  35681. #: guix-git/doc/guix.texi:23974
  35682. msgid "The darkstat package to use."
  35683. msgstr ""
  35684. #. type: code{#1}
  35685. #: guix-git/doc/guix.texi:23975
  35686. #, no-wrap
  35687. msgid "interface"
  35688. msgstr ""
  35689. #. type: table
  35690. #: guix-git/doc/guix.texi:23977
  35691. msgid "Capture traffic on the specified network interface."
  35692. msgstr ""
  35693. #. type: item
  35694. #: guix-git/doc/guix.texi:23978
  35695. #, no-wrap
  35696. msgid "@code{port} (default: @code{\"667\"})"
  35697. msgstr ""
  35698. #. type: table
  35699. #: guix-git/doc/guix.texi:23980
  35700. msgid "Bind the web interface to the specified port."
  35701. msgstr ""
  35702. #. type: table
  35703. #: guix-git/doc/guix.texi:23983 guix-git/doc/guix.texi:24018
  35704. msgid "Bind the web interface to the specified address."
  35705. msgstr ""
  35706. #. type: item
  35707. #: guix-git/doc/guix.texi:23984
  35708. #, no-wrap
  35709. msgid "@code{base} (default: @code{\"/\"})"
  35710. msgstr ""
  35711. #. type: table
  35712. #: guix-git/doc/guix.texi:23987
  35713. msgid "Specify the path of the base URL@. This can be useful if @command{darkstat} is accessed via a reverse proxy."
  35714. msgstr ""
  35715. #. type: subsubheading
  35716. #: guix-git/doc/guix.texi:23991
  35717. #, no-wrap
  35718. msgid "Prometheus Node Exporter Service"
  35719. msgstr ""
  35720. #. type: cindex
  35721. #: guix-git/doc/guix.texi:23993
  35722. #, no-wrap
  35723. msgid "prometheus-node-exporter"
  35724. msgstr ""
  35725. #. type: Plain text
  35726. #: guix-git/doc/guix.texi:23998
  35727. msgid "The Prometheus ``node exporter'' makes hardware and operating system statistics provided by the Linux kernel available for the Prometheus monitoring system. This service should be deployed on all physical nodes and virtual machines, where monitoring these statistics is desirable."
  35728. msgstr ""
  35729. #. type: defvar
  35730. #: guix-git/doc/guix.texi:23999
  35731. #, no-wrap
  35732. msgid "{Scheme variable} prometheus-node-exporter-service-type"
  35733. msgstr ""
  35734. #. type: defvar
  35735. #: guix-git/doc/guix.texi:24003
  35736. msgid "This is the service type for the @uref{https://github.com/prometheus/node_exporter/, prometheus-node-exporter} service, its value must be a @code{prometheus-node-exporter-configuration}."
  35737. msgstr ""
  35738. #. type: lisp
  35739. #: guix-git/doc/guix.texi:24006
  35740. #, no-wrap
  35741. msgid "(service prometheus-node-exporter-service-type)\n"
  35742. msgstr ""
  35743. #. type: deftp
  35744. #: guix-git/doc/guix.texi:24009
  35745. #, no-wrap
  35746. msgid "{Data Type} prometheus-node-exporter-configuration"
  35747. msgstr ""
  35748. #. type: deftp
  35749. #: guix-git/doc/guix.texi:24011
  35750. msgid "Data type representing the configuration of @command{node_exporter}."
  35751. msgstr ""
  35752. #. type: item
  35753. #: guix-git/doc/guix.texi:24013
  35754. #, no-wrap
  35755. msgid "@code{package} (default: @code{go-github-com-prometheus-node-exporter})"
  35756. msgstr ""
  35757. #. type: table
  35758. #: guix-git/doc/guix.texi:24015
  35759. msgid "The prometheus-node-exporter package to use."
  35760. msgstr ""
  35761. #. type: item
  35762. #: guix-git/doc/guix.texi:24016
  35763. #, no-wrap
  35764. msgid "@code{web-listen-address} (default: @code{\":9100\"})"
  35765. msgstr ""
  35766. #. type: item
  35767. #: guix-git/doc/guix.texi:24019
  35768. #, no-wrap
  35769. msgid "@code{textfile-directory} (default: @code{\"/var/lib/prometheus/node-exporter\"})"
  35770. msgstr ""
  35771. #. type: table
  35772. #: guix-git/doc/guix.texi:24023
  35773. msgid "This directory can be used to export metrics specific to this machine. Files containing metrics in the text format, with the filename ending in @code{.prom} should be placed in this directory."
  35774. msgstr ""
  35775. #. type: table
  35776. #: guix-git/doc/guix.texi:24026
  35777. msgid "Extra options to pass to the Prometheus node exporter."
  35778. msgstr ""
  35779. #. type: subsubheading
  35780. #: guix-git/doc/guix.texi:24030
  35781. #, no-wrap
  35782. msgid "Zabbix server"
  35783. msgstr ""
  35784. #. type: cindex
  35785. #: guix-git/doc/guix.texi:24031
  35786. #, no-wrap
  35787. msgid "zabbix zabbix-server"
  35788. msgstr ""
  35789. #. type: Plain text
  35790. #: guix-git/doc/guix.texi:24034
  35791. msgid "Zabbix provides monitoring metrics, among others network utilization, CPU load and disk space consumption:"
  35792. msgstr ""
  35793. #. type: item
  35794. #: guix-git/doc/guix.texi:24036
  35795. #, no-wrap
  35796. msgid "High performance, high capacity (able to monitor hundreds of thousands of devices)."
  35797. msgstr ""
  35798. #. type: item
  35799. #: guix-git/doc/guix.texi:24037
  35800. #, no-wrap
  35801. msgid "Auto-discovery of servers and network devices and interfaces."
  35802. msgstr ""
  35803. #. type: item
  35804. #: guix-git/doc/guix.texi:24038
  35805. #, no-wrap
  35806. msgid "Low-level discovery, allows to automatically start monitoring new items, file systems or network interfaces among others."
  35807. msgstr ""
  35808. #. type: item
  35809. #: guix-git/doc/guix.texi:24039
  35810. #, no-wrap
  35811. msgid "Distributed monitoring with centralized web administration."
  35812. msgstr ""
  35813. #. type: item
  35814. #: guix-git/doc/guix.texi:24040
  35815. #, no-wrap
  35816. msgid "Native high performance agents."
  35817. msgstr ""
  35818. #. type: item
  35819. #: guix-git/doc/guix.texi:24041
  35820. #, no-wrap
  35821. msgid "SLA, and ITIL KPI metrics on reporting."
  35822. msgstr ""
  35823. #. type: item
  35824. #: guix-git/doc/guix.texi:24042
  35825. #, no-wrap
  35826. msgid "High-level (business) view of monitored resources through user-defined visual console screens and dashboards."
  35827. msgstr ""
  35828. #. type: item
  35829. #: guix-git/doc/guix.texi:24043
  35830. #, no-wrap
  35831. msgid "Remote command execution through Zabbix proxies."
  35832. msgstr ""
  35833. #. type: Plain text
  35834. #: guix-git/doc/guix.texi:24049
  35835. msgid "Available @code{zabbix-server-configuration} fields are:"
  35836. msgstr ""
  35837. #. type: deftypevr
  35838. #: guix-git/doc/guix.texi:24050
  35839. #, no-wrap
  35840. msgid "{@code{zabbix-server-configuration} parameter} package zabbix-server"
  35841. msgstr ""
  35842. #. type: deftypevr
  35843. #: guix-git/doc/guix.texi:24052
  35844. msgid "The zabbix-server package."
  35845. msgstr ""
  35846. #. type: deftypevr
  35847. #: guix-git/doc/guix.texi:24055
  35848. #, no-wrap
  35849. msgid "{@code{zabbix-server-configuration} parameter} string user"
  35850. msgstr ""
  35851. #. type: deftypevr
  35852. #: guix-git/doc/guix.texi:24057
  35853. msgid "User who will run the Zabbix server."
  35854. msgstr ""
  35855. #. type: deftypevr
  35856. #: guix-git/doc/guix.texi:24059 guix-git/doc/guix.texi:24066
  35857. #: guix-git/doc/guix.texi:24080 guix-git/doc/guix.texi:24087
  35858. #: guix-git/doc/guix.texi:24188 guix-git/doc/guix.texi:24195
  35859. #: guix-git/doc/guix.texi:24306 guix-git/doc/guix.texi:24313
  35860. msgid "Defaults to @samp{\"zabbix\"}."
  35861. msgstr ""
  35862. #. type: deftypevr
  35863. #: guix-git/doc/guix.texi:24062
  35864. #, no-wrap
  35865. msgid "{@code{zabbix-server-configuration} parameter} group group"
  35866. msgstr ""
  35867. #. type: deftypevr
  35868. #: guix-git/doc/guix.texi:24064
  35869. msgid "Group who will run the Zabbix server."
  35870. msgstr ""
  35871. #. type: deftypevr
  35872. #: guix-git/doc/guix.texi:24069
  35873. #, no-wrap
  35874. msgid "{@code{zabbix-server-configuration} parameter} string db-host"
  35875. msgstr ""
  35876. #. type: deftypevr
  35877. #: guix-git/doc/guix.texi:24071 guix-git/doc/guix.texi:24290
  35878. msgid "Database host name."
  35879. msgstr ""
  35880. #. type: deftypevr
  35881. #: guix-git/doc/guix.texi:24073
  35882. msgid "Defaults to @samp{\"127.0.0.1\"}."
  35883. msgstr ""
  35884. #. type: deftypevr
  35885. #: guix-git/doc/guix.texi:24076
  35886. #, no-wrap
  35887. msgid "{@code{zabbix-server-configuration} parameter} string db-name"
  35888. msgstr ""
  35889. #. type: deftypevr
  35890. #: guix-git/doc/guix.texi:24078 guix-git/doc/guix.texi:24304
  35891. msgid "Database name."
  35892. msgstr ""
  35893. #. type: deftypevr
  35894. #: guix-git/doc/guix.texi:24083
  35895. #, no-wrap
  35896. msgid "{@code{zabbix-server-configuration} parameter} string db-user"
  35897. msgstr ""
  35898. #. type: deftypevr
  35899. #: guix-git/doc/guix.texi:24085 guix-git/doc/guix.texi:24311
  35900. msgid "Database user."
  35901. msgstr ""
  35902. #. type: deftypevr
  35903. #: guix-git/doc/guix.texi:24090
  35904. #, no-wrap
  35905. msgid "{@code{zabbix-server-configuration} parameter} string db-password"
  35906. msgstr ""
  35907. #. type: deftypevr
  35908. #: guix-git/doc/guix.texi:24093
  35909. msgid "Database password. Please, use @code{include-files} with @code{DBPassword=SECRET} inside a specified file instead."
  35910. msgstr ""
  35911. #. type: deftypevr
  35912. #: guix-git/doc/guix.texi:24098
  35913. #, no-wrap
  35914. msgid "{@code{zabbix-server-configuration} parameter} number db-port"
  35915. msgstr ""
  35916. #. type: deftypevr
  35917. #: guix-git/doc/guix.texi:24100 guix-git/doc/guix.texi:24297
  35918. msgid "Database port."
  35919. msgstr ""
  35920. #. type: deftypevr
  35921. #: guix-git/doc/guix.texi:24102 guix-git/doc/guix.texi:24299
  35922. msgid "Defaults to @samp{5432}."
  35923. msgstr ""
  35924. #. type: deftypevr
  35925. #: guix-git/doc/guix.texi:24105
  35926. #, no-wrap
  35927. msgid "{@code{zabbix-server-configuration} parameter} string log-type"
  35928. msgstr ""
  35929. #. type: deftypevr
  35930. #: guix-git/doc/guix.texi:24107 guix-git/doc/guix.texi:24208
  35931. msgid "Specifies where log messages are written to:"
  35932. msgstr ""
  35933. #. type: itemize
  35934. #: guix-git/doc/guix.texi:24111 guix-git/doc/guix.texi:24212
  35935. msgid "@code{system} - syslog."
  35936. msgstr ""
  35937. #. type: itemize
  35938. #: guix-git/doc/guix.texi:24114 guix-git/doc/guix.texi:24215
  35939. msgid "@code{file} - file specified with @code{log-file} parameter."
  35940. msgstr ""
  35941. #. type: itemize
  35942. #: guix-git/doc/guix.texi:24117 guix-git/doc/guix.texi:24218
  35943. msgid "@code{console} - standard output."
  35944. msgstr ""
  35945. #. type: deftypevr
  35946. #: guix-git/doc/guix.texi:24124
  35947. #, no-wrap
  35948. msgid "{@code{zabbix-server-configuration} parameter} string log-file"
  35949. msgstr ""
  35950. #. type: deftypevr
  35951. #: guix-git/doc/guix.texi:24126 guix-git/doc/guix.texi:24227
  35952. msgid "Log file name for @code{log-type} @code{file} parameter."
  35953. msgstr ""
  35954. #. type: deftypevr
  35955. #: guix-git/doc/guix.texi:24128
  35956. msgid "Defaults to @samp{\"/var/log/zabbix/server.log\"}."
  35957. msgstr ""
  35958. #. type: deftypevr
  35959. #: guix-git/doc/guix.texi:24131
  35960. #, no-wrap
  35961. msgid "{@code{zabbix-server-configuration} parameter} string pid-file"
  35962. msgstr ""
  35963. #. type: deftypevr
  35964. #: guix-git/doc/guix.texi:24133 guix-git/doc/guix.texi:24234
  35965. msgid "Name of PID file."
  35966. msgstr ""
  35967. #. type: deftypevr
  35968. #: guix-git/doc/guix.texi:24135
  35969. msgid "Defaults to @samp{\"/var/run/zabbix/zabbix_server.pid\"}."
  35970. msgstr ""
  35971. #. type: deftypevr
  35972. #: guix-git/doc/guix.texi:24138
  35973. #, no-wrap
  35974. msgid "{@code{zabbix-server-configuration} parameter} string ssl-ca-location"
  35975. msgstr ""
  35976. #. type: deftypevr
  35977. #: guix-git/doc/guix.texi:24141
  35978. msgid "The location of certificate authority (CA) files for SSL server certificate verification."
  35979. msgstr ""
  35980. #. type: deftypevr
  35981. #: guix-git/doc/guix.texi:24143
  35982. msgid "Defaults to @samp{\"/etc/ssl/certs/ca-certificates.crt\"}."
  35983. msgstr ""
  35984. #. type: deftypevr
  35985. #: guix-git/doc/guix.texi:24146
  35986. #, no-wrap
  35987. msgid "{@code{zabbix-server-configuration} parameter} string ssl-cert-location"
  35988. msgstr ""
  35989. #. type: deftypevr
  35990. #: guix-git/doc/guix.texi:24148
  35991. msgid "Location of SSL client certificates."
  35992. msgstr ""
  35993. #. type: deftypevr
  35994. #: guix-git/doc/guix.texi:24150
  35995. msgid "Defaults to @samp{\"/etc/ssl/certs\"}."
  35996. msgstr ""
  35997. #. type: deftypevr
  35998. #: guix-git/doc/guix.texi:24153
  35999. #, no-wrap
  36000. msgid "{@code{zabbix-server-configuration} parameter} string extra-options"
  36001. msgstr ""
  36002. #. type: deftypevr
  36003. #: guix-git/doc/guix.texi:24155 guix-git/doc/guix.texi:24259
  36004. msgid "Extra options will be appended to Zabbix server configuration file."
  36005. msgstr ""
  36006. #. type: deftypevr
  36007. #: guix-git/doc/guix.texi:24160
  36008. #, no-wrap
  36009. msgid "{@code{zabbix-server-configuration} parameter} include-files include-files"
  36010. msgstr ""
  36011. #. type: deftypevr
  36012. #: guix-git/doc/guix.texi:24163 guix-git/doc/guix.texi:24267
  36013. msgid "You may include individual files or all files in a directory in the configuration file."
  36014. msgstr ""
  36015. #. type: subsubheading
  36016. #: guix-git/doc/guix.texi:24170
  36017. #, no-wrap
  36018. msgid "Zabbix agent"
  36019. msgstr ""
  36020. #. type: cindex
  36021. #: guix-git/doc/guix.texi:24171
  36022. #, no-wrap
  36023. msgid "zabbix zabbix-agent"
  36024. msgstr ""
  36025. #. type: Plain text
  36026. #: guix-git/doc/guix.texi:24174
  36027. msgid "Zabbix agent gathers information for Zabbix server."
  36028. msgstr ""
  36029. #. type: Plain text
  36030. #: guix-git/doc/guix.texi:24178
  36031. msgid "Available @code{zabbix-agent-configuration} fields are:"
  36032. msgstr ""
  36033. #. type: deftypevr
  36034. #: guix-git/doc/guix.texi:24179
  36035. #, no-wrap
  36036. msgid "{@code{zabbix-agent-configuration} parameter} package zabbix-agent"
  36037. msgstr ""
  36038. #. type: deftypevr
  36039. #: guix-git/doc/guix.texi:24181
  36040. msgid "The zabbix-agent package."
  36041. msgstr ""
  36042. #. type: deftypevr
  36043. #: guix-git/doc/guix.texi:24184
  36044. #, no-wrap
  36045. msgid "{@code{zabbix-agent-configuration} parameter} string user"
  36046. msgstr ""
  36047. #. type: deftypevr
  36048. #: guix-git/doc/guix.texi:24186
  36049. msgid "User who will run the Zabbix agent."
  36050. msgstr ""
  36051. #. type: deftypevr
  36052. #: guix-git/doc/guix.texi:24191
  36053. #, no-wrap
  36054. msgid "{@code{zabbix-agent-configuration} parameter} group group"
  36055. msgstr ""
  36056. #. type: deftypevr
  36057. #: guix-git/doc/guix.texi:24193
  36058. msgid "Group who will run the Zabbix agent."
  36059. msgstr ""
  36060. #. type: deftypevr
  36061. #: guix-git/doc/guix.texi:24198
  36062. #, no-wrap
  36063. msgid "{@code{zabbix-agent-configuration} parameter} string hostname"
  36064. msgstr ""
  36065. #. type: deftypevr
  36066. #: guix-git/doc/guix.texi:24201
  36067. msgid "Unique, case sensitive hostname which is required for active checks and must match hostname as configured on the server."
  36068. msgstr ""
  36069. #. type: deftypevr
  36070. #: guix-git/doc/guix.texi:24206
  36071. #, no-wrap
  36072. msgid "{@code{zabbix-agent-configuration} parameter} string log-type"
  36073. msgstr ""
  36074. #. type: deftypevr
  36075. #: guix-git/doc/guix.texi:24225
  36076. #, no-wrap
  36077. msgid "{@code{zabbix-agent-configuration} parameter} string log-file"
  36078. msgstr ""
  36079. #. type: deftypevr
  36080. #: guix-git/doc/guix.texi:24229
  36081. msgid "Defaults to @samp{\"/var/log/zabbix/agent.log\"}."
  36082. msgstr ""
  36083. #. type: deftypevr
  36084. #: guix-git/doc/guix.texi:24232
  36085. #, no-wrap
  36086. msgid "{@code{zabbix-agent-configuration} parameter} string pid-file"
  36087. msgstr ""
  36088. #. type: deftypevr
  36089. #: guix-git/doc/guix.texi:24236
  36090. msgid "Defaults to @samp{\"/var/run/zabbix/zabbix_agent.pid\"}."
  36091. msgstr ""
  36092. #. type: deftypevr
  36093. #: guix-git/doc/guix.texi:24239
  36094. #, no-wrap
  36095. msgid "{@code{zabbix-agent-configuration} parameter} list server"
  36096. msgstr ""
  36097. #. type: deftypevr
  36098. #: guix-git/doc/guix.texi:24243
  36099. msgid "List of IP addresses, optionally in CIDR notation, or hostnames of Zabbix servers and Zabbix proxies. Incoming connections will be accepted only from the hosts listed here."
  36100. msgstr ""
  36101. #. type: deftypevr
  36102. #: guix-git/doc/guix.texi:24245 guix-git/doc/guix.texi:24254
  36103. msgid "Defaults to @samp{(\"127.0.0.1\")}."
  36104. msgstr ""
  36105. #. type: deftypevr
  36106. #: guix-git/doc/guix.texi:24248
  36107. #, no-wrap
  36108. msgid "{@code{zabbix-agent-configuration} parameter} list server-active"
  36109. msgstr ""
  36110. #. type: deftypevr
  36111. #: guix-git/doc/guix.texi:24252
  36112. msgid "List of IP:port (or hostname:port) pairs of Zabbix servers and Zabbix proxies for active checks. If port is not specified, default port is used. If this parameter is not specified, active checks are disabled."
  36113. msgstr ""
  36114. #. type: deftypevr
  36115. #: guix-git/doc/guix.texi:24257
  36116. #, no-wrap
  36117. msgid "{@code{zabbix-agent-configuration} parameter} string extra-options"
  36118. msgstr ""
  36119. #. type: deftypevr
  36120. #: guix-git/doc/guix.texi:24264
  36121. #, no-wrap
  36122. msgid "{@code{zabbix-agent-configuration} parameter} include-files include-files"
  36123. msgstr ""
  36124. #. type: subsubheading
  36125. #: guix-git/doc/guix.texi:24274
  36126. #, no-wrap
  36127. msgid "Zabbix front-end"
  36128. msgstr ""
  36129. #. type: cindex
  36130. #: guix-git/doc/guix.texi:24275
  36131. #, no-wrap
  36132. msgid "zabbix zabbix-front-end"
  36133. msgstr ""
  36134. #. type: Plain text
  36135. #: guix-git/doc/guix.texi:24278
  36136. msgid "This service provides a WEB interface to Zabbix server."
  36137. msgstr ""
  36138. #. type: Plain text
  36139. #: guix-git/doc/guix.texi:24282
  36140. msgid "Available @code{zabbix-front-end-configuration} fields are:"
  36141. msgstr ""
  36142. #. type: deftypevr
  36143. #: guix-git/doc/guix.texi:24283
  36144. #, no-wrap
  36145. msgid "{@code{zabbix-front-end-configuration} parameter} nginx-server-configuration-list nginx"
  36146. msgstr ""
  36147. #. type: deftypevr
  36148. #: guix-git/doc/guix.texi:24285 guix-git/doc/guix.texi:30515
  36149. msgid "NGINX configuration."
  36150. msgstr ""
  36151. #. type: deftypevr
  36152. #: guix-git/doc/guix.texi:24288
  36153. #, no-wrap
  36154. msgid "{@code{zabbix-front-end-configuration} parameter} string db-host"
  36155. msgstr ""
  36156. #. type: deftypevr
  36157. #: guix-git/doc/guix.texi:24295
  36158. #, no-wrap
  36159. msgid "{@code{zabbix-front-end-configuration} parameter} number db-port"
  36160. msgstr ""
  36161. #. type: deftypevr
  36162. #: guix-git/doc/guix.texi:24302
  36163. #, no-wrap
  36164. msgid "{@code{zabbix-front-end-configuration} parameter} string db-name"
  36165. msgstr ""
  36166. #. type: deftypevr
  36167. #: guix-git/doc/guix.texi:24309
  36168. #, no-wrap
  36169. msgid "{@code{zabbix-front-end-configuration} parameter} string db-user"
  36170. msgstr ""
  36171. #. type: deftypevr
  36172. #: guix-git/doc/guix.texi:24316
  36173. #, no-wrap
  36174. msgid "{@code{zabbix-front-end-configuration} parameter} string db-password"
  36175. msgstr ""
  36176. #. type: deftypevr
  36177. #: guix-git/doc/guix.texi:24318
  36178. msgid "Database password. Please, use @code{db-secret-file} instead."
  36179. msgstr ""
  36180. #. type: deftypevr
  36181. #: guix-git/doc/guix.texi:24323
  36182. #, no-wrap
  36183. msgid "{@code{zabbix-front-end-configuration} parameter} string db-secret-file"
  36184. msgstr ""
  36185. #. type: deftypevr
  36186. #: guix-git/doc/guix.texi:24328
  36187. msgid "Secret file containing the credentials for the Zabbix front-end. The value must be a local file name, not a G-expression. You are expected to create this file manually. Its contents will be copied into @file{zabbix.conf.php} as the value of @code{$DB['PASSWORD']}."
  36188. msgstr ""
  36189. #. type: deftypevr
  36190. #: guix-git/doc/guix.texi:24333
  36191. #, no-wrap
  36192. msgid "{@code{zabbix-front-end-configuration} parameter} string zabbix-host"
  36193. msgstr ""
  36194. #. type: deftypevr
  36195. #: guix-git/doc/guix.texi:24335
  36196. msgid "Zabbix server hostname."
  36197. msgstr ""
  36198. #. type: deftypevr
  36199. #: guix-git/doc/guix.texi:24340
  36200. #, no-wrap
  36201. msgid "{@code{zabbix-front-end-configuration} parameter} number zabbix-port"
  36202. msgstr ""
  36203. #. type: deftypevr
  36204. #: guix-git/doc/guix.texi:24342
  36205. msgid "Zabbix server port."
  36206. msgstr ""
  36207. #. type: deftypevr
  36208. #: guix-git/doc/guix.texi:24344
  36209. msgid "Defaults to @samp{10051}."
  36210. msgstr ""
  36211. #. type: cindex
  36212. #: guix-git/doc/guix.texi:24352
  36213. #, no-wrap
  36214. msgid "Kerberos"
  36215. msgstr ""
  36216. #. type: Plain text
  36217. #: guix-git/doc/guix.texi:24356
  36218. msgid "The @code{(gnu services kerberos)} module provides services relating to the authentication protocol @dfn{Kerberos}."
  36219. msgstr ""
  36220. #. type: subsubheading
  36221. #: guix-git/doc/guix.texi:24357
  36222. #, no-wrap
  36223. msgid "Krb5 Service"
  36224. msgstr ""
  36225. #. type: Plain text
  36226. #: guix-git/doc/guix.texi:24364
  36227. msgid "Programs using a Kerberos client library normally expect a configuration file in @file{/etc/krb5.conf}. This service generates such a file from a definition provided in the operating system declaration. It does not cause any daemon to be started."
  36228. msgstr ""
  36229. #. type: Plain text
  36230. #: guix-git/doc/guix.texi:24368
  36231. msgid "No ``keytab'' files are provided by this service---you must explicitly create them. This service is known to work with the MIT client library, @code{mit-krb5}. Other implementations have not been tested."
  36232. msgstr ""
  36233. #. type: defvr
  36234. #: guix-git/doc/guix.texi:24369
  36235. #, no-wrap
  36236. msgid "{Scheme Variable} krb5-service-type"
  36237. msgstr ""
  36238. #. type: defvr
  36239. #: guix-git/doc/guix.texi:24371
  36240. msgid "A service type for Kerberos 5 clients."
  36241. msgstr ""
  36242. #. type: Plain text
  36243. #: guix-git/doc/guix.texi:24375
  36244. msgid "Here is an example of its use:"
  36245. msgstr ""
  36246. #. type: lisp
  36247. #: guix-git/doc/guix.texi:24389
  36248. #, no-wrap
  36249. msgid ""
  36250. "(service krb5-service-type\n"
  36251. " (krb5-configuration\n"
  36252. " (default-realm \"EXAMPLE.COM\")\n"
  36253. " (allow-weak-crypto? #t)\n"
  36254. " (realms (list\n"
  36255. " (krb5-realm\n"
  36256. " (name \"EXAMPLE.COM\")\n"
  36257. " (admin-server \"groucho.example.com\")\n"
  36258. " (kdc \"karl.example.com\"))\n"
  36259. " (krb5-realm\n"
  36260. " (name \"ARGRX.EDU\")\n"
  36261. " (admin-server \"kerb-admin.argrx.edu\")\n"
  36262. " (kdc \"keys.argrx.edu\"))))))\n"
  36263. msgstr ""
  36264. #. type: Plain text
  36265. #: guix-git/doc/guix.texi:24393
  36266. msgid "This example provides a Kerberos@tie{}5 client configuration which:"
  36267. msgstr ""
  36268. #. type: item
  36269. #: guix-git/doc/guix.texi:24394
  36270. #, no-wrap
  36271. msgid "Recognizes two realms, @i{viz:} ``EXAMPLE.COM'' and ``ARGRX.EDU'', both"
  36272. msgstr ""
  36273. #. type: itemize
  36274. #: guix-git/doc/guix.texi:24396
  36275. msgid "of which have distinct administration servers and key distribution centers;"
  36276. msgstr ""
  36277. #. type: item
  36278. #: guix-git/doc/guix.texi:24396
  36279. #, no-wrap
  36280. msgid "Will default to the realm ``EXAMPLE.COM'' if the realm is not explicitly"
  36281. msgstr ""
  36282. #. type: itemize
  36283. #: guix-git/doc/guix.texi:24398
  36284. msgid "specified by clients;"
  36285. msgstr ""
  36286. #. type: item
  36287. #: guix-git/doc/guix.texi:24398
  36288. #, no-wrap
  36289. msgid "Accepts services which only support encryption types known to be weak."
  36290. msgstr ""
  36291. #. type: Plain text
  36292. #: guix-git/doc/guix.texi:24406
  36293. msgid "The @code{krb5-realm} and @code{krb5-configuration} types have many fields. Only the most commonly used ones are described here. For a full list, and more detailed explanation of each, see the MIT @uref{https://web.mit.edu/kerberos/krb5-devel/doc/admin/conf_files/krb5_conf.html,,krb5.conf} documentation."
  36294. msgstr ""
  36295. #. type: deftp
  36296. #: guix-git/doc/guix.texi:24408
  36297. #, no-wrap
  36298. msgid "{Data Type} krb5-realm"
  36299. msgstr ""
  36300. #. type: cindex
  36301. #: guix-git/doc/guix.texi:24409
  36302. #, no-wrap
  36303. msgid "realm, kerberos"
  36304. msgstr ""
  36305. #. type: table
  36306. #: guix-git/doc/guix.texi:24415
  36307. msgid "This field is a string identifying the name of the realm. A common convention is to use the fully qualified DNS name of your organization, converted to upper case."
  36308. msgstr ""
  36309. #. type: code{#1}
  36310. #: guix-git/doc/guix.texi:24416
  36311. #, no-wrap
  36312. msgid "admin-server"
  36313. msgstr ""
  36314. #. type: table
  36315. #: guix-git/doc/guix.texi:24419
  36316. msgid "This field is a string identifying the host where the administration server is running."
  36317. msgstr ""
  36318. #. type: code{#1}
  36319. #: guix-git/doc/guix.texi:24420
  36320. #, no-wrap
  36321. msgid "kdc"
  36322. msgstr ""
  36323. #. type: table
  36324. #: guix-git/doc/guix.texi:24423
  36325. msgid "This field is a string identifying the key distribution center for the realm."
  36326. msgstr ""
  36327. #. type: deftp
  36328. #: guix-git/doc/guix.texi:24426
  36329. #, no-wrap
  36330. msgid "{Data Type} krb5-configuration"
  36331. msgstr ""
  36332. #. type: item
  36333. #: guix-git/doc/guix.texi:24429
  36334. #, no-wrap
  36335. msgid "@code{allow-weak-crypto?} (default: @code{#f})"
  36336. msgstr ""
  36337. #. type: table
  36338. #: guix-git/doc/guix.texi:24432
  36339. msgid "If this flag is @code{#t} then services which only offer encryption algorithms known to be weak will be accepted."
  36340. msgstr ""
  36341. #. type: item
  36342. #: guix-git/doc/guix.texi:24433
  36343. #, no-wrap
  36344. msgid "@code{default-realm} (default: @code{#f})"
  36345. msgstr ""
  36346. #. type: table
  36347. #: guix-git/doc/guix.texi:24440
  36348. msgid "This field should be a string identifying the default Kerberos realm for the client. You should set this field to the name of your Kerberos realm. If this value is @code{#f} then a realm must be specified with every Kerberos principal when invoking programs such as @command{kinit}."
  36349. msgstr ""
  36350. #. type: code{#1}
  36351. #: guix-git/doc/guix.texi:24441
  36352. #, no-wrap
  36353. msgid "realms"
  36354. msgstr ""
  36355. #. type: table
  36356. #: guix-git/doc/guix.texi:24446
  36357. msgid "This should be a non-empty list of @code{krb5-realm} objects, which clients may access. Normally, one of them will have a @code{name} field matching the @code{default-realm} field."
  36358. msgstr ""
  36359. #. type: subsubheading
  36360. #: guix-git/doc/guix.texi:24450
  36361. #, no-wrap
  36362. msgid "PAM krb5 Service"
  36363. msgstr ""
  36364. #. type: cindex
  36365. #: guix-git/doc/guix.texi:24451
  36366. #, no-wrap
  36367. msgid "pam-krb5"
  36368. msgstr ""
  36369. #. type: Plain text
  36370. #: guix-git/doc/guix.texi:24457
  36371. msgid "The @code{pam-krb5} service allows for login authentication and password management via Kerberos. You will need this service if you want PAM enabled applications to authenticate users using Kerberos."
  36372. msgstr ""
  36373. #. type: defvr
  36374. #: guix-git/doc/guix.texi:24458
  36375. #, no-wrap
  36376. msgid "{Scheme Variable} pam-krb5-service-type"
  36377. msgstr ""
  36378. #. type: defvr
  36379. #: guix-git/doc/guix.texi:24460
  36380. msgid "A service type for the Kerberos 5 PAM module."
  36381. msgstr ""
  36382. #. type: deftp
  36383. #: guix-git/doc/guix.texi:24462
  36384. #, no-wrap
  36385. msgid "{Data Type} pam-krb5-configuration"
  36386. msgstr ""
  36387. #. type: deftp
  36388. #: guix-git/doc/guix.texi:24465
  36389. msgid "Data type representing the configuration of the Kerberos 5 PAM module. This type has the following parameters:"
  36390. msgstr ""
  36391. #. type: item
  36392. #: guix-git/doc/guix.texi:24466
  36393. #, no-wrap
  36394. msgid "@code{pam-krb5} (default: @code{pam-krb5})"
  36395. msgstr ""
  36396. #. type: table
  36397. #: guix-git/doc/guix.texi:24468
  36398. msgid "The pam-krb5 package to use."
  36399. msgstr ""
  36400. #. type: item
  36401. #: guix-git/doc/guix.texi:24469
  36402. #, no-wrap
  36403. msgid "@code{minimum-uid} (default: @code{1000})"
  36404. msgstr ""
  36405. #. type: table
  36406. #: guix-git/doc/guix.texi:24472
  36407. msgid "The smallest user ID for which Kerberos authentications should be attempted. Local accounts with lower values will silently fail to authenticate."
  36408. msgstr ""
  36409. #. type: cindex
  36410. #: guix-git/doc/guix.texi:24478
  36411. #, no-wrap
  36412. msgid "LDAP"
  36413. msgstr ""
  36414. #. type: cindex
  36415. #: guix-git/doc/guix.texi:24479
  36416. #, no-wrap
  36417. msgid "nslcd, LDAP service"
  36418. msgstr ""
  36419. #. type: Plain text
  36420. #: guix-git/doc/guix.texi:24486
  36421. msgid "The @code{(gnu services authentication)} module provides the @code{nslcd-service-type}, which can be used to authenticate against an LDAP server. In addition to configuring the service itself, you may want to add @code{ldap} as a name service to the Name Service Switch. @xref{Name Service Switch} for detailed information."
  36422. msgstr ""
  36423. #. type: Plain text
  36424. #: guix-git/doc/guix.texi:24490
  36425. msgid "Here is a simple operating system declaration with a default configuration of the @code{nslcd-service-type} and a Name Service Switch configuration that consults the @code{ldap} name service last:"
  36426. msgstr ""
  36427. #. type: lisp
  36428. #: guix-git/doc/guix.texi:24513
  36429. #, no-wrap
  36430. msgid ""
  36431. "(use-service-modules authentication)\n"
  36432. "(use-modules (gnu system nss))\n"
  36433. "...\n"
  36434. "(operating-system\n"
  36435. " ...\n"
  36436. " (services\n"
  36437. " (cons*\n"
  36438. " (service nslcd-service-type)\n"
  36439. " (service dhcp-client-service-type)\n"
  36440. " %base-services))\n"
  36441. " (name-service-switch\n"
  36442. " (let ((services (list (name-service (name \"db\"))\n"
  36443. " (name-service (name \"files\"))\n"
  36444. " (name-service (name \"ldap\")))))\n"
  36445. " (name-service-switch\n"
  36446. " (inherit %mdns-host-lookup-nss)\n"
  36447. " (password services)\n"
  36448. " (shadow services)\n"
  36449. " (group services)\n"
  36450. " (netgroup services)\n"
  36451. " (gshadow services)))))\n"
  36452. msgstr ""
  36453. #. type: Plain text
  36454. #: guix-git/doc/guix.texi:24518
  36455. msgid "Available @code{nslcd-configuration} fields are:"
  36456. msgstr ""
  36457. #. type: deftypevr
  36458. #: guix-git/doc/guix.texi:24519
  36459. #, no-wrap
  36460. msgid "{@code{nslcd-configuration} parameter} package nss-pam-ldapd"
  36461. msgstr ""
  36462. #. type: deftypevr
  36463. #: guix-git/doc/guix.texi:24521
  36464. msgid "The @code{nss-pam-ldapd} package to use."
  36465. msgstr ""
  36466. #. type: deftypevr
  36467. #: guix-git/doc/guix.texi:24524
  36468. #, no-wrap
  36469. msgid "{@code{nslcd-configuration} parameter} maybe-number threads"
  36470. msgstr ""
  36471. #. type: deftypevr
  36472. #: guix-git/doc/guix.texi:24528
  36473. msgid "The number of threads to start that can handle requests and perform LDAP queries. Each thread opens a separate connection to the LDAP server. The default is to start 5 threads."
  36474. msgstr ""
  36475. #. type: deftypevr
  36476. #: guix-git/doc/guix.texi:24533
  36477. #, no-wrap
  36478. msgid "{@code{nslcd-configuration} parameter} string uid"
  36479. msgstr ""
  36480. #. type: deftypevr
  36481. #: guix-git/doc/guix.texi:24535
  36482. msgid "This specifies the user id with which the daemon should be run."
  36483. msgstr ""
  36484. #. type: deftypevr
  36485. #: guix-git/doc/guix.texi:24537 guix-git/doc/guix.texi:24544
  36486. msgid "Defaults to @samp{\"nslcd\"}."
  36487. msgstr ""
  36488. #. type: deftypevr
  36489. #: guix-git/doc/guix.texi:24540
  36490. #, no-wrap
  36491. msgid "{@code{nslcd-configuration} parameter} string gid"
  36492. msgstr ""
  36493. #. type: deftypevr
  36494. #: guix-git/doc/guix.texi:24542
  36495. msgid "This specifies the group id with which the daemon should be run."
  36496. msgstr ""
  36497. #. type: deftypevr
  36498. #: guix-git/doc/guix.texi:24547
  36499. #, no-wrap
  36500. msgid "{@code{nslcd-configuration} parameter} log-option log"
  36501. msgstr ""
  36502. #. type: deftypevr
  36503. #: guix-git/doc/guix.texi:24555
  36504. msgid "This option controls the way logging is done via a list containing SCHEME and LEVEL@. The SCHEME argument may either be the symbols @samp{none} or @samp{syslog}, or an absolute file name. The LEVEL argument is optional and specifies the log level. The log level may be one of the following symbols: @samp{crit}, @samp{error}, @samp{warning}, @samp{notice}, @samp{info} or @samp{debug}. All messages with the specified log level or higher are logged."
  36505. msgstr ""
  36506. #. type: deftypevr
  36507. #: guix-git/doc/guix.texi:24557
  36508. msgid "Defaults to @samp{(\"/var/log/nslcd\" info)}."
  36509. msgstr ""
  36510. #. type: deftypevr
  36511. #: guix-git/doc/guix.texi:24560
  36512. #, no-wrap
  36513. msgid "{@code{nslcd-configuration} parameter} list uri"
  36514. msgstr ""
  36515. #. type: deftypevr
  36516. #: guix-git/doc/guix.texi:24563
  36517. msgid "The list of LDAP server URIs. Normally, only the first server will be used with the following servers as fall-back."
  36518. msgstr ""
  36519. #. type: deftypevr
  36520. #: guix-git/doc/guix.texi:24565
  36521. msgid "Defaults to @samp{(\"ldap://localhost:389/\")}."
  36522. msgstr ""
  36523. #. type: deftypevr
  36524. #: guix-git/doc/guix.texi:24568
  36525. #, no-wrap
  36526. msgid "{@code{nslcd-configuration} parameter} maybe-string ldap-version"
  36527. msgstr ""
  36528. #. type: deftypevr
  36529. #: guix-git/doc/guix.texi:24571
  36530. msgid "The version of the LDAP protocol to use. The default is to use the maximum version supported by the LDAP library."
  36531. msgstr ""
  36532. #. type: deftypevr
  36533. #: guix-git/doc/guix.texi:24576
  36534. #, no-wrap
  36535. msgid "{@code{nslcd-configuration} parameter} maybe-string binddn"
  36536. msgstr ""
  36537. #. type: deftypevr
  36538. #: guix-git/doc/guix.texi:24579
  36539. msgid "Specifies the distinguished name with which to bind to the directory server for lookups. The default is to bind anonymously."
  36540. msgstr ""
  36541. #. type: deftypevr
  36542. #: guix-git/doc/guix.texi:24584
  36543. #, no-wrap
  36544. msgid "{@code{nslcd-configuration} parameter} maybe-string bindpw"
  36545. msgstr ""
  36546. #. type: deftypevr
  36547. #: guix-git/doc/guix.texi:24587
  36548. msgid "Specifies the credentials with which to bind. This option is only applicable when used with binddn."
  36549. msgstr ""
  36550. #. type: deftypevr
  36551. #: guix-git/doc/guix.texi:24592
  36552. #, no-wrap
  36553. msgid "{@code{nslcd-configuration} parameter} maybe-string rootpwmoddn"
  36554. msgstr ""
  36555. #. type: deftypevr
  36556. #: guix-git/doc/guix.texi:24595
  36557. msgid "Specifies the distinguished name to use when the root user tries to modify a user's password using the PAM module."
  36558. msgstr ""
  36559. #. type: deftypevr
  36560. #: guix-git/doc/guix.texi:24600
  36561. #, no-wrap
  36562. msgid "{@code{nslcd-configuration} parameter} maybe-string rootpwmodpw"
  36563. msgstr ""
  36564. #. type: deftypevr
  36565. #: guix-git/doc/guix.texi:24604
  36566. msgid "Specifies the credentials with which to bind if the root user tries to change a user's password. This option is only applicable when used with rootpwmoddn"
  36567. msgstr ""
  36568. #. type: deftypevr
  36569. #: guix-git/doc/guix.texi:24609
  36570. #, no-wrap
  36571. msgid "{@code{nslcd-configuration} parameter} maybe-string sasl-mech"
  36572. msgstr ""
  36573. #. type: deftypevr
  36574. #: guix-git/doc/guix.texi:24612
  36575. msgid "Specifies the SASL mechanism to be used when performing SASL authentication."
  36576. msgstr ""
  36577. #. type: deftypevr
  36578. #: guix-git/doc/guix.texi:24617
  36579. #, no-wrap
  36580. msgid "{@code{nslcd-configuration} parameter} maybe-string sasl-realm"
  36581. msgstr ""
  36582. #. type: deftypevr
  36583. #: guix-git/doc/guix.texi:24619
  36584. msgid "Specifies the SASL realm to be used when performing SASL authentication."
  36585. msgstr ""
  36586. #. type: deftypevr
  36587. #: guix-git/doc/guix.texi:24624
  36588. #, no-wrap
  36589. msgid "{@code{nslcd-configuration} parameter} maybe-string sasl-authcid"
  36590. msgstr ""
  36591. #. type: deftypevr
  36592. #: guix-git/doc/guix.texi:24627
  36593. msgid "Specifies the authentication identity to be used when performing SASL authentication."
  36594. msgstr ""
  36595. #. type: deftypevr
  36596. #: guix-git/doc/guix.texi:24632
  36597. #, no-wrap
  36598. msgid "{@code{nslcd-configuration} parameter} maybe-string sasl-authzid"
  36599. msgstr ""
  36600. #. type: deftypevr
  36601. #: guix-git/doc/guix.texi:24635
  36602. msgid "Specifies the authorization identity to be used when performing SASL authentication."
  36603. msgstr ""
  36604. #. type: deftypevr
  36605. #: guix-git/doc/guix.texi:24640
  36606. #, no-wrap
  36607. msgid "{@code{nslcd-configuration} parameter} maybe-boolean sasl-canonicalize?"
  36608. msgstr ""
  36609. #. type: deftypevr
  36610. #: guix-git/doc/guix.texi:24645
  36611. msgid "Determines whether the LDAP server host name should be canonicalised. If this is enabled the LDAP library will do a reverse host name lookup. By default, it is left up to the LDAP library whether this check is performed or not."
  36612. msgstr ""
  36613. #. type: deftypevr
  36614. #: guix-git/doc/guix.texi:24650
  36615. #, no-wrap
  36616. msgid "{@code{nslcd-configuration} parameter} maybe-string krb5-ccname"
  36617. msgstr ""
  36618. #. type: deftypevr
  36619. #: guix-git/doc/guix.texi:24652
  36620. msgid "Set the name for the GSS-API Kerberos credentials cache."
  36621. msgstr ""
  36622. #. type: deftypevr
  36623. #: guix-git/doc/guix.texi:24657
  36624. #, no-wrap
  36625. msgid "{@code{nslcd-configuration} parameter} string base"
  36626. msgstr ""
  36627. #. type: deftypevr
  36628. #: guix-git/doc/guix.texi:24659
  36629. msgid "The directory search base."
  36630. msgstr ""
  36631. #. type: deftypevr
  36632. #: guix-git/doc/guix.texi:24661
  36633. msgid "Defaults to @samp{\"dc=example,dc=com\"}."
  36634. msgstr ""
  36635. #. type: deftypevr
  36636. #: guix-git/doc/guix.texi:24664
  36637. #, no-wrap
  36638. msgid "{@code{nslcd-configuration} parameter} scope-option scope"
  36639. msgstr ""
  36640. #. type: deftypevr
  36641. #: guix-git/doc/guix.texi:24668
  36642. msgid "Specifies the search scope (subtree, onelevel, base or children). The default scope is subtree; base scope is almost never useful for name service lookups; children scope is not supported on all servers."
  36643. msgstr ""
  36644. #. type: deftypevr
  36645. #: guix-git/doc/guix.texi:24670
  36646. msgid "Defaults to @samp{(subtree)}."
  36647. msgstr ""
  36648. #. type: deftypevr
  36649. #: guix-git/doc/guix.texi:24673
  36650. #, no-wrap
  36651. msgid "{@code{nslcd-configuration} parameter} maybe-deref-option deref"
  36652. msgstr ""
  36653. #. type: deftypevr
  36654. #: guix-git/doc/guix.texi:24676
  36655. msgid "Specifies the policy for dereferencing aliases. The default policy is to never dereference aliases."
  36656. msgstr ""
  36657. #. type: deftypevr
  36658. #: guix-git/doc/guix.texi:24681
  36659. #, no-wrap
  36660. msgid "{@code{nslcd-configuration} parameter} maybe-boolean referrals"
  36661. msgstr ""
  36662. #. type: deftypevr
  36663. #: guix-git/doc/guix.texi:24684
  36664. msgid "Specifies whether automatic referral chasing should be enabled. The default behaviour is to chase referrals."
  36665. msgstr ""
  36666. #. type: deftypevr
  36667. #: guix-git/doc/guix.texi:24689
  36668. #, no-wrap
  36669. msgid "{@code{nslcd-configuration} parameter} list-of-map-entries maps"
  36670. msgstr ""
  36671. #. type: deftypevr
  36672. #: guix-git/doc/guix.texi:24694
  36673. msgid "This option allows for custom attributes to be looked up instead of the default RFC 2307 attributes. It is a list of maps, each consisting of the name of a map, the RFC 2307 attribute to match and the query expression for the attribute as it is available in the directory."
  36674. msgstr ""
  36675. #. type: deftypevr
  36676. #: guix-git/doc/guix.texi:24699
  36677. #, no-wrap
  36678. msgid "{@code{nslcd-configuration} parameter} list-of-filter-entries filters"
  36679. msgstr ""
  36680. #. type: deftypevr
  36681. #: guix-git/doc/guix.texi:24702
  36682. msgid "A list of filters consisting of the name of a map to which the filter applies and an LDAP search filter expression."
  36683. msgstr ""
  36684. #. type: deftypevr
  36685. #: guix-git/doc/guix.texi:24707
  36686. #, no-wrap
  36687. msgid "{@code{nslcd-configuration} parameter} maybe-number bind-timelimit"
  36688. msgstr ""
  36689. #. type: deftypevr
  36690. #: guix-git/doc/guix.texi:24710
  36691. msgid "Specifies the time limit in seconds to use when connecting to the directory server. The default value is 10 seconds."
  36692. msgstr ""
  36693. #. type: deftypevr
  36694. #: guix-git/doc/guix.texi:24715
  36695. #, no-wrap
  36696. msgid "{@code{nslcd-configuration} parameter} maybe-number timelimit"
  36697. msgstr ""
  36698. #. type: deftypevr
  36699. #: guix-git/doc/guix.texi:24719
  36700. msgid "Specifies the time limit (in seconds) to wait for a response from the LDAP server. A value of zero, which is the default, is to wait indefinitely for searches to be completed."
  36701. msgstr ""
  36702. #. type: deftypevr
  36703. #: guix-git/doc/guix.texi:24724
  36704. #, no-wrap
  36705. msgid "{@code{nslcd-configuration} parameter} maybe-number idle-timelimit"
  36706. msgstr ""
  36707. #. type: deftypevr
  36708. #: guix-git/doc/guix.texi:24728
  36709. msgid "Specifies the period if inactivity (in seconds) after which the con‐ nection to the LDAP server will be closed. The default is not to time out connections."
  36710. msgstr ""
  36711. #. type: deftypevr
  36712. #: guix-git/doc/guix.texi:24733
  36713. #, no-wrap
  36714. msgid "{@code{nslcd-configuration} parameter} maybe-number reconnect-sleeptime"
  36715. msgstr ""
  36716. #. type: deftypevr
  36717. #: guix-git/doc/guix.texi:24737
  36718. msgid "Specifies the number of seconds to sleep when connecting to all LDAP servers fails. By default one second is waited between the first failure and the first retry."
  36719. msgstr ""
  36720. #. type: deftypevr
  36721. #: guix-git/doc/guix.texi:24742
  36722. #, no-wrap
  36723. msgid "{@code{nslcd-configuration} parameter} maybe-number reconnect-retrytime"
  36724. msgstr ""
  36725. #. type: deftypevr
  36726. #: guix-git/doc/guix.texi:24746
  36727. msgid "Specifies the time after which the LDAP server is considered to be permanently unavailable. Once this time is reached retries will be done only once per this time period. The default value is 10 seconds."
  36728. msgstr ""
  36729. #. type: deftypevr
  36730. #: guix-git/doc/guix.texi:24751
  36731. #, no-wrap
  36732. msgid "{@code{nslcd-configuration} parameter} maybe-ssl-option ssl"
  36733. msgstr ""
  36734. #. type: deftypevr
  36735. #: guix-git/doc/guix.texi:24755
  36736. msgid "Specifies whether to use SSL/TLS or not (the default is not to). If 'start-tls is specified then StartTLS is used rather than raw LDAP over SSL."
  36737. msgstr ""
  36738. #. type: deftypevr
  36739. #: guix-git/doc/guix.texi:24760
  36740. #, no-wrap
  36741. msgid "{@code{nslcd-configuration} parameter} maybe-tls-reqcert-option tls-reqcert"
  36742. msgstr ""
  36743. #. type: deftypevr
  36744. #: guix-git/doc/guix.texi:24763
  36745. msgid "Specifies what checks to perform on a server-supplied certificate. The meaning of the values is described in the ldap.conf(5) manual page."
  36746. msgstr ""
  36747. #. type: deftypevr
  36748. #: guix-git/doc/guix.texi:24768
  36749. #, no-wrap
  36750. msgid "{@code{nslcd-configuration} parameter} maybe-string tls-cacertdir"
  36751. msgstr ""
  36752. #. type: deftypevr
  36753. #: guix-git/doc/guix.texi:24771
  36754. msgid "Specifies the directory containing X.509 certificates for peer authen‐ tication. This parameter is ignored when using GnuTLS."
  36755. msgstr ""
  36756. #. type: deftypevr
  36757. #: guix-git/doc/guix.texi:24776
  36758. #, no-wrap
  36759. msgid "{@code{nslcd-configuration} parameter} maybe-string tls-cacertfile"
  36760. msgstr ""
  36761. #. type: deftypevr
  36762. #: guix-git/doc/guix.texi:24778
  36763. msgid "Specifies the path to the X.509 certificate for peer authentication."
  36764. msgstr ""
  36765. #. type: deftypevr
  36766. #: guix-git/doc/guix.texi:24783
  36767. #, no-wrap
  36768. msgid "{@code{nslcd-configuration} parameter} maybe-string tls-randfile"
  36769. msgstr ""
  36770. #. type: deftypevr
  36771. #: guix-git/doc/guix.texi:24786
  36772. msgid "Specifies the path to an entropy source. This parameter is ignored when using GnuTLS."
  36773. msgstr ""
  36774. #. type: deftypevr
  36775. #: guix-git/doc/guix.texi:24791
  36776. #, no-wrap
  36777. msgid "{@code{nslcd-configuration} parameter} maybe-string tls-ciphers"
  36778. msgstr ""
  36779. #. type: deftypevr
  36780. #: guix-git/doc/guix.texi:24793
  36781. msgid "Specifies the ciphers to use for TLS as a string."
  36782. msgstr ""
  36783. #. type: deftypevr
  36784. #: guix-git/doc/guix.texi:24798
  36785. #, no-wrap
  36786. msgid "{@code{nslcd-configuration} parameter} maybe-string tls-cert"
  36787. msgstr ""
  36788. #. type: deftypevr
  36789. #: guix-git/doc/guix.texi:24801
  36790. msgid "Specifies the path to the file containing the local certificate for client TLS authentication."
  36791. msgstr ""
  36792. #. type: deftypevr
  36793. #: guix-git/doc/guix.texi:24806
  36794. #, no-wrap
  36795. msgid "{@code{nslcd-configuration} parameter} maybe-string tls-key"
  36796. msgstr ""
  36797. #. type: deftypevr
  36798. #: guix-git/doc/guix.texi:24809
  36799. msgid "Specifies the path to the file containing the private key for client TLS authentication."
  36800. msgstr ""
  36801. #. type: deftypevr
  36802. #: guix-git/doc/guix.texi:24814
  36803. #, no-wrap
  36804. msgid "{@code{nslcd-configuration} parameter} maybe-number pagesize"
  36805. msgstr ""
  36806. #. type: deftypevr
  36807. #: guix-git/doc/guix.texi:24818
  36808. msgid "Set this to a number greater than 0 to request paged results from the LDAP server in accordance with RFC2696. The default (0) is to not request paged results."
  36809. msgstr ""
  36810. #. type: deftypevr
  36811. #: guix-git/doc/guix.texi:24823
  36812. #, no-wrap
  36813. msgid "{@code{nslcd-configuration} parameter} maybe-ignore-users-option nss-initgroups-ignoreusers"
  36814. msgstr ""
  36815. #. type: deftypevr
  36816. #: guix-git/doc/guix.texi:24827
  36817. msgid "This option prevents group membership lookups through LDAP for the specified users. Alternatively, the value 'all-local may be used. With that value nslcd builds a full list of non-LDAP users on startup."
  36818. msgstr ""
  36819. #. type: deftypevr
  36820. #: guix-git/doc/guix.texi:24832
  36821. #, no-wrap
  36822. msgid "{@code{nslcd-configuration} parameter} maybe-number nss-min-uid"
  36823. msgstr ""
  36824. #. type: deftypevr
  36825. #: guix-git/doc/guix.texi:24835
  36826. msgid "This option ensures that LDAP users with a numeric user id lower than the specified value are ignored."
  36827. msgstr ""
  36828. #. type: deftypevr
  36829. #: guix-git/doc/guix.texi:24840
  36830. #, no-wrap
  36831. msgid "{@code{nslcd-configuration} parameter} maybe-number nss-uid-offset"
  36832. msgstr ""
  36833. #. type: deftypevr
  36834. #: guix-git/doc/guix.texi:24843
  36835. msgid "This option specifies an offset that is added to all LDAP numeric user ids. This can be used to avoid user id collisions with local users."
  36836. msgstr ""
  36837. #. type: deftypevr
  36838. #: guix-git/doc/guix.texi:24848
  36839. #, no-wrap
  36840. msgid "{@code{nslcd-configuration} parameter} maybe-number nss-gid-offset"
  36841. msgstr ""
  36842. #. type: deftypevr
  36843. #: guix-git/doc/guix.texi:24851
  36844. msgid "This option specifies an offset that is added to all LDAP numeric group ids. This can be used to avoid user id collisions with local groups."
  36845. msgstr ""
  36846. #. type: deftypevr
  36847. #: guix-git/doc/guix.texi:24856
  36848. #, no-wrap
  36849. msgid "{@code{nslcd-configuration} parameter} maybe-boolean nss-nested-groups"
  36850. msgstr ""
  36851. #. type: deftypevr
  36852. #: guix-git/doc/guix.texi:24862
  36853. msgid "If this option is set, the member attribute of a group may point to another group. Members of nested groups are also returned in the higher level group and parent groups are returned when finding groups for a specific user. The default is not to perform extra searches for nested groups."
  36854. msgstr ""
  36855. #. type: deftypevr
  36856. #: guix-git/doc/guix.texi:24867
  36857. #, no-wrap
  36858. msgid "{@code{nslcd-configuration} parameter} maybe-boolean nss-getgrent-skipmembers"
  36859. msgstr ""
  36860. #. type: deftypevr
  36861. #: guix-git/doc/guix.texi:24872
  36862. msgid "If this option is set, the group member list is not retrieved when looking up groups. Lookups for finding which groups a user belongs to will remain functional so the user will likely still get the correct groups assigned on login."
  36863. msgstr ""
  36864. #. type: deftypevr
  36865. #: guix-git/doc/guix.texi:24877
  36866. #, no-wrap
  36867. msgid "{@code{nslcd-configuration} parameter} maybe-boolean nss-disable-enumeration"
  36868. msgstr ""
  36869. #. type: deftypevr
  36870. #: guix-git/doc/guix.texi:24883
  36871. msgid "If this option is set, functions which cause all user/group entries to be loaded from the directory will not succeed in doing so. This can dramatically reduce LDAP server load in situations where there are a great number of users and/or groups. This option is not recommended for most configurations."
  36872. msgstr ""
  36873. #. type: deftypevr
  36874. #: guix-git/doc/guix.texi:24888
  36875. #, no-wrap
  36876. msgid "{@code{nslcd-configuration} parameter} maybe-string validnames"
  36877. msgstr ""
  36878. #. type: deftypevr
  36879. #: guix-git/doc/guix.texi:24892
  36880. msgid "This option can be used to specify how user and group names are verified within the system. This pattern is used to check all user and group names that are requested and returned from LDAP."
  36881. msgstr ""
  36882. #. type: deftypevr
  36883. #: guix-git/doc/guix.texi:24897
  36884. #, no-wrap
  36885. msgid "{@code{nslcd-configuration} parameter} maybe-boolean ignorecase"
  36886. msgstr ""
  36887. #. type: deftypevr
  36888. #: guix-git/doc/guix.texi:24902
  36889. msgid "This specifies whether or not to perform searches using case-insensitive matching. Enabling this could open up the system to authorization bypass vulnerabilities and introduce nscd cache poisoning vulnerabilities which allow denial of service."
  36890. msgstr ""
  36891. #. type: deftypevr
  36892. #: guix-git/doc/guix.texi:24907
  36893. #, no-wrap
  36894. msgid "{@code{nslcd-configuration} parameter} maybe-boolean pam-authc-ppolicy"
  36895. msgstr ""
  36896. #. type: deftypevr
  36897. #: guix-git/doc/guix.texi:24910
  36898. msgid "This option specifies whether password policy controls are requested and handled from the LDAP server when performing user authentication."
  36899. msgstr ""
  36900. #. type: deftypevr
  36901. #: guix-git/doc/guix.texi:24915
  36902. #, no-wrap
  36903. msgid "{@code{nslcd-configuration} parameter} maybe-string pam-authc-search"
  36904. msgstr ""
  36905. #. type: deftypevr
  36906. #: guix-git/doc/guix.texi:24921
  36907. msgid "By default nslcd performs an LDAP search with the user's credentials after BIND (authentication) to ensure that the BIND operation was successful. The default search is a simple check to see if the user's DN exists. A search filter can be specified that will be used instead. It should return at least one entry."
  36908. msgstr ""
  36909. #. type: deftypevr
  36910. #: guix-git/doc/guix.texi:24926
  36911. #, no-wrap
  36912. msgid "{@code{nslcd-configuration} parameter} maybe-string pam-authz-search"
  36913. msgstr ""
  36914. #. type: deftypevr
  36915. #: guix-git/doc/guix.texi:24930
  36916. msgid "This option allows flexible fine tuning of the authorisation check that should be performed. The search filter specified is executed and if any entries match, access is granted, otherwise access is denied."
  36917. msgstr ""
  36918. #. type: deftypevr
  36919. #: guix-git/doc/guix.texi:24935
  36920. #, no-wrap
  36921. msgid "{@code{nslcd-configuration} parameter} maybe-string pam-password-prohibit-message"
  36922. msgstr ""
  36923. #. type: deftypevr
  36924. #: guix-git/doc/guix.texi:24940
  36925. msgid "If this option is set password modification using pam_ldap will be denied and the specified message will be presented to the user instead. The message can be used to direct the user to an alternative means of changing their password."
  36926. msgstr ""
  36927. #. type: deftypevr
  36928. #: guix-git/doc/guix.texi:24945
  36929. #, no-wrap
  36930. msgid "{@code{nslcd-configuration} parameter} list pam-services"
  36931. msgstr ""
  36932. #. type: deftypevr
  36933. #: guix-git/doc/guix.texi:24947
  36934. msgid "List of pam service names for which LDAP authentication should suffice."
  36935. msgstr ""
  36936. #. type: cindex
  36937. #: guix-git/doc/guix.texi:24958
  36938. #, no-wrap
  36939. msgid "web"
  36940. msgstr ""
  36941. #. type: cindex
  36942. #: guix-git/doc/guix.texi:24959
  36943. #, no-wrap
  36944. msgid "www"
  36945. msgstr ""
  36946. #. type: cindex
  36947. #: guix-git/doc/guix.texi:24960
  36948. #, no-wrap
  36949. msgid "HTTP"
  36950. msgstr ""
  36951. #. type: Plain text
  36952. #: guix-git/doc/guix.texi:24963
  36953. msgid "The @code{(gnu services web)} module provides the Apache HTTP Server, the nginx web server, and also a fastcgi wrapper daemon."
  36954. msgstr ""
  36955. #. type: subsubheading
  36956. #: guix-git/doc/guix.texi:24964
  36957. #, no-wrap
  36958. msgid "Apache HTTP Server"
  36959. msgstr ""
  36960. #. type: deffn
  36961. #: guix-git/doc/guix.texi:24966
  36962. #, no-wrap
  36963. msgid "{Scheme Variable} httpd-service-type"
  36964. msgstr ""
  36965. #. type: deffn
  36966. #: guix-git/doc/guix.texi:24970
  36967. msgid "Service type for the @uref{https://httpd.apache.org/,Apache HTTP} server (@dfn{httpd}). The value for this service type is a @code{httpd-configuration} record."
  36968. msgstr ""
  36969. #. type: deffn
  36970. #: guix-git/doc/guix.texi:24972 guix-git/doc/guix.texi:25153
  36971. msgid "A simple example configuration is given below."
  36972. msgstr ""
  36973. #. type: lisp
  36974. #: guix-git/doc/guix.texi:24980
  36975. #, no-wrap
  36976. msgid ""
  36977. "(service httpd-service-type\n"
  36978. " (httpd-configuration\n"
  36979. " (config\n"
  36980. " (httpd-config-file\n"
  36981. " (server-name \"www.example.com\")\n"
  36982. " (document-root \"/srv/http/www.example.com\")))))\n"
  36983. msgstr ""
  36984. #. type: deffn
  36985. #: guix-git/doc/guix.texi:24984
  36986. msgid "Other services can also extend the @code{httpd-service-type} to add to the configuration."
  36987. msgstr ""
  36988. #. type: lisp
  36989. #: guix-git/doc/guix.texi:24993 guix-git/doc/guix.texi:25133
  36990. #, no-wrap
  36991. msgid ""
  36992. "(simple-service 'www.example.com-server httpd-service-type\n"
  36993. " (list\n"
  36994. " (httpd-virtualhost\n"
  36995. " \"*:80\"\n"
  36996. " (list (string-join '(\"ServerName www.example.com\"\n"
  36997. " \"DocumentRoot /srv/http/www.example.com\")\n"
  36998. " \"\\n\")))))\n"
  36999. msgstr ""
  37000. #. type: Plain text
  37001. #: guix-git/doc/guix.texi:24999
  37002. msgid "The details for the @code{httpd-configuration}, @code{httpd-module}, @code{httpd-config-file} and @code{httpd-virtualhost} record types are given below."
  37003. msgstr ""
  37004. #. type: deffn
  37005. #: guix-git/doc/guix.texi:25000
  37006. #, no-wrap
  37007. msgid "{Data Type} httpd-configuration"
  37008. msgstr ""
  37009. #. type: deffn
  37010. #: guix-git/doc/guix.texi:25002
  37011. msgid "This data type represents the configuration for the httpd service."
  37012. msgstr ""
  37013. #. type: item
  37014. #: guix-git/doc/guix.texi:25004
  37015. #, no-wrap
  37016. msgid "@code{package} (default: @code{httpd})"
  37017. msgstr ""
  37018. #. type: table
  37019. #: guix-git/doc/guix.texi:25006
  37020. msgid "The httpd package to use."
  37021. msgstr ""
  37022. #. type: item
  37023. #: guix-git/doc/guix.texi:25007 guix-git/doc/guix.texi:25096
  37024. #, no-wrap
  37025. msgid "@code{pid-file} (default: @code{\"/var/run/httpd\"})"
  37026. msgstr ""
  37027. #. type: table
  37028. #: guix-git/doc/guix.texi:25009
  37029. msgid "The pid file used by the shepherd-service."
  37030. msgstr ""
  37031. #. type: item
  37032. #: guix-git/doc/guix.texi:25010
  37033. #, no-wrap
  37034. msgid "@code{config} (default: @code{(httpd-config-file)})"
  37035. msgstr ""
  37036. #. type: table
  37037. #: guix-git/doc/guix.texi:25015
  37038. msgid "The configuration file to use with the httpd service. The default value is a @code{httpd-config-file} record, but this can also be a different G-expression that generates a file, for example a @code{plain-file}. A file outside of the store can also be specified through a string."
  37039. msgstr ""
  37040. #. type: deffn
  37041. #: guix-git/doc/guix.texi:25019
  37042. #, no-wrap
  37043. msgid "{Data Type} httpd-module"
  37044. msgstr ""
  37045. #. type: deffn
  37046. #: guix-git/doc/guix.texi:25021
  37047. msgid "This data type represents a module for the httpd service."
  37048. msgstr ""
  37049. #. type: table
  37050. #: guix-git/doc/guix.texi:25025
  37051. msgid "The name of the module."
  37052. msgstr ""
  37053. #. type: table
  37054. #: guix-git/doc/guix.texi:25031
  37055. msgid "The file for the module. This can be relative to the httpd package being used, the absolute location of a file, or a G-expression for a file within the store, for example @code{(file-append mod-wsgi \"/modules/mod_wsgi.so\")}."
  37056. msgstr ""
  37057. #. type: defvr
  37058. #: guix-git/doc/guix.texi:25035
  37059. #, no-wrap
  37060. msgid "{Scheme Variable} %default-httpd-modules"
  37061. msgstr ""
  37062. #. type: defvr
  37063. #: guix-git/doc/guix.texi:25037
  37064. msgid "A default list of @code{httpd-module} objects."
  37065. msgstr ""
  37066. #. type: deffn
  37067. #: guix-git/doc/guix.texi:25039
  37068. #, no-wrap
  37069. msgid "{Data Type} httpd-config-file"
  37070. msgstr ""
  37071. #. type: deffn
  37072. #: guix-git/doc/guix.texi:25041
  37073. msgid "This data type represents a configuration file for the httpd service."
  37074. msgstr ""
  37075. #. type: item
  37076. #: guix-git/doc/guix.texi:25043
  37077. #, no-wrap
  37078. msgid "@code{modules} (default: @code{%default-httpd-modules})"
  37079. msgstr ""
  37080. #. type: table
  37081. #: guix-git/doc/guix.texi:25046
  37082. msgid "The modules to load. Additional modules can be added here, or loaded by additional configuration."
  37083. msgstr ""
  37084. #. type: table
  37085. #: guix-git/doc/guix.texi:25049
  37086. msgid "For example, in order to handle requests for PHP files, you can use Apache’s @code{mod_proxy_fcgi} module along with @code{php-fpm-service-type}:"
  37087. msgstr ""
  37088. #. type: lisp
  37089. #: guix-git/doc/guix.texi:25071
  37090. #, no-wrap
  37091. msgid ""
  37092. "(service httpd-service-type\n"
  37093. " (httpd-configuration\n"
  37094. " (config\n"
  37095. " (httpd-config-file\n"
  37096. " (modules (cons*\n"
  37097. " (httpd-module\n"
  37098. " (name \"proxy_module\")\n"
  37099. " (file \"modules/mod_proxy.so\"))\n"
  37100. " (httpd-module\n"
  37101. " (name \"proxy_fcgi_module\")\n"
  37102. " (file \"modules/mod_proxy_fcgi.so\"))\n"
  37103. " %default-httpd-modules))\n"
  37104. " (extra-config (list \"\\\n"
  37105. "<FilesMatch \\\\.php$>\n"
  37106. " SetHandler \\\"proxy:unix:/var/run/php-fpm.sock|fcgi://localhost/\\\"\n"
  37107. "</FilesMatch>\"))))))\n"
  37108. "(service php-fpm-service-type\n"
  37109. " (php-fpm-configuration\n"
  37110. " (socket \"/var/run/php-fpm.sock\")\n"
  37111. " (socket-group \"httpd\")))\n"
  37112. msgstr ""
  37113. #. type: item
  37114. #: guix-git/doc/guix.texi:25073
  37115. #, no-wrap
  37116. msgid "@code{server-root} (default: @code{httpd})"
  37117. msgstr ""
  37118. #. type: table
  37119. #: guix-git/doc/guix.texi:25077
  37120. msgid "The @code{ServerRoot} in the configuration file, defaults to the httpd package. Directives including @code{Include} and @code{LoadModule} are taken as relative to the server root."
  37121. msgstr ""
  37122. #. type: item
  37123. #: guix-git/doc/guix.texi:25078
  37124. #, no-wrap
  37125. msgid "@code{server-name} (default: @code{#f})"
  37126. msgstr ""
  37127. #. type: table
  37128. #: guix-git/doc/guix.texi:25082
  37129. msgid "The @code{ServerName} in the configuration file, used to specify the request scheme, hostname and port that the server uses to identify itself."
  37130. msgstr ""
  37131. #. type: table
  37132. #: guix-git/doc/guix.texi:25086
  37133. msgid "This doesn't need to be set in the server config, and can be specified in virtual hosts. The default is @code{#f} to not specify a @code{ServerName}."
  37134. msgstr ""
  37135. #. type: item
  37136. #: guix-git/doc/guix.texi:25087
  37137. #, no-wrap
  37138. msgid "@code{document-root} (default: @code{\"/srv/http\"})"
  37139. msgstr ""
  37140. #. type: table
  37141. #: guix-git/doc/guix.texi:25089
  37142. msgid "The @code{DocumentRoot} from which files will be served."
  37143. msgstr ""
  37144. #. type: item
  37145. #: guix-git/doc/guix.texi:25090
  37146. #, no-wrap
  37147. msgid "@code{listen} (default: @code{'(\"80\")})"
  37148. msgstr ""
  37149. #. type: table
  37150. #: guix-git/doc/guix.texi:25095
  37151. msgid "The list of values for the @code{Listen} directives in the config file. The value should be a list of strings, when each string can specify the port number to listen on, and optionally the IP address and protocol to use."
  37152. msgstr ""
  37153. #. type: table
  37154. #: guix-git/doc/guix.texi:25100
  37155. msgid "The @code{PidFile} to use. This should match the @code{pid-file} set in the @code{httpd-configuration} so that the Shepherd service is configured correctly."
  37156. msgstr ""
  37157. #. type: item
  37158. #: guix-git/doc/guix.texi:25101
  37159. #, no-wrap
  37160. msgid "@code{error-log} (default: @code{\"/var/log/httpd/error_log\"})"
  37161. msgstr ""
  37162. #. type: table
  37163. #: guix-git/doc/guix.texi:25103
  37164. msgid "The @code{ErrorLog} to which the server will log errors."
  37165. msgstr ""
  37166. #. type: item
  37167. #: guix-git/doc/guix.texi:25104 guix-git/doc/guix.texi:25665
  37168. #, no-wrap
  37169. msgid "@code{user} (default: @code{\"httpd\"})"
  37170. msgstr ""
  37171. #. type: table
  37172. #: guix-git/doc/guix.texi:25106
  37173. msgid "The @code{User} which the server will answer requests as."
  37174. msgstr ""
  37175. #. type: item
  37176. #: guix-git/doc/guix.texi:25107
  37177. #, no-wrap
  37178. msgid "@code{group} (default: @code{\"httpd\"})"
  37179. msgstr ""
  37180. #. type: table
  37181. #: guix-git/doc/guix.texi:25109
  37182. msgid "The @code{Group} which the server will answer requests as."
  37183. msgstr ""
  37184. #. type: item
  37185. #: guix-git/doc/guix.texi:25110
  37186. #, no-wrap
  37187. msgid "@code{extra-config} (default: @code{(list \"TypesConfig etc/httpd/mime.types\")})"
  37188. msgstr ""
  37189. #. type: table
  37190. #: guix-git/doc/guix.texi:25113
  37191. msgid "A flat list of strings and G-expressions which will be added to the end of the configuration file."
  37192. msgstr ""
  37193. #. type: table
  37194. #: guix-git/doc/guix.texi:25116
  37195. msgid "Any values which the service is extended with will be appended to this list."
  37196. msgstr ""
  37197. #. type: deffn
  37198. #: guix-git/doc/guix.texi:25120
  37199. #, no-wrap
  37200. msgid "{Data Type} httpd-virtualhost"
  37201. msgstr ""
  37202. #. type: deffn
  37203. #: guix-git/doc/guix.texi:25122
  37204. msgid "This data type represents a virtualhost configuration block for the httpd service."
  37205. msgstr ""
  37206. #. type: deffn
  37207. #: guix-git/doc/guix.texi:25124
  37208. msgid "These should be added to the extra-config for the httpd-service."
  37209. msgstr ""
  37210. #. type: code{#1}
  37211. #: guix-git/doc/guix.texi:25136
  37212. #, no-wrap
  37213. msgid "addresses-and-ports"
  37214. msgstr ""
  37215. #. type: table
  37216. #: guix-git/doc/guix.texi:25138
  37217. msgid "The addresses and ports for the @code{VirtualHost} directive."
  37218. msgstr ""
  37219. #. type: code{#1}
  37220. #: guix-git/doc/guix.texi:25139
  37221. #, no-wrap
  37222. msgid "contents"
  37223. msgstr ""
  37224. #. type: table
  37225. #: guix-git/doc/guix.texi:25142
  37226. msgid "The contents of the @code{VirtualHost} directive, this should be a list of strings and G-expressions."
  37227. msgstr ""
  37228. #. type: subsubheading
  37229. #: guix-git/doc/guix.texi:25146
  37230. #, no-wrap
  37231. msgid "NGINX"
  37232. msgstr ""
  37233. #. type: deffn
  37234. #: guix-git/doc/guix.texi:25148
  37235. #, no-wrap
  37236. msgid "{Scheme Variable} nginx-service-type"
  37237. msgstr ""
  37238. #. type: deffn
  37239. #: guix-git/doc/guix.texi:25151
  37240. msgid "Service type for the @uref{https://nginx.org/,NGinx} web server. The value for this service type is a @code{<nginx-configuration>} record."
  37241. msgstr ""
  37242. #. type: lisp
  37243. #: guix-git/doc/guix.texi:25161 guix-git/doc/guix.texi:25215
  37244. #, no-wrap
  37245. msgid ""
  37246. "(service nginx-service-type\n"
  37247. " (nginx-configuration\n"
  37248. " (server-blocks\n"
  37249. " (list (nginx-server-configuration\n"
  37250. " (server-name '(\"www.example.com\"))\n"
  37251. " (root \"/srv/http/www.example.com\"))))))\n"
  37252. msgstr ""
  37253. #. type: deffn
  37254. #: guix-git/doc/guix.texi:25166
  37255. msgid "In addition to adding server blocks to the service configuration directly, this service can be extended by other services to add server blocks, as in this example:"
  37256. msgstr ""
  37257. #. type: lisp
  37258. #: guix-git/doc/guix.texi:25172
  37259. #, no-wrap
  37260. msgid ""
  37261. "(simple-service 'my-extra-server nginx-service-type\n"
  37262. " (list (nginx-server-configuration\n"
  37263. " (root \"/srv/http/extra-website\")\n"
  37264. " (try-files (list \"$uri\" \"$uri/index.html\")))))\n"
  37265. msgstr ""
  37266. #. type: Plain text
  37267. #: guix-git/doc/guix.texi:25183
  37268. msgid "At startup, @command{nginx} has not yet read its configuration file, so it uses a default file to log error messages. If it fails to load its configuration file, that is where error messages are logged. After the configuration file is loaded, the default error log file changes as per configuration. In our case, startup error messages can be found in @file{/var/run/nginx/logs/error.log}, and after configuration in @file{/var/log/nginx/error.log}. The second location can be changed with the @var{log-directory} configuration option."
  37269. msgstr ""
  37270. #. type: deffn
  37271. #: guix-git/doc/guix.texi:25184
  37272. #, no-wrap
  37273. msgid "{Data Type} nginx-configuration"
  37274. msgstr ""
  37275. #. type: deffn
  37276. #: guix-git/doc/guix.texi:25188
  37277. msgid "This data type represents the configuration for NGinx. Some configuration can be done through this and the other provided record types, or alternatively, a config file can be provided."
  37278. msgstr ""
  37279. #. type: item
  37280. #: guix-git/doc/guix.texi:25190
  37281. #, no-wrap
  37282. msgid "@code{nginx} (default: @code{nginx})"
  37283. msgstr ""
  37284. #. type: table
  37285. #: guix-git/doc/guix.texi:25192
  37286. msgid "The nginx package to use."
  37287. msgstr ""
  37288. #. type: item
  37289. #: guix-git/doc/guix.texi:25193
  37290. #, no-wrap
  37291. msgid "@code{log-directory} (default: @code{\"/var/log/nginx\"})"
  37292. msgstr ""
  37293. #. type: table
  37294. #: guix-git/doc/guix.texi:25195
  37295. msgid "The directory to which NGinx will write log files."
  37296. msgstr ""
  37297. #. type: item
  37298. #: guix-git/doc/guix.texi:25196
  37299. #, no-wrap
  37300. msgid "@code{run-directory} (default: @code{\"/var/run/nginx\"})"
  37301. msgstr ""
  37302. #. type: table
  37303. #: guix-git/doc/guix.texi:25199
  37304. msgid "The directory in which NGinx will create a pid file, and write temporary files."
  37305. msgstr ""
  37306. #. type: item
  37307. #: guix-git/doc/guix.texi:25200
  37308. #, no-wrap
  37309. msgid "@code{server-blocks} (default: @code{'()})"
  37310. msgstr ""
  37311. #. type: table
  37312. #: guix-git/doc/guix.texi:25204
  37313. msgid "A list of @dfn{server blocks} to create in the generated configuration file, the elements should be of type @code{<nginx-server-configuration>}."
  37314. msgstr ""
  37315. #. type: table
  37316. #: guix-git/doc/guix.texi:25208
  37317. msgid "The following example would setup NGinx to serve @code{www.example.com} from the @code{/srv/http/www.example.com} directory, without using HTTPS."
  37318. msgstr ""
  37319. #. type: item
  37320. #: guix-git/doc/guix.texi:25217
  37321. #, no-wrap
  37322. msgid "@code{upstream-blocks} (default: @code{'()})"
  37323. msgstr ""
  37324. #. type: table
  37325. #: guix-git/doc/guix.texi:25221
  37326. msgid "A list of @dfn{upstream blocks} to create in the generated configuration file, the elements should be of type @code{<nginx-upstream-configuration>}."
  37327. msgstr ""
  37328. #. type: table
  37329. #: guix-git/doc/guix.texi:25228
  37330. msgid "Configuring upstreams through the @code{upstream-blocks} can be useful when combined with @code{locations} in the @code{<nginx-server-configuration>} records. The following example creates a server configuration with one location configuration, that will proxy requests to a upstream configuration, which will handle requests with two servers."
  37331. msgstr ""
  37332. #. type: lisp
  37333. #: guix-git/doc/guix.texi:25247
  37334. #, no-wrap
  37335. msgid ""
  37336. "(service\n"
  37337. " nginx-service-type\n"
  37338. " (nginx-configuration\n"
  37339. " (server-blocks\n"
  37340. " (list (nginx-server-configuration\n"
  37341. " (server-name '(\"www.example.com\"))\n"
  37342. " (root \"/srv/http/www.example.com\")\n"
  37343. " (locations\n"
  37344. " (list\n"
  37345. " (nginx-location-configuration\n"
  37346. " (uri \"/path1\")\n"
  37347. " (body '(\"proxy_pass http://server-proxy;\"))))))))\n"
  37348. " (upstream-blocks\n"
  37349. " (list (nginx-upstream-configuration\n"
  37350. " (name \"server-proxy\")\n"
  37351. " (servers (list \"server1.example.com\"\n"
  37352. " \"server2.example.com\")))))))\n"
  37353. msgstr ""
  37354. #. type: table
  37355. #: guix-git/doc/guix.texi:25255
  37356. msgid "If a configuration @var{file} is provided, this will be used, rather than generating a configuration file from the provided @code{log-directory}, @code{run-directory}, @code{server-blocks} and @code{upstream-blocks}. For proper operation, these arguments should match what is in @var{file} to ensure that the directories are created when the service is activated."
  37357. msgstr ""
  37358. #. type: table
  37359. #: guix-git/doc/guix.texi:25259
  37360. msgid "This can be useful if you have an existing configuration file, or it's not possible to do what is required through the other parts of the nginx-configuration record."
  37361. msgstr ""
  37362. #. type: item
  37363. #: guix-git/doc/guix.texi:25260
  37364. #, no-wrap
  37365. msgid "@code{server-names-hash-bucket-size} (default: @code{#f})"
  37366. msgstr ""
  37367. #. type: table
  37368. #: guix-git/doc/guix.texi:25263
  37369. msgid "Bucket size for the server names hash tables, defaults to @code{#f} to use the size of the processors cache line."
  37370. msgstr ""
  37371. #. type: item
  37372. #: guix-git/doc/guix.texi:25264
  37373. #, no-wrap
  37374. msgid "@code{server-names-hash-bucket-max-size} (default: @code{#f})"
  37375. msgstr ""
  37376. #. type: table
  37377. #: guix-git/doc/guix.texi:25266
  37378. msgid "Maximum bucket size for the server names hash tables."
  37379. msgstr ""
  37380. #. type: table
  37381. #: guix-git/doc/guix.texi:25270
  37382. msgid "List of nginx dynamic modules to load. This should be a list of file names of loadable modules, as in this example:"
  37383. msgstr ""
  37384. #. type: lisp
  37385. #: guix-git/doc/guix.texi:25278
  37386. #, no-wrap
  37387. msgid ""
  37388. "(modules\n"
  37389. " (list\n"
  37390. " (file-append nginx-accept-language-module \"\\\n"
  37391. "/etc/nginx/modules/ngx_http_accept_language_module.so\")\n"
  37392. " (file-append nginx-lua-module \"\\\n"
  37393. "/etc/nginx/modules/ngx_http_lua_module.so\")))\n"
  37394. msgstr ""
  37395. #. type: item
  37396. #: guix-git/doc/guix.texi:25280
  37397. #, no-wrap
  37398. msgid "@code{lua-package-path} (default: @code{'()})"
  37399. msgstr ""
  37400. #. type: table
  37401. #: guix-git/doc/guix.texi:25283
  37402. msgid "List of nginx lua packages to load. This should be a list of package names of loadable lua modules, as in this example:"
  37403. msgstr ""
  37404. #. type: lisp
  37405. #: guix-git/doc/guix.texi:25290
  37406. #, no-wrap
  37407. msgid ""
  37408. "(lua-package-path (list lua-resty-core\n"
  37409. " lua-resty-lrucache\n"
  37410. " lua-resty-signal\n"
  37411. " lua-tablepool\n"
  37412. " lua-resty-shell))\n"
  37413. msgstr ""
  37414. #. type: item
  37415. #: guix-git/doc/guix.texi:25292
  37416. #, no-wrap
  37417. msgid "@code{lua-package-cpath} (default: @code{'()})"
  37418. msgstr ""
  37419. #. type: table
  37420. #: guix-git/doc/guix.texi:25295
  37421. msgid "List of nginx lua C packages to load. This should be a list of package names of loadable lua C modules, as in this example:"
  37422. msgstr ""
  37423. #. type: lisp
  37424. #: guix-git/doc/guix.texi:25298
  37425. #, no-wrap
  37426. msgid "(lua-package-cpath (list lua-resty-signal))\n"
  37427. msgstr ""
  37428. #. type: item
  37429. #: guix-git/doc/guix.texi:25300
  37430. #, no-wrap
  37431. msgid "@code{global-directives} (default: @code{'((events . ()))})"
  37432. msgstr ""
  37433. #. type: table
  37434. #: guix-git/doc/guix.texi:25303
  37435. msgid "Association list of global directives for the top level of the nginx configuration. Values may themselves be association lists."
  37436. msgstr ""
  37437. #. type: lisp
  37438. #: guix-git/doc/guix.texi:25309
  37439. #, no-wrap
  37440. msgid ""
  37441. "(global-directives\n"
  37442. " `((worker_processes . 16)\n"
  37443. " (pcre_jit . on)\n"
  37444. " (events . ((worker_connections . 1024)))))\n"
  37445. msgstr ""
  37446. #. type: table
  37447. #: guix-git/doc/guix.texi:25314
  37448. msgid "Extra content for the @code{http} block. Should be string or a string valued G-expression."
  37449. msgstr ""
  37450. #. type: deftp
  37451. #: guix-git/doc/guix.texi:25318
  37452. #, no-wrap
  37453. msgid "{Data Type} nginx-server-configuration"
  37454. msgstr ""
  37455. #. type: deftp
  37456. #: guix-git/doc/guix.texi:25321
  37457. msgid "Data type representing the configuration of an nginx server block. This type has the following parameters:"
  37458. msgstr ""
  37459. #. type: item
  37460. #: guix-git/doc/guix.texi:25323
  37461. #, no-wrap
  37462. msgid "@code{listen} (default: @code{'(\"80\" \"443 ssl\")})"
  37463. msgstr ""
  37464. #. type: table
  37465. #: guix-git/doc/guix.texi:25328
  37466. msgid "Each @code{listen} directive sets the address and port for IP, or the path for a UNIX-domain socket on which the server will accept requests. Both address and port, or only address or only port can be specified. An address may also be a hostname, for example:"
  37467. msgstr ""
  37468. #. type: lisp
  37469. #: guix-git/doc/guix.texi:25331
  37470. #, no-wrap
  37471. msgid "'(\"127.0.0.1:8000\" \"127.0.0.1\" \"8000\" \"*:8000\" \"localhost:8000\")\n"
  37472. msgstr ""
  37473. #. type: item
  37474. #: guix-git/doc/guix.texi:25333
  37475. #, no-wrap
  37476. msgid "@code{server-name} (default: @code{(list 'default)})"
  37477. msgstr ""
  37478. #. type: table
  37479. #: guix-git/doc/guix.texi:25336
  37480. msgid "A list of server names this server represents. @code{'default} represents the default server for connections matching no other server."
  37481. msgstr ""
  37482. #. type: item
  37483. #: guix-git/doc/guix.texi:25337
  37484. #, no-wrap
  37485. msgid "@code{root} (default: @code{\"/srv/http\"})"
  37486. msgstr ""
  37487. #. type: table
  37488. #: guix-git/doc/guix.texi:25339
  37489. msgid "Root of the website nginx will serve."
  37490. msgstr ""
  37491. #. type: item
  37492. #: guix-git/doc/guix.texi:25340
  37493. #, no-wrap
  37494. msgid "@code{locations} (default: @code{'()})"
  37495. msgstr ""
  37496. #. type: table
  37497. #: guix-git/doc/guix.texi:25344
  37498. msgid "A list of @dfn{nginx-location-configuration} or @dfn{nginx-named-location-configuration} records to use within this server block."
  37499. msgstr ""
  37500. #. type: item
  37501. #: guix-git/doc/guix.texi:25345
  37502. #, no-wrap
  37503. msgid "@code{index} (default: @code{(list \"index.html\")})"
  37504. msgstr ""
  37505. #. type: table
  37506. #: guix-git/doc/guix.texi:25348
  37507. msgid "Index files to look for when clients ask for a directory. If it cannot be found, Nginx will send the list of files in the directory."
  37508. msgstr ""
  37509. #. type: item
  37510. #: guix-git/doc/guix.texi:25349
  37511. #, no-wrap
  37512. msgid "@code{try-files} (default: @code{'()})"
  37513. msgstr ""
  37514. #. type: table
  37515. #: guix-git/doc/guix.texi:25352
  37516. msgid "A list of files whose existence is checked in the specified order. @code{nginx} will use the first file it finds to process the request."
  37517. msgstr ""
  37518. #. type: item
  37519. #: guix-git/doc/guix.texi:25353
  37520. #, no-wrap
  37521. msgid "@code{ssl-certificate} (default: @code{#f})"
  37522. msgstr ""
  37523. #. type: table
  37524. #: guix-git/doc/guix.texi:25356
  37525. msgid "Where to find the certificate for secure connections. Set it to @code{#f} if you don't have a certificate or you don't want to use HTTPS."
  37526. msgstr ""
  37527. #. type: item
  37528. #: guix-git/doc/guix.texi:25357
  37529. #, no-wrap
  37530. msgid "@code{ssl-certificate-key} (default: @code{#f})"
  37531. msgstr ""
  37532. #. type: table
  37533. #: guix-git/doc/guix.texi:25360
  37534. msgid "Where to find the private key for secure connections. Set it to @code{#f} if you don't have a key or you don't want to use HTTPS."
  37535. msgstr ""
  37536. #. type: item
  37537. #: guix-git/doc/guix.texi:25361
  37538. #, no-wrap
  37539. msgid "@code{server-tokens?} (default: @code{#f})"
  37540. msgstr ""
  37541. #. type: table
  37542. #: guix-git/doc/guix.texi:25363
  37543. msgid "Whether the server should add its configuration to response."
  37544. msgstr ""
  37545. #. type: item
  37546. #: guix-git/doc/guix.texi:25364
  37547. #, no-wrap
  37548. msgid "@code{raw-content} (default: @code{'()})"
  37549. msgstr ""
  37550. #. type: table
  37551. #: guix-git/doc/guix.texi:25366
  37552. msgid "A list of raw lines added to the server block."
  37553. msgstr ""
  37554. #. type: deftp
  37555. #: guix-git/doc/guix.texi:25370
  37556. #, no-wrap
  37557. msgid "{Data Type} nginx-upstream-configuration"
  37558. msgstr ""
  37559. #. type: deftp
  37560. #: guix-git/doc/guix.texi:25373
  37561. msgid "Data type representing the configuration of an nginx @code{upstream} block. This type has the following parameters:"
  37562. msgstr ""
  37563. #. type: table
  37564. #: guix-git/doc/guix.texi:25377
  37565. msgid "Name for this group of servers."
  37566. msgstr ""
  37567. #. type: code{#1}
  37568. #: guix-git/doc/guix.texi:25378
  37569. #, no-wrap
  37570. msgid "servers"
  37571. msgstr ""
  37572. #. type: table
  37573. #: guix-git/doc/guix.texi:25385
  37574. msgid "Specify the addresses of the servers in the group. The address can be specified as a IP address (e.g.@: @samp{127.0.0.1}), domain name (e.g.@: @samp{backend1.example.com}) or a path to a UNIX socket using the prefix @samp{unix:}. For addresses using an IP address or domain name, the default port is 80, and a different port can be specified explicitly."
  37575. msgstr ""
  37576. #. type: deftp
  37577. #: guix-git/doc/guix.texi:25389
  37578. #, no-wrap
  37579. msgid "{Data Type} nginx-location-configuration"
  37580. msgstr ""
  37581. #. type: deftp
  37582. #: guix-git/doc/guix.texi:25392
  37583. msgid "Data type representing the configuration of an nginx @code{location} block. This type has the following parameters:"
  37584. msgstr ""
  37585. #. type: table
  37586. #: guix-git/doc/guix.texi:25396
  37587. msgid "URI which this location block matches."
  37588. msgstr ""
  37589. #. type: anchor{#1}
  37590. #: guix-git/doc/guix.texi:25398
  37591. msgid "nginx-location-configuration body"
  37592. msgstr ""
  37593. #. type: code{#1}
  37594. #: guix-git/doc/guix.texi:25398 guix-git/doc/guix.texi:25419
  37595. #, no-wrap
  37596. msgid "body"
  37597. msgstr ""
  37598. #. type: table
  37599. #: guix-git/doc/guix.texi:25405
  37600. msgid "Body of the location block, specified as a list of strings. This can contain many configuration directives. For example, to pass requests to a upstream server group defined using an @code{nginx-upstream-configuration} block, the following directive would be specified in the body @samp{(list \"proxy_pass http://upstream-name;\")}."
  37601. msgstr ""
  37602. #. type: deftp
  37603. #: guix-git/doc/guix.texi:25409
  37604. #, no-wrap
  37605. msgid "{Data Type} nginx-named-location-configuration"
  37606. msgstr ""
  37607. #. type: deftp
  37608. #: guix-git/doc/guix.texi:25414
  37609. msgid "Data type representing the configuration of an nginx named location block. Named location blocks are used for request redirection, and not used for regular request processing. This type has the following parameters:"
  37610. msgstr ""
  37611. #. type: table
  37612. #: guix-git/doc/guix.texi:25418
  37613. msgid "Name to identify this location block."
  37614. msgstr ""
  37615. #. type: table
  37616. #: guix-git/doc/guix.texi:25424
  37617. msgid "@xref{nginx-location-configuration body}, as the body for named location blocks can be used in a similar way to the @code{nginx-location-configuration body}. One restriction is that the body of a named location block cannot contain location blocks."
  37618. msgstr ""
  37619. #. type: subsubheading
  37620. #: guix-git/doc/guix.texi:25428
  37621. #, no-wrap
  37622. msgid "Varnish Cache"
  37623. msgstr ""
  37624. #. type: cindex
  37625. #: guix-git/doc/guix.texi:25429
  37626. #, no-wrap
  37627. msgid "Varnish"
  37628. msgstr ""
  37629. #. type: Plain text
  37630. #: guix-git/doc/guix.texi:25434
  37631. msgid "Varnish is a fast cache server that sits in between web applications and end users. It proxies requests from clients and caches the accessed URLs such that multiple requests for the same resource only creates one request to the back-end."
  37632. msgstr ""
  37633. #. type: defvr
  37634. #: guix-git/doc/guix.texi:25435
  37635. #, no-wrap
  37636. msgid "{Scheme Variable} varnish-service-type"
  37637. msgstr ""
  37638. #. type: defvr
  37639. #: guix-git/doc/guix.texi:25437
  37640. msgid "Service type for the Varnish daemon."
  37641. msgstr ""
  37642. #. type: deftp
  37643. #: guix-git/doc/guix.texi:25439
  37644. #, no-wrap
  37645. msgid "{Data Type} varnish-configuration"
  37646. msgstr ""
  37647. #. type: deftp
  37648. #: guix-git/doc/guix.texi:25442
  37649. msgid "Data type representing the @code{varnish} service configuration. This type has the following parameters:"
  37650. msgstr ""
  37651. #. type: item
  37652. #: guix-git/doc/guix.texi:25444
  37653. #, no-wrap
  37654. msgid "@code{package} (default: @code{varnish})"
  37655. msgstr ""
  37656. #. type: table
  37657. #: guix-git/doc/guix.texi:25446
  37658. msgid "The Varnish package to use."
  37659. msgstr ""
  37660. #. type: item
  37661. #: guix-git/doc/guix.texi:25447
  37662. #, no-wrap
  37663. msgid "@code{name} (default: @code{\"default\"})"
  37664. msgstr ""
  37665. #. type: table
  37666. #: guix-git/doc/guix.texi:25452
  37667. msgid "A name for this Varnish instance. Varnish will create a directory in @file{/var/varnish/} with this name and keep temporary files there. If the name starts with a forward slash, it is interpreted as an absolute directory name."
  37668. msgstr ""
  37669. #. type: table
  37670. #: guix-git/doc/guix.texi:25455
  37671. msgid "Pass the @code{-n} argument to other Varnish programs to connect to the named instance, e.g.@: @command{varnishncsa -n default}."
  37672. msgstr ""
  37673. #. type: item
  37674. #: guix-git/doc/guix.texi:25456
  37675. #, no-wrap
  37676. msgid "@code{backend} (default: @code{\"localhost:8080\"})"
  37677. msgstr ""
  37678. #. type: table
  37679. #: guix-git/doc/guix.texi:25458
  37680. msgid "The backend to use. This option has no effect if @code{vcl} is set."
  37681. msgstr ""
  37682. #. type: item
  37683. #: guix-git/doc/guix.texi:25459
  37684. #, no-wrap
  37685. msgid "@code{vcl} (default: #f)"
  37686. msgstr ""
  37687. #. type: table
  37688. #: guix-git/doc/guix.texi:25464
  37689. msgid "The @dfn{VCL} (Varnish Configuration Language) program to run. If this is @code{#f}, Varnish will proxy @code{backend} using the default configuration. Otherwise this must be a file-like object with valid VCL syntax."
  37690. msgstr ""
  37691. #. type: table
  37692. #: guix-git/doc/guix.texi:25468
  37693. msgid "For example, to mirror @url{https://www.gnu.org,www.gnu.org} with VCL you can do something along these lines:"
  37694. msgstr ""
  37695. #. type: lisp
  37696. #: guix-git/doc/guix.texi:25474
  37697. #, no-wrap
  37698. msgid ""
  37699. "(define %gnu-mirror\n"
  37700. " (plain-file \"gnu.vcl\"\n"
  37701. " \"vcl 4.1;\n"
  37702. "backend gnu @{ .host = \\\"www.gnu.org\\\"; @}\"))\n"
  37703. "\n"
  37704. msgstr ""
  37705. #. type: lisp
  37706. #: guix-git/doc/guix.texi:25482
  37707. #, no-wrap
  37708. msgid ""
  37709. "(operating-system\n"
  37710. " ;; @dots{}\n"
  37711. " (services (cons (service varnish-service-type\n"
  37712. " (varnish-configuration\n"
  37713. " (listen '(\":80\"))\n"
  37714. " (vcl %gnu-mirror)))\n"
  37715. " %base-services)))\n"
  37716. msgstr ""
  37717. #. type: table
  37718. #: guix-git/doc/guix.texi:25486
  37719. msgid "The configuration of an already running Varnish instance can be inspected and changed using the @command{varnishadm} program."
  37720. msgstr ""
  37721. #. type: table
  37722. #: guix-git/doc/guix.texi:25490
  37723. msgid "Consult the @url{https://varnish-cache.org/docs/,Varnish User Guide} and @url{https://book.varnish-software.com/4.0/,Varnish Book} for comprehensive documentation on Varnish and its configuration language."
  37724. msgstr ""
  37725. #. type: item
  37726. #: guix-git/doc/guix.texi:25491
  37727. #, no-wrap
  37728. msgid "@code{listen} (default: @code{'(\"localhost:80\")})"
  37729. msgstr ""
  37730. #. type: table
  37731. #: guix-git/doc/guix.texi:25493
  37732. msgid "List of addresses Varnish will listen on."
  37733. msgstr ""
  37734. #. type: item
  37735. #: guix-git/doc/guix.texi:25494
  37736. #, no-wrap
  37737. msgid "@code{storage} (default: @code{'(\"malloc,128m\")})"
  37738. msgstr ""
  37739. #. type: table
  37740. #: guix-git/doc/guix.texi:25496
  37741. msgid "List of storage backends that will be available in VCL."
  37742. msgstr ""
  37743. #. type: item
  37744. #: guix-git/doc/guix.texi:25497
  37745. #, no-wrap
  37746. msgid "@code{parameters} (default: @code{'()})"
  37747. msgstr ""
  37748. #. type: table
  37749. #: guix-git/doc/guix.texi:25499
  37750. msgid "List of run-time parameters in the form @code{'((\"parameter\" . \"value\"))}."
  37751. msgstr ""
  37752. #. type: table
  37753. #: guix-git/doc/guix.texi:25502
  37754. msgid "Additional arguments to pass to the @command{varnishd} process."
  37755. msgstr ""
  37756. #. type: cindex
  37757. #: guix-git/doc/guix.texi:25506 guix-git/doc/guix.texi:25507
  37758. #, no-wrap
  37759. msgid "Patchwork"
  37760. msgstr ""
  37761. #. type: Plain text
  37762. #: guix-git/doc/guix.texi:25510
  37763. msgid "Patchwork is a patch tracking system. It can collect patches sent to a mailing list, and display them in a web interface."
  37764. msgstr ""
  37765. #. type: defvr
  37766. #: guix-git/doc/guix.texi:25511
  37767. #, no-wrap
  37768. msgid "{Scheme Variable} patchwork-service-type"
  37769. msgstr ""
  37770. #. type: defvr
  37771. #: guix-git/doc/guix.texi:25513
  37772. msgid "Service type for Patchwork."
  37773. msgstr ""
  37774. #. type: Plain text
  37775. #: guix-git/doc/guix.texi:25517
  37776. msgid "The following example is an example of a minimal service for Patchwork, for the @code{patchwork.example.com} domain."
  37777. msgstr ""
  37778. #. type: lisp
  37779. #: guix-git/doc/guix.texi:25537
  37780. #, no-wrap
  37781. msgid ""
  37782. "(service patchwork-service-type\n"
  37783. " (patchwork-configuration\n"
  37784. " (domain \"patchwork.example.com\")\n"
  37785. " (settings-module\n"
  37786. " (patchwork-settings-module\n"
  37787. " (allowed-hosts (list domain))\n"
  37788. " (default-from-email \"patchwork@@patchwork.example.com\")))\n"
  37789. " (getmail-retriever-config\n"
  37790. " (getmail-retriever-configuration\n"
  37791. " (type \"SimpleIMAPSSLRetriever\")\n"
  37792. " (server \"imap.example.com\")\n"
  37793. " (port 993)\n"
  37794. " (username \"patchwork\")\n"
  37795. " (password-command\n"
  37796. " (list (file-append coreutils \"/bin/cat\")\n"
  37797. " \"/etc/getmail-patchwork-imap-password\"))\n"
  37798. " (extra-parameters\n"
  37799. " '((mailboxes . (\"Patches\"))))))))\n"
  37800. "\n"
  37801. msgstr ""
  37802. #. type: Plain text
  37803. #: guix-git/doc/guix.texi:25543
  37804. msgid "There are three records for configuring the Patchwork service. The @code{<patchwork-configuration>} relates to the configuration for Patchwork within the HTTPD service."
  37805. msgstr ""
  37806. #. type: Plain text
  37807. #: guix-git/doc/guix.texi:25547
  37808. msgid "The @code{settings-module} field within the @code{<patchwork-configuration>} record can be populated with the @code{<patchwork-settings-module>} record, which describes a settings module that is generated within the Guix store."
  37809. msgstr ""
  37810. #. type: Plain text
  37811. #: guix-git/doc/guix.texi:25551
  37812. msgid "For the @code{database-configuration} field within the @code{<patchwork-settings-module>}, the @code{<patchwork-database-configuration>} must be used."
  37813. msgstr ""
  37814. #. type: deftp
  37815. #: guix-git/doc/guix.texi:25552
  37816. #, no-wrap
  37817. msgid "{Data Type} patchwork-configuration"
  37818. msgstr ""
  37819. #. type: deftp
  37820. #: guix-git/doc/guix.texi:25555
  37821. msgid "Data type representing the Patchwork service configuration. This type has the following parameters:"
  37822. msgstr ""
  37823. #. type: item
  37824. #: guix-git/doc/guix.texi:25557
  37825. #, no-wrap
  37826. msgid "@code{patchwork} (default: @code{patchwork})"
  37827. msgstr ""
  37828. #. type: table
  37829. #: guix-git/doc/guix.texi:25559
  37830. msgid "The Patchwork package to use."
  37831. msgstr ""
  37832. #. type: code{#1}
  37833. #: guix-git/doc/guix.texi:25560
  37834. #, no-wrap
  37835. msgid "domain"
  37836. msgstr ""
  37837. #. type: table
  37838. #: guix-git/doc/guix.texi:25563
  37839. msgid "The domain to use for Patchwork, this is used in the HTTPD service virtual host."
  37840. msgstr ""
  37841. #. type: code{#1}
  37842. #: guix-git/doc/guix.texi:25564
  37843. #, no-wrap
  37844. msgid "settings-module"
  37845. msgstr ""
  37846. #. type: table
  37847. #: guix-git/doc/guix.texi:25570
  37848. msgid "The settings module to use for Patchwork. As a Django application, Patchwork is configured with a Python module containing the settings. This can either be an instance of the @code{<patchwork-settings-module>} record, any other record that represents the settings in the store, or a directory outside of the store."
  37849. msgstr ""
  37850. #. type: item
  37851. #: guix-git/doc/guix.texi:25571
  37852. #, no-wrap
  37853. msgid "@code{static-path} (default: @code{\"/static/\"})"
  37854. msgstr ""
  37855. #. type: table
  37856. #: guix-git/doc/guix.texi:25573
  37857. msgid "The path under which the HTTPD service should serve the static files."
  37858. msgstr ""
  37859. #. type: code{#1}
  37860. #: guix-git/doc/guix.texi:25574
  37861. #, no-wrap
  37862. msgid "getmail-retriever-config"
  37863. msgstr ""
  37864. #. type: table
  37865. #: guix-git/doc/guix.texi:25578
  37866. msgid "The getmail-retriever-configuration record value to use with Patchwork. Getmail will be configured with this value, the messages will be delivered to Patchwork."
  37867. msgstr ""
  37868. #. type: deftp
  37869. #: guix-git/doc/guix.texi:25582
  37870. #, no-wrap
  37871. msgid "{Data Type} patchwork-settings-module"
  37872. msgstr ""
  37873. #. type: deftp
  37874. #: guix-git/doc/guix.texi:25587
  37875. msgid "Data type representing a settings module for Patchwork. Some of these settings relate directly to Patchwork, but others relate to Django, the web framework used by Patchwork, or the Django Rest Framework library. This type has the following parameters:"
  37876. msgstr ""
  37877. #. type: item
  37878. #: guix-git/doc/guix.texi:25589
  37879. #, no-wrap
  37880. msgid "@code{database-configuration} (default: @code{(patchwork-database-configuration)})"
  37881. msgstr ""
  37882. #. type: table
  37883. #: guix-git/doc/guix.texi:25592
  37884. msgid "The database connection settings used for Patchwork. See the @code{<patchwork-database-configuration>} record type for more information."
  37885. msgstr ""
  37886. #. type: item
  37887. #: guix-git/doc/guix.texi:25593
  37888. #, no-wrap
  37889. msgid "@code{secret-key-file} (default: @code{\"/etc/patchwork/django-secret-key\"})"
  37890. msgstr ""
  37891. #. type: table
  37892. #: guix-git/doc/guix.texi:25596
  37893. msgid "Patchwork, as a Django web application uses a secret key for cryptographically signing values. This file should contain a unique unpredictable value."
  37894. msgstr ""
  37895. #. type: table
  37896. #: guix-git/doc/guix.texi:25599
  37897. msgid "If this file does not exist, it will be created and populated with a random value by the patchwork-setup shepherd service."
  37898. msgstr ""
  37899. #. type: table
  37900. #: guix-git/doc/guix.texi:25601
  37901. msgid "This setting relates to Django."
  37902. msgstr ""
  37903. #. type: code{#1}
  37904. #: guix-git/doc/guix.texi:25602
  37905. #, no-wrap
  37906. msgid "allowed-hosts"
  37907. msgstr ""
  37908. #. type: table
  37909. #: guix-git/doc/guix.texi:25605
  37910. msgid "A list of valid hosts for this Patchwork service. This should at least include the domain specified in the @code{<patchwork-configuration>} record."
  37911. msgstr ""
  37912. #. type: table
  37913. #: guix-git/doc/guix.texi:25607 guix-git/doc/guix.texi:25621
  37914. #: guix-git/doc/guix.texi:25627 guix-git/doc/guix.texi:25633
  37915. msgid "This is a Django setting."
  37916. msgstr ""
  37917. #. type: code{#1}
  37918. #: guix-git/doc/guix.texi:25608
  37919. #, no-wrap
  37920. msgid "default-from-email"
  37921. msgstr ""
  37922. #. type: table
  37923. #: guix-git/doc/guix.texi:25610
  37924. msgid "The email address from which Patchwork should send email by default."
  37925. msgstr ""
  37926. #. type: table
  37927. #: guix-git/doc/guix.texi:25612 guix-git/doc/guix.texi:25638
  37928. #: guix-git/doc/guix.texi:25643 guix-git/doc/guix.texi:25648
  37929. msgid "This is a Patchwork setting."
  37930. msgstr ""
  37931. #. type: item
  37932. #: guix-git/doc/guix.texi:25613
  37933. #, no-wrap
  37934. msgid "@code{static-url} (default: @code{#f})"
  37935. msgstr ""
  37936. #. type: table
  37937. #: guix-git/doc/guix.texi:25616
  37938. msgid "The URL to use when serving static assets. It can be part of a URL, or a full URL, but must end in a @code{/}."
  37939. msgstr ""
  37940. #. type: table
  37941. #: guix-git/doc/guix.texi:25619
  37942. msgid "If the default value is used, the @code{static-path} value from the @code{<patchwork-configuration>} record will be used."
  37943. msgstr ""
  37944. #. type: item
  37945. #: guix-git/doc/guix.texi:25622
  37946. #, no-wrap
  37947. msgid "@code{admins} (default: @code{'()})"
  37948. msgstr ""
  37949. #. type: table
  37950. #: guix-git/doc/guix.texi:25625
  37951. msgid "Email addresses to send the details of errors that occur. Each value should be a list containing two elements, the name and then the email address."
  37952. msgstr ""
  37953. #. type: table
  37954. #: guix-git/doc/guix.texi:25631
  37955. msgid "Whether to run Patchwork in debug mode. If set to @code{#t}, detailed error messages will be shown."
  37956. msgstr ""
  37957. #. type: item
  37958. #: guix-git/doc/guix.texi:25634
  37959. #, no-wrap
  37960. msgid "@code{enable-rest-api?} (default: @code{#t})"
  37961. msgstr ""
  37962. #. type: table
  37963. #: guix-git/doc/guix.texi:25636
  37964. msgid "Whether to enable the Patchwork REST API."
  37965. msgstr ""
  37966. #. type: item
  37967. #: guix-git/doc/guix.texi:25639
  37968. #, no-wrap
  37969. msgid "@code{enable-xmlrpc?} (default: @code{#t})"
  37970. msgstr ""
  37971. #. type: table
  37972. #: guix-git/doc/guix.texi:25641
  37973. msgid "Whether to enable the XML RPC API."
  37974. msgstr ""
  37975. #. type: item
  37976. #: guix-git/doc/guix.texi:25644
  37977. #, no-wrap
  37978. msgid "@code{force-https-links?} (default: @code{#t})"
  37979. msgstr ""
  37980. #. type: table
  37981. #: guix-git/doc/guix.texi:25646
  37982. msgid "Whether to use HTTPS links on Patchwork pages."
  37983. msgstr ""
  37984. #. type: table
  37985. #: guix-git/doc/guix.texi:25651
  37986. msgid "Extra code to place at the end of the Patchwork settings module."
  37987. msgstr ""
  37988. #. type: deftp
  37989. #: guix-git/doc/guix.texi:25655
  37990. #, no-wrap
  37991. msgid "{Data Type} patchwork-database-configuration"
  37992. msgstr ""
  37993. #. type: deftp
  37994. #: guix-git/doc/guix.texi:25657
  37995. msgid "Data type representing the database configuration for Patchwork."
  37996. msgstr ""
  37997. #. type: item
  37998. #: guix-git/doc/guix.texi:25659
  37999. #, no-wrap
  38000. msgid "@code{engine} (default: @code{\"django.db.backends.postgresql_psycopg2\"})"
  38001. msgstr ""
  38002. #. type: table
  38003. #: guix-git/doc/guix.texi:25661
  38004. msgid "The database engine to use."
  38005. msgstr ""
  38006. #. type: item
  38007. #: guix-git/doc/guix.texi:25662
  38008. #, no-wrap
  38009. msgid "@code{name} (default: @code{\"patchwork\"})"
  38010. msgstr ""
  38011. #. type: table
  38012. #: guix-git/doc/guix.texi:25664
  38013. msgid "The name of the database to use."
  38014. msgstr ""
  38015. #. type: table
  38016. #: guix-git/doc/guix.texi:25667
  38017. msgid "The user to connect to the database as."
  38018. msgstr ""
  38019. #. type: item
  38020. #: guix-git/doc/guix.texi:25668
  38021. #, no-wrap
  38022. msgid "@code{password} (default: @code{\"\"})"
  38023. msgstr ""
  38024. #. type: table
  38025. #: guix-git/doc/guix.texi:25670
  38026. msgid "The password to use when connecting to the database."
  38027. msgstr ""
  38028. #. type: item
  38029. #: guix-git/doc/guix.texi:25671
  38030. #, no-wrap
  38031. msgid "@code{host} (default: @code{\"\"})"
  38032. msgstr ""
  38033. #. type: table
  38034. #: guix-git/doc/guix.texi:25673
  38035. msgid "The host to make the database connection to."
  38036. msgstr ""
  38037. #. type: item
  38038. #: guix-git/doc/guix.texi:25674
  38039. #, no-wrap
  38040. msgid "@code{port} (default: @code{\"\"})"
  38041. msgstr ""
  38042. #. type: table
  38043. #: guix-git/doc/guix.texi:25676
  38044. msgid "The port on which to connect to the database."
  38045. msgstr ""
  38046. #. type: subsubheading
  38047. #: guix-git/doc/guix.texi:25680
  38048. #, no-wrap
  38049. msgid "Mumi"
  38050. msgstr ""
  38051. #. type: cindex
  38052. #: guix-git/doc/guix.texi:25682
  38053. #, no-wrap
  38054. msgid "Mumi, Debbugs Web interface"
  38055. msgstr ""
  38056. #. type: cindex
  38057. #: guix-git/doc/guix.texi:25683
  38058. #, no-wrap
  38059. msgid "Debbugs, Mumi Web interface"
  38060. msgstr ""
  38061. #. type: Plain text
  38062. #: guix-git/doc/guix.texi:25688
  38063. msgid "@uref{https://git.elephly.net/gitweb.cgi?p=software/mumi.git, Mumi} is a Web interface to the Debbugs bug tracker, by default for @uref{https://bugs.gnu.org, the GNU instance}. Mumi is a Web server, but it also fetches and indexes mail retrieved from Debbugs."
  38064. msgstr ""
  38065. #. type: defvr
  38066. #: guix-git/doc/guix.texi:25689
  38067. #, no-wrap
  38068. msgid "{Scheme Variable} mumi-service-type"
  38069. msgstr ""
  38070. #. type: defvr
  38071. #: guix-git/doc/guix.texi:25691
  38072. msgid "This is the service type for Mumi."
  38073. msgstr ""
  38074. #. type: deftp
  38075. #: guix-git/doc/guix.texi:25693
  38076. #, no-wrap
  38077. msgid "{Data Type} mumi-configuration"
  38078. msgstr ""
  38079. #. type: deftp
  38080. #: guix-git/doc/guix.texi:25696
  38081. msgid "Data type representing the Mumi service configuration. This type has the following fields:"
  38082. msgstr ""
  38083. #. type: item
  38084. #: guix-git/doc/guix.texi:25698
  38085. #, no-wrap
  38086. msgid "@code{mumi} (default: @code{mumi})"
  38087. msgstr ""
  38088. #. type: table
  38089. #: guix-git/doc/guix.texi:25700
  38090. msgid "The Mumi package to use."
  38091. msgstr ""
  38092. #. type: item
  38093. #: guix-git/doc/guix.texi:25701
  38094. #, no-wrap
  38095. msgid "@code{mailer?} (default: @code{#true})"
  38096. msgstr ""
  38097. #. type: table
  38098. #: guix-git/doc/guix.texi:25703
  38099. msgid "Whether to enable or disable the mailer component."
  38100. msgstr ""
  38101. #. type: code{#1}
  38102. #: guix-git/doc/guix.texi:25704
  38103. #, no-wrap
  38104. msgid "mumi-configuration-sender"
  38105. msgstr ""
  38106. #. type: table
  38107. #: guix-git/doc/guix.texi:25706
  38108. msgid "The email address used as the sender for comments."
  38109. msgstr ""
  38110. #. type: code{#1}
  38111. #: guix-git/doc/guix.texi:25707
  38112. #, no-wrap
  38113. msgid "mumi-configuration-smtp"
  38114. msgstr ""
  38115. #. type: table
  38116. #: guix-git/doc/guix.texi:25712
  38117. msgid "A URI to configure the SMTP settings for Mailutils. This could be something like @code{sendmail:///path/to/bin/msmtp} or any other URI supported by Mailutils. @xref{SMTP Mailboxes, SMTP Mailboxes,, mailutils, GNU@tie{}Mailutils}."
  38118. msgstr ""
  38119. #. type: subsubheading
  38120. #: guix-git/doc/guix.texi:25717
  38121. #, no-wrap
  38122. msgid "FastCGI"
  38123. msgstr ""
  38124. #. type: cindex
  38125. #: guix-git/doc/guix.texi:25718
  38126. #, no-wrap
  38127. msgid "fastcgi"
  38128. msgstr ""
  38129. #. type: cindex
  38130. #: guix-git/doc/guix.texi:25719
  38131. #, no-wrap
  38132. msgid "fcgiwrap"
  38133. msgstr ""
  38134. #. type: Plain text
  38135. #: guix-git/doc/guix.texi:25726
  38136. msgid "FastCGI is an interface between the front-end and the back-end of a web service. It is a somewhat legacy facility; new web services should generally just talk HTTP between the front-end and the back-end. However there are a number of back-end services such as PHP or the optimized HTTP Git repository access that use FastCGI, so we have support for it in Guix."
  38137. msgstr ""
  38138. #. type: Plain text
  38139. #: guix-git/doc/guix.texi:25733
  38140. msgid "To use FastCGI, you configure the front-end web server (e.g., nginx) to dispatch some subset of its requests to the fastcgi backend, which listens on a local TCP or UNIX socket. There is an intermediary @code{fcgiwrap} program that sits between the actual backend process and the web server. The front-end indicates which backend program to run, passing that information to the @code{fcgiwrap} process."
  38141. msgstr ""
  38142. #. type: defvr
  38143. #: guix-git/doc/guix.texi:25734
  38144. #, no-wrap
  38145. msgid "{Scheme Variable} fcgiwrap-service-type"
  38146. msgstr ""
  38147. #. type: defvr
  38148. #: guix-git/doc/guix.texi:25736
  38149. msgid "A service type for the @code{fcgiwrap} FastCGI proxy."
  38150. msgstr ""
  38151. #. type: deftp
  38152. #: guix-git/doc/guix.texi:25738
  38153. #, no-wrap
  38154. msgid "{Data Type} fcgiwrap-configuration"
  38155. msgstr ""
  38156. #. type: deftp
  38157. #: guix-git/doc/guix.texi:25741
  38158. msgid "Data type representing the configuration of the @code{fcgiwrap} service. This type has the following parameters:"
  38159. msgstr ""
  38160. #. type: item
  38161. #: guix-git/doc/guix.texi:25742
  38162. #, no-wrap
  38163. msgid "@code{package} (default: @code{fcgiwrap})"
  38164. msgstr ""
  38165. #. type: table
  38166. #: guix-git/doc/guix.texi:25744
  38167. msgid "The fcgiwrap package to use."
  38168. msgstr ""
  38169. #. type: item
  38170. #: guix-git/doc/guix.texi:25745
  38171. #, no-wrap
  38172. msgid "@code{socket} (default: @code{tcp:127.0.0.1:9000})"
  38173. msgstr ""
  38174. #. type: table
  38175. #: guix-git/doc/guix.texi:25751
  38176. msgid "The socket on which the @code{fcgiwrap} process should listen, as a string. Valid @var{socket} values include @code{unix:@var{/path/to/unix/socket}}, @code{tcp:@var{dot.ted.qu.ad}:@var{port}} and @code{tcp6:[@var{ipv6_addr}]:port}."
  38177. msgstr ""
  38178. #. type: item
  38179. #: guix-git/doc/guix.texi:25752
  38180. #, no-wrap
  38181. msgid "@code{user} (default: @code{fcgiwrap})"
  38182. msgstr ""
  38183. #. type: itemx
  38184. #: guix-git/doc/guix.texi:25753
  38185. #, no-wrap
  38186. msgid "@code{group} (default: @code{fcgiwrap})"
  38187. msgstr ""
  38188. #. type: table
  38189. #: guix-git/doc/guix.texi:25758
  38190. msgid "The user and group names, as strings, under which to run the @code{fcgiwrap} process. The @code{fastcgi} service will ensure that if the user asks for the specific user or group names @code{fcgiwrap} that the corresponding user and/or group is present on the system."
  38191. msgstr ""
  38192. #. type: table
  38193. #: guix-git/doc/guix.texi:25765
  38194. msgid "It is possible to configure a FastCGI-backed web service to pass HTTP authentication information from the front-end to the back-end, and to allow @code{fcgiwrap} to run the back-end process as a corresponding local user. To enable this capability on the back-end, run @code{fcgiwrap} as the @code{root} user and group. Note that this capability also has to be configured on the front-end as well."
  38195. msgstr ""
  38196. #. type: cindex
  38197. #: guix-git/doc/guix.texi:25768
  38198. #, no-wrap
  38199. msgid "php-fpm"
  38200. msgstr ""
  38201. #. type: Plain text
  38202. #: guix-git/doc/guix.texi:25771
  38203. msgid "PHP-FPM (FastCGI Process Manager) is an alternative PHP FastCGI implementation with some additional features useful for sites of any size."
  38204. msgstr ""
  38205. #. type: Plain text
  38206. #: guix-git/doc/guix.texi:25773
  38207. msgid "These features include:"
  38208. msgstr ""
  38209. #. type: item
  38210. #: guix-git/doc/guix.texi:25774
  38211. #, no-wrap
  38212. msgid "Adaptive process spawning"
  38213. msgstr ""
  38214. #. type: item
  38215. #: guix-git/doc/guix.texi:25775
  38216. #, no-wrap
  38217. msgid "Basic statistics (similar to Apache's mod_status)"
  38218. msgstr ""
  38219. #. type: item
  38220. #: guix-git/doc/guix.texi:25776
  38221. #, no-wrap
  38222. msgid "Advanced process management with graceful stop/start"
  38223. msgstr ""
  38224. #. type: item
  38225. #: guix-git/doc/guix.texi:25777
  38226. #, no-wrap
  38227. msgid "Ability to start workers with different uid/gid/chroot/environment"
  38228. msgstr ""
  38229. #. type: itemize
  38230. #: guix-git/doc/guix.texi:25779
  38231. msgid "and different php.ini (replaces safe_mode)"
  38232. msgstr ""
  38233. #. type: item
  38234. #: guix-git/doc/guix.texi:25779
  38235. #, no-wrap
  38236. msgid "Stdout & stderr logging"
  38237. msgstr ""
  38238. #. type: item
  38239. #: guix-git/doc/guix.texi:25780
  38240. #, no-wrap
  38241. msgid "Emergency restart in case of accidental opcode cache destruction"
  38242. msgstr ""
  38243. #. type: item
  38244. #: guix-git/doc/guix.texi:25781
  38245. #, no-wrap
  38246. msgid "Accelerated upload support"
  38247. msgstr ""
  38248. #. type: item
  38249. #: guix-git/doc/guix.texi:25782
  38250. #, no-wrap
  38251. msgid "Support for a \"slowlog\""
  38252. msgstr ""
  38253. #. type: item
  38254. #: guix-git/doc/guix.texi:25783
  38255. #, no-wrap
  38256. msgid "Enhancements to FastCGI, such as fastcgi_finish_request() -"
  38257. msgstr ""
  38258. #. type: itemize
  38259. #: guix-git/doc/guix.texi:25786
  38260. msgid "a special function to finish request & flush all data while continuing to do something time-consuming (video converting, stats processing, etc.)"
  38261. msgstr ""
  38262. #. type: Plain text
  38263. #: guix-git/doc/guix.texi:25788
  38264. msgid "...@: and much more."
  38265. msgstr ""
  38266. #. type: defvr
  38267. #: guix-git/doc/guix.texi:25789
  38268. #, no-wrap
  38269. msgid "{Scheme Variable} php-fpm-service-type"
  38270. msgstr ""
  38271. #. type: defvr
  38272. #: guix-git/doc/guix.texi:25791
  38273. msgid "A Service type for @code{php-fpm}."
  38274. msgstr ""
  38275. #. type: deftp
  38276. #: guix-git/doc/guix.texi:25793
  38277. #, no-wrap
  38278. msgid "{Data Type} php-fpm-configuration"
  38279. msgstr ""
  38280. #. type: deftp
  38281. #: guix-git/doc/guix.texi:25795
  38282. msgid "Data Type for php-fpm service configuration."
  38283. msgstr ""
  38284. #. type: item
  38285. #: guix-git/doc/guix.texi:25796
  38286. #, no-wrap
  38287. msgid "@code{php} (default: @code{php})"
  38288. msgstr ""
  38289. #. type: table
  38290. #: guix-git/doc/guix.texi:25798
  38291. msgid "The php package to use."
  38292. msgstr ""
  38293. #. type: item
  38294. #: guix-git/doc/guix.texi:25798
  38295. #, no-wrap
  38296. msgid "@code{socket} (default: @code{(string-append \"/var/run/php\" (version-major (package-version php)) \"-fpm.sock\")})"
  38297. msgstr ""
  38298. #. type: table
  38299. #: guix-git/doc/guix.texi:25800
  38300. msgid "The address on which to accept FastCGI requests. Valid syntaxes are:"
  38301. msgstr ""
  38302. #. type: code{#1}
  38303. #: guix-git/doc/guix.texi:25801
  38304. #, no-wrap
  38305. msgid "\"ip.add.re.ss:port\""
  38306. msgstr ""
  38307. #. type: table
  38308. #: guix-git/doc/guix.texi:25803
  38309. msgid "Listen on a TCP socket to a specific address on a specific port."
  38310. msgstr ""
  38311. #. type: code{#1}
  38312. #: guix-git/doc/guix.texi:25803
  38313. #, no-wrap
  38314. msgid "\"port\""
  38315. msgstr ""
  38316. #. type: table
  38317. #: guix-git/doc/guix.texi:25805
  38318. msgid "Listen on a TCP socket to all addresses on a specific port."
  38319. msgstr ""
  38320. #. type: code{#1}
  38321. #: guix-git/doc/guix.texi:25805
  38322. #, no-wrap
  38323. msgid "\"/path/to/unix/socket\""
  38324. msgstr ""
  38325. #. type: table
  38326. #: guix-git/doc/guix.texi:25807
  38327. msgid "Listen on a unix socket."
  38328. msgstr ""
  38329. #. type: item
  38330. #: guix-git/doc/guix.texi:25809
  38331. #, no-wrap
  38332. msgid "@code{user} (default: @code{php-fpm})"
  38333. msgstr ""
  38334. #. type: table
  38335. #: guix-git/doc/guix.texi:25811
  38336. msgid "User who will own the php worker processes."
  38337. msgstr ""
  38338. #. type: item
  38339. #: guix-git/doc/guix.texi:25811
  38340. #, no-wrap
  38341. msgid "@code{group} (default: @code{php-fpm})"
  38342. msgstr ""
  38343. #. type: table
  38344. #: guix-git/doc/guix.texi:25813
  38345. msgid "Group of the worker processes."
  38346. msgstr ""
  38347. #. type: item
  38348. #: guix-git/doc/guix.texi:25813
  38349. #, no-wrap
  38350. msgid "@code{socket-user} (default: @code{php-fpm})"
  38351. msgstr ""
  38352. #. type: table
  38353. #: guix-git/doc/guix.texi:25815
  38354. msgid "User who can speak to the php-fpm socket."
  38355. msgstr ""
  38356. #. type: item
  38357. #: guix-git/doc/guix.texi:25815
  38358. #, no-wrap
  38359. msgid "@code{socket-group} (default: @code{nginx})"
  38360. msgstr ""
  38361. #. type: table
  38362. #: guix-git/doc/guix.texi:25817
  38363. msgid "Group that can speak to the php-fpm socket."
  38364. msgstr ""
  38365. #. type: item
  38366. #: guix-git/doc/guix.texi:25817
  38367. #, no-wrap
  38368. msgid "@code{pid-file} (default: @code{(string-append \"/var/run/php\" (version-major (package-version php)) \"-fpm.pid\")})"
  38369. msgstr ""
  38370. #. type: table
  38371. #: guix-git/doc/guix.texi:25820
  38372. msgid "The process id of the php-fpm process is written to this file once the service has started."
  38373. msgstr ""
  38374. #. type: item
  38375. #: guix-git/doc/guix.texi:25820
  38376. #, no-wrap
  38377. msgid "@code{log-file} (default: @code{(string-append \"/var/log/php\" (version-major (package-version php)) \"-fpm.log\")})"
  38378. msgstr ""
  38379. #. type: table
  38380. #: guix-git/doc/guix.texi:25822
  38381. msgid "Log for the php-fpm master process."
  38382. msgstr ""
  38383. #. type: item
  38384. #: guix-git/doc/guix.texi:25822
  38385. #, no-wrap
  38386. msgid "@code{process-manager} (default: @code{(php-fpm-dynamic-process-manager-configuration)})"
  38387. msgstr ""
  38388. #. type: table
  38389. #: guix-git/doc/guix.texi:25825
  38390. msgid "Detailed settings for the php-fpm process manager. Must be one of:"
  38391. msgstr ""
  38392. #. type: code{#1}
  38393. #: guix-git/doc/guix.texi:25826
  38394. #, no-wrap
  38395. msgid "<php-fpm-dynamic-process-manager-configuration>"
  38396. msgstr ""
  38397. #. type: code{#1}
  38398. #: guix-git/doc/guix.texi:25827
  38399. #, no-wrap
  38400. msgid "<php-fpm-static-process-manager-configuration>"
  38401. msgstr ""
  38402. #. type: code{#1}
  38403. #: guix-git/doc/guix.texi:25828
  38404. #, no-wrap
  38405. msgid "<php-fpm-on-demand-process-manager-configuration>"
  38406. msgstr ""
  38407. #. type: item
  38408. #: guix-git/doc/guix.texi:25830
  38409. #, no-wrap
  38410. msgid "@code{display-errors} (default @code{#f})"
  38411. msgstr ""
  38412. #. type: table
  38413. #: guix-git/doc/guix.texi:25835
  38414. msgid "Determines whether php errors and warning should be sent to clients and displayed in their browsers. This is useful for local php development, but a security risk for public sites, as error messages can reveal passwords and personal data."
  38415. msgstr ""
  38416. #. type: item
  38417. #: guix-git/doc/guix.texi:25835
  38418. #, no-wrap
  38419. msgid "@code{timezone} (default @code{#f})"
  38420. msgstr ""
  38421. #. type: table
  38422. #: guix-git/doc/guix.texi:25837
  38423. msgid "Specifies @code{php_admin_value[date.timezone]} parameter."
  38424. msgstr ""
  38425. #. type: item
  38426. #: guix-git/doc/guix.texi:25837
  38427. #, no-wrap
  38428. msgid "@code{workers-logfile} (default @code{(string-append \"/var/log/php\" (version-major (package-version php)) \"-fpm.www.log\")})"
  38429. msgstr ""
  38430. #. type: table
  38431. #: guix-git/doc/guix.texi:25840
  38432. msgid "This file will log the @code{stderr} outputs of php worker processes. Can be set to @code{#f} to disable logging."
  38433. msgstr ""
  38434. #. type: item
  38435. #: guix-git/doc/guix.texi:25840
  38436. #, no-wrap
  38437. msgid "@code{file} (default @code{#f})"
  38438. msgstr ""
  38439. #. type: table
  38440. #: guix-git/doc/guix.texi:25843
  38441. msgid "An optional override of the whole configuration. You can use the @code{mixed-text-file} function or an absolute filepath for it."
  38442. msgstr ""
  38443. #. type: item
  38444. #: guix-git/doc/guix.texi:25843
  38445. #, no-wrap
  38446. msgid "@code{php-ini-file} (default @code{#f})"
  38447. msgstr ""
  38448. #. type: table
  38449. #: guix-git/doc/guix.texi:25847
  38450. msgid "An optional override of the default php settings. It may be any ``file-like'' object (@pxref{G-Expressions, file-like objects}). You can use the @code{mixed-text-file} function or an absolute filepath for it."
  38451. msgstr ""
  38452. #. type: table
  38453. #: guix-git/doc/guix.texi:25851
  38454. msgid "For local development it is useful to set a higher timeout and memory limit for spawned php processes. This be accomplished with the following operating system configuration snippet:"
  38455. msgstr ""
  38456. #. type: lisp
  38457. #: guix-git/doc/guix.texi:25856
  38458. #, no-wrap
  38459. msgid ""
  38460. "(define %local-php-ini\n"
  38461. " (plain-file \"php.ini\"\n"
  38462. " \"memory_limit = 2G\n"
  38463. "max_execution_time = 1800\"))\n"
  38464. "\n"
  38465. msgstr ""
  38466. #. type: lisp
  38467. #: guix-git/doc/guix.texi:25863
  38468. #, no-wrap
  38469. msgid ""
  38470. "(operating-system\n"
  38471. " ;; @dots{}\n"
  38472. " (services (cons (service php-fpm-service-type\n"
  38473. " (php-fpm-configuration\n"
  38474. " (php-ini-file %local-php-ini)))\n"
  38475. " %base-services)))\n"
  38476. msgstr ""
  38477. #. type: table
  38478. #: guix-git/doc/guix.texi:25868
  38479. msgid "Consult the @url{https://www.php.net/manual/en/ini.core.php,core php.ini directives} for comprehensive documentation on the acceptable @file{php.ini} directives."
  38480. msgstr ""
  38481. #. type: deftp
  38482. #: guix-git/doc/guix.texi:25871
  38483. #, no-wrap
  38484. msgid "{Data type} php-fpm-dynamic-process-manager-configuration"
  38485. msgstr ""
  38486. #. type: deftp
  38487. #: guix-git/doc/guix.texi:25875
  38488. msgid "Data Type for the @code{dynamic} php-fpm process manager. With the @code{dynamic} process manager, spare worker processes are kept around based on its configured limits."
  38489. msgstr ""
  38490. #. type: item
  38491. #: guix-git/doc/guix.texi:25876 guix-git/doc/guix.texi:25892
  38492. #: guix-git/doc/guix.texi:25902
  38493. #, no-wrap
  38494. msgid "@code{max-children} (default: @code{5})"
  38495. msgstr ""
  38496. #. type: table
  38497. #: guix-git/doc/guix.texi:25878 guix-git/doc/guix.texi:25894
  38498. #: guix-git/doc/guix.texi:25904
  38499. msgid "Maximum of worker processes."
  38500. msgstr ""
  38501. #. type: item
  38502. #: guix-git/doc/guix.texi:25878
  38503. #, no-wrap
  38504. msgid "@code{start-servers} (default: @code{2})"
  38505. msgstr ""
  38506. #. type: table
  38507. #: guix-git/doc/guix.texi:25880
  38508. msgid "How many worker processes should be started on start-up."
  38509. msgstr ""
  38510. #. type: item
  38511. #: guix-git/doc/guix.texi:25880
  38512. #, no-wrap
  38513. msgid "@code{min-spare-servers} (default: @code{1})"
  38514. msgstr ""
  38515. #. type: table
  38516. #: guix-git/doc/guix.texi:25882
  38517. msgid "How many spare worker processes should be kept around at minimum."
  38518. msgstr ""
  38519. #. type: item
  38520. #: guix-git/doc/guix.texi:25882
  38521. #, no-wrap
  38522. msgid "@code{max-spare-servers} (default: @code{3})"
  38523. msgstr ""
  38524. #. type: table
  38525. #: guix-git/doc/guix.texi:25884
  38526. msgid "How many spare worker processes should be kept around at maximum."
  38527. msgstr ""
  38528. #. type: deftp
  38529. #: guix-git/doc/guix.texi:25887
  38530. #, no-wrap
  38531. msgid "{Data type} php-fpm-static-process-manager-configuration"
  38532. msgstr ""
  38533. #. type: deftp
  38534. #: guix-git/doc/guix.texi:25891
  38535. msgid "Data Type for the @code{static} php-fpm process manager. With the @code{static} process manager, an unchanging number of worker processes are created."
  38536. msgstr ""
  38537. #. type: deftp
  38538. #: guix-git/doc/guix.texi:25897
  38539. #, no-wrap
  38540. msgid "{Data type} php-fpm-on-demand-process-manager-configuration"
  38541. msgstr ""
  38542. #. type: deftp
  38543. #: guix-git/doc/guix.texi:25901
  38544. msgid "Data Type for the @code{on-demand} php-fpm process manager. With the @code{on-demand} process manager, worker processes are only created as requests arrive."
  38545. msgstr ""
  38546. #. type: item
  38547. #: guix-git/doc/guix.texi:25904
  38548. #, no-wrap
  38549. msgid "@code{process-idle-timeout} (default: @code{10})"
  38550. msgstr ""
  38551. #. type: table
  38552. #: guix-git/doc/guix.texi:25906
  38553. msgid "The time in seconds after which a process with no requests is killed."
  38554. msgstr ""
  38555. #. type: deffn
  38556. #: guix-git/doc/guix.texi:25910
  38557. #, no-wrap
  38558. msgid "{Scheme Procedure} nginx-php-location @"
  38559. msgstr ""
  38560. #. type: deffn
  38561. #: guix-git/doc/guix.texi:25916
  38562. msgid "[#:nginx-package nginx] @ [socket (string-append \"/var/run/php\" @ (version-major (package-version php)) @ \"-fpm.sock\")] A helper function to quickly add php to an @code{nginx-server-configuration}."
  38563. msgstr ""
  38564. #. type: Plain text
  38565. #: guix-git/doc/guix.texi:25919
  38566. msgid "A simple services setup for nginx with php can look like this:"
  38567. msgstr ""
  38568. #. type: lisp
  38569. #: guix-git/doc/guix.texi:25932
  38570. #, no-wrap
  38571. msgid ""
  38572. "(services (cons* (service dhcp-client-service-type)\n"
  38573. " (service php-fpm-service-type)\n"
  38574. " (service nginx-service-type\n"
  38575. " (nginx-server-configuration\n"
  38576. " (server-name '(\"example.com\"))\n"
  38577. " (root \"/srv/http/\")\n"
  38578. " (locations\n"
  38579. " (list (nginx-php-location)))\n"
  38580. " (listen '(\"80\"))\n"
  38581. " (ssl-certificate #f)\n"
  38582. " (ssl-certificate-key #f)))\n"
  38583. " %base-services))\n"
  38584. msgstr ""
  38585. #. type: cindex
  38586. #: guix-git/doc/guix.texi:25934
  38587. #, no-wrap
  38588. msgid "cat-avatar-generator"
  38589. msgstr ""
  38590. #. type: Plain text
  38591. #: guix-git/doc/guix.texi:25938
  38592. msgid "The cat avatar generator is a simple service to demonstrate the use of php-fpm in @code{Nginx}. It is used to generate cat avatar from a seed, for instance the hash of a user's email address."
  38593. msgstr ""
  38594. #. type: deffn
  38595. #: guix-git/doc/guix.texi:25939
  38596. #, no-wrap
  38597. msgid "{Scheme Procedure} cat-avatar-generator-service @"
  38598. msgstr ""
  38599. #. type: deffn
  38600. #: guix-git/doc/guix.texi:25947
  38601. msgid "[#:cache-dir \"/var/cache/cat-avatar-generator\"] @ [#:package cat-avatar-generator] @ [#:configuration (nginx-server-configuration)] Returns an nginx-server-configuration that inherits @code{configuration}. It extends the nginx configuration to add a server block that serves @code{package}, a version of cat-avatar-generator. During execution, cat-avatar-generator will be able to use @code{cache-dir} as its cache directory."
  38602. msgstr ""
  38603. #. type: Plain text
  38604. #: guix-git/doc/guix.texi:25950
  38605. msgid "A simple setup for cat-avatar-generator can look like this:"
  38606. msgstr ""
  38607. #. type: lisp
  38608. #: guix-git/doc/guix.texi:25957
  38609. #, no-wrap
  38610. msgid ""
  38611. "(services (cons* (cat-avatar-generator-service\n"
  38612. " #:configuration\n"
  38613. " (nginx-server-configuration\n"
  38614. " (server-name '(\"example.com\"))))\n"
  38615. " ...\n"
  38616. " %base-services))\n"
  38617. msgstr ""
  38618. #. type: subsubheading
  38619. #: guix-git/doc/guix.texi:25959
  38620. #, no-wrap
  38621. msgid "Hpcguix-web"
  38622. msgstr ""
  38623. #. type: cindex
  38624. #: guix-git/doc/guix.texi:25961
  38625. #, no-wrap
  38626. msgid "hpcguix-web"
  38627. msgstr ""
  38628. #. type: Plain text
  38629. #: guix-git/doc/guix.texi:25966
  38630. msgid "The @uref{https://github.com/UMCUGenetics/hpcguix-web/, hpcguix-web} program is a customizable web interface to browse Guix packages, initially designed for users of high-performance computing (HPC) clusters."
  38631. msgstr ""
  38632. #. type: defvr
  38633. #: guix-git/doc/guix.texi:25967
  38634. #, no-wrap
  38635. msgid "{Scheme Variable} hpcguix-web-service-type"
  38636. msgstr ""
  38637. #. type: defvr
  38638. #: guix-git/doc/guix.texi:25969
  38639. msgid "The service type for @code{hpcguix-web}."
  38640. msgstr ""
  38641. #. type: deftp
  38642. #: guix-git/doc/guix.texi:25971
  38643. #, no-wrap
  38644. msgid "{Data Type} hpcguix-web-configuration"
  38645. msgstr ""
  38646. #. type: deftp
  38647. #: guix-git/doc/guix.texi:25973
  38648. msgid "Data type for the hpcguix-web service configuration."
  38649. msgstr ""
  38650. #. type: code{#1}
  38651. #: guix-git/doc/guix.texi:25975
  38652. #, no-wrap
  38653. msgid "specs"
  38654. msgstr ""
  38655. #. type: table
  38656. #: guix-git/doc/guix.texi:25978
  38657. msgid "A gexp (@pxref{G-Expressions}) specifying the hpcguix-web service configuration. The main items available in this spec are:"
  38658. msgstr ""
  38659. #. type: item
  38660. #: guix-git/doc/guix.texi:25980
  38661. #, no-wrap
  38662. msgid "@code{title-prefix} (default: @code{\"hpcguix | \"})"
  38663. msgstr ""
  38664. #. type: table
  38665. #: guix-git/doc/guix.texi:25982
  38666. msgid "The page title prefix."
  38667. msgstr ""
  38668. #. type: item
  38669. #: guix-git/doc/guix.texi:25983
  38670. #, no-wrap
  38671. msgid "@code{guix-command} (default: @code{\"guix\"})"
  38672. msgstr ""
  38673. #. type: table
  38674. #: guix-git/doc/guix.texi:25985
  38675. msgid "The @command{guix} command."
  38676. msgstr ""
  38677. #. type: item
  38678. #: guix-git/doc/guix.texi:25986
  38679. #, no-wrap
  38680. msgid "@code{package-filter-proc} (default: @code{(const #t)})"
  38681. msgstr ""
  38682. #. type: table
  38683. #: guix-git/doc/guix.texi:25988
  38684. msgid "A procedure specifying how to filter packages that are displayed."
  38685. msgstr ""
  38686. #. type: item
  38687. #: guix-git/doc/guix.texi:25989
  38688. #, no-wrap
  38689. msgid "@code{package-page-extension-proc} (default: @code{(const '())})"
  38690. msgstr ""
  38691. #. type: table
  38692. #: guix-git/doc/guix.texi:25991
  38693. msgid "Extension package for @code{hpcguix-web}."
  38694. msgstr ""
  38695. #. type: item
  38696. #: guix-git/doc/guix.texi:25992
  38697. #, no-wrap
  38698. msgid "@code{menu} (default: @code{'()})"
  38699. msgstr ""
  38700. #. type: table
  38701. #: guix-git/doc/guix.texi:25994
  38702. msgid "Additional entry in page @code{menu}."
  38703. msgstr ""
  38704. #. type: item
  38705. #: guix-git/doc/guix.texi:25995
  38706. #, no-wrap
  38707. msgid "@code{channels} (default: @code{%default-channels})"
  38708. msgstr ""
  38709. #. type: table
  38710. #: guix-git/doc/guix.texi:25997
  38711. msgid "List of channels from which the package list is built (@pxref{Channels})."
  38712. msgstr ""
  38713. #. type: item
  38714. #: guix-git/doc/guix.texi:25998
  38715. #, no-wrap
  38716. msgid "@code{package-list-expiration} (default: @code{(* 12 3600)})"
  38717. msgstr ""
  38718. #. type: table
  38719. #: guix-git/doc/guix.texi:26001
  38720. msgid "The expiration time, in seconds, after which the package list is rebuilt from the latest instances of the given channels."
  38721. msgstr ""
  38722. #. type: table
  38723. #: guix-git/doc/guix.texi:26006
  38724. msgid "See the hpcguix-web repository for a @uref{https://github.com/UMCUGenetics/hpcguix-web/blob/master/hpcweb-configuration.scm, complete example}."
  38725. msgstr ""
  38726. #. type: item
  38727. #: guix-git/doc/guix.texi:26007
  38728. #, no-wrap
  38729. msgid "@code{package} (default: @code{hpcguix-web})"
  38730. msgstr ""
  38731. #. type: table
  38732. #: guix-git/doc/guix.texi:26009
  38733. msgid "The hpcguix-web package to use."
  38734. msgstr ""
  38735. #. type: Plain text
  38736. #: guix-git/doc/guix.texi:26013
  38737. msgid "A typical hpcguix-web service declaration looks like this:"
  38738. msgstr ""
  38739. #. type: lisp
  38740. #: guix-git/doc/guix.texi:26022
  38741. #, no-wrap
  38742. msgid ""
  38743. "(service hpcguix-web-service-type\n"
  38744. " (hpcguix-web-configuration\n"
  38745. " (specs\n"
  38746. " #~(define site-config\n"
  38747. " (hpcweb-configuration\n"
  38748. " (title-prefix \"Guix-HPC - \")\n"
  38749. " (menu '((\"/about\" \"ABOUT\"))))))))\n"
  38750. msgstr ""
  38751. #. type: quotation
  38752. #: guix-git/doc/guix.texi:26029
  38753. msgid "The hpcguix-web service periodically updates the package list it publishes by pulling channels from Git. To that end, it needs to access X.509 certificates so that it can authenticate Git servers when communicating over HTTPS, and it assumes that @file{/etc/ssl/certs} contains those certificates."
  38754. msgstr ""
  38755. #. type: quotation
  38756. #: guix-git/doc/guix.texi:26033
  38757. msgid "Thus, make sure to add @code{nss-certs} or another certificate package to the @code{packages} field of your configuration. @ref{X.509 Certificates}, for more information on X.509 certificates."
  38758. msgstr ""
  38759. #. type: cindex
  38760. #: guix-git/doc/guix.texi:26035 guix-git/doc/guix.texi:26037
  38761. #, no-wrap
  38762. msgid "gmnisrv"
  38763. msgstr ""
  38764. #. type: Plain text
  38765. #: guix-git/doc/guix.texi:26040
  38766. msgid "The @uref{https://git.sr.ht/~sircmpwn/gmnisrv, gmnisrv} program is a simple @uref{https://gemini.circumlunar.space/, Gemini} protocol server."
  38767. msgstr ""
  38768. #. type: deffn
  38769. #: guix-git/doc/guix.texi:26041
  38770. #, no-wrap
  38771. msgid "{Scheme Variable} gmnisrv-service-type"
  38772. msgstr ""
  38773. #. type: deffn
  38774. #: guix-git/doc/guix.texi:26044
  38775. msgid "This is the type of the gmnisrv service, whose value should be a @code{gmnisrv-configuration} object, as in this example:"
  38776. msgstr ""
  38777. #. type: lisp
  38778. #: guix-git/doc/guix.texi:26049
  38779. #, no-wrap
  38780. msgid ""
  38781. "(service gmnisrv-service-type\n"
  38782. " (gmnisrv-configuration\n"
  38783. " (config-file (local-file \"./my-gmnisrv.ini\"))))\n"
  38784. msgstr ""
  38785. #. type: deftp
  38786. #: guix-git/doc/guix.texi:26052
  38787. #, no-wrap
  38788. msgid "{Data Type} gmnisrv-configuration"
  38789. msgstr ""
  38790. #. type: deftp
  38791. #: guix-git/doc/guix.texi:26054
  38792. msgid "Data type representing the configuration of gmnisrv."
  38793. msgstr ""
  38794. #. type: item
  38795. #: guix-git/doc/guix.texi:26056
  38796. #, no-wrap
  38797. msgid "@code{package} (default: @var{gmnisrv})"
  38798. msgstr ""
  38799. #. type: table
  38800. #: guix-git/doc/guix.texi:26058
  38801. msgid "Package object of the gmnisrv server."
  38802. msgstr ""
  38803. #. type: item
  38804. #: guix-git/doc/guix.texi:26059
  38805. #, no-wrap
  38806. msgid "@code{config-file} (default: @code{%default-gmnisrv-config-file})"
  38807. msgstr ""
  38808. #. type: table
  38809. #: guix-git/doc/guix.texi:26065
  38810. msgid "File-like object of the gmnisrv configuration file to use. The default configuration listens on port 1965 and serves files from @file{/srv/gemini}. Certificates are stored in @file{/var/lib/gemini/certs}. For more information, run @command{man gmnisrv} and @command{man gmnisrv.ini}."
  38811. msgstr ""
  38812. #. type: subsubheading
  38813. #: guix-git/doc/guix.texi:26069
  38814. #, no-wrap
  38815. msgid "Agate"
  38816. msgstr ""
  38817. #. type: cindex
  38818. #: guix-git/doc/guix.texi:26071
  38819. #, no-wrap
  38820. msgid "agate"
  38821. msgstr ""
  38822. #. type: Plain text
  38823. #: guix-git/doc/guix.texi:26076
  38824. msgid "The @uref{gemini://qwertqwefsday.eu/agate.gmi, Agate} (@uref{https://github.com/mbrubeck/agate, GitHub page over HTTPS}) program is a simple @uref{https://gemini.circumlunar.space/, Gemini} protocol server written in Rust."
  38825. msgstr ""
  38826. #. type: deffn
  38827. #: guix-git/doc/guix.texi:26077
  38828. #, no-wrap
  38829. msgid "{Scheme Variable} agate-service-type"
  38830. msgstr ""
  38831. #. type: deffn
  38832. #: guix-git/doc/guix.texi:26080
  38833. msgid "This is the type of the agate service, whose value should be an @code{agate-service-type} object, as in this example:"
  38834. msgstr ""
  38835. #. type: lisp
  38836. #: guix-git/doc/guix.texi:26087
  38837. #, no-wrap
  38838. msgid ""
  38839. "(service agate-service-type\n"
  38840. "\t (agate-configuration\n"
  38841. "\t (content \"/srv/gemini\")\n"
  38842. "\t (cert \"/srv/cert.pem\")\n"
  38843. "\t (key \"/srv/key.rsa\")))\n"
  38844. msgstr ""
  38845. #. type: deffn
  38846. #: guix-git/doc/guix.texi:26092
  38847. msgid "The example above represents the minimal tweaking necessary to get Agate up and running. Specifying the path to the certificate and key is always necessary, as the Gemini protocol requires TLS by default."
  38848. msgstr ""
  38849. #. type: deffn
  38850. #: guix-git/doc/guix.texi:26095
  38851. msgid "To obtain a certificate and a key, you could, for example, use OpenSSL, running a command similar to the following example:"
  38852. msgstr ""
  38853. #. type: example
  38854. #: guix-git/doc/guix.texi:26099
  38855. #, no-wrap
  38856. msgid ""
  38857. "openssl req -x509 -newkey rsa:4096 -keyout key.rsa -out cert.pem \\\n"
  38858. " -days 3650 -nodes -subj \"/CN=example.com\"\n"
  38859. msgstr ""
  38860. #. type: deffn
  38861. #: guix-git/doc/guix.texi:26104
  38862. msgid "Of course, you'll have to replace @i{example.com} with your own domain name, and then point the Agate configuration towards the path of the generated key and certificate."
  38863. msgstr ""
  38864. #. type: deftp
  38865. #: guix-git/doc/guix.texi:26107
  38866. #, no-wrap
  38867. msgid "{Data Type} agate-configuration"
  38868. msgstr ""
  38869. #. type: deftp
  38870. #: guix-git/doc/guix.texi:26109
  38871. msgid "Data type representing the configuration of Agate."
  38872. msgstr ""
  38873. #. type: item
  38874. #: guix-git/doc/guix.texi:26111
  38875. #, no-wrap
  38876. msgid "@code{package} (default: @code{agate})"
  38877. msgstr ""
  38878. #. type: table
  38879. #: guix-git/doc/guix.texi:26113
  38880. msgid "The package object of the Agate server."
  38881. msgstr ""
  38882. #. type: item
  38883. #: guix-git/doc/guix.texi:26114
  38884. #, no-wrap
  38885. msgid "@code{content} (default: @file{\"/srv/gemini\"})"
  38886. msgstr ""
  38887. #. type: table
  38888. #: guix-git/doc/guix.texi:26116
  38889. msgid "The directory from which Agate will serve files."
  38890. msgstr ""
  38891. #. type: item
  38892. #: guix-git/doc/guix.texi:26117
  38893. #, no-wrap
  38894. msgid "@code{cert} (default: @code{#f})"
  38895. msgstr ""
  38896. #. type: table
  38897. #: guix-git/doc/guix.texi:26120
  38898. msgid "The path to the TLS certificate PEM file to be used for encrypted connections. Must be filled in with a value from the user."
  38899. msgstr ""
  38900. #. type: item
  38901. #: guix-git/doc/guix.texi:26121 guix-git/doc/guix.texi:26557
  38902. #, no-wrap
  38903. msgid "@code{key} (default: @code{#f})"
  38904. msgstr ""
  38905. #. type: table
  38906. #: guix-git/doc/guix.texi:26124
  38907. msgid "The path to the PKCS8 private key file to be used for encrypted connections. Must be filled in with a value from the user."
  38908. msgstr ""
  38909. #. type: item
  38910. #: guix-git/doc/guix.texi:26125
  38911. #, no-wrap
  38912. msgid "@code{addr} (default: @code{'(\"0.0.0.0:1965\" \"[::]:1965\")})"
  38913. msgstr ""
  38914. #. type: table
  38915. #: guix-git/doc/guix.texi:26127
  38916. msgid "A list of the addresses to listen on."
  38917. msgstr ""
  38918. #. type: table
  38919. #: guix-git/doc/guix.texi:26130
  38920. msgid "The domain name of this Gemini server. Optional."
  38921. msgstr ""
  38922. #. type: item
  38923. #: guix-git/doc/guix.texi:26131
  38924. #, no-wrap
  38925. msgid "@code{lang} (default: @code{#f})"
  38926. msgstr ""
  38927. #. type: table
  38928. #: guix-git/doc/guix.texi:26133
  38929. msgid "RFC 4646 language code(s) for text/gemini documents. Optional."
  38930. msgstr ""
  38931. #. type: item
  38932. #: guix-git/doc/guix.texi:26134
  38933. #, no-wrap
  38934. msgid "@code{silent?} (default: @code{#f})"
  38935. msgstr ""
  38936. #. type: table
  38937. #: guix-git/doc/guix.texi:26136
  38938. msgid "Set to @code{#t} to disable logging output."
  38939. msgstr ""
  38940. #. type: item
  38941. #: guix-git/doc/guix.texi:26137
  38942. #, no-wrap
  38943. msgid "@code{serve-secret?} (default: @code{#f})"
  38944. msgstr ""
  38945. #. type: table
  38946. #: guix-git/doc/guix.texi:26140
  38947. msgid "Set to @code{#t} to serve secret files (files/directories starting with a dot)."
  38948. msgstr ""
  38949. #. type: item
  38950. #: guix-git/doc/guix.texi:26141
  38951. #, no-wrap
  38952. msgid "@code{log-ip?} (default: @code{#t})"
  38953. msgstr ""
  38954. #. type: table
  38955. #: guix-git/doc/guix.texi:26143
  38956. msgid "Whether or not to output IP addresses when logging."
  38957. msgstr ""
  38958. #. type: item
  38959. #: guix-git/doc/guix.texi:26144
  38960. #, no-wrap
  38961. msgid "@code{user} (default: @code{\"agate\"})"
  38962. msgstr ""
  38963. #. type: table
  38964. #: guix-git/doc/guix.texi:26146
  38965. msgid "Owner of the @code{agate} process."
  38966. msgstr ""
  38967. #. type: item
  38968. #: guix-git/doc/guix.texi:26147
  38969. #, no-wrap
  38970. msgid "@code{group} (default: @code{\"agate\"})"
  38971. msgstr ""
  38972. #. type: table
  38973. #: guix-git/doc/guix.texi:26149
  38974. msgid "Owner's group of the @code{agate} process."
  38975. msgstr ""
  38976. #. type: item
  38977. #: guix-git/doc/guix.texi:26150
  38978. #, no-wrap
  38979. msgid "@code{log-file} (default: @file{\"/var/log/agate.log\"})"
  38980. msgstr ""
  38981. #. type: table
  38982. #: guix-git/doc/guix.texi:26152
  38983. msgid "The file which should store the logging output of Agate."
  38984. msgstr ""
  38985. #. type: cindex
  38986. #: guix-git/doc/guix.texi:26159
  38987. #, no-wrap
  38988. msgid "Web"
  38989. msgstr ""
  38990. #. type: cindex
  38991. #: guix-git/doc/guix.texi:26160
  38992. #, no-wrap
  38993. msgid "HTTP, HTTPS"
  38994. msgstr ""
  38995. #. type: cindex
  38996. #: guix-git/doc/guix.texi:26161
  38997. #, no-wrap
  38998. msgid "Let's Encrypt"
  38999. msgstr ""
  39000. #. type: cindex
  39001. #: guix-git/doc/guix.texi:26162
  39002. #, no-wrap
  39003. msgid "TLS certificates"
  39004. msgstr ""
  39005. #. type: Plain text
  39006. #: guix-git/doc/guix.texi:26169
  39007. msgid "The @code{(gnu services certbot)} module provides a service to automatically obtain a valid TLS certificate from the Let's Encrypt certificate authority. These certificates can then be used to serve content securely over HTTPS or other TLS-based protocols, with the knowledge that the client will be able to verify the server's authenticity."
  39008. msgstr ""
  39009. #. type: Plain text
  39010. #: guix-git/doc/guix.texi:26181
  39011. msgid "@url{https://letsencrypt.org/, Let's Encrypt} provides the @code{certbot} tool to automate the certification process. This tool first securely generates a key on the server. It then makes a request to the Let's Encrypt certificate authority (CA) to sign the key. The CA checks that the request originates from the host in question by using a challenge-response protocol, requiring the server to provide its response over HTTP@. If that protocol completes successfully, the CA signs the key, resulting in a certificate. That certificate is valid for a limited period of time, and therefore to continue to provide TLS services, the server needs to periodically ask the CA to renew its signature."
  39012. msgstr ""
  39013. #. type: Plain text
  39014. #: guix-git/doc/guix.texi:26188
  39015. msgid "The certbot service automates this process: the initial key generation, the initial certification request to the Let's Encrypt service, the web server challenge/response integration, writing the certificate to disk, the automated periodic renewals, and the deployment tasks associated with the renewal (e.g.@: reloading services, copying keys with different permissions)."
  39016. msgstr ""
  39017. #. type: Plain text
  39018. #: guix-git/doc/guix.texi:26194
  39019. msgid "Certbot is run twice a day, at a random minute within the hour. It won't do anything until your certificates are due for renewal or revoked, but running it regularly would give your service a chance of staying online in case a Let's Encrypt-initiated revocation happened for some reason."
  39020. msgstr ""
  39021. #. type: Plain text
  39022. #: guix-git/doc/guix.texi:26198
  39023. msgid "By using this service, you agree to the ACME Subscriber Agreement, which can be found there: @url{https://acme-v01.api.letsencrypt.org/directory}."
  39024. msgstr ""
  39025. #. type: defvr
  39026. #: guix-git/doc/guix.texi:26199
  39027. #, no-wrap
  39028. msgid "{Scheme Variable} certbot-service-type"
  39029. msgstr ""
  39030. #. type: defvr
  39031. #: guix-git/doc/guix.texi:26202
  39032. msgid "A service type for the @code{certbot} Let's Encrypt client. Its value must be a @code{certbot-configuration} record as in this example:"
  39033. msgstr ""
  39034. #. type: lisp
  39035. #: guix-git/doc/guix.texi:26209
  39036. #, no-wrap
  39037. msgid ""
  39038. "(define %nginx-deploy-hook\n"
  39039. " (program-file\n"
  39040. " \"nginx-deploy-hook\"\n"
  39041. " #~(let ((pid (call-with-input-file \"/var/run/nginx/pid\" read)))\n"
  39042. " (kill pid SIGHUP))))\n"
  39043. "\n"
  39044. msgstr ""
  39045. #. type: lisp
  39046. #: guix-git/doc/guix.texi:26220
  39047. #, no-wrap
  39048. msgid ""
  39049. "(service certbot-service-type\n"
  39050. " (certbot-configuration\n"
  39051. " (email \"foo@@example.net\")\n"
  39052. " (certificates\n"
  39053. " (list\n"
  39054. " (certificate-configuration\n"
  39055. " (domains '(\"example.net\" \"www.example.net\"))\n"
  39056. " (deploy-hook %nginx-deploy-hook))\n"
  39057. " (certificate-configuration\n"
  39058. " (domains '(\"bar.example.net\")))))))\n"
  39059. msgstr ""
  39060. #. type: defvr
  39061. #: guix-git/doc/guix.texi:26223
  39062. msgid "See below for details about @code{certbot-configuration}."
  39063. msgstr ""
  39064. #. type: deftp
  39065. #: guix-git/doc/guix.texi:26225
  39066. #, no-wrap
  39067. msgid "{Data Type} certbot-configuration"
  39068. msgstr ""
  39069. #. type: deftp
  39070. #: guix-git/doc/guix.texi:26228
  39071. msgid "Data type representing the configuration of the @code{certbot} service. This type has the following parameters:"
  39072. msgstr ""
  39073. #. type: item
  39074. #: guix-git/doc/guix.texi:26230
  39075. #, no-wrap
  39076. msgid "@code{package} (default: @code{certbot})"
  39077. msgstr ""
  39078. #. type: table
  39079. #: guix-git/doc/guix.texi:26232
  39080. msgid "The certbot package to use."
  39081. msgstr ""
  39082. #. type: item
  39083. #: guix-git/doc/guix.texi:26233
  39084. #, no-wrap
  39085. msgid "@code{webroot} (default: @code{/var/www})"
  39086. msgstr ""
  39087. #. type: table
  39088. #: guix-git/doc/guix.texi:26236
  39089. msgid "The directory from which to serve the Let's Encrypt challenge/response files."
  39090. msgstr ""
  39091. #. type: item
  39092. #: guix-git/doc/guix.texi:26237
  39093. #, no-wrap
  39094. msgid "@code{certificates} (default: @code{()})"
  39095. msgstr ""
  39096. #. type: table
  39097. #: guix-git/doc/guix.texi:26241
  39098. msgid "A list of @code{certificates-configuration}s for which to generate certificates and request signatures. Each certificate has a @code{name} and several @code{domains}."
  39099. msgstr ""
  39100. #. type: item
  39101. #: guix-git/doc/guix.texi:26242
  39102. #, no-wrap
  39103. msgid "@code{email} (default: @code{#f})"
  39104. msgstr ""
  39105. #. type: table
  39106. #: guix-git/doc/guix.texi:26246
  39107. msgid "Optional email address used for registration and recovery contact. Setting this is encouraged as it allows you to receive important notifications about the account and issued certificates."
  39108. msgstr ""
  39109. #. type: item
  39110. #: guix-git/doc/guix.texi:26247 guix-git/doc/guix.texi:27991
  39111. #, no-wrap
  39112. msgid "@code{server} (default: @code{#f})"
  39113. msgstr ""
  39114. #. type: table
  39115. #: guix-git/doc/guix.texi:26250
  39116. msgid "Optional URL of ACME server. Setting this overrides certbot's default, which is the Let's Encrypt server."
  39117. msgstr ""
  39118. #. type: item
  39119. #: guix-git/doc/guix.texi:26251
  39120. #, no-wrap
  39121. msgid "@code{rsa-key-size} (default: @code{2048})"
  39122. msgstr ""
  39123. #. type: table
  39124. #: guix-git/doc/guix.texi:26253
  39125. msgid "Size of the RSA key."
  39126. msgstr ""
  39127. #. type: item
  39128. #: guix-git/doc/guix.texi:26254
  39129. #, no-wrap
  39130. msgid "@code{default-location} (default: @i{see below})"
  39131. msgstr ""
  39132. #. type: table
  39133. #: guix-git/doc/guix.texi:26263
  39134. msgid "The default @code{nginx-location-configuration}. Because @code{certbot} needs to be able to serve challenges and responses, it needs to be able to run a web server. It does so by extending the @code{nginx} web service with an @code{nginx-server-configuration} listening on the @var{domains} on port 80, and which has a @code{nginx-location-configuration} for the @code{/.well-known/} URI path subspace used by Let's Encrypt. @xref{Web Services}, for more on these nginx configuration data types."
  39135. msgstr ""
  39136. #. type: table
  39137. #: guix-git/doc/guix.texi:26267
  39138. msgid "Requests to other URL paths will be matched by the @code{default-location}, which if present is added to all @code{nginx-server-configuration}s."
  39139. msgstr ""
  39140. #. type: table
  39141. #: guix-git/doc/guix.texi:26271
  39142. msgid "By default, the @code{default-location} will issue a redirect from @code{http://@var{domain}/...} to @code{https://@var{domain}/...}, leaving you to define what to serve on your site via @code{https}."
  39143. msgstr ""
  39144. #. type: table
  39145. #: guix-git/doc/guix.texi:26273
  39146. msgid "Pass @code{#f} to not issue a default location."
  39147. msgstr ""
  39148. #. type: deftp
  39149. #: guix-git/doc/guix.texi:26276
  39150. #, no-wrap
  39151. msgid "{Data Type} certificate-configuration"
  39152. msgstr ""
  39153. #. type: deftp
  39154. #: guix-git/doc/guix.texi:26279
  39155. msgid "Data type representing the configuration of a certificate. This type has the following parameters:"
  39156. msgstr ""
  39157. #. type: item
  39158. #: guix-git/doc/guix.texi:26281
  39159. #, no-wrap
  39160. msgid "@code{name} (default: @i{see below})"
  39161. msgstr ""
  39162. #. type: table
  39163. #: guix-git/doc/guix.texi:26285
  39164. msgid "This name is used by Certbot for housekeeping and in file paths; it doesn't affect the content of the certificate itself. To see certificate names, run @code{certbot certificates}."
  39165. msgstr ""
  39166. #. type: table
  39167. #: guix-git/doc/guix.texi:26287
  39168. msgid "Its default is the first provided domain."
  39169. msgstr ""
  39170. #. type: item
  39171. #: guix-git/doc/guix.texi:26288
  39172. #, no-wrap
  39173. msgid "@code{domains} (default: @code{()})"
  39174. msgstr ""
  39175. #. type: table
  39176. #: guix-git/doc/guix.texi:26291
  39177. msgid "The first domain provided will be the subject CN of the certificate, and all domains will be Subject Alternative Names on the certificate."
  39178. msgstr ""
  39179. #. type: item
  39180. #: guix-git/doc/guix.texi:26292
  39181. #, no-wrap
  39182. msgid "@code{challenge} (default: @code{#f})"
  39183. msgstr ""
  39184. #. type: table
  39185. #: guix-git/doc/guix.texi:26299
  39186. msgid "The challenge type that has to be run by certbot. If @code{#f} is specified, default to the HTTP challenge. If a value is specified, defaults to the manual plugin (see @code{authentication-hook}, @code{cleanup-hook} and the documentation at @url{https://certbot.eff.org/docs/using.html#hooks}), and gives Let's Encrypt permission to log the public IP address of the requesting machine."
  39187. msgstr ""
  39188. #. type: item
  39189. #: guix-git/doc/guix.texi:26300
  39190. #, no-wrap
  39191. msgid "@code{csr} (default: @code{#f})"
  39192. msgstr ""
  39193. #. type: table
  39194. #: guix-git/doc/guix.texi:26307
  39195. msgid "File name of Certificate Signing Request (CSR) in DER or PEM format. If @code{#f} is specified, this argument will not be passed to certbot. If a value is specified, certbot will use it to obtain a certificate, instead of using a self-generated CSR. The domain-name(s) mentioned in @code{domains}, must be consistent with the domain-name(s) mentioned in CSR file."
  39196. msgstr ""
  39197. #. type: item
  39198. #: guix-git/doc/guix.texi:26308
  39199. #, no-wrap
  39200. msgid "@code{authentication-hook} (default: @code{#f})"
  39201. msgstr ""
  39202. #. type: table
  39203. #: guix-git/doc/guix.texi:26314
  39204. msgid "Command to be run in a shell once for each certificate challenge to be answered. For this command, the shell variable @code{$CERTBOT_DOMAIN} will contain the domain being authenticated, @code{$CERTBOT_VALIDATION} contains the validation string and @code{$CERTBOT_TOKEN} contains the file name of the resource requested when performing an HTTP-01 challenge."
  39205. msgstr ""
  39206. #. type: item
  39207. #: guix-git/doc/guix.texi:26315
  39208. #, no-wrap
  39209. msgid "@code{cleanup-hook} (default: @code{#f})"
  39210. msgstr ""
  39211. #. type: table
  39212. #: guix-git/doc/guix.texi:26321
  39213. msgid "Command to be run in a shell once for each certificate challenge that have been answered by the @code{auth-hook}. For this command, the shell variables available in the @code{auth-hook} script are still available, and additionally @code{$CERTBOT_AUTH_OUTPUT} will contain the standard output of the @code{auth-hook} script."
  39214. msgstr ""
  39215. #. type: item
  39216. #: guix-git/doc/guix.texi:26322
  39217. #, no-wrap
  39218. msgid "@code{deploy-hook} (default: @code{#f})"
  39219. msgstr ""
  39220. #. type: table
  39221. #: guix-git/doc/guix.texi:26330
  39222. msgid "Command to be run in a shell once for each successfully issued certificate. For this command, the shell variable @code{$RENEWED_LINEAGE} will point to the config live subdirectory (for example, @samp{\"/etc/letsencrypt/live/example.com\"}) containing the new certificates and keys; the shell variable @code{$RENEWED_DOMAINS} will contain a space-delimited list of renewed certificate domains (for example, @samp{\"example.com www.example.com\"}."
  39223. msgstr ""
  39224. #. type: Plain text
  39225. #: guix-git/doc/guix.texi:26337
  39226. msgid "For each @code{certificate-configuration}, the certificate is saved to @code{/etc/letsencrypt/live/@var{name}/fullchain.pem} and the key is saved to @code{/etc/letsencrypt/live/@var{name}/privkey.pem}."
  39227. msgstr ""
  39228. #. type: cindex
  39229. #: guix-git/doc/guix.texi:26339
  39230. #, no-wrap
  39231. msgid "DNS (domain name system)"
  39232. msgstr ""
  39233. #. type: cindex
  39234. #: guix-git/doc/guix.texi:26340
  39235. #, no-wrap
  39236. msgid "domain name system (DNS)"
  39237. msgstr ""
  39238. #. type: Plain text
  39239. #: guix-git/doc/guix.texi:26348
  39240. msgid "The @code{(gnu services dns)} module provides services related to the @dfn{domain name system} (DNS). It provides a server service for hosting an @emph{authoritative} DNS server for multiple zones, slave or master. This service uses @uref{https://www.knot-dns.cz/, Knot DNS}. And also a caching and forwarding DNS server for the LAN, which uses @uref{http://www.thekelleys.org.uk/dnsmasq/doc.html, dnsmasq}."
  39241. msgstr ""
  39242. #. type: subsubheading
  39243. #: guix-git/doc/guix.texi:26349
  39244. #, no-wrap
  39245. msgid "Knot Service"
  39246. msgstr ""
  39247. #. type: Plain text
  39248. #: guix-git/doc/guix.texi:26353
  39249. msgid "An example configuration of an authoritative server for two zones, one master and one slave, is:"
  39250. msgstr ""
  39251. #. type: lisp
  39252. #: guix-git/doc/guix.texi:26360
  39253. #, no-wrap
  39254. msgid ""
  39255. "(define-zone-entries example.org.zone\n"
  39256. ";; Name TTL Class Type Data\n"
  39257. " (\"@@\" \"\" \"IN\" \"A\" \"127.0.0.1\")\n"
  39258. " (\"@@\" \"\" \"IN\" \"NS\" \"ns\")\n"
  39259. " (\"ns\" \"\" \"IN\" \"A\" \"127.0.0.1\"))\n"
  39260. "\n"
  39261. msgstr ""
  39262. #. type: lisp
  39263. #: guix-git/doc/guix.texi:26367
  39264. #, no-wrap
  39265. msgid ""
  39266. "(define master-zone\n"
  39267. " (knot-zone-configuration\n"
  39268. " (domain \"example.org\")\n"
  39269. " (zone (zone-file\n"
  39270. " (origin \"example.org\")\n"
  39271. " (entries example.org.zone)))))\n"
  39272. "\n"
  39273. msgstr ""
  39274. #. type: lisp
  39275. #: guix-git/doc/guix.texi:26373
  39276. #, no-wrap
  39277. msgid ""
  39278. "(define slave-zone\n"
  39279. " (knot-zone-configuration\n"
  39280. " (domain \"plop.org\")\n"
  39281. " (dnssec-policy \"default\")\n"
  39282. " (master (list \"plop-master\"))))\n"
  39283. "\n"
  39284. msgstr ""
  39285. #. type: lisp
  39286. #: guix-git/doc/guix.texi:26378
  39287. #, no-wrap
  39288. msgid ""
  39289. "(define plop-master\n"
  39290. " (knot-remote-configuration\n"
  39291. " (id \"plop-master\")\n"
  39292. " (address (list \"208.76.58.171\"))))\n"
  39293. "\n"
  39294. msgstr ""
  39295. #. type: lisp
  39296. #: guix-git/doc/guix.texi:26387
  39297. #, no-wrap
  39298. msgid ""
  39299. "(operating-system\n"
  39300. " ;; ...\n"
  39301. " (services (cons* (service knot-service-type\n"
  39302. " (knot-configuration\n"
  39303. " (remotes (list plop-master))\n"
  39304. " (zones (list master-zone slave-zone))))\n"
  39305. " ;; ...\n"
  39306. " %base-services)))\n"
  39307. msgstr ""
  39308. #. type: deffn
  39309. #: guix-git/doc/guix.texi:26389
  39310. #, no-wrap
  39311. msgid "{Scheme Variable} knot-service-type"
  39312. msgstr ""
  39313. #. type: deffn
  39314. #: guix-git/doc/guix.texi:26391
  39315. msgid "This is the type for the Knot DNS server."
  39316. msgstr ""
  39317. #. type: deffn
  39318. #: guix-git/doc/guix.texi:26399
  39319. msgid "Knot DNS is an authoritative DNS server, meaning that it can serve multiple zones, that is to say domain names you would buy from a registrar. This server is not a resolver, meaning that it can only resolve names for which it is authoritative. This server can be configured to serve zones as a master server or a slave server as a per-zone basis. Slave zones will get their data from masters, and will serve it as an authoritative server. From the point of view of a resolver, there is no difference between master and slave."
  39320. msgstr ""
  39321. #. type: deffn
  39322. #: guix-git/doc/guix.texi:26401
  39323. msgid "The following data types are used to configure the Knot DNS server:"
  39324. msgstr ""
  39325. #. type: deftp
  39326. #: guix-git/doc/guix.texi:26403
  39327. #, no-wrap
  39328. msgid "{Data Type} knot-key-configuration"
  39329. msgstr ""
  39330. #. type: deftp
  39331. #: guix-git/doc/guix.texi:26406
  39332. msgid "Data type representing a key. This type has the following parameters:"
  39333. msgstr ""
  39334. #. type: item
  39335. #: guix-git/doc/guix.texi:26408 guix-git/doc/guix.texi:26428
  39336. #: guix-git/doc/guix.texi:26543 guix-git/doc/guix.texi:26569
  39337. #: guix-git/doc/guix.texi:26604
  39338. #, no-wrap
  39339. msgid "@code{id} (default: @code{\"\"})"
  39340. msgstr ""
  39341. #. type: table
  39342. #: guix-git/doc/guix.texi:26411 guix-git/doc/guix.texi:26431
  39343. msgid "An identifier for other configuration fields to refer to this key. IDs must be unique and must not be empty."
  39344. msgstr ""
  39345. #. type: item
  39346. #: guix-git/doc/guix.texi:26412
  39347. #, no-wrap
  39348. msgid "@code{algorithm} (default: @code{#f})"
  39349. msgstr ""
  39350. #. type: table
  39351. #: guix-git/doc/guix.texi:26416
  39352. msgid "The algorithm to use. Choose between @code{#f}, @code{'hmac-md5}, @code{'hmac-sha1}, @code{'hmac-sha224}, @code{'hmac-sha256}, @code{'hmac-sha384} and @code{'hmac-sha512}."
  39353. msgstr ""
  39354. #. type: item
  39355. #: guix-git/doc/guix.texi:26417
  39356. #, no-wrap
  39357. msgid "@code{secret} (default: @code{\"\"})"
  39358. msgstr ""
  39359. #. type: table
  39360. #: guix-git/doc/guix.texi:26419
  39361. msgid "The secret key itself."
  39362. msgstr ""
  39363. #. type: deftp
  39364. #: guix-git/doc/guix.texi:26423
  39365. #, no-wrap
  39366. msgid "{Data Type} knot-acl-configuration"
  39367. msgstr ""
  39368. #. type: deftp
  39369. #: guix-git/doc/guix.texi:26426
  39370. msgid "Data type representing an Access Control List (ACL) configuration. This type has the following parameters:"
  39371. msgstr ""
  39372. #. type: item
  39373. #: guix-git/doc/guix.texi:26432 guix-git/doc/guix.texi:26547
  39374. #, no-wrap
  39375. msgid "@code{address} (default: @code{'()})"
  39376. msgstr ""
  39377. #. type: table
  39378. #: guix-git/doc/guix.texi:26436
  39379. msgid "An ordered list of IP addresses, network subnets, or network ranges represented with strings. The query must match one of them. Empty value means that address match is not required."
  39380. msgstr ""
  39381. #. type: item
  39382. #: guix-git/doc/guix.texi:26437
  39383. #, no-wrap
  39384. msgid "@code{key} (default: @code{'()})"
  39385. msgstr ""
  39386. #. type: table
  39387. #: guix-git/doc/guix.texi:26441
  39388. msgid "An ordered list of references to keys represented with strings. The string must match a key ID defined in a @code{knot-key-configuration}. No key means that a key is not require to match that ACL."
  39389. msgstr ""
  39390. #. type: item
  39391. #: guix-git/doc/guix.texi:26442
  39392. #, no-wrap
  39393. msgid "@code{action} (default: @code{'()})"
  39394. msgstr ""
  39395. #. type: table
  39396. #: guix-git/doc/guix.texi:26446
  39397. msgid "An ordered list of actions that are permitted or forbidden by this ACL@. Possible values are lists of zero or more elements from @code{'transfer}, @code{'notify} and @code{'update}."
  39398. msgstr ""
  39399. #. type: item
  39400. #: guix-git/doc/guix.texi:26447
  39401. #, no-wrap
  39402. msgid "@code{deny?} (default: @code{#f})"
  39403. msgstr ""
  39404. #. type: table
  39405. #: guix-git/doc/guix.texi:26450
  39406. msgid "When true, the ACL defines restrictions. Listed actions are forbidden. When false, listed actions are allowed."
  39407. msgstr ""
  39408. #. type: deftp
  39409. #: guix-git/doc/guix.texi:26454
  39410. #, no-wrap
  39411. msgid "{Data Type} zone-entry"
  39412. msgstr ""
  39413. #. type: deftp
  39414. #: guix-git/doc/guix.texi:26457
  39415. msgid "Data type representing a record entry in a zone file. This type has the following parameters:"
  39416. msgstr ""
  39417. #. type: item
  39418. #: guix-git/doc/guix.texi:26459
  39419. #, no-wrap
  39420. msgid "@code{name} (default: @code{\"@@\"})"
  39421. msgstr ""
  39422. #. type: table
  39423. #: guix-git/doc/guix.texi:26465
  39424. msgid "The name of the record. @code{\"@@\"} refers to the origin of the zone. Names are relative to the origin of the zone. For example, in the @code{example.org} zone, @code{\"ns.example.org\"} actually refers to @code{ns.example.org.example.org}. Names ending with a dot are absolute, which means that @code{\"ns.example.org.\"} refers to @code{ns.example.org}."
  39425. msgstr ""
  39426. #. type: item
  39427. #: guix-git/doc/guix.texi:26466
  39428. #, no-wrap
  39429. msgid "@code{ttl} (default: @code{\"\"})"
  39430. msgstr ""
  39431. #. type: table
  39432. #: guix-git/doc/guix.texi:26468
  39433. msgid "The Time-To-Live (TTL) of this record. If not set, the default TTL is used."
  39434. msgstr ""
  39435. #. type: item
  39436. #: guix-git/doc/guix.texi:26469
  39437. #, no-wrap
  39438. msgid "@code{class} (default: @code{\"IN\"})"
  39439. msgstr ""
  39440. #. type: table
  39441. #: guix-git/doc/guix.texi:26472
  39442. msgid "The class of the record. Knot currently supports only @code{\"IN\"} and partially @code{\"CH\"}."
  39443. msgstr ""
  39444. #. type: item
  39445. #: guix-git/doc/guix.texi:26473
  39446. #, no-wrap
  39447. msgid "@code{type} (default: @code{\"A\"})"
  39448. msgstr ""
  39449. #. type: table
  39450. #: guix-git/doc/guix.texi:26477
  39451. msgid "The type of the record. Common types include A (IPv4 address), AAAA (IPv6 address), NS (Name Server) and MX (Mail eXchange). Many other types are defined."
  39452. msgstr ""
  39453. #. type: item
  39454. #: guix-git/doc/guix.texi:26478
  39455. #, no-wrap
  39456. msgid "@code{data} (default: @code{\"\"})"
  39457. msgstr ""
  39458. #. type: table
  39459. #: guix-git/doc/guix.texi:26482
  39460. msgid "The data contained in the record. For instance an IP address associated with an A record, or a domain name associated with an NS record. Remember that domain names are relative to the origin unless they end with a dot."
  39461. msgstr ""
  39462. #. type: deftp
  39463. #: guix-git/doc/guix.texi:26486
  39464. #, no-wrap
  39465. msgid "{Data Type} zone-file"
  39466. msgstr ""
  39467. #. type: deftp
  39468. #: guix-git/doc/guix.texi:26489
  39469. msgid "Data type representing the content of a zone file. This type has the following parameters:"
  39470. msgstr ""
  39471. #. type: table
  39472. #: guix-git/doc/guix.texi:26498
  39473. msgid "The list of entries. The SOA record is taken care of, so you don't need to put it in the list of entries. This list should probably contain an entry for your primary authoritative DNS server. Other than using a list of entries directly, you can use @code{define-zone-entries} to define a object containing the list of entries more easily, that you can later pass to the @code{entries} field of the @code{zone-file}."
  39474. msgstr ""
  39475. #. type: item
  39476. #: guix-git/doc/guix.texi:26499
  39477. #, no-wrap
  39478. msgid "@code{origin} (default: @code{\"\"})"
  39479. msgstr ""
  39480. #. type: table
  39481. #: guix-git/doc/guix.texi:26501
  39482. msgid "The name of your zone. This parameter cannot be empty."
  39483. msgstr ""
  39484. #. type: item
  39485. #: guix-git/doc/guix.texi:26502
  39486. #, no-wrap
  39487. msgid "@code{ns} (default: @code{\"ns\"})"
  39488. msgstr ""
  39489. #. type: table
  39490. #: guix-git/doc/guix.texi:26507
  39491. msgid "The domain of your primary authoritative DNS server. The name is relative to the origin, unless it ends with a dot. It is mandatory that this primary DNS server corresponds to an NS record in the zone and that it is associated to an IP address in the list of entries."
  39492. msgstr ""
  39493. #. type: item
  39494. #: guix-git/doc/guix.texi:26508
  39495. #, no-wrap
  39496. msgid "@code{mail} (default: @code{\"hostmaster\"})"
  39497. msgstr ""
  39498. #. type: table
  39499. #: guix-git/doc/guix.texi:26511
  39500. msgid "An email address people can contact you at, as the owner of the zone. This is translated as @code{<mail>@@<origin>}."
  39501. msgstr ""
  39502. #. type: item
  39503. #: guix-git/doc/guix.texi:26512
  39504. #, no-wrap
  39505. msgid "@code{serial} (default: @code{1})"
  39506. msgstr ""
  39507. #. type: table
  39508. #: guix-git/doc/guix.texi:26516
  39509. msgid "The serial number of the zone. As this is used to keep track of changes by both slaves and resolvers, it is mandatory that it @emph{never} decreases. Always increment it when you make a change in your zone."
  39510. msgstr ""
  39511. #. type: item
  39512. #: guix-git/doc/guix.texi:26517
  39513. #, no-wrap
  39514. msgid "@code{refresh} (default: @code{(* 2 24 3600)})"
  39515. msgstr ""
  39516. #. type: table
  39517. #: guix-git/doc/guix.texi:26521
  39518. msgid "The frequency at which slaves will do a zone transfer. This value is a number of seconds. It can be computed by multiplications or with @code{(string->duration)}."
  39519. msgstr ""
  39520. #. type: item
  39521. #: guix-git/doc/guix.texi:26522
  39522. #, no-wrap
  39523. msgid "@code{retry} (default: @code{(* 15 60)})"
  39524. msgstr ""
  39525. #. type: table
  39526. #: guix-git/doc/guix.texi:26525
  39527. msgid "The period after which a slave will retry to contact its master when it fails to do so a first time."
  39528. msgstr ""
  39529. #. type: item
  39530. #: guix-git/doc/guix.texi:26526
  39531. #, no-wrap
  39532. msgid "@code{expiry} (default: @code{(* 14 24 3600)})"
  39533. msgstr ""
  39534. #. type: table
  39535. #: guix-git/doc/guix.texi:26530
  39536. msgid "Default TTL of records. Existing records are considered correct for at most this amount of time. After this period, resolvers will invalidate their cache and check again that it still exists."
  39537. msgstr ""
  39538. #. type: item
  39539. #: guix-git/doc/guix.texi:26531
  39540. #, no-wrap
  39541. msgid "@code{nx} (default: @code{3600})"
  39542. msgstr ""
  39543. #. type: table
  39544. #: guix-git/doc/guix.texi:26534
  39545. msgid "Default TTL of inexistent records. This delay is usually short because you want your new domains to reach everyone quickly."
  39546. msgstr ""
  39547. #. type: deftp
  39548. #: guix-git/doc/guix.texi:26538
  39549. #, no-wrap
  39550. msgid "{Data Type} knot-remote-configuration"
  39551. msgstr ""
  39552. #. type: deftp
  39553. #: guix-git/doc/guix.texi:26541
  39554. msgid "Data type representing a remote configuration. This type has the following parameters:"
  39555. msgstr ""
  39556. #. type: table
  39557. #: guix-git/doc/guix.texi:26546
  39558. msgid "An identifier for other configuration fields to refer to this remote. IDs must be unique and must not be empty."
  39559. msgstr ""
  39560. #. type: table
  39561. #: guix-git/doc/guix.texi:26551
  39562. msgid "An ordered list of destination IP addresses. Addresses are tried in sequence. An optional port can be given with the @@ separator. For instance: @code{(list \"1.2.3.4\" \"2.3.4.5@@53\")}. Default port is 53."
  39563. msgstr ""
  39564. #. type: item
  39565. #: guix-git/doc/guix.texi:26552
  39566. #, no-wrap
  39567. msgid "@code{via} (default: @code{'()})"
  39568. msgstr ""
  39569. #. type: table
  39570. #: guix-git/doc/guix.texi:26556
  39571. msgid "An ordered list of source IP addresses. An empty list will have Knot choose an appropriate source IP@. An optional port can be given with the @@ separator. The default is to choose at random."
  39572. msgstr ""
  39573. #. type: table
  39574. #: guix-git/doc/guix.texi:26560
  39575. msgid "A reference to a key, that is a string containing the identifier of a key defined in a @code{knot-key-configuration} field."
  39576. msgstr ""
  39577. #. type: deftp
  39578. #: guix-git/doc/guix.texi:26564
  39579. #, no-wrap
  39580. msgid "{Data Type} knot-keystore-configuration"
  39581. msgstr ""
  39582. #. type: deftp
  39583. #: guix-git/doc/guix.texi:26567
  39584. msgid "Data type representing a keystore to hold dnssec keys. This type has the following parameters:"
  39585. msgstr ""
  39586. #. type: table
  39587. #: guix-git/doc/guix.texi:26571
  39588. msgid "The id of the keystore. It must not be empty."
  39589. msgstr ""
  39590. #. type: item
  39591. #: guix-git/doc/guix.texi:26572
  39592. #, no-wrap
  39593. msgid "@code{backend} (default: @code{'pem})"
  39594. msgstr ""
  39595. #. type: table
  39596. #: guix-git/doc/guix.texi:26574
  39597. msgid "The backend to store the keys in. Can be @code{'pem} or @code{'pkcs11}."
  39598. msgstr ""
  39599. #. type: item
  39600. #: guix-git/doc/guix.texi:26575
  39601. #, no-wrap
  39602. msgid "@code{config} (default: @code{\"/var/lib/knot/keys/keys\"})"
  39603. msgstr ""
  39604. #. type: table
  39605. #: guix-git/doc/guix.texi:26579
  39606. msgid "The configuration string of the backend. An example for the PKCS#11 is: @code{\"pkcs11:token=knot;pin-value=1234 /gnu/store/.../lib/pkcs11/libsofthsm2.so\"}. For the pem backend, the string represents a path in the file system."
  39607. msgstr ""
  39608. #. type: deftp
  39609. #: guix-git/doc/guix.texi:26583
  39610. #, no-wrap
  39611. msgid "{Data Type} knot-policy-configuration"
  39612. msgstr ""
  39613. #. type: deftp
  39614. #: guix-git/doc/guix.texi:26587
  39615. msgid "Data type representing a dnssec policy. Knot DNS is able to automatically sign your zones. It can either generate and manage your keys automatically or use keys that you generate."
  39616. msgstr ""
  39617. #. type: deftp
  39618. #: guix-git/doc/guix.texi:26594
  39619. msgid "Dnssec is usually implemented using two keys: a Key Signing Key (KSK) that is used to sign the second, and a Zone Signing Key (ZSK) that is used to sign the zone. In order to be trusted, the KSK needs to be present in the parent zone (usually a top-level domain). If your registrar supports dnssec, you will have to send them your KSK's hash so they can add a DS record in their zone. This is not automated and need to be done each time you change your KSK."
  39620. msgstr ""
  39621. #. type: deftp
  39622. #: guix-git/doc/guix.texi:26600
  39623. msgid "The policy also defines the lifetime of keys. Usually, ZSK can be changed easily and use weaker cryptographic functions (they use lower parameters) in order to sign records quickly, so they are changed often. The KSK however requires manual interaction with the registrar, so they are changed less often and use stronger parameters because they sign only one record."
  39624. msgstr ""
  39625. #. type: deftp
  39626. #: guix-git/doc/guix.texi:26602
  39627. msgid "This type has the following parameters:"
  39628. msgstr ""
  39629. #. type: table
  39630. #: guix-git/doc/guix.texi:26606
  39631. msgid "The id of the policy. It must not be empty."
  39632. msgstr ""
  39633. #. type: item
  39634. #: guix-git/doc/guix.texi:26607
  39635. #, no-wrap
  39636. msgid "@code{keystore} (default: @code{\"default\"})"
  39637. msgstr ""
  39638. #. type: table
  39639. #: guix-git/doc/guix.texi:26612
  39640. msgid "A reference to a keystore, that is a string containing the identifier of a keystore defined in a @code{knot-keystore-configuration} field. The @code{\"default\"} identifier means the default keystore (a kasp database that was setup by this service)."
  39641. msgstr ""
  39642. #. type: item
  39643. #: guix-git/doc/guix.texi:26613
  39644. #, no-wrap
  39645. msgid "@code{manual?} (default: @code{#f})"
  39646. msgstr ""
  39647. #. type: table
  39648. #: guix-git/doc/guix.texi:26615
  39649. msgid "Whether the key management is manual or automatic."
  39650. msgstr ""
  39651. #. type: item
  39652. #: guix-git/doc/guix.texi:26616
  39653. #, no-wrap
  39654. msgid "@code{single-type-signing?} (default: @code{#f})"
  39655. msgstr ""
  39656. #. type: table
  39657. #: guix-git/doc/guix.texi:26618
  39658. msgid "When @code{#t}, use the Single-Type Signing Scheme."
  39659. msgstr ""
  39660. #. type: item
  39661. #: guix-git/doc/guix.texi:26619
  39662. #, no-wrap
  39663. msgid "@code{algorithm} (default: @code{\"ecdsap256sha256\"})"
  39664. msgstr ""
  39665. #. type: table
  39666. #: guix-git/doc/guix.texi:26621
  39667. msgid "An algorithm of signing keys and issued signatures."
  39668. msgstr ""
  39669. #. type: item
  39670. #: guix-git/doc/guix.texi:26622
  39671. #, no-wrap
  39672. msgid "@code{ksk-size} (default: @code{256})"
  39673. msgstr ""
  39674. #. type: table
  39675. #: guix-git/doc/guix.texi:26625
  39676. msgid "The length of the KSK@. Note that this value is correct for the default algorithm, but would be unsecure for other algorithms."
  39677. msgstr ""
  39678. #. type: item
  39679. #: guix-git/doc/guix.texi:26626
  39680. #, no-wrap
  39681. msgid "@code{zsk-size} (default: @code{256})"
  39682. msgstr ""
  39683. #. type: table
  39684. #: guix-git/doc/guix.texi:26629
  39685. msgid "The length of the ZSK@. Note that this value is correct for the default algorithm, but would be unsecure for other algorithms."
  39686. msgstr ""
  39687. #. type: item
  39688. #: guix-git/doc/guix.texi:26630
  39689. #, no-wrap
  39690. msgid "@code{dnskey-ttl} (default: @code{'default})"
  39691. msgstr ""
  39692. #. type: table
  39693. #: guix-git/doc/guix.texi:26633
  39694. msgid "The TTL value for DNSKEY records added into zone apex. The special @code{'default} value means same as the zone SOA TTL."
  39695. msgstr ""
  39696. #. type: item
  39697. #: guix-git/doc/guix.texi:26634
  39698. #, no-wrap
  39699. msgid "@code{zsk-lifetime} (default: @code{(* 30 24 3600)})"
  39700. msgstr ""
  39701. #. type: table
  39702. #: guix-git/doc/guix.texi:26636
  39703. msgid "The period between ZSK publication and the next rollover initiation."
  39704. msgstr ""
  39705. #. type: item
  39706. #: guix-git/doc/guix.texi:26637
  39707. #, no-wrap
  39708. msgid "@code{propagation-delay} (default: @code{(* 24 3600)})"
  39709. msgstr ""
  39710. #. type: table
  39711. #: guix-git/doc/guix.texi:26640
  39712. msgid "An extra delay added for each key rollover step. This value should be high enough to cover propagation of data from the master server to all slaves."
  39713. msgstr ""
  39714. #. type: item
  39715. #: guix-git/doc/guix.texi:26641
  39716. #, no-wrap
  39717. msgid "@code{rrsig-lifetime} (default: @code{(* 14 24 3600)})"
  39718. msgstr ""
  39719. #. type: table
  39720. #: guix-git/doc/guix.texi:26643
  39721. msgid "A validity period of newly issued signatures."
  39722. msgstr ""
  39723. #. type: item
  39724. #: guix-git/doc/guix.texi:26644
  39725. #, no-wrap
  39726. msgid "@code{rrsig-refresh} (default: @code{(* 7 24 3600)})"
  39727. msgstr ""
  39728. #. type: table
  39729. #: guix-git/doc/guix.texi:26646
  39730. msgid "A period how long before a signature expiration the signature will be refreshed."
  39731. msgstr ""
  39732. #. type: item
  39733. #: guix-git/doc/guix.texi:26647
  39734. #, no-wrap
  39735. msgid "@code{nsec3?} (default: @code{#f})"
  39736. msgstr ""
  39737. #. type: table
  39738. #: guix-git/doc/guix.texi:26649
  39739. msgid "When @code{#t}, NSEC3 will be used instead of NSEC."
  39740. msgstr ""
  39741. #. type: item
  39742. #: guix-git/doc/guix.texi:26650
  39743. #, no-wrap
  39744. msgid "@code{nsec3-iterations} (default: @code{5})"
  39745. msgstr ""
  39746. #. type: table
  39747. #: guix-git/doc/guix.texi:26652
  39748. msgid "The number of additional times the hashing is performed."
  39749. msgstr ""
  39750. #. type: item
  39751. #: guix-git/doc/guix.texi:26653
  39752. #, no-wrap
  39753. msgid "@code{nsec3-salt-length} (default: @code{8})"
  39754. msgstr ""
  39755. #. type: table
  39756. #: guix-git/doc/guix.texi:26656
  39757. msgid "The length of a salt field in octets, which is appended to the original owner name before hashing."
  39758. msgstr ""
  39759. #. type: item
  39760. #: guix-git/doc/guix.texi:26657
  39761. #, no-wrap
  39762. msgid "@code{nsec3-salt-lifetime} (default: @code{(* 30 24 3600)})"
  39763. msgstr ""
  39764. #. type: table
  39765. #: guix-git/doc/guix.texi:26659
  39766. msgid "The validity period of newly issued salt field."
  39767. msgstr ""
  39768. #. type: deftp
  39769. #: guix-git/doc/guix.texi:26663
  39770. #, no-wrap
  39771. msgid "{Data Type} knot-zone-configuration"
  39772. msgstr ""
  39773. #. type: deftp
  39774. #: guix-git/doc/guix.texi:26666
  39775. msgid "Data type representing a zone served by Knot. This type has the following parameters:"
  39776. msgstr ""
  39777. #. type: item
  39778. #: guix-git/doc/guix.texi:26668
  39779. #, no-wrap
  39780. msgid "@code{domain} (default: @code{\"\"})"
  39781. msgstr ""
  39782. #. type: table
  39783. #: guix-git/doc/guix.texi:26670
  39784. msgid "The domain served by this configuration. It must not be empty."
  39785. msgstr ""
  39786. #. type: item
  39787. #: guix-git/doc/guix.texi:26671
  39788. #, no-wrap
  39789. msgid "@code{file} (default: @code{\"\"})"
  39790. msgstr ""
  39791. #. type: table
  39792. #: guix-git/doc/guix.texi:26674
  39793. msgid "The file where this zone is saved. This parameter is ignored by master zones. Empty means default location that depends on the domain name."
  39794. msgstr ""
  39795. #. type: item
  39796. #: guix-git/doc/guix.texi:26675
  39797. #, no-wrap
  39798. msgid "@code{zone} (default: @code{(zone-file)})"
  39799. msgstr ""
  39800. #. type: table
  39801. #: guix-git/doc/guix.texi:26678
  39802. msgid "The content of the zone file. This parameter is ignored by slave zones. It must contain a zone-file record."
  39803. msgstr ""
  39804. #. type: item
  39805. #: guix-git/doc/guix.texi:26679
  39806. #, no-wrap
  39807. msgid "@code{master} (default: @code{'()})"
  39808. msgstr ""
  39809. #. type: table
  39810. #: guix-git/doc/guix.texi:26682
  39811. msgid "A list of master remotes. When empty, this zone is a master. When set, this zone is a slave. This is a list of remotes identifiers."
  39812. msgstr ""
  39813. #. type: item
  39814. #: guix-git/doc/guix.texi:26683
  39815. #, no-wrap
  39816. msgid "@code{ddns-master} (default: @code{#f})"
  39817. msgstr ""
  39818. #. type: table
  39819. #: guix-git/doc/guix.texi:26686
  39820. msgid "The main master. When empty, it defaults to the first master in the list of masters."
  39821. msgstr ""
  39822. #. type: item
  39823. #: guix-git/doc/guix.texi:26687
  39824. #, no-wrap
  39825. msgid "@code{notify} (default: @code{'()})"
  39826. msgstr ""
  39827. #. type: table
  39828. #: guix-git/doc/guix.texi:26689
  39829. msgid "A list of slave remote identifiers."
  39830. msgstr ""
  39831. #. type: item
  39832. #: guix-git/doc/guix.texi:26690
  39833. #, no-wrap
  39834. msgid "@code{acl} (default: @code{'()})"
  39835. msgstr ""
  39836. #. type: table
  39837. #: guix-git/doc/guix.texi:26692
  39838. msgid "A list of acl identifiers."
  39839. msgstr ""
  39840. #. type: item
  39841. #: guix-git/doc/guix.texi:26693
  39842. #, no-wrap
  39843. msgid "@code{semantic-checks?} (default: @code{#f})"
  39844. msgstr ""
  39845. #. type: table
  39846. #: guix-git/doc/guix.texi:26695
  39847. msgid "When set, this adds more semantic checks to the zone."
  39848. msgstr ""
  39849. #. type: item
  39850. #: guix-git/doc/guix.texi:26696
  39851. #, no-wrap
  39852. msgid "@code{disable-any?} (default: @code{#f})"
  39853. msgstr ""
  39854. #. type: table
  39855. #: guix-git/doc/guix.texi:26698
  39856. msgid "When set, this forbids queries of the ANY type."
  39857. msgstr ""
  39858. #. type: item
  39859. #: guix-git/doc/guix.texi:26699
  39860. #, no-wrap
  39861. msgid "@code{zonefile-sync} (default: @code{0})"
  39862. msgstr ""
  39863. #. type: table
  39864. #: guix-git/doc/guix.texi:26702
  39865. msgid "The delay between a modification in memory and on disk. 0 means immediate synchronization."
  39866. msgstr ""
  39867. #. type: item
  39868. #: guix-git/doc/guix.texi:26703
  39869. #, no-wrap
  39870. msgid "@code{zonefile-load} (default: @code{#f})"
  39871. msgstr ""
  39872. #. type: table
  39873. #: guix-git/doc/guix.texi:26706
  39874. msgid "The way the zone file contents are applied during zone load. Possible values are:"
  39875. msgstr ""
  39876. #. type: item
  39877. #: guix-git/doc/guix.texi:26708
  39878. #, no-wrap
  39879. msgid "@code{#f} for using the default value from Knot,"
  39880. msgstr ""
  39881. #. type: item
  39882. #: guix-git/doc/guix.texi:26709
  39883. #, no-wrap
  39884. msgid "@code{'none} for not using the zone file at all,"
  39885. msgstr ""
  39886. #. type: item
  39887. #: guix-git/doc/guix.texi:26710
  39888. #, no-wrap
  39889. msgid "@code{'difference} for computing the difference between already available"
  39890. msgstr ""
  39891. #. type: itemize
  39892. #: guix-git/doc/guix.texi:26712
  39893. msgid "contents and zone contents and applying it to the current zone contents,"
  39894. msgstr ""
  39895. #. type: item
  39896. #: guix-git/doc/guix.texi:26712
  39897. #, no-wrap
  39898. msgid "@code{'difference-no-serial} for the same as @code{'difference}, but"
  39899. msgstr ""
  39900. #. type: itemize
  39901. #: guix-git/doc/guix.texi:26715
  39902. msgid "ignoring the SOA serial in the zone file, while the server takes care of it automatically."
  39903. msgstr ""
  39904. #. type: item
  39905. #: guix-git/doc/guix.texi:26715
  39906. #, no-wrap
  39907. msgid "@code{'whole} for loading zone contents from the zone file."
  39908. msgstr ""
  39909. #. type: item
  39910. #: guix-git/doc/guix.texi:26718
  39911. #, no-wrap
  39912. msgid "@code{journal-content} (default: @code{#f})"
  39913. msgstr ""
  39914. #. type: table
  39915. #: guix-git/doc/guix.texi:26723
  39916. msgid "The way the journal is used to store zone and its changes. Possible values are @code{'none} to not use it at all, @code{'changes} to store changes and @code{'all} to store contents. @code{#f} does not set this option, so the default value from Knot is used."
  39917. msgstr ""
  39918. #. type: item
  39919. #: guix-git/doc/guix.texi:26724
  39920. #, no-wrap
  39921. msgid "@code{max-journal-usage} (default: @code{#f})"
  39922. msgstr ""
  39923. #. type: table
  39924. #: guix-git/doc/guix.texi:26727
  39925. msgid "The maximum size for the journal on disk. @code{#f} does not set this option, so the default value from Knot is used."
  39926. msgstr ""
  39927. #. type: item
  39928. #: guix-git/doc/guix.texi:26728
  39929. #, no-wrap
  39930. msgid "@code{max-journal-depth} (default: @code{#f})"
  39931. msgstr ""
  39932. #. type: table
  39933. #: guix-git/doc/guix.texi:26731
  39934. msgid "The maximum size of the history. @code{#f} does not set this option, so the default value from Knot is used."
  39935. msgstr ""
  39936. #. type: item
  39937. #: guix-git/doc/guix.texi:26732
  39938. #, no-wrap
  39939. msgid "@code{max-zone-size} (default: @code{#f})"
  39940. msgstr ""
  39941. #. type: table
  39942. #: guix-git/doc/guix.texi:26736
  39943. msgid "The maximum size of the zone file. This limit is enforced for incoming transfer and updates. @code{#f} does not set this option, so the default value from Knot is used."
  39944. msgstr ""
  39945. #. type: item
  39946. #: guix-git/doc/guix.texi:26737
  39947. #, no-wrap
  39948. msgid "@code{dnssec-policy} (default: @code{#f})"
  39949. msgstr ""
  39950. #. type: table
  39951. #: guix-git/doc/guix.texi:26741
  39952. msgid "A reference to a @code{knot-policy-configuration} record, or the special name @code{\"default\"}. If the value is @code{#f}, there is no dnssec signing on this zone."
  39953. msgstr ""
  39954. #. type: item
  39955. #: guix-git/doc/guix.texi:26742
  39956. #, no-wrap
  39957. msgid "@code{serial-policy} (default: @code{'increment})"
  39958. msgstr ""
  39959. #. type: table
  39960. #: guix-git/doc/guix.texi:26744
  39961. msgid "A policy between @code{'increment} and @code{'unixtime}."
  39962. msgstr ""
  39963. #. type: deftp
  39964. #: guix-git/doc/guix.texi:26748
  39965. #, no-wrap
  39966. msgid "{Data Type} knot-configuration"
  39967. msgstr ""
  39968. #. type: deftp
  39969. #: guix-git/doc/guix.texi:26751
  39970. msgid "Data type representing the Knot configuration. This type has the following parameters:"
  39971. msgstr ""
  39972. #. type: item
  39973. #: guix-git/doc/guix.texi:26753
  39974. #, no-wrap
  39975. msgid "@code{knot} (default: @code{knot})"
  39976. msgstr ""
  39977. #. type: table
  39978. #: guix-git/doc/guix.texi:26755
  39979. msgid "The Knot package."
  39980. msgstr ""
  39981. #. type: item
  39982. #: guix-git/doc/guix.texi:26756
  39983. #, no-wrap
  39984. msgid "@code{run-directory} (default: @code{\"/var/run/knot\"})"
  39985. msgstr ""
  39986. #. type: table
  39987. #: guix-git/doc/guix.texi:26758
  39988. msgid "The run directory. This directory will be used for pid file and sockets."
  39989. msgstr ""
  39990. #. type: item
  39991. #: guix-git/doc/guix.texi:26759
  39992. #, no-wrap
  39993. msgid "@code{includes} (default: @code{'()})"
  39994. msgstr ""
  39995. #. type: table
  39996. #: guix-git/doc/guix.texi:26762
  39997. msgid "A list of strings or file-like objects denoting other files that must be included at the top of the configuration file."
  39998. msgstr ""
  39999. #. type: cindex
  40000. #: guix-git/doc/guix.texi:26763
  40001. #, no-wrap
  40002. msgid "secrets, Knot service"
  40003. msgstr ""
  40004. #. type: table
  40005. #: guix-git/doc/guix.texi:26769
  40006. msgid "This can be used to manage secrets out-of-band. For example, secret keys may be stored in an out-of-band file not managed by Guix, and thus not visible in @file{/gnu/store}---e.g., you could store secret key configuration in @file{/etc/knot/secrets.conf} and add this file to the @code{includes} list."
  40007. msgstr ""
  40008. #. type: table
  40009. #: guix-git/doc/guix.texi:26774
  40010. msgid "One can generate a secret tsig key (for nsupdate and zone transfers with the keymgr command from the knot package. Note that the package is not automatically installed by the service. The following example shows how to generate a new tsig key:"
  40011. msgstr ""
  40012. #. type: example
  40013. #: guix-git/doc/guix.texi:26778
  40014. #, no-wrap
  40015. msgid ""
  40016. "keymgr -t mysecret > /etc/knot/secrets.conf\n"
  40017. "chmod 600 /etc/knot/secrets.conf\n"
  40018. msgstr ""
  40019. #. type: table
  40020. #: guix-git/doc/guix.texi:26784
  40021. msgid "Also note that the generated key will be named @var{mysecret}, so it is the name that needs to be used in the @var{key} field of the @code{knot-acl-configuration} record and in other places that need to refer to that key."
  40022. msgstr ""
  40023. #. type: table
  40024. #: guix-git/doc/guix.texi:26786
  40025. msgid "It can also be used to add configuration not supported by this interface."
  40026. msgstr ""
  40027. #. type: item
  40028. #: guix-git/doc/guix.texi:26787
  40029. #, no-wrap
  40030. msgid "@code{listen-v4} (default: @code{\"0.0.0.0\"})"
  40031. msgstr ""
  40032. #. type: table
  40033. #: guix-git/doc/guix.texi:26789 guix-git/doc/guix.texi:26792
  40034. msgid "An ip address on which to listen."
  40035. msgstr ""
  40036. #. type: item
  40037. #: guix-git/doc/guix.texi:26790
  40038. #, no-wrap
  40039. msgid "@code{listen-v6} (default: @code{\"::\"})"
  40040. msgstr ""
  40041. #. type: item
  40042. #: guix-git/doc/guix.texi:26793
  40043. #, no-wrap
  40044. msgid "@code{listen-port} (default: @code{53})"
  40045. msgstr ""
  40046. #. type: table
  40047. #: guix-git/doc/guix.texi:26795
  40048. msgid "A port on which to listen."
  40049. msgstr ""
  40050. #. type: item
  40051. #: guix-git/doc/guix.texi:26796
  40052. #, no-wrap
  40053. msgid "@code{keys} (default: @code{'()})"
  40054. msgstr ""
  40055. #. type: table
  40056. #: guix-git/doc/guix.texi:26798
  40057. msgid "The list of knot-key-configuration used by this configuration."
  40058. msgstr ""
  40059. #. type: item
  40060. #: guix-git/doc/guix.texi:26799
  40061. #, no-wrap
  40062. msgid "@code{acls} (default: @code{'()})"
  40063. msgstr ""
  40064. #. type: table
  40065. #: guix-git/doc/guix.texi:26801
  40066. msgid "The list of knot-acl-configuration used by this configuration."
  40067. msgstr ""
  40068. #. type: item
  40069. #: guix-git/doc/guix.texi:26802
  40070. #, no-wrap
  40071. msgid "@code{remotes} (default: @code{'()})"
  40072. msgstr ""
  40073. #. type: table
  40074. #: guix-git/doc/guix.texi:26804
  40075. msgid "The list of knot-remote-configuration used by this configuration."
  40076. msgstr ""
  40077. #. type: item
  40078. #: guix-git/doc/guix.texi:26805
  40079. #, no-wrap
  40080. msgid "@code{zones} (default: @code{'()})"
  40081. msgstr ""
  40082. #. type: table
  40083. #: guix-git/doc/guix.texi:26807
  40084. msgid "The list of knot-zone-configuration used by this configuration."
  40085. msgstr ""
  40086. #. type: subsubheading
  40087. #: guix-git/doc/guix.texi:26811
  40088. #, no-wrap
  40089. msgid "Knot Resolver Service"
  40090. msgstr ""
  40091. #. type: deffn
  40092. #: guix-git/doc/guix.texi:26813
  40093. #, no-wrap
  40094. msgid "{Scheme Variable} knot-resolver-service-type"
  40095. msgstr ""
  40096. #. type: deffn
  40097. #: guix-git/doc/guix.texi:26816
  40098. msgid "This is the type of the knot resolver service, whose value should be an @code{knot-resolver-configuration} object as in this example:"
  40099. msgstr ""
  40100. #. type: lisp
  40101. #: guix-git/doc/guix.texi:26826
  40102. #, no-wrap
  40103. msgid ""
  40104. "(service knot-resolver-service-type\n"
  40105. " (knot-resolver-configuration\n"
  40106. " (kresd-config-file (plain-file \"kresd.conf\" \"\n"
  40107. "net.listen('192.168.0.1', 5353)\n"
  40108. "user('knot-resolver', 'knot-resolver')\n"
  40109. "modules = @{ 'hints > iterate', 'stats', 'predict' @}\n"
  40110. "cache.size = 100 * MB\n"
  40111. "\"))))\n"
  40112. msgstr ""
  40113. #. type: deffn
  40114. #: guix-git/doc/guix.texi:26829
  40115. msgid "For more information, refer its @url{https://knot-resolver.readthedocs.org/en/stable/daemon.html#configuration, manual}."
  40116. msgstr ""
  40117. #. type: deftp
  40118. #: guix-git/doc/guix.texi:26831
  40119. #, no-wrap
  40120. msgid "{Data Type} knot-resolver-configuration"
  40121. msgstr ""
  40122. #. type: deftp
  40123. #: guix-git/doc/guix.texi:26833
  40124. msgid "Data type representing the configuration of knot-resolver."
  40125. msgstr ""
  40126. #. type: item
  40127. #: guix-git/doc/guix.texi:26835
  40128. #, no-wrap
  40129. msgid "@code{package} (default: @var{knot-resolver})"
  40130. msgstr ""
  40131. #. type: table
  40132. #: guix-git/doc/guix.texi:26837
  40133. msgid "Package object of the knot DNS resolver."
  40134. msgstr ""
  40135. #. type: item
  40136. #: guix-git/doc/guix.texi:26838
  40137. #, no-wrap
  40138. msgid "@code{kresd-config-file} (default: %kresd.conf)"
  40139. msgstr ""
  40140. #. type: table
  40141. #: guix-git/doc/guix.texi:26841
  40142. msgid "File-like object of the kresd configuration file to use, by default it will listen on @code{127.0.0.1} and @code{::1}."
  40143. msgstr ""
  40144. #. type: item
  40145. #: guix-git/doc/guix.texi:26842
  40146. #, no-wrap
  40147. msgid "@code{garbage-collection-interval} (default: 1000)"
  40148. msgstr ""
  40149. #. type: table
  40150. #: guix-git/doc/guix.texi:26844
  40151. msgid "Number of milliseconds for @code{kres-cache-gc} to periodically trim the cache."
  40152. msgstr ""
  40153. #. type: subsubheading
  40154. #: guix-git/doc/guix.texi:26849
  40155. #, no-wrap
  40156. msgid "Dnsmasq Service"
  40157. msgstr ""
  40158. #. type: deffn
  40159. #: guix-git/doc/guix.texi:26851
  40160. #, no-wrap
  40161. msgid "{Scheme Variable} dnsmasq-service-type"
  40162. msgstr ""
  40163. #. type: deffn
  40164. #: guix-git/doc/guix.texi:26854
  40165. msgid "This is the type of the dnsmasq service, whose value should be an @code{dnsmasq-configuration} object as in this example:"
  40166. msgstr ""
  40167. #. type: lisp
  40168. #: guix-git/doc/guix.texi:26860
  40169. #, no-wrap
  40170. msgid ""
  40171. "(service dnsmasq-service-type\n"
  40172. " (dnsmasq-configuration\n"
  40173. " (no-resolv? #t)\n"
  40174. " (servers '(\"192.168.1.1\"))))\n"
  40175. msgstr ""
  40176. #. type: deftp
  40177. #: guix-git/doc/guix.texi:26863
  40178. #, no-wrap
  40179. msgid "{Data Type} dnsmasq-configuration"
  40180. msgstr ""
  40181. #. type: deftp
  40182. #: guix-git/doc/guix.texi:26865
  40183. msgid "Data type representing the configuration of dnsmasq."
  40184. msgstr ""
  40185. #. type: item
  40186. #: guix-git/doc/guix.texi:26867
  40187. #, no-wrap
  40188. msgid "@code{package} (default: @var{dnsmasq})"
  40189. msgstr ""
  40190. #. type: table
  40191. #: guix-git/doc/guix.texi:26869
  40192. msgid "Package object of the dnsmasq server."
  40193. msgstr ""
  40194. #. type: item
  40195. #: guix-git/doc/guix.texi:26870
  40196. #, no-wrap
  40197. msgid "@code{no-hosts?} (default: @code{#f})"
  40198. msgstr ""
  40199. #. type: table
  40200. #: guix-git/doc/guix.texi:26872
  40201. msgid "When true, don't read the hostnames in /etc/hosts."
  40202. msgstr ""
  40203. #. type: item
  40204. #: guix-git/doc/guix.texi:26873
  40205. #, no-wrap
  40206. msgid "@code{port} (default: @code{53})"
  40207. msgstr ""
  40208. #. type: table
  40209. #: guix-git/doc/guix.texi:26876
  40210. msgid "The port to listen on. Setting this to zero completely disables DNS responses, leaving only DHCP and/or TFTP functions."
  40211. msgstr ""
  40212. #. type: item
  40213. #: guix-git/doc/guix.texi:26877
  40214. #, no-wrap
  40215. msgid "@code{local-service?} (default: @code{#t})"
  40216. msgstr ""
  40217. #. type: table
  40218. #: guix-git/doc/guix.texi:26880
  40219. msgid "Accept DNS queries only from hosts whose address is on a local subnet, ie a subnet for which an interface exists on the server."
  40220. msgstr ""
  40221. #. type: item
  40222. #: guix-git/doc/guix.texi:26881
  40223. #, no-wrap
  40224. msgid "@code{listen-addresses} (default: @code{'()})"
  40225. msgstr ""
  40226. #. type: table
  40227. #: guix-git/doc/guix.texi:26883
  40228. msgid "Listen on the given IP addresses."
  40229. msgstr ""
  40230. #. type: item
  40231. #: guix-git/doc/guix.texi:26884
  40232. #, no-wrap
  40233. msgid "@code{resolv-file} (default: @code{\"/etc/resolv.conf\"})"
  40234. msgstr ""
  40235. #. type: table
  40236. #: guix-git/doc/guix.texi:26886
  40237. msgid "The file to read the IP address of the upstream nameservers from."
  40238. msgstr ""
  40239. #. type: item
  40240. #: guix-git/doc/guix.texi:26887
  40241. #, no-wrap
  40242. msgid "@code{no-resolv?} (default: @code{#f})"
  40243. msgstr ""
  40244. #. type: table
  40245. #: guix-git/doc/guix.texi:26889
  40246. msgid "When true, don't read @var{resolv-file}."
  40247. msgstr ""
  40248. #. type: item
  40249. #: guix-git/doc/guix.texi:26890
  40250. #, no-wrap
  40251. msgid "@code{servers} (default: @code{'()})"
  40252. msgstr ""
  40253. #. type: table
  40254. #: guix-git/doc/guix.texi:26892
  40255. msgid "Specify IP address of upstream servers directly."
  40256. msgstr ""
  40257. #. type: item
  40258. #: guix-git/doc/guix.texi:26893
  40259. #, no-wrap
  40260. msgid "@code{addresses} (default: @code{'()})"
  40261. msgstr ""
  40262. #. type: table
  40263. #: guix-git/doc/guix.texi:26897
  40264. msgid "For each entry, specify an IP address to return for any host in the given domains. Queries in the domains are never forwarded and always replied to with the specified IP address."
  40265. msgstr ""
  40266. #. type: table
  40267. #: guix-git/doc/guix.texi:26899
  40268. msgid "This is useful for redirecting hosts locally, for example:"
  40269. msgstr ""
  40270. #. type: lisp
  40271. #: guix-git/doc/guix.texi:26908
  40272. #, no-wrap
  40273. msgid ""
  40274. "(service dnsmasq-service-type\n"
  40275. " (dnsmasq-configuration\n"
  40276. " (addresses\n"
  40277. " '(; Redirect to a local web-server.\n"
  40278. " \"/example.org/127.0.0.1\"\n"
  40279. " ; Redirect subdomain to a specific IP.\n"
  40280. " \"/subdomain.example.org/192.168.1.42\"))))\n"
  40281. msgstr ""
  40282. #. type: table
  40283. #: guix-git/doc/guix.texi:26911
  40284. msgid "Note that rules in @file{/etc/hosts} take precedence over this."
  40285. msgstr ""
  40286. #. type: item
  40287. #: guix-git/doc/guix.texi:26912
  40288. #, no-wrap
  40289. msgid "@code{cache-size} (default: @code{150})"
  40290. msgstr ""
  40291. #. type: table
  40292. #: guix-git/doc/guix.texi:26915
  40293. msgid "Set the size of dnsmasq's cache. Setting the cache size to zero disables caching."
  40294. msgstr ""
  40295. #. type: item
  40296. #: guix-git/doc/guix.texi:26916
  40297. #, no-wrap
  40298. msgid "@code{negative-cache?} (default: @code{#t})"
  40299. msgstr ""
  40300. #. type: table
  40301. #: guix-git/doc/guix.texi:26918
  40302. msgid "When false, disable negative caching."
  40303. msgstr ""
  40304. #. type: item
  40305. #: guix-git/doc/guix.texi:26919
  40306. #, no-wrap
  40307. msgid "@code{tftp-enable?} (default: @code{#f})"
  40308. msgstr ""
  40309. #. type: table
  40310. #: guix-git/doc/guix.texi:26921
  40311. msgid "Whether to enable the built-in TFTP server."
  40312. msgstr ""
  40313. #. type: item
  40314. #: guix-git/doc/guix.texi:26922
  40315. #, no-wrap
  40316. msgid "@code{tftp-no-fail?} (default: @code{#f})"
  40317. msgstr ""
  40318. #. type: table
  40319. #: guix-git/doc/guix.texi:26924
  40320. msgid "If true, does not fail dnsmasq if the TFTP server could not start up."
  40321. msgstr ""
  40322. #. type: item
  40323. #: guix-git/doc/guix.texi:26925
  40324. #, no-wrap
  40325. msgid "@code{tftp-single-port?} (default: @code{#f})"
  40326. msgstr ""
  40327. #. type: table
  40328. #: guix-git/doc/guix.texi:26927
  40329. msgid "Whether to use only one single port for TFTP."
  40330. msgstr ""
  40331. #. type: item
  40332. #: guix-git/doc/guix.texi:26928
  40333. #, no-wrap
  40334. msgid "@code{tftp-secure?} (default: @code{#f})"
  40335. msgstr ""
  40336. #. type: table
  40337. #: guix-git/doc/guix.texi:26930
  40338. msgid "If true, only files owned by the user running the dnsmasq process are accessible."
  40339. msgstr ""
  40340. #. type: table
  40341. #: guix-git/doc/guix.texi:26934
  40342. msgid "If dnsmasq is being run as root, different rules apply: @code{tftp-secure?} has no effect, but only files which have the world-readable bit set are accessible."
  40343. msgstr ""
  40344. #. type: item
  40345. #: guix-git/doc/guix.texi:26935
  40346. #, no-wrap
  40347. msgid "@code{tftp-max} (default: @code{#f})"
  40348. msgstr ""
  40349. #. type: table
  40350. #: guix-git/doc/guix.texi:26937
  40351. msgid "If set, sets the maximal number of concurrent connections allowed."
  40352. msgstr ""
  40353. #. type: item
  40354. #: guix-git/doc/guix.texi:26938
  40355. #, no-wrap
  40356. msgid "@code{tftp-mtu} (default: @code{#f})"
  40357. msgstr ""
  40358. #. type: table
  40359. #: guix-git/doc/guix.texi:26940
  40360. msgid "If set, sets the MTU for TFTP packets to that value."
  40361. msgstr ""
  40362. #. type: item
  40363. #: guix-git/doc/guix.texi:26941
  40364. #, no-wrap
  40365. msgid "@code{tftp-no-blocksize?} (default: @code{#f})"
  40366. msgstr ""
  40367. #. type: table
  40368. #: guix-git/doc/guix.texi:26943
  40369. msgid "If true, stops the TFTP server from negotiating the blocksize with a client."
  40370. msgstr ""
  40371. #. type: item
  40372. #: guix-git/doc/guix.texi:26944
  40373. #, no-wrap
  40374. msgid "@code{tftp-lowercase?} (default: @code{#f})"
  40375. msgstr ""
  40376. #. type: table
  40377. #: guix-git/doc/guix.texi:26946
  40378. msgid "Whether to convert all filenames in TFTP requests to lowercase."
  40379. msgstr ""
  40380. #. type: item
  40381. #: guix-git/doc/guix.texi:26947
  40382. #, no-wrap
  40383. msgid "@code{tftp-port-range} (default: @code{#f})"
  40384. msgstr ""
  40385. #. type: table
  40386. #: guix-git/doc/guix.texi:26950
  40387. msgid "If set, fixes the dynamical ports (one per client) to the given range (@code{\"<start>,<end>\"})."
  40388. msgstr ""
  40389. #. type: item
  40390. #: guix-git/doc/guix.texi:26951
  40391. #, no-wrap
  40392. msgid "@code{tftp-root} (default: @code{/var/empty,lo})"
  40393. msgstr ""
  40394. #. type: table
  40395. #: guix-git/doc/guix.texi:26958
  40396. msgid "Look for files to transfer using TFTP relative to the given directory. When this is set, TFTP paths which include @samp{..} are rejected, to stop clients getting outside the specified root. Absolute paths (starting with @samp{/}) are allowed, but they must be within the TFTP-root. If the optional interface argument is given, the directory is only used for TFTP requests via that interface."
  40397. msgstr ""
  40398. #. type: item
  40399. #: guix-git/doc/guix.texi:26959
  40400. #, no-wrap
  40401. msgid "@code{tftp-unique-root} (default: @code{#f})"
  40402. msgstr ""
  40403. #. type: table
  40404. #: guix-git/doc/guix.texi:26964
  40405. msgid "If set, add the IP or hardware address of the TFTP client as a path component on the end of the TFTP-root. Only valid if a TFTP root is set and the directory exists. Defaults to adding IP address (in standard dotted-quad format)."
  40406. msgstr ""
  40407. #. type: table
  40408. #: guix-git/doc/guix.texi:26973
  40409. msgid "For instance, if @option{--tftp-root} is @samp{/tftp} and client @samp{1.2.3.4} requests file @file{myfile} then the effective path will be @file{/tftp/1.2.3.4/myfile} if @file{/tftp/1.2.3.4} exists or @file{/tftp/myfile} otherwise. When @samp{=mac} is specified it will append the MAC address instead, using lowercase zero padded digits separated by dashes, e.g.: @samp{01-02-03-04-aa-bb}. Note that resolving MAC addresses is only possible if the client is in the local network or obtained a DHCP lease from dnsmasq."
  40410. msgstr ""
  40411. #. type: subsubheading
  40412. #: guix-git/doc/guix.texi:26977
  40413. #, no-wrap
  40414. msgid "ddclient Service"
  40415. msgstr ""
  40416. #. type: cindex
  40417. #: guix-git/doc/guix.texi:26979
  40418. #, no-wrap
  40419. msgid "ddclient"
  40420. msgstr ""
  40421. #. type: Plain text
  40422. #: guix-git/doc/guix.texi:26983
  40423. msgid "The ddclient service described below runs the ddclient daemon, which takes care of automatically updating DNS entries for service providers such as @uref{https://dyn.com/dns/, Dyn}."
  40424. msgstr ""
  40425. #. type: Plain text
  40426. #: guix-git/doc/guix.texi:26986
  40427. msgid "The following example show instantiates the service with its default configuration:"
  40428. msgstr ""
  40429. #. type: lisp
  40430. #: guix-git/doc/guix.texi:26989
  40431. #, no-wrap
  40432. msgid "(service ddclient-service-type)\n"
  40433. msgstr ""
  40434. #. type: Plain text
  40435. #: guix-git/doc/guix.texi:26998
  40436. msgid "Note that ddclient needs to access credentials that are stored in a @dfn{secret file}, by default @file{/etc/ddclient/secrets} (see @code{secret-file} below). You are expected to create this file manually, in an ``out-of-band'' fashion (you @emph{could} make this file part of the service configuration, for instance by using @code{plain-file}, but it will be world-readable @i{via} @file{/gnu/store}). See the examples in the @file{share/ddclient} directory of the @code{ddclient} package."
  40437. msgstr ""
  40438. #. type: Plain text
  40439. #: guix-git/doc/guix.texi:27002
  40440. msgid "Available @code{ddclient-configuration} fields are:"
  40441. msgstr ""
  40442. #. type: deftypevr
  40443. #: guix-git/doc/guix.texi:27003
  40444. #, no-wrap
  40445. msgid "{@code{ddclient-configuration} parameter} package ddclient"
  40446. msgstr ""
  40447. #. type: deftypevr
  40448. #: guix-git/doc/guix.texi:27005
  40449. msgid "The ddclient package."
  40450. msgstr ""
  40451. #. type: deftypevr
  40452. #: guix-git/doc/guix.texi:27008
  40453. #, no-wrap
  40454. msgid "{@code{ddclient-configuration} parameter} integer daemon"
  40455. msgstr ""
  40456. #. type: deftypevr
  40457. #: guix-git/doc/guix.texi:27010
  40458. msgid "The period after which ddclient will retry to check IP and domain name."
  40459. msgstr ""
  40460. #. type: deftypevr
  40461. #: guix-git/doc/guix.texi:27015
  40462. #, no-wrap
  40463. msgid "{@code{ddclient-configuration} parameter} boolean syslog"
  40464. msgstr ""
  40465. #. type: deftypevr
  40466. #: guix-git/doc/guix.texi:27017
  40467. msgid "Use syslog for the output."
  40468. msgstr ""
  40469. #. type: deftypevr
  40470. #: guix-git/doc/guix.texi:27022
  40471. #, no-wrap
  40472. msgid "{@code{ddclient-configuration} parameter} string mail"
  40473. msgstr ""
  40474. #. type: deftypevr
  40475. #: guix-git/doc/guix.texi:27024
  40476. msgid "Mail to user."
  40477. msgstr ""
  40478. #. type: deftypevr
  40479. #: guix-git/doc/guix.texi:27026 guix-git/doc/guix.texi:27033
  40480. #: guix-git/doc/guix.texi:28829
  40481. msgid "Defaults to @samp{\"root\"}."
  40482. msgstr ""
  40483. #. type: deftypevr
  40484. #: guix-git/doc/guix.texi:27029
  40485. #, no-wrap
  40486. msgid "{@code{ddclient-configuration} parameter} string mail-failure"
  40487. msgstr ""
  40488. #. type: deftypevr
  40489. #: guix-git/doc/guix.texi:27031
  40490. msgid "Mail failed update to user."
  40491. msgstr ""
  40492. #. type: deftypevr
  40493. #: guix-git/doc/guix.texi:27036
  40494. #, no-wrap
  40495. msgid "{@code{ddclient-configuration} parameter} string pid"
  40496. msgstr ""
  40497. #. type: deftypevr
  40498. #: guix-git/doc/guix.texi:27038
  40499. msgid "The ddclient PID file."
  40500. msgstr ""
  40501. #. type: deftypevr
  40502. #: guix-git/doc/guix.texi:27040
  40503. msgid "Defaults to @samp{\"/var/run/ddclient/ddclient.pid\"}."
  40504. msgstr ""
  40505. #. type: deftypevr
  40506. #: guix-git/doc/guix.texi:27043
  40507. #, no-wrap
  40508. msgid "{@code{ddclient-configuration} parameter} boolean ssl"
  40509. msgstr ""
  40510. #. type: deftypevr
  40511. #: guix-git/doc/guix.texi:27045
  40512. msgid "Enable SSL support."
  40513. msgstr ""
  40514. #. type: deftypevr
  40515. #: guix-git/doc/guix.texi:27050
  40516. #, no-wrap
  40517. msgid "{@code{ddclient-configuration} parameter} string user"
  40518. msgstr ""
  40519. #. type: deftypevr
  40520. #: guix-git/doc/guix.texi:27053
  40521. msgid "Specifies the user name or ID that is used when running ddclient program."
  40522. msgstr ""
  40523. #. type: deftypevr
  40524. #: guix-git/doc/guix.texi:27055 guix-git/doc/guix.texi:27062
  40525. msgid "Defaults to @samp{\"ddclient\"}."
  40526. msgstr ""
  40527. #. type: deftypevr
  40528. #: guix-git/doc/guix.texi:27058
  40529. #, no-wrap
  40530. msgid "{@code{ddclient-configuration} parameter} string group"
  40531. msgstr ""
  40532. #. type: deftypevr
  40533. #: guix-git/doc/guix.texi:27060
  40534. msgid "Group of the user who will run the ddclient program."
  40535. msgstr ""
  40536. #. type: deftypevr
  40537. #: guix-git/doc/guix.texi:27065
  40538. #, no-wrap
  40539. msgid "{@code{ddclient-configuration} parameter} string secret-file"
  40540. msgstr ""
  40541. #. type: deftypevr
  40542. #: guix-git/doc/guix.texi:27069
  40543. msgid "Secret file which will be appended to @file{ddclient.conf} file. This file contains credentials for use by ddclient. You are expected to create it manually."
  40544. msgstr ""
  40545. #. type: deftypevr
  40546. #: guix-git/doc/guix.texi:27071
  40547. msgid "Defaults to @samp{\"/etc/ddclient/secrets.conf\"}."
  40548. msgstr ""
  40549. #. type: deftypevr
  40550. #: guix-git/doc/guix.texi:27074
  40551. #, no-wrap
  40552. msgid "{@code{ddclient-configuration} parameter} list extra-options"
  40553. msgstr ""
  40554. #. type: deftypevr
  40555. #: guix-git/doc/guix.texi:27076
  40556. msgid "Extra options will be appended to @file{ddclient.conf} file."
  40557. msgstr ""
  40558. #. type: cindex
  40559. #: guix-git/doc/guix.texi:27087
  40560. #, no-wrap
  40561. msgid "VPN (virtual private network)"
  40562. msgstr ""
  40563. #. type: cindex
  40564. #: guix-git/doc/guix.texi:27088
  40565. #, no-wrap
  40566. msgid "virtual private network (VPN)"
  40567. msgstr ""
  40568. #. type: Plain text
  40569. #: guix-git/doc/guix.texi:27092
  40570. msgid "The @code{(gnu services vpn)} module provides services related to @dfn{virtual private networks} (VPNs)."
  40571. msgstr ""
  40572. #. type: subsubheading
  40573. #: guix-git/doc/guix.texi:27093
  40574. #, no-wrap
  40575. msgid "Bitmask"
  40576. msgstr ""
  40577. #. type: defvr
  40578. #: guix-git/doc/guix.texi:27095
  40579. #, no-wrap
  40580. msgid "{Scheme Variable} bitmask-service-type"
  40581. msgstr ""
  40582. #. type: defvr
  40583. #: guix-git/doc/guix.texi:27100
  40584. msgid "A service type for the @uref{https://bitmask.net, Bitmask} VPN client. It makes the client available in the system and loads its polkit policy. Please note that the client expects an active polkit-agent, which is either run by your desktop-environment or should be run manually."
  40585. msgstr ""
  40586. #. type: subsubheading
  40587. #: guix-git/doc/guix.texi:27102
  40588. #, no-wrap
  40589. msgid "OpenVPN"
  40590. msgstr ""
  40591. #. type: Plain text
  40592. #: guix-git/doc/guix.texi:27106
  40593. msgid "It provides a @emph{client} service for your machine to connect to a VPN, and a @emph{server} service for your machine to host a VPN@."
  40594. msgstr ""
  40595. #. type: deffn
  40596. #: guix-git/doc/guix.texi:27107
  40597. #, no-wrap
  40598. msgid "{Scheme Procedure} openvpn-client-service @"
  40599. msgstr ""
  40600. #. type: deffn
  40601. #: guix-git/doc/guix.texi:27109
  40602. msgid "[#:config (openvpn-client-configuration)]"
  40603. msgstr ""
  40604. #. type: deffn
  40605. #: guix-git/doc/guix.texi:27111
  40606. msgid "Return a service that runs @command{openvpn}, a VPN daemon, as a client."
  40607. msgstr ""
  40608. #. type: deffn
  40609. #: guix-git/doc/guix.texi:27113
  40610. #, no-wrap
  40611. msgid "{Scheme Procedure} openvpn-server-service @"
  40612. msgstr ""
  40613. #. type: deffn
  40614. #: guix-git/doc/guix.texi:27115
  40615. msgid "[#:config (openvpn-server-configuration)]"
  40616. msgstr ""
  40617. #. type: deffn
  40618. #: guix-git/doc/guix.texi:27117
  40619. msgid "Return a service that runs @command{openvpn}, a VPN daemon, as a server."
  40620. msgstr ""
  40621. #. type: deffn
  40622. #: guix-git/doc/guix.texi:27119
  40623. msgid "Both can be run simultaneously."
  40624. msgstr ""
  40625. #. type: Plain text
  40626. #: guix-git/doc/guix.texi:27124
  40627. msgid "Available @code{openvpn-client-configuration} fields are:"
  40628. msgstr ""
  40629. #. type: deftypevr
  40630. #: guix-git/doc/guix.texi:27125
  40631. #, no-wrap
  40632. msgid "{@code{openvpn-client-configuration} parameter} package openvpn"
  40633. msgstr ""
  40634. #. type: deftypevr
  40635. #: guix-git/doc/guix.texi:27127 guix-git/doc/guix.texi:27282
  40636. msgid "The OpenVPN package."
  40637. msgstr ""
  40638. #. type: deftypevr
  40639. #: guix-git/doc/guix.texi:27130
  40640. #, no-wrap
  40641. msgid "{@code{openvpn-client-configuration} parameter} string pid-file"
  40642. msgstr ""
  40643. #. type: deftypevr
  40644. #: guix-git/doc/guix.texi:27132 guix-git/doc/guix.texi:27287
  40645. msgid "The OpenVPN pid file."
  40646. msgstr ""
  40647. #. type: deftypevr
  40648. #: guix-git/doc/guix.texi:27134 guix-git/doc/guix.texi:27289
  40649. msgid "Defaults to @samp{\"/var/run/openvpn/openvpn.pid\"}."
  40650. msgstr ""
  40651. #. type: deftypevr
  40652. #: guix-git/doc/guix.texi:27137
  40653. #, no-wrap
  40654. msgid "{@code{openvpn-client-configuration} parameter} proto proto"
  40655. msgstr ""
  40656. #. type: deftypevr
  40657. #: guix-git/doc/guix.texi:27140 guix-git/doc/guix.texi:27295
  40658. msgid "The protocol (UDP or TCP) used to open a channel between clients and servers."
  40659. msgstr ""
  40660. #. type: deftypevr
  40661. #: guix-git/doc/guix.texi:27142 guix-git/doc/guix.texi:27297
  40662. msgid "Defaults to @samp{udp}."
  40663. msgstr ""
  40664. #. type: deftypevr
  40665. #: guix-git/doc/guix.texi:27145
  40666. #, no-wrap
  40667. msgid "{@code{openvpn-client-configuration} parameter} dev dev"
  40668. msgstr ""
  40669. #. type: deftypevr
  40670. #: guix-git/doc/guix.texi:27147 guix-git/doc/guix.texi:27302
  40671. msgid "The device type used to represent the VPN connection."
  40672. msgstr ""
  40673. #. type: deftypevr
  40674. #: guix-git/doc/guix.texi:27149 guix-git/doc/guix.texi:27304
  40675. msgid "Defaults to @samp{tun}."
  40676. msgstr ""
  40677. #. type: Plain text
  40678. #: guix-git/doc/guix.texi:27155 guix-git/doc/guix.texi:27310
  40679. msgid "If you do not have some of these files (eg.@: you use a username and password), you can disable any of the following three fields by setting it to @code{'disabled}."
  40680. msgstr ""
  40681. #. type: deftypevr
  40682. #: guix-git/doc/guix.texi:27156
  40683. #, no-wrap
  40684. msgid "{@code{openvpn-client-configuration} parameter} maybe-string ca"
  40685. msgstr ""
  40686. #. type: deftypevr
  40687. #: guix-git/doc/guix.texi:27158 guix-git/doc/guix.texi:27313
  40688. msgid "The certificate authority to check connections against."
  40689. msgstr ""
  40690. #. type: deftypevr
  40691. #: guix-git/doc/guix.texi:27160 guix-git/doc/guix.texi:27315
  40692. msgid "Defaults to @samp{\"/etc/openvpn/ca.crt\"}."
  40693. msgstr ""
  40694. #. type: deftypevr
  40695. #: guix-git/doc/guix.texi:27163
  40696. #, no-wrap
  40697. msgid "{@code{openvpn-client-configuration} parameter} maybe-string cert"
  40698. msgstr ""
  40699. #. type: deftypevr
  40700. #: guix-git/doc/guix.texi:27166 guix-git/doc/guix.texi:27321
  40701. msgid "The certificate of the machine the daemon is running on. It should be signed by the authority given in @code{ca}."
  40702. msgstr ""
  40703. #. type: deftypevr
  40704. #: guix-git/doc/guix.texi:27168 guix-git/doc/guix.texi:27323
  40705. msgid "Defaults to @samp{\"/etc/openvpn/client.crt\"}."
  40706. msgstr ""
  40707. #. type: deftypevr
  40708. #: guix-git/doc/guix.texi:27171
  40709. #, no-wrap
  40710. msgid "{@code{openvpn-client-configuration} parameter} maybe-string key"
  40711. msgstr ""
  40712. #. type: deftypevr
  40713. #: guix-git/doc/guix.texi:27174 guix-git/doc/guix.texi:27329
  40714. msgid "The key of the machine the daemon is running on. It must be the key whose certificate is @code{cert}."
  40715. msgstr ""
  40716. #. type: deftypevr
  40717. #: guix-git/doc/guix.texi:27176 guix-git/doc/guix.texi:27331
  40718. msgid "Defaults to @samp{\"/etc/openvpn/client.key\"}."
  40719. msgstr ""
  40720. #. type: deftypevr
  40721. #: guix-git/doc/guix.texi:27179
  40722. #, no-wrap
  40723. msgid "{@code{openvpn-client-configuration} parameter} boolean comp-lzo?"
  40724. msgstr ""
  40725. #. type: deftypevr
  40726. #: guix-git/doc/guix.texi:27181 guix-git/doc/guix.texi:27336
  40727. msgid "Whether to use the lzo compression algorithm."
  40728. msgstr ""
  40729. #. type: deftypevr
  40730. #: guix-git/doc/guix.texi:27186
  40731. #, no-wrap
  40732. msgid "{@code{openvpn-client-configuration} parameter} boolean persist-key?"
  40733. msgstr ""
  40734. #. type: deftypevr
  40735. #: guix-git/doc/guix.texi:27188 guix-git/doc/guix.texi:27343
  40736. msgid "Don't re-read key files across SIGUSR1 or --ping-restart."
  40737. msgstr ""
  40738. #. type: deftypevr
  40739. #: guix-git/doc/guix.texi:27193
  40740. #, no-wrap
  40741. msgid "{@code{openvpn-client-configuration} parameter} boolean persist-tun?"
  40742. msgstr ""
  40743. #. type: deftypevr
  40744. #: guix-git/doc/guix.texi:27196 guix-git/doc/guix.texi:27351
  40745. msgid "Don't close and reopen TUN/TAP device or run up/down scripts across SIGUSR1 or --ping-restart restarts."
  40746. msgstr ""
  40747. #. type: deftypevr
  40748. #: guix-git/doc/guix.texi:27201
  40749. #, no-wrap
  40750. msgid "{@code{openvpn-client-configuration} parameter} boolean fast-io?"
  40751. msgstr ""
  40752. #. type: deftypevr
  40753. #: guix-git/doc/guix.texi:27204 guix-git/doc/guix.texi:27359
  40754. msgid "(Experimental) Optimize TUN/TAP/UDP I/O writes by avoiding a call to poll/epoll/select prior to the write operation."
  40755. msgstr ""
  40756. #. type: deftypevr
  40757. #: guix-git/doc/guix.texi:27208
  40758. #, no-wrap
  40759. msgid "{@code{openvpn-client-configuration} parameter} number verbosity"
  40760. msgstr ""
  40761. #. type: deftypevr
  40762. #: guix-git/doc/guix.texi:27210 guix-git/doc/guix.texi:27365
  40763. msgid "Verbosity level."
  40764. msgstr ""
  40765. #. type: deftypevr
  40766. #: guix-git/doc/guix.texi:27212 guix-git/doc/guix.texi:27367
  40767. #: guix-git/doc/guix.texi:29097 guix-git/doc/guix.texi:29321
  40768. msgid "Defaults to @samp{3}."
  40769. msgstr ""
  40770. #. type: deftypevr
  40771. #: guix-git/doc/guix.texi:27215
  40772. #, no-wrap
  40773. msgid "{@code{openvpn-client-configuration} parameter} tls-auth-client tls-auth"
  40774. msgstr ""
  40775. #. type: deftypevr
  40776. #: guix-git/doc/guix.texi:27218 guix-git/doc/guix.texi:27373
  40777. msgid "Add an additional layer of HMAC authentication on top of the TLS control channel to protect against DoS attacks."
  40778. msgstr ""
  40779. #. type: deftypevr
  40780. #: guix-git/doc/guix.texi:27223
  40781. #, no-wrap
  40782. msgid "{@code{openvpn-client-configuration} parameter} maybe-string auth-user-pass"
  40783. msgstr ""
  40784. #. type: deftypevr
  40785. #: guix-git/doc/guix.texi:27227
  40786. msgid "Authenticate with server using username/password. The option is a file containing username/password on 2 lines. Do not use a file-like object as it would be added to the store and readable by any user."
  40787. msgstr ""
  40788. #. type: deftypevr
  40789. #: guix-git/doc/guix.texi:27229
  40790. msgid "Defaults to @samp{'disabled}."
  40791. msgstr ""
  40792. #. type: deftypevr
  40793. #: guix-git/doc/guix.texi:27231
  40794. #, no-wrap
  40795. msgid "{@code{openvpn-client-configuration} parameter} key-usage verify-key-usage?"
  40796. msgstr ""
  40797. #. type: deftypevr
  40798. #: guix-git/doc/guix.texi:27233
  40799. msgid "Whether to check the server certificate has server usage extension."
  40800. msgstr ""
  40801. #. type: deftypevr
  40802. #: guix-git/doc/guix.texi:27238
  40803. #, no-wrap
  40804. msgid "{@code{openvpn-client-configuration} parameter} bind bind?"
  40805. msgstr ""
  40806. #. type: deftypevr
  40807. #: guix-git/doc/guix.texi:27240
  40808. msgid "Bind to a specific local port number."
  40809. msgstr ""
  40810. #. type: deftypevr
  40811. #: guix-git/doc/guix.texi:27245
  40812. #, no-wrap
  40813. msgid "{@code{openvpn-client-configuration} parameter} resolv-retry resolv-retry?"
  40814. msgstr ""
  40815. #. type: deftypevr
  40816. #: guix-git/doc/guix.texi:27247
  40817. msgid "Retry resolving server address."
  40818. msgstr ""
  40819. #. type: deftypevr
  40820. #: guix-git/doc/guix.texi:27252
  40821. #, no-wrap
  40822. msgid "{@code{openvpn-client-configuration} parameter} openvpn-remote-list remote"
  40823. msgstr ""
  40824. #. type: deftypevr
  40825. #: guix-git/doc/guix.texi:27254
  40826. msgid "A list of remote servers to connect to."
  40827. msgstr ""
  40828. #. type: deftypevr
  40829. #: guix-git/doc/guix.texi:27258
  40830. msgid "Available @code{openvpn-remote-configuration} fields are:"
  40831. msgstr ""
  40832. #. type: deftypevr
  40833. #: guix-git/doc/guix.texi:27259
  40834. #, no-wrap
  40835. msgid "{@code{openvpn-remote-configuration} parameter} string name"
  40836. msgstr ""
  40837. #. type: deftypevr
  40838. #: guix-git/doc/guix.texi:27261
  40839. msgid "Server name."
  40840. msgstr ""
  40841. #. type: deftypevr
  40842. #: guix-git/doc/guix.texi:27263
  40843. msgid "Defaults to @samp{\"my-server\"}."
  40844. msgstr ""
  40845. #. type: deftypevr
  40846. #: guix-git/doc/guix.texi:27266
  40847. #, no-wrap
  40848. msgid "{@code{openvpn-remote-configuration} parameter} number port"
  40849. msgstr ""
  40850. #. type: deftypevr
  40851. #: guix-git/doc/guix.texi:27268
  40852. msgid "Port number the server listens to."
  40853. msgstr ""
  40854. #. type: deftypevr
  40855. #: guix-git/doc/guix.texi:27270 guix-git/doc/guix.texi:27382
  40856. msgid "Defaults to @samp{1194}."
  40857. msgstr ""
  40858. #. type: Plain text
  40859. #: guix-git/doc/guix.texi:27279
  40860. msgid "Available @code{openvpn-server-configuration} fields are:"
  40861. msgstr ""
  40862. #. type: deftypevr
  40863. #: guix-git/doc/guix.texi:27280
  40864. #, no-wrap
  40865. msgid "{@code{openvpn-server-configuration} parameter} package openvpn"
  40866. msgstr ""
  40867. #. type: deftypevr
  40868. #: guix-git/doc/guix.texi:27285
  40869. #, no-wrap
  40870. msgid "{@code{openvpn-server-configuration} parameter} string pid-file"
  40871. msgstr ""
  40872. #. type: deftypevr
  40873. #: guix-git/doc/guix.texi:27292
  40874. #, no-wrap
  40875. msgid "{@code{openvpn-server-configuration} parameter} proto proto"
  40876. msgstr ""
  40877. #. type: deftypevr
  40878. #: guix-git/doc/guix.texi:27300
  40879. #, no-wrap
  40880. msgid "{@code{openvpn-server-configuration} parameter} dev dev"
  40881. msgstr ""
  40882. #. type: deftypevr
  40883. #: guix-git/doc/guix.texi:27311
  40884. #, no-wrap
  40885. msgid "{@code{openvpn-server-configuration} parameter} maybe-string ca"
  40886. msgstr ""
  40887. #. type: deftypevr
  40888. #: guix-git/doc/guix.texi:27318
  40889. #, no-wrap
  40890. msgid "{@code{openvpn-server-configuration} parameter} maybe-string cert"
  40891. msgstr ""
  40892. #. type: deftypevr
  40893. #: guix-git/doc/guix.texi:27326
  40894. #, no-wrap
  40895. msgid "{@code{openvpn-server-configuration} parameter} maybe-string key"
  40896. msgstr ""
  40897. #. type: deftypevr
  40898. #: guix-git/doc/guix.texi:27334
  40899. #, no-wrap
  40900. msgid "{@code{openvpn-server-configuration} parameter} boolean comp-lzo?"
  40901. msgstr ""
  40902. #. type: deftypevr
  40903. #: guix-git/doc/guix.texi:27341
  40904. #, no-wrap
  40905. msgid "{@code{openvpn-server-configuration} parameter} boolean persist-key?"
  40906. msgstr ""
  40907. #. type: deftypevr
  40908. #: guix-git/doc/guix.texi:27348
  40909. #, no-wrap
  40910. msgid "{@code{openvpn-server-configuration} parameter} boolean persist-tun?"
  40911. msgstr ""
  40912. #. type: deftypevr
  40913. #: guix-git/doc/guix.texi:27356
  40914. #, no-wrap
  40915. msgid "{@code{openvpn-server-configuration} parameter} boolean fast-io?"
  40916. msgstr ""
  40917. #. type: deftypevr
  40918. #: guix-git/doc/guix.texi:27363
  40919. #, no-wrap
  40920. msgid "{@code{openvpn-server-configuration} parameter} number verbosity"
  40921. msgstr ""
  40922. #. type: deftypevr
  40923. #: guix-git/doc/guix.texi:27370
  40924. #, no-wrap
  40925. msgid "{@code{openvpn-server-configuration} parameter} tls-auth-server tls-auth"
  40926. msgstr ""
  40927. #. type: deftypevr
  40928. #: guix-git/doc/guix.texi:27378
  40929. #, no-wrap
  40930. msgid "{@code{openvpn-server-configuration} parameter} number port"
  40931. msgstr ""
  40932. #. type: deftypevr
  40933. #: guix-git/doc/guix.texi:27380
  40934. msgid "Specifies the port number on which the server listens."
  40935. msgstr ""
  40936. #. type: deftypevr
  40937. #: guix-git/doc/guix.texi:27385
  40938. #, no-wrap
  40939. msgid "{@code{openvpn-server-configuration} parameter} ip-mask server"
  40940. msgstr ""
  40941. #. type: deftypevr
  40942. #: guix-git/doc/guix.texi:27387
  40943. msgid "An ip and mask specifying the subnet inside the virtual network."
  40944. msgstr ""
  40945. #. type: deftypevr
  40946. #: guix-git/doc/guix.texi:27389
  40947. msgid "Defaults to @samp{\"10.8.0.0 255.255.255.0\"}."
  40948. msgstr ""
  40949. #. type: deftypevr
  40950. #: guix-git/doc/guix.texi:27392
  40951. #, no-wrap
  40952. msgid "{@code{openvpn-server-configuration} parameter} cidr6 server-ipv6"
  40953. msgstr ""
  40954. #. type: deftypevr
  40955. #: guix-git/doc/guix.texi:27394
  40956. msgid "A CIDR notation specifying the IPv6 subnet inside the virtual network."
  40957. msgstr ""
  40958. #. type: deftypevr
  40959. #: guix-git/doc/guix.texi:27399
  40960. #, no-wrap
  40961. msgid "{@code{openvpn-server-configuration} parameter} string dh"
  40962. msgstr ""
  40963. #. type: deftypevr
  40964. #: guix-git/doc/guix.texi:27401
  40965. msgid "The Diffie-Hellman parameters file."
  40966. msgstr ""
  40967. #. type: deftypevr
  40968. #: guix-git/doc/guix.texi:27403
  40969. msgid "Defaults to @samp{\"/etc/openvpn/dh2048.pem\"}."
  40970. msgstr ""
  40971. #. type: deftypevr
  40972. #: guix-git/doc/guix.texi:27406
  40973. #, no-wrap
  40974. msgid "{@code{openvpn-server-configuration} parameter} string ifconfig-pool-persist"
  40975. msgstr ""
  40976. #. type: deftypevr
  40977. #: guix-git/doc/guix.texi:27408
  40978. msgid "The file that records client IPs."
  40979. msgstr ""
  40980. #. type: deftypevr
  40981. #: guix-git/doc/guix.texi:27410
  40982. msgid "Defaults to @samp{\"/etc/openvpn/ipp.txt\"}."
  40983. msgstr ""
  40984. #. type: deftypevr
  40985. #: guix-git/doc/guix.texi:27413
  40986. #, no-wrap
  40987. msgid "{@code{openvpn-server-configuration} parameter} gateway redirect-gateway?"
  40988. msgstr ""
  40989. #. type: deftypevr
  40990. #: guix-git/doc/guix.texi:27415
  40991. msgid "When true, the server will act as a gateway for its clients."
  40992. msgstr ""
  40993. #. type: deftypevr
  40994. #: guix-git/doc/guix.texi:27420
  40995. #, no-wrap
  40996. msgid "{@code{openvpn-server-configuration} parameter} boolean client-to-client?"
  40997. msgstr ""
  40998. #. type: deftypevr
  40999. #: guix-git/doc/guix.texi:27422
  41000. msgid "When true, clients are allowed to talk to each other inside the VPN."
  41001. msgstr ""
  41002. #. type: deftypevr
  41003. #: guix-git/doc/guix.texi:27427
  41004. #, no-wrap
  41005. msgid "{@code{openvpn-server-configuration} parameter} keepalive keepalive"
  41006. msgstr ""
  41007. #. type: deftypevr
  41008. #: guix-git/doc/guix.texi:27433
  41009. msgid "Causes ping-like messages to be sent back and forth over the link so that each side knows when the other side has gone down. @code{keepalive} requires a pair. The first element is the period of the ping sending, and the second element is the timeout before considering the other side down."
  41010. msgstr ""
  41011. #. type: deftypevr
  41012. #: guix-git/doc/guix.texi:27436
  41013. #, no-wrap
  41014. msgid "{@code{openvpn-server-configuration} parameter} number max-clients"
  41015. msgstr ""
  41016. #. type: deftypevr
  41017. #: guix-git/doc/guix.texi:27438
  41018. msgid "The maximum number of clients."
  41019. msgstr ""
  41020. #. type: deftypevr
  41021. #: guix-git/doc/guix.texi:27443
  41022. #, no-wrap
  41023. msgid "{@code{openvpn-server-configuration} parameter} string status"
  41024. msgstr ""
  41025. #. type: deftypevr
  41026. #: guix-git/doc/guix.texi:27446
  41027. msgid "The status file. This file shows a small report on current connection. It is truncated and rewritten every minute."
  41028. msgstr ""
  41029. #. type: deftypevr
  41030. #: guix-git/doc/guix.texi:27448
  41031. msgid "Defaults to @samp{\"/var/run/openvpn/status\"}."
  41032. msgstr ""
  41033. #. type: deftypevr
  41034. #: guix-git/doc/guix.texi:27451
  41035. #, no-wrap
  41036. msgid "{@code{openvpn-server-configuration} parameter} openvpn-ccd-list client-config-dir"
  41037. msgstr ""
  41038. #. type: deftypevr
  41039. #: guix-git/doc/guix.texi:27453
  41040. msgid "The list of configuration for some clients."
  41041. msgstr ""
  41042. #. type: deftypevr
  41043. #: guix-git/doc/guix.texi:27457
  41044. msgid "Available @code{openvpn-ccd-configuration} fields are:"
  41045. msgstr ""
  41046. #. type: deftypevr
  41047. #: guix-git/doc/guix.texi:27458
  41048. #, no-wrap
  41049. msgid "{@code{openvpn-ccd-configuration} parameter} string name"
  41050. msgstr ""
  41051. #. type: deftypevr
  41052. #: guix-git/doc/guix.texi:27460
  41053. msgid "Client name."
  41054. msgstr ""
  41055. #. type: deftypevr
  41056. #: guix-git/doc/guix.texi:27462
  41057. msgid "Defaults to @samp{\"client\"}."
  41058. msgstr ""
  41059. #. type: deftypevr
  41060. #: guix-git/doc/guix.texi:27465
  41061. #, no-wrap
  41062. msgid "{@code{openvpn-ccd-configuration} parameter} ip-mask iroute"
  41063. msgstr ""
  41064. #. type: deftypevr
  41065. #: guix-git/doc/guix.texi:27467
  41066. msgid "Client own network"
  41067. msgstr ""
  41068. #. type: deftypevr
  41069. #: guix-git/doc/guix.texi:27472
  41070. #, no-wrap
  41071. msgid "{@code{openvpn-ccd-configuration} parameter} ip-mask ifconfig-push"
  41072. msgstr ""
  41073. #. type: deftypevr
  41074. #: guix-git/doc/guix.texi:27474
  41075. msgid "Client VPN IP."
  41076. msgstr ""
  41077. #. type: subheading
  41078. #: guix-git/doc/guix.texi:27483
  41079. #, no-wrap
  41080. msgid "strongSwan"
  41081. msgstr ""
  41082. #. type: Plain text
  41083. #: guix-git/doc/guix.texi:27487
  41084. msgid "Currently, the strongSwan service only provides legacy-style configuration with @file{ipsec.conf} and @file{ipsec.secrets} files."
  41085. msgstr ""
  41086. #. type: defvr
  41087. #: guix-git/doc/guix.texi:27488
  41088. #, no-wrap
  41089. msgid "{Scheme Variable} strongswan-service-type"
  41090. msgstr ""
  41091. #. type: defvr
  41092. #: guix-git/doc/guix.texi:27492
  41093. msgid "A service type for configuring strongSwan for IPsec @acronym{VPN, Virtual Private Networking}. Its value must be a @code{strongswan-configuration} record as in this example:"
  41094. msgstr ""
  41095. #. type: lisp
  41096. #: guix-git/doc/guix.texi:27498
  41097. #, no-wrap
  41098. msgid ""
  41099. "(service strongswan-service-type\n"
  41100. " (strongswan-configuration\n"
  41101. " (ipsec-conf \"/etc/ipsec.conf\")\n"
  41102. " (ipsec-secrets \"/etc/ipsec.secrets\")))\n"
  41103. msgstr ""
  41104. #. type: deftp
  41105. #: guix-git/doc/guix.texi:27502
  41106. #, no-wrap
  41107. msgid "{Data Type} strongswan-configuration"
  41108. msgstr ""
  41109. #. type: deftp
  41110. #: guix-git/doc/guix.texi:27504
  41111. msgid "Data type representing the configuration of the StrongSwan service."
  41112. msgstr ""
  41113. #. type: code{#1}
  41114. #: guix-git/doc/guix.texi:27506
  41115. #, no-wrap
  41116. msgid "strongswan"
  41117. msgstr ""
  41118. #. type: table
  41119. #: guix-git/doc/guix.texi:27508
  41120. msgid "The strongSwan package to use for this service."
  41121. msgstr ""
  41122. #. type: item
  41123. #: guix-git/doc/guix.texi:27509
  41124. #, no-wrap
  41125. msgid "@code{ipsec-conf} (default: @code{#f})"
  41126. msgstr ""
  41127. #. type: table
  41128. #: guix-git/doc/guix.texi:27512
  41129. msgid "The file name of your @file{ipsec.conf}. If not @code{#f}, then this and @code{ipsec-secrets} must both be strings."
  41130. msgstr ""
  41131. #. type: item
  41132. #: guix-git/doc/guix.texi:27513
  41133. #, no-wrap
  41134. msgid "@code{ipsec-secrets} (default @code{#f})"
  41135. msgstr ""
  41136. #. type: table
  41137. #: guix-git/doc/guix.texi:27516
  41138. msgid "The file name of your @file{ipsec.secrets}. If not @code{#f}, then this and @code{ipsec-conf} must both be strings."
  41139. msgstr ""
  41140. #. type: subsubheading
  41141. #: guix-git/doc/guix.texi:27520
  41142. #, no-wrap
  41143. msgid "Wireguard"
  41144. msgstr ""
  41145. #. type: defvr
  41146. #: guix-git/doc/guix.texi:27522
  41147. #, no-wrap
  41148. msgid "{Scheme Variable} wireguard-service-type"
  41149. msgstr ""
  41150. #. type: defvr
  41151. #: guix-git/doc/guix.texi:27525
  41152. msgid "A service type for a Wireguard tunnel interface. Its value must be a @code{wireguard-configuration} record as in this example:"
  41153. msgstr ""
  41154. #. type: lisp
  41155. #: guix-git/doc/guix.texi:27536
  41156. #, no-wrap
  41157. msgid ""
  41158. "(service wireguard-service-type\n"
  41159. " (wireguard-configuration\n"
  41160. " (peers\n"
  41161. " (list\n"
  41162. " (wireguard-peer\n"
  41163. " (name \"my-peer\")\n"
  41164. " (endpoint \"my.wireguard.com:51820\")\n"
  41165. " (public-key \"hzpKg9X1yqu1axN6iJp0mWf6BZGo8m1wteKwtTmDGF4=\")\n"
  41166. " (allowed-ips '(\"10.0.0.2/32\")))))))\n"
  41167. msgstr ""
  41168. #. type: deftp
  41169. #: guix-git/doc/guix.texi:27540
  41170. #, no-wrap
  41171. msgid "{Data Type} wireguard-configuration"
  41172. msgstr ""
  41173. #. type: deftp
  41174. #: guix-git/doc/guix.texi:27542
  41175. msgid "Data type representing the configuration of the Wireguard service."
  41176. msgstr ""
  41177. #. type: code{#1}
  41178. #: guix-git/doc/guix.texi:27544
  41179. #, no-wrap
  41180. msgid "wireguard"
  41181. msgstr ""
  41182. #. type: table
  41183. #: guix-git/doc/guix.texi:27546
  41184. msgid "The wireguard package to use for this service."
  41185. msgstr ""
  41186. #. type: item
  41187. #: guix-git/doc/guix.texi:27547
  41188. #, no-wrap
  41189. msgid "@code{interface} (default: @code{\"wg0\"})"
  41190. msgstr ""
  41191. #. type: table
  41192. #: guix-git/doc/guix.texi:27549
  41193. msgid "The interface name for the VPN."
  41194. msgstr ""
  41195. #. type: item
  41196. #: guix-git/doc/guix.texi:27550
  41197. #, no-wrap
  41198. msgid "@code{addresses} (default: @code{'(\"10.0.0.1/32\")})"
  41199. msgstr ""
  41200. #. type: table
  41201. #: guix-git/doc/guix.texi:27552
  41202. msgid "The IP addresses to be assigned to the above interface."
  41203. msgstr ""
  41204. #. type: item
  41205. #: guix-git/doc/guix.texi:27553
  41206. #, no-wrap
  41207. msgid "@code{private-key} (default: @code{\"/etc/wireguard/private.key\"})"
  41208. msgstr ""
  41209. #. type: table
  41210. #: guix-git/doc/guix.texi:27556
  41211. msgid "The private key file for the interface. It is automatically generated if the file does not exist."
  41212. msgstr ""
  41213. #. type: item
  41214. #: guix-git/doc/guix.texi:27557
  41215. #, no-wrap
  41216. msgid "@code{peers} (default: @code{'()})"
  41217. msgstr ""
  41218. #. type: table
  41219. #: guix-git/doc/guix.texi:27560
  41220. msgid "The authorized peers on this interface. This is a list of @var{wireguard-peer} records."
  41221. msgstr ""
  41222. #. type: deftp
  41223. #: guix-git/doc/guix.texi:27564
  41224. #, no-wrap
  41225. msgid "{Data Type} wireguard-peer"
  41226. msgstr ""
  41227. #. type: deftp
  41228. #: guix-git/doc/guix.texi:27566
  41229. msgid "Data type representing a Wireguard peer attached to a given interface."
  41230. msgstr ""
  41231. #. type: table
  41232. #: guix-git/doc/guix.texi:27570
  41233. msgid "The peer name."
  41234. msgstr ""
  41235. #. type: item
  41236. #: guix-git/doc/guix.texi:27571
  41237. #, no-wrap
  41238. msgid "@code{endpoint} (default: @code{#f})"
  41239. msgstr ""
  41240. #. type: table
  41241. #: guix-git/doc/guix.texi:27574
  41242. msgid "The optional endpoint for the peer, such as @code{\"demo.wireguard.com:51820\"}."
  41243. msgstr ""
  41244. #. type: itemx
  41245. #: guix-git/doc/guix.texi:27575 guix-git/doc/guix.texi:27970
  41246. #: guix-git/doc/guix.texi:28007 guix-git/doc/guix.texi:32926
  41247. #, no-wrap
  41248. msgid "public-key"
  41249. msgstr ""
  41250. #. type: table
  41251. #: guix-git/doc/guix.texi:27577
  41252. msgid "The peer public-key represented as a base64 string."
  41253. msgstr ""
  41254. #. type: code{#1}
  41255. #: guix-git/doc/guix.texi:27578
  41256. #, no-wrap
  41257. msgid "allowed-ips"
  41258. msgstr ""
  41259. #. type: table
  41260. #: guix-git/doc/guix.texi:27581
  41261. msgid "A list of IP addresses from which incoming traffic for this peer is allowed and to which incoming traffic for this peer is directed."
  41262. msgstr ""
  41263. #. type: item
  41264. #: guix-git/doc/guix.texi:27582
  41265. #, no-wrap
  41266. msgid "@code{keep-alive} (default: @code{#f})"
  41267. msgstr ""
  41268. #. type: table
  41269. #: guix-git/doc/guix.texi:27587
  41270. msgid "An optional time interval in seconds. A packet will be sent to the server endpoint once per time interval. This helps receiving incoming connections from this peer when you are behind a NAT or a firewall."
  41271. msgstr ""
  41272. #. type: cindex
  41273. #: guix-git/doc/guix.texi:27593
  41274. #, no-wrap
  41275. msgid "NFS"
  41276. msgstr ""
  41277. #. type: Plain text
  41278. #: guix-git/doc/guix.texi:27598
  41279. msgid "The @code{(gnu services nfs)} module provides the following services, which are most commonly used in relation to mounting or exporting directory trees as @dfn{network file systems} (NFS)."
  41280. msgstr ""
  41281. #. type: Plain text
  41282. #: guix-git/doc/guix.texi:27602
  41283. msgid "While it is possible to use the individual components that together make up a Network File System service, we recommended to configure an NFS server with the @code{nfs-service-type}."
  41284. msgstr ""
  41285. #. type: subsubheading
  41286. #: guix-git/doc/guix.texi:27603
  41287. #, no-wrap
  41288. msgid "NFS Service"
  41289. msgstr ""
  41290. #. type: cindex
  41291. #: guix-git/doc/guix.texi:27604
  41292. #, no-wrap
  41293. msgid "NFS, server"
  41294. msgstr ""
  41295. #. type: Plain text
  41296. #: guix-git/doc/guix.texi:27609
  41297. msgid "The NFS service takes care of setting up all NFS component services, kernel configuration file systems, and installs configuration files in the locations that NFS expects."
  41298. msgstr ""
  41299. #. type: defvr
  41300. #: guix-git/doc/guix.texi:27610
  41301. #, no-wrap
  41302. msgid "{Scheme Variable} nfs-service-type"
  41303. msgstr ""
  41304. #. type: defvr
  41305. #: guix-git/doc/guix.texi:27612
  41306. msgid "A service type for a complete NFS server."
  41307. msgstr ""
  41308. #. type: deftp
  41309. #: guix-git/doc/guix.texi:27614
  41310. #, no-wrap
  41311. msgid "{Data Type} nfs-configuration"
  41312. msgstr ""
  41313. #. type: deftp
  41314. #: guix-git/doc/guix.texi:27617
  41315. msgid "This data type represents the configuration of the NFS service and all of its subsystems."
  41316. msgstr ""
  41317. #. type: deftp
  41318. #: guix-git/doc/guix.texi:27619
  41319. msgid "It has the following parameters:"
  41320. msgstr ""
  41321. #. type: item
  41322. #: guix-git/doc/guix.texi:27620 guix-git/doc/guix.texi:27745
  41323. #: guix-git/doc/guix.texi:27770
  41324. #, no-wrap
  41325. msgid "@code{nfs-utils} (default: @code{nfs-utils})"
  41326. msgstr ""
  41327. #. type: table
  41328. #: guix-git/doc/guix.texi:27622
  41329. msgid "The nfs-utils package to use."
  41330. msgstr ""
  41331. #. type: item
  41332. #: guix-git/doc/guix.texi:27623
  41333. #, no-wrap
  41334. msgid "@code{nfs-versions} (default: @code{'(\"4.2\" \"4.1\" \"4.0\")})"
  41335. msgstr ""
  41336. #. type: table
  41337. #: guix-git/doc/guix.texi:27626
  41338. msgid "If a list of string values is provided, the @command{rpc.nfsd} daemon will be limited to supporting the given versions of the NFS protocol."
  41339. msgstr ""
  41340. #. type: item
  41341. #: guix-git/doc/guix.texi:27627
  41342. #, no-wrap
  41343. msgid "@code{exports} (default: @code{'()})"
  41344. msgstr ""
  41345. #. type: table
  41346. #: guix-git/doc/guix.texi:27632
  41347. msgid "This is a list of directories the NFS server should export. Each entry is a list consisting of two elements: a directory name and a string containing all options. This is an example in which the directory @file{/export} is served to all NFS clients as a read-only share:"
  41348. msgstr ""
  41349. #. type: lisp
  41350. #: guix-git/doc/guix.texi:27638
  41351. #, no-wrap
  41352. msgid ""
  41353. "(nfs-configuration\n"
  41354. " (exports\n"
  41355. " '((\"/export\"\n"
  41356. " \"*(ro,insecure,no_subtree_check,crossmnt,fsid=0)\"))))\n"
  41357. msgstr ""
  41358. #. type: item
  41359. #: guix-git/doc/guix.texi:27640
  41360. #, no-wrap
  41361. msgid "@code{rpcmountd-port} (default: @code{#f})"
  41362. msgstr ""
  41363. #. type: table
  41364. #: guix-git/doc/guix.texi:27642
  41365. msgid "The network port that the @command{rpc.mountd} daemon should use."
  41366. msgstr ""
  41367. #. type: item
  41368. #: guix-git/doc/guix.texi:27643
  41369. #, no-wrap
  41370. msgid "@code{rpcstatd-port} (default: @code{#f})"
  41371. msgstr ""
  41372. #. type: table
  41373. #: guix-git/doc/guix.texi:27645
  41374. msgid "The network port that the @command{rpc.statd} daemon should use."
  41375. msgstr ""
  41376. #. type: item
  41377. #: guix-git/doc/guix.texi:27646 guix-git/doc/guix.texi:27694
  41378. #, no-wrap
  41379. msgid "@code{rpcbind} (default: @code{rpcbind})"
  41380. msgstr ""
  41381. #. type: table
  41382. #: guix-git/doc/guix.texi:27648 guix-git/doc/guix.texi:27696
  41383. msgid "The rpcbind package to use."
  41384. msgstr ""
  41385. #. type: item
  41386. #: guix-git/doc/guix.texi:27649
  41387. #, no-wrap
  41388. msgid "@code{idmap-domain} (default: @code{\"localdomain\"})"
  41389. msgstr ""
  41390. #. type: table
  41391. #: guix-git/doc/guix.texi:27651
  41392. msgid "The local NFSv4 domain name."
  41393. msgstr ""
  41394. #. type: item
  41395. #: guix-git/doc/guix.texi:27652
  41396. #, no-wrap
  41397. msgid "@code{nfsd-port} (default: @code{2049})"
  41398. msgstr ""
  41399. #. type: table
  41400. #: guix-git/doc/guix.texi:27654
  41401. msgid "The network port that the @command{nfsd} daemon should use."
  41402. msgstr ""
  41403. #. type: item
  41404. #: guix-git/doc/guix.texi:27655
  41405. #, no-wrap
  41406. msgid "@code{nfsd-threads} (default: @code{8})"
  41407. msgstr ""
  41408. #. type: table
  41409. #: guix-git/doc/guix.texi:27657
  41410. msgid "The number of threads used by the @command{nfsd} daemon."
  41411. msgstr ""
  41412. #. type: item
  41413. #: guix-git/doc/guix.texi:27658
  41414. #, no-wrap
  41415. msgid "@code{nfsd-tcp?} (default: @code{#t})"
  41416. msgstr ""
  41417. #. type: table
  41418. #: guix-git/doc/guix.texi:27660
  41419. msgid "Whether the @command{nfsd} daemon should listen on a TCP socket."
  41420. msgstr ""
  41421. #. type: item
  41422. #: guix-git/doc/guix.texi:27661
  41423. #, no-wrap
  41424. msgid "@code{nfsd-udp?} (default: @code{#f})"
  41425. msgstr ""
  41426. #. type: table
  41427. #: guix-git/doc/guix.texi:27663
  41428. msgid "Whether the @command{nfsd} daemon should listen on a UDP socket."
  41429. msgstr ""
  41430. #. type: item
  41431. #: guix-git/doc/guix.texi:27664 guix-git/doc/guix.texi:27748
  41432. #: guix-git/doc/guix.texi:27773
  41433. #, no-wrap
  41434. msgid "@code{pipefs-directory} (default: @code{\"/var/lib/nfs/rpc_pipefs\"})"
  41435. msgstr ""
  41436. #. type: table
  41437. #: guix-git/doc/guix.texi:27666 guix-git/doc/guix.texi:27750
  41438. #: guix-git/doc/guix.texi:27775
  41439. msgid "The directory where the pipefs file system is mounted."
  41440. msgstr ""
  41441. #. type: item
  41442. #: guix-git/doc/guix.texi:27667
  41443. #, no-wrap
  41444. msgid "@code{debug} (default: @code{'()\"})"
  41445. msgstr ""
  41446. #. type: table
  41447. #: guix-git/doc/guix.texi:27671
  41448. msgid "A list of subsystems for which debugging output should be enabled. This is a list of symbols. Any of these symbols are valid: @code{nfsd}, @code{nfs}, @code{rpc}, @code{idmap}, @code{statd}, or @code{mountd}."
  41449. msgstr ""
  41450. #. type: Plain text
  41451. #: guix-git/doc/guix.texi:27676
  41452. msgid "If you don't need a complete NFS service or prefer to build it yourself you can use the individual component services that are documented below."
  41453. msgstr ""
  41454. #. type: subsubheading
  41455. #: guix-git/doc/guix.texi:27677
  41456. #, no-wrap
  41457. msgid "RPC Bind Service"
  41458. msgstr ""
  41459. #. type: cindex
  41460. #: guix-git/doc/guix.texi:27678
  41461. #, no-wrap
  41462. msgid "rpcbind"
  41463. msgstr ""
  41464. #. type: Plain text
  41465. #: guix-git/doc/guix.texi:27684
  41466. msgid "The RPC Bind service provides a facility to map program numbers into universal addresses. Many NFS related services use this facility. Hence it is automatically started when a dependent service starts."
  41467. msgstr ""
  41468. #. type: defvr
  41469. #: guix-git/doc/guix.texi:27685
  41470. #, no-wrap
  41471. msgid "{Scheme Variable} rpcbind-service-type"
  41472. msgstr ""
  41473. #. type: defvr
  41474. #: guix-git/doc/guix.texi:27687
  41475. msgid "A service type for the RPC portmapper daemon."
  41476. msgstr ""
  41477. #. type: deftp
  41478. #: guix-git/doc/guix.texi:27690
  41479. #, no-wrap
  41480. msgid "{Data Type} rpcbind-configuration"
  41481. msgstr ""
  41482. #. type: deftp
  41483. #: guix-git/doc/guix.texi:27693
  41484. msgid "Data type representing the configuration of the RPC Bind Service. This type has the following parameters:"
  41485. msgstr ""
  41486. #. type: item
  41487. #: guix-git/doc/guix.texi:27697
  41488. #, no-wrap
  41489. msgid "@code{warm-start?} (default: @code{#t})"
  41490. msgstr ""
  41491. #. type: table
  41492. #: guix-git/doc/guix.texi:27701
  41493. msgid "If this parameter is @code{#t}, then the daemon will read a state file on startup thus reloading state information saved by a previous instance."
  41494. msgstr ""
  41495. #. type: subsubheading
  41496. #: guix-git/doc/guix.texi:27705
  41497. #, no-wrap
  41498. msgid "Pipefs Pseudo File System"
  41499. msgstr ""
  41500. #. type: cindex
  41501. #: guix-git/doc/guix.texi:27706
  41502. #, no-wrap
  41503. msgid "pipefs"
  41504. msgstr ""
  41505. #. type: cindex
  41506. #: guix-git/doc/guix.texi:27707
  41507. #, no-wrap
  41508. msgid "rpc_pipefs"
  41509. msgstr ""
  41510. #. type: Plain text
  41511. #: guix-git/doc/guix.texi:27711
  41512. msgid "The pipefs file system is used to transfer NFS related data between the kernel and user space programs."
  41513. msgstr ""
  41514. #. type: defvr
  41515. #: guix-git/doc/guix.texi:27712
  41516. #, no-wrap
  41517. msgid "{Scheme Variable} pipefs-service-type"
  41518. msgstr ""
  41519. #. type: defvr
  41520. #: guix-git/doc/guix.texi:27714
  41521. msgid "A service type for the pipefs pseudo file system."
  41522. msgstr ""
  41523. #. type: deftp
  41524. #: guix-git/doc/guix.texi:27716
  41525. #, no-wrap
  41526. msgid "{Data Type} pipefs-configuration"
  41527. msgstr ""
  41528. #. type: deftp
  41529. #: guix-git/doc/guix.texi:27719
  41530. msgid "Data type representing the configuration of the pipefs pseudo file system service. This type has the following parameters:"
  41531. msgstr ""
  41532. #. type: item
  41533. #: guix-git/doc/guix.texi:27720
  41534. #, no-wrap
  41535. msgid "@code{mount-point} (default: @code{\"/var/lib/nfs/rpc_pipefs\"})"
  41536. msgstr ""
  41537. #. type: table
  41538. #: guix-git/doc/guix.texi:27722
  41539. msgid "The directory to which the file system is to be attached."
  41540. msgstr ""
  41541. #. type: subsubheading
  41542. #: guix-git/doc/guix.texi:27726
  41543. #, no-wrap
  41544. msgid "GSS Daemon Service"
  41545. msgstr ""
  41546. #. type: cindex
  41547. #: guix-git/doc/guix.texi:27727
  41548. #, no-wrap
  41549. msgid "GSSD"
  41550. msgstr ""
  41551. #. type: cindex
  41552. #: guix-git/doc/guix.texi:27728
  41553. #, no-wrap
  41554. msgid "GSS"
  41555. msgstr ""
  41556. #. type: cindex
  41557. #: guix-git/doc/guix.texi:27729
  41558. #, no-wrap
  41559. msgid "global security system"
  41560. msgstr ""
  41561. #. type: Plain text
  41562. #: guix-git/doc/guix.texi:27736
  41563. msgid "The @dfn{global security system} (GSS) daemon provides strong security for RPC based protocols. Before exchanging RPC requests an RPC client must establish a security context. Typically this is done using the Kerberos command @command{kinit} or automatically at login time using PAM services (@pxref{Kerberos Services})."
  41564. msgstr ""
  41565. #. type: defvr
  41566. #: guix-git/doc/guix.texi:27737
  41567. #, no-wrap
  41568. msgid "{Scheme Variable} gss-service-type"
  41569. msgstr ""
  41570. #. type: defvr
  41571. #: guix-git/doc/guix.texi:27739
  41572. msgid "A service type for the Global Security System (GSS) daemon."
  41573. msgstr ""
  41574. #. type: deftp
  41575. #: guix-git/doc/guix.texi:27741
  41576. #, no-wrap
  41577. msgid "{Data Type} gss-configuration"
  41578. msgstr ""
  41579. #. type: deftp
  41580. #: guix-git/doc/guix.texi:27744
  41581. msgid "Data type representing the configuration of the GSS daemon service. This type has the following parameters:"
  41582. msgstr ""
  41583. #. type: table
  41584. #: guix-git/doc/guix.texi:27747
  41585. msgid "The package in which the @command{rpc.gssd} command is to be found."
  41586. msgstr ""
  41587. #. type: subsubheading
  41588. #: guix-git/doc/guix.texi:27755
  41589. #, no-wrap
  41590. msgid "IDMAP Daemon Service"
  41591. msgstr ""
  41592. #. type: cindex
  41593. #: guix-git/doc/guix.texi:27756
  41594. #, no-wrap
  41595. msgid "idmapd"
  41596. msgstr ""
  41597. #. type: cindex
  41598. #: guix-git/doc/guix.texi:27757
  41599. #, no-wrap
  41600. msgid "name mapper"
  41601. msgstr ""
  41602. #. type: Plain text
  41603. #: guix-git/doc/guix.texi:27761
  41604. msgid "The idmap daemon service provides mapping between user IDs and user names. Typically it is required in order to access file systems mounted via NFSv4."
  41605. msgstr ""
  41606. #. type: defvr
  41607. #: guix-git/doc/guix.texi:27762
  41608. #, no-wrap
  41609. msgid "{Scheme Variable} idmap-service-type"
  41610. msgstr ""
  41611. #. type: defvr
  41612. #: guix-git/doc/guix.texi:27764
  41613. msgid "A service type for the Identity Mapper (IDMAP) daemon."
  41614. msgstr ""
  41615. #. type: deftp
  41616. #: guix-git/doc/guix.texi:27766
  41617. #, no-wrap
  41618. msgid "{Data Type} idmap-configuration"
  41619. msgstr ""
  41620. #. type: deftp
  41621. #: guix-git/doc/guix.texi:27769
  41622. msgid "Data type representing the configuration of the IDMAP daemon service. This type has the following parameters:"
  41623. msgstr ""
  41624. #. type: table
  41625. #: guix-git/doc/guix.texi:27772
  41626. msgid "The package in which the @command{rpc.idmapd} command is to be found."
  41627. msgstr ""
  41628. #. type: item
  41629. #: guix-git/doc/guix.texi:27776
  41630. #, no-wrap
  41631. msgid "@code{domain} (default: @code{#f})"
  41632. msgstr ""
  41633. #. type: table
  41634. #: guix-git/doc/guix.texi:27780
  41635. msgid "The local NFSv4 domain name. This must be a string or @code{#f}. If it is @code{#f} then the daemon will use the host's fully qualified domain name."
  41636. msgstr ""
  41637. #. type: item
  41638. #: guix-git/doc/guix.texi:27781
  41639. #, no-wrap
  41640. msgid "@code{verbosity} (default: @code{0})"
  41641. msgstr ""
  41642. #. type: table
  41643. #: guix-git/doc/guix.texi:27783
  41644. msgid "The verbosity level of the daemon."
  41645. msgstr ""
  41646. #. type: Plain text
  41647. #: guix-git/doc/guix.texi:27794
  41648. msgid "@uref{https://guix.gnu.org/cuirass/, Cuirass} is a continuous integration tool for Guix. It can be used both for development and for providing substitutes to others (@pxref{Substitutes})."
  41649. msgstr ""
  41650. #. type: Plain text
  41651. #: guix-git/doc/guix.texi:27796
  41652. msgid "The @code{(gnu services cuirass)} module provides the following service."
  41653. msgstr ""
  41654. #. type: defvr
  41655. #: guix-git/doc/guix.texi:27797
  41656. #, no-wrap
  41657. msgid "{Scheme Procedure} cuirass-service-type"
  41658. msgstr ""
  41659. #. type: defvr
  41660. #: guix-git/doc/guix.texi:27800
  41661. msgid "The type of the Cuirass service. Its value must be a @code{cuirass-configuration} object, as described below."
  41662. msgstr ""
  41663. #. type: Plain text
  41664. #: guix-git/doc/guix.texi:27805
  41665. msgid "To add build jobs, you have to set the @code{specifications} field of the configuration. For instance, the following example will build all the packages provided by the @code{my-channel} channel."
  41666. msgstr ""
  41667. #. type: lisp
  41668. #: guix-git/doc/guix.texi:27816
  41669. #, no-wrap
  41670. msgid ""
  41671. "(define %cuirass-specs\n"
  41672. " #~(list (specification\n"
  41673. " (name \"my-channel\")\n"
  41674. " (build '(channels my-channel))\n"
  41675. " (channels\n"
  41676. " (cons (channel\n"
  41677. " (name 'my-channel)\n"
  41678. " (url \"https://my-channel.git\"))\n"
  41679. " %default-channels)))))\n"
  41680. "\n"
  41681. msgstr ""
  41682. #. type: lisp
  41683. #: guix-git/doc/guix.texi:27820 guix-git/doc/guix.texi:27834
  41684. #, no-wrap
  41685. msgid ""
  41686. "(service cuirass-service-type\n"
  41687. " (cuirass-configuration\n"
  41688. " (specifications %cuirass-specs)))\n"
  41689. msgstr ""
  41690. #. type: Plain text
  41691. #: guix-git/doc/guix.texi:27824
  41692. msgid "To build the @code{linux-libre} package defined by the default Guix channel, one can use the following configuration."
  41693. msgstr ""
  41694. #. type: lisp
  41695. #: guix-git/doc/guix.texi:27830
  41696. #, no-wrap
  41697. msgid ""
  41698. "(define %cuirass-specs\n"
  41699. " #~(list (specification\n"
  41700. " (name \"my-linux\")\n"
  41701. " (build '(packages \"linux-libre\")))))\n"
  41702. "\n"
  41703. msgstr ""
  41704. #. type: Plain text
  41705. #: guix-git/doc/guix.texi:27839
  41706. msgid "The other configuration possibilities, as well as the specification record itself are described in the Cuirass manual (@pxref{Specifications,,, cuirass, Cuirass})."
  41707. msgstr ""
  41708. #. type: Plain text
  41709. #: guix-git/doc/guix.texi:27843
  41710. msgid "While information related to build jobs is located directly in the specifications, global settings for the @command{cuirass} process are accessible in other @code{cuirass-configuration} fields."
  41711. msgstr ""
  41712. #. type: deftp
  41713. #: guix-git/doc/guix.texi:27844
  41714. #, no-wrap
  41715. msgid "{Data Type} cuirass-configuration"
  41716. msgstr ""
  41717. #. type: deftp
  41718. #: guix-git/doc/guix.texi:27846
  41719. msgid "Data type representing the configuration of Cuirass."
  41720. msgstr ""
  41721. #. type: item
  41722. #: guix-git/doc/guix.texi:27848 guix-git/doc/guix.texi:27985
  41723. #, no-wrap
  41724. msgid "@code{cuirass} (default: @code{cuirass})"
  41725. msgstr ""
  41726. #. type: table
  41727. #: guix-git/doc/guix.texi:27850 guix-git/doc/guix.texi:27987
  41728. msgid "The Cuirass package to use."
  41729. msgstr ""
  41730. #. type: item
  41731. #: guix-git/doc/guix.texi:27851
  41732. #, no-wrap
  41733. msgid "@code{log-file} (default: @code{\"/var/log/cuirass.log\"})"
  41734. msgstr ""
  41735. #. type: table
  41736. #: guix-git/doc/guix.texi:27853 guix-git/doc/guix.texi:27957
  41737. #: guix-git/doc/guix.texi:28000
  41738. msgid "Location of the log file."
  41739. msgstr ""
  41740. #. type: item
  41741. #: guix-git/doc/guix.texi:27854
  41742. #, no-wrap
  41743. msgid "@code{web-log-file} (default: @code{\"/var/log/cuirass-web.log\"})"
  41744. msgstr ""
  41745. #. type: table
  41746. #: guix-git/doc/guix.texi:27856
  41747. msgid "Location of the log file used by the web interface."
  41748. msgstr ""
  41749. #. type: item
  41750. #: guix-git/doc/guix.texi:27857
  41751. #, no-wrap
  41752. msgid "@code{cache-directory} (default: @code{\"/var/cache/cuirass\"})"
  41753. msgstr ""
  41754. #. type: table
  41755. #: guix-git/doc/guix.texi:27859
  41756. msgid "Location of the repository cache."
  41757. msgstr ""
  41758. #. type: item
  41759. #: guix-git/doc/guix.texi:27860
  41760. #, no-wrap
  41761. msgid "@code{user} (default: @code{\"cuirass\"})"
  41762. msgstr ""
  41763. #. type: table
  41764. #: guix-git/doc/guix.texi:27862
  41765. msgid "Owner of the @code{cuirass} process."
  41766. msgstr ""
  41767. #. type: item
  41768. #: guix-git/doc/guix.texi:27863
  41769. #, no-wrap
  41770. msgid "@code{group} (default: @code{\"cuirass\"})"
  41771. msgstr ""
  41772. #. type: table
  41773. #: guix-git/doc/guix.texi:27865
  41774. msgid "Owner's group of the @code{cuirass} process."
  41775. msgstr ""
  41776. #. type: item
  41777. #: guix-git/doc/guix.texi:27866
  41778. #, no-wrap
  41779. msgid "@code{interval} (default: @code{60})"
  41780. msgstr ""
  41781. #. type: table
  41782. #: guix-git/doc/guix.texi:27869
  41783. msgid "Number of seconds between the poll of the repositories followed by the Cuirass jobs."
  41784. msgstr ""
  41785. #. type: item
  41786. #: guix-git/doc/guix.texi:27870
  41787. #, no-wrap
  41788. msgid "@code{parameters} (default: @code{#f})"
  41789. msgstr ""
  41790. #. type: table
  41791. #: guix-git/doc/guix.texi:27873
  41792. msgid "Read parameters from the given @var{parameters} file. The supported parameters are described here (@pxref{Parameters,,, cuirass, Cuirass})."
  41793. msgstr ""
  41794. #. type: item
  41795. #: guix-git/doc/guix.texi:27874
  41796. #, no-wrap
  41797. msgid "@code{remote-server} (default: @code{#f})"
  41798. msgstr ""
  41799. #. type: table
  41800. #: guix-git/doc/guix.texi:27877
  41801. msgid "A @code{cuirass-remote-server-configuration} record to use the build remote mechanism or @code{#f} to use the default build mechanism."
  41802. msgstr ""
  41803. #. type: item
  41804. #: guix-git/doc/guix.texi:27878
  41805. #, no-wrap
  41806. msgid "@code{database} (default: @code{\"dbname=cuirass host=/var/run/postgresql\"})"
  41807. msgstr ""
  41808. #. type: table
  41809. #: guix-git/doc/guix.texi:27883
  41810. msgid "Use @var{database} as the database containing the jobs and the past build results. Since Cuirass uses PostgreSQL as a database engine, @var{database} must be a string such as @code{\"dbname=cuirass host=localhost\"}."
  41811. msgstr ""
  41812. #. type: item
  41813. #: guix-git/doc/guix.texi:27884
  41814. #, no-wrap
  41815. msgid "@code{port} (default: @code{8081})"
  41816. msgstr ""
  41817. #. type: table
  41818. #: guix-git/doc/guix.texi:27886
  41819. msgid "Port number used by the HTTP server."
  41820. msgstr ""
  41821. #. type: table
  41822. #: guix-git/doc/guix.texi:27890
  41823. msgid "Listen on the network interface for @var{host}. The default is to accept connections from localhost."
  41824. msgstr ""
  41825. #. type: item
  41826. #: guix-git/doc/guix.texi:27891
  41827. #, no-wrap
  41828. msgid "@code{specifications} (default: @code{#~'()})"
  41829. msgstr ""
  41830. #. type: table
  41831. #: guix-git/doc/guix.texi:27895
  41832. msgid "A gexp (@pxref{G-Expressions}) that evaluates to a list of specifications records. The specification record is described in the Cuirass manual (@pxref{Specifications,,, cuirass, Cuirass})."
  41833. msgstr ""
  41834. #. type: item
  41835. #: guix-git/doc/guix.texi:27896
  41836. #, no-wrap
  41837. msgid "@code{use-substitutes?} (default: @code{#f})"
  41838. msgstr ""
  41839. #. type: table
  41840. #: guix-git/doc/guix.texi:27899
  41841. msgid "This allows using substitutes to avoid building every dependencies of a job from source."
  41842. msgstr ""
  41843. #. type: item
  41844. #: guix-git/doc/guix.texi:27900 guix-git/doc/guix.texi:34918
  41845. #, no-wrap
  41846. msgid "@code{one-shot?} (default: @code{#f})"
  41847. msgstr ""
  41848. #. type: table
  41849. #: guix-git/doc/guix.texi:27902
  41850. msgid "Only evaluate specifications and build derivations once."
  41851. msgstr ""
  41852. #. type: item
  41853. #: guix-git/doc/guix.texi:27903
  41854. #, no-wrap
  41855. msgid "@code{fallback?} (default: @code{#f})"
  41856. msgstr ""
  41857. #. type: table
  41858. #: guix-git/doc/guix.texi:27906
  41859. msgid "When substituting a pre-built binary fails, fall back to building packages locally."
  41860. msgstr ""
  41861. #. type: table
  41862. #: guix-git/doc/guix.texi:27909
  41863. msgid "Extra options to pass when running the Cuirass processes."
  41864. msgstr ""
  41865. #. type: cindex
  41866. #: guix-git/doc/guix.texi:27913
  41867. #, no-wrap
  41868. msgid "remote build"
  41869. msgstr ""
  41870. #. type: subsubheading
  41871. #: guix-git/doc/guix.texi:27914
  41872. #, no-wrap
  41873. msgid "Cuirass remote building"
  41874. msgstr ""
  41875. #. type: Plain text
  41876. #: guix-git/doc/guix.texi:27917
  41877. msgid "Cuirass supports two mechanisms to build derivations."
  41878. msgstr ""
  41879. #. type: item
  41880. #: guix-git/doc/guix.texi:27919
  41881. #, no-wrap
  41882. msgid "Using the local Guix daemon."
  41883. msgstr ""
  41884. #. type: itemize
  41885. #: guix-git/doc/guix.texi:27923
  41886. msgid "This is the default build mechanism. Once the build jobs are evaluated, they are sent to the local Guix daemon. Cuirass then listens to the Guix daemon output to detect the various build events."
  41887. msgstr ""
  41888. #. type: item
  41889. #: guix-git/doc/guix.texi:27924
  41890. #, no-wrap
  41891. msgid "Using the remote build mechanism."
  41892. msgstr ""
  41893. #. type: itemize
  41894. #: guix-git/doc/guix.texi:27928
  41895. msgid "The build jobs are not submitted to the local Guix daemon. Instead, a remote server dispatches build requests to the connect remote workers, according to the build priorities."
  41896. msgstr ""
  41897. #. type: Plain text
  41898. #: guix-git/doc/guix.texi:27935
  41899. msgid "To enable this build mode a @code{cuirass-remote-server-configuration} record must be passed as @code{remote-server} argument of the @code{cuirass-configuration} record. The @code{cuirass-remote-server-configuration} record is described below."
  41900. msgstr ""
  41901. #. type: Plain text
  41902. #: guix-git/doc/guix.texi:27940
  41903. msgid "This build mode scales way better than the default build mode. This is the build mode that is used on the GNU Guix build farm at @url{https://ci.guix.gnu.org}. It should be preferred when using Cuirass to build large amount of packages."
  41904. msgstr ""
  41905. #. type: deftp
  41906. #: guix-git/doc/guix.texi:27941
  41907. #, no-wrap
  41908. msgid "{Data Type} cuirass-remote-server-configuration"
  41909. msgstr ""
  41910. #. type: deftp
  41911. #: guix-git/doc/guix.texi:27943
  41912. msgid "Data type representing the configuration of the Cuirass remote-server."
  41913. msgstr ""
  41914. #. type: item
  41915. #: guix-git/doc/guix.texi:27945
  41916. #, no-wrap
  41917. msgid "@code{backend-port} (default: @code{5555})"
  41918. msgstr ""
  41919. #. type: table
  41920. #: guix-git/doc/guix.texi:27948
  41921. msgid "The TCP port for communicating with @code{remote-worker} processes using ZMQ. It defaults to @code{5555}."
  41922. msgstr ""
  41923. #. type: item
  41924. #: guix-git/doc/guix.texi:27949
  41925. #, no-wrap
  41926. msgid "@code{log-port} (default: @code{5556})"
  41927. msgstr ""
  41928. #. type: table
  41929. #: guix-git/doc/guix.texi:27951
  41930. msgid "The TCP port of the log server. It defaults to @code{5556}."
  41931. msgstr ""
  41932. #. type: item
  41933. #: guix-git/doc/guix.texi:27952
  41934. #, no-wrap
  41935. msgid "@code{publish-port} (default: @code{5557})"
  41936. msgstr ""
  41937. #. type: table
  41938. #: guix-git/doc/guix.texi:27954
  41939. msgid "The TCP port of the publish server. It defaults to @code{5557}."
  41940. msgstr ""
  41941. #. type: item
  41942. #: guix-git/doc/guix.texi:27955
  41943. #, no-wrap
  41944. msgid "@code{log-file} (default: @code{\"/var/log/cuirass-remote-server.log\"})"
  41945. msgstr ""
  41946. #. type: item
  41947. #: guix-git/doc/guix.texi:27958
  41948. #, no-wrap
  41949. msgid "@code{cache} (default: @code{\"/var/cache/cuirass/remote\"})"
  41950. msgstr ""
  41951. #. type: table
  41952. #: guix-git/doc/guix.texi:27960
  41953. msgid "Use @var{cache} directory to cache build log files."
  41954. msgstr ""
  41955. #. type: item
  41956. #: guix-git/doc/guix.texi:27961
  41957. #, no-wrap
  41958. msgid "@code{trigger-url} (default: @code{#f})"
  41959. msgstr ""
  41960. #. type: table
  41961. #: guix-git/doc/guix.texi:27964
  41962. msgid "Once a substitute is successfully fetched, trigger substitute baking at @var{trigger-url}."
  41963. msgstr ""
  41964. #. type: table
  41965. #: guix-git/doc/guix.texi:27969
  41966. msgid "If set to false, do not start a publish server and ignore the @code{publish-port} argument. This can be useful if there is already a standalone publish server standing next to the remote server."
  41967. msgstr ""
  41968. #. type: code{#1}
  41969. #: guix-git/doc/guix.texi:27971 guix-git/doc/guix.texi:28008
  41970. #, no-wrap
  41971. msgid "private-key"
  41972. msgstr ""
  41973. #. type: Plain text
  41974. #: guix-git/doc/guix.texi:27980
  41975. msgid "At least one remote worker must also be started on any machine of the local network to actually perform the builds and report their status."
  41976. msgstr ""
  41977. #. type: deftp
  41978. #: guix-git/doc/guix.texi:27981
  41979. #, no-wrap
  41980. msgid "{Data Type} cuirass-remote-worker-configuration"
  41981. msgstr ""
  41982. #. type: deftp
  41983. #: guix-git/doc/guix.texi:27983
  41984. msgid "Data type representing the configuration of the Cuirass remote-worker."
  41985. msgstr ""
  41986. #. type: item
  41987. #: guix-git/doc/guix.texi:27988
  41988. #, no-wrap
  41989. msgid "@code{workers} (default: @code{1})"
  41990. msgstr ""
  41991. #. type: table
  41992. #: guix-git/doc/guix.texi:27990
  41993. msgid "Start @var{workers} parallel workers."
  41994. msgstr ""
  41995. #. type: table
  41996. #: guix-git/doc/guix.texi:27994
  41997. msgid "Do not use Avahi discovery and connect to the given @code{server} IP address instead."
  41998. msgstr ""
  41999. #. type: item
  42000. #: guix-git/doc/guix.texi:27995
  42001. #, no-wrap
  42002. msgid "@code{systems} (default: @code{(list (%current-system))})"
  42003. msgstr ""
  42004. #. type: table
  42005. #: guix-git/doc/guix.texi:27997
  42006. msgid "Only request builds for the given @var{systems}."
  42007. msgstr ""
  42008. #. type: item
  42009. #: guix-git/doc/guix.texi:27998
  42010. #, no-wrap
  42011. msgid "@code{log-file} (default: @code{\"/var/log/cuirass-remote-worker.log\"})"
  42012. msgstr ""
  42013. #. type: item
  42014. #: guix-git/doc/guix.texi:28001
  42015. #, no-wrap
  42016. msgid "@code{publish-port} (default: @code{5558})"
  42017. msgstr ""
  42018. #. type: table
  42019. #: guix-git/doc/guix.texi:28003
  42020. msgid "The TCP port of the publish server. It defaults to @code{5558}."
  42021. msgstr ""
  42022. #. type: subsubheading
  42023. #: guix-git/doc/guix.texi:28015
  42024. #, no-wrap
  42025. msgid "Laminar"
  42026. msgstr ""
  42027. #. type: Plain text
  42028. #: guix-git/doc/guix.texi:28020
  42029. msgid "@uref{https://laminar.ohwg.net/, Laminar} is a lightweight and modular Continuous Integration service. It doesn't have a configuration web UI instead uses version-controllable configuration files and scripts."
  42030. msgstr ""
  42031. #. type: Plain text
  42032. #: guix-git/doc/guix.texi:28023
  42033. msgid "Laminar encourages the use of existing tools such as bash and cron instead of reinventing them."
  42034. msgstr ""
  42035. #. type: defvr
  42036. #: guix-git/doc/guix.texi:28024
  42037. #, no-wrap
  42038. msgid "{Scheme Procedure} laminar-service-type"
  42039. msgstr ""
  42040. #. type: defvr
  42041. #: guix-git/doc/guix.texi:28027
  42042. msgid "The type of the Laminar service. Its value must be a @code{laminar-configuration} object, as described below."
  42043. msgstr ""
  42044. #. type: defvr
  42045. #: guix-git/doc/guix.texi:28031
  42046. msgid "All configuration values have defaults, a minimal configuration to get Laminar running is shown below. By default, the web interface is available on port 8080."
  42047. msgstr ""
  42048. #. type: lisp
  42049. #: guix-git/doc/guix.texi:28034
  42050. #, no-wrap
  42051. msgid "(service laminar-service-type)\n"
  42052. msgstr ""
  42053. #. type: deftp
  42054. #: guix-git/doc/guix.texi:28037
  42055. #, no-wrap
  42056. msgid "{Data Type} laminar-configuration"
  42057. msgstr ""
  42058. #. type: deftp
  42059. #: guix-git/doc/guix.texi:28039
  42060. msgid "Data type representing the configuration of Laminar."
  42061. msgstr ""
  42062. #. type: item
  42063. #: guix-git/doc/guix.texi:28041
  42064. #, no-wrap
  42065. msgid "@code{laminar} (default: @code{laminar})"
  42066. msgstr ""
  42067. #. type: table
  42068. #: guix-git/doc/guix.texi:28043
  42069. msgid "The Laminar package to use."
  42070. msgstr ""
  42071. #. type: item
  42072. #: guix-git/doc/guix.texi:28044
  42073. #, no-wrap
  42074. msgid "@code{home-directory} (default: @code{\"/var/lib/laminar\"})"
  42075. msgstr ""
  42076. #. type: table
  42077. #: guix-git/doc/guix.texi:28046
  42078. msgid "The directory for job configurations and run directories."
  42079. msgstr ""
  42080. #. type: item
  42081. #: guix-git/doc/guix.texi:28047
  42082. #, no-wrap
  42083. msgid "@code{bind-http} (default: @code{\"*:8080\"})"
  42084. msgstr ""
  42085. #. type: table
  42086. #: guix-git/doc/guix.texi:28050
  42087. msgid "The interface/port or unix socket on which laminard should listen for incoming connections to the web frontend."
  42088. msgstr ""
  42089. #. type: item
  42090. #: guix-git/doc/guix.texi:28051
  42091. #, no-wrap
  42092. msgid "@code{bind-rpc} (default: @code{\"unix-abstract:laminar\"})"
  42093. msgstr ""
  42094. #. type: table
  42095. #: guix-git/doc/guix.texi:28054
  42096. msgid "The interface/port or unix socket on which laminard should listen for incoming commands such as build triggers."
  42097. msgstr ""
  42098. #. type: item
  42099. #: guix-git/doc/guix.texi:28055
  42100. #, no-wrap
  42101. msgid "@code{title} (default: @code{\"Laminar\"})"
  42102. msgstr ""
  42103. #. type: table
  42104. #: guix-git/doc/guix.texi:28057
  42105. msgid "The page title to show in the web frontend."
  42106. msgstr ""
  42107. #. type: item
  42108. #: guix-git/doc/guix.texi:28058
  42109. #, no-wrap
  42110. msgid "@code{keep-rundirs} (default: @code{0})"
  42111. msgstr ""
  42112. #. type: table
  42113. #: guix-git/doc/guix.texi:28062
  42114. msgid "Set to an integer defining how many rundirs to keep per job. The lowest-numbered ones will be deleted. The default is 0, meaning all run dirs will be immediately deleted."
  42115. msgstr ""
  42116. #. type: item
  42117. #: guix-git/doc/guix.texi:28063
  42118. #, no-wrap
  42119. msgid "@code{archive-url} (default: @code{#f})"
  42120. msgstr ""
  42121. #. type: table
  42122. #: guix-git/doc/guix.texi:28066
  42123. msgid "The web frontend served by laminard will use this URL to form links to artefacts archived jobs."
  42124. msgstr ""
  42125. #. type: item
  42126. #: guix-git/doc/guix.texi:28067
  42127. #, no-wrap
  42128. msgid "@code{base-url} (default: @code{#f})"
  42129. msgstr ""
  42130. #. type: table
  42131. #: guix-git/doc/guix.texi:28069
  42132. msgid "Base URL to use for links to laminar itself."
  42133. msgstr ""
  42134. #. type: cindex
  42135. #: guix-git/doc/guix.texi:28076
  42136. #, no-wrap
  42137. msgid "tlp"
  42138. msgstr ""
  42139. #. type: cindex
  42140. #: guix-git/doc/guix.texi:28077
  42141. #, no-wrap
  42142. msgid "power management with TLP"
  42143. msgstr ""
  42144. #. type: subsubheading
  42145. #: guix-git/doc/guix.texi:28078
  42146. #, no-wrap
  42147. msgid "TLP daemon"
  42148. msgstr ""
  42149. #. type: Plain text
  42150. #: guix-git/doc/guix.texi:28082
  42151. msgid "The @code{(gnu services pm)} module provides a Guix service definition for the Linux power management tool TLP."
  42152. msgstr ""
  42153. #. type: Plain text
  42154. #: guix-git/doc/guix.texi:28088
  42155. msgid "TLP enables various powersaving modes in userspace and kernel. Contrary to @code{upower-service}, it is not a passive, monitoring tool, as it will apply custom settings each time a new power source is detected. More information can be found at @uref{https://linrunner.de/en/tlp/tlp.html, TLP home page}."
  42156. msgstr ""
  42157. #. type: deffn
  42158. #: guix-git/doc/guix.texi:28089
  42159. #, no-wrap
  42160. msgid "{Scheme Variable} tlp-service-type"
  42161. msgstr ""
  42162. #. type: deffn
  42163. #: guix-git/doc/guix.texi:28093
  42164. msgid "The service type for the TLP tool. The default settings are optimised for battery life on most systems, but you can tweak them to your heart's content by adding a valid @code{tlp-configuration}:"
  42165. msgstr ""
  42166. #. type: lisp
  42167. #: guix-git/doc/guix.texi:28098
  42168. #, no-wrap
  42169. msgid ""
  42170. "(service tlp-service-type\n"
  42171. " (tlp-configuration\n"
  42172. " (cpu-scaling-governor-on-ac (list \"performance\"))\n"
  42173. " (sched-powersave-on-bat? #t)))\n"
  42174. msgstr ""
  42175. #. type: Plain text
  42176. #: guix-git/doc/guix.texi:28106
  42177. msgid "Each parameter definition is preceded by its type; for example, @samp{boolean foo} indicates that the @code{foo} parameter should be specified as a boolean. Types starting with @code{maybe-} denote parameters that won't show up in TLP config file when their value is @code{'disabled}."
  42178. msgstr ""
  42179. #. type: Plain text
  42180. #: guix-git/doc/guix.texi:28116
  42181. msgid "Available @code{tlp-configuration} fields are:"
  42182. msgstr ""
  42183. #. type: deftypevr
  42184. #: guix-git/doc/guix.texi:28117
  42185. #, no-wrap
  42186. msgid "{@code{tlp-configuration} parameter} package tlp"
  42187. msgstr ""
  42188. #. type: deftypevr
  42189. #: guix-git/doc/guix.texi:28119
  42190. msgid "The TLP package."
  42191. msgstr ""
  42192. #. type: deftypevr
  42193. #: guix-git/doc/guix.texi:28122
  42194. #, no-wrap
  42195. msgid "{@code{tlp-configuration} parameter} boolean tlp-enable?"
  42196. msgstr ""
  42197. #. type: deftypevr
  42198. #: guix-git/doc/guix.texi:28124
  42199. msgid "Set to true if you wish to enable TLP."
  42200. msgstr ""
  42201. #. type: deftypevr
  42202. #: guix-git/doc/guix.texi:28129
  42203. #, no-wrap
  42204. msgid "{@code{tlp-configuration} parameter} string tlp-default-mode"
  42205. msgstr ""
  42206. #. type: deftypevr
  42207. #: guix-git/doc/guix.texi:28132
  42208. msgid "Default mode when no power supply can be detected. Alternatives are AC and BAT."
  42209. msgstr ""
  42210. #. type: deftypevr
  42211. #: guix-git/doc/guix.texi:28134
  42212. msgid "Defaults to @samp{\"AC\"}."
  42213. msgstr ""
  42214. #. type: deftypevr
  42215. #: guix-git/doc/guix.texi:28137
  42216. #, no-wrap
  42217. msgid "{@code{tlp-configuration} parameter} non-negative-integer disk-idle-secs-on-ac"
  42218. msgstr ""
  42219. #. type: deftypevr
  42220. #: guix-git/doc/guix.texi:28140
  42221. msgid "Number of seconds Linux kernel has to wait after the disk goes idle, before syncing on AC."
  42222. msgstr ""
  42223. #. type: deftypevr
  42224. #: guix-git/doc/guix.texi:28145
  42225. #, no-wrap
  42226. msgid "{@code{tlp-configuration} parameter} non-negative-integer disk-idle-secs-on-bat"
  42227. msgstr ""
  42228. #. type: deftypevr
  42229. #: guix-git/doc/guix.texi:28147
  42230. msgid "Same as @code{disk-idle-ac} but on BAT mode."
  42231. msgstr ""
  42232. #. type: deftypevr
  42233. #: guix-git/doc/guix.texi:28149
  42234. msgid "Defaults to @samp{2}."
  42235. msgstr ""
  42236. #. type: deftypevr
  42237. #: guix-git/doc/guix.texi:28152
  42238. #, no-wrap
  42239. msgid "{@code{tlp-configuration} parameter} non-negative-integer max-lost-work-secs-on-ac"
  42240. msgstr ""
  42241. #. type: deftypevr
  42242. #: guix-git/doc/guix.texi:28154
  42243. msgid "Dirty pages flushing periodicity, expressed in seconds."
  42244. msgstr ""
  42245. #. type: deftypevr
  42246. #: guix-git/doc/guix.texi:28156 guix-git/doc/guix.texi:28379
  42247. #: guix-git/doc/guix.texi:30594 guix-git/doc/guix.texi:30602
  42248. msgid "Defaults to @samp{15}."
  42249. msgstr ""
  42250. #. type: deftypevr
  42251. #: guix-git/doc/guix.texi:28159
  42252. #, no-wrap
  42253. msgid "{@code{tlp-configuration} parameter} non-negative-integer max-lost-work-secs-on-bat"
  42254. msgstr ""
  42255. #. type: deftypevr
  42256. #: guix-git/doc/guix.texi:28161
  42257. msgid "Same as @code{max-lost-work-secs-on-ac} but on BAT mode."
  42258. msgstr ""
  42259. #. type: deftypevr
  42260. #: guix-git/doc/guix.texi:28163
  42261. msgid "Defaults to @samp{60}."
  42262. msgstr ""
  42263. #. type: deftypevr
  42264. #: guix-git/doc/guix.texi:28166
  42265. #, no-wrap
  42266. msgid "{@code{tlp-configuration} parameter} maybe-space-separated-string-list cpu-scaling-governor-on-ac"
  42267. msgstr ""
  42268. #. type: deftypevr
  42269. #: guix-git/doc/guix.texi:28170
  42270. msgid "CPU frequency scaling governor on AC mode. With intel_pstate driver, alternatives are powersave and performance. With acpi-cpufreq driver, alternatives are ondemand, powersave, performance and conservative."
  42271. msgstr ""
  42272. #. type: deftypevr
  42273. #: guix-git/doc/guix.texi:28175
  42274. #, no-wrap
  42275. msgid "{@code{tlp-configuration} parameter} maybe-space-separated-string-list cpu-scaling-governor-on-bat"
  42276. msgstr ""
  42277. #. type: deftypevr
  42278. #: guix-git/doc/guix.texi:28177
  42279. msgid "Same as @code{cpu-scaling-governor-on-ac} but on BAT mode."
  42280. msgstr ""
  42281. #. type: deftypevr
  42282. #: guix-git/doc/guix.texi:28182
  42283. #, no-wrap
  42284. msgid "{@code{tlp-configuration} parameter} maybe-non-negative-integer cpu-scaling-min-freq-on-ac"
  42285. msgstr ""
  42286. #. type: deftypevr
  42287. #: guix-git/doc/guix.texi:28184
  42288. msgid "Set the min available frequency for the scaling governor on AC."
  42289. msgstr ""
  42290. #. type: deftypevr
  42291. #: guix-git/doc/guix.texi:28189
  42292. #, no-wrap
  42293. msgid "{@code{tlp-configuration} parameter} maybe-non-negative-integer cpu-scaling-max-freq-on-ac"
  42294. msgstr ""
  42295. #. type: deftypevr
  42296. #: guix-git/doc/guix.texi:28191
  42297. msgid "Set the max available frequency for the scaling governor on AC."
  42298. msgstr ""
  42299. #. type: deftypevr
  42300. #: guix-git/doc/guix.texi:28196
  42301. #, no-wrap
  42302. msgid "{@code{tlp-configuration} parameter} maybe-non-negative-integer cpu-scaling-min-freq-on-bat"
  42303. msgstr ""
  42304. #. type: deftypevr
  42305. #: guix-git/doc/guix.texi:28198
  42306. msgid "Set the min available frequency for the scaling governor on BAT."
  42307. msgstr ""
  42308. #. type: deftypevr
  42309. #: guix-git/doc/guix.texi:28203
  42310. #, no-wrap
  42311. msgid "{@code{tlp-configuration} parameter} maybe-non-negative-integer cpu-scaling-max-freq-on-bat"
  42312. msgstr ""
  42313. #. type: deftypevr
  42314. #: guix-git/doc/guix.texi:28205
  42315. msgid "Set the max available frequency for the scaling governor on BAT."
  42316. msgstr ""
  42317. #. type: deftypevr
  42318. #: guix-git/doc/guix.texi:28210
  42319. #, no-wrap
  42320. msgid "{@code{tlp-configuration} parameter} maybe-non-negative-integer cpu-min-perf-on-ac"
  42321. msgstr ""
  42322. #. type: deftypevr
  42323. #: guix-git/doc/guix.texi:28213
  42324. msgid "Limit the min P-state to control the power dissipation of the CPU, in AC mode. Values are stated as a percentage of the available performance."
  42325. msgstr ""
  42326. #. type: deftypevr
  42327. #: guix-git/doc/guix.texi:28218
  42328. #, no-wrap
  42329. msgid "{@code{tlp-configuration} parameter} maybe-non-negative-integer cpu-max-perf-on-ac"
  42330. msgstr ""
  42331. #. type: deftypevr
  42332. #: guix-git/doc/guix.texi:28221
  42333. msgid "Limit the max P-state to control the power dissipation of the CPU, in AC mode. Values are stated as a percentage of the available performance."
  42334. msgstr ""
  42335. #. type: deftypevr
  42336. #: guix-git/doc/guix.texi:28226
  42337. #, no-wrap
  42338. msgid "{@code{tlp-configuration} parameter} maybe-non-negative-integer cpu-min-perf-on-bat"
  42339. msgstr ""
  42340. #. type: deftypevr
  42341. #: guix-git/doc/guix.texi:28228
  42342. msgid "Same as @code{cpu-min-perf-on-ac} on BAT mode."
  42343. msgstr ""
  42344. #. type: deftypevr
  42345. #: guix-git/doc/guix.texi:28233
  42346. #, no-wrap
  42347. msgid "{@code{tlp-configuration} parameter} maybe-non-negative-integer cpu-max-perf-on-bat"
  42348. msgstr ""
  42349. #. type: deftypevr
  42350. #: guix-git/doc/guix.texi:28235
  42351. msgid "Same as @code{cpu-max-perf-on-ac} on BAT mode."
  42352. msgstr ""
  42353. #. type: deftypevr
  42354. #: guix-git/doc/guix.texi:28240
  42355. #, no-wrap
  42356. msgid "{@code{tlp-configuration} parameter} maybe-boolean cpu-boost-on-ac?"
  42357. msgstr ""
  42358. #. type: deftypevr
  42359. #: guix-git/doc/guix.texi:28242
  42360. msgid "Enable CPU turbo boost feature on AC mode."
  42361. msgstr ""
  42362. #. type: deftypevr
  42363. #: guix-git/doc/guix.texi:28247
  42364. #, no-wrap
  42365. msgid "{@code{tlp-configuration} parameter} maybe-boolean cpu-boost-on-bat?"
  42366. msgstr ""
  42367. #. type: deftypevr
  42368. #: guix-git/doc/guix.texi:28249
  42369. msgid "Same as @code{cpu-boost-on-ac?} on BAT mode."
  42370. msgstr ""
  42371. #. type: deftypevr
  42372. #: guix-git/doc/guix.texi:28254
  42373. #, no-wrap
  42374. msgid "{@code{tlp-configuration} parameter} boolean sched-powersave-on-ac?"
  42375. msgstr ""
  42376. #. type: deftypevr
  42377. #: guix-git/doc/guix.texi:28257
  42378. msgid "Allow Linux kernel to minimize the number of CPU cores/hyper-threads used under light load conditions."
  42379. msgstr ""
  42380. #. type: deftypevr
  42381. #: guix-git/doc/guix.texi:28262
  42382. #, no-wrap
  42383. msgid "{@code{tlp-configuration} parameter} boolean sched-powersave-on-bat?"
  42384. msgstr ""
  42385. #. type: deftypevr
  42386. #: guix-git/doc/guix.texi:28264
  42387. msgid "Same as @code{sched-powersave-on-ac?} but on BAT mode."
  42388. msgstr ""
  42389. #. type: deftypevr
  42390. #: guix-git/doc/guix.texi:28269
  42391. #, no-wrap
  42392. msgid "{@code{tlp-configuration} parameter} boolean nmi-watchdog?"
  42393. msgstr ""
  42394. #. type: deftypevr
  42395. #: guix-git/doc/guix.texi:28271
  42396. msgid "Enable Linux kernel NMI watchdog."
  42397. msgstr ""
  42398. #. type: deftypevr
  42399. #: guix-git/doc/guix.texi:28276
  42400. #, no-wrap
  42401. msgid "{@code{tlp-configuration} parameter} maybe-string phc-controls"
  42402. msgstr ""
  42403. #. type: deftypevr
  42404. #: guix-git/doc/guix.texi:28279
  42405. msgid "For Linux kernels with PHC patch applied, change CPU voltages. An example value would be @samp{\"F:V F:V F:V F:V\"}."
  42406. msgstr ""
  42407. #. type: deftypevr
  42408. #: guix-git/doc/guix.texi:28284
  42409. #, no-wrap
  42410. msgid "{@code{tlp-configuration} parameter} string energy-perf-policy-on-ac"
  42411. msgstr ""
  42412. #. type: deftypevr
  42413. #: guix-git/doc/guix.texi:28287
  42414. msgid "Set CPU performance versus energy saving policy on AC@. Alternatives are performance, normal, powersave."
  42415. msgstr ""
  42416. #. type: deftypevr
  42417. #: guix-git/doc/guix.texi:28289 guix-git/doc/guix.texi:28387
  42418. #: guix-git/doc/guix.texi:28417
  42419. msgid "Defaults to @samp{\"performance\"}."
  42420. msgstr ""
  42421. #. type: deftypevr
  42422. #: guix-git/doc/guix.texi:28292
  42423. #, no-wrap
  42424. msgid "{@code{tlp-configuration} parameter} string energy-perf-policy-on-bat"
  42425. msgstr ""
  42426. #. type: deftypevr
  42427. #: guix-git/doc/guix.texi:28294
  42428. msgid "Same as @code{energy-perf-policy-ac} but on BAT mode."
  42429. msgstr ""
  42430. #. type: deftypevr
  42431. #: guix-git/doc/guix.texi:28296 guix-git/doc/guix.texi:28394
  42432. msgid "Defaults to @samp{\"powersave\"}."
  42433. msgstr ""
  42434. #. type: deftypevr
  42435. #: guix-git/doc/guix.texi:28299
  42436. #, no-wrap
  42437. msgid "{@code{tlp-configuration} parameter} space-separated-string-list disks-devices"
  42438. msgstr ""
  42439. #. type: deftypevr
  42440. #: guix-git/doc/guix.texi:28301
  42441. msgid "Hard disk devices."
  42442. msgstr ""
  42443. #. type: deftypevr
  42444. #: guix-git/doc/guix.texi:28304
  42445. #, no-wrap
  42446. msgid "{@code{tlp-configuration} parameter} space-separated-string-list disk-apm-level-on-ac"
  42447. msgstr ""
  42448. #. type: deftypevr
  42449. #: guix-git/doc/guix.texi:28306
  42450. msgid "Hard disk advanced power management level."
  42451. msgstr ""
  42452. #. type: deftypevr
  42453. #: guix-git/doc/guix.texi:28309
  42454. #, no-wrap
  42455. msgid "{@code{tlp-configuration} parameter} space-separated-string-list disk-apm-level-on-bat"
  42456. msgstr ""
  42457. #. type: deftypevr
  42458. #: guix-git/doc/guix.texi:28311
  42459. msgid "Same as @code{disk-apm-bat} but on BAT mode."
  42460. msgstr ""
  42461. #. type: deftypevr
  42462. #: guix-git/doc/guix.texi:28314
  42463. #, no-wrap
  42464. msgid "{@code{tlp-configuration} parameter} maybe-space-separated-string-list disk-spindown-timeout-on-ac"
  42465. msgstr ""
  42466. #. type: deftypevr
  42467. #: guix-git/doc/guix.texi:28317
  42468. msgid "Hard disk spin down timeout. One value has to be specified for each declared hard disk."
  42469. msgstr ""
  42470. #. type: deftypevr
  42471. #: guix-git/doc/guix.texi:28322
  42472. #, no-wrap
  42473. msgid "{@code{tlp-configuration} parameter} maybe-space-separated-string-list disk-spindown-timeout-on-bat"
  42474. msgstr ""
  42475. #. type: deftypevr
  42476. #: guix-git/doc/guix.texi:28324
  42477. msgid "Same as @code{disk-spindown-timeout-on-ac} but on BAT mode."
  42478. msgstr ""
  42479. #. type: deftypevr
  42480. #: guix-git/doc/guix.texi:28329
  42481. #, no-wrap
  42482. msgid "{@code{tlp-configuration} parameter} maybe-space-separated-string-list disk-iosched"
  42483. msgstr ""
  42484. #. type: deftypevr
  42485. #: guix-git/doc/guix.texi:28333
  42486. msgid "Select IO scheduler for disk devices. One value has to be specified for each declared hard disk. Example alternatives are cfq, deadline and noop."
  42487. msgstr ""
  42488. #. type: deftypevr
  42489. #: guix-git/doc/guix.texi:28338
  42490. #, no-wrap
  42491. msgid "{@code{tlp-configuration} parameter} string sata-linkpwr-on-ac"
  42492. msgstr ""
  42493. #. type: deftypevr
  42494. #: guix-git/doc/guix.texi:28341
  42495. msgid "SATA aggressive link power management (ALPM) level. Alternatives are min_power, medium_power, max_performance."
  42496. msgstr ""
  42497. #. type: deftypevr
  42498. #: guix-git/doc/guix.texi:28343
  42499. msgid "Defaults to @samp{\"max_performance\"}."
  42500. msgstr ""
  42501. #. type: deftypevr
  42502. #: guix-git/doc/guix.texi:28346
  42503. #, no-wrap
  42504. msgid "{@code{tlp-configuration} parameter} string sata-linkpwr-on-bat"
  42505. msgstr ""
  42506. #. type: deftypevr
  42507. #: guix-git/doc/guix.texi:28348
  42508. msgid "Same as @code{sata-linkpwr-ac} but on BAT mode."
  42509. msgstr ""
  42510. #. type: deftypevr
  42511. #: guix-git/doc/guix.texi:28350
  42512. msgid "Defaults to @samp{\"min_power\"}."
  42513. msgstr ""
  42514. #. type: deftypevr
  42515. #: guix-git/doc/guix.texi:28353
  42516. #, no-wrap
  42517. msgid "{@code{tlp-configuration} parameter} maybe-string sata-linkpwr-blacklist"
  42518. msgstr ""
  42519. #. type: deftypevr
  42520. #: guix-git/doc/guix.texi:28355
  42521. msgid "Exclude specified SATA host devices for link power management."
  42522. msgstr ""
  42523. #. type: deftypevr
  42524. #: guix-git/doc/guix.texi:28360
  42525. #, no-wrap
  42526. msgid "{@code{tlp-configuration} parameter} maybe-on-off-boolean ahci-runtime-pm-on-ac?"
  42527. msgstr ""
  42528. #. type: deftypevr
  42529. #: guix-git/doc/guix.texi:28363
  42530. msgid "Enable Runtime Power Management for AHCI controller and disks on AC mode."
  42531. msgstr ""
  42532. #. type: deftypevr
  42533. #: guix-git/doc/guix.texi:28368
  42534. #, no-wrap
  42535. msgid "{@code{tlp-configuration} parameter} maybe-on-off-boolean ahci-runtime-pm-on-bat?"
  42536. msgstr ""
  42537. #. type: deftypevr
  42538. #: guix-git/doc/guix.texi:28370
  42539. msgid "Same as @code{ahci-runtime-pm-on-ac} on BAT mode."
  42540. msgstr ""
  42541. #. type: deftypevr
  42542. #: guix-git/doc/guix.texi:28375
  42543. #, no-wrap
  42544. msgid "{@code{tlp-configuration} parameter} non-negative-integer ahci-runtime-pm-timeout"
  42545. msgstr ""
  42546. #. type: deftypevr
  42547. #: guix-git/doc/guix.texi:28377
  42548. msgid "Seconds of inactivity before disk is suspended."
  42549. msgstr ""
  42550. #. type: deftypevr
  42551. #: guix-git/doc/guix.texi:28382
  42552. #, no-wrap
  42553. msgid "{@code{tlp-configuration} parameter} string pcie-aspm-on-ac"
  42554. msgstr ""
  42555. #. type: deftypevr
  42556. #: guix-git/doc/guix.texi:28385
  42557. msgid "PCI Express Active State Power Management level. Alternatives are default, performance, powersave."
  42558. msgstr ""
  42559. #. type: deftypevr
  42560. #: guix-git/doc/guix.texi:28390
  42561. #, no-wrap
  42562. msgid "{@code{tlp-configuration} parameter} string pcie-aspm-on-bat"
  42563. msgstr ""
  42564. #. type: deftypevr
  42565. #: guix-git/doc/guix.texi:28392
  42566. msgid "Same as @code{pcie-aspm-ac} but on BAT mode."
  42567. msgstr ""
  42568. #. type: deftypevr
  42569. #: guix-git/doc/guix.texi:28397
  42570. #, no-wrap
  42571. msgid "{@code{tlp-configuration} parameter} string radeon-power-profile-on-ac"
  42572. msgstr ""
  42573. #. type: deftypevr
  42574. #: guix-git/doc/guix.texi:28400
  42575. msgid "Radeon graphics clock speed level. Alternatives are low, mid, high, auto, default."
  42576. msgstr ""
  42577. #. type: deftypevr
  42578. #: guix-git/doc/guix.texi:28402
  42579. msgid "Defaults to @samp{\"high\"}."
  42580. msgstr ""
  42581. #. type: deftypevr
  42582. #: guix-git/doc/guix.texi:28405
  42583. #, no-wrap
  42584. msgid "{@code{tlp-configuration} parameter} string radeon-power-profile-on-bat"
  42585. msgstr ""
  42586. #. type: deftypevr
  42587. #: guix-git/doc/guix.texi:28407
  42588. msgid "Same as @code{radeon-power-ac} but on BAT mode."
  42589. msgstr ""
  42590. #. type: deftypevr
  42591. #: guix-git/doc/guix.texi:28409
  42592. msgid "Defaults to @samp{\"low\"}."
  42593. msgstr ""
  42594. #. type: deftypevr
  42595. #: guix-git/doc/guix.texi:28412
  42596. #, no-wrap
  42597. msgid "{@code{tlp-configuration} parameter} string radeon-dpm-state-on-ac"
  42598. msgstr ""
  42599. #. type: deftypevr
  42600. #: guix-git/doc/guix.texi:28415
  42601. msgid "Radeon dynamic power management method (DPM). Alternatives are battery, performance."
  42602. msgstr ""
  42603. #. type: deftypevr
  42604. #: guix-git/doc/guix.texi:28420
  42605. #, no-wrap
  42606. msgid "{@code{tlp-configuration} parameter} string radeon-dpm-state-on-bat"
  42607. msgstr ""
  42608. #. type: deftypevr
  42609. #: guix-git/doc/guix.texi:28422
  42610. msgid "Same as @code{radeon-dpm-state-ac} but on BAT mode."
  42611. msgstr ""
  42612. #. type: deftypevr
  42613. #: guix-git/doc/guix.texi:28424
  42614. msgid "Defaults to @samp{\"battery\"}."
  42615. msgstr ""
  42616. #. type: deftypevr
  42617. #: guix-git/doc/guix.texi:28427
  42618. #, no-wrap
  42619. msgid "{@code{tlp-configuration} parameter} string radeon-dpm-perf-level-on-ac"
  42620. msgstr ""
  42621. #. type: deftypevr
  42622. #: guix-git/doc/guix.texi:28429
  42623. msgid "Radeon DPM performance level. Alternatives are auto, low, high."
  42624. msgstr ""
  42625. #. type: deftypevr
  42626. #: guix-git/doc/guix.texi:28431 guix-git/doc/guix.texi:28438
  42627. #: guix-git/doc/guix.texi:28512
  42628. msgid "Defaults to @samp{\"auto\"}."
  42629. msgstr ""
  42630. #. type: deftypevr
  42631. #: guix-git/doc/guix.texi:28434
  42632. #, no-wrap
  42633. msgid "{@code{tlp-configuration} parameter} string radeon-dpm-perf-level-on-bat"
  42634. msgstr ""
  42635. #. type: deftypevr
  42636. #: guix-git/doc/guix.texi:28436
  42637. msgid "Same as @code{radeon-dpm-perf-ac} but on BAT mode."
  42638. msgstr ""
  42639. #. type: deftypevr
  42640. #: guix-git/doc/guix.texi:28441
  42641. #, no-wrap
  42642. msgid "{@code{tlp-configuration} parameter} on-off-boolean wifi-pwr-on-ac?"
  42643. msgstr ""
  42644. #. type: deftypevr
  42645. #: guix-git/doc/guix.texi:28443
  42646. msgid "Wifi power saving mode."
  42647. msgstr ""
  42648. #. type: deftypevr
  42649. #: guix-git/doc/guix.texi:28448
  42650. #, no-wrap
  42651. msgid "{@code{tlp-configuration} parameter} on-off-boolean wifi-pwr-on-bat?"
  42652. msgstr ""
  42653. #. type: deftypevr
  42654. #: guix-git/doc/guix.texi:28450
  42655. msgid "Same as @code{wifi-power-ac?} but on BAT mode."
  42656. msgstr ""
  42657. #. type: deftypevr
  42658. #: guix-git/doc/guix.texi:28455
  42659. #, no-wrap
  42660. msgid "{@code{tlp-configuration} parameter} y-n-boolean wol-disable?"
  42661. msgstr ""
  42662. #. type: deftypevr
  42663. #: guix-git/doc/guix.texi:28457
  42664. msgid "Disable wake on LAN."
  42665. msgstr ""
  42666. #. type: deftypevr
  42667. #: guix-git/doc/guix.texi:28462
  42668. #, no-wrap
  42669. msgid "{@code{tlp-configuration} parameter} non-negative-integer sound-power-save-on-ac"
  42670. msgstr ""
  42671. #. type: deftypevr
  42672. #: guix-git/doc/guix.texi:28465
  42673. msgid "Timeout duration in seconds before activating audio power saving on Intel HDA and AC97 devices. A value of 0 disables power saving."
  42674. msgstr ""
  42675. #. type: deftypevr
  42676. #: guix-git/doc/guix.texi:28470
  42677. #, no-wrap
  42678. msgid "{@code{tlp-configuration} parameter} non-negative-integer sound-power-save-on-bat"
  42679. msgstr ""
  42680. #. type: deftypevr
  42681. #: guix-git/doc/guix.texi:28472
  42682. msgid "Same as @code{sound-powersave-ac} but on BAT mode."
  42683. msgstr ""
  42684. #. type: deftypevr
  42685. #: guix-git/doc/guix.texi:28477
  42686. #, no-wrap
  42687. msgid "{@code{tlp-configuration} parameter} y-n-boolean sound-power-save-controller?"
  42688. msgstr ""
  42689. #. type: deftypevr
  42690. #: guix-git/doc/guix.texi:28479
  42691. msgid "Disable controller in powersaving mode on Intel HDA devices."
  42692. msgstr ""
  42693. #. type: deftypevr
  42694. #: guix-git/doc/guix.texi:28484
  42695. #, no-wrap
  42696. msgid "{@code{tlp-configuration} parameter} boolean bay-poweroff-on-bat?"
  42697. msgstr ""
  42698. #. type: deftypevr
  42699. #: guix-git/doc/guix.texi:28488
  42700. msgid "Enable optical drive in UltraBay/MediaBay on BAT mode. Drive can be powered on again by releasing (and reinserting) the eject lever or by pressing the disc eject button on newer models."
  42701. msgstr ""
  42702. #. type: deftypevr
  42703. #: guix-git/doc/guix.texi:28493
  42704. #, no-wrap
  42705. msgid "{@code{tlp-configuration} parameter} string bay-device"
  42706. msgstr ""
  42707. #. type: deftypevr
  42708. #: guix-git/doc/guix.texi:28495
  42709. msgid "Name of the optical drive device to power off."
  42710. msgstr ""
  42711. #. type: deftypevr
  42712. #: guix-git/doc/guix.texi:28497
  42713. msgid "Defaults to @samp{\"sr0\"}."
  42714. msgstr ""
  42715. #. type: deftypevr
  42716. #: guix-git/doc/guix.texi:28500
  42717. #, no-wrap
  42718. msgid "{@code{tlp-configuration} parameter} string runtime-pm-on-ac"
  42719. msgstr ""
  42720. #. type: deftypevr
  42721. #: guix-git/doc/guix.texi:28503
  42722. msgid "Runtime Power Management for PCI(e) bus devices. Alternatives are on and auto."
  42723. msgstr ""
  42724. #. type: deftypevr
  42725. #: guix-git/doc/guix.texi:28505
  42726. msgid "Defaults to @samp{\"on\"}."
  42727. msgstr ""
  42728. #. type: deftypevr
  42729. #: guix-git/doc/guix.texi:28508
  42730. #, no-wrap
  42731. msgid "{@code{tlp-configuration} parameter} string runtime-pm-on-bat"
  42732. msgstr ""
  42733. #. type: deftypevr
  42734. #: guix-git/doc/guix.texi:28510
  42735. msgid "Same as @code{runtime-pm-ac} but on BAT mode."
  42736. msgstr ""
  42737. #. type: deftypevr
  42738. #: guix-git/doc/guix.texi:28515
  42739. #, no-wrap
  42740. msgid "{@code{tlp-configuration} parameter} boolean runtime-pm-all?"
  42741. msgstr ""
  42742. #. type: deftypevr
  42743. #: guix-git/doc/guix.texi:28518
  42744. msgid "Runtime Power Management for all PCI(e) bus devices, except blacklisted ones."
  42745. msgstr ""
  42746. #. type: deftypevr
  42747. #: guix-git/doc/guix.texi:28523
  42748. #, no-wrap
  42749. msgid "{@code{tlp-configuration} parameter} maybe-space-separated-string-list runtime-pm-blacklist"
  42750. msgstr ""
  42751. #. type: deftypevr
  42752. #: guix-git/doc/guix.texi:28525
  42753. msgid "Exclude specified PCI(e) device addresses from Runtime Power Management."
  42754. msgstr ""
  42755. #. type: deftypevr
  42756. #: guix-git/doc/guix.texi:28530
  42757. #, no-wrap
  42758. msgid "{@code{tlp-configuration} parameter} space-separated-string-list runtime-pm-driver-blacklist"
  42759. msgstr ""
  42760. #. type: deftypevr
  42761. #: guix-git/doc/guix.texi:28533
  42762. msgid "Exclude PCI(e) devices assigned to the specified drivers from Runtime Power Management."
  42763. msgstr ""
  42764. #. type: deftypevr
  42765. #: guix-git/doc/guix.texi:28536
  42766. #, no-wrap
  42767. msgid "{@code{tlp-configuration} parameter} boolean usb-autosuspend?"
  42768. msgstr ""
  42769. #. type: deftypevr
  42770. #: guix-git/doc/guix.texi:28538
  42771. msgid "Enable USB autosuspend feature."
  42772. msgstr ""
  42773. #. type: deftypevr
  42774. #: guix-git/doc/guix.texi:28543
  42775. #, no-wrap
  42776. msgid "{@code{tlp-configuration} parameter} maybe-string usb-blacklist"
  42777. msgstr ""
  42778. #. type: deftypevr
  42779. #: guix-git/doc/guix.texi:28545
  42780. msgid "Exclude specified devices from USB autosuspend."
  42781. msgstr ""
  42782. #. type: deftypevr
  42783. #: guix-git/doc/guix.texi:28550
  42784. #, no-wrap
  42785. msgid "{@code{tlp-configuration} parameter} boolean usb-blacklist-wwan?"
  42786. msgstr ""
  42787. #. type: deftypevr
  42788. #: guix-git/doc/guix.texi:28552
  42789. msgid "Exclude WWAN devices from USB autosuspend."
  42790. msgstr ""
  42791. #. type: deftypevr
  42792. #: guix-git/doc/guix.texi:28557
  42793. #, no-wrap
  42794. msgid "{@code{tlp-configuration} parameter} maybe-string usb-whitelist"
  42795. msgstr ""
  42796. #. type: deftypevr
  42797. #: guix-git/doc/guix.texi:28560
  42798. msgid "Include specified devices into USB autosuspend, even if they are already excluded by the driver or via @code{usb-blacklist-wwan?}."
  42799. msgstr ""
  42800. #. type: deftypevr
  42801. #: guix-git/doc/guix.texi:28565
  42802. #, no-wrap
  42803. msgid "{@code{tlp-configuration} parameter} maybe-boolean usb-autosuspend-disable-on-shutdown?"
  42804. msgstr ""
  42805. #. type: deftypevr
  42806. #: guix-git/doc/guix.texi:28567
  42807. msgid "Enable USB autosuspend before shutdown."
  42808. msgstr ""
  42809. #. type: deftypevr
  42810. #: guix-git/doc/guix.texi:28572
  42811. #, no-wrap
  42812. msgid "{@code{tlp-configuration} parameter} boolean restore-device-state-on-startup?"
  42813. msgstr ""
  42814. #. type: deftypevr
  42815. #: guix-git/doc/guix.texi:28575
  42816. msgid "Restore radio device state (bluetooth, wifi, wwan) from previous shutdown on system startup."
  42817. msgstr ""
  42818. #. type: cindex
  42819. #: guix-git/doc/guix.texi:28580
  42820. #, no-wrap
  42821. msgid "thermald"
  42822. msgstr ""
  42823. #. type: cindex
  42824. #: guix-git/doc/guix.texi:28581
  42825. #, no-wrap
  42826. msgid "CPU frequency scaling with thermald"
  42827. msgstr ""
  42828. #. type: subsubheading
  42829. #: guix-git/doc/guix.texi:28582
  42830. #, no-wrap
  42831. msgid "Thermald daemon"
  42832. msgstr ""
  42833. #. type: Plain text
  42834. #: guix-git/doc/guix.texi:28586
  42835. msgid "The @code{(gnu services pm)} module provides an interface to thermald, a CPU frequency scaling service which helps prevent overheating."
  42836. msgstr ""
  42837. #. type: defvr
  42838. #: guix-git/doc/guix.texi:28587
  42839. #, no-wrap
  42840. msgid "{Scheme Variable} thermald-service-type"
  42841. msgstr ""
  42842. #. type: defvr
  42843. #: guix-git/doc/guix.texi:28592
  42844. msgid "This is the service type for @uref{https://01.org/linux-thermal-daemon/, thermald}, the Linux Thermal Daemon, which is responsible for controlling the thermal state of processors and preventing overheating."
  42845. msgstr ""
  42846. #. type: deftp
  42847. #: guix-git/doc/guix.texi:28594
  42848. #, no-wrap
  42849. msgid "{Data Type} thermald-configuration"
  42850. msgstr ""
  42851. #. type: deftp
  42852. #: guix-git/doc/guix.texi:28596
  42853. msgid "Data type representing the configuration of @code{thermald-service-type}."
  42854. msgstr ""
  42855. #. type: item
  42856. #: guix-git/doc/guix.texi:28598
  42857. #, no-wrap
  42858. msgid "@code{ignore-cpuid-check?} (default: @code{#f})"
  42859. msgstr ""
  42860. #. type: table
  42861. #: guix-git/doc/guix.texi:28600
  42862. msgid "Ignore cpuid check for supported CPU models."
  42863. msgstr ""
  42864. #. type: item
  42865. #: guix-git/doc/guix.texi:28601
  42866. #, no-wrap
  42867. msgid "@code{thermald} (default: @var{thermald})"
  42868. msgstr ""
  42869. #. type: table
  42870. #: guix-git/doc/guix.texi:28603
  42871. msgid "Package object of thermald."
  42872. msgstr ""
  42873. #. type: Plain text
  42874. #: guix-git/doc/guix.texi:28612
  42875. msgid "The @code{(gnu services audio)} module provides a service to start MPD (the Music Player Daemon)."
  42876. msgstr ""
  42877. #. type: cindex
  42878. #: guix-git/doc/guix.texi:28613
  42879. #, no-wrap
  42880. msgid "mpd"
  42881. msgstr ""
  42882. #. type: subsubheading
  42883. #: guix-git/doc/guix.texi:28614
  42884. #, no-wrap
  42885. msgid "Music Player Daemon"
  42886. msgstr ""
  42887. #. type: Plain text
  42888. #: guix-git/doc/guix.texi:28619
  42889. msgid "The Music Player Daemon (MPD) is a service that can play music while being controlled from the local machine or over the network by a variety of clients."
  42890. msgstr ""
  42891. #. type: Plain text
  42892. #: guix-git/doc/guix.texi:28622
  42893. msgid "The following example shows how one might run @code{mpd} as user @code{\"bob\"} on port @code{6666}. It uses pulseaudio for output."
  42894. msgstr ""
  42895. #. type: lisp
  42896. #: guix-git/doc/guix.texi:28628
  42897. #, no-wrap
  42898. msgid ""
  42899. "(service mpd-service-type\n"
  42900. " (mpd-configuration\n"
  42901. " (user \"bob\")\n"
  42902. " (port \"6666\")))\n"
  42903. msgstr ""
  42904. #. type: defvr
  42905. #: guix-git/doc/guix.texi:28630
  42906. #, no-wrap
  42907. msgid "{Scheme Variable} mpd-service-type"
  42908. msgstr ""
  42909. #. type: defvr
  42910. #: guix-git/doc/guix.texi:28632
  42911. msgid "The service type for @command{mpd}"
  42912. msgstr ""
  42913. #. type: deftp
  42914. #: guix-git/doc/guix.texi:28634
  42915. #, no-wrap
  42916. msgid "{Data Type} mpd-configuration"
  42917. msgstr ""
  42918. #. type: deftp
  42919. #: guix-git/doc/guix.texi:28636
  42920. msgid "Data type representing the configuration of @command{mpd}."
  42921. msgstr ""
  42922. #. type: item
  42923. #: guix-git/doc/guix.texi:28638
  42924. #, no-wrap
  42925. msgid "@code{user} (default: @code{\"mpd\"})"
  42926. msgstr ""
  42927. #. type: table
  42928. #: guix-git/doc/guix.texi:28640
  42929. msgid "The user to run mpd as."
  42930. msgstr ""
  42931. #. type: item
  42932. #: guix-git/doc/guix.texi:28641
  42933. #, no-wrap
  42934. msgid "@code{music-dir} (default: @code{\"~/Music\"})"
  42935. msgstr ""
  42936. #. type: table
  42937. #: guix-git/doc/guix.texi:28643
  42938. msgid "The directory to scan for music files."
  42939. msgstr ""
  42940. #. type: item
  42941. #: guix-git/doc/guix.texi:28644
  42942. #, no-wrap
  42943. msgid "@code{playlist-dir} (default: @code{\"~/.mpd/playlists\"})"
  42944. msgstr ""
  42945. #. type: table
  42946. #: guix-git/doc/guix.texi:28646
  42947. msgid "The directory to store playlists."
  42948. msgstr ""
  42949. #. type: item
  42950. #: guix-git/doc/guix.texi:28647
  42951. #, no-wrap
  42952. msgid "@code{db-file} (default: @code{\"~/.mpd/tag_cache\"})"
  42953. msgstr ""
  42954. #. type: table
  42955. #: guix-git/doc/guix.texi:28649
  42956. msgid "The location of the music database."
  42957. msgstr ""
  42958. #. type: item
  42959. #: guix-git/doc/guix.texi:28650
  42960. #, no-wrap
  42961. msgid "@code{state-file} (default: @code{\"~/.mpd/state\"})"
  42962. msgstr ""
  42963. #. type: table
  42964. #: guix-git/doc/guix.texi:28652
  42965. msgid "The location of the file that stores current MPD's state."
  42966. msgstr ""
  42967. #. type: item
  42968. #: guix-git/doc/guix.texi:28653
  42969. #, no-wrap
  42970. msgid "@code{sticker-file} (default: @code{\"~/.mpd/sticker.sql\"})"
  42971. msgstr ""
  42972. #. type: table
  42973. #: guix-git/doc/guix.texi:28655
  42974. msgid "The location of the sticker database."
  42975. msgstr ""
  42976. #. type: item
  42977. #: guix-git/doc/guix.texi:28656
  42978. #, no-wrap
  42979. msgid "@code{port} (default: @code{\"6600\"})"
  42980. msgstr ""
  42981. #. type: table
  42982. #: guix-git/doc/guix.texi:28658
  42983. msgid "The port to run mpd on."
  42984. msgstr ""
  42985. #. type: item
  42986. #: guix-git/doc/guix.texi:28659
  42987. #, no-wrap
  42988. msgid "@code{address} (default: @code{\"any\"})"
  42989. msgstr ""
  42990. #. type: table
  42991. #: guix-git/doc/guix.texi:28662
  42992. msgid "The address that mpd will bind to. To use a Unix domain socket, an absolute path can be specified here."
  42993. msgstr ""
  42994. #. type: item
  42995. #: guix-git/doc/guix.texi:28663
  42996. #, no-wrap
  42997. msgid "@code{outputs} (default: @code{\"(list (mpd-output))\"})"
  42998. msgstr ""
  42999. #. type: table
  43000. #: guix-git/doc/guix.texi:28665
  43001. msgid "The audio outputs that MPD can use. By default this is a single output using pulseaudio."
  43002. msgstr ""
  43003. #. type: deftp
  43004. #: guix-git/doc/guix.texi:28669
  43005. #, no-wrap
  43006. msgid "{Data Type} mpd-output"
  43007. msgstr ""
  43008. #. type: deftp
  43009. #: guix-git/doc/guix.texi:28671
  43010. msgid "Data type representing an @command{mpd} audio output."
  43011. msgstr ""
  43012. #. type: item
  43013. #: guix-git/doc/guix.texi:28673
  43014. #, no-wrap
  43015. msgid "@code{name} (default: @code{\"MPD\"})"
  43016. msgstr ""
  43017. #. type: table
  43018. #: guix-git/doc/guix.texi:28675
  43019. msgid "The name of the audio output."
  43020. msgstr ""
  43021. #. type: item
  43022. #: guix-git/doc/guix.texi:28676
  43023. #, no-wrap
  43024. msgid "@code{type} (default: @code{\"pulse\"})"
  43025. msgstr ""
  43026. #. type: table
  43027. #: guix-git/doc/guix.texi:28678
  43028. msgid "The type of audio output."
  43029. msgstr ""
  43030. #. type: item
  43031. #: guix-git/doc/guix.texi:28679
  43032. #, no-wrap
  43033. msgid "@code{enabled?} (default: @code{#t})"
  43034. msgstr ""
  43035. #. type: table
  43036. #: guix-git/doc/guix.texi:28684
  43037. msgid "Specifies whether this audio output is enabled when MPD is started. By default, all audio outputs are enabled. This is just the default setting when there is no state file; with a state file, the previous state is restored."
  43038. msgstr ""
  43039. #. type: item
  43040. #: guix-git/doc/guix.texi:28685
  43041. #, no-wrap
  43042. msgid "@code{tags?} (default: @code{#t})"
  43043. msgstr ""
  43044. #. type: table
  43045. #: guix-git/doc/guix.texi:28689
  43046. msgid "If set to @code{#f}, then MPD will not send tags to this output. This is only useful for output plugins that can receive tags, for example the @code{httpd} output plugin."
  43047. msgstr ""
  43048. #. type: item
  43049. #: guix-git/doc/guix.texi:28690
  43050. #, no-wrap
  43051. msgid "@code{always-on?} (default: @code{#f})"
  43052. msgstr ""
  43053. #. type: table
  43054. #: guix-git/doc/guix.texi:28694
  43055. msgid "If set to @code{#t}, then MPD attempts to keep this audio output always open. This may be useful for streaming servers, when you don’t want to disconnect all listeners even when playback is accidentally stopped."
  43056. msgstr ""
  43057. #. type: code{#1}
  43058. #: guix-git/doc/guix.texi:28695
  43059. #, no-wrap
  43060. msgid "mixer-type"
  43061. msgstr ""
  43062. #. type: table
  43063. #: guix-git/doc/guix.texi:28701
  43064. msgid "This field accepts a symbol that specifies which mixer should be used for this audio output: the @code{hardware} mixer, the @code{software} mixer, the @code{null} mixer (allows setting the volume, but with no effect; this can be used as a trick to implement an external mixer External Mixer) or no mixer (@code{none})."
  43065. msgstr ""
  43066. #. type: table
  43067. #: guix-git/doc/guix.texi:28705
  43068. msgid "An association list of option symbols to string values to be appended to the audio output configuration."
  43069. msgstr ""
  43070. #. type: Plain text
  43071. #: guix-git/doc/guix.texi:28711
  43072. msgid "The following example shows a configuration of @code{mpd} that provides an HTTP audio streaming output."
  43073. msgstr ""
  43074. #. type: lisp
  43075. #: guix-git/doc/guix.texi:28723
  43076. #, no-wrap
  43077. msgid ""
  43078. "(service mpd-service-type\n"
  43079. " (mpd-configuration\n"
  43080. " (outputs\n"
  43081. " (list (mpd-output\n"
  43082. " (name \"streaming\")\n"
  43083. " (type \"httpd\")\n"
  43084. " (mixer-type 'null)\n"
  43085. " (extra-options\n"
  43086. " `((encoder . \"vorbis\")\n"
  43087. " (port . \"8080\"))))))))\n"
  43088. msgstr ""
  43089. #. type: Plain text
  43090. #: guix-git/doc/guix.texi:28732
  43091. msgid "The @code{(gnu services virtualization)} module provides services for the libvirt and virtlog daemons, as well as other virtualization-related services."
  43092. msgstr ""
  43093. #. type: subsubheading
  43094. #: guix-git/doc/guix.texi:28733
  43095. #, no-wrap
  43096. msgid "Libvirt daemon"
  43097. msgstr ""
  43098. #. type: Plain text
  43099. #: guix-git/doc/guix.texi:28738
  43100. msgid "@code{libvirtd} is the server side daemon component of the libvirt virtualization management system. This daemon runs on host servers and performs required management tasks for virtualized guests."
  43101. msgstr ""
  43102. #. type: deffn
  43103. #: guix-git/doc/guix.texi:28739
  43104. #, no-wrap
  43105. msgid "{Scheme Variable} libvirt-service-type"
  43106. msgstr ""
  43107. #. type: deffn
  43108. #: guix-git/doc/guix.texi:28742
  43109. msgid "This is the type of the @uref{https://libvirt.org, libvirt daemon}. Its value must be a @code{libvirt-configuration}."
  43110. msgstr ""
  43111. #. type: lisp
  43112. #: guix-git/doc/guix.texi:28748
  43113. #, no-wrap
  43114. msgid ""
  43115. "(service libvirt-service-type\n"
  43116. " (libvirt-configuration\n"
  43117. " (unix-sock-group \"libvirt\")\n"
  43118. " (tls-port \"16555\")))\n"
  43119. msgstr ""
  43120. #. type: Plain text
  43121. #: guix-git/doc/guix.texi:28753
  43122. msgid "Available @code{libvirt-configuration} fields are:"
  43123. msgstr ""
  43124. #. type: deftypevr
  43125. #: guix-git/doc/guix.texi:28754
  43126. #, no-wrap
  43127. msgid "{@code{libvirt-configuration} parameter} package libvirt"
  43128. msgstr ""
  43129. #. type: deftypevr
  43130. #: guix-git/doc/guix.texi:28756
  43131. msgid "Libvirt package."
  43132. msgstr ""
  43133. #. type: deftypevr
  43134. #: guix-git/doc/guix.texi:28759
  43135. #, no-wrap
  43136. msgid "{@code{libvirt-configuration} parameter} boolean listen-tls?"
  43137. msgstr ""
  43138. #. type: deftypevr
  43139. #: guix-git/doc/guix.texi:28762
  43140. msgid "Flag listening for secure TLS connections on the public TCP/IP port. You must set @code{listen} for this to have any effect."
  43141. msgstr ""
  43142. #. type: deftypevr
  43143. #: guix-git/doc/guix.texi:28765
  43144. msgid "It is necessary to setup a CA and issue server certificates before using this capability."
  43145. msgstr ""
  43146. #. type: deftypevr
  43147. #: guix-git/doc/guix.texi:28770
  43148. #, no-wrap
  43149. msgid "{@code{libvirt-configuration} parameter} boolean listen-tcp?"
  43150. msgstr ""
  43151. #. type: deftypevr
  43152. #: guix-git/doc/guix.texi:28773
  43153. msgid "Listen for unencrypted TCP connections on the public TCP/IP port. You must set @code{listen} for this to have any effect."
  43154. msgstr ""
  43155. #. type: deftypevr
  43156. #: guix-git/doc/guix.texi:28777
  43157. msgid "Using the TCP socket requires SASL authentication by default. Only SASL mechanisms which support data encryption are allowed. This is DIGEST_MD5 and GSSAPI (Kerberos5)."
  43158. msgstr ""
  43159. #. type: deftypevr
  43160. #: guix-git/doc/guix.texi:28782
  43161. #, no-wrap
  43162. msgid "{@code{libvirt-configuration} parameter} string tls-port"
  43163. msgstr ""
  43164. #. type: deftypevr
  43165. #: guix-git/doc/guix.texi:28785
  43166. msgid "Port for accepting secure TLS connections. This can be a port number, or service name."
  43167. msgstr ""
  43168. #. type: deftypevr
  43169. #: guix-git/doc/guix.texi:28787
  43170. msgid "Defaults to @samp{\"16514\"}."
  43171. msgstr ""
  43172. #. type: deftypevr
  43173. #: guix-git/doc/guix.texi:28790
  43174. #, no-wrap
  43175. msgid "{@code{libvirt-configuration} parameter} string tcp-port"
  43176. msgstr ""
  43177. #. type: deftypevr
  43178. #: guix-git/doc/guix.texi:28793
  43179. msgid "Port for accepting insecure TCP connections. This can be a port number, or service name."
  43180. msgstr ""
  43181. #. type: deftypevr
  43182. #: guix-git/doc/guix.texi:28795
  43183. msgid "Defaults to @samp{\"16509\"}."
  43184. msgstr ""
  43185. #. type: deftypevr
  43186. #: guix-git/doc/guix.texi:28798
  43187. #, no-wrap
  43188. msgid "{@code{libvirt-configuration} parameter} string listen-addr"
  43189. msgstr ""
  43190. #. type: deftypevr
  43191. #: guix-git/doc/guix.texi:28800
  43192. msgid "IP address or hostname used for client connections."
  43193. msgstr ""
  43194. #. type: deftypevr
  43195. #: guix-git/doc/guix.texi:28805
  43196. #, no-wrap
  43197. msgid "{@code{libvirt-configuration} parameter} boolean mdns-adv?"
  43198. msgstr ""
  43199. #. type: deftypevr
  43200. #: guix-git/doc/guix.texi:28807
  43201. msgid "Flag toggling mDNS advertisement of the libvirt service."
  43202. msgstr ""
  43203. #. type: deftypevr
  43204. #: guix-git/doc/guix.texi:28810
  43205. msgid "Alternatively can disable for all services on a host by stopping the Avahi daemon."
  43206. msgstr ""
  43207. #. type: deftypevr
  43208. #: guix-git/doc/guix.texi:28815
  43209. #, no-wrap
  43210. msgid "{@code{libvirt-configuration} parameter} string mdns-name"
  43211. msgstr ""
  43212. #. type: deftypevr
  43213. #: guix-git/doc/guix.texi:28818
  43214. msgid "Default mDNS advertisement name. This must be unique on the immediate broadcast network."
  43215. msgstr ""
  43216. #. type: deftypevr
  43217. #: guix-git/doc/guix.texi:28820
  43218. msgid "Defaults to @samp{\"Virtualization Host <hostname>\"}."
  43219. msgstr ""
  43220. #. type: deftypevr
  43221. #: guix-git/doc/guix.texi:28823
  43222. #, no-wrap
  43223. msgid "{@code{libvirt-configuration} parameter} string unix-sock-group"
  43224. msgstr ""
  43225. #. type: deftypevr
  43226. #: guix-git/doc/guix.texi:28827
  43227. msgid "UNIX domain socket group ownership. This can be used to allow a 'trusted' set of users access to management capabilities without becoming root."
  43228. msgstr ""
  43229. #. type: deftypevr
  43230. #: guix-git/doc/guix.texi:28832
  43231. #, no-wrap
  43232. msgid "{@code{libvirt-configuration} parameter} string unix-sock-ro-perms"
  43233. msgstr ""
  43234. #. type: deftypevr
  43235. #: guix-git/doc/guix.texi:28835
  43236. msgid "UNIX socket permissions for the R/O socket. This is used for monitoring VM status only."
  43237. msgstr ""
  43238. #. type: deftypevr
  43239. #: guix-git/doc/guix.texi:28837 guix-git/doc/guix.texi:28855
  43240. msgid "Defaults to @samp{\"0777\"}."
  43241. msgstr ""
  43242. #. type: deftypevr
  43243. #: guix-git/doc/guix.texi:28840
  43244. #, no-wrap
  43245. msgid "{@code{libvirt-configuration} parameter} string unix-sock-rw-perms"
  43246. msgstr ""
  43247. #. type: deftypevr
  43248. #: guix-git/doc/guix.texi:28844
  43249. msgid "UNIX socket permissions for the R/W socket. Default allows only root. If PolicyKit is enabled on the socket, the default will change to allow everyone (eg, 0777)"
  43250. msgstr ""
  43251. #. type: deftypevr
  43252. #: guix-git/doc/guix.texi:28846
  43253. msgid "Defaults to @samp{\"0770\"}."
  43254. msgstr ""
  43255. #. type: deftypevr
  43256. #: guix-git/doc/guix.texi:28849
  43257. #, no-wrap
  43258. msgid "{@code{libvirt-configuration} parameter} string unix-sock-admin-perms"
  43259. msgstr ""
  43260. #. type: deftypevr
  43261. #: guix-git/doc/guix.texi:28853
  43262. msgid "UNIX socket permissions for the admin socket. Default allows only owner (root), do not change it unless you are sure to whom you are exposing the access to."
  43263. msgstr ""
  43264. #. type: deftypevr
  43265. #: guix-git/doc/guix.texi:28858
  43266. #, no-wrap
  43267. msgid "{@code{libvirt-configuration} parameter} string unix-sock-dir"
  43268. msgstr ""
  43269. #. type: deftypevr
  43270. #: guix-git/doc/guix.texi:28860
  43271. msgid "The directory in which sockets will be found/created."
  43272. msgstr ""
  43273. #. type: deftypevr
  43274. #: guix-git/doc/guix.texi:28862
  43275. msgid "Defaults to @samp{\"/var/run/libvirt\"}."
  43276. msgstr ""
  43277. #. type: deftypevr
  43278. #: guix-git/doc/guix.texi:28865
  43279. #, no-wrap
  43280. msgid "{@code{libvirt-configuration} parameter} string auth-unix-ro"
  43281. msgstr ""
  43282. #. type: deftypevr
  43283. #: guix-git/doc/guix.texi:28868
  43284. msgid "Authentication scheme for UNIX read-only sockets. By default socket permissions allow anyone to connect"
  43285. msgstr ""
  43286. #. type: deftypevr
  43287. #: guix-git/doc/guix.texi:28870 guix-git/doc/guix.texi:28879
  43288. msgid "Defaults to @samp{\"polkit\"}."
  43289. msgstr ""
  43290. #. type: deftypevr
  43291. #: guix-git/doc/guix.texi:28873
  43292. #, no-wrap
  43293. msgid "{@code{libvirt-configuration} parameter} string auth-unix-rw"
  43294. msgstr ""
  43295. #. type: deftypevr
  43296. #: guix-git/doc/guix.texi:28877
  43297. msgid "Authentication scheme for UNIX read-write sockets. By default socket permissions only allow root. If PolicyKit support was compiled into libvirt, the default will be to use 'polkit' auth."
  43298. msgstr ""
  43299. #. type: deftypevr
  43300. #: guix-git/doc/guix.texi:28882
  43301. #, no-wrap
  43302. msgid "{@code{libvirt-configuration} parameter} string auth-tcp"
  43303. msgstr ""
  43304. #. type: deftypevr
  43305. #: guix-git/doc/guix.texi:28886
  43306. msgid "Authentication scheme for TCP sockets. If you don't enable SASL, then all TCP traffic is cleartext. Don't do this outside of a dev/test scenario."
  43307. msgstr ""
  43308. #. type: deftypevr
  43309. #: guix-git/doc/guix.texi:28888
  43310. msgid "Defaults to @samp{\"sasl\"}."
  43311. msgstr ""
  43312. #. type: deftypevr
  43313. #: guix-git/doc/guix.texi:28891
  43314. #, no-wrap
  43315. msgid "{@code{libvirt-configuration} parameter} string auth-tls"
  43316. msgstr ""
  43317. #. type: deftypevr
  43318. #: guix-git/doc/guix.texi:28895
  43319. msgid "Authentication scheme for TLS sockets. TLS sockets already have encryption provided by the TLS layer, and limited authentication is done by certificates."
  43320. msgstr ""
  43321. #. type: deftypevr
  43322. #: guix-git/doc/guix.texi:28898
  43323. msgid "It is possible to make use of any SASL authentication mechanism as well, by using 'sasl' for this option"
  43324. msgstr ""
  43325. #. type: deftypevr
  43326. #: guix-git/doc/guix.texi:28900
  43327. msgid "Defaults to @samp{\"none\"}."
  43328. msgstr ""
  43329. #. type: deftypevr
  43330. #: guix-git/doc/guix.texi:28903
  43331. #, no-wrap
  43332. msgid "{@code{libvirt-configuration} parameter} optional-list access-drivers"
  43333. msgstr ""
  43334. #. type: deftypevr
  43335. #: guix-git/doc/guix.texi:28905
  43336. msgid "API access control scheme."
  43337. msgstr ""
  43338. #. type: deftypevr
  43339. #: guix-git/doc/guix.texi:28908
  43340. msgid "By default an authenticated user is allowed access to all APIs. Access drivers can place restrictions on this."
  43341. msgstr ""
  43342. #. type: deftypevr
  43343. #: guix-git/doc/guix.texi:28913
  43344. #, no-wrap
  43345. msgid "{@code{libvirt-configuration} parameter} string key-file"
  43346. msgstr ""
  43347. #. type: deftypevr
  43348. #: guix-git/doc/guix.texi:28916
  43349. msgid "Server key file path. If set to an empty string, then no private key is loaded."
  43350. msgstr ""
  43351. #. type: deftypevr
  43352. #: guix-git/doc/guix.texi:28921
  43353. #, no-wrap
  43354. msgid "{@code{libvirt-configuration} parameter} string cert-file"
  43355. msgstr ""
  43356. #. type: deftypevr
  43357. #: guix-git/doc/guix.texi:28924
  43358. msgid "Server key file path. If set to an empty string, then no certificate is loaded."
  43359. msgstr ""
  43360. #. type: deftypevr
  43361. #: guix-git/doc/guix.texi:28929
  43362. #, no-wrap
  43363. msgid "{@code{libvirt-configuration} parameter} string ca-file"
  43364. msgstr ""
  43365. #. type: deftypevr
  43366. #: guix-git/doc/guix.texi:28932
  43367. msgid "Server key file path. If set to an empty string, then no CA certificate is loaded."
  43368. msgstr ""
  43369. #. type: deftypevr
  43370. #: guix-git/doc/guix.texi:28937
  43371. #, no-wrap
  43372. msgid "{@code{libvirt-configuration} parameter} string crl-file"
  43373. msgstr ""
  43374. #. type: deftypevr
  43375. #: guix-git/doc/guix.texi:28940
  43376. msgid "Certificate revocation list path. If set to an empty string, then no CRL is loaded."
  43377. msgstr ""
  43378. #. type: deftypevr
  43379. #: guix-git/doc/guix.texi:28945
  43380. #, no-wrap
  43381. msgid "{@code{libvirt-configuration} parameter} boolean tls-no-sanity-cert"
  43382. msgstr ""
  43383. #. type: deftypevr
  43384. #: guix-git/doc/guix.texi:28947
  43385. msgid "Disable verification of our own server certificates."
  43386. msgstr ""
  43387. #. type: deftypevr
  43388. #: guix-git/doc/guix.texi:28950
  43389. msgid "When libvirtd starts it performs some sanity checks against its own certificates."
  43390. msgstr ""
  43391. #. type: deftypevr
  43392. #: guix-git/doc/guix.texi:28955
  43393. #, no-wrap
  43394. msgid "{@code{libvirt-configuration} parameter} boolean tls-no-verify-cert"
  43395. msgstr ""
  43396. #. type: deftypevr
  43397. #: guix-git/doc/guix.texi:28957
  43398. msgid "Disable verification of client certificates."
  43399. msgstr ""
  43400. #. type: deftypevr
  43401. #: guix-git/doc/guix.texi:28961
  43402. msgid "Client certificate verification is the primary authentication mechanism. Any client which does not present a certificate signed by the CA will be rejected."
  43403. msgstr ""
  43404. #. type: deftypevr
  43405. #: guix-git/doc/guix.texi:28966
  43406. #, no-wrap
  43407. msgid "{@code{libvirt-configuration} parameter} optional-list tls-allowed-dn-list"
  43408. msgstr ""
  43409. #. type: deftypevr
  43410. #: guix-git/doc/guix.texi:28968
  43411. msgid "Whitelist of allowed x509 Distinguished Name."
  43412. msgstr ""
  43413. #. type: deftypevr
  43414. #: guix-git/doc/guix.texi:28973
  43415. #, no-wrap
  43416. msgid "{@code{libvirt-configuration} parameter} optional-list sasl-allowed-usernames"
  43417. msgstr ""
  43418. #. type: deftypevr
  43419. #: guix-git/doc/guix.texi:28976
  43420. msgid "Whitelist of allowed SASL usernames. The format for username depends on the SASL authentication mechanism."
  43421. msgstr ""
  43422. #. type: deftypevr
  43423. #: guix-git/doc/guix.texi:28981
  43424. #, no-wrap
  43425. msgid "{@code{libvirt-configuration} parameter} string tls-priority"
  43426. msgstr ""
  43427. #. type: deftypevr
  43428. #: guix-git/doc/guix.texi:28985
  43429. msgid "Override the compile time default TLS priority string. The default is usually @samp{\"NORMAL\"} unless overridden at build time. Only set this is it is desired for libvirt to deviate from the global default settings."
  43430. msgstr ""
  43431. #. type: deftypevr
  43432. #: guix-git/doc/guix.texi:28987
  43433. msgid "Defaults to @samp{\"NORMAL\"}."
  43434. msgstr ""
  43435. #. type: deftypevr
  43436. #: guix-git/doc/guix.texi:28990
  43437. #, no-wrap
  43438. msgid "{@code{libvirt-configuration} parameter} integer max-clients"
  43439. msgstr ""
  43440. #. type: deftypevr
  43441. #: guix-git/doc/guix.texi:28993 guix-git/doc/guix.texi:29417
  43442. msgid "Maximum number of concurrent client connections to allow over all sockets combined."
  43443. msgstr ""
  43444. #. type: deftypevr
  43445. #: guix-git/doc/guix.texi:28995
  43446. msgid "Defaults to @samp{5000}."
  43447. msgstr ""
  43448. #. type: deftypevr
  43449. #: guix-git/doc/guix.texi:28998
  43450. #, no-wrap
  43451. msgid "{@code{libvirt-configuration} parameter} integer max-queued-clients"
  43452. msgstr ""
  43453. #. type: deftypevr
  43454. #: guix-git/doc/guix.texi:29002
  43455. msgid "Maximum length of queue of connections waiting to be accepted by the daemon. Note, that some protocols supporting retransmission may obey this so that a later reattempt at connection succeeds."
  43456. msgstr ""
  43457. #. type: deftypevr
  43458. #: guix-git/doc/guix.texi:29007
  43459. #, no-wrap
  43460. msgid "{@code{libvirt-configuration} parameter} integer max-anonymous-clients"
  43461. msgstr ""
  43462. #. type: deftypevr
  43463. #: guix-git/doc/guix.texi:29010
  43464. msgid "Maximum length of queue of accepted but not yet authenticated clients. Set this to zero to turn this feature off"
  43465. msgstr ""
  43466. #. type: deftypevr
  43467. #: guix-git/doc/guix.texi:29012 guix-git/doc/guix.texi:29030
  43468. #: guix-git/doc/guix.texi:29046
  43469. msgid "Defaults to @samp{20}."
  43470. msgstr ""
  43471. #. type: deftypevr
  43472. #: guix-git/doc/guix.texi:29015
  43473. #, no-wrap
  43474. msgid "{@code{libvirt-configuration} parameter} integer min-workers"
  43475. msgstr ""
  43476. #. type: deftypevr
  43477. #: guix-git/doc/guix.texi:29017
  43478. msgid "Number of workers to start up initially."
  43479. msgstr ""
  43480. #. type: deftypevr
  43481. #: guix-git/doc/guix.texi:29022
  43482. #, no-wrap
  43483. msgid "{@code{libvirt-configuration} parameter} integer max-workers"
  43484. msgstr ""
  43485. #. type: deftypevr
  43486. #: guix-git/doc/guix.texi:29024
  43487. msgid "Maximum number of worker threads."
  43488. msgstr ""
  43489. #. type: deftypevr
  43490. #: guix-git/doc/guix.texi:29028
  43491. msgid "If the number of active clients exceeds @code{min-workers}, then more threads are spawned, up to max_workers limit. Typically you'd want max_workers to equal maximum number of clients allowed."
  43492. msgstr ""
  43493. #. type: deftypevr
  43494. #: guix-git/doc/guix.texi:29033
  43495. #, no-wrap
  43496. msgid "{@code{libvirt-configuration} parameter} integer prio-workers"
  43497. msgstr ""
  43498. #. type: deftypevr
  43499. #: guix-git/doc/guix.texi:29037
  43500. msgid "Number of priority workers. If all workers from above pool are stuck, some calls marked as high priority (notably domainDestroy) can be executed in this pool."
  43501. msgstr ""
  43502. #. type: deftypevr
  43503. #: guix-git/doc/guix.texi:29042
  43504. #, no-wrap
  43505. msgid "{@code{libvirt-configuration} parameter} integer max-requests"
  43506. msgstr ""
  43507. #. type: deftypevr
  43508. #: guix-git/doc/guix.texi:29044
  43509. msgid "Total global limit on concurrent RPC calls."
  43510. msgstr ""
  43511. #. type: deftypevr
  43512. #: guix-git/doc/guix.texi:29049
  43513. #, no-wrap
  43514. msgid "{@code{libvirt-configuration} parameter} integer max-client-requests"
  43515. msgstr ""
  43516. #. type: deftypevr
  43517. #: guix-git/doc/guix.texi:29053
  43518. msgid "Limit on concurrent requests from a single client connection. To avoid one client monopolizing the server this should be a small fraction of the global max_requests and max_workers parameter."
  43519. msgstr ""
  43520. #. type: deftypevr
  43521. #: guix-git/doc/guix.texi:29058
  43522. #, no-wrap
  43523. msgid "{@code{libvirt-configuration} parameter} integer admin-min-workers"
  43524. msgstr ""
  43525. #. type: deftypevr
  43526. #: guix-git/doc/guix.texi:29060
  43527. msgid "Same as @code{min-workers} but for the admin interface."
  43528. msgstr ""
  43529. #. type: deftypevr
  43530. #: guix-git/doc/guix.texi:29065
  43531. #, no-wrap
  43532. msgid "{@code{libvirt-configuration} parameter} integer admin-max-workers"
  43533. msgstr ""
  43534. #. type: deftypevr
  43535. #: guix-git/doc/guix.texi:29067
  43536. msgid "Same as @code{max-workers} but for the admin interface."
  43537. msgstr ""
  43538. #. type: deftypevr
  43539. #: guix-git/doc/guix.texi:29072
  43540. #, no-wrap
  43541. msgid "{@code{libvirt-configuration} parameter} integer admin-max-clients"
  43542. msgstr ""
  43543. #. type: deftypevr
  43544. #: guix-git/doc/guix.texi:29074
  43545. msgid "Same as @code{max-clients} but for the admin interface."
  43546. msgstr ""
  43547. #. type: deftypevr
  43548. #: guix-git/doc/guix.texi:29079
  43549. #, no-wrap
  43550. msgid "{@code{libvirt-configuration} parameter} integer admin-max-queued-clients"
  43551. msgstr ""
  43552. #. type: deftypevr
  43553. #: guix-git/doc/guix.texi:29081
  43554. msgid "Same as @code{max-queued-clients} but for the admin interface."
  43555. msgstr ""
  43556. #. type: deftypevr
  43557. #: guix-git/doc/guix.texi:29086
  43558. #, no-wrap
  43559. msgid "{@code{libvirt-configuration} parameter} integer admin-max-client-requests"
  43560. msgstr ""
  43561. #. type: deftypevr
  43562. #: guix-git/doc/guix.texi:29088
  43563. msgid "Same as @code{max-client-requests} but for the admin interface."
  43564. msgstr ""
  43565. #. type: deftypevr
  43566. #: guix-git/doc/guix.texi:29093
  43567. #, no-wrap
  43568. msgid "{@code{libvirt-configuration} parameter} integer log-level"
  43569. msgstr ""
  43570. #. type: deftypevr
  43571. #: guix-git/doc/guix.texi:29095 guix-git/doc/guix.texi:29319
  43572. msgid "Logging level. 4 errors, 3 warnings, 2 information, 1 debug."
  43573. msgstr ""
  43574. #. type: deftypevr
  43575. #: guix-git/doc/guix.texi:29100
  43576. #, no-wrap
  43577. msgid "{@code{libvirt-configuration} parameter} string log-filters"
  43578. msgstr ""
  43579. #. type: deftypevr
  43580. #: guix-git/doc/guix.texi:29102 guix-git/doc/guix.texi:29326
  43581. msgid "Logging filters."
  43582. msgstr ""
  43583. #. type: deftypevr
  43584. #: guix-git/doc/guix.texi:29105
  43585. msgid "A filter allows to select a different logging level for a given category of logs. The format for a filter is one of:"
  43586. msgstr ""
  43587. #. type: itemize
  43588. #: guix-git/doc/guix.texi:29109 guix-git/doc/guix.texi:29333
  43589. msgid "x:name"
  43590. msgstr ""
  43591. #. type: itemize
  43592. #: guix-git/doc/guix.texi:29112 guix-git/doc/guix.texi:29336
  43593. msgid "x:+name"
  43594. msgstr ""
  43595. #. type: deftypevr
  43596. #: guix-git/doc/guix.texi:29123
  43597. msgid "where @code{name} is a string which is matched against the category given in the @code{VIR_LOG_INIT()} at the top of each libvirt source file, e.g., @samp{\"remote\"}, @samp{\"qemu\"}, or @samp{\"util.json\"} (the name in the filter can be a substring of the full category name, in order to match multiple similar categories), the optional @samp{\"+\"} prefix tells libvirt to log stack trace for each message matching name, and @code{x} is the minimal level where matching messages should be logged:"
  43598. msgstr ""
  43599. #. type: itemize
  43600. #: guix-git/doc/guix.texi:29127 guix-git/doc/guix.texi:29172
  43601. #: guix-git/doc/guix.texi:29350 guix-git/doc/guix.texi:29395
  43602. msgid "1: DEBUG"
  43603. msgstr ""
  43604. #. type: itemize
  43605. #: guix-git/doc/guix.texi:29130 guix-git/doc/guix.texi:29175
  43606. #: guix-git/doc/guix.texi:29353 guix-git/doc/guix.texi:29398
  43607. msgid "2: INFO"
  43608. msgstr ""
  43609. #. type: itemize
  43610. #: guix-git/doc/guix.texi:29133 guix-git/doc/guix.texi:29178
  43611. #: guix-git/doc/guix.texi:29356 guix-git/doc/guix.texi:29401
  43612. msgid "3: WARNING"
  43613. msgstr ""
  43614. #. type: itemize
  43615. #: guix-git/doc/guix.texi:29136 guix-git/doc/guix.texi:29181
  43616. #: guix-git/doc/guix.texi:29359 guix-git/doc/guix.texi:29404
  43617. msgid "4: ERROR"
  43618. msgstr ""
  43619. #. type: deftypevr
  43620. #: guix-git/doc/guix.texi:29141 guix-git/doc/guix.texi:29364
  43621. msgid "Multiple filters can be defined in a single filters statement, they just need to be separated by spaces."
  43622. msgstr ""
  43623. #. type: deftypevr
  43624. #: guix-git/doc/guix.texi:29143 guix-git/doc/guix.texi:29366
  43625. msgid "Defaults to @samp{\"3:remote 4:event\"}."
  43626. msgstr ""
  43627. #. type: deftypevr
  43628. #: guix-git/doc/guix.texi:29146
  43629. #, no-wrap
  43630. msgid "{@code{libvirt-configuration} parameter} string log-outputs"
  43631. msgstr ""
  43632. #. type: deftypevr
  43633. #: guix-git/doc/guix.texi:29148 guix-git/doc/guix.texi:29371
  43634. msgid "Logging outputs."
  43635. msgstr ""
  43636. #. type: deftypevr
  43637. #: guix-git/doc/guix.texi:29151
  43638. msgid "An output is one of the places to save logging information. The format for an output can be:"
  43639. msgstr ""
  43640. #. type: item
  43641. #: guix-git/doc/guix.texi:29153 guix-git/doc/guix.texi:29376
  43642. #, no-wrap
  43643. msgid "x:stderr"
  43644. msgstr ""
  43645. #. type: table
  43646. #: guix-git/doc/guix.texi:29155 guix-git/doc/guix.texi:29378
  43647. msgid "output goes to stderr"
  43648. msgstr ""
  43649. #. type: item
  43650. #: guix-git/doc/guix.texi:29156 guix-git/doc/guix.texi:29379
  43651. #, no-wrap
  43652. msgid "x:syslog:name"
  43653. msgstr ""
  43654. #. type: table
  43655. #: guix-git/doc/guix.texi:29158 guix-git/doc/guix.texi:29381
  43656. msgid "use syslog for the output and use the given name as the ident"
  43657. msgstr ""
  43658. #. type: item
  43659. #: guix-git/doc/guix.texi:29159 guix-git/doc/guix.texi:29382
  43660. #, no-wrap
  43661. msgid "x:file:file_path"
  43662. msgstr ""
  43663. #. type: table
  43664. #: guix-git/doc/guix.texi:29161 guix-git/doc/guix.texi:29384
  43665. msgid "output to a file, with the given filepath"
  43666. msgstr ""
  43667. #. type: item
  43668. #: guix-git/doc/guix.texi:29162 guix-git/doc/guix.texi:29385
  43669. #, no-wrap
  43670. msgid "x:journald"
  43671. msgstr ""
  43672. #. type: table
  43673. #: guix-git/doc/guix.texi:29164 guix-git/doc/guix.texi:29387
  43674. msgid "output to journald logging system"
  43675. msgstr ""
  43676. #. type: deftypevr
  43677. #: guix-git/doc/guix.texi:29168 guix-git/doc/guix.texi:29391
  43678. msgid "In all case the x prefix is the minimal level, acting as a filter"
  43679. msgstr ""
  43680. #. type: deftypevr
  43681. #: guix-git/doc/guix.texi:29186 guix-git/doc/guix.texi:29409
  43682. msgid "Multiple outputs can be defined, they just need to be separated by spaces."
  43683. msgstr ""
  43684. #. type: deftypevr
  43685. #: guix-git/doc/guix.texi:29188 guix-git/doc/guix.texi:29411
  43686. msgid "Defaults to @samp{\"3:stderr\"}."
  43687. msgstr ""
  43688. #. type: deftypevr
  43689. #: guix-git/doc/guix.texi:29191
  43690. #, no-wrap
  43691. msgid "{@code{libvirt-configuration} parameter} integer audit-level"
  43692. msgstr ""
  43693. #. type: deftypevr
  43694. #: guix-git/doc/guix.texi:29193
  43695. msgid "Allows usage of the auditing subsystem to be altered"
  43696. msgstr ""
  43697. #. type: itemize
  43698. #: guix-git/doc/guix.texi:29197
  43699. msgid "0: disable all auditing"
  43700. msgstr ""
  43701. #. type: itemize
  43702. #: guix-git/doc/guix.texi:29200
  43703. msgid "1: enable auditing, only if enabled on host"
  43704. msgstr ""
  43705. #. type: itemize
  43706. #: guix-git/doc/guix.texi:29203
  43707. msgid "2: enable auditing, and exit if disabled on host."
  43708. msgstr ""
  43709. #. type: deftypevr
  43710. #: guix-git/doc/guix.texi:29210
  43711. #, no-wrap
  43712. msgid "{@code{libvirt-configuration} parameter} boolean audit-logging"
  43713. msgstr ""
  43714. #. type: deftypevr
  43715. #: guix-git/doc/guix.texi:29212
  43716. msgid "Send audit messages via libvirt logging infrastructure."
  43717. msgstr ""
  43718. #. type: deftypevr
  43719. #: guix-git/doc/guix.texi:29217
  43720. #, no-wrap
  43721. msgid "{@code{libvirt-configuration} parameter} optional-string host-uuid"
  43722. msgstr ""
  43723. #. type: deftypevr
  43724. #: guix-git/doc/guix.texi:29219
  43725. msgid "Host UUID@. UUID must not have all digits be the same."
  43726. msgstr ""
  43727. #. type: deftypevr
  43728. #: guix-git/doc/guix.texi:29224
  43729. #, no-wrap
  43730. msgid "{@code{libvirt-configuration} parameter} string host-uuid-source"
  43731. msgstr ""
  43732. #. type: deftypevr
  43733. #: guix-git/doc/guix.texi:29226
  43734. msgid "Source to read host UUID."
  43735. msgstr ""
  43736. #. type: itemize
  43737. #: guix-git/doc/guix.texi:29230
  43738. msgid "@code{smbios}: fetch the UUID from @code{dmidecode -s system-uuid}"
  43739. msgstr ""
  43740. #. type: itemize
  43741. #: guix-git/doc/guix.texi:29233
  43742. msgid "@code{machine-id}: fetch the UUID from @code{/etc/machine-id}"
  43743. msgstr ""
  43744. #. type: deftypevr
  43745. #: guix-git/doc/guix.texi:29238
  43746. msgid "If @code{dmidecode} does not provide a valid UUID a temporary UUID will be generated."
  43747. msgstr ""
  43748. #. type: deftypevr
  43749. #: guix-git/doc/guix.texi:29240
  43750. msgid "Defaults to @samp{\"smbios\"}."
  43751. msgstr ""
  43752. #. type: deftypevr
  43753. #: guix-git/doc/guix.texi:29243
  43754. #, no-wrap
  43755. msgid "{@code{libvirt-configuration} parameter} integer keepalive-interval"
  43756. msgstr ""
  43757. #. type: deftypevr
  43758. #: guix-git/doc/guix.texi:29248
  43759. msgid "A keepalive message is sent to a client after @code{keepalive_interval} seconds of inactivity to check if the client is still responding. If set to -1, libvirtd will never send keepalive requests; however clients can still send them and the daemon will send responses."
  43760. msgstr ""
  43761. #. type: deftypevr
  43762. #: guix-git/doc/guix.texi:29253
  43763. #, no-wrap
  43764. msgid "{@code{libvirt-configuration} parameter} integer keepalive-count"
  43765. msgstr ""
  43766. #. type: deftypevr
  43767. #: guix-git/doc/guix.texi:29257
  43768. msgid "Maximum number of keepalive messages that are allowed to be sent to the client without getting any response before the connection is considered broken."
  43769. msgstr ""
  43770. #. type: deftypevr
  43771. #: guix-git/doc/guix.texi:29264
  43772. msgid "In other words, the connection is automatically closed approximately after @code{keepalive_interval * (keepalive_count + 1)} seconds since the last message received from the client. When @code{keepalive-count} is set to 0, connections will be automatically closed after @code{keepalive-interval} seconds of inactivity without sending any keepalive messages."
  43773. msgstr ""
  43774. #. type: deftypevr
  43775. #: guix-git/doc/guix.texi:29269
  43776. #, no-wrap
  43777. msgid "{@code{libvirt-configuration} parameter} integer admin-keepalive-interval"
  43778. msgstr ""
  43779. #. type: deftypevr
  43780. #: guix-git/doc/guix.texi:29271 guix-git/doc/guix.texi:29278
  43781. msgid "Same as above but for admin interface."
  43782. msgstr ""
  43783. #. type: deftypevr
  43784. #: guix-git/doc/guix.texi:29276
  43785. #, no-wrap
  43786. msgid "{@code{libvirt-configuration} parameter} integer admin-keepalive-count"
  43787. msgstr ""
  43788. #. type: deftypevr
  43789. #: guix-git/doc/guix.texi:29283
  43790. #, no-wrap
  43791. msgid "{@code{libvirt-configuration} parameter} integer ovs-timeout"
  43792. msgstr ""
  43793. #. type: deftypevr
  43794. #: guix-git/doc/guix.texi:29285
  43795. msgid "Timeout for Open vSwitch calls."
  43796. msgstr ""
  43797. #. type: deftypevr
  43798. #: guix-git/doc/guix.texi:29289
  43799. msgid "The @code{ovs-vsctl} utility is used for the configuration and its timeout option is set by default to 5 seconds to avoid potential infinite waits blocking libvirt."
  43800. msgstr ""
  43801. #. type: subsubheading
  43802. #: guix-git/doc/guix.texi:29296
  43803. #, no-wrap
  43804. msgid "Virtlog daemon"
  43805. msgstr ""
  43806. #. type: Plain text
  43807. #: guix-git/doc/guix.texi:29299
  43808. msgid "The virtlogd service is a server side daemon component of libvirt that is used to manage logs from virtual machine consoles."
  43809. msgstr ""
  43810. #. type: Plain text
  43811. #: guix-git/doc/guix.texi:29305
  43812. msgid "This daemon is not used directly by libvirt client applications, rather it is called on their behalf by @code{libvirtd}. By maintaining the logs in a standalone daemon, the main @code{libvirtd} daemon can be restarted without risk of losing logs. The @code{virtlogd} daemon has the ability to re-exec() itself upon receiving @code{SIGUSR1}, to allow live upgrades without downtime."
  43813. msgstr ""
  43814. #. type: deffn
  43815. #: guix-git/doc/guix.texi:29306
  43816. #, no-wrap
  43817. msgid "{Scheme Variable} virtlog-service-type"
  43818. msgstr ""
  43819. #. type: deffn
  43820. #: guix-git/doc/guix.texi:29309
  43821. msgid "This is the type of the virtlog daemon. Its value must be a @code{virtlog-configuration}."
  43822. msgstr ""
  43823. #. type: lisp
  43824. #: guix-git/doc/guix.texi:29314
  43825. #, no-wrap
  43826. msgid ""
  43827. "(service virtlog-service-type\n"
  43828. " (virtlog-configuration\n"
  43829. " (max-clients 1000)))\n"
  43830. msgstr ""
  43831. #. type: deftypevr
  43832. #: guix-git/doc/guix.texi:29317
  43833. #, no-wrap
  43834. msgid "{@code{virtlog-configuration} parameter} integer log-level"
  43835. msgstr ""
  43836. #. type: deftypevr
  43837. #: guix-git/doc/guix.texi:29324
  43838. #, no-wrap
  43839. msgid "{@code{virtlog-configuration} parameter} string log-filters"
  43840. msgstr ""
  43841. #. type: deftypevr
  43842. #: guix-git/doc/guix.texi:29329
  43843. msgid "A filter allows to select a different logging level for a given category of logs The format for a filter is one of:"
  43844. msgstr ""
  43845. #. type: deftypevr
  43846. #: guix-git/doc/guix.texi:29346
  43847. msgid "where @code{name} is a string which is matched against the category given in the @code{VIR_LOG_INIT()} at the top of each libvirt source file, e.g., \"remote\", \"qemu\", or \"util.json\" (the name in the filter can be a substring of the full category name, in order to match multiple similar categories), the optional \"+\" prefix tells libvirt to log stack trace for each message matching name, and @code{x} is the minimal level where matching messages should be logged:"
  43848. msgstr ""
  43849. #. type: deftypevr
  43850. #: guix-git/doc/guix.texi:29369
  43851. #, no-wrap
  43852. msgid "{@code{virtlog-configuration} parameter} string log-outputs"
  43853. msgstr ""
  43854. #. type: deftypevr
  43855. #: guix-git/doc/guix.texi:29374
  43856. msgid "An output is one of the places to save logging information The format for an output can be:"
  43857. msgstr ""
  43858. #. type: deftypevr
  43859. #: guix-git/doc/guix.texi:29414
  43860. #, no-wrap
  43861. msgid "{@code{virtlog-configuration} parameter} integer max-clients"
  43862. msgstr ""
  43863. #. type: deftypevr
  43864. #: guix-git/doc/guix.texi:29419
  43865. msgid "Defaults to @samp{1024}."
  43866. msgstr ""
  43867. #. type: deftypevr
  43868. #: guix-git/doc/guix.texi:29422
  43869. #, no-wrap
  43870. msgid "{@code{virtlog-configuration} parameter} integer max-size"
  43871. msgstr ""
  43872. #. type: deftypevr
  43873. #: guix-git/doc/guix.texi:29424
  43874. msgid "Maximum file size before rolling over."
  43875. msgstr ""
  43876. #. type: deftypevr
  43877. #: guix-git/doc/guix.texi:29426
  43878. msgid "Defaults to @samp{2MB}"
  43879. msgstr ""
  43880. #. type: deftypevr
  43881. #: guix-git/doc/guix.texi:29429
  43882. #, no-wrap
  43883. msgid "{@code{virtlog-configuration} parameter} integer max-backups"
  43884. msgstr ""
  43885. #. type: deftypevr
  43886. #: guix-git/doc/guix.texi:29431
  43887. msgid "Maximum number of backup files to keep."
  43888. msgstr ""
  43889. #. type: deftypevr
  43890. #: guix-git/doc/guix.texi:29433
  43891. msgid "Defaults to @samp{3}"
  43892. msgstr ""
  43893. #. type: anchor{#1}
  43894. #: guix-git/doc/guix.texi:29437
  43895. msgid "transparent-emulation-qemu"
  43896. msgstr ""
  43897. #. type: subsubheading
  43898. #: guix-git/doc/guix.texi:29437
  43899. #, no-wrap
  43900. msgid "Transparent Emulation with QEMU"
  43901. msgstr ""
  43902. #. type: cindex
  43903. #: guix-git/doc/guix.texi:29439
  43904. #, no-wrap
  43905. msgid "emulation"
  43906. msgstr ""
  43907. #. type: code{#1}
  43908. #: guix-git/doc/guix.texi:29440
  43909. #, no-wrap
  43910. msgid "binfmt_misc"
  43911. msgstr ""
  43912. #. type: Plain text
  43913. #: guix-git/doc/guix.texi:29448
  43914. msgid "@code{qemu-binfmt-service-type} provides support for transparent emulation of program binaries built for different architectures---e.g., it allows you to transparently execute an ARMv7 program on an x86_64 machine. It achieves this by combining the @uref{https://www.qemu.org, QEMU} emulator and the @code{binfmt_misc} feature of the kernel Linux. This feature only allows you to emulate GNU/Linux on a different architecture, but see below for GNU/Hurd support."
  43915. msgstr ""
  43916. #. type: defvr
  43917. #: guix-git/doc/guix.texi:29449
  43918. #, no-wrap
  43919. msgid "{Scheme Variable} qemu-binfmt-service-type"
  43920. msgstr ""
  43921. #. type: defvr
  43922. #: guix-git/doc/guix.texi:29454
  43923. msgid "This is the type of the QEMU/binfmt service for transparent emulation. Its value must be a @code{qemu-binfmt-configuration} object, which specifies the QEMU package to use as well as the architecture we want to emulated:"
  43924. msgstr ""
  43925. #. type: lisp
  43926. #: guix-git/doc/guix.texi:29459
  43927. #, no-wrap
  43928. msgid ""
  43929. "(service qemu-binfmt-service-type\n"
  43930. " (qemu-binfmt-configuration\n"
  43931. " (platforms (lookup-qemu-platforms \"arm\" \"aarch64\"))))\n"
  43932. msgstr ""
  43933. #. type: defvr
  43934. #: guix-git/doc/guix.texi:29465
  43935. msgid "In this example, we enable transparent emulation for the ARM and aarch64 platforms. Running @code{herd stop qemu-binfmt} turns it off, and running @code{herd start qemu-binfmt} turns it back on (@pxref{Invoking herd, the @command{herd} command,, shepherd, The GNU Shepherd Manual})."
  43936. msgstr ""
  43937. #. type: deftp
  43938. #: guix-git/doc/guix.texi:29467
  43939. #, no-wrap
  43940. msgid "{Data Type} qemu-binfmt-configuration"
  43941. msgstr ""
  43942. #. type: deftp
  43943. #: guix-git/doc/guix.texi:29469
  43944. msgid "This is the configuration for the @code{qemu-binfmt} service."
  43945. msgstr ""
  43946. #. type: item
  43947. #: guix-git/doc/guix.texi:29471
  43948. #, no-wrap
  43949. msgid "@code{platforms} (default: @code{'()})"
  43950. msgstr ""
  43951. #. type: table
  43952. #: guix-git/doc/guix.texi:29474
  43953. msgid "The list of emulated QEMU platforms. Each item must be a @dfn{platform object} as returned by @code{lookup-qemu-platforms} (see below)."
  43954. msgstr ""
  43955. #. type: table
  43956. #: guix-git/doc/guix.texi:29477
  43957. msgid "For example, let's suppose you're on an x86_64 machine and you have this service:"
  43958. msgstr ""
  43959. #. type: lisp
  43960. #: guix-git/doc/guix.texi:29482
  43961. #, no-wrap
  43962. msgid ""
  43963. "(service qemu-binfmt-service-type\n"
  43964. " (qemu-binfmt-configuration\n"
  43965. " (platforms (lookup-qemu-platforms \"arm\"))))\n"
  43966. msgstr ""
  43967. #. type: table
  43968. #: guix-git/doc/guix.texi:29485
  43969. msgid "You can run:"
  43970. msgstr ""
  43971. #. type: example
  43972. #: guix-git/doc/guix.texi:29488
  43973. #, no-wrap
  43974. msgid "guix build -s armhf-linux inkscape\n"
  43975. msgstr ""
  43976. #. type: table
  43977. #: guix-git/doc/guix.texi:29495
  43978. msgid "and it will build Inkscape for ARMv7 @emph{as if it were a native build}, transparently using QEMU to emulate the ARMv7 CPU@. Pretty handy if you'd like to test a package build for an architecture you don't have access to!"
  43979. msgstr ""
  43980. #. type: item
  43981. #: guix-git/doc/guix.texi:29496
  43982. #, no-wrap
  43983. msgid "@code{qemu} (default: @code{qemu})"
  43984. msgstr ""
  43985. #. type: table
  43986. #: guix-git/doc/guix.texi:29498 guix-git/doc/guix.texi:29592
  43987. msgid "The QEMU package to use."
  43988. msgstr ""
  43989. #. type: deffn
  43990. #: guix-git/doc/guix.texi:29501
  43991. #, no-wrap
  43992. msgid "{Scheme Procedure} lookup-qemu-platforms @var{platforms}@dots{}"
  43993. msgstr ""
  43994. #. type: deffn
  43995. #: guix-git/doc/guix.texi:29506
  43996. msgid "Return the list of QEMU platform objects corresponding to @var{platforms}@dots{}. @var{platforms} must be a list of strings corresponding to platform names, such as @code{\"arm\"}, @code{\"sparc\"}, @code{\"mips64el\"}, and so on."
  43997. msgstr ""
  43998. #. type: deffn
  43999. #: guix-git/doc/guix.texi:29508
  44000. #, no-wrap
  44001. msgid "{Scheme Procedure} qemu-platform? @var{obj}"
  44002. msgstr ""
  44003. #. type: deffn
  44004. #: guix-git/doc/guix.texi:29510
  44005. msgid "Return true if @var{obj} is a platform object."
  44006. msgstr ""
  44007. #. type: deffn
  44008. #: guix-git/doc/guix.texi:29512
  44009. #, no-wrap
  44010. msgid "{Scheme Procedure} qemu-platform-name @var{platform}"
  44011. msgstr ""
  44012. #. type: deffn
  44013. #: guix-git/doc/guix.texi:29514
  44014. msgid "Return the name of @var{platform}---a string such as @code{\"arm\"}."
  44015. msgstr ""
  44016. #. type: subsubheading
  44017. #: guix-git/doc/guix.texi:29517
  44018. #, no-wrap
  44019. msgid "The Hurd in a Virtual Machine"
  44020. msgstr ""
  44021. #. type: cindex
  44022. #: guix-git/doc/guix.texi:29520
  44023. #, no-wrap
  44024. msgid "the Hurd"
  44025. msgstr ""
  44026. #. type: cindex
  44027. #: guix-git/doc/guix.texi:29521
  44028. #, no-wrap
  44029. msgid "childhurd"
  44030. msgstr ""
  44031. #. type: Plain text
  44032. #: guix-git/doc/guix.texi:29529
  44033. msgid "Service @code{hurd-vm} provides support for running GNU/Hurd in a virtual machine (VM), a so-called @dfn{childhurd}. This service is meant to be used on GNU/Linux and the given GNU/Hurd operating system configuration is cross-compiled. The virtual machine is a Shepherd service that can be referred to by the names @code{hurd-vm} and @code{childhurd} and be controlled with commands such as:"
  44034. msgstr ""
  44035. #. type: example
  44036. #: guix-git/doc/guix.texi:29533
  44037. #, no-wrap
  44038. msgid ""
  44039. "herd start hurd-vm\n"
  44040. "herd stop childhurd\n"
  44041. msgstr ""
  44042. #. type: Plain text
  44043. #: guix-git/doc/guix.texi:29537
  44044. msgid "When the service is running, you can view its console by connecting to it with a VNC client, for example with:"
  44045. msgstr ""
  44046. #. type: example
  44047. #: guix-git/doc/guix.texi:29541
  44048. #, no-wrap
  44049. msgid ""
  44050. "guix environment --ad-hoc tigervnc-client -- \\\n"
  44051. " vncviewer localhost:5900\n"
  44052. msgstr ""
  44053. #. type: Plain text
  44054. #: guix-git/doc/guix.texi:29547
  44055. msgid "The default configuration (see @code{hurd-vm-configuration} below) spawns a secure shell (SSH) server in your GNU/Hurd system, which QEMU (the virtual machine emulator) redirects to port 10222 on the host. Thus, you can connect over SSH to the childhurd with:"
  44056. msgstr ""
  44057. #. type: example
  44058. #: guix-git/doc/guix.texi:29550
  44059. #, no-wrap
  44060. msgid "ssh root@@localhost -p 10022\n"
  44061. msgstr ""
  44062. #. type: Plain text
  44063. #: guix-git/doc/guix.texi:29559
  44064. msgid "The childhurd is volatile and stateless: it starts with a fresh root file system every time you restart it. By default though, all the files under @file{/etc/childhurd} on the host are copied as is to the root file system of the childhurd when it boots. This allows you to initialize ``secrets'' inside the VM: SSH host keys, authorized substitute keys, and so on---see the explanation of @code{secret-root} below."
  44065. msgstr ""
  44066. #. type: defvr
  44067. #: guix-git/doc/guix.texi:29560
  44068. #, no-wrap
  44069. msgid "{Scheme Variable} hurd-vm-service-type"
  44070. msgstr ""
  44071. #. type: defvr
  44072. #: guix-git/doc/guix.texi:29566
  44073. msgid "This is the type of the Hurd in a Virtual Machine service. Its value must be a @code{hurd-vm-configuration} object, which specifies the operating system (@pxref{operating-system Reference}) and the disk size for the Hurd Virtual Machine, the QEMU package to use as well as the options for running it."
  44074. msgstr ""
  44075. #. type: lisp
  44076. #: guix-git/doc/guix.texi:29574
  44077. #, no-wrap
  44078. msgid ""
  44079. "(service hurd-vm-service-type\n"
  44080. " (hurd-vm-configuration\n"
  44081. " (disk-size (* 5000 (expt 2 20))) ;5G\n"
  44082. " (memory-size 1024))) ;1024MiB\n"
  44083. msgstr ""
  44084. #. type: defvr
  44085. #: guix-git/doc/guix.texi:29578
  44086. msgid "would create a disk image big enough to build GNU@tie{}Hello, with some extra memory."
  44087. msgstr ""
  44088. #. type: deftp
  44089. #: guix-git/doc/guix.texi:29580
  44090. #, no-wrap
  44091. msgid "{Data Type} hurd-vm-configuration"
  44092. msgstr ""
  44093. #. type: deftp
  44094. #: guix-git/doc/guix.texi:29583
  44095. msgid "The data type representing the configuration for @code{hurd-vm-service-type}."
  44096. msgstr ""
  44097. #. type: item
  44098. #: guix-git/doc/guix.texi:29585
  44099. #, no-wrap
  44100. msgid "@code{os} (default: @var{%hurd-vm-operating-system})"
  44101. msgstr ""
  44102. #. type: table
  44103. #: guix-git/doc/guix.texi:29589
  44104. msgid "The operating system to instantiate. This default is bare-bones with a permissive OpenSSH secure shell daemon listening on port 2222 (@pxref{Networking Services, @code{openssh-service-type}})."
  44105. msgstr ""
  44106. #. type: item
  44107. #: guix-git/doc/guix.texi:29590
  44108. #, no-wrap
  44109. msgid "@code{qemu} (default: @code{qemu-minimal})"
  44110. msgstr ""
  44111. #. type: item
  44112. #: guix-git/doc/guix.texi:29593
  44113. #, no-wrap
  44114. msgid "@code{image} (default: @var{hurd-vm-disk-image})"
  44115. msgstr ""
  44116. #. type: table
  44117. #: guix-git/doc/guix.texi:29596
  44118. msgid "The procedure used to build the disk-image built from this configuration."
  44119. msgstr ""
  44120. #. type: item
  44121. #: guix-git/doc/guix.texi:29597
  44122. #, no-wrap
  44123. msgid "@code{disk-size} (default: @code{'guess})"
  44124. msgstr ""
  44125. #. type: table
  44126. #: guix-git/doc/guix.texi:29599
  44127. msgid "The size of the disk image."
  44128. msgstr ""
  44129. #. type: item
  44130. #: guix-git/doc/guix.texi:29600
  44131. #, no-wrap
  44132. msgid "@code{memory-size} (default: @code{512})"
  44133. msgstr ""
  44134. #. type: table
  44135. #: guix-git/doc/guix.texi:29602
  44136. msgid "The memory size of the Virtual Machine in mebibytes."
  44137. msgstr ""
  44138. #. type: item
  44139. #: guix-git/doc/guix.texi:29603
  44140. #, no-wrap
  44141. msgid "@code{options} (default: @code{'(\"--snapshot\")})"
  44142. msgstr ""
  44143. #. type: table
  44144. #: guix-git/doc/guix.texi:29605
  44145. msgid "The extra options for running QEMU."
  44146. msgstr ""
  44147. #. type: table
  44148. #: guix-git/doc/guix.texi:29610
  44149. msgid "If set, a non-zero positive integer used to parameterize Childhurd instances. It is appended to the service's name, e.g. @code{childhurd1}."
  44150. msgstr ""
  44151. #. type: item
  44152. #: guix-git/doc/guix.texi:29611
  44153. #, no-wrap
  44154. msgid "@code{net-options} (default: @var{hurd-vm-net-options})"
  44155. msgstr ""
  44156. #. type: table
  44157. #: guix-git/doc/guix.texi:29613
  44158. msgid "The procedure used to produce the list of QEMU networking options."
  44159. msgstr ""
  44160. #. type: table
  44161. #: guix-git/doc/guix.texi:29615
  44162. msgid "By default, it produces"
  44163. msgstr ""
  44164. #. type: lisp
  44165. #: guix-git/doc/guix.texi:29623
  44166. #, no-wrap
  44167. msgid ""
  44168. "'(\"--device\" \"rtl8139,netdev=net0\"\n"
  44169. " \"--netdev\" (string-append\n"
  44170. " \"user,id=net0,\"\n"
  44171. " \"hostfwd=tcp:127.0.0.1:@var{secrets-port}-:1004,\"\n"
  44172. " \"hostfwd=tcp:127.0.0.1:@var{ssh-port}-:2222,\"\n"
  44173. " \"hostfwd=tcp:127.0.0.1:@var{vnc-port}-:5900\"))\n"
  44174. msgstr ""
  44175. #. type: table
  44176. #: guix-git/doc/guix.texi:29626
  44177. msgid "with forwarded ports:"
  44178. msgstr ""
  44179. #. type: example
  44180. #: guix-git/doc/guix.texi:29631
  44181. #, no-wrap
  44182. msgid ""
  44183. "@var{secrets-port}: @code{(+ 11004 (* 1000 @var{ID}))}\n"
  44184. "@var{ssh-port}: @code{(+ 10022 (* 1000 @var{ID}))}\n"
  44185. "@var{vnc-port}: @code{(+ 15900 (* 1000 @var{ID}))}\n"
  44186. msgstr ""
  44187. #. type: item
  44188. #: guix-git/doc/guix.texi:29633
  44189. #, no-wrap
  44190. msgid "@code{secret-root} (default: @file{/etc/childhurd})"
  44191. msgstr ""
  44192. #. type: table
  44193. #: guix-git/doc/guix.texi:29638
  44194. msgid "The root directory with out-of-band secrets to be installed into the childhurd once it runs. Childhurds are volatile which means that on every startup, secrets such as the SSH host keys and Guix signing key are recreated."
  44195. msgstr ""
  44196. #. type: table
  44197. #: guix-git/doc/guix.texi:29642
  44198. msgid "If the @file{/etc/childhurd} directory does not exist, the @code{secret-service} running in the Childhurd will be sent an empty list of secrets."
  44199. msgstr ""
  44200. #. type: table
  44201. #: guix-git/doc/guix.texi:29645
  44202. msgid "By default, the service automatically populates @file{/etc/childhurd} with the following non-volatile secrets, unless they already exist:"
  44203. msgstr ""
  44204. #. type: example
  44205. #: guix-git/doc/guix.texi:29654
  44206. #, no-wrap
  44207. msgid ""
  44208. "/etc/childhurd/etc/guix/acl\n"
  44209. "/etc/childhurd/etc/guix/signing-key.pub\n"
  44210. "/etc/childhurd/etc/guix/signing-key.sec\n"
  44211. "/etc/childhurd/etc/ssh/ssh_host_ed25519_key\n"
  44212. "/etc/childhurd/etc/ssh/ssh_host_ecdsa_key\n"
  44213. "/etc/childhurd/etc/ssh/ssh_host_ed25519_key.pub\n"
  44214. "/etc/childhurd/etc/ssh/ssh_host_ecdsa_key.pub\n"
  44215. msgstr ""
  44216. #. type: table
  44217. #: guix-git/doc/guix.texi:29658
  44218. msgid "These files are automatically sent to the guest Hurd VM when it boots, including permissions."
  44219. msgstr ""
  44220. #. type: cindex
  44221. #: guix-git/doc/guix.texi:29659
  44222. #, no-wrap
  44223. msgid "childhurd, offloading"
  44224. msgstr ""
  44225. #. type: cindex
  44226. #: guix-git/doc/guix.texi:29660
  44227. #, no-wrap
  44228. msgid "Hurd, offloading"
  44229. msgstr ""
  44230. #. type: table
  44231. #: guix-git/doc/guix.texi:29664
  44232. msgid "Having these files in place means that only a couple of things are missing to allow the host to offload @code{i586-gnu} builds to the childhurd:"
  44233. msgstr ""
  44234. #. type: enumerate
  44235. #: guix-git/doc/guix.texi:29669
  44236. msgid "Authorizing the childhurd's key on the host so that the host accepts build results coming from the childhurd, which can be done like so:"
  44237. msgstr ""
  44238. #. type: example
  44239. #: guix-git/doc/guix.texi:29673
  44240. #, no-wrap
  44241. msgid ""
  44242. "guix archive --authorize < \\\n"
  44243. " /etc/childhurd/etc/guix/signing-key.pub\n"
  44244. msgstr ""
  44245. #. type: enumerate
  44246. #: guix-git/doc/guix.texi:29678
  44247. msgid "Adding the childhurd to @file{/etc/guix/machines.scm} (@pxref{Daemon Offload Setup})."
  44248. msgstr ""
  44249. #. type: table
  44250. #: guix-git/doc/guix.texi:29682
  44251. msgid "We're working towards making that happen automatically---get in touch with us at @email{guix-devel@@gnu.org} to discuss it!"
  44252. msgstr ""
  44253. #. type: Plain text
  44254. #: guix-git/doc/guix.texi:29689
  44255. msgid "Note that by default the VM image is volatile, i.e., once stopped the contents are lost. If you want a stateful image instead, override the configuration's @code{image} and @code{options} without the @code{--snapshot} flag using something along these lines:"
  44256. msgstr ""
  44257. #. type: lisp
  44258. #: guix-git/doc/guix.texi:29695
  44259. #, no-wrap
  44260. msgid ""
  44261. "(service hurd-vm-service-type\n"
  44262. " (hurd-vm-configuration\n"
  44263. " (image (const \"/out/of/store/writable/hurd.img\"))\n"
  44264. " (options '())))\n"
  44265. msgstr ""
  44266. #. type: subsubheading
  44267. #: guix-git/doc/guix.texi:29697
  44268. #, no-wrap
  44269. msgid "Ganeti"
  44270. msgstr ""
  44271. #. type: cindex
  44272. #: guix-git/doc/guix.texi:29699
  44273. #, no-wrap
  44274. msgid "ganeti"
  44275. msgstr ""
  44276. #. type: quotation
  44277. #: guix-git/doc/guix.texi:29706
  44278. msgid "This service is considered experimental. Configuration options may be changed in a backwards-incompatible manner, and not all features have been thorougly tested. Users of this service are encouraged to share their experience at @email{guix-devel@@gnu.org}."
  44279. msgstr ""
  44280. #. type: Plain text
  44281. #: guix-git/doc/guix.texi:29716
  44282. msgid "Ganeti is a virtual machine management system. It is designed to keep virtual machines running on a cluster of servers even in the event of hardware failures, and to make maintenance and recovery tasks easy. It consists of multiple services which are described later in this section. In addition to the Ganeti service, you will need the OpenSSH service (@pxref{Networking Services, @code{openssh-service-type}}), and update the @file{/etc/hosts} file (@pxref{operating-system Reference, @code{hosts-file}}) with the cluster name and address (or use a DNS server)."
  44283. msgstr ""
  44284. #. type: Plain text
  44285. #: guix-git/doc/guix.texi:29721
  44286. msgid "All nodes participating in a Ganeti cluster should have the same Ganeti and @file{/etc/hosts} configuration. Here is an example configuration for a Ganeti cluster node that supports multiple storage backends, and installs the @code{debootstrap} and @code{guix} @dfn{OS providers}:"
  44287. msgstr ""
  44288. #. type: lisp
  44289. #: guix-git/doc/guix.texi:29731
  44290. #, no-wrap
  44291. msgid ""
  44292. "(use-package-modules virtualization)\n"
  44293. "(use-service-modules base ganeti networking ssh)\n"
  44294. "(operating-system\n"
  44295. " ;; @dots{}\n"
  44296. " (host-name \"node1\")\n"
  44297. " (hosts-file (plain-file \"hosts\" (format #f \"\n"
  44298. "127.0.0.1 localhost\n"
  44299. "::1 localhost\n"
  44300. "\n"
  44301. msgstr ""
  44302. #. type: lisp
  44303. #: guix-git/doc/guix.texi:29736
  44304. #, no-wrap
  44305. msgid ""
  44306. "192.168.1.200 ganeti.example.com\n"
  44307. "192.168.1.201 node1.example.com node1\n"
  44308. "192.168.1.202 node2.example.com node2\n"
  44309. "\")))\n"
  44310. "\n"
  44311. msgstr ""
  44312. #. type: lisp
  44313. #: guix-git/doc/guix.texi:29750
  44314. #, no-wrap
  44315. msgid ""
  44316. " ;; Install QEMU so we can use KVM-based instances, and LVM, DRBD and Ceph\n"
  44317. " ;; in order to use the \"plain\", \"drbd\" and \"rbd\" storage backends.\n"
  44318. " (packages (append (map specification->package\n"
  44319. " '(\"qemu\" \"lvm2\" \"drbd-utils\" \"ceph\"\n"
  44320. " ;; Add the debootstrap and guix OS providers.\n"
  44321. " \"ganeti-instance-guix\" \"ganeti-instance-debootstrap\"))\n"
  44322. " %base-packages))\n"
  44323. " (services\n"
  44324. " (append (list (static-networking-service \"eth0\" \"192.168.1.201\"\n"
  44325. " #:netmask \"255.255.255.0\"\n"
  44326. " #:gateway \"192.168.1.254\"\n"
  44327. " #:name-servers '(\"192.168.1.252\"\n"
  44328. " \"192.168.1.253\"))\n"
  44329. "\n"
  44330. msgstr ""
  44331. #. type: lisp
  44332. #: guix-git/doc/guix.texi:29755
  44333. #, no-wrap
  44334. msgid ""
  44335. " ;; Ganeti uses SSH to communicate between nodes.\n"
  44336. " (service openssh-service-type\n"
  44337. " (openssh-configuration\n"
  44338. " (permit-root-login 'prohibit-password)))\n"
  44339. "\n"
  44340. msgstr ""
  44341. #. type: lisp
  44342. #: guix-git/doc/guix.texi:29765
  44343. #, no-wrap
  44344. msgid ""
  44345. " (service ganeti-service-type\n"
  44346. " (ganeti-configuration\n"
  44347. " ;; This list specifies allowed file system paths\n"
  44348. " ;; for storing virtual machine images.\n"
  44349. " (file-storage-paths '(\"/srv/ganeti/file-storage\"))\n"
  44350. " ;; This variable configures a single \"variant\" for\n"
  44351. " ;; both Debootstrap and Guix that works with KVM.\n"
  44352. " (os %default-ganeti-os))))\n"
  44353. " %base-services)))\n"
  44354. msgstr ""
  44355. #. type: Plain text
  44356. #: guix-git/doc/guix.texi:29773
  44357. msgid "Users are advised to read the @url{http://docs.ganeti.org/ganeti/master/html/admin.html,Ganeti administrators guide} to learn about the various cluster options and day-to-day operations. There is also a @url{https://guix.gnu.org/blog/2020/running-a-ganeti-cluster-on-guix/,blog post} describing how to configure and initialize a small cluster."
  44358. msgstr ""
  44359. #. type: defvr
  44360. #: guix-git/doc/guix.texi:29774
  44361. #, no-wrap
  44362. msgid "{Scheme Variable} ganeti-service-type"
  44363. msgstr ""
  44364. #. type: defvr
  44365. #: guix-git/doc/guix.texi:29777
  44366. msgid "This is a service type that includes all the various services that Ganeti nodes should run."
  44367. msgstr ""
  44368. #. type: defvr
  44369. #: guix-git/doc/guix.texi:29782
  44370. msgid "Its value is a @code{ganeti-configuration} object that defines the package to use for CLI operations, as well as configuration for the various daemons. Allowed file storage paths and available guest operating systems are also configured through this data type."
  44371. msgstr ""
  44372. #. type: deftp
  44373. #: guix-git/doc/guix.texi:29784
  44374. #, no-wrap
  44375. msgid "{Data Type} ganeti-configuration"
  44376. msgstr ""
  44377. #. type: deftp
  44378. #: guix-git/doc/guix.texi:29786
  44379. msgid "The @code{ganeti} service takes the following configuration options:"
  44380. msgstr ""
  44381. #. type: item
  44382. #: guix-git/doc/guix.texi:29788 guix-git/doc/guix.texi:30016
  44383. #: guix-git/doc/guix.texi:30066 guix-git/doc/guix.texi:30096
  44384. #: guix-git/doc/guix.texi:30123 guix-git/doc/guix.texi:30155
  44385. #: guix-git/doc/guix.texi:30208 guix-git/doc/guix.texi:30228
  44386. #: guix-git/doc/guix.texi:30254 guix-git/doc/guix.texi:30287
  44387. #: guix-git/doc/guix.texi:30327
  44388. #, no-wrap
  44389. msgid "@code{ganeti} (default: @code{ganeti})"
  44390. msgstr ""
  44391. #. type: table
  44392. #: guix-git/doc/guix.texi:29793
  44393. msgid "The @code{ganeti} package to use. It will be installed to the system profile and make @command{gnt-cluster}, @command{gnt-instance}, etc available. Note that the value specified here does not affect the other services as each refer to a specific @code{ganeti} package (see below)."
  44394. msgstr ""
  44395. #. type: item
  44396. #: guix-git/doc/guix.texi:29794
  44397. #, no-wrap
  44398. msgid "@code{noded-configuration} (default: @code{(ganeti-noded-configuration)})"
  44399. msgstr ""
  44400. #. type: itemx
  44401. #: guix-git/doc/guix.texi:29795
  44402. #, no-wrap
  44403. msgid "@code{confd-configuration} (default: @code{(ganeti-confd-configuration)})"
  44404. msgstr ""
  44405. #. type: itemx
  44406. #: guix-git/doc/guix.texi:29796
  44407. #, no-wrap
  44408. msgid "@code{wconfd-configuration} (default: @code{(ganeti-wconfd-configuration)})"
  44409. msgstr ""
  44410. #. type: itemx
  44411. #: guix-git/doc/guix.texi:29797
  44412. #, no-wrap
  44413. msgid "@code{luxid-configuration} (default: @code{(ganeti-luxid-configuration)})"
  44414. msgstr ""
  44415. #. type: itemx
  44416. #: guix-git/doc/guix.texi:29798
  44417. #, no-wrap
  44418. msgid "@code{rapi-configuration} (default: @code{(ganeti-rapi-configuration)})"
  44419. msgstr ""
  44420. #. type: itemx
  44421. #: guix-git/doc/guix.texi:29799
  44422. #, no-wrap
  44423. msgid "@code{kvmd-configuration} (default: @code{(ganeti-kvmd-configuration)})"
  44424. msgstr ""
  44425. #. type: itemx
  44426. #: guix-git/doc/guix.texi:29800
  44427. #, no-wrap
  44428. msgid "@code{mond-configuration} (default: @code{(ganeti-mond-configuration)})"
  44429. msgstr ""
  44430. #. type: itemx
  44431. #: guix-git/doc/guix.texi:29801
  44432. #, no-wrap
  44433. msgid "@code{metad-configuration} (default: @code{(ganeti-metad-configuration)})"
  44434. msgstr ""
  44435. #. type: itemx
  44436. #: guix-git/doc/guix.texi:29802
  44437. #, no-wrap
  44438. msgid "@code{watcher-configuration} (default: @code{(ganeti-watcher-configuration)})"
  44439. msgstr ""
  44440. #. type: itemx
  44441. #: guix-git/doc/guix.texi:29803
  44442. #, no-wrap
  44443. msgid "@code{cleaner-configuration} (default: @code{(ganeti-cleaner-configuration)})"
  44444. msgstr ""
  44445. #. type: table
  44446. #: guix-git/doc/guix.texi:29808
  44447. msgid "These options control the various daemons and cron jobs that are distributed with Ganeti. The possible values for these are described in detail below. To override a setting, you must use the configuration type for that service:"
  44448. msgstr ""
  44449. #. type: lisp
  44450. #: guix-git/doc/guix.texi:29818
  44451. #, no-wrap
  44452. msgid ""
  44453. "(service ganeti-service-type\n"
  44454. " (ganeti-configuration\n"
  44455. " (rapi-configuration\n"
  44456. " (ganeti-rapi-configuration\n"
  44457. " (interface \"eth1\"))))\n"
  44458. " (watcher-configuration\n"
  44459. " (ganeti-watcher-configuration\n"
  44460. " (rapi-ip \"10.0.0.1\"))))\n"
  44461. msgstr ""
  44462. #. type: item
  44463. #: guix-git/doc/guix.texi:29820
  44464. #, no-wrap
  44465. msgid "@code{file-storage-paths} (default: @code{'()})"
  44466. msgstr ""
  44467. #. type: table
  44468. #: guix-git/doc/guix.texi:29822
  44469. msgid "List of allowed directories for file storage backend."
  44470. msgstr ""
  44471. #. type: item
  44472. #: guix-git/doc/guix.texi:29823
  44473. #, no-wrap
  44474. msgid "@code{os} (default: @code{%default-ganeti-os})"
  44475. msgstr ""
  44476. #. type: table
  44477. #: guix-git/doc/guix.texi:29825
  44478. msgid "List of @code{<ganeti-os>} records."
  44479. msgstr ""
  44480. #. type: deftp
  44481. #: guix-git/doc/guix.texi:29829
  44482. msgid "In essence @code{ganeti-service-type} is shorthand for declaring each service individually:"
  44483. msgstr ""
  44484. #. type: lisp
  44485. #: guix-git/doc/guix.texi:29840
  44486. #, no-wrap
  44487. msgid ""
  44488. "(service ganeti-noded-service-type)\n"
  44489. "(service ganeti-confd-service-type)\n"
  44490. "(service ganeti-wconfd-service-type)\n"
  44491. "(service ganeti-luxid-service-type)\n"
  44492. "(service ganeti-kvmd-service-type)\n"
  44493. "(service ganeti-mond-service-type)\n"
  44494. "(service ganeti-metad-service-type)\n"
  44495. "(service ganeti-watcher-service-type)\n"
  44496. "(service ganeti-cleaner-service-type)\n"
  44497. msgstr ""
  44498. #. type: deftp
  44499. #: guix-git/doc/guix.texi:29844
  44500. msgid "Plus a service extension for @code{etc-service-type} that configures the file storage backend and OS variants."
  44501. msgstr ""
  44502. #. type: deftp
  44503. #: guix-git/doc/guix.texi:29847
  44504. #, no-wrap
  44505. msgid "{Data Type} ganeti-os"
  44506. msgstr ""
  44507. #. type: deftp
  44508. #: guix-git/doc/guix.texi:29850
  44509. msgid "This data type is suitable for passing to the @code{os} parameter of @code{ganeti-configuration}. It takes the following parameters:"
  44510. msgstr ""
  44511. #. type: table
  44512. #: guix-git/doc/guix.texi:29856
  44513. msgid "The name for this OS provider. It is only used to specify where the configuration ends up. Setting it to ``debootstrap'' will create @file{/etc/ganeti/instance-debootstrap}."
  44514. msgstr ""
  44515. #. type: code{#1}
  44516. #: guix-git/doc/guix.texi:29857
  44517. #, no-wrap
  44518. msgid "extension"
  44519. msgstr ""
  44520. #. type: table
  44521. #: guix-git/doc/guix.texi:29860
  44522. msgid "The file extension for variants of this OS type. For example @file{.conf} or @file{.scm}."
  44523. msgstr ""
  44524. #. type: item
  44525. #: guix-git/doc/guix.texi:29861
  44526. #, no-wrap
  44527. msgid "@code{variants} (default: @code{'()})"
  44528. msgstr ""
  44529. #. type: table
  44530. #: guix-git/doc/guix.texi:29863
  44531. msgid "List of @code{ganeti-os-variant} objects for this OS."
  44532. msgstr ""
  44533. #. type: deftp
  44534. #: guix-git/doc/guix.texi:29867
  44535. #, no-wrap
  44536. msgid "{Data Type} ganeti-os-variant"
  44537. msgstr ""
  44538. #. type: deftp
  44539. #: guix-git/doc/guix.texi:29870
  44540. msgid "This is the data type for a Ganeti OS variant. It takes the following parameters:"
  44541. msgstr ""
  44542. #. type: table
  44543. #: guix-git/doc/guix.texi:29874
  44544. msgid "The name of this variant."
  44545. msgstr ""
  44546. #. type: code{#1}
  44547. #: guix-git/doc/guix.texi:29875
  44548. #, no-wrap
  44549. msgid "configuration"
  44550. msgstr ""
  44551. #. type: table
  44552. #: guix-git/doc/guix.texi:29877
  44553. msgid "A configuration file for this variant."
  44554. msgstr ""
  44555. #. type: defvr
  44556. #: guix-git/doc/guix.texi:29880
  44557. #, no-wrap
  44558. msgid "{Scheme Variable} %default-debootstrap-hooks"
  44559. msgstr ""
  44560. #. type: defvr
  44561. #: guix-git/doc/guix.texi:29882
  44562. msgid "This variable contains hooks to configure networking and the GRUB bootloader."
  44563. msgstr ""
  44564. #. type: defvr
  44565. #: guix-git/doc/guix.texi:29884
  44566. #, no-wrap
  44567. msgid "{Scheme Variable} %default-debootstrap-extra-pkgs"
  44568. msgstr ""
  44569. #. type: defvr
  44570. #: guix-git/doc/guix.texi:29886
  44571. msgid "This variable contains a list of packages suitable for a fully-virtualized guest."
  44572. msgstr ""
  44573. #. type: deftp
  44574. #: guix-git/doc/guix.texi:29888
  44575. #, no-wrap
  44576. msgid "{Data Type} debootstrap-configuration"
  44577. msgstr ""
  44578. #. type: deftp
  44579. #: guix-git/doc/guix.texi:29891
  44580. msgid "This data type creates configuration files suitable for the debootstrap OS provider."
  44581. msgstr ""
  44582. #. type: item
  44583. #: guix-git/doc/guix.texi:29893
  44584. #, no-wrap
  44585. msgid "@code{hooks} (default: @code{%default-debootstrap-hooks})"
  44586. msgstr ""
  44587. #. type: table
  44588. #: guix-git/doc/guix.texi:29897
  44589. msgid "When not @code{#f}, this must be a G-expression that specifies a directory with scripts that will run when the OS is installed. It can also be a list of @code{(name . file-like)} pairs. For example:"
  44590. msgstr ""
  44591. #. type: lisp
  44592. #: guix-git/doc/guix.texi:29900
  44593. #, no-wrap
  44594. msgid "`((99-hello-world . ,(plain-file \"#!/bin/sh\\necho Hello, World\")))\n"
  44595. msgstr ""
  44596. #. type: table
  44597. #: guix-git/doc/guix.texi:29905
  44598. msgid "That will create a directory with one executable named @code{99-hello-world} and run it every time this variant is installed. If set to @code{#f}, hooks in @file{/etc/ganeti/instance-debootstrap/hooks} will be used, if any."
  44599. msgstr ""
  44600. #. type: item
  44601. #: guix-git/doc/guix.texi:29905
  44602. #, no-wrap
  44603. msgid "@code{proxy} (default: @code{#f})"
  44604. msgstr ""
  44605. #. type: table
  44606. #: guix-git/doc/guix.texi:29907
  44607. msgid "Optional HTTP proxy to use."
  44608. msgstr ""
  44609. #. type: item
  44610. #: guix-git/doc/guix.texi:29907
  44611. #, no-wrap
  44612. msgid "@code{mirror} (default: @code{#f})"
  44613. msgstr ""
  44614. #. type: table
  44615. #: guix-git/doc/guix.texi:29910
  44616. msgid "The Debian mirror. Typically something like @code{http://ftp.no.debian.org/debian}. The default varies depending on the distribution."
  44617. msgstr ""
  44618. #. type: item
  44619. #: guix-git/doc/guix.texi:29910
  44620. #, no-wrap
  44621. msgid "@code{arch} (default: @code{#f})"
  44622. msgstr ""
  44623. #. type: table
  44624. #: guix-git/doc/guix.texi:29913
  44625. msgid "The dpkg architecture. Set to @code{armhf} to debootstrap an ARMv7 instance on an AArch64 host. Default is to use the current system architecture."
  44626. msgstr ""
  44627. #. type: item
  44628. #: guix-git/doc/guix.texi:29913
  44629. #, no-wrap
  44630. msgid "@code{suite} (default: @code{\"stable\"})"
  44631. msgstr ""
  44632. #. type: table
  44633. #: guix-git/doc/guix.texi:29916
  44634. msgid "When set, this must be a Debian distribution ``suite'' such as @code{buster} or @code{focal}. If set to @code{#f}, the default for the OS provider is used."
  44635. msgstr ""
  44636. #. type: item
  44637. #: guix-git/doc/guix.texi:29916
  44638. #, no-wrap
  44639. msgid "@code{extra-pkgs} (default: @code{%default-debootstrap-extra-pkgs})"
  44640. msgstr ""
  44641. #. type: table
  44642. #: guix-git/doc/guix.texi:29919
  44643. msgid "List of extra packages that will get installed by dpkg in addition to the minimal system."
  44644. msgstr ""
  44645. #. type: item
  44646. #: guix-git/doc/guix.texi:29919
  44647. #, no-wrap
  44648. msgid "@code{components} (default: @code{#f})"
  44649. msgstr ""
  44650. #. type: table
  44651. #: guix-git/doc/guix.texi:29922
  44652. msgid "When set, must be a list of Debian repository ``components''. For example @code{'(\"main\" \"contrib\")}."
  44653. msgstr ""
  44654. #. type: item
  44655. #: guix-git/doc/guix.texi:29922
  44656. #, no-wrap
  44657. msgid "@code{generate-cache?} (default: @code{#t})"
  44658. msgstr ""
  44659. #. type: table
  44660. #: guix-git/doc/guix.texi:29924
  44661. msgid "Whether to automatically cache the generated debootstrap archive."
  44662. msgstr ""
  44663. #. type: item
  44664. #: guix-git/doc/guix.texi:29924
  44665. #, no-wrap
  44666. msgid "@code{clean-cache} (default: @code{14})"
  44667. msgstr ""
  44668. #. type: table
  44669. #: guix-git/doc/guix.texi:29927
  44670. msgid "Discard the cache after this amount of days. Use @code{#f} to never clear the cache."
  44671. msgstr ""
  44672. #. type: item
  44673. #: guix-git/doc/guix.texi:29927
  44674. #, no-wrap
  44675. msgid "@code{partition-style} (default: @code{'msdos})"
  44676. msgstr ""
  44677. #. type: table
  44678. #: guix-git/doc/guix.texi:29930
  44679. msgid "The type of partition to create. When set, it must be one of @code{'msdos}, @code{'none} or a string."
  44680. msgstr ""
  44681. #. type: item
  44682. #: guix-git/doc/guix.texi:29930
  44683. #, no-wrap
  44684. msgid "@code{partition-alignment} (default: @code{2048})"
  44685. msgstr ""
  44686. #. type: table
  44687. #: guix-git/doc/guix.texi:29932
  44688. msgid "Alignment of the partition in sectors."
  44689. msgstr ""
  44690. #. type: deffn
  44691. #: guix-git/doc/guix.texi:29935
  44692. #, no-wrap
  44693. msgid "{Scheme Procedure} debootstrap-variant @var{name} @var{configuration}"
  44694. msgstr ""
  44695. #. type: deffn
  44696. #: guix-git/doc/guix.texi:29938
  44697. msgid "This is a helper procedure that creates a @code{ganeti-os-variant} record. It takes two parameters: a name and a @code{debootstrap-configuration} object."
  44698. msgstr ""
  44699. #. type: deffn
  44700. #: guix-git/doc/guix.texi:29940
  44701. #, no-wrap
  44702. msgid "{Scheme Procedure} debootstrap-os @var{variants}@dots{}"
  44703. msgstr ""
  44704. #. type: deffn
  44705. #: guix-git/doc/guix.texi:29943
  44706. msgid "This is a helper procedure that creates a @code{ganeti-os} record. It takes a list of variants created with @code{debootstrap-variant}."
  44707. msgstr ""
  44708. #. type: deffn
  44709. #: guix-git/doc/guix.texi:29945
  44710. #, no-wrap
  44711. msgid "{Scheme Procedure} guix-variant @var{name} @var{configuration}"
  44712. msgstr ""
  44713. #. type: deffn
  44714. #: guix-git/doc/guix.texi:29950
  44715. msgid "This is a helper procedure that creates a @code{ganeti-os-variant} record for use with the Guix OS provider. It takes a name and a G-expression that returns a ``file-like'' (@pxref{G-Expressions, file-like objects}) object containing a Guix System configuration."
  44716. msgstr ""
  44717. #. type: deffn
  44718. #: guix-git/doc/guix.texi:29952
  44719. #, no-wrap
  44720. msgid "{Scheme Procedure} guix-os @var{variants}@dots{}"
  44721. msgstr ""
  44722. #. type: deffn
  44723. #: guix-git/doc/guix.texi:29955
  44724. msgid "This is a helper procedure that creates a @code{ganeti-os} record. It takes a list of variants produced by @code{guix-variant}."
  44725. msgstr ""
  44726. #. type: defvr
  44727. #: guix-git/doc/guix.texi:29957
  44728. #, no-wrap
  44729. msgid "{Scheme Variable} %default-debootstrap-variants"
  44730. msgstr ""
  44731. #. type: defvr
  44732. #: guix-git/doc/guix.texi:29961
  44733. msgid "This is a convenience variable to make the debootstrap provider work ``out of the box'' without users having to declare variants manually. It contains a single debootstrap variant with the default configuration:"
  44734. msgstr ""
  44735. #. type: lisp
  44736. #: guix-git/doc/guix.texi:29966
  44737. #, no-wrap
  44738. msgid ""
  44739. "(list (debootstrap-variant\n"
  44740. " \"default\"\n"
  44741. " (debootstrap-configuration)))\n"
  44742. msgstr ""
  44743. #. type: defvr
  44744. #: guix-git/doc/guix.texi:29969
  44745. #, no-wrap
  44746. msgid "{Scheme Variable} %default-guix-variants"
  44747. msgstr ""
  44748. #. type: defvr
  44749. #: guix-git/doc/guix.texi:29973
  44750. msgid "This is a convenience variable to make the Guix OS provider work without additional configuration. It creates a virtual machine that has an SSH server, a serial console, and authorizes the Ganeti hosts SSH keys."
  44751. msgstr ""
  44752. #. type: lisp
  44753. #: guix-git/doc/guix.texi:29979
  44754. #, no-wrap
  44755. msgid ""
  44756. "(list (guix-variant\n"
  44757. " \"default\"\n"
  44758. " (file-append ganeti-instance-guix\n"
  44759. " \"/share/doc/ganeti-instance-guix/examples/dynamic.scm\")))\n"
  44760. msgstr ""
  44761. #. type: Plain text
  44762. #: guix-git/doc/guix.texi:29985
  44763. msgid "Users can implement support for OS providers unbeknownst to Guix by extending the @code{ganeti-os} and @code{ganeti-os-variant} records appropriately. For example:"
  44764. msgstr ""
  44765. #. type: lisp
  44766. #: guix-git/doc/guix.texi:29994
  44767. #, no-wrap
  44768. msgid ""
  44769. "(ganeti-os\n"
  44770. " (name \"custom\")\n"
  44771. " (extension \".conf\")\n"
  44772. " (variants\n"
  44773. " (list (ganeti-os-variant\n"
  44774. " (name \"foo\")\n"
  44775. " (configuration (plain-file \"bar\" \"this is fine\"))))))\n"
  44776. msgstr ""
  44777. #. type: Plain text
  44778. #: guix-git/doc/guix.texi:29999
  44779. msgid "That creates @file{/etc/ganeti/instance-custom/variants/foo.conf} which points to a file in the store with contents @code{this is fine}. It also creates @file{/etc/ganeti/instance-custom/variants/variants.list} with contents @code{foo}."
  44780. msgstr ""
  44781. #. type: Plain text
  44782. #: guix-git/doc/guix.texi:30002
  44783. msgid "Obviously this may not work for all OS providers out there. If you find the interface limiting, please reach out to @email{guix-devel@@gnu.org}."
  44784. msgstr ""
  44785. #. type: Plain text
  44786. #: guix-git/doc/guix.texi:30005
  44787. msgid "The rest of this section documents the various services that are included by @code{ganeti-service-type}."
  44788. msgstr ""
  44789. #. type: defvr
  44790. #: guix-git/doc/guix.texi:30006
  44791. #, no-wrap
  44792. msgid "{Scheme Variable} ganeti-noded-service-type"
  44793. msgstr ""
  44794. #. type: defvr
  44795. #: guix-git/doc/guix.texi:30010
  44796. msgid "@command{ganeti-noded} is the daemon responsible for node-specific functions within the Ganeti system. The value of this service must be a @code{ganeti-noded-configuration} object."
  44797. msgstr ""
  44798. #. type: deftp
  44799. #: guix-git/doc/guix.texi:30012
  44800. #, no-wrap
  44801. msgid "{Data Type} ganeti-noded-configuration"
  44802. msgstr ""
  44803. #. type: deftp
  44804. #: guix-git/doc/guix.texi:30014
  44805. msgid "This is the configuration for the @code{ganeti-noded} service."
  44806. msgstr ""
  44807. #. type: table
  44808. #: guix-git/doc/guix.texi:30018 guix-git/doc/guix.texi:30068
  44809. #: guix-git/doc/guix.texi:30098 guix-git/doc/guix.texi:30125
  44810. #: guix-git/doc/guix.texi:30157 guix-git/doc/guix.texi:30210
  44811. #: guix-git/doc/guix.texi:30230 guix-git/doc/guix.texi:30256
  44812. #: guix-git/doc/guix.texi:30289
  44813. msgid "The @code{ganeti} package to use for this service."
  44814. msgstr ""
  44815. #. type: item
  44816. #: guix-git/doc/guix.texi:30019
  44817. #, no-wrap
  44818. msgid "@code{port} (default: @code{1811})"
  44819. msgstr ""
  44820. #. type: table
  44821. #: guix-git/doc/guix.texi:30021
  44822. msgid "The TCP port on which the node daemon listens for network requests."
  44823. msgstr ""
  44824. #. type: item
  44825. #: guix-git/doc/guix.texi:30022 guix-git/doc/guix.texi:30072
  44826. #: guix-git/doc/guix.texi:30164 guix-git/doc/guix.texi:30234
  44827. #, no-wrap
  44828. msgid "@code{address} (default: @code{\"0.0.0.0\"})"
  44829. msgstr ""
  44830. #. type: table
  44831. #: guix-git/doc/guix.texi:30025
  44832. msgid "The network address that the daemon will bind to. The default address means bind to all available addresses."
  44833. msgstr ""
  44834. #. type: table
  44835. #: guix-git/doc/guix.texi:30029
  44836. msgid "When this is set, it must be a specific network interface (e.g.@: @code{eth0}) that the daemon will bind to."
  44837. msgstr ""
  44838. #. type: item
  44839. #: guix-git/doc/guix.texi:30030 guix-git/doc/guix.texi:30172
  44840. #, no-wrap
  44841. msgid "@code{max-clients} (default: @code{20})"
  44842. msgstr ""
  44843. #. type: table
  44844. #: guix-git/doc/guix.texi:30034
  44845. msgid "This sets a limit on the maximum number of simultaneous client connections that the daemon will handle. Connections above this count are accepted, but no responses will be sent until enough connections have closed."
  44846. msgstr ""
  44847. #. type: item
  44848. #: guix-git/doc/guix.texi:30035 guix-git/doc/guix.texi:30177
  44849. #, no-wrap
  44850. msgid "@code{ssl?} (default: @code{#t})"
  44851. msgstr ""
  44852. #. type: table
  44853. #: guix-git/doc/guix.texi:30039
  44854. msgid "Whether to use SSL/TLS to encrypt network communications. The certificate is automatically provisioned by the cluster and can be rotated with @command{gnt-cluster renew-crypto}."
  44855. msgstr ""
  44856. #. type: item
  44857. #: guix-git/doc/guix.texi:30040 guix-git/doc/guix.texi:30180
  44858. #, no-wrap
  44859. msgid "@code{ssl-key} (default: @file{\"/var/lib/ganeti/server.pem\"})"
  44860. msgstr ""
  44861. #. type: table
  44862. #: guix-git/doc/guix.texi:30042 guix-git/doc/guix.texi:30182
  44863. msgid "This can be used to provide a specific encryption key for TLS communications."
  44864. msgstr ""
  44865. #. type: item
  44866. #: guix-git/doc/guix.texi:30043 guix-git/doc/guix.texi:30183
  44867. #, no-wrap
  44868. msgid "@code{ssl-cert} (default: @file{\"/var/lib/ganeti/server.pem\"})"
  44869. msgstr ""
  44870. #. type: table
  44871. #: guix-git/doc/guix.texi:30045 guix-git/doc/guix.texi:30185
  44872. msgid "This can be used to provide a specific certificate for TLS communications."
  44873. msgstr ""
  44874. #. type: table
  44875. #: guix-git/doc/guix.texi:30049 guix-git/doc/guix.texi:30189
  44876. msgid "When true, the daemon performs additional logging for debugging purposes. Note that this will leak encryption details to the log files, use with caution."
  44877. msgstr ""
  44878. #. type: defvr
  44879. #: guix-git/doc/guix.texi:30053
  44880. #, no-wrap
  44881. msgid "{Scheme Variable} ganeti-confd-service-type"
  44882. msgstr ""
  44883. #. type: defvr
  44884. #: guix-git/doc/guix.texi:30059
  44885. msgid "@command{ganeti-confd} answers queries related to the configuration of a Ganeti cluster. The purpose of this daemon is to have a highly available and fast way to query cluster configuration values. It is automatically active on all @dfn{master candidates}. The value of this service must be a @code{ganeti-confd-configuration} object."
  44886. msgstr ""
  44887. #. type: deftp
  44888. #: guix-git/doc/guix.texi:30062
  44889. #, no-wrap
  44890. msgid "{Data Type} ganeti-confd-configuration"
  44891. msgstr ""
  44892. #. type: deftp
  44893. #: guix-git/doc/guix.texi:30064
  44894. msgid "This is the configuration for the @code{ganeti-confd} service."
  44895. msgstr ""
  44896. #. type: item
  44897. #: guix-git/doc/guix.texi:30069
  44898. #, no-wrap
  44899. msgid "@code{port} (default: @code{1814})"
  44900. msgstr ""
  44901. #. type: table
  44902. #: guix-git/doc/guix.texi:30071
  44903. msgid "The UDP port on which to listen for network requests."
  44904. msgstr ""
  44905. #. type: table
  44906. #: guix-git/doc/guix.texi:30074
  44907. msgid "Network address that the daemon will bind to."
  44908. msgstr ""
  44909. #. type: table
  44910. #: guix-git/doc/guix.texi:30077 guix-git/doc/guix.texi:30106
  44911. #: guix-git/doc/guix.texi:30133 guix-git/doc/guix.texi:30213
  44912. #: guix-git/doc/guix.texi:30240 guix-git/doc/guix.texi:30266
  44913. msgid "When true, the daemon performs additional logging for debugging purposes."
  44914. msgstr ""
  44915. #. type: defvr
  44916. #: guix-git/doc/guix.texi:30081
  44917. #, no-wrap
  44918. msgid "{Scheme Variable} ganeti-wconfd-service-type"
  44919. msgstr ""
  44920. #. type: defvr
  44921. #: guix-git/doc/guix.texi:30087
  44922. msgid "@command{ganeti-wconfd} is the daemon that has authoritative knowledge about the cluster configuration and is the only entity that can accept changes to it. All jobs that need to modify the configuration will do so by sending appropriate requests to this daemon. It only runs on the @dfn{master node} and will automatically disable itself on other nodes."
  44923. msgstr ""
  44924. #. type: defvr
  44925. #: guix-git/doc/guix.texi:30090
  44926. msgid "The value of this service must be a @code{ganeti-wconfd-configuration} object."
  44927. msgstr ""
  44928. #. type: deftp
  44929. #: guix-git/doc/guix.texi:30092
  44930. #, no-wrap
  44931. msgid "{Data Type} ganeti-wconfd-configuration"
  44932. msgstr ""
  44933. #. type: deftp
  44934. #: guix-git/doc/guix.texi:30094 guix-git/doc/guix.texi:30121
  44935. msgid "This is the configuration for the @code{ganeti-wconfd} service."
  44936. msgstr ""
  44937. #. type: item
  44938. #: guix-git/doc/guix.texi:30099 guix-git/doc/guix.texi:30126
  44939. #, no-wrap
  44940. msgid "@code{no-voting?} (default: @code{#f})"
  44941. msgstr ""
  44942. #. type: table
  44943. #: guix-git/doc/guix.texi:30103
  44944. msgid "The daemon will refuse to start if the majority of cluster nodes does not agree that it is running on the master node. Set to @code{#t} to start even if a quorum can not be reached (dangerous, use with caution)."
  44945. msgstr ""
  44946. #. type: defvr
  44947. #: guix-git/doc/guix.texi:30110
  44948. #, no-wrap
  44949. msgid "{Scheme Variable} ganeti-luxid-service-type"
  44950. msgstr ""
  44951. #. type: defvr
  44952. #: guix-git/doc/guix.texi:30115
  44953. msgid "@command{ganeti-luxid} is a daemon used to answer queries related to the configuration and the current live state of a Ganeti cluster. Additionally, it is the authoritative daemon for the Ganeti job queue. Jobs can be submitted via this daemon and it schedules and starts them."
  44954. msgstr ""
  44955. #. type: defvr
  44956. #: guix-git/doc/guix.texi:30117
  44957. msgid "It takes a @code{ganeti-luxid-configuration} object."
  44958. msgstr ""
  44959. #. type: deftp
  44960. #: guix-git/doc/guix.texi:30119
  44961. #, no-wrap
  44962. msgid "{Data Type} ganeti-luxid-configuration"
  44963. msgstr ""
  44964. #. type: table
  44965. #: guix-git/doc/guix.texi:30130
  44966. msgid "The daemon will refuse to start if it cannot verify that the majority of cluster nodes believes that it is running on the master node. Set to @code{#t} to ignore such checks and start anyway (this can be dangerous)."
  44967. msgstr ""
  44968. #. type: defvr
  44969. #: guix-git/doc/guix.texi:30137
  44970. #, no-wrap
  44971. msgid "{Scheme Variable} ganeti-rapi-service-type"
  44972. msgstr ""
  44973. #. type: defvr
  44974. #: guix-git/doc/guix.texi:30141
  44975. msgid "@command{ganeti-rapi} provides a remote API for Ganeti clusters. It runs on the master node and can be used to perform cluster actions programmatically via a JSON-based RPC protocol."
  44976. msgstr ""
  44977. #. type: defvr
  44978. #: guix-git/doc/guix.texi:30147
  44979. msgid "Most query operations are allowed without authentication (unless @var{require-authentication?} is set), whereas write operations require explicit authorization via the @file{/var/lib/ganeti/rapi/users} file. See the @url{http://docs.ganeti.org/ganeti/master/html/rapi.html, Ganeti Remote API documentation} for more information."
  44980. msgstr ""
  44981. #. type: defvr
  44982. #: guix-git/doc/guix.texi:30149
  44983. msgid "The value of this service must be a @code{ganeti-rapi-configuration} object."
  44984. msgstr ""
  44985. #. type: deftp
  44986. #: guix-git/doc/guix.texi:30151
  44987. #, no-wrap
  44988. msgid "{Data Type} ganeti-rapi-configuration"
  44989. msgstr ""
  44990. #. type: deftp
  44991. #: guix-git/doc/guix.texi:30153
  44992. msgid "This is the configuration for the @code{ganeti-rapi} service."
  44993. msgstr ""
  44994. #. type: item
  44995. #: guix-git/doc/guix.texi:30158
  44996. #, no-wrap
  44997. msgid "@code{require-authentication?} (default: @code{#f})"
  44998. msgstr ""
  44999. #. type: table
  45000. #: guix-git/doc/guix.texi:30160
  45001. msgid "Whether to require authentication even for read-only operations."
  45002. msgstr ""
  45003. #. type: item
  45004. #: guix-git/doc/guix.texi:30161
  45005. #, no-wrap
  45006. msgid "@code{port} (default: @code{5080})"
  45007. msgstr ""
  45008. #. type: table
  45009. #: guix-git/doc/guix.texi:30163
  45010. msgid "The TCP port on which to listen to API requests."
  45011. msgstr ""
  45012. #. type: table
  45013. #: guix-git/doc/guix.texi:30167
  45014. msgid "The network address that the service will bind to. By default it listens on all configured addresses."
  45015. msgstr ""
  45016. #. type: table
  45017. #: guix-git/doc/guix.texi:30171
  45018. msgid "When set, it must specify a specific network interface such as @code{eth0} that the daemon will bind to."
  45019. msgstr ""
  45020. #. type: table
  45021. #: guix-git/doc/guix.texi:30176
  45022. msgid "The maximum number of simultaneous client requests to handle. Further connections are allowed, but no responses are sent until enough connections have closed."
  45023. msgstr ""
  45024. #. type: table
  45025. #: guix-git/doc/guix.texi:30179
  45026. msgid "Whether to use SSL/TLS encryption on the RAPI port."
  45027. msgstr ""
  45028. #. type: defvr
  45029. #: guix-git/doc/guix.texi:30193
  45030. #, no-wrap
  45031. msgid "{Scheme Variable} ganeti-kvmd-service-type"
  45032. msgstr ""
  45033. #. type: defvr
  45034. #: guix-git/doc/guix.texi:30201
  45035. msgid "@command{ganeti-kvmd} is responsible for determining whether a given KVM instance was shut down by an administrator or a user. Normally Ganeti will restart an instance that was not stopped through Ganeti itself. If the cluster option @code{user_shutdown} is true, this daemon monitors the @code{QMP} socket provided by QEMU and listens for shutdown events, and marks the instance as @dfn{USER_down} instead of @dfn{ERROR_down} when it shuts down gracefully by itself."
  45036. msgstr ""
  45037. #. type: defvr
  45038. #: guix-git/doc/guix.texi:30203
  45039. msgid "It takes a @code{ganeti-kvmd-configuration} object."
  45040. msgstr ""
  45041. #. type: deftp
  45042. #: guix-git/doc/guix.texi:30205
  45043. #, no-wrap
  45044. msgid "{Data Type} ganeti-kvmd-configuration"
  45045. msgstr ""
  45046. #. type: defvr
  45047. #: guix-git/doc/guix.texi:30217
  45048. #, no-wrap
  45049. msgid "{Scheme Variable} ganeti-mond-service-type"
  45050. msgstr ""
  45051. #. type: defvr
  45052. #: guix-git/doc/guix.texi:30221
  45053. msgid "@command{ganeti-mond} is an optional daemon that provides Ganeti monitoring functionality. It is responsible for running data collectors and publish the collected information through a HTTP interface."
  45054. msgstr ""
  45055. #. type: defvr
  45056. #: guix-git/doc/guix.texi:30223
  45057. msgid "It takes a @code{ganeti-mond-configuration} object."
  45058. msgstr ""
  45059. #. type: deftp
  45060. #: guix-git/doc/guix.texi:30225
  45061. #, no-wrap
  45062. msgid "{Data Type} ganeti-mond-configuration"
  45063. msgstr ""
  45064. #. type: item
  45065. #: guix-git/doc/guix.texi:30231
  45066. #, no-wrap
  45067. msgid "@code{port} (default: @code{1815})"
  45068. msgstr ""
  45069. #. type: table
  45070. #: guix-git/doc/guix.texi:30233 guix-git/doc/guix.texi:30259
  45071. msgid "The port on which the daemon will listen."
  45072. msgstr ""
  45073. #. type: table
  45074. #: guix-git/doc/guix.texi:30237
  45075. msgid "The network address that the daemon will bind to. By default it binds to all available interfaces."
  45076. msgstr ""
  45077. #. type: defvr
  45078. #: guix-git/doc/guix.texi:30244
  45079. #, no-wrap
  45080. msgid "{Scheme Variable} ganeti-metad-service-type"
  45081. msgstr ""
  45082. #. type: defvr
  45083. #: guix-git/doc/guix.texi:30247
  45084. msgid "@command{ganeti-metad} is an optional daemon that can be used to provide information about the cluster to instances or OS install scripts."
  45085. msgstr ""
  45086. #. type: defvr
  45087. #: guix-git/doc/guix.texi:30249
  45088. msgid "It takes a @code{ganeti-metad-configuration} object."
  45089. msgstr ""
  45090. #. type: deftp
  45091. #: guix-git/doc/guix.texi:30251
  45092. #, no-wrap
  45093. msgid "{Data Type} ganeti-metad-configuration"
  45094. msgstr ""
  45095. #. type: item
  45096. #: guix-git/doc/guix.texi:30260
  45097. #, no-wrap
  45098. msgid "@code{address} (default: @code{#f})"
  45099. msgstr ""
  45100. #. type: table
  45101. #: guix-git/doc/guix.texi:30263
  45102. msgid "If set, the daemon will bind to this address only. If left unset, the behavior depends on the cluster configuration."
  45103. msgstr ""
  45104. #. type: defvr
  45105. #: guix-git/doc/guix.texi:30270
  45106. #, no-wrap
  45107. msgid "{Scheme Variable} ganeti-watcher-service-type"
  45108. msgstr ""
  45109. #. type: defvr
  45110. #: guix-git/doc/guix.texi:30278
  45111. msgid "@command{ganeti-watcher} is a script designed to run periodically and ensure the health of a cluster. It will automatically restart instances that have stopped without Ganeti's consent, and repairs DRBD links in case a node has rebooted. It also archives old cluster jobs and restarts Ganeti daemons that are not running. If the cluster parameter @code{ensure_node_health} is set, the watcher will also shutdown instances and DRBD devices if the node it is running on is declared offline by known master candidates."
  45112. msgstr ""
  45113. #. type: defvr
  45114. #: guix-git/doc/guix.texi:30280
  45115. msgid "It can be paused on all nodes with @command{gnt-cluster watcher pause}."
  45116. msgstr ""
  45117. #. type: defvr
  45118. #: guix-git/doc/guix.texi:30282
  45119. msgid "The service takes a @code{ganeti-watcher-configuration} object."
  45120. msgstr ""
  45121. #. type: deftp
  45122. #: guix-git/doc/guix.texi:30284
  45123. #, no-wrap
  45124. msgid "{Data Type} ganeti-watcher-configuration"
  45125. msgstr ""
  45126. #. type: item
  45127. #: guix-git/doc/guix.texi:30290
  45128. #, no-wrap
  45129. msgid "@code{schedule} (default: @code{'(next-second-from (next-minute (range 0 60 5)))})"
  45130. msgstr ""
  45131. #. type: table
  45132. #: guix-git/doc/guix.texi:30292
  45133. msgid "How often to run the script. The default is every five minutes."
  45134. msgstr ""
  45135. #. type: item
  45136. #: guix-git/doc/guix.texi:30293
  45137. #, no-wrap
  45138. msgid "@code{rapi-ip} (default: @code{#f})"
  45139. msgstr ""
  45140. #. type: table
  45141. #: guix-git/doc/guix.texi:30296
  45142. msgid "This option needs to be specified only if the RAPI daemon is configured to use a particular interface or address. By default the cluster address is used."
  45143. msgstr ""
  45144. #. type: item
  45145. #: guix-git/doc/guix.texi:30297
  45146. #, no-wrap
  45147. msgid "@code{job-age} (default: @code{(* 6 3600)})"
  45148. msgstr ""
  45149. #. type: table
  45150. #: guix-git/doc/guix.texi:30300
  45151. msgid "Archive cluster jobs older than this age, specified in seconds. The default is 6 hours. This keeps @command{gnt-job list} manageable."
  45152. msgstr ""
  45153. #. type: item
  45154. #: guix-git/doc/guix.texi:30301
  45155. #, no-wrap
  45156. msgid "@code{verify-disks?} (default: @code{#t})"
  45157. msgstr ""
  45158. #. type: table
  45159. #: guix-git/doc/guix.texi:30305
  45160. msgid "If this is @code{#f}, the watcher will not try to repair broken DRBD links automatically. Administrators will need to use @command{gnt-cluster verify-disks} manually instead."
  45161. msgstr ""
  45162. #. type: table
  45163. #: guix-git/doc/guix.texi:30308
  45164. msgid "When @code{#t}, the script performs additional logging for debugging purposes."
  45165. msgstr ""
  45166. #. type: defvr
  45167. #: guix-git/doc/guix.texi:30312
  45168. #, no-wrap
  45169. msgid "{Scheme Variable} ganeti-cleaner-service-type"
  45170. msgstr ""
  45171. #. type: defvr
  45172. #: guix-git/doc/guix.texi:30320
  45173. msgid "@command{ganeti-cleaner} is a script designed to run periodically and remove old files from the cluster. This service type controls two @dfn{cron jobs}: one intended for the master node that permanently purges old cluster jobs, and one intended for every node that removes expired X509 certificates, keys, and outdated @command{ganeti-watcher} information. Like all Ganeti services, it is safe to include even on non-master nodes as it will disable itself as necessary."
  45174. msgstr ""
  45175. #. type: defvr
  45176. #: guix-git/doc/guix.texi:30322
  45177. msgid "It takes a @code{ganeti-cleaner-configuration} object."
  45178. msgstr ""
  45179. #. type: deftp
  45180. #: guix-git/doc/guix.texi:30324
  45181. #, no-wrap
  45182. msgid "{Data Type} ganeti-cleaner-configuration"
  45183. msgstr ""
  45184. #. type: table
  45185. #: guix-git/doc/guix.texi:30329
  45186. msgid "The @code{ganeti} package to use for the @command{gnt-cleaner} command."
  45187. msgstr ""
  45188. #. type: item
  45189. #: guix-git/doc/guix.texi:30330
  45190. #, no-wrap
  45191. msgid "@code{master-schedule} (default: @code{\"45 1 * * *\"})"
  45192. msgstr ""
  45193. #. type: table
  45194. #: guix-git/doc/guix.texi:30333
  45195. msgid "How often to run the master cleaning job. The default is once per day, at 01:45:00."
  45196. msgstr ""
  45197. #. type: item
  45198. #: guix-git/doc/guix.texi:30334
  45199. #, no-wrap
  45200. msgid "@code{node-schedule} (default: @code{\"45 2 * * *\"})"
  45201. msgstr ""
  45202. #. type: table
  45203. #: guix-git/doc/guix.texi:30337
  45204. msgid "How often to run the node cleaning job. The default is once per day, at 02:45:00."
  45205. msgstr ""
  45206. #. type: Plain text
  45207. #: guix-git/doc/guix.texi:30351
  45208. msgid "The @code{(gnu services version-control)} module provides a service to allow remote access to local Git repositories. There are three options: the @code{git-daemon-service}, which provides access to repositories via the @code{git://} unsecured TCP-based protocol, extending the @code{nginx} web server to proxy some requests to @code{git-http-backend}, or providing a web interface with @code{cgit-service-type}."
  45209. msgstr ""
  45210. #. type: deffn
  45211. #: guix-git/doc/guix.texi:30352
  45212. #, no-wrap
  45213. msgid "{Scheme Procedure} git-daemon-service [#:config (git-daemon-configuration)]"
  45214. msgstr ""
  45215. #. type: deffn
  45216. #: guix-git/doc/guix.texi:30356
  45217. msgid "Return a service that runs @command{git daemon}, a simple TCP server to expose repositories over the Git protocol for anonymous access."
  45218. msgstr ""
  45219. #. type: deffn
  45220. #: guix-git/doc/guix.texi:30362
  45221. msgid "The optional @var{config} argument should be a @code{<git-daemon-configuration>} object, by default it allows read-only access to exported@footnote{By creating the magic file @file{git-daemon-export-ok} in the repository directory.} repositories under @file{/srv/git}."
  45222. msgstr ""
  45223. #. type: deftp
  45224. #: guix-git/doc/guix.texi:30365
  45225. #, no-wrap
  45226. msgid "{Data Type} git-daemon-configuration"
  45227. msgstr ""
  45228. #. type: deftp
  45229. #: guix-git/doc/guix.texi:30367
  45230. msgid "Data type representing the configuration for @code{git-daemon-service}."
  45231. msgstr ""
  45232. #. type: item
  45233. #: guix-git/doc/guix.texi:30369
  45234. #, no-wrap
  45235. msgid "@code{package} (default: @code{git})"
  45236. msgstr ""
  45237. #. type: table
  45238. #: guix-git/doc/guix.texi:30371 guix-git/doc/guix.texi:30431
  45239. msgid "Package object of the Git distributed version control system."
  45240. msgstr ""
  45241. #. type: item
  45242. #: guix-git/doc/guix.texi:30372 guix-git/doc/guix.texi:30435
  45243. #, no-wrap
  45244. msgid "@code{export-all?} (default: @code{#f})"
  45245. msgstr ""
  45246. #. type: table
  45247. #: guix-git/doc/guix.texi:30375
  45248. msgid "Whether to allow access for all Git repositories, even if they do not have the @file{git-daemon-export-ok} file."
  45249. msgstr ""
  45250. #. type: item
  45251. #: guix-git/doc/guix.texi:30376
  45252. #, no-wrap
  45253. msgid "@code{base-path} (default: @file{/srv/git})"
  45254. msgstr ""
  45255. #. type: table
  45256. #: guix-git/doc/guix.texi:30382
  45257. msgid "Whether to remap all the path requests as relative to the given path. If you run @command{git daemon} with @code{(base-path \"/srv/git\")} on @samp{example.com}, then if you later try to pull @indicateurl{git://example.com/hello.git}, git daemon will interpret the path as @file{/srv/git/hello.git}."
  45258. msgstr ""
  45259. #. type: item
  45260. #: guix-git/doc/guix.texi:30383
  45261. #, no-wrap
  45262. msgid "@code{user-path} (default: @code{#f})"
  45263. msgstr ""
  45264. #. type: table
  45265. #: guix-git/doc/guix.texi:30391
  45266. msgid "Whether to allow @code{~user} notation to be used in requests. When specified with empty string, requests to @indicateurl{git://host/~alice/foo} is taken as a request to access @code{foo} repository in the home directory of user @code{alice}. If @code{(user-path \"@var{path}\")} is specified, the same request is taken as a request to access @file{@var{path}/foo} repository in the home directory of user @code{alice}."
  45267. msgstr ""
  45268. #. type: item
  45269. #: guix-git/doc/guix.texi:30392
  45270. #, no-wrap
  45271. msgid "@code{listen} (default: @code{'()})"
  45272. msgstr ""
  45273. #. type: table
  45274. #: guix-git/doc/guix.texi:30395
  45275. msgid "Whether to listen on specific IP addresses or hostnames, defaults to all."
  45276. msgstr ""
  45277. #. type: item
  45278. #: guix-git/doc/guix.texi:30396
  45279. #, no-wrap
  45280. msgid "@code{port} (default: @code{#f})"
  45281. msgstr ""
  45282. #. type: table
  45283. #: guix-git/doc/guix.texi:30398
  45284. msgid "Whether to listen on an alternative port, which defaults to 9418."
  45285. msgstr ""
  45286. #. type: item
  45287. #: guix-git/doc/guix.texi:30399
  45288. #, no-wrap
  45289. msgid "@code{whitelist} (default: @code{'()})"
  45290. msgstr ""
  45291. #. type: table
  45292. #: guix-git/doc/guix.texi:30401
  45293. msgid "If not empty, only allow access to this list of directories."
  45294. msgstr ""
  45295. #. type: table
  45296. #: guix-git/doc/guix.texi:30405
  45297. msgid "Extra options will be passed to @command{git daemon}, please run @command{man git-daemon} for more information."
  45298. msgstr ""
  45299. #. type: Plain text
  45300. #: guix-git/doc/guix.texi:30419
  45301. msgid "The @code{git://} protocol lacks authentication. When you pull from a repository fetched via @code{git://}, you don't know whether the data you receive was modified or is even coming from the specified host, and your connection is subject to eavesdropping. It's better to use an authenticated and encrypted transport, such as @code{https}. Although Git allows you to serve repositories using unsophisticated file-based web servers, there is a faster protocol implemented by the @code{git-http-backend} program. This program is the back-end of a proper Git web service. It is designed to sit behind a FastCGI proxy. @xref{Web Services}, for more on running the necessary @code{fcgiwrap} daemon."
  45302. msgstr ""
  45303. #. type: Plain text
  45304. #: guix-git/doc/guix.texi:30422
  45305. msgid "Guix has a separate configuration data type for serving Git repositories over HTTP."
  45306. msgstr ""
  45307. #. type: deftp
  45308. #: guix-git/doc/guix.texi:30423
  45309. #, no-wrap
  45310. msgid "{Data Type} git-http-configuration"
  45311. msgstr ""
  45312. #. type: deftp
  45313. #: guix-git/doc/guix.texi:30427
  45314. msgid "Data type representing the configuration for a future @code{git-http-service-type}; can currently be used to configure Nginx through @code{git-http-nginx-location-configuration}."
  45315. msgstr ""
  45316. #. type: item
  45317. #: guix-git/doc/guix.texi:30429
  45318. #, no-wrap
  45319. msgid "@code{package} (default: @var{git})"
  45320. msgstr ""
  45321. #. type: item
  45322. #: guix-git/doc/guix.texi:30432
  45323. #, no-wrap
  45324. msgid "@code{git-root} (default: @file{/srv/git})"
  45325. msgstr ""
  45326. #. type: table
  45327. #: guix-git/doc/guix.texi:30434
  45328. msgid "Directory containing the Git repositories to expose to the world."
  45329. msgstr ""
  45330. #. type: table
  45331. #: guix-git/doc/guix.texi:30438
  45332. msgid "Whether to expose access for all Git repositories in @var{git-root}, even if they do not have the @file{git-daemon-export-ok} file."
  45333. msgstr ""
  45334. #. type: item
  45335. #: guix-git/doc/guix.texi:30439
  45336. #, no-wrap
  45337. msgid "@code{uri-path} (default: @samp{/git/})"
  45338. msgstr ""
  45339. #. type: table
  45340. #: guix-git/doc/guix.texi:30444
  45341. msgid "Path prefix for Git access. With the default @samp{/git/} prefix, this will map @indicateurl{http://@var{server}/git/@var{repo}.git} to @file{/srv/git/@var{repo}.git}. Requests whose URI paths do not begin with this prefix are not passed on to this Git instance."
  45342. msgstr ""
  45343. #. type: item
  45344. #: guix-git/doc/guix.texi:30445
  45345. #, no-wrap
  45346. msgid "@code{fcgiwrap-socket} (default: @code{127.0.0.1:9000})"
  45347. msgstr ""
  45348. #. type: table
  45349. #: guix-git/doc/guix.texi:30448
  45350. msgid "The socket on which the @code{fcgiwrap} daemon is listening. @xref{Web Services}."
  45351. msgstr ""
  45352. #. type: Plain text
  45353. #: guix-git/doc/guix.texi:30455
  45354. msgid "There is no @code{git-http-service-type}, currently; instead you can create an @code{nginx-location-configuration} from a @code{git-http-configuration} and then add that location to a web server."
  45355. msgstr ""
  45356. #. type: deffn
  45357. #: guix-git/doc/guix.texi:30456
  45358. #, no-wrap
  45359. msgid "{Scheme Procedure} git-http-nginx-location-configuration @"
  45360. msgstr ""
  45361. #. type: deffn
  45362. #: guix-git/doc/guix.texi:30461
  45363. msgid "[config=(git-http-configuration)] Compute an @code{nginx-location-configuration} that corresponds to the given Git http configuration. An example nginx service definition to serve the default @file{/srv/git} over HTTPS might be:"
  45364. msgstr ""
  45365. #. type: lisp
  45366. #: guix-git/doc/guix.texi:30478
  45367. #, no-wrap
  45368. msgid ""
  45369. "(service nginx-service-type\n"
  45370. " (nginx-configuration\n"
  45371. " (server-blocks\n"
  45372. " (list\n"
  45373. " (nginx-server-configuration\n"
  45374. " (listen '(\"443 ssl\"))\n"
  45375. " (server-name \"git.my-host.org\")\n"
  45376. " (ssl-certificate\n"
  45377. " \"/etc/letsencrypt/live/git.my-host.org/fullchain.pem\")\n"
  45378. " (ssl-certificate-key\n"
  45379. " \"/etc/letsencrypt/live/git.my-host.org/privkey.pem\")\n"
  45380. " (locations\n"
  45381. " (list\n"
  45382. " (git-http-nginx-location-configuration\n"
  45383. " (git-http-configuration (uri-path \"/\"))))))))))\n"
  45384. msgstr ""
  45385. #. type: deffn
  45386. #: guix-git/doc/guix.texi:30485
  45387. msgid "This example assumes that you are using Let's Encrypt to get your TLS certificate. @xref{Certificate Services}. The default @code{certbot} service will redirect all HTTP traffic on @code{git.my-host.org} to HTTPS@. You will also need to add an @code{fcgiwrap} proxy to your system services. @xref{Web Services}."
  45388. msgstr ""
  45389. #. type: subsubheading
  45390. #: guix-git/doc/guix.texi:30487
  45391. #, no-wrap
  45392. msgid "Cgit Service"
  45393. msgstr ""
  45394. #. type: cindex
  45395. #: guix-git/doc/guix.texi:30489
  45396. #, no-wrap
  45397. msgid "Cgit service"
  45398. msgstr ""
  45399. #. type: cindex
  45400. #: guix-git/doc/guix.texi:30490
  45401. #, no-wrap
  45402. msgid "Git, web interface"
  45403. msgstr ""
  45404. #. type: Plain text
  45405. #: guix-git/doc/guix.texi:30493
  45406. msgid "@uref{https://git.zx2c4.com/cgit/, Cgit} is a web frontend for Git repositories written in C."
  45407. msgstr ""
  45408. #. type: Plain text
  45409. #: guix-git/doc/guix.texi:30496
  45410. msgid "The following example will configure the service with default values. By default, Cgit can be accessed on port 80 (@code{http://localhost:80})."
  45411. msgstr ""
  45412. #. type: lisp
  45413. #: guix-git/doc/guix.texi:30499
  45414. #, no-wrap
  45415. msgid "(service cgit-service-type)\n"
  45416. msgstr ""
  45417. #. type: Plain text
  45418. #: guix-git/doc/guix.texi:30503
  45419. msgid "The @code{file-object} type designates either a file-like object (@pxref{G-Expressions, file-like objects}) or a string."
  45420. msgstr ""
  45421. #. type: Plain text
  45422. #: guix-git/doc/guix.texi:30507
  45423. msgid "Available @code{cgit-configuration} fields are:"
  45424. msgstr ""
  45425. #. type: deftypevr
  45426. #: guix-git/doc/guix.texi:30508
  45427. #, no-wrap
  45428. msgid "{@code{cgit-configuration} parameter} package package"
  45429. msgstr ""
  45430. #. type: deftypevr
  45431. #: guix-git/doc/guix.texi:30510
  45432. msgid "The CGIT package."
  45433. msgstr ""
  45434. #. type: deftypevr
  45435. #: guix-git/doc/guix.texi:30513
  45436. #, no-wrap
  45437. msgid "{@code{cgit-configuration} parameter} nginx-server-configuration-list nginx"
  45438. msgstr ""
  45439. #. type: deftypevr
  45440. #: guix-git/doc/guix.texi:30518
  45441. #, no-wrap
  45442. msgid "{@code{cgit-configuration} parameter} file-object about-filter"
  45443. msgstr ""
  45444. #. type: deftypevr
  45445. #: guix-git/doc/guix.texi:30521
  45446. msgid "Specifies a command which will be invoked to format the content of about pages (both top-level and for each repository)."
  45447. msgstr ""
  45448. #. type: deftypevr
  45449. #: guix-git/doc/guix.texi:30526
  45450. #, no-wrap
  45451. msgid "{@code{cgit-configuration} parameter} string agefile"
  45452. msgstr ""
  45453. #. type: deftypevr
  45454. #: guix-git/doc/guix.texi:30529
  45455. msgid "Specifies a path, relative to each repository path, which can be used to specify the date and time of the youngest commit in the repository."
  45456. msgstr ""
  45457. #. type: deftypevr
  45458. #: guix-git/doc/guix.texi:30534
  45459. #, no-wrap
  45460. msgid "{@code{cgit-configuration} parameter} file-object auth-filter"
  45461. msgstr ""
  45462. #. type: deftypevr
  45463. #: guix-git/doc/guix.texi:30537
  45464. msgid "Specifies a command that will be invoked for authenticating repository access."
  45465. msgstr ""
  45466. #. type: deftypevr
  45467. #: guix-git/doc/guix.texi:30542
  45468. #, no-wrap
  45469. msgid "{@code{cgit-configuration} parameter} string branch-sort"
  45470. msgstr ""
  45471. #. type: deftypevr
  45472. #: guix-git/doc/guix.texi:30545
  45473. msgid "Flag which, when set to @samp{age}, enables date ordering in the branch ref list, and when set @samp{name} enables ordering by branch name."
  45474. msgstr ""
  45475. #. type: deftypevr
  45476. #: guix-git/doc/guix.texi:30547
  45477. msgid "Defaults to @samp{\"name\"}."
  45478. msgstr ""
  45479. #. type: deftypevr
  45480. #: guix-git/doc/guix.texi:30550
  45481. #, no-wrap
  45482. msgid "{@code{cgit-configuration} parameter} string cache-root"
  45483. msgstr ""
  45484. #. type: deftypevr
  45485. #: guix-git/doc/guix.texi:30552
  45486. msgid "Path used to store the cgit cache entries."
  45487. msgstr ""
  45488. #. type: deftypevr
  45489. #: guix-git/doc/guix.texi:30554
  45490. msgid "Defaults to @samp{\"/var/cache/cgit\"}."
  45491. msgstr ""
  45492. #. type: deftypevr
  45493. #: guix-git/doc/guix.texi:30557
  45494. #, no-wrap
  45495. msgid "{@code{cgit-configuration} parameter} integer cache-static-ttl"
  45496. msgstr ""
  45497. #. type: deftypevr
  45498. #: guix-git/doc/guix.texi:30560
  45499. msgid "Number which specifies the time-to-live, in minutes, for the cached version of repository pages accessed with a fixed SHA1."
  45500. msgstr ""
  45501. #. type: deftypevr
  45502. #: guix-git/doc/guix.texi:30562 guix-git/doc/guix.texi:31005
  45503. msgid "Defaults to @samp{-1}."
  45504. msgstr ""
  45505. #. type: deftypevr
  45506. #: guix-git/doc/guix.texi:30565
  45507. #, no-wrap
  45508. msgid "{@code{cgit-configuration} parameter} integer cache-dynamic-ttl"
  45509. msgstr ""
  45510. #. type: deftypevr
  45511. #: guix-git/doc/guix.texi:30568
  45512. msgid "Number which specifies the time-to-live, in minutes, for the cached version of repository pages accessed without a fixed SHA1."
  45513. msgstr ""
  45514. #. type: deftypevr
  45515. #: guix-git/doc/guix.texi:30573
  45516. #, no-wrap
  45517. msgid "{@code{cgit-configuration} parameter} integer cache-repo-ttl"
  45518. msgstr ""
  45519. #. type: deftypevr
  45520. #: guix-git/doc/guix.texi:30576
  45521. msgid "Number which specifies the time-to-live, in minutes, for the cached version of the repository summary page."
  45522. msgstr ""
  45523. #. type: deftypevr
  45524. #: guix-git/doc/guix.texi:30581
  45525. #, no-wrap
  45526. msgid "{@code{cgit-configuration} parameter} integer cache-root-ttl"
  45527. msgstr ""
  45528. #. type: deftypevr
  45529. #: guix-git/doc/guix.texi:30584
  45530. msgid "Number which specifies the time-to-live, in minutes, for the cached version of the repository index page."
  45531. msgstr ""
  45532. #. type: deftypevr
  45533. #: guix-git/doc/guix.texi:30589
  45534. #, no-wrap
  45535. msgid "{@code{cgit-configuration} parameter} integer cache-scanrc-ttl"
  45536. msgstr ""
  45537. #. type: deftypevr
  45538. #: guix-git/doc/guix.texi:30592
  45539. msgid "Number which specifies the time-to-live, in minutes, for the result of scanning a path for Git repositories."
  45540. msgstr ""
  45541. #. type: deftypevr
  45542. #: guix-git/doc/guix.texi:30597
  45543. #, no-wrap
  45544. msgid "{@code{cgit-configuration} parameter} integer cache-about-ttl"
  45545. msgstr ""
  45546. #. type: deftypevr
  45547. #: guix-git/doc/guix.texi:30600
  45548. msgid "Number which specifies the time-to-live, in minutes, for the cached version of the repository about page."
  45549. msgstr ""
  45550. #. type: deftypevr
  45551. #: guix-git/doc/guix.texi:30605
  45552. #, no-wrap
  45553. msgid "{@code{cgit-configuration} parameter} integer cache-snapshot-ttl"
  45554. msgstr ""
  45555. #. type: deftypevr
  45556. #: guix-git/doc/guix.texi:30608
  45557. msgid "Number which specifies the time-to-live, in minutes, for the cached version of snapshots."
  45558. msgstr ""
  45559. #. type: deftypevr
  45560. #: guix-git/doc/guix.texi:30613
  45561. #, no-wrap
  45562. msgid "{@code{cgit-configuration} parameter} integer cache-size"
  45563. msgstr ""
  45564. #. type: deftypevr
  45565. #: guix-git/doc/guix.texi:30616
  45566. msgid "The maximum number of entries in the cgit cache. When set to @samp{0}, caching is disabled."
  45567. msgstr ""
  45568. #. type: deftypevr
  45569. #: guix-git/doc/guix.texi:30621
  45570. #, no-wrap
  45571. msgid "{@code{cgit-configuration} parameter} boolean case-sensitive-sort?"
  45572. msgstr ""
  45573. #. type: deftypevr
  45574. #: guix-git/doc/guix.texi:30623
  45575. msgid "Sort items in the repo list case sensitively."
  45576. msgstr ""
  45577. #. type: deftypevr
  45578. #: guix-git/doc/guix.texi:30628
  45579. #, no-wrap
  45580. msgid "{@code{cgit-configuration} parameter} list clone-prefix"
  45581. msgstr ""
  45582. #. type: deftypevr
  45583. #: guix-git/doc/guix.texi:30631
  45584. msgid "List of common prefixes which, when combined with a repository URL, generates valid clone URLs for the repository."
  45585. msgstr ""
  45586. #. type: deftypevr
  45587. #: guix-git/doc/guix.texi:30636
  45588. #, no-wrap
  45589. msgid "{@code{cgit-configuration} parameter} list clone-url"
  45590. msgstr ""
  45591. #. type: deftypevr
  45592. #: guix-git/doc/guix.texi:30638
  45593. msgid "List of @code{clone-url} templates."
  45594. msgstr ""
  45595. #. type: deftypevr
  45596. #: guix-git/doc/guix.texi:30643
  45597. #, no-wrap
  45598. msgid "{@code{cgit-configuration} parameter} file-object commit-filter"
  45599. msgstr ""
  45600. #. type: deftypevr
  45601. #: guix-git/doc/guix.texi:30645
  45602. msgid "Command which will be invoked to format commit messages."
  45603. msgstr ""
  45604. #. type: deftypevr
  45605. #: guix-git/doc/guix.texi:30650
  45606. #, no-wrap
  45607. msgid "{@code{cgit-configuration} parameter} string commit-sort"
  45608. msgstr ""
  45609. #. type: deftypevr
  45610. #: guix-git/doc/guix.texi:30654 guix-git/doc/guix.texi:31212
  45611. msgid "Flag which, when set to @samp{date}, enables strict date ordering in the commit log, and when set to @samp{topo} enables strict topological ordering."
  45612. msgstr ""
  45613. #. type: deftypevr
  45614. #: guix-git/doc/guix.texi:30656
  45615. msgid "Defaults to @samp{\"git log\"}."
  45616. msgstr ""
  45617. #. type: deftypevr
  45618. #: guix-git/doc/guix.texi:30659
  45619. #, no-wrap
  45620. msgid "{@code{cgit-configuration} parameter} file-object css"
  45621. msgstr ""
  45622. #. type: deftypevr
  45623. #: guix-git/doc/guix.texi:30661
  45624. msgid "URL which specifies the css document to include in all cgit pages."
  45625. msgstr ""
  45626. #. type: deftypevr
  45627. #: guix-git/doc/guix.texi:30663
  45628. msgid "Defaults to @samp{\"/share/cgit/cgit.css\"}."
  45629. msgstr ""
  45630. #. type: deftypevr
  45631. #: guix-git/doc/guix.texi:30666
  45632. #, no-wrap
  45633. msgid "{@code{cgit-configuration} parameter} file-object email-filter"
  45634. msgstr ""
  45635. #. type: deftypevr
  45636. #: guix-git/doc/guix.texi:30670
  45637. msgid "Specifies a command which will be invoked to format names and email address of committers, authors, and taggers, as represented in various places throughout the cgit interface."
  45638. msgstr ""
  45639. #. type: deftypevr
  45640. #: guix-git/doc/guix.texi:30675
  45641. #, no-wrap
  45642. msgid "{@code{cgit-configuration} parameter} boolean embedded?"
  45643. msgstr ""
  45644. #. type: deftypevr
  45645. #: guix-git/doc/guix.texi:30678
  45646. msgid "Flag which, when set to @samp{#t}, will make cgit generate a HTML fragment suitable for embedding in other HTML pages."
  45647. msgstr ""
  45648. #. type: deftypevr
  45649. #: guix-git/doc/guix.texi:30683
  45650. #, no-wrap
  45651. msgid "{@code{cgit-configuration} parameter} boolean enable-commit-graph?"
  45652. msgstr ""
  45653. #. type: deftypevr
  45654. #: guix-git/doc/guix.texi:30687
  45655. msgid "Flag which, when set to @samp{#t}, will make cgit print an ASCII-art commit history graph to the left of the commit messages in the repository log page."
  45656. msgstr ""
  45657. #. type: deftypevr
  45658. #: guix-git/doc/guix.texi:30692
  45659. #, no-wrap
  45660. msgid "{@code{cgit-configuration} parameter} boolean enable-filter-overrides?"
  45661. msgstr ""
  45662. #. type: deftypevr
  45663. #: guix-git/doc/guix.texi:30695
  45664. msgid "Flag which, when set to @samp{#t}, allows all filter settings to be overridden in repository-specific cgitrc files."
  45665. msgstr ""
  45666. #. type: deftypevr
  45667. #: guix-git/doc/guix.texi:30700
  45668. #, no-wrap
  45669. msgid "{@code{cgit-configuration} parameter} boolean enable-follow-links?"
  45670. msgstr ""
  45671. #. type: deftypevr
  45672. #: guix-git/doc/guix.texi:30703
  45673. msgid "Flag which, when set to @samp{#t}, allows users to follow a file in the log view."
  45674. msgstr ""
  45675. #. type: deftypevr
  45676. #: guix-git/doc/guix.texi:30708
  45677. #, no-wrap
  45678. msgid "{@code{cgit-configuration} parameter} boolean enable-http-clone?"
  45679. msgstr ""
  45680. #. type: deftypevr
  45681. #: guix-git/doc/guix.texi:30711
  45682. msgid "If set to @samp{#t}, cgit will act as an dumb HTTP endpoint for Git clones."
  45683. msgstr ""
  45684. #. type: deftypevr
  45685. #: guix-git/doc/guix.texi:30716
  45686. #, no-wrap
  45687. msgid "{@code{cgit-configuration} parameter} boolean enable-index-links?"
  45688. msgstr ""
  45689. #. type: deftypevr
  45690. #: guix-git/doc/guix.texi:30719
  45691. msgid "Flag which, when set to @samp{#t}, will make cgit generate extra links \"summary\", \"commit\", \"tree\" for each repo in the repository index."
  45692. msgstr ""
  45693. #. type: deftypevr
  45694. #: guix-git/doc/guix.texi:30724
  45695. #, no-wrap
  45696. msgid "{@code{cgit-configuration} parameter} boolean enable-index-owner?"
  45697. msgstr ""
  45698. #. type: deftypevr
  45699. #: guix-git/doc/guix.texi:30727
  45700. msgid "Flag which, when set to @samp{#t}, will make cgit display the owner of each repo in the repository index."
  45701. msgstr ""
  45702. #. type: deftypevr
  45703. #: guix-git/doc/guix.texi:30732
  45704. #, no-wrap
  45705. msgid "{@code{cgit-configuration} parameter} boolean enable-log-filecount?"
  45706. msgstr ""
  45707. #. type: deftypevr
  45708. #: guix-git/doc/guix.texi:30735
  45709. msgid "Flag which, when set to @samp{#t}, will make cgit print the number of modified files for each commit on the repository log page."
  45710. msgstr ""
  45711. #. type: deftypevr
  45712. #: guix-git/doc/guix.texi:30740
  45713. #, no-wrap
  45714. msgid "{@code{cgit-configuration} parameter} boolean enable-log-linecount?"
  45715. msgstr ""
  45716. #. type: deftypevr
  45717. #: guix-git/doc/guix.texi:30743
  45718. msgid "Flag which, when set to @samp{#t}, will make cgit print the number of added and removed lines for each commit on the repository log page."
  45719. msgstr ""
  45720. #. type: deftypevr
  45721. #: guix-git/doc/guix.texi:30748
  45722. #, no-wrap
  45723. msgid "{@code{cgit-configuration} parameter} boolean enable-remote-branches?"
  45724. msgstr ""
  45725. #. type: deftypevr
  45726. #: guix-git/doc/guix.texi:30751 guix-git/doc/guix.texi:31275
  45727. msgid "Flag which, when set to @code{#t}, will make cgit display remote branches in the summary and refs views."
  45728. msgstr ""
  45729. #. type: deftypevr
  45730. #: guix-git/doc/guix.texi:30756
  45731. #, no-wrap
  45732. msgid "{@code{cgit-configuration} parameter} boolean enable-subject-links?"
  45733. msgstr ""
  45734. #. type: deftypevr
  45735. #: guix-git/doc/guix.texi:30760
  45736. msgid "Flag which, when set to @code{1}, will make cgit use the subject of the parent commit as link text when generating links to parent commits in commit view."
  45737. msgstr ""
  45738. #. type: deftypevr
  45739. #: guix-git/doc/guix.texi:30765
  45740. #, no-wrap
  45741. msgid "{@code{cgit-configuration} parameter} boolean enable-html-serving?"
  45742. msgstr ""
  45743. #. type: deftypevr
  45744. #: guix-git/doc/guix.texi:30769
  45745. msgid "Flag which, when set to @samp{#t}, will make cgit use the subject of the parent commit as link text when generating links to parent commits in commit view."
  45746. msgstr ""
  45747. #. type: deftypevr
  45748. #: guix-git/doc/guix.texi:30774
  45749. #, no-wrap
  45750. msgid "{@code{cgit-configuration} parameter} boolean enable-tree-linenumbers?"
  45751. msgstr ""
  45752. #. type: deftypevr
  45753. #: guix-git/doc/guix.texi:30777
  45754. msgid "Flag which, when set to @samp{#t}, will make cgit generate linenumber links for plaintext blobs printed in the tree view."
  45755. msgstr ""
  45756. #. type: deftypevr
  45757. #: guix-git/doc/guix.texi:30782
  45758. #, no-wrap
  45759. msgid "{@code{cgit-configuration} parameter} boolean enable-git-config?"
  45760. msgstr ""
  45761. #. type: deftypevr
  45762. #: guix-git/doc/guix.texi:30785
  45763. msgid "Flag which, when set to @samp{#f}, will allow cgit to use Git config to set any repo specific settings."
  45764. msgstr ""
  45765. #. type: deftypevr
  45766. #: guix-git/doc/guix.texi:30790
  45767. #, no-wrap
  45768. msgid "{@code{cgit-configuration} parameter} file-object favicon"
  45769. msgstr ""
  45770. #. type: deftypevr
  45771. #: guix-git/doc/guix.texi:30792
  45772. msgid "URL used as link to a shortcut icon for cgit."
  45773. msgstr ""
  45774. #. type: deftypevr
  45775. #: guix-git/doc/guix.texi:30794
  45776. msgid "Defaults to @samp{\"/favicon.ico\"}."
  45777. msgstr ""
  45778. #. type: deftypevr
  45779. #: guix-git/doc/guix.texi:30797
  45780. #, no-wrap
  45781. msgid "{@code{cgit-configuration} parameter} string footer"
  45782. msgstr ""
  45783. #. type: deftypevr
  45784. #: guix-git/doc/guix.texi:30801
  45785. msgid "The content of the file specified with this option will be included verbatim at the bottom of all pages (i.e.@: it replaces the standard \"generated by...\"@: message)."
  45786. msgstr ""
  45787. #. type: deftypevr
  45788. #: guix-git/doc/guix.texi:30806
  45789. #, no-wrap
  45790. msgid "{@code{cgit-configuration} parameter} string head-include"
  45791. msgstr ""
  45792. #. type: deftypevr
  45793. #: guix-git/doc/guix.texi:30809
  45794. msgid "The content of the file specified with this option will be included verbatim in the HTML HEAD section on all pages."
  45795. msgstr ""
  45796. #. type: deftypevr
  45797. #: guix-git/doc/guix.texi:30814
  45798. #, no-wrap
  45799. msgid "{@code{cgit-configuration} parameter} string header"
  45800. msgstr ""
  45801. #. type: deftypevr
  45802. #: guix-git/doc/guix.texi:30817
  45803. msgid "The content of the file specified with this option will be included verbatim at the top of all pages."
  45804. msgstr ""
  45805. #. type: deftypevr
  45806. #: guix-git/doc/guix.texi:30822
  45807. #, no-wrap
  45808. msgid "{@code{cgit-configuration} parameter} file-object include"
  45809. msgstr ""
  45810. #. type: deftypevr
  45811. #: guix-git/doc/guix.texi:30825
  45812. msgid "Name of a configfile to include before the rest of the current config- file is parsed."
  45813. msgstr ""
  45814. #. type: deftypevr
  45815. #: guix-git/doc/guix.texi:30830
  45816. #, no-wrap
  45817. msgid "{@code{cgit-configuration} parameter} string index-header"
  45818. msgstr ""
  45819. #. type: deftypevr
  45820. #: guix-git/doc/guix.texi:30833
  45821. msgid "The content of the file specified with this option will be included verbatim above the repository index."
  45822. msgstr ""
  45823. #. type: deftypevr
  45824. #: guix-git/doc/guix.texi:30838
  45825. #, no-wrap
  45826. msgid "{@code{cgit-configuration} parameter} string index-info"
  45827. msgstr ""
  45828. #. type: deftypevr
  45829. #: guix-git/doc/guix.texi:30841
  45830. msgid "The content of the file specified with this option will be included verbatim below the heading on the repository index page."
  45831. msgstr ""
  45832. #. type: deftypevr
  45833. #: guix-git/doc/guix.texi:30846
  45834. #, no-wrap
  45835. msgid "{@code{cgit-configuration} parameter} boolean local-time?"
  45836. msgstr ""
  45837. #. type: deftypevr
  45838. #: guix-git/doc/guix.texi:30849
  45839. msgid "Flag which, if set to @samp{#t}, makes cgit print commit and tag times in the servers timezone."
  45840. msgstr ""
  45841. #. type: deftypevr
  45842. #: guix-git/doc/guix.texi:30854
  45843. #, no-wrap
  45844. msgid "{@code{cgit-configuration} parameter} file-object logo"
  45845. msgstr ""
  45846. #. type: deftypevr
  45847. #: guix-git/doc/guix.texi:30857
  45848. msgid "URL which specifies the source of an image which will be used as a logo on all cgit pages."
  45849. msgstr ""
  45850. #. type: deftypevr
  45851. #: guix-git/doc/guix.texi:30859
  45852. msgid "Defaults to @samp{\"/share/cgit/cgit.png\"}."
  45853. msgstr ""
  45854. #. type: deftypevr
  45855. #: guix-git/doc/guix.texi:30862
  45856. #, no-wrap
  45857. msgid "{@code{cgit-configuration} parameter} string logo-link"
  45858. msgstr ""
  45859. #. type: deftypevr
  45860. #: guix-git/doc/guix.texi:30864 guix-git/doc/guix.texi:31321
  45861. msgid "URL loaded when clicking on the cgit logo image."
  45862. msgstr ""
  45863. #. type: deftypevr
  45864. #: guix-git/doc/guix.texi:30869
  45865. #, no-wrap
  45866. msgid "{@code{cgit-configuration} parameter} file-object owner-filter"
  45867. msgstr ""
  45868. #. type: deftypevr
  45869. #: guix-git/doc/guix.texi:30872
  45870. msgid "Command which will be invoked to format the Owner column of the main page."
  45871. msgstr ""
  45872. #. type: deftypevr
  45873. #: guix-git/doc/guix.texi:30877
  45874. #, no-wrap
  45875. msgid "{@code{cgit-configuration} parameter} integer max-atom-items"
  45876. msgstr ""
  45877. #. type: deftypevr
  45878. #: guix-git/doc/guix.texi:30879
  45879. msgid "Number of items to display in atom feeds view."
  45880. msgstr ""
  45881. #. type: deftypevr
  45882. #: guix-git/doc/guix.texi:30884
  45883. #, no-wrap
  45884. msgid "{@code{cgit-configuration} parameter} integer max-commit-count"
  45885. msgstr ""
  45886. #. type: deftypevr
  45887. #: guix-git/doc/guix.texi:30886
  45888. msgid "Number of entries to list per page in \"log\" view."
  45889. msgstr ""
  45890. #. type: deftypevr
  45891. #: guix-git/doc/guix.texi:30891
  45892. #, no-wrap
  45893. msgid "{@code{cgit-configuration} parameter} integer max-message-length"
  45894. msgstr ""
  45895. #. type: deftypevr
  45896. #: guix-git/doc/guix.texi:30893
  45897. msgid "Number of commit message characters to display in \"log\" view."
  45898. msgstr ""
  45899. #. type: deftypevr
  45900. #: guix-git/doc/guix.texi:30895 guix-git/doc/guix.texi:30911
  45901. msgid "Defaults to @samp{80}."
  45902. msgstr ""
  45903. #. type: deftypevr
  45904. #: guix-git/doc/guix.texi:30898
  45905. #, no-wrap
  45906. msgid "{@code{cgit-configuration} parameter} integer max-repo-count"
  45907. msgstr ""
  45908. #. type: deftypevr
  45909. #: guix-git/doc/guix.texi:30901
  45910. msgid "Specifies the number of entries to list per page on the repository index page."
  45911. msgstr ""
  45912. #. type: deftypevr
  45913. #: guix-git/doc/guix.texi:30906
  45914. #, no-wrap
  45915. msgid "{@code{cgit-configuration} parameter} integer max-repodesc-length"
  45916. msgstr ""
  45917. #. type: deftypevr
  45918. #: guix-git/doc/guix.texi:30909
  45919. msgid "Specifies the maximum number of repo description characters to display on the repository index page."
  45920. msgstr ""
  45921. #. type: deftypevr
  45922. #: guix-git/doc/guix.texi:30914
  45923. #, no-wrap
  45924. msgid "{@code{cgit-configuration} parameter} integer max-blob-size"
  45925. msgstr ""
  45926. #. type: deftypevr
  45927. #: guix-git/doc/guix.texi:30916
  45928. msgid "Specifies the maximum size of a blob to display HTML for in KBytes."
  45929. msgstr ""
  45930. #. type: deftypevr
  45931. #: guix-git/doc/guix.texi:30921
  45932. #, no-wrap
  45933. msgid "{@code{cgit-configuration} parameter} string max-stats"
  45934. msgstr ""
  45935. #. type: deftypevr
  45936. #: guix-git/doc/guix.texi:30924
  45937. msgid "Maximum statistics period. Valid values are @samp{week},@samp{month}, @samp{quarter} and @samp{year}."
  45938. msgstr ""
  45939. #. type: deftypevr
  45940. #: guix-git/doc/guix.texi:30929
  45941. #, no-wrap
  45942. msgid "{@code{cgit-configuration} parameter} mimetype-alist mimetype"
  45943. msgstr ""
  45944. #. type: deftypevr
  45945. #: guix-git/doc/guix.texi:30931
  45946. msgid "Mimetype for the specified filename extension."
  45947. msgstr ""
  45948. #. type: deftypevr
  45949. #: guix-git/doc/guix.texi:30935
  45950. msgid "Defaults to @samp{((gif \"image/gif\") (html \"text/html\") (jpg \"image/jpeg\") (jpeg \"image/jpeg\") (pdf \"application/pdf\") (png \"image/png\") (svg \"image/svg+xml\"))}."
  45951. msgstr ""
  45952. #. type: deftypevr
  45953. #: guix-git/doc/guix.texi:30938
  45954. #, no-wrap
  45955. msgid "{@code{cgit-configuration} parameter} file-object mimetype-file"
  45956. msgstr ""
  45957. #. type: deftypevr
  45958. #: guix-git/doc/guix.texi:30940
  45959. msgid "Specifies the file to use for automatic mimetype lookup."
  45960. msgstr ""
  45961. #. type: deftypevr
  45962. #: guix-git/doc/guix.texi:30945
  45963. #, no-wrap
  45964. msgid "{@code{cgit-configuration} parameter} string module-link"
  45965. msgstr ""
  45966. #. type: deftypevr
  45967. #: guix-git/doc/guix.texi:30948
  45968. msgid "Text which will be used as the formatstring for a hyperlink when a submodule is printed in a directory listing."
  45969. msgstr ""
  45970. #. type: deftypevr
  45971. #: guix-git/doc/guix.texi:30953
  45972. #, no-wrap
  45973. msgid "{@code{cgit-configuration} parameter} boolean nocache?"
  45974. msgstr ""
  45975. #. type: deftypevr
  45976. #: guix-git/doc/guix.texi:30955
  45977. msgid "If set to the value @samp{#t} caching will be disabled."
  45978. msgstr ""
  45979. #. type: deftypevr
  45980. #: guix-git/doc/guix.texi:30960
  45981. #, no-wrap
  45982. msgid "{@code{cgit-configuration} parameter} boolean noplainemail?"
  45983. msgstr ""
  45984. #. type: deftypevr
  45985. #: guix-git/doc/guix.texi:30963
  45986. msgid "If set to @samp{#t} showing full author email addresses will be disabled."
  45987. msgstr ""
  45988. #. type: deftypevr
  45989. #: guix-git/doc/guix.texi:30968
  45990. #, no-wrap
  45991. msgid "{@code{cgit-configuration} parameter} boolean noheader?"
  45992. msgstr ""
  45993. #. type: deftypevr
  45994. #: guix-git/doc/guix.texi:30971
  45995. msgid "Flag which, when set to @samp{#t}, will make cgit omit the standard header on all pages."
  45996. msgstr ""
  45997. #. type: deftypevr
  45998. #: guix-git/doc/guix.texi:30976
  45999. #, no-wrap
  46000. msgid "{@code{cgit-configuration} parameter} project-list project-list"
  46001. msgstr ""
  46002. #. type: deftypevr
  46003. #: guix-git/doc/guix.texi:30980
  46004. msgid "A list of subdirectories inside of @code{repository-directory}, relative to it, that should loaded as Git repositories. An empty list means that all subdirectories will be loaded."
  46005. msgstr ""
  46006. #. type: deftypevr
  46007. #: guix-git/doc/guix.texi:30985
  46008. #, no-wrap
  46009. msgid "{@code{cgit-configuration} parameter} file-object readme"
  46010. msgstr ""
  46011. #. type: deftypevr
  46012. #: guix-git/doc/guix.texi:30987
  46013. msgid "Text which will be used as default value for @code{cgit-repo-readme}."
  46014. msgstr ""
  46015. #. type: deftypevr
  46016. #: guix-git/doc/guix.texi:30992
  46017. #, no-wrap
  46018. msgid "{@code{cgit-configuration} parameter} boolean remove-suffix?"
  46019. msgstr ""
  46020. #. type: deftypevr
  46021. #: guix-git/doc/guix.texi:30996
  46022. msgid "If set to @code{#t} and @code{repository-directory} is enabled, if any repositories are found with a suffix of @code{.git}, this suffix will be removed for the URL and name."
  46023. msgstr ""
  46024. #. type: deftypevr
  46025. #: guix-git/doc/guix.texi:31001
  46026. #, no-wrap
  46027. msgid "{@code{cgit-configuration} parameter} integer renamelimit"
  46028. msgstr ""
  46029. #. type: deftypevr
  46030. #: guix-git/doc/guix.texi:31003
  46031. msgid "Maximum number of files to consider when detecting renames."
  46032. msgstr ""
  46033. #. type: deftypevr
  46034. #: guix-git/doc/guix.texi:31008
  46035. #, no-wrap
  46036. msgid "{@code{cgit-configuration} parameter} string repository-sort"
  46037. msgstr ""
  46038. #. type: deftypevr
  46039. #: guix-git/doc/guix.texi:31010
  46040. msgid "The way in which repositories in each section are sorted."
  46041. msgstr ""
  46042. #. type: deftypevr
  46043. #: guix-git/doc/guix.texi:31015
  46044. #, no-wrap
  46045. msgid "{@code{cgit-configuration} parameter} robots-list robots"
  46046. msgstr ""
  46047. #. type: deftypevr
  46048. #: guix-git/doc/guix.texi:31017
  46049. msgid "Text used as content for the @code{robots} meta-tag."
  46050. msgstr ""
  46051. #. type: deftypevr
  46052. #: guix-git/doc/guix.texi:31019
  46053. msgid "Defaults to @samp{(\"noindex\" \"nofollow\")}."
  46054. msgstr ""
  46055. #. type: deftypevr
  46056. #: guix-git/doc/guix.texi:31022
  46057. #, no-wrap
  46058. msgid "{@code{cgit-configuration} parameter} string root-desc"
  46059. msgstr ""
  46060. #. type: deftypevr
  46061. #: guix-git/doc/guix.texi:31024
  46062. msgid "Text printed below the heading on the repository index page."
  46063. msgstr ""
  46064. #. type: deftypevr
  46065. #: guix-git/doc/guix.texi:31026
  46066. msgid "Defaults to @samp{\"a fast webinterface for the git dscm\"}."
  46067. msgstr ""
  46068. #. type: deftypevr
  46069. #: guix-git/doc/guix.texi:31029
  46070. #, no-wrap
  46071. msgid "{@code{cgit-configuration} parameter} string root-readme"
  46072. msgstr ""
  46073. #. type: deftypevr
  46074. #: guix-git/doc/guix.texi:31032
  46075. msgid "The content of the file specified with this option will be included verbatim below the ``about'' link on the repository index page."
  46076. msgstr ""
  46077. #. type: deftypevr
  46078. #: guix-git/doc/guix.texi:31037
  46079. #, no-wrap
  46080. msgid "{@code{cgit-configuration} parameter} string root-title"
  46081. msgstr ""
  46082. #. type: deftypevr
  46083. #: guix-git/doc/guix.texi:31039
  46084. msgid "Text printed as heading on the repository index page."
  46085. msgstr ""
  46086. #. type: deftypevr
  46087. #: guix-git/doc/guix.texi:31044
  46088. #, no-wrap
  46089. msgid "{@code{cgit-configuration} parameter} boolean scan-hidden-path"
  46090. msgstr ""
  46091. #. type: deftypevr
  46092. #: guix-git/doc/guix.texi:31050
  46093. msgid "If set to @samp{#t} and repository-directory is enabled, repository-directory will recurse into directories whose name starts with a period. Otherwise, repository-directory will stay away from such directories, considered as ``hidden''. Note that this does not apply to the @file{.git} directory in non-bare repos."
  46094. msgstr ""
  46095. #. type: deftypevr
  46096. #: guix-git/doc/guix.texi:31055
  46097. #, no-wrap
  46098. msgid "{@code{cgit-configuration} parameter} list snapshots"
  46099. msgstr ""
  46100. #. type: deftypevr
  46101. #: guix-git/doc/guix.texi:31058
  46102. msgid "Text which specifies the default set of snapshot formats that cgit generates links for."
  46103. msgstr ""
  46104. #. type: deftypevr
  46105. #: guix-git/doc/guix.texi:31063
  46106. #, no-wrap
  46107. msgid "{@code{cgit-configuration} parameter} repository-directory repository-directory"
  46108. msgstr ""
  46109. #. type: deftypevr
  46110. #: guix-git/doc/guix.texi:31066
  46111. msgid "Name of the directory to scan for repositories (represents @code{scan-path})."
  46112. msgstr ""
  46113. #. type: deftypevr
  46114. #: guix-git/doc/guix.texi:31068
  46115. msgid "Defaults to @samp{\"/srv/git\"}."
  46116. msgstr ""
  46117. #. type: deftypevr
  46118. #: guix-git/doc/guix.texi:31071
  46119. #, no-wrap
  46120. msgid "{@code{cgit-configuration} parameter} string section"
  46121. msgstr ""
  46122. #. type: deftypevr
  46123. #: guix-git/doc/guix.texi:31074 guix-git/doc/guix.texi:31390
  46124. msgid "The name of the current repository section - all repositories defined after this option will inherit the current section name."
  46125. msgstr ""
  46126. #. type: deftypevr
  46127. #: guix-git/doc/guix.texi:31079
  46128. #, no-wrap
  46129. msgid "{@code{cgit-configuration} parameter} string section-sort"
  46130. msgstr ""
  46131. #. type: deftypevr
  46132. #: guix-git/doc/guix.texi:31082
  46133. msgid "Flag which, when set to @samp{1}, will sort the sections on the repository listing by name."
  46134. msgstr ""
  46135. #. type: deftypevr
  46136. #: guix-git/doc/guix.texi:31087
  46137. #, no-wrap
  46138. msgid "{@code{cgit-configuration} parameter} integer section-from-path"
  46139. msgstr ""
  46140. #. type: deftypevr
  46141. #: guix-git/doc/guix.texi:31090
  46142. msgid "A number which, if defined prior to repository-directory, specifies how many path elements from each repo path to use as a default section name."
  46143. msgstr ""
  46144. #. type: deftypevr
  46145. #: guix-git/doc/guix.texi:31095
  46146. #, no-wrap
  46147. msgid "{@code{cgit-configuration} parameter} boolean side-by-side-diffs?"
  46148. msgstr ""
  46149. #. type: deftypevr
  46150. #: guix-git/doc/guix.texi:31098
  46151. msgid "If set to @samp{#t} shows side-by-side diffs instead of unidiffs per default."
  46152. msgstr ""
  46153. #. type: deftypevr
  46154. #: guix-git/doc/guix.texi:31103
  46155. #, no-wrap
  46156. msgid "{@code{cgit-configuration} parameter} file-object source-filter"
  46157. msgstr ""
  46158. #. type: deftypevr
  46159. #: guix-git/doc/guix.texi:31106
  46160. msgid "Specifies a command which will be invoked to format plaintext blobs in the tree view."
  46161. msgstr ""
  46162. #. type: deftypevr
  46163. #: guix-git/doc/guix.texi:31111
  46164. #, no-wrap
  46165. msgid "{@code{cgit-configuration} parameter} integer summary-branches"
  46166. msgstr ""
  46167. #. type: deftypevr
  46168. #: guix-git/doc/guix.texi:31114
  46169. msgid "Specifies the number of branches to display in the repository ``summary'' view."
  46170. msgstr ""
  46171. #. type: deftypevr
  46172. #: guix-git/doc/guix.texi:31119
  46173. #, no-wrap
  46174. msgid "{@code{cgit-configuration} parameter} integer summary-log"
  46175. msgstr ""
  46176. #. type: deftypevr
  46177. #: guix-git/doc/guix.texi:31122
  46178. msgid "Specifies the number of log entries to display in the repository ``summary'' view."
  46179. msgstr ""
  46180. #. type: deftypevr
  46181. #: guix-git/doc/guix.texi:31127
  46182. #, no-wrap
  46183. msgid "{@code{cgit-configuration} parameter} integer summary-tags"
  46184. msgstr ""
  46185. #. type: deftypevr
  46186. #: guix-git/doc/guix.texi:31130
  46187. msgid "Specifies the number of tags to display in the repository ``summary'' view."
  46188. msgstr ""
  46189. #. type: deftypevr
  46190. #: guix-git/doc/guix.texi:31135
  46191. #, no-wrap
  46192. msgid "{@code{cgit-configuration} parameter} string strict-export"
  46193. msgstr ""
  46194. #. type: deftypevr
  46195. #: guix-git/doc/guix.texi:31138
  46196. msgid "Filename which, if specified, needs to be present within the repository for cgit to allow access to that repository."
  46197. msgstr ""
  46198. #. type: deftypevr
  46199. #: guix-git/doc/guix.texi:31143
  46200. #, no-wrap
  46201. msgid "{@code{cgit-configuration} parameter} string virtual-root"
  46202. msgstr ""
  46203. #. type: deftypevr
  46204. #: guix-git/doc/guix.texi:31145
  46205. msgid "URL which, if specified, will be used as root for all cgit links."
  46206. msgstr ""
  46207. #. type: deftypevr
  46208. #: guix-git/doc/guix.texi:31147
  46209. msgid "Defaults to @samp{\"/\"}."
  46210. msgstr ""
  46211. #. type: deftypevr
  46212. #: guix-git/doc/guix.texi:31150
  46213. #, no-wrap
  46214. msgid "{@code{cgit-configuration} parameter} repository-cgit-configuration-list repositories"
  46215. msgstr ""
  46216. #. type: deftypevr
  46217. #: guix-git/doc/guix.texi:31152
  46218. msgid "A list of @dfn{cgit-repo} records to use with config."
  46219. msgstr ""
  46220. #. type: deftypevr
  46221. #: guix-git/doc/guix.texi:31156
  46222. msgid "Available @code{repository-cgit-configuration} fields are:"
  46223. msgstr ""
  46224. #. type: deftypevr
  46225. #: guix-git/doc/guix.texi:31157
  46226. #, no-wrap
  46227. msgid "{@code{repository-cgit-configuration} parameter} repo-list snapshots"
  46228. msgstr ""
  46229. #. type: deftypevr
  46230. #: guix-git/doc/guix.texi:31160
  46231. msgid "A mask of snapshot formats for this repo that cgit generates links for, restricted by the global @code{snapshots} setting."
  46232. msgstr ""
  46233. #. type: deftypevr
  46234. #: guix-git/doc/guix.texi:31165
  46235. #, no-wrap
  46236. msgid "{@code{repository-cgit-configuration} parameter} repo-file-object source-filter"
  46237. msgstr ""
  46238. #. type: deftypevr
  46239. #: guix-git/doc/guix.texi:31167
  46240. msgid "Override the default @code{source-filter}."
  46241. msgstr ""
  46242. #. type: deftypevr
  46243. #: guix-git/doc/guix.texi:31172
  46244. #, no-wrap
  46245. msgid "{@code{repository-cgit-configuration} parameter} repo-string url"
  46246. msgstr ""
  46247. #. type: deftypevr
  46248. #: guix-git/doc/guix.texi:31174
  46249. msgid "The relative URL used to access the repository."
  46250. msgstr ""
  46251. #. type: deftypevr
  46252. #: guix-git/doc/guix.texi:31179
  46253. #, no-wrap
  46254. msgid "{@code{repository-cgit-configuration} parameter} repo-file-object about-filter"
  46255. msgstr ""
  46256. #. type: deftypevr
  46257. #: guix-git/doc/guix.texi:31181
  46258. msgid "Override the default @code{about-filter}."
  46259. msgstr ""
  46260. #. type: deftypevr
  46261. #: guix-git/doc/guix.texi:31186
  46262. #, no-wrap
  46263. msgid "{@code{repository-cgit-configuration} parameter} repo-string branch-sort"
  46264. msgstr ""
  46265. #. type: deftypevr
  46266. #: guix-git/doc/guix.texi:31189
  46267. msgid "Flag which, when set to @samp{age}, enables date ordering in the branch ref list, and when set to @samp{name} enables ordering by branch name."
  46268. msgstr ""
  46269. #. type: deftypevr
  46270. #: guix-git/doc/guix.texi:31194
  46271. #, no-wrap
  46272. msgid "{@code{repository-cgit-configuration} parameter} repo-list clone-url"
  46273. msgstr ""
  46274. #. type: deftypevr
  46275. #: guix-git/doc/guix.texi:31196
  46276. msgid "A list of URLs which can be used to clone repo."
  46277. msgstr ""
  46278. #. type: deftypevr
  46279. #: guix-git/doc/guix.texi:31201
  46280. #, no-wrap
  46281. msgid "{@code{repository-cgit-configuration} parameter} repo-file-object commit-filter"
  46282. msgstr ""
  46283. #. type: deftypevr
  46284. #: guix-git/doc/guix.texi:31203
  46285. msgid "Override the default @code{commit-filter}."
  46286. msgstr ""
  46287. #. type: deftypevr
  46288. #: guix-git/doc/guix.texi:31208
  46289. #, no-wrap
  46290. msgid "{@code{repository-cgit-configuration} parameter} repo-string commit-sort"
  46291. msgstr ""
  46292. #. type: deftypevr
  46293. #: guix-git/doc/guix.texi:31217
  46294. #, no-wrap
  46295. msgid "{@code{repository-cgit-configuration} parameter} repo-string defbranch"
  46296. msgstr ""
  46297. #. type: deftypevr
  46298. #: guix-git/doc/guix.texi:31222
  46299. msgid "The name of the default branch for this repository. If no such branch exists in the repository, the first branch name (when sorted) is used as default instead. By default branch pointed to by HEAD, or ``master'' if there is no suitable HEAD."
  46300. msgstr ""
  46301. #. type: deftypevr
  46302. #: guix-git/doc/guix.texi:31227
  46303. #, no-wrap
  46304. msgid "{@code{repository-cgit-configuration} parameter} repo-string desc"
  46305. msgstr ""
  46306. #. type: deftypevr
  46307. #: guix-git/doc/guix.texi:31229
  46308. msgid "The value to show as repository description."
  46309. msgstr ""
  46310. #. type: deftypevr
  46311. #: guix-git/doc/guix.texi:31234
  46312. #, no-wrap
  46313. msgid "{@code{repository-cgit-configuration} parameter} repo-string homepage"
  46314. msgstr ""
  46315. #. type: deftypevr
  46316. #: guix-git/doc/guix.texi:31236
  46317. msgid "The value to show as repository homepage."
  46318. msgstr ""
  46319. #. type: deftypevr
  46320. #: guix-git/doc/guix.texi:31241
  46321. #, no-wrap
  46322. msgid "{@code{repository-cgit-configuration} parameter} repo-file-object email-filter"
  46323. msgstr ""
  46324. #. type: deftypevr
  46325. #: guix-git/doc/guix.texi:31243
  46326. msgid "Override the default @code{email-filter}."
  46327. msgstr ""
  46328. #. type: deftypevr
  46329. #: guix-git/doc/guix.texi:31248
  46330. #, no-wrap
  46331. msgid "{@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-commit-graph?"
  46332. msgstr ""
  46333. #. type: deftypevr
  46334. #: guix-git/doc/guix.texi:31251
  46335. msgid "A flag which can be used to disable the global setting @code{enable-commit-graph?}."
  46336. msgstr ""
  46337. #. type: deftypevr
  46338. #: guix-git/doc/guix.texi:31256
  46339. #, no-wrap
  46340. msgid "{@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-log-filecount?"
  46341. msgstr ""
  46342. #. type: deftypevr
  46343. #: guix-git/doc/guix.texi:31259
  46344. msgid "A flag which can be used to disable the global setting @code{enable-log-filecount?}."
  46345. msgstr ""
  46346. #. type: deftypevr
  46347. #: guix-git/doc/guix.texi:31264
  46348. #, no-wrap
  46349. msgid "{@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-log-linecount?"
  46350. msgstr ""
  46351. #. type: deftypevr
  46352. #: guix-git/doc/guix.texi:31267
  46353. msgid "A flag which can be used to disable the global setting @code{enable-log-linecount?}."
  46354. msgstr ""
  46355. #. type: deftypevr
  46356. #: guix-git/doc/guix.texi:31272
  46357. #, no-wrap
  46358. msgid "{@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-remote-branches?"
  46359. msgstr ""
  46360. #. type: deftypevr
  46361. #: guix-git/doc/guix.texi:31280
  46362. #, no-wrap
  46363. msgid "{@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-subject-links?"
  46364. msgstr ""
  46365. #. type: deftypevr
  46366. #: guix-git/doc/guix.texi:31283
  46367. msgid "A flag which can be used to override the global setting @code{enable-subject-links?}."
  46368. msgstr ""
  46369. #. type: deftypevr
  46370. #: guix-git/doc/guix.texi:31288
  46371. #, no-wrap
  46372. msgid "{@code{repository-cgit-configuration} parameter} maybe-repo-boolean enable-html-serving?"
  46373. msgstr ""
  46374. #. type: deftypevr
  46375. #: guix-git/doc/guix.texi:31291
  46376. msgid "A flag which can be used to override the global setting @code{enable-html-serving?}."
  46377. msgstr ""
  46378. #. type: deftypevr
  46379. #: guix-git/doc/guix.texi:31296
  46380. #, no-wrap
  46381. msgid "{@code{repository-cgit-configuration} parameter} repo-boolean hide?"
  46382. msgstr ""
  46383. #. type: deftypevr
  46384. #: guix-git/doc/guix.texi:31299
  46385. msgid "Flag which, when set to @code{#t}, hides the repository from the repository index."
  46386. msgstr ""
  46387. #. type: deftypevr
  46388. #: guix-git/doc/guix.texi:31304
  46389. #, no-wrap
  46390. msgid "{@code{repository-cgit-configuration} parameter} repo-boolean ignore?"
  46391. msgstr ""
  46392. #. type: deftypevr
  46393. #: guix-git/doc/guix.texi:31306
  46394. msgid "Flag which, when set to @samp{#t}, ignores the repository."
  46395. msgstr ""
  46396. #. type: deftypevr
  46397. #: guix-git/doc/guix.texi:31311
  46398. #, no-wrap
  46399. msgid "{@code{repository-cgit-configuration} parameter} repo-file-object logo"
  46400. msgstr ""
  46401. #. type: deftypevr
  46402. #: guix-git/doc/guix.texi:31314
  46403. msgid "URL which specifies the source of an image which will be used as a logo on this repo’s pages."
  46404. msgstr ""
  46405. #. type: deftypevr
  46406. #: guix-git/doc/guix.texi:31319
  46407. #, no-wrap
  46408. msgid "{@code{repository-cgit-configuration} parameter} repo-string logo-link"
  46409. msgstr ""
  46410. #. type: deftypevr
  46411. #: guix-git/doc/guix.texi:31326
  46412. #, no-wrap
  46413. msgid "{@code{repository-cgit-configuration} parameter} repo-file-object owner-filter"
  46414. msgstr ""
  46415. #. type: deftypevr
  46416. #: guix-git/doc/guix.texi:31328
  46417. msgid "Override the default @code{owner-filter}."
  46418. msgstr ""
  46419. #. type: deftypevr
  46420. #: guix-git/doc/guix.texi:31333
  46421. #, no-wrap
  46422. msgid "{@code{repository-cgit-configuration} parameter} repo-string module-link"
  46423. msgstr ""
  46424. #. type: deftypevr
  46425. #: guix-git/doc/guix.texi:31337
  46426. msgid "Text which will be used as the formatstring for a hyperlink when a submodule is printed in a directory listing. The arguments for the formatstring are the path and SHA1 of the submodule commit."
  46427. msgstr ""
  46428. #. type: deftypevr
  46429. #: guix-git/doc/guix.texi:31342
  46430. #, no-wrap
  46431. msgid "{@code{repository-cgit-configuration} parameter} module-link-path module-link-path"
  46432. msgstr ""
  46433. #. type: deftypevr
  46434. #: guix-git/doc/guix.texi:31346
  46435. msgid "Text which will be used as the formatstring for a hyperlink when a submodule with the specified subdirectory path is printed in a directory listing."
  46436. msgstr ""
  46437. #. type: deftypevr
  46438. #: guix-git/doc/guix.texi:31351
  46439. #, no-wrap
  46440. msgid "{@code{repository-cgit-configuration} parameter} repo-string max-stats"
  46441. msgstr ""
  46442. #. type: deftypevr
  46443. #: guix-git/doc/guix.texi:31353
  46444. msgid "Override the default maximum statistics period."
  46445. msgstr ""
  46446. #. type: deftypevr
  46447. #: guix-git/doc/guix.texi:31358
  46448. #, no-wrap
  46449. msgid "{@code{repository-cgit-configuration} parameter} repo-string name"
  46450. msgstr ""
  46451. #. type: deftypevr
  46452. #: guix-git/doc/guix.texi:31360
  46453. msgid "The value to show as repository name."
  46454. msgstr ""
  46455. #. type: deftypevr
  46456. #: guix-git/doc/guix.texi:31365
  46457. #, no-wrap
  46458. msgid "{@code{repository-cgit-configuration} parameter} repo-string owner"
  46459. msgstr ""
  46460. #. type: deftypevr
  46461. #: guix-git/doc/guix.texi:31367
  46462. msgid "A value used to identify the owner of the repository."
  46463. msgstr ""
  46464. #. type: deftypevr
  46465. #: guix-git/doc/guix.texi:31372
  46466. #, no-wrap
  46467. msgid "{@code{repository-cgit-configuration} parameter} repo-string path"
  46468. msgstr ""
  46469. #. type: deftypevr
  46470. #: guix-git/doc/guix.texi:31374
  46471. msgid "An absolute path to the repository directory."
  46472. msgstr ""
  46473. #. type: deftypevr
  46474. #: guix-git/doc/guix.texi:31379
  46475. #, no-wrap
  46476. msgid "{@code{repository-cgit-configuration} parameter} repo-string readme"
  46477. msgstr ""
  46478. #. type: deftypevr
  46479. #: guix-git/doc/guix.texi:31382
  46480. msgid "A path (relative to repo) which specifies a file to include verbatim as the ``About'' page for this repo."
  46481. msgstr ""
  46482. #. type: deftypevr
  46483. #: guix-git/doc/guix.texi:31387
  46484. #, no-wrap
  46485. msgid "{@code{repository-cgit-configuration} parameter} repo-string section"
  46486. msgstr ""
  46487. #. type: deftypevr
  46488. #: guix-git/doc/guix.texi:31395
  46489. #, no-wrap
  46490. msgid "{@code{repository-cgit-configuration} parameter} repo-list extra-options"
  46491. msgstr ""
  46492. #. type: deftypevr
  46493. #: guix-git/doc/guix.texi:31397 guix-git/doc/guix.texi:31406
  46494. msgid "Extra options will be appended to cgitrc file."
  46495. msgstr ""
  46496. #. type: deftypevr
  46497. #: guix-git/doc/guix.texi:31404
  46498. #, no-wrap
  46499. msgid "{@code{cgit-configuration} parameter} list extra-options"
  46500. msgstr ""
  46501. #. type: Plain text
  46502. #: guix-git/doc/guix.texi:31418
  46503. msgid "However, it could be that you just want to get a @code{cgitrc} up and running. In that case, you can pass an @code{opaque-cgit-configuration} as a record to @code{cgit-service-type}. As its name indicates, an opaque configuration does not have easy reflective capabilities."
  46504. msgstr ""
  46505. #. type: Plain text
  46506. #: guix-git/doc/guix.texi:31420
  46507. msgid "Available @code{opaque-cgit-configuration} fields are:"
  46508. msgstr ""
  46509. #. type: deftypevr
  46510. #: guix-git/doc/guix.texi:31421
  46511. #, no-wrap
  46512. msgid "{@code{opaque-cgit-configuration} parameter} package cgit"
  46513. msgstr ""
  46514. #. type: deftypevr
  46515. #: guix-git/doc/guix.texi:31423
  46516. msgid "The cgit package."
  46517. msgstr ""
  46518. #. type: deftypevr
  46519. #: guix-git/doc/guix.texi:31425
  46520. #, no-wrap
  46521. msgid "{@code{opaque-cgit-configuration} parameter} string string"
  46522. msgstr ""
  46523. #. type: deftypevr
  46524. #: guix-git/doc/guix.texi:31427
  46525. msgid "The contents of the @code{cgitrc}, as a string."
  46526. msgstr ""
  46527. #. type: Plain text
  46528. #: guix-git/doc/guix.texi:31431
  46529. msgid "For example, if your @code{cgitrc} is just the empty string, you could instantiate a cgit service like this:"
  46530. msgstr ""
  46531. #. type: lisp
  46532. #: guix-git/doc/guix.texi:31436
  46533. #, no-wrap
  46534. msgid ""
  46535. "(service cgit-service-type\n"
  46536. " (opaque-cgit-configuration\n"
  46537. " (cgitrc \"\")))\n"
  46538. msgstr ""
  46539. #. type: subsubheading
  46540. #: guix-git/doc/guix.texi:31438
  46541. #, no-wrap
  46542. msgid "Gitolite Service"
  46543. msgstr ""
  46544. #. type: cindex
  46545. #: guix-git/doc/guix.texi:31440
  46546. #, no-wrap
  46547. msgid "Gitolite service"
  46548. msgstr ""
  46549. #. type: cindex
  46550. #: guix-git/doc/guix.texi:31441
  46551. #, no-wrap
  46552. msgid "Git, hosting"
  46553. msgstr ""
  46554. #. type: Plain text
  46555. #: guix-git/doc/guix.texi:31444
  46556. msgid "@uref{https://gitolite.com/gitolite/, Gitolite} is a tool for hosting Git repositories on a central server."
  46557. msgstr ""
  46558. #. type: Plain text
  46559. #: guix-git/doc/guix.texi:31447
  46560. msgid "Gitolite can handle multiple repositories and users, and supports flexible configuration of the permissions for the users on the repositories."
  46561. msgstr ""
  46562. #. type: Plain text
  46563. #: guix-git/doc/guix.texi:31450
  46564. msgid "The following example will configure Gitolite using the default @code{git} user, and the provided SSH public key."
  46565. msgstr ""
  46566. #. type: lisp
  46567. #: guix-git/doc/guix.texi:31457
  46568. #, no-wrap
  46569. msgid ""
  46570. "(service gitolite-service-type\n"
  46571. " (gitolite-configuration\n"
  46572. " (admin-pubkey (plain-file\n"
  46573. " \"yourname.pub\"\n"
  46574. " \"ssh-rsa AAAA... guix@@example.com\"))))\n"
  46575. msgstr ""
  46576. #. type: Plain text
  46577. #: guix-git/doc/guix.texi:31462
  46578. msgid "Gitolite is configured through a special admin repository which you can clone, for example, if you setup Gitolite on @code{example.com}, you would run the following command to clone the admin repository."
  46579. msgstr ""
  46580. #. type: example
  46581. #: guix-git/doc/guix.texi:31465
  46582. #, no-wrap
  46583. msgid "git clone git@@example.com:gitolite-admin\n"
  46584. msgstr ""
  46585. #. type: Plain text
  46586. #: guix-git/doc/guix.texi:31471
  46587. msgid "When the Gitolite service is activated, the provided @code{admin-pubkey} will be inserted in to the @file{keydir} directory in the gitolite-admin repository. If this results in a change in the repository, it will be committed using the message ``gitolite setup by GNU Guix''."
  46588. msgstr ""
  46589. #. type: deftp
  46590. #: guix-git/doc/guix.texi:31472
  46591. #, no-wrap
  46592. msgid "{Data Type} gitolite-configuration"
  46593. msgstr ""
  46594. #. type: deftp
  46595. #: guix-git/doc/guix.texi:31474
  46596. msgid "Data type representing the configuration for @code{gitolite-service-type}."
  46597. msgstr ""
  46598. #. type: item
  46599. #: guix-git/doc/guix.texi:31476
  46600. #, no-wrap
  46601. msgid "@code{package} (default: @var{gitolite})"
  46602. msgstr ""
  46603. #. type: table
  46604. #: guix-git/doc/guix.texi:31478
  46605. msgid "Gitolite package to use."
  46606. msgstr ""
  46607. #. type: item
  46608. #: guix-git/doc/guix.texi:31479
  46609. #, no-wrap
  46610. msgid "@code{user} (default: @var{git})"
  46611. msgstr ""
  46612. #. type: table
  46613. #: guix-git/doc/guix.texi:31482
  46614. msgid "User to use for Gitolite. This will be user that you use when accessing Gitolite over SSH."
  46615. msgstr ""
  46616. #. type: item
  46617. #: guix-git/doc/guix.texi:31483
  46618. #, no-wrap
  46619. msgid "@code{group} (default: @var{git})"
  46620. msgstr ""
  46621. #. type: table
  46622. #: guix-git/doc/guix.texi:31485
  46623. msgid "Group to use for Gitolite."
  46624. msgstr ""
  46625. #. type: item
  46626. #: guix-git/doc/guix.texi:31486
  46627. #, no-wrap
  46628. msgid "@code{home-directory} (default: @var{\"/var/lib/gitolite\"})"
  46629. msgstr ""
  46630. #. type: table
  46631. #: guix-git/doc/guix.texi:31488
  46632. msgid "Directory in which to store the Gitolite configuration and repositories."
  46633. msgstr ""
  46634. #. type: item
  46635. #: guix-git/doc/guix.texi:31489
  46636. #, no-wrap
  46637. msgid "@code{rc-file} (default: @var{(gitolite-rc-file)})"
  46638. msgstr ""
  46639. #. type: table
  46640. #: guix-git/doc/guix.texi:31492
  46641. msgid "A ``file-like'' object (@pxref{G-Expressions, file-like objects}), representing the configuration for Gitolite."
  46642. msgstr ""
  46643. #. type: item
  46644. #: guix-git/doc/guix.texi:31493
  46645. #, no-wrap
  46646. msgid "@code{admin-pubkey} (default: @var{#f})"
  46647. msgstr ""
  46648. #. type: table
  46649. #: guix-git/doc/guix.texi:31497
  46650. msgid "A ``file-like'' object (@pxref{G-Expressions, file-like objects}) used to setup Gitolite. This will be inserted in to the @file{keydir} directory within the gitolite-admin repository."
  46651. msgstr ""
  46652. #. type: table
  46653. #: guix-git/doc/guix.texi:31499
  46654. msgid "To specify the SSH key as a string, use the @code{plain-file} function."
  46655. msgstr ""
  46656. #. type: lisp
  46657. #: guix-git/doc/guix.texi:31502
  46658. #, no-wrap
  46659. msgid "(plain-file \"yourname.pub\" \"ssh-rsa AAAA... guix@@example.com\")\n"
  46660. msgstr ""
  46661. #. type: deftp
  46662. #: guix-git/doc/guix.texi:31507
  46663. #, no-wrap
  46664. msgid "{Data Type} gitolite-rc-file"
  46665. msgstr ""
  46666. #. type: deftp
  46667. #: guix-git/doc/guix.texi:31509
  46668. msgid "Data type representing the Gitolite RC file."
  46669. msgstr ""
  46670. #. type: item
  46671. #: guix-git/doc/guix.texi:31511
  46672. #, no-wrap
  46673. msgid "@code{umask} (default: @code{#o0077})"
  46674. msgstr ""
  46675. #. type: table
  46676. #: guix-git/doc/guix.texi:31514
  46677. msgid "This controls the permissions Gitolite sets on the repositories and their contents."
  46678. msgstr ""
  46679. #. type: table
  46680. #: guix-git/doc/guix.texi:31518
  46681. msgid "A value like @code{#o0027} will give read access to the group used by Gitolite (by default: @code{git}). This is necessary when using Gitolite with software like cgit or gitweb."
  46682. msgstr ""
  46683. #. type: item
  46684. #: guix-git/doc/guix.texi:31519
  46685. #, no-wrap
  46686. msgid "@code{git-config-keys} (default: @code{\"\"})"
  46687. msgstr ""
  46688. #. type: table
  46689. #: guix-git/doc/guix.texi:31522
  46690. msgid "Gitolite allows you to set git config values using the @samp{config} keyword. This setting allows control over the config keys to accept."
  46691. msgstr ""
  46692. #. type: item
  46693. #: guix-git/doc/guix.texi:31523
  46694. #, no-wrap
  46695. msgid "@code{roles} (default: @code{'((\"READERS\" . 1) (\"WRITERS\" . ))})"
  46696. msgstr ""
  46697. #. type: table
  46698. #: guix-git/doc/guix.texi:31525
  46699. msgid "Set the role names allowed to be used by users running the perms command."
  46700. msgstr ""
  46701. #. type: item
  46702. #: guix-git/doc/guix.texi:31526
  46703. #, no-wrap
  46704. msgid "@code{enable} (default: @code{'(\"help\" \"desc\" \"info\" \"perms\" \"writable\" \"ssh-authkeys\" \"git-config\" \"daemon\" \"gitweb\")})"
  46705. msgstr ""
  46706. #. type: table
  46707. #: guix-git/doc/guix.texi:31528
  46708. msgid "This setting controls the commands and features to enable within Gitolite."
  46709. msgstr ""
  46710. #. type: subsubheading
  46711. #: guix-git/doc/guix.texi:31536
  46712. #, no-wrap
  46713. msgid "The Battle for Wesnoth Service"
  46714. msgstr ""
  46715. #. type: cindex
  46716. #: guix-git/doc/guix.texi:31537
  46717. #, no-wrap
  46718. msgid "wesnothd"
  46719. msgstr ""
  46720. #. type: Plain text
  46721. #: guix-git/doc/guix.texi:31541
  46722. msgid "@uref{https://wesnoth.org, The Battle for Wesnoth} is a fantasy, turn based tactical strategy game, with several single player campaigns, and multiplayer games (both networked and local)."
  46723. msgstr ""
  46724. #. type: defvar
  46725. #: guix-git/doc/guix.texi:31542
  46726. #, no-wrap
  46727. msgid "{Scheme Variable} wesnothd-service-type"
  46728. msgstr ""
  46729. #. type: defvar
  46730. #: guix-git/doc/guix.texi:31546
  46731. msgid "Service type for the wesnothd service. Its value must be a @code{wesnothd-configuration} object. To run wesnothd in the default configuration, instantiate it as:"
  46732. msgstr ""
  46733. #. type: lisp
  46734. #: guix-git/doc/guix.texi:31549
  46735. #, no-wrap
  46736. msgid "(service wesnothd-service-type)\n"
  46737. msgstr ""
  46738. #. type: deftp
  46739. #: guix-git/doc/guix.texi:31552
  46740. #, no-wrap
  46741. msgid "{Data Type} wesnothd-configuration"
  46742. msgstr ""
  46743. #. type: deftp
  46744. #: guix-git/doc/guix.texi:31554
  46745. msgid "Data type representing the configuration of @command{wesnothd}."
  46746. msgstr ""
  46747. #. type: item
  46748. #: guix-git/doc/guix.texi:31556
  46749. #, no-wrap
  46750. msgid "@code{package} (default: @code{wesnoth-server})"
  46751. msgstr ""
  46752. #. type: table
  46753. #: guix-git/doc/guix.texi:31558
  46754. msgid "The wesnoth server package to use."
  46755. msgstr ""
  46756. #. type: item
  46757. #: guix-git/doc/guix.texi:31559
  46758. #, no-wrap
  46759. msgid "@code{port} (default: @code{15000})"
  46760. msgstr ""
  46761. #. type: table
  46762. #: guix-git/doc/guix.texi:31561
  46763. msgid "The port to bind the server to."
  46764. msgstr ""
  46765. #. type: cindex
  46766. #: guix-git/doc/guix.texi:31567
  46767. #, no-wrap
  46768. msgid "pam-mount"
  46769. msgstr ""
  46770. #. type: Plain text
  46771. #: guix-git/doc/guix.texi:31572
  46772. msgid "The @code{(gnu services pam-mount)} module provides a service allowing users to mount volumes when they log in. It should be able to mount any volume format supported by the system."
  46773. msgstr ""
  46774. #. type: defvar
  46775. #: guix-git/doc/guix.texi:31573
  46776. #, no-wrap
  46777. msgid "{Scheme Variable} pam-mount-service-type"
  46778. msgstr ""
  46779. #. type: defvar
  46780. #: guix-git/doc/guix.texi:31575
  46781. msgid "Service type for PAM Mount support."
  46782. msgstr ""
  46783. #. type: deftp
  46784. #: guix-git/doc/guix.texi:31577
  46785. #, no-wrap
  46786. msgid "{Data Type} pam-mount-configuration"
  46787. msgstr ""
  46788. #. type: deftp
  46789. #: guix-git/doc/guix.texi:31579
  46790. msgid "Data type representing the configuration of PAM Mount."
  46791. msgstr ""
  46792. #. type: code{#1}
  46793. #: guix-git/doc/guix.texi:31583
  46794. #, no-wrap
  46795. msgid "rules"
  46796. msgstr ""
  46797. #. type: table
  46798. #: guix-git/doc/guix.texi:31586
  46799. msgid "The configuration rules that will be used to generate @file{/etc/security/pam_mount.conf.xml}."
  46800. msgstr ""
  46801. #. type: table
  46802. #: guix-git/doc/guix.texi:31590
  46803. msgid "The configuration rules are SXML elements (@pxref{SXML,,, guile, GNU Guile Reference Manual}), and the default ones don't mount anything for anyone at login:"
  46804. msgstr ""
  46805. #. type: lisp
  46806. #: guix-git/doc/guix.texi:31605
  46807. #, no-wrap
  46808. msgid ""
  46809. "`((debug (@@ (enable \"0\")))\n"
  46810. " (mntoptions (@@ (allow ,(string-join\n"
  46811. " '(\"nosuid\" \"nodev\" \"loop\"\n"
  46812. " \"encryption\" \"fsck\" \"nonempty\"\n"
  46813. " \"allow_root\" \"allow_other\")\n"
  46814. " \",\"))))\n"
  46815. " (mntoptions (@@ (require \"nosuid,nodev\")))\n"
  46816. " (logout (@@ (wait \"0\")\n"
  46817. " (hup \"0\")\n"
  46818. " (term \"no\")\n"
  46819. " (kill \"no\")))\n"
  46820. " (mkmountpoint (@@ (enable \"1\")\n"
  46821. " (remove \"true\"))))\n"
  46822. msgstr ""
  46823. #. type: table
  46824. #: guix-git/doc/guix.texi:31611
  46825. msgid "Some @code{volume} elements must be added to automatically mount volumes at login. Here's an example allowing the user @code{alice} to mount her encrypted @env{HOME} directory and allowing the user @code{bob} to mount the partition where he stores his data:"
  46826. msgstr ""
  46827. #. type: lisp
  46828. #: guix-git/doc/guix.texi:31636
  46829. #, no-wrap
  46830. msgid ""
  46831. "(define pam-mount-rules\n"
  46832. "`((debug (@@ (enable \"0\")))\n"
  46833. " (volume (@@ (user \"alice\")\n"
  46834. " (fstype \"crypt\")\n"
  46835. " (path \"/dev/sda2\")\n"
  46836. " (mountpoint \"/home/alice\")))\n"
  46837. " (volume (@@ (user \"bob\")\n"
  46838. " (fstype \"auto\")\n"
  46839. " (path \"/dev/sdb3\")\n"
  46840. " (mountpoint \"/home/bob/data\")\n"
  46841. " (options \"defaults,autodefrag,compress\")))\n"
  46842. " (mntoptions (@@ (allow ,(string-join\n"
  46843. " '(\"nosuid\" \"nodev\" \"loop\"\n"
  46844. " \"encryption\" \"fsck\" \"nonempty\"\n"
  46845. " \"allow_root\" \"allow_other\")\n"
  46846. " \",\"))))\n"
  46847. " (mntoptions (@@ (require \"nosuid,nodev\")))\n"
  46848. " (logout (@@ (wait \"0\")\n"
  46849. " (hup \"0\")\n"
  46850. " (term \"no\")\n"
  46851. " (kill \"no\")))\n"
  46852. " (mkmountpoint (@@ (enable \"1\")\n"
  46853. " (remove \"true\")))))\n"
  46854. "\n"
  46855. msgstr ""
  46856. #. type: lisp
  46857. #: guix-git/doc/guix.texi:31640
  46858. #, no-wrap
  46859. msgid ""
  46860. "(service pam-mount-service-type\n"
  46861. " (pam-mount-configuration\n"
  46862. " (rules pam-mount-rules)))\n"
  46863. msgstr ""
  46864. #. type: table
  46865. #: guix-git/doc/guix.texi:31644
  46866. msgid "The complete list of possible options can be found in the man page for @uref{http://pam-mount.sourceforge.net/pam_mount.conf.5.html, pam_mount.conf}."
  46867. msgstr ""
  46868. #. type: subsubheading
  46869. #: guix-git/doc/guix.texi:31651
  46870. #, no-wrap
  46871. msgid "Guix Build Coordinator"
  46872. msgstr ""
  46873. #. type: Plain text
  46874. #: guix-git/doc/guix.texi:31657
  46875. msgid "The @uref{https://git.cbaines.net/guix/build-coordinator/,Guix Build Coordinator} aids in distributing derivation builds among machines running an @dfn{agent}. The build daemon is still used to build the derivations, but the Guix Build Coordinator manages allocating builds and working with the results."
  46876. msgstr ""
  46877. #. type: quotation
  46878. #: guix-git/doc/guix.texi:31662
  46879. msgid "This service is considered experimental. Configuration options may be changed in a backwards-incompatible manner, and not all features have been thorougly tested."
  46880. msgstr ""
  46881. #. type: Plain text
  46882. #: guix-git/doc/guix.texi:31669
  46883. msgid "The Guix Build Coordinator consists of one @dfn{coordinator}, and one or more connected @dfn{agent} processes. The coordinator process handles clients submitting builds, and allocating builds to agents. The agent processes talk to a build daemon to actually perform the builds, then send the results back to the coordinator."
  46884. msgstr ""
  46885. #. type: Plain text
  46886. #: guix-git/doc/guix.texi:31673
  46887. msgid "There is a script to run the coordinator component of the Guix Build Coordinator, but the Guix service uses a custom Guile script instead, to provide better integration with G-expressions used in the configuration."
  46888. msgstr ""
  46889. #. type: defvar
  46890. #: guix-git/doc/guix.texi:31674
  46891. #, no-wrap
  46892. msgid "{Scheme Variable} guix-build-coordinator-service-type"
  46893. msgstr ""
  46894. #. type: defvar
  46895. #: guix-git/doc/guix.texi:31677
  46896. msgid "Service type for the Guix Build Coordinator. Its value must be a @code{guix-build-coordinator-configuration} object."
  46897. msgstr ""
  46898. #. type: deftp
  46899. #: guix-git/doc/guix.texi:31679
  46900. #, no-wrap
  46901. msgid "{Data Type} guix-build-coordinator-configuration"
  46902. msgstr ""
  46903. #. type: deftp
  46904. #: guix-git/doc/guix.texi:31681
  46905. msgid "Data type representing the configuration of the Guix Build Coordinator."
  46906. msgstr ""
  46907. #. type: item
  46908. #: guix-git/doc/guix.texi:31683 guix-git/doc/guix.texi:31727
  46909. #: guix-git/doc/guix.texi:31853
  46910. #, no-wrap
  46911. msgid "@code{package} (default: @code{guix-build-coordinator})"
  46912. msgstr ""
  46913. #. type: table
  46914. #: guix-git/doc/guix.texi:31685 guix-git/doc/guix.texi:31729
  46915. #: guix-git/doc/guix.texi:31855
  46916. msgid "The Guix Build Coordinator package to use."
  46917. msgstr ""
  46918. #. type: item
  46919. #: guix-git/doc/guix.texi:31686
  46920. #, no-wrap
  46921. msgid "@code{user} (default: @code{\"guix-build-coordinator\"})"
  46922. msgstr ""
  46923. #. type: table
  46924. #: guix-git/doc/guix.texi:31688 guix-git/doc/guix.texi:31732
  46925. #: guix-git/doc/guix.texi:31858 guix-git/doc/guix.texi:31904
  46926. msgid "The system user to run the service as."
  46927. msgstr ""
  46928. #. type: item
  46929. #: guix-git/doc/guix.texi:31689
  46930. #, no-wrap
  46931. msgid "@code{group} (default: @code{\"guix-build-coordinator\"})"
  46932. msgstr ""
  46933. #. type: table
  46934. #: guix-git/doc/guix.texi:31691 guix-git/doc/guix.texi:31907
  46935. msgid "The system group to run the service as."
  46936. msgstr ""
  46937. #. type: item
  46938. #: guix-git/doc/guix.texi:31692
  46939. #, no-wrap
  46940. msgid "@code{database-uri-string} (default: @code{\"sqlite:///var/lib/guix-build-coordinator/guix_build_coordinator.db\"})"
  46941. msgstr ""
  46942. #. type: table
  46943. #: guix-git/doc/guix.texi:31694
  46944. msgid "The URI to use for the database."
  46945. msgstr ""
  46946. #. type: item
  46947. #: guix-git/doc/guix.texi:31695
  46948. #, no-wrap
  46949. msgid "@code{agent-communication-uri} (default: @code{\"http://0.0.0.0:8745\"})"
  46950. msgstr ""
  46951. #. type: table
  46952. #: guix-git/doc/guix.texi:31697
  46953. msgid "The URI describing how to listen to requests from agent processes."
  46954. msgstr ""
  46955. #. type: item
  46956. #: guix-git/doc/guix.texi:31698
  46957. #, no-wrap
  46958. msgid "@code{client-communication-uri} (default: @code{\"http://127.0.0.1:8746\"})"
  46959. msgstr ""
  46960. #. type: table
  46961. #: guix-git/doc/guix.texi:31702
  46962. msgid "The URI describing how to listen to requests from clients. The client API allows submitting builds and currently isn't authenticated, so take care when configuring this value."
  46963. msgstr ""
  46964. #. type: item
  46965. #: guix-git/doc/guix.texi:31703
  46966. #, no-wrap
  46967. msgid "@code{allocation-strategy} (default: @code{#~basic-build-allocation-strategy})"
  46968. msgstr ""
  46969. #. type: table
  46970. #: guix-git/doc/guix.texi:31707
  46971. msgid "A G-expression for the allocation strategy to be used. This is a procedure that takes the datastore as an argument and populates the allocation plan in the database."
  46972. msgstr ""
  46973. #. type: item
  46974. #: guix-git/doc/guix.texi:31708
  46975. #, no-wrap
  46976. msgid "@code{hooks} (default: @var{'()})"
  46977. msgstr ""
  46978. #. type: table
  46979. #: guix-git/doc/guix.texi:31711
  46980. msgid "An association list of hooks. These provide a way to execute arbitrary code upon certain events, like a build result being processed."
  46981. msgstr ""
  46982. #. type: item
  46983. #: guix-git/doc/guix.texi:31712
  46984. #, no-wrap
  46985. msgid "@code{guile} (default: @code{guile-3.0-latest})"
  46986. msgstr ""
  46987. #. type: table
  46988. #: guix-git/doc/guix.texi:31714
  46989. msgid "The Guile package with which to run the Guix Build Coordinator."
  46990. msgstr ""
  46991. #. type: defvar
  46992. #: guix-git/doc/guix.texi:31718
  46993. #, no-wrap
  46994. msgid "{Scheme Variable} guix-build-coordinator-agent-service-type"
  46995. msgstr ""
  46996. #. type: defvar
  46997. #: guix-git/doc/guix.texi:31721
  46998. msgid "Service type for a Guix Build Coordinator agent. Its value must be a @code{guix-build-coordinator-agent-configuration} object."
  46999. msgstr ""
  47000. #. type: deftp
  47001. #: guix-git/doc/guix.texi:31723
  47002. #, no-wrap
  47003. msgid "{Data Type} guix-build-coordinator-agent-configuration"
  47004. msgstr ""
  47005. #. type: deftp
  47006. #: guix-git/doc/guix.texi:31725
  47007. msgid "Data type representing the configuration a Guix Build Coordinator agent."
  47008. msgstr ""
  47009. #. type: item
  47010. #: guix-git/doc/guix.texi:31730
  47011. #, no-wrap
  47012. msgid "@code{user} (default: @code{\"guix-build-coordinator-agent\"})"
  47013. msgstr ""
  47014. #. type: item
  47015. #: guix-git/doc/guix.texi:31733
  47016. #, no-wrap
  47017. msgid "@code{coordinator} (default: @code{\"http://localhost:8745\"})"
  47018. msgstr ""
  47019. #. type: table
  47020. #: guix-git/doc/guix.texi:31735 guix-git/doc/guix.texi:31861
  47021. msgid "The URI to use when connecting to the coordinator."
  47022. msgstr ""
  47023. #. type: code{#1}
  47024. #: guix-git/doc/guix.texi:31736
  47025. #, fuzzy, no-wrap
  47026. msgid "authentication"
  47027. msgstr "Documentazione"
  47028. #. type: table
  47029. #: guix-git/doc/guix.texi:31739
  47030. msgid "Record describing how this agent should authenticate with the coordinator. Possible record types are described below."
  47031. msgstr ""
  47032. #. type: item
  47033. #: guix-git/doc/guix.texi:31740 guix-git/doc/guix.texi:31862
  47034. #, no-wrap
  47035. msgid "@code{systems} (default: @code{#f})"
  47036. msgstr ""
  47037. #. type: table
  47038. #: guix-git/doc/guix.texi:31743
  47039. msgid "The systems for which this agent should fetch builds. The agent process will use the current system it's running on as the default."
  47040. msgstr ""
  47041. #. type: item
  47042. #: guix-git/doc/guix.texi:31744
  47043. #, no-wrap
  47044. msgid "@code{max-parallel-builds} (default: @code{1})"
  47045. msgstr ""
  47046. #. type: table
  47047. #: guix-git/doc/guix.texi:31746
  47048. msgid "The number of builds to perform in parallel."
  47049. msgstr ""
  47050. #. type: item
  47051. #: guix-git/doc/guix.texi:31747
  47052. #, no-wrap
  47053. msgid "@code{max-1min-load-average} (default: @code{#f})"
  47054. msgstr ""
  47055. #. type: table
  47056. #: guix-git/doc/guix.texi:31751
  47057. msgid "Load average value to look at when considering starting new builds, if the 1 minute load average exceeds this value, the agent will wait before starting new builds."
  47058. msgstr ""
  47059. #. type: table
  47060. #: guix-git/doc/guix.texi:31755
  47061. msgid "This will be unspecified if the value is @code{#f}, and the agent will use the number of cores reported by the system as the max 1 minute load average."
  47062. msgstr ""
  47063. #. type: item
  47064. #: guix-git/doc/guix.texi:31756
  47065. #, no-wrap
  47066. msgid "@code{derivation-substitute-urls} (default: @code{#f})"
  47067. msgstr ""
  47068. #. type: table
  47069. #: guix-git/doc/guix.texi:31759
  47070. msgid "URLs from which to attempt to fetch substitutes for derivations, if the derivations aren't already available."
  47071. msgstr ""
  47072. #. type: item
  47073. #: guix-git/doc/guix.texi:31760
  47074. #, no-wrap
  47075. msgid "@code{non-derivation-substitute-urls} (default: @code{#f})"
  47076. msgstr ""
  47077. #. type: table
  47078. #: guix-git/doc/guix.texi:31763
  47079. msgid "URLs from which to attempt to fetch substitutes for build inputs, if the input store items aren't already available."
  47080. msgstr ""
  47081. #. type: deftp
  47082. #: guix-git/doc/guix.texi:31767
  47083. #, no-wrap
  47084. msgid "{Data Type} guix-build-coordinator-agent-password-auth"
  47085. msgstr ""
  47086. #. type: deftp
  47087. #: guix-git/doc/guix.texi:31770
  47088. msgid "Data type representing an agent authenticating with a coordinator via a UUID and password."
  47089. msgstr ""
  47090. #. type: table
  47091. #: guix-git/doc/guix.texi:31776 guix-git/doc/guix.texi:31792
  47092. msgid "The UUID of the agent. This should be generated by the coordinator process, stored in the coordinator database, and used by the intended agent."
  47093. msgstr ""
  47094. #. type: table
  47095. #: guix-git/doc/guix.texi:31779
  47096. msgid "The password to use when connecting to the coordinator."
  47097. msgstr ""
  47098. #. type: deftp
  47099. #: guix-git/doc/guix.texi:31783
  47100. #, no-wrap
  47101. msgid "{Data Type} guix-build-coordinator-agent-password-file-auth"
  47102. msgstr ""
  47103. #. type: deftp
  47104. #: guix-git/doc/guix.texi:31786
  47105. msgid "Data type representing an agent authenticating with a coordinator via a UUID and password read from a file."
  47106. msgstr ""
  47107. #. type: code{#1}
  47108. #: guix-git/doc/guix.texi:31793
  47109. #, no-wrap
  47110. msgid "password-file"
  47111. msgstr ""
  47112. #. type: table
  47113. #: guix-git/doc/guix.texi:31796
  47114. msgid "A file containing the password to use when connecting to the coordinator."
  47115. msgstr ""
  47116. #. type: deftp
  47117. #: guix-git/doc/guix.texi:31800
  47118. #, no-wrap
  47119. msgid "{Data Type} guix-build-coordinator-agent-dynamic-auth"
  47120. msgstr ""
  47121. #. type: deftp
  47122. #: guix-git/doc/guix.texi:31803
  47123. msgid "Data type representing an agent authenticating with a coordinator via a dynamic auth token and agent name."
  47124. msgstr ""
  47125. #. type: code{#1}
  47126. #: guix-git/doc/guix.texi:31805 guix-git/doc/guix.texi:31822
  47127. #, fuzzy, no-wrap
  47128. msgid "agent-name"
  47129. msgstr "Canali"
  47130. #. type: table
  47131. #: guix-git/doc/guix.texi:31809 guix-git/doc/guix.texi:31826
  47132. msgid "Name of an agent, this is used to match up to an existing entry in the database if there is one. When no existing entry is found, a new entry is automatically added."
  47133. msgstr ""
  47134. #. type: code{#1}
  47135. #: guix-git/doc/guix.texi:31810
  47136. #, no-wrap
  47137. msgid "token"
  47138. msgstr ""
  47139. #. type: table
  47140. #: guix-git/doc/guix.texi:31813
  47141. msgid "Dynamic auth token, this is created and stored in the coordinator database, and is used by the agent to authenticate."
  47142. msgstr ""
  47143. #. type: deftp
  47144. #: guix-git/doc/guix.texi:31817
  47145. #, no-wrap
  47146. msgid "{Data Type} guix-build-coordinator-agent-dynamic-auth-with-file"
  47147. msgstr ""
  47148. #. type: deftp
  47149. #: guix-git/doc/guix.texi:31820
  47150. msgid "Data type representing an agent authenticating with a coordinator via a dynamic auth token read from a file and agent name."
  47151. msgstr ""
  47152. #. type: code{#1}
  47153. #: guix-git/doc/guix.texi:31827
  47154. #, no-wrap
  47155. msgid "token-file"
  47156. msgstr ""
  47157. #. type: table
  47158. #: guix-git/doc/guix.texi:31830
  47159. msgid "File containing the dynamic auth token, this is created and stored in the coordinator database, and is used by the agent to authenticate."
  47160. msgstr ""
  47161. #. type: Plain text
  47162. #: guix-git/doc/guix.texi:31840
  47163. msgid "The Guix Build Coordinator package contains a script to query an instance of the Guix Data Service for derivations to build, and then submit builds for those derivations to the coordinator. The service type below assists in running this script. This is an additional tool that may be useful when building derivations contained within an instance of the Guix Data Service."
  47164. msgstr ""
  47165. #. type: defvar
  47166. #: guix-git/doc/guix.texi:31841
  47167. #, no-wrap
  47168. msgid "{Scheme Variable} guix-build-coordinator-queue-builds-service-type"
  47169. msgstr ""
  47170. #. type: defvar
  47171. #: guix-git/doc/guix.texi:31846
  47172. msgid "Service type for the guix-build-coordinator-queue-builds-from-guix-data-service script. Its value must be a @code{guix-build-coordinator-queue-builds-configuration} object."
  47173. msgstr ""
  47174. #. type: deftp
  47175. #: guix-git/doc/guix.texi:31848
  47176. #, no-wrap
  47177. msgid "{Data Type} guix-build-coordinator-queue-builds-configuration"
  47178. msgstr ""
  47179. #. type: deftp
  47180. #: guix-git/doc/guix.texi:31851
  47181. msgid "Data type representing the options to the queue builds from guix data service script."
  47182. msgstr ""
  47183. #. type: item
  47184. #: guix-git/doc/guix.texi:31856
  47185. #, no-wrap
  47186. msgid "@code{user} (default: @code{\"guix-build-coordinator-queue-builds\"})"
  47187. msgstr ""
  47188. #. type: item
  47189. #: guix-git/doc/guix.texi:31859
  47190. #, no-wrap
  47191. msgid "@code{coordinator} (default: @code{\"http://localhost:8746\"})"
  47192. msgstr ""
  47193. #. type: table
  47194. #: guix-git/doc/guix.texi:31864
  47195. msgid "The systems for which to fetch derivations to build."
  47196. msgstr ""
  47197. #. type: item
  47198. #: guix-git/doc/guix.texi:31865
  47199. #, no-wrap
  47200. msgid "@code{systems-and-targets} (default: @code{#f})"
  47201. msgstr ""
  47202. #. type: table
  47203. #: guix-git/doc/guix.texi:31868
  47204. msgid "An association list of system and target pairs for which to fetch derivations to build."
  47205. msgstr ""
  47206. #. type: item
  47207. #: guix-git/doc/guix.texi:31869
  47208. #, no-wrap
  47209. msgid "@code{guix-data-service} (default: @code{\"https://data.guix.gnu.org\"})"
  47210. msgstr ""
  47211. #. type: table
  47212. #: guix-git/doc/guix.texi:31872
  47213. msgid "The Guix Data Service instance from which to query to find out about derivations to build."
  47214. msgstr ""
  47215. #. type: item
  47216. #: guix-git/doc/guix.texi:31873
  47217. #, no-wrap
  47218. msgid "@code{processed-commits-file} (default: @code{\"/var/cache/guix-build-coordinator-queue-builds/processed-commits\"})"
  47219. msgstr ""
  47220. #. type: table
  47221. #: guix-git/doc/guix.texi:31876
  47222. msgid "A file to record which commits have been processed, to avoid needlessly processing them again if the service is restarted."
  47223. msgstr ""
  47224. #. type: subsubheading
  47225. #: guix-git/doc/guix.texi:31880
  47226. #, no-wrap
  47227. msgid "Guix Data Service"
  47228. msgstr ""
  47229. #. type: Plain text
  47230. #: guix-git/doc/guix.texi:31884
  47231. msgid "The @uref{http://data.guix.gnu.org,Guix Data Service} processes, stores and provides data about GNU Guix. This includes information about packages, derivations and lint warnings."
  47232. msgstr ""
  47233. #. type: Plain text
  47234. #: guix-git/doc/guix.texi:31887
  47235. msgid "The data is stored in a PostgreSQL database, and available through a web interface."
  47236. msgstr ""
  47237. #. type: defvar
  47238. #: guix-git/doc/guix.texi:31888
  47239. #, no-wrap
  47240. msgid "{Scheme Variable} guix-data-service-type"
  47241. msgstr ""
  47242. #. type: defvar
  47243. #: guix-git/doc/guix.texi:31893
  47244. msgid "Service type for the Guix Data Service. Its value must be a @code{guix-data-service-configuration} object. The service optionally extends the getmail service, as the guix-commits mailing list is used to find out about changes in the Guix git repository."
  47245. msgstr ""
  47246. #. type: deftp
  47247. #: guix-git/doc/guix.texi:31895
  47248. #, no-wrap
  47249. msgid "{Data Type} guix-data-service-configuration"
  47250. msgstr ""
  47251. #. type: deftp
  47252. #: guix-git/doc/guix.texi:31897
  47253. msgid "Data type representing the configuration of the Guix Data Service."
  47254. msgstr ""
  47255. #. type: item
  47256. #: guix-git/doc/guix.texi:31899
  47257. #, no-wrap
  47258. msgid "@code{package} (default: @code{guix-data-service})"
  47259. msgstr ""
  47260. #. type: table
  47261. #: guix-git/doc/guix.texi:31901
  47262. msgid "The Guix Data Service package to use."
  47263. msgstr ""
  47264. #. type: item
  47265. #: guix-git/doc/guix.texi:31902
  47266. #, no-wrap
  47267. msgid "@code{user} (default: @code{\"guix-data-service\"})"
  47268. msgstr ""
  47269. #. type: item
  47270. #: guix-git/doc/guix.texi:31905
  47271. #, no-wrap
  47272. msgid "@code{group} (default: @code{\"guix-data-service\"})"
  47273. msgstr ""
  47274. #. type: item
  47275. #: guix-git/doc/guix.texi:31908
  47276. #, no-wrap
  47277. msgid "@code{port} (default: @code{8765})"
  47278. msgstr ""
  47279. #. type: table
  47280. #: guix-git/doc/guix.texi:31910
  47281. msgid "The port to bind the web service to."
  47282. msgstr ""
  47283. #. type: item
  47284. #: guix-git/doc/guix.texi:31911
  47285. #, no-wrap
  47286. msgid "@code{host} (default: @code{\"127.0.0.1\"})"
  47287. msgstr ""
  47288. #. type: table
  47289. #: guix-git/doc/guix.texi:31913
  47290. msgid "The host to bind the web service to."
  47291. msgstr ""
  47292. #. type: item
  47293. #: guix-git/doc/guix.texi:31914
  47294. #, no-wrap
  47295. msgid "@code{getmail-idle-mailboxes} (default: @code{#f})"
  47296. msgstr ""
  47297. #. type: table
  47298. #: guix-git/doc/guix.texi:31917
  47299. msgid "If set, this is the list of mailboxes that the getmail service will be configured to listen to."
  47300. msgstr ""
  47301. #. type: item
  47302. #: guix-git/doc/guix.texi:31918
  47303. #, no-wrap
  47304. msgid "@code{commits-getmail-retriever-configuration} (default: @code{#f})"
  47305. msgstr ""
  47306. #. type: table
  47307. #: guix-git/doc/guix.texi:31922
  47308. msgid "If set, this is the @code{getmail-retriever-configuration} object with which to configure getmail to fetch mail from the guix-commits mailing list."
  47309. msgstr ""
  47310. #. type: item
  47311. #: guix-git/doc/guix.texi:31923
  47312. #, no-wrap
  47313. msgid "@code{extra-options} (default: @var{'()})"
  47314. msgstr ""
  47315. #. type: table
  47316. #: guix-git/doc/guix.texi:31925
  47317. msgid "Extra command line options for @code{guix-data-service}."
  47318. msgstr ""
  47319. #. type: item
  47320. #: guix-git/doc/guix.texi:31926
  47321. #, no-wrap
  47322. msgid "@code{extra-process-jobs-options} (default: @var{'()})"
  47323. msgstr ""
  47324. #. type: table
  47325. #: guix-git/doc/guix.texi:31928
  47326. msgid "Extra command line options for @code{guix-data-service-process-jobs}."
  47327. msgstr ""
  47328. #. type: cindex
  47329. #: guix-git/doc/guix.texi:31935
  47330. #, no-wrap
  47331. msgid "oom"
  47332. msgstr ""
  47333. #. type: cindex
  47334. #: guix-git/doc/guix.texi:31936
  47335. #, no-wrap
  47336. msgid "out of memory killer"
  47337. msgstr ""
  47338. #. type: cindex
  47339. #: guix-git/doc/guix.texi:31937
  47340. #, no-wrap
  47341. msgid "earlyoom"
  47342. msgstr ""
  47343. #. type: cindex
  47344. #: guix-git/doc/guix.texi:31938
  47345. #, no-wrap
  47346. msgid "early out of memory daemon"
  47347. msgstr ""
  47348. #. type: subsubheading
  47349. #: guix-git/doc/guix.texi:31939
  47350. #, no-wrap
  47351. msgid "Early OOM Service"
  47352. msgstr ""
  47353. #. type: Plain text
  47354. #: guix-git/doc/guix.texi:31946
  47355. msgid "@uref{https://github.com/rfjakob/earlyoom,Early OOM}, also known as Earlyoom, is a minimalist out of memory (OOM) daemon that runs in user space and provides a more responsive and configurable alternative to the in-kernel OOM killer. It is useful to prevent the system from becoming unresponsive when it runs out of memory."
  47356. msgstr ""
  47357. #. type: deffn
  47358. #: guix-git/doc/guix.texi:31947
  47359. #, no-wrap
  47360. msgid "{Scheme Variable} earlyoom-service-type"
  47361. msgstr ""
  47362. #. type: deffn
  47363. #: guix-git/doc/guix.texi:31952
  47364. msgid "The service type for running @command{earlyoom}, the Early OOM daemon. Its value must be a @code{earlyoom-configuration} object, described below. The service can be instantiated in its default configuration with:"
  47365. msgstr ""
  47366. #. type: lisp
  47367. #: guix-git/doc/guix.texi:31955
  47368. #, no-wrap
  47369. msgid "(service earlyoom-service-type)\n"
  47370. msgstr ""
  47371. #. type: deftp
  47372. #: guix-git/doc/guix.texi:31958
  47373. #, no-wrap
  47374. msgid "{Data Type} earlyoom-configuration"
  47375. msgstr ""
  47376. #. type: deftp
  47377. #: guix-git/doc/guix.texi:31960
  47378. msgid "This is the configuration record for the @code{earlyoom-service-type}."
  47379. msgstr ""
  47380. #. type: item
  47381. #: guix-git/doc/guix.texi:31962
  47382. #, no-wrap
  47383. msgid "@code{earlyoom} (default: @var{earlyoom})"
  47384. msgstr ""
  47385. #. type: table
  47386. #: guix-git/doc/guix.texi:31964
  47387. msgid "The Earlyoom package to use."
  47388. msgstr ""
  47389. #. type: item
  47390. #: guix-git/doc/guix.texi:31965
  47391. #, no-wrap
  47392. msgid "@code{minimum-available-memory} (default: @code{10})"
  47393. msgstr ""
  47394. #. type: table
  47395. #: guix-git/doc/guix.texi:31967
  47396. msgid "The threshold for the minimum @emph{available} memory, in percentages."
  47397. msgstr ""
  47398. #. type: item
  47399. #: guix-git/doc/guix.texi:31968
  47400. #, no-wrap
  47401. msgid "@code{minimum-free-swap} (default: @code{10})"
  47402. msgstr ""
  47403. #. type: table
  47404. #: guix-git/doc/guix.texi:31970
  47405. msgid "The threshold for the minimum free swap memory, in percentages."
  47406. msgstr ""
  47407. #. type: item
  47408. #: guix-git/doc/guix.texi:31971
  47409. #, no-wrap
  47410. msgid "@code{prefer-regexp} (default: @code{#f})"
  47411. msgstr ""
  47412. #. type: table
  47413. #: guix-git/doc/guix.texi:31974
  47414. msgid "A regular expression (as a string) to match the names of the processes that should be preferably killed."
  47415. msgstr ""
  47416. #. type: item
  47417. #: guix-git/doc/guix.texi:31975
  47418. #, no-wrap
  47419. msgid "@code{avoid-regexp} (default: @code{#f})"
  47420. msgstr ""
  47421. #. type: table
  47422. #: guix-git/doc/guix.texi:31978
  47423. msgid "A regular expression (as a string) to match the names of the processes that should @emph{not} be killed."
  47424. msgstr ""
  47425. #. type: item
  47426. #: guix-git/doc/guix.texi:31979
  47427. #, no-wrap
  47428. msgid "@code{memory-report-interval} (default: @code{0})"
  47429. msgstr ""
  47430. #. type: table
  47431. #: guix-git/doc/guix.texi:31982
  47432. msgid "The interval in seconds at which a memory report is printed. It is disabled by default."
  47433. msgstr ""
  47434. #. type: item
  47435. #: guix-git/doc/guix.texi:31983
  47436. #, no-wrap
  47437. msgid "@code{ignore-positive-oom-score-adj?} (default: @code{#f})"
  47438. msgstr ""
  47439. #. type: table
  47440. #: guix-git/doc/guix.texi:31986
  47441. msgid "A boolean indicating whether the positive adjustments set in @file{/proc/*/oom_score_adj} should be ignored."
  47442. msgstr ""
  47443. #. type: item
  47444. #: guix-git/doc/guix.texi:31987
  47445. #, no-wrap
  47446. msgid "@code{show-debug-messages?} (default: @code{#f})"
  47447. msgstr ""
  47448. #. type: table
  47449. #: guix-git/doc/guix.texi:31990
  47450. msgid "A boolean indicating whether debug messages should be printed. The logs are saved at @file{/var/log/earlyoom.log}."
  47451. msgstr ""
  47452. #. type: item
  47453. #: guix-git/doc/guix.texi:31991
  47454. #, no-wrap
  47455. msgid "@code{send-notification-command} (default: @code{#f})"
  47456. msgstr ""
  47457. #. type: table
  47458. #: guix-git/doc/guix.texi:31994
  47459. msgid "This can be used to provide a custom command used for sending notifications."
  47460. msgstr ""
  47461. #. type: cindex
  47462. #: guix-git/doc/guix.texi:31997
  47463. #, no-wrap
  47464. msgid "modprobe"
  47465. msgstr ""
  47466. #. type: cindex
  47467. #: guix-git/doc/guix.texi:31998
  47468. #, no-wrap
  47469. msgid "kernel module loader"
  47470. msgstr ""
  47471. #. type: subsubheading
  47472. #: guix-git/doc/guix.texi:31999
  47473. #, no-wrap
  47474. msgid "Kernel Module Loader Service"
  47475. msgstr ""
  47476. #. type: Plain text
  47477. #: guix-git/doc/guix.texi:32005
  47478. msgid "The kernel module loader service allows one to load loadable kernel modules at boot. This is especially useful for modules that don't autoload and need to be manually loaded, as is the case with @code{ddcci}."
  47479. msgstr ""
  47480. #. type: deffn
  47481. #: guix-git/doc/guix.texi:32006
  47482. #, no-wrap
  47483. msgid "{Scheme Variable} kernel-module-loader-service-type"
  47484. msgstr ""
  47485. #. type: deffn
  47486. #: guix-git/doc/guix.texi:32012
  47487. msgid "The service type for loading loadable kernel modules at boot with @command{modprobe}. Its value must be a list of strings representing module names. For example loading the drivers provided by @code{ddcci-driver-linux}, in debugging mode by passing some module parameters, can be done as follow:"
  47488. msgstr ""
  47489. #. type: lisp
  47490. #: guix-git/doc/guix.texi:32017
  47491. #, no-wrap
  47492. msgid ""
  47493. "(use-modules (gnu) (gnu services))\n"
  47494. "(use-package-modules linux)\n"
  47495. "(use-service-modules linux)\n"
  47496. "\n"
  47497. msgstr ""
  47498. #. type: lisp
  47499. #: guix-git/doc/guix.texi:32021
  47500. #, no-wrap
  47501. msgid ""
  47502. "(define ddcci-config\n"
  47503. " (plain-file \"ddcci.conf\"\n"
  47504. " \"options ddcci dyndbg delay=120\"))\n"
  47505. "\n"
  47506. msgstr ""
  47507. #. type: lisp
  47508. #: guix-git/doc/guix.texi:32031
  47509. #, no-wrap
  47510. msgid ""
  47511. "(operating-system\n"
  47512. " ...\n"
  47513. " (services (cons* (service kernel-module-loader-service-type\n"
  47514. " '(\"ddcci\" \"ddcci_backlight\"))\n"
  47515. " (simple-service 'ddcci-config etc-service-type\n"
  47516. " (list `(\"modprobe.d/ddcci.conf\"\n"
  47517. " ,ddcci-config)))\n"
  47518. " %base-services))\n"
  47519. " (kernel-loadable-modules (list ddcci-driver-linux)))\n"
  47520. msgstr ""
  47521. #. type: cindex
  47522. #: guix-git/doc/guix.texi:32034
  47523. #, no-wrap
  47524. msgid "rasdaemon"
  47525. msgstr ""
  47526. #. type: cindex
  47527. #: guix-git/doc/guix.texi:32035
  47528. #, no-wrap
  47529. msgid "Platform Reliability, Availability and Serviceability daemon"
  47530. msgstr ""
  47531. #. type: subsubheading
  47532. #: guix-git/doc/guix.texi:32036
  47533. #, no-wrap
  47534. msgid "Rasdaemon Service"
  47535. msgstr ""
  47536. #. type: Plain text
  47537. #: guix-git/doc/guix.texi:32041
  47538. msgid "The Rasdaemon service provides a daemon which monitors platform @acronym{RAS, Reliability@comma{} Availability@comma{} and Serviceability} reports from Linux kernel trace events, logging them to syslogd."
  47539. msgstr ""
  47540. #. type: Plain text
  47541. #: guix-git/doc/guix.texi:32044
  47542. msgid "Reliability, Availability and Serviceability is a concept used on servers meant to measure their robustness."
  47543. msgstr ""
  47544. #. type: Plain text
  47545. #: guix-git/doc/guix.texi:32047
  47546. msgid "@strong{Relability} is the probability that a system will produce correct outputs:"
  47547. msgstr ""
  47548. #. type: item
  47549. #: guix-git/doc/guix.texi:32049
  47550. #, no-wrap
  47551. msgid "Generally measured as Mean Time Between Failures (MTBF), and"
  47552. msgstr ""
  47553. #. type: item
  47554. #: guix-git/doc/guix.texi:32050
  47555. #, no-wrap
  47556. msgid "Enhanced by features that help to avoid, detect and repair hardware"
  47557. msgstr ""
  47558. #. type: itemize
  47559. #: guix-git/doc/guix.texi:32052
  47560. msgid "faults"
  47561. msgstr ""
  47562. #. type: Plain text
  47563. #: guix-git/doc/guix.texi:32056
  47564. msgid "@strong{Availability} is the probability that a system is operational at a given time:"
  47565. msgstr ""
  47566. #. type: item
  47567. #: guix-git/doc/guix.texi:32058
  47568. #, no-wrap
  47569. msgid "Generally measured as a percentage of downtime per a period of time, and"
  47570. msgstr ""
  47571. #. type: item
  47572. #: guix-git/doc/guix.texi:32059
  47573. #, no-wrap
  47574. msgid "Often uses mechanisms to detect and correct hardware faults in runtime."
  47575. msgstr ""
  47576. #. type: Plain text
  47577. #: guix-git/doc/guix.texi:32064
  47578. msgid "@strong{Serviceability} is the simplicity and speed with which a system can be repaired or maintained:"
  47579. msgstr ""
  47580. #. type: item
  47581. #: guix-git/doc/guix.texi:32066
  47582. #, no-wrap
  47583. msgid "Generally measured on Mean Time Between Repair (MTBR)."
  47584. msgstr ""
  47585. #. type: Plain text
  47586. #: guix-git/doc/guix.texi:32071
  47587. msgid "Among the monitoring measures, the most usual ones include:"
  47588. msgstr ""
  47589. #. type: item
  47590. #: guix-git/doc/guix.texi:32073
  47591. #, no-wrap
  47592. msgid "CPU – detect errors at instruction execution and at L1/L2/L3 caches;"
  47593. msgstr ""
  47594. #. type: item
  47595. #: guix-git/doc/guix.texi:32074
  47596. #, no-wrap
  47597. msgid "Memory – add error correction logic (ECC) to detect and correct errors;"
  47598. msgstr ""
  47599. #. type: item
  47600. #: guix-git/doc/guix.texi:32075
  47601. #, no-wrap
  47602. msgid "I/O – add CRC checksums for transferred data;"
  47603. msgstr ""
  47604. #. type: item
  47605. #: guix-git/doc/guix.texi:32076
  47606. #, no-wrap
  47607. msgid "Storage – RAID, journal file systems, checksums, Self-Monitoring,"
  47608. msgstr ""
  47609. #. type: itemize
  47610. #: guix-git/doc/guix.texi:32078
  47611. msgid "Analysis and Reporting Technology (SMART)."
  47612. msgstr ""
  47613. #. type: Plain text
  47614. #: guix-git/doc/guix.texi:32084
  47615. msgid "By monitoring the number of occurrences of error detections, it is possible to identify if the probability of hardware errors is increasing, and, on such case, do a preventive maintenance to replace a degraded component while those errors are correctable."
  47616. msgstr ""
  47617. #. type: Plain text
  47618. #: guix-git/doc/guix.texi:32088
  47619. msgid "For detailed information about the types of error events gathered and how to make sense of them, see the kernel administrator's guide at @url{https://www.kernel.org/doc/html/latest/admin-guide/ras.html}."
  47620. msgstr ""
  47621. #. type: defvr
  47622. #: guix-git/doc/guix.texi:32089
  47623. #, no-wrap
  47624. msgid "{Scheme Variable} rasdaemon-service-type"
  47625. msgstr ""
  47626. #. type: defvr
  47627. #: guix-git/doc/guix.texi:32092
  47628. msgid "Service type for the @command{rasdaemon} service. It accepts a @code{rasdaemon-configuration} object. Instantiating like"
  47629. msgstr ""
  47630. #. type: lisp
  47631. #: guix-git/doc/guix.texi:32095
  47632. #, no-wrap
  47633. msgid "(service rasdaemon-service-type)\n"
  47634. msgstr ""
  47635. #. type: defvr
  47636. #: guix-git/doc/guix.texi:32099
  47637. msgid "will load with a default configuration, which monitors all events and logs to syslogd."
  47638. msgstr ""
  47639. #. type: deftp
  47640. #: guix-git/doc/guix.texi:32101
  47641. #, no-wrap
  47642. msgid "{Data Type} rasdaemon-configuration"
  47643. msgstr ""
  47644. #. type: deftp
  47645. #: guix-git/doc/guix.texi:32103
  47646. msgid "The data type representing the configuration of @command{rasdaemon}."
  47647. msgstr ""
  47648. #. type: item
  47649. #: guix-git/doc/guix.texi:32105
  47650. #, no-wrap
  47651. msgid "@code{record?} (default: @code{#f})"
  47652. msgstr ""
  47653. #. type: table
  47654. #: guix-git/doc/guix.texi:32110
  47655. msgid "A boolean indicating whether to record the events in an SQLite database. This provides a more structured access to the information contained in the log file. The database location is hard-coded to @file{/var/lib/rasdaemon/ras-mc_event.db}."
  47656. msgstr ""
  47657. #. type: cindex
  47658. #: guix-git/doc/guix.texi:32114
  47659. #, no-wrap
  47660. msgid "zram"
  47661. msgstr ""
  47662. #. type: cindex
  47663. #: guix-git/doc/guix.texi:32115
  47664. #, no-wrap
  47665. msgid "compressed swap"
  47666. msgstr ""
  47667. #. type: cindex
  47668. #: guix-git/doc/guix.texi:32116
  47669. #, no-wrap
  47670. msgid "Compressed RAM-based block devices"
  47671. msgstr ""
  47672. #. type: subsubheading
  47673. #: guix-git/doc/guix.texi:32117
  47674. #, no-wrap
  47675. msgid "Zram Device Service"
  47676. msgstr ""
  47677. #. type: Plain text
  47678. #: guix-git/doc/guix.texi:32123
  47679. msgid "The Zram device service provides a compressed swap device in system memory. The Linux Kernel documentation has more information about @uref{https://www.kernel.org/doc/html/latest/admin-guide/blockdev/zram.html,zram} devices."
  47680. msgstr ""
  47681. #. type: deffn
  47682. #: guix-git/doc/guix.texi:32124
  47683. #, no-wrap
  47684. msgid "{Scheme Variable} zram-device-service-type"
  47685. msgstr ""
  47686. #. type: deffn
  47687. #: guix-git/doc/guix.texi:32128
  47688. msgid "This service creates the zram block device, formats it as swap and enables it as a swap device. The service's value is a @code{zram-device-configuration} record."
  47689. msgstr ""
  47690. #. type: deftp
  47691. #: guix-git/doc/guix.texi:32129
  47692. #, no-wrap
  47693. msgid "{Data Type} zram-device-configuration"
  47694. msgstr ""
  47695. #. type: deftp
  47696. #: guix-git/doc/guix.texi:32132
  47697. msgid "This is the data type representing the configuration for the zram-device service."
  47698. msgstr ""
  47699. #. type: item
  47700. #: guix-git/doc/guix.texi:32134
  47701. #, no-wrap
  47702. msgid "@code{size} (default @code{\"1G\"})"
  47703. msgstr ""
  47704. #. type: table
  47705. #: guix-git/doc/guix.texi:32138
  47706. msgid "This is the amount of space you wish to provide for the zram device. It accepts a string and can be a number of bytes or use a suffix, eg.: @code{\"512M\"} or @code{1024000}."
  47707. msgstr ""
  47708. #. type: item
  47709. #: guix-git/doc/guix.texi:32138
  47710. #, no-wrap
  47711. msgid "@code{compression-algorithm} (default @code{'lzo})"
  47712. msgstr ""
  47713. #. type: table
  47714. #: guix-git/doc/guix.texi:32142
  47715. msgid "This is the compression algorithm you wish to use. It is difficult to list all the possible compression options, but common ones supported by Guix's Linux Libre Kernel include @code{'lzo}, @code{'lz4} and @code{'zstd}."
  47716. msgstr ""
  47717. #. type: item
  47718. #: guix-git/doc/guix.texi:32142
  47719. #, no-wrap
  47720. msgid "@code{memory-limit} (default @code{0})"
  47721. msgstr ""
  47722. #. type: table
  47723. #: guix-git/doc/guix.texi:32149
  47724. msgid "This is the maximum amount of memory which the zram device can use. Setting it to '0' disables the limit. While it is generally expected that compression will be 2:1, it is possible that uncompressable data can be written to swap and this is a method to limit how much memory can be used. It accepts a string and can be a number of bytes or use a suffix, eg.: @code{\"2G\"}."
  47725. msgstr ""
  47726. #. type: item
  47727. #: guix-git/doc/guix.texi:32149
  47728. #, no-wrap
  47729. msgid "@code{priority} (default @code{-1})"
  47730. msgstr ""
  47731. #. type: table
  47732. #: guix-git/doc/guix.texi:32154
  47733. msgid "This is the priority of the swap device created from the zram device. @code{swapon} accepts values between -1 and 32767, with higher values indicating higher priority. Higher priority swap will generally be used first."
  47734. msgstr ""
  47735. #. type: defvr
  47736. #: guix-git/doc/guix.texi:32162
  47737. #, no-wrap
  47738. msgid "{Scheme Variable} hurd-console-service-type"
  47739. msgstr ""
  47740. #. type: defvr
  47741. #: guix-git/doc/guix.texi:32164
  47742. msgid "This service starts the fancy @code{VGA} console client on the Hurd."
  47743. msgstr ""
  47744. #. type: defvr
  47745. #: guix-git/doc/guix.texi:32166
  47746. msgid "The service's value is a @code{hurd-console-configuration} record."
  47747. msgstr ""
  47748. #. type: deftp
  47749. #: guix-git/doc/guix.texi:32168
  47750. #, no-wrap
  47751. msgid "{Data Type} hurd-console-configuration"
  47752. msgstr ""
  47753. #. type: deftp
  47754. #: guix-git/doc/guix.texi:32171
  47755. msgid "This is the data type representing the configuration for the hurd-console-service."
  47756. msgstr ""
  47757. #. type: item
  47758. #: guix-git/doc/guix.texi:32173 guix-git/doc/guix.texi:32189
  47759. #, no-wrap
  47760. msgid "@code{hurd} (default: @var{hurd})"
  47761. msgstr ""
  47762. #. type: table
  47763. #: guix-git/doc/guix.texi:32175 guix-git/doc/guix.texi:32191
  47764. msgid "The Hurd package to use."
  47765. msgstr ""
  47766. #. type: defvr
  47767. #: guix-git/doc/guix.texi:32178
  47768. #, no-wrap
  47769. msgid "{Scheme Variable} hurd-getty-service-type"
  47770. msgstr ""
  47771. #. type: defvr
  47772. #: guix-git/doc/guix.texi:32180
  47773. msgid "This service starts a tty using the Hurd @code{getty} program."
  47774. msgstr ""
  47775. #. type: defvr
  47776. #: guix-git/doc/guix.texi:32182
  47777. msgid "The service's value is a @code{hurd-getty-configuration} record."
  47778. msgstr ""
  47779. #. type: deftp
  47780. #: guix-git/doc/guix.texi:32184
  47781. #, no-wrap
  47782. msgid "{Data Type} hurd-getty-configuration"
  47783. msgstr ""
  47784. #. type: deftp
  47785. #: guix-git/doc/guix.texi:32187
  47786. msgid "This is the data type representing the configuration for the hurd-getty-service."
  47787. msgstr ""
  47788. #. type: table
  47789. #: guix-git/doc/guix.texi:32194
  47790. msgid "The name of the console this Getty runs on---e.g., @code{\"tty1\"}."
  47791. msgstr ""
  47792. #. type: item
  47793. #: guix-git/doc/guix.texi:32195
  47794. #, no-wrap
  47795. msgid "@code{baud-rate} (default: @code{38400})"
  47796. msgstr ""
  47797. #. type: table
  47798. #: guix-git/doc/guix.texi:32197
  47799. msgid "An integer specifying the baud rate of the tty."
  47800. msgstr ""
  47801. #. type: cindex
  47802. #: guix-git/doc/guix.texi:32204
  47803. #, no-wrap
  47804. msgid "fingerprint"
  47805. msgstr ""
  47806. #. type: subsubheading
  47807. #: guix-git/doc/guix.texi:32205
  47808. #, no-wrap
  47809. msgid "Fingerprint Service"
  47810. msgstr ""
  47811. #. type: Plain text
  47812. #: guix-git/doc/guix.texi:32209
  47813. msgid "The @code{(gnu services authentication)} module provides a DBus service to read and identify fingerprints via a fingerprint sensor."
  47814. msgstr ""
  47815. #. type: defvr
  47816. #: guix-git/doc/guix.texi:32210
  47817. #, no-wrap
  47818. msgid "{Scheme Variable} fprintd-service-type"
  47819. msgstr ""
  47820. #. type: defvr
  47821. #: guix-git/doc/guix.texi:32213
  47822. msgid "The service type for @command{fprintd}, which provides the fingerprint reading capability."
  47823. msgstr ""
  47824. #. type: lisp
  47825. #: guix-git/doc/guix.texi:32216
  47826. #, no-wrap
  47827. msgid "(service fprintd-service-type)\n"
  47828. msgstr ""
  47829. #. type: cindex
  47830. #: guix-git/doc/guix.texi:32219
  47831. #, no-wrap
  47832. msgid "sysctl"
  47833. msgstr ""
  47834. #. type: subsubheading
  47835. #: guix-git/doc/guix.texi:32220
  47836. #, no-wrap
  47837. msgid "System Control Service"
  47838. msgstr ""
  47839. #. type: Plain text
  47840. #: guix-git/doc/guix.texi:32224
  47841. msgid "The @code{(gnu services sysctl)} provides a service to configure kernel parameters at boot."
  47842. msgstr ""
  47843. #. type: defvr
  47844. #: guix-git/doc/guix.texi:32225
  47845. #, no-wrap
  47846. msgid "{Scheme Variable} sysctl-service-type"
  47847. msgstr ""
  47848. #. type: defvr
  47849. #: guix-git/doc/guix.texi:32229
  47850. msgid "The service type for @command{sysctl}, which modifies kernel parameters under @file{/proc/sys/}. To enable IPv4 forwarding, it can be instantiated as:"
  47851. msgstr ""
  47852. #. type: lisp
  47853. #: guix-git/doc/guix.texi:32234
  47854. #, no-wrap
  47855. msgid ""
  47856. "(service sysctl-service-type\n"
  47857. " (sysctl-configuration\n"
  47858. " (settings '((\"net.ipv4.ip_forward\" . \"1\")))))\n"
  47859. msgstr ""
  47860. #. type: defvr
  47861. #: guix-git/doc/guix.texi:32241
  47862. msgid "Since @code{sysctl-service-type} is used in the default lists of services, @code{%base-services} and @code{%desktop-services}, you can use @code{modify-services} to change its configuration and add the kernel parameters that you want (@pxref{Service Reference, @code{modify-services}})."
  47863. msgstr ""
  47864. #. type: lisp
  47865. #: guix-git/doc/guix.texi:32248
  47866. #, no-wrap
  47867. msgid ""
  47868. "(modify-services %base-services\n"
  47869. " (sysctl-service-type config =>\n"
  47870. " (sysctl-configuration\n"
  47871. " (settings (append '((\"net.ipv4.ip_forward\" . \"1\"))\n"
  47872. " %default-sysctl-settings)))))\n"
  47873. msgstr ""
  47874. #. type: deftp
  47875. #: guix-git/doc/guix.texi:32252
  47876. #, no-wrap
  47877. msgid "{Data Type} sysctl-configuration"
  47878. msgstr ""
  47879. #. type: deftp
  47880. #: guix-git/doc/guix.texi:32254
  47881. msgid "The data type representing the configuration of @command{sysctl}."
  47882. msgstr ""
  47883. #. type: item
  47884. #: guix-git/doc/guix.texi:32256
  47885. #, no-wrap
  47886. msgid "@code{sysctl} (default: @code{(file-append procps \"/sbin/sysctl\"})"
  47887. msgstr ""
  47888. #. type: table
  47889. #: guix-git/doc/guix.texi:32258
  47890. msgid "The @command{sysctl} executable to use."
  47891. msgstr ""
  47892. #. type: item
  47893. #: guix-git/doc/guix.texi:32259
  47894. #, no-wrap
  47895. msgid "@code{settings} (default: @code{%default-sysctl-settings})"
  47896. msgstr ""
  47897. #. type: table
  47898. #: guix-git/doc/guix.texi:32261
  47899. msgid "An association list specifies kernel parameters and their values."
  47900. msgstr ""
  47901. #. type: defvr
  47902. #: guix-git/doc/guix.texi:32264
  47903. #, no-wrap
  47904. msgid "{Scheme Variable} %default-sysctl-settings"
  47905. msgstr ""
  47906. #. type: defvr
  47907. #: guix-git/doc/guix.texi:32267
  47908. msgid "An association list specifying the default @command{sysctl} parameters on Guix System."
  47909. msgstr ""
  47910. #. type: cindex
  47911. #: guix-git/doc/guix.texi:32269
  47912. #, no-wrap
  47913. msgid "pcscd"
  47914. msgstr ""
  47915. #. type: subsubheading
  47916. #: guix-git/doc/guix.texi:32270
  47917. #, no-wrap
  47918. msgid "PC/SC Smart Card Daemon Service"
  47919. msgstr ""
  47920. #. type: Plain text
  47921. #: guix-git/doc/guix.texi:32277
  47922. msgid "The @code{(gnu services security-token)} module provides the following service to run @command{pcscd}, the PC/SC Smart Card Daemon. @command{pcscd} is the daemon program for pcsc-lite and the MuscleCard framework. It is a resource manager that coordinates communications with smart card readers, smart cards and cryptographic tokens that are connected to the system."
  47923. msgstr ""
  47924. #. type: defvr
  47925. #: guix-git/doc/guix.texi:32278
  47926. #, no-wrap
  47927. msgid "{Scheme Variable} pcscd-service-type"
  47928. msgstr ""
  47929. #. type: defvr
  47930. #: guix-git/doc/guix.texi:32282
  47931. msgid "Service type for the @command{pcscd} service. Its value must be a @code{pcscd-configuration} object. To run pcscd in the default configuration, instantiate it as:"
  47932. msgstr ""
  47933. #. type: lisp
  47934. #: guix-git/doc/guix.texi:32285
  47935. #, no-wrap
  47936. msgid "(service pcscd-service-type)\n"
  47937. msgstr ""
  47938. #. type: deftp
  47939. #: guix-git/doc/guix.texi:32288
  47940. #, no-wrap
  47941. msgid "{Data Type} pcscd-configuration"
  47942. msgstr ""
  47943. #. type: deftp
  47944. #: guix-git/doc/guix.texi:32290
  47945. msgid "The data type representing the configuration of @command{pcscd}."
  47946. msgstr ""
  47947. #. type: item
  47948. #: guix-git/doc/guix.texi:32292
  47949. #, no-wrap
  47950. msgid "@code{pcsc-lite} (default: @code{pcsc-lite})"
  47951. msgstr ""
  47952. #. type: table
  47953. #: guix-git/doc/guix.texi:32294
  47954. msgid "The pcsc-lite package that provides pcscd."
  47955. msgstr ""
  47956. #. type: item
  47957. #: guix-git/doc/guix.texi:32294
  47958. #, no-wrap
  47959. msgid "@code{usb-drivers} (default: @code{(list ccid)})"
  47960. msgstr ""
  47961. #. type: table
  47962. #: guix-git/doc/guix.texi:32297
  47963. msgid "List of packages that provide USB drivers to pcscd. Drivers are expected to be under @file{pcsc/drivers} in the store directory of the package."
  47964. msgstr ""
  47965. #. type: cindex
  47966. #: guix-git/doc/guix.texi:32300
  47967. #, no-wrap
  47968. msgid "lirc"
  47969. msgstr ""
  47970. #. type: subsubheading
  47971. #: guix-git/doc/guix.texi:32301
  47972. #, no-wrap
  47973. msgid "Lirc Service"
  47974. msgstr ""
  47975. #. type: Plain text
  47976. #: guix-git/doc/guix.texi:32304
  47977. msgid "The @code{(gnu services lirc)} module provides the following service."
  47978. msgstr ""
  47979. #. type: deffn
  47980. #: guix-git/doc/guix.texi:32305
  47981. #, no-wrap
  47982. msgid "{Scheme Procedure} lirc-service [#:lirc lirc] @"
  47983. msgstr ""
  47984. #. type: deffn
  47985. #: guix-git/doc/guix.texi:32310
  47986. msgid "[#:device #f] [#:driver #f] [#:config-file #f] @ [#:extra-options '()] Return a service that runs @url{http://www.lirc.org,LIRC}, a daemon that decodes infrared signals from remote controls."
  47987. msgstr ""
  47988. #. type: deffn
  47989. #: guix-git/doc/guix.texi:32314
  47990. msgid "Optionally, @var{device}, @var{driver} and @var{config-file} (configuration file name) may be specified. See @command{lircd} manual for details."
  47991. msgstr ""
  47992. #. type: deffn
  47993. #: guix-git/doc/guix.texi:32317
  47994. msgid "Finally, @var{extra-options} is a list of additional command-line options passed to @command{lircd}."
  47995. msgstr ""
  47996. #. type: cindex
  47997. #: guix-git/doc/guix.texi:32319
  47998. #, no-wrap
  47999. msgid "spice"
  48000. msgstr ""
  48001. #. type: subsubheading
  48002. #: guix-git/doc/guix.texi:32320
  48003. #, no-wrap
  48004. msgid "Spice Service"
  48005. msgstr ""
  48006. #. type: Plain text
  48007. #: guix-git/doc/guix.texi:32323
  48008. msgid "The @code{(gnu services spice)} module provides the following service."
  48009. msgstr ""
  48010. #. type: deffn
  48011. #: guix-git/doc/guix.texi:32324
  48012. #, no-wrap
  48013. msgid "{Scheme Procedure} spice-vdagent-service [#:spice-vdagent]"
  48014. msgstr ""
  48015. #. type: deffn
  48016. #: guix-git/doc/guix.texi:32328
  48017. msgid "Returns a service that runs @url{https://www.spice-space.org,VDAGENT}, a daemon that enables sharing the clipboard with a vm and setting the guest display resolution when the graphical console window resizes."
  48018. msgstr ""
  48019. #. type: cindex
  48020. #: guix-git/doc/guix.texi:32330
  48021. #, no-wrap
  48022. msgid "inputattach"
  48023. msgstr ""
  48024. #. type: subsubheading
  48025. #: guix-git/doc/guix.texi:32331
  48026. #, no-wrap
  48027. msgid "inputattach Service"
  48028. msgstr ""
  48029. #. type: cindex
  48030. #: guix-git/doc/guix.texi:32333
  48031. #, no-wrap
  48032. msgid "tablet input, for Xorg"
  48033. msgstr ""
  48034. #. type: cindex
  48035. #: guix-git/doc/guix.texi:32334
  48036. #, no-wrap
  48037. msgid "touchscreen input, for Xorg"
  48038. msgstr ""
  48039. #. type: Plain text
  48040. #: guix-git/doc/guix.texi:32338
  48041. msgid "The @uref{https://linuxwacom.github.io/, inputattach} service allows you to use input devices such as Wacom tablets, touchscreens, or joysticks with the Xorg display server."
  48042. msgstr ""
  48043. #. type: deffn
  48044. #: guix-git/doc/guix.texi:32339
  48045. #, no-wrap
  48046. msgid "{Scheme Variable} inputattach-service-type"
  48047. msgstr ""
  48048. #. type: deffn
  48049. #: guix-git/doc/guix.texi:32342
  48050. msgid "Type of a service that runs @command{inputattach} on a device and dispatches events from it."
  48051. msgstr ""
  48052. #. type: deftp
  48053. #: guix-git/doc/guix.texi:32344
  48054. #, no-wrap
  48055. msgid "{Data Type} inputattach-configuration"
  48056. msgstr ""
  48057. #. type: item
  48058. #: guix-git/doc/guix.texi:32346
  48059. #, no-wrap
  48060. msgid "@code{device-type} (default: @code{\"wacom\"})"
  48061. msgstr ""
  48062. #. type: table
  48063. #: guix-git/doc/guix.texi:32349
  48064. msgid "The type of device to connect to. Run @command{inputattach --help}, from the @code{inputattach} package, to see the list of supported device types."
  48065. msgstr ""
  48066. #. type: item
  48067. #: guix-git/doc/guix.texi:32350
  48068. #, no-wrap
  48069. msgid "@code{device} (default: @code{\"/dev/ttyS0\"})"
  48070. msgstr ""
  48071. #. type: table
  48072. #: guix-git/doc/guix.texi:32352
  48073. msgid "The device file to connect to the device."
  48074. msgstr ""
  48075. #. type: table
  48076. #: guix-git/doc/guix.texi:32356
  48077. msgid "Baud rate to use for the serial connection. Should be a number or @code{#f}."
  48078. msgstr ""
  48079. #. type: item
  48080. #: guix-git/doc/guix.texi:32357
  48081. #, no-wrap
  48082. msgid "@code{log-file} (default: @code{#f})"
  48083. msgstr ""
  48084. #. type: table
  48085. #: guix-git/doc/guix.texi:32359
  48086. msgid "If true, this must be the name of a file to log messages to."
  48087. msgstr ""
  48088. #. type: subsubheading
  48089. #: guix-git/doc/guix.texi:32362
  48090. #, no-wrap
  48091. msgid "Dictionary Service"
  48092. msgstr ""
  48093. #. type: cindex
  48094. #: guix-git/doc/guix.texi:32363
  48095. #, no-wrap
  48096. msgid "dictionary"
  48097. msgstr ""
  48098. #. type: Plain text
  48099. #: guix-git/doc/guix.texi:32365
  48100. msgid "The @code{(gnu services dict)} module provides the following service:"
  48101. msgstr ""
  48102. #. type: defvr
  48103. #: guix-git/doc/guix.texi:32366
  48104. #, no-wrap
  48105. msgid "{Scheme Variable} dicod-service-type"
  48106. msgstr ""
  48107. #. type: defvr
  48108. #: guix-git/doc/guix.texi:32369
  48109. msgid "This is the type of the service that runs the @command{dicod} daemon, an implementation of DICT server (@pxref{Dicod,,, dico, GNU Dico Manual})."
  48110. msgstr ""
  48111. #. type: deffn
  48112. #: guix-git/doc/guix.texi:32371
  48113. #, no-wrap
  48114. msgid "{Scheme Procedure} dicod-service [#:config (dicod-configuration)]"
  48115. msgstr ""
  48116. #. type: deffn
  48117. #: guix-git/doc/guix.texi:32374
  48118. msgid "Return a service that runs the @command{dicod} daemon, an implementation of DICT server (@pxref{Dicod,,, dico, GNU Dico Manual})."
  48119. msgstr ""
  48120. #. type: deffn
  48121. #: guix-git/doc/guix.texi:32378
  48122. msgid "The optional @var{config} argument specifies the configuration for @command{dicod}, which should be a @code{<dicod-configuration>} object, by default it serves the GNU Collaborative International Dictionary of English."
  48123. msgstr ""
  48124. #. type: deffn
  48125. #: guix-git/doc/guix.texi:32382
  48126. msgid "You can add @command{open localhost} to your @file{~/.dico} file to make @code{localhost} the default server for @command{dico} client (@pxref{Initialization File,,, dico, GNU Dico Manual})."
  48127. msgstr ""
  48128. #. type: deftp
  48129. #: guix-git/doc/guix.texi:32384
  48130. #, no-wrap
  48131. msgid "{Data Type} dicod-configuration"
  48132. msgstr ""
  48133. #. type: deftp
  48134. #: guix-git/doc/guix.texi:32386
  48135. msgid "Data type representing the configuration of dicod."
  48136. msgstr ""
  48137. #. type: item
  48138. #: guix-git/doc/guix.texi:32388
  48139. #, no-wrap
  48140. msgid "@code{dico} (default: @var{dico})"
  48141. msgstr ""
  48142. #. type: table
  48143. #: guix-git/doc/guix.texi:32390
  48144. msgid "Package object of the GNU Dico dictionary server."
  48145. msgstr ""
  48146. #. type: item
  48147. #: guix-git/doc/guix.texi:32391
  48148. #, no-wrap
  48149. msgid "@code{interfaces} (default: @var{'(\"localhost\")})"
  48150. msgstr ""
  48151. #. type: table
  48152. #: guix-git/doc/guix.texi:32395
  48153. msgid "This is the list of IP addresses and ports and possibly socket file names to listen to (@pxref{Server Settings, @code{listen} directive,, dico, GNU Dico Manual})."
  48154. msgstr ""
  48155. #. type: item
  48156. #: guix-git/doc/guix.texi:32396
  48157. #, no-wrap
  48158. msgid "@code{handlers} (default: @var{'()})"
  48159. msgstr ""
  48160. #. type: table
  48161. #: guix-git/doc/guix.texi:32398
  48162. msgid "List of @code{<dicod-handler>} objects denoting handlers (module instances)."
  48163. msgstr ""
  48164. #. type: item
  48165. #: guix-git/doc/guix.texi:32399
  48166. #, no-wrap
  48167. msgid "@code{databases} (default: @var{(list %dicod-database:gcide)})"
  48168. msgstr ""
  48169. #. type: table
  48170. #: guix-git/doc/guix.texi:32401
  48171. msgid "List of @code{<dicod-database>} objects denoting dictionaries to be served."
  48172. msgstr ""
  48173. #. type: deftp
  48174. #: guix-git/doc/guix.texi:32404
  48175. #, no-wrap
  48176. msgid "{Data Type} dicod-handler"
  48177. msgstr ""
  48178. #. type: deftp
  48179. #: guix-git/doc/guix.texi:32406
  48180. msgid "Data type representing a dictionary handler (module instance)."
  48181. msgstr ""
  48182. #. type: table
  48183. #: guix-git/doc/guix.texi:32410
  48184. msgid "Name of the handler (module instance)."
  48185. msgstr ""
  48186. #. type: item
  48187. #: guix-git/doc/guix.texi:32411
  48188. #, no-wrap
  48189. msgid "@code{module} (default: @var{#f})"
  48190. msgstr ""
  48191. #. type: table
  48192. #: guix-git/doc/guix.texi:32415
  48193. msgid "Name of the dicod module of the handler (instance). If it is @code{#f}, the module has the same name as the handler. (@pxref{Modules,,, dico, GNU Dico Manual})."
  48194. msgstr ""
  48195. #. type: table
  48196. #: guix-git/doc/guix.texi:32418
  48197. msgid "List of strings or gexps representing the arguments for the module handler"
  48198. msgstr ""
  48199. #. type: deftp
  48200. #: guix-git/doc/guix.texi:32421
  48201. #, no-wrap
  48202. msgid "{Data Type} dicod-database"
  48203. msgstr ""
  48204. #. type: deftp
  48205. #: guix-git/doc/guix.texi:32423
  48206. msgid "Data type representing a dictionary database."
  48207. msgstr ""
  48208. #. type: table
  48209. #: guix-git/doc/guix.texi:32427
  48210. msgid "Name of the database, will be used in DICT commands."
  48211. msgstr ""
  48212. #. type: code{#1}
  48213. #: guix-git/doc/guix.texi:32428
  48214. #, no-wrap
  48215. msgid "handler"
  48216. msgstr ""
  48217. #. type: table
  48218. #: guix-git/doc/guix.texi:32431
  48219. msgid "Name of the dicod handler (module instance) used by this database (@pxref{Handlers,,, dico, GNU Dico Manual})."
  48220. msgstr ""
  48221. #. type: item
  48222. #: guix-git/doc/guix.texi:32432
  48223. #, no-wrap
  48224. msgid "@code{complex?} (default: @var{#f})"
  48225. msgstr ""
  48226. #. type: table
  48227. #: guix-git/doc/guix.texi:32435
  48228. msgid "Whether the database configuration complex. The complex configuration will need a corresponding @code{<dicod-handler>} object, otherwise not."
  48229. msgstr ""
  48230. #. type: table
  48231. #: guix-git/doc/guix.texi:32439
  48232. msgid "List of strings or gexps representing the arguments for the database (@pxref{Databases,,, dico, GNU Dico Manual})."
  48233. msgstr ""
  48234. #. type: defvr
  48235. #: guix-git/doc/guix.texi:32442
  48236. #, no-wrap
  48237. msgid "{Scheme Variable} %dicod-database:gcide"
  48238. msgstr ""
  48239. #. type: defvr
  48240. #: guix-git/doc/guix.texi:32445
  48241. msgid "A @code{<dicod-database>} object serving the GNU Collaborative International Dictionary of English using the @code{gcide} package."
  48242. msgstr ""
  48243. #. type: Plain text
  48244. #: guix-git/doc/guix.texi:32448
  48245. msgid "The following is an example @code{dicod-service} configuration."
  48246. msgstr ""
  48247. #. type: lisp
  48248. #: guix-git/doc/guix.texi:32463
  48249. #, no-wrap
  48250. msgid ""
  48251. "(dicod-service #:config\n"
  48252. " (dicod-configuration\n"
  48253. " (handlers (list (dicod-handler\n"
  48254. " (name \"wordnet\")\n"
  48255. " (module \"dictorg\")\n"
  48256. " (options\n"
  48257. " (list #~(string-append \"dbdir=\" #$wordnet))))))\n"
  48258. " (databases (list (dicod-database\n"
  48259. " (name \"wordnet\")\n"
  48260. " (complex? #t)\n"
  48261. " (handler \"wordnet\")\n"
  48262. " (options '(\"database=wn\")))\n"
  48263. " %dicod-database:gcide))))\n"
  48264. msgstr ""
  48265. #. type: cindex
  48266. #: guix-git/doc/guix.texi:32465
  48267. #, no-wrap
  48268. msgid "Docker"
  48269. msgstr ""
  48270. #. type: subsubheading
  48271. #: guix-git/doc/guix.texi:32466
  48272. #, no-wrap
  48273. msgid "Docker Service"
  48274. msgstr ""
  48275. #. type: Plain text
  48276. #: guix-git/doc/guix.texi:32469
  48277. msgid "The @code{(gnu services docker)} module provides the following services."
  48278. msgstr ""
  48279. #. type: defvr
  48280. #: guix-git/doc/guix.texi:32470
  48281. #, no-wrap
  48282. msgid "{Scheme Variable} docker-service-type"
  48283. msgstr ""
  48284. #. type: defvr
  48285. #: guix-git/doc/guix.texi:32475
  48286. msgid "This is the type of the service that runs @url{https://www.docker.com,Docker}, a daemon that can execute application bundles (sometimes referred to as ``containers'') in isolated environments."
  48287. msgstr ""
  48288. #. type: deftp
  48289. #: guix-git/doc/guix.texi:32478
  48290. #, no-wrap
  48291. msgid "{Data Type} docker-configuration"
  48292. msgstr ""
  48293. #. type: deftp
  48294. #: guix-git/doc/guix.texi:32480
  48295. msgid "This is the data type representing the configuration of Docker and Containerd."
  48296. msgstr ""
  48297. #. type: item
  48298. #: guix-git/doc/guix.texi:32483
  48299. #, no-wrap
  48300. msgid "@code{docker} (default: @code{docker})"
  48301. msgstr ""
  48302. #. type: table
  48303. #: guix-git/doc/guix.texi:32485
  48304. msgid "The Docker daemon package to use."
  48305. msgstr ""
  48306. #. type: item
  48307. #: guix-git/doc/guix.texi:32486
  48308. #, no-wrap
  48309. msgid "@code{docker-cli} (default: @code{docker-cli})"
  48310. msgstr ""
  48311. #. type: table
  48312. #: guix-git/doc/guix.texi:32488
  48313. msgid "The Docker client package to use."
  48314. msgstr ""
  48315. #. type: item
  48316. #: guix-git/doc/guix.texi:32489
  48317. #, no-wrap
  48318. msgid "@code{containerd} (default: @var{containerd})"
  48319. msgstr ""
  48320. #. type: table
  48321. #: guix-git/doc/guix.texi:32491
  48322. msgid "The Containerd package to use."
  48323. msgstr ""
  48324. #. type: item
  48325. #: guix-git/doc/guix.texi:32492
  48326. #, no-wrap
  48327. msgid "@code{proxy} (default @var{docker-libnetwork-cmd-proxy})"
  48328. msgstr ""
  48329. #. type: table
  48330. #: guix-git/doc/guix.texi:32494
  48331. msgid "The Docker user-land networking proxy package to use."
  48332. msgstr ""
  48333. #. type: item
  48334. #: guix-git/doc/guix.texi:32495
  48335. #, no-wrap
  48336. msgid "@code{enable-proxy?} (default @code{#t})"
  48337. msgstr ""
  48338. #. type: table
  48339. #: guix-git/doc/guix.texi:32497
  48340. msgid "Enable or disable the use of the Docker user-land networking proxy."
  48341. msgstr ""
  48342. #. type: item
  48343. #: guix-git/doc/guix.texi:32498
  48344. #, no-wrap
  48345. msgid "@code{debug?} (default @code{#f})"
  48346. msgstr ""
  48347. #. type: table
  48348. #: guix-git/doc/guix.texi:32500
  48349. msgid "Enable or disable debug output."
  48350. msgstr ""
  48351. #. type: item
  48352. #: guix-git/doc/guix.texi:32501
  48353. #, no-wrap
  48354. msgid "@code{enable-iptables?} (default @code{#t})"
  48355. msgstr ""
  48356. #. type: table
  48357. #: guix-git/doc/guix.texi:32503
  48358. msgid "Enable or disable the addition of iptables rules."
  48359. msgstr ""
  48360. #. type: cindex
  48361. #: guix-git/doc/guix.texi:32507
  48362. #, no-wrap
  48363. msgid "Singularity, container service"
  48364. msgstr ""
  48365. #. type: defvr
  48366. #: guix-git/doc/guix.texi:32508
  48367. #, no-wrap
  48368. msgid "{Scheme Variable} singularity-service-type"
  48369. msgstr ""
  48370. #. type: defvr
  48371. #: guix-git/doc/guix.texi:32513
  48372. msgid "This is the type of the service that allows you to run @url{https://www.sylabs.io/singularity/, Singularity}, a Docker-style tool to create and run application bundles (aka. ``containers''). The value for this service is the Singularity package to use."
  48373. msgstr ""
  48374. #. type: defvr
  48375. #: guix-git/doc/guix.texi:32517
  48376. msgid "The service does not install a daemon; instead, it installs helper programs as setuid-root (@pxref{Setuid Programs}) such that unprivileged users can invoke @command{singularity run} and similar commands."
  48377. msgstr ""
  48378. #. type: cindex
  48379. #: guix-git/doc/guix.texi:32519
  48380. #, no-wrap
  48381. msgid "Audit"
  48382. msgstr ""
  48383. #. type: subsubheading
  48384. #: guix-git/doc/guix.texi:32520
  48385. #, no-wrap
  48386. msgid "Auditd Service"
  48387. msgstr ""
  48388. #. type: Plain text
  48389. #: guix-git/doc/guix.texi:32523
  48390. msgid "The @code{(gnu services auditd)} module provides the following service."
  48391. msgstr ""
  48392. #. type: defvr
  48393. #: guix-git/doc/guix.texi:32524
  48394. #, no-wrap
  48395. msgid "{Scheme Variable} auditd-service-type"
  48396. msgstr ""
  48397. #. type: defvr
  48398. #: guix-git/doc/guix.texi:32529
  48399. msgid "This is the type of the service that runs @url{https://people.redhat.com/sgrubb/audit/,auditd}, a daemon that tracks security-relevant information on your system."
  48400. msgstr ""
  48401. #. type: defvr
  48402. #: guix-git/doc/guix.texi:32531
  48403. msgid "Examples of things that can be tracked:"
  48404. msgstr ""
  48405. #. type: enumerate
  48406. #: guix-git/doc/guix.texi:32535
  48407. msgid "File accesses"
  48408. msgstr ""
  48409. #. type: enumerate
  48410. #: guix-git/doc/guix.texi:32537
  48411. msgid "System calls"
  48412. msgstr ""
  48413. #. type: enumerate
  48414. #: guix-git/doc/guix.texi:32539
  48415. msgid "Invoked commands"
  48416. msgstr ""
  48417. #. type: enumerate
  48418. #: guix-git/doc/guix.texi:32541
  48419. msgid "Failed login attempts"
  48420. msgstr ""
  48421. #. type: enumerate
  48422. #: guix-git/doc/guix.texi:32543
  48423. msgid "Firewall filtering"
  48424. msgstr ""
  48425. #. type: enumerate
  48426. #: guix-git/doc/guix.texi:32545
  48427. msgid "Network access"
  48428. msgstr ""
  48429. #. type: defvr
  48430. #: guix-git/doc/guix.texi:32556
  48431. msgid "@command{auditctl} from the @code{audit} package can be used in order to add or remove events to be tracked (until the next reboot). In order to permanently track events, put the command line arguments of auditctl into a file called @code{audit.rules} in the configuration directory (see below). @command{aureport} from the @code{audit} package can be used in order to view a report of all recorded events. The audit daemon by default logs into the file @file{/var/log/audit.log}."
  48432. msgstr ""
  48433. #. type: deftp
  48434. #: guix-git/doc/guix.texi:32559
  48435. #, no-wrap
  48436. msgid "{Data Type} auditd-configuration"
  48437. msgstr ""
  48438. #. type: deftp
  48439. #: guix-git/doc/guix.texi:32561
  48440. msgid "This is the data type representing the configuration of auditd."
  48441. msgstr ""
  48442. #. type: item
  48443. #: guix-git/doc/guix.texi:32564
  48444. #, no-wrap
  48445. msgid "@code{audit} (default: @code{audit})"
  48446. msgstr ""
  48447. #. type: table
  48448. #: guix-git/doc/guix.texi:32566
  48449. msgid "The audit package to use."
  48450. msgstr ""
  48451. #. type: item
  48452. #: guix-git/doc/guix.texi:32567
  48453. #, no-wrap
  48454. msgid "@code{configuration-directory} (default: @code{%default-auditd-configuration-directory})"
  48455. msgstr ""
  48456. #. type: table
  48457. #: guix-git/doc/guix.texi:32571
  48458. msgid "The directory containing the configuration file for the audit package, which must be named @code{auditd.conf}, and optionally some audit rules to instantiate on startup."
  48459. msgstr ""
  48460. #. type: cindex
  48461. #: guix-git/doc/guix.texi:32575
  48462. #, no-wrap
  48463. msgid "rshiny"
  48464. msgstr ""
  48465. #. type: subsubheading
  48466. #: guix-git/doc/guix.texi:32576
  48467. #, no-wrap
  48468. msgid "R-Shiny service"
  48469. msgstr ""
  48470. #. type: Plain text
  48471. #: guix-git/doc/guix.texi:32579
  48472. msgid "The @code{(gnu services science)} module provides the following service."
  48473. msgstr ""
  48474. #. type: defvr
  48475. #: guix-git/doc/guix.texi:32580
  48476. #, no-wrap
  48477. msgid "{Scheme Variable} rshiny-service-type"
  48478. msgstr ""
  48479. #. type: defvr
  48480. #: guix-git/doc/guix.texi:32585
  48481. msgid "This is a type of service which is used to run a webapp created with @code{r-shiny}. This service sets the @env{R_LIBS_USER} environment variable and runs the provided script to call @code{runApp}."
  48482. msgstr ""
  48483. #. type: deftp
  48484. #: guix-git/doc/guix.texi:32586
  48485. #, no-wrap
  48486. msgid "{Data Type} rshiny-configuration"
  48487. msgstr ""
  48488. #. type: deftp
  48489. #: guix-git/doc/guix.texi:32588
  48490. msgid "This is the data type representing the configuration of rshiny."
  48491. msgstr ""
  48492. #. type: item
  48493. #: guix-git/doc/guix.texi:32591
  48494. #, no-wrap
  48495. msgid "@code{package} (default: @code{r-shiny})"
  48496. msgstr ""
  48497. #. type: table
  48498. #: guix-git/doc/guix.texi:32593
  48499. msgid "The package to use."
  48500. msgstr ""
  48501. #. type: item
  48502. #: guix-git/doc/guix.texi:32594
  48503. #, no-wrap
  48504. msgid "@code{binary} (defaunlt @code{\"rshiny\"})"
  48505. msgstr ""
  48506. #. type: table
  48507. #: guix-git/doc/guix.texi:32597
  48508. msgid "The name of the binary or shell script located at @code{package/bin/} to run when the service is run."
  48509. msgstr ""
  48510. #. type: table
  48511. #: guix-git/doc/guix.texi:32599
  48512. msgid "The common way to create this file is as follows:"
  48513. msgstr ""
  48514. #. type: lisp
  48515. #: guix-git/doc/guix.texi:32617
  48516. #, no-wrap
  48517. msgid ""
  48518. "@dots{}\n"
  48519. "(let* ((out (assoc-ref %outputs \"out\"))\n"
  48520. " (targetdir (string-append out \"/share/\" ,name))\n"
  48521. " (app (string-append out \"/bin/\" ,name))\n"
  48522. " (Rbin (string-append (assoc-ref %build-inputs \"r-min\")\n"
  48523. " \"/bin/Rscript\")))\n"
  48524. " ;; @dots{}\n"
  48525. " (mkdir-p (string-append out \"/bin\"))\n"
  48526. " (call-with-output-file app\n"
  48527. " (lambda (port)\n"
  48528. " (format port\n"
  48529. "\"#!~a\n"
  48530. "library(shiny)\n"
  48531. "setwd(\\\"~a\\\")\n"
  48532. "runApp(launch.browser=0, port=4202)~%\\n\"\n"
  48533. " Rbin targetdir))))\n"
  48534. msgstr ""
  48535. #. type: cindex
  48536. #: guix-git/doc/guix.texi:32623
  48537. #, no-wrap
  48538. msgid "Nix"
  48539. msgstr ""
  48540. #. type: subsubheading
  48541. #: guix-git/doc/guix.texi:32624
  48542. #, no-wrap
  48543. msgid "Nix service"
  48544. msgstr ""
  48545. #. type: Plain text
  48546. #: guix-git/doc/guix.texi:32627
  48547. msgid "The @code{(gnu services nix)} module provides the following service."
  48548. msgstr ""
  48549. #. type: defvr
  48550. #: guix-git/doc/guix.texi:32628
  48551. #, no-wrap
  48552. msgid "{Scheme Variable} nix-service-type"
  48553. msgstr ""
  48554. #. type: defvr
  48555. #: guix-git/doc/guix.texi:32633
  48556. msgid "This is the type of the service that runs build daemon of the @url{https://nixos.org/nix/, Nix} package manager. Here is an example showing how to use it:"
  48557. msgstr ""
  48558. #. type: lisp
  48559. #: guix-git/doc/guix.texi:32638
  48560. #, no-wrap
  48561. msgid ""
  48562. "(use-modules (gnu))\n"
  48563. "(use-service-modules nix)\n"
  48564. "(use-package-modules package-management)\n"
  48565. "\n"
  48566. msgstr ""
  48567. #. type: lisp
  48568. #: guix-git/doc/guix.texi:32643
  48569. #, no-wrap
  48570. msgid ""
  48571. "(operating-system\n"
  48572. " ;; @dots{}\n"
  48573. " (packages (append (list nix)\n"
  48574. " %base-packages))\n"
  48575. "\n"
  48576. msgstr ""
  48577. #. type: lisp
  48578. #: guix-git/doc/guix.texi:32646
  48579. #, no-wrap
  48580. msgid ""
  48581. " (services (append (list (service nix-service-type))\n"
  48582. " %base-services)))\n"
  48583. msgstr ""
  48584. #. type: defvr
  48585. #: guix-git/doc/guix.texi:32649
  48586. msgid "After @command{guix system reconfigure} configure Nix for your user:"
  48587. msgstr ""
  48588. #. type: item
  48589. #: guix-git/doc/guix.texi:32651
  48590. #, no-wrap
  48591. msgid "Add a Nix channel and update it. See"
  48592. msgstr ""
  48593. #. type: itemize
  48594. #: guix-git/doc/guix.texi:32653
  48595. msgid "@url{https://nixos.org/nix/manual/, Nix Package Manager Guide}."
  48596. msgstr ""
  48597. #. type: item
  48598. #: guix-git/doc/guix.texi:32654
  48599. #, no-wrap
  48600. msgid "Create a symlink to your profile and activate Nix profile:"
  48601. msgstr ""
  48602. #. type: example
  48603. #: guix-git/doc/guix.texi:32660
  48604. #, no-wrap
  48605. msgid ""
  48606. "$ ln -s \"/nix/var/nix/profiles/per-user/$USER/profile\" ~/.nix-profile\n"
  48607. "$ source /run/current-system/profile/etc/profile.d/nix.sh\n"
  48608. msgstr ""
  48609. #. type: deftp
  48610. #: guix-git/doc/guix.texi:32664
  48611. #, no-wrap
  48612. msgid "{Data Type} nix-configuration"
  48613. msgstr ""
  48614. #. type: deftp
  48615. #: guix-git/doc/guix.texi:32666
  48616. msgid "This data type represents the configuration of the Nix daemon."
  48617. msgstr ""
  48618. #. type: item
  48619. #: guix-git/doc/guix.texi:32668
  48620. #, no-wrap
  48621. msgid "@code{nix} (default: @code{nix})"
  48622. msgstr ""
  48623. #. type: table
  48624. #: guix-git/doc/guix.texi:32670
  48625. msgid "The Nix package to use."
  48626. msgstr ""
  48627. #. type: item
  48628. #: guix-git/doc/guix.texi:32671
  48629. #, no-wrap
  48630. msgid "@code{sandbox} (default: @code{#t})"
  48631. msgstr ""
  48632. #. type: table
  48633. #: guix-git/doc/guix.texi:32673
  48634. msgid "Specifies whether builds are sandboxed by default."
  48635. msgstr ""
  48636. #. type: item
  48637. #: guix-git/doc/guix.texi:32674
  48638. #, no-wrap
  48639. msgid "@code{build-sandbox-items} (default: @code{'()})"
  48640. msgstr ""
  48641. #. type: table
  48642. #: guix-git/doc/guix.texi:32677
  48643. msgid "This is a list of strings or objects appended to the @code{build-sandbox-items} field of the configuration file."
  48644. msgstr ""
  48645. #. type: table
  48646. #: guix-git/doc/guix.texi:32685
  48647. msgid "Extra command line options for @code{nix-service-type}."
  48648. msgstr ""
  48649. #. type: cindex
  48650. #: guix-git/doc/guix.texi:32691
  48651. #, no-wrap
  48652. msgid "setuid programs"
  48653. msgstr ""
  48654. #. type: Plain text
  48655. #: guix-git/doc/guix.texi:32701
  48656. msgid "Some programs need to run with ``root'' privileges, even when they are launched by unprivileged users. A notorious example is the @command{passwd} program, which users can run to change their password, and which needs to access the @file{/etc/passwd} and @file{/etc/shadow} files---something normally restricted to root, for obvious security reasons. To address that, these executables are @dfn{setuid-root}, meaning that they always run with root privileges (@pxref{How Change Persona,,, libc, The GNU C Library Reference Manual}, for more info about the setuid mechanism)."
  48657. msgstr ""
  48658. #. type: Plain text
  48659. #: guix-git/doc/guix.texi:32708
  48660. msgid "The store itself @emph{cannot} contain setuid programs: that would be a security issue since any user on the system can write derivations that populate the store (@pxref{The Store}). Thus, a different mechanism is used: instead of changing the setuid bit directly on files that are in the store, we let the system administrator @emph{declare} which programs should be setuid root."
  48661. msgstr ""
  48662. #. type: Plain text
  48663. #: guix-git/doc/guix.texi:32715
  48664. msgid "The @code{setuid-programs} field of an @code{operating-system} declaration contains a list of @code{<setuid-program>} denoting the names of programs to have a setuid or setgid bit set (@pxref{Using the Configuration System}). For instance, the @command{passwd} program, which is part of the Shadow package, with a setuid root can be designated like this:"
  48665. msgstr ""
  48666. #. type: example
  48667. #: guix-git/doc/guix.texi:32719
  48668. #, no-wrap
  48669. msgid ""
  48670. "(setuid-program\n"
  48671. " (program (file-append #$shadow \"/bin/passwd\")))\n"
  48672. msgstr ""
  48673. #. type: deftp
  48674. #: guix-git/doc/guix.texi:32721
  48675. #, no-wrap
  48676. msgid "{Data Type} setuid-program"
  48677. msgstr ""
  48678. #. type: deftp
  48679. #: guix-git/doc/guix.texi:32723
  48680. msgid "This data type represents a program with a setuid or setgid bit set."
  48681. msgstr ""
  48682. #. type: code{#1}
  48683. #: guix-git/doc/guix.texi:32725
  48684. #, no-wrap
  48685. msgid "program"
  48686. msgstr ""
  48687. #. type: table
  48688. #: guix-git/doc/guix.texi:32727
  48689. msgid "A file-like object having its setuid and/or setgid bit set."
  48690. msgstr ""
  48691. #. type: item
  48692. #: guix-git/doc/guix.texi:32728
  48693. #, no-wrap
  48694. msgid "@code{setuid?} (default: @code{#t})"
  48695. msgstr ""
  48696. #. type: table
  48697. #: guix-git/doc/guix.texi:32730
  48698. msgid "Whether to set user setuid bit."
  48699. msgstr ""
  48700. #. type: item
  48701. #: guix-git/doc/guix.texi:32731
  48702. #, no-wrap
  48703. msgid "@code{setgid?} (default: @code{#f})"
  48704. msgstr ""
  48705. #. type: table
  48706. #: guix-git/doc/guix.texi:32733
  48707. msgid "Whether to set group setgid bit."
  48708. msgstr ""
  48709. #. type: item
  48710. #: guix-git/doc/guix.texi:32734
  48711. #, no-wrap
  48712. msgid "@code{user} (default: @code{0})"
  48713. msgstr ""
  48714. #. type: table
  48715. #: guix-git/doc/guix.texi:32737
  48716. msgid "UID (integer) or user name (string) for the user owner of the program, defaults to root."
  48717. msgstr ""
  48718. #. type: item
  48719. #: guix-git/doc/guix.texi:32738
  48720. #, no-wrap
  48721. msgid "@code{group} (default: @code{0})"
  48722. msgstr ""
  48723. #. type: table
  48724. #: guix-git/doc/guix.texi:32741
  48725. msgid "GID (integer) goup name (string) for the group owner of the program, defaults to root."
  48726. msgstr ""
  48727. #. type: Plain text
  48728. #: guix-git/doc/guix.texi:32747
  48729. msgid "A default set of setuid programs is defined by the @code{%setuid-programs} variable of the @code{(gnu system)} module."
  48730. msgstr ""
  48731. #. type: defvr
  48732. #: guix-git/doc/guix.texi:32748
  48733. #, no-wrap
  48734. msgid "{Scheme Variable} %setuid-programs"
  48735. msgstr ""
  48736. #. type: defvr
  48737. #: guix-git/doc/guix.texi:32751
  48738. msgid "A list of @code{<setuid-program>} denoting common programs that are setuid-root."
  48739. msgstr ""
  48740. #. type: defvr
  48741. #: guix-git/doc/guix.texi:32754
  48742. msgid "The list includes commands such as @command{passwd}, @command{ping}, @command{su}, and @command{sudo}."
  48743. msgstr ""
  48744. #. type: Plain text
  48745. #: guix-git/doc/guix.texi:32760
  48746. msgid "Under the hood, the actual setuid programs are created in the @file{/run/setuid-programs} directory at system activation time. The files in this directory refer to the ``real'' binaries, which are in the store."
  48747. msgstr ""
  48748. #. type: cindex
  48749. #: guix-git/doc/guix.texi:32764
  48750. #, no-wrap
  48751. msgid "HTTPS, certificates"
  48752. msgstr ""
  48753. #. type: cindex
  48754. #: guix-git/doc/guix.texi:32765
  48755. #, no-wrap
  48756. msgid "X.509 certificates"
  48757. msgstr ""
  48758. #. type: cindex
  48759. #: guix-git/doc/guix.texi:32766
  48760. #, no-wrap
  48761. msgid "TLS"
  48762. msgstr ""
  48763. #. type: Plain text
  48764. #: guix-git/doc/guix.texi:32773
  48765. msgid "Web servers available over HTTPS (that is, HTTP over the transport-layer security mechanism, TLS) send client programs an @dfn{X.509 certificate} that the client can then use to @emph{authenticate} the server. To do that, clients verify that the server's certificate is signed by a so-called @dfn{certificate authority} (CA). But to verify the CA's signature, clients must have first acquired the CA's certificate."
  48766. msgstr ""
  48767. #. type: Plain text
  48768. #: guix-git/doc/guix.texi:32777
  48769. msgid "Web browsers such as GNU@tie{}IceCat include their own set of CA certificates, such that they are able to verify CA signatures out-of-the-box."
  48770. msgstr ""
  48771. #. type: Plain text
  48772. #: guix-git/doc/guix.texi:32781
  48773. msgid "However, most other programs that can talk HTTPS---@command{wget}, @command{git}, @command{w3m}, etc.---need to be told where CA certificates can be found."
  48774. msgstr ""
  48775. #. type: Plain text
  48776. #: guix-git/doc/guix.texi:32788
  48777. msgid "In Guix, this is done by adding a package that provides certificates to the @code{packages} field of the @code{operating-system} declaration (@pxref{operating-system Reference}). Guix includes one such package, @code{nss-certs}, which is a set of CA certificates provided as part of Mozilla's Network Security Services."
  48778. msgstr ""
  48779. #. type: Plain text
  48780. #: guix-git/doc/guix.texi:32793
  48781. msgid "Note that it is @emph{not} part of @code{%base-packages}, so you need to explicitly add it. The @file{/etc/ssl/certs} directory, which is where most applications and libraries look for certificates by default, points to the certificates installed globally."
  48782. msgstr ""
  48783. #. type: Plain text
  48784. #: guix-git/doc/guix.texi:32803
  48785. msgid "Unprivileged users, including users of Guix on a foreign distro, can also install their own certificate package in their profile. A number of environment variables need to be defined so that applications and libraries know where to find them. Namely, the OpenSSL library honors the @env{SSL_CERT_DIR} and @env{SSL_CERT_FILE} variables. Some applications add their own environment variables; for instance, the Git version control system honors the certificate bundle pointed to by the @env{GIT_SSL_CAINFO} environment variable. Thus, you would typically run something like:"
  48786. msgstr ""
  48787. #. type: example
  48788. #: guix-git/doc/guix.texi:32809
  48789. #, no-wrap
  48790. msgid ""
  48791. "guix install nss-certs\n"
  48792. "export SSL_CERT_DIR=\"$HOME/.guix-profile/etc/ssl/certs\"\n"
  48793. "export SSL_CERT_FILE=\"$HOME/.guix-profile/etc/ssl/certs/ca-certificates.crt\"\n"
  48794. "export GIT_SSL_CAINFO=\"$SSL_CERT_FILE\"\n"
  48795. msgstr ""
  48796. #. type: Plain text
  48797. #: guix-git/doc/guix.texi:32814
  48798. msgid "As another example, R requires the @env{CURL_CA_BUNDLE} environment variable to point to a certificate bundle, so you would have to run something like this:"
  48799. msgstr ""
  48800. #. type: example
  48801. #: guix-git/doc/guix.texi:32818
  48802. #, no-wrap
  48803. msgid ""
  48804. "guix install nss-certs\n"
  48805. "export CURL_CA_BUNDLE=\"$HOME/.guix-profile/etc/ssl/certs/ca-certificates.crt\"\n"
  48806. msgstr ""
  48807. #. type: Plain text
  48808. #: guix-git/doc/guix.texi:32822
  48809. msgid "For other applications you may want to look up the required environment variable in the relevant documentation."
  48810. msgstr ""
  48811. #. type: cindex
  48812. #: guix-git/doc/guix.texi:32827
  48813. #, no-wrap
  48814. msgid "name service switch"
  48815. msgstr ""
  48816. #. type: cindex
  48817. #: guix-git/doc/guix.texi:32828
  48818. #, no-wrap
  48819. msgid "NSS"
  48820. msgstr ""
  48821. #. type: Plain text
  48822. #: guix-git/doc/guix.texi:32837
  48823. msgid "The @code{(gnu system nss)} module provides bindings to the configuration file of the libc @dfn{name service switch} or @dfn{NSS} (@pxref{NSS Configuration File,,, libc, The GNU C Library Reference Manual}). In a nutshell, the NSS is a mechanism that allows libc to be extended with new ``name'' lookup methods for system databases, which includes host names, service names, user accounts, and more (@pxref{Name Service Switch, System Databases and Name Service Switch,, libc, The GNU C Library Reference Manual})."
  48824. msgstr ""
  48825. #. type: Plain text
  48826. #: guix-git/doc/guix.texi:32844
  48827. msgid "The NSS configuration specifies, for each system database, which lookup method is to be used, and how the various methods are chained together---for instance, under which circumstances NSS should try the next method in the list. The NSS configuration is given in the @code{name-service-switch} field of @code{operating-system} declarations (@pxref{operating-system Reference, @code{name-service-switch}})."
  48828. msgstr ""
  48829. #. type: cindex
  48830. #: guix-git/doc/guix.texi:32845
  48831. #, no-wrap
  48832. msgid "nss-mdns"
  48833. msgstr ""
  48834. #. type: cindex
  48835. #: guix-git/doc/guix.texi:32846
  48836. #, no-wrap
  48837. msgid ".local, host name lookup"
  48838. msgstr ""
  48839. #. type: Plain text
  48840. #: guix-git/doc/guix.texi:32851
  48841. msgid "As an example, the declaration below configures the NSS to use the @uref{https://0pointer.de/lennart/projects/nss-mdns/, @code{nss-mdns} back-end}, which supports host name lookups over multicast DNS (mDNS) for host names ending in @code{.local}:"
  48842. msgstr ""
  48843. #. type: lisp
  48844. #: guix-git/doc/guix.texi:32855
  48845. #, no-wrap
  48846. msgid ""
  48847. "(name-service-switch\n"
  48848. " (hosts (list %files ;first, check /etc/hosts\n"
  48849. "\n"
  48850. msgstr ""
  48851. #. type: lisp
  48852. #: guix-git/doc/guix.texi:32860
  48853. #, no-wrap
  48854. msgid ""
  48855. " ;; If the above did not succeed, try\n"
  48856. " ;; with 'mdns_minimal'.\n"
  48857. " (name-service\n"
  48858. " (name \"mdns_minimal\")\n"
  48859. "\n"
  48860. msgstr ""
  48861. #. type: lisp
  48862. #: guix-git/doc/guix.texi:32866
  48863. #, no-wrap
  48864. msgid ""
  48865. " ;; 'mdns_minimal' is authoritative for\n"
  48866. " ;; '.local'. When it returns \"not found\",\n"
  48867. " ;; no need to try the next methods.\n"
  48868. " (reaction (lookup-specification\n"
  48869. " (not-found => return))))\n"
  48870. "\n"
  48871. msgstr ""
  48872. #. type: lisp
  48873. #: guix-git/doc/guix.texi:32870
  48874. #, no-wrap
  48875. msgid ""
  48876. " ;; Then fall back to DNS.\n"
  48877. " (name-service\n"
  48878. " (name \"dns\"))\n"
  48879. "\n"
  48880. msgstr ""
  48881. #. type: lisp
  48882. #: guix-git/doc/guix.texi:32874
  48883. #, no-wrap
  48884. msgid ""
  48885. " ;; Finally, try with the \"full\" 'mdns'.\n"
  48886. " (name-service\n"
  48887. " (name \"mdns\")))))\n"
  48888. msgstr ""
  48889. #. type: Plain text
  48890. #: guix-git/doc/guix.texi:32879
  48891. msgid "Do not worry: the @code{%mdns-host-lookup-nss} variable (see below) contains this configuration, so you will not have to type it if all you want is to have @code{.local} host lookup working."
  48892. msgstr ""
  48893. #. type: Plain text
  48894. #: guix-git/doc/guix.texi:32887
  48895. msgid "Note that, in this case, in addition to setting the @code{name-service-switch} of the @code{operating-system} declaration, you also need to use @code{avahi-service-type} (@pxref{Networking Services, @code{avahi-service-type}}), or @code{%desktop-services}, which includes it (@pxref{Desktop Services}). Doing this makes @code{nss-mdns} accessible to the name service cache daemon (@pxref{Base Services, @code{nscd-service}})."
  48896. msgstr ""
  48897. #. type: Plain text
  48898. #: guix-git/doc/guix.texi:32890
  48899. msgid "For convenience, the following variables provide typical NSS configurations."
  48900. msgstr ""
  48901. #. type: defvr
  48902. #: guix-git/doc/guix.texi:32891
  48903. #, no-wrap
  48904. msgid "{Scheme Variable} %default-nss"
  48905. msgstr ""
  48906. #. type: defvr
  48907. #: guix-git/doc/guix.texi:32894
  48908. msgid "This is the default name service switch configuration, a @code{name-service-switch} object."
  48909. msgstr ""
  48910. #. type: defvr
  48911. #: guix-git/doc/guix.texi:32896
  48912. #, no-wrap
  48913. msgid "{Scheme Variable} %mdns-host-lookup-nss"
  48914. msgstr ""
  48915. #. type: defvr
  48916. #: guix-git/doc/guix.texi:32899
  48917. msgid "This is the name service switch configuration with support for host name lookup over multicast DNS (mDNS) for host names ending in @code{.local}."
  48918. msgstr ""
  48919. #. type: Plain text
  48920. #: guix-git/doc/guix.texi:32909
  48921. msgid "The reference for name service switch configuration is given below. It is a direct mapping of the configuration file format of the C library , so please refer to the C library manual for more information (@pxref{NSS Configuration File,,, libc, The GNU C Library Reference Manual}). Compared to the configuration file format of libc NSS, it has the advantage not only of adding this warm parenthetic feel that we like, but also static checks: you will know about syntax errors and typos as soon as you run @command{guix system}."
  48922. msgstr ""
  48923. #. type: deftp
  48924. #: guix-git/doc/guix.texi:32910
  48925. #, no-wrap
  48926. msgid "{Data Type} name-service-switch"
  48927. msgstr ""
  48928. #. type: deftp
  48929. #: guix-git/doc/guix.texi:32915
  48930. msgid "This is the data type representation the configuration of libc's name service switch (NSS). Each field below represents one of the supported system databases."
  48931. msgstr ""
  48932. #. type: item
  48933. #: guix-git/doc/guix.texi:32917
  48934. #, no-wrap
  48935. msgid "aliases"
  48936. msgstr ""
  48937. #. type: itemx
  48938. #: guix-git/doc/guix.texi:32918
  48939. #, no-wrap
  48940. msgid "ethers"
  48941. msgstr ""
  48942. #. type: itemx
  48943. #: guix-git/doc/guix.texi:32920
  48944. #, no-wrap
  48945. msgid "gshadow"
  48946. msgstr ""
  48947. #. type: itemx
  48948. #: guix-git/doc/guix.texi:32921
  48949. #, no-wrap
  48950. msgid "hosts"
  48951. msgstr ""
  48952. #. type: itemx
  48953. #: guix-git/doc/guix.texi:32922
  48954. #, no-wrap
  48955. msgid "initgroups"
  48956. msgstr ""
  48957. #. type: itemx
  48958. #: guix-git/doc/guix.texi:32923
  48959. #, no-wrap
  48960. msgid "netgroup"
  48961. msgstr ""
  48962. #. type: itemx
  48963. #: guix-git/doc/guix.texi:32924
  48964. #, no-wrap
  48965. msgid "networks"
  48966. msgstr ""
  48967. #. type: itemx
  48968. #: guix-git/doc/guix.texi:32927
  48969. #, no-wrap
  48970. msgid "rpc"
  48971. msgstr ""
  48972. #. type: itemx
  48973. #: guix-git/doc/guix.texi:32929
  48974. #, no-wrap
  48975. msgid "shadow"
  48976. msgstr ""
  48977. #. type: table
  48978. #: guix-git/doc/guix.texi:32932
  48979. msgid "The system databases handled by the NSS@. Each of these fields must be a list of @code{<name-service>} objects (see below)."
  48980. msgstr ""
  48981. #. type: deftp
  48982. #: guix-git/doc/guix.texi:32935
  48983. #, no-wrap
  48984. msgid "{Data Type} name-service"
  48985. msgstr ""
  48986. #. type: deftp
  48987. #: guix-git/doc/guix.texi:32939
  48988. msgid "This is the data type representing an actual name service and the associated lookup action."
  48989. msgstr ""
  48990. #. type: table
  48991. #: guix-git/doc/guix.texi:32944
  48992. msgid "A string denoting the name service (@pxref{Services in the NSS configuration,,, libc, The GNU C Library Reference Manual})."
  48993. msgstr ""
  48994. #. type: table
  48995. #: guix-git/doc/guix.texi:32949
  48996. msgid "Note that name services listed here must be visible to nscd. This is achieved by passing the @code{#:name-services} argument to @code{nscd-service} the list of packages providing the needed name services (@pxref{Base Services, @code{nscd-service}})."
  48997. msgstr ""
  48998. #. type: item
  48999. #: guix-git/doc/guix.texi:32950
  49000. #, no-wrap
  49001. msgid "reaction"
  49002. msgstr ""
  49003. #. type: table
  49004. #: guix-git/doc/guix.texi:32954
  49005. msgid "An action specified using the @code{lookup-specification} macro (@pxref{Actions in the NSS configuration,,, libc, The GNU C Library Reference Manual}). For example:"
  49006. msgstr ""
  49007. #. type: lisp
  49008. #: guix-git/doc/guix.texi:32958
  49009. #, no-wrap
  49010. msgid ""
  49011. "(lookup-specification (unavailable => continue)\n"
  49012. " (success => return))\n"
  49013. msgstr ""
  49014. #. type: Plain text
  49015. #: guix-git/doc/guix.texi:32972
  49016. msgid "For bootstrapping purposes, the Linux-Libre kernel is passed an @dfn{initial RAM disk}, or @dfn{initrd}. An initrd contains a temporary root file system as well as an initialization script. The latter is responsible for mounting the real root file system, and for loading any kernel modules that may be needed to achieve that."
  49017. msgstr ""
  49018. #. type: Plain text
  49019. #: guix-git/doc/guix.texi:32981
  49020. msgid "The @code{initrd-modules} field of an @code{operating-system} declaration allows you to specify Linux-libre kernel modules that must be available in the initrd. In particular, this is where you would list modules needed to actually drive the hard disk where your root partition is---although the default value of @code{initrd-modules} should cover most use cases. For example, assuming you need the @code{megaraid_sas} module in addition to the default modules to be able to access your root file system, you would write:"
  49021. msgstr ""
  49022. #. type: lisp
  49023. #: guix-git/doc/guix.texi:32986
  49024. #, no-wrap
  49025. msgid ""
  49026. "(operating-system\n"
  49027. " ;; @dots{}\n"
  49028. " (initrd-modules (cons \"megaraid_sas\" %base-initrd-modules)))\n"
  49029. msgstr ""
  49030. #. type: defvr
  49031. #: guix-git/doc/guix.texi:32988
  49032. #, no-wrap
  49033. msgid "{Scheme Variable} %base-initrd-modules"
  49034. msgstr ""
  49035. #. type: defvr
  49036. #: guix-git/doc/guix.texi:32990
  49037. msgid "This is the list of kernel modules included in the initrd by default."
  49038. msgstr ""
  49039. #. type: Plain text
  49040. #: guix-git/doc/guix.texi:32998
  49041. msgid "Furthermore, if you need lower-level customization, the @code{initrd} field of an @code{operating-system} declaration allows you to specify which initrd you would like to use. The @code{(gnu system linux-initrd)} module provides three ways to build an initrd: the high-level @code{base-initrd} procedure and the low-level @code{raw-initrd} and @code{expression->initrd} procedures."
  49042. msgstr ""
  49043. #. type: Plain text
  49044. #: guix-git/doc/guix.texi:33003
  49045. msgid "The @code{base-initrd} procedure is intended to cover most common uses. For example, if you want to add a bunch of kernel modules to be loaded at boot time, you can define the @code{initrd} field of the operating system declaration like this:"
  49046. msgstr ""
  49047. #. type: lisp
  49048. #: guix-git/doc/guix.texi:33011
  49049. #, no-wrap
  49050. msgid ""
  49051. "(initrd (lambda (file-systems . rest)\n"
  49052. " ;; Create a standard initrd but set up networking\n"
  49053. " ;; with the parameters QEMU expects by default.\n"
  49054. " (apply base-initrd file-systems\n"
  49055. " #:qemu-networking? #t\n"
  49056. " rest)))\n"
  49057. msgstr ""
  49058. #. type: Plain text
  49059. #: guix-git/doc/guix.texi:33016
  49060. msgid "The @code{base-initrd} procedure also handles common use cases that involves using the system as a QEMU guest, or as a ``live'' system with volatile root file system."
  49061. msgstr ""
  49062. #. type: Plain text
  49063. #: guix-git/doc/guix.texi:33023
  49064. msgid "The @code{base-initrd} procedure is built from @code{raw-initrd} procedure. Unlike @code{base-initrd}, @code{raw-initrd} doesn't do anything high-level, such as trying to guess which kernel modules and packages should be included to the initrd. An example use of @code{raw-initrd} is when a user has a custom Linux kernel configuration and default kernel modules included by @code{base-initrd} are not available."
  49065. msgstr ""
  49066. #. type: Plain text
  49067. #: guix-git/doc/guix.texi:33028
  49068. msgid "The initial RAM disk produced by @code{base-initrd} or @code{raw-initrd} honors several options passed on the Linux kernel command line (that is, arguments passed @i{via} the @code{linux} command of GRUB, or the @code{-append} option of QEMU), notably:"
  49069. msgstr ""
  49070. #. type: item
  49071. #: guix-git/doc/guix.texi:33030
  49072. #, no-wrap
  49073. msgid "--load=@var{boot}"
  49074. msgstr ""
  49075. #. type: table
  49076. #: guix-git/doc/guix.texi:33033
  49077. msgid "Tell the initial RAM disk to load @var{boot}, a file containing a Scheme program, once it has mounted the root file system."
  49078. msgstr ""
  49079. #. type: table
  49080. #: guix-git/doc/guix.texi:33037
  49081. msgid "Guix uses this option to yield control to a boot program that runs the service activation programs and then spawns the GNU@tie{}Shepherd, the initialization system."
  49082. msgstr ""
  49083. #. type: item
  49084. #: guix-git/doc/guix.texi:33038
  49085. #, no-wrap
  49086. msgid "--root=@var{root}"
  49087. msgstr ""
  49088. #. type: table
  49089. #: guix-git/doc/guix.texi:33043
  49090. msgid "Mount @var{root} as the root file system. @var{root} can be a device name like @code{/dev/sda1}, a file system label, or a file system UUID. When unspecified, the device name from the root file system of the operating system declaration is used."
  49091. msgstr ""
  49092. #. type: table
  49093. #: guix-git/doc/guix.texi:33047
  49094. msgid "Have @file{/run/booted-system} and @file{/run/current-system} point to @var{system}."
  49095. msgstr ""
  49096. #. type: item
  49097. #: guix-git/doc/guix.texi:33048
  49098. #, no-wrap
  49099. msgid "modprobe.blacklist=@var{modules}@dots{}"
  49100. msgstr ""
  49101. #. type: cindex
  49102. #: guix-git/doc/guix.texi:33049
  49103. #, no-wrap
  49104. msgid "module, black-listing"
  49105. msgstr ""
  49106. #. type: cindex
  49107. #: guix-git/doc/guix.texi:33050
  49108. #, no-wrap
  49109. msgid "black list, of kernel modules"
  49110. msgstr ""
  49111. #. type: table
  49112. #: guix-git/doc/guix.texi:33055
  49113. msgid "Instruct the initial RAM disk as well as the @command{modprobe} command (from the kmod package) to refuse to load @var{modules}. @var{modules} must be a comma-separated list of module names---e.g., @code{usbkbd,9pnet}."
  49114. msgstr ""
  49115. #. type: item
  49116. #: guix-git/doc/guix.texi:33056
  49117. #, no-wrap
  49118. msgid "--repl"
  49119. msgstr ""
  49120. #. type: table
  49121. #: guix-git/doc/guix.texi:33062
  49122. msgid "Start a read-eval-print loop (REPL) from the initial RAM disk before it tries to load kernel modules and to mount the root file system. Our marketing team calls it @dfn{boot-to-Guile}. The Schemer in you will love it. @xref{Using Guile Interactively,,, guile, GNU Guile Reference Manual}, for more information on Guile's REPL."
  49123. msgstr ""
  49124. #. type: Plain text
  49125. #: guix-git/doc/guix.texi:33068
  49126. msgid "Now that you know all the features that initial RAM disks produced by @code{base-initrd} and @code{raw-initrd} provide, here is how to use it and customize it further."
  49127. msgstr ""
  49128. #. type: deffn
  49129. #: guix-git/doc/guix.texi:33071
  49130. #, no-wrap
  49131. msgid "{Scheme Procedure} raw-initrd @var{file-systems} @"
  49132. msgstr ""
  49133. #. type: deffn
  49134. #: guix-git/doc/guix.texi:33085
  49135. msgid "[#:linux-modules '()] [#:mapped-devices '()] @ [#:keyboard-layout #f] @ [#:helper-packages '()] [#:qemu-networking? #f] [#:volatile-root? #f] Return a derivation that builds a raw initrd. @var{file-systems} is a list of file systems to be mounted by the initrd, possibly in addition to the root file system specified on the kernel command line via @option{--root}. @var{linux-modules} is a list of kernel modules to be loaded at boot time. @var{mapped-devices} is a list of device mappings to realize before @var{file-systems} are mounted (@pxref{Mapped Devices}). @var{helper-packages} is a list of packages to be copied in the initrd. It may include @code{e2fsck/static} or other packages needed by the initrd to check the root file system."
  49136. msgstr ""
  49137. #. type: deffn
  49138. #: guix-git/doc/guix.texi:33091 guix-git/doc/guix.texi:33115
  49139. msgid "When true, @var{keyboard-layout} is a @code{<keyboard-layout>} record denoting the desired console keyboard layout. This is done before @var{mapped-devices} are set up and before @var{file-systems} are mounted such that, should the user need to enter a passphrase or use the REPL, this happens using the intended keyboard layout."
  49140. msgstr ""
  49141. #. type: deffn
  49142. #: guix-git/doc/guix.texi:33095
  49143. msgid "When @var{qemu-networking?} is true, set up networking with the standard QEMU parameters. When @var{virtio?} is true, load additional modules so that the initrd can be used as a QEMU guest with para-virtualized I/O drivers."
  49144. msgstr ""
  49145. #. type: deffn
  49146. #: guix-git/doc/guix.texi:33098
  49147. msgid "When @var{volatile-root?} is true, the root file system is writable but any changes to it are lost."
  49148. msgstr ""
  49149. #. type: deffn
  49150. #: guix-git/doc/guix.texi:33100
  49151. #, no-wrap
  49152. msgid "{Scheme Procedure} base-initrd @var{file-systems} @"
  49153. msgstr ""
  49154. #. type: deffn
  49155. #: guix-git/doc/guix.texi:33109
  49156. msgid "[#:mapped-devices '()] [#:keyboard-layout #f] @ [#:qemu-networking? #f] [#:volatile-root? #f] @ [#:linux-modules '()] Return as a file-like object a generic initrd, with kernel modules taken from @var{linux}. @var{file-systems} is a list of file-systems to be mounted by the initrd, possibly in addition to the root file system specified on the kernel command line via @option{--root}. @var{mapped-devices} is a list of device mappings to realize before @var{file-systems} are mounted."
  49157. msgstr ""
  49158. #. type: deffn
  49159. #: guix-git/doc/guix.texi:33117
  49160. msgid "@var{qemu-networking?} and @var{volatile-root?} behaves as in @code{raw-initrd}."
  49161. msgstr ""
  49162. #. type: deffn
  49163. #: guix-git/doc/guix.texi:33122
  49164. msgid "The initrd is automatically populated with all the kernel modules necessary for @var{file-systems} and for the given options. Additional kernel modules can be listed in @var{linux-modules}. They will be added to the initrd, and loaded at boot time in the order in which they appear."
  49165. msgstr ""
  49166. #. type: Plain text
  49167. #: guix-git/doc/guix.texi:33129
  49168. msgid "Needless to say, the initrds we produce and use embed a statically-linked Guile, and the initialization program is a Guile program. That gives a lot of flexibility. The @code{expression->initrd} procedure builds such an initrd, given the program to run in that initrd."
  49169. msgstr ""
  49170. #. type: deffn
  49171. #: guix-git/doc/guix.texi:33130
  49172. #, no-wrap
  49173. msgid "{Scheme Procedure} expression->initrd @var{exp} @"
  49174. msgstr ""
  49175. #. type: deffn
  49176. #: guix-git/doc/guix.texi:33136
  49177. msgid "[#:guile %guile-static-stripped] [#:name \"guile-initrd\"] Return as a file-like object a Linux initrd (a gzipped cpio archive) containing @var{guile} and that evaluates @var{exp}, a G-expression, upon booting. All the derivations referenced by @var{exp} are automatically copied to the initrd."
  49178. msgstr ""
  49179. #. type: cindex
  49180. #: guix-git/doc/guix.texi:33142
  49181. #, no-wrap
  49182. msgid "boot loader"
  49183. msgstr ""
  49184. #. type: Plain text
  49185. #: guix-git/doc/guix.texi:33149
  49186. msgid "The operating system supports multiple bootloaders. The bootloader is configured using @code{bootloader-configuration} declaration. All the fields of this structure are bootloader agnostic except for one field, @code{bootloader} that indicates the bootloader to be configured and installed."
  49187. msgstr ""
  49188. #. type: Plain text
  49189. #: guix-git/doc/guix.texi:33154
  49190. msgid "Some of the bootloaders do not honor every field of @code{bootloader-configuration}. For instance, the extlinux bootloader does not support themes and thus ignores the @code{theme} field."
  49191. msgstr ""
  49192. #. type: deftp
  49193. #: guix-git/doc/guix.texi:33155
  49194. #, no-wrap
  49195. msgid "{Data Type} bootloader-configuration"
  49196. msgstr ""
  49197. #. type: deftp
  49198. #: guix-git/doc/guix.texi:33157
  49199. msgid "The type of a bootloader configuration declaration."
  49200. msgstr ""
  49201. #. type: cindex
  49202. #: guix-git/doc/guix.texi:33161
  49203. #, no-wrap
  49204. msgid "EFI, bootloader"
  49205. msgstr ""
  49206. #. type: cindex
  49207. #: guix-git/doc/guix.texi:33162
  49208. #, no-wrap
  49209. msgid "UEFI, bootloader"
  49210. msgstr ""
  49211. #. type: cindex
  49212. #: guix-git/doc/guix.texi:33163
  49213. #, no-wrap
  49214. msgid "BIOS, bootloader"
  49215. msgstr ""
  49216. #. type: table
  49217. #: guix-git/doc/guix.texi:33168
  49218. msgid "The bootloader to use, as a @code{bootloader} object. For now @code{grub-bootloader}, @code{grub-efi-bootloader}, @code{grub-efi-netboot-bootloader}, @code{extlinux-bootloader} and @code{u-boot-bootloader} are supported."
  49219. msgstr ""
  49220. #. type: cindex
  49221. #: guix-git/doc/guix.texi:33169
  49222. #, no-wrap
  49223. msgid "ARM, bootloaders"
  49224. msgstr ""
  49225. #. type: cindex
  49226. #: guix-git/doc/guix.texi:33170
  49227. #, no-wrap
  49228. msgid "AArch64, bootloaders"
  49229. msgstr ""
  49230. #. type: table
  49231. #: guix-git/doc/guix.texi:33175
  49232. msgid "Available bootloaders are described in @code{(gnu bootloader @dots{})} modules. In particular, @code{(gnu bootloader u-boot)} contains definitions of bootloaders for a wide range of ARM and AArch64 systems, using the @uref{https://www.denx.de/wiki/U-Boot/, U-Boot bootloader}."
  49233. msgstr ""
  49234. #. type: table
  49235. #: guix-git/doc/guix.texi:33181
  49236. msgid "@code{grub-efi-bootloader} allows to boot on modern systems using the @dfn{Unified Extensible Firmware Interface} (UEFI). This is what you should use if the installation image contains a @file{/sys/firmware/efi} directory when you boot it on your system."
  49237. msgstr ""
  49238. #. type: table
  49239. #: guix-git/doc/guix.texi:33185
  49240. msgid "@code{grub-bootloader} allows you to boot in particular Intel-based machines in ``legacy'' BIOS mode."
  49241. msgstr ""
  49242. #. type: vindex
  49243. #: guix-git/doc/guix.texi:33186
  49244. #, no-wrap
  49245. msgid "grub-efi-netboot-bootloader"
  49246. msgstr ""
  49247. #. type: table
  49248. #: guix-git/doc/guix.texi:33190
  49249. msgid "@code{grub-efi-netboot-bootloader} allows you to boot your system over network through TFTP@. In combination with an NFS root file system this allows you to build a diskless Guix system."
  49250. msgstr ""
  49251. #. type: table
  49252. #: guix-git/doc/guix.texi:33196
  49253. msgid "The installation of the @code{grub-efi-netboot-bootloader} generates the content of the TFTP root directory at @code{target} (@pxref{Bootloader Configuration, @code{target}}), to be served by a TFTP server. You may want to mount your TFTP server directory onto @code{target} to move the required files to the TFTP server automatically."
  49254. msgstr ""
  49255. #. type: table
  49256. #: guix-git/doc/guix.texi:33205
  49257. msgid "If you plan to use an NFS root file system as well (actually if you mount the store from an NFS share), then the TFTP server needs to serve the file @file{/boot/grub/grub.cfg} and other files from the store (like GRUBs background image, the kernel (@pxref{operating-system Reference, @code{kernel}}) and the initrd (@pxref{operating-system Reference, @code{initrd}})), too. All these files from the store will be accessed by GRUB through TFTP with their normal store path, for example as @file{tftp://tftp-server/gnu/store/…-initrd/initrd.cpio.gz}."
  49258. msgstr ""
  49259. #. type: table
  49260. #: guix-git/doc/guix.texi:33213
  49261. msgid "Two symlinks are created to make this possible. The first symlink is @code{target}@file{/efi/Guix/boot/grub/grub.cfg} pointing to @file{../../../boot/grub/grub.cfg}, where @code{target} may be @file{/boot}. In this case the link is not leaving the served TFTP root directory, but otherwise it does. The second link is @code{target}@file{/gnu/store} and points to @file{../gnu/store}. This link is leaving the served TFTP root directory."
  49262. msgstr ""
  49263. #. type: table
  49264. #: guix-git/doc/guix.texi:33218
  49265. msgid "The assumption behind all this is that you have an NFS server exporting the root file system for your Guix system, and additionally a TFTP server exporting your @code{target} directory—usually @file{/boot}—from that same root file system for your Guix system. In this constellation the symlinks will work."
  49266. msgstr ""
  49267. #. type: table
  49268. #: guix-git/doc/guix.texi:33222
  49269. msgid "For other constellations you will have to program your own bootloader installer, which then takes care to make necessary files from the store accessible through TFTP, for example by copying them into the TFTP root directory at @code{target}."
  49270. msgstr ""
  49271. #. type: table
  49272. #: guix-git/doc/guix.texi:33227
  49273. msgid "It is important to note that symlinks pointing outside the TFTP root directory may need to be allowed in the configuration of your TFTP server. Further the store link exposes the whole store through TFTP@. Both points need to be considered carefully for security aspects."
  49274. msgstr ""
  49275. #. type: table
  49276. #: guix-git/doc/guix.texi:33232
  49277. msgid "Beside the @code{grub-efi-netboot-bootloader}, the already mentioned TFTP and NFS servers, you also need a properly configured DHCP server to make the booting over netboot possible. For all this we can currently only recommend you to look for instructions about @acronym{PXE, Preboot eXecution Environment}."
  49278. msgstr ""
  49279. #. type: table
  49280. #: guix-git/doc/guix.texi:33236
  49281. msgid "This is a string denoting the target onto which to install the bootloader."
  49282. msgstr ""
  49283. #. type: table
  49284. #: guix-git/doc/guix.texi:33245
  49285. msgid "The interpretation depends on the bootloader in question. For @code{grub-bootloader}, for example, it should be a device name understood by the bootloader @command{installer} command, such as @code{/dev/sda} or @code{(hd0)} (@pxref{Invoking grub-install,,, grub, GNU GRUB Manual}). For @code{grub-efi-bootloader}, it should be the mount point of the EFI file system, usually @file{/boot/efi}. For @code{grub-efi-netboot-bootloader}, @code{target} should be the mount point corresponding to the TFTP root directory of your TFTP server."
  49286. msgstr ""
  49287. #. type: item
  49288. #: guix-git/doc/guix.texi:33246
  49289. #, no-wrap
  49290. msgid "@code{menu-entries} (default: @code{()})"
  49291. msgstr ""
  49292. #. type: table
  49293. #: guix-git/doc/guix.texi:33250
  49294. msgid "A possibly empty list of @code{menu-entry} objects (see below), denoting entries to appear in the bootloader menu, in addition to the current system entry and the entry pointing to previous system generations."
  49295. msgstr ""
  49296. #. type: item
  49297. #: guix-git/doc/guix.texi:33251
  49298. #, no-wrap
  49299. msgid "@code{default-entry} (default: @code{0})"
  49300. msgstr ""
  49301. #. type: table
  49302. #: guix-git/doc/guix.texi:33254
  49303. msgid "The index of the default boot menu entry. Index 0 is for the entry of the current system."
  49304. msgstr ""
  49305. #. type: item
  49306. #: guix-git/doc/guix.texi:33255
  49307. #, no-wrap
  49308. msgid "@code{timeout} (default: @code{5})"
  49309. msgstr ""
  49310. #. type: table
  49311. #: guix-git/doc/guix.texi:33258
  49312. msgid "The number of seconds to wait for keyboard input before booting. Set to 0 to boot immediately, and to -1 to wait indefinitely."
  49313. msgstr ""
  49314. #. type: cindex
  49315. #: guix-git/doc/guix.texi:33259
  49316. #, no-wrap
  49317. msgid "keyboard layout, for the bootloader"
  49318. msgstr ""
  49319. #. type: table
  49320. #: guix-git/doc/guix.texi:33263
  49321. msgid "If this is @code{#f}, the bootloader's menu (if any) uses the default keyboard layout, usually US@tie{}English (``qwerty'')."
  49322. msgstr ""
  49323. #. type: table
  49324. #: guix-git/doc/guix.texi:33266
  49325. msgid "Otherwise, this must be a @code{keyboard-layout} object (@pxref{Keyboard Layout})."
  49326. msgstr ""
  49327. #. type: quotation
  49328. #: guix-git/doc/guix.texi:33270
  49329. msgid "This option is currently ignored by bootloaders other than @code{grub} and @code{grub-efi}."
  49330. msgstr ""
  49331. #. type: item
  49332. #: guix-git/doc/guix.texi:33272
  49333. #, no-wrap
  49334. msgid "@code{theme} (default: @var{#f})"
  49335. msgstr ""
  49336. #. type: table
  49337. #: guix-git/doc/guix.texi:33276
  49338. msgid "The bootloader theme object describing the theme to use. If no theme is provided, some bootloaders might use a default theme, that's true for GRUB."
  49339. msgstr ""
  49340. #. type: item
  49341. #: guix-git/doc/guix.texi:33277
  49342. #, no-wrap
  49343. msgid "@code{terminal-outputs} (default: @code{'(gfxterm)})"
  49344. msgstr ""
  49345. #. type: table
  49346. #: guix-git/doc/guix.texi:33284
  49347. msgid "The output terminals used for the bootloader boot menu, as a list of symbols. GRUB accepts the values: @code{console}, @code{serial}, @code{serial_@{0-3@}}, @code{gfxterm}, @code{vga_text}, @code{mda_text}, @code{morse}, and @code{pkmodem}. This field corresponds to the GRUB variable @code{GRUB_TERMINAL_OUTPUT} (@pxref{Simple configuration,,, grub,GNU GRUB manual})."
  49348. msgstr ""
  49349. #. type: item
  49350. #: guix-git/doc/guix.texi:33285
  49351. #, no-wrap
  49352. msgid "@code{terminal-inputs} (default: @code{'()})"
  49353. msgstr ""
  49354. #. type: table
  49355. #: guix-git/doc/guix.texi:33293
  49356. msgid "The input terminals used for the bootloader boot menu, as a list of symbols. For GRUB, the default is the native platform terminal as determined at run-time. GRUB accepts the values: @code{console}, @code{serial}, @code{serial_@{0-3@}}, @code{at_keyboard}, and @code{usb_keyboard}. This field corresponds to the GRUB variable @code{GRUB_TERMINAL_INPUT} (@pxref{Simple configuration,,, grub,GNU GRUB manual})."
  49357. msgstr ""
  49358. #. type: item
  49359. #: guix-git/doc/guix.texi:33294
  49360. #, no-wrap
  49361. msgid "@code{serial-unit} (default: @code{#f})"
  49362. msgstr ""
  49363. #. type: table
  49364. #: guix-git/doc/guix.texi:33298
  49365. msgid "The serial unit used by the bootloader, as an integer from 0 to 3. For GRUB, it is chosen at run-time; currently GRUB chooses 0, which corresponds to COM1 (@pxref{Serial terminal,,, grub,GNU GRUB manual})."
  49366. msgstr ""
  49367. #. type: item
  49368. #: guix-git/doc/guix.texi:33299
  49369. #, no-wrap
  49370. msgid "@code{serial-speed} (default: @code{#f})"
  49371. msgstr ""
  49372. #. type: table
  49373. #: guix-git/doc/guix.texi:33303
  49374. msgid "The speed of the serial interface, as an integer. For GRUB, the default value is chosen at run-time; currently GRUB chooses 9600@tie{}bps (@pxref{Serial terminal,,, grub,GNU GRUB manual})."
  49375. msgstr ""
  49376. #. type: cindex
  49377. #: guix-git/doc/guix.texi:33307
  49378. #, no-wrap
  49379. msgid "dual boot"
  49380. msgstr ""
  49381. #. type: cindex
  49382. #: guix-git/doc/guix.texi:33308
  49383. #, no-wrap
  49384. msgid "boot menu"
  49385. msgstr ""
  49386. #. type: Plain text
  49387. #: guix-git/doc/guix.texi:33314
  49388. msgid "Should you want to list additional boot menu entries @i{via} the @code{menu-entries} field above, you will need to create them with the @code{menu-entry} form. For example, imagine you want to be able to boot another distro (hard to imagine!), you can define a menu entry along these lines:"
  49389. msgstr ""
  49390. #. type: lisp
  49391. #: guix-git/doc/guix.texi:33321
  49392. #, no-wrap
  49393. msgid ""
  49394. "(menu-entry\n"
  49395. " (label \"The Other Distro\")\n"
  49396. " (linux \"/boot/old/vmlinux-2.6.32\")\n"
  49397. " (linux-arguments '(\"root=/dev/sda2\"))\n"
  49398. " (initrd \"/boot/old/initrd\"))\n"
  49399. msgstr ""
  49400. #. type: Plain text
  49401. #: guix-git/doc/guix.texi:33324
  49402. msgid "Details below."
  49403. msgstr ""
  49404. #. type: deftp
  49405. #: guix-git/doc/guix.texi:33325
  49406. #, no-wrap
  49407. msgid "{Data Type} menu-entry"
  49408. msgstr ""
  49409. #. type: deftp
  49410. #: guix-git/doc/guix.texi:33327
  49411. msgid "The type of an entry in the bootloader menu."
  49412. msgstr ""
  49413. #. type: table
  49414. #: guix-git/doc/guix.texi:33332
  49415. msgid "The label to show in the menu---e.g., @code{\"GNU\"}."
  49416. msgstr ""
  49417. #. type: item
  49418. #: guix-git/doc/guix.texi:33333
  49419. #, no-wrap
  49420. msgid "@code{linux} (default: @code{#f})"
  49421. msgstr ""
  49422. #. type: table
  49423. #: guix-git/doc/guix.texi:33335
  49424. msgid "The Linux kernel image to boot, for example:"
  49425. msgstr ""
  49426. #. type: lisp
  49427. #: guix-git/doc/guix.texi:33338
  49428. #, no-wrap
  49429. msgid "(file-append linux-libre \"/bzImage\")\n"
  49430. msgstr ""
  49431. #. type: table
  49432. #: guix-git/doc/guix.texi:33343
  49433. msgid "For GRUB, it is also possible to specify a device explicitly in the file path using GRUB's device naming convention (@pxref{Naming convention,,, grub, GNU GRUB manual}), for example:"
  49434. msgstr ""
  49435. #. type: example
  49436. #: guix-git/doc/guix.texi:33346
  49437. #, no-wrap
  49438. msgid "\"(hd0,msdos1)/boot/vmlinuz\"\n"
  49439. msgstr ""
  49440. #. type: table
  49441. #: guix-git/doc/guix.texi:33350
  49442. msgid "If the device is specified explicitly as above, then the @code{device} field is ignored entirely."
  49443. msgstr ""
  49444. #. type: item
  49445. #: guix-git/doc/guix.texi:33351
  49446. #, no-wrap
  49447. msgid "@code{linux-arguments} (default: @code{()})"
  49448. msgstr ""
  49449. #. type: table
  49450. #: guix-git/doc/guix.texi:33354
  49451. msgid "The list of extra Linux kernel command-line arguments---e.g., @code{(\"console=ttyS0\")}."
  49452. msgstr ""
  49453. #. type: item
  49454. #: guix-git/doc/guix.texi:33355
  49455. #, no-wrap
  49456. msgid "@code{initrd} (default: @code{#f})"
  49457. msgstr ""
  49458. #. type: table
  49459. #: guix-git/doc/guix.texi:33358
  49460. msgid "A G-Expression or string denoting the file name of the initial RAM disk to use (@pxref{G-Expressions})."
  49461. msgstr ""
  49462. #. type: item
  49463. #: guix-git/doc/guix.texi:33359
  49464. #, no-wrap
  49465. msgid "@code{device} (default: @code{#f})"
  49466. msgstr ""
  49467. #. type: table
  49468. #: guix-git/doc/guix.texi:33362
  49469. msgid "The device where the kernel and initrd are to be found---i.e., for GRUB, @dfn{root} for this menu entry (@pxref{root,,, grub, GNU GRUB manual})."
  49470. msgstr ""
  49471. #. type: table
  49472. #: guix-git/doc/guix.texi:33368
  49473. msgid "This may be a file system label (a string), a file system UUID (a bytevector, @pxref{File Systems}), or @code{#f}, in which case the bootloader will search the device containing the file specified by the @code{linux} field (@pxref{search,,, grub, GNU GRUB manual}). It must @emph{not} be an OS device name such as @file{/dev/sda1}."
  49474. msgstr ""
  49475. #. type: item
  49476. #: guix-git/doc/guix.texi:33369
  49477. #, no-wrap
  49478. msgid "@code{multiboot-kernel} (default: @code{#f})"
  49479. msgstr ""
  49480. #. type: table
  49481. #: guix-git/doc/guix.texi:33373
  49482. msgid "The kernel to boot in Multiboot-mode (@pxref{multiboot,,, grub, GNU GRUB manual}). When this field is set, a Multiboot menu-entry is generated. For example:"
  49483. msgstr ""
  49484. #. type: lisp
  49485. #: guix-git/doc/guix.texi:33376
  49486. #, no-wrap
  49487. msgid "(file-append mach \"/boot/gnumach\")\n"
  49488. msgstr ""
  49489. #. type: item
  49490. #: guix-git/doc/guix.texi:33378
  49491. #, no-wrap
  49492. msgid "@code{multiboot-arguments} (default: @code{()})"
  49493. msgstr ""
  49494. #. type: table
  49495. #: guix-git/doc/guix.texi:33380
  49496. msgid "The list of extra command-line arguments for the multiboot-kernel."
  49497. msgstr ""
  49498. #. type: item
  49499. #: guix-git/doc/guix.texi:33381
  49500. #, no-wrap
  49501. msgid "@code{multiboot-modules} (default: @code{()})"
  49502. msgstr ""
  49503. #. type: table
  49504. #: guix-git/doc/guix.texi:33383
  49505. msgid "The list of commands for loading Multiboot modules. For example:"
  49506. msgstr ""
  49507. #. type: lisp
  49508. #: guix-git/doc/guix.texi:33389
  49509. #, no-wrap
  49510. msgid ""
  49511. "(list (list (file-append hurd \"/hurd/ext2fs.static\") \"ext2fs\"\n"
  49512. " @dots{})\n"
  49513. " (list (file-append libc \"/lib/ld.so.1\") \"exec\"\n"
  49514. " @dots{}))\n"
  49515. msgstr ""
  49516. #. type: cindex
  49517. #: guix-git/doc/guix.texi:33394 guix-git/doc/guix.texi:33453
  49518. #, no-wrap
  49519. msgid "HDPI"
  49520. msgstr ""
  49521. #. type: cindex
  49522. #: guix-git/doc/guix.texi:33395 guix-git/doc/guix.texi:33454
  49523. #, no-wrap
  49524. msgid "HiDPI"
  49525. msgstr ""
  49526. #. type: cindex
  49527. #: guix-git/doc/guix.texi:33396 guix-git/doc/guix.texi:33455
  49528. #, no-wrap
  49529. msgid "resolution"
  49530. msgstr ""
  49531. #. type: Plain text
  49532. #: guix-git/doc/guix.texi:33400
  49533. msgid "For now only GRUB has theme support. GRUB themes are created using the @code{grub-theme} form, which is not fully documented yet."
  49534. msgstr ""
  49535. #. type: deftp
  49536. #: guix-git/doc/guix.texi:33401
  49537. #, no-wrap
  49538. msgid "{Data Type} grub-theme"
  49539. msgstr ""
  49540. #. type: deftp
  49541. #: guix-git/doc/guix.texi:33403
  49542. msgid "Data type representing the configuration of the GRUB theme."
  49543. msgstr ""
  49544. #. type: item
  49545. #: guix-git/doc/guix.texi:33405
  49546. #, no-wrap
  49547. msgid "@code{gfxmode} (default: @code{'(\"auto\")})"
  49548. msgstr ""
  49549. #. type: table
  49550. #: guix-git/doc/guix.texi:33408
  49551. msgid "The GRUB @code{gfxmode} to set (a list of screen resolution strings, @pxref{gfxmode,,, grub, GNU GRUB manual})."
  49552. msgstr ""
  49553. #. type: deffn
  49554. #: guix-git/doc/guix.texi:33411
  49555. #, no-wrap
  49556. msgid "{Scheme Procedure} grub-theme"
  49557. msgstr ""
  49558. #. type: deffn
  49559. #: guix-git/doc/guix.texi:33415
  49560. msgid "Return the default GRUB theme used by the operating system if no @code{theme} field is specified in @code{bootloader-configuration} record."
  49561. msgstr ""
  49562. #. type: deffn
  49563. #: guix-git/doc/guix.texi:33418
  49564. msgid "It comes with a fancy background image displaying the GNU and Guix logos."
  49565. msgstr ""
  49566. #. type: Plain text
  49567. #: guix-git/doc/guix.texi:33422
  49568. msgid "For example, to override the default resolution, you may use something like"
  49569. msgstr ""
  49570. #. type: lisp
  49571. #: guix-git/doc/guix.texi:33430
  49572. #, no-wrap
  49573. msgid ""
  49574. "(bootloader\n"
  49575. " (bootloader-configuration\n"
  49576. " ;; @dots{}\n"
  49577. " (theme (grub-theme\n"
  49578. " (inherit (grub-theme))\n"
  49579. " (gfxmode '(\"1024x786x32\" \"auto\"))))))\n"
  49580. msgstr ""
  49581. #. type: section
  49582. #: guix-git/doc/guix.texi:33433
  49583. #, no-wrap
  49584. msgid "Invoking @code{guix system}"
  49585. msgstr ""
  49586. #. type: Plain text
  49587. #: guix-git/doc/guix.texi:33438
  49588. msgid "Once you have written an operating system declaration as seen in the previous section, it can be @dfn{instantiated} using the @command{guix system} command. The synopsis is:"
  49589. msgstr ""
  49590. #. type: example
  49591. #: guix-git/doc/guix.texi:33441
  49592. #, no-wrap
  49593. msgid "guix system @var{options}@dots{} @var{action} @var{file}\n"
  49594. msgstr ""
  49595. #. type: Plain text
  49596. #: guix-git/doc/guix.texi:33447
  49597. msgid "@var{file} must be the name of a file containing an @code{operating-system} declaration. @var{action} specifies how the operating system is instantiated. Currently the following values are supported:"
  49598. msgstr ""
  49599. #. type: item
  49600. #: guix-git/doc/guix.texi:33449
  49601. #, no-wrap
  49602. msgid "search"
  49603. msgstr ""
  49604. #. type: table
  49605. #: guix-git/doc/guix.texi:33452
  49606. msgid "Display available service type definitions that match the given regular expressions, sorted by relevance:"
  49607. msgstr ""
  49608. #. type: example
  49609. #: guix-git/doc/guix.texi:33474
  49610. #, no-wrap
  49611. msgid ""
  49612. "$ guix system search console\n"
  49613. "name: console-fonts\n"
  49614. "location: gnu/services/base.scm:806:2\n"
  49615. "extends: shepherd-root\n"
  49616. "description: Install the given fonts on the specified ttys (fonts are per\n"
  49617. "+ virtual console on GNU/Linux). The value of this service is a list of\n"
  49618. "+ tty/font pairs. The font can be the name of a font provided by the `kbd'\n"
  49619. "+ package or any valid argument to `setfont', as in this example:\n"
  49620. "+\n"
  49621. "+ '((\"tty1\" . \"LatGrkCyr-8x16\")\n"
  49622. "+ (\"tty2\" . (file-append\n"
  49623. "+ font-tamzen\n"
  49624. "+ \"/share/kbd/consolefonts/TamzenForPowerline10x20.psf\"))\n"
  49625. "+ (\"tty3\" . (file-append\n"
  49626. "+ font-terminus\n"
  49627. "+ \"/share/consolefonts/ter-132n\"))) ; for HDPI\n"
  49628. "relevance: 9\n"
  49629. "\n"
  49630. msgstr ""
  49631. #. type: example
  49632. #: guix-git/doc/guix.texi:33480
  49633. #, no-wrap
  49634. msgid ""
  49635. "name: mingetty\n"
  49636. "location: gnu/services/base.scm:1190:2\n"
  49637. "extends: shepherd-root\n"
  49638. "description: Provide console login using the `mingetty' program.\n"
  49639. "relevance: 2\n"
  49640. "\n"
  49641. msgstr ""
  49642. #. type: example
  49643. #: guix-git/doc/guix.texi:33487
  49644. #, no-wrap
  49645. msgid ""
  49646. "name: login\n"
  49647. "location: gnu/services/base.scm:860:2\n"
  49648. "extends: pam\n"
  49649. "description: Provide a console log-in service as specified by its\n"
  49650. "+ configuration value, a `login-configuration' object.\n"
  49651. "relevance: 2\n"
  49652. "\n"
  49653. msgstr ""
  49654. #. type: example
  49655. #: guix-git/doc/guix.texi:33489
  49656. #, no-wrap
  49657. msgid "@dots{}\n"
  49658. msgstr ""
  49659. #. type: table
  49660. #: guix-git/doc/guix.texi:33494
  49661. msgid "As for @command{guix package --search}, the result is written in @code{recutils} format, which makes it easy to filter the output (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual})."
  49662. msgstr ""
  49663. #. type: item
  49664. #: guix-git/doc/guix.texi:33495
  49665. #, no-wrap
  49666. msgid "reconfigure"
  49667. msgstr ""
  49668. #. type: table
  49669. #: guix-git/doc/guix.texi:33500
  49670. msgid "Build the operating system described in @var{file}, activate it, and switch to it@footnote{This action (and the related actions @code{switch-generation} and @code{roll-back}) are usable only on systems already running Guix System.}."
  49671. msgstr ""
  49672. #. type: quotation
  49673. #: guix-git/doc/guix.texi:33508
  49674. msgid "It is highly recommended to run @command{guix pull} once before you run @command{guix system reconfigure} for the first time (@pxref{Invoking guix pull}). Failing to do that you would see an older version of Guix once @command{reconfigure} has completed."
  49675. msgstr ""
  49676. #. type: table
  49677. #: guix-git/doc/guix.texi:33516
  49678. msgid "This effects all the configuration specified in @var{file}: user accounts, system services, global package list, setuid programs, etc. The command starts system services specified in @var{file} that are not currently running; if a service is currently running this command will arrange for it to be upgraded the next time it is stopped (e.g.@: by @code{herd stop X} or @code{herd restart X})."
  49679. msgstr ""
  49680. #. type: table
  49681. #: guix-git/doc/guix.texi:33522
  49682. msgid "This command creates a new generation whose number is one greater than the current generation (as reported by @command{guix system list-generations}). If that generation already exists, it will be overwritten. This behavior mirrors that of @command{guix package} (@pxref{Invoking guix package})."
  49683. msgstr ""
  49684. #. type: table
  49685. #: guix-git/doc/guix.texi:33527
  49686. msgid "It also adds a bootloader menu entry for the new OS configuration, ---unless @option{--no-bootloader} is passed. For GRUB, it moves entries for older configurations to a submenu, allowing you to choose an older system generation at boot time should you need it."
  49687. msgstr ""
  49688. #. type: cindex
  49689. #: guix-git/doc/guix.texi:33528 guix-git/doc/guix.texi:33853
  49690. #: guix-git/doc/guix.texi:34805
  49691. #, no-wrap
  49692. msgid "provenance tracking, of the operating system"
  49693. msgstr ""
  49694. #. type: table
  49695. #: guix-git/doc/guix.texi:33533
  49696. msgid "Upon completion, the new system is deployed under @file{/run/current-system}. This directory contains @dfn{provenance meta-data}: the list of channels in use (@pxref{Channels}) and @var{file} itself, when available. You can view it by running:"
  49697. msgstr ""
  49698. #. type: example
  49699. #: guix-git/doc/guix.texi:33536
  49700. #, no-wrap
  49701. msgid "guix system describe\n"
  49702. msgstr ""
  49703. #. type: table
  49704. #: guix-git/doc/guix.texi:33542
  49705. msgid "This information is useful should you later want to inspect how this particular generation was built. In fact, assuming @var{file} is self-contained, you can later rebuild generation @var{n} of your operating system with:"
  49706. msgstr ""
  49707. #. type: example
  49708. #: guix-git/doc/guix.texi:33548
  49709. #, no-wrap
  49710. msgid ""
  49711. "guix time-machine \\\n"
  49712. " -C /var/guix/profiles/system-@var{n}-link/channels.scm -- \\\n"
  49713. " system reconfigure \\\n"
  49714. " /var/guix/profiles/system-@var{n}-link/configuration.scm\n"
  49715. msgstr ""
  49716. #. type: table
  49717. #: guix-git/doc/guix.texi:33554
  49718. msgid "You can think of it as some sort of built-in version control! Your system is not just a binary artifact: @emph{it carries its own source}. @xref{Service Reference, @code{provenance-service-type}}, for more information on provenance tracking."
  49719. msgstr ""
  49720. #. type: table
  49721. #: guix-git/doc/guix.texi:33560
  49722. msgid "By default, @command{reconfigure} @emph{prevents you from downgrading your system}, which could (re)introduce security vulnerabilities and also cause problems with ``stateful'' services such as database management systems. You can override that behavior by passing @option{--allow-downgrades}."
  49723. msgstr ""
  49724. #. type: item
  49725. #: guix-git/doc/guix.texi:33561
  49726. #, no-wrap
  49727. msgid "switch-generation"
  49728. msgstr ""
  49729. #. type: table
  49730. #: guix-git/doc/guix.texi:33570
  49731. msgid "Switch to an existing system generation. This action atomically switches the system profile to the specified system generation. It also rearranges the system's existing bootloader menu entries. It makes the menu entry for the specified system generation the default, and it moves the entries for the other generations to a submenu, if supported by the bootloader being used. The next time the system boots, it will use the specified system generation."
  49732. msgstr ""
  49733. #. type: table
  49734. #: guix-git/doc/guix.texi:33574
  49735. msgid "The bootloader itself is not being reinstalled when using this command. Thus, the installed bootloader is used with an updated configuration file."
  49736. msgstr ""
  49737. #. type: table
  49738. #: guix-git/doc/guix.texi:33578
  49739. msgid "The target generation can be specified explicitly by its generation number. For example, the following invocation would switch to system generation 7:"
  49740. msgstr ""
  49741. #. type: example
  49742. #: guix-git/doc/guix.texi:33581
  49743. #, no-wrap
  49744. msgid "guix system switch-generation 7\n"
  49745. msgstr ""
  49746. #. type: table
  49747. #: guix-git/doc/guix.texi:33589
  49748. msgid "The target generation can also be specified relative to the current generation with the form @code{+N} or @code{-N}, where @code{+3} means ``3 generations ahead of the current generation,'' and @code{-1} means ``1 generation prior to the current generation.'' When specifying a negative value such as @code{-1}, you must precede it with @code{--} to prevent it from being parsed as an option. For example:"
  49749. msgstr ""
  49750. #. type: example
  49751. #: guix-git/doc/guix.texi:33592
  49752. #, no-wrap
  49753. msgid "guix system switch-generation -- -1\n"
  49754. msgstr ""
  49755. #. type: table
  49756. #: guix-git/doc/guix.texi:33600
  49757. msgid "Currently, the effect of invoking this action is @emph{only} to switch the system profile to an existing generation and rearrange the bootloader menu entries. To actually start using the target system generation, you must reboot after running this action. In the future, it will be updated to do the same things as @command{reconfigure}, like activating and deactivating services."
  49758. msgstr ""
  49759. #. type: table
  49760. #: guix-git/doc/guix.texi:33602
  49761. msgid "This action will fail if the specified generation does not exist."
  49762. msgstr ""
  49763. #. type: item
  49764. #: guix-git/doc/guix.texi:33603
  49765. #, no-wrap
  49766. msgid "roll-back"
  49767. msgstr ""
  49768. #. type: table
  49769. #: guix-git/doc/guix.texi:33609
  49770. msgid "Switch to the preceding system generation. The next time the system boots, it will use the preceding system generation. This is the inverse of @command{reconfigure}, and it is exactly the same as invoking @command{switch-generation} with an argument of @code{-1}."
  49771. msgstr ""
  49772. #. type: table
  49773. #: guix-git/doc/guix.texi:33613
  49774. msgid "Currently, as with @command{switch-generation}, you must reboot after running this action to actually start using the preceding system generation."
  49775. msgstr ""
  49776. #. type: item
  49777. #: guix-git/doc/guix.texi:33614
  49778. #, no-wrap
  49779. msgid "delete-generations"
  49780. msgstr ""
  49781. #. type: cindex
  49782. #: guix-git/doc/guix.texi:33615
  49783. #, no-wrap
  49784. msgid "deleting system generations"
  49785. msgstr ""
  49786. #. type: cindex
  49787. #: guix-git/doc/guix.texi:33616
  49788. #, no-wrap
  49789. msgid "saving space"
  49790. msgstr ""
  49791. #. type: table
  49792. #: guix-git/doc/guix.texi:33620
  49793. msgid "Delete system generations, making them candidates for garbage collection (@pxref{Invoking guix gc}, for information on how to run the ``garbage collector'')."
  49794. msgstr ""
  49795. #. type: table
  49796. #: guix-git/doc/guix.texi:33624
  49797. msgid "This works in the same way as @samp{guix package --delete-generations} (@pxref{Invoking guix package, @option{--delete-generations}}). With no arguments, all system generations but the current one are deleted:"
  49798. msgstr ""
  49799. #. type: example
  49800. #: guix-git/doc/guix.texi:33627
  49801. #, no-wrap
  49802. msgid "guix system delete-generations\n"
  49803. msgstr ""
  49804. #. type: table
  49805. #: guix-git/doc/guix.texi:33631
  49806. msgid "You can also select the generations you want to delete. The example below deletes all the system generations that are more than two month old:"
  49807. msgstr ""
  49808. #. type: example
  49809. #: guix-git/doc/guix.texi:33634
  49810. #, no-wrap
  49811. msgid "guix system delete-generations 2m\n"
  49812. msgstr ""
  49813. #. type: table
  49814. #: guix-git/doc/guix.texi:33639
  49815. msgid "Running this command automatically reinstalls the bootloader with an updated list of menu entries---e.g., the ``old generations'' sub-menu in GRUB no longer lists the generations that have been deleted."
  49816. msgstr ""
  49817. #. type: table
  49818. #: guix-git/doc/guix.texi:33644
  49819. msgid "Build the derivation of the operating system, which includes all the configuration files and programs needed to boot and run the system. This action does not actually install anything."
  49820. msgstr ""
  49821. #. type: item
  49822. #: guix-git/doc/guix.texi:33645
  49823. #, no-wrap
  49824. msgid "init"
  49825. msgstr ""
  49826. #. type: table
  49827. #: guix-git/doc/guix.texi:33649
  49828. msgid "Populate the given directory with all the files necessary to run the operating system specified in @var{file}. This is useful for first-time installations of Guix System. For instance:"
  49829. msgstr ""
  49830. #. type: example
  49831. #: guix-git/doc/guix.texi:33652
  49832. #, no-wrap
  49833. msgid "guix system init my-os-config.scm /mnt\n"
  49834. msgstr ""
  49835. #. type: table
  49836. #: guix-git/doc/guix.texi:33659
  49837. msgid "copies to @file{/mnt} all the store items required by the configuration specified in @file{my-os-config.scm}. This includes configuration files, packages, and so on. It also creates other essential files needed for the system to operate correctly---e.g., the @file{/etc}, @file{/var}, and @file{/run} directories, and the @file{/bin/sh} file."
  49838. msgstr ""
  49839. #. type: table
  49840. #: guix-git/doc/guix.texi:33663
  49841. msgid "This command also installs bootloader on the target specified in @file{my-os-config}, unless the @option{--no-bootloader} option was passed."
  49842. msgstr ""
  49843. #. type: item
  49844. #: guix-git/doc/guix.texi:33664
  49845. #, no-wrap
  49846. msgid "vm"
  49847. msgstr ""
  49848. #. type: cindex
  49849. #: guix-git/doc/guix.texi:33665 guix-git/doc/guix.texi:34226
  49850. #, no-wrap
  49851. msgid "virtual machine"
  49852. msgstr ""
  49853. #. type: cindex
  49854. #: guix-git/doc/guix.texi:33666
  49855. #, no-wrap
  49856. msgid "VM"
  49857. msgstr ""
  49858. #. type: anchor{#1}
  49859. #: guix-git/doc/guix.texi:33670
  49860. msgid "guix system vm"
  49861. msgstr ""
  49862. #. type: table
  49863. #: guix-git/doc/guix.texi:33670
  49864. msgid "Build a virtual machine that contains the operating system declared in @var{file}, and return a script to run that virtual machine (VM)."
  49865. msgstr ""
  49866. #. type: quotation
  49867. #: guix-git/doc/guix.texi:33678
  49868. msgid "The @code{vm} action and others below can use KVM support in the Linux-libre kernel. Specifically, if the machine has hardware virtualization support, the corresponding KVM kernel module should be loaded, and the @file{/dev/kvm} device node must exist and be readable and writable by the user and by the build users of the daemon (@pxref{Build Environment Setup})."
  49869. msgstr ""
  49870. #. type: table
  49871. #: guix-git/doc/guix.texi:33683
  49872. msgid "Arguments given to the script are passed to QEMU as in the example below, which enables networking and requests 1@tie{}GiB of RAM for the emulated machine:"
  49873. msgstr ""
  49874. #. type: example
  49875. #: guix-git/doc/guix.texi:33686
  49876. #, no-wrap
  49877. msgid "$ /gnu/store/@dots{}-run-vm.sh -m 1024 -smp 2 -nic user,model=virtio-net-pci\n"
  49878. msgstr ""
  49879. #. type: table
  49880. #: guix-git/doc/guix.texi:33689
  49881. msgid "The VM shares its store with the host system."
  49882. msgstr ""
  49883. #. type: table
  49884. #: guix-git/doc/guix.texi:33694
  49885. msgid "Additional file systems can be shared between the host and the VM using the @option{--share} and @option{--expose} command-line options: the former specifies a directory to be shared with write access, while the latter provides read-only access to the shared directory."
  49886. msgstr ""
  49887. #. type: table
  49888. #: guix-git/doc/guix.texi:33698
  49889. msgid "The example below creates a VM in which the user's home directory is accessible read-only, and where the @file{/exchange} directory is a read-write mapping of @file{$HOME/tmp} on the host:"
  49890. msgstr ""
  49891. #. type: example
  49892. #: guix-git/doc/guix.texi:33702
  49893. #, no-wrap
  49894. msgid ""
  49895. "guix system vm my-config.scm \\\n"
  49896. " --expose=$HOME --share=$HOME/tmp=/exchange\n"
  49897. msgstr ""
  49898. #. type: table
  49899. #: guix-git/doc/guix.texi:33707
  49900. msgid "On GNU/Linux, the default is to boot directly to the kernel; this has the advantage of requiring only a very tiny root disk image since the store of the host can then be mounted."
  49901. msgstr ""
  49902. #. type: table
  49903. #: guix-git/doc/guix.texi:33713
  49904. msgid "The @option{--full-boot} option forces a complete boot sequence, starting with the bootloader. This requires more disk space since a root image containing at least the kernel, initrd, and bootloader data files must be created. The @option{--image-size} option can be used to specify the size of the image."
  49905. msgstr ""
  49906. #. type: cindex
  49907. #: guix-git/doc/guix.texi:33714
  49908. #, no-wrap
  49909. msgid "System images, creation in various formats"
  49910. msgstr ""
  49911. #. type: cindex
  49912. #: guix-git/doc/guix.texi:33715
  49913. #, no-wrap
  49914. msgid "Creating system images in various formats"
  49915. msgstr ""
  49916. #. type: item
  49917. #: guix-git/doc/guix.texi:33716
  49918. #, no-wrap
  49919. msgid "image"
  49920. msgstr ""
  49921. #. type: itemx
  49922. #: guix-git/doc/guix.texi:33717
  49923. #, no-wrap
  49924. msgid "docker-image"
  49925. msgstr ""
  49926. #. type: table
  49927. #: guix-git/doc/guix.texi:33725
  49928. msgid "Return a virtual machine, disk image, or Docker image of the operating system declared in @var{file} that stands alone. By default, @command{guix system} estimates the size of the image needed to store the system, but you can use the @option{--image-size} option to specify a value. Docker images are built to contain exactly what they need, so the @option{--image-size} option is ignored in the case of @code{docker-image}."
  49929. msgstr ""
  49930. #. type: cindex
  49931. #: guix-git/doc/guix.texi:33726
  49932. #, no-wrap
  49933. msgid "image, creating disk images"
  49934. msgstr ""
  49935. #. type: table
  49936. #: guix-git/doc/guix.texi:33738
  49937. msgid "The @code{image} command can produce various image types. The image type can be selected using the @option{--image-type} option. It defaults to @code{efi-raw}. When its value is @code{iso9660}, the @option{--label} option can be used to specify a volume ID with @code{image}. By default, the root file system of a disk image is mounted non-volatile; the @option{--volatile} option can be provided to make it volatile instead. When using @code{image}, the bootloader installed on the generated image is taken from the provided @code{operating-system} definition. The following example demonstrates how to generate an image that uses the @code{grub-efi-bootloader} bootloader and boot it with QEMU:"
  49938. msgstr ""
  49939. #. type: example
  49940. #: guix-git/doc/guix.texi:33746
  49941. #, no-wrap
  49942. msgid ""
  49943. "image=$(guix system image --image-type=qcow2 \\\n"
  49944. " gnu/system/examples/lightweight-desktop.tmpl)\n"
  49945. "cp $image /tmp/my-image.qcow2\n"
  49946. "chmod +w /tmp/my-image.qcow2\n"
  49947. "qemu-system-x86_64 -enable-kvm -hda /tmp/my-image.qcow2 -m 1000 \\\n"
  49948. " -bios $(guix build ovmf)/share/firmware/ovmf_x64.bin\n"
  49949. msgstr ""
  49950. #. type: table
  49951. #: guix-git/doc/guix.texi:33752
  49952. msgid "When using the @code{efi-raw} image type, a raw disk image is produced; it can be copied as is to a USB stick, for instance. Assuming @code{/dev/sdc} is the device corresponding to a USB stick, one can copy the image to it using the following command:"
  49953. msgstr ""
  49954. #. type: example
  49955. #: guix-git/doc/guix.texi:33755
  49956. #, no-wrap
  49957. msgid "# dd if=$(guix system image my-os.scm) of=/dev/sdc status=progress\n"
  49958. msgstr ""
  49959. #. type: table
  49960. #: guix-git/doc/guix.texi:33759
  49961. msgid "The @code{--list-image-types} command lists all the available image types."
  49962. msgstr ""
  49963. #. type: cindex
  49964. #: guix-git/doc/guix.texi:33760
  49965. #, no-wrap
  49966. msgid "creating virtual machine images"
  49967. msgstr ""
  49968. #. type: table
  49969. #: guix-git/doc/guix.texi:33769
  49970. msgid "When using the @code{qcow2} image type, the returned image is in qcow2 format, which the QEMU emulator can efficiently use. @xref{Running Guix in a VM}, for more information on how to run the image in a virtual machine. The @code{grub-bootloader} bootloader is always used independently of what is declared in the @code{operating-system} file passed as argument. This is to make it easier to work with QEMU, which uses the SeaBIOS BIOS by default, expecting a bootloader to be installed in the Master Boot Record (MBR)."
  49971. msgstr ""
  49972. #. type: cindex
  49973. #: guix-git/doc/guix.texi:33770
  49974. #, no-wrap
  49975. msgid "docker-image, creating docker images"
  49976. msgstr ""
  49977. #. type: table
  49978. #: guix-git/doc/guix.texi:33776
  49979. msgid "When using @code{docker-image}, a Docker image is produced. Guix builds the image from scratch, not from a pre-existing Docker base image. As a result, it contains @emph{exactly} what you define in the operating system configuration file. You can then load the image and launch a Docker container using commands like the following:"
  49980. msgstr ""
  49981. #. type: example
  49982. #: guix-git/doc/guix.texi:33781
  49983. #, no-wrap
  49984. msgid ""
  49985. "image_id=\"$(docker load < guix-system-docker-image.tar.gz)\"\n"
  49986. "container_id=\"$(docker create $image_id)\"\n"
  49987. "docker start $container_id\n"
  49988. msgstr ""
  49989. #. type: table
  49990. #: guix-git/doc/guix.texi:33788
  49991. msgid "This command starts a new Docker container from the specified image. It will boot the Guix system in the usual manner, which means it will start any services you have defined in the operating system configuration. You can get an interactive shell running in the container using @command{docker exec}:"
  49992. msgstr ""
  49993. #. type: example
  49994. #: guix-git/doc/guix.texi:33791
  49995. #, no-wrap
  49996. msgid "docker exec -ti $container_id /run/current-system/profile/bin/bash --login\n"
  49997. msgstr ""
  49998. #. type: table
  49999. #: guix-git/doc/guix.texi:33798
  50000. msgid "Depending on what you run in the Docker container, it may be necessary to give the container additional permissions. For example, if you intend to build software using Guix inside of the Docker container, you may need to pass the @option{--privileged} option to @code{docker create}."
  50001. msgstr ""
  50002. #. type: table
  50003. #: guix-git/doc/guix.texi:33802
  50004. msgid "Last, the @option{--network} option applies to @command{guix system docker-image}: it produces an image where network is supposedly shared with the host, and thus without services like nscd or NetworkManager."
  50005. msgstr ""
  50006. #. type: table
  50007. #: guix-git/doc/guix.texi:33810
  50008. msgid "Return a script to run the operating system declared in @var{file} within a container. Containers are a set of lightweight isolation mechanisms provided by the kernel Linux-libre. Containers are substantially less resource-demanding than full virtual machines since the kernel, shared objects, and other resources can be shared with the host system; this also means they provide thinner isolation."
  50009. msgstr ""
  50010. #. type: table
  50011. #: guix-git/doc/guix.texi:33814
  50012. msgid "Currently, the script must be run as root in order to support more than a single user and group. The container shares its store with the host system."
  50013. msgstr ""
  50014. #. type: table
  50015. #: guix-git/doc/guix.texi:33818
  50016. msgid "As with the @code{vm} action (@pxref{guix system vm}), additional file systems to be shared between the host and container can be specified using the @option{--share} and @option{--expose} options:"
  50017. msgstr ""
  50018. #. type: example
  50019. #: guix-git/doc/guix.texi:33822
  50020. #, no-wrap
  50021. msgid ""
  50022. "guix system container my-config.scm \\\n"
  50023. " --expose=$HOME --share=$HOME/tmp=/exchange\n"
  50024. msgstr ""
  50025. #. type: quotation
  50026. #: guix-git/doc/guix.texi:33826
  50027. msgid "This option requires Linux-libre 3.19 or newer."
  50028. msgstr ""
  50029. #. type: Plain text
  50030. #: guix-git/doc/guix.texi:33833
  50031. msgid "@var{options} can contain any of the common build options (@pxref{Common Build Options}). In addition, @var{options} can contain one of the following:"
  50032. msgstr ""
  50033. #. type: table
  50034. #: guix-git/doc/guix.texi:33842
  50035. msgid "Consider the operating-system @var{expr} evaluates to. This is an alternative to specifying a file which evaluates to an operating system. This is used to generate the Guix system installer @pxref{Building the Installation Image})."
  50036. msgstr ""
  50037. #. type: table
  50038. #: guix-git/doc/guix.texi:33847
  50039. msgid "Attempt to build for @var{system} instead of the host system type. This works as per @command{guix build} (@pxref{Invoking guix build})."
  50040. msgstr ""
  50041. #. type: table
  50042. #: guix-git/doc/guix.texi:33852
  50043. msgid "Return the derivation file name of the given operating system without building anything."
  50044. msgstr ""
  50045. #. type: table
  50046. #: guix-git/doc/guix.texi:33861
  50047. msgid "As discussed above, @command{guix system init} and @command{guix system reconfigure} always save provenance information @i{via} a dedicated service (@pxref{Service Reference, @code{provenance-service-type}}). However, other commands don't do that by default. If you wish to, say, create a virtual machine image that contains provenance information, you can run:"
  50048. msgstr ""
  50049. #. type: example
  50050. #: guix-git/doc/guix.texi:33864
  50051. #, no-wrap
  50052. msgid "guix system image -t qcow2 --save-provenance config.scm\n"
  50053. msgstr ""
  50054. #. type: table
  50055. #: guix-git/doc/guix.texi:33871
  50056. msgid "That way, the resulting image will effectively ``embed its own source'' in the form of meta-data in @file{/run/current-system}. With that information, one can rebuild the image to make sure it really contains what it pretends to contain; or they could use that to derive a variant of the image."
  50057. msgstr ""
  50058. #. type: item
  50059. #: guix-git/doc/guix.texi:33872
  50060. #, no-wrap
  50061. msgid "--image-type=@var{type}"
  50062. msgstr ""
  50063. #. type: table
  50064. #: guix-git/doc/guix.texi:33875
  50065. msgid "For the @code{image} action, create an image with given @var{type}."
  50066. msgstr ""
  50067. #. type: table
  50068. #: guix-git/doc/guix.texi:33878
  50069. msgid "When this option is omitted, @command{guix system} uses the @code{efi-raw} image type."
  50070. msgstr ""
  50071. #. type: cindex
  50072. #: guix-git/doc/guix.texi:33879
  50073. #, no-wrap
  50074. msgid "ISO-9660 format"
  50075. msgstr ""
  50076. #. type: cindex
  50077. #: guix-git/doc/guix.texi:33880
  50078. #, no-wrap
  50079. msgid "CD image format"
  50080. msgstr ""
  50081. #. type: cindex
  50082. #: guix-git/doc/guix.texi:33881
  50083. #, no-wrap
  50084. msgid "DVD image format"
  50085. msgstr ""
  50086. #. type: table
  50087. #: guix-git/doc/guix.texi:33884
  50088. msgid "@option{--image-type=iso9660} produces an ISO-9660 image, suitable for burning on CDs and DVDs."
  50089. msgstr ""
  50090. #. type: item
  50091. #: guix-git/doc/guix.texi:33885
  50092. #, no-wrap
  50093. msgid "--image-size=@var{size}"
  50094. msgstr ""
  50095. #. type: table
  50096. #: guix-git/doc/guix.texi:33890
  50097. msgid "For the @code{image} action, create an image of the given @var{size}. @var{size} may be a number of bytes, or it may include a unit as a suffix (@pxref{Block size, size specifications,, coreutils, GNU Coreutils})."
  50098. msgstr ""
  50099. #. type: table
  50100. #: guix-git/doc/guix.texi:33894
  50101. msgid "When this option is omitted, @command{guix system} computes an estimate of the image size as a function of the size of the system declared in @var{file}."
  50102. msgstr ""
  50103. #. type: table
  50104. #: guix-git/doc/guix.texi:33899
  50105. msgid "For the @code{container} action, allow containers to access the host network, that is, do not create a network namespace."
  50106. msgstr ""
  50107. #. type: item
  50108. #: guix-git/doc/guix.texi:33905
  50109. #, no-wrap
  50110. msgid "--skip-checks"
  50111. msgstr ""
  50112. #. type: table
  50113. #: guix-git/doc/guix.texi:33907
  50114. msgid "Skip pre-installation safety checks."
  50115. msgstr ""
  50116. #. type: table
  50117. #: guix-git/doc/guix.texi:33914
  50118. msgid "By default, @command{guix system init} and @command{guix system reconfigure} perform safety checks: they make sure the file systems that appear in the @code{operating-system} declaration actually exist (@pxref{File Systems}), and that any Linux kernel modules that may be needed at boot time are listed in @code{initrd-modules} (@pxref{Initial RAM Disk}). Passing this option skips these tests altogether."
  50119. msgstr ""
  50120. #. type: table
  50121. #: guix-git/doc/guix.texi:33917
  50122. msgid "Instruct @command{guix system reconfigure} to allow system downgrades."
  50123. msgstr ""
  50124. #. type: table
  50125. #: guix-git/doc/guix.texi:33925
  50126. msgid "By default, @command{reconfigure} prevents you from downgrading your system. It achieves that by comparing the provenance info of your system (shown by @command{guix system describe}) with that of your @command{guix} command (shown by @command{guix describe}). If the commits for @command{guix} are not descendants of those used for your system, @command{guix system reconfigure} errors out. Passing @option{--allow-downgrades} allows you to bypass these checks."
  50127. msgstr ""
  50128. #. type: cindex
  50129. #: guix-git/doc/guix.texi:33931
  50130. #, no-wrap
  50131. msgid "on-error"
  50132. msgstr ""
  50133. #. type: cindex
  50134. #: guix-git/doc/guix.texi:33932
  50135. #, no-wrap
  50136. msgid "on-error strategy"
  50137. msgstr ""
  50138. #. type: cindex
  50139. #: guix-git/doc/guix.texi:33933
  50140. #, no-wrap
  50141. msgid "error strategy"
  50142. msgstr ""
  50143. #. type: item
  50144. #: guix-git/doc/guix.texi:33934
  50145. #, no-wrap
  50146. msgid "--on-error=@var{strategy}"
  50147. msgstr ""
  50148. #. type: table
  50149. #: guix-git/doc/guix.texi:33937
  50150. msgid "Apply @var{strategy} when an error occurs when reading @var{file}. @var{strategy} may be one of the following:"
  50151. msgstr ""
  50152. #. type: item
  50153. #: guix-git/doc/guix.texi:33939
  50154. #, no-wrap
  50155. msgid "nothing-special"
  50156. msgstr ""
  50157. #. type: table
  50158. #: guix-git/doc/guix.texi:33941
  50159. msgid "Report the error concisely and exit. This is the default strategy."
  50160. msgstr ""
  50161. #. type: item
  50162. #: guix-git/doc/guix.texi:33942
  50163. #, no-wrap
  50164. msgid "backtrace"
  50165. msgstr ""
  50166. #. type: table
  50167. #: guix-git/doc/guix.texi:33944
  50168. msgid "Likewise, but also display a backtrace."
  50169. msgstr ""
  50170. #. type: item
  50171. #: guix-git/doc/guix.texi:33945
  50172. #, no-wrap
  50173. msgid "debug"
  50174. msgstr ""
  50175. #. type: table
  50176. #: guix-git/doc/guix.texi:33951
  50177. msgid "Report the error and enter Guile's debugger. From there, you can run commands such as @code{,bt} to get a backtrace, @code{,locals} to display local variable values, and more generally inspect the state of the program. @xref{Debug Commands,,, guile, GNU Guile Reference Manual}, for a list of available debugging commands."
  50178. msgstr ""
  50179. #. type: Plain text
  50180. #: guix-git/doc/guix.texi:33958
  50181. msgid "Once you have built, configured, re-configured, and re-re-configured your Guix installation, you may find it useful to list the operating system generations available on disk---and that you can choose from the bootloader boot menu:"
  50182. msgstr ""
  50183. #. type: item
  50184. #: guix-git/doc/guix.texi:33961
  50185. #, no-wrap
  50186. msgid "describe"
  50187. msgstr ""
  50188. #. type: table
  50189. #: guix-git/doc/guix.texi:33964
  50190. msgid "Describe the current system generation: its file name, the kernel and bootloader used, etc., as well as provenance information when available."
  50191. msgstr ""
  50192. #. type: item
  50193. #: guix-git/doc/guix.texi:33965
  50194. #, no-wrap
  50195. msgid "list-generations"
  50196. msgstr ""
  50197. #. type: table
  50198. #: guix-git/doc/guix.texi:33970
  50199. msgid "List a summary of each generation of the operating system available on disk, in a human-readable way. This is similar to the @option{--list-generations} option of @command{guix package} (@pxref{Invoking guix package})."
  50200. msgstr ""
  50201. #. type: table
  50202. #: guix-git/doc/guix.texi:33975
  50203. msgid "Optionally, one can specify a pattern, with the same syntax that is used in @command{guix package --list-generations}, to restrict the list of generations displayed. For instance, the following command displays generations that are up to 10 days old:"
  50204. msgstr ""
  50205. #. type: example
  50206. #: guix-git/doc/guix.texi:33978
  50207. #, no-wrap
  50208. msgid "$ guix system list-generations 10d\n"
  50209. msgstr ""
  50210. #. type: Plain text
  50211. #: guix-git/doc/guix.texi:33985
  50212. msgid "The @command{guix system} command has even more to offer! The following sub-commands allow you to visualize how your system services relate to each other:"
  50213. msgstr ""
  50214. #. type: anchor{#1}
  50215. #: guix-git/doc/guix.texi:33987
  50216. msgid "system-extension-graph"
  50217. msgstr ""
  50218. #. type: item
  50219. #: guix-git/doc/guix.texi:33989
  50220. #, no-wrap
  50221. msgid "extension-graph"
  50222. msgstr ""
  50223. #. type: table
  50224. #: guix-git/doc/guix.texi:33996
  50225. msgid "Emit to standard output the @dfn{service extension graph} of the operating system defined in @var{file} (@pxref{Service Composition}, for more information on service extensions). By default the output is in Dot/Graphviz format, but you can choose a different format with @option{--graph-backend}, as with @command{guix graph} (@pxref{Invoking guix graph, @option{--backend}}):"
  50226. msgstr ""
  50227. #. type: table
  50228. #: guix-git/doc/guix.texi:33998
  50229. msgid "The command:"
  50230. msgstr ""
  50231. #. type: example
  50232. #: guix-git/doc/guix.texi:34001
  50233. #, no-wrap
  50234. msgid "$ guix system extension-graph @var{file} | xdot -\n"
  50235. msgstr ""
  50236. #. type: table
  50237. #: guix-git/doc/guix.texi:34004
  50238. msgid "shows the extension relations among services."
  50239. msgstr ""
  50240. #. type: anchor{#1}
  50241. #: guix-git/doc/guix.texi:34006
  50242. msgid "system-shepherd-graph"
  50243. msgstr ""
  50244. #. type: item
  50245. #: guix-git/doc/guix.texi:34006
  50246. #, no-wrap
  50247. msgid "shepherd-graph"
  50248. msgstr ""
  50249. #. type: table
  50250. #: guix-git/doc/guix.texi:34011
  50251. msgid "Emit to standard output the @dfn{dependency graph} of shepherd services of the operating system defined in @var{file}. @xref{Shepherd Services}, for more information and for an example graph."
  50252. msgstr ""
  50253. #. type: table
  50254. #: guix-git/doc/guix.texi:34014
  50255. msgid "Again, the default output format is Dot/Graphviz, but you can pass @option{--graph-backend} to select a different one."
  50256. msgstr ""
  50257. #. type: section
  50258. #: guix-git/doc/guix.texi:34018
  50259. #, no-wrap
  50260. msgid "Invoking @code{guix deploy}"
  50261. msgstr ""
  50262. #. type: Plain text
  50263. #: guix-git/doc/guix.texi:34026
  50264. msgid "We've already seen @code{operating-system} declarations used to manage a machine's configuration locally. Suppose you need to configure multiple machines, though---perhaps you're managing a service on the web that's comprised of several servers. @command{guix deploy} enables you to use those same @code{operating-system} declarations to manage multiple remote hosts at once as a logical ``deployment''."
  50265. msgstr ""
  50266. #. type: quotation
  50267. #: guix-git/doc/guix.texi:34031
  50268. msgid "The functionality described in this section is still under development and is subject to change. Get in touch with us on @email{guix-devel@@gnu.org}!"
  50269. msgstr ""
  50270. #. type: example
  50271. #: guix-git/doc/guix.texi:34035
  50272. #, no-wrap
  50273. msgid "guix deploy @var{file}\n"
  50274. msgstr ""
  50275. #. type: Plain text
  50276. #: guix-git/doc/guix.texi:34039
  50277. msgid "Such an invocation will deploy the machines that the code within @var{file} evaluates to. As an example, @var{file} might contain a definition like this:"
  50278. msgstr ""
  50279. #. type: lisp
  50280. #: guix-git/doc/guix.texi:34046
  50281. #, no-wrap
  50282. msgid ""
  50283. ";; This is a Guix deployment of a \"bare bones\" setup, with\n"
  50284. ";; no X11 display server, to a machine with an SSH daemon\n"
  50285. ";; listening on localhost:2222. A configuration such as this\n"
  50286. ";; may be appropriate for virtual machine with ports\n"
  50287. ";; forwarded to the host's loopback interface.\n"
  50288. "\n"
  50289. msgstr ""
  50290. #. type: lisp
  50291. #: guix-git/doc/guix.texi:34049
  50292. #, no-wrap
  50293. msgid ""
  50294. "(use-service-modules networking ssh)\n"
  50295. "(use-package-modules bootloaders)\n"
  50296. "\n"
  50297. msgstr ""
  50298. #. type: lisp
  50299. #: guix-git/doc/guix.texi:34070
  50300. #, no-wrap
  50301. msgid ""
  50302. "(define %system\n"
  50303. " (operating-system\n"
  50304. " (host-name \"gnu-deployed\")\n"
  50305. " (timezone \"Etc/UTC\")\n"
  50306. " (bootloader (bootloader-configuration\n"
  50307. " (bootloader grub-bootloader)\n"
  50308. " (target \"/dev/vda\")\n"
  50309. " (terminal-outputs '(console))))\n"
  50310. " (file-systems (cons (file-system\n"
  50311. " (mount-point \"/\")\n"
  50312. " (device \"/dev/vda1\")\n"
  50313. " (type \"ext4\"))\n"
  50314. " %base-file-systems))\n"
  50315. " (services\n"
  50316. " (append (list (service dhcp-client-service-type)\n"
  50317. " (service openssh-service-type\n"
  50318. " (openssh-configuration\n"
  50319. " (permit-root-login #t)\n"
  50320. " (allow-empty-passwords? #t))))\n"
  50321. " %base-services))))\n"
  50322. "\n"
  50323. msgstr ""
  50324. #. type: lisp
  50325. #: guix-git/doc/guix.texi:34080
  50326. #, no-wrap
  50327. msgid ""
  50328. "(list (machine\n"
  50329. " (operating-system %system)\n"
  50330. " (environment managed-host-environment-type)\n"
  50331. " (configuration (machine-ssh-configuration\n"
  50332. " (host-name \"localhost\")\n"
  50333. " (system \"x86_64-linux\")\n"
  50334. " (user \"alice\")\n"
  50335. " (identity \"./id_rsa\")\n"
  50336. " (port 2222)))))\n"
  50337. msgstr ""
  50338. #. type: Plain text
  50339. #: guix-git/doc/guix.texi:34093
  50340. msgid "The file should evaluate to a list of @var{machine} objects. This example, upon being deployed, will create a new generation on the remote system realizing the @code{operating-system} declaration @code{%system}. @code{environment} and @code{configuration} specify how the machine should be provisioned---that is, how the computing resources should be created and managed. The above example does not create any resources, as a @code{'managed-host} is a machine that is already running the Guix system and available over the network. This is a particularly simple case; a more complex deployment may involve, for example, starting virtual machines through a Virtual Private Server (VPS) provider. In such a case, a different @var{environment} type would be used."
  50341. msgstr ""
  50342. #. type: Plain text
  50343. #: guix-git/doc/guix.texi:34098
  50344. msgid "Do note that you first need to generate a key pair on the coordinator machine to allow the daemon to export signed archives of files from the store (@pxref{Invoking guix archive}), though this step is automatic on Guix System:"
  50345. msgstr ""
  50346. #. type: Plain text
  50347. #: guix-git/doc/guix.texi:34106
  50348. msgid "Each target machine must authorize the key of the master machine so that it accepts store items it receives from the coordinator:"
  50349. msgstr ""
  50350. #. type: example
  50351. #: guix-git/doc/guix.texi:34109
  50352. #, no-wrap
  50353. msgid "# guix archive --authorize < coordinator-public-key.txt\n"
  50354. msgstr ""
  50355. #. type: Plain text
  50356. #: guix-git/doc/guix.texi:34120
  50357. msgid "@code{user}, in this example, specifies the name of the user account to log in as to perform the deployment. Its default value is @code{root}, but root login over SSH may be forbidden in some cases. To work around this, @command{guix deploy} can log in as an unprivileged user and employ @code{sudo} to escalate privileges. This will only work if @code{sudo} is currently installed on the remote and can be invoked non-interactively as @code{user}. That is, the line in @code{sudoers} granting @code{user} the ability to use @code{sudo} must contain the @code{NOPASSWD} tag. This can be accomplished with the following operating system configuration snippet:"
  50358. msgstr ""
  50359. #. type: lisp
  50360. #: guix-git/doc/guix.texi:34124
  50361. #, no-wrap
  50362. msgid ""
  50363. "(use-modules ...\n"
  50364. " (gnu system)) ;for %sudoers-specification\n"
  50365. "\n"
  50366. msgstr ""
  50367. #. type: lisp
  50368. #: guix-git/doc/guix.texi:34126
  50369. #, no-wrap
  50370. msgid ""
  50371. "(define %user \"username\")\n"
  50372. "\n"
  50373. msgstr ""
  50374. #. type: lisp
  50375. #: guix-git/doc/guix.texi:34134
  50376. #, no-wrap
  50377. msgid ""
  50378. "(operating-system\n"
  50379. " ...\n"
  50380. " (sudoers-file\n"
  50381. " (plain-file \"sudoers\"\n"
  50382. " (string-append (plain-file-content %sudoers-specification)\n"
  50383. " (format #f \"~a ALL = NOPASSWD: ALL~%\"\n"
  50384. " %user)))))\n"
  50385. "\n"
  50386. msgstr ""
  50387. #. type: Plain text
  50388. #: guix-git/doc/guix.texi:34139
  50389. msgid "For more information regarding the format of the @file{sudoers} file, consult @command{man sudoers}."
  50390. msgstr ""
  50391. #. type: deftp
  50392. #: guix-git/doc/guix.texi:34140
  50393. #, no-wrap
  50394. msgid "{Data Type} machine"
  50395. msgstr ""
  50396. #. type: deftp
  50397. #: guix-git/doc/guix.texi:34143
  50398. msgid "This is the data type representing a single machine in a heterogeneous Guix deployment."
  50399. msgstr ""
  50400. #. type: table
  50401. #: guix-git/doc/guix.texi:34147
  50402. msgid "The object of the operating system configuration to deploy."
  50403. msgstr ""
  50404. #. type: code{#1}
  50405. #: guix-git/doc/guix.texi:34148
  50406. #, no-wrap
  50407. msgid "environment"
  50408. msgstr ""
  50409. #. type: table
  50410. #: guix-git/doc/guix.texi:34150
  50411. msgid "An @code{environment-type} describing how the machine should be provisioned."
  50412. msgstr ""
  50413. #. type: item
  50414. #: guix-git/doc/guix.texi:34151
  50415. #, no-wrap
  50416. msgid "@code{configuration} (default: @code{#f})"
  50417. msgstr ""
  50418. #. type: table
  50419. #: guix-git/doc/guix.texi:34156
  50420. msgid "An object describing the configuration for the machine's @code{environment}. If the @code{environment} has a default configuration, @code{#f} may be used. If @code{#f} is used for an environment with no default configuration, however, an error will be thrown."
  50421. msgstr ""
  50422. #. type: deftp
  50423. #: guix-git/doc/guix.texi:34159
  50424. #, no-wrap
  50425. msgid "{Data Type} machine-ssh-configuration"
  50426. msgstr ""
  50427. #. type: deftp
  50428. #: guix-git/doc/guix.texi:34162
  50429. msgid "This is the data type representing the SSH client parameters for a machine with an @code{environment} of @code{managed-host-environment-type}."
  50430. msgstr ""
  50431. #. type: item
  50432. #: guix-git/doc/guix.texi:34165
  50433. #, no-wrap
  50434. msgid "@code{build-locally?} (default: @code{#t})"
  50435. msgstr ""
  50436. #. type: table
  50437. #: guix-git/doc/guix.texi:34167
  50438. msgid "If false, system derivations will be built on the machine being deployed to."
  50439. msgstr ""
  50440. #. type: code{#1}
  50441. #: guix-git/doc/guix.texi:34167
  50442. #, no-wrap
  50443. msgid "system"
  50444. msgstr ""
  50445. #. type: table
  50446. #: guix-git/doc/guix.texi:34170
  50447. msgid "The system type describing the architecture of the machine being deployed to---e.g., @code{\"x86_64-linux\"}."
  50448. msgstr ""
  50449. #. type: item
  50450. #: guix-git/doc/guix.texi:34170
  50451. #, no-wrap
  50452. msgid "@code{authorize?} (default: @code{#t})"
  50453. msgstr ""
  50454. #. type: table
  50455. #: guix-git/doc/guix.texi:34173
  50456. msgid "If true, the coordinator's signing key will be added to the remote's ACL keyring."
  50457. msgstr ""
  50458. #. type: item
  50459. #: guix-git/doc/guix.texi:34174
  50460. #, no-wrap
  50461. msgid "@code{user} (default: @code{\"root\"})"
  50462. msgstr ""
  50463. #. type: item
  50464. #: guix-git/doc/guix.texi:34175
  50465. #, no-wrap
  50466. msgid "@code{identity} (default: @code{#f})"
  50467. msgstr ""
  50468. #. type: table
  50469. #: guix-git/doc/guix.texi:34178
  50470. msgid "If specified, the path to the SSH private key to use to authenticate with the remote host."
  50471. msgstr ""
  50472. #. type: item
  50473. #: guix-git/doc/guix.texi:34179
  50474. #, no-wrap
  50475. msgid "@code{host-key} (default: @code{#f})"
  50476. msgstr ""
  50477. #. type: table
  50478. #: guix-git/doc/guix.texi:34181
  50479. msgid "This should be the SSH host key of the machine, which looks like this:"
  50480. msgstr ""
  50481. #. type: example
  50482. #: guix-git/doc/guix.texi:34184
  50483. #, no-wrap
  50484. msgid "ssh-ed25519 AAAAC3Nz@dots{} root@@example.org\n"
  50485. msgstr ""
  50486. #. type: table
  50487. #: guix-git/doc/guix.texi:34189
  50488. msgid "When @code{host-key} is @code{#f}, the server is authenticated against the @file{~/.ssh/known_hosts} file, just like the OpenSSH @command{ssh} client does."
  50489. msgstr ""
  50490. #. type: item
  50491. #: guix-git/doc/guix.texi:34190
  50492. #, no-wrap
  50493. msgid "@code{allow-downgrades?} (default: @code{#f})"
  50494. msgstr ""
  50495. #. type: table
  50496. #: guix-git/doc/guix.texi:34192
  50497. msgid "Whether to allow potential downgrades."
  50498. msgstr ""
  50499. #. type: table
  50500. #: guix-git/doc/guix.texi:34200
  50501. msgid "Like @command{guix system reconfigure}, @command{guix deploy} compares the channel commits currently deployed on the remote host (as returned by @command{guix system describe}) to those currently in use (as returned by @command{guix describe}) to determine whether commits currently in use are descendants of those deployed. When this is not the case and @code{allow-downgrades?} is false, it raises an error. This ensures you do not accidentally downgrade remote machines."
  50502. msgstr ""
  50503. #. type: deftp
  50504. #: guix-git/doc/guix.texi:34203
  50505. #, no-wrap
  50506. msgid "{Data Type} digital-ocean-configuration"
  50507. msgstr ""
  50508. #. type: deftp
  50509. #: guix-git/doc/guix.texi:34206
  50510. msgid "This is the data type describing the Droplet that should be created for a machine with an @code{environment} of @code{digital-ocean-environment-type}."
  50511. msgstr ""
  50512. #. type: code{#1}
  50513. #: guix-git/doc/guix.texi:34208
  50514. #, no-wrap
  50515. msgid "ssh-key"
  50516. msgstr ""
  50517. #. type: table
  50518. #: guix-git/doc/guix.texi:34211
  50519. msgid "The path to the SSH private key to use to authenticate with the remote host. In the future, this field may not exist."
  50520. msgstr ""
  50521. #. type: code{#1}
  50522. #: guix-git/doc/guix.texi:34211
  50523. #, no-wrap
  50524. msgid "tags"
  50525. msgstr ""
  50526. #. type: table
  50527. #: guix-git/doc/guix.texi:34214
  50528. msgid "A list of string ``tags'' that uniquely identify the machine. Must be given such that no two machines in the deployment have the same set of tags."
  50529. msgstr ""
  50530. #. type: code{#1}
  50531. #: guix-git/doc/guix.texi:34214
  50532. #, no-wrap
  50533. msgid "region"
  50534. msgstr ""
  50535. #. type: table
  50536. #: guix-git/doc/guix.texi:34216
  50537. msgid "A Digital Ocean region slug, such as @code{\"nyc3\"}."
  50538. msgstr ""
  50539. #. type: table
  50540. #: guix-git/doc/guix.texi:34218
  50541. msgid "A Digital Ocean size slug, such as @code{\"s-1vcpu-1gb\"}"
  50542. msgstr ""
  50543. #. type: code{#1}
  50544. #: guix-git/doc/guix.texi:34218
  50545. #, no-wrap
  50546. msgid "enable-ipv6?"
  50547. msgstr ""
  50548. #. type: table
  50549. #: guix-git/doc/guix.texi:34220
  50550. msgid "Whether or not the droplet should be created with IPv6 networking."
  50551. msgstr ""
  50552. #. type: section
  50553. #: guix-git/doc/guix.texi:34224
  50554. #, no-wrap
  50555. msgid "Running Guix in a Virtual Machine"
  50556. msgstr ""
  50557. #. type: Plain text
  50558. #: guix-git/doc/guix.texi:34232
  50559. msgid "To run Guix in a virtual machine (VM), one can use the pre-built Guix VM image distributed at @url{@value{BASE-URL}/guix-system-vm-image-@value{VERSION}.x86_64-linux.qcow2}. This image is a compressed image in QCOW format. You can pass it to an emulator such as @uref{https://qemu.org/, QEMU} (see below for details)."
  50560. msgstr ""
  50561. #. type: Plain text
  50562. #: guix-git/doc/guix.texi:34239
  50563. msgid "This image boots the Xfce graphical environment and it contains some commonly used tools. You can install more software in the image by running @command{guix package} in a terminal (@pxref{Invoking guix package}). You can also reconfigure the system based on its initial configuration file available as @file{/run/current-system/configuration.scm} (@pxref{Using the Configuration System})."
  50564. msgstr ""
  50565. #. type: Plain text
  50566. #: guix-git/doc/guix.texi:34242
  50567. msgid "Instead of using this pre-built image, one can also build their own image using @command{guix system image} (@pxref{Invoking guix system})."
  50568. msgstr ""
  50569. #. type: cindex
  50570. #: guix-git/doc/guix.texi:34243
  50571. #, no-wrap
  50572. msgid "QEMU"
  50573. msgstr ""
  50574. #. type: Plain text
  50575. #: guix-git/doc/guix.texi:34250
  50576. msgid "If you built your own image, you must copy it out of the store (@pxref{The Store}) and give yourself permission to write to the copy before you can use it. When invoking QEMU, you must choose a system emulator that is suitable for your hardware platform. Here is a minimal QEMU invocation that will boot the result of @command{guix system image -t qcow2} on x86_64 hardware:"
  50577. msgstr ""
  50578. #. type: example
  50579. #: guix-git/doc/guix.texi:34257
  50580. #, no-wrap
  50581. msgid ""
  50582. "$ qemu-system-x86_64 \\\n"
  50583. " -nic user,model=virtio-net-pci \\\n"
  50584. " -enable-kvm -m 1024 \\\n"
  50585. " -device virtio-blk,drive=myhd \\\n"
  50586. " -drive if=none,file=/tmp/qemu-image,id=myhd\n"
  50587. msgstr ""
  50588. #. type: Plain text
  50589. #: guix-git/doc/guix.texi:34260
  50590. msgid "Here is what each of these options means:"
  50591. msgstr ""
  50592. #. type: item
  50593. #: guix-git/doc/guix.texi:34262
  50594. #, no-wrap
  50595. msgid "qemu-system-x86_64"
  50596. msgstr ""
  50597. #. type: table
  50598. #: guix-git/doc/guix.texi:34265
  50599. msgid "This specifies the hardware platform to emulate. This should match the host."
  50600. msgstr ""
  50601. #. type: item
  50602. #: guix-git/doc/guix.texi:34266
  50603. #, no-wrap
  50604. msgid "-nic user,model=virtio-net-pci"
  50605. msgstr ""
  50606. #. type: table
  50607. #: guix-git/doc/guix.texi:34274
  50608. msgid "Enable the unprivileged user-mode network stack. The guest OS can access the host but not vice versa. This is the simplest way to get the guest OS online. @code{model} specifies which network device to emulate: @code{virtio-net-pci} is a special device made for virtualized operating systems and recommended for most uses. Assuming your hardware platform is x86_64, you can get a list of available NIC models by running @command{qemu-system-x86_64 -nic model=help}."
  50609. msgstr ""
  50610. #. type: item
  50611. #: guix-git/doc/guix.texi:34275
  50612. #, no-wrap
  50613. msgid "-enable-kvm"
  50614. msgstr ""
  50615. #. type: table
  50616. #: guix-git/doc/guix.texi:34279
  50617. msgid "If your system has hardware virtualization extensions, enabling the virtual machine support (KVM) of the Linux kernel will make things run faster."
  50618. msgstr ""
  50619. #. type: item
  50620. #: guix-git/doc/guix.texi:34281
  50621. #, no-wrap
  50622. msgid "-m 1024"
  50623. msgstr ""
  50624. #. type: table
  50625. #: guix-git/doc/guix.texi:34284
  50626. msgid "RAM available to the guest OS, in mebibytes. Defaults to 128@tie{}MiB, which may be insufficient for some operations."
  50627. msgstr ""
  50628. #. type: item
  50629. #: guix-git/doc/guix.texi:34285
  50630. #, no-wrap
  50631. msgid "-device virtio-blk,drive=myhd"
  50632. msgstr ""
  50633. #. type: table
  50634. #: guix-git/doc/guix.texi:34290
  50635. msgid "Create a @code{virtio-blk} drive called ``myhd''. @code{virtio-blk} is a ``paravirtualization'' mechanism for block devices that allows QEMU to achieve better performance than if it were emulating a complete disk drive. See the QEMU and KVM documentation for more info."
  50636. msgstr ""
  50637. #. type: item
  50638. #: guix-git/doc/guix.texi:34291
  50639. #, no-wrap
  50640. msgid "-drive if=none,file=/tmp/qemu-image,id=myhd"
  50641. msgstr ""
  50642. #. type: table
  50643. #: guix-git/doc/guix.texi:34294
  50644. msgid "Use our QCOW image, the @file{/tmp/qemu-image} file, as the backing store of the ``myhd'' drive."
  50645. msgstr ""
  50646. #. type: Plain text
  50647. #: guix-git/doc/guix.texi:34304
  50648. msgid "The default @command{run-vm.sh} script that is returned by an invocation of @command{guix system vm} does not add a @command{-nic user} flag by default. To get network access from within the vm add the @code{(dhcp-client-service)} to your system definition and start the VM using @command{$(guix system vm config.scm) -nic user}. An important caveat of using @command{-nic user} for networking is that @command{ping} will not work, because it uses the ICMP protocol. You'll have to use a different command to check for network connectivity, for example @command{guix download}."
  50649. msgstr ""
  50650. #. type: subsection
  50651. #: guix-git/doc/guix.texi:34305
  50652. #, no-wrap
  50653. msgid "Connecting Through SSH"
  50654. msgstr ""
  50655. #. type: Plain text
  50656. #: guix-git/doc/guix.texi:34313
  50657. msgid "To enable SSH inside a VM you need to add an SSH server like @code{openssh-service-type} to your VM (@pxref{Networking Services, @code{openssh-service-type}}). In addition you need to forward the SSH port, 22 by default, to the host. You can do this with"
  50658. msgstr ""
  50659. #. type: example
  50660. #: guix-git/doc/guix.texi:34316
  50661. #, no-wrap
  50662. msgid "$(guix system vm config.scm) -nic user,model=virtio-net-pci,hostfwd=tcp::10022-:22\n"
  50663. msgstr ""
  50664. #. type: Plain text
  50665. #: guix-git/doc/guix.texi:34319
  50666. msgid "To connect to the VM you can run"
  50667. msgstr ""
  50668. #. type: example
  50669. #: guix-git/doc/guix.texi:34322
  50670. #, no-wrap
  50671. msgid "ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 10022 localhost\n"
  50672. msgstr ""
  50673. #. type: Plain text
  50674. #: guix-git/doc/guix.texi:34329
  50675. msgid "The @command{-p} tells @command{ssh} the port you want to connect to. @command{-o UserKnownHostsFile=/dev/null} prevents @command{ssh} from complaining every time you modify your @command{config.scm} file and the @command{-o StrictHostKeyChecking=no} prevents you from having to allow a connection to an unknown host every time you connect."
  50676. msgstr ""
  50677. #. type: quotation
  50678. #: guix-git/doc/guix.texi:34335
  50679. msgid "If you find the above @samp{hostfwd} example not to be working (e.g., your SSH client hangs attempting to connect to the mapped port of your VM), make sure that your Guix System VM has networking support, such as by using the @code{dhcp-client-service-type} service type."
  50680. msgstr ""
  50681. #. type: subsection
  50682. #: guix-git/doc/guix.texi:34337
  50683. #, no-wrap
  50684. msgid "Using @command{virt-viewer} with Spice"
  50685. msgstr ""
  50686. #. type: Plain text
  50687. #: guix-git/doc/guix.texi:34343
  50688. msgid "As an alternative to the default @command{qemu} graphical client you can use the @command{remote-viewer} from the @command{virt-viewer} package. To connect pass the @command{-spice port=5930,disable-ticketing} flag to @command{qemu}. See previous section for further information on how to do this."
  50689. msgstr ""
  50690. #. type: Plain text
  50691. #: guix-git/doc/guix.texi:34346
  50692. msgid "Spice also allows you to do some nice stuff like share your clipboard with your VM@. To enable that you'll also have to pass the following flags to @command{qemu}:"
  50693. msgstr ""
  50694. #. type: example
  50695. #: guix-git/doc/guix.texi:34352
  50696. #, no-wrap
  50697. msgid ""
  50698. "-device virtio-serial-pci,id=virtio-serial0,max_ports=16,bus=pci.0,addr=0x5\n"
  50699. "-chardev spicevmc,name=vdagent,id=vdagent\n"
  50700. "-device virtserialport,nr=1,bus=virtio-serial0.0,chardev=vdagent,\n"
  50701. "name=com.redhat.spice.0\n"
  50702. msgstr ""
  50703. #. type: Plain text
  50704. #: guix-git/doc/guix.texi:34356
  50705. msgid "You'll also need to add the @code{(spice-vdagent-service)} to your system definition (@pxref{Miscellaneous Services, Spice service})."
  50706. msgstr ""
  50707. #. type: Plain text
  50708. #: guix-git/doc/guix.texi:34363
  50709. msgid "The previous sections show the available services and how one can combine them in an @code{operating-system} declaration. But how do we define them in the first place? And what is a service anyway?"
  50710. msgstr ""
  50711. #. type: cindex
  50712. #: guix-git/doc/guix.texi:34375
  50713. #, no-wrap
  50714. msgid "daemons"
  50715. msgstr ""
  50716. #. type: Plain text
  50717. #: guix-git/doc/guix.texi:34388
  50718. msgid "Here we define a @dfn{service} as, broadly, something that extends the functionality of the operating system. Often a service is a process---a @dfn{daemon}---started when the system boots: a secure shell server, a Web server, the Guix build daemon, etc. Sometimes a service is a daemon whose execution can be triggered by another daemon---e.g., an FTP server started by @command{inetd} or a D-Bus service activated by @command{dbus-daemon}. Occasionally, a service does not map to a daemon. For instance, the ``account'' service collects user accounts and makes sure they exist when the system runs; the ``udev'' service collects device management rules and makes them available to the eudev daemon; the @file{/etc} service populates the @file{/etc} directory of the system."
  50719. msgstr ""
  50720. #. type: cindex
  50721. #: guix-git/doc/guix.texi:34389
  50722. #, no-wrap
  50723. msgid "service extensions"
  50724. msgstr ""
  50725. #. type: Plain text
  50726. #: guix-git/doc/guix.texi:34401
  50727. msgid "Guix system services are connected by @dfn{extensions}. For instance, the secure shell service @emph{extends} the Shepherd---the initialization system, running as PID@tie{}1---by giving it the command lines to start and stop the secure shell daemon (@pxref{Networking Services, @code{openssh-service-type}}); the UPower service extends the D-Bus service by passing it its @file{.service} specification, and extends the udev service by passing it device management rules (@pxref{Desktop Services, @code{upower-service}}); the Guix daemon service extends the Shepherd by passing it the command lines to start and stop the daemon, and extends the account service by passing it a list of required build user accounts (@pxref{Base Services})."
  50728. msgstr ""
  50729. #. type: Plain text
  50730. #: guix-git/doc/guix.texi:34405
  50731. msgid "All in all, services and their ``extends'' relations form a directed acyclic graph (DAG). If we represent services as boxes and extensions as arrows, a typical system might provide something like this:"
  50732. msgstr ""
  50733. #. type: Plain text
  50734. #: guix-git/doc/guix.texi:34407
  50735. msgid "@image{images/service-graph,,5in,Typical service extension graph.}"
  50736. msgstr ""
  50737. #. type: cindex
  50738. #: guix-git/doc/guix.texi:34408
  50739. #, no-wrap
  50740. msgid "system service"
  50741. msgstr ""
  50742. #. type: Plain text
  50743. #: guix-git/doc/guix.texi:34416
  50744. msgid "At the bottom, we see the @dfn{system service}, which produces the directory containing everything to run and boot the system, as returned by the @command{guix system build} command. @xref{Service Reference}, to learn about the other service types shown here. @xref{system-extension-graph, the @command{guix system extension-graph} command}, for information on how to generate this representation for a particular operating system definition."
  50745. msgstr ""
  50746. #. type: cindex
  50747. #: guix-git/doc/guix.texi:34417
  50748. #, no-wrap
  50749. msgid "service types"
  50750. msgstr ""
  50751. #. type: Plain text
  50752. #: guix-git/doc/guix.texi:34423
  50753. msgid "Technically, developers can define @dfn{service types} to express these relations. There can be any number of services of a given type on the system---for instance, a system running two instances of the GNU secure shell server (lsh) has two instances of @code{lsh-service-type}, with different parameters."
  50754. msgstr ""
  50755. #. type: Plain text
  50756. #: guix-git/doc/guix.texi:34426
  50757. msgid "The following section describes the programming interface for service types and services."
  50758. msgstr ""
  50759. #. type: Plain text
  50760. #: guix-git/doc/guix.texi:34433
  50761. msgid "A @dfn{service type} is a node in the DAG described above. Let us start with a simple example, the service type for the Guix build daemon (@pxref{Invoking guix-daemon}):"
  50762. msgstr ""
  50763. #. type: lisp
  50764. #: guix-git/doc/guix.texi:34443
  50765. #, no-wrap
  50766. msgid ""
  50767. "(define guix-service-type\n"
  50768. " (service-type\n"
  50769. " (name 'guix)\n"
  50770. " (extensions\n"
  50771. " (list (service-extension shepherd-root-service-type guix-shepherd-service)\n"
  50772. " (service-extension account-service-type guix-accounts)\n"
  50773. " (service-extension activation-service-type guix-activation)))\n"
  50774. " (default-value (guix-configuration))))\n"
  50775. msgstr ""
  50776. #. type: Plain text
  50777. #: guix-git/doc/guix.texi:34447
  50778. msgid "It defines three things:"
  50779. msgstr ""
  50780. #. type: enumerate
  50781. #: guix-git/doc/guix.texi:34451
  50782. msgid "A name, whose sole purpose is to make inspection and debugging easier."
  50783. msgstr ""
  50784. #. type: enumerate
  50785. #: guix-git/doc/guix.texi:34456
  50786. msgid "A list of @dfn{service extensions}, where each extension designates the target service type and a procedure that, given the parameters of the service, returns a list of objects to extend the service of that type."
  50787. msgstr ""
  50788. #. type: enumerate
  50789. #: guix-git/doc/guix.texi:34459
  50790. msgid "Every service type has at least one service extension. The only exception is the @dfn{boot service type}, which is the ultimate service."
  50791. msgstr ""
  50792. #. type: enumerate
  50793. #: guix-git/doc/guix.texi:34462
  50794. msgid "Optionally, a default value for instances of this type."
  50795. msgstr ""
  50796. #. type: Plain text
  50797. #: guix-git/doc/guix.texi:34465
  50798. msgid "In this example, @code{guix-service-type} extends three services:"
  50799. msgstr ""
  50800. #. type: item
  50801. #: guix-git/doc/guix.texi:34467
  50802. #, no-wrap
  50803. msgid "shepherd-root-service-type"
  50804. msgstr ""
  50805. #. type: table
  50806. #: guix-git/doc/guix.texi:34472
  50807. msgid "The @code{guix-shepherd-service} procedure defines how the Shepherd service is extended. Namely, it returns a @code{<shepherd-service>} object that defines how @command{guix-daemon} is started and stopped (@pxref{Shepherd Services})."
  50808. msgstr ""
  50809. #. type: item
  50810. #: guix-git/doc/guix.texi:34473
  50811. #, no-wrap
  50812. msgid "account-service-type"
  50813. msgstr ""
  50814. #. type: table
  50815. #: guix-git/doc/guix.texi:34478
  50816. msgid "This extension for this service is computed by @code{guix-accounts}, which returns a list of @code{user-group} and @code{user-account} objects representing the build user accounts (@pxref{Invoking guix-daemon})."
  50817. msgstr ""
  50818. #. type: item
  50819. #: guix-git/doc/guix.texi:34479
  50820. #, no-wrap
  50821. msgid "activation-service-type"
  50822. msgstr ""
  50823. #. type: table
  50824. #: guix-git/doc/guix.texi:34483
  50825. msgid "Here @code{guix-activation} is a procedure that returns a gexp, which is a code snippet to run at ``activation time''---e.g., when the service is booted."
  50826. msgstr ""
  50827. #. type: Plain text
  50828. #: guix-git/doc/guix.texi:34486
  50829. msgid "A service of this type is instantiated like this:"
  50830. msgstr ""
  50831. #. type: lisp
  50832. #: guix-git/doc/guix.texi:34492
  50833. #, no-wrap
  50834. msgid ""
  50835. "(service guix-service-type\n"
  50836. " (guix-configuration\n"
  50837. " (build-accounts 5)\n"
  50838. " (extra-options '(\"--gc-keep-derivations\"))))\n"
  50839. msgstr ""
  50840. #. type: Plain text
  50841. #: guix-git/doc/guix.texi:34500
  50842. msgid "The second argument to the @code{service} form is a value representing the parameters of this specific service instance. @xref{guix-configuration-type, @code{guix-configuration}}, for information about the @code{guix-configuration} data type. When the value is omitted, the default value specified by @code{guix-service-type} is used:"
  50843. msgstr ""
  50844. #. type: lisp
  50845. #: guix-git/doc/guix.texi:34503
  50846. #, no-wrap
  50847. msgid "(service guix-service-type)\n"
  50848. msgstr ""
  50849. #. type: Plain text
  50850. #: guix-git/doc/guix.texi:34507
  50851. msgid "@code{guix-service-type} is quite simple because it extends other services but is not extensible itself."
  50852. msgstr ""
  50853. #. type: Plain text
  50854. #: guix-git/doc/guix.texi:34511
  50855. msgid "The service type for an @emph{extensible} service looks like this:"
  50856. msgstr ""
  50857. #. type: lisp
  50858. #: guix-git/doc/guix.texi:34518
  50859. #, no-wrap
  50860. msgid ""
  50861. "(define udev-service-type\n"
  50862. " (service-type (name 'udev)\n"
  50863. " (extensions\n"
  50864. " (list (service-extension shepherd-root-service-type\n"
  50865. " udev-shepherd-service)))\n"
  50866. "\n"
  50867. msgstr ""
  50868. #. type: lisp
  50869. #: guix-git/doc/guix.texi:34526
  50870. #, no-wrap
  50871. msgid ""
  50872. " (compose concatenate) ;concatenate the list of rules\n"
  50873. " (extend (lambda (config rules)\n"
  50874. " (match config\n"
  50875. " (($ <udev-configuration> udev initial-rules)\n"
  50876. " (udev-configuration\n"
  50877. " (udev udev) ;the udev package to use\n"
  50878. " (rules (append initial-rules rules)))))))))\n"
  50879. msgstr ""
  50880. #. type: Plain text
  50881. #: guix-git/doc/guix.texi:34532
  50882. msgid "This is the service type for the @uref{https://wiki.gentoo.org/wiki/Project:Eudev, eudev device management daemon}. Compared to the previous example, in addition to an extension of @code{shepherd-root-service-type}, we see two new fields:"
  50883. msgstr ""
  50884. #. type: item
  50885. #: guix-git/doc/guix.texi:34534
  50886. #, no-wrap
  50887. msgid "compose"
  50888. msgstr ""
  50889. #. type: table
  50890. #: guix-git/doc/guix.texi:34537
  50891. msgid "This is the procedure to @dfn{compose} the list of extensions to services of this type."
  50892. msgstr ""
  50893. #. type: table
  50894. #: guix-git/doc/guix.texi:34540
  50895. msgid "Services can extend the udev service by passing it lists of rules; we compose those extensions simply by concatenating them."
  50896. msgstr ""
  50897. #. type: item
  50898. #: guix-git/doc/guix.texi:34541
  50899. #, no-wrap
  50900. msgid "extend"
  50901. msgstr ""
  50902. #. type: table
  50903. #: guix-git/doc/guix.texi:34544
  50904. msgid "This procedure defines how the value of the service is @dfn{extended} with the composition of the extensions."
  50905. msgstr ""
  50906. #. type: table
  50907. #: guix-git/doc/guix.texi:34549
  50908. msgid "Udev extensions are composed into a list of rules, but the udev service value is itself a @code{<udev-configuration>} record. So here, we extend that record by appending the list of rules it contains to the list of contributed rules."
  50909. msgstr ""
  50910. #. type: table
  50911. #: guix-git/doc/guix.texi:34555
  50912. msgid "This is a string giving an overview of the service type. The string can contain Texinfo markup (@pxref{Overview,,, texinfo, GNU Texinfo}). The @command{guix system search} command searches these strings and displays them (@pxref{Invoking guix system})."
  50913. msgstr ""
  50914. #. type: Plain text
  50915. #: guix-git/doc/guix.texi:34560
  50916. msgid "There can be only one instance of an extensible service type such as @code{udev-service-type}. If there were more, the @code{service-extension} specifications would be ambiguous."
  50917. msgstr ""
  50918. #. type: Plain text
  50919. #: guix-git/doc/guix.texi:34563
  50920. msgid "Still here? The next section provides a reference of the programming interface for services."
  50921. msgstr ""
  50922. #. type: Plain text
  50923. #: guix-git/doc/guix.texi:34571
  50924. msgid "We have seen an overview of service types (@pxref{Service Types and Services}). This section provides a reference on how to manipulate services and service types. This interface is provided by the @code{(gnu services)} module."
  50925. msgstr ""
  50926. #. type: deffn
  50927. #: guix-git/doc/guix.texi:34572
  50928. #, no-wrap
  50929. msgid "{Scheme Procedure} service @var{type} [@var{value}]"
  50930. msgstr ""
  50931. #. type: deffn
  50932. #: guix-git/doc/guix.texi:34576
  50933. msgid "Return a new service of @var{type}, a @code{<service-type>} object (see below). @var{value} can be any object; it represents the parameters of this particular service instance."
  50934. msgstr ""
  50935. #. type: deffn
  50936. #: guix-git/doc/guix.texi:34580
  50937. msgid "When @var{value} is omitted, the default value specified by @var{type} is used; if @var{type} does not specify a default value, an error is raised."
  50938. msgstr ""
  50939. #. type: deffn
  50940. #: guix-git/doc/guix.texi:34582
  50941. msgid "For instance, this:"
  50942. msgstr ""
  50943. #. type: lisp
  50944. #: guix-git/doc/guix.texi:34585
  50945. #, no-wrap
  50946. msgid "(service openssh-service-type)\n"
  50947. msgstr ""
  50948. #. type: deffn
  50949. #: guix-git/doc/guix.texi:34589
  50950. msgid "is equivalent to this:"
  50951. msgstr ""
  50952. #. type: lisp
  50953. #: guix-git/doc/guix.texi:34593
  50954. #, no-wrap
  50955. msgid ""
  50956. "(service openssh-service-type\n"
  50957. " (openssh-configuration))\n"
  50958. msgstr ""
  50959. #. type: deffn
  50960. #: guix-git/doc/guix.texi:34597
  50961. msgid "In both cases the result is an instance of @code{openssh-service-type} with the default configuration."
  50962. msgstr ""
  50963. #. type: deffn
  50964. #: guix-git/doc/guix.texi:34599
  50965. #, no-wrap
  50966. msgid "{Scheme Procedure} service? @var{obj}"
  50967. msgstr ""
  50968. #. type: deffn
  50969. #: guix-git/doc/guix.texi:34601
  50970. msgid "Return true if @var{obj} is a service."
  50971. msgstr ""
  50972. #. type: deffn
  50973. #: guix-git/doc/guix.texi:34603
  50974. #, no-wrap
  50975. msgid "{Scheme Procedure} service-kind @var{service}"
  50976. msgstr ""
  50977. #. type: deffn
  50978. #: guix-git/doc/guix.texi:34605
  50979. msgid "Return the type of @var{service}---i.e., a @code{<service-type>} object."
  50980. msgstr ""
  50981. #. type: deffn
  50982. #: guix-git/doc/guix.texi:34607
  50983. #, no-wrap
  50984. msgid "{Scheme Procedure} service-value @var{service}"
  50985. msgstr ""
  50986. #. type: deffn
  50987. #: guix-git/doc/guix.texi:34610
  50988. msgid "Return the value associated with @var{service}. It represents its parameters."
  50989. msgstr ""
  50990. #. type: Plain text
  50991. #: guix-git/doc/guix.texi:34613
  50992. msgid "Here is an example of how a service is created and manipulated:"
  50993. msgstr ""
  50994. #. type: lisp
  50995. #: guix-git/doc/guix.texi:34622
  50996. #, no-wrap
  50997. msgid ""
  50998. "(define s\n"
  50999. " (service nginx-service-type\n"
  51000. " (nginx-configuration\n"
  51001. " (nginx nginx)\n"
  51002. " (log-directory log-directory)\n"
  51003. " (run-directory run-directory)\n"
  51004. " (file config-file))))\n"
  51005. "\n"
  51006. msgstr ""
  51007. #. type: lisp
  51008. #: guix-git/doc/guix.texi:34625
  51009. #, no-wrap
  51010. msgid ""
  51011. "(service? s)\n"
  51012. "@result{} #t\n"
  51013. "\n"
  51014. msgstr ""
  51015. #. type: lisp
  51016. #: guix-git/doc/guix.texi:34628
  51017. #, no-wrap
  51018. msgid ""
  51019. "(eq? (service-kind s) nginx-service-type)\n"
  51020. "@result{} #t\n"
  51021. msgstr ""
  51022. #. type: Plain text
  51023. #: guix-git/doc/guix.texi:34638
  51024. msgid "The @code{modify-services} form provides a handy way to change the parameters of some of the services of a list such as @code{%base-services} (@pxref{Base Services, @code{%base-services}}). It evaluates to a list of services. Of course, you could always use standard list combinators such as @code{map} and @code{fold} to do that (@pxref{SRFI-1, List Library,, guile, GNU Guile Reference Manual}); @code{modify-services} simply provides a more concise form for this common pattern."
  51025. msgstr ""
  51026. #. type: deffn
  51027. #: guix-git/doc/guix.texi:34639
  51028. #, no-wrap
  51029. msgid "{Scheme Syntax} modify-services @var{services} @"
  51030. msgstr ""
  51031. #. type: deffn
  51032. #: guix-git/doc/guix.texi:34641
  51033. msgid "(@var{type} @var{variable} => @var{body}) @dots{}"
  51034. msgstr ""
  51035. #. type: deffn
  51036. #: guix-git/doc/guix.texi:34644
  51037. msgid "Modify the services listed in @var{services} according to the given clauses. Each clause has the form:"
  51038. msgstr ""
  51039. #. type: example
  51040. #: guix-git/doc/guix.texi:34647
  51041. #, no-wrap
  51042. msgid "(@var{type} @var{variable} => @var{body})\n"
  51043. msgstr ""
  51044. #. type: deffn
  51045. #: guix-git/doc/guix.texi:34654
  51046. msgid "where @var{type} is a service type---e.g., @code{guix-service-type}---and @var{variable} is an identifier that is bound within the @var{body} to the service parameters---e.g., a @code{guix-configuration} instance---of the original service of that @var{type}."
  51047. msgstr ""
  51048. #. type: deffn
  51049. #: guix-git/doc/guix.texi:34661
  51050. msgid "The @var{body} should evaluate to the new service parameters, which will be used to configure the new service. This new service will replace the original in the resulting list. Because a service's service parameters are created using @code{define-record-type*}, you can write a succinct @var{body} that evaluates to the new service parameters by using the @code{inherit} feature that @code{define-record-type*} provides."
  51051. msgstr ""
  51052. #. type: deffn
  51053. #: guix-git/doc/guix.texi:34663
  51054. msgid "@xref{Using the Configuration System}, for example usage."
  51055. msgstr ""
  51056. #. type: Plain text
  51057. #: guix-git/doc/guix.texi:34670
  51058. msgid "Next comes the programming interface for service types. This is something you want to know when writing new service definitions, but not necessarily when simply looking for ways to customize your @code{operating-system} declaration."
  51059. msgstr ""
  51060. #. type: deftp
  51061. #: guix-git/doc/guix.texi:34671
  51062. #, no-wrap
  51063. msgid "{Data Type} service-type"
  51064. msgstr ""
  51065. #. type: cindex
  51066. #: guix-git/doc/guix.texi:34672
  51067. #, no-wrap
  51068. msgid "service type"
  51069. msgstr ""
  51070. #. type: deftp
  51071. #: guix-git/doc/guix.texi:34675
  51072. msgid "This is the representation of a @dfn{service type} (@pxref{Service Types and Services})."
  51073. msgstr ""
  51074. #. type: table
  51075. #: guix-git/doc/guix.texi:34679
  51076. msgid "This is a symbol, used only to simplify inspection and debugging."
  51077. msgstr ""
  51078. #. type: code{#1}
  51079. #: guix-git/doc/guix.texi:34680
  51080. #, no-wrap
  51081. msgid "extensions"
  51082. msgstr ""
  51083. #. type: table
  51084. #: guix-git/doc/guix.texi:34682
  51085. msgid "A non-empty list of @code{<service-extension>} objects (see below)."
  51086. msgstr ""
  51087. #. type: item
  51088. #: guix-git/doc/guix.texi:34683
  51089. #, no-wrap
  51090. msgid "@code{compose} (default: @code{#f})"
  51091. msgstr ""
  51092. #. type: table
  51093. #: guix-git/doc/guix.texi:34687
  51094. msgid "If this is @code{#f}, then the service type denotes services that cannot be extended---i.e., services that do not receive ``values'' from other services."
  51095. msgstr ""
  51096. #. type: table
  51097. #: guix-git/doc/guix.texi:34691
  51098. msgid "Otherwise, it must be a one-argument procedure. The procedure is called by @code{fold-services} and is passed a list of values collected from extensions. It may return any single value."
  51099. msgstr ""
  51100. #. type: item
  51101. #: guix-git/doc/guix.texi:34692
  51102. #, no-wrap
  51103. msgid "@code{extend} (default: @code{#f})"
  51104. msgstr ""
  51105. #. type: table
  51106. #: guix-git/doc/guix.texi:34694
  51107. msgid "If this is @code{#f}, services of this type cannot be extended."
  51108. msgstr ""
  51109. #. type: table
  51110. #: guix-git/doc/guix.texi:34700
  51111. msgid "Otherwise, it must be a two-argument procedure: @code{fold-services} calls it, passing it the initial value of the service as the first argument and the result of applying @code{compose} to the extension values as the second argument. It must return a value that is a valid parameter value for the service instance."
  51112. msgstr ""
  51113. #. type: table
  51114. #: guix-git/doc/guix.texi:34706
  51115. msgid "This is a string, possibly using Texinfo markup, describing in a couple of sentences what the service is about. This string allows users to find about the service through @command{guix system search} (@pxref{Invoking guix system})."
  51116. msgstr ""
  51117. #. type: item
  51118. #: guix-git/doc/guix.texi:34707
  51119. #, no-wrap
  51120. msgid "@code{default-value} (default: @code{&no-default-value})"
  51121. msgstr ""
  51122. #. type: table
  51123. #: guix-git/doc/guix.texi:34710
  51124. msgid "The default value associated for instances of this service type. This allows users to use the @code{service} form without its second argument:"
  51125. msgstr ""
  51126. #. type: lisp
  51127. #: guix-git/doc/guix.texi:34713
  51128. #, no-wrap
  51129. msgid "(service @var{type})\n"
  51130. msgstr ""
  51131. #. type: table
  51132. #: guix-git/doc/guix.texi:34717
  51133. msgid "The returned service in this case has the default value specified by @var{type}."
  51134. msgstr ""
  51135. #. type: deftp
  51136. #: guix-git/doc/guix.texi:34720
  51137. msgid "@xref{Service Types and Services}, for examples."
  51138. msgstr ""
  51139. #. type: deffn
  51140. #: guix-git/doc/guix.texi:34722
  51141. #, no-wrap
  51142. msgid "{Scheme Procedure} service-extension @var{target-type} @"
  51143. msgstr ""
  51144. #. type: deffn
  51145. #: guix-git/doc/guix.texi:34728
  51146. msgid "@var{compute} Return a new extension for services of type @var{target-type}. @var{compute} must be a one-argument procedure: @code{fold-services} calls it, passing it the value associated with the service that provides the extension; it must return a valid value for the target service."
  51147. msgstr ""
  51148. #. type: deffn
  51149. #: guix-git/doc/guix.texi:34730
  51150. #, no-wrap
  51151. msgid "{Scheme Procedure} service-extension? @var{obj}"
  51152. msgstr ""
  51153. #. type: deffn
  51154. #: guix-git/doc/guix.texi:34732
  51155. msgid "Return true if @var{obj} is a service extension."
  51156. msgstr ""
  51157. #. type: Plain text
  51158. #: guix-git/doc/guix.texi:34738
  51159. msgid "Occasionally, you might want to simply extend an existing service. This involves creating a new service type and specifying the extension of interest, which can be verbose; the @code{simple-service} procedure provides a shorthand for this."
  51160. msgstr ""
  51161. #. type: deffn
  51162. #: guix-git/doc/guix.texi:34739
  51163. #, no-wrap
  51164. msgid "{Scheme Procedure} simple-service @var{name} @var{target} @var{value}"
  51165. msgstr ""
  51166. #. type: deffn
  51167. #: guix-git/doc/guix.texi:34743
  51168. msgid "Return a service that extends @var{target} with @var{value}. This works by creating a singleton service type @var{name}, of which the returned service is an instance."
  51169. msgstr ""
  51170. #. type: deffn
  51171. #: guix-git/doc/guix.texi:34746
  51172. msgid "For example, this extends mcron (@pxref{Scheduled Job Execution}) with an additional job:"
  51173. msgstr ""
  51174. #. type: lisp
  51175. #: guix-git/doc/guix.texi:34750
  51176. #, no-wrap
  51177. msgid ""
  51178. "(simple-service 'my-mcron-job mcron-service-type\n"
  51179. " #~(job '(next-hour (3)) \"guix gc -F 2G\"))\n"
  51180. msgstr ""
  51181. #. type: Plain text
  51182. #: guix-git/doc/guix.texi:34760
  51183. msgid "At the core of the service abstraction lies the @code{fold-services} procedure, which is responsible for ``compiling'' a list of services down to a single directory that contains everything needed to boot and run the system---the directory shown by the @command{guix system build} command (@pxref{Invoking guix system}). In essence, it propagates service extensions down the service graph, updating each node parameters on the way, until it reaches the root node."
  51184. msgstr ""
  51185. #. type: deffn
  51186. #: guix-git/doc/guix.texi:34761
  51187. #, no-wrap
  51188. msgid "{Scheme Procedure} fold-services @var{services} @"
  51189. msgstr ""
  51190. #. type: deffn
  51191. #: guix-git/doc/guix.texi:34765
  51192. msgid "[#:target-type @var{system-service-type}] Fold @var{services} by propagating their extensions down to the root of type @var{target-type}; return the root service adjusted accordingly."
  51193. msgstr ""
  51194. #. type: Plain text
  51195. #: guix-git/doc/guix.texi:34769
  51196. msgid "Lastly, the @code{(gnu services)} module also defines several essential service types, some of which are listed below."
  51197. msgstr ""
  51198. #. type: defvr
  51199. #: guix-git/doc/guix.texi:34770
  51200. #, no-wrap
  51201. msgid "{Scheme Variable} system-service-type"
  51202. msgstr ""
  51203. #. type: defvr
  51204. #: guix-git/doc/guix.texi:34773
  51205. msgid "This is the root of the service graph. It produces the system directory as returned by the @command{guix system build} command."
  51206. msgstr ""
  51207. #. type: defvr
  51208. #: guix-git/doc/guix.texi:34775
  51209. #, no-wrap
  51210. msgid "{Scheme Variable} boot-service-type"
  51211. msgstr ""
  51212. #. type: defvr
  51213. #: guix-git/doc/guix.texi:34778
  51214. msgid "The type of the ``boot service'', which produces the @dfn{boot script}. The boot script is what the initial RAM disk runs when booting."
  51215. msgstr ""
  51216. #. type: defvr
  51217. #: guix-git/doc/guix.texi:34780
  51218. #, no-wrap
  51219. msgid "{Scheme Variable} etc-service-type"
  51220. msgstr ""
  51221. #. type: defvr
  51222. #: guix-git/doc/guix.texi:34784
  51223. msgid "The type of the @file{/etc} service. This service is used to create files under @file{/etc} and can be extended by passing it name/file tuples such as:"
  51224. msgstr ""
  51225. #. type: lisp
  51226. #: guix-git/doc/guix.texi:34787
  51227. #, no-wrap
  51228. msgid "(list `(\"issue\" ,(plain-file \"issue\" \"Welcome!\\n\")))\n"
  51229. msgstr ""
  51230. #. type: defvr
  51231. #: guix-git/doc/guix.texi:34791
  51232. msgid "In this example, the effect would be to add an @file{/etc/issue} file pointing to the given file."
  51233. msgstr ""
  51234. #. type: defvr
  51235. #: guix-git/doc/guix.texi:34793
  51236. #, no-wrap
  51237. msgid "{Scheme Variable} setuid-program-service-type"
  51238. msgstr ""
  51239. #. type: defvr
  51240. #: guix-git/doc/guix.texi:34797
  51241. msgid "Type for the ``setuid-program service''. This service collects lists of executable file names, passed as gexps, and adds them to the set of setuid-root programs on the system (@pxref{Setuid Programs})."
  51242. msgstr ""
  51243. #. type: defvr
  51244. #: guix-git/doc/guix.texi:34799
  51245. #, no-wrap
  51246. msgid "{Scheme Variable} profile-service-type"
  51247. msgstr ""
  51248. #. type: defvr
  51249. #: guix-git/doc/guix.texi:34803
  51250. msgid "Type of the service that populates the @dfn{system profile}---i.e., the programs under @file{/run/current-system/profile}. Other services can extend it by passing it lists of packages to add to the system profile."
  51251. msgstr ""
  51252. #. type: anchor{#1}
  51253. #: guix-git/doc/guix.texi:34807
  51254. msgid "provenance-service-type"
  51255. msgstr ""
  51256. #. type: defvr
  51257. #: guix-git/doc/guix.texi:34807
  51258. #, no-wrap
  51259. msgid "{Scheme Variable} provenance-service-type"
  51260. msgstr ""
  51261. #. type: defvr
  51262. #: guix-git/doc/guix.texi:34811
  51263. msgid "This is the type of the service that records @dfn{provenance meta-data} in the system itself. It creates several files under @file{/run/current-system}:"
  51264. msgstr ""
  51265. #. type: item
  51266. #: guix-git/doc/guix.texi:34813
  51267. #, no-wrap
  51268. msgid "channels.scm"
  51269. msgstr ""
  51270. #. type: table
  51271. #: guix-git/doc/guix.texi:34818
  51272. msgid "This is a ``channel file'' that can be passed to @command{guix pull -C} or @command{guix time-machine -C}, and which describes the channels used to build the system, if that information was available (@pxref{Channels})."
  51273. msgstr ""
  51274. #. type: item
  51275. #: guix-git/doc/guix.texi:34819
  51276. #, no-wrap
  51277. msgid "configuration.scm"
  51278. msgstr ""
  51279. #. type: table
  51280. #: guix-git/doc/guix.texi:34824
  51281. msgid "This is the file that was passed as the value for this @code{provenance-service-type} service. By default, @command{guix system reconfigure} automatically passes the OS configuration file it received on the command line."
  51282. msgstr ""
  51283. #. type: item
  51284. #: guix-git/doc/guix.texi:34825
  51285. #, no-wrap
  51286. msgid "provenance"
  51287. msgstr ""
  51288. #. type: table
  51289. #: guix-git/doc/guix.texi:34828
  51290. msgid "This contains the same information as the two other files but in a format that is more readily processable."
  51291. msgstr ""
  51292. #. type: defvr
  51293. #: guix-git/doc/guix.texi:34832
  51294. msgid "In general, these two pieces of information (channels and configuration file) are enough to reproduce the operating system ``from source''."
  51295. msgstr ""
  51296. #. type: quotation
  51297. #: guix-git/doc/guix.texi:34833
  51298. #, no-wrap
  51299. msgid "Caveats"
  51300. msgstr ""
  51301. #. type: quotation
  51302. #: guix-git/doc/guix.texi:34840
  51303. msgid "This information is necessary to rebuild your operating system, but it is not always sufficient. In particular, @file{configuration.scm} itself is insufficient if it is not self-contained---if it refers to external Guile modules or to extra files. If you want @file{configuration.scm} to be self-contained, we recommend that modules or files it refers to be part of a channel."
  51304. msgstr ""
  51305. #. type: quotation
  51306. #: guix-git/doc/guix.texi:34848
  51307. msgid "Besides, provenance meta-data is ``silent'' in the sense that it does not change the bits contained in your system, @emph{except for the meta-data bits themselves}. Two different OS configurations or sets of channels can lead to the same system, bit-for-bit; when @code{provenance-service-type} is used, these two systems will have different meta-data and thus different store file names, which makes comparison less trivial."
  51308. msgstr ""
  51309. #. type: defvr
  51310. #: guix-git/doc/guix.texi:34853
  51311. msgid "This service is automatically added to your operating system configuration when you use @command{guix system reconfigure}, @command{guix system init}, or @command{guix deploy}."
  51312. msgstr ""
  51313. #. type: defvr
  51314. #: guix-git/doc/guix.texi:34855
  51315. #, no-wrap
  51316. msgid "{Scheme Variable} linux-loadable-module-service-type"
  51317. msgstr ""
  51318. #. type: defvr
  51319. #: guix-git/doc/guix.texi:34859
  51320. msgid "Type of the service that collects lists of packages containing kernel-loadable modules, and adds them to the set of kernel-loadable modules."
  51321. msgstr ""
  51322. #. type: defvr
  51323. #: guix-git/doc/guix.texi:34862
  51324. msgid "This service type is intended to be extended by other service types, such as below:"
  51325. msgstr ""
  51326. #. type: lisp
  51327. #: guix-git/doc/guix.texi:34868
  51328. #, no-wrap
  51329. msgid ""
  51330. "(simple-service 'installing-module\n"
  51331. " linux-loadable-module-service-type\n"
  51332. " (list module-to-install-1\n"
  51333. " module-to-install-2))\n"
  51334. msgstr ""
  51335. #. type: defvr
  51336. #: guix-git/doc/guix.texi:34872
  51337. msgid "This does not actually load modules at bootup, only adds it to the kernel profile so that it @emph{can} be loaded by other means."
  51338. msgstr ""
  51339. #. type: cindex
  51340. #: guix-git/doc/guix.texi:34877
  51341. #, no-wrap
  51342. msgid "shepherd services"
  51343. msgstr ""
  51344. #. type: cindex
  51345. #: guix-git/doc/guix.texi:34878
  51346. #, no-wrap
  51347. msgid "PID 1"
  51348. msgstr ""
  51349. #. type: cindex
  51350. #: guix-git/doc/guix.texi:34879
  51351. #, no-wrap
  51352. msgid "init system"
  51353. msgstr ""
  51354. #. type: Plain text
  51355. #: guix-git/doc/guix.texi:34885
  51356. msgid "The @code{(gnu services shepherd)} module provides a way to define services managed by the GNU@tie{}Shepherd, which is the initialization system---the first process that is started when the system boots, also known as PID@tie{}1 (@pxref{Introduction,,, shepherd, The GNU Shepherd Manual})."
  51357. msgstr ""
  51358. #. type: Plain text
  51359. #: guix-git/doc/guix.texi:34891
  51360. msgid "Services in the Shepherd can depend on each other. For instance, the SSH daemon may need to be started after the syslog daemon has been started, which in turn can only happen once all the file systems have been mounted. The simple operating system defined earlier (@pxref{Using the Configuration System}) results in a service graph like this:"
  51361. msgstr ""
  51362. #. type: Plain text
  51363. #: guix-git/doc/guix.texi:34893
  51364. msgid "@image{images/shepherd-graph,,5in,Typical shepherd service graph.}"
  51365. msgstr ""
  51366. #. type: Plain text
  51367. #: guix-git/doc/guix.texi:34897
  51368. msgid "You can actually generate such a graph for any operating system definition using the @command{guix system shepherd-graph} command (@pxref{system-shepherd-graph, @command{guix system shepherd-graph}})."
  51369. msgstr ""
  51370. #. type: Plain text
  51371. #: guix-git/doc/guix.texi:34901
  51372. msgid "The @code{%shepherd-root-service} is a service object representing PID@tie{}1, of type @code{shepherd-root-service-type}; it can be extended by passing it lists of @code{<shepherd-service>} objects."
  51373. msgstr ""
  51374. #. type: deftp
  51375. #: guix-git/doc/guix.texi:34902
  51376. #, no-wrap
  51377. msgid "{Data Type} shepherd-service"
  51378. msgstr ""
  51379. #. type: deftp
  51380. #: guix-git/doc/guix.texi:34904
  51381. msgid "The data type representing a service managed by the Shepherd."
  51382. msgstr ""
  51383. #. type: code{#1}
  51384. #: guix-git/doc/guix.texi:34906
  51385. #, no-wrap
  51386. msgid "provision"
  51387. msgstr ""
  51388. #. type: table
  51389. #: guix-git/doc/guix.texi:34908
  51390. msgid "This is a list of symbols denoting what the service provides."
  51391. msgstr ""
  51392. #. type: table
  51393. #: guix-git/doc/guix.texi:34913
  51394. msgid "These are the names that may be passed to @command{herd start}, @command{herd status}, and similar commands (@pxref{Invoking herd,,, shepherd, The GNU Shepherd Manual}). @xref{Slots of services, the @code{provides} slot,, shepherd, The GNU Shepherd Manual}, for details."
  51395. msgstr ""
  51396. #. type: item
  51397. #: guix-git/doc/guix.texi:34914
  51398. #, no-wrap
  51399. msgid "@code{requirement} (default: @code{'()})"
  51400. msgstr ""
  51401. #. type: table
  51402. #: guix-git/doc/guix.texi:34916
  51403. msgid "List of symbols denoting the Shepherd services this one depends on."
  51404. msgstr ""
  51405. #. type: cindex
  51406. #: guix-git/doc/guix.texi:34917
  51407. #, no-wrap
  51408. msgid "one-shot services, for the Shepherd"
  51409. msgstr ""
  51410. #. type: table
  51411. #: guix-git/doc/guix.texi:34922
  51412. msgid "Whether this service is @dfn{one-shot}. One-shot services stop immediately after their @code{start} action has completed. @xref{Slots of services,,, shepherd, The GNU Shepherd Manual}, for more info."
  51413. msgstr ""
  51414. #. type: item
  51415. #: guix-git/doc/guix.texi:34923
  51416. #, no-wrap
  51417. msgid "@code{respawn?} (default: @code{#t})"
  51418. msgstr ""
  51419. #. type: table
  51420. #: guix-git/doc/guix.texi:34926
  51421. msgid "Whether to restart the service when it stops, for instance when the underlying process dies."
  51422. msgstr ""
  51423. #. type: code{#1}
  51424. #: guix-git/doc/guix.texi:34927
  51425. #, no-wrap
  51426. msgid "start"
  51427. msgstr ""
  51428. #. type: itemx
  51429. #: guix-git/doc/guix.texi:34928
  51430. #, no-wrap
  51431. msgid "@code{stop} (default: @code{#~(const #f)})"
  51432. msgstr ""
  51433. #. type: table
  51434. #: guix-git/doc/guix.texi:34934
  51435. msgid "The @code{start} and @code{stop} fields refer to the Shepherd's facilities to start and stop processes (@pxref{Service De- and Constructors,,, shepherd, The GNU Shepherd Manual}). They are given as G-expressions that get expanded in the Shepherd configuration file (@pxref{G-Expressions})."
  51436. msgstr ""
  51437. #. type: item
  51438. #: guix-git/doc/guix.texi:34935
  51439. #, no-wrap
  51440. msgid "@code{actions} (default: @code{'()})"
  51441. msgstr ""
  51442. #. type: cindex
  51443. #: guix-git/doc/guix.texi:34936
  51444. #, no-wrap
  51445. msgid "actions, of Shepherd services"
  51446. msgstr ""
  51447. #. type: table
  51448. #: guix-git/doc/guix.texi:34941
  51449. msgid "This is a list of @code{shepherd-action} objects (see below) defining @dfn{actions} supported by the service, in addition to the standard @code{start} and @code{stop} actions. Actions listed here become available as @command{herd} sub-commands:"
  51450. msgstr ""
  51451. #. type: example
  51452. #: guix-git/doc/guix.texi:34944
  51453. #, no-wrap
  51454. msgid "herd @var{action} @var{service} [@var{arguments}@dots{}]\n"
  51455. msgstr ""
  51456. #. type: item
  51457. #: guix-git/doc/guix.texi:34946
  51458. #, no-wrap
  51459. msgid "@code{auto-start?} (default: @code{#t})"
  51460. msgstr ""
  51461. #. type: table
  51462. #: guix-git/doc/guix.texi:34949
  51463. msgid "Whether this service should be started automatically by the Shepherd. If it is @code{#f} the service has to be started manually with @code{herd start}."
  51464. msgstr ""
  51465. #. type: table
  51466. #: guix-git/doc/guix.texi:34952
  51467. msgid "A documentation string, as shown when running:"
  51468. msgstr ""
  51469. #. type: example
  51470. #: guix-git/doc/guix.texi:34955
  51471. #, no-wrap
  51472. msgid "herd doc @var{service-name}\n"
  51473. msgstr ""
  51474. #. type: table
  51475. #: guix-git/doc/guix.texi:34959
  51476. msgid "where @var{service-name} is one of the symbols in @code{provision} (@pxref{Invoking herd,,, shepherd, The GNU Shepherd Manual})."
  51477. msgstr ""
  51478. #. type: item
  51479. #: guix-git/doc/guix.texi:34960
  51480. #, no-wrap
  51481. msgid "@code{modules} (default: @code{%default-modules})"
  51482. msgstr ""
  51483. #. type: table
  51484. #: guix-git/doc/guix.texi:34963
  51485. msgid "This is the list of modules that must be in scope when @code{start} and @code{stop} are evaluated."
  51486. msgstr ""
  51487. #. type: Plain text
  51488. #: guix-git/doc/guix.texi:34971
  51489. msgid "The example below defines a Shepherd service that spawns @command{syslogd}, the system logger from the GNU Networking Utilities (@pxref{syslogd invocation, @command{syslogd},, inetutils, GNU Inetutils}):"
  51490. msgstr ""
  51491. #. type: example
  51492. #: guix-git/doc/guix.texi:34983
  51493. #, no-wrap
  51494. msgid ""
  51495. "(let ((config (plain-file \"syslogd.conf\" \"@dots{}\")))\n"
  51496. " (shepherd-service\n"
  51497. " (documentation \"Run the syslog daemon (syslogd).\")\n"
  51498. " (provision '(syslogd))\n"
  51499. " (requirement '(user-processes))\n"
  51500. " (start #~(make-forkexec-constructor\n"
  51501. " (list #$(file-append inetutils \"/libexec/syslogd\")\n"
  51502. " \"--rcfile\" #$config)\n"
  51503. " #:pid-file \"/var/run/syslog.pid\"))\n"
  51504. " (stop #~(make-kill-destructor))))\n"
  51505. msgstr ""
  51506. #. type: Plain text
  51507. #: guix-git/doc/guix.texi:34998
  51508. msgid "Key elements in this example are the @code{start} and @code{stop} fields: they are @dfn{staged} code snippets that use the @code{make-forkexec-constructor} procedure provided by the Shepherd and its dual, @code{make-kill-destructor} (@pxref{Service De- and Constructors,,, shepherd, The GNU Shepherd Manual}). The @code{start} field will have @command{shepherd} spawn @command{syslogd} with the given option; note that we pass @code{config} after @option{--rcfile}, which is a configuration file declared above (contents of this file are omitted). Likewise, the @code{stop} field tells how this service is to be stopped; in this case, it is stopped by making the @code{kill} system call on its PID@. Code staging is achieved using G-expressions: @code{#~} stages code, while @code{#$} ``escapes'' back to host code (@pxref{G-Expressions})."
  51509. msgstr ""
  51510. #. type: deftp
  51511. #: guix-git/doc/guix.texi:34999
  51512. #, no-wrap
  51513. msgid "{Data Type} shepherd-action"
  51514. msgstr ""
  51515. #. type: deftp
  51516. #: guix-git/doc/guix.texi:35002
  51517. msgid "This is the data type that defines additional actions implemented by a Shepherd service (see above)."
  51518. msgstr ""
  51519. #. type: table
  51520. #: guix-git/doc/guix.texi:35006
  51521. msgid "Symbol naming the action."
  51522. msgstr ""
  51523. #. type: table
  51524. #: guix-git/doc/guix.texi:35009
  51525. msgid "This is a documentation string for the action. It can be viewed by running:"
  51526. msgstr ""
  51527. #. type: example
  51528. #: guix-git/doc/guix.texi:35012
  51529. #, no-wrap
  51530. msgid "herd doc @var{service} action @var{action}\n"
  51531. msgstr ""
  51532. #. type: item
  51533. #: guix-git/doc/guix.texi:35014
  51534. #, no-wrap
  51535. msgid "procedure"
  51536. msgstr ""
  51537. #. type: table
  51538. #: guix-git/doc/guix.texi:35018
  51539. msgid "This should be a gexp that evaluates to a procedure of at least one argument, which is the ``running value'' of the service (@pxref{Slots of services,,, shepherd, The GNU Shepherd Manual})."
  51540. msgstr ""
  51541. #. type: deftp
  51542. #: guix-git/doc/guix.texi:35022
  51543. msgid "The following example defines an action called @code{say-hello} that kindly greets the user:"
  51544. msgstr ""
  51545. #. type: lisp
  51546. #: guix-git/doc/guix.texi:35031
  51547. #, no-wrap
  51548. msgid ""
  51549. "(shepherd-action\n"
  51550. " (name 'say-hello)\n"
  51551. " (documentation \"Say hi!\")\n"
  51552. " (procedure #~(lambda (running . args)\n"
  51553. " (format #t \"Hello, friend! arguments: ~s\\n\"\n"
  51554. " args)\n"
  51555. " #t)))\n"
  51556. msgstr ""
  51557. #. type: deftp
  51558. #: guix-git/doc/guix.texi:35034
  51559. msgid "Assuming this action is added to the @code{example} service, then you can do:"
  51560. msgstr ""
  51561. #. type: example
  51562. #: guix-git/doc/guix.texi:35040
  51563. #, no-wrap
  51564. msgid ""
  51565. "# herd say-hello example\n"
  51566. "Hello, friend! arguments: ()\n"
  51567. "# herd say-hello example a b c\n"
  51568. "Hello, friend! arguments: (\"a\" \"b\" \"c\")\n"
  51569. msgstr ""
  51570. #. type: deftp
  51571. #: guix-git/doc/guix.texi:35045
  51572. msgid "This, as you can see, is a fairly sophisticated way to say hello. @xref{Service Convenience,,, shepherd, The GNU Shepherd Manual}, for more info on actions."
  51573. msgstr ""
  51574. #. type: defvr
  51575. #: guix-git/doc/guix.texi:35047
  51576. #, no-wrap
  51577. msgid "{Scheme Variable} shepherd-root-service-type"
  51578. msgstr ""
  51579. #. type: defvr
  51580. #: guix-git/doc/guix.texi:35049
  51581. msgid "The service type for the Shepherd ``root service''---i.e., PID@tie{}1."
  51582. msgstr ""
  51583. #. type: defvr
  51584. #: guix-git/doc/guix.texi:35054
  51585. msgid "This is the service type that extensions target when they want to create shepherd services (@pxref{Service Types and Services}, for an example). Each extension must pass a list of @code{<shepherd-service>}. Its value must be a @code{shepherd-configuration}, as described below."
  51586. msgstr ""
  51587. #. type: deftp
  51588. #: guix-git/doc/guix.texi:35056
  51589. #, no-wrap
  51590. msgid "{Data Type} shepherd-configuration"
  51591. msgstr ""
  51592. #. type: deftp
  51593. #: guix-git/doc/guix.texi:35058
  51594. msgid "This data type represents the Shepherd's configuration."
  51595. msgstr ""
  51596. #. type: item
  51597. #: guix-git/doc/guix.texi:35060
  51598. #, no-wrap
  51599. msgid "shepherd (default: @code{shepherd})"
  51600. msgstr ""
  51601. #. type: table
  51602. #: guix-git/doc/guix.texi:35062
  51603. msgid "The Shepherd package to use."
  51604. msgstr ""
  51605. #. type: item
  51606. #: guix-git/doc/guix.texi:35063
  51607. #, no-wrap
  51608. msgid "services (default: @code{'()})"
  51609. msgstr ""
  51610. #. type: table
  51611. #: guix-git/doc/guix.texi:35067
  51612. msgid "A list of @code{<shepherd-service>} to start. You should probably use the service extension mechanism instead (@pxref{Shepherd Services})."
  51613. msgstr ""
  51614. #. type: Plain text
  51615. #: guix-git/doc/guix.texi:35072
  51616. msgid "The following example specifies the Shepherd package for the operating system:"
  51617. msgstr ""
  51618. #. type: lisp
  51619. #: guix-git/doc/guix.texi:35087
  51620. #, no-wrap
  51621. msgid ""
  51622. "(operating-system\n"
  51623. " ;; ...\n"
  51624. " (services (append (list openssh-service-type))\n"
  51625. " ;; ...\n"
  51626. " %desktop-services)\n"
  51627. " ;; ...\n"
  51628. " ;; Use own Shepherd package.\n"
  51629. " (essential-services\n"
  51630. " (modify-services (operating-system-default-essential-services\n"
  51631. " this-operating-system)\n"
  51632. " (shepherd-root-service-type config => (shepherd-configuration\n"
  51633. " (inherit config)\n"
  51634. " (shepherd my-shepherd))))))\n"
  51635. msgstr ""
  51636. #. type: defvr
  51637. #: guix-git/doc/guix.texi:35089
  51638. #, no-wrap
  51639. msgid "{Scheme Variable} %shepherd-root-service"
  51640. msgstr ""
  51641. #. type: defvr
  51642. #: guix-git/doc/guix.texi:35091
  51643. msgid "This service represents PID@tie{}1."
  51644. msgstr ""
  51645. #. type: cindex
  51646. #: guix-git/doc/guix.texi:35097
  51647. #, no-wrap
  51648. msgid "documentation, searching for"
  51649. msgstr ""
  51650. #. type: cindex
  51651. #: guix-git/doc/guix.texi:35098
  51652. #, no-wrap
  51653. msgid "searching for documentation"
  51654. msgstr ""
  51655. #. type: cindex
  51656. #: guix-git/doc/guix.texi:35099
  51657. #, no-wrap
  51658. msgid "Info, documentation format"
  51659. msgstr ""
  51660. #. type: cindex
  51661. #: guix-git/doc/guix.texi:35100
  51662. #, no-wrap
  51663. msgid "man pages"
  51664. msgstr ""
  51665. #. type: cindex
  51666. #: guix-git/doc/guix.texi:35101
  51667. #, no-wrap
  51668. msgid "manual pages"
  51669. msgstr ""
  51670. #. type: Plain text
  51671. #: guix-git/doc/guix.texi:35108
  51672. msgid "In most cases packages installed with Guix come with documentation. There are two main documentation formats: ``Info'', a browsable hypertext format used for GNU software, and ``manual pages'' (or ``man pages''), the linear documentation format traditionally found on Unix. Info manuals are accessed with the @command{info} command or with Emacs, and man pages are accessed using @command{man}."
  51673. msgstr ""
  51674. #. type: Plain text
  51675. #: guix-git/doc/guix.texi:35112
  51676. msgid "You can look for documentation of software installed on your system by keyword. For example, the following command searches for information about ``TLS'' in Info manuals:"
  51677. msgstr ""
  51678. #. type: example
  51679. #: guix-git/doc/guix.texi:35120
  51680. #, no-wrap
  51681. msgid ""
  51682. "$ info -k TLS\n"
  51683. "\"(emacs)Network Security\" -- STARTTLS\n"
  51684. "\"(emacs)Network Security\" -- TLS\n"
  51685. "\"(gnutls)Core TLS API\" -- gnutls_certificate_set_verify_flags\n"
  51686. "\"(gnutls)Core TLS API\" -- gnutls_certificate_set_verify_function\n"
  51687. "@dots{}\n"
  51688. msgstr ""
  51689. #. type: Plain text
  51690. #: guix-git/doc/guix.texi:35124
  51691. msgid "The command below searches for the same keyword in man pages:"
  51692. msgstr ""
  51693. #. type: example
  51694. #: guix-git/doc/guix.texi:35130
  51695. #, no-wrap
  51696. msgid ""
  51697. "$ man -k TLS\n"
  51698. "SSL (7) - OpenSSL SSL/TLS library\n"
  51699. "certtool (1) - GnuTLS certificate tool\n"
  51700. "@dots {}\n"
  51701. msgstr ""
  51702. #. type: Plain text
  51703. #: guix-git/doc/guix.texi:35136
  51704. msgid "These searches are purely local to your computer so you have the guarantee that documentation you find corresponds to what you have actually installed, you can access it off-line, and your privacy is respected."
  51705. msgstr ""
  51706. #. type: Plain text
  51707. #: guix-git/doc/guix.texi:35139
  51708. msgid "Once you have these results, you can view the relevant documentation by running, say:"
  51709. msgstr ""
  51710. #. type: example
  51711. #: guix-git/doc/guix.texi:35142
  51712. #, no-wrap
  51713. msgid "$ info \"(gnutls)Core TLS API\"\n"
  51714. msgstr ""
  51715. #. type: Plain text
  51716. #: guix-git/doc/guix.texi:35146
  51717. msgid "or:"
  51718. msgstr ""
  51719. #. type: example
  51720. #: guix-git/doc/guix.texi:35149
  51721. #, no-wrap
  51722. msgid "$ man certtool\n"
  51723. msgstr ""
  51724. #. type: Plain text
  51725. #: guix-git/doc/guix.texi:35157
  51726. msgid "Info manuals contain sections and indices as well as hyperlinks like those found in Web pages. The @command{info} reader (@pxref{Top, Info reader,, info-stnd, Stand-alone GNU Info}) and its Emacs counterpart (@pxref{Misc Help,,, emacs, The GNU Emacs Manual}) provide intuitive key bindings to navigate manuals. @xref{Getting Started,,, info, Info: An Introduction}, for an introduction to Info navigation."
  51727. msgstr ""
  51728. #. type: cindex
  51729. #: guix-git/doc/guix.texi:35161
  51730. #, no-wrap
  51731. msgid "debugging files"
  51732. msgstr ""
  51733. #. type: Plain text
  51734. #: guix-git/doc/guix.texi:35167
  51735. msgid "Program binaries, as produced by the GCC compilers for instance, are typically written in the ELF format, with a section containing @dfn{debugging information}. Debugging information is what allows the debugger, GDB, to map binary code to source code; it is required to debug a compiled program in good conditions."
  51736. msgstr ""
  51737. #. type: Plain text
  51738. #: guix-git/doc/guix.texi:35171
  51739. msgid "This chapter explains how to use separate debug info when packages provide it, and how to rebuild packages with debug info when it's missing."
  51740. msgstr ""
  51741. #. type: Plain text
  51742. #: guix-git/doc/guix.texi:35187
  51743. msgid "The problem with debugging information is that is takes up a fair amount of disk space. For example, debugging information for the GNU C Library weighs in at more than 60 MiB@. Thus, as a user, keeping all the debugging info of all the installed programs is usually not an option. Yet, space savings should not come at the cost of an impediment to debugging---especially in the GNU system, which should make it easier for users to exert their computing freedom (@pxref{GNU Distribution})."
  51744. msgstr ""
  51745. #. type: Plain text
  51746. #: guix-git/doc/guix.texi:35194
  51747. msgid "Thankfully, the GNU Binary Utilities (Binutils) and GDB provide a mechanism that allows users to get the best of both worlds: debugging information can be stripped from the binaries and stored in separate files. GDB is then able to load debugging information from those files, when they are available (@pxref{Separate Debug Files,,, gdb, Debugging with GDB})."
  51748. msgstr ""
  51749. #. type: Plain text
  51750. #: guix-git/doc/guix.texi:35202
  51751. msgid "The GNU distribution takes advantage of this by storing debugging information in the @code{lib/debug} sub-directory of a separate package output unimaginatively called @code{debug} (@pxref{Packages with Multiple Outputs}). Users can choose to install the @code{debug} output of a package when they need it. For instance, the following command installs the debugging information for the GNU C Library and for GNU Guile:"
  51752. msgstr ""
  51753. #. type: example
  51754. #: guix-git/doc/guix.texi:35205
  51755. #, no-wrap
  51756. msgid "guix install glibc:debug guile:debug\n"
  51757. msgstr ""
  51758. #. type: Plain text
  51759. #: guix-git/doc/guix.texi:35211
  51760. msgid "GDB must then be told to look for debug files in the user's profile, by setting the @code{debug-file-directory} variable (consider setting it from the @file{~/.gdbinit} file, @pxref{Startup,,, gdb, Debugging with GDB}):"
  51761. msgstr ""
  51762. #. type: example
  51763. #: guix-git/doc/guix.texi:35214
  51764. #, no-wrap
  51765. msgid "(gdb) set debug-file-directory ~/.guix-profile/lib/debug\n"
  51766. msgstr ""
  51767. #. type: Plain text
  51768. #: guix-git/doc/guix.texi:35218
  51769. msgid "From there on, GDB will pick up debugging information from the @file{.debug} files under @file{~/.guix-profile/lib/debug}."
  51770. msgstr ""
  51771. #. type: Plain text
  51772. #: guix-git/doc/guix.texi:35225
  51773. msgid "In addition, you will most likely want GDB to be able to show the source code being debugged. To do that, you will have to unpack the source code of the package of interest (obtained with @code{guix build --source}, @pxref{Invoking guix build}), and to point GDB to that source directory using the @code{directory} command (@pxref{Source Path, @code{directory},, gdb, Debugging with GDB})."
  51774. msgstr ""
  51775. #. type: Plain text
  51776. #: guix-git/doc/guix.texi:35233
  51777. msgid "The @code{debug} output mechanism in Guix is implemented by the @code{gnu-build-system} (@pxref{Build Systems}). Currently, it is opt-in---debugging information is available only for the packages with definitions explicitly declaring a @code{debug} output. To check whether a package has a @code{debug} output, use @command{guix package --list-available} (@pxref{Invoking guix package})."
  51778. msgstr ""
  51779. #. type: Plain text
  51780. #: guix-git/doc/guix.texi:35235
  51781. msgid "Read on for how to deal with packages lacking a @code{debug} output."
  51782. msgstr ""
  51783. #. type: Plain text
  51784. #: guix-git/doc/guix.texi:35247
  51785. msgid "As we saw above, some packages, but not all, provide debugging info in a @code{debug} output. What can you do when debugging info is missing? The @option{--with-debug-info} option provides a solution to that: it allows you to rebuild the package(s) for which debugging info is missing---and only those---and to graft those onto the application you're debugging. Thus, while it's not as fast as installing a @code{debug} output, it is relatively inexpensive."
  51786. msgstr ""
  51787. #. type: Plain text
  51788. #: guix-git/doc/guix.texi:35252
  51789. msgid "Let's illustrate that. Suppose you're experiencing a bug in Inkscape and would like to see what's going on in GLib, a library that's deep down in its dependency graph. As it turns out, GLib does not have a @code{debug} output and the backtrace GDB shows is all sadness:"
  51790. msgstr ""
  51791. #. type: example
  51792. #: guix-git/doc/guix.texi:35263
  51793. #, no-wrap
  51794. msgid ""
  51795. "(gdb) bt\n"
  51796. "#0 0x00007ffff5f92190 in g_getenv ()\n"
  51797. " from /gnu/store/@dots{}-glib-2.62.6/lib/libglib-2.0.so.0\n"
  51798. "#1 0x00007ffff608a7d6 in gobject_init_ctor ()\n"
  51799. " from /gnu/store/@dots{}-glib-2.62.6/lib/libgobject-2.0.so.0\n"
  51800. "#2 0x00007ffff7fe275a in call_init (l=<optimized out>, argc=argc@@entry=1, argv=argv@@entry=0x7fffffffcfd8, \n"
  51801. " env=env@@entry=0x7fffffffcfe8) at dl-init.c:72\n"
  51802. "#3 0x00007ffff7fe2866 in call_init (env=0x7fffffffcfe8, argv=0x7fffffffcfd8, argc=1, l=<optimized out>)\n"
  51803. " at dl-init.c:118\n"
  51804. msgstr ""
  51805. #. type: Plain text
  51806. #: guix-git/doc/guix.texi:35267
  51807. msgid "To address that, you install Inkscape linked against a variant GLib that contains debug info:"
  51808. msgstr ""
  51809. #. type: Plain text
  51810. #: guix-git/doc/guix.texi:35273
  51811. msgid "This time, debugging will be a whole lot nicer:"
  51812. msgstr ""
  51813. #. type: example
  51814. #: guix-git/doc/guix.texi:35291
  51815. #, no-wrap
  51816. msgid ""
  51817. "$ gdb --args sh -c 'exec inkscape'\n"
  51818. "@dots{}\n"
  51819. "(gdb) b g_getenv\n"
  51820. "Function \"g_getenv\" not defined.\n"
  51821. "Make breakpoint pending on future shared library load? (y or [n]) y\n"
  51822. "Breakpoint 1 (g_getenv) pending.\n"
  51823. "(gdb) r\n"
  51824. "Starting program: /gnu/store/@dots{}-profile/bin/sh -c exec\\ inkscape\n"
  51825. "@dots{}\n"
  51826. "(gdb) bt\n"
  51827. "#0 g_getenv (variable=variable@@entry=0x7ffff60c7a2e \"GOBJECT_DEBUG\") at ../glib-2.62.6/glib/genviron.c:252\n"
  51828. "#1 0x00007ffff608a7d6 in gobject_init () at ../glib-2.62.6/gobject/gtype.c:4380\n"
  51829. "#2 gobject_init_ctor () at ../glib-2.62.6/gobject/gtype.c:4493\n"
  51830. "#3 0x00007ffff7fe275a in call_init (l=<optimized out>, argc=argc@@entry=3, argv=argv@@entry=0x7fffffffd088, \n"
  51831. " env=env@@entry=0x7fffffffd0a8) at dl-init.c:72\n"
  51832. "@dots{}\n"
  51833. msgstr ""
  51834. #. type: Plain text
  51835. #: guix-git/doc/guix.texi:35294
  51836. msgid "Much better!"
  51837. msgstr ""
  51838. #. type: Plain text
  51839. #: guix-git/doc/guix.texi:35298
  51840. msgid "Note that there can be packages for which @option{--with-debug-info} will not have the desired effect. @xref{Package Transformation Options, @option{--with-debug-info}}, for more information."
  51841. msgstr ""
  51842. #. type: cindex
  51843. #: guix-git/doc/guix.texi:35302
  51844. #, no-wrap
  51845. msgid "security updates"
  51846. msgstr ""
  51847. #. type: Plain text
  51848. #: guix-git/doc/guix.texi:35311
  51849. msgid "Occasionally, important security vulnerabilities are discovered in software packages and must be patched. Guix developers try hard to keep track of known vulnerabilities and to apply fixes as soon as possible in the @code{master} branch of Guix (we do not yet provide a ``stable'' branch containing only security updates). The @command{guix lint} tool helps developers find out about vulnerable versions of software packages in the distribution:"
  51850. msgstr ""
  51851. #. type: smallexample
  51852. #: guix-git/doc/guix.texi:35318
  51853. #, no-wrap
  51854. msgid ""
  51855. "$ guix lint -c cve\n"
  51856. "gnu/packages/base.scm:652:2: glibc@@2.21: probably vulnerable to CVE-2015-1781, CVE-2015-7547\n"
  51857. "gnu/packages/gcc.scm:334:2: gcc@@4.9.3: probably vulnerable to CVE-2015-5276\n"
  51858. "gnu/packages/image.scm:312:2: openjpeg@@2.1.0: probably vulnerable to CVE-2016-1923, CVE-2016-1924\n"
  51859. "@dots{}\n"
  51860. msgstr ""
  51861. #. type: Plain text
  51862. #: guix-git/doc/guix.texi:35321
  51863. msgid "@xref{Invoking guix lint}, for more information."
  51864. msgstr ""
  51865. #. type: Plain text
  51866. #: guix-git/doc/guix.texi:35330
  51867. msgid "Guix follows a functional package management discipline (@pxref{Introduction}), which implies that, when a package is changed, @emph{every package that depends on it} must be rebuilt. This can significantly slow down the deployment of fixes in core packages such as libc or Bash, since basically the whole distribution would need to be rebuilt. Using pre-built binaries helps (@pxref{Substitutes}), but deployment may still take more time than desired."
  51868. msgstr ""
  51869. #. type: cindex
  51870. #: guix-git/doc/guix.texi:35331
  51871. #, no-wrap
  51872. msgid "grafts"
  51873. msgstr ""
  51874. #. type: Plain text
  51875. #: guix-git/doc/guix.texi:35339
  51876. msgid "To address this, Guix implements @dfn{grafts}, a mechanism that allows for fast deployment of critical updates without the costs associated with a whole-distribution rebuild. The idea is to rebuild only the package that needs to be patched, and then to ``graft'' it onto packages explicitly installed by the user and that were previously referring to the original package. The cost of grafting is typically very low, and order of magnitudes lower than a full rebuild of the dependency chain."
  51877. msgstr ""
  51878. #. type: cindex
  51879. #: guix-git/doc/guix.texi:35340
  51880. #, no-wrap
  51881. msgid "replacements of packages, for grafts"
  51882. msgstr ""
  51883. #. type: Plain text
  51884. #: guix-git/doc/guix.texi:35346
  51885. msgid "For instance, suppose a security update needs to be applied to Bash. Guix developers will provide a package definition for the ``fixed'' Bash, say @code{bash-fixed}, in the usual way (@pxref{Defining Packages}). Then, the original package definition is augmented with a @code{replacement} field pointing to the package containing the bug fix:"
  51886. msgstr ""
  51887. #. type: lisp
  51888. #: guix-git/doc/guix.texi:35353
  51889. #, no-wrap
  51890. msgid ""
  51891. "(define bash\n"
  51892. " (package\n"
  51893. " (name \"bash\")\n"
  51894. " ;; @dots{}\n"
  51895. " (replacement bash-fixed)))\n"
  51896. msgstr ""
  51897. #. type: Plain text
  51898. #: guix-git/doc/guix.texi:35363
  51899. msgid "From there on, any package depending directly or indirectly on Bash---as reported by @command{guix gc --requisites} (@pxref{Invoking guix gc})---that is installed is automatically ``rewritten'' to refer to @code{bash-fixed} instead of @code{bash}. This grafting process takes time proportional to the size of the package, usually less than a minute for an ``average'' package on a recent machine. Grafting is recursive: when an indirect dependency requires grafting, then grafting ``propagates'' up to the package that the user is installing."
  51900. msgstr ""
  51901. #. type: Plain text
  51902. #: guix-git/doc/guix.texi:35371
  51903. msgid "Currently, the length of the name and version of the graft and that of the package it replaces (@code{bash-fixed} and @code{bash} in the example above) must be equal. This restriction mostly comes from the fact that grafting works by patching files, including binary files, directly. Other restrictions may apply: for instance, when adding a graft to a package providing a shared library, the original shared library and its replacement must have the same @code{SONAME} and be binary-compatible."
  51904. msgstr ""
  51905. #. type: Plain text
  51906. #: guix-git/doc/guix.texi:35375
  51907. msgid "The @option{--no-grafts} command-line option allows you to forcefully avoid grafting (@pxref{Common Build Options, @option{--no-grafts}}). Thus, the command:"
  51908. msgstr ""
  51909. #. type: example
  51910. #: guix-git/doc/guix.texi:35378
  51911. #, no-wrap
  51912. msgid "guix build bash --no-grafts\n"
  51913. msgstr ""
  51914. #. type: Plain text
  51915. #: guix-git/doc/guix.texi:35382
  51916. msgid "returns the store file name of the original Bash, whereas:"
  51917. msgstr ""
  51918. #. type: example
  51919. #: guix-git/doc/guix.texi:35385
  51920. #, no-wrap
  51921. msgid "guix build bash\n"
  51922. msgstr ""
  51923. #. type: Plain text
  51924. #: guix-git/doc/guix.texi:35390
  51925. msgid "returns the store file name of the ``fixed'', replacement Bash. This allows you to distinguish between the two variants of Bash."
  51926. msgstr ""
  51927. #. type: Plain text
  51928. #: guix-git/doc/guix.texi:35393
  51929. msgid "To verify which Bash your whole profile refers to, you can run (@pxref{Invoking guix gc}):"
  51930. msgstr ""
  51931. #. type: example
  51932. #: guix-git/doc/guix.texi:35396
  51933. #, no-wrap
  51934. msgid "guix gc -R $(readlink -f ~/.guix-profile) | grep bash\n"
  51935. msgstr ""
  51936. #. type: Plain text
  51937. #: guix-git/doc/guix.texi:35401
  51938. msgid "@dots{} and compare the store file names that you get with those above. Likewise for a complete Guix system generation:"
  51939. msgstr ""
  51940. #. type: example
  51941. #: guix-git/doc/guix.texi:35404
  51942. #, no-wrap
  51943. msgid "guix gc -R $(guix system build my-config.scm) | grep bash\n"
  51944. msgstr ""
  51945. #. type: Plain text
  51946. #: guix-git/doc/guix.texi:35408
  51947. msgid "Lastly, to check which Bash running processes are using, you can use the @command{lsof} command:"
  51948. msgstr ""
  51949. #. type: example
  51950. #: guix-git/doc/guix.texi:35411
  51951. #, no-wrap
  51952. msgid "lsof | grep /gnu/store/.*bash\n"
  51953. msgstr ""
  51954. #. type: cindex
  51955. #: guix-git/doc/guix.texi:35419
  51956. #, no-wrap
  51957. msgid "bootstrapping"
  51958. msgstr ""
  51959. #. type: Plain text
  51960. #: guix-git/doc/guix.texi:35426
  51961. msgid "Bootstrapping in our context refers to how the distribution gets built ``from nothing''. Remember that the build environment of a derivation contains nothing but its declared inputs (@pxref{Introduction}). So there's an obvious chicken-and-egg problem: how does the first package get built? How does the first compiler get compiled?"
  51962. msgstr ""
  51963. #. type: Plain text
  51964. #: guix-git/doc/guix.texi:35434
  51965. msgid "It is tempting to think of this question as one that only die-hard hackers may care about. However, while the answer to that question is technical in nature, its implications are wide-ranging. How the distribution is bootstrapped defines the extent to which we, as individuals and as a collective of users and hackers, can trust the software we run. It is a central concern from the standpoint of @emph{security} and from a @emph{user freedom} viewpoint."
  51966. msgstr ""
  51967. #. type: cindex
  51968. #: guix-git/doc/guix.texi:35435 guix-git/doc/guix.texi:35647
  51969. #, no-wrap
  51970. msgid "bootstrap binaries"
  51971. msgstr ""
  51972. #. type: Plain text
  51973. #: guix-git/doc/guix.texi:35445
  51974. msgid "The GNU system is primarily made of C code, with libc at its core. The GNU build system itself assumes the availability of a Bourne shell and command-line tools provided by GNU Coreutils, Awk, Findutils, `sed', and `grep'. Furthermore, build programs---programs that run @code{./configure}, @code{make}, etc.---are written in Guile Scheme (@pxref{Derivations}). Consequently, to be able to build anything at all, from scratch, Guix relies on pre-built binaries of Guile, GCC, Binutils, libc, and the other packages mentioned above---the @dfn{bootstrap binaries}."
  51975. msgstr ""
  51976. #. type: Plain text
  51977. #: guix-git/doc/guix.texi:35449
  51978. msgid "These bootstrap binaries are ``taken for granted'', though we can also re-create them if needed (@pxref{Preparing to Use the Bootstrap Binaries})."
  51979. msgstr ""
  51980. #. type: section
  51981. #: guix-git/doc/guix.texi:35456
  51982. #, no-wrap
  51983. msgid "The Reduced Binary Seed Bootstrap"
  51984. msgstr ""
  51985. #. type: Plain text
  51986. #: guix-git/doc/guix.texi:35463
  51987. msgid "Guix---like other GNU/Linux distributions---is traditionally bootstrapped from a set of bootstrap binaries: Bourne shell, command-line tools provided by GNU Coreutils, Awk, Findutils, `sed', and `grep' and Guile, GCC, Binutils, and the GNU C Library (@pxref{Bootstrapping}). Usually, these bootstrap binaries are ``taken for granted.''"
  51988. msgstr ""
  51989. #. type: Plain text
  51990. #: guix-git/doc/guix.texi:35469
  51991. msgid "Taking the bootstrap binaries for granted means that we consider them to be a correct and trustworthy ``seed'' for building the complete system. Therein lies a problem: the combined size of these bootstrap binaries is about 250MB (@pxref{Bootstrappable Builds,,, mes, GNU Mes}). Auditing or even inspecting these is next to impossible."
  51992. msgstr ""
  51993. #. type: Plain text
  51994. #: guix-git/doc/guix.texi:35474
  51995. msgid "For @code{i686-linux} and @code{x86_64-linux}, Guix now features a ``Reduced Binary Seed'' bootstrap @footnote{We would like to say: ``Full Source Bootstrap'' and while we are working towards that goal it would be hyperbole to use that term for what we do now.}."
  51996. msgstr ""
  51997. #. type: Plain text
  51998. #: guix-git/doc/guix.texi:35480
  51999. msgid "The Reduced Binary Seed bootstrap removes the most critical tools---from a trust perspective---from the bootstrap binaries: GCC, Binutils and the GNU C Library are replaced by: @code{bootstrap-mescc-tools} (a tiny assembler and linker) and @code{bootstrap-mes} (a small Scheme Interpreter and a C compiler written in Scheme and the Mes C Library, built for TinyCC and for GCC)."
  52000. msgstr ""
  52001. #. type: Plain text
  52002. #: guix-git/doc/guix.texi:35485
  52003. msgid "Using these new binary seeds the ``missing'' Binutils, GCC, and the GNU C Library are built from source. From here on the more traditional bootstrap process resumes. This approach has reduced the bootstrap binaries in size to about 145MB in Guix v1.1."
  52004. msgstr ""
  52005. #. type: Plain text
  52006. #: guix-git/doc/guix.texi:35493
  52007. msgid "The next step that Guix has taken is to replace the shell and all its utilities with implementations in Guile Scheme, the @emph{Scheme-only bootstrap}. Gash (@pxref{Gash,,, gash, The Gash manual}) is a POSIX-compatible shell that replaces Bash, and it comes with Gash Utils which has minimalist replacements for Awk, the GNU Core Utilities, Grep, Gzip, Sed, and Tar. The rest of the bootstrap binary seeds that were removed are now built from source."
  52008. msgstr ""
  52009. #. type: Plain text
  52010. #: guix-git/doc/guix.texi:35503
  52011. msgid "Building the GNU System from source is currently only possible by adding some historical GNU packages as intermediate steps@footnote{Packages such as @code{gcc-2.95.3}, @code{binutils-2.14}, @code{glibc-2.2.5}, @code{gzip-1.2.4}, @code{tar-1.22}, and some others. For details, see @file{gnu/packages/commencement.scm}.}. As Gash and Gash Utils mature, and GNU packages become more bootstrappable again (e.g., new releases of GNU Sed will also ship as gzipped tarballs again, as alternative to the hard to bootstrap @code{xz}-compression), this set of added packages can hopefully be reduced again."
  52012. msgstr ""
  52013. #. type: Plain text
  52014. #: guix-git/doc/guix.texi:35507
  52015. msgid "The graph below shows the resulting dependency graph for @code{gcc-core-mesboot0}, the bootstrap compiler used for the traditional bootstrap of the rest of the Guix System."
  52016. msgstr ""
  52017. #. type: Plain text
  52018. #: guix-git/doc/guix.texi:35510
  52019. msgid "@image{images/gcc-core-mesboot0-graph,6in,,Dependency graph of gcc-core-mesboot0}"
  52020. msgstr ""
  52021. #. type: Plain text
  52022. #: guix-git/doc/guix.texi:35517
  52023. msgid "The only significant binary bootstrap seeds that remain@footnote{ Ignoring the 68KB @code{mescc-tools}; that will be removed later, together with @code{mes}.} are a Scheme interpreter and a Scheme compiler: GNU Mes and GNU Guile@footnote{Not shown in this graph are the static binaries for @file{bash}, @code{tar}, and @code{xz} that are used to get Guile running.}."
  52024. msgstr ""
  52025. #. type: Plain text
  52026. #: guix-git/doc/guix.texi:35520
  52027. msgid "This further reduction has brought down the size of the binary seed to about 60MB for @code{i686-linux} and @code{x86_64-linux}."
  52028. msgstr ""
  52029. #. type: Plain text
  52030. #: guix-git/doc/guix.texi:35525
  52031. msgid "Work is ongoing to remove all binary blobs from our free software bootstrap stack, working towards a Full Source Bootstrap. Also ongoing is work to bring these bootstraps to the @code{arm-linux} and @code{aarch64-linux} architectures and to the Hurd."
  52032. msgstr ""
  52033. #. type: Plain text
  52034. #: guix-git/doc/guix.texi:35529
  52035. msgid "If you are interested, join us on @samp{#bootstrappable} on the Freenode IRC network or discuss on @email{bug-mes@@gnu.org} or @email{gash-devel@@nongnu.org}."
  52036. msgstr ""
  52037. #. type: Plain text
  52038. #: guix-git/doc/guix.texi:35536
  52039. msgid "@image{images/bootstrap-graph,6in,,Dependency graph of the early bootstrap derivations}"
  52040. msgstr ""
  52041. #. type: Plain text
  52042. #: guix-git/doc/guix.texi:35541
  52043. msgid "The figure above shows the very beginning of the dependency graph of the distribution, corresponding to the package definitions of the @code{(gnu packages bootstrap)} module. A similar figure can be generated with @command{guix graph} (@pxref{Invoking guix graph}), along the lines of:"
  52044. msgstr ""
  52045. #. type: example
  52046. #: guix-git/doc/guix.texi:35546
  52047. #, no-wrap
  52048. msgid ""
  52049. "guix graph -t derivation \\\n"
  52050. " -e '(@@@@ (gnu packages bootstrap) %bootstrap-gcc)' \\\n"
  52051. " | dot -Tps > gcc.ps\n"
  52052. msgstr ""
  52053. #. type: Plain text
  52054. #: guix-git/doc/guix.texi:35549
  52055. msgid "or, for the further Reduced Binary Seed bootstrap"
  52056. msgstr ""
  52057. #. type: example
  52058. #: guix-git/doc/guix.texi:35554
  52059. #, no-wrap
  52060. msgid ""
  52061. "guix graph -t derivation \\\n"
  52062. " -e '(@@@@ (gnu packages bootstrap) %bootstrap-mes)' \\\n"
  52063. " | dot -Tps > mes.ps\n"
  52064. msgstr ""
  52065. #. type: Plain text
  52066. #: guix-git/doc/guix.texi:35563
  52067. msgid "At this level of detail, things are slightly complex. First, Guile itself consists of an ELF executable, along with many source and compiled Scheme files that are dynamically loaded when it runs. This gets stored in the @file{guile-2.0.7.tar.xz} tarball shown in this graph. This tarball is part of Guix's ``source'' distribution, and gets inserted into the store with @code{add-to-store} (@pxref{The Store})."
  52068. msgstr ""
  52069. #. type: Plain text
  52070. #: guix-git/doc/guix.texi:35572
  52071. msgid "But how do we write a derivation that unpacks this tarball and adds it to the store? To solve this problem, the @code{guile-bootstrap-2.0.drv} derivation---the first one that gets built---uses @code{bash} as its builder, which runs @code{build-bootstrap-guile.sh}, which in turn calls @code{tar} to unpack the tarball. Thus, @file{bash}, @file{tar}, @file{xz}, and @file{mkdir} are statically-linked binaries, also part of the Guix source distribution, whose sole purpose is to allow the Guile tarball to be unpacked."
  52072. msgstr ""
  52073. #. type: Plain text
  52074. #: guix-git/doc/guix.texi:35584
  52075. msgid "Once @code{guile-bootstrap-2.0.drv} is built, we have a functioning Guile that can be used to run subsequent build programs. Its first task is to download tarballs containing the other pre-built binaries---this is what the @file{.tar.xz.drv} derivations do. Guix modules such as @code{ftp-client.scm} are used for this purpose. The @code{module-import.drv} derivations import those modules in a directory in the store, using the original layout. The @code{module-import-compiled.drv} derivations compile those modules, and write them in an output directory with the right layout. This corresponds to the @code{#:modules} argument of @code{build-expression->derivation} (@pxref{Derivations})."
  52076. msgstr ""
  52077. #. type: Plain text
  52078. #: guix-git/doc/guix.texi:35589
  52079. msgid "Finally, the various tarballs are unpacked by the derivations @code{gcc-bootstrap-0.drv}, @code{glibc-bootstrap-0.drv}, or @code{bootstrap-mes-0.drv} and @code{bootstrap-mescc-tools-0.drv}, at which point we have a working C tool chain."
  52080. msgstr ""
  52081. #. type: unnumberedsec
  52082. #: guix-git/doc/guix.texi:35590
  52083. #, no-wrap
  52084. msgid "Building the Build Tools"
  52085. msgstr ""
  52086. #. type: Plain text
  52087. #: guix-git/doc/guix.texi:35599
  52088. msgid "Bootstrapping is complete when we have a full tool chain that does not depend on the pre-built bootstrap tools discussed above. This no-dependency requirement is verified by checking whether the files of the final tool chain contain references to the @file{/gnu/store} directories of the bootstrap inputs. The process that leads to this ``final'' tool chain is described by the package definitions found in the @code{(gnu packages commencement)} module."
  52089. msgstr ""
  52090. #. type: Plain text
  52091. #: guix-git/doc/guix.texi:35606
  52092. msgid "The @command{guix graph} command allows us to ``zoom out'' compared to the graph above, by looking at the level of package objects instead of individual derivations---remember that a package may translate to several derivations, typically one derivation to download its source, one to build the Guile modules it needs, and one to actually build the package from source. The command:"
  52093. msgstr ""
  52094. #. type: example
  52095. #: guix-git/doc/guix.texi:35611
  52096. #, no-wrap
  52097. msgid ""
  52098. "guix graph -t bag \\\n"
  52099. " -e '(@@@@ (gnu packages commencement)\n"
  52100. " glibc-final-with-bootstrap-bash)' | xdot -\n"
  52101. msgstr ""
  52102. #. type: Plain text
  52103. #: guix-git/doc/guix.texi:35618
  52104. msgid "displays the dependency graph leading to the ``final'' C library@footnote{You may notice the @code{glibc-intermediate} label, suggesting that it is not @emph{quite} final, but as a good approximation, we will consider it final.}, depicted below."
  52105. msgstr ""
  52106. #. type: Plain text
  52107. #: guix-git/doc/guix.texi:35620
  52108. msgid "@image{images/bootstrap-packages,6in,,Dependency graph of the early packages}"
  52109. msgstr ""
  52110. #. type: Plain text
  52111. #: guix-git/doc/guix.texi:35626
  52112. msgid "The first tool that gets built with the bootstrap binaries is GNU@tie{}Make---noted @code{make-boot0} above---which is a prerequisite for all the following packages. From there Findutils and Diffutils get built."
  52113. msgstr ""
  52114. #. type: Plain text
  52115. #: guix-git/doc/guix.texi:35631
  52116. msgid "Then come the first-stage Binutils and GCC, built as pseudo cross tools---i.e., with @option{--target} equal to @option{--host}. They are used to build libc. Thanks to this cross-build trick, this libc is guaranteed not to hold any reference to the initial tool chain."
  52117. msgstr ""
  52118. #. type: Plain text
  52119. #: guix-git/doc/guix.texi:35637
  52120. msgid "From there the final Binutils and GCC (not shown above) are built. GCC uses @command{ld} from the final Binutils, and links programs against the just-built libc. This tool chain is used to build the other packages used by Guix and by the GNU Build System: Guile, Bash, Coreutils, etc."
  52121. msgstr ""
  52122. #. type: Plain text
  52123. #: guix-git/doc/guix.texi:35643
  52124. msgid "And voilà! At this point we have the complete set of build tools that the GNU Build System expects. These are in the @code{%final-inputs} variable of the @code{(gnu packages commencement)} module, and are implicitly used by any package that uses @code{gnu-build-system} (@pxref{Build Systems, @code{gnu-build-system}})."
  52125. msgstr ""
  52126. #. type: unnumberedsec
  52127. #: guix-git/doc/guix.texi:35645
  52128. #, no-wrap
  52129. msgid "Building the Bootstrap Binaries"
  52130. msgstr ""
  52131. #. type: Plain text
  52132. #: guix-git/doc/guix.texi:35652
  52133. msgid "Because the final tool chain does not depend on the bootstrap binaries, those rarely need to be updated. Nevertheless, it is useful to have an automated way to produce them, should an update occur, and this is what the @code{(gnu packages make-bootstrap)} module provides."
  52134. msgstr ""
  52135. #. type: Plain text
  52136. #: guix-git/doc/guix.texi:35658
  52137. msgid "The following command builds the tarballs containing the bootstrap binaries (Binutils, GCC, glibc, for the traditional bootstrap and linux-libre-headers, bootstrap-mescc-tools, bootstrap-mes for the Reduced Binary Seed bootstrap, and Guile, and a tarball containing a mixture of Coreutils and other basic command-line tools):"
  52138. msgstr ""
  52139. #. type: example
  52140. #: guix-git/doc/guix.texi:35661
  52141. #, no-wrap
  52142. msgid "guix build bootstrap-tarballs\n"
  52143. msgstr ""
  52144. #. type: Plain text
  52145. #: guix-git/doc/guix.texi:35666
  52146. msgid "The generated tarballs are those that should be referred to in the @code{(gnu packages bootstrap)} module mentioned at the beginning of this section."
  52147. msgstr ""
  52148. #. type: Plain text
  52149. #: guix-git/doc/guix.texi:35672
  52150. msgid "Still here? Then perhaps by now you've started to wonder: when do we reach a fixed point? That is an interesting question! The answer is unknown, but if you would like to investigate further (and have significant computational and storage resources to do so), then let us know."
  52151. msgstr ""
  52152. #. type: unnumberedsec
  52153. #: guix-git/doc/guix.texi:35673
  52154. #, no-wrap
  52155. msgid "Reducing the Set of Bootstrap Binaries"
  52156. msgstr ""
  52157. #. type: Plain text
  52158. #: guix-git/doc/guix.texi:35681
  52159. msgid "Our traditional bootstrap includes GCC, GNU Libc, Guile, etc. That's a lot of binary code! Why is that a problem? It's a problem because these big chunks of binary code are practically non-auditable, which makes it hard to establish what source code produced them. Every unauditable binary also leaves us vulnerable to compiler backdoors as described by Ken Thompson in the 1984 paper @emph{Reflections on Trusting Trust}."
  52160. msgstr ""
  52161. #. type: Plain text
  52162. #: guix-git/doc/guix.texi:35687
  52163. msgid "This is mitigated by the fact that our bootstrap binaries were generated from an earlier Guix revision. Nevertheless it lacks the level of transparency that we get in the rest of the package dependency graph, where Guix always gives us a source-to-binary mapping. Thus, our goal is to reduce the set of bootstrap binaries to the bare minimum."
  52164. msgstr ""
  52165. #. type: Plain text
  52166. #: guix-git/doc/guix.texi:35693
  52167. msgid "The @uref{https://bootstrappable.org, Bootstrappable.org web site} lists on-going projects to do that. One of these is about replacing the bootstrap GCC with a sequence of assemblers, interpreters, and compilers of increasing complexity, which could be built from source starting from a simple and auditable assembler."
  52168. msgstr ""
  52169. #. type: Plain text
  52170. #: guix-git/doc/guix.texi:35702
  52171. msgid "Our first major achievement is the replacement of of GCC, the GNU C Library and Binutils by MesCC-Tools (a simple hex linker and macro assembler) and Mes (@pxref{Top, GNU Mes Reference Manual,, mes, GNU Mes}, a Scheme interpreter and C compiler in Scheme). Neither MesCC-Tools nor Mes can be fully bootstrapped yet and thus we inject them as binary seeds. We call this the Reduced Binary Seed bootstrap, as it has halved the size of our bootstrap binaries! Also, it has eliminated the C compiler binary; i686-linux and x86_64-linux Guix packages are now bootstrapped without any binary C compiler."
  52172. msgstr ""
  52173. #. type: Plain text
  52174. #: guix-git/doc/guix.texi:35705
  52175. msgid "Work is ongoing to make MesCC-Tools and Mes fully bootstrappable and we are also looking at any other bootstrap binaries. Your help is welcome!"
  52176. msgstr ""
  52177. #. type: chapter
  52178. #: guix-git/doc/guix.texi:35707
  52179. #, no-wrap
  52180. msgid "Porting to a New Platform"
  52181. msgstr ""
  52182. #. type: Plain text
  52183. #: guix-git/doc/guix.texi:35716
  52184. msgid "As discussed above, the GNU distribution is self-contained, and self-containment is achieved by relying on pre-built ``bootstrap binaries'' (@pxref{Bootstrapping}). These binaries are specific to an operating system kernel, CPU architecture, and application binary interface (ABI). Thus, to port the distribution to a platform that is not yet supported, one must build those bootstrap binaries, and update the @code{(gnu packages bootstrap)} module to use them on that platform."
  52185. msgstr ""
  52186. #. type: Plain text
  52187. #: guix-git/doc/guix.texi:35721
  52188. msgid "Fortunately, Guix can @emph{cross compile} those bootstrap binaries. When everything goes well, and assuming the GNU tool chain supports the target platform, this can be as simple as running a command like this one:"
  52189. msgstr ""
  52190. #. type: example
  52191. #: guix-git/doc/guix.texi:35724
  52192. #, no-wrap
  52193. msgid "guix build --target=armv5tel-linux-gnueabi bootstrap-tarballs\n"
  52194. msgstr ""
  52195. #. type: Plain text
  52196. #: guix-git/doc/guix.texi:35731
  52197. msgid "For this to work, the @code{glibc-dynamic-linker} procedure in @code{(gnu packages bootstrap)} must be augmented to return the right file name for libc's dynamic linker on that platform; likewise, @code{system->linux-architecture} in @code{(gnu packages linux)} must be taught about the new platform."
  52198. msgstr ""
  52199. #. type: Plain text
  52200. #: guix-git/doc/guix.texi:35740
  52201. msgid "Once these are built, the @code{(gnu packages bootstrap)} module needs to be updated to refer to these binaries on the target platform. That is, the hashes and URLs of the bootstrap tarballs for the new platform must be added alongside those of the currently supported platforms. The bootstrap Guile tarball is treated specially: it is expected to be available locally, and @file{gnu/local.mk} has rules to download it for the supported architectures; a rule for the new platform must be added as well."
  52202. msgstr ""
  52203. #. type: Plain text
  52204. #: guix-git/doc/guix.texi:35749
  52205. msgid "In practice, there may be some complications. First, it may be that the extended GNU triplet that specifies an ABI (like the @code{eabi} suffix above) is not recognized by all the GNU tools. Typically, glibc recognizes some of these, whereas GCC uses an extra @option{--with-abi} configure flag (see @code{gcc.scm} for examples of how to handle this). Second, some of the required packages could fail to build for that platform. Lastly, the generated binaries could be broken for some reason."
  52206. msgstr ""
  52207. #. type: include
  52208. #: guix-git/doc/guix.texi:35751
  52209. #, no-wrap
  52210. msgid "contributing.texi"
  52211. msgstr "contributing.it.texi"
  52212. #. type: Plain text
  52213. #: guix-git/doc/guix.texi:35764
  52214. msgid "Guix is based on the @uref{https://nixos.org/nix/, Nix package manager}, which was designed and implemented by Eelco Dolstra, with contributions from other people (see the @file{nix/AUTHORS} file in Guix). Nix pioneered functional package management, and promoted unprecedented features, such as transactional package upgrades and rollbacks, per-user profiles, and referentially transparent build processes. Without this work, Guix would not exist."
  52215. msgstr ""
  52216. #. type: Plain text
  52217. #: guix-git/doc/guix.texi:35767
  52218. msgid "The Nix-based software distributions, Nixpkgs and NixOS, have also been an inspiration for Guix."
  52219. msgstr ""
  52220. #. type: Plain text
  52221. #: guix-git/doc/guix.texi:35773
  52222. msgid "GNU@tie{}Guix itself is a collective work with contributions from a number of people. See the @file{AUTHORS} file in Guix for more information on these fine people. The @file{THANKS} file lists people who have helped by reporting bugs, taking care of the infrastructure, providing artwork and themes, making suggestions, and more---thank you!"
  52223. msgstr ""
  52224. #. type: cindex
  52225. #: guix-git/doc/guix.texi:35778
  52226. #, no-wrap
  52227. msgid "license, GNU Free Documentation License"
  52228. msgstr ""
  52229. #. type: include
  52230. #: guix-git/doc/guix.texi:35779
  52231. #, no-wrap
  52232. msgid "fdl-1.3.texi"
  52233. msgstr ""
  52234. #, fuzzy
  52235. #~| msgid "Channels"
  52236. #~ msgid "channel-name"
  52237. #~ msgstr "Canali"