Cmd_plasma



plasma - command-line access to PlasmaFS files

Synopsis

plasma list   <general options> [-1] pfs_file ...
plasma create <general options> [-rep n] pfs_file ...
plasma mkdir  <general options> pfs_file ...
plasma delete <general options> pfs_file ...
plasma put    <general options> [-rep n] [-chain] local_file pfs_file
plasma get    <general options> pfs_file local_file

General options:

-cluster <name> -namenode <host>:<port>

Description

The utility plasma allows one to directly access files stored in PlasmaFS via the PlasmaFS-specific RPC protocol.

All pfs_file arguments refer to the file hierarchy of the PlasmaFS cluster. For now, all such files need to be absolute, and there is no symlink resolution.

General options

The cluster to use is determined as follows:

  1. If -cluster and -namenode options are given, this cluster is used
  2. If there is a configuration file ~/.plasmafs the name set via -cluster is used to select which cluster is accessed
  3. If there is a configuration file ~/.plasmafs, but no -cluster option is passed to the command, the first configuration in the file is taken

The ~/.plasmafs configuration file

See Plasma_client_config.parse_config_file for a description.

list subcommand

list lists files (like Unix ls).

There is only one special option:

create subcommand

create creates a new file (which must not exist already).

Option:

mkdir subcommand

mkdir creates a new directory (which must not exist already).

delete subcommand

delete removes an existing file, or an existing and empty directory.

put subcommand

put creates a new file in PlasmaFS, and copies the contents of local_file to it. local_file must be seekable for now.

Options:

get subcommand

get downloads a file from PlasmaFS to the local filesystem.