Administration Guide : Command-line manual pages

KATS(1) manual page

Name

kats, kscp, ksmv, ksrm - FullPress File Manipulation Utilities

Synopsis

kats [-bcilpsSu ] [-F flags] [-TC type] [-K comment] [-L label] [filename ...]
kats -v [ filename ... ]
kats -o [ dirname ]
kscp [-l |-L] [-n ] [-p ] [-q ] [-s ] [-v ] path1 [ path2 ... ] target
ksmv [-l |-L] [-n ] [-p ] [-s ] [-v ] path1 [ path2 ... ] target
ksrm [-l |-L] [-r ] [-v ] path ...

Description

These routines let you copy, delete, move and set AppleShare attributes for FullPress files and directories.

FullPress stores AppleShare specific information, such as file Type and Creator and the resource fork, in several utility files. This information will be lost if you use cp(1) , mv(1) and rm(1) , to move FullPress files around a unix filesystem. If you use kscp, ksmv, and ksrm, the AppleShare info will be copied, moved or deleted as necessary.

Ksrm will refuse to delete directories unless the -r flag is provided. With the -r flag, every subdirectory of the given path (s) will be removed along with path itself.

Kats is an administrative program used to view and set various AppleShare file attributes, including the invisible and copy-protected attributes and the Type and Creator fields. Invisible files and directories will not be visible to Appleshare clients. The Macintosh finder will refuse to copy copy-protected files. Directories cannot be copy protected.

When no options are supplied, kats prints out information either about the specified files or all files in the current directory if no files are specified.

The attributes are in the .HSancillary file rather than in the file itself. Only the owner of files and root are allowed to change attributes.

Options

-s 
Set the requested attributes. This is the default.
-c 
Clear the requested attributes.
-i 
Make the file invisible.
-b 
The file has a bundle.
-F 
Set the Finder Flags to flags.
-S 
The file can be shared.
-l 
The file is locked.
-L 
(kats only) Set the Label (i.e. the color in the Finder). label must be an integer between 0 and 7, inclusive. This option is ignored if -F is also given.
-o 
Check for and delete "orphaned" resource forks from dirname (or the current directory if dirname is absent). Orphaned resource forks are .HSResource directory entries that have no corresponding data files. Theses files will not appear in FullPress volumes. They can crop up when users use cp, mv and rm instead of kscp, ksmv, and ksrm to manipulate FullPress files. This option has been superceded by the dtrebuild(8) -clean option.

-p 
Copy protect the file.
-T type  
Change the Macintosh file type.
-C type  
Change the Macintosh file creator.
-K comment  
Change the Macintosh OS9 Finder Comment.
-u 
The file or folder has a Custom Icon.
-v 
Verbose listing of files. Shows finder flags and other info.

Options that apply to ksmv, kscp and ksrm only:

-l
Lock a file (does not affect operations on directories) before moving, copying or deleting it. This option makes ksmv, kscp or ksrm wait indefinitely for the lock.
-L
Attempt to lock a file (does not affect operations on directories) before moving, copying or deleting it. If the lock cannot immediately be obtained, the program exits with error code 3 without doing the requested operation (or any other, if more than one path was on the command line).
-n
Normally, ksmv and kscp take steps to keep Versions of files with them during the move or copy. Specifying the -n option prevents that extra work from being done. If ksmv or kscp is being used to manipulate actual Version files, the -n option is required.
-p
(ksmv and kscp, non-Windows platforms) By default, kscp and ksmv implement inheritance for assigning ownership (if possible) and access privileges to files moved or copied to new directories. They also honor the inheritance setting assigned to AFP volumes that contain the target directories. The -p option disables inheritance, regardless of volume settings, and causes the ownership and access privileges of the moved or copied files to remain the same as the source file(s).
-q
(kscp on Windows only) Disables the xcopy program's prompts so it can run unattended.
-s
(ksmv and kscp only) If the path to be moved or copied is a directory, this option causes a series of Sync events to be generated for the affected target instead of the single Rename or Copy event normally generated for webdblog.
-v
Prevents sending a webdblog event on Venture-licensed servers.

Files

*/.HSancillary    
File for additional file information needed by Macintosh.
*/.HSResource/*    
Directory for storing the resource fork of files

Examples

Print information about all files in the current directory:

    kats 
 

Make the file foo copy-protected:

    kats -ps foo 
 

Make the file foo a TeachText file:

    kats -T TEXT -C ttxt foo 
 

See Also

FullPress Administrator's Guide
ksd(8)

Caveats

Once files are typed by FullPress the filetype(5) database will not be consulted. If you change the rules for typing a particular type of file, it will not change the type of already existing files of that type. The katype(1) program can be used to check the validity of your filetype(5) database. Kats shows you the files as FullPress currently has them typed.

Bugs

Kats normally should be run in the directory where the specified files resides (although if one of the filename args has a pathname component, Kats will change to that directory before processing).

If you are not the super-user and you copy or move files that you do not own between different directories, the permissions of the resulting files may not be set correctly.