unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



 NAME
      swverify - verify software products

 SYNOPSIS
      swverify [-d|-r] [-F] [-v] [-C session_file] [-f software_file]
	   [-J jobid] [-Q date] [-S session_file] [-t target_file]
	   [-x option=value] [-X option_file] [software_selections]
	   [@  target_selections]

    Remarks
	   +  This command supports operations on remote systems.  See Remote
	      Operation below.

	   +  For an overview of all SD commands, see the sd(5) man page by
	      typing man 5 sd on the command line.

 DESCRIPTION
      The swverify command verifies the software_selections at one or more
      target_selections (e.g. root filesystems).  When verifying installed
      software, swverify checks software states, dependency relationships,
      file existence and integrity, in addition to executing vendor-supplied
      verification scripts.

      The swverify command also verifies software_selections at one or more
      target depots.  For target depots, swverify performs all of the checks
      listed above, but does not execute verification scripts.

      NOTE: swverify does not support operations on a tape depot.

      The swverify command also supports these features:

	   +  Verifies whether installed or configured software is
	      compatible with the hosts on which that software is installed.

	   +  Verifies that all dependencies (prerequisites, corequisites,
	      exrequisites) are being met (for installed software) or can be
	      met (for available software).

	   +  Executes vendor-specific verify scripts that check if the
	      software products is correctly configured.

	   +  Executes vendor-specific fix scripts that correct and report
	      specific problems.

	   +  Reports missing files, check all file attributes (ignoring
	      volatile files). These attributes include permissions, file
	      types, size, checksum, mtime, link source and major/minor
	      attributes.

    Remote Operation
      You can enable SD to manage software on remote systems. To let the



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



      root user from a central SD controller (also called the central
      management server or manager node) perform operations on a remote
      target (also called the host or agent):

      1)  Install a special HP ServiceControl Manager fileset on the remote
	  systems.  This enables remote operations by automatically setting
	  up the root, host, and template Access Control Lists (ACLs) on the
	  remote machines and permitting root access from the controller
	  system.  To install the fileset, run the following command on each
	  remote system:

	  swinstall -s controller:/var/opt/mx/depot11 AgentConfig.SD-CONFIG

	  NOTES:

	  +  controller is the name of the central management server.

	  +  If the target is running HP-UX 10.20, use the same command but
	     substitute depot10 for depot11.

	  +  Targets previously set up by SD/OV to be managed by this
	     controller do not need this step.

	  +  SD does not require any other ServiceControl Manager filesets.

      2)  (Optional) swinstall, swcopy, and swremove have enhanced GUI
	  interfaces for remote operations.  Enable the enhanced GUIs by
	  creating the .sdkey file on the controller.  Use this command:

	  touch /var/adm/sw/.sdkey

	  NOTES:

	  +    This step is not required when you use SD from within the HP
	       ServiceControl Manager.

	  +    See sd(5), swinstall(1M), swcopy(1M), swjob(1M), swlist(1M),
	       or swremove(1M) for more information on interactive
	       operations.

      NOTE: You can also set up remote access by using swacl directly on the
      remote machines to grant root or non-root access to users from the
      controller system.

    Options
      swverify supports the following options:

	   -d		  Operate on a depot rather than installed software.

	   -F		  Runs vendor-specific fix scripts to correct and
			  report problems on installed software.  The fix



 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



			  script can create missing directories, correct
			  file modifications (mode, owner, group, major, and
			  minor), and recreate symbolic links.

	   -r		  Operates on an alternate root directory, which
			  must be specified the @ target_selections option.
			  Verify scripts are not run when verifying software
			  in an alternate root directory.  (This option is
			  not required for alternate root operations but is
			  maintained for backward compatibility.  See the
			  Alternate Root Directory and Depot Directory
			  heading in sd(5) for more information.)

	   -v		  Turns on verbose output to stdout.  (The swverify
			  logfile is not affected by this option.) Verbose
			  output is enabled by default; see the verbose
			  option below.

	   -C session_file
			  Save the current options and operands to
			  session_file.	 You can enter a relative or
			  absolute path with the file name.  The default
			  directory for session files is
			  $HOME/.sw/sessions/.	You can recall a session
			  file with the -S option.

	   -f software_file
			  Read the list of software_selections from
			  software_file instead of (or in addition to) the
			  command line.

	   -J jobid	  (HP OpenView Software Distributor only) Executes
			  the previously scheduled job.	 This is the syntax
			  used by the daemon to start the job.

	   -Q date	  (HP OpenView Software Distributor only) Schedules
			  the job for this date.  You can change the date
			  format by editing the /var/adm/sw/getdate.templ
			  file.

	   -S session_file
			  Execute swverify based on the options and operands
			  saved from a previous session, as defined in
			  session_file.	 You can save session information to
			  a file with the -C option.

	   -t target_file Read the list of target_selections from
			  target_file instead of (or in addition to) the
			  command line.





 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



	   -x option=value
			  Set the session option to value and override the
			  default value (or a value in an alternate
			  options_file specified with the -X option).
			  Multiple -x options can be specified.

	   -X option_file Read the session options and behaviors from
			  options_file.

    Operands
      Most SD commands support two types of operands: software selections
      followed by target selections.  These operands are separated by the @
      (at) character. This syntax implies that the command operates on
      "software selections at targets".

    Software Selections
      The swverify command supports the following syntax for each
      software_selection:

	   bundle[.product[.subproduct][.fileset]][,version]

	   product[.subproduct][.fileset][,version]

	   +	The = (equals) relational operator lets you specify
		selections with the following shell wildcard and pattern-
		matching notations:

		     [ ], *, ?

	   +	Bundles and subproducts are recursive.	Bundles can contain
		other bundles and subproducts can contain other subproducts.

	   +	The \* software specification selects all products. Use this
		specification with caution.

      The version component has the form:

	   [,r <op> revision][,a <op> arch][,v <op> vendor]
	   [,c <op> category][,q=qualifier][,l=location]
	   [,fr <op> revision][,fa <op> arch]

	   +	location applies only to installed software and refers to
		software installed to a location other than the default
		product directory.

	   +	fr and fa apply only to filesets.

	   +	The <op> (relational operator) component can be of the form:

		     =, ==, >&gt&gt&gt;=, <&lt&lt&lt;=, <&lt&lt&lt;, >&gt&gt&gt;, or !=




 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



		which performs individual comparisons on dot-separated
		fields.

		For example, r>&gt&gt&gt;=B.10.00 chooses all revisions greater than
		or equal to B.10.00.  The system compares each dot-separated
		field to find matches.

	   +	The = (equals) relational operator lets you specify
		selections with the shell wildcard and pattern-matching
		notations:

		     [ ], *, ?, !

		For example, the expression r=1[01].* returns any revision
		in version 10 or version 11.

	   +	All version components are repeatable within a single
		specification (e.g.  r>&gt&gt&gt;=A.12, r<&lt&lt&lt;A.20).	If multiple
		components are used, the selection must match all
		components.

	   +	Fully qualified software specs include the r=, a=, and v=
		version components even if they contain empty strings.	For
		installed software, l= is also included.

	   +	No space or tab characters are allowed in a software
		selection.

	   +	The software instance_id can take the place of the version
		component. It has the form:

		     [instance_id]

		within the context of an exported catalog, where instance_id
		is an integer that distinguishes versions of products and
		bundles with the same tag.

    Target Selections
	   The swverify command supports the following syntax for each
	   target_selection.  The : (colon) is required if both a host and
	   directory are specified.

	   [host][:][/directory]

 EXTERNAL INFLUENCES
    Default Options
      In addition to the standard options, several SD behaviors and policy
      options can be changed by editing the default values found in:

	   /var/adm/sw/defaults		 the system-wide default values.




 Hewlett-Packard Company	    - 5 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



	   $HOME/.swdefaults		 the user-specific default values.

      Values must be specified in the defaults file using this syntax:

	   [command_name.]option=value

      The optional command_name prefix denotes one of the SD commands. Using
      the prefix limits the change in the default value to that command. If
      you leave the prefix off, the change applies to all commands.

      You can also override default values from the command line with the -x
      or -X options:

	   command -x option=value

	   command -X option_file

      The following section lists all of the keywords supported by the
      swverify command. If a default value exists, it is listed after the
      "=". The commands that this option applies to are also specified.

	   admin_directory=/var/adm/sw (for normal mode)
	   admin_directory=/var/home/LOGNAME/sw (for nonprivileged mode)
		     The location for SD logfiles and the default parent
		     directory for the installed software catalog.  The
		     default value is /var/adm/sw for normal SD operations.
		     When SD operates in nonprivileged mode (that is, when
		     the run_as_superuser default option is set to true):

		     +	The default value is forced to /var/home/LOGNAME/sw.

		     +	The path element LOGNAME is replaced with the name
			of the invoking user, which SD reads from the system
			password file.

		     +	If you set the value of this option to HOME/path, SD
			replaces HOME with the invoking user's home
			directory (from the system password file) and
			resolves path relative to that directory.  For
			example, HOME/my_admin resolves to the my_admin
			directory in your home directory.

		     +	If you set the value of the
			installed_software_catalog default option to a
			relative path, that path is resolved relative to the
			value of this option.

		     SD's nonprivileged mode is intended only for managing
		     applications that are specially designed and packaged.
		     This mode cannot be used to manage the HP-UX operating
		     system or patches to it.  For a full explanation of



 Hewlett-Packard Company	    - 6 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



		     nonprivileged SD, see the Software Distributor
		     Administration Guide, available at the
		     http://docs.hp.com web site.

		     See also the installed_software_catalog and
		     run_as_superuser options.

	   agent_auto_exit=true
		     Causes the target agent to automatically exit after
		     Execute phase, or after a failed Analysis phase.  This
		     is forced to false when the controller is using an
		     interactive UI, or when -p (preview) is used.  This
		     enhances network reliability and performance.  The
		     default value of true causes the target agent to
		     automatically exit when appropriate. When set to false,
		     the target agent will not exit until the controller
		     ends the session.

	   agent_timeout_minutes=10000
		     Causes a target agent to exit if it has been inactive
		     for the specified time.  This can be used to make
		     target agents more quickly detect lost network
		     connections since RPC can take as long as 130 minutes
		     to detect a lost connection. The recommended value is
		     the longest period of inactivity expected in your
		     environment. For command line invocation, a value
		     between 10 minutes and 60 minutes is suitable. A value
		     of 60 minutes or more is recommended when the GUI will
		     be used. The default of 10000 is slightly less than 7
		     days.

	   allow_incompatible=false
		     Requires that the software products which are being
		     installed be "compatible" with the target selections.
		     (All of the target selections must match the list of
		     supported systems defined for each selected product.)
		     If set to true, target compatibility is not enforced.

	   allow_multiple_versions=false
		     Prevents the installation or configuration of another,
		     independent version of a product when a version already
		     is installed or configured at the target.

		     If set to true, another version of an existing product
		     can be installed into a new location, or can be
		     configured in its new location.  Multiple versions can
		     only be installed if a product is locatable.  Multiple
		     configured versions will not work unless the product
		     supports it.





 Hewlett-Packard Company	    - 7 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



	   autoremove_job=false

			  This option applies only to HP OpenView Software
			  Distributor.

		     Controls automatic job removal of completed jobs.	If
		     the job is automatically removed, job information (job
		     status or target log files) cannot be queried with
		     swjob.

	   autoselect_dependencies=true
		     Controls the automatic selection of prerequisite,
		     corequisite, and exrequisite software that is not
		     explicitly selected by the user.  When set to true, the
		     requisite software is automatically selected for
		     configuration.  When set to false, requisite software
		     which is not explicitly selected is not automatically
		     selected for configuration.

	   check_contents=true
		     Causes swverify to verify the time stamp, size, and
		     checksum attributes of files.  If set to false, these
		     attributes are not verified.

	   check_contents_uncompressed=false
		     (This option is ignored if check_contents is set to
		     false.) Controls whether or not swverify validates the
		     size and checksum for compressed files. In the default
		     state of false, swverify checks only the mtime, size
		     and cksum attributes of the compressed file.  If set to
		     true, swverify uncompresses the file in memory and
		     verifies the size and cksum attributes of the
		     uncompressed contents.

		     Only files compressed with SD's internal compressor can
		     be uncompressed during a swverify operation. See the
		     compress_files option of the swpackage(1M) command for
		     more information.

	   check_contents_use_cksum=true
		     (This option is ignored if check_contents is set to
		     false.) Controls whether or not swverify computes a
		     checksum on the contents of the file. In the default
		     state of true, swverify checks all file attributes
		     including the checksum.  If set to false, swverify
		     checks only the file timestamp and size.

	   check_permissions=true
		     Causes swverify to verify the mode, owner, UID, group,
		     and GID attributes of installed files.  If set to
		     false, these attributes are not verified.



 Hewlett-Packard Company	    - 8 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



	   check_requisites=true
		     Causes swverify to verify that the prerequisite,
		     corequisite, and exrequisite dependencies of the
		     software selections are being met.	 If set to false,
		     these checks are not performed.

	   check_scripts=true
		     Causes swverify to run the fileset/product verify
		     scripts for installed software.  If set to false, these
		     scripts are not executed.

	   check_volatile=false
		     Causes swverify to not verify those files marked as
		     volatile (i.e. can be changed).  If set to true,
		     volatile files are also checked (for installed
		     software).

	   controller_source=
		     Specifies the location of a depot for the controller to
		     access to resolve selections. Setting this option can
		     reduce network traffic between the controller and the
		     target. Use the target selection syntax to specify the
		     location:

			  [host][:][path]

		     This option has no effect on which sources the target
		     uses.

	   distribution_target_directory=/var/spool/sw
		     Defines the default distribution directory of the
		     target depot.  The target_selection operand overrides
		     this default.

	   enforce_dependencies=true
		     Requires that all dependencies specified by the
		     software_selections be resolved either in the specified
		     source, or at the target_selections themselves.

		     If set to false, dependencies will still be checked,
		     but not enforced.	Corequisite dependencies, if not
		     enforced, may keep the selected software from working
		     properly. Prerequisite or exrequisite dependencies, if
		     not enforced, may cause the installation or
		     configuration to fail.

	   enforce_locatable=true
		     (Currently, swverify recognizes this option, but the
		     option has no associated behavior. See swinstall(1M) or
		     sd(5) for more information.)  Controls the handling of
		     errors when relocating a non-relocatable fileset. If



 Hewlett-Packard Company	    - 9 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



		     true, an error is generated when an attempt is made to
		     relocate a non-relocatable fileset. If false, an
		     attempt is made to relocate the fileset in any case.

	   fix=false If true, runs vendor-specific scripts to correct and
		     report problems on installed software. Fix scripts can
		     create missing directories, correct file modifications,
		     (mode, owner, group, major, minor), and recreate
		     symbolic links. If false, fix scripts are not run.

	   installed_software_catalog=products
		     Defines the directory path where the Installed Products
		     Database (IPD) is stored.	This information describes
		     installed software.  When set to an absolute path, this
		     option defines the location of the IPD.  When this
		     option contains a relative path, the SD controller
		     appends the value to the value specified by the
		     admin_directory option to determine the path to the
		     IPD.  For alternate roots, this path is resolved
		     relative to the location of the alternate root.  This
		     option does not affect where software is installed,
		     only the IPD location.

		     This option permits the simultaneous installation and
		     removal of multiple software applications by multiple
		     users or multiple processes, with each application or
		     group of applications using a different IPD.

		     Caution: use a specific installed_software_catalog to
		     manage a specific application.  SD does not support
		     multiple descriptions of the same application in
		     multiple IPDs.

		     See also the admin_directory and run_as_superuser
		     options, which control SD's nonprivileged mode.  (This
		     mode is intended only for managing applications that
		     are specially designed and packaged. This mode cannot
		     be used to manage the HP-UX operating system or patches
		     to it.  For a full explanation of nonprivileged SD, see
		     the Software Distributor Administration Guide,
		     available at the http://docs.hp.com web site.)

	   job_title=

			  This option applies only to HP OpenView Software
			  Distributor.

		     This is an ASCII string giving a title to a job.  It is
		     displayed along with the job ID to provide additional
		     identifying information about a job when swjob is
		     invoked.



 Hewlett-Packard Company	   - 10 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



	   logdetail=false[true]
		     Controls the amount of detail written to the logfile.
		     When set to true, this option adds detailed task
		     information (such as options specified, progress
		     statements, and additional summary information) to the
		     logfile. This information is in addition to log
		     information controlled by the loglevel option.

	   logfile=/var/adm/sw/sw<&lt&lt&lt;command>&gt&gt&gt;.log
		     Defines the default log file for each SD command.	(The
		     agent log files are always located relative to the
		     target depot or target root, e.g.
		     /var/spool/sw/swagent.log and /var/adm/sw/swagent.log.)

	   loglevel=1
		     Controls the log level for the events logged to the
		     command logfile, the target agent logfile, and the
		     source agent logfile. This information is in addition
		     to the detail controlled by the logdetail option. See
		     logdetail, above, and the sd(5) manual page (by typing
		     man 5 sd) for more information.  A value of
		     0	 provides no information to the logfile.
		     1	 enables verbose logging to the logfiles.
		     2	 enables very verbose logging to the logfiles.

	   log_msgid=0
		     Adds numeric identification numbers at the beginning of
		     SD logfile messages:
		     0	(default)  No identifiers are attached to messages.
		     1	Adds identifiers to ERROR messages only.
		     2	Adds identifiers to ERROR and WARNING messages.
		     3	Adds identifiers to ERROR, WARNING, and NOTE
			messages.
		     4	Adds identifiers to ERROR, WARNING, NOTE, and
			certain other informational messages.

	   mount_all_filesystems=true
		     By default, the SD commands attempt to mount all
		     filesystems in the /etc/fstab file at the beginning of
		     the analysis phase, to ensure that all listed
		     filesystems are mounted before proceeding.	 This policy
		     helps to ensure that files are not loaded into a
		     directory that may be below a future mount point, and
		     that the expected files are available for a remove or
		     verify operation.

		     If set to false, the mount operation is not attempted,
		     and no check of the current mounts is performed.

	   rpc_binding_info=ncacn_ip_tcp:[2121] ncadg_ip_udp:[2121]
		     Defines the protocol sequence(s) and endpoint(s) on



 Hewlett-Packard Company	   - 11 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



		     which the daemon listens and which the other commands
		     use to contact the daemon.	 If the connection fails for
		     one protocol sequence, the next is attempted.  SD
		     supports both the tcp (ncacn_ip_tcp:[2121]) and udp
		     (ncadg_ip_udp:[2121]) protocol sequence on most
		     platforms.	 See the sd(5) man page by typing man 5 sd
		     for more information.

	   rpc_timeout=5
		     Relative length of the communications timeout.  This is
		     a value in the range from 0 to 9 and is interpreted by
		     the DCE RPC.  Higher values mean longer times; you may
		     need a higher value for a slow or busy network.  Lower
		     values will give faster recognition on attempts to
		     contact hosts that are not up, or are not running
		     swagentd.	Each value is approximately twice as long as
		     the preceding value.  A value of 5 is about 30 seconds
		     for the ncadg_ip_udp protocol sequence.  This option
		     may not have any noticeable impact when using the
		     ncacn_ip_tcp protocol sequence.

	   run_as_superuser=true
		     This option controls SD's nonprivileged mode.  This
		     option is ignored (treated as true) when the invoking
		     user is super-user.

		     When set to the default value of true, SD operations
		     are performed normally, with permissions for operations
		     either granted to a local super-user or set by SD ACLs.
		     (See swacl(1M) for details on ACLs.)

		     When set to false and the invoking user is local and is
		     not super-user, nonprivileged mode is invoked:

		     +	Permissions for operations are based on the user's
			file system permissions.

		     +	SD ACLs are ignored.

		     +	Files created by SD have the uid and gid of the
			invoking user, and the mode of created files is set
			according to the invoking user's umask.

		     SD's nonprivileged mode is intended only for managing
		     applications that are specially designed and packaged.
		     This mode cannot be used to manage the HP-UX operating
		     system or patches to it.  For a full explanation of
		     nonprivileged SD, see the Software Distributor
		     Administration Guide, available at the
		     http://docs.hp.com web site.




 Hewlett-Packard Company	   - 12 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



		     See also the admin_directory and
		     installed_software_catalog options.

	   select_local=true
		     If no target_selections are specified, select the
		     default target_directory of the local host as the
		     target_selection for the command.

	   software= Defines the default software_selections.  There is no
		     supplied default.	If there is more than one software
		     selection, they must be separated by spaces.  Software
		     is usually specified in a software input file, as
		     operands on the command line, or in the GUI.

	   targets=  Defines the default target_selections.  There is no
		     supplied default (see select_local above).	 If there is
		     more than one target selection, they must be separated
		     by spaces.	 Targets can be specified in a target input
		     file or as operands on the command line.

	   verbose=1 Controls the verbosity of a non-interactive command's
		     output:
		     0	 disables output to stdout.  (Error and warning
			 messages are always written to stderr).
		     1	 enables verbose messaging to stdout.
		     2	 for swpackage and swmodify, enables very verbose
			 messaging to stdout.

		     The -v option overrides this default if it is set to 0.

    Session File
      Each invocation of the swverify command defines a verify session.	 The
      invocation options, source information, software selections, and
      target hosts are saved before the installation or copy task actually
      commences.  This lets you re-execute the command even if the session
      ends before proper completion.

      Each session is saved to the file $HOME/.sw/sessions/swverify.last.
      This file is overwritten by each invocation of swverify.

      You can also save session information to a specific file by executing
      swverify with the -C session__file option.

      A session file uses the same syntax as the defaults files.  You can
      specify an absolute path for the session file.  If you do not specify
      a directory, the default location for a session file is
      $HOME/.sw/sessions/.

      To re-execute a session file, specify the session file as the argument
      for the -S session__file option of swverify.




 Hewlett-Packard Company	   - 13 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



      Note that when you re-execute a session file, the values in the
      session file take precedence over values in the system defaults file.
      Likewise, any command line options or parameters that you specify when
      you invoke swverify take precedence over the values in the session
      file.

    Environment Variables
      SD programs that execute control scripts set environment variables for
      use by the control scripts.

      The environment variable that affects the swverify command is:

	   LANG	     Determines the language in which messages are
		     displayed.	 If LANG is not specified or is set to the
		     empty string, a default value of C is used.  See the
		     lang(5) man page by typing man 5 sd for more
		     information.

		     NOTE: The language in which the SD agent and daemon log
		     messages are displayed is set by the system
		     configuration variable script, /etc/rc.config.d/LANG.
		     For example, /etc/rc.config.d/LANG, must be set to
		     LANG=ja_JP.SJIS or LANG=ja_JP.eucJP to make the agent
		     and daemon log messages display in Japanese.

	   LC_ALL    Determines the locale to be used to override any values
		     for locale categories specified by the settings of LANG
		     or any environment variables beginning with LC_.

	   LC_CTYPE  Determines the interpretation of sequences of bytes of
		     text data as characters (e.g., single-versus multibyte
		     characters in values for vendor-defined attributes).

	   LC_MESSAGES
		     Determines the language in which messages should be
		     written.

	   LC_TIME   Determines the format of dates (create_date and
		     mod_date) when displayed by swlist.  Used by all
		     utilities when displaying dates and times in stdout,
		     stderr, and logging.

	   TZ	     Determines the time zone for use when displaying dates
		     and times.

      Environment variables that affect scripts:

	   SW_CATALOG
		Holds the path to the Installed Products Database (IPD),
		relative to the path in the SW_ROOT_DIRECTORY environment
		variable. Note that you can specify a path for the IPD using



 Hewlett-Packard Company	   - 14 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



		the installed_software_catalog default option.

	   SW_CONTROL_DIRECTORY
		Defines the current directory of the script being executed,
		either a temporary catalog directory, or a directory within
		in the Installed Products Database (IPD).  This variable
		tells scripts where other control scripts for the software
		are located (e.g. subscripts).

	   SW_CONTROL_TAG
		Holds the tag name of the control_file being executed. When
		packaging software, you can define a physical name and path
		for a control file in a depot. This lets you define the
		control_file with a name other than its tag and lets you use
		multiple control file definitions to point to the same file.
		A control_file can query the SW_CONTROL_TAG variable to
		determine which tag is being executed.

	   SW_LOCATION
		Defines the location of the product, which may have been
		changed from the default product directory.  When combined
		with the SW_ROOT_DIRECTORY, this variable tells scripts
		where the product files are located.

	   SW_PATH
		A PATH variable which defines a minimum set of commands
		available to for use in a control script (e.g.
		/sbin:/usr/bin).

	   SW_ROOT_DIRECTORY
		Defines the root directory in which the session is
		operating, either / or an alternate root directory.  This
		variable tells control scripts the root directory in which
		the products are installed.  A script must use this
		directory as a prefix to SW_LOCATION to locate the product's
		installed files.  The configure script is only run when
		SW_ROOT_DIRECTORY is /.

	   SW_SESSION_OPTIONS
		Contains the pathname of a file containing the value of
		every option for a particular command, including software
		and target selections. This lets scripts retrieve any
		command options and values other than the ones provided
		explicitly by other environment variables. For example, when
		the file pointed to by SW_SESSIONS_OPTIONS is made available
		to a request script, the targets option contains a list of
		software_collection_specs for all targets specified for the
		command. When the file pointed to by SW_SESSIONS_OPTIONS is
		made available to other scripts, the targets option contains
		the single software_collection_spec for the targets on which
		the script is being executed.



 Hewlett-Packard Company	   - 15 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



	   SW_SOFTWARE_SPEC
		This variable contains the fully qualified software
		specification of the current product or fileset.  The
		software specification allows the product or fileset to be
		uniquely identified.

    Signals
      The swverify command catches the signals SIGQUIT, SIGINT, and SIGUSR1.
      If these signals are received, the command prints a message, sends a
      Remote Procedure Call (RPC) to the agents to wrap up after completion,
      and then exits.

      The agent ignores SIGHUP, SIGINT, and SIGQUIT.  It immediately exits
      gracefully after receiving SIGTERM, SIGUSR1, or SIGUSR2.	Killing the
      agent may leave corrupt software on the system, and thus should only
      be done if absolutely necessary.	Note that when an SD command is
      killed, the agent does not terminate until completing the task in
      progress.

      The daemon ignores SIGHUP, SIGINT and SIGQUIT.  It immediately exits
      gracefully after receiving SIGTERM and SIGUSR2.  After receiving
      SIGUSR1, it waits for completion of a copy or remove from a depot
      session before exiting, so that it can register or unregister depots
      if necessary. Requests to start new sessions are refused during this
      wait.

 RETURN VALUES
      The swverify command returns:

	   0   The software_selections were successfully verified.
	   1   The verify operation failed on all target_selections.
	   2   The verify operation failed on some target_selections.

 DIAGNOSTICS
      The swverify command writes to stdout, stderr, and to specific
      logfiles.

    Standard Output
      The swverify command writes messages for significant events.  These
      include:

	   +  a begin and end session message,
	   +  selection, analysis, and execution task messages for each
	      target_selection.

    Standard Error
      The swverify command also writes messages for all WARNING and ERROR
      conditions to stderr.

    Logging
      The swverify command logs summary events at the host where the command



 Hewlett-Packard Company	   - 16 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



      was invoked.  It logs detailed events to the swagent logfile
      associated with each target_selection.

      Command Log
	   The swverify command logs all stdout and stderr messages to the
	   the logfile /var/adm/sw/swverify.log.  (The user can specify a
	   different logfile by modifying the logfile option.)

      Target Log
	   A swagent process performs the actual verify operation at each
	   target_selection.  When verifying installed software, the swagent
	   logs messages to the file var/adm/sw/swagent.log beneath the root
	   directory (e.g.  / or an alternate root directory).	When
	   verifying available software (within a depot), the swagent logs
	   messages to the file swagent.log beneath the depot directory
	   (e.g.  /var/spool/sw).

	   The following line applies only to HP OpenView Software
	   Distributor.

	   Command and target log files can be viewed using the swjob
	   command.

 EXAMPLES
      Verify the C and Pascal products installed at the local host:

	   swverify cc pascal

      Verify a particular version of HP Omniback:

	   swverify Omniback,1=/opt/Omniback_v2.0

      Verify the entire contents of a local depot:

	   swverify -d \* @ /var/spool/sw

		The following example applies only to HP OpenView Software
		Distributor.

      Verify the C and Pascal products on remote hosts:

	   swverify cc pascal @ hostA hostB hostC

 FILES
      $HOME/.swdefaults
	   Contains the user-specific default values for some or all SD
	   options.

      $HOME/.sw/sessions/
	   Contains session files automatically saved by the SD commands, or
	   explicitly saved by the user.



 Hewlett-Packard Company	   - 17 -   HP-UX Release 11i: November 2000






 swverify(1M)							swverify(1M)
			   Hewlett-Packard Company



      /usr/lib/sw/sys.defaults
	   Contains the master list of current SD options with their default
	   values.

      /var/adm/sw/
	   The directory which contains all the configurable and non-
	   configurable data for SD.  This directory is also the default
	   location of logfiles.

      /var/adm/sw/defaults
	   Contains the active system-wide default values for some or all SD
	   options.

      /var/adm/sw/getdate.templ
	   Contains the set of date/time templates used when scheduling
	   jobs.

      /var/adm/sw/products/
	   The Installed Products Database (IPD), a catalog of all products
	   installed on a system.

      /var/spool/sw/
	   The default location of a target software depot.

 AUTHOR
      swverify was developed by the Hewlett-Packard Company.

 SEE ALSO
      install-sd(1M), swacl(1M), swagentd(1M), swask(1M), swconfig(1M),
      swcopy(1M), swinstall(1M), swjob(1M), swlist(1M), swmodify(1M),
      swpackage(1M), swreg(1M), swremove(1M), sd(4), swpackage(4), sd(5).

      Software Distributor Administration Guide, available at
      http://docs.hp.com.

      SD customer web site at http://software.hp.com/SD_AT_HP/.


















 Hewlett-Packard Company	   - 18 -   HP-UX Release 11i: November 2000