Emulex EMULEX manual Command Descriptions emlxadm, CLI Mode emlxadm

Page 12

reset_link <wwpn,0> - Resets the link of a specified FC device. reset_hard - Reset the HBA.

reset_hard_core - Reset the HBA firmware core.

diag <test> - Perform a diagnostic test on the HBA.

ns - Performs a complete query of the fabric name server.

parm_get_num - Returns the total number of configurable parameters. parm_get_list - Returns a list of configurable parameters.

parm_get <label> - Gets the value of a specified parameter in the driver.

parm_set <label> <val> - Sets the value of a specified parameter in the driver. msgbuf all or <number> [-i interval] - Returns the driver's internal message log. get_host_attrs - Returns the host adapter and port attributes. get_port_attrs <index>, <wwn> or all - Returns the port attributes.

get_path <index> - Returns the adapter path. q - Exits this program.

h - Returns this help screen. hba - Select another hba.

p - Repeat previous command. emlxadm>

At the bottom of the command list is an emlxadm> prompt. From this point, the utility is prompt driven. When the prompt is displayed, you must enter one of the commands in the list. The list is displayed automatically only once, but you can display it again by entering h at the prompt. To exit the program, enter q.

Some commands require additional arguments, such as a Fibre Channel World Wide Port Name (WWPN) or a Fibre Channel port address (D_ID). To display the available arguments for a command, enter the command without any arguments.

For example, the command get_state requires a WWPN for the target device. If only the command without the argument is entered, the following statement appears to indicate that the command requires an argument to be executed. For example:

emlxadm> get_state

Usage: get_state <wwpn>

emlxadm> get_state 21000020371938fa

State: PORT_DEVICE_LOGGED_IN

For a detailed explanation of each command and its arguments, see Command Descriptions (emlxadm) on page 8.

CLI Mode (emlxadm)

The emlxadm utility program can be run in CLI mode by typing the name of the program, followed by the full device name of the desired HBA, followed by a valid command and any required command arguments. For example:

#emlxadm /devices/pci@1e,600000/SUNW,emlxs@2/fp@0,0:devctl get_state 21000020371938fa

State: PORT_DEVICE_LOGGED_IN

#

This mode of operation enables you to use the emlxadm utility as part of a script or another program capable of executing system level calls. For a detailed explanation of each command and its arguments, see Command Descriptions (emlxadm) on page 8.

Command Descriptions (emlxadm)

This section provides a list of commands that can be issued with the emlxadm utility program.

FCA Utilities Reference Manual

Page 8

Image 12
Contents FCA Utilities FCA Utilities Reference Manual Introduction Using the emlxdrv Utility HbaFibre Channel Overview Solaris Fibre Channel StackSolaris Software Stack Installing the Utilities Enter y. The following message is displayedRemoving the Utilities Using the emlxuremove Script Installing the Utilities Package Manually Removing the Utilities Package ManuallyTo remove the emlxu utilities package, do the following Update the emlxu utilities by doing the following Updating the Utilities Package ManuallyInteractive Mode emlxadm Modes of Operation emlxadmCommand Descriptions emlxadm CLI Mode emlxadmGetnumdevs GetdevlistGetlogiparams wwpn FCA Utilities Reference Manual Gethostparams GetsympnameSetsympname string GetsymnnameDevlogin wwpn DevlogoutGetstate wwpn Devremove wwpnGetbootrev Downloadfcode filenameGetfwrev Downloadfw filenameDownloadboot filename Downloads the specified boot image file to the HBA ExampleGetdumpsize ForcedumpResetlink wwpn or zero for local link ResethardResethardcore GettopologyType PID Returns the total number of configurable parameters Example Returns a list of configurable parameters ExampleParmgetnum ParmgetlistFCA Utilities Reference Manual Parmget label Gets the value of a specified parameter in the driverParmset label value Msgbuf all or number -i intervalExample This example attempts to set a static parameter Gethostattrs Getportattrs index, wwn or allDisplays all of the current host HBA API attributes Example Seagate ST39103FC = Seagate ST39103FC Displays a help menu of utility commands Example Getpath indexExits the utility program Example Repeats the last command Example HbaInteractive Mode emlxdrv Modes of Operation emlxdrvEmlxdrv utility program can be run in two modes Interactive CLI Mode emlxdrv Command Descriptions emlxdrv Setemlxs aliasSetemlxssun SetemlxsallSetlpfc alias SetlpfcnonsunCleardev alias Clearlpfc ClearemlxsClearsun ClearnonsunClearall Emlxdrv q Exiting