X-Git-Url: http://git.tuebingen.mpg.de/?a=blobdiff_plain;f=net.c;h=cffd250e182d36e94a1ffe06db9f96abcabe3100;hb=025bd85e6a7c4618b4741762982b37df35eb7725;hp=046cf0b76f63ca57129e0b3a699b5a0bb43ae651;hpb=a05a33be9ed15982aabfa13726317a1fcb13cc19;p=paraslash.git diff --git a/net.c b/net.c index 046cf0b7..cffd250e 100644 --- a/net.c +++ b/net.c @@ -4,7 +4,9 @@ * Licensed under the GPL v2. For licencing details see COPYING. */ -/** \file net.c networking-related helper functions */ +/** \file net.c Networking-related helper functions. */ + +#include /* hostent */ #include "para.h" #include "error.h" @@ -30,12 +32,12 @@ static struct crypt_data *crypt_data_array; static unsigned cda_size = 0; /** - * activate encryption for one file descriptor + * Activate encryption for one file descriptor. * - * \param fd the file descriptor - * \param recv_f the function used for decrypting received data - * \param send_f the function used for encrypting before sending - * \param private_data user data supplied by the caller + * \param fd The file descriptor. + * \param recv_f The function used for decrypting received data. + * \param send_f The function used for encrypting before sending. + * \param private_data User data supplied by the caller. */ void enable_crypt(int fd, crypt_function *recv_f, crypt_function *send_f, void *private_data) @@ -54,9 +56,9 @@ void enable_crypt(int fd, crypt_function *recv_f, crypt_function *send_f, } /** - * deactivate encryption for a given fd + * Deactivate encryption for a given fd. * - * \param fd the file descriptor + * \param fd The file descriptor. * * This must be called if and only if \p fd was activated via enable_crypt(). */ @@ -71,16 +73,16 @@ void disable_crypt(int fd) /** - * initialize a struct sockaddr_in + * Initialize a struct sockaddr_in. * - * \param addr A pointer to the struct to be initialized - * \param port The port number to use - * \param he The address to use + * \param addr A pointer to the struct to be initialized. + * \param port The port number to use. + * \param he The address to use. * * If \a he is null (server mode), \a addr->sin_addr is initialized with \p * INADDR_ANY. Otherwise, the address given by \a he is copied to addr. */ -void init_sockaddr(struct sockaddr_in *addr, int port, const struct hostent *he) +static void init_sockaddr(struct sockaddr_in *addr, int port, const struct hostent *he) { /* host byte order */ addr->sin_family = AF_INET; @@ -95,36 +97,28 @@ void init_sockaddr(struct sockaddr_in *addr, int port, const struct hostent *he) } /* - * send out a buffer, resend on short writes + * Send out a buffer, resend on short writes. * - * \param fd the file descriptor - * \param buf The buffer to be sent - * \param len The length of \a buf - * - * Due to circumstances beyond your control, the kernel might not send all the - * data out in one chunk, and now, my friend, it's up to us to get the data out - * there (Beej's Guide to Network Programming). + * \param fd The file descriptor. + * \param buf The buffer to be sent. + * \param len The length of \a buf. * - * \return This function returns 1 on success and \a -E_SEND on errors. The - * number of bytes actually sent is stored upon successful return in \a len. + * \return Standard. In any case, the number of bytes actually sent is stored + * in \a len. */ static int sendall(int fd, const char *buf, size_t *len) { - size_t total = 0, bytesleft = *len; /* how many we have left to send */ - int n = -1; - - while (total < *len) { - n = send(fd, buf + total, bytesleft, 0); - if (n == -1) - break; - total += n; - bytesleft -= n; - if (total < *len) - PARA_DEBUG_LOG("short write (%zd byte(s) left)", - *len - total); + size_t total = *len; + + assert(total); + *len = 0; + while (*len < total) { + int ret = send(fd, buf + *len, total - *len, 0); + if (ret == -1) + return -ERRNO_TO_PARA_ERROR(errno); + *len += ret; } - *len = total; /* return number actually sent here */ - return n == -1? -E_SEND : 1; /* return 1 on success */ + return 1; } /** @@ -138,7 +132,7 @@ static int sendall(int fd, const char *buf, size_t *len) * out the buffer, encrypted or not, and try to resend the remaing part in case * of short writes. * - * \return Positive on success, \p -E_SEND on errors. + * \return Standard. */ int send_bin_buffer(int fd, const char *buf, size_t len) { @@ -162,14 +156,14 @@ int send_bin_buffer(int fd, const char *buf, size_t len) } /** - * encrypt and send null terminated buffer. + * Encrypt and send null terminated buffer. * - * \param fd the file descriptor - * \param buf the null-terminated buffer to be send + * \param fd The file descriptor. + * \param buf The null-terminated buffer to be send. * * This is equivalent to send_bin_buffer(fd, buf, strlen(buf)). * - * \return Positive on success, \p -E_SEND on errors. + * \return Standard. */ int send_buffer(int fd, const char *buf) { @@ -178,12 +172,12 @@ int send_buffer(int fd, const char *buf) /** - * send and encrypt a buffer given by a format string + * Send and encrypt a buffer given by a format string. * - * \param fd the file descriptor - * \param fmt a format string + * \param fd The file descriptor. + * \param fmt A format string. * - * \return Positive on success, \p -E_SEND on errors. + * \return Standard. */ __printf_2_3 int send_va_buffer(int fd, const char *fmt, ...) { @@ -197,18 +191,16 @@ __printf_2_3 int send_va_buffer(int fd, const char *fmt, ...) } /** - * receive and decrypt. + * Receive and decrypt. * - * \param fd the file descriptor - * \param buf the buffer to write the decrypted data to - * \param size the size of \a buf + * \param fd The file descriptor. + * \param buf The buffer to write the decrypted data to. + * \param size The size of \a buf. * - * Receive at most \a size bytes from filedescriptor fd. If encryption is + * Receive at most \a size bytes from file descriptor \a fd. If encryption is * available, decrypt the received buffer. * - * \return The number of bytes received on success. On receive errors, -E_RECV - * is returned. On crypt errors, the corresponding crypt error number is - * returned. + * \return The number of bytes received on success, negative on errors. * * \sa recv(2) */ @@ -232,21 +224,21 @@ __must_check int recv_bin_buffer(int fd, char *buf, size_t size) } else n = recv(fd, buf, size, 0); if (n == -1) - n = -E_RECV; + return -ERRNO_TO_PARA_ERROR(errno); return n; } /** - * receive, decrypt and write terminating NULL byte + * Receive, decrypt and write terminating NULL byte. * - * \param fd the file descriptor - * \param buf the buffer to write the decrypted data to - * \param size the size of \a buf + * \param fd The file descriptor. + * \param buf The buffer to write the decrypted data to. + * \param size The size of \a buf. * * Read and decrypt at most \a size - 1 bytes from file descriptor \a fd and * write a NULL byte at the end of the received data. * - * \return: The return value of the underlying call to \a recv_bin_buffer(). + * \return The return value of the underlying call to \a recv_bin_buffer(). * * \sa recv_bin_buffer() */ @@ -254,8 +246,7 @@ int recv_buffer(int fd, char *buf, size_t size) { int n; - if (!size) - return -E_RECV; + assert(size); n = recv_bin_buffer(fd, buf, size - 1); if (n >= 0) buf[n] = '\0'; @@ -265,22 +256,34 @@ int recv_buffer(int fd, char *buf, size_t size) } /** - * wrapper around gethostbyname - * - * \param host hostname or IPv4 address - * \param ret the hostent structure is returned here + * Establish a tcp connection. * - * \return positive on success, negative on errors. On success, \a ret - * contains the return value of the underlying gethostbyname() call. + * \param host Hostname or IPv4 address. + * \param port The tcp port. * - * \sa gethostbyname(2) + * \return Negative on errors, a valid file descriptor on success. */ -int get_host_info(char *host, struct hostent **ret) +int tcp_connect(char *host, int port) { + struct sockaddr_in addr; + struct hostent *he; + int ret, fd; + PARA_INFO_LOG("getting host info of %s\n", host); /* FIXME: gethostbyname() is obsolete */ - *ret = gethostbyname(host); - return *ret? 1 : -E_HOST_INFO; + he = gethostbyname(host); + if (!he) + return -ERRNO_TO_PARA_ERROR(h_errno); + init_sockaddr(&addr, port, he); + ret = get_stream_socket(AF_INET); + if (ret < 0) + return ret; + fd = ret; + ret = PARA_CONNECT(fd, &addr); + if (ret >= 0) + return fd; + close(fd); + return ret; } /** @@ -288,32 +291,32 @@ int get_host_info(char *host, struct hostent **ret) * * \param domain The communication domain that selects the protocol family. * - * \return The socket fd on success, -E_SOCKET on errors. - * * Create an IPv4 socket for sequenced, reliable, two-way, connection-based * byte streams. * + * \return The socket fd on success, negative on errors. + * * \sa socket(2). */ int get_stream_socket(int domain) { - int socket_fd; + int fd = socket(domain, SOCK_STREAM, 0); - if ((socket_fd = socket(domain, SOCK_STREAM, 0)) == -1) - return -E_SOCKET; - return socket_fd; + if (fd < 0) + return -ERRNO_TO_PARA_ERROR(errno); + return fd; } /** - * paraslash's wrapper around the accept system call + * Wrapper around the accept system call. * - * \param fd the listening socket - * \param addr structure which is filled in with the address of the peer socket - * \param size should contain the size of the structure pointed to by \a addr + * \param fd The listening socket. + * \param addr Structure which is filled in with the address of the peer socket. + * \param size Should contain the size of the structure pointed to by \a addr. * * Accept incoming connections on \a addr. Retry if interrupted. * - * \return The new file descriptor on success, \a -E_ACCEPT on errors. + * \return The new file descriptor on success, negative on errors. * * \sa accept(2). */ @@ -324,17 +327,7 @@ int para_accept(int fd, void *addr, socklen_t size) do new_fd = accept(fd, (struct sockaddr *) addr, &size); while (new_fd < 0 && errno == EINTR); - return new_fd < 0? -E_ACCEPT : new_fd; -} - -static int setserversockopts(int socket_fd) -{ - int yes = 1; - - if (setsockopt(socket_fd, SOL_SOCKET, SO_REUSEADDR, &yes, - sizeof(int)) == -1) - return -E_SETSOCKOPT; - return 1; + return new_fd < 0? -ERRNO_TO_PARA_ERROR(errno) : new_fd; } /** @@ -382,12 +375,15 @@ int create_local_socket(const char *name, struct sockaddr_un *unix_addr, ret = init_unix_addr(unix_addr, name); if (ret < 0) return ret; - fd = socket(PF_UNIX, SOCK_STREAM, 0); - if (fd < 0) - return -E_SOCKET; - ret = -E_BIND; - if (bind(fd, (struct sockaddr *) unix_addr, UNIX_PATH_MAX) < 0) + ret = socket(PF_UNIX, SOCK_STREAM, 0); + if (ret < 0) + return -ERRNO_TO_PARA_ERROR(errno); + fd = ret; + ret = bind(fd, (struct sockaddr *) unix_addr, UNIX_PATH_MAX); + if (ret < 0) { + ret = -ERRNO_TO_PARA_ERROR(errno); goto err; + } ret = -E_CHMOD; if (chmod(name, mode) < 0) goto err; @@ -414,7 +410,7 @@ int recv_cred_buffer(int fd, char *buf, size_t size) * \param buf the buffer to be sent * * \return On success, this call returns the number of characters sent. On - * error, \p -E_SENDMSG ist returned. + * error, \p -E_SENDMSG is returned. * * \sa okir's Black Hats Manual * \sa sendmsg(2) @@ -518,19 +514,18 @@ int recv_cred_buffer(int fd, char *buf, size_t size) #define BACKLOG 10 /** - * create a socket, bind it and listen + * Create a tcp socket, bind it and listen on the given port. * - * \param port the tcp port to listen on + * \param port The tcp port to listen on. * - * \return The file descriptor of the created socket, negative - * on errors. + * \return The file descriptor of the created socket, negative on errors. * * \sa get_stream_socket() * \sa setsockopt(2) * \sa bind(2) * \sa listen(2) */ -int init_tcp_socket(int port) +int tcp_listen(int port) { struct sockaddr_in my_addr; int fd, ret = get_stream_socket(AF_INET); @@ -538,19 +533,23 @@ int init_tcp_socket(int port) if (ret < 0) return ret; fd = ret; - ret = setserversockopts(fd); - if (ret < 0) + ret = 1; + ret = setsockopt(fd, SOL_SOCKET, SO_REUSEADDR, &ret, sizeof(int)); + if (ret < 0) { + ret = -ERRNO_TO_PARA_ERROR(errno); goto err; + } init_sockaddr(&my_addr, port, NULL); - ret = -E_BIND; - if (bind(fd, (struct sockaddr *)&my_addr, - sizeof(struct sockaddr)) == -1) { - PARA_CRIT_LOG("bind error: %s\n", strerror(errno)); + ret = bind(fd, (struct sockaddr *)&my_addr, sizeof(struct sockaddr)); + if (ret < 0) { + ret = -ERRNO_TO_PARA_ERROR(errno); goto err; } - ret = -E_LISTEN; - if (listen(fd, BACKLOG) == -1) + ret = listen(fd, BACKLOG); + if (ret < 0) { + ret = -ERRNO_TO_PARA_ERROR(errno); goto err; + } PARA_INFO_LOG("listening on port %d, fd %d\n", port, fd); return fd; err: