mirror of https://github.com/ceph/ceph
377 lines
6.9 KiB
ReStructuredText
377 lines
6.9 KiB
ReStructuredText
|
|
=============
|
|
CephFS Shell
|
|
=============
|
|
|
|
The File System (FS) shell includes various shell-like commands that directly interact with the :term:`Ceph Filesystem`.
|
|
|
|
Usage :
|
|
|
|
cephfs-shell [-options] -- [command, command,...]
|
|
|
|
Options :
|
|
-c, --config FILE Set Configuration file.
|
|
-b, --batch FILE Process a batch file.
|
|
-t, --test FILE Test against transcript(s) in FILE
|
|
|
|
|
|
.. note::
|
|
|
|
Latest version of the cmd2 module is required for running cephfs-shell.
|
|
If CephFS is installed through source, execute cephfs-shell in the build
|
|
directory. It can also be executed as following using virtualenv:
|
|
|
|
.. code:: bash
|
|
|
|
[build]$ virtualenv -p python3 venv && source venv/bin/activate && pip3 install cmd2
|
|
[build]$ source vstart_environment.sh && source venv/bin/activate && python3 ../src/tools/cephfs/cephfs-shell
|
|
|
|
Commands
|
|
========
|
|
|
|
mkdir
|
|
-----
|
|
|
|
Create the directory(ies), if they do not already exist.
|
|
|
|
Usage :
|
|
|
|
mkdir [-option] <directory>...
|
|
|
|
* directory - name of the directory to be created.
|
|
|
|
Options :
|
|
-m MODE Sets the access mode for the new directory.
|
|
-p, --parent Create parent directories as necessary. When this option is specified, no error is reported if a directory already exists.
|
|
|
|
put
|
|
---
|
|
|
|
Copy a file/directory to Ceph Filesystem from Local Filesystem.
|
|
|
|
Usage :
|
|
|
|
put [options] <source_path> [target_path]
|
|
|
|
* source_path - local file/directory path to be copied to cephfs.
|
|
* if `.` copies all the file/directories in the local working directory.
|
|
* if `-` Reads the input from stdin.
|
|
|
|
* target_path - remote directory path where the files/directories are to be copied to.
|
|
* if `.` files/directories are copied to the remote working directory.
|
|
|
|
Options :
|
|
-f, --force Overwrites the destination if it already exists.
|
|
|
|
|
|
get
|
|
---
|
|
|
|
Copy a file from Ceph Filesystem to Local Filesystem.
|
|
|
|
Usage :
|
|
|
|
get [options] <source_path> [target_path]
|
|
|
|
* source_path - remote file/directory path which is to be copied to local filesystem.
|
|
* if `.` copies all the file/directories in the remote working directory.
|
|
|
|
* target_path - local directory path where the files/directories are to be copied to.
|
|
* if `.` files/directories are copied to the local working directory.
|
|
* if `-` Writes output to stdout.
|
|
|
|
Options:
|
|
-f, --force Overwrites the destination if it already exists.
|
|
|
|
ls
|
|
--
|
|
|
|
List all the files and directories in the current working directory.
|
|
|
|
Usage :
|
|
|
|
ls [option] [directory]...
|
|
|
|
* directory - name of directory whose files/directories are to be listed.
|
|
* By default current working directory's files/directories are listed.
|
|
|
|
Options:
|
|
-l, --long list with long format - show permissions
|
|
-r, --reverse reverse sort
|
|
-H human readable
|
|
-a, -all ignore entries starting with .
|
|
-S Sort by file_size
|
|
|
|
|
|
cat
|
|
---
|
|
|
|
Concatenate files and print on the standard output
|
|
|
|
Usage :
|
|
|
|
cat <file>....
|
|
|
|
* file - name of the file
|
|
|
|
cd
|
|
--
|
|
|
|
Change current working directory.
|
|
|
|
Usage :
|
|
|
|
cd [directory]
|
|
|
|
* directory - path/directory name. If no directory is mentioned it is changed to the root directory.
|
|
* If '.' moves to the parent directory of the current directory.
|
|
|
|
cwd
|
|
---
|
|
|
|
Get current working directory.
|
|
|
|
Usage :
|
|
|
|
cwd
|
|
|
|
|
|
quit/Ctrl + D
|
|
-------------
|
|
|
|
Close the shell.
|
|
|
|
chmod
|
|
-----
|
|
|
|
Change the permissions of file/directory.
|
|
|
|
Usage :
|
|
|
|
chmod <mode> <file/directory>
|
|
|
|
mv
|
|
--
|
|
|
|
Moves files/Directory from source to destination.
|
|
|
|
Usage :
|
|
|
|
mv <source_path> <destination_path>
|
|
|
|
rmdir
|
|
-----
|
|
|
|
Delete a directory(ies).
|
|
|
|
Usage :
|
|
|
|
rmdir <directory_name>.....
|
|
|
|
rm
|
|
--
|
|
|
|
Remove a file(es).
|
|
|
|
Usage :
|
|
|
|
rm <file_name/pattern>...
|
|
|
|
|
|
write
|
|
-----
|
|
|
|
Create and Write a file.
|
|
|
|
Usage :
|
|
|
|
write <file_name>
|
|
<Enter Data>
|
|
Ctrl+D Exit.
|
|
|
|
lls
|
|
---
|
|
|
|
Lists all files and directories in the specified directory.Current local directory files and directories are listed if no path is mentioned
|
|
|
|
Usage:
|
|
|
|
lls <path>.....
|
|
|
|
lcd
|
|
---
|
|
|
|
Moves into the given local directory.
|
|
|
|
Usage :
|
|
|
|
lcd <path>
|
|
|
|
lpwd
|
|
----
|
|
|
|
Prints the absolute path of the current local directory.
|
|
|
|
Usage :
|
|
|
|
lpwd
|
|
|
|
|
|
umask
|
|
-----
|
|
|
|
Set and get the file mode creation mask
|
|
|
|
Usage :
|
|
|
|
umask [mode]
|
|
|
|
alias
|
|
-----
|
|
|
|
Define or display aliases
|
|
|
|
Usage:
|
|
|
|
alias [name] | [<name> <value>]
|
|
|
|
* name - name of the alias being looked up, added, or replaced
|
|
* value - what the alias will be resolved to (if adding or replacing) this can contain spaces and does not need to be quoted
|
|
|
|
pyscript
|
|
--------
|
|
|
|
Runs a python script file inside the console
|
|
|
|
Usage:
|
|
|
|
pyscript <script_path> [script_arguments]
|
|
|
|
* Console commands can be executed inside this script with cmd ("your command")
|
|
However, you cannot run nested "py" or "pyscript" commands from within this script
|
|
Paths or arguments that contain spaces must be enclosed in quotes
|
|
|
|
py
|
|
--
|
|
|
|
Invoke python command, shell, or script
|
|
|
|
Usage :
|
|
|
|
py <command>: Executes a Python command.
|
|
py: Enters interactive Python mode.
|
|
|
|
shortcuts
|
|
---------
|
|
|
|
Lists shortcuts (aliases) available
|
|
|
|
Usage :
|
|
|
|
shortcuts
|
|
|
|
history
|
|
-------
|
|
|
|
View, run, edit, and save previously entered commands.
|
|
|
|
Usage :
|
|
|
|
history [-h] [-r | -e | -s | -o FILE | -t TRANSCRIPT] [arg]
|
|
|
|
Options:
|
|
-h show this help message and exit
|
|
-r run selected history items
|
|
-e edit and then run selected history items
|
|
-s script format; no separation lines
|
|
-o FILE output commands to a script file
|
|
-t TRANSCRIPT output commands and results to a transcript file
|
|
|
|
unalias
|
|
-------
|
|
|
|
Unsets aliases
|
|
|
|
Usage :
|
|
|
|
unalias [-a] name [name ...]
|
|
|
|
* name - name of the alias being unset
|
|
|
|
Options:
|
|
-a remove all alias definitions
|
|
|
|
set
|
|
---
|
|
|
|
Sets a settable parameter or shows current settings of parameters.
|
|
|
|
Usage :
|
|
|
|
set [-h] [-a] [-l] [settable [settable ...]]
|
|
|
|
* Call without arguments for a list of settable parameters with their values.
|
|
|
|
Options :
|
|
-h show this help message and exit
|
|
-a display read-only settings as well
|
|
-l describe function of parameter
|
|
|
|
edit
|
|
----
|
|
|
|
Edit a file in a text editor.
|
|
|
|
Usage:
|
|
|
|
edit [file_path]
|
|
|
|
* file_path - path to a file to open in editor
|
|
|
|
load
|
|
----
|
|
|
|
Runs commands in script file that is encoded as either ASCII or UTF-8 text.
|
|
|
|
Usage:
|
|
|
|
load <file_path>
|
|
|
|
* file_path - a file path pointing to a script
|
|
|
|
* Script should contain one command per line, just like command would betyped in console.
|
|
|
|
shell
|
|
-----
|
|
|
|
Execute a command as if at the OS prompt.
|
|
|
|
Usage:
|
|
|
|
shell <command> [arguments]
|
|
|
|
locate
|
|
------
|
|
|
|
Find an item in Filesystem
|
|
|
|
Usage:
|
|
|
|
locate [options] <name>
|
|
|
|
Options :
|
|
-c Count number of items found
|
|
-i Ignore case
|
|
|
|
stat
|
|
------
|
|
|
|
Display file status.
|
|
|
|
Usage :
|
|
|
|
stat [-h] <file_name> [file_name ...]
|
|
|
|
Options :
|
|
-h Shows the help message
|