Open System Services Programmer's Guide

OSS Time-Management Functions
Table 16 (page 170) displays information about each OSS function that you can use to manage
time. The columns of the table contain the following:
OSS Function
The name of the function and a brief description.
OSS Notes
Notes about the OSS implementation of the function. The note “Can return extended errors”
means that the function can return errors that are HP extensions to the XPG4 specification.
Refer to the function’s reference page for further information.
Guardian Notes
Notes about using the function when it is called from a Guardian process.
The note “FDM set” (for file, directory, and memory) means that the function is one of a set of
functions that have the following effects when the first of them is called from the Guardian
environment:
• Two Guardian file-system numbers (not necessarily the next two available) are allocated
for the root directory and the current working directory. These file numbers cannot be
closed by calling the Guardian FILE_CLOSE_ procedure.
• The current working directory is assigned from the VOLUME attribute of the Guardian
environment =_DEFAULTS DEFINE.
• The use of static memory by the process increases slightly.
• The functions in the FDM set are access(), chdir(), chmod(), chown(), chroot(),
creat(), creat64()fchmod(), fchown(), fstatvfs(), fstatvfs64(), ftok(),
ftw(), ftw64(), getcwd(), glob(), lchmod(), lchown(), link(), lstat(),
lstat64(), mkdir(), mkfifo(), mknod(), nftw(), nftw64(),open(),
open64(),opendir(), pathconf(), pipe(), readlink(), rename(),
rename_oss(), rmdir(), select(), socket(), socketpair(), stat(),
stat64(), statvfs(),statvfs64(), symlink(), unlink(), and utime().
The information in this table is only a summary of the information in the reference page for a
function. For details, refer to the reference pages either online or in the Open System Services
System Calls Reference Manual and the Open System Services Library Calls Reference Manual.
Example 42 (page 170) shows the use of the gettimeofday() function to get date to the nearest
microsecond. The function is provided for compatibility with BSD programs.
OSS Time-Management Functions 169