DCMD_DUMPER_GETPATH
Get the path of the dump file associated with a process ID
Synopsis:
#include <sys/dcmd_dumper.h>
#define DCMD_DUMPER_GETPATH __DIOTF(_DCMD_MISC, DUMPER_GETPATH, dump_info_t)
Arguments to devctl():
| Argument | Value |
|---|---|
| filedes | A file descriptor for the dumper that you obtained by opening /proc/dumper. |
| dcmd | DCMD_DUMPER_GETPATH |
| dev_data_ptr | A pointer to a dump_info_t structure |
| n_bytes | sizeof(dump_info_t) |
| dev_info_ptr | NULL |
Description:
This command gets the path of the dump file associated with a given process ID. To use this command, first use the DCMD_DUMPER_NOTIFYEVENT devctl() command to register for a pulse when the dump completes. When you receive the pulse, use DCMD_DUMPER_GETPATH, passing it the process ID included in the pulse. The command returns the matching pathname if one exists.
DCMD_DUMPER_GETPATH uses a dump_info_t structure for both input and output:
typedef union {
struct {
pid_t pid;
} i;
struct {
char dump_pathname[PATH_MAX];
} o;
} dump_info_t;
Input:
The i (input) member includes:
- pid
- The process ID.
Output:
The o (output) member includes:
- dump_pathname
- The path of the associated dump file.
Errors:
The devctl() function can return the following, in addition to the error codes listed in its entry in the C Library Reference:
- ESRCH
- A dump file couldn't be found for the process ID. This could mean that dumper's list of dump file names isn't big enough; you can use the -E option to specify the number of entries in it.
See also:
DCMD_DUMPER_NOTIFYEVENT, DCMD_DUMPER_REMOVEEVENT
devctl() in the QNX OS C Library Reference
dumper in the Utilities Reference