1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94
|
.\" Copyright (c)1983, 1991 Los Regentes de la Universidad de California.
.\" Todos los derechos reservados.
.\"
.\" Redistribuciones y uso de los formatos fuente y binario, con o sin
.\" modificacin, son permitidas siempre que las siguientes condiciones
.\" sean cumplidas :
.\" 1. Redistribuciones del cdigo fuente deben guardar el mensaje del
.\" copyright, esta lista de condiciones y las siguientes renuncias.
.\" 2.Redistribuciones en forma binaria deben reproducir el copyright,
.\" esta lista de condiciones y las siguientes renuncias en la
.\" documentacin y/u otros materiales provistos con la distribucin.
.\" 3. Todo advertimiento, materiales, menciones, caractersticas o uso de este software
.\" debe mostrar el siguiente reconocimiento :
.\" Este producto incluye software desarrollado por la Universidad de
.\" California, Berkeley y sus contribuciones.
.\" 4. Ni el nombre de la Universidad de California ni los nombres de sus contribuidores
.\" deben ser usados para aprobar o fomentar productos derivados de este sofware
.\" sin un permiso por escrito con prioridad especfica.
.\" ESTE SOFTWARE ES PROPORCIONADO POR LOS REGENTES Y CONTRIBUIDORES
.\" "COMO ES" Y
.\" CUALQUIER GARANTIA EXPRESA O IMPLICITA, INCLUYENDO, PERO NO LIMITANDO A, LAS
.\" GARANTIAS IMPLICITAS DE COMERCIABILIDAD Y BUENA APTITUD PARA UN PROPOSITO PARTICULAR
.\" SON RENUNCIADAS. ENTODO CASO, LOS REGENTES O CONTRIBUIDORES ESTARAN OBLIGADOS
.\" DE FORMA DIRECTA, INDIRECTA, INCIDENTE, ESPECIAL, EJEMPLAR O CONCECUENCIAL
.\" PERJUICIO (INCLUYENDO, PERO NO LIMITADO A, PROCEDIMIENTOS DE BUENAS SUSTITUCIONES
.\" O SERVICIOS ; PERDIDA DE USO, DATOS O BENEFICIOS ; O INTERRUPCION EN LA OCUPACION)
.\" COMO SIEMPRE CAUSADO Y SOBRE CUALQUIER TEORIA DE OBLIGACION, SI EN EL CONTRATO, ESTRICTA
.\" OBLIGACION,O TORTURA (INCLUYENDO NEGLIGENCIA U OTROS)RESULTANDO DE CUALQUIER MANERA
.\" FUERA DEL USO DE ESTE SOFTWARE AUN SI ADVERTIDO DE LA POSIBILIDAD DE
.\" SEMEJANTE DAO.
.\"
.\" @(#)getsockname.2 6.4 (Berkeley) 3/10/91
.\"
.\" Modified Sat Jul 24 16:30:29 1993 by Rik Faith <faith@cs.unc.edu>
.\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified Sun Mar 28 21:26:46 1999 by Andries Brouwer <aeb@cwi.nl>
.\" Translation revised on Sun Apr 4 1999 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH GETSOCKNAME 2 "24 Julio 1993" "Pgina de Manual BSD" "Manual del Programador de Linux"
.SH NOMBRE
getsockname \- obtener nombre de conexin
.SH SINOPSIS
.B #include <sys/socket.h>
.sp
.B "int getsockname(int " s ", struct sockaddr *" name ", socklen_t *" namelen )
.SH DESCRIPCIN
.B Getsockname
devuelve el
.I nombre
actual para la conexin indicada. El parmetro
.I namelen
debe ser inicializado para indicar la cantidad de espacio apuntador por
.IR name .
La devolucin contiene el tamao actual del nombre devuelto (en bytes).
.SH "VALOR DEVUELTO"
Si es correcto, devuelve un cero. Si hay error, devuelve \-1, y se asigna a
.I errno
un valor apropiado.
.SH ERRORES
.TP 0.8i
.B EBADF
El argumento
.I s
no es un descriptor vlido.
.TP
.B ENOTSOCK
El argumento
.I s
es un fichero, no una conexin.
.TP
.B ENOBUFS
No haba suficientes recursos disponibles en el sistema para llevar a cabo
la operaicn.
.TP
.B EFAULT
El parametro
.I name
apunta a una memoria que no est dentro de una zona vlida del espacio de
direcciones del proceso.
.SH CONFORME A
SVr4, 4.4BSD (la funcion
.B getsockname
apareci en 4.2BSD). SVr4 documenta dos cdigos de error adicionales,
ENOMEM y ENOSR.
.SH NOTA
El tercer argumento de
.B getsockname
es en realidad un entero (y esto es lo que tienen BSD 4.*, libc4 y libc5).
Cierta confusin en POSIX dio como resultado el actual socklen_t.
El estndar propuesto todava no ha sido adoptado pero glibc2 ya lo sigue y
tambin tiene socklen_t. Vea tambin
.BR accept (2).
.SH "VASE TAMBIN"
.BR bind "(2), " socket (2)
|