.In sys/types.h

.In sys/types.h

.In sys/acl.h

.In sys/acl.h

.Sh DESCRIPTION

.Sh DESCRIPTION

.Fx 4.0

.Fx 4.0

permits file systems to export

permits file systems to export

Access Control Lists via the VFS, and provides a library for userland

Access Control Lists via the VFS, and provides a library for userland

.Fn acl_valid_file_np ,

.Fn acl_valid_file_np ,

.Fn acl_valid_fd_np

.Fn acl_valid_fd_np

.Pp

.Pp

.Xr acl_valid 3 ,

.Xr acl_valid 3 ,

and may be used to validate an ACL as correct POSIX.1e-semantics, or

and may be used to validate an ACL as correct POSIX.1e-semantics, or

as appropriate for a particular file system object regardless of semantics.

as appropriate for a particular file system object regardless of semantics.

POSIX.1e is described in IEEE POSIX.1e draft 17.  Discussion

POSIX.1e is described in IEEE POSIX.1e draft 17.  Discussion

of the draft continues on the cross-platform POSIX.1e implementation

of the draft continues on the cross-platform POSIX.1e implementation

mailing list.  To join this list, see the

mailing list.  To join this list, see the

POSIX.1e implementation

POSIX.1e implementation

page for more information.

page for more information.

.Sh HISTORY

.Sh HISTORY

.Fn INVARIANT

.Fn INVARIANT

macros evaluate a boolean expression, and if it is false, they invoke the

macros evaluate a boolean expression, and if it is false, they invoke the

current assertion failure callback.  The default callback will print a message

current assertion failure callback.  The default callback will print a message

.Li stderr

.Li stderr

describing the failure, and then cause the program to dump core.

describing the failure, and then cause the program to dump core.

If the

If the

.Pp

.Pp

When an

When an

.Fn assertion_failure_callback

.Fn assertion_failure_callback

.Fa filename

.Fa filename

and

and

.Fa line

.Fa line

and may be used by the callback to determine the type of the failing

and may be used by the callback to determine the type of the failing

assertion.

assertion.

.Fa condition

.Fa condition

.Fa print_errno

.Fa print_errno

will be non-zero if the callback should print

will be non-zero if the callback should print

as part of its output.

as part of its output.

.Pp

.Pp

.Fn assertion_type_to_text

.Fn assertion_type_to_text

alert is possible, nothing happens.  Nearly all terminals have an audible alert

alert is possible, nothing happens.  Nearly all terminals have an audible alert

(bell or beep), but only some can flash the screen.

(bell or beep), but only some can flash the screen.

.SH RETURN VALUE

.SH RETURN VALUE

\fBERR\fR otherwise.

\fBERR\fR otherwise.

.SH EXTENSIONS

.SH EXTENSIONS

SVr4's beep and flash routines always returned \fBOK\fR, so it was not

SVr4's beep and flash routines always returned \fBOK\fR, so it was not

possible to tell when the beep or flash failed.

possible to tell when the beep or flash failed.

.SH PORTABILITY

.SH PORTABILITY

specifies that they always return \fBOK\fR.

specifies that they always return \fBOK\fR.

.SH SEE ALSO

.SH SEE ALSO

\fBcurses\fR(3X)

\fBcurses\fR(3X)

.PP

.PP

The assumption that \fBCOLOR_BLACK\fR is the default

The assumption that \fBCOLOR_BLACK\fR is the default

background color for all terminals can be modified using the

background color for all terminals can be modified using the

..

..

.SH SEE ALSO

.SH SEE ALSO

\fBcurses\fR(3X),

\fBcurses\fR(3X),

is able to use user-defined or nonstandard names

is able to use user-defined or nonstandard names

which may be compiled into the terminfo

which may be compiled into the terminfo

description, i.e., via the terminfo or termcap interfaces.

description, i.e., via the terminfo or termcap interfaces.

is made by using the \fB-x\fP option of \fItic\fP to compile

is made by using the \fB-x\fP option of \fItic\fP to compile

extended terminal definitions.

extended terminal definitions.

However you can disable this feature

However you can disable this feature

..

..

.SH PORTABILITY

.SH PORTABILITY

These routines are specific to ncurses.  They were not supported on

These routines are specific to ncurses.  They were not supported on

.Fn end_dialog "void"

.Fn end_dialog "void"

.Ft "int"

.Ft "int"

.Fn dialog_ftree "unsigned char *filename" "unsigned char FS" "unsigned char *title" "unsigned char *prompt" "int height" "int width" "int menu_height" "unsigned char **result"

.Fn dialog_ftree "unsigned char *filename" "unsigned char FS" "unsigned char *title" "unsigned char *prompt" "int height" "int width" "int menu_height" "unsigned char **result"

.Fa "int size"

.Fa "int size"

.Fa "unsigned char *prompt"

.Fa "unsigned char *prompt"

.Fa "int menu_height"

.Fa "int menu_height"

.Fa "unsigned char **result"

.Fa "unsigned char **result"

.Fc

.Fc

.Va fire

.Va fire

actions are used to override the default behavior, and

