Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
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 cata- log 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. Oth- erwise, a value of -1 is returned and errno is set to indi- cate 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).