.\" Man page generated from reStructuredText.
.
.TH "OONIREPORT" "1" "Dec 07, 2016" "2.1.0" "OONI: Open Observatory of Network Interference"
.SH NAME
oonireport \- upload ooniprobe measurements
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBoonireport\fP [\fIoptions\fP] upload | status [\fIpath to report\fP]
.SH DESCRIPTION
.sp
\fBoonireport\fP is a tool for viewing which ooniprobe
reports have not been submitted to a collector and upload them.
.sp
\fBooniprobe \-i /usr/share/ooni/decks\-available/web.yaml\fP
.SH OPTIONS
.INDENT 0.0
.TP
.B \-d\fP,\fB  \-\-default\-collector
Upload the reports to the default collector that is looked up
with the canonical bouncer.
.TP
.B \-f\fP,\fB  \-\-configfile
Specify the configuration file to use.
.TP
.B \-c\fP,\fB  \-\-collector
Specify the collector to upload the result to.
.TP
.B \-b\fP,\fB  \-\-bouncer
Specify the bouncer to query for a collector.
.sp
\-\-version
.INDENT 7.0
.TP
.B \-\-help
Display this help and exit.
.UNINDENT
.UNINDENT
.SH COMMANDS
.sp
\fBupload\fP
.sp
If no argument is specified all the reports that have not been
submitted will be submitted to either the collector specified as
an option (\-c) or to the collector that was previously used.
.sp
If a report file is specified then only that report file will be
uploaded
.sp
\fBstatus\fP
.sp
Outputs all of the reports that are either "not uploaded",
"incomplete" or "pending".
.sp
The possible statuses are:
.sp
not\-created
.sp
If it has not been created, because the user specified to not use a
collector.
.sp
creation\-failed
.sp
If we attempted to create the report, but failed to do so either because
the collector does not accept our report or because it was unreachable at the
time.
.sp
created
.sp
If the report has been successfully created, but has not yet been
closed.
.sp
incomplete
.sp
If the report has been created, but we have failed to update the
report with some data.
.SH OONIREPORT
.sp
This tool is used to upload reports that are stored on the users
filesystem and have not been submitted to a collector. This can be
either because the collector was unreachable when we attempted to
submit the report or because the policy of the collector did not
support the specified test.
.SH AUTHOR
The Tor Project
.SH COPYRIGHT
2016, The Tor Project
.\" Generated by docutils manpage writer.
.