.TH HDFSCLI "1" "October 2021" "" "User Commands"

.SH NAME

.B hdfscli

\(en a command line interface for HDFS

.SH SYNOPSIS

.B hdfscli

.RB [ interactive ]

.RB [ \-a\fR\ \fIALIAS ]

.RB [ \-v ...]

.P

.B hdfscli download

.RB [ \-fsa\fR\ \fIALIAS ]

.RB [ \-v ...]

.RB [ \-t\fR\ \fITHREADS ]

.I HDFS_PATH

.I LOCAL_PATH

.P

.B hdfscli upload

.RB [ \-sa\fR\ \fIALIAS ]

.RB [ \-v ...]

.RB [ \-A \ |\  \-f ]

.RB [ \-t\fR\ \fITHREADS ]

.I LOCAL_PATH

.I HDFS_PATH

.P

.B hdfscli

.BR \-L \ |\  \-v \ |\  \-h

.SH OPTIONS

.SS COMMANDS

.TP

.B download

Download a file or folder from HDFS.

If a single file is downloaded,

.B \-

can be specified as

.I LOCAL_PATH

to stream it to standard out.

.TP

.B interactive

Upload a file or folder to HDFS.

.B \-

can be specified as

.I LOCAL_PATH

to read from standard in.

Start the client and expose it via the python interpreter (using

.BR ipython (1)

if available).

.TP

.B upload

Upload a file or folder to HDFS.

.B \-

can be specified as

.I LOCAL_PATH

to read from standard in.

.SS ARGUMENTS

.TP

.I HDFS_PATH

Remote HDFS path.

.TP

.I LOCAL_PATH

Path to local file or directory.

.SS OPTIONS

.TP

.BR \-A \  \-\-append

Append data to an existing file.

Only supported if uploading a single file or from standard in.

.TP

.BR \-L \  \-\-log

Show path to current log file and exit.

.TP

.BR \-V \  \-\-version

Show version and exit.

.TP

.BR \-a \ \fIALIAS \-\-alias=\fIALIAS

Alias of namenode to connect to.

.TP

.BR \-f \  \-\-force

Allow overwriting any existing files.

.TP

.BR \-s \  \-\-silent

Don\(cqt display progress status.

.TP

.BR \-t \ \fITHREADS \-\-threads=\fITHREADS

Number of threads to use for parallelization.

.B 0

allocates a thread per file.

[default:

.BR 0 ]

.TP

.BR \-v \  \-\-verbose

Enable log output.

Can be specified up to three times (increasing verbosity each time).

.SH "EXIT\ STATUS"

HdfsCLI exits with return status

.B 1

if an error occurred and

.B 0

otherwise.

.SH EXAMPLES

.EX

.B hdfscli\ \-a\ prod\ /user/foo

.EE

.EX

.B hdfscli\ download\ features.avro\ dat/

.EE

.EX

.B hdfscli\ download\ logs/1987\-03\-23\ \-\ >>logs

.EE

.EX

.B hdfscli\ upload\ \-f\ \-\ data/weights.tsv\ 

.EE

.SH "SEE\ ALSO"

.BR hdfscli\-avro (1)

.P

.BR ipython (1)