DMSTAT(5ICD)

NAME
dmStat - get DDM stream status

SYNOPSIS

#include <sys/types.h>
#include <sys/stat.h>
#include "dmincl.h"
dmStat (key, stream, buf)
DM_CELL *key;
char *stream;
struct stat *buf;

PARAMETERS
is a pointer to a valid DM_CELL as obtained from function dmCheckOut(). names the stream which status must be determined. The stream is not a composite name (doesn't contain '/'s). It can be a buildin or full name, see dmOpenStream(5ICD). the address of the buffer where the status information is placed.

DESCRIPTION
Function dmStat() can be used after dmCheckOut() to get status information of the named DDM stream of the cell with the given access key.

DIAGNOSTICS
If the call is successful, dmStat() returns 0 and status information is available. If dmStat() fails -1 will be returned, dmerrno will be set to indicate the error.
This might happen in the following cases:

DME_BADKEY
    No valid cell key given. A call to function dmError() is done.

DME_SYS
    Call to stat() fails, database stream does not exist. Function dmError() is not called.

SEE ALSO
stat(2), dmOpenStream(5ICD).