2002-10-28 00:15:43 +00:00
|
|
|
.\"
|
|
|
|
.\" Copyright 2002 Massachusetts Institute of Technology
|
|
|
|
.\"
|
|
|
|
.\" Permission to use, copy, modify, and distribute this software and
|
|
|
|
.\" its documentation for any purpose and without fee is hereby
|
|
|
|
.\" granted, provided that both the above copyright notice and this
|
|
|
|
.\" permission notice appear in all copies, that both the above
|
|
|
|
.\" copyright notice and this permission notice appear in all
|
|
|
|
.\" supporting documentation, and that the name of M.I.T. not be used
|
|
|
|
.\" in advertising or publicity pertaining to distribution of the
|
|
|
|
.\" software without specific, written prior permission. M.I.T. makes
|
|
|
|
.\" no representations about the suitability of this software for any
|
|
|
|
.\" purpose. It is provided "as is" without express or implied
|
|
|
|
.\" warranty.
|
2002-12-04 15:47:41 +00:00
|
|
|
.\"
|
2002-10-28 00:15:43 +00:00
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY M.I.T. ``AS IS''. M.I.T. DISCLAIMS
|
|
|
|
.\" ALL EXPRESS OR IMPLIED WARRANTIES WITH REGARD TO THIS SOFTWARE,
|
|
|
|
.\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
|
|
.\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT
|
|
|
|
.\" SHALL M.I.T. BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
|
|
.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
|
|
|
|
.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
|
|
|
.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 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
|
|
|
|
.\" SUCH DAMAGE.
|
|
|
|
.\"
|
|
|
|
.\" $FreeBSD$
|
|
|
|
.\"
|
|
|
|
.Dd October 27, 2002
|
2002-12-04 15:47:41 +00:00
|
|
|
.Dt CHECK_UTILITY_COMPAT 3
|
2010-04-14 19:08:06 +00:00
|
|
|
.Os
|
2002-12-04 15:47:41 +00:00
|
|
|
.Sh NAME
|
2002-10-28 00:15:43 +00:00
|
|
|
.Nm check_utility_compat
|
|
|
|
.Nd "determine whether a utility should be compatible"
|
|
|
|
.Sh LIBRARY
|
|
|
|
.Lb libc
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.In unistd.h
|
|
|
|
.Ft int
|
|
|
|
.Fn check_utility_compat "const char *utility"
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
The
|
2002-12-04 15:47:41 +00:00
|
|
|
.Fn check_utility_compat
|
2002-10-28 00:15:43 +00:00
|
|
|
function checks whether
|
|
|
|
.Fa utility
|
|
|
|
should behave in a traditional
|
2002-12-04 15:47:41 +00:00
|
|
|
.Pq Fx 4.7 Ns -compatible
|
2002-10-28 00:15:43 +00:00
|
|
|
manner, or in accordance with
|
|
|
|
.St -p1003.1-2001 .
|
|
|
|
The configuration is given as a comma-separated list of utility names;
|
|
|
|
if the list is present but empty, all supported utilities assume their
|
|
|
|
most compatible mode.
|
|
|
|
The
|
2002-12-04 15:47:41 +00:00
|
|
|
.Fn check_utility_compat
|
2002-10-28 00:15:43 +00:00
|
|
|
function first checks for an environment variable named
|
|
|
|
.Ev _COMPAT_FreeBSD_4 .
|
|
|
|
If that environment variable does not exist, then
|
2002-12-04 15:47:41 +00:00
|
|
|
.Fn check_utility_compat
|
2002-10-28 00:15:43 +00:00
|
|
|
will attempt to read the contents of a symbolic link named
|
|
|
|
.Pa /etc/compat-FreeBSD-4-util .
|
|
|
|
If no configuration is found, compatibility mode is disabled.
|
|
|
|
.Sh RETURN VALUES
|
|
|
|
The
|
2002-12-04 15:47:41 +00:00
|
|
|
.Fn check_utility_compat
|
2002-10-28 00:15:43 +00:00
|
|
|
function returns zero if
|
|
|
|
.Fa utility
|
|
|
|
should implement strict
|
|
|
|
.St -p1003.1-2001
|
|
|
|
behavior, and nonzero otherwise.
|
|
|
|
.Sh FILES
|
2002-12-04 15:47:41 +00:00
|
|
|
.Bl -tag -width ".Pa /etc/compat-FreeBSD-4-util"
|
2002-10-28 00:15:43 +00:00
|
|
|
.It Pa /etc/compat-FreeBSD-4-util
|
|
|
|
If present, a symbolic link whose expansion gives system-wide default settings
|
|
|
|
for the
|
2002-12-04 15:47:41 +00:00
|
|
|
.Fn check_utility_compat
|
2002-10-28 00:15:43 +00:00
|
|
|
function.
|
|
|
|
.El
|
2005-01-20 09:17:07 +00:00
|
|
|
.Sh ERRORS
|
|
|
|
No errors are detected.
|
2002-10-28 00:15:43 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
The
|
2002-12-04 15:47:41 +00:00
|
|
|
.Fn check_utility_compat
|
2002-10-28 00:15:43 +00:00
|
|
|
function first appeared in
|
|
|
|
.Fx 5.0 .
|
2002-12-04 15:47:41 +00:00
|
|
|
.Sh AUTHORS
|
2002-10-28 00:15:43 +00:00
|
|
|
This manual page was written by
|
|
|
|
.An Garrett Wollman Aq wollman@FreeBSD.org .
|