Movatterモバイル変換

setsockopt(3p) — Linux manual page

PROLOG \|NAME \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ERRORS \|EXAMPLES \|APPLICATION USAGE \|RATIONALE \|FUTURE DIRECTIONS \|SEE ALSO \|COPYRIGHT

SETSOCKOPT(3P)          POSIX Programmer's ManualSETSOCKOPT(3P)

PROLOG top

       This manual page is part of the POSIX Programmer's Manual.  The       Linux implementation of this interface may differ (consult the       corresponding Linux manual page for details of Linux behavior), or       the interface may not be implemented on Linux.

NAME top

       setsockopt — set the socket options

SYNOPSIS top

       #include <sys/socket.h>       int setsockopt(intsocket, intlevel, intoption_name,           const void *option_value, socklen_toption_len);

DESCRIPTION top

       Thesetsockopt() function shall set the option specified by theoption_name argument, at the protocol level specified by thelevel       argument, to the value pointed to by theoption_value argument for       the socket associated with the file descriptor specified by thesocket argument.       Thelevel argument specifies the protocol level at which the       option resides. To set options at the socket level, specify thelevel argument as SOL_SOCKET. To set options at other levels,       supply the appropriatelevel identifier for the protocol       controlling the option. For example, to indicate that an option is       interpreted by the TCP (Transport Control Protocol), setlevel to       IPPROTO_TCP as defined in the<netinet/in.h> header.       Theoption_name argument specifies a single option to set. It can       be one of the socket-level options defined insys_socket.h(0p) and       described inSection 2.10.16,Use of Options.  Ifoption_name is       equal to SO_RCVTIMEO or SO_SNDTIMEO and the implementation       supports setting the option, it is unspecified whether thestructtimevalpointed to byoption_value is stored as provided by this       function or is rounded up to align with the resolution of the       clock being used. Ifsetsockopt() is called withoption_name equal       to SO_ACCEPTCONN, SO_ERROR, or SO_TYPE, the behavior is       unspecified.

RETURN VALUE top

       Upon successful completion,setsockopt() shall return 0.       Otherwise, -1 shall be returned anderrno set to indicate the       error.

ERRORS top

       Thesetsockopt() function shall fail if:EBADFThesocket argument is not a valid file descriptor.EDOMThe send and receive timeout values are too big to fit into              the timeout fields in the socket structure.EINVALThe specified option is invalid at the specified socket              level or the socket has been shut down.EISCONN              The socket is already connected, and a specified option              cannot be set while the socket is connected.ENOPROTOOPT              The option is not supported by the protocol.ENOTSOCK              Thesocket argument does not refer to a socket.       Thesetsockopt() function may fail if:ENOMEMThere was insufficient memory available for the operation              to complete.ENOBUFS              Insufficient resources are available in the system to              complete the call.The following sections are informative.

EXAMPLES top

       None.

APPLICATION USAGE top

       Thesetsockopt() function provides an application program with the       means to control socket behavior. An application program can usesetsockopt() to allocate buffer space, control timeouts, or permit       socket data broadcasts. The<sys/socket.h> header defines the       socket-level options available tosetsockopt().       Options may exist at multiple protocol levels. The SO_ options are       always present at the uppermost socket level.

RATIONALE top

       None.

FUTURE DIRECTIONS top

       None.

COPYRIGHT top

       Portions of this text are reprinted and reproduced in electronic       form from IEEE Std 1003.1-2017, Standard for Information       Technology -- Portable Operating System Interface (POSIX), The       Open Group Base Specifications Issue 7, 2018 Edition, Copyright       (C) 2018 by the Institute of Electrical and Electronics Engineers,       Inc and The Open Group.  In the event of any discrepancy between       this version and the original IEEE and The Open Group Standard,       the original IEEE and The Open Group Standard is the referee       document. The original Standard can be obtained online athttp://www.opengroup.org/unix/online.html .       Any typographical or formatting errors that appear in this page       are most likely to have been introduced during the conversion of       the source files to man page format. To report such errors, seehttps://www.kernel.org/doc/man-pages/reporting_bugs.html .IEEE/The Open Group                2017SETSOCKOPT(3P)

Pages that refer to this page:netinet_in.h(0p), netinet_tcp.h(0p), sys_socket.h(0p), getsockopt(3p), if_freenameindex(3p), if_indextoname(3p), if_nameindex(3p), if_nametoindex(3p), send(3p), sendmsg(3p), sendto(3p), shutdown(3p), socket(3p)