Description
bool
socket_listen
( resource socket [, int backlog])
Avertissement
|
Cette
fonction
est
EXPERIMENTALE
.
Cela
signifie
que
le
comportement
de
cette
fonction
,
son
nom
et
concrètement
,
TOUT
ce
qui
est
documenté
ici
peut
changer
dans
un
futur
proche
,
SANS
PREAVIS
!
Soyez-en
conscient
,
et
utilisez
cette
fonction
à
vos
risques
et
périls
.
|
Une
fois
que
la
socket
socket
a
été
créée
avec
la
focntion
socket_create(
)
et
liée
à
un
nom
avec
la
fonction
socket_bind(
)
,
elle
peut
être
mise
en
attente
de
connexion
entrantes
.
Un
nombre
maximum
de
backlog
connexions
seront
mises
en
attente
de
traitement
.
Si
une
demande
de
connexion
arrive
et
que
la
queue
est
pleine
,
le
client
recevra
une
erreur
indiquant
ECONNREFUSED
,
ou
,
si
le
protocole
de
support
accepte
les
retransmissions
,
la
requête
sera
ignorée
pour
que
les
tentatives
ultérieures
finissent
par
réussir
.
Le
nombre
maximum
passé
dans
le
paramètre
backlog
Le
nombre
maximum
passé
dans
le
paramètre
backlog
dépend
essentiellement
de
la
plate
forme
de
support
.
Sur
Linux
,
c
'
est
tronqué
automatiquement
à
SOMAXCONN
.
Sous
Windows32
,
si
la
constante
SOMAXCONN
est
passée
,
le
service
responsable
des
sockets
choisira
une
valeur
maximum
raisonnable
.
Il
n
'
y
a
pas
de
méthode
pour
deviner
la
valeur
réellement
choisie
.
socket_listen(
)
ne
fonctionne
qu
'avec
des
sockets
de
type
SOCK_STREAM
et
SOCK_SEQPACKET
.
Cette
fonction
retourne
TRUE
en
cas
de
succès
,
FALSE
en
cas
d
'
échec
.
Le
code
d'
erreur
généré
peut
être
obtenu
en
appelant
la
fonction
socket_last_error(
)
.
Ce
code
d'
erreur
peut
être
passé
à
la
fonction
socket_strerror(
)
pour
obtenir
un
message
d
'erreur
,
humainement
lisible
.
Voir
aussi
socket_accept(
)
,
socket_bind(
)
,
socket_connect(
)
,
socket_create(
)
et
socket_strerror(
)
.