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)

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

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