Start of change

gpfs_close_watch subroutine

Destroys resources that are associated with a parent watch descriptor (pwd).

Library

GPFS™ Library (libgpfswatch.so for Linux)

Synopsis

#include  <gpfs_watch.h>
int gpfs_close_watch(
             int pwd)

Description

For an overview of watch folder, see Introduction to watch folder.

Parameters

pwd
The parent watch descriptor that is returned by gpfs_init_watch.

Exit status

The gpfs_close_watch subroutine returns 0 on success or -1 on failure.

Error status

Errno is set if -1 is returned.

Note: Further errnos might be reported depending on the inner instrumentation of the API. Use gpfs_watch_strerror to learn more about an error.

Examples

For an example using gpfs_*_watch, see /usr/lpp/mmfs/samples/util/tswf.C.

Location

/usr/lpp/mmfs/lib/libgpfswatch.so for Linux

End of change