getsockopt(2)                 System Calls Manual                getsockopt(2)

NUME
       getsockopt, setsockopt - ob<?>ine <?>i define<?>te op<?>iunile pe
       socluri

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

REZUMAT
       #include <sys/socket.h>

       int getsockopt(int sockfd, int nivel, int optname,
                      void optval[restrict *.optlen],
                      socklen_t *restrict optlen);
       int setsockopt(int sockfd, int nivel, int optname,
                      const void optval[.optlen],
                      socklen_t optlen);

DESCRIERE
       getsockopt() <?>i setsockopt() manipuleaza op<?>iunile pentru soclul la
       care face referire descriptorul de fi<?>ier sockfd.  Op<?>iunile pot
       exista la mai multe niveluri de protocol; ele sunt intotdeauna prezente
       la nivelul de soclu cel mai inalt.

       Atunci cand se manipuleaza op<?>iunile de soclu, trebuie sa se
       precizeze nivelul la care se afla op<?>iunea <?>i numele acesteia.
       Pentru a manipula op<?>iunile de la nivelul API pentru socluri, nivel
       este specificat ca SOL_SOCKET.  Pentru a manipula op<?>iunile la orice
       alt nivel, se furnizeaza numarul protocolului corespunzator care
       controleaza op<?>iunea.  De exemplu, pentru a indica faptul ca o
       op<?>iune trebuie interpretata de protocolul TCP, nivel trebuie sa fie
       definit la numarul de protocol al TCP; a se vedea getprotoent(3).

       Argumentele optval <?>i optlen sunt utilizate pentru a accesa valorile
       op<?>iunilor pentru setsockopt().  Pentru getsockopt(), acestea
       identifica o memorie tampon in care trebuie returnata valoarea
       op<?>iunii (op<?>iunilor) solicitate.  Pentru getsockopt(), optlen este
       un argument valoare-rezultat, care con<?>ine ini<?>ial dimensiunea
       memoriei tampon indicata de optval <?>i care este modificata la
       returnare pentru a indica dimensiunea reala a valorii returnate.  Daca
       nu trebuie furnizata sau returnata nicio valoare de op<?>iune, optval
       poate fi NULL.

       Optname <?>i orice op<?>iuni specificate sunt transmise neinterpretate
       modulului de protocol corespunzator pentru interpretare.  Fi<?>ierul de
       includere <sys/socket.h> con<?>ine defini<?>ii pentru op<?>iunile la
       nivel de soclu, descrise mai jos.  Op<?>iunile de la alte niveluri de
       protocol variaza in ceea ce prive<?>te formatul <?>i numele;
       consulta<?>i intrarile corespunzatoare din sec<?>iunea 4 a manualului.

       Majoritatea op<?>iunilor la nivel de soclu utilizeaza un argument int
       pentru optval.  Pentru setsockopt(), argumentul trebuie sa fie diferit
       de zero pentru a activa o op<?>iune booleana, sau zero daca op<?>iunea
       trebuie dezactivata.

       Pentru o descriere a op<?>iunilor de soclu disponibile, consulta<?>i
       socket(7) <?>i paginile de manual ale protocolului corespunzator.

VALOAREA RETURNATA
       In caz de succes, se returneaza zero pentru op<?>iunile standard.  In
       caz de eroare, se returneaza -1, iar errno este configurata pentru a
       indica eroarea.

       Netfilter permite programatorului sa defineasca op<?>iuni de soclu
       personalizate cu gestionari asocia<?>i; pentru astfel de op<?>iuni,
       valoarea de returnare in caz de succes este valoarea returnata de
       gestionarul respectiv.

ERORI-IE<?>IRE
       EBADF  Argumentul sockfd nu este un descriptor de fi<?>ier valid.

       EFAULT Adresa indicata de optval nu se afla intr-o parte valida a
              spa<?>iului de adrese al procesului.  Pentru getsockopt(),
              aceasta eroare poate fi returnata, de asemenea, daca optlen nu
              se afla intr-o parte valida a spa<?>iului de adrese al
              procesului.

       EINVAL optlen nevalida in setsockopt().  In unele cazuri, aceasta
              eroare poate aparea, de asemenea, pentru o valoare nevalida in
              optval (de exemplu, pentru op<?>iunea IP_ADD_MEMBERSHIP descrisa
              in ip(7)).

       ENOPROTOOPT
              Op<?>iunea este necunoscuta la nivelul indicat.

       ENOTSOCK
              Descriptorul de fi<?>ier sockfd nu se refera la un soclu.

STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001, SVr4, 4.4BSD (a aparut pentru prima data in 4.2BSD).

ERORI
       Mai multe dintre op<?>iunile de soclu ar trebui sa fie gestionate la
       niveluri inferioare ale sistemului.

CONSULTA<?>I <?>I
       ioctl(2), socket(2), getprotoent(3), protocols(5), ip(7), packet(7),
       socket(7), tcp(7), udp(7), unix(7)

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>.

Pagini de manual de Linux 6.06 31 octombrie 2023                 getsockopt(2)