DTREBUILD(1M) K-AShare by Xinet (13 Mar 1998 8.6) DTREBUILD(1M)
NAME
dtrebuild - ``desktop'' maintenance of AppleShare volumes
SYNOPSIS
/usr/etc/appletalk/dtrebuild [ -dlev|-D ] [ -ro ] [ -a ]
[ -u user ] [ -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
those operations are selected, this option is implied.
Page 1 (printed 3/26/98)
DTREBUILD(1M) K-AShare by Xinet (13 Mar 1998 8.6) DTREBUILD(1M)
-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.
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 (root, all volumes only) Clean out old File IDs and
Directory IDs that no longer correspond to real files.
If large subdirectories have been deleted using 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
entries for all applications currently on all volumes.
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
Page 2 (printed 3/26/98)
DTREBUILD(1M) K-AShare by Xinet (13 Mar 1998 8.6) DTREBUILD(1M)
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.
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(1), opidebug(5), fpovolopts(5), fpod(1m)
FILES
/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 3 (printed 3/26/98)