NAME [Toc] [Back]
convertfs - convert an HFS file system to allow long file names
SYNOPSIS [Toc] [Back]
/usr/sbin/convertfs [-q] [special-file]
DESCRIPTION [Toc] [Back]
The convertfs command converts an existing HFS file system supporting
the default maximum file name length of 14 characters into one that
supports file names up to 255 characters long. Once an HFS file
system is converted to long file names, it cannot be restored to its
original state, since the longer file names require a directory
representation that is incompatible with the default HFS directory
format. Since this is an irreversible operation, convertfs prompts
for verification before it performs a conversion.
convertfs forces the system to reboot if the root file system is
converted. When converting the root file system, the system should be
in single-user mode, with all unnecessary processes terminated and all
non-root file systems unmounted. Except for the root file system,
convertfs requires that the file system to be converted be unmounted.
If invoked without arguments, convertfs interactively prompts the user
with a list of the HFS file systems from /etc/fstab. One or more or
all of the listed file systems can be selected for conversion.
Typically, it is desirable to convert all of the file systems in
/etc/fstab to avoid inconsistencies between two file systems mounted
on the same system.
convertfs can also be invoked with an argument of either a block or
character special-file of a file system to be converted. Only the
block special file should be specified for a mounted root file system.
As part of the conversion process, convertfs performs an fsck on each
file system (see fsck(1M)).
Options [Toc] [Back]
-q Do quietly. convertfs will perform the conversions
without querying the user. Normally convertfs prompts
the user before converting a file system.
RETURN VALUE [Toc] [Back]
convertfs returns the following values:
0 Success. Either convertfs successfully converted the
file system, or the file system already allowed long
non-0 Failure. convertfs was not able to convert the file
system due to some failure in processing.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
AUTHOR [Toc] [Back]
convertfs was developed by HP.
FILES [Toc] [Back]
/etc/fstab Default list of file systems to check.
SEE ALSO [Toc] [Back]
fsck(1M), mkfs(1M), newfs(1M), fstab(4).
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ]