XARGS(1)                    General Commands Manual                   XARGS(1)

NUME
       xargs - construie<?>te <?>i executa linii de comanda de la intrarea
       standard

REZUMAT
       xargs [op<?>iuni] [comanda [argumente-ini<?>iale]]

DESCRIERE
       Aceasta pagina de manual documenteaza versiunea GNU a xargs. xargs
       cite<?>te elemente de la intrarea standard, delimitate de spa<?>ii
       libere (care pot fi protejate cu ghilimele duble sau simple sau cu o
       bara oblica inversa) sau de linii noi, <?>i executa comanda (implicit
       echo) de una sau mai multe ori cu orice argumente-ini<?>iale urmate de
       elemente citite de la intrarea standard. Liniile goale de la intrarea
       standard sunt ignorate.

       Linia de comanda pentru comanda este construita pana cand atinge o
       limita definita de sistem (cu excep<?>ia cazului in care se utilizeaza
       op<?>iunile -n <?>i -L). comanda specificata va fi invocata de cate ori
       este necesar pentru a epuiza lista de elemente de intrare. In general,
       vor exista mult mai pu<?>ine invocari ale comenzii decat numarul
       elementelor de intrare. In mod normal, acest lucru va avea beneficii
       semnificative in materie de performan<?>a. Unele comenzi pot fi
       executate in paralel; a se vedea op<?>iunea -P.

       Deoarece numele de fi<?>iere Unix pot con<?>ine spa<?>ii libere <?>i
       linii noi, acest comportament implicit este adesea problematic; numele
       de fi<?>iere care con<?>in spa<?>ii libere <?>i/sau linii noi sunt
       procesate incorect de xargs. In aceste situa<?>ii, este mai bine sa se
       utilizeze op<?>iunea -0, care previne astfel de probleme. Atunci cand
       utiliza<?>i aceasta op<?>iune, va trebui sa va asigura<?>i ca programul
       care produce datele de intrare pentru xargs utilizeaza, de asemenea, un
       caracter nul ca separator. Daca acest program este GNU find, de
       exemplu, op<?>iunea -print0 face acest lucru pentru dumneavoastra.

       Daca orice invocare a comenzii iese cu starea 255, xargs se va opri
       imediat fara a citi alte date de intrare. Un mesaj de eroare este emis
       la ie<?>irea de eroare standard atunci cand se intampla acest lucru.

