vxtools 0.1 - Tools for accessing Veritas Journaled FileSystem (VxFS)
Copyright (c) 1999 Martin Hinner <mhi@penguin.cz>
WWW: http://www.penguin.cz/~mhi/fs/vxfs/
FTP: ftp.penguin.cz/pub/users/mhi/vxfs/

-=- INTRODUCTION -=-
This package allows you to read files from Veritas Journaled Filesystem.
Current version seems to support versions 2 and 4 (and 3, but this version
was never released, AFAIK). I don't plan a write version, because I don't
know journal log structure and I have *no* time to play with it. But I plan
a Linux kernel implementation.

-=- LICENSE -=-
vxtools - Tools for accessing Veritas Journaled FileSystem (VxFS)
Copyright (c) 1999 Martin Hinner <mhi@penguin.cz>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

-=- INSTALLATION -=-
Installation is very simple:

- Download tarball from FTP site.
- Extract it into /usr/src directory (bzip2 -d vxfs-x.y.tar.bz2 |\
  tar xvf - -C /usr/src)
- Run ./configure script
- Compile package (make all).
- Install package (make install)

-=- USING -=-

Use vxmount(1) command to "mount" a VxFS filesystem. It will not mount fs. like
mount(1) does, but checks filesystem validity and stores state in ~/.vxcwd file
for other programs. Then you can use vxls(1), vxcat(1), vxidump(1), vxcd(1)
and vxpwd(1) to browse filesystem. To "unmount" filesystem use vxumount(1)
command. For more information see manual pages (Which are not finished ;-).

Maybe someone will write X-based package for interactive browsing.

Here is example (UnixWare 2.1 VxFS):

% prtvtoc /dev/hda
slice 0:        BACKUP          permissions:    UNMOUNTABLE VALID
        starting sector:        2056320         length: 1028160
slice 1:        ROOT            permissions:    VALID
        starting sector:        2216970         length: 851445
slice 7:        BOOT            permissions:    UNMOUNTABLE VALID
        starting sector:        2056320         length: 34
slice 10:       STAND           permissions:    VALID
        starting sector:        2072385         length: 32130
% vxmount -p 1 /dev/hda
% vxls /etc
oshadow
resolv.conf
ps_data
[few lines deleted]

% vxcat /etc/passwd
root:x:0:3:0000-Admin(0000):/:/sbin/sh
daemon:x:1:12:0000-Admin(0000):/:
bin:x:2:2:0000-Admin(0000):/usr/bin:
[few lines deleted]

% vxcd /usr/bin
% vxpwd
/usr/bin
% vxls
yacc
val
unget
[deleted]

% vxumount
%

-=- BUGS -=-
See TODO a BUGS files. If you will have any problems with this package,
don't hesitate to send me mail (mhi@penguin.cz). This software was tested only
on my home Linux 2.3.26 glibc2 based system.


I'd like to hear whether this program worked on your VxFS filesystem or not,
mainly if you are using VxFS on HP-UX or SUN Solaris.

-=- SEE ALSO -=-
Tigran A. Aivazian wrote Linux implementation of SCO UnixWare boot filesystem
(BFS), see his page at <http://www.ocston.org/~tigran/patches/bfs/>.

VxFS filesystem is described in SCO UnixWare 7 documentation, which is
available at <http://uw7doc.sco.com/ODM_FSadmin/CONTENTS.html>. 

Filesystem HOWTO, which generally describes filesystems and accessing them
is available at <http://www.penguin.cz/~mhi/fs/>.

-- Martin Hinner <mhi@penguin.cz>
