CHECK_UTILITY_COMPAT(3)                       FreeBSD Library Functions Manual

NAME

     check_utility_compat - determine whether a utility should be compatible

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <unistd.h>

     int
     check_utility_compat(const char *utility);

DESCRIPTION

     The check_utility_compat() function checks whether utility should behave
     in a traditional (FreeBSD 4.7-compatible) manner, or in accordance with
     IEEE Std 1003.1-2001 ("POSIX.1").  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
     check_utility_compat() function first checks for an environment variable
     named _COMPAT_FreeBSD_4.  If that environment variable does not exist,
     then check_utility_compat() will attempt to read the contents of a
     symbolic link named /etc/compat-FreeBSD-4-util.  If no configuration is
     found, compatibility mode is disabled.

RETURN VALUES

     The check_utility_compat() function returns zero if utility should
     implement strict IEEE Std 1003.1-2001 ("POSIX.1") behavior, and nonzero
     otherwise.

FILES

     /etc/compat-FreeBSD-4-util  If present, a symbolic link whose expansion
                                 gives system-wide default settings for the
                                 check_utility_compat() function.

ERRORS

     No errors are detected.

HISTORY

     The check_utility_compat() function first appeared in FreeBSD 5.0.

AUTHORS

     This manual page was written by Garrett Wollman <wollman@FreeBSD.org>.

FreeBSD 15.1-STABLE-HBSD       October 27, 2002        CHECK_UTILITY_COMPAT(3)