Differential D25029 Diff 72327 sbin/ifconfig/ifconfig.8

Changeset View

Standalone View

sbin/ifconfig/ifconfig.8

	Show All 22 Lines
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94			.\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd December 17, 2019			.Dd May 27, 2020
	.Dt IFCONFIG 8			.Dt IFCONFIG 8
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm ifconfig			.Nm ifconfig
	.Nd configure network interface parameters			.Nd configure network interface parameters
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Op Fl f Ar type:format Ns Op Ar ,type:format			.Op Fl f Ar type:format Ns Op Ar ,type:format
	Show All 11 Lines
	.Op Ar parameters			.Op Ar parameters
	.Nm			.Nm
	.Ar interface			.Ar interface
	.Cm destroy			.Cm destroy
	.Nm			.Nm
	.Fl a			.Fl a
	.Op Fl L			.Op Fl L
	.Op Fl d			.Op Fl d
				.Op Fl g Ar groupname
	.Op Fl m			.Op Fl m
	.Op Fl u			.Op Fl u
	.Op Fl v			.Op Fl v
	.Op Ar address_family			.Op Ar address_family
	.Nm			.Nm
	.Fl l			.Fl l
	.Op Fl d			.Op Fl d
	.Op Fl u			.Op Fl u
	▲ Show 20 Lines • Show All 2,843 Lines • ▼ Show 20 Lines
	Optionally, the			Optionally, the
	.Fl a			.Fl a
	flag may be used instead of an interface name.			flag may be used instead of an interface name.
	This flag instructs			This flag instructs
	.Nm			.Nm
	to display information about all interfaces in the system.			to display information about all interfaces in the system.
	The			The
	.Fl d			.Fl d
	flag limits this to interfaces that are down, and			flag limits this to interfaces that are down,
	.Fl u			.Fl u
	limits this to interfaces that are up.			limits this to interfaces that are up, and
				.Fl -g
				limits this to members of specified group of interfaces.
				.Sy groupname
				may be prefixed with caret symbol (^) to list
				bcrUnsubmitted Not Done Inline Actions Sure the ^ is a special symbol with a very popular shell: zsh. For example, I need to escape it every time I do an MFC like this: $ svn merge -c r<revisionfromhead> \^/head/ stable/12 bcr: Sure the ^ is a special symbol with a very popular shell: zsh. For example, I need to escape it…
				eugen_grosbein.netAuthorUnsubmitted Done Inline Actions Can you suggest another symbol that whould be suitable to zsh too? I don't have zsh to check. eugen_grosbein.net: Can you suggest another symbol that whould be suitable to zsh too? I don't have zsh to check.
				bcrUnsubmitted Not Done Inline Actions The zshexpn man page lists all the expansion characters in the "Word Designators" section. Everything that's not listed there should be fine. bcr: The [[ https://www.freebsd.org/cgi/man.cgi?query=zshexpn&apropos=0&sektion=0&manpath=FreeBSD+12.
				eugen_grosbein.netAuthorUnsubmitted Done Inline Actions Which character would you personally like to use? eugen_grosbein.net: Which character would you personally like to use?
				bcrUnsubmitted Not Done Inline Actions Maybe @ or #? The @ could be a mnemonic for "list me all AT this interface group". bcr: Maybe @ or #? The @ could be a mnemonic for "list me all AT this interface group".
				eugen_grosbein.netAuthorUnsubmitted Done Inline Actions As far as I know, # begins a commentary in any shell so it would require escaping too. The symbol @ may be suitable if we don't care that it would require escaping in Perl code running shell command. I see only two other symbols that could also do it, a colon (:) or slash (/). I think we need more opinions. eugen_grosbein.net: As far as I know, # begins a commentary in any shell so it would require escaping too. The…
				interfaces not belonging to specified group
				(see the
				.Sx EXAMPLES
				section).
	When no arguments are given,			When no arguments are given,
	.Fl a			.Fl a
	is implied.			is implied.
	.Pp			.Pp
	The			The
	.Fl l			.Fl l
	flag may be used to list all available interfaces on the system, with			flag may be used to list all available interfaces on the system, with
	no other additional information.			no other additional information.
	▲ Show 20 Lines • Show All 107 Lines • ▼ Show 20 Lines
	.Dl # ifconfig gif1 destroy			.Dl # ifconfig gif1 destroy
	.Pp			.Pp
	Display available wireless networks using			Display available wireless networks using
	.Li wlan0 :			.Li wlan0 :
	.Dl # ifconfig wlan0 list scan			.Dl # ifconfig wlan0 list scan
	.Pp			.Pp
	Display inet and inet6 address subnet masks in CIDR notation			Display inet and inet6 address subnet masks in CIDR notation
	.Dl # ifconfig -f inet:cidr,inet6:cidr			.Dl # ifconfig -f inet:cidr,inet6:cidr
				.Pp
				Display interfaces that are up with the exception of loopack
				.Dl # ifconfig -a -u -g ^lo
	.Sh DIAGNOSTICS			.Sh DIAGNOSTICS
	Messages indicating the specified interface does not exist, the			Messages indicating the specified interface does not exist, the
	requested address is unknown, or the user is not privileged and			requested address is unknown, or the user is not privileged and
	tried to alter an interface's configuration.			tried to alter an interface's configuration.
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr netstat 1 ,			.Xr netstat 1 ,
	.Xr carp 4 ,			.Xr carp 4 ,
	.Xr gif 4 ,			.Xr gif 4 ,
	Show All 31 Lines