dg_stat(5) DG/UX 5.4.2 dg_stat(5)
NAME
dgstat - data returned by dg_stat and dg_fstat system call
SYNOPSIS
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/dgstat.h>
DESCRIPTION
The system calls dgstat, and dgfstat return data whose structure is
defined by this include file.
struct dgstat
{
devt stdev;
inot stino;
modet stmode;
nlinkt stnlink;
uidt stuid;
gidt stgid;
devt strdev;
offt stsize;
timet statime;
unsigned long stausec;
timet stmtime;
unsigned long stmusec;
timet stctime;
unsigned long stcusec;
long stpad1[114];
unsigned long stblocks;
modet extendedmode;
unsigned long dataelementblocks;
unsigned long indexelementblocks;
unsigned long maxcpdblocks;
unsigned long maxcpdfilenodes;
unsigned long curcpdblocks;
unsigned long curcpdfilenodes;
};
The fields of this structure are defined as follows:
stdev An identifier of the flat file store containing the file. The
meaning of this field is the same as that of the field of the
same name in the stat structure.
stino An identifier of the per-file database within the flat file
store. The meaning of this field is the same as that of the
field of the same name in the stat structure.
stmode
The mode of the file, encoded using the constants defined in
stat.h. The meaning of this field is the same as that of the
field of the same name in the stat structure.
Licensed material--property of copyright holder(s) 1
dg_stat(5) DG/UX 5.4.2 dg_stat(5)
stnlink
The number of links to the file. The meaning of this field is
the same as that of the field of the same name in the stat
structure.
stuid The user-id of the file. The meaning of this field is the
same as that of the field of the same name in the stat
structure.
stgid The group-id of the file. The meaning of this field is the
same as that of the field of the same name in the stat
structure.
strdev
The represented device, giving the major and minor device
numbers of the device represented by a special file. This
field is meaningful only if the file is of type `block-
special' or `character-special'. The meaning of this field is
the same as that of the field of the same name in the stat
structure.
stsize
The size of the file in bytes. The meaning of this field is
the same as that of the field of the same name in the stat
structure.
statime
The last time the file was accessed. The meaning of this
field is the same as that of the field of the same name in the
stat structure.
stausec
The extended-precision portion of st_atime, in microseconds.
If such precision is not available, this field will be zero.
stmtime
The last time the file's contents were modified. The meaning
of this field is the same as that of the field of the same
name in the stat structure.
stmusec
The extended-precision portion of st_mtime, in microseconds.
If such precision is not available, this field will be zero.
stctime
The last time the file's attributes were changed. The meaning
of this field is the same as that of the field of the same
name in the stat structure.
stcusec
The extended-precision portion of st_ctime, in microseconds.
If such precision is not available, this field will be zero.
stpad Reserved space.
Licensed material--property of copyright holder(s) 2
dg_stat(5) DG/UX 5.4.2 dg_stat(5)
stblocks
The actual number of blocks allocated for the file.
extendedmode
The extended mode of the file, encoded using the constants
defined below and in stat.h.
dataelementblocks
The number of 512-byte blocks used in each of the file's data
elements.
indexelementblocks
The number of 512-byte blocks used in each of the file's index
elements.
maxcpdblocks
The maximum number of 512-byte blocks that can be allocated by
this file and all of its space descendants. This field has
meaning only if the file is a control-point directory.
Otherwise, it will be zero. A node is a space descendant of a
CPD if it is found in the directory tree descending from the
CPD and if no file system mount point boundaries are crossed.
maxcpdfilenodes
The maximum number of file nodes that can be allocated by this
file and all of its space descendants. This field has meaning
only if the file is a control-point directory. Otherwise, it
will be zero.
curcpdblocks
The current number of 512-byte blocks that have been allocated
by this file and all of its space descendants. This field has
meaning only if the file is a control-point directory.
Otherwise, it will be zero.
curcpdfilenodes
The current number of file nodes that have been allocated by
this file and all of its space descendants. This field has
meaning only if the file is a control-point directory.
Otherwise, it will be zero.
#define DG_FILE_TYPE_MASK ((unsigned_long) 0xFFFFF000)
The bitmask used to extract the file's type from the extendedmode
field. The result of AND-ing the file's extendedmode with this mask
will be one of the following: DG_IFCPD, S_IFDIR, S_IFCHR, S_IFBLK,
S_IFREG, S_IFLNK, S_IFIFO, S_IFSOCK. Logically, this field is
equivalent to the S_IFMT mask defined in stat.h, except that
DG_FILE_TYPE_MASK allows for detection of DG/UX-only extended file
types, such as DG_IFCPD (see below).
#define DG_IFCPD ((unsigned long) 0x00010000)
Licensed material--property of copyright holder(s) 3
dg_stat(5) DG/UX 5.4.2 dg_stat(5)
Control-point directory file type.
#define DG_IFSTREAMS ((unsigned long) 0x00020000)
Streams special file type.
FILES
/usr/include/sys/dgstat.h
/usr/include/sys/types.h
SEE ALSO
dgstat(2), dgfstat(2), stat(5), types(5).
Licensed material--property of copyright holder(s) 4