NAAM

execve - voer programma uit

BIBLIOTHEEK

Standard C bibliotheek (libc, -lc)

SAMENVATTING

#include <unistd.h>

int execve(const char *padnaam, char *const argv[],
           char *const _NULL_baarenvp[]);

BESCHRIJVING

execve() voert het programma uit waar padnaam naar wijst. Dit zorgt er voor dat het programma dan momenteel wordt uitgevoerd door het aanroepende proces wordt vervangen door een nieuw programma, met een niet-geïnitialiseerde stack, heap en (geïnitialiseerde en niet-geïnitialiseerde) data segmenten.

padnaam moet ofwel een binair uitvoerbaar bestand zijn, ofwel een script dat begint met een regel van de vorm:

#!interpreter[optioneel-arg]

Voor details over het laatste geval, zie "Interpreter scripts" hieronder.

argv is een lijst van wijzers naar tekenreeksen die worden doorgegeven naar een nieuw programma als zijn commando-regel argumenten. Per conventie zou de eerste van deze tekenreeksen (m.a.w. argv[0]) de bestandsnaam moeten zijn van het bestand dat uitgevoerd wordt. De argv lijst moet worden afgesloten met een NULL wijzer. (Daarom, zal in het nieuwe programma, argv[argc] NULL zijn.)

envp is een lijst van wijzers naar tekenreeksen, bij conventie van de vorm key=value, die worden doorgegeven als omgeving van een nieuw programma. De envp lijst moet worden afgesloten met een NULL wijzer.

Deze handleiding beschrijft de Linux systeem aanroep in detail; voor een overzicht van de nomenclatuur en de vele, vaak te prefereren, gestandaardiseerde varianten van de functie voorzien in libc, inclusief die de PATH omgevingsvariabele doorzoeken, zie exec(3).

De argumenten vector en omgeving kunnen worden benaderd door de main-functie van het nieuwe programma, mits deze is gedefinieerd als:

int main(int argc, char *argv[], char *envp[])

Let evenwel op dat het gebruik van het derde argument van de main-functie niet gespecificeerd is in POSIX.1; volgens POSIX.1, zou de omgeving moeten worden benaderd via de externe variabele environ(7).

Bij succes keert execve() niet terug, en de text, geïnitialiseerde data, niet-geinitialiseerde data (bss) en stack van het aanroepende proces worden overschreven volgens de inhoud van het nieuw geladen programma.

Als het huidige programma momenteel wordt ge-ptrace´ed, dan wordt er een SIGTRAP signaal naar verstuurd na een succesvolle execve() aanroep .

Als het set-user-ID bit is gezet op het programma bestand aangewezen door padnaam, dan wordt het effectieve gebruiker ID van het aanroepende proces veranderd naar dat van de eigenaar van het programma bestand. Vergelijkbaar, is het set-group-ID bit is gezet op het programma bestand, dan wordt het effectieve group ID van het aanroepende proces gezet op de groep van het programma bestand.

De hiervoor genoemde transformaties van de effectieve ID worden niet uitgevoerd (m.a.w. de set-user-ID en set-group-ID bits worden genegeerd) als een van de volgende waar is:

•

het no_new_privs attribuut wordt gezet voor de aanroepende thread (zie prctl(2));

•

het onderliggende bestandssysteem is gekoppeld nosuid (de MS_NOSUID vlag voor mount(2)); of

•

het aanroepende proces wordt ge-ptrace´d.

