socket_getpeername
Interroge l'autre extrémité de la communication
&reftitle.description;
boolsocket_getpeername
Socketsocket
stringaddress
intport&null;
Interroge l'autre extrémité de la communication.
&reftitle.parameters;
socket
Une instance de Socket créée par
socket_create ou socket_accept.
address
Si le socket socket est de type
AF_INET, ou AF_INET6
socket_getpeername retournera
l'adresse IP de l'hôte, en notation numérique (e.g.
127.0.0.1 ou fe80::1) dans le
paramètre address, et si le paramètre optionnel
port est présent, elle retournera aussi le port
de la communication établie.
Si le socket socket est de type AF_UNIX,
socket_getpeername retournera le chemin sur le
système de fichiers (e.g. /var/run/daemon.sock) dans le
paramètre address.
port
Si fourni, ce devra être le port associé à l'adresse
du paramètre address.
&reftitle.returnvalues;
&return.success; socket_getpeername peut aussi
retourner &false; si le type de le socket n'est ni AF_INET
AF_INET6, ni AF_UNIX, auquel cas le
dernier code d'erreur socket n'est pas modifié.
&reftitle.changelog;
&Version;
&Description;
&sockets.changelog.socket-param;
&reftitle.notes;
socket_getsockname ne doit pas être utilisée avec les sockets
AF_UNIX créés avec socket_accept.
Seules les sockets créées avec socket_connect ou une socket
serveur primaire suivant un appel à socket_bind retourneront
des valeurs logiques.
Pour faire en sorte que la fonction
socket_getpeername retourne une
valeur cohérente, le socket sur lequel la fonction est
appelée doit évidemment être un pour qui le conscepte
de "peer" a du sens.
&reftitle.seealso;
socket_getsockname
socket_last_error
socket_strerror