'\" t
.\"     Title: pipesz
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.23
.\"      Date: 2025-03-29
.\"    Manual: Comenzi utilizator
.\"    Source: util-linux 2.41
.\"  Language: English
.\"
.TH "PIPESZ" "1" "2025-03-29" "util\-linux 2.41" "Comenzi utilizator"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NUME"
pipesz \- stabilește sau examinează dimensiunile memoriilor tampon ale conductelor și FIFO
.SH "REZUMAT"
.sp
\fBpipesz\fP [opțiuni] [\-\-set \fIdimensiunea\fP] [\-\-] [\fIcomanda\fP [argument] ...]
.sp
\fBpipesz\fP [opțiuni] \-\-get
.SH "DESCRIERE"
.sp
Conductele și FIFO\-urile (conductele cu nume) mențin o memorie tampon internă utilizată pentru transferul de date între capătul de citire și cel de scriere. În unele cazuri, este posibil ca dimensiunea implicită a acestui tampon intern să nu fie adecvată. Acest program oferă facilități pentru a stabili și examina dimensiunea acestor memorii tampon.
.sp
Operația \fB\-\-set\fP stabilește dimensiunile memoriilor tampon ale conductelor. În cazul în care este specificată, aceasta trebuie să fie specificată cu o \fIdimensiune\fP explicită. În caz contrar, aceasta este implicită, iar dimensiunea este citită din \fB/proc/sys/fs/pipe\-max\-size\fP. Nucleul poate ajusta \fIdimensiunea\fP așa cum este descris în \fBfcntl\fP(2). Pentru a determina dimensiunile reale ale memoriilor tampon definite, utilizați opțiunea \fB\-\-verbose\fP. Dacă nu sunt specificate nici \fB\-\-file\fP, nici \fB\-\-fd\fP, \fB\-\-set\fP acționează la ieșirea standard.
.sp
Operația \fB\-\-set\fP permite executarea unei \fIcomenzi\fP opționale după stabilirea dimensiunilor memoriei tampon de conductă. Această comandă este executată cu conductele ajustate.
.sp
Operația \fB\-\-get\fP produce date într\-un format tabelar. Prima coloană este numele conductei, așa cum a fost pasat la \fBpipesz\fP. Descriptorii de fișiere se numesc „fd \fIN\fP”. A doua coloană este dimensiunea, în octeți, a memoriei tampon interne a conductei. A treia coloană este numărul de octeți necitit în prezent din conductă. Coloanele sunt separate de tabulatoare ("\(rst", ASCII 09h). În cazul în care se specifică \fB\-\-verbose\fP, se emite, de asemenea, un antet descriptiv. Dacă nu sunt specificate nici \fB\-\-file\fP, nici \fB\-\-fd\fP, \fB\-\-get\fP acționează la intrarea standard.
.sp
Cu excepția cazului în care este specificată opțiunea \fB\-\-check\fP, \fBpipesz\fP nu iese dacă întâlnește o eroare în timp ce manipulează un fișier sau un descriptor de fișier. Acest lucru permite ca \fBpipesz\fP să fie utilizat în mod generic fără teama de a întrerupe execuția conductelor în cazul în care tipul anumitor fișiere ar fi schimbat ulterior. Pentru o perturbare minimă, opțiunea \fB\-\-quiet\fP împiedică emiterea de avertismente în aceste cazuri.
.sp
Nucleul impune limite asupra cantității de spațiu de memorie tampon pentru conducte pe care o pot utiliza procesele neprivilegiate, dar consultați \fBERORI\fP mai jos. De asemenea, nucleul va refuza să micșoreze o memorie tampon a unei conducte în cazul în care acest lucru ar duce la pierderea datelor stocate în memoria tampon. Pentru detalii suplimentare, consultați \fBpipe\fP(7).
.sp
\fBpipesz\fP acceptă specificarea mai multor opțiuni scurte consecutiv, în modul obișnuit \fBgetopt\fP(3). Primul argument fără opțiune este interpretat ca fiind \fIcomanda\fP. Dacă \fIcomanda\fP ar putea începe cu „\-”, utilizați „\-\-” pentru a o separa de argumentele pentru \fBpipesz\fP. În scripturile de tip shell, este o bună practică să se utilizeze „\-\-” atunci când este vorba de extinderea parametrilor. \fBpipesz\fP însuși nu citește de la intrarea standard și nu scrie la ieșirea standard decât dacă sunt specificate \fB\-\-get\fP, \fB\-\-help\fP sau \fB\-\-version\fP.
.SH "OPȚIUNI"
.sp
\fB\-g\fP, \fB\-\-get\fP
.RS 4
Raportează dimensiunea memoriilor tampon ale conductelor la ieșirea standard și iese. Ca un comportament special, dacă nu sunt specificate nici \fB\-\-file\fP, nici \fB\-\-fd\fP, se examinează intrarea standard. Este o eroare să se specifice această opțiune în combinație cu \fB\-\-set\fP.
.RE
.sp
\fB\-s\fP, \fB\-\-set\fP \fIdimensiunea\fP
.RS 4
Stabilește dimensiunea memoriilor tampon ale conductelor, în octeți. Această opțiune poate fi sufixată cu \fIK\fP, \fIM\fP, \fIG\fP, \fIKiB\fP, \fIMiB\fP sau \fIGiB\fP pentru a indica multiplii de 1024. În acest caz, sunt acceptate valorile fracționare. Sufixele suplimentare sunt acceptate, dar este puțin probabil să fie utile. Dacă această opțiune nu este specificată, se utilizează o valoare implicită, așa cum este descris mai sus. În cazul în care această opțiune este specificată de mai multe ori, se emite un avertisment și se utilizează doar ultima \fIdimensiune\fP specificată. Ca un comportament special, dacă nu sunt specificate nici \fB\-\-file\fP, nici \fB\-\-fd\fP, ieșirea standard este ajustată. Specificarea acestei opțiuni în combinație cu \fB\-\-get\fP constituie o eroare.
.RE
.sp
\fB\-f\fP, \fB\-\-file\fP \fIruta\fP
.RS 4
Stabilește dimensiunea memoriei tampon a FIFO\-ului sau a conductei din \fIruta\fP, în raport cu directorul de lucru curent. Puteți specifica această opțiune de mai multe ori pentru a afecta fișiere diferite și puteți face acest lucru în combinație cu \fB\-\-fd\fP. În general, această opțiune este utilizată cu FIFO\-uri, dar va funcționa și cu conducte anonime, cum ar fi cele găsite în \fB/proc/PID/fd\fP. Modificările aduse dimensiunii memoriei tampon a FIFO\-urilor nu sunt păstrate de la o repornire a sistemului la alta.
.RE
.sp
\fB\-n\fP, \fB\-\-fd\fP \fIfd\fP
.RS 4
Stabilește dimensiunea memoriei tampon a conductei sau a FIFO\-ului pasată la \fBpipesz\fP ca număr de descriptor de fișier specificat. Puteți specifica această opțiune de mai multe ori pentru a afecta diferiți descriptori de fișiere și puteți face acest lucru în combinație cu \fB\-\-file\fP. Sunt furnizate opțiuni prescurtate pentru cazurile obișnuite de fd 0 (stdin, intrarea standard), fd 1 (stdout, ieșirea standard) și fd 2 (stderr, ieșirea de eroare standard). Acestea ar trebui să fie suficiente în majoritatea cazurilor.
.RE
.sp
\fB\-i\fP, \fB\-\-stdin\fP
.RS 4
Abreviere pentru \fB\-\-fd 0\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-stdout\fP
.RS 4
Abreviere pentru \fB\-\-fd 1\fP.
.RE
.sp
\fB\-e\fP, \fB\-\-stderr\fP
.RS 4
Abreviere pentru \fB\-\-fd 2\fP.
.RE
.sp
\fB\-c\fP, \fB\-\-check\fP
.RS 4
Iese, fără a executa \fIcomanda\fP, în caz de eroare în timpul manipulării unui fișier sau a unui descriptor de fișier. Comportamentul implicit în cazul în care acest lucru nu este specificat este de a emite un avertisment la ieșirea de eroare standard și de a continua.
.RE
.sp
\fB\-q\fP, \fB\-\-quiet\fP
.RS 4
Nu diagnostichează erorile care nu sunt fatale la ieșirea de eroare standard. Această opțiune nu afectează ieșirea normală a \fB\-\-get\fP, \fB\-\-verbose\fP, \fB\-\-help\fP sau \fB\-\-version\fP.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
Dacă este specificată cu \fB\-\-get\fP, \fBpipesz\fP va emite un antet descriptiv deasupra tabelului. În caz contrar, dacă este specificată, \fBpipesz\fP va afișa la ieșirea de eroare standard dimensiunile actuale ale memoriilor tampon stabilite de nucleu.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
Afișează acest mesaj de ajutor și iese.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
Afișează versiunea și iese.
.RE
.SH "EXEMPLE"
.sp
\fBpipesz\fP \fBdd\fP if=\fIfișier\fP bs=1M | ...
.RS 4
Rulează \fBdd\fP(1) cu o conductă de ieșire standard extinsă, permițându\-i să evite schimbările de context atunci când se face o legătură între blocuri mari.
.RE
.sp
\fBpipesz\fP \-s1M \-cf \fI/run/serviciul\-meu.fifo\fP
.RS 4
Stabilește dimensiunea memoriei tampon a conductei unui serviciu FIFO la 1.048.576 octeți. În cazul în care dimensiunea memoriei tampon nu a putut fi stabilită, \fBpipesz\fP iese cu o eroare.
.RE
.sp
\fBecho\fP hello | \fBpipesz\fP \-g
.RS 4
Afișează dimensiunea conductei utilizate de shell pentru a transmite datele de intrare către \fBpipesz\fP. Deoarece \fBpipesz\fP nu citește intrarea standard, este posibil să raporteze, de asemenea, 6 octeți necitiți în conductă, în funcție de timpii relativi.
.RE
.sp
\fBfind\fP /proc/\fIPID\fP/fd \-exec \fBpipesz\fP \-gqf \*(Aq{}\*(Aq \*(Aq;\*(Aq
.RS 4
Afișează dimensiunea și numărul de octeți necitiți ai tuturor conductelor utilizate de \fIPID\fP. În cazul în care unele conducte sunt în mod obișnuit pline, \fBpipesz\fP ar putea fi capabilă să atenueze un blocaj de procesare.
.RE
.SH "NOTE"
.sp
Linux suportă ajustarea dimensiunii memoriilor tampon ale conductelor începând cu nucleul 2.6.35. Această versiune a introdus, de asemenea, \fB/proc/sys/fs/pipe\-max\-size\fP.
.sp
Acest program utilizează \fBfcntl\fP(2) \fBF_GETPIPE_SZ\fP/\fBF_SETPIPE_SZ\fP pentru a obține și a stabili dimensiunile memoriilor tampon ale conductelor.
.sp
Acest program utilizează \fBioctl\fP(2) \fBFIONREAD\fP pentru a raporta cantitatea de date necitite din conducte. Dacă dintr\-un motiv oarecare acest lucru eșuează, cantitatea de date necitite este raportată ca fiind 0.
.SH "ERORI"
.sp
Înainte de Linux 4.9, unele erori afectează modul în care sunt aplicate anumite limite de resurse atunci când se stabilesc dimensiunile memoriilor tampon pentru pipe. Consultați \fBpipe\fP(7) pentru detalii.
.SH "AUTORI"
.sp
.MTO "nwsharp\(atlive.com" "Nathan Sharp" ""
.SH "CONSULTAȚI ȘI"
.sp
\fBpipe\fP(7)
.SH "RAPORTAREA ERORILOR"
.sp
Pentru rapoarte de eroare, folosiți \c
.URL "https://github.com/util\-linux/util\-linux/issues" "sistemul de urmărire al erorilor" "."
.SH "DISPONIBILITATE"
.sp
Comanda \fBpipesz\fP face parte din pachetul util\-linux care poate fi descărcat de la \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."