.\" -*- coding: UTF-8 -*- .\" Copyright (C) 2003 Davide Libenzi .\" and Copyright 2008, 2009, 2012 Michael Kerrisk .\" Davide Libenzi .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified 2004-06-17 by Michael Kerrisk .\" Modified 2005-04-04 by Marko Kohtala .\" 2008-10-10, mtk: add description of epoll_create1() .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH epoll_create 2 "16 iulie 2023" "Pagini de manual de Linux 6.05.01" .SH NUME epoll_create, epoll_create1 \- deschide un descriptor de fișier epoll .SH BIBLIOTECA Biblioteca C standard (\fIlibc\fP, \fI\-lc\fP) .SH REZUMAT .nf \fB#include \fP .PP \fBint epoll_create(int \fP\fIsize\fP\fB);\fP \fBint epoll_create1(int \fP\fIflags\fP\fB);\fP .fi .SH DESCRIERE \fBepoll_create\fP() creează o nouă instanță \fBepoll\fP(7). Începând cu Linux 2.6.8, argumentul \fIsize\fP este ignorat, dar trebuie să fie mai mare decât zero; a se vedea ISTORIC. .PP \fBepoll_create\fP() returnează un descriptor de fișier care se referă la noua instanță epoll. Acest descriptor de fișier este utilizat pentru toate apelurile ulterioare la interfața \fBepoll\fP. Atunci când nu mai este necesar, descriptorul de fișier returnat de \fBepoll_create\fP() trebuie închis prin utilizarea \fBclose\fP(2). Atunci când toți descriptorii de fișiere care se referă la o instanță epoll au fost închiși, nucleul distruge instanța și eliberează resursele asociate pentru reutilizare. .SS epoll_create1() Dacă \fIflags\fP este 0, atunci, în afară de faptul că se renunță la argumentul învechit \fIsize\fP, \fBepoll_create1\fP() este la fel ca \fBepoll_create\fP(). Următoarea valoare poate fi inclusă în \fIflags\fP pentru a obține un comportament diferit: .TP \fBEPOLL_CLOEXEC\fP Stabilește fanionul „close\-on\-exec” (\fBFD_CLOEXEC\fP) pe noul descriptor de fișier. A se vedea descrierea fanionului \fBO_CLOEXEC\fP în \fBopen\fP(2) pentru motivele pentru care acest lucru poate fi util. .SH "VALOAREA RETURNATĂ" În caz de succes, aceste apeluri de sistem returnează un descriptor de fișier (un număr întreg nenegativ). În caz de eroare, se returnează \-1, iar \fIerrno\fP este configurată pentru a indica eroarea. .SH ERORI\-IEȘIRE .TP \fBEINVAL\fP argumentul \fIsize\fP nu este pozitiv. .TP \fBEINVAL\fP (\fBepoll_create1\fP()) Valoare nevalidă specificată în \fIflags\fP. .TP \fBEMFILE\fP Limita per proces a numărului de descriptori de fișiere deschise a fost atinsă. .TP \fBENFILE\fP Limita la nivel de sistem a numărului total de fișiere deschise a fost atinsă. .TP \fBENOMEM\fP Nu a existat suficientă memorie pentru a crea obiectul nucleului. .SH STANDARDE Linux. .SH ISTORIC .TP \fBepoll_create\fP() .\" To be precise: kernel 2.5.44. .\" The interface should be finalized by Linux kernel 2.5.66. Linux 2.6, glibc 2.3.2. .TP \fBepoll_create1\fP() Linux 2.6.27, glibc 2.9. .PP În implementarea inițială a \fBepoll_create\fP(), argumentul \fIsize\fP informa nucleul cu privire la numărul de descriptori de fișiere pe care apelantul se aștepta să îi adauge la instanța \fBepoll\fP. Nucleul folosea această informație ca un indiciu pentru cantitatea de spațiu pe care trebuia să o aloce inițial în structurile de date interne care descriu evenimentele (dacă era necesar, nucleul aloca mai mult spațiu dacă utilizarea apelantului depășea indicația dată în \fIsize\fP). În prezent, acest indiciu nu mai este necesar ( nucleul dimensionează în mod dinamic structurile de date necesare fără a avea nevoie de indiciu), dar \fIsize\fP trebuie să fie în continuare mai mare decât zero, pentru a asigura compatibilitatea retroactivă atunci când noile aplicații \fBepoll\fP sunt rulate pe nuclee mai vechi. .PP .\" commit 9df04e1f25effde823a600e755b51475d438f56b Înainte de Linux 2.6.29, un parametru de nucleu \fI/proc/sys/fs/epoll/max_user_instances\fP limita numărul de epoll\-uri active pentru fiecare ID de utilizator real și făcea ca \fBepoll_create\fP() să eșueze cu \fBEMFILE\fP la depășirea acestei valori. .SH "CONSULTAȚI ȘI" \fBclose\fP(2), \fBepoll_ctl\fP(2), \fBepoll_wait\fP(2), \fBepoll\fP(7) .PP .SH TRADUCERE Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu . .PP Această traducere este documentație gratuită; citiți .UR https://www.gnu.org/licenses/gpl-3.0.html Licența publică generală GNU Versiunea 3 .UE sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE. .PP Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la .MT translation-team-ro@lists.sourceforge.net .ME .