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

FreeBSD Manual Pages

  
 
  

home | help
SMP_ZONE_ACTIVATE(8)		   SMP_UTILS		  SMP_ZONE_ACTIVATE(8)

NAME
       smp_zone_activate - invoke ZONE ACTIVATE	SMP function

SYNOPSIS
       smp_zone_activate [--expected=EX] [--help] [--hex] [--interface=PARAMS]
       [--raw] [--sa=SAS_ADDR] [--verbose] [--version] SMP_DEVICE[,N]

DESCRIPTION
       Sends a SAS Serial Management Protocol (SMP) ZONE ACTIVATE function re-
       quest  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 iden-
       tify a HBA (an SMP initiator) and needs the additional ,N to  differen-
       tiate between HBAs if there are multiple	present.

       This  function, if successful, will cause various zoning	related	shadow
       values (e.g. zone permission table and  zone  phy  information)	to  be
       copied  to  the	corresponding current values. If the saving to "saved"
       values option has been selected then the	various	zoning related	shadow
       values will also	be copied to the corresponding saved values.

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.

       -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.

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

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

CONFORMING TO
       The SMP ZONE ACTIVATE 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_zone_lock,	 smp_zone_unlock,     smp_ena_dis_zon-
       ing(smp_utils)

smp_utils-0.96			   June	2011		  SMP_ZONE_ACTIVATE(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | CONFORMING TO | AUTHORS | REPORTING BUGS | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=smp_zone_activate&sektion=8&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help