'\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH cmis-client 1 2018-12-23 "libcmis 0.5.2" ""
.SH NAME
cmis-client
\- command line CMIS client tool. 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
help 
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] --url \fIurl://to/binding\fR list-repos 
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] [-u \fIlogin\fR] [-p \fIsecret\fR] --url \fIurl://to/binding\fR -r \fIrepo-id\fR repo-infos 
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] [-u \fIlogin\fR] [-p \fIsecret\fR] --url \fIurl://to/binding\fR -r \fIrepo-id\fR show-root 
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] [-u \fIlogin\fR] [-p \fIsecret\fR] --url \fIurl://to/binding\fR -r \fIrepo-id\fR get-content \fIid\fR 
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] [-u \fIlogin\fR] [-p \fIsecret\fR] --url \fIurl://to/binding\fR -r \fIrepo-id\fR --input-file \fIpath/to/file\fR --input-type \fImime/type\fR [--input-name \fIname.ext\fR] set-content \fIid\fR 
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] [-u \fIlogin\fR] [-p \fIsecret\fR] --url \fIurl://to/binding\fR -r \fIrepo-id\fR [--object-type \fIsome:cmistype\fR] [--object-property \fIprop-id=prop-value\fR]\&... create-folder \fIparent-id name\fR 
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] [-u \fIlogin\fR] [-p \fIsecret\fR] --url \fIurl://to/binding\fR -r \fIrepo-id\fR --input-file \fIpath/to/file\fR --input-type \fImime/type\fR [--input-name \fIname.ext\fR] [--object-type \fIsome:cmistype\fR] [--object-property \fIprop-id=prop-value\fR]\&... create-document \fIparent-id name\fR 
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] [-u \fIlogin\fR] [-p \fIsecret\fR] --url \fIurl://to/binding\fR -r \fIrepo-id\fR [--object-property \fIprop-id=prop-value\fR]\&... update-object \fIobject-id\fR 
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] [-u \fIlogin\fR] [-p \fIsecret\fR] --url \fIurl://to/binding\fR -r \fIrepo-id\fR type-by-id | show-by-id | show-by-path | delete 
\fIarg\fR
\&...
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] [-u \fIlogin\fR] [-p \fIsecret\fR] --url \fIurl://to/binding\fR -r \fIrepo-id\fR checkout | cancel-checkout | get-versions 
\fIarg\fR
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBcmis-client\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-v] [-u \fIlogin\fR] [-p \fIsecret\fR] --url \fIurl://to/binding\fR -r \fIrepo-id\fR [--input-file \fIpath/to/file\fR] [--input-type \fImime/type\fR] [--input-name \fIname.ext\fR] [--object-property \fIprop-id=prop-value\fR]\&... [--major] [--message] checkin \fIpwc id\fR 
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
The \fBcmis-client\fR tool sends queries over the net to a CMIS-enabled server
to access or modify its content. It is originally demonstrating what libcmis is capable of.
.SH OPTIONS
.SS "GLOBAL OPTIONS"
.TP 
-v, --verbose
Shows a lot of information to monitor what is happening behind the scene.
This helps a lot to debug libcmis.
.TP 
--help
Show the help and exit. This is equivalent to use the help command.
.TP 
--url \fIurl://to/binding\fR
\fIurl://to/binding\fR needs to point to the service document of
either AtomPub or WebService binding.
.TP 
-r,--repository \fIrepo-id\fR
Operate on the \fIrepo-id\fR CMIS repository.
If there is only one repository on the server, this parameter is not needed and that
repository will be automatically selected. Use this parameter if there are several
repositories on the server.
.TP 
-u,--username \fIlogin\fR
Connect as \fIlogin\fR to the CMIS server.
If not provided connect anonymously.
.TP 
-p,--password \fIsecret\fR
Use \fIsecret\fR to authenticate on the CMIS server.
.TP 
--no-ssl-check
Disables the SSL certificate verifications. Lowers the security, but may be handy
to work around bad certificates like expired or self-signed ones.
.TP 
--proxy \fIurl\fR
Use \fIurl\fR as the HTTP proxy.
Setting this value will override the system proxy settings.
.TP 
--proxy-username \fIlogin\fR
Use \fIlogin\fR to authenticate on the HTTP proxy.
.TP 
--proxy-password \fIsecret\fR
Use \fIsecret\fR to authenticate on the HTTP proxy.
.TP 
--noproxy \fIlist\fR
Proxy settings won't apply to hostnames and domain names listed 
in \fIlist\fR.
This value is a coma separated list.
.TP 
--oauth2-client-id \fIclient_id\fR
Application client id to use in the OAuth2 authentication flow.
.TP 
--oauth2-client-secret \fIclient_secret\fR
Application client secret to use in the OAuth2 authentication flow.
.TP 
--oauth2-auth-url \fIurl\fR
URL to authenticate the user in the OAuth2 authentication flow.
.TP 
--oauth2-token-url \fIurl\fR
URL to authenticate the application in the OAuth2 authentication flow.
The access and refresh tokens are provided by this URL.
.TP 
--oauth2-redirect-uri \fIuri\fR
URI where the OAuth2 authentication flow will redirect after a sucessful
authentication.
.TP 
--oauth2-scope \fIscope\fR
Requested scope to access in the OAuth2 authentication flow.
.SS "MODIFICATION OPERATIONS OPTIONS"
.TP 
--input-file \fIpath/to/file\fR
Upload \fIpath/to/file\fR as the new content stream
of the object.
.TP 
--input-type \fImime/type\fR
Set the mime type of the new content stream of the object to \fImime/type\fR.
.TP 
--input-name \fIname.ext\fR
Set the remote content stream filename of the new content stream of the object to \fIname.ext\fR.
.TP 
--object-type \fIsome:cmistype\fR
Set the object type of the CMIS object to be created to \fIsome:cmistype\fR.
This is the equivalent of --object-property cmis:objectTypeId=some:cmistype.
.TP 
--object-property \fIprop-id=prop-value\fR
Set a property to be updated or added to the CMIS object. \fIprop-id\fR is
the property definition id and \fIprop-value\fR is the value to set on it.
.TP 
--major
Create a major version when performing a checkin.
.TP 
-m, --message \fImessage\fR
Set the checking message.
.SS COMMANDS
.TP 
help
Show the help and exit.
.TP 
list-repos
List the repositories available on the server.
.TP 
repo-infos
Displays the informations and capabilities of the selected repository
.TP 
show-root
Displays the root node infos and children.
.TP 
get-content \fIid\fR
Download the content of the CMIS object corresponding to 
\fIid\fR in the current directory.
.TP 
set-content \fIid\fR
Upload a file as the content stream of the CMIS object corresponding to
\fIid\fR.
.TP 
create-folder \fIparent-id name\fR
Create a sub folder in folder \fIparent-id\fR
named \fIname\fR. The default type of the folder
to create is cmis:folder, but this can be changed using --object-type option.
.TP 
create-document \fIparent-id name\fR
Create a document in folder \fIparent-id\fR
named \fIname\fR. The default type of the document
to create is cmis:document, but this can be changed using --object-type option.

