xref: /freebsd-13-stable/sbin/ifconfig/ifconfig.h (revision 17da660ad5b3b9cd90e164dd4dbb9beaa7203054)
1 /*-
2  * SPDX-License-Identifier: BSD-4-Clause
3  *
4  * Copyright (c) 1997 Peter Wemm.
5  * 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. All advertising materials mentioning features or use of this software
16  *    must display the following acknowledgement:
17  *      This product includes software developed for the FreeBSD Project
18  *	by Peter Wemm.
19  * 4. The name of the author may not be used to endorse or promote products
20  *    derived from this software without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
23  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
26  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
27  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
29  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32  * SUCH DAMAGE.
33  *
34  * so there!
35  */
36 
37 #pragma once
38 
39 #include <libifconfig.h>
40 
41 #define	__constructor	__attribute__((constructor))
42 
43 struct afswtch;
44 struct cmd;
45 
46 typedef	void c_func(const char *cmd, int arg, int s, const struct afswtch *afp);
47 typedef	void c_func2(const char *arg1, const char *arg2, int s, const struct afswtch *afp);
48 
49 struct cmd {
50 	const char *c_name;
51 	int	c_parameter;
52 #define	NEXTARG		0xffffff	/* has following arg */
53 #define	NEXTARG2	0xfffffe	/* has 2 following args */
54 #define	OPTARG		0xfffffd	/* has optional following arg */
55 	union {
56 		c_func	*c_func;
57 		c_func2	*c_func2;
58 	} c_u;
59 	int	c_iscloneop;
60 	struct cmd *c_next;
61 };
62 void	cmd_register(struct cmd *);
63 
64 typedef	void callback_func(int s, void *);
65 void	callback_register(callback_func *, void *);
66 
67 /*
68  * Macros for declaring command functions and initializing entries.
69  */
70 #define	DECL_CMD_FUNC(name, cmd, arg) \
71 	void name(const char *cmd, int arg, int s, const struct afswtch *afp)
72 #define	DECL_CMD_FUNC2(name, arg1, arg2) \
73 	void name(const char *arg1, const char *arg2, int s, const struct afswtch *afp)
74 
75 #define	DEF_CMD(name, param, func)	{ name, param, { .c_func = func }, 0, NULL }
76 #define	DEF_CMD_ARG(name, func)		{ name, NEXTARG, { .c_func = func }, 0, NULL }
77 #define	DEF_CMD_OPTARG(name, func)	{ name, OPTARG, { .c_func = func }, 0, NULL }
78 #define	DEF_CMD_ARG2(name, func)	{ name, NEXTARG2, { .c_func2 = func }, 0, NULL }
79 #define	DEF_CLONE_CMD(name, param, func) { name, param, { .c_func = func }, 1, NULL }
80 #define	DEF_CLONE_CMD_ARG(name, func)	{ name, NEXTARG, { .c_func = func }, 1, NULL }
81 #define	DEF_CLONE_CMD_ARG2(name, func)	{ name, NEXTARG2, { .c_func2 = func }, 1, NULL }
82 
83 struct ifaddrs;
84 struct addrinfo;
85 
86 enum {
87 	RIDADDR,
88 	ADDR,
89 	MASK,
90 	DSTADDR,
91 };
92 
93 struct afswtch {
94 	const char	*af_name;	/* as given on cmd line, e.g. "inet" */
95 	short		af_af;		/* AF_* */
96 	/*
97 	 * Status is handled one of two ways; if there is an
98 	 * address associated with the interface then the
99 	 * associated address family af_status method is invoked
100 	 * with the appropriate addressin info.  Otherwise, if
101 	 * all possible info is to be displayed and af_other_status
102 	 * is defined then it is invoked after all address status
103 	 * is presented.
104 	 */
105 	void		(*af_status)(int, const struct ifaddrs *);
106 	void		(*af_other_status)(int);
107 					/* parse address method */
108 	void		(*af_getaddr)(const char *, int);
109 					/* parse prefix method (IPv6) */
110 	void		(*af_getprefix)(const char *, int);
111 	void		(*af_postproc)(int s, const struct afswtch *,
112 			    int newaddr, int ifflags);
113 	u_long		af_difaddr;	/* set dst if address ioctl */
114 	u_long		af_aifaddr;	/* set if address ioctl */
115 	void		*af_ridreq;	/* */
116 	void		*af_addreq;	/* */
117 	struct afswtch	*af_next;
118 
119 	/* XXX doesn't fit model */
120 	void		(*af_status_tunnel)(int);
121 	void		(*af_settunnel)(int s, struct addrinfo *srcres,
122 				struct addrinfo *dstres);
123 };
124 void	af_register(struct afswtch *);
125 
126 struct option {
127 	const char *opt;
128 	const char *opt_usage;
129 	void	(*cb)(const char *arg);
130 	struct option *next;
131 };
132 void	opt_register(struct option *);
133 
134 extern	ifconfig_handle_t *lifh;
135 extern	struct ifreq ifr;
136 extern	char name[IFNAMSIZ];	/* name of interface */
137 extern	int allmedia;
138 extern	int supmedia;
139 extern	int printkeys;
140 extern	int newaddr;
141 extern	int verbose;
142 extern	int printifname;
143 extern	int exit_code;
144 
145 void	setifcap(const char *, int value, int s, const struct afswtch *);
146 
147 void	Perror(const char *cmd);
148 void	printb(const char *s, unsigned value, const char *bits);
149 
150 void	ifmaybeload(const char *name);
151 
152 typedef int  clone_match_func(const char *);
153 typedef void clone_callback_func(int, struct ifreq *);
154 void	clone_setdefcallback_prefix(const char *, clone_callback_func *);
155 void	clone_setdefcallback_filter(clone_match_func *, clone_callback_func *);
156 
157 void	sfp_status(int s, struct ifreq *ifr, int verbose);
158 
159 /*
160  * XXX expose this so modules that neeed to know of any pending
161  * operations on ifmedia can avoid cmd line ordering confusion.
162  */
163 struct ifmediareq *ifmedia_getstate(void);
164 
165 void print_vhid(const struct ifaddrs *, const char *);
166 
167 void ioctl_ifcreate(int s, struct ifreq *);
168