NAME

jput − Store files in a Jaquith archive. 

SYNOPSIS

jput [−arch archive] [-server hostname] [-port port]
[−abs text] [−absfilter program] [−absfilteropt options] [-mod mod-date] [-dir] [-link] [-sync] [-force]  [-v] [-prune expression] [-prunefull expression] [-ignore expression]
[-mail mailaddr] [-newvol] [-crossremote] [-ackfreq count] [-local] filenames

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. 

−mod dateDump files modified since specified date. 

−abs textPut text in the abstract line for each file. 

−absfilter program
Invoke program to generate abstract for each file. The utility file is a good choice. 

−absfilteropt options
Option string to be passed to absfilter program. Must be enclosed in quotes if it contains spaces. ie. "-a -l". 

−linkFollow symbolic links. By default, the link is saved, not the file it points to. 

−syncWrite data synchronously to tape. Normally data is buffered on disk. There is a severe performance penalty with this option. 

−forceForce files to be archived, even if an up-to-date copy already exists on the archive. 

−vVerbose mode. Show filenames as they are processed. 

−dirPut the directory and top level contents only. By default jput is recursive. 

−mail mailaddr
Send response by mail to mailaddr when operation is complete. 

−newvolForce data onto a new volume.  The -sync option is also required. 

−prune expression
Subtrees with simple names matching globbing expression expression will not be archived, but their names will still appear in the parent directory list. Default is NULL expression. 

−prunefull expression
Subtrees with absolute path names matching globbing expression expression will not be archived, but their names will still appear in the parent directory list. Default is NULL expression. 

−ignore expression
Files with simple names matching globbing expression expression will not be archived and their names will not be listed in the parent directory.  Default is ’{#∗#,∗~}’. 

−crossSprite only: Enable crossing of remote links. By default jput stays within the filesystem containing the files on the command line. 

−ackfreq count
Server should acknowledge every count file. 

−localSprite only: The files are local to the server so don’t send the data over the net. This is strictly a Sprite performance hack for large backups. Invoker must be login id ’root’. 

DESCRIPTION

Jput stores a directory subtree onto an archive system controlled by the Jaquith server.  The filenames which match filenames are stored on the archive if they have been modified since the last time they were archived, or if the -force option is used. 

The argument filepath is interpreted as it would be for a standard ls command, i.e., it is interpreted relative to the current working directory, unless it begins with ’/’. 

A plain file is considered to be modified if the last modification time/date as reported by stat is more recent than the date/time the file was archived, or if the permissions have changed.  A directory is considered modified if the list of files in it has changed since it was last archived, or if the permissions have changed. 

The list of filenames is filtered (using Unix globbing rules, but see BUGS below) by the -prune, -prunefull, and -ignore expressions. Any filename which matches any of these expressions is silently skipped. The options are similar except that pruned filenames will appear in their parent directory’s list whereas ignored files will not. 

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

Files are stored and indexed by their current pathname so there is no way to store file foo as bar. 

There is currently no support for hard links. 

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

An abstract must be less than 16 kilobytes long. 
 

SEE ALSO

jaquith jmgr jls jstat jget jctrl jcopy jclean jbuild
 

KEYWORDS

jaquith archive

Sprite version 1.0  —