02_Reverse-lookup-support.diff
[paraslash.git] / net.h
1 /*
2 * Copyright (C) 2006-2007 Andre Noll <maan@systemlinux.org>
3 *
4 * Licensed under the GPL v2. For licencing details see COPYING.
5 */
6
7 /** \file net.h exported symbols from net.c */
8
9 /**
10 * the buffer size of the sun_path component of struct sockaddr_un
11 *
12 * While glibc doesn't define \p UNIX_PATH_MAX, it
13 * documents it has being limited to 108 bytes.
14 */
15 #ifndef UNIX_PATH_MAX
16 #define UNIX_PATH_MAX 108
17 #endif
18
19 /** \cond Userland defines for Linux DCCP support. */
20 #ifndef IPPROTO_DCCP
21 #define IPPROTO_DCCP 33 /**< IANA assigned value */
22 #define SOCK_DCCP 6 /**< Linux socket type */
23 #define SOL_DCCP 269 /**< Linux socket level */
24 #endif
25 /** \endcond */
26
27 /**
28 * Generic socket creation (passive and active sockets).
29 */
30 extern int makesock(unsigned l3type, unsigned l4type, int passive,
31 const char *host, unsigned short port_number);
32
33 /**
34 * Functions to support listening sockets.
35 */
36 /** How many pending connections queue of a listening server will hold. */
37 #define BACKLOG 10
38 extern int para_listen(unsigned l3type, unsigned l4type, unsigned short port);
39
40 /** Pretty-printing of IPv4/6 socket addresses */
41 extern char *host_and_port(struct sockaddr *sa, socklen_t len);
42 extern char *local_name(int sockfd);
43 extern char *remote_name(int sockfd);
44
45 /** used to crypt the communication between para_server and para_client */
46 typedef void crypt_function(unsigned long len,
47 const unsigned char *indata, unsigned char *outdata, void *private_data);
48
49 int tcp_connect(char *host, int port);
50 int get_stream_socket(int domain);
51 int send_buffer(int, const char *);
52 int send_bin_buffer(int, const char *, size_t);
53 __printf_2_3 int send_va_buffer(int fd, const char *fmt, ...);
54 int recv_buffer(int fd, char *buf, size_t size);
55 int recv_bin_buffer(int fd, char *buf, size_t size);
56 int para_accept(int, void *addr, socklen_t size);
57 int create_local_socket(const char *name, struct sockaddr_un *unix_addr,
58 mode_t mode);
59 int init_unix_addr(struct sockaddr_un *, const char *);
60 int recv_cred_buffer(int, char *, size_t);
61 ssize_t send_cred_buffer(int, char*);
62 int recv_pattern(int fd, const char *pattern, size_t bufsize);
63 int tcp_listen(int port);
64 void enable_crypt(int fd, crypt_function *recv_f, crypt_function *send_f,
65 void *private_data);
66 void disable_crypt(int fd);
67
68 /**
69 * A wrapper around connect(2).
70 *
71 * \param fd The file descriptor.
72 * \param addr The address to connect.
73 * \param len The size of \a addr.
74 *
75 * This should not be called directly. Always use the PARA_CONNECT macro.
76 *
77 * \return \p -E_CONNECT on errors, 1 on success.
78 *
79 * \sa connect(2), PARA_CONNECT.
80 */
81 static inline int _para_connect(int fd, void *addr, socklen_t len)
82 {
83 if (connect(fd, (struct sockaddr *)addr, len) == -1)
84 return -E_CONNECT;
85 return 1;
86 }
87
88 /** A macro for connect() which does not need a \a len parameter. */
89 #define PARA_CONNECT(fd, addr) _para_connect(fd, addr, sizeof(*(addr)))