Note that the --input-file and --input-type may be mandatory, depending on the type of
the document to create and its constraints.
.TP 
update-object \fIobject-id\fR
Replace the writeable properties given with --object-property option on the object
matching id \fIobject-id\fR.
.TP 
type-by-id \fIarg...\fR
Displays the infos and children (if any) of all the CMIS types corresponding
to the listed ids.
.TP 
show-by-id \fIarg...\fR
Displays the infos and children (if any) of all the CMIS objects corresponding
to the listed ids.
.TP 
show-by-path \fIarg...\fR
Displays the infos and children (if any) of all the CMIS objects corresponding
to the listed paths.
.TP 
delete \fIarg...\fR
Deletes the CMIS objects corresponding to the listed ids. If the node
is a folder, its content will be removed as well.
.TP 
checkout \fIarg\fR
Checkout the document corresponding to the provided id and display
the infos of the created private working copy.
.TP 
cancel-checkout \fIarg\fR
Cancel the Private Working Copy corresponding to the node id.
.TP 
get-versions \fIarg\fR
Display the versions (if any) of all the CMIS object corresponding
to the provided id.
.TP 
checkin \fIarg\fR
Check in the private working copy corresponding to the provided id and display
the infos of the resulting document. Use the --major and --message options to
define the version to create and the commit to associate to it.
Note that repositories without the ability to update the private working copies
will need the --input-file, --input-type and --object-property options.
.SH USAGE
Displays the root node of repository A1:
.PP
\fBcmis-client\fR -r A1 --url http://localhost/atom show-root
.PP
Displays the nodes with id 133 and 116 of repository A1:
.PP
\fBcmis-client\fR -r A1 --url http://localhost/atom show-by id 133 116
.SH AUTHOR
C\('edric Bosdonnat
.SH "REPORTING BUGS"
Report bugs to <\(lahttps://github.com/tdf/libcmis/issues\(ra>.