CMIS-CLIENT(1)

📦
version 0.6.3 · 6 versions
, in arch rolling, fedora 43, fedora 44, nixpkgs unstable, ubuntu stonking

💖 NAME 💖

cmis-client — command line CMIS client tool. That's the whole vibe bestie, one tool, one job, go off ✨

🎀 SYNOPSIS 🎀

okay so here's literally every shape this command can take, no cap:

cmis-client help

cmis-client [-v] --url url://to/binding list-repos

cmis-client [-v] [-u login] [-p secret] --url url://to/binding
            -r repo-id repo-infos

cmis-client [-v] [-u login] [-p secret] --url url://to/binding
            -r repo-id show-root

cmis-client [-v] [-u login] [-p secret] --url url://to/binding
            -r repo-id get-content id

cmis-client [-v] [-u login] [-p secret] --url url://to/binding
            -r repo-id --input-file path/to/file --input-type mime/type
            [--input-name name.ext] set-content id

cmis-client [-v] [-u login] [-p secret] --url url://to/binding
            -r repo-id [--object-type some:cmistype]
            [--object-property prop-id=prop-value...]
            create-folder parent-id name

cmis-client [-v] [-u login] [-p secret] --url url://to/binding
            -r repo-id --input-file path/to/file --input-type mime/type
            [--input-name name.ext] [--object-type some:cmistype]
            [--object-property prop-id=prop-value...]
            create-document parent-id name

cmis-client [-v] [-u login] [-p secret] --url url://to/binding
            -r repo-id [--object-property prop-id=prop-value...]
            update-object object-id

cmis-client [-v] [-u login] [-p secret] --url url://to/binding
            -r repo-id [type-by-id] | [show-by-id] | [show-by-path] |
            [delete]  arg...

cmis-client [-v] [-u login] [-p secret] --url url://to/binding
            -r repo-id [checkout] | [cancel-checkout] | [get-versions]
            arg

cmis-client [-v] [-u login] [-p secret] --url url://to/binding
            -r repo-id [--input-file path/to/file]
            [--input-type mime/type] [--input-name name.ext]
            [--object-property prop-id=prop-value...] [--major]
            [--message] checkin pwc id

like… she's flexible 💅

🌸 DESCRIPTION 🌸

The cmis-client 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.

that's it, that's the tea ☕ it literally exists to show off what libcmis can do, and honestly? iconic behavior 👑

✨ OPTIONS ✨

🌈 GLOBAL OPTIONS

  • -v, --verbose — shows a lot of information to monitor what is happening behind the scene. This helps a lot to debug libcmis. (basically the "let me see everything" button 🔍)
  • --help — show the help and exit. This is equivalent to use the help command.
  • --url url://to/binding — url://to/binding needs to point to the service document of either AtomPub or WebService binding.
  • -r,--repository repo-id — operate on the repo-id 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.
  • -u,--username login — connect as login to the CMIS server. If not provided, connect anonymously.
  • -p,--password secret — use secret to authenticate on the CMIS server.
  • --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.
bestie listen, that one literally lowers your security 😭 it's fine as a workaround for cursed certs but do NOT make it your whole personality, fr fr
  • --proxy url — use url as the HTTP proxy. Setting this value will override the system proxy settings.
  • --proxy-username login — use login to authenticate on the HTTP proxy.
  • --proxy-password secret — use secret to authenticate on the HTTP proxy.
  • --noproxy list — proxy settings won't apply to hostnames and domain names listed in list. This value is a coma separated list.
  • --oauth2-client-id client_id — application client id to use in the OAuth2 authentication flow.
  • --oauth2-client-secret client_secret — application client secret to use in the OAuth2 authentication flow.
  • --oauth2-auth-url url — URL to authenticate the user in the OAuth2 authentication flow.
  • --oauth2-token-url url — URL to authenticate the application in the OAuth2 authentication flow. The access and refresh tokens are provided by this URL.
  • --oauth2-redirect-uri uri — URI where the OAuth2 authentication flow will redirect after a sucessful authentication.
  • --oauth2-scope scope — requested scope to access in the OAuth2 authentication flow.

🦋 MODIFICATION OPERATIONS OPTIONS

these are the ones that change stuff, so like, main character energy only 🫶

  • --input-file path/to/file — upload path/to/file as the new content stream of the object.
  • --input-type mime/type — set the mime type of the new content stream of the object to mime/type.
  • --input-name name.ext — set the remote content stream filename of the new content stream of the object to name.ext.
  • --object-type some:cmistype — set the object type of the CMIS object to be created to some:cmistype. This is the equivalent of --object-property cmis:objectTypeId=some:cmistype.
  • --object-property prop-id=prop-value — set a property to be updated or added to the CMIS object. prop-id is the property definition id and prop-value is the value to set on it.
  • --major — create a major version when performing a checkin.
  • -m, --message message — set the checking message.

💅 COMMANDS

  • help — show the help and exit.
  • list-repos — list the repositories available on the server.
  • repo-infos — displays the informations and capabilities of the selected repository
  • show-root — displays the root node infos and children.
  • get-content id — download the content of the CMIS object corresponding to id in the current directory.
  • set-content id — upload a file as the content stream of the CMIS object corresponding to id.
  • create-folder parent-id name — create a sub folder in folder parent-id named name. The default type of the folder to create is cmis:folder, but this can be changed using --object-type option.
  • create-document parent-id name — create a document in folder parent-id named name. 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.

  • update-object object-id — replace the writeable properties given with --object-property option on the object matching id object-id.
  • type-by-id arg... — displays the infos and children (if any) of all the CMIS types corresponding to the listed ids.
  • show-by-id arg... — displays the infos and children (if any) of all the CMIS objects corresponding to the listed ids.
  • show-by-path arg... — displays the infos and children (if any) of all the CMIS objects corresponding to the listed paths.
  • delete arg... — deletes the CMIS objects corresponding to the listed ids. If the node is a folder, its content will be removed as well.
okay real talk, that last one is giving no takebacks 💀 folder delete takes the whole squad down with it, be sure bestie
  • checkout arg — checkout the document corresponding to the provided id and display the infos of the created private working copy.
  • cancel-checkout arg — cancel the Private Working Copy corresponding to the node id.
  • get-versions arg — display the versions (if any) of all the CMIS object corresponding to the provided id.
  • checkin arg — 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.

⭐ USAGE ⭐

displays the root node of repository A1:

cmis-client -r A1 --url http://localhost/atom show-root

displays the nodes with id 133 and 116 of repository A1:

cmis-client -r A1 --url http://localhost/atom show-by id 133 116

see? not scary at all, you got this 🌟

👑 AUTHOR 👑

Cédric Bosdonnat

💀 REPORTING BUGS 💀

Report bugs to https://github.com/tdf/libcmis/issues.

go tell them, they wanna know, i promise 🙈

and that's the whole page bestie!! this was libcmis 0.6.3, dated 2018-12-23, and the manual is called CMIS-CLIENT(1) — read it, love it, go show-root on something 🌈✨ mwah 💖

📦 where this page comes from