NAME
pdgwcfg — configures HPDPS gateway printers in a Basic environment
SYNOPSIS
pdgwcfg
[-a|-m]
[-h]
[-p]
[-v]
DESCRIPTION
The
pdgwcfg
utility simplifies the configuration of HPDPS gateway printers
in a Basic (non-DCE Extended) environment by reading
an administrator-supplied configuration file
/etc/pdgwcfg.conf
(see
pdgwcfg.conf(4)).
It creates-enables and/or deletes gateway printers as appropriate.
Gateway printers are similar to
"remote printers" provided by the LP spooler, allowing access to a printer
in a foreign (DCE Extended or Basic) environment.
You must have super-user privileges to invoke the utility. The default
behavior of the utility will not modify any previously-created gateway
printers listed in
/etc/pdgwcfg.conf.
Any new entries will be created and any gateway printers not listed will
be deleted.
All output is sent to
$PDBASE/pdgwcfg/error.log
(or
/var/opt/pd/pdgwcfg/error.log
by default). Previous error logs are retained in separate files in this
directory for reference and, if used extensively, the directory
may need to be cleaned-up periodically. If a severe error
is encountered that causes a premature abort, an error
message is also sent to stderr.
Options
pdgwcfg
uses the following options:
- -a
Retain all previously-created gateway printers, even
if they are no longer listed in
/etc/pdgwcfg.conf.
No gateway printers will be deleted.
The administrator must manually remove any
unwanted gateway printers.
- -m
Retain any manually-created gateway printers. These would not
contain the text
PDGWCFG-MARKER
in the
descriptor
attribute which is placed there by the
pdgwcfg
utility when it creates a gateway printer. This option is intended for
scenarios where
/etc/pdgwcfg.conf
is not used exclusively for gateway printer configuration (e.g. a
local sysadmin also creates gateway printers without the utility).
- -h
Provides invocation syntax help.
- -p
Preview mode. No changes to the gateway configuration will
actually be made. For best results, the local HPDPS system should be
running so that the utility can query the system to determine
which gateway printers, if any, would be created/deleted.
- -v
Verbose mode. Provides more extensive output in the
error.log.
RETURN VALUE
pdgwcfg
exits with one of the following values:
- 0
Successful completion.
- 1
Failure.
EXTERNAL INFLUENCES
Environment Variables
PATH
needs to include at a minimum
/usr/bin:/opt/pd/bin.
PDBASE
affects the location of the
error.log
EXAMPLES
If it is desirable to have a single configuration file distributed
across multiple
systems, there are various ways to distribute the configuration file
and have the utility invoked to configure a system (e.g.
swinstall(1M),
rdist(1),
etc.). Each method should
be weighed against the administration and security concerns of your
particular environment.
The below is just an example using
rdist(1)
and is not intended to be a recommendation.
# sample distfile for use with rdist
# copies /etc/pdgwcfg.conf and invokes the pdgwcfg utility
# invoke as 'rdist -b -h -f distfile'
HOSTS = ( host7 host8 )
FILES = ( /etc/pdgwcfg.conf )
${FILES} -> ${HOSTS}
install ;
special /etc/pdgwcfg.conf \\
" PATH=/usr/bin:/opt/pd/bin;pdgwcfg" ;
To update the configuration on host8 only, one would invoke:
rdist -b -h -f distfile -m host8
WARNINGS
By default, any gateway printer not listed in
/etc/pdgwcfg.conf
will be removed.
pdgwcfg
does not check for entry modifications in
/etc/pdgwcfg.conf.
See
pdgwcfg.conf(4)
for possible ways to accomplish modifications.
If the descriptor attribute is modified,
then the
-m
option will not consider these gateway printers as
candidates for deletion because it overrides the
PDGWCFG-MARKER
marker that
pdgwcfg
would have placed in that attribute.
AUTHOR
pdgwcfg
was developed by HP.
