NAME

jget − list contents of a Jaquith archive directory. 

SYNOPSIS

jget  [−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] [-mail mailaddr] [−target directory] [−dir] [−filter] [−tar] [−tarbuf bufSize]
 

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
Retrieve files with date in specified range.

−owner nameRetrieve only files with specified owner name. 

−group nameRetrieve only files with specified group name. 

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

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

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

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

−lastRetrieve to the nth version in the date range. 

−allRetrieve 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. 

−mailSend response by mail to mailaddr. 

−target directory
Restore file hierarchy relative to specified directory. By default, files are restored with their original pathnames.

−dirRestore directory’s top-level contents only. 

−filterRun jget as in filter mode. Data is restored directly to stdout. 

−tarData is restored directly to stdout in tar format. 

−tarbuf bufSize
With -tar option, use a buffer size of bufSize.  Default is 10KB. 

DESCRIPTION

Jget provides a simple file retrieval 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 both 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 retrieve the most recent versions of matching filenames.  The set of files retrieved can be controlled by the use of one or more options.  The options are all logically ANDed together; only files matching all criteria are retrieved. 

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 ’:’. 
 

BUGS

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

There is currently no support for hard links. 

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 jls jstat jput jctrl jcopy jclean jbuild
 

KEYWORDS

jaquith archive

Sprite version 1.0  —