dg_stat(5) DG/UX 5.4R3.00 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 stblksize;
long stnewblocks;
char stfstype[STFSTYPSZ];
char stpadding[114];
unsigned long stblocks;
modet extendedmode;
unsigned long dataelementblocks;
unsigned long indexelementblocks;
unsigned long maxcpdblocks;
unsigned long maxcpdfilenodes;
unsigned long curcpdblocks;
unsigned long curcpdfilenodes;
long filesizeextender;
};
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.
Licensed material--property of copyright holder(s) 1
dg_stat(5) DG/UX 5.4R3.00 dg_stat(5)
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.
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.
Licensed material--property of copyright holder(s) 2
dg_stat(5) DG/UX 5.4R3.00 dg_stat(5)
stcusec
The extended-precision portion of st_ctime, in microseconds.
If such precision is not available, this field will be zero.
stblksize
The number of bytes is a basic block for the file. For an
ordinary file, this will be the number of bytes in a data
element.
stnewblocks
The actual number of blocks allocated for the file. This is
the same as the st_blocks field and was replaced by it. This
field is defined as a placeholder for the stat structure which
is a substructure of the dg_stat structure.
stfstype
The type string that identifies the file system type that the
file resides on. An example for the local file system would
be the string "dg/ux".
stpadding
Reserved space.
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
Licensed material--property of copyright holder(s) 3
dg_stat(5) DG/UX 5.4R3.00 dg_stat(5)
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.
filesizeextender
Reserved for future use. Currently set to 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)
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