vxupgrade(1M_VXFS) (VXFS) vxupgrade(1M_VXFS)
NAME
vxupgrade (vxfs) - upgrade a Version 1 vxfs file system to
Version 2
SYNOPSIS
vxupgrade [-r rawdev] mount_point
DESCRIPTION
The vxupgrade utility upgrades a vxfs Version 1 layout file
system to a Version 2 layout file system. vxupgrade operates
on file systems mounted for read/write access. mount_point
must be a mounted Version 1 file system. Only a privileged
user can upgrade a vxfs file system.
The vxupgrade utility freeze the file system, allocates and
initializes the new structures, and then thaws the file
system. This process should not keep the file system frozen
for more than a couple of seconds.
The options are:
-r rawdev Pathname of raw device to use. This option can
be used when vxupgrade cannot determine what the
raw device corresponding to the mount point is
(when /etc/mnttab is, for instance).
vxupgrade makes use of a lock file (lost+found/.fsadm) on the
file system to ensure that only one instance of vxupgrade is
running at any time. vxupgrade and fsadm cannot be run
simulataneously, so the lock file also ensures that vxupgrade
is not run while a file system reorganization is in progress.
When vxupgrade is invoked, it opens the file lost+found/.fsadm
in the root of the file system specified by mount_point. If
the file doesn't exist, it is created. The fcntl(2) system
call is used to obtain a write lock on the file. If the write
lock fails, vxupgrade will assume that another vxupgrade or an
fsadm is running and will fail.
NOTES
The VxFS 2.0 or later kernel must be running before vxupgrade
can be used. Once a file system has been upgraded to Version
2, it is no longer mountable using a pre-VxFS 2.0 kernel.
FILES
Copyright 1994 Novell, Inc. Page 1
vxupgrade(1M_VXFS) (VXFS) vxupgrade(1M_VXFS)
lost+found/.fsadm lock file
REFERENCES
vxfs-specific fs(4VXFS), vxfs-specific mkfs(1M_VXFS) vxfsio(7)
Copyright 1994 Novell, Inc. Page 2