NAME

jls − list contents of a Jaquith archive directory. 

SYNOPSIS

jls  [−arch archive] [−server hostname]  [−port port] [−range (date1,date2)] [−owner name] [−group name] [−abs regexp] [-u] [−asof date] [−since date] [-first n] [-last n] [−all] [−moddate] [filelist] [−l] [−i] [−u] [−a] [−s] [-g] [−d] [-R] [-raw]

OPTIONS

−arch archiveName of logical archive.  If none is specified, the environment variable JARCHIVE is used, if defined, else the default archive is used. 

−server hostname
Specifies host where Jaquith server is running. Defaults to the environment variable JSERVER.

−port portSpecifies port number where Jaquith server is running. Defaults to the environment variable JPORT. 

−range date1,date2
List files with date in specified range.

−owner nameList only files with specified owner name. 

−group nameList only files with specified group name. 

−abs regexpList files which match regexp in their abstract lines. 

−asof dateList version which was current as of specified date. Equivalent to: −range(1-jan-1970,date)

−since dateList versions between date and present date. Equivalent to: −range(date,present-date)

−first nList from the nth version in the date range. 

−lastList to the nth version in the date range. 

−allList all the versions in the archive. Equivalent to: -first 1 -last -1

−moddateUse the file’s modification date, not its archive date for all date comparisons. 

−lDisplay using long format (see below). 

−iDisplay buffer number where file lives, volume id where buffer lives, and position on volume of buffer. 

−uDisplay archive date instead of last-modification date (with -l option). 

−aDisplay abstract. 

−sDisplay file size in 1024 byte units. 

−gDisplay group name. 

−dDisplay directory name only. 

−RDisplay directory tree recursively. 

−rawDisplay output in raw mode. This feature is undocumented, (you are NOT presently reading this) and is subject to change/removal. 

DESCRIPTION

Jls provides a simple directory listing mechanism for an archive tape system controlled by the Jaquith program. 

The primary argument filelist is a  file expression which specifies the files to be listed.  Shell-like globbing is supported. ’∗’ matches any number of characters. ’?’ matches a single character. Additionally, curly braces can be used to enclose alternatives. For example foo.{bak,?} matches foo.bak, foo.c and foo.h. 

Note that any metacharacters which are not protected with a backslash or quotes will be expanded by the shell, not by the Jaquith system. 

The default action is to list the simple filenames of the most recent versions of matching filenames.  The set of files listed can be controlled by the use of one or more options.  The options are all logically ANDed together; only files matching all criteria are listed. 

The -range, -first and -last options work together to specify a subset of the archived versions.  First, the date range is applied, resulting in a list of candidates numbered logically from 1 to n.  Then the first and last options are applied to this list. First and last can be positive and retrieve the specified filenames from restricted list, or they can be negative in which case they count from the end of the list. Thus, the most recent version of a file can be retrieved with ’first -1 last -1’ without having to know how many versions currently exist. 

date is of the form DateSpec[:TimeSpec]. TimeSpec is of the form [hh[:mm[:ss]]], and DateSpec is of the form dd-month[-yyyy]. Month is the first 3 letters of the month; all others are numbers. The ’/’ character is a substitute for ’-’ and ’.’ may be used instead of ’:’. 

By default jls simply lists the matching filenames, 1 per line.  In long form jls generates:

mode ownerID size date filename

With the -i option the "inode" information is included:

tBufId volId filemark mode ownerID size date filename

date is the archive date if the -u option is given, else it’s the file’s last modification date. 

BUGS

The option flags have little relation to the standard ls options. 

No multicolumn formatting is provided. 

A file which matches more than one regular expression will be listed multiple times. 

Only one archive can be specified at a time. 

Unlike the shell, the Jaquith globbing characters ’∗’ and ’?’ match a ’.’ in the first position. 
 

SEE ALSO

jaquith jmgr jstat jput jget jctrl jcopy jclean jbuild
 

KEYWORDS

jaquith archive
 

Sprite version 1.0  —