make - GNU pripomore k ohranjanju skupin programov
Povzetek
naredi [ -f makefile ] [opcija] ... cilj ...
Opozorilo
Ta stran je izvleček dokumentacije o izdelavi GNU. Posodobi se le občasno, ker projekt GNU ne uporablja nroff. Za popolno in aktualno dokumentacijo glejte Informacijsko datoteko make.info, ki je izdelana iz izvorne datoteke Texinfo make.texinfo .
Opis
Namen pripomočka za izdelavo je samodejno ugotoviti, kateri deli velikega programa je treba prevedeti in izdati ukaze za njihovo prevedbo. Priročnik opisuje izvajanje znamke GNU, ki so ga napisali Richard Stallman in Roland McGrath. Naši primeri kažejo programe C, saj so najpogostejši, lahko pa jih uporabite s katerimkoli programskim jezikom, katerega prevajalnik lahko zaženete z ukazom lupine. Pravzaprav, izdelava ni omejena na programe. Uporabite ga lahko za opisovanje vseh nalog, pri katerih je treba nekatere datoteke samodejno posodabljati od drugih, kadar se drugi spremenijo.
Če se želite pripraviti za uporabo, morate napisati datoteko, imenovano makefile, ki opisuje razmerja med datotekami v vašem programu in navaja ukaze za posodabljanje posamezne datoteke. V programu običajno izvedljivo datoteko posodabljamo iz objektnih datotek, ki jih nato naredimo z zbiranjem izvornih datotek.
Ko ustrezen makefile obstaja, vsakič, ko spremenite nekaj izvornih datotek, ta preprost ukaz lupine:
naredi
zadostuje za izvedbo vseh potrebnih prekomernih kompilacij. Program za izdelavo uporablja zbirko podatkov makefile in čas zadnje spremembe datotek, da se odloči, katere datoteke je treba posodobiti. Za vsako od teh datotek izda ukaze, zabeležene v bazi podatkov.
narediti ukaze v makefileu, če želite posodobiti eno ali več ciljnih imen , kjer je ime navadno program. Če ni prisotna nobena možnost -f , bodo v tem vrstnem redu iskali makefile GNUmakefile , makefile in Makefile .
Običajno morate poklicati makefile bodisi makefile ali Makefile . (Priporočamo Makefile, ker se pojavlja vidno v bližini začetnega seznama imenikov, neposredno v bližini drugih pomembnih datotek, kot je README .) Ime, preverjeno, GNUmakefile , ni priporočljivo za večino makefilov. To ime morate uporabiti, če imate makefile, ki je značilen za izdelavo GNU-ja in ga ne bodo razumeli druge različice izdelave . Če je makefile `- ', se bere standardni vnos.
posodabljanje cilja, če je odvisno od predpogojnih datotek, ki so bile spremenjene od zadnje spremembe cilja ali če tarča ne obstaja.
OPCIJE
-b
-m
Te možnosti se ne upoštevajo za združljivost z drugimi različicami izdelave .
-C re
Spremenite se v mapo imenika, preden preberete makefile ali delate karkoli drugega. Če so določene več -C možnosti, se vsaka razlaga glede na prejšnjo: -C / C itd je enakovreden -C / etc. To se navadno uporablja pri rekurzivnih pozivih na znamko .
-d
Informacije o odpravi napak poleg običajne obdelave. Podatki o odpravi napak kažejo, katere datoteke se preučujejo za predelavo, katere datoteke se primerjajo in s kakšnimi rezultati, katere datoteke je treba dejansko popraviti, katere implicitne predpise se upoštevajo in ki se uporabljajo --- vse zanimive, kako se odloči kaj storiti.
-e
Dati spremenljivke, vzete iz prednosti okolja, nad spremenljivkami iz makefilov.
-f datoteke
Uporabi datoteko kot makefile.
-jaz
Prezrite vse napake v ukazih, izvedenih za preoblikovanje datotek.
-Reč
Podaja usmerjevalni imenik za iskanje vključenih makefilov. Če za določitev več imenikov uporabite več -I možnosti, se imeniki iščejo v določenem vrstnem redu. Za razliko od argumentov za druge zastavice znamke, lahko imeniki, ki so podani z -I zastavami, pridejo neposredno po zastavi: -I je dovoljen dir , kot tudi -I dir. Ta sintaksa je dovoljena za združljivost z zastavico preprodajalca C -I .
-j delovnih mest
Določa število opravil (ukazov), ki jih je treba zagnati hkrati. Če obstaja več možnosti -j , je zadnja učinkovita. Če je opcija -j podana brez argumenta, naredi ne bo omejila števila opravil, ki se lahko izvajajo sočasno.
-k
Nadaljujte, kolikor je mogoče, po napaki. Medtem ko cilj, ki ni uspel, in tisti, ki so odvisni od njega, ni mogoče odpraviti, se lahko druge odvisnosti teh ciljev obdelujejo enako.
-l
Naloži
Določa, da ni treba zagnati novih delovnih mest (ukazov), če se izvajajo druga opravila in je obremenitev najmanj obremenjena (številka s plavajočo vejico). Brez argumentov odstrani prejšnjo omejitev obremenitve.
-n
Natisnite ukaze, ki bi bili izvedeni, vendar jih ne izvršite.
- datoteka
Ne predelujte datoteke datoteke, tudi če je starejši od njenih odvisnosti, in ne spreminjajte ničesar zaradi sprememb v datoteki . V bistvu se datoteka obravnava kot zelo stara in njena pravila se ne upoštevajo.
-p
Natisnite bazo podatkov (pravila in spremenljive vrednosti), ki izhajajo iz branja makefilov; nato pa kot običajno ali kot je drugače določeno. To tudi natisne informacije o različici, ki jih je dal -v stikalo (glejte spodaj). Če želite natisniti bazo podatkov, ne da bi poskušali popraviti nobenih datotek, uporabite make -p -f / dev / null.
-q
"Način vprašanj". Ne vodite nobenih ukazov ali natisnite ničesar; samo vrnite status izhoda, ki je nič, če so določeni cilji že posodobljeni, sicer pa ničen.
-r
Odpravite uporabo vgrajenih implicitnih pravil. Tudi očistite privzeti seznam pripone za pravila o končnih končnicah.
-s
Tiho delovanje; ne natisnite ukazov, kot so bili izvedeni.
-S
Prekličite učinek možnosti -k . To ni nikoli potrebno, razen v rekurzivni znamki, kjer bi -k lahko podedovali od najvišje ravni s pomočjo MAKEFLAGS ali če nastavite -k v MAKEFLAGS v vašem okolju.
-t
Datoteke na dotik (jih označite z datumom, ne da bi jih resnično spremenili), namesto da bi zagnali svoje ukaze. To se uporablja za pretvarjanje, da so bili ukazi opravljeni, da bi se lahko zavedli bodočih pozivov na znamko .
-v
Natisnite različico programa za izdelavo in avtorske pravice, seznam avtorjev in obvestilo, da garancije ni.
-w
Natisnite sporočilo, ki vsebuje delovni imenik pred in po drugi obdelavi. To je lahko uporabno za sledenje napak iz zapletenih gnezd za rekurzivne ukaze naredi .
-W datoteko
Pretvarjaj, da je bila ciljna datoteka pravkar spremenjena. Ko se uporablja z zastavico -n , se prikaže, kaj se bo zgodilo, če bi spremenili to datoteko. Brez -n je skoraj enako kot izvajanje ukaza za dotik na zadevni datoteki pred zagonom, le da se čas spremembe spremeni samo v domišljiji make .