OP<?>IUNI
       -0, --null
              Elementele de intrare se termina cu un caracter nul in loc de
              spa<?>iu alb, iar ghilimelele <?>i bara inversa nu sunt speciale
              (fiecare caracter este luat literal). Dezactiveaza <?>irul de
              sfar<?>it de fi<?>ier, care este tratat ca orice alt argument.
              Utila atunci cand elementele de intrare pot con<?>ine spa<?>ii
              albe, ghilimele sau bare oblice inverse.  Op<?>iunea GNU <<find
              -print0>> produce date de intrare adecvate pentru acest mod.


       -a fi<?>ier, --arg-file=fi<?>ier
              Cite<?>te elemente din fi<?>ier in loc de la intrarea standard.
              Daca utiliza<?>i aceasta op<?>iune, intrarea standard ramane
              neschimbata atunci cand se executa comenzile. In caz contrar,
              intrarea standard este redirec<?>ionata catre /dev/null.


       --delimiter=delimitator, -d delimitator
              Elementele de intrare se termina cu caracterul specificat.
              Delimitatorul specificat poate fi un singur caracter, un
              caracter de eludare in stil C, cum ar fi \n, sau un cod de
              eludare octal sau hexazecimal. Codurile de eludare octale <?>i
              hexazecimale se in<?>eleg ca <?>i in cazul comenzii printf.
              Caracterele multi-octet nu sunt acceptate. La procesarea datelor
              de intrare, ghilimelele <?>i barele oblice inverse nu sunt
              speciale; fiecare caracter din datele de intrare este luat
              literal. Op<?>iunea -d dezactiveaza orice <?>ir de sfar<?>it de
              fi<?>ier, care este tratat ca orice alt argument. Pute<?>i
              utiliza aceasta op<?>iune atunci cand datele de intrare constau
              doar in elemente separate prin linii noi, de<?>i este aproape
              intotdeauna mai bine sa va proiecta<?>i programul pentru a
              utiliza --null atunci cand acest lucru este posibil.


       -E <?>ir-eof
              Stabile<?>te <?>irul de sfar<?>it de fi<?>ier la <?>ir-eof. In
              cazul in care <?>irul de sfar<?>it de fi<?>ier apare ca linie de
              intrare, restul intrarii este ignorat. Daca nu se utilizeaza
              nici -E, nici -e, nu se utilizeaza <?>irul de sfar<?>it de
              fi<?>ier.

       -e[<?>ir-eof], --eof[=<?>ir-eof]
              Aceasta op<?>iune este sinonima cu op<?>iunea -E. Utiliza<?>i -E
              in schimb, deoarece este conforma cu POSIX, in timp ce aceasta
              op<?>iune nu este. Daca <?>ir-eof este omis, nu exista un <?>ir
              de sfar<?>it de fi<?>ier. Daca nu se utilizeaza nici -E, nici
              -e, nu se utilizeaza <?>irul de sfar<?>it de fi<?>ier.

       -I <?>ir-inlocuire
              Inlocuie<?>te apari<?>iile lui <?>ir-inlocuire in argumentele
              ini<?>iale cu nume citite de la intrarea standard. De asemenea,
              spa<?>iile libere fara ghilimele nu termina elementele de
              intrare; in schimb, separatorul este caracterul de linie noua.
              Implica -x <?>i -L 1.

       -i[<?>ir-inlocuire], --replace[=<?>ir-inlocuire]
              Aceasta op<?>iune este un sinonim pentru -I<?>ir-inlocuire daca
              se specifica <?>ir-inlocuire. Daca lipse<?>te argumentul
              <?>ir-inlocuire, efectul este acela<?>i ca <?>i in cazul -I{}.
              Aceasta op<?>iune este depreciata; utiliza<?>i -I in locul ei.

       -L max-linii
              Utilizeaza cel mult max-linii linii de intrare fara spa<?>ii
              libere pe fiecare linie de comanda. Liniile goale la sfar<?>it
              determina continuarea logica a unei linii de intrare pe
              urmatoarea linie de intrare. Implica -x.

       -l[max-linii], --max-lines[=max-linii]
              Sinonim pentru op<?>iunea -L. Spre deosebire de -L, argumentul
              max-linii este op<?>ional. Daca max-linii nu este specificat,
              valoarea implicita este 1. Op<?>iunea -l este depreciata,
              deoarece standardul POSIX specifica in schimb -L.

       -n max-arg, --max-args=max-arg
              Utilizeaza cel mult max-arg argumente pe linie de comanda. Se
              vor utiliza mai pu<?>ine argumente decat max-arg daca se
              depa<?>e<?>te dimensiunea (a se vedea op<?>iunea -s), cu
              excep<?>ia cazului in care se da op<?>iunea -x, caz in care se
              va ie<?>i din xargs..

       -P max-proc, --max-procs=max-proc
              Ruleaza pana la max-proc procese la un moment dat; valoarea
              implicita este 1. Daca max-proc este 0, xargs va rula cat mai
              multe procese posibile la un moment dat. Folosi<?>i op<?>iunea
              -n sau op<?>iunea -L cu -P; in caz contrar, exista <?>anse sa se
              execute doar o singura execu<?>ie. In timp ce xargs ruleaza,
              pute<?>i trimite procesului sau un semnal SIGUSR1 pentru a
              cre<?>te numarul de comenzi care vor fi executate simultan sau
              un SIGUSR2 pentru a reduce numarul. Nu il pute<?>i cre<?>te
              peste o limita definita de implementare (care este afi<?>ata cu
              --show-limits). Nu se poate scadea sub 1. xargs nu-<?>i termina
              niciodata comenzile; atunci cand i se cere sa scada numarul de
              comenzi, a<?>teapta doar ca mai multe comenzi existente sa se
              termine inainte de a incepe o alta.

              Re<?>ine<?>i ca este de competen<?>a proceselor apelate sa
              gestioneze in mod corespunzator accesul paralel la resursele
              partajate. De exemplu, daca mai multe dintre ele incearca sa
              imprime la ie<?>irea standard (stdout), ie<?>irile vor fi
              produse intr-o ordine nedeterminata (<?>i foarte probabil
              amestecate), cu excep<?>ia cazului in care procesele colaboreaza
              in vreun fel pentru a preveni acest lucru. Folosirea unei scheme
              de blocare este o modalitate de a preveni astfel de probleme. In
              general, utilizarea unei scheme de blocare va contribui la
              asigurarea unei ie<?>iri corecte, dar va reduce performan<?>a.
              Daca nu dori<?>i sa tolera<?>i diferen<?>a de performan<?>a,
              aranja<?>i pur <?>i simplu ca fiecare proces sa produca un
              fi<?>ier de ie<?>ire separat (sau sa utilizeze in alt mod
              resurse separate).

       -o, --open-tty
              Redeschide intrarea standard ca /dev/tty in procesul copil
              inainte de a executa comanda. Acest lucru este util daca
              dori<?>i ca xargs sa ruleze o aplica<?>ie interactiva.

       -p, --interactive
              Intreaba utilizatorul daca dore<?>te sa execute fiecare linie de
              comanda <?>i sa citeasca o linie din terminal. Executa linia de
              comanda numai daca raspunsul incepe cu ,,y" sau ,,Y". Implica
              -t.

       --process-slot-var=nume
              Stabile<?>te variabila de mediu nume la o valoare unica in
              fiecare proces copil care ruleaza. Valorile sunt refolosite
              odata ce procesele copil ies. Acest lucru poate fi utilizat, de
              exemplu, intr-o schema rudimentara de distribu<?>ie a sarcinii.

       -r, --no-run-if-empty
              In cazul in care intrarea standard nu con<?>ine niciun spa<?>iu
              in alb, nu executa comanda. In mod normal, comanda este
              executata o singura data, chiar daca nu exista nicio intrare.
              Aceasta op<?>iune este o extensie GNU.

       -s max-caractere, --max-chars=max-caractere
              Utilizeaza cel mult max-caractere caractere pe linie de comanda,
              inclusiv comanda <?>i argumentele ini<?>iale, precum <?>i
              caracterele nule de terminare de la capetele <?>irurilor de
              argumente. Cea mai mare valoare permisa depinde de sistem <?>i
              este calculata ca fiind limita de lungime a argumentelor pentru
              <<exec>>, minus dimensiunea mediului dumneavoastra, minus 2048
              de octe<?>i de spa<?>iu de manevra. Daca aceasta valoare este
              mai mare de 128KiB, se utilizeaza 128Kib ca valoare implicita;
              in caz contrar, valoarea implicita este cea maxima. 1KiB
              reprezinta 1024 de octe<?>i. xargs se adapteaza automat la
              constrangeri mai stricte.

       --show-limits
              Afi<?>eaza limitele de lungime a liniei de comanda care sunt
              impuse de sistemul de operare, de dimensiunea memoriei tampon
              aleasa de xargs <?>i de op<?>iunea -s. Canaliza<?>i intrarea
              catre /dev/null (<?>i poate specifica<?>i --no-run-if-empty)
              daca nu dori<?>i ca xargs sa faca ceva.

       -t, --verbose
              Afi<?>eaza linia de comanda la ie<?>irea de eroare standard
              inainte de a o executa.

       -x, --exit
              Iese in cazul in care dimensiunea (a se vedea op<?>iunea -s)
              este depa<?>ita.

       --help Afi<?>eaza un rezumat al op<?>iunilor lui xargs <?>i iese.

       --version
              Afi<?>eaza numarul versiunii xargs <?>i iese.

       Op<?>iunile --max-lines (-L, -l), --replace (-I, -i) <?>i --max-args
       (-n) se exclud reciproc. Daca unele dintre ele sunt specificate in
       acela<?>i timp, atunci xargs va utiliza, in general, op<?>iunea
       specificata ultima in linia de comanda, adica va restaura valoarea
       op<?>iunii incriminate (data inainte) la valoarea sa implicita. In
       plus, xargs va emite un diagnostic de avertizare la ie<?>irea de eroare
       standard. Excep<?>ia de la aceasta regula este ca valoarea speciala
       max-arg 1 (,,-n1") este ignorata dupa op<?>iunea --replace <?>i
       alias-urile sale -I <?>i -i, deoarece nu ar intra de fapt in conflict.


EXEMPLE
       find /tmp -name core -type f -print | xargs /bin/rm -f

       Gase<?>te fi<?>ierele cu numele core in sau sub directorul /tmp <?>i le
       <?>terge.  Re<?>ine<?>i ca acest lucru va func<?>iona incorect daca
       exista nume de fi<?>iere care con<?>in linii noi sau spa<?>ii.

       find /tmp -name core -type f -print0 | xargs -0 /bin/rm -f

       Gase<?>te fi<?>ierele numite core in sau sub directorul /tmp <?>i le
       <?>terge, procesand numele de fi<?>iere astfel incat numele de
       fi<?>iere sau directoare care con<?>in spa<?>ii sau linii noi sa fie
       tratate corect.


       find /tmp -depth -name core -type f -delete

       Gase<?>te fi<?>ierele numite core in sau sub directorul /tmp <?>i le
       <?>terge, dar mai eficient decat in exemplul anterior (deoarece se
       evita necesitatea de a utiliza fork(2) <?>i exec(2) pentru a lansa rm
       <?>i nu avem nevoie de procesul suplimentar xargs).


       cut -d: -f1 < /etc/passwd | sort | xargs echo

       Genereaza o lista compacta a tuturor utilizatorilor din sistem.

STARE DE IE<?>IRE
       xargs iese cu urmatoarea stare:

              0      daca reu<?>e<?>te

              123    daca orice invocare a comenzii a ie<?>it cu starea 1-125

              124    daca comanda a ie<?>it cu starea 255

              125    daca comanda este omorata de un semnal

              126    daca comanda nu poate fi executata

              127    daca comanda nu este gasita

              1      in cazul in care s-a produs o alta eroare.


       Codurile de ie<?>ire mai mari de 128 sunt utilizate de shell pentru a
       indica faptul ca un program a murit din cauza unui semnal fatal.

CONFORMAREA CU STANDARDELE
       Incepand cu versiunea 4.2.9 a GNU xargs, comportamentul implicit al
       xargs este de a nu avea un marcaj logic de sfar<?>it de fi<?>ier. POSIX
       (IEEE Std 1003.1, edi<?>ia 2004) permite acest lucru.

       Op<?>iunile ,,-l" <?>i ,,-i" apar in versiunea din 1997 a standardului
       POSIX, dar nu apar in versiunea din 2004 a standardului. Prin urmare,
       ar trebui sa utiliza<?>i in schimb ,,-L" <?>i, respectiv, ,,-I".

       Op<?>iunea ,,-o" este o extensie a standardului POSIX pentru o mai buna
       compatibilitate cu BSD.

       Standardul POSIX permite implementarilor sa aiba o limita privind
       dimensiunea argumentelor pentru func<?>iile exec. Aceasta limita poate
       fi de pana la 4096 octe<?>i, inclusiv dimensiunea mediului. Pentru ca
       scripturile sa fie portabile, acestea nu trebuie sa se bazeze pe o
       valoare mai mare. Cu toate acestea, nu cunosc nicio implementare a
       carei limita reala sa fie atat de mica. Op<?>iunea --show-limits poate
       fi utilizata pentru a descoperi limitele reale in vigoare pe sistemul
       actual.

ERORI
       Nu este posibil ca xargs sa fie utilizat in siguran<?>a, deoarece va
       exista intotdeauna un interval de timp intre producerea listei de
       fi<?>iere de intrare <?>i utilizarea lor in comenzile pe care xargs le
       emite. Daca al<?>i utilizatori au acces la sistem, ace<?>tia pot
       manipula sistemul de fi<?>iere in timpul acestui interval de timp
       pentru a for<?>a ac<?>iunea comenzilor pe care xargs le executa sa se
       aplice unor fi<?>iere pe care nu le-a<?>i inten<?>ionat. Pentru o
       discu<?>ie mai detaliata a acestei probleme <?>i a problemelor conexe,
       consulta<?>i capitolul ,,Security Considerations" din documenta<?>ia
       findutils Texinfo. Op<?>iunea -execdir din find poate fi adesea
       utilizata ca o alternativa mai sigura.

       Atunci cand utiliza<?>i op<?>iunea -I, fiecare linie citita de la
       intrare este pusa in memoria tampon interna. Aceasta inseamna ca exista
       o limita superioara a lungimii liniei de intrare pe care xargs o va
       accepta atunci cand este utilizata cu op<?>iunea -I. Pentru a ocoli
       aceasta limitare, pute<?>i utiliza op<?>iunea -s pentru a mari
       spa<?>iul de tampon pe care il utilizeaza xargs <?>i pute<?>i utiliza,
       de asemenea, o invocare suplimentara a xargs pentru a va asigura ca nu
       apar linii foarte lungi. De exemplu:

       vreo-comanda | xargs -s 50000 echo | xargs -I '{}' -s 100000 rm '{}'

       Aici, prima invocare a xargs nu are o limita de lungime a liniei de
       intrare, deoarece nu utilizeaza op<?>iunea -i. A doua invocare a xargs
       are o astfel de limita, dar ne-am asigurat ca nu intalne<?>te niciodata
       o linie mai lunga decat poate gestiona. Aceasta nu este o solu<?>ie
       ideala. In schimb, op<?>iunea -i nu ar trebui sa impuna o limita de
       lungime a liniei, motiv pentru care aceasta discu<?>ie apare in
       sec<?>iunea ERORI. Problema nu apare la ie<?>irea lui find(1), deoarece
       acesta emite doar un nume de fi<?>ier pe linie.

RAPORTAREA ERORILOR
       Ajutor in internet pentru GNU findutils:
       <https://www.gnu.org/software/findutils/#get-help>.
       Raporta<?>i orice erori de traducere la:
       <https://translationproject.org/team/ro.html>

       Raporta<?>i orice alta problema prin intermediul formularului de la
       sistemul de urmarire a erorilor al GNU Savannah:
              <https://savannah.gnu.org/bugs/?group=findutils>
       Subiectele generale despre pachetul GNU findutils sunt discutate pe
       lista de discu<?>ii bug-findutils:
              <https://lists.gnu.org/mailman/listinfo/bug-findutils>

DREPTURI DE AUTOR
       Drepturi de autor (C) 1990-2022 Free Software Foundation, Inc.
       Licen<?>a GPLv3+: GNU GPL versiunea 3 sau ulterioara
       <https://gnu.org/licenses/gpl.html>.
       Acesta este software liber: sunte<?>i liber sa-l modifica<?>i <?>i sa-l
       redistribui<?>i. Nu exista NICIO GARAN<?>IE, in limitele prevazute de
       lege.

CONSULTA<?>I <?>I
       find(1), kill(1), locate(1), updatedb(1), fork(2), execvp(3),
       locatedb(5), signal(7)

       Documenta<?>ia completa este disponibila la
       <https://www.gnu.org/software/findutils/xargs>.
       sau local prin intermediul comenzii: info xargs

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

                                                                      XARGS(1)