Chapter 1: SYMCLI Commands

symrslv

Displays detailed mapping information about a disk storage object.

SYNOPSIS symrslv [-h] [-version] [-kb | -blocks | -mb] pd <PdevName>

[-no_extents | -expand | -pdev_extents] lv <LVolName> -g <VgName>

[-no_extents | -expand | -pdev_extents]

[-stripe_column] [-type <VgType>] file <FileName>

[-no_extents | -expand | -pdev_extents |

-collapse | -phys_collapse] dir <Directory>

[-no_extents | -expand | -pdev_extents] fs <MountPoint>

[-no_extents | -expand | -pdev_extents]

[-nfs] object <ObjectName> identify <ObjectName>

DESCRIPTION

The symrslv command displays detailed logical-to-physical mapping information specific to a disk storage object. 

By default, it provides data relating to the physical extents of these objects. Currently, the supported disk storage objects are:

690 EMC Solutions Enabler CLICommand Reference

- Physical devices

- Logical volumes

- Regular files 

- Directories

- File systems 

- Object

Object restriction:

Because not all options apply to all supported objects, no options can be passed if keyword object is specified.

Note that Veritas Quick I/O devices (or the symbolic links to them) are treated like physical devices by symrslv and require the pd argument.

The collapse flag is applicable to files that reside on file systems that are mounted on a striped or RAID5 LVM mirror. This collapse is a logical collapse, meaning the data can be reconstructed with the meta data returned. 

The phys_collapse flag causes a physical collapse, which means that the data cannot be reconstructed with the meta data returned.

In the lists of mirror physical extents and mirror physical devices for the disk storage object, CLARiiON devices are distinguished from other device types by a (C) indicator.

Volume group name length restriction:

The volume group name field is limited to 63 characters. This length restriction is inclusive of the name and absolute path of the volume group even if the user only specified the volume group name itself. The behavior is undefined if the length is exceeded.

Chapter 1: SYMCLI Commands

symrslv 691

Chapter 1: SYMCLI Commands

Logical volume name length restriction:

The logical volume name field is limited to 63 characters. The behavior is undefined if the length is exceeded.

Note that network based file systems based on the NFS protocol is supported on Linux, Solaris, HP_UX and AIX.

Network based file systems based on CIFS protocol is supported on Linux and Windows. Resolving file system to a physical device and extent level is not applicable for network based file systems.

ARGUMENTS dir            Specifies a directory.

file           Specifies a file name.

fs             Specifies a file system mount point.

identify       Specifies that the object be only identified but not resolved. Only objects with its corresponding object name can be specified as an argument to identify. Options cannot be specified because not all options apply to all supported object types, and the object type is not known when object is specified in the command line.

lv             Specifies a logical volume name.

pd             Specifies a device physical name.

object         Specifies a generic object. In this case object could be either a directory, filename, file system mount point, logical volume name or a device physical name. Options cannot be specified because

692 EMC Solutions Enabler CLICommand Reference

not all options apply to all supported object types, and the object type is not known when the object is specified in the command line.

OPTIONS

-blocks        Displays size information in 512-byte blocks.

-collapse      Logically collapses the extents. 

-expand        Expands the extents, if possible. The default is to collapse the extents.

-g             Specifies a volume group name for use with the lv argument.

-h             Provides brief, online help information.

-kb            Displays size information in Kilobytes.

-mb            Displays size information in Megabytes.

This is the default.

-nfs           Displays information on mounted network based file systems.  

-no_extents    Excludes any extents information from displaying.

-pdev_extents  Displays Pdev level extents only (does not expand extents to reflect an underlying meta device configuration).

-phys_collapse

Physically collapses the extents. 

Chapter 1: SYMCLI Commands

symrslv 693

Chapter 1: SYMCLI Commands

-stripe_column

For striped logical volumes, displays the extent's stripe column number.

-type          Specifies the volume group type.

-version       Displays SYMAPI build and runtime versions.

PARAMETERS

Directory      The directory name. For a directory that is also a mount point, use a trailing slash at the end of the directory name to obtain the directory information.

FileName       The file name.

LVolName       The logical volume name.

MountPoint     The file system mount point,

(for example, d:). For a directory that is also a mount point, do not use a trailing slash at the end of the directory name to obtain the file system.

ObjectName     The directory, file name, logical volume name, MountPoint, or PdevName.

PdevName       The device physical (host) name for the device, such as /dev/rdsk/c2t0d2s2.

VgName         The logical volume group name.

VgType         The volume group type. Supported values are:

Group Type

694 EMC Solutions Enabler CLICommand Reference

------------------------

DEFAULT               LINUX_LVM          

AIX_LVM               LINUX_POOL         

AIX_VXVM              LINUX_VXVM         

AS400_LVM             ORACLE_ASM         

DYNIX_SVM             SUN_SOLSTICE       

EMC_PVM               SUN_VXVM           

HP_LVM                WIN_LDM            

HP_VXVM               WIN_VXVM           

RETURN CODES

Code #     Code Symbol

------ -----------

0         CLI_C_SUCCESS

1         CLI_C_FAIL

EXAMPLES

To display physical extent information in kilobytes about the physical device /dev/rdsk/c2t0d2s2, enter: symrslv -kb pd /dev/rdsk/c2t0d2s2

To display an expanded listing of physical extent information in blocks about the logical volume lvol1 in volume group ProdVG, enter: symrslv -blocks -expand -g ProdVG lv lvol1

To display physical extent information in megabytes about the file accounts, enter: symrslv -mb file accounts

Chapter 1: SYMCLI Commands

symrslv 695

Chapter 1: SYMCLI Commands

To display physical extent information in blocks about the directory /usr, enter: symrslv -blocks dir /usr

To display physical extent information in kilobytes about the file system whose mount point is /, enter: symrslv -kb fs /

To display physical extent information about object

/usr, enter: symrslv object /usr

To identify object /usr, enter: symrslv identify /usr

Notes:

- If object were to be passed as an argument to symrslv, user should not specify dir, file, fs, lv, or pd as an argument. The keyword object also does the type resolution.

- On the AS400 platform, only the lv and pd arguments are supported.

696 EMC Solutions Enabler CLICommand Reference