/*++ /* NAME /* timed_connect 3 /* SUMMARY /* connect operation with timeout /* SYNOPSIS /* #include <sys/socket.h> /* #include <timed_connect.h> /* /* int timed_connect(fd, buf, buf_len, timeout) /* int fd; /* struct sockaddr *buf; /* int buf_len; /* int timeout; /* DESCRIPTION /* timed_connect() implement a BSD socket connect() operation that is /* bounded in time. /* /* Arguments: /* .IP fd /* File descriptor in the range 0..FD_SETSIZE. This descriptor /* must be set to non-blocking mode prior to calling timed_connect(). /* .IP buf /* Socket address buffer pointer. /* .IP buf_len /* Size of socket address buffer. /* .IP timeout /* The deadline in seconds. This must be a number > 0. /* DIAGNOSTICS /* Panic: interface violations. /* When the operation does not complete within the deadline, the /* result value is -1, and errno is set to ETIMEDOUT. /* All other returns are identical to those of a blocking connect(2) /* operation. /* WARNINGS /* .ad /* .fi /* A common error is to call timed_connect() without enabling /* non-blocking I/O on the socket. In that case, the \fItimeout\fR /* parameter takes no effect. /* LICENSE /* .ad /* .fi /* The Secure Mailer license must be distributed with this software. /* AUTHOR(S) /* Wietse Venema /* IBM T.J. Watson Research /* P.O. Box 704 /* Yorktown Heights, NY 10598, USA /*--*/ /* System library. */ #include <sys_defs.h> #include <sys/socket.h> #include <errno.h> /* Utility library. */ #include "msg.h" #include "iostuff.h" #include "sane_connect.h" #include "timed_connect.h" /* timed_connect - connect with deadline */ int timed_connect(int sock, struct sockaddr * sa, int len, int timeout) { int error; SOCKOPT_SIZE error_len; /* * Sanity check. Just like with timed_wait(), the timeout must be a * positive number. */ if (timeout <= 0) msg_panic("timed_connect: bad timeout: %d", timeout); /* * Start the connection, and handle all possible results. */ if (sane_connect(sock, sa, len) == 0) return (0); if (errno != EINPROGRESS) return (-1); /* * A connection is in progress. Wait for a limited amount of time for * something to happen. If nothing happens, report an error. */ if (write_wait(sock, timeout) < 0) return (-1); /* * Something happened. Some Solaris 2 versions have getsockopt() itself * return the error, instead of returning it via the parameter list. */ error = 0; error_len = sizeof(error); if (getsockopt(sock, SOL_SOCKET, SO_ERROR, (char *) &error, &error_len) < 0) return (-1); if (error) { errno = error; return (-1); } /* * No problems. */ return (0); }