actions are used to override the default behavior, and

.Va it

.Va it

.Pp

.Pp

Using either API behavior, the

Using either API behavior, the

.Va ch

.Va ch

.Va menu_height

.Va menu_height

sets the height of the tree subwindow inside the

sets the height of the tree subwindow inside the

.Fn dialog_ftree

.Fn dialog_ftree

.Va title

.Va title

is shown centered on the upper border of the

is shown centered on the upper border of the

.Fn dialog_ftree

.Fn dialog_ftree

.Fn dialog_ftree

.Fn dialog_ftree

on ESC, the function returns -1.

on ESC, the function returns -1.

.Pp

.Pp

function returns the same results as

function returns the same results as

.Fn dialog_ftree .

.Fn dialog_ftree .

If 0 is returned, result will contain a pointer from the array

If 0 is returned, result will contain a pointer from the array

command and were soon split into a separate library

command and were soon split into a separate library

and command by

and command by

.An Andrey Chernov .

.An Andrey Chernov .

extra controls and objects,

extra controls and objects,

.An Jordan Hubbard

.An Jordan Hubbard

added the dialogMenuItem renovations and this man page and

added the dialogMenuItem renovations and this man page and

.Fa handle

.Fa handle

argument.

argument.

.Ft Link_map

.Ft Link_map

in same order as

in same order as

.Fn dlopen

.Fn dlopen

and

and

  const char      *l_name;   /* Absolute Path to Library */

  const char      *l_name;   /* Absolute Path to Library */

  const void      *l_ld;     /* Pointer to .dynamic in memory */

  const void      *l_ld;     /* Pointer to .dynamic in memory */

  struct link_map *l_next,   /* linked list of of mapped libs */

  struct link_map *l_next,   /* linked list of of mapped libs */

.Ed

.Ed

.Bl -tag -width Ds

.Bl -tag -width Ds

.It l_addr

.It l_addr

.Ed

.Ed

.Sh RETURN VALUES

.Sh RETURN VALUES

.Fn dlinfo

.Fn dlinfo

Whenever an error has been detected, a message detailing it can

Whenever an error has been detected, a message detailing it can

be retrieved via a call to

be retrieved via a call to

.Fn dlerror .

.Fn dlerror .

.Ft int

.Ft int

.Fn evSetIdleTimer "evContext opaqueCtx" "evTimerFunc func" "void *uap" \

.Fn evSetIdleTimer "evContext opaqueCtx" "evTimerFunc func" "void *uap" \

"struct timespec max_idle" "evTimerID *opaqueID"

"struct timespec max_idle" "evTimerID *opaqueID"

.Fn evTouchIdleTimer "evContext opaqueCtx" "evTimerID id"

.Fn evTouchIdleTimer "evContext opaqueCtx" "evTimerID id"

.Fn evResetIdleTimer "evContext opaqueCtx" "evTimerID id" "evTimerFunc func" \

.Fn evResetIdleTimer "evContext opaqueCtx" "evTimerID id" "evTimerFunc func" \

"void *uap" "struct timespec max_idle"

"void *uap" "struct timespec max_idle"

.Ft int

.Ft int

.Fn evCreate

.Fn evCreate

creates an event context which is needed by all the other functions in this

creates an event context which is needed by all the other functions in this

library.  All information used internally by this library is bound to this

library.  All information used internally by this library is bound to this

.Dq thread safe ,

.Dq thread safe ,

and permits other library functions to use events without

and permits other library functions to use events without

disrupting the application's use of events.

disrupting the application's use of events.

.Fa EV_NULL ,

.Fa EV_NULL ,

which tells

which tells

.Fn evGetNext

.Fn evGetNext

event, which is ignored by

event, which is ignored by

.Fn evDispatch

.Fn evDispatch

but handled correctly by

but handled correctly by

.Fn evDrop .

.Fn evDrop .

.Fa EV_NULL

.Fa EV_NULL

.Fn evMainLoop ,

.Fn evMainLoop ,

wherein perterbations caused by external system events must be polled for, and

wherein perterbations caused by external system events must be polled for, and

the default behaviour of internally ignoring such events is undesirable.

the default behaviour of internally ignoring such events is undesirable.

The functions

The functions

.Fn evTimeSpec

.Fn evTimeSpec

and

and

are utilities which allow the caller to convert a

are utilities which allow the caller to convert a

.Dq Fa struct timeval

.Dq Fa struct timeval

.Dq Fa struct timespec

.Dq Fa struct timespec

(the function of

(the function of

.Fn evTimeSpec )

.Fn evTimeSpec )

.Xr gettimeofday 2 . )

.Xr gettimeofday 2 . )

.Pp

.Pp

The function

The function

returns the

returns the

.Dq Fa struct timespec

.Dq Fa struct timespec

.Fa opaqueCtx .

.Fa opaqueCtx .

This value is updated by

This value is updated by

and

and

(upon entry and after

(upon entry and after

.Xr select 2

.Xr select 2

returns); it is routinely compared with other times in the internal handling

returns); it is routinely compared with other times in the internal handling

.Fa due

