mirror of
https://github.com/cookiengineer/audacity
synced 2025-06-23 07:40:05 +02:00
149 lines
4.1 KiB
Groff
149 lines
4.1 KiB
Groff
.\" Hey, EMACS: -*- nroff -*-
|
|
.\"
|
|
.\" roqet.1 - Rasqal RDF query test program
|
|
.\"
|
|
.\" $Id: roqet.1,v 1.1 2008-07-08 10:47:07 larsl Exp $
|
|
.\"
|
|
.\" Copyright (C) 2004-2008 David Beckett - http://www.dajobe.org/
|
|
.\" Copyright (C) 2004-2005 University of Bristol - http://www.bristol.ac.uk/
|
|
.\"
|
|
.TH roqet 1 "2008-06-22"
|
|
.\" Please adjust this date whenever revising the manpage.
|
|
.SH NAME
|
|
roqet \- Rasqal RDF query utility
|
|
.SH SYNOPSIS
|
|
.B roqet
|
|
.RB [ OPTIONS ]
|
|
.IR "<query-URI>"
|
|
.IR "[base-URI]"
|
|
.br
|
|
.B roqet
|
|
.RB [ OPTIONS ] -e
|
|
.IR "query-string"
|
|
.IR "[base-URI]"
|
|
.SH EXAMPLE
|
|
.nf
|
|
.B roqet example.sparql
|
|
.br
|
|
.B roqet -q -i rdql x.rdql http://example.org/base/
|
|
.br
|
|
.B roqet -i sparql -r xml http://example.org/query.rq
|
|
.br
|
|
.SH DESCRIPTION
|
|
The
|
|
.B roqet
|
|
utility allows querying of RDF content using the
|
|
.B Rasqal
|
|
RDF query library, printing the results in variable bindings,
|
|
RDF graph or boolean format. The query is read from \fIquery-URI\fR and
|
|
the optional \fIbase-URI\fR is used as the base URI of the query if present.
|
|
.SH MAIN OPTIONS
|
|
roqet uses the usual GNU command line syntax, with long
|
|
options starting with two dashes (`-') if supported by the
|
|
getopt_long function. Otherwise only the short options are available.
|
|
.TP
|
|
.B \-e, \-\-exec QUERY
|
|
Execute the query in the argument
|
|
.I QUERY
|
|
instead of reading the query from a URI (when -e is not given).
|
|
.TP
|
|
.B \-i, \-\-input LANGUAGE
|
|
Set the input query
|
|
.I LANGUAGE
|
|
to one of'sparql' (SPARQL Query Language for RDF, default)
|
|
or 'rdql' (RDF Data Query Language). The list of
|
|
supported languages is given in the help summary given by \-h.
|
|
.TP
|
|
.B \-r, \-\-results FORMAT
|
|
Set the query results format.
|
|
.IP
|
|
For variable bindings, the values of
|
|
.I FORMAT
|
|
vary upon what Rasqal supports but include 'simple'
|
|
for a simple text format (default), 'xml'
|
|
for the SPARQL Query Results XML format
|
|
and 'json' for a JSON version of the results.
|
|
.IP
|
|
For RDF graph results, the values of
|
|
.I FORMAT
|
|
are 'ntriples' (N-Triples, default), 'rdfxml-abbrev'
|
|
(RDF/XML Abbreviated), 'rdfxml' (RDF/XML), 'turtle' (Turtle), 'json'
|
|
(RDF/JSON resource centric), 'json-triples' (RDF/JSON triples)
|
|
or 'rss-1.0' (RSS 1.0, also an RDF/XML syntax).
|
|
.IP
|
|
The exact list of formats depends on what libraptor(3) was built with
|
|
but is given correct in the usage message with \-h.
|
|
.SH OTHER OPTIONS
|
|
.TP
|
|
.B \-c, \-\-count
|
|
Only count the triples and produce no other output.
|
|
.TP
|
|
.B \-D, \-\-data URI
|
|
Add RDF data source URI (not a named graph)
|
|
.TP
|
|
.B \-d, \-\-dump\-query FORMAT
|
|
Print the parsed query out in a given
|
|
.I FORMAT
|
|
one of 'debug', 'structure' or 'sparql'
|
|
.TP
|
|
.B \-f, \-\-feature NAME(=VALUE)
|
|
Set query feature
|
|
.I NAME
|
|
to the
|
|
.I VALUE
|
|
or integer 1 if omitted.
|
|
The known features can be shown with \fB-f help\fP or \fB--feature help\fP.
|
|
.TP
|
|
.B \-G, \-\-named URI
|
|
Add RDF data source URI (named graph)
|
|
.TP
|
|
.B \-h, \-\-help
|
|
Show a summary of the options.
|
|
.TP
|
|
.B \-n, \-\-dryrun
|
|
Prepare the query but do not execute it.
|
|
.TP
|
|
.B \-q, \-\-quiet
|
|
No extra information messages.
|
|
.TP
|
|
.B \-s, \-\-source URI
|
|
Ad RDF data source URI (named graph))
|
|
.I URI
|
|
by adding it to the list of query data source URIs.
|
|
.I FORMAT
|
|
to 'simple' (default) or 'xml' (an experimental XML format)
|
|
.TP
|
|
.B \-v, \-\-version
|
|
Print the rasqal library version and exit.
|
|
.TP
|
|
.B \-w, \-\-walk-query
|
|
Walk the query and display it using the API.
|
|
.SH "CONFORMING TO"
|
|
\fISPARQL Query Language for RDF\fR,
|
|
Eric Prud'hommeaux and Andy Seaborne (eds), W3C Recommendation, 15 January 2008.
|
|
.UR http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/
|
|
http://www.w3.org/TR/2008/REC-rdf-sparql-query-20080115/
|
|
.UE
|
|
.LP
|
|
\fISPARQL Query Results XML Format\fR,
|
|
Jeen Broekstra and Dave Beckett (eds), W3C Recommendation, 15 January 2008.
|
|
.UR http://www.w3.org/TR/2008/REC-rdf-sparql-XMLres-20080115/
|
|
http://www.w3.org/TR/2008/REC-rdf-sparql-XMLres-20080115/
|
|
.UE
|
|
.LP
|
|
\fIRDQL - A Query Language for RDF\fR, Andy Seaborne,
|
|
W3C Member Submission 9 January 2004
|
|
.UR http://www.w3.org/Submission/2004/SUBM-RDQL-20040109/
|
|
http://www.w3.org/Submission/2004/SUBM-RDQL-20040109/
|
|
.UE
|
|
.SH SEE ALSO
|
|
.BR librasqal(3), rasqal-config(1), libraptor(3)
|
|
.SH CHANGES
|
|
.br
|
|
.SH AUTHOR
|
|
Dave Beckett -
|
|
.UR http://www.dajobe.org/
|
|
http://www.dajobe.org/
|
|
.UE
|
|
.br
|