(PHP4 >= 4.0.2)

strerror -- Return a string describing a socket error


string strerror (int errno)

strerror() takes as its errno parameter the return value of one of the socket functions, and returns the corresponding explanatory text. This makes it a bit more pleasant to figure out why something didn't work; for instance, instead of having to track down a system include file to find out what '-111' means, you just pass it to strerror(), and it tells you what happened.

Example 1. strerror() example

if (($socket = socket (AF_INET, SOCK_STREAM, 0)) < 0) {
   echo "socket() failed: reason: " . strerror ($socket) . "\n";

if (($ret = bind ($socket, '', 80)) < 0) {
   echo "bind() failed: reason: " . strerror ($ret) . "\n";

The expected output from the above example (assuming the script is not run with root privileges):

        bind() failed: reason: Permission denied

See also accept_connect(), bind(), connect(), listen(), socket(), and socket_get_status().