xref: /freebsd/usr.sbin/setfib/setfib.1 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
18b07e49aSJulian Elischer.\" Copyright (c) 2008 Cisco systems
28b07e49aSJulian Elischer.\"	Author Julian Elischer.  All rights reserved.
38b07e49aSJulian Elischer.\"
48b07e49aSJulian Elischer.\" Redistribution and use in source and binary forms, with or without
58b07e49aSJulian Elischer.\" modification, are permitted provided that the following conditions
68b07e49aSJulian Elischer.\" are met:
78b07e49aSJulian Elischer.\" 1. Redistributions of source code must retain the above copyright
88b07e49aSJulian Elischer.\"    notice, this list of conditions and the following disclaimer.
98b07e49aSJulian Elischer.\" 2. Neither the name of the University nor the names of its contributors
108b07e49aSJulian Elischer.\"    may be used to endorse or promote products derived from this software
118b07e49aSJulian Elischer.\"    without specific prior written permission.
128b07e49aSJulian Elischer.\"
138b07e49aSJulian Elischer.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
148b07e49aSJulian Elischer.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
158b07e49aSJulian Elischer.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
168b07e49aSJulian Elischer.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
178b07e49aSJulian Elischer.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
188b07e49aSJulian Elischer.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
198b07e49aSJulian Elischer.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
208b07e49aSJulian Elischer.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
218b07e49aSJulian Elischer.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
228b07e49aSJulian Elischer.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
238b07e49aSJulian Elischer.\" SUCH DAMAGE.
248b07e49aSJulian Elischer.\"
25*452262c8SDag-Erling Smørgrav.Dd October 20, 2008
268b07e49aSJulian Elischer.Dt SETFIB 1
278b07e49aSJulian Elischer.Os
288b07e49aSJulian Elischer.Sh NAME
298b07e49aSJulian Elischer.Nm setfib
30f30f7085SChristian Brueffer.Nd execute a utility with an altered default network view
318b07e49aSJulian Elischer.Sh SYNOPSIS
328b07e49aSJulian Elischer.Nm
338b07e49aSJulian Elischer.Op Fl F
348b07e49aSJulian Elischer.Ar fib
358b07e49aSJulian Elischer.Ar utility
368b07e49aSJulian Elischer.Op Ar argument ...
378b07e49aSJulian Elischer.Sh DESCRIPTION
388b07e49aSJulian ElischerThe
398b07e49aSJulian Elischer.Nm
40*452262c8SDag-Erling Smørgravutility runs another
418b07e49aSJulian Elischer.Ar utility
42*452262c8SDag-Erling Smørgravwith a different routing table.
43f30f7085SChristian BruefferThe table number
44*452262c8SDag-Erling Smørgrav.Ar fib
458b07e49aSJulian Elischerwill be used by default for all sockets started by this
468972c8b6SJoel Dahlprocess or descendants.
478b07e49aSJulian Elischer.Sh ENVIRONMENT
488b07e49aSJulian ElischerThe
498b07e49aSJulian Elischer.Ev PATH
508b07e49aSJulian Elischerenvironment variable is used to locate the requested
518b07e49aSJulian Elischer.Ar utility
528b07e49aSJulian Elischerif the name contains no
538b07e49aSJulian Elischer.Ql /
548b07e49aSJulian Elischercharacters.
558b07e49aSJulian Elischer.Sh EXIT STATUS
568b07e49aSJulian ElischerIf
578b07e49aSJulian Elischer.Ar utility
588b07e49aSJulian Elischeris invoked, the exit status of
598b07e49aSJulian Elischer.Nm
608b07e49aSJulian Elischeris the exit status of
618b07e49aSJulian Elischer.Ar utility .
628b07e49aSJulian Elischer.Pp
638b07e49aSJulian ElischerAn exit status of 126 indicates
648b07e49aSJulian Elischer.Ar utility
658b07e49aSJulian Elischerwas found, but could not be executed.
668b07e49aSJulian ElischerAn exit status of 127 indicates
678b07e49aSJulian Elischer.Ar utility
688b07e49aSJulian Elischercould not be found.
698b07e49aSJulian Elischer.Sh EXAMPLES
70*452262c8SDag-Erling SmørgravRun
71*452262c8SDag-Erling Smørgrav.Xr netstat 1
728b07e49aSJulian Elischerto view the second routing table.
738b07e49aSJulian Elischer.Pp
748b07e49aSJulian Elischer.Dl "setfib -F 1 netstat -rn"
758b07e49aSJulian Elischeror
768b07e49aSJulian Elischer.Dl "setfib 1 netstat -rn"
778b07e49aSJulian Elischeror
788b07e49aSJulian Elischer.Dl "setfib -1 netstat -rn"
798b07e49aSJulian Elischer.Sh SEE ALSO
808b07e49aSJulian Elischer.Xr setfib 2 ,
818b07e49aSJulian Elischer.Xr setsockopt 2
828b07e49aSJulian Elischer.Sh STANDARDS
838b07e49aSJulian ElischerThe
848b07e49aSJulian Elischer.Nm
85f30f7085SChristian Bruefferutility is a
86f30f7085SChristian Brueffer.Fx
87*452262c8SDag-Erling Smørgravspecific extension.
88*452262c8SDag-Erling SmørgravHowever, many
89*452262c8SDag-Erling Smørgrav.Ux Ns - Ns
90f30f7085SChristian Bruefferlike systems
918b07e49aSJulian Elischerhave an equivalent function.
928b07e49aSJulian Elischer.Sh HISTORY
938b07e49aSJulian ElischerThe
948b07e49aSJulian Elischer.Nm
958b07e49aSJulian Elischerutility appeared in
962a72feb4SChristian Brueffer.Fx 7.1 .
97