resb(1) UNIX Programmer's Manual resb(1)
NAME
resb - retarget a sandbox to use a new backing tree
SYNOPSIS
resb [-rconly -info -v] [-sb sandbox-name] [-rc rc-file]
new_backing_tree
resb [-usage]
FLAGS
-rconly
Updates the local and shared rc files without relinking
the sandbox.
-info
Indicates what resb will do without actually doing it.
-v Puts resb in verbose mode.
-sb sandbox-name
Use the sandbox name instead of the current sandbox..
The default value of this flag is the value of $SANDBOX
or the default sandbox name listed in $HOME/.sandboxrc.
-rc rc-file
Provides the path and name of an alternative .sandboxrc
file to use instead of the default ${HOME}/.sandboxrc.
-usage
Print the usage line without taking any action.
resb retargets a sandbox to a backing tree.
DESCRIPTION
resb retargets a sandbox to use a new backing tree by saving
the old rc_files, changing the sandbox link to point at the
new backing tree and regenerating the rc_files using the
templates found in the new backing tree. The full path name
of the new backing tree should be specified on the command
line or, if the new backing tree is in /project/osc/build,
just the name of the tree can be given. The user will prob-
ably want to run mklinks on directories with links or copies
in them to pick up any new files in the new backing tree.
It is also up to the user to correctly integrate personal
changes that have been made to the old rc_files into the
newly generated rc_files. resb is also a good way to regen-
erate your rc_files if they have been damaged.
resb can also be used to update the sandbox's shared and
local rc files without linking to a new build by using the
-rconly option.
Printed 1/23/91 5/21/90 1
resb(1) UNIX Programmer's Manual resb(1)
Like other OSF/1 sandbox commands, resb uses the -sb flag,
the environment variable $SANDBOX, or the defaults found in
your .sandboxrc file (in that order) to determine the name
of the current sandbox. resb also determines the location
of the sandbox by reading a .sandboxrc, either the one in
your $HOME directory or one specified with a -rc flag.
EXAMPLES
To change the backing tree to be latest:
resb latest
To change the backing tree to another sandbox:
resb /sandboxes/suzieq/symphony
To update the files rc_files/local and rc_files/shared in
the local sandbox:
resb -rconly
FILES
$HOME/.sandboxrc
is used to obtain the path of the sandbox.
sandbox/rc_files/*
are files that are recreated with resb.
sandbox/link
is the link that is recreated to point at the new back-
ing tree.
RELATED INFORMATION
mksb(1), mklinks(1), sbinfo(1), sandbox(5), sandboxrc(4)
PLANNED ENHANCEMENTS
resb will be able to run mklinks on the directories speci-
fied in the .sandboxrc file automatically, as mksb does.
Any directory that has had links created in it by running
mklinks manually, will still need to have mklinks run over
it again to create links for any new files in the new back-
ing tree.
resb will allow the user to automatically merge in the per-
sonal changes made in the old rc_files into the newly gen-
erated rc_files, if desired. Currently, resb only makes a
backup copy of the old rc_files, and it is up to the user to
merge any changes that were made.
Eventually, resb will provide more comprehensive information
about the condition of the objects in the newly retargeted
sandbox. Presently, the user must assume that they are all
out of date.
Printed 1/23/91 5/21/90 2