1.\" Copyright (c) 2008 Cisco systems 2.\" Author Julian Elischer. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Neither the name of the University nor the names of its contributors 10.\" may be used to endorse or promote products derived from this software 11.\" without specific prior written permission. 12.\" 13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 16.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" 25.\" $FreeBSD$ 26.\" 27.Dd April 9, 2008 28.Dt SETFIB 1 29.Os 30.Sh NAME 31.Nm setfib 32.Nd execute a utility with an altered default network view 33.Sh SYNOPSIS 34.Nm 35.Op Fl F 36.Ar fib 37.Ar utility 38.Op Ar argument ... 39.Sh DESCRIPTION 40The 41.Nm 42utility runs 43.Ar utility 44with an different routing table. 45The table number 46.Dq Ar fib 47will be used by default for all sockets started by this 48process or descendants. 49.Sh ENVIRONMENT 50The 51.Ev PATH 52environment variable is used to locate the requested 53.Ar utility 54if the name contains no 55.Ql / 56characters. 57.Sh EXIT STATUS 58If 59.Ar utility 60is invoked, the exit status of 61.Nm 62is the exit status of 63.Ar utility . 64.Pp 65An exit status of 126 indicates 66.Ar utility 67was found, but could not be executed. 68An exit status of 127 indicates 69.Ar utility 70could not be found. 71.Sh EXAMPLES 72Execute utility 73.Sq netstat 74to view the second routing table. 75.Pp 76.Dl "setfib -F 1 netstat -rn" 77or 78.Dl "setfib 1 netstat -rn" 79or 80.Dl "setfib -1 netstat -rn" 81.Sh SEE ALSO 82.Xr setfib 2 , 83.Xr setsockopt 2 84.Sh STANDARDS 85The 86.Nm 87utility is a 88.Fx 89specific extension, however many 90.Ux 91like systems 92have an equivalent function. 93.Sh HISTORY 94The 95.Nm 96utility appeared in 97.Fx 7.1 . 98