RTEMS Logo

RTEMS 4.6.2 On-Line Library


Process Dump Control Manager dump_setpath - Dump File Control

PREV UP next Bookshelf New Chapters

2.4.1: dump_setpath - Dump File Control

CALLING SEQUENCE:

#include <dump.h>

int dump_setpath(
  const char      *path
);

STATUS CODES:

EACESS
Search permission is denied for a component of the path prefix, or write permission is denied on the directory containing the file.
ENAMETOOLONG
The length of the argument exceeds PATH_MAX or a pathname component is longer than NAME_MAX while _POSIX_NO_TRUNC is in effect.
ENOENT
The path argument points to an empty string.
ENOTDIR
A component of the path prefix is not a directory.
EROFS
The directory entry specified resides on a read-only file system.

DESCRIPTION:

The dump_setpath() function defines the pathname where process dumps are written. The pathname pointed to by path defines where a process dump file is written if the calling process terminates with a dump file. The path argument does not name a directory.

If the path argument is NULL, the system does not write a process dump file if the calling process terminates with a dump file. If the dump_setpath function fails, the pathname for writing process dumps does not change.

NOTES:

The _POSIX_DUMP feature flag is defined to indicate this service is available.


PREV UP next Bookshelf New Chapters

Copyright © 1988-2004 OAR Corporation