XEROX DUMPER 2 4 1 DUMPER 1 4 By: Doug Cutting (DOUG@SU-CSLI.ARPA) Introduction DUMPER provides a facility for backing up NS file servers to some other filing device, presumably one with a tape drive. Use (DUMP HOST TO.DIRECTORY LOG.FILE NEWERTHAN NVERSIONS) [Function] Will copy all files on HOST to TO.DIRECTORY, keeping a log of files dumped in LOG.FILE. Only files written since NEWERTHAN, a date string, will be dumped. A maximum of NVERSIONS, an integer, of a given file will be dumped. NEWERTHAN defaults to the beginning of time (19-Jan-69 03:14:08 GMT). NVERSIONS defaults to positive infinity. DUMP returns the log file name. As DUMP runs it prints out its status to the terminal. For each top level directory dumped it will printout something like the following: DIRECTORY(33).........10.........20.........30...OK The number in parentheses after the name is how many files on that directory DUMPER intends to backup. One dot is printed for each file copied, with a number printed every ten dots. Errors encountered while copying or enumerating are trapped. The error message is printed out the the terminal and to to log, and the file or directory in question is not dumped. Note: In order to dump a directory you need to have read permission to that directory. This means to dump a file server one, or a group one is a member of, must be on the access list of every file drawer on that host. As changing all the drawers by hand can be quite tedious, and there exists no facility for automating this task, I suggest, as a slight improvement, shift selecting from TEdit into an NSCHAT window a script which makes the necesary change for one file drawer. Variables DUMP.DIRECTORY.SEPARATOR [Variable] Determines what will be substituted for >'s in filenames when copying. Default value is "\". This substitution is best explained by an example: The file {Host1:}SubDir>Foo.Bar when backing to {Host2} would be copied to {Host2}Dir1\SubDir\Foo.Bar. This scheme is meant to make it easy to translate between the original filename and the dumped file name. In addition to the NEWERTHAN and NVERSIONS filters, DUMPER provides two variables which limit the size of the dump. DUMP.IGNORE.DIRS [Variable] A list of top level directories which are not to be dumped. Directories on this list are never even enumerated. Default value is (FONTS CLEARINGHOUSE SYSTEMFILES DESKTOPS). DUMP.IGNORE.SPECS [Variable] A list of file specifications not to be dumped. Default value is (*.DCOM;* *.SYSOUT;*). Note: All of these variables are INITVARS, so if one sets them before loading DUMPER, your settings will not be overwritten. Modification The following function is given for so that, if its default behavior does not suit a site's needs, it may be advised or redefined. (DUMP.NEW.FILENAME FILE TO.DIR) [Function] Determines what FILE will be named when dumped to TO.DIR. Default behavior is as described above. (LIST ((PAGE NIL (PAPERSIZE Letter FOLIOINFO (ARABIC ) STARTINGPAGE# 1) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO (ARABIC )) (174 36 288 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 528 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL))) (PAGE NIL (PAPERSIZE Letter FOLIOINFO (ARABIC )) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO (ARABIC )) (174 36 288 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 528 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL))) (PAGE NIL (PAPERSIZE Letter FOLIOINFO (ARABIC )) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 INVISIBLE OFF SELECTPOINT OFF PROTECTED OFF SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF EXPANSION REGULAR SLOPE REGULAR WEIGHT MEDIUM INVERTED OFF USERINFO NIL STYLE NIL) FORMATINFO (ARABIC )) (174 36 288 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 528 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL)))))1È È(È (È(ŠŠ8(ŠŠ8DÈÈ PAGEHEADING RUNNINGHEAD(TERMINAL MODERN MODERN MODERN MODERN MODERNLOGO?1(DEFAULTFONT 1 (GACHA 10) (GACHA 8) (TERMINAL 8))  HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN & y. s‹4·´á $(s  mtƒ*B~ ƒ  c ‰\zº