.\" Man page generated from reStructuredText.
.
.TH "PLAINBOX-SESSION-LIST" "1" "January 05, 2016" "0.25" "Plainbox"
.SH NAME
plainbox-session-list \- list available session
.
.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
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
plainbox session list [\-h] [\-\-only\-ids]
.ft P
.fi
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.sp
List available sessions
.sp
The \fIplainbox session list\fP command simply prints a list of available
sessions. Each session has the following attributes displayed:
.INDENT 0.0
.TP
.B storage identifier:
A randomly\-looking identifier string starting with \(aqpbox\-\(aq that
identifies the session in the repository it comes from. The repository
is typically typically specific to the user\(aqs home directory:
\fB$XDG_CACHE_HOME/plainbox/sessions\fP\&.
.TP
.B app:
The name of the application that created the session.  Typically
\fIplainbox\fP or \fIcheckbox\fP\&. Plainbox only resumes sessions it has itself
created.
.TP
.B flags:
A list of flags. Existing flags are:
.INDENT 7.0
.TP
.B incomplete:
The session has some jobs left to run. Sessions with this flag can
be resumed
.TP
.B submitted:
The session was complete and the results were processed somehow.
Typically this means they were saved to a file or sent to the
certification website.
.UNINDENT
.sp
Note that other flags are possible and they are perfectly fine.
Applications can define their own flags that are not documented here or
even understood by the core.
.TP
.B title:
An arbitrary "title" of the session. Plainbox typically uses the
command line that was used to launch the session but other applications
may come up with more interesting titles. Plainbox also uses the title
to match find a possible resume candidate.
.UNINDENT
.SH OPTIONS
.sp

\fBOptional arguments:\fP
.PP
.INDENT 0.0
.TP
.B \-\-only\-ids=False
print one id per line only
.UNINDENT
.SH AUTHOR
Zygmunt Krynicki & Checkbox Contributors
.SH COPYRIGHT
2012-2014 Canonical Ltd
.\" Generated by docutils manpage writer.
.