xref: /freebsd/sys/sys/protosw.h (revision bfd03046d18776ea70785ca1ef36dfc60822de3b)
1 /*-
2  * SPDX-License-Identifier: BSD-3-Clause
3  *
4  * Copyright (c) 1982, 1986, 1993
5  *	The Regents of the University of California.  All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. Neither the name of the University nor the names of its contributors
16  *    may be used to endorse or promote products derived from this software
17  *    without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
23  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29  * SUCH DAMAGE.
30  */
31 
32 #ifndef _SYS_PROTOSW_H_
33 #define _SYS_PROTOSW_H_
34 
35 #include <sys/_types.h>
36 
37 /* Forward declare these structures referenced from prototypes below. */
38 struct kaiocb;
39 struct mbuf;
40 struct thread;
41 struct sockaddr;
42 struct socket;
43 struct sockopt;
44 enum shutdown_how;
45 
46 /*#ifdef _KERNEL*/
47 /*
48  * Protocol switch table.
49  *
50  * Each protocol has a handle initializing one of these structures,
51  * which is used for protocol-protocol and system-protocol communication.
52  *
53  * In retrospect, it would be a lot nicer to use an interface
54  * similar to the vnode VOP interface.
55  */
56 struct ifnet;
57 struct stat;
58 struct ucred;
59 struct uio;
60 
61 /* USE THESE FOR YOUR PROTOTYPES ! */
62 typedef int	pr_ctloutput_t(struct socket *, struct sockopt *);
63 typedef int	pr_setsbopt_t(struct socket *, struct sockopt *);
64 typedef void	pr_abort_t(struct socket *);
65 typedef int	pr_accept_t(struct socket *, struct sockaddr *);
66 typedef int	pr_attach_t(struct socket *, int, struct thread *);
67 typedef int	pr_bind_t(struct socket *, struct sockaddr *, struct thread *);
68 typedef int	pr_connect_t(struct socket *, struct sockaddr *,
69 		    struct thread *);
70 typedef int	pr_connect2_t(struct socket *, struct socket *);
71 typedef int	pr_control_t(struct socket *, unsigned long, void *,
72 		    struct ifnet *, struct thread *);
73 typedef void	pr_detach_t(struct socket *);
74 typedef int	pr_disconnect_t(struct socket *);
75 typedef int	pr_listen_t(struct socket *, int, struct thread *);
76 typedef int	pr_peeraddr_t(struct socket *, struct sockaddr *);
77 typedef int	pr_rcvd_t(struct socket *, int);
78 typedef int	pr_rcvoob_t(struct socket *, struct mbuf *, int);
79 typedef enum {
80 	PRUS_OOB =		0x1,
81 	PRUS_EOF =		0x2,
82 	PRUS_MORETOCOME =	0x4,
83 	PRUS_NOTREADY =		0x8,
84 	PRUS_IPV6 =		0x10,
85 } pr_send_flags_t;
86 typedef int	pr_send_t(struct socket *, int, struct mbuf *,
87 		    struct sockaddr *, struct mbuf *, struct thread *);
88 typedef int	pr_ready_t(struct socket *, struct mbuf *, int);
89 typedef int	pr_sense_t(struct socket *, struct stat *);
90 typedef int	pr_shutdown_t(struct socket *, enum shutdown_how);
91 typedef int	pr_sockaddr_t(struct socket *, struct sockaddr *);
92 typedef int	pr_sosend_t(struct socket *, struct sockaddr *, struct uio *,
93 		    struct mbuf *, struct mbuf *, int, struct thread *);
94 typedef int	pr_soreceive_t(struct socket *, struct sockaddr **,
95 		    struct uio *, struct mbuf **, struct mbuf **, int *);
96 typedef int	pr_sopoll_t(struct socket *, int, struct ucred *,
97 		    struct thread *);
98 typedef void	pr_sosetlabel_t(struct socket *);
99 typedef void	pr_close_t(struct socket *);
100 typedef int	pr_bindat_t(int, struct socket *, struct sockaddr *,
101 		    struct thread *);
102 typedef int	pr_connectat_t(int, struct socket *, struct sockaddr *,
103 		    struct thread *);
104 typedef int	pr_aio_queue_t(struct socket *, struct kaiocb *);
105 typedef int	pr_chmod_t(struct socket *, __mode_t, struct ucred *,
106 		    struct thread *);
107 
108 struct protosw {
109 	short	pr_type;		/* socket type used for */
110 	short	pr_protocol;		/* protocol number */
111 	short	pr_flags;		/* see below */
112 	short	pr_unused;
113 	struct	domain	*pr_domain;	/* domain protocol a member of */
114 
115 	pr_soreceive_t	*pr_soreceive;	/* recv(2) */
116 	pr_rcvd_t	*pr_rcvd;	/* soreceive_generic() if PR_WANTRCVD */
117 	pr_sosend_t	*pr_sosend;	/* send(2) */
118 	pr_send_t	*pr_send;	/* send(2) via sosend_generic() */
119 	pr_ready_t	*pr_ready;	/* sendfile/ktls readyness */
120 	pr_sopoll_t	*pr_sopoll;	/* poll(2) */
121 /* Cache line #2 */
122 	pr_attach_t	*pr_attach;	/* creation: socreate(), sonewconn() */
123 	pr_detach_t	*pr_detach;	/* destruction: sofree() */
124 	pr_connect_t	*pr_connect;	/* connect(2) */
125 	pr_disconnect_t	*pr_disconnect;	/* sodisconnect() */
126 	pr_close_t	*pr_close;	/* close(2) */
127 	pr_shutdown_t	*pr_shutdown;	/* shutdown(2) */
128 	pr_abort_t	*pr_abort;	/* abrupt tear down: soabort() */
129 	pr_aio_queue_t	*pr_aio_queue;	/* aio(9) */
130 /* Cache line #3 */
131 	pr_bind_t	*pr_bind;	/* bind(2) */
132 	pr_bindat_t	*pr_bindat;	/* bindat(2) */
133 	pr_listen_t	*pr_listen;	/* listen(2) */
134 	pr_accept_t	*pr_accept;	/* accept(2) */
135 	pr_connectat_t	*pr_connectat;	/* connectat(2) */
136 	pr_connect2_t	*pr_connect2;	/* socketpair(2) */
137 	pr_control_t	*pr_control;	/* ioctl(2) */
138 	pr_rcvoob_t	*pr_rcvoob;	/* soreceive_rcvoob() */
139 /* Cache line #4 */
140 	pr_ctloutput_t	*pr_ctloutput;	/* control output (from above) */
141 	pr_peeraddr_t	*pr_peeraddr;	/* getpeername(2) */
142 	pr_sockaddr_t	*pr_sockaddr;	/* getsockname(2) */
143 	pr_sense_t	*pr_sense;	/* stat(2) */
144 	pr_sosetlabel_t	*pr_sosetlabel;	/* MAC, XXXGL: remove */
145 	pr_setsbopt_t	*pr_setsbopt;	/* Socket buffer ioctls */
146 	pr_chmod_t	*pr_chmod;	/* fchmod(2) */
147 };
148 /*#endif*/
149 
150 /*
151  * Values for pr_flags.
152  * PR_ADDR requires PR_ATOMIC;
153  * PR_ADDR and PR_CONNREQUIRED are mutually exclusive.
154  * PR_IMPLOPCL means that the protocol allows sendto without prior connect,
155  *	and the protocol understands the MSG_EOF flag.  The first property is
156  *	is only relevant if PR_CONNREQUIRED is set (otherwise sendto is allowed
157  *	anyhow).
158  * PR_SOCKBUF requires protocol to initialize and destroy its socket buffers
159  * in its pr_attach and pr_detach.
160  */
161 #define	PR_ATOMIC	0x01		/* exchange atomic messages only */
162 #define	PR_ADDR		0x02		/* addresses given with messages */
163 #define	PR_CONNREQUIRED	0x04		/* connection required by protocol */
164 #define	PR_WANTRCVD	0x08		/* want PRU_RCVD calls */
165 /* was	PR_RIGHTS	0x10		   passes capabilities */
166 #define PR_IMPLOPCL	0x20		/* implied open/close */
167 /* was	PR_LASTHDR	0x40		   enforce ipsec policy; last header */
168 #define	PR_CAPATTACH	0x80		/* socket can attach in cap mode */
169 #define	PR_SOCKBUF	0x100		/* private implementation of buffers */
170 
171 #ifdef _KERNEL
172 struct domain *pffinddomain(int family);
173 struct protosw *pffindproto(int family, int type, int proto);
174 int protosw_register(struct domain *, struct protosw *);
175 int protosw_unregister(struct protosw *);
176 
177 /* Domains that are known to be avaliable for protosw_register(). */
178 extern struct domain inetdomain;
179 extern struct domain inet6domain;
180 #endif
181 
182 #endif
183