DACSTRANSFORM(1) | DACS Commands Manual | DACSTRANSFORM(1) |
dacstransform - rule-based document transformation
dacstransform [dacsoptions[1]]
[-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)[2] for details.
If the program is executed through the system's "#!" mechanism (execve(2)[3]), 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 program has some limitations, including missing configuration capabilities and features, that might be expected in a production version but which have not yet been implemented.
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)[4] 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 str
-docs dir
-f
-h
-help
-insert dir
-name str
-prefix str
-suffix str
-r rules_uri
-rules rules_uri
-rprefix regex
-rsuffix regex
-var name=value
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.
-x
--
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:
The program exits 0 if everything was fine, 1 if an error occurred.
dacs_transform(8)[2], dacs.exprs(5)[6], dacs.acls(5)[7]
Distributed Systems Software (www.dss.ca[8])
Copyright © 2003-2018 Distributed Systems Software. See the LICENSE[9] file that accompanies the distribution for licensing information.
02/19/2019 | DACS 1.4.40 |