chlwm(2) — AIX PS/2 1.2.1



CHLWM(2,L)                  AIX Technical Reference                  CHLWM(2,L)



-------------------------------------------------------------------------------
chlwm



PURPOSE

Updates the low-water mark of a file system.

SYNTAX

#include <sys/types.h>

commitcnt_t chlwm(gfs, site, lwm)
gfs_t gfs;
siteno_t site;
commitcnt_t lwm;

DESCRIPTION

The chlwm system call sets the low-water mark of the local site's copy of the
file system identified by gfs to the greater of lwm and the current file
system's low-water mark.  It returns the previous low-water mark.

If site is not the local site, the low-water mark is returned, but the remote
file system is not changed.

The low-water mark is a field in the superblock of a replicated file system
copy which records which changes have already been propagated to this copy from
the primary copy.  It is normally updated by the AIX kernel as changes made to
the primary copy are automatically propagated to the copy.  When propagation is
done outside the kernel by the file system reconciliation procedure (primrec),
the final step in this process is to adjust the low-water mark with this call.
Other programs are not expected to use this system call.  For more information
on replicated file systems see "Distributed File Systems Overview" in AIX/370
Administration Guide.

You must have superuser authority to call chwlm().

ERROR CONDITIONS

If chlwm fails, it returns a value of -1 and sets the following error codes:

EPERM     The user was not superuser.

EBADST    The site was 0.

ENOSTORE  The specified file system is not a replicated file system.

ENOSTORE  The specified file system was not mounted.





Processed November 7, 1990        CHLWM(2,L)                                  1



CHLWM(2,L)                  AIX Technical Reference                  CHLWM(2,L)



EINVAL    The specified file system was not mounted at site or is not a
          replicated file system.

ESITEDN1  The site cannot be accessed because a site went down.

ESITEDN2  The operation was terminated because a site failed.

RELATED INFORMATION

In this book:  "spropin," "raccept," and "fs."

The primrec and recmstr commands in AIX Operating System Commands Reference.











































Processed November 7, 1990        CHLWM(2,L)                                  2

Museum

Related Articles