NAME

       dpm_rmpool - remove a disk pool definition

SYNOPSIS

       #include <sys/types.h>
       #include "dpm_api.h"

       int dpm_rmpool (char *poolname)

DESCRIPTION

       dpm_rmpool removes a disk pool definition.

       poolname
              specifies the disk pool name.

       This function requires ADMIN privilege.

RETURN VALUE

       This  routine  returns 0 if the operation was successful or -1 if the operation failed. In
       the latter case, serrno is set appropriately.

ERRORS

       ENOENT       Pool does not exist.

       EACCES       The caller does not have ADMIN privilege.

       EFAULT       poolname is a NULL pointer.

       EEXIST       Space token still associated with poolname.

       EINVAL       The length of poolname exceeds CA_MAXPOOLNAMELEN.

       SENOSHOST    Host unknown.

       SEINTERNAL   Database error.

       SECOMERR     Communication error.