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

System Functions (s and S) SPT_FILE_CLOSE_(2)

Closing a nowait file open

If an SPT_FILE_CLOSE_() call is executed for a nowait ﬁle that has pending

operations, any incomplete operations are canceled. There is no indication as to

whether the operation completed or not.

Labeled tape processing

If your system has labeled tape processing enabled, all tape actions (as speciﬁed

by tape_disposition) wait for completion.

Process close message

A process can receive a process close system message when it is closed by

another process. It can obtain the process handle of the closer by a subsequent

call to the Guardian FILE_GETRECEIVEINFO_ procedure. For detailed infor-

mation about system messages, see the Guardian Procedure Errors and Mes-

sages Manual.

This message is also received if the close is made by the backup process of a

process pair. Therefore, a process can expect two of these messages when being

closed by a process pair.

RETURN VALUES

The SPT_FILE_CLOSE_ () 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_OPEN_(2),

SPT_LOCKFILE(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_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−189