De capaciteiten van het programma bestand (zie capabilities(7) worden ook genegeerd als enig van de bovenstaande waar is.

Het effectieve gebruiker ID van het proces wordt gekopieerd naar het bewaarde set-user-ID; vergelijkbaar, het effectieve groep ID wordt gekopieerd naar het bewaarde set-group-ID. Het kopiëren vindt plaats na effectieve ID veranderingen die optreden vanwege de set-user-ID en set-group-ID modus bits.

De echte UID en echte GID van het proces, zowel als zijn supplementaire groep ID´s blijven onveranderd door de aanroep van execve().

Als het uitvoerbaar bestand een a.out dynamisch gelinked binair uitvoerbaar bestand is dat ook shared-library stompjes bevat, dan wordt de Linux dynamische linker ld.so(8) aangeroepen na de aanvang van uitvoering, om zo de benodigde gedeelde objecten in het geheugen te laden en het uitvoerbaar bestand hiermee te linken.

Als de executable een dynamisch gelinkte ELF executable is, dan wordt de interpreter genoemd in het PT_INTERP segment gebruikt om de benodigde gedeelde objecten te laden. Deze interpreter is typisch /lib/ld-linux.so.2 voor binaire bestanden gelinked met glibc (zie ld-linux.so(8)).

#!interpreter[optioneel-arg]

interpreter  [optional-arg] padnaam arg...

EIND WAARDE

Bij succes keert execve() niet terug, bij falen wordt -1 teruggegeven, en wordt errno overeenkomstig gezet.

FOUTEN

E2BIG

Het totaal aantal bytes in de omgeving (envp en de lijst van argumenten (argv) is te groot, een argument of omgeving tekenreeks is te lang, of de volledige padnaam van het uitvoerbaar bestand is te lang. Het afsluitende null-byte wordt mee geteld als een onderdeel van de lengte van de tekenreeks.

EACCES

Zoek recht wordt geweigerd op een component van het pad voorvoegsel van padnaam of de naam van een script interpreter. Zie ook path_resolution(7).)

EACCES

Het bestand of de script interpreter is geen normaal bestand.

EACCES

Uitvoer toestemming werd geweigerd voor het bestand of een script of ELF interpreter.

EACCES

Het bestandsysteem is gemount met noexec.

EAGAIN (sinds Linux 3.1)

Ondanks dat de echte UID van de aanroeper is verandert door een van de set*uid() aanroepen, was en — is nog steeds— de aanroeper nog steeds boven zijn RLIMIT_NPROC resource limiet (zie setrlimit(2)). Voor een gedetailleerde verklaring van deze fout, zie OPMERKINGEN.

EFAULT

padnaam of een van de wijzers in de vectoren argv of envp wijst buiten door de, voor u, toegankelijke adres ruimte.

EINVAL

Een ELF uitvoerbaar bestand heeft meer dan 1 PT_INTERP segment (probeerde meer dan 1 interpreter te benoemen).

EIO

Een Invoer/Uitvoer fout trad op.

EISDIR

Een ELF interpreter was een map.

ELIBBAD

Een ELF interpreter had een onbekende vorm.

ELOOP

Teveel symbolische koppelingen werden tegengekomen bij het "oplossen" van padnaam of de naam van een script of ELF interpreter.

ELOOP

De maximale recursie limiet werd bereikt door uitvoeren van de recursieve script interpreter (zie "Interpreter scripts", hierboven) Voor Linux 3.8 werd de fout ENOEXEC geproduceerd voor dit geval.

EMFILE

De per-proces limiet van het aantal open bestandsbeschrijvingen werd bereikt.

ENAMETOOLONG

padnaam is te lang.

ENFILE

De grens aan het aantal open bestanden van het systeem is bereikt.

ENOENT

Het bestand padnaam of een script of een ELF interpreter bestaat niet.

ENOEXEC

Een uitvoerbaar bestand is niet in een bekende vorm: het is voor de verkeerde architectuur, of heeft een of andere vormfout waardoor het niet kan worden uitgevoerd.

ENOMEM

Onvoldoende kernelgeheugen voorhanden.

ENOTDIR

Een deel van het pad-voorvoegsel van padnaam of van een script of ELF interpreter is geen map.

EPERM

Het bestandssysteem was gekoppeld met nosuid, de gebruiker is niet de supergebruiker, en het bestand heeft het set-user-ID of set-group-ID bit aan staan.

EPERM

Het proces wordt gevolgd, de gebruiker is niet de supergebruiker en het bestand heeft een set-user-ID of set-group-ID bit aan staan.

EPERM

Een "domme-capaciteiten" toepassing zou niet de volledige verzameling van toegestane capaciteiten die door het uitvoerbaar bestand zijn toegekend kunnen verkrijgen. Zie capaciteiten(7).

ETXTBSY

Uitvoerbaar bestand is open voor schrijven bij een of meer processen.

VERSIES

POSIX documenteert het #! gedrag niet, maar het bestaat (met enige variaties) op andere UNIX systems.

Op Linux kunnen argv en envp worden opgegeven als NULL. In beide gevallen heeft dat hetzelfde effect als het opgeven van het argument als een wijzer naar een lijst die een enkele NULL wijzer bevat. Maak geen gebruik van dit niet-standaard en neit-overdraagbaar gedrag. Op veel andere Linux systemen zal het opgeven van argv als NULL resulteren in een fout (EFAULT). Sommige andere Linux systemen behandelen het envp==NULL geval hetzelfde als Linux.

POSIX.1 zegt dat waarden zoals teruggeven worden door sysconf(3) niet mogen veranderen gedurende de levensduur van een proces. Hoewel vanaf Linux 2.6.23 de door _SC_ARG_MAX gerapporteerde waarde zal veranderen zodra de RLIMIT_STACK resource limiet veranderd. Dit om het feit aan te geve dan de limiet op de ruimte die de argumenten en de omgevingsvariabelen op commando regel in beslag nemen werd veranderd.

VOLDOET AAN

POSIX.1-2008.

GESCHIEDENIS

POSIX.1-2001, SVr4, 4.3BSD.

Met UNIX V6, eindigde de argumenten lijst van een exec() aanroep op 0, terwijl de argumenten lijst van main eindigde op -1. Daarom was deze argumenten lijst niet meteen bruikbaar in een volgende exec() aanroep. Vanaf UNIX V7, zijn beiden NULL.

OPMERKINGEN

Soms ziet men execve() (en de gerelateerde functies beschreven in in exec(3)) beschreven als "uitvoeren van een nieuw proces" (of vergelijkbaar). Dit is een hoogst misleidende beschrijving: er is geen nieuw proces; veel attributen van het aanroepende proces blijven onveranderd (in het bijzonder, zijn PID). Het enige dat execve() doet is het regelen dat een bestand proces (het aanroepende proces) een nieuw program kan uitvoeren.

Set-user-ID en set-group-ID processen kunnen niet ptrace(2)d zijn.

Het resultaat van het aankoppelen van een bestandssysteem nosuid varieert van Linux kernel versies: sommigen weigeren het uitvoeren van set-user-ID en set-group-ID uitvoerbare bestanden als dat zou betekenen dat de gebruiker rechten zou krijgen die hij eerder niet had (en EPERM retourneren), sommige zullen de set-user-ID en set-group-ID bits negeren en exec() succesvol uitvoeren,

In de meeste gevallen waar execve() faalt, wordt controle naar de originele uitvoerbare afbeelding teruggegeven, en kan de aanroeper van execve() de foutmelding afhandelen. Hoewel, in (zeldzame) gevallen (typisch veroorzaakt door uitputting van hulpbronnen) kan een fout optreden voorbij het punt waarbij terugkeer niet mogelijk is: de oorspronkelijk uitvoerbare afbeelding is al afgebroken, maar de nieuwe nog niet compleet gebouwd. In deze gevallen, stopt de kernel het proces met een SIGSEGV (SIGKILL tot Linux 3.17) signaal.

VOORBEELDEN

Het volgende programma is ontworpen om te worden uitgevoerd door het tweede programma daaronder. Het echo´d de commando-regel argumenten, een per regel.

/* myecho.c */
#include <stdio.h>
#include <stdlib.h>
int
main(int argc, char *argv[])
{
    for (size_t j = 0; j < argc; j++)
        printf("argv[%zu]: %s\n", j, argv[j]);
    exit(EXIT_SUCCESS);
}

Dit programma kan worden gebruikt om het op de commando regel genoemde programma uit te voeren:

/* execve.c */
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int
main(int argc, char *argv[])
{
    static char *newargv[] = { NULL, "hello", "world", NULL };
    static char *newenviron[] = { NULL };
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <file-to-exec>\n", argv[0]);
        exit(EXIT_FAILURE);
    }
    newargv[0] = argv[1];
    execve(argv[1], newargv, newenviron);
    perror("execve");   /* execve() stopt alleen bij een fout */
    exit(EXIT_FAILURE);
}

