File: getsockname.2

package info (click to toggle)
manpages-es 1.24a-6
  • links: PTS
  • area: main
  • in suites: potato
  • size: 4,256 kB
  • ctags: 7
  • sloc: makefile: 66; sh: 62
file content (94 lines) | stat: -rw-r--r-- 3,891 bytes parent folder | download
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)