@c
|
@c
|
@c COPYRIGHT (c) 1988-2002.
|
@c COPYRIGHT (c) 1988-2002.
|
@c On-Line Applications Research Corporation (OAR).
|
@c On-Line Applications Research Corporation (OAR).
|
@c All rights reserved.
|
@c All rights reserved.
|
@c
|
@c
|
@c dumpcontrol.t,v 1.13 2002/01/17 21:47:45 joel Exp
|
@c dumpcontrol.t,v 1.13 2002/01/17 21:47:45 joel Exp
|
@c
|
@c
|
|
|
@chapter Process Dump Control Manager
|
@chapter Process Dump Control Manager
|
|
|
@section Introduction
|
@section Introduction
|
|
|
The process dump control manager provides a portable
|
The process dump control manager provides a portable
|
interface for changing the path to which a process dump
|
interface for changing the path to which a process dump
|
is written. The capabilities in this manager were defined in
|
is written. The capabilities in this manager were defined in
|
the POSIX 1003.1h/D3 proposed standard titled @b{Services for Reliable,
|
the POSIX 1003.1h/D3 proposed standard titled @b{Services for Reliable,
|
Available, and Serviceable Systems}.
|
Available, and Serviceable Systems}.
|
|
|
The directives provided by the process dump control manager are:
|
The directives provided by the process dump control manager are:
|
|
|
@itemize @bullet
|
@itemize @bullet
|
@item @code{dump_setpath} - Dump File Control
|
@item @code{dump_setpath} - Dump File Control
|
@end itemize
|
@end itemize
|
|
|
@section Background
|
@section Background
|
|
|
There is currently no text in this section.
|
There is currently no text in this section.
|
|
|
@section Operations
|
@section Operations
|
|
|
There is currently no text in this section.
|
There is currently no text in this section.
|
|
|
@section Directives
|
@section Directives
|
|
|
This section details the process dump control manager's directives.
|
This section details the process dump control manager's directives.
|
A subsection is dedicated to each of this manager's directives
|
A subsection is dedicated to each of this manager's directives
|
and describes the calling sequence, related constants, usage,
|
and describes the calling sequence, related constants, usage,
|
and status codes.
|
and status codes.
|
|
|
@page
|
@page
|
@subsection dump_setpath - Dump File Control
|
@subsection dump_setpath - Dump File Control
|
|
|
@subheading CALLING SEQUENCE:
|
@subheading CALLING SEQUENCE:
|
|
|
@ifset is-C
|
@ifset is-C
|
@example
|
@example
|
#include
|
#include
|
|
|
int dump_setpath(
|
int dump_setpath(
|
const char *path
|
const char *path
|
);
|
);
|
@end example
|
@end example
|
@end ifset
|
@end ifset
|
|
|
@ifset is-Ada
|
@ifset is-Ada
|
@end ifset
|
@end ifset
|
|
|
@subheading STATUS CODES:
|
@subheading STATUS CODES:
|
|
|
@table @b
|
@table @b
|
@item EACESS
|
@item EACESS
|
Search permission is denied for a component of the path prefix,
|
Search permission is denied for a component of the path prefix,
|
or write permission is denied on the directory containing the
|
or write permission is denied on the directory containing the
|
file.
|
file.
|
|
|
@item ENAMETOOLONG
|
@item ENAMETOOLONG
|
The length of the argument exceeds @code{PATH_MAX} or a pathname
|
The length of the argument exceeds @code{PATH_MAX} or a pathname
|
component is longer than @code{NAME_MAX} while @code{_POSIX_NO_TRUNC}
|
component is longer than @code{NAME_MAX} while @code{_POSIX_NO_TRUNC}
|
is in effect.
|
is in effect.
|
|
|
@item ENOENT
|
@item ENOENT
|
The path argument points to an empty string.
|
The path argument points to an empty string.
|
|
|
@item ENOTDIR
|
@item ENOTDIR
|
A component of the path prefix is not a directory.
|
A component of the path prefix is not a directory.
|
|
|
@item EROFS
|
@item EROFS
|
The directory entry specified resides on a read-only file system.
|
The directory entry specified resides on a read-only file system.
|
|
|
@end table
|
@end table
|
|
|
@subheading DESCRIPTION:
|
@subheading DESCRIPTION:
|
|
|
The @code{dump_setpath()} function defines the pathname where process
|
The @code{dump_setpath()} function defines the pathname where process
|
dumps are written. The pathname pointed to by @code{path} defines
|
dumps are written. The pathname pointed to by @code{path} defines
|
where a process dump file is written if the calling process
|
where a process dump file is written if the calling process
|
terminates with a dump file. The @code{path} argument does not
|
terminates with a dump file. The @code{path} argument does not
|
name a directory.
|
name a directory.
|
|
|
If the @code{path} argument is NULL, the system does not write a
|
If the @code{path} argument is NULL, the system does not write a
|
process dump file if the calling process terminates with a dump
|
process dump file if the calling process terminates with a dump
|
file. If the @code{dump_setpath} function fails, the pathname for
|
file. If the @code{dump_setpath} function fails, the pathname for
|
writing process dumps does not change.
|
writing process dumps does not change.
|
|
|
@subheading NOTES:
|
@subheading NOTES:
|
|
|
The @code{_POSIX_DUMP} feature flag is defined to indicate
|
The @code{_POSIX_DUMP} feature flag is defined to indicate
|
this service is available.
|
this service is available.
|
|
|