We kunnen het tweede programma om het eerste, als volgt, uit te voeren

$ cc myecho.c -o myecho
$ cc execve.c -o execve
$ ./execve ./myecho
argv[0]: ./myecho
argv[1]: hello
argv[2]: world

We kunnen deze programma´s ook gebruiken om het gebruik van ee script interpreter te demonstreren. Om dit te doen creëren wij een script wiens "interpreter' on myecho programma is:

$ cat > script
#!./myecho script-arg
^D
$ chmod +x script

We kunnen nu ons programma gebruiken om het script uit te voeren:

$ ./execve ./script
argv[0]: ./myecho
argv[1]: script-arg
argv[2]: ./script
argv[3]: hello
argv[4]: world

ZIE OOK

chmod(2), execveat(2), fork(2), get_robust_list(2), ptrace(2), exec(3), fexecve(3), getauxval(3), getopt(3), system(3), capabilities(7), credentials(7), environ(7), path_resolution(7), ld.so(8)

VERTALING

De Nederlandse vertaling van deze handleiding is geschreven door Jos Boersema <joshb@xs4all.nl>, Mario Blättermann <mario.blaettermann@gmail.com> en Luc Castermans <luc.castermans@gmail.com>

Deze vertaling is vrije documentatie; lees de GNU General Public License Version 3 of later over de Copyright-voorwaarden. Er is geen AANSPRAKELIJKHEID.

Indien U fouten in de vertaling van deze handleiding zou vinden, stuur een e-mail naar debian-l10n-dutch@lists.debian.org.