d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
97f0211303
freebsd-skq/lib/libc/gen/check_utility_compat.3

90 lines
3.0 KiB
Groff
Raw Normal View History

Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
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.
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.\"
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
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
.Os
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.Dt CHECK_UTILITY_COMPAT 3
.Sh NAME
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
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
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.Fn check_utility_compat
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
2002-10-28 00:15:43 +00:00
function checks whether
.Fa utility
should behave in a traditional
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.Pq Fx 4.7 Ns -compatible
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
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
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.Fn check_utility_compat
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
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
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.Fn check_utility_compat
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
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
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.Fn check_utility_compat
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
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 ERRORS
No errors are detected.
.Sh FILES
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.Bl -tag -width ".Pa /etc/compat-FreeBSD-4-util"
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
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
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.Fn check_utility_compat
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
2002-10-28 00:15:43 +00:00
function.
.El
.Sh HISTORY
The
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.Fn check_utility_compat
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
2002-10-28 00:15:43 +00:00
function first appeared in
.Fx 5.0 .
mdoc(7) police: overhaul. Approved by: re
2002-12-04 15:47:41 +00:00
.Sh AUTHORS
Create a small library function, check_utility_compat(3), to determine whether a named utility should behave in FreeBSD 4.x-compatible mode or in a standard mode (default standard). The configuration is done malloc(3)-style, with either an environment variable or a symlink. Update expr(1) to use this new interface.
2002-10-28 00:15:43 +00:00
This manual page was written by
.An Garrett Wollman Aq wollman@FreeBSD.org .
Reference in New Issue Copy Permalink