github.com/vchain-us/vcn@v0.9.11-0.20210921212052-a2484d23c0b3/docs/cmd/vcn_untrust.md (about)

     1  ## vcn untrust
     2  
     3  Untrust an asset
     4  
     5  ### Synopsis
     6  
     7  
     8  Change an asset's status so it is equal to UNTRUSTED.
     9  
    10  Untrust command calculates the SHA-256 hash of a digital asset
    11  (file, directory, container's image).
    12  The hash (not the asset) and the desired status of UNTRUSTED are then
    13  cryptographically signed by the signer's secret (private key).
    14  Next, these signed objects are sent to the blockchain where the signer’s
    15  trust level and a timestamp are added.
    16  When complete, a new blockchain entry is created that binds the asset’s
    17  signed hash, signed status, level, and timestamp together.
    18  
    19  Note that your assets will not be uploaded. They will be processed locally.
    20  
    21  Assets are referenced by passed ARG(s) with untrust command only accepting
    22  1 ARG at a time.
    23  
    24  ARG must be one of:
    25    wildcard
    26    file
    27    directory
    28    file://<file>
    29    dir://<directory>
    30    git://<repository>
    31    docker://<image>
    32    podman://<image>
    33    wildcard://"*"
    34    javacom://<java project component>
    35    nodecom://<node component>
    36    gocom://<Go module in name@version format>
    37    pythoncom://<Python module in name@version format>
    38    dotnetcom://<.Net module in name@version format>
    39  
    40  
    41  ```
    42  vcn untrust [flags]
    43  ```
    44  
    45  ### Examples
    46  
    47  ```
    48  vcn notarize my-file"
    49  vcn notarize -r "*.md"
    50  echo my-file | vcn n -
    51  ```
    52  
    53  ### Options
    54  
    55  ```
    56        --attach vcn a binary1 --attach=vscanner.result:jobid123   add user defined file attachments. Ex. vcn n myfile --attach mysecondfile. (repeat --attach for multiple entries). It's possible to specify a label for each entry, Ex: --attach=vscanner.result:jobid123. In this way it will be possible to retrieve the specific attachment with vcn a binary1 --attach=vscanner.result:jobid123 or `vcn a binary1 --attach=jobid123` to get all attachments
    57    -a, --attr key=value                                           add user defined attributes (repeat --attr for multiple entries)
    58        --bom-cascade                                              cascade the operation to all assets that include the asset being processed
    59        --bom-force                                                force notarization of untrusted dependencies, force cascade operation
    60        --ci-attr                                                  detect CI environment variables context if presents and inject
    61        --hash string                                              specify the hash instead of using an asset, if set no ARG(s) can be used
    62    -h, --help                                                     help for untrust
    63        --lc-api-key string                                        Codenotary Cloud server api key
    64        --lc-cert string                                           local or absolute path to a certificate file needed to set up tls connection to a Codenotary Cloud server
    65        --lc-host string                                           if set with host, action will be route to a Codenotary Cloud server
    66        --lc-no-tls                                                allow insecure connections when connecting to a Codenotary Cloud server
    67        --lc-port string                                           set port for set up a connection to a Codenotary Cloud server (default 443). If --lc-no-tls is provided default port will be 80 (default "443")
    68        --lc-skip-tls-verify                                       disables tls certificate verification when connecting to a Codenotary Cloud server
    69    -n, --name string                                              set the asset name
    70        --no-ignore-file                                           if set, .vcnignore will be not written inside the targeted dir (affects dir:// only)
    71    -p, --public                                                   when notarized as public, the asset name and metadata will be visible to everyone
    72        --read-only                                                if set, no files will be written into the targeted dir (affects dir:// only)
    73    -r, --recursive                                                if set, wildcard usage will walk inside subdirectories of provided path
    74  ```
    75  
    76  ### Options inherited from parent commands
    77  
    78  ```
    79    -o, --output string    output format, one of: --output=json|--output=yaml|--output=''. In Codenotary Cloud authenticate command is possible to specify also --output=attachments. It permits to download all items attached to an artifact.
    80    -S, --silent           silent mode, don't show progress spinner, but it will still output the result
    81        --vcnpath string   config files (default is /tmp/.vcn/config.json on linux, c:\temp\config.json or c:\windows\temp\config.json on Windows)
    82        --verbose          if true, print additional information
    83  ```
    84  
    85  ### SEE ALSO
    86  
    87  * [vcn](vcn.md)	 - vChain CodeNotary - Notarize and authenticate, from code to production
    88  
    89  ###### Auto generated by spf13/cobra on 18-Aug-2021