getsockopt(2) System Calls Manual getsockopt(2) NOMBRE getsockopt, setsockopt - obtiene y pone opciones en conectores (sockets) BIBLIOTECA Biblioteca Estandar C (libc, -lc) SINOPSIS #include int getsockopt(socklen_t *restrict optlen; int sockfd, int level, int optname, void optval[_Nullable restrict *optlen], socklen_t *restrict optlen); int setsockopt(socklen_t optlen; int sockfd, int level, int optname, const void optval[optlen], socklen_t optlen); DESCRIPCION getsockopt() y setsockopt() manipulan las opciones del socket al que hace referencia el descriptor de archivo sockfd. Las opciones pueden existir en varios niveles de protocolo; siempre estan presentes en el nivel de socket superior. Al manipular las opciones de socket, se debe definir el nivel en el que reside la opcion y su nombre. Para manipular opciones al nivel de la API de sockets, level se define como SOL_SOCKET. Para manipular opciones en cualquier otro nivel, se indica el numero del protocolo correspondiente que controla la opcion. Por ejemplo, para indicar que una opcion debe ser interpretada por el protocolo TCP, level debera establecerse en el numero de protocolo de TCP; consulte getprotoent(3). Los argumentos optval y optlen sirven para acceder a los valores de las opciones de setsockopt(). En getsockopt(), identifican un bufer que retornara el valor de las opciones solicitadas. Para getsockopt(), optlen es un argumento de valor-resultado que inicialmente contiene el tamano del bufer al que apunta optval y se modifica al regresar para indicar el tamano real del valor devuelto. Si no se proporciona ni se devuelve ningun valor, optval puede ser NULL. Optname y cualesquiera opciones especificadas se pasan sin interpretar al modulo de protocolo apropiado para su interpretacion. El fichero de cabecera contiene definiciones para opciones de nivel de conector, descritas mas abajo. Las opciones a otros niveles de protocolo varian en formato y nombre; consulte las paginas apropiadas de la seccion 4 del Manual. La mayoria de las opciones de nivel-conector utilizan un parametro int para optval. Para setsockopt(), el parametro debe ser distinto de cero para permitir una opcion booleana, o cero si la opcion va a ser deshabilitada. Para una descripcion de las opciones disponibles para conectores vea socket(7) y las paginas de manual del protocolo apropiado. VALOR DEVUELTO En caso de exito, se devuelve cero en las operaciones estandar. En caso de error, -1, y se define errno al valor correspondiente. Netfilter permite al programador definir opciones de socket personalizadas con controladores asociados; para estas opciones, el valor de retorno, en caso de exito, sera el valor devuelto por el controlador. ERRORES EBADF El argumento sockfd no es un descriptor de archivo valido. EFAULT La direccion apuntada por optval no esta en un sitio valido del espacio de direcciones del proceso. Para getsockopt(), este error puede tambien ser devuelto si optlen no esta en un sitio valido del espacio de direcciones del proceso. EINVAL optlen no valido en setsockopt(). En algunos casos, este error tambien puede ocurrir si el valor de optval no es valido (por ejemplo, para la opcion IP_ADD_MEMBERSHIP descrita en ip(7)). ENOPROTOOPT La opcion es desconocida al nivel indicado. ENOTSOCK El descriptor de archivo sockfd no se refiere a un conector. ESTANDARES POSIX.1-2024. HISTORIAL POSIX.1-2001, SVr4, 4.4BSD (aparecio por primera vez en 4.2BSD). ERRORES Algunas de las opciones de conector deberian ser manejadas a niveles mas bajos del sistema. VEASE TAMBIEN ioctl(2), socket(2), getprotoent(3), protocols(5), ip(7), packet(7), socket(7), tcp(7), udp(7), unix(7) TRADUCCION La traduccion al espanol de esta pagina del manual fue creada por Juan Piernas , Miguel Perez Ibars y Marcos Fouces Esta traduccion es documentacion libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. Si encuentra algun error en la traduccion de esta pagina del manual, envie un correo electronico a . Linux man-pages 6.18 29 Octubre 2025 getsockopt(2)