HSI File and Directory Commands

Summary of HSI Commands by Function

Note: a complete list of HSI commands is available in Chapter 8.

HPSS File and Directory Commands

Command	Function
cd, cdls, cdup	Change current directory
du	Calculate space occuiped and file count for directories
get, cget, mget, recv	Copy an HPSS-resident file to a local file
cp, copy	Copy a file within HPSS
delete, mdelete, erase, rm	Remove a file from HPSS
dump	List Name Server and Bitfile Server info about a namespace object
ln	Create a hard or symbolic link
ls, list, dir	List directory
put, cput, mput, replace, save, store, send	Copy a local file to HPSS
pwd	Print current directory
find	Traverse a directory tree looking for files or directories that match a set of criteria
mv, move, rename, crename	Rename an HPSS file
mkdir, md, add	Create an HPSS directory
rmdir, rd, remove	Delete an HPSS directory

Local File and Directory Commands

Command	Function
lcd, lcdls	Change local directory
lls	List local directory
lmd, lmkdir	Make a local directory
lpwd	Print current local directory
!command	Issue shell command

File Administrative Information

Command	Function
chacct	Change account id of file or directory
chcos	Change Class of Service for a file
chgrp	Change group id of file or directory
chmod	Change permissions of file or directory
chown	Change owner of file or directory
touch	Update last access time
umask	Set file creation permission mask

Storage Hierarchy Commands

Command	Function
lscos	List available hierarchies
stage	Stage files to disk cache

Keywords

Command	Function
set, default	Change keyword value
dirn	Set working directory
backup	Keep a copy of overwritten files

Saved Keysets

Command	Function
adopt	Load a keyset
free	Delete a keyset
keep	Save a keyset
show	Display a keyset

Miscellaneous HSI commands

Command	Function
debug	Toggles displaying debug messages
groups	Displays DCE group membership for authenticated user
help	Display help information
lsconnections	List the currently active HPSS connections (HSI non-DCE version)
lsjunctions	List the junctions defined by HPSS administrator
lssites	(HSI non-DCE version) List the site info for HPSS systems defined in the .hsirc or host-wide hsirc file.
newacct	Changes current Account ID
progress	Toggles displaying progress of file transfers
quit, exit, end	Terminate HSI
in	Read commands from a local file
out	Write HSI output to a local file
log	Write all HSI commands and responses to a local log file
bell	Toggles terminal bell
prompt	Toggles HSI prompting for mget, mput, and mdelete

HSI is a command-driven interface to the HPSS Mass Storage System.

Current DCE credentials are required to use HSI on DCE-based hosts. Non-DCE hosts use a variety of authentication methods, including Kerberos and the SDSC Encryption/Authentication (SEA) method.

HSI can accept input several different ways:

From a command line.
Single line execution.
From a command file.

Example: hsi
Example: hsi "mkdir foo; cd foo; put data_file"
Example: hsi "in command_file"

HSI can read from standard input and write to standard output.

Example:

tar cvf - . | hsi put - : data.tar
hsi get - : data.tar | tar xvf -

WARNING: For 'get' and 'put' operations, HSI uses a different syntax than FTP to identify the local file name. The syntax uses a ':' (colon character) to separate the local pathname from the HPSS pathname. Note that as of version 2.4 of HSI, the colon character must be surrounded by whitespace. See section 5.8 of the online documentation for details. Use the version command to see which version of HSI you are using. The HSI version is also displayed at startup time unless the -q ("quiet") option is specified on the command line.

Example:

put local_file : hpss_file

Recursive operations are allowed for the following commands:

cget, chgrp, chmod, chown, cput,
delete, get, ls, mdelete, mget, mput
put, rm, stage, touch

Wildcards are supported. See section 5.9 of the online documentation.