NUME¶

sistem - execută o comandă shell

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

SINOPSIS¶

#include <stdlib.h>

int system(const char *comandă);

DESCRIERE¶

Funcția de bibliotecă system() se comportă ca și cum ar fi utilizat fork(2) pentru a crea un proces-copil care să execute comanda shell specificată în comandă utilizând execl(3) după cum urmează:

execl("/bin/sh", "sh", "-c", comandă, (char *) NULL);

system() returnează după ce comanda a fost finalizată.

În timpul executării comenzii, SIGCHLD va fi blocat, iar SIGINT și SIGQUIT vor fi ignorate, în procesul care apelează system(); (aceste semnale vor fi tratate în conformitate cu valorile lor implicite în interiorul procesului-copil care execută comanda).

Dacă comandă este NULL, atunci system() returnează o stare care indică dacă un shell este disponibil pe sistem.

VALOAREA RETURNATö

Valoarea returnată de system() este una dintre următoarele:

•

Dacă comandă este NULL, atunci o valoare diferită de zero dacă este disponibil un shell, sau 0 dacă nu este disponibil niciun shell.

•

Dacă un proces-copil nu a putut fi creat sau starea acestuia nu a putut fi recuperată, valoarea de returnare este -1 și errno este configurată pentru a indica eroarea.

•

În cazul în care un shell nu a putut fi executat în procesul-copil, atunci valoarea de returnare este ca și cum shell-ul copil s-ar fi încheiat prin apelarea _exit(2) cu starea 127.

•

Dacă toate apelurile sistemului reușesc, atunci valoarea de returnare este starea de terminare a shell-ului copil utilizat pentru a executa comandă; (starea de terminare a unui shell este starea de terminare a ultimei comenzi pe care o execută).

În ultimele două cazuri, valoarea de returnare este o „stare de așteptare” care poate fi examinată utilizând macrocomenzile descrise în waitpid(2); (și anume, WIFEXITED(), WEXITSTATUS() și așa mai departe).

system() nu afectează starea de așteptare a niciunui alt copil.

ERORI-IEȘIRE¶

system() poate eșua cu oricare dintre aceleași erori ca fork(2).

ATRIBUTE¶

Pentru o explicație a termenilor folosiți în această secțiune, a se vedea attributes(7).

STANDARDE¶

POSIX.1-2001, POSIX.1-2008, C99.

NOTE¶

system() oferă simplitate și confort: se ocupă de toate detaliile apelurilor fork(2), execl(3) și waitpid(2), precum și de manipulările necesare ale semnalelor; în plus, shell-ul efectuează substituțiile obișnuite și redirecționările de In/Ieș pentru comandă. Principalul cost al system() este ineficiența: sunt necesare apeluri de sistem suplimentare pentru a crea procesul care rulează shell-ul și pentru a executa shell-ul.

Dacă macrocomanda de testare a caracteristicii _XOPEN_SOURCE este definită (înainte de includerea fișierelor de antet any), atunci macrocomenzile descrise în waitpid(2) (WEXITSTATUS(), etc.) sunt disponibile atunci când se include <stdlib.h>.

După cum s-a menționat, system() ignoră SIGINT și SIGQUIT. Acest lucru poate face ca programele care îl apelează dintr-o buclă să nu poată fi întrerupte, cu excepția cazului în care au ele însele grijă să verifice starea de ieșire a copilului. De exemplu:

while (ceva-orice) {


    int ret = system("foo");


    if (WIFSIGNALED(ret) &&


        (WTERMSIG(ret) == SIGINT || WTERMSIG(ret) == SIGQUIT))


            break;
}

În conformitate cu POSIX.1, nu este specificat dacă gestionarii înregistrați folosind pthread_atfork(3) sunt apelați în timpul executării system(). În implementarea glibc, astfel de gestionari nu sunt apelați.

Înainte de glibc 2.1.3, verificarea disponibilității /bin/sh nu era efectuată dacă comandă era NULL; în schimb, se presupunea întotdeauna că este disponibil, iar system() returna întotdeauna 1 în acest caz. Începând cu glibc 2.1.3, această verificare este efectuată deoarece, chiar dacă POSIX.1-2001 cere ca o implementare conformă să furnizeze un shell, acel shell poate să nu fie disponibil sau executabil dacă programul apelant a apelat anterior chroot(2) (care nu este specificat de POSIX.1-2001).

Este posibil ca comanda shell să se încheie cu o stare de 127, ceea ce produce o valoare de returnare system() care nu poate fi distinsă de cazul în care un shell nu a putut fi executat în procesul-copil.

ERORI¶

Dacă numele comenzii începe cu o cratimă, sh(1) interpretează numele comenzii ca o opțiune, iar comportamentul este nedefinit; (consultați opțiunea -c pentru sh(1)). Pentru a rezolva această problemă, precedați comanda cu un spațiu, ca în următorul apel:

    system(" -unfortunate-command-name");

CONSULTAȚI ȘI¶

sh(1), execve(2), fork(2), sigaction(2), sigprocmask(2), wait(2), exec(3), signal(7)

TRADUCERE¶

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.