svcsearch
The svcsearch command runs view commands with filtered fields and returns only objects where one or more fields match a given string.
Syntax
Parameters
- -objects list_of_types
- (Optional) Specifies a colon-separated list of object types that are to be searched. Object
types include:
- partition
- volume (vdisk)
- volumegroup
- volumegroupsnapshot
- hostports
- host
- hostcluster
- targetportfc
- ip
- -limit number_of_results
- (Optional) Specifies the maximum number of objects of each type that the command returns. By default, the command returns all matching objects.
- -delim
- (Optional) Specifies a delimiter to separate data in the output.
- search_string
- A single string that is compared with certain fields of each object of the requested (or default) types.
Description
This command searches all objects of the following types for case-insensitive matches to a given search string. To keep the output concise, the command returns only certain fields for each object. The command uses only some of the following fields to match the search string.
| Object type | Reported fields | Searched fields |
|---|---|---|
| partition | Indicates id, name, uuid, ha_status, dr_link_status, host_count, volume_group_count, migration_status, and host_provisioned_capacity | name and uuid |
| volume | vdisk | Indicates id, name, vdisk_UID, display_name, capacity, volume_group_name, and status | name, vdisk_UID, and display_name |
| volumegroup | Indicates id, name, uuid, partition_name, dr_link_status, volume_count, and host_provisioned_capacity | name and uuid |
| volumegroupsnapshot | Indicates id, name, uuid, volume_group_name, time, state, and expiration_time | name, uuid, and volume_group_name |
| host | Indicates id, name, uuid, protocol, status, partition_name, and host_cluster_name | name and uuid |
| hostports | Indicates host_name, WWPN, iscsi_name, and nqn | host_name, WWPN, iscsi_name, and nqn |
| hostcluster | Indicates id, name, uuid, status, host_count, mapping_count, and partition_name | name and uuid |
| targetportfc | Indicates id, WWPN, WWNN, nportid, host_io_permitted, and protocol | WWPN and WWNN |
| ip | Indicates id, IP_address, portset_name, vlan, gateway, and node_name | IP_address |