fstyp_get_attr(3FSTYP) File System Type Identification Library Functions fstyp_get_attr(3FSTYP)NAME
fstyp_get_attr - get file system attributes
SYNOPSIS
cc [ flag... ] file... -lfstyp-lnvpair [ library... ]
#include <libnvpair.h>
#include <libfstyp.h>
int fstyp_get_attr(fstyp_handle_t handle, nvlist_t **attrp);
PARAMETERS
handle Opaque handle returned by fstyp_ident(3FSTYP).
attrp Address to which the name-pair list is returned.
DESCRIPTION
The fstyp_get_attr() function returns a name-value pair list of various attributes for an identified file system. This function can be
called only after a successful call to fstyp_ident().
Each file system has its own set of attributes. The following attributes are generic and are returned when appropriate for a particular
file system type:
gen_clean (DATA_TYPE_BOOLEAN_VALUE)
Attribute for which true and false values are allowed. A false value is returned if the file system is damaged or if the file system is
not cleanly unmounted. In the latter case, fsck(1M) is required before the file system can be mounted.
gen_guid (DATA_TYPE_STRING)
Globally unique string identifier used to establish the identity of the file system.
gen_version (DATA_TYPE_STRING)
String that specifes the file system version.
gen_volume_label (DATA_TYPE_STRING)
Human-readable volume label string used to describe and/or identify the file system.
Attribute names associated with specific file systems should not start with gen_.
RETURN VALUES
The fstyp_get_attr() 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_get_attr(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)