CONFSTR (3)
get configuration dependent string variables
SYNOPSIS
#define __USE_POSIX_2
#include <unistd.h>
size_t confstr(int name , char * buf , size_t len );
DESCRIPTION
confstr()
gets the value of configuration - dependent string variables.
The
name
argument is the system variable to be queried.
The following variables are supported:
_CS_PATH
A value for the
PATH
variable which indicates where all the POSIX.2 standard utilities can
be found.
If
buf
is not
NULL ,
and
len
is not zero,
confstr()
copies the value of the string to
buf
truncated to
len - 1
characters if necessary, with a null character as termination.
This can be detected by comparing the return value of
confstr()
against
len .
If
len
is zero and
buf
is
NULL ,
confstr()
just returns the value as defined below.
RETURN VALUE
If
name
does not correspond to a valid configuration variable,
confstr()
returns 0.
EXAMPLES
The following code fragment determines the path where to find
the POSIX.2 system utilities:
10
char *pathbuf; size_t n;
n = confstr(_CS_PATH,NULL,(size_t)0);
if ((pathbuf = malloc(n)) == NULL) abort();
confstr(_CS_PATH, pathbuf, n);
ERRORS
If the value of
name
is invalid,
errno
is set to
EINVAL .
CONFORMING TO
BUGS
POSIX.2 is not yet an approved standard; the information in this
manpage is subject to change.
SEE ALSO
- sh (1) -
- exec (3) -
- system (3) -
' " ' " Copyright(c) 1990-1993 The Regents of the University of California ' " Copyright(c) 1994-1996 Sun Microsystems Inc ' " ' " See the file "license terms" for information on usage and redistribution ' " of this file and for a DISCLAIMER OF ALL WARRANTIES ' " ' " RCS: @(#) $Id: CoordToWin 3 v 1 2 1998/09/14 18:22:46 stanton Exp $ ' " ' " The definitions below are for supplemental macros used in Tcl/Tk ' " manual entries ' " ' " AP type name in/out ?indent? ' " Start paragraph describing an argument to a library procedure ' " type is type of argument(int etc ) in/out is either "in" "out" ' " or "in/out" to describe whether procedure reads or modifies arg ' " and indent is equivalent to second arg of IP(shouldn't ever be ' " needed; use AS below instead) ' " ' " AS ?type? ?name? ' " Give maximum sizes of arguments for setting tab stops Type and ' " name are examples of largest possible arguments that will be passed ' " to AP later If args are omitted default tab stops are used ' " ' " BS ' " Start box enclosure From here until next BE everything will be ' " enclosed in one large box ' " ' " BE ' " End of box enclosure ' " ' " CS ' " Begin code excerpt ' " ' " CE ' " End code excerpt ' " ' " VS ?version? ?br? ' " Begin vertical sidebar for use in marking newly-changed parts ' " of man pages The first argument is ignored and used for recording ' " the version when the VS was added so that the sidebars can be ' " found and removed when they reach a certain age If another argument ' " is present then a line break is forced before starting the sidebar ' " ' " VE ' " End of vertical sidebar ' " ' " DS ' " Begin an indented unfilled display ' " ' " DE ' " End of indented unfilled display ' " ' " SO ' " Start of list of standard options for a Tk widget The ' " options follow on successive lines in four columns separated ' " by tabs ' " ' " SE ' " End of list of standard options for a Tk widget ' " ' " OP cmdName dbName dbClass ' " Start of description of a specific option cmdName gives the ' " option's name as specified in the class command dbName gives ' " the option's name in the option database and dbClass gives ' " the option's class in the option database ' " ' " UL arg1 arg2 ' " Print arg1 underlined then print arg2 normally ' " ' " RCS: @(#) $Id: man macros v 1 2 1998/09/14 18:39:54 stanton Exp $ ' " ' " # Set up traps and other miscellaneous stuff for Tcl/Tk man pages t wh -1 3i ^B ^l n( l b ' " # Start an argument description AP !" $4"" TP $4 { !" $2"" TP n()Cu 15
|