xref: /linux/include/linux/net.h (revision e2aec372ff4b7e78e79c308104a860ae0ed20950)
11da177e4SLinus Torvalds /*
21da177e4SLinus Torvalds  * NET		An implementation of the SOCKET network access protocol.
31da177e4SLinus Torvalds  *		This is the master header file for the Linux NET layer,
41da177e4SLinus Torvalds  *		or, in plain English: the networking handling part of the
51da177e4SLinus Torvalds  *		kernel.
61da177e4SLinus Torvalds  *
71da177e4SLinus Torvalds  * Version:	@(#)net.h	1.0.3	05/25/93
81da177e4SLinus Torvalds  *
91da177e4SLinus Torvalds  * Authors:	Orest Zborowski, <obz@Kodak.COM>
1002c30a84SJesper Juhl  *		Ross Biro
111da177e4SLinus Torvalds  *		Fred N. van Kempen, <waltje@uWalt.NL.Mugnet.ORG>
121da177e4SLinus Torvalds  *
131da177e4SLinus Torvalds  *		This program is free software; you can redistribute it and/or
141da177e4SLinus Torvalds  *		modify it under the terms of the GNU General Public License
151da177e4SLinus Torvalds  *		as published by the Free Software Foundation; either version
161da177e4SLinus Torvalds  *		2 of the License, or (at your option) any later version.
171da177e4SLinus Torvalds  */
181da177e4SLinus Torvalds #ifndef _LINUX_NET_H
191da177e4SLinus Torvalds #define _LINUX_NET_H
201da177e4SLinus Torvalds 
210098b727SRusty Russell #include <linux/socket.h>
221da177e4SLinus Torvalds #include <asm/socket.h>
231da177e4SLinus Torvalds 
240098b727SRusty Russell #define NPROTO		AF_MAX
251da177e4SLinus Torvalds 
261da177e4SLinus Torvalds #define SYS_SOCKET	1		/* sys_socket(2)		*/
271da177e4SLinus Torvalds #define SYS_BIND	2		/* sys_bind(2)			*/
281da177e4SLinus Torvalds #define SYS_CONNECT	3		/* sys_connect(2)		*/
291da177e4SLinus Torvalds #define SYS_LISTEN	4		/* sys_listen(2)		*/
301da177e4SLinus Torvalds #define SYS_ACCEPT	5		/* sys_accept(2)		*/
311da177e4SLinus Torvalds #define SYS_GETSOCKNAME	6		/* sys_getsockname(2)		*/
321da177e4SLinus Torvalds #define SYS_GETPEERNAME	7		/* sys_getpeername(2)		*/
331da177e4SLinus Torvalds #define SYS_SOCKETPAIR	8		/* sys_socketpair(2)		*/
341da177e4SLinus Torvalds #define SYS_SEND	9		/* sys_send(2)			*/
351da177e4SLinus Torvalds #define SYS_RECV	10		/* sys_recv(2)			*/
361da177e4SLinus Torvalds #define SYS_SENDTO	11		/* sys_sendto(2)		*/
371da177e4SLinus Torvalds #define SYS_RECVFROM	12		/* sys_recvfrom(2)		*/
381da177e4SLinus Torvalds #define SYS_SHUTDOWN	13		/* sys_shutdown(2)		*/
391da177e4SLinus Torvalds #define SYS_SETSOCKOPT	14		/* sys_setsockopt(2)		*/
401da177e4SLinus Torvalds #define SYS_GETSOCKOPT	15		/* sys_getsockopt(2)		*/
411da177e4SLinus Torvalds #define SYS_SENDMSG	16		/* sys_sendmsg(2)		*/
421da177e4SLinus Torvalds #define SYS_RECVMSG	17		/* sys_recvmsg(2)		*/
43de11defeSUlrich Drepper #define SYS_ACCEPT4	18		/* sys_accept4(2)		*/
44a2e27255SArnaldo Carvalho de Melo #define SYS_RECVMMSG	19		/* sys_recvmmsg(2)		*/
451da177e4SLinus Torvalds 
461da177e4SLinus Torvalds typedef enum {
471da177e4SLinus Torvalds 	SS_FREE = 0,			/* not allocated		*/
481da177e4SLinus Torvalds 	SS_UNCONNECTED,			/* unconnected to any socket	*/
491da177e4SLinus Torvalds 	SS_CONNECTING,			/* in process of connecting	*/
501da177e4SLinus Torvalds 	SS_CONNECTED,			/* connected to socket		*/
511da177e4SLinus Torvalds 	SS_DISCONNECTING		/* in process of disconnecting	*/
521da177e4SLinus Torvalds } socket_state;
531da177e4SLinus Torvalds 
541da177e4SLinus Torvalds #define __SO_ACCEPTCON	(1 << 16)	/* performed a listen		*/
551da177e4SLinus Torvalds 
561da177e4SLinus Torvalds #ifdef __KERNEL__
57eacf17bdSDavid Woodhouse #include <linux/stringify.h>
58cb4db4c2SDavid Woodhouse #include <linux/random.h>
595770a3fbSDavid Woodhouse #include <linux/wait.h>
605770a3fbSDavid Woodhouse #include <linux/fcntl.h>	/* For O_CLOEXEC and O_NONBLOCK */
6129a020d3SEric Dumazet #include <linux/kmemcheck.h>
6243815482SEric Dumazet #include <linux/rcupdate.h>
635770a3fbSDavid Woodhouse 
645770a3fbSDavid Woodhouse struct poll_table_struct;
655770a3fbSDavid Woodhouse struct pipe_inode_info;
665770a3fbSDavid Woodhouse struct inode;
675770a3fbSDavid Woodhouse struct net;
681da177e4SLinus Torvalds 
691da177e4SLinus Torvalds #define SOCK_ASYNC_NOSPACE	0
701da177e4SLinus Torvalds #define SOCK_ASYNC_WAITDATA	1
711da177e4SLinus Torvalds #define SOCK_NOSPACE		2
721da177e4SLinus Torvalds #define SOCK_PASSCRED		3
73877ce7c1SCatherine Zhang #define SOCK_PASSSEC		4
741da177e4SLinus Torvalds 
751da177e4SLinus Torvalds #ifndef ARCH_HAS_SOCKET_TYPES
764dc3b16bSPavel Pisa /**
774dc3b16bSPavel Pisa  * enum sock_type - Socket types
784dc3b16bSPavel Pisa  * @SOCK_STREAM: stream (connection) socket
794dc3b16bSPavel Pisa  * @SOCK_DGRAM: datagram (conn.less) socket
804dc3b16bSPavel Pisa  * @SOCK_RAW: raw socket
814dc3b16bSPavel Pisa  * @SOCK_RDM: reliably-delivered message
824dc3b16bSPavel Pisa  * @SOCK_SEQPACKET: sequential packet socket
838f2709b5SRandy Dunlap  * @SOCK_DCCP: Datagram Congestion Control Protocol socket
844dc3b16bSPavel Pisa  * @SOCK_PACKET: linux specific way of getting packets at the dev level.
854dc3b16bSPavel Pisa  *		  For writing rarp and other similar things on the user level.
861da177e4SLinus Torvalds  *
871da177e4SLinus Torvalds  * When adding some new socket type please
881da177e4SLinus Torvalds  * grep ARCH_HAS_SOCKET_TYPE include/asm-* /socket.h, at least MIPS
891da177e4SLinus Torvalds  * overrides this enum for binary compat reasons.
901da177e4SLinus Torvalds  */
911da177e4SLinus Torvalds enum sock_type {
921da177e4SLinus Torvalds 	SOCK_STREAM	= 1,
931da177e4SLinus Torvalds 	SOCK_DGRAM	= 2,
941da177e4SLinus Torvalds 	SOCK_RAW	= 3,
951da177e4SLinus Torvalds 	SOCK_RDM	= 4,
961da177e4SLinus Torvalds 	SOCK_SEQPACKET	= 5,
977c657876SArnaldo Carvalho de Melo 	SOCK_DCCP	= 6,
981da177e4SLinus Torvalds 	SOCK_PACKET	= 10,
991da177e4SLinus Torvalds };
1001da177e4SLinus Torvalds 
1011da177e4SLinus Torvalds #define SOCK_MAX (SOCK_PACKET + 1)
102a677a039SUlrich Drepper /* Mask which covers at least up to SOCK_MASK-1.  The
103a677a039SUlrich Drepper  * remaining bits are used as flags. */
104a677a039SUlrich Drepper #define SOCK_TYPE_MASK 0xf
105a677a039SUlrich Drepper 
106de11defeSUlrich Drepper /* Flags for socket, socketpair, accept4 */
107a677a039SUlrich Drepper #define SOCK_CLOEXEC	O_CLOEXEC
108c019bbc6SUlrich Drepper #ifndef SOCK_NONBLOCK
109c019bbc6SUlrich Drepper #define SOCK_NONBLOCK	O_NONBLOCK
110c019bbc6SUlrich Drepper #endif
1111da177e4SLinus Torvalds 
1121da177e4SLinus Torvalds #endif /* ARCH_HAS_SOCKET_TYPES */
1131da177e4SLinus Torvalds 
11491cf45f0STrond Myklebust enum sock_shutdown_cmd {
11591cf45f0STrond Myklebust 	SHUT_RD		= 0,
11691cf45f0STrond Myklebust 	SHUT_WR		= 1,
11791cf45f0STrond Myklebust 	SHUT_RDWR	= 2,
11891cf45f0STrond Myklebust };
11991cf45f0STrond Myklebust 
12043815482SEric Dumazet struct socket_wq {
12143815482SEric Dumazet 	wait_queue_head_t	wait;
12243815482SEric Dumazet 	struct fasync_struct	*fasync_list;
12343815482SEric Dumazet 	struct rcu_head		rcu;
12443815482SEric Dumazet } ____cacheline_aligned_in_smp;
12543815482SEric Dumazet 
1261da177e4SLinus Torvalds /**
1271da177e4SLinus Torvalds  *  struct socket - general BSD socket
1284dc3b16bSPavel Pisa  *  @state: socket state (%SS_CONNECTED, etc)
1292c693610SRichard Kennedy  *  @type: socket type (%SOCK_STREAM, etc)
1304dc3b16bSPavel Pisa  *  @flags: socket flags (%SOCK_ASYNC_NOSPACE, etc)
1314dc3b16bSPavel Pisa  *  @ops: protocol specific socket operations
1324dc3b16bSPavel Pisa  *  @file: File back pointer for gc
1334dc3b16bSPavel Pisa  *  @sk: internal networking protocol agnostic socket representation
134*e2aec372SRandy Dunlap  *  @wq: wait queue for several uses
1351da177e4SLinus Torvalds  */
1361da177e4SLinus Torvalds struct socket {
1371da177e4SLinus Torvalds 	socket_state		state;
13829a020d3SEric Dumazet 
13929a020d3SEric Dumazet 	kmemcheck_bitfield_begin(type);
1402c693610SRichard Kennedy 	short			type;
14129a020d3SEric Dumazet 	kmemcheck_bitfield_end(type);
14229a020d3SEric Dumazet 
1431da177e4SLinus Torvalds 	unsigned long		flags;
14443815482SEric Dumazet 
14543815482SEric Dumazet 	struct socket_wq	*wq;
1468bdd663aSEric Dumazet 
1471da177e4SLinus Torvalds 	struct file		*file;
1481da177e4SLinus Torvalds 	struct sock		*sk;
1498bdd663aSEric Dumazet 	const struct proto_ops	*ops;
1501da177e4SLinus Torvalds };
1511da177e4SLinus Torvalds 
1521da177e4SLinus Torvalds struct vm_area_struct;
1531da177e4SLinus Torvalds struct page;
1541da177e4SLinus Torvalds struct kiocb;
1551da177e4SLinus Torvalds struct sockaddr;
1561da177e4SLinus Torvalds struct msghdr;
1571da177e4SLinus Torvalds struct module;
1581da177e4SLinus Torvalds 
1591da177e4SLinus Torvalds struct proto_ops {
1601da177e4SLinus Torvalds 	int		family;
1611da177e4SLinus Torvalds 	struct module	*owner;
1621da177e4SLinus Torvalds 	int		(*release)   (struct socket *sock);
1631da177e4SLinus Torvalds 	int		(*bind)	     (struct socket *sock,
1641da177e4SLinus Torvalds 				      struct sockaddr *myaddr,
1651da177e4SLinus Torvalds 				      int sockaddr_len);
1661da177e4SLinus Torvalds 	int		(*connect)   (struct socket *sock,
1671da177e4SLinus Torvalds 				      struct sockaddr *vaddr,
1681da177e4SLinus Torvalds 				      int sockaddr_len, int flags);
1691da177e4SLinus Torvalds 	int		(*socketpair)(struct socket *sock1,
1701da177e4SLinus Torvalds 				      struct socket *sock2);
1711da177e4SLinus Torvalds 	int		(*accept)    (struct socket *sock,
1721da177e4SLinus Torvalds 				      struct socket *newsock, int flags);
1731da177e4SLinus Torvalds 	int		(*getname)   (struct socket *sock,
1741da177e4SLinus Torvalds 				      struct sockaddr *addr,
1751da177e4SLinus Torvalds 				      int *sockaddr_len, int peer);
1761da177e4SLinus Torvalds 	unsigned int	(*poll)	     (struct file *file, struct socket *sock,
1771da177e4SLinus Torvalds 				      struct poll_table_struct *wait);
1781da177e4SLinus Torvalds 	int		(*ioctl)     (struct socket *sock, unsigned int cmd,
1791da177e4SLinus Torvalds 				      unsigned long arg);
1801621e094SAlexey Dobriyan #ifdef CONFIG_COMPAT
18189bbfc95SShaun Pereira 	int	 	(*compat_ioctl) (struct socket *sock, unsigned int cmd,
18289bbfc95SShaun Pereira 				      unsigned long arg);
1831621e094SAlexey Dobriyan #endif
1841da177e4SLinus Torvalds 	int		(*listen)    (struct socket *sock, int len);
1851da177e4SLinus Torvalds 	int		(*shutdown)  (struct socket *sock, int flags);
1861da177e4SLinus Torvalds 	int		(*setsockopt)(struct socket *sock, int level,
187b7058842SDavid S. Miller 				      int optname, char __user *optval, unsigned int optlen);
1881da177e4SLinus Torvalds 	int		(*getsockopt)(struct socket *sock, int level,
1891da177e4SLinus Torvalds 				      int optname, char __user *optval, int __user *optlen);
1901621e094SAlexey Dobriyan #ifdef CONFIG_COMPAT
1913fdadf7dSDmitry Mishin 	int		(*compat_setsockopt)(struct socket *sock, int level,
192b7058842SDavid S. Miller 				      int optname, char __user *optval, unsigned int optlen);
1933fdadf7dSDmitry Mishin 	int		(*compat_getsockopt)(struct socket *sock, int level,
1943fdadf7dSDmitry Mishin 				      int optname, char __user *optval, int __user *optlen);
1951621e094SAlexey Dobriyan #endif
1961da177e4SLinus Torvalds 	int		(*sendmsg)   (struct kiocb *iocb, struct socket *sock,
1971da177e4SLinus Torvalds 				      struct msghdr *m, size_t total_len);
1981da177e4SLinus Torvalds 	int		(*recvmsg)   (struct kiocb *iocb, struct socket *sock,
1991da177e4SLinus Torvalds 				      struct msghdr *m, size_t total_len,
2001da177e4SLinus Torvalds 				      int flags);
2011da177e4SLinus Torvalds 	int		(*mmap)	     (struct file *file, struct socket *sock,
2021da177e4SLinus Torvalds 				      struct vm_area_struct * vma);
2031da177e4SLinus Torvalds 	ssize_t		(*sendpage)  (struct socket *sock, struct page *page,
2041da177e4SLinus Torvalds 				      int offset, size_t size, int flags);
2059c55e01cSJens Axboe 	ssize_t 	(*splice_read)(struct socket *sock,  loff_t *ppos,
2069c55e01cSJens Axboe 				       struct pipe_inode_info *pipe, size_t len, unsigned int flags);
2071da177e4SLinus Torvalds };
2081da177e4SLinus Torvalds 
20938bfd8f5SCyrill Gorcunov #define DECLARE_SOCKADDR(type, dst, src)	\
21038bfd8f5SCyrill Gorcunov 	type dst = ({ __sockaddr_check_size(sizeof(*dst)); (type) src; })
21138bfd8f5SCyrill Gorcunov 
2121da177e4SLinus Torvalds struct net_proto_family {
2131da177e4SLinus Torvalds 	int		family;
2143f378b68SEric Paris 	int		(*create)(struct net *net, struct socket *sock,
2153f378b68SEric Paris 				  int protocol, int kern);
2161da177e4SLinus Torvalds 	struct module	*owner;
2171da177e4SLinus Torvalds };
2181da177e4SLinus Torvalds 
2191da177e4SLinus Torvalds struct iovec;
2201da177e4SLinus Torvalds struct kvec;
2211da177e4SLinus Torvalds 
2228d8ad9d7SPavel Emelyanov enum {
2238d8ad9d7SPavel Emelyanov 	SOCK_WAKE_IO,
2248d8ad9d7SPavel Emelyanov 	SOCK_WAKE_WAITD,
2258d8ad9d7SPavel Emelyanov 	SOCK_WAKE_SPACE,
2268d8ad9d7SPavel Emelyanov 	SOCK_WAKE_URG,
2278d8ad9d7SPavel Emelyanov };
2288d8ad9d7SPavel Emelyanov 
2291da177e4SLinus Torvalds extern int	     sock_wake_async(struct socket *sk, int how, int band);
230f0fd27d4SStephen Hemminger extern int	     sock_register(const struct net_proto_family *fam);
231f0fd27d4SStephen Hemminger extern void	     sock_unregister(int family);
2321da177e4SLinus Torvalds extern int	     sock_create(int family, int type, int proto,
2331da177e4SLinus Torvalds 				 struct socket **res);
2341da177e4SLinus Torvalds extern int	     sock_create_kern(int family, int type, int proto,
2351da177e4SLinus Torvalds 				      struct socket **res);
2361da177e4SLinus Torvalds extern int	     sock_create_lite(int family, int type, int proto,
2371da177e4SLinus Torvalds 				      struct socket **res);
2381da177e4SLinus Torvalds extern void	     sock_release(struct socket *sock);
2391da177e4SLinus Torvalds extern int   	     sock_sendmsg(struct socket *sock, struct msghdr *msg,
2401da177e4SLinus Torvalds 				  size_t len);
2411da177e4SLinus Torvalds extern int	     sock_recvmsg(struct socket *sock, struct msghdr *msg,
2421da177e4SLinus Torvalds 				  size_t size, int flags);
243a677a039SUlrich Drepper extern int 	     sock_map_fd(struct socket *sock, int flags);
2441da177e4SLinus Torvalds extern struct socket *sockfd_lookup(int fd, int *err);
2451da177e4SLinus Torvalds #define		     sockfd_put(sock) fput(sock->file)
2461da177e4SLinus Torvalds extern int	     net_ratelimit(void);
247aaa248f6SStephen Hemminger 
248aaa248f6SStephen Hemminger #define net_random()		random32()
249a64b78a0SAl Viro #define net_srandom(seed)	srandom32((__force u32)seed)
2501da177e4SLinus Torvalds 
2511da177e4SLinus Torvalds extern int   	     kernel_sendmsg(struct socket *sock, struct msghdr *msg,
2521da177e4SLinus Torvalds 				    struct kvec *vec, size_t num, size_t len);
2531da177e4SLinus Torvalds extern int   	     kernel_recvmsg(struct socket *sock, struct msghdr *msg,
2541da177e4SLinus Torvalds 				    struct kvec *vec, size_t num,
2551da177e4SLinus Torvalds 				    size_t len, int flags);
2561da177e4SLinus Torvalds 
257ac5a488eSSridhar Samudrala extern int kernel_bind(struct socket *sock, struct sockaddr *addr,
258ac5a488eSSridhar Samudrala 		       int addrlen);
259ac5a488eSSridhar Samudrala extern int kernel_listen(struct socket *sock, int backlog);
260ac5a488eSSridhar Samudrala extern int kernel_accept(struct socket *sock, struct socket **newsock,
261ac5a488eSSridhar Samudrala 			 int flags);
262ac5a488eSSridhar Samudrala extern int kernel_connect(struct socket *sock, struct sockaddr *addr,
263ac5a488eSSridhar Samudrala 			  int addrlen, int flags);
264ac5a488eSSridhar Samudrala extern int kernel_getsockname(struct socket *sock, struct sockaddr *addr,
265ac5a488eSSridhar Samudrala 			      int *addrlen);
266ac5a488eSSridhar Samudrala extern int kernel_getpeername(struct socket *sock, struct sockaddr *addr,
267ac5a488eSSridhar Samudrala 			      int *addrlen);
268ac5a488eSSridhar Samudrala extern int kernel_getsockopt(struct socket *sock, int level, int optname,
269ac5a488eSSridhar Samudrala 			     char *optval, int *optlen);
270ac5a488eSSridhar Samudrala extern int kernel_setsockopt(struct socket *sock, int level, int optname,
271b7058842SDavid S. Miller 			     char *optval, unsigned int optlen);
272ac5a488eSSridhar Samudrala extern int kernel_sendpage(struct socket *sock, struct page *page, int offset,
273ac5a488eSSridhar Samudrala 			   size_t size, int flags);
274ac5a488eSSridhar Samudrala extern int kernel_sock_ioctl(struct socket *sock, int cmd, unsigned long arg);
27591cf45f0STrond Myklebust extern int kernel_sock_shutdown(struct socket *sock,
27691cf45f0STrond Myklebust 				enum sock_shutdown_cmd how);
277ac5a488eSSridhar Samudrala 
2781da177e4SLinus Torvalds #define MODULE_ALIAS_NETPROTO(proto) \
2791da177e4SLinus Torvalds 	MODULE_ALIAS("net-pf-" __stringify(proto))
2801da177e4SLinus Torvalds 
2814fdb3bb7SHarald Welte #define MODULE_ALIAS_NET_PF_PROTO(pf, proto) \
2824fdb3bb7SHarald Welte 	MODULE_ALIAS("net-pf-" __stringify(pf) "-proto-" __stringify(proto))
2834fdb3bb7SHarald Welte 
284305e1e96SJean Delvare #define MODULE_ALIAS_NET_PF_PROTO_TYPE(pf, proto, type) \
285305e1e96SJean Delvare 	MODULE_ALIAS("net-pf-" __stringify(pf) "-proto-" __stringify(proto) \
286305e1e96SJean Delvare 		     "-type-" __stringify(type))
287305e1e96SJean Delvare 
28820380731SArnaldo Carvalho de Melo #ifdef CONFIG_SYSCTL
28920380731SArnaldo Carvalho de Melo #include <linux/sysctl.h>
2903fff4c42SIngo Molnar #include <linux/ratelimit.h>
291717115e1SDave Young extern struct ratelimit_state net_ratelimit_state;
29220380731SArnaldo Carvalho de Melo #endif
29320380731SArnaldo Carvalho de Melo 
2941da177e4SLinus Torvalds #endif /* __KERNEL__ */
2951da177e4SLinus Torvalds #endif	/* _LINUX_NET_H */
296