socket_get_option

Manuale PHP
Indietro		Avanti

Descrizione

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

Avvertimento

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().

Tabella 1. 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().

Indietro	Partenza	Avanti
socket_create	Risali	socket_getpeername