Skip to main content

ls

File information includes file path, date of creation, file size and author.

info

The ls command can be used with or without prepending bx:// to the path.

Usage

bx ls [-a] [--help] [<path>]

Parameters and inputs

ShorthandLong versionDescription
-a--aliasesShow all aliases of the file
--helpShow this help message and exit

Example

Running ls with no arguments

Typing bx ls will show the contents from the root of your file-system.

$ bx ls
jobs/ Thu Oct 31 13:14:14 CET 2019 nacho
bio/ Thu Oct 31 17:01:14 CET 2019 nacho
test/ Mon Nov 04 15:42:39 CET 2019 david

Running ls on a directory

Directories in BatchX end with a forward slash (/). In this example, running bx ls on the bio directory will display its content.

$ bx ls bio/
bio/hg38/ Sun Nov 03 10:00:39 CET 2019 david
bio/demo/ Mon Nov 04 16:00:44 CET 2019 david
bio/fastqs/ Fri Nov 08 16:33:03 CET 2019 david
bio/RNA-Seq/ Thu Nov 21 17:27:47 CET 2019 david
bio/ROS1.fa Thu Oct 31 17:01:14 CET 2019 18.4 kB nacho

Show all aliases of a file

From the previous output we can run bx ls -a on the bio/ROS1.fa file. In addition to the previous information we also obtain additional references pointing to this file.

$ bx ls -a bio/ROS1.fa
FILE CREATED SIZE USER
bio/ROS1.fa Thu Oct 31 17:01:14 CET 2019 18.4 kB nacho
Aliases (pointers to the same data): 4
jobs/5/input/file0/ROS1.fa
jobs/6/input/file0/ROS1.fa
jobs/7/input/file0/ROS1.fa
jobs/8/input/file0/ROS1.fa