github.com/slspeek/camlistore_namedsearch@v0.0.0-20140519202248-ed6f70f7721a/cmd/camput/doc.go (about)

     1  /*
     2  Copyright 2013 The Camlistore Authors.
     3  
     4  Licensed under the Apache License, Version 2.0 (the "License");
     5  you may not use this file except in compliance with the License.
     6  You may obtain a copy of the License at
     7  
     8       http://www.apache.org/licenses/LICENSE-2.0
     9  
    10  Unless required by applicable law or agreed to in writing, software
    11  distributed under the License is distributed on an "AS IS" BASIS,
    12  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13  See the License for the specific language governing permissions and
    14  limitations under the License.
    15  */
    16  
    17  /*
    18  The camput tool mainly pushes blobs, files, and directories. It can also perform various related tasks, such as setting tags, creating permanodes, and creating share blobs.
    19  
    20  
    21  Usage:
    22  
    23    camput [globalopts] <mode> [commandopts] [commandargs]
    24  
    25  Modes:
    26  
    27    delete: Create and upload a delete claim.
    28    attr: Add, set, or delete a permanode's attribute.
    29    file: Upload file(s).
    30    init: Initialize the camput configuration file. With no option, it tries to use the GPG key found in the default identity secret ring.
    31    permanode: Create and upload a permanode.
    32    rawobj: Upload a custom JSON schema blob.
    33    share: Grant access to a resource by making a "share" blob.
    34    blob: Upload raw blob(s).
    35  
    36  Examples:
    37  
    38    camput file [opts] <file(s)/director(ies)
    39    camput file --permanode --name='Homedir backup' --tag=backup,homedir $HOME
    40    camput file --filenodes /mnt/camera/DCIM
    41  
    42    camput blob <files>     (raw, without any metadata)
    43    camput blob -           (read from stdin)
    44  
    45    camput permanode                                (create a new permanode)
    46    camput permanode -name="Some Name" -tag=foo,bar (with attributes added)
    47  
    48    camput init
    49    camput init --gpgkey=XXXXX
    50  
    51    camput share [opts] <blobref to share via haveref>
    52  
    53    camput rawobj (debug command)
    54  
    55    camput attr <permanode> <name> <value>         Set attribute
    56    camput attr --add <permanode> <name> <value>   Adds attribute (e.g. "tag")
    57    camput attr --del <permanode> <name> [<value>] Deletes named attribute [value
    58  
    59  For mode-specific help:
    60  
    61    camput <mode> -help
    62  
    63  Global options:
    64    -help=false: print usage
    65    -secret-keyring="~/.gnupg/secring.gpg": GnuPG secret keyring file to use.
    66    -server="": Camlistore server prefix. If blank, the default from the "server" field of
    67    ~/.camlistore/config is used.
    68    Acceptable forms: https://you.example.com, example.com:1345 (https assumed),
    69    or http://you.example.com/alt-root
    70    -verbose=false: extra debug logging
    71    -verbose_http=false: show HTTP request summaries
    72    -version=false: show version
    73  */
    74  package main