Converter is a Java (SDK2) application that reads an MDSML
(XML) document, converts the information to another format
and then writes the converted document to either stdout
or a user-specified file. Currently, the supported
output formats include DSML, GOS, LDAP Attributes (at), LDAP
Objectclasses (oc), an HTML version of GOS, a LaTex version of
GOS, LDAPv3 subschema, as well as DIT, inheritance, and
aggregate graphs in dot input format.
OPTIONS
-input input-file
-format output-format
The output format (gos | attribute | objectclass |
html | latex | dsml | dit | inheritance | ldap |
aggregate | ldif)
-help Display the usage screen.
-output output
The output file for the converted document (default
is stdout).
-seperator seperator
The GOS namespace/type seperator (default is '::').
-oid-db oid-database
Specify the ldap "at" file which serves as a
database for retrieving OIDs. This option also
flags the converters to write out OIDs. If this
option is not used, OIDs will not be displayed.
-with-namespaces | -without-namespaces
Do or do not output namespaces for formats that may
contain them (default is without). -with-alter
nate | -without-alternate Do or do not generate an
alternate output (default is without). This is
currently only used in LaTex.
JAVA OPTIONS
-classpath
The classpath indicates where the necessary packages
are installed.
If you are using the "cog" jar distribution and are
running Converter from the distribution directory,
you will specify the following:
"-classpath cog.jar:xml4j.jar:xerces.jar".
If you are not running Converter from the distribu
tion directory, you will have to specify absolute
paths to the appropriate jar files.
If you are not using a pre-compiled jar distribution,
instead of specifiying a path to "cog.jar", you will
specify the path to the distribution's top-level directory.
Then specify the location of the other jar files. For example,
the following is what we use in our Makefiles:
"-classpath ../../..:../../../lib/xml4j.jar:../../../lib/xerces.jar"
DIAGNOSTICS
If error messages are displayed that complain about the
inability of the program to find certain java packages,
refer to the above section "JAVA OPTIONS" for more information.
Author:
Peter Lane (lane@mcs.anl.gov), Gregor von Laszewski (gregor@mcs.anl.gov)
Constructor Summary
Converter(java.lang.String[] args)
Creates and initializes a new MDSML converter with the command-line arguments
Method Summary
void
convert()
Controls the conversion from MDSML to another format
