---
layout: doc
title: master / valid_socket
---
# valid_socket

### NAME

    valid_socket - protects the socket efunctions.

### SYNOPSIS

    int valid_socket( object caller, string function,
                      mixed *info );

### DESCRIPTION

    Each  of the socket efunctions calls valid_socket() prior to executing.
    If valid_socket  returns  0,  then  the  socket  efunction  fails.   If
    valid_socket  returns 1, then the socket efunction attempts to succeed.
    The first argument 'caller' is the object that called the socket efunc‐
    tion.   The second argument is the name of the socket efunction that is
    being called (e.g. socket_write() or socket_bind()).  The  third  argu‐
    ment  is an array of information.  The first element of the array (when
    applicable) is file descriptor being referenced.  The second element of
    the  array  is  the owner of the socket (object).  The third element of
    the array is the address (string) of the remote end of the socket.  The
    fourth  element  of  the  array  is the port number associated with the
    socket.

