Pittsburgh Supercomputing Center 

Advancing the state-of-the-art in high-performance computing,
communications and data analytics.

PSCBridges

PSC Receives NSF Award for Bridges Supercomputer - Read More

* patent pending

far commands

Most of the far commands are standard UNIX commands. They work in the usual way, and all of their switches and options are available. Additional information for the standard commands is available via the man pages.

far commands fall into these categories:

Storing and retrieving files

The put and get commands allow you to store and retrieve archived files:

put source-file target-file
copies a file from the current working directory to the archive. Both source and target filenames are required. The file is archived but not deleted. Existing archived files of the same name are overwritten.
put -R source-directory target-directory
copies an entire subtree from the source directory to the archive. Both source and target directories are required.
get source-file target-file
retrieves a file from the archive and saves it in your current working directory, unless you specify another directory in the target filename. Both source and target filenames are required. The file is not deleted from the archive. Existing files of the same name in the target directory are overwritten.
get -R source-directory target-directory
copies the entire subtree of the source directory to the target directory. Both source and target directories are required.

Examples:

put output  run1.dat

Saves the file output on the Data Supercell*, naming it run1.dat.

put output run1/data

Copies the file called output to the Data Supercell, storing it in directory run1 and naming it data.

put prog.f inp.dat out.dat  simulation

Copies prog.f, inp.dat, and out.dat to the archiver directory simulation.

get file1 file2 file3 $TMP

Copies file1, file2, and file3 from the current archive directory to your $TMP directory.

Displaying archived files

These commands allow you to display archived files:

head
prints the first few lines of a file.
tail
prints the last few lines of a file.
cat
displays the contents of a file.
ls
displays a directory listing for the archive. To determine if the file has an ACL associated it with it, type ls -le, which prints an afollowing the permissions strings for files with ACLs.
more
displays a file in paged mode.

For additional information on any of these commands, refer to the man pages.

These commands allow you to move around within, and modify, your archive hierarchy:

cp
makes another copy of a file in the archive.
cd
changes your working directory in the archive. cd is futile in line mode, since once you are moved to the appropriate directory, far exits. When you invoke far again to issue the next command, you start from your home directory.
mkdir
creates a new directory in the archive.
mv
renames or moves a file from one archive directory to another.
pwd
prints your current directory in the archive.
rm
deletes a file from the archive. Please note that there is no delete recovery provided; a file cannot be restored after it has been deleted.
rmdir
deletes a empty directory from the archive.

For additional information on any of these commands, refer to the man pages.

Modifying protections on archived files

Files copied into or out of the archive retain their permissions. New versions of files replacing older versions in the archive inherit the protection of the older version.

The file protection scheme used on the archiver matches that used by Unix. Use chmod to change the protections on a file and chgrp to change a file's group ownership. For more information on these commands, see your favorite Unix documentation.

Working with your local directory without leaving far

Two commands allow you to see and change your local directory - your working directory on the machine that you connected to the archiver from - without leaving the far interface.

lls
prints the directory listing of your working directory on your local machine.
lcd
changes your working directory on your local machine.

Getting help

Type help for more information on far commands.