bionic (1) rdfproc.1.gz

Provided by: redland-utils_1.0.17-1.1_amd64 bug

NAME

       rdfproc - Redland RDF processor utility

SYNOPSIS

       rdfproc [options] store-name command arg...

EXAMPLE

       rdfproc test parse http://planetrdf.com/guide/rss.rdf
       rdfproc test print
       rdfproc test serialize ntriples

DESCRIPTION

       The  rdfproc  utility  allows  parsing,  querying, manipulating and  serializing of RDF content using the
       Redland RDF library.   The store-name is a  Redland  store  name,  typically  a  short  identifier.   The
       arguments to command vary and are explained in section COMMANDS below.

OPTIONS

       rdfproc  uses  the  usual  GNU  command  line syntax, with long options starting with two dashes (`-') if
       supported by the getopt_long function.  Otherwise the short options are only available.

       -h, --help
              Show a summary of the options.

       -c, --contexts
              Use a store with Redland contexts.

       -n, --new
              Make a new store, overwriting any existing one.

       -o, --output FORMAT
              Set the output FORMAT for sequences of triples, such as from a search (find command) to a  Redland
              serializer.  Use -h or -o help to see the full list of supported formats.

       -p, --password
              Read  the  storage option 'password' from standard input.  Terminated by end of line ('\n') or end
              of file.  This is equivalent to setting it using -t or  --storage-options  but  does  not  require
              exposing the password in the argument list.

       -q, --quiet
              Suppress informational messages (that go to stderr)

       -r, --results FORMAT
              Set  the  query  results  syntax  format.   Use -h or -r help to see the full list of query result
              formats.

              The exact list of formats depends on what libraptor(3) was built with but is given correct in  the
              usage message with -h.

       -s, --storage TYPE
              Set  the Redland storage type (default 'hashes').  If environment variable RDFPROC_STORAGE_TYPE is
              set, the storage type given here will override it.  Use -h or -s help to  see  the  full  list  of
              query result formats.

       -t, --storage-options OPTIONS
              Set  options  for  the  the  Redland  storage,  default is "hash-type='bdb',dir='.'"  to match the
              default storage "hashes".  For storages types such as 'mysql' that need extra options  this  would
              typically  be  something  like "host='hostname',database='dbname',user='abc',password='pass'".  If
              environment variable RDFPROC_STORAGE_OPTIONS is set,  the  storage  options  given  here  will  be
              applied afterwards.

       -v, --version
              Print the Redland version and exit.

       -V, --verbose
              Show informational messages on stderr.

COMMANDS

       Where  a node is allowed, such as NODE, SUBJECT, PREDICATE or OBJECT below, simple heuristics are used to
       guess which are blank node identifiers, URIs or literals (to add a statement with  a  literal,  use  add-
       typed).   If  the  item  starts with _: then it is assumed to be a blank node identifier, otherwise if it
       matches something:// it is assumed to be a URI, otherwise it is a literal.  Literals are only allowed  as
       objects of statements and blank nodes are not allowed as predicates.

       add SUBJECT PREDICATE OBJECT [CONTEXT]
              Add the given triple to graph, in the optional Redland context if the CONTEXT node is given.

       add-typed SUBJECT PREDICATE OBJECT OBJECT-LANG OBJECT-URI [CONTEXT]
              Add  the triple with the datatyped literal object to the graph, in the optional Redland context if
              CONTEXT is given.

       arc SUBJECT OBJECT

       arcs SUBJECT OBJECT
              Show one node/all nodes that match triples (SUBJECT, ?, OBJECT)

       arcs-in NODE
              Show all properties of triples with NODE as a subject.

       arcs-out NODE
              Show all properties of triples with NODE as an object.

       contains SUBJECT PREDICATE OBJECT
              Check if the given triple is in the graph.

       contexts
              List all the contexts in the graph (if contexts are enabled).

       find SUBJECT|- PREDICATE|- OBJECT|- [CONTEXT]
              Find matching triples to the given statement where - stands for a blank that matches any node.  If
              CONTEXT is given, only search for triples in that context node.

       has-arc-in NODE ARC
              Check that there is a triple with NODE as a subject and ARC as a predicate.

       has-arc-out NODE ARC
              Check that there is a triple with NODE as a object and ARC as a predicate.

       parse URI|FILENAME [SYNTAX| [BASE URI]]
              Parse  syntax  at  URI  into the graph using SYNTAX which can be one of rdfxml (RDF/XML, default),
              ntriples, turtle, rss-tag-soup (for all RSS and Atoms), grddl and guess to use content  hints  and
              protocol  information to work it out. (This list changes faster than this manual page) If FILENAME
              is a existing file, the appropriate URI will be generated for it.  If parsing returns errors,  the
              return code will be non-0.

       parse-stream URI|FILENAME [SYNTAX [BASE URI [CONTEXT]]
              Streaming  parse  syntax  at  URI into the graph using SYNTAX which can be one of rdfxml (RDF/XML,
              default) or ntriples.  If FILENAME is an existing file, the appropriate URI will be generated  for
              it.   If  the  optional  CONTEXT  URI is given, the triples are added to that context.  If parsing
              returns errors, the return code will be non-0.

       print  Print the graph triples in a simple format showing context nodes if present.

       query NAME|- URI|- QUERY-STRING
              Run QUERY-STRING query in language NAME returning  variable  bindings,  a  boolean  or  RDF  graph
              depending on the query.  Query language can be 'sparql' or 'rdql'.

       remove SUBJECT PREDICATE OBJECT [CONTEXT]
              Remove the given triple graph, in the optional Redland context if CONTEXT is given.

       remove-context CONTEXT
              Remove all triples in the graph with the Redland context CONTEXT.

       serialize [SYNTAX [URI [MIME-TYPE]]]
              Serializes  the  graph to a syntax with a particular ISYNTAX URI or Internet Media Type/MIME Type.
              The default is RDF/XML (NAME "rdfxml", MIME Type "application/rdf/xml") if none of the  above  are
              given.  Other alternatives are "ntriples" (no MIME Type).

       source PREDICATE OBJECT

       sources PREDICATE OBJECT
              Show one node/all nodes that match triples (?, PREDICATE, OBJECT)

       target SUBJECT PREDICATE

       targets SUBJECT PREDICATE
              Show one node/all nodes that match triples (SUBJECT, PREDICATE, ?)

ENVIRONMENT

       RDFPROC_STORAGE_OPTIONS  can be set to provide storage options instead of using the option -t, --storage-
       options OPTIONS.  When both are given, command options are applied last.

       RDFPROC_STORAGE_TYPE can be set to provide a storage type instead of using the option -s, --storage TYPE.
       When both are given, the storage type from the command is used.

CONFORMING TO

       RDF/XML     Syntax     (Revised),     W3C     Recommendation,    http://www.w3.org/TR/rdf-syntax-grammar/http://www.w3.org/TR/rdf-syntax-grammar/N-Triples,  in  RDF  Test   Cases,   Jan   Grant   and   Dave   Beckett   (eds.)    W3C   Recommendation,
       http://www.w3.org/TR/rdf-testcases/#ntriples ⟨http://www.w3.org/TR/rdf-testcases/#ntriples⟩

SEE ALSO

       redland(3), libraptor(3), rapper(1)

AUTHOR

       Dave Beckett - http://www.dajobe.org/http://www.dajobe.org/⟩

                                                   2010-08-29                                         rdfproc(1)