fstyp_strerror(3FSTYP) File System Type Identification Library Functions fstyp_strerror(3FSTYP)NAME
fstyp_strerror - get error message string
SYNOPSIS
cc [ flag... ] file... -lfstyp-lnvpair [ library... ]
#include <libnvpair.h>
#include <libfstyp.h>
const char *fstyp_strerror(fstyp_handle_t handle, int error);
PARAMETERS
handle Opaque handle returned by fstyp_init(3FSTYP). This argument is optional and can be 0.
error Error value returned by a libfstyp function.
DESCRIPTION
The fstyp_strerror() function maps the error value to an error message string and returns a pointer to that string. The returned string
should not be overwritten.
The following error values are defined:
FSTYP_ERR_NO_MATCH No file system match.
FSTYP_ERR_MULT_MATCH Multiple file system matches.
FSTYP_ERR_HANDLE Invalid handle.
FSTYP_ERR_OFFSET Supplied offset is invalid or unsupported by the module.
FSTYP_ERR_NO_PARTITION Specified partition not found.
FSTYP_ERR_NOP No such operation.
FSTYP_ERR_DEV_OPEN Device cannot be opened.
FSTYP_ERR_IO I/O error.
FSTYP_ERR_NOMEM Out of memory.
FSTYP_ERR_MOD_NOT_FOUND Requested file system module not found.
FSTYP_ERR_MOD_DIR_OPEN Directory cannot be opened.
FSTYP_ERR_MOD_OPEN Module cannot be opened.
FSTYP_ERR_MOD_INVALID Invalid module version.
FSTYP_ERR_NAME_TOO_LONG File system name length exceeds system limit.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO fstyp_init(3FSTYP), libfstyp(3LIB), attributes(5)SunOS 5.11 20 Jun 2006 fstyp_strerror(3FSTYP)
Check Out this Related Man Page
fstyp_init(3FSTYP) File System Type Identification Library Functions fstyp_init(3FSTYP)NAME
fstyp_init, fstyp_fini - initialize and finalize libfstyp handle
SYNOPSIS
cc [ flag... ] file... -lfstyp-lnvpair [ library... ]
#include <libnvpair.h>
#include <libfstyp.h>
int fstyp_init(int fd, off64_t **offset, char *module_dir,
fstyp_handle_t *handle);
void fstyp_fini(void *handle);
PARAMETERS
fd Open file descriptor of a block or a raw device that contains the file system to be identified.
offset Offset from the beginning of the device where the file system is located.
module_dir Optional location of the libfstyp modules.
handle Opaque handle to be used with libfstyp functions.
DESCRIPTION
The fstyp_init() function returns a handle associated with the specified parameters. This handle should be used with all other libfstyp
functions.
If module_dir is NULL, fstyp_init() looks for modules in the default location: /usr/lib/fs subdirectories. The fstyp_init() function
locates libfstyp modules, but might defer loading the modules until the subsequent fstyp_ident() call.
If module_dir is other than NULL, the fstyp_init() function locates a module in the directory that is specified. If no module is found,
fstyp_init fails with FSTYP_ERR_MOD_NOT_FOUND.
Modules that do not support non-zero offset can fail fstyp_init() with FSTYP_ERR_OFFSET.
The fstyp_fini() function releases all resources associated with a handle and invalidates the handle.
RETURN VALUES
The fstyp_init() function returns 0 on success and an error value on failure. See fstyp_strerror(3FSTYP).
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO fstyp_ident(3FSTYP), fstyp_mod_init(3FSTYP), fstyp_strerror(3FSTYP), libfstyp(3LIB), attributes(5)SunOS 5.11 20 Jun 2006 fstyp_init(3FSTYP)