sam_closecat(3)

NAME
sam_closecat - Closes a catalog handle

SYNOPSIS

cc [ flag ... ] file ... -L/opt/SUNWsamfs/lib -lsam [ library ... ]

#include "/opt/SUNWsamfs/include/catalog.h"

int sam_closecat(int cat_handle);

AVAILABILITY
32-bit programs only

DESCRIPTION
sam_closecat() deallocates the catalog handle indicated by cat_handle. cat_handle is a catalog "handle" obtained from a previous call to sam_opencat(). Deallocation of the catalog handle ends access to the automated library catalog that it referred to, and makes the catalog handle available for return by subsequent calls to sam_opencat().

RETURN VALUES
Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned and errno is set to indicate the error.

ERRORS

sam_closecat() fails if one or more of the following error conditions are true:

EBADFILE
    cat_handle is invalid.

SEE ALSO
sam_getcatalog(3), sam_opencat(3).