]> bbs.cooldavid.org Git - net-next-2.6.git/blame - include/linux/net.h
[BRIDGE]: Annotations.
[net-next-2.6.git] / include / linux / net.h
CommitLineData
1da177e4
LT
1/*
2 * NET An implementation of the SOCKET network access protocol.
3 * This is the master header file for the Linux NET layer,
4 * or, in plain English: the networking handling part of the
5 * kernel.
6 *
7 * Version: @(#)net.h 1.0.3 05/25/93
8 *
9 * Authors: Orest Zborowski, <obz@Kodak.COM>
02c30a84 10 * Ross Biro
1da177e4
LT
11 * Fred N. van Kempen, <waltje@uWalt.NL.Mugnet.ORG>
12 *
13 * This program is free software; you can redistribute it and/or
14 * modify it under the terms of the GNU General Public License
15 * as published by the Free Software Foundation; either version
16 * 2 of the License, or (at your option) any later version.
17 */
18#ifndef _LINUX_NET_H
19#define _LINUX_NET_H
20
1da177e4 21#include <linux/wait.h>
aaa248f6 22#include <linux/random.h>
1da177e4
LT
23#include <asm/socket.h>
24
25struct poll_table_struct;
26struct inode;
27
28#define NPROTO 32 /* should be enough for now.. */
29
30#define SYS_SOCKET 1 /* sys_socket(2) */
31#define SYS_BIND 2 /* sys_bind(2) */
32#define SYS_CONNECT 3 /* sys_connect(2) */
33#define SYS_LISTEN 4 /* sys_listen(2) */
34#define SYS_ACCEPT 5 /* sys_accept(2) */
35#define SYS_GETSOCKNAME 6 /* sys_getsockname(2) */
36#define SYS_GETPEERNAME 7 /* sys_getpeername(2) */
37#define SYS_SOCKETPAIR 8 /* sys_socketpair(2) */
38#define SYS_SEND 9 /* sys_send(2) */
39#define SYS_RECV 10 /* sys_recv(2) */
40#define SYS_SENDTO 11 /* sys_sendto(2) */
41#define SYS_RECVFROM 12 /* sys_recvfrom(2) */
42#define SYS_SHUTDOWN 13 /* sys_shutdown(2) */
43#define SYS_SETSOCKOPT 14 /* sys_setsockopt(2) */
44#define SYS_GETSOCKOPT 15 /* sys_getsockopt(2) */
45#define SYS_SENDMSG 16 /* sys_sendmsg(2) */
46#define SYS_RECVMSG 17 /* sys_recvmsg(2) */
47
48typedef enum {
49 SS_FREE = 0, /* not allocated */
50 SS_UNCONNECTED, /* unconnected to any socket */
51 SS_CONNECTING, /* in process of connecting */
52 SS_CONNECTED, /* connected to socket */
53 SS_DISCONNECTING /* in process of disconnecting */
54} socket_state;
55
56#define __SO_ACCEPTCON (1 << 16) /* performed a listen */
57
58#ifdef __KERNEL__
eacf17bd 59#include <linux/stringify.h>
1da177e4
LT
60
61#define SOCK_ASYNC_NOSPACE 0
62#define SOCK_ASYNC_WAITDATA 1
63#define SOCK_NOSPACE 2
64#define SOCK_PASSCRED 3
877ce7c1 65#define SOCK_PASSSEC 4
1da177e4
LT
66
67#ifndef ARCH_HAS_SOCKET_TYPES
4dc3b16b
PP
68/**
69 * enum sock_type - Socket types
70 * @SOCK_STREAM: stream (connection) socket
71 * @SOCK_DGRAM: datagram (conn.less) socket
72 * @SOCK_RAW: raw socket
73 * @SOCK_RDM: reliably-delivered message
74 * @SOCK_SEQPACKET: sequential packet socket
8f2709b5 75 * @SOCK_DCCP: Datagram Congestion Control Protocol socket
4dc3b16b
PP
76 * @SOCK_PACKET: linux specific way of getting packets at the dev level.
77 * For writing rarp and other similar things on the user level.
78 *
1da177e4
LT
79 * When adding some new socket type please
80 * grep ARCH_HAS_SOCKET_TYPE include/asm-* /socket.h, at least MIPS
81 * overrides this enum for binary compat reasons.
1da177e4
LT
82 */
83enum sock_type {
84 SOCK_STREAM = 1,
85 SOCK_DGRAM = 2,
86 SOCK_RAW = 3,
87 SOCK_RDM = 4,
88 SOCK_SEQPACKET = 5,
7c657876 89 SOCK_DCCP = 6,
1da177e4
LT
90 SOCK_PACKET = 10,
91};
92
93#define SOCK_MAX (SOCK_PACKET + 1)
94
95#endif /* ARCH_HAS_SOCKET_TYPES */
96
97/**
98 * struct socket - general BSD socket
4dc3b16b
PP
99 * @state: socket state (%SS_CONNECTED, etc)
100 * @flags: socket flags (%SOCK_ASYNC_NOSPACE, etc)
101 * @ops: protocol specific socket operations
102 * @fasync_list: Asynchronous wake up list
103 * @file: File back pointer for gc
104 * @sk: internal networking protocol agnostic socket representation
105 * @wait: wait queue for several uses
106 * @type: socket type (%SOCK_STREAM, etc)
1da177e4
LT
107 */
108struct socket {
109 socket_state state;
110 unsigned long flags;
90ddc4f0 111 const struct proto_ops *ops;
1da177e4
LT
112 struct fasync_struct *fasync_list;
113 struct file *file;
114 struct sock *sk;
115 wait_queue_head_t wait;
116 short type;
117};
118
119struct vm_area_struct;
120struct page;
121struct kiocb;
122struct sockaddr;
123struct msghdr;
124struct module;
125
126struct proto_ops {
127 int family;
128 struct module *owner;
129 int (*release) (struct socket *sock);
130 int (*bind) (struct socket *sock,
131 struct sockaddr *myaddr,
132 int sockaddr_len);
133 int (*connect) (struct socket *sock,
134 struct sockaddr *vaddr,
135 int sockaddr_len, int flags);
136 int (*socketpair)(struct socket *sock1,
137 struct socket *sock2);
138 int (*accept) (struct socket *sock,
139 struct socket *newsock, int flags);
140 int (*getname) (struct socket *sock,
141 struct sockaddr *addr,
142 int *sockaddr_len, int peer);
143 unsigned int (*poll) (struct file *file, struct socket *sock,
144 struct poll_table_struct *wait);
145 int (*ioctl) (struct socket *sock, unsigned int cmd,
146 unsigned long arg);
89bbfc95
SP
147 int (*compat_ioctl) (struct socket *sock, unsigned int cmd,
148 unsigned long arg);
1da177e4
LT
149 int (*listen) (struct socket *sock, int len);
150 int (*shutdown) (struct socket *sock, int flags);
151 int (*setsockopt)(struct socket *sock, int level,
152 int optname, char __user *optval, int optlen);
153 int (*getsockopt)(struct socket *sock, int level,
154 int optname, char __user *optval, int __user *optlen);
3fdadf7d
DM
155 int (*compat_setsockopt)(struct socket *sock, int level,
156 int optname, char __user *optval, int optlen);
157 int (*compat_getsockopt)(struct socket *sock, int level,
158 int optname, char __user *optval, int __user *optlen);
1da177e4
LT
159 int (*sendmsg) (struct kiocb *iocb, struct socket *sock,
160 struct msghdr *m, size_t total_len);
161 int (*recvmsg) (struct kiocb *iocb, struct socket *sock,
162 struct msghdr *m, size_t total_len,
163 int flags);
164 int (*mmap) (struct file *file, struct socket *sock,
165 struct vm_area_struct * vma);
166 ssize_t (*sendpage) (struct socket *sock, struct page *page,
167 int offset, size_t size, int flags);
168};
169
170struct net_proto_family {
171 int family;
172 int (*create)(struct socket *sock, int protocol);
1da177e4
LT
173 struct module *owner;
174};
175
176struct iovec;
177struct kvec;
178
179extern int sock_wake_async(struct socket *sk, int how, int band);
f0fd27d4
SH
180extern int sock_register(const struct net_proto_family *fam);
181extern void sock_unregister(int family);
1da177e4
LT
182extern int sock_create(int family, int type, int proto,
183 struct socket **res);
184extern int sock_create_kern(int family, int type, int proto,
185 struct socket **res);
186extern int sock_create_lite(int family, int type, int proto,
187 struct socket **res);
188extern void sock_release(struct socket *sock);
189extern int sock_sendmsg(struct socket *sock, struct msghdr *msg,
190 size_t len);
191extern int sock_recvmsg(struct socket *sock, struct msghdr *msg,
192 size_t size, int flags);
193extern int sock_map_fd(struct socket *sock);
194extern struct socket *sockfd_lookup(int fd, int *err);
195#define sockfd_put(sock) fput(sock->file)
196extern int net_ratelimit(void);
aaa248f6
SH
197
198#define net_random() random32()
199#define net_srandom(seed) srandom32(seed)
1da177e4
LT
200
201extern int kernel_sendmsg(struct socket *sock, struct msghdr *msg,
202 struct kvec *vec, size_t num, size_t len);
203extern int kernel_recvmsg(struct socket *sock, struct msghdr *msg,
204 struct kvec *vec, size_t num,
205 size_t len, int flags);
206
ac5a488e
SS
207extern int kernel_bind(struct socket *sock, struct sockaddr *addr,
208 int addrlen);
209extern int kernel_listen(struct socket *sock, int backlog);
210extern int kernel_accept(struct socket *sock, struct socket **newsock,
211 int flags);
212extern int kernel_connect(struct socket *sock, struct sockaddr *addr,
213 int addrlen, int flags);
214extern int kernel_getsockname(struct socket *sock, struct sockaddr *addr,
215 int *addrlen);
216extern int kernel_getpeername(struct socket *sock, struct sockaddr *addr,
217 int *addrlen);
218extern int kernel_getsockopt(struct socket *sock, int level, int optname,
219 char *optval, int *optlen);
220extern int kernel_setsockopt(struct socket *sock, int level, int optname,
221 char *optval, int optlen);
222extern int kernel_sendpage(struct socket *sock, struct page *page, int offset,
223 size_t size, int flags);
224extern int kernel_sock_ioctl(struct socket *sock, int cmd, unsigned long arg);
225
1da177e4
LT
226#ifndef CONFIG_SMP
227#define SOCKOPS_WRAPPED(name) name
228#define SOCKOPS_WRAP(name, fam)
229#else
230
231#define SOCKOPS_WRAPPED(name) __unlocked_##name
232
233#define SOCKCALL_WRAP(name, call, parms, args) \
234static int __lock_##name##_##call parms \
235{ \
236 int ret; \
237 lock_kernel(); \
238 ret = __unlocked_##name##_ops.call args ;\
239 unlock_kernel(); \
240 return ret; \
241}
242
243#define SOCKCALL_UWRAP(name, call, parms, args) \
244static unsigned int __lock_##name##_##call parms \
245{ \
246 int ret; \
247 lock_kernel(); \
248 ret = __unlocked_##name##_ops.call args ;\
249 unlock_kernel(); \
250 return ret; \
251}
252
253
254#define SOCKOPS_WRAP(name, fam) \
255SOCKCALL_WRAP(name, release, (struct socket *sock), (sock)) \
256SOCKCALL_WRAP(name, bind, (struct socket *sock, struct sockaddr *uaddr, int addr_len), \
257 (sock, uaddr, addr_len)) \
258SOCKCALL_WRAP(name, connect, (struct socket *sock, struct sockaddr * uaddr, \
259 int addr_len, int flags), \
260 (sock, uaddr, addr_len, flags)) \
261SOCKCALL_WRAP(name, socketpair, (struct socket *sock1, struct socket *sock2), \
262 (sock1, sock2)) \
263SOCKCALL_WRAP(name, accept, (struct socket *sock, struct socket *newsock, \
264 int flags), (sock, newsock, flags)) \
265SOCKCALL_WRAP(name, getname, (struct socket *sock, struct sockaddr *uaddr, \
266 int *addr_len, int peer), (sock, uaddr, addr_len, peer)) \
267SOCKCALL_UWRAP(name, poll, (struct file *file, struct socket *sock, struct poll_table_struct *wait), \
268 (file, sock, wait)) \
269SOCKCALL_WRAP(name, ioctl, (struct socket *sock, unsigned int cmd, \
270 unsigned long arg), (sock, cmd, arg)) \
89bbfc95
SP
271SOCKCALL_WRAP(name, compat_ioctl, (struct socket *sock, unsigned int cmd, \
272 unsigned long arg), (sock, cmd, arg)) \
1da177e4
LT
273SOCKCALL_WRAP(name, listen, (struct socket *sock, int len), (sock, len)) \
274SOCKCALL_WRAP(name, shutdown, (struct socket *sock, int flags), (sock, flags)) \
275SOCKCALL_WRAP(name, setsockopt, (struct socket *sock, int level, int optname, \
276 char __user *optval, int optlen), (sock, level, optname, optval, optlen)) \
277SOCKCALL_WRAP(name, getsockopt, (struct socket *sock, int level, int optname, \
278 char __user *optval, int __user *optlen), (sock, level, optname, optval, optlen)) \
279SOCKCALL_WRAP(name, sendmsg, (struct kiocb *iocb, struct socket *sock, struct msghdr *m, size_t len), \
280 (iocb, sock, m, len)) \
281SOCKCALL_WRAP(name, recvmsg, (struct kiocb *iocb, struct socket *sock, struct msghdr *m, size_t len, int flags), \
282 (iocb, sock, m, len, flags)) \
283SOCKCALL_WRAP(name, mmap, (struct file *file, struct socket *sock, struct vm_area_struct *vma), \
284 (file, sock, vma)) \
285 \
90ddc4f0 286static const struct proto_ops name##_ops = { \
1da177e4
LT
287 .family = fam, \
288 .owner = THIS_MODULE, \
289 .release = __lock_##name##_release, \
290 .bind = __lock_##name##_bind, \
291 .connect = __lock_##name##_connect, \
292 .socketpair = __lock_##name##_socketpair, \
293 .accept = __lock_##name##_accept, \
294 .getname = __lock_##name##_getname, \
295 .poll = __lock_##name##_poll, \
296 .ioctl = __lock_##name##_ioctl, \
89bbfc95 297 .compat_ioctl = __lock_##name##_compat_ioctl, \
1da177e4
LT
298 .listen = __lock_##name##_listen, \
299 .shutdown = __lock_##name##_shutdown, \
300 .setsockopt = __lock_##name##_setsockopt, \
301 .getsockopt = __lock_##name##_getsockopt, \
302 .sendmsg = __lock_##name##_sendmsg, \
303 .recvmsg = __lock_##name##_recvmsg, \
304 .mmap = __lock_##name##_mmap, \
305};
89bbfc95 306
1da177e4
LT
307#endif
308
309#define MODULE_ALIAS_NETPROTO(proto) \
310 MODULE_ALIAS("net-pf-" __stringify(proto))
311
4fdb3bb7
HW
312#define MODULE_ALIAS_NET_PF_PROTO(pf, proto) \
313 MODULE_ALIAS("net-pf-" __stringify(pf) "-proto-" __stringify(proto))
314
20380731
ACM
315#ifdef CONFIG_SYSCTL
316#include <linux/sysctl.h>
317extern ctl_table net_table[];
318extern int net_msg_cost;
319extern int net_msg_burst;
320#endif
321
1da177e4
LT
322#endif /* __KERNEL__ */
323#endif /* _LINUX_NET_H */