hfs(1) [debian man page]
HFS(1) General Commands Manual HFS(1) NAME
hfs - shell for manipulating HFS volumes SYNOPSIS
hfs [hfs-path [partition-no]] DESCRIPTION
hfs is an interactive command-oriented tool for manipulating HFS volumes. hfs is based on the Tcl interpreter, so basic Tcl constructs can be used in addition to the following commands: mount path [partition-no] The specified UNIX path is opened as an HFS volume. If a partition number n is specified and the volume source is located on a par- titioned medium, the nth discovered HFS partition will be mounted. The default partition-no is 1. umount [path] The volume previously mounted from the specified path (or the current volume, if none specified) is unmounted. vol path The volume previously mounted from the specified path is made current. info General information about the currently mounted volume is displayed. This information is also displayed automatically when the vol- ume is mounted. pwd The full path to the current working HFS directory is displayed. cd [hfs-path] The current working directory is changed to the given HFS path. If no path is given, the working directory is changed to the root of the volume. dir [hfs-path] A directory listing of the specified HFS directory is displayed. If no path is given, the contents of the current working directory are shown. mkdir hfs-path A new, empty directory is created with the specified path. rmdir hfs-path The specified directory is removed. It must be empty. create hfs-path [type [creator]] An empty file is created with the specified path. The Macintosh type and creator may be specified, or they will default to TEXT and UNIX, respectively. del hfs-path Both forks of the specified file are deleted. stat hfs-path Status information about the specified HFS path-identified entity is displayed. cat hfs-path The data fork of the specified HFS file is displayed. copyin unix-path [hfs-path [mode]] The specified UNIX file is copied to the named HFS destination path. Unless specified otherwise, the file will be copied into the current HFS working directory using a heuristically chosen mode. The mode may be one of: macb (MacBinary II), binh (BinHex), text, or raw. copyout hfs-path [unix-path [mode]] The specified HFS file is copied into the named UNIX destination path. Unless specified otherwise, the file will be copied into the current UNIX working directory using a heuristically chosen mode. The modes are the same as for copyin. format path [partition-no [volume-name]] The specified UNIX path is initialized as an empty HFS volume with the given name, and this volume is subsequently mounted. The default volume name is Untitled. The shell is scriptable, however it should be understood that the above commands are actually implemented by Tcl procedures prefixed with the character "h", e.g. hmount, hcd, etc., in order to avoid name collisions with other Tcl utilities. The "h" may be omitted in interac- tive use for convenience. SEE ALSO
hfsutils(1), xhfs(1) BUGS
cat can only display the data fork of a file. Text translations are performed unconditionally on the output. Furthermore, binary data can- not be handled properly from within Tcl scripts since the character with value 0 cannot be represented in Tcl strings. Use copyout to copy files without these limitations. AUTHOR
Robert Leslie <rob@mars.org> HFSUTILS
15-Jan-1997 HFS(1)
Check Out this Related Man Page
HFSUTILS(1) General Commands Manual HFSUTILS(1) NAME
hfsutils - tools for reading and writing Macintosh HFS volumes SYNOPSIS
hattrib - change HFS file or directory attributes hcd - change working HFS directory hcopy - copy files from or to an HFS volume hdel - delete both forks of an HFS file hdir - display an HFS directory in long format hformat - create a new HFS filesystem and make it current hls - list files in an HFS directory hmkdir - create a new HFS directory hmount - introduce a new HFS volume and make it current hpwd - print the full path to the current HFS working directory hrename - rename or move an HFS file or directory hrmdir - remove an empty HFS directory humount - remove an HFS volume from the list of known volumes hvol - display or change the current HFS volume hfssh - Tcl interpreter with HFS extensions hfs - shell for manipulating HFS volumes xhfs - graphical interface for manipulating HFS volumes DESCRIPTION
hfsutils is a collection of tools and programs for accessing Macintosh HFS-formatted volumes. See the accompanying man page for each pro- gram above for more information. NOTES
These utilities can manipulate HFS volumes on nearly any medium. A UNIX path is initially specified to hmount or hformat which gives the location of the volume. This path can be a block device -- corresponding to, for example, a floppy disk, CD-ROM, SCSI disk, or other device -- or it can be a regular file containing an image of any of the above. The medium specified by the UNIX path may or may not contain an Apple partition map. If partitioned, it is possible for more than one HFS volume to be present on the medium. In this case, a partition number must also be given which selects the desired partition. This number refers to the nth ordinal HFS partition on the volume. (Other, non-HFS partitions are ignored.) Partition number 0 refers to the entire medium, disregarding the partition map, if any. HFS pathnames consist of colon-separated components. Unlike UNIX pathnames, an HFS path which begins with a colon (e.g. :Foo:Bar) is a rel- ative path, and one which does not (e.g. Foo:Bar) is an absolute path. As sole exception to this rule, a path not containing any colons is assumed to be relative. Absolute pathnames always begin with the name of the volume itself. Any occurrence of two or more consecutive colons in a path causes reso- lution of the path to ascend into parent directories. Most of the command-line programs support HFS filename globbing. The following forms of globbing are supported: * matches zero or more characters. ? matches exactly one character. [...] matches any single character enclosed within the brackets. A character range may be specified by using a hypen (-). Note that matches are not case sensitive. {...,...} expands into the Cartesian product of each specified substring. causes the following character to be matched literally. Note that since globbing is performed by each HFS command rather than by the UNIX shell (which knows nothing about HFS volumes), care should always be taken to protect pathnames from the shell by using an appropriate quoting technique. Typically it is best to surround HFS pathnames containing glob characters with single quotes ('). Time stamps on HFS volumes are interpreted as being relative to the current time zone. This means that modification dates on HFS volumes written in another time zone may appear to be off by some number of hours. Hardware limitations prevent some systems from reading or writing native Macintosh 800K floppy disks; only high-density 1440K disks can be used on these systems. The obsolete MFS volume format is not supported by this software. SEE ALSO
hattrib(1), hcd(1), hcopy(1), hdel(1), hdir(1), hformat(1), hls(1), hmkdir(1), hmount(1), hpwd(1), hrename(1), hrmdir(1), hvol(1), hfs(1), xhfs(1) AUTHOR
Robert Leslie <rob@mars.org> HFSUTILS
08-Nov-1997 HFSUTILS(1)