Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
SMP_CONF_ZONE_PHY_INFO(8)	   SMP_UTILS	     SMP_CONF_ZONE_PHY_INFO(8)

NAME
       smp_conf_zone_phy_info -	invoke CONFIGURE ZONE PHY INFORMATION function

SYNOPSIS
       smp_conf_zone_phy_info	[--expected=EX]	  [--help]  [--hex]  [--inter-
       face=PARAMS] --pconf=FN [--raw]	[--sa=SAS_ADDR]	 [--save=SAV]  [--ver-
       bose] [--version] SMP_DEVICE[,N]

DESCRIPTION
       Sends  a	SAS Serial Management Protocol (SMP) CONFIGURE ZONE PHY	INFOR-
       MATION function request to an SMP target. The SMP target	is  identified
       by  the	SMP_DEVICE  and	the --sa=SAS_ADDR. Depending on	the interface,
       the SAS_ADDR may	be deduced from	the SMP_DEVICE.	The mpt	interface uses
       SMP_DEVICE to identify a	HBA (an	SMP initiator)	and  needs  the	 addi-
       tional ,N to differentiate between HBAs if there	are multiple present.

       Each  zone phy configuration descriptor is 4 bytes long.	The first byte
       is a (expander) phy identifier. The second byte has 3 modifiable	 bits:
       bit  5 is "inside ZPSDS persistent"; bit	4 is "requested	inside ZPSDS";
       and bit 2 is "zone group	persistent". The other bits in the second byte
       are reserved and	should be 0. The third byte is reserved	and should  be
       0. The fourth byte is the zone group.

OPTIONS
       Mandatory  arguments to long options are	mandatory for short options as
       well.

       -E, --expected=EX
	      set the 'expected	expander change	count' field in	 the  SMP  re-
	      quest.   The  value EX is	from 0 to 65535	inclusive with 0 being
	      the default value. When EX is greater  than  zero	 then  if  the
	      value  doesn't match the expander	change count of	the SMP	target
	      (i.e. the	expander) when the request arrives then	the target ig-
	      nores the	request	and sets a function  result  of	 "invalid  ex-
	      pander change count" in the response.

       -h, --help
	      output the usage message then exit.

       -H, --hex
	      output the response (less	the CRC	field) in hexadecimal.

       -I, --interface=PARAMS
	      interface	 specific  parameters. In this case "interface"	refers
	      to the path through the operating	system to the  SMP  initiator.
	      See the smp_utils	man page for more information.

       -p, --pconf=FN
	      FN  is  a	 file containing zone phy configuration	descriptors in
	      ASCII hexadecimal; either	as  bytes  separated  by  space,  tab,
	      comma  or	 newline, or as	longer strings of hexadecimal bytes in
	      which every 2 digits represents a	byte. Empty  lines  and	 those
	      starting	with  "#" are ignored.	Since each zone	phy configura-
	      tion descriptor is 4 bytes long, the number of bytes  in	FN  is
	      expected to be a multiple	of 4.

       -r, --raw
	      send  the	response (less the CRC field) to stdout	in binary. All
	      error messages are sent to stderr.

       -s, --sa=SAS_ADDR
	      specifies	the SAS	address	of the SMP target device. The mpt  in-
	      terface needs this option	and it will typically be an expander's
	      SAS  address.  The SAS_ADDR is in	decimal	but most SAS addresses
	      are shown	in hexadecimal.	 To give a number in  hexadecimal  ei-
	      ther prefix it with '0x' or put a	trailing 'h' on	it.

       -S, --save=SAV
	      set the 'save' field in the SMP request. SAV may take these val-
	      ues:  0 for updating the shadow values (default),	1 for updating
	      the saved	values,	2 for updating shadow values and if  available
	      the saved	values,	3 for updating both saved and shadow values.

       -v, --verbose
	      increase	the  verbosity	of  the	 output.  Can be used multiple
	      times.

       -V, --version
	      print the	version	string and then	exit.

NOTES
       The expander phys that make up a	wide port (2 or	more attached to  phys
       with  the same SAS address) must	be set to the same zone	phy configura-
       tion settings (other than the phy id).

       Zone phy	information can	be read	back from an expander and placed in  a
       file  with  the smp_discover_list utility's --zpi=FN option. The	format
       of that file should be suitable for this	utility's --pconf=FN option.

CONFORMING TO
       The SMP CONFIGURE ZONE PHY INFORMATION function was introduced in SAS-2
       .

AUTHORS
       Written by Douglas Gilbert.

REPORTING BUGS
       Report bugs to <dgilbert	at interlog dot	com>.

COPYRIGHT
       Copyright (C) 2011 Douglas Gilbert
       This software is	distributed under a FreeBSD license. There is NO  war-
       ranty;  not  even  for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR-
       POSE.

SEE ALSO
       smp_utils,    smp_conf_zone_perm_tbl,	smp_zone_activate,    smp_dis-
       cover_list(smp_utils)

smp_utils-0.96			   May 2011	     SMP_CONF_ZONE_PHY_INFO(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=smp_conf_zone_phy_info&sektion=8&manpath=FreeBSD+Ports+15.0>

home | help