DTREBUILD(1M) K-AShare by Xinet (10/14/99 10.1) DTREBUILD(1M)
NAME
dtrebuild - ``desktop'' maintenance of AppleShare volumes
SYNOPSIS
/usr/etc/appletalk/dtrebuild [ -dlev|-D ] [ -ro ] [ -a ]
[ -u user ] [ -chroot rootdir ] [ -OP ... ]
[ file|dir|volume ... ]
DESCRIPTION
This program may be used to maintain some databases used by
the AppleShare server, a la ``Rebuild Desktop'' on the Mac.
FullPress and WebNative users may also use it to (re)create
FPO/WEB images. It performs one or more operations on one
or more files, directories and/or AppleShare volumes.
Running dtrebuild with no arguments will produce an up-to-
date list of available OPerations.
In the absence of the -a option, most of the OPerations may
be run on a selected subset of AppleShare volumes or
directories (or sometimes files), by listing a series of
file, dir and/or volume arguments. In the absence of either
the -a option or named volumes/files, the operations will be
performed on all public volumes if run by root, else all of
the user's private volumes. Dtrebuild will refuse to work
on directories within KFS volumes.
OPTIONS
The following command-line options control the behaviour of
all OPerations done by dtrebuild:
-d lev
Turns on debugging for a subset of items. lev is a hex
bitmask. See opidebug(5) for a listing of what bits
control what.
-D Turns on ALL debugging and sends the messages to
standard error.
-ro Don't actually perform any of the selected OPerations,
but print, on standard output, what changes each
operation would make.
-a (root only) do all the OPerations on every volume.
This means all public volumes as well as every user's
private volumes. If a user only has a defaulted home
directory volume, and has no desktop file in the home
directory, that volume will be skipped. WARNING: on
servers using the automount(1m)er, this could cause a
number of NFS mounts, possibly waiting indefinitely for
some NFS servers to respond. Also, some OPerations
must be run on all available AppleShare volumes, since
they clean out old, unused volume information. When
Page 1 (printed 5/4/100)
DTREBUILD(1M) K-AShare by Xinet (10/14/99 10.1) DTREBUILD(1M)
those operations are selected, this option is implied.
-u user
(root only) restricts the volume list to ones for the
specified user. This option may not be used along with
the -a option or OPerations that must be done on all
volumes.
-chroot rootdir
Runs the entire program with the root of the filesystem
changed to rootdir. This option is useful when working
from an installation miniroot.
The following OPerations are supported. Selecting any OP
that must be done on all volumes implies that all selected
OPs will be done on all volumes.
nop Does nothing; however, some Volume and File-searching
debug messages are generated only within the nop
operation.
clean
Delete old Resource forks that don't match existing
data forks. Remove Desktop file entries for files that
are no longer present. Set the Type and Creator for
any file with creator currently set to ``uxex'' or
``uxtt' (does not re-type files with no type/creator
info - see kats(1) for that operation).
Trash_Me
Irreversibly destroy all AppleShare-specific
information in the specified volumes or directories.
This will delete every .HSResource directory it comes
across. Should only be used on directory trees that
will never again be used as AppleShare volumes.
fid Clean out old File IDs and Directory IDs that no longer
correspond to real files. If large subdirectories have
been deleted via (for example) the Unix ``rm'' command,
this operation can free up space inside the FileID
database.
icon Update the Icon Database. Reads icons referenced by
BNDL resources and stores them in the icon database.
When run on all volumes, the database is deleted before
anything is stored.
appl Update the Application Database. When run on a whole
volume (starting with the volume's top-level
directory), every entry for that volume is deleted
first. When the -a option is also specified, the
entire Application Database is deleted before storing
Page 2 (printed 5/4/100)
DTREBUILD(1M) K-AShare by Xinet (10/14/99 10.1) DTREBUILD(1M)
entries for all applications currently on all volumes.
rmfpo
(Fullpress only) Removes any FPOs associated with
image files. This OP can work on files or directories,
whether or not they're part of an OPI volume.
rmweb
(Fullpress only) Removes any WEB-specific previews
(GIFs and/or JPEGs) associated with image files. This
operation is independent of the rmfpo option, but if
both are specified, all FullPress- and Webnative-
specific additions to a file are deleted (this does not
include PICT previews or custom icons).
fpo (Fullpress, root only) Rebuild FPOs in the specified
volume or directory, or FPO(s) for the given file(s),
using current FPO option settings. Doesn't actually
rebuild them directly, but instructs fpod(1m) to do it.
This can take a long time on volumes with many image
files in them.
epsfpo
(Fullpress, root only) Differs from the fpo operation
in that it only remakes FPOs that are EPS format.
pict (Fullpress, root only) Force a remake of PICT previews
made by FullPress for any Web or FPO images. This can
be used with other fpo operations, but forces dtrebuild
to work on all images that can have a low-res version.
locfpo
(Fullpress, root only) Do whatever is necessary to
keep FPOs up to date with regard to their location. It
either updates the location information inside an EPS
FPO or, if the FPO is out of date, does a rebuild.
web (root only) Force a re-make of WebNative volume
images. Unless the fpo option is also specified, only
the GIF/JPEG low-resolution images will be made on
volumes where WebNative is enabled.
newicon
(root only) Convert pre-version-9 custom folder icons
to the version 9 format. This may be done any number
of times and will have no effect if the folder icons
are already in version 9 format.
SEE ALSO
ksd(1m), opidebug(5), fpovolopts(5), fpod(1m)
FILES
Page 3 (printed 5/4/100)
DTREBUILD(1M) K-AShare by Xinet (10/14/99 10.1) DTREBUILD(1M)
/usr/adm/appletalk/KASPubVols
public AppleShare volumes list
~/.KSVols
per-user volumes list
/usr/adm/appletalk/fpovolopts
FPO options per AppleTalk volume
/usr/adm/appletalk/fiddb.new.*
AppleShare Server File/Directory ID database
/usr/adm/appletalk/icons/KASicondt.new.*
AppleShare Server Icon Database
/usr/adm/appletalk/appldb.new.*
AppleShare Server Application Database
Page 4 (printed 5/4/100)