.Fa due

argument equal to

argument equal to

.Dq Fn evConsTime 0 0

.Dq Fn evConsTime 0 0

.Dq due immediately .

.Dq due immediately .

The

The

.Fa opaqueID

.Fa opaqueID

argument, if specified as a value other than

argument, if specified as a value other than

.Fa NULL ,

.Fa NULL ,

useful as an argument to

useful as an argument to

.Fn evClearTimer .

.Fn evClearTimer .

timer (which has an

timer (which has an

.Fa inter

.Fa inter

argument equal to

argument equal to

will exist within the event library.

will exist within the event library.

.Pp

.Pp

The function

The function

is similar to (and built on)

is similar to (and built on)

.Fn evSetTimer ;

.Fn evSetTimer ;

it registers an idle timer event which provides for the function call to

it registers an idle timer event which provides for the function call to

time has passed since the time the idle timer was

time has passed since the time the idle timer was

.Dq last touched ;

.Dq last touched ;

originally, this is set to the time returned by

originally, this is set to the time returned by

timer, but the time at which the

timer, but the time at which the

.Fa func

.Fa func

is actually called can be changed by recourse to

is actually called can be changed by recourse to

.Fn evTouchIdleTimer

.Fn evTouchIdleTimer

is returned in

is returned in

.Fa opaqueID ,

.Fa opaqueID ,

if it is

if it is

.No non- Ns Dv NULL .

.No non- Ns Dv NULL .

.Pp

.Pp

The

The

function updates the idle timer associated with

function updates the idle timer associated with

.Fa id ,

.Fa id ,

setting its idea of the time it was last accessed to the value returned by

setting its idea of the time it was last accessed to the value returned by

function unregisters the idle timer associated with

function unregisters the idle timer associated with

.Fa id .

.Fa id .

See the discussion under

See the discussion under

above, for information regarding caller handling of the

above, for information regarding caller handling of the

.Fa uap

.Fa uap

associated with the corresponding

associated with the corresponding

on the given event context's wait queue with the associated (possibly

on the given event context's wait queue with the associated (possibly

.Dv NULL )

.Dv NULL )

.Dq Fa tag ;

.Dq Fa tag ;

.Fa id

.Fa id

.No non- Ns Dv NULL ,

.No non- Ns Dv NULL ,

associated with the created queue element.

associated with the created queue element.

.Pp

.Pp

The function

The function

.Em all

.Em all

functions in the given event context's wait queue with the associated (possibly

functions in the given event context's wait queue with the associated (possibly

.Dv NULL )

.Dv NULL )

.Dq Fa tag

.Dq Fa tag

.Fn evGetNext .

.Fn evGetNext .

.Pp

.Pp

The function

The function

will search for the

will search for the

.Fa id

.Fa id

in the wait queue of the given event context; if an element with the given

in the wait queue of the given event context; if an element with the given

is not found, then the

is not found, then the

.Dq done

.Dq done

queue of that context is searched.  If found, the queue element is removed

queue of that context is searched.  If found, the queue element is removed

.Pp

.Pp

The function

The function

.Fn evTimeRW

.Fn evTimeRW

.Dq Fa id

.Dq Fa id

.Dq Fa timer .

.Dq Fa timer .

.Pp

.Pp

The function

The function

.Fn \*(lp*func\*(rp

.Fn \*(lp*func\*(rp

will be

will be

.Fa -1

.Fa -1

successfully.  In this case

successfully.  In this case

.Fn errno

.Fn errno

will have been set and the socket described by

will have been set and the socket described by

.Pp

.Pp

The function

The function

.Fn evInitID

.Fn evInitID

or

or

.Dq evEvent ,

.Dq evEvent ,

which is passed by reference.

which is passed by reference.

to indicate failure.

to indicate failure.

.Sh FILE

.Sh FILE

.Pa heap.h ,

.Pa heap.h ,

.Pa src/lib/isc

.Pa src/lib/isc

.Sy BIND

.Sy BIND

distribution.

distribution.

.Sh ERRORS

.Sh ERRORS

.Fa FD_SETSIZE ,

.Fa FD_SETSIZE ,

meaning that the application's limit is higher than the library's.

meaning that the application's limit is higher than the library's.

.It Bq Er ENOENT

.It Bq Er ENOENT

does not exist.

does not exist.

.It Bq Er EWOULDBLOCK

.It Bq Er EWOULDBLOCK

No events have occurred and the

No events have occurred and the

as being ambiguous here, although only the critical error

as being ambiguous here, although only the critical error

.Er EACCES

.Er EACCES

is really ambiguous),

is really ambiguous),

whether the file exists and has suitable execute permissions.

whether the file exists and has suitable execute permissions.

If it does, they will return immediately with the global variable

If it does, they will return immediately with the global variable

.Va errno

.Va errno

upon which they returned.

upon which they returned.

They now return for

They now return for

.Er ETXTBSY ,

.Er ETXTBSY ,

In particular,

In particular,

.Er EACCES

.Er EACCES

for inaccessible directories in the path prefix is no longer

for inaccessible directories in the path prefix is no longer