HP-UX Reference (11i v1 00/12) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

231

232

233

234

235

236

237

238

239

240

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man2/!!!intro.2

________________________________________________________________

___ ___

pstat(2) pstat(2)

pstat_getdisk()

Returns information speciﬁc to a particular disk. There is one instance of this context for

each disk conﬁgured into the system. For each instance requested, data, up to a maximum

of elemsize bytes, are returned in the structs pst_diskinfo pointed to by buf.

The elemcount parameter speciﬁes the number of structs pst_diskinfo that are

available at buf to be ﬁlled in. The index parameter speciﬁes the starting index within

the context of disks.

pstat_getdynamic()

Returns dynamic information about the system. There is one global instance of this con-

text. Data, up to a maximum of elemsize bytes, are returned in the struct

pst_dynamic

pointed to by buf. The elemcount parameter must be 1. The index

parameter must be 0.

pstat_getfile()

This call is now obsolete and is provided for backward compatibility only. Use of

pstat_getfile2() call is recommended. Returns information speciﬁc to a particular

open ﬁle for a speciﬁed process. For the speciﬁed process, there is one instance of this con-

text for each open ﬁle descriptor. For each instance requested, data, up to a maximum of

elemsize bytes, are returned in the structs

pst_fileinfo pointed to by buf. The

elemcount parameter speciﬁes the number of struct

s pst_fileinfo that are

available at

buf to be ﬁlled in. The index parameter speciﬁes the starting index within

the context of open ﬁles for the speciﬁed process: it is a 32-bit quantity constructed of the

pst_idx ﬁeld of the ’owning’ process, obtained via pstat_getproc()

, described

above, as the most signiﬁcant 16 bits, and the index of open ﬁles within the process as the

least signiﬁcant 16 bits. Example:

index = ((pst_idx << 16) | (file_index & 0xffff)); As a shortcut,

information for a single ﬁle within the speciﬁed process may be obtained by setting elem-

count

to zero and setting the least signiﬁcant 16 bits to the ﬁle descriptor number (the

most signiﬁcant 16 bits are still set to the pst_idx ﬁeld from the pst_status

struc-

ture for the process).

The

pst_fileinfo structure contains both a psf_offset and psf_offset64 ele-

ment. The psf_offset element can correctly store a 32-bit value, whereas the

psf_offset64 element can store a 64-bit value. pstat_getfile()

will ﬁll in both

psf_offset and psf_offset64 if the value can be correctly stored in both elements.

If the offset is too large to be correctly stored in psf_offset , then psf_offset

will

contain a -1. No error will be set in this case.

pstat_getfile2()

Returns information speciﬁc to a particular open ﬁle for a speciﬁed process. For the

speciﬁed process, there is one instance of this context for each open ﬁle descriptor. For

each instance requested, data, up to a maximum of

elemsize bytes, are returned in the

structs pst_fileinfo2 pointed to by buf. The elemcount parameter speciﬁes

the number of structs pst_fileinfo2 that are available at buf to be ﬁlled in. The

index parameter speciﬁes the starting index within the context of open ﬁles for the

speciﬁed process: It is the ﬁle descriptor number with which to begin. The pid

parameter

speciﬁes the process ID.

As a shortcut, information for a single ﬁle within the speciﬁed process may be obtained by

setting

elemcount to zero and setting the index to the ﬁle descriptor number.

The pst_fileinfo2 structure contains both a

psf_offset and psf_offset64

element. The psf_offset element can correctly store a 32-bit value, whereas the

psf_offset64 element can store a 64-bit value. pstat_getfile2() will ﬁll in both

psf_offset and psf_offset64 if the value can be correctly stored in both elements.

If the offset is too large to be correctly stored in psf_offset , then psf_offset will

contain a -1. No error will be set in this case.

pstat_getfiledetails()

Returns detailed information speciﬁc to a particular open ﬁle. For a speciﬁed opened ﬁle,

there is only one instance of this context. For each call, data up to a maximum of elem-

size

bytes are returned in the struct pst_filedetails

pointed to by buf. The

fid parameter uniquely identiﬁes the ﬁle. This fid is obtained from calls to

pstat_getfile(), pstat_getproc(), or pstat_getprocvm()

. The

HP-UX Release 11i: December 2000 − 4 − Section 2−−221

___