NAME

sxprof - substitute LCFG resource values in template

SYNOPSIS

/usr/bin/sxprof [options] component [template [target-file]] | [var=value] ...

DESCRIPTION

Substitute LCFG resources from the specified component into the given template, to generate the named target file. Variable assignments specified on the command line overide any corresponding resource values.

OPTIONS

-B

Do not create backup files. Normally backup files are created with an extension of "~".

-d

Dummy run. Do not change target files, but still report which files would have changed, and set exit status accordingly.

-h hostname

Use resources for the specified host, rather than the current host. Note that this is only useful if the a DBM file for the specified host exists on the current machine; this will not normally be the case. rdxprof can however be used to fetch the profile for any machine and create the appropriate DBM file.

-i

Instead of reading resources from the profile, the resources are read from variables in the current environment, as created with the -e option of qxprof.

-l

Load resources from profile (default).

-L delimiter

Set the left delimiter used for substituted expresions (default <%). This is Perl regexp and sxprof wil fail if meta-characters are not correctly escaped.

-p pfx[,pfx]

The specified prefixes are used when creating shell variable names from resource names for importing resources from the environment. The first prefix is for variable names representing resource values, the second is for resource types. A %s in the prefix is replaced with the component name. The default values are: LCFG_%S_,LCFGTYPE_%_.

-r file

Read resources from named file rather than profile.

-R delimiter

Set the right delimiter used for substituted expresions (default %>). This is Perl regexp and sxprof wil fail if meta-characters are not correctly escaped.

-s

The Perl Template module is used to process the templates, instead of the builtin template processor.

-t

The component resource template is expected to contain a list of tags specifying a template to be processed. The resources tsrc_tag and tdst_tag should contain the template source and target filenames. These templates are processed before any templates specified on the command line.

-v

Verbose.

EXIT STATUS

0

No target files have been changed.

1

Error.

2

At least one of the target files has changed.

TEMPLATE LANGUAGE

See the manual page for the Perl module LCFG::Template.

FILES

/var/lcfg/conf/profile/dbm/hostname

The DBM file.

/usr/share/doc/lcfg-utils-1.2.42/EXAMPLE

An example template.

PLATFORMS

Solaris9, Fedora3, Fedora5, Darwin, Fedora6, Scientific5

AUTHOR

Paul Anderson <dcspaul@inf.ed.ac.uk>

POD ERRORS

Hey! The above document had some coding errors, which are explained below:

Around line 101:

Expected text after =item, not a number

Around line 105:

Expected text after =item, not a number