Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

System Functions (s and S) SPT_LOCKFILE(2)

Use on OSS Objects

This procedure operates only on Guardian objects. If an OSS ﬁle is speciﬁed, Guardian ﬁle-

system error 2 occurs.

RETURN VALUES

The SPT_LOCKFILE() function returns 0 (zero) upon successful completion. Otherwise, this

function returns a nonzero Guardian ﬁle-system error number that indicates the outcome of the

operation.

For information about Guardian ﬁle-system error numbers, see the Guardian Procedure Errors

and Messages Manual.

ERRORS

None. This function does not set the errno variable.

RELATED INFORMATION

Functions: SPT_CANCEL(2), SPT_CONTROL(2), SPT_FILE_CLOSE_(2),

SPT_FILE_OPEN_(2), SPT_LOCKREC(2), SPT_READLOCKX(2),

SPT_READUPDATELOCKX(2), SPT_READUPDATEX(2), SPT_READX(2),

SPT_SETMODE(2), SPT_UNLOCKFILE(2), SPT_UNLOCKREC(2),

SPT_WRITEREADX(2), SPT_WRITEUPDATEUNLOCKX(2),

SPT_WRITEUPDATEX(2), SPT_WRITEX(2).

STANDARDS CONFORMANCE

This function is an extension to the UNIX 98 speciﬁcation. Interfaces documented on this refer-

ence page conform to the following industry standards:

• IEEE Std 1003.1c-1995, POSIX System Application Program Interface

The use of the header ﬁle spthread.h is an HP exception to the POSIX standard.

527186-023 Hewlett-Packard Company 7−285