fstyp_mod_fini(3fstyp) [opensolaris man page]
fstyp_mod_init(3FSTYP) File System Type Identification Library Functions fstyp_mod_init(3FSTYP) NAME
fstyp_mod_init, fstyp_mod_fini, fstyp_mod_ident, fstyp_mod_get_attr, fstyp_mod_dump - libfstyp module interface SYNOPSIS
cc [ flag... ] file... -lfstyp -lnvpair [ library... ] #include <libnvpair.h> #include <libfstyp.h> int fstyp_mod_init(int fd, off64_t **offset, fstyp_mod_handle_t *handle); void fstyp_mod_fini(fstyp_mod_handle_t handle); int fstyp_mod_ident(fstyp_mod_handle_t handle); int fstyp_mod_get_attr(fstyp_mod_handle_t handle, nvlist_t **attr); int fstyp_mod_dump(fstyp_mod_handle_t handle, FILE *fout, FILE *ferr); 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. handle Opaque handle that the module returns in fstyp_mod_init() and is used with other module functions. fout Output stream. ferr Error stream. DESCRIPTION
A libfstyp module implements heuristics required to identify a file system type. The modules are shared objects loaded by libfstyp. The libfstyp modules are located in /usr/lib/fs subdirectories. A subdirectory name defines the name of the file system. Each module exports the fstyp_mod_init(), fstyp_mod_fini(), fstyp_mod_ident(), and fstyp_mod_get_attr() functions. All of these functions map directly to the respective libfstyp interfaces. The fstyp_mod_dump() function is optional. It can be used to output unformatted information about the file system. This function is used by the fstyp(1M) command when the -v option is specified. The fstyp_mod_dump() function is not recommended and should be used only in legacy modules. FILES
/usr/lib/fs/ Default module directory. /usr/lib/fs/fstype/fstyp.so.1 Default path to a libfstyp module for an fstype file system. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
fstyp(1M), fstyp_strerror(3FSTYP), libfstyp(3LIB), attributes(5) SunOS 5.11 29 Jun 2006 fstyp_mod_init(3FSTYP)
Check Out this Related Man Page
fstyp(1M) System Administration Commands fstyp(1M) NAME
fstyp - determine file system type SYNOPSIS
fstyp [-a | -v] special [:logical-drive] DESCRIPTION
fstyp allows the user to determine the file system type of unmounted file systems using heuristic programs. An fstyp module for each file system type to be checked is executed; each of these modules applies an appropriate heuristic to determine whether the supplied special file is of the type for which it checks. If it is, the program prints on standard output the usual file system identifier for that type (for example, ``ufs'') and exits with a return code of 0; if none of the modules succeed, the error message unknown_fstyp (no matches) is returned and the exit status is 1. If more than one module succeeds, the error message unknown_fstyp (multi- ple matches) is returned and the exit status is 2. Other errors are printed in the same format. This command is unreliable and its results should not be used to make any decisions about subsequent use of a storage device or disk parti- tion. OPTIONS
-a Output all available file system attributes. If a file system has been successfully identified, and this option is specified, the FSType identifier is followed by one or more "name-value" pairs, one per line, in the format: name: value The following conventions are recognized for the file system attributes: o String values are put in single quotes. o Nested "name-value" list increases the indentation of its values by four whitespaces. o For an array of "name-value" pairs, one array entry is printed per line, with the index following the name in square brackets. For instance, in the following example, "top_list" is a "name-value" list, consisting of a string array "string_array" and a "name- value" list array "list_array". The second "list_array"element is an integer array "int_array" containing three elements. top_string: 'String' top_list: string_array[0]: 'S0' string_array[1]: 'S1' list_array[0]: int_one: 1 string_two: 'S2' list_array[1]: int_array[0]: 1 int_array[1]: 2 int_array[2]: 3 In addition to the FSType-specific attributes, the following generic attributes may be present: gen_clean Allowable values are "true" or "false". If the value is "false", the file system is damaged or was not unmounted cleanly and the fsck(1M) command must be run before this file system can be mounted. gen_guid Globally unique identifier. This string uniquely identifies the file system. gen_version A string describing the file system version. gen_volume_label Volume label, a human-readable string used to either describe or identify the file system. -v Produce verbose output. This is usually information about the file systems superblock and varies across different FSTypes. See ufs(7FS), mkfs_ufs(1M), and tunefs(1M) for details. USAGE
See largefile(5) for the description of the behavior of fstyp when encountering files greater than or equal to 2 Gbyte ( 2^31 bytes). ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsu | +-----------------------------+-----------------------------+ SEE ALSO
fsck(1M), mkfs_ufs(1M), tunefs(1M), attributes(5), libfstyp(3LIB), largefile(5), hsfs(7FS), ufs(7FS), pcfs(7FS) NOTES
The use of heuristics implies that the result offstyp is not guaranteed to be accurate. This command is unreliable and its results should not be used to make any decisions about subsequent use of a storage device or disk parti- tion. SunOS 5.11 19 Dec 2007 fstyp(1M)