customquery(ADM)
customquery, swconfig --
query system contents database; list file status; list software modifications
Syntax
customquery Usage
customquery ListComponents
[-e] [-p phase]
[-D dir] [vend:comp[::vers]] ...
customquery ListPackages
[-e] [-p phase]
[-D dir] [vend:comp[:pkg]
[::vers]] ...]
customquery ListPatches [-e] [-a accessType] [-D dir] [componentID...]
customquery ListFiles [-e]
[-t type] [-a accessType]
[-D dir] [-r]
[vend:comp[:pkg][::vers]] ...
customquery ListExportTargets [-e]
[-D dir] [vend:comp[:pkg]
[::vers]] ...
customquery ListPhases [-e]
[-D dir] [vend:comp[:pkg]
[::vers]] ...
customquery IsFileIncluded [-e]
[-a accessType] [-D dir]
[-r]
vend:comp[:pkg][::vers] filename
customquery GetExpectedSum [-e]
[-D dir][-r]
vend:comp[:pkg][::vers] filename
customquery ListDescriptions [-e]
[-D dir]
[vend:comp[:pkg][::vers]] ...
customquery swconfig
swconfig [-P]
Description
The customquery command queries the state of the
installed system software by referencing the
custom(ADM)
utility's static databases.
It does not look at the state of the system directly.
Use the verification functionality in custom
to check the state of the system against the information stored
in the custom database.
ListComponents-
list components and versions, one version per line, in the
form:
vendor:component::version.
If no vendor:component::version is specified,
customquery lists all components.
ListPackages-
return a list of packages which are either partially or fully at phase,
one package per line, in the form:
vendor:component:package::version.
If no vendor:component:package::version is specified,
customquery lists all packages of the given phase.
If no phase is specified, the default phase is LOAD.
ListFiles-
list all the files for the given package(s), one file per line.
ListPatches-
lists the patches applied to a system.
ListExportTargets-
list all the export targets for the given packages, one target per line.
Export pathnames are listed relative to the root of the system.
ListDescriptions-
list all the verbose descriptions for the given components or packages,
one package per line. The -e option causes the
vend:comp[:pkg][::vers]
arguments to be treated as regular expressions instead of literals.
The -D option is used for debugging; it specifies a
non-root directory under which lie directories named
/opt, var/opt, and so on.
ListPhases-
list the phases (except EXPORT) for each specified package,
in the form:
vendor:component:package::version PHASE1 PHASE2...
Each phase may be prepended with the keywords
PART or CORRUPT.
IsFileIncluded-
is true if the filename specified is included in the given
component or package.
This is exactly the same as checking whether the command
customquery ListFiles [-a accessType] [-e] vend:comp[:pkg][::vers]
displays filename in its output.
If -r is not specified, filename is
assumed to be relative to the root of the software storage object
of the specified component (see
hierarchy(M)).
If -r is specified, filename is relative to
the absolute root.
GetExpectedSum-
return the checksum stored in the custom database for the given file.
custom generates sums using the command sum -r.
filename must be relative to the root of the software storage
object of the specified component
(see
hierarchy(M)).
For example, specify ./etc/mount instead of
/opt/K/SCO/Unix/5.0.0/etc/mount.
swconfig-
list the software sets (with release numbers) that have been
modified since the system's initialization.
Updates and patches are noted as such.
The -P option only displays applied patches.
customquery accepts the following action options:
-a accessType-
is either CLIENT or SHARED.
The default is CLIENT.
-D dir-
is used for debugging; it specifies a directory under which
the software storage object hierarchies /opt and
/var/opt can be found (see
hierarchy(M)).
It defaults to root (/).
-e-
causes the vendor:component[:package][::version]
arguments to be treated as regular expressions instead of literals.
-p phase-
is one of the following: LOAD, ATTACH,
REGISTER, or CONFIGURE.
If phase is not specified, the default is LOAD.
-t type-
is one of the following: ALL, DIR, FILE,
FIFO, or SYML.
If type is not specified, the default is ALL.
-r-
is used for checking whether files are included.
If the -r option is not specified, filename is
assumed to be relative to the root of the SSO; if
-r is specified, it is relative to the absolute root.
Exit values
0-
success
1-
error
The following exceptions pertain to the IsFileIncluded
subcommand:
0-
yes
1-
no
Examples
customquery ListComponents displays a list in this format:
SCO:TclX::7.3.2a
SCO:Unix::5.0.0
SCO:WServer::1.0.0l
customquery ListPackages SCO:WServer displays:
SCO:WServer
SCO:WServer::1.0.0l
SCO:WServer:SharedControl::1.0.0l
SCO:WServer:ClientControl::1.0.0l
SCO:WServer:WSERVER::1.0.0l
SCO:WServer:EXAMPLES::1.0.0l
customquery ListExportTargets SCO:Unix:KSH::5.0.0 displays:
./bin/ksh
./bin/posix/sh
./bin/rksh
./usr/lib/mkuser/ksh/profile
./usr/lib/mkuser/ksh/kshrc
./usr/lib/mkuser/ksh/mkuser.defs
./usr/lib/mkuser/rksh/profile
./usr/lib/mkuser/rksh/rkshrc
./usr/lib/mkuser/rksh/mkuser.defs
./usr/lib/mkuser/rksh/mkuser.init
customquery ListPhases SCO:Unix:KSH::5.0.0 displays
the following if the package is fully installed:
SCO:Unix:KSH::5.0.0 LOAD ATTACH REGISTER CONFIGURE
If the package was corrupted during the attachment phase of
the installation, the display looks like this:
SCO:Unix:KSH::5.0.0 LOAD CORRUPT-ATTACH
If corruption occurred while only part of the package was being installed,
the display looks like this:
SCO:Unix:KSH::5.0.0 PART-LOAD CORRUPT-PART-ATTACH
customquery GetExpectedSum SCO:Unix ./bin/ksh displays the sum
in this format:
./bin/ksh 831108312
customquery swconfig displays a list in this format.
Note that applied
patches are displayed as a subheading under the component
to which they are applied.
Sample output might be:
Network Installation Boot Module 1.0.1 installed
SCO TCP/IP 2.0.0Cl installed
TCP/IP Version 2.0.0 Release 5.0.0c applied
TCP/IP Version 2.0.0 Release rs.tcp200 applied
SCO NFS 2.0.0Cl installed
NFS Version 2.0.0 Release Su 5.0.0c applied
NFS Version 2.0.0 Release Su rs.nfs200 applied
swconfig -P only displays applied patches.
Files
/usr/bin/customquery
See also
custom(ADM),
hierarchy(M)
Standards conformance
customquery is not part of a currently supported standard;
it is an extension to AT&T System V developed by The Santa
Cruz Operation, Inc.
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 03 June 2005