| DACSTRANSFORM(1) | DACS Tools and Utilities | DACSTRANSFORM(1) |
dacstransform — rule-based document transformation
dacstransform [dacsoptions] [-admin] [-ct ] [str-docs ] [dir-f] [-F ] [field_sep-fd ] [domain-fh ] [hostname-fj ]jurname
[-fn ] [ fedname-h | -help ] [-i ] [ident-il ] [ident-ilg ] [ident-ieuid]
[-ieuidg] [-iuid] [-insert] [-iuidg] [-lg] [-name ] [str-prefix ] [str-roles ] [roles_vfs-rprefix ] [regex-rsuffix ] [regex-suffix ] [
{ str-r | -rules }
rules_uri
]
[-var ] [name=value-x] [--] { - | file }
This program is part of the DACS suite.
dacstransform supplies the functionality of dacs_transform from the command-line. Because the two programs are almost identical, please refer to dacs_transform(8) for details.
If the program is executed through the
system's "#!" mechanism
(execve(2)),
one or more command line arguments can be given:
#!/usr/local/dacs/bin/dacstransform -Dfoo=val -ct '' Hello, world Bye
Such programs always use the script file as input, therefore no
expression or other file can be specified on the "#!" line.
The arguments are processed as they are examined (left-to-right) and their ordering can be significant. Command line arguments override DACS configuration (see below).
Please refer to
dacscheck(1) for a description
of the flags related to setting identities and DACS
context.
If no identity is specified,
the program will use the values of the environment variables
REMOTE_USER and DACS_ROLES if they
are available and valid.
The following command line flags are recognized:
-ct strSet the MIME Content-Type to
str.
The default is not to emit this header.
-docs dirSet the directory containing the documents to
dir - the file
argument will be relative to dir.
If dir is the empty string, however,
this mapping will not be performed.
The mapping is also disabled if the -f is given or
if the standard input is read.
This argument overrides any configuration of
transform_docs or default behaviour.
-fDisable input file location mapping.
-h-helpPrints the usage blurb, which includes a listing of the program's defaults.
-insert dirIf a relative path is given for the value of a
filename attribute with the
insert,
insertv,
or expand directive,
prefix the relative path with the string dir.
-name strThe name of the input document is
str.
This is used to associate a rule with the document; that is, it is matched
against a rule's service or delegate
element.
By default, it is the name of the input file or the path component of the
input URI.
If the effective name does not begin with a slash character, one is
prepended.
The argument should probably be given if the standard input is being read.
-prefix strA directive is introduced by str
appearing at the beginning of an input line.
The default is "<--DACS ".
-suffix strA directive is terminated by str
appearing at the end of a directive line.
The default is "-->".
-r rules_uri-rules rules_uriThe location of the ruleset to be applied to the document, as a DACS VFS URI.
-rprefix regexA line whose beginning matches
regex introduces a directive.
This overrides the default and any -prefix flag.
IEEE Std 1003.2 ("POSIX.2") "extended" regular expressions are supported
(regex(3)).
-rsuffix regexA directive is terminated by a string that
matches regex, followed immediately by the
end of the line.
This overrides the default and any -suffix flag.
IEEE Std 1003.2 ("POSIX.2") "extended" regular expressions are supported
(regex(3)).
-var name=valueAdd a variable definition to the
DACS namespace.
The variable ${DACS:: will
be assigned the string name}value.
The name must be syntactically valid.
This flag is equivalent to the
dacsoptions flag
-Dname=value.
This flag may be repeated.
It is best to avoid the variable name stdin,
which has a special purpose.
If name is defined more than once its value
is indeterminate.
In a directive, an attribute value that is enclosed within backtick quotes
is evaluated as an expression, which may include variable references.
Variables from the Env namespace and, if available,
the Conf are also instantiated.
The current directive's attributes are accessible in the
Attr namespace;
these attribute values are unevaluated and quoted.
-xRun as a command, not a web service. This is often required when dacstransform is run as a CGI program.
--Flags end. An input source argument may follow.
After the flags, the input source can be specified.
By default, or if - is given, the standard input is read,
otherwise file is read.
Whitespace is not ignored at the beginning or end of an input line with respect to directive prefix and suffix matching.
Configuration variables can be set to change some of the program's defaults, but each one is overridden if a value is also given on the command line:
transform_docs:
This is the full pathname of the root directory in which original documents
are kept.
By default, the program will use a subdirectory
.
(default: ${Conf::DACS_HOME}dacs_transform/docs/usr/local/dacs/dacs_transform/docs)
Change the default with care.
In the absence of an appropriate access control rule,
setting the pathname to "/" or the empty string,
would provide access to any file on the server that can be
read by this web service.
transform_acls:
This is the VFS specification for the rules.
By default, the program will use
.
(default: ${Conf::DACS_HOME}dacs_transform/acls[transform-acls]dacs-fs:/usr/local/dacs/dacs_transform/acls)
transform_annotation:
This is the annotation to interpolate in redacted text instead of the default.
transform_prefix:
Instead of the default prefix string used to introduce a directive,
the value of this variable is used.
It must appear at the beginning of a line.
transform_suffix:
Instead of the default string used to end a directive,
the value of this variable is used.
transform_rprefix:
A line whose beginning matches the specified regular expression introduces
a directive.
transform_rsuffix:
The end of a directive is found by matching the specified regular expression.
Copyright © 2003-2018 Distributed Systems Software.
See the
LICENSE
file that accompanies the distribution
for licensing information.
| DACS Version 1.4.40 | 1-Feb-2018 | DACSTRANSFORM(1) |
| Table of Contents | ![]() |
Font:
|
−− | Set | ++ |
$Id: dacstransform.1.xml 2978 2018-01-23 22:39:14Z brachman $