socket_get_option

(PHP 4 >= 4.3.0, PHP 5)

socket_get_option — Ottiene le opzioni per un socket

Descrizione

mixed socket_get_option ( resource $socket , int $level , int $optname )

Avviso

Questa funzione è SPERIMENTALE. Ovvero, il comportamento di questa funzione, il nome di questa funzione, in definitiva tutto ciò che è documentato qui può cambiare nei futuri rilasci del PHP senza preavviso. Siete avvisati, l'uso di questa funzione è a vostro rischio.

La funzione socket_get_option() restituisce i valori per il parametro indicato in optname per il socket indicato da socket. La funzione restituisce FALSE se non riesce.

Il parametro level specifica a quale livello di protocollo risiede l'opzione cercata. Ad esempio, per recuperare le informzioni su opzioni a livello di socket, il parametro level deve essere impostato a SOL_SOCKET. Altri livelli tipo TCP, possono essere utilizzati specificando il numero del livello. I numeri dei livelli dei protocolli possono essere ottenuti tramite getprotobyname().

**Opzioni per i socket disponibili**
Opzione	Descrizione
SO_DEBUG	Riporta informazioni per il debug.
SO_ACCEPTCONN	Indica se il socket è abilitato in ascolto.
SO_BROADCAST	Indica se sono supportate le trasmissioni dei messaggi di broadcast.
SO_REUSEADDR	Riporta se gli indirizzi locali possono essere riutilizzati.
SO_KEEPALIVE	Riporta se la connesisone deve essere mantenuta attiva tramite la trasmissione periodica di messaggi. Se il socket connesso non risponde a questi messaggi, la connessione viene interrotta ed i processi che stavano scrivendo in quel socket riceveranno il segnale SIGPIPE.
SO_LINGER	Indice se il `socket` debba ritardare il socket_close() se vi sono dati.
SO_OOBINLINE	Indica se il `socket` gestisce i dati fuori-banda.
SO_SNDBUF	Riporta le dimensioni del buffer di trasmissione.
SO_RCVBUF	Riporta le dimensioni del buffer di ricezione.
SO_ERROR	Restituisce informaizoni sugli stati di errore e li ripulisce.
SO_TYPE	Restituisce il tipo di`socket`.
SO_DONTROUTE	Indica se i messaggi in uscita ignorano i parametri standard di routing.
SO_RCVLOWAT	Indica il numero minimo di byte da processare da parte del `socket` per le operazioni di input (default 1).
SO_RCVTIMEO	Tempo di timeout per le operazioni di input.
SO_SNDLOWAT	Riporta il numero minimo di byte da processare da parte del `socket` per le operazioni di output.
SO_SNDTIMEO	Indica il tempo di timeout specificando il tempo che una funzione di output resti bloccata in attesa di potere inviare i dati.

Nota:
Nelle versioni di PHP antecedenti la 4.3.0, questa funzione era chiamata socket_getopt().

add a note User Contributed Notes socket_get_option - [2 notes]

down

Chad Lavoie ¶

2 years ago


If using Unix Sockets, and you want to use SO_PEERCRED, you can use the number 17 for the optname (and SOL_SOCKET for the level).  The PID of the connecting process will be returned.

down

recycling dot sp dot am at gmail dot com ¶

2 years ago


Just 2 notes here:

- On UNIX, If SO_DEBUG is set, the php program needs an effective user id of 0.

-  activating SO_OOBINLINE on a socket is equivalent to passing MSG_OOB flag to each recieving functions used with that socket (eg: socket_recv, socket_recvfrom).

add a note