xref: /freebsd/usr.sbin/setfib/setfib.1 (revision 8b07e49a008c89a15e1fc4a1e3db6d945f81fab4)
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.\"
258b07e49aSJulian Elischer.\" $FreeBSD$
268b07e49aSJulian Elischer.\"
278b07e49aSJulian Elischer.Dd April 9, 2008
288b07e49aSJulian Elischer.Dt SETFIB 1
298b07e49aSJulian Elischer.Os
308b07e49aSJulian Elischer.Sh NAME
318b07e49aSJulian Elischer.Nm setfib
328b07e49aSJulian Elischer.Nd execute a utility with an altered default network view.
338b07e49aSJulian Elischer.Sh SYNOPSIS
348b07e49aSJulian Elischer.Nm
358b07e49aSJulian Elischer.Op Fl F
368b07e49aSJulian Elischer.Ar fib
378b07e49aSJulian Elischer.Ar utility
388b07e49aSJulian Elischer.Op Ar argument ...
398b07e49aSJulian Elischer.Sh DESCRIPTION
408b07e49aSJulian ElischerThe
418b07e49aSJulian Elischer.Nm
428b07e49aSJulian Elischerutility runs
438b07e49aSJulian Elischer.Ar utility
448b07e49aSJulian Elischerwith an different routing table. The table number
458b07e49aSJulian Elischer.Dq fib
468b07e49aSJulian Elischerwill be used by default for all sockets started by this
478b07e49aSJulian Elischerprocess or descendents.
488b07e49aSJulian Elischer.Sh ENVIRONMENT
498b07e49aSJulian ElischerThe
508b07e49aSJulian Elischer.Ev PATH
518b07e49aSJulian Elischerenvironment variable is used to locate the requested
528b07e49aSJulian Elischer.Ar utility
538b07e49aSJulian Elischerif the name contains no
548b07e49aSJulian Elischer.Ql /
558b07e49aSJulian Elischercharacters.
568b07e49aSJulian Elischer.Sh EXIT STATUS
578b07e49aSJulian ElischerIf
588b07e49aSJulian Elischer.Ar utility
598b07e49aSJulian Elischeris invoked, the exit status of
608b07e49aSJulian Elischer.Nm
618b07e49aSJulian Elischeris the exit status of
628b07e49aSJulian Elischer.Ar utility .
638b07e49aSJulian Elischer.Pp
648b07e49aSJulian ElischerAn exit status of 126 indicates
658b07e49aSJulian Elischer.Ar utility
668b07e49aSJulian Elischerwas found, but could not be executed.
678b07e49aSJulian ElischerAn exit status of 127 indicates
688b07e49aSJulian Elischer.Ar utility
698b07e49aSJulian Elischercould not be found.
708b07e49aSJulian Elischer.Sh EXAMPLES
718b07e49aSJulian ElischerExecute utility
728b07e49aSJulian Elischer.Sq netstat
738b07e49aSJulian Elischerto view the second routing table.
748b07e49aSJulian Elischer.Pp
758b07e49aSJulian Elischer.Dl "setfib -F 1 netstat -rn"
768b07e49aSJulian Elischeror
778b07e49aSJulian Elischer.Dl "setfib 1 netstat -rn"
788b07e49aSJulian Elischeror
798b07e49aSJulian Elischer.Dl "setfib -1 netstat -rn"
808b07e49aSJulian Elischer.Sh SEE ALSO
818b07e49aSJulian Elischer.Xr setfib 2 ,
828b07e49aSJulian Elischer.Xr setsockopt 2
838b07e49aSJulian Elischer.Sh STANDARDS
848b07e49aSJulian ElischerThe
858b07e49aSJulian Elischer.Nm
868b07e49aSJulian Elischerutility is a FreeBSD specific extension, however many UNIX like systems
878b07e49aSJulian Elischerhave an equivalent function.
888b07e49aSJulian Elischer.Sh HISTORY
898b07e49aSJulian ElischerThe
908b07e49aSJulian Elischer.Nm
918b07e49aSJulian Elischerutility appeared in
928b07e49aSJulian Elischer.Fx 8.0 .
93