Welcome to jBASE's new documentation site! Many answers to your questions can be found by searching the Knowledgebase or viewing the jBASE Documentation. We also have a Google Group for peer discussion about jBASE. If you are unable to find the information you are looking for, jBASE Support will be glad to assist in resolving your technical problems. Enjoy and please provide comments and feedback .

How can we help you?



The jrestore utility provides fast on-line restores from the saves produced by the jbackup utility. 

The jrestore can be controlled to restore from any file type on the backup, from single records to multiple directories. 

The jrestore utility can also be used to verify jbackup saves.

jrestore -Options

where options may be: 


restore from current media position
set number of read buffers to n (default is 8, minimum is 1)
-c"old new"
restore old directory path as new directory path
restore directory files matching regular expression
-f Device
restore from device file, default stdin
restore hash files matching regular expression
-H FileList
restore files using only file names from FileList file
restore hash file items matching regular expression
-I ItemList
restore hash file items using only item ids from ItemList file
restore links matching regular expression
-k EncKey
Encryption key
control info files not restored
control info files restored and indexes rebuilt
restore other files matching regular expression
set priority, nice value of parent process
restore normal file matching regular expression
verbose mode
use fixed block device. Use for QIC tapes
force block size to 128k, default 16k
force block size to n bytes, rounded to nearest k
print and scan files only, no restore
overwrite existing files and records
suppress rewind last reel
-T type
restore hash files as specified file type; the original modulo and separation will be retained rather than use the 'resize' parameters.
update only does not overwrite existing files or records
verbose dot mode, displays a "." for each file
-W Roll forware TJ logfiles after database restore
-X Clear existing hashed files b efore population
(jBASE 5.8)

All-encompassing option that allows anything to be restored.
It is similar to: -u"regexp" -h"regexp" -d"regexp" -o"regexp" -l"regexp"
This option can be specified more than once on the command line.


When using jrestore, ensure that the command is executed at the standard shell not in jsh otherwise the double quotes and other meta characters will lose their meaning.


On Windows, when specifying Windows path names the backslash must be escaped with a backslash, otherwise the backslash character is removed. e.g. 



Examples of use may be as: 

jrestore -f /dev/rmt/ctape -P

Reads formatted files and directories from a streaming cartridge device, displaying each file or directory as it is encountered. 

This option can be used to verify that the tape does not contain any parity or formatting errors and so can be restored at a later date.

jrestore -f /dev/rmt/floppy -v

Reads and restores formatted files and directories from a floppy disk device, displaying each file or directory as it is encountered.

jbackup -Ajbase | jrestore -c"/home/old /home/new"

Reads formatted files and directories from stdin, which is being supplied by jbackup, modifies all occurrences of path string /home/old to /home/new and then restores files and directories using modified path string.

jrestore -f BACKUP -d".*PAYROLL$"

Reads formatted files and directories from UNIX file BACKUP, limits restore to any directories whose path name ends in PAYROLL.

jrestore -f BACKUP -h"/CUSTOMERS$" -i".*SMITH.*"

Reads formatted files and directories from UNIX file BACKUP, limits restore to any hash files whose path name ends in CUSTOMERS, and only restores record ids containing the string SMITH.

Was this article helpful?