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



-------------------------------------------------------------------------------
disclaim



PURPOSE

Disclaims content of a memory address range.

SYNTAX

#include <sys/shm.h>

int disclaim (addr, length, flag)
char *addr;
unsigned int length, flag;

DESCRIPTION

The disclaim system call marks an area of memory that has content that is no
longer needed.  This allows the system to discontinue paging the memory area.

The addr parameter points to the beginning of the memory area, and the length
parameter specifies its length in bytes.  The flag parameter must be the value
ZERO_MEM, which indicates that each memory location in the address range is to
be set to 0.

RETURN VALUE

Upon successful completion, the disclaim system call returns a value of 0.  If
it fails, it returns a value of -1 and sets errno to indicate the error.

ERROR CONDITIONS

The disclaim system call fails if one or more of the following is true:

EFAULT  The calling process does not have write access to the area of memory
        that begins at address and extends for length bytes.

EINVAL  The value of the flag parameter is not valid.

RELATED INFORMATION

In this book:  "shmat" and "shmctl."











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