src/lib/libc/gen/getcap.3 - diff

Return to getcap.3 CVS log

Up to [cvs.NetBSD.org] / src / lib / libc / gen

Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.

Diff for /src/lib/libc/gen/Attic/getcap.3 between version 1.10 and 1.21

version 1.10, 1998/04/29 19:12:09

version 1.21, 2005/04/12 16:11:33

Line 14

.\" 2. Redistributions in binary form must reproduce the above copyright

.\" notice, this list of conditions and the following disclaimer in the

.\" documentation and/or other materials provided with the distribution.

.\" 3. All advertising materials mentioning features or use of this software

.\" 3. Neither the name of the University nor the names of its contributors

.\" must display the following acknowledgement:

.\" This product includes software developed by the University of

.\" California, Berkeley and its contributors.

.\" 4. Neither the name of the University nor the names of its contributors

.\" may be used to endorse or promote products derived from this software

.\" without specific prior written permission.

.\"

Line 36

Line 32

.\"

.\" @(#)getcap.3 8.4 (Berkeley) 5/13/94

.\"

.Dd May 13, 1994

.Dd April 23, 2004

.Dt GETCAP 3

.Os

.Sh NAME

Line 54

Line 50

.Sh LIBRARY

.Lb libc

.Sh SYNOPSIS

.Fd #include <stdlib.h>

.In stdlib.h

.Ft int

.Fn cgetent "char **buf" "char **db_array" "char *name"

.Fn cgetent "char **buf" "const char * const *db_array" "const char *name"

.Ft int

.Fn cgetset "char *ent"

.Fn cgetset "const char *ent"

.Ft int

.Fn cgetmatch "char *buf" "char *name"

.Fn cgetmatch "const char *buf" "const char *name"

.Ft char *

.Fn cgetcap "char *buf" "char *cap" "char type"

.Fn cgetcap "char *buf" "const char *cap" "int type"

.Ft int

.Fn cgetnum "char *buf" "char *cap" "long *num"

.Fn cgetnum "char *buf" "const char *cap" "long *num"

.Ft int

.Fn cgetstr "char *buf" "char *cap" "char **str"

.Fn cgetstr "char *buf" "const char *cap" "char **str"

.Ft int

.Fn cgetustr "char *buf" "char *cap" "char **str"

.Fn cgetustr "char *buf" "const char *cap" "char **str"

.Ft int

.Fn cgetfirst "char **buf" "char **db_array"

.Fn cgetfirst "char **buf" "const char * const *db_array"

.Ft int

.Fn cgetnext "char **buf" "char **db_array"

.Fn cgetnext "char **buf" "const char * const *db_array"

.Ft int

.Fn cgetclose "void"

.Sh DESCRIPTION

Line 105 must be retained through all subsequent

Line 101 must be retained through all subsequent

and

.Fn cgetustr ,

but may then be

.Xr free 3 Ns \&'d.

.Xr free 3 Ns \&'d .

.Pp

On success 0 is returned, 1 if the returned record contains an unresolved

.Qq tc

Line 289 database begins:

Line 285 database begins:

giving four names that can be used to access the record.

.Pp

The remaining non-empty capabilities describe a set of (name, value)

bindings, consisting of a names optionally followed by a typed values:

bindings, consisting of a name optionally followed by a typed value:

.Bl -column "nameTvalue"

.It name Ta "typeless [boolean] capability"

.Em name No "is present [true]"

Line 423 overrides the definition of

Line 419 overrides the definition of

interpolated from the capability record

.Em old

.Fa file2,

.Fa file2 ,

.Qq who-cares@

prevents the definition of any who-cares definitions in

.Em old

Line 452 Two types are predefined by

Line 448 Two types are predefined by

and

.Fn cgetstr :

.Bl -column "nameXnumber"

.Sm off

.It Em name Ns \&# Ns Em number Ta numeric

.It Em name No \&# Em number Ta numeric

capability

.Em name

has value

.Em number

.It Em name No = Em string Ta "string capability"

.It Em name Ns = Ns Em string Ta "string capability"

.Em name

has value

.Em string

.It Em name No \&#@ Ta "the numeric capability"

.It Em name Ns \&#@ Ns Ta "the numeric capability"

.Em name

does not exist

.It Em name No \&=@ Ta "the string capability"

.It Em name Ns \&=@ Ns Ta "the string capability"

.Em name

does not exist

.El

Line 488 Non-printable

Line 483 Non-printable

codes, new lines, and colons may be conveniently represented by the use

of escape sequences:

.Bl -column "\e\|X,X\e\|X" "(ASCII octal nnn)"

^X ('\fIX\fP' & 037) control-\fIX\fP

^X ('\fIX\fP' \*[Am] 037) control-\fIX\fP

\e\|b, \e\|B (ASCII 010) backspace

\e\|t, \e\|T (ASCII 011) tab

\e\|n, \e\|N (ASCII 012) line feed (newline)

Line 501 of escape sequences:

Line 496 of escape sequences:

\e\|\fInnn\fP (ASCII octal \fInnn\fP)

.El

.Pp

A `\|\e' may be followed by up to three octal digits directly specifies

A `\|\e' followed by up to three octal digits directly specifies

the numeric code for a character.

The use of

.Tn ASCII

Line 531 on failure.

Line 526 on failure.

.Pp

.Fn cgetent ,

and

.Fn cgetseq

.Fn cgetset

may fail and set

.Va errno

for any of the errors specified for the library functions:

CVSweb <webmaster@jp.NetBSD.org>