113 lines
4.1 KiB
Groff
113 lines
4.1 KiB
Groff
.\" -*- nroff -*-
|
|
.\" Copyright (c) 2003 Anton Altaparmakov. All Rights Reserved.
|
|
.\" This file may be copied under the terms of the GNU Public License.
|
|
.\"
|
|
.TH NTFSPROGS 8 "November 2003" "Linux-NTFS version @VERSION@"
|
|
.SH NAME
|
|
libntfs-gnomevfs \- Module for GNOME VFS that allows access to NTFS filesystems.
|
|
.SH OVERVIEW
|
|
The GNOME virtual filesystem (VFS) provides universal access to different filesystems.
|
|
The
|
|
.BR libntfs-gnomevfs
|
|
module enables GNOME VFS aware clients to seamlessly utilize the NTFS library
|
|
.BR libntfs .
|
|
|
|
So you can access an NTFS filesystem without needing to use the NTFS utilities themselves
|
|
(at least in theory anyway). In practice this is probably more useful for programs and
|
|
programmers to make using
|
|
.BR libntfs
|
|
easier, more generic, and to allow easier debugging of
|
|
.BR libntfs .
|
|
|
|
.SH Examples
|
|
.SS Prerequisites
|
|
.PP
|
|
To be able to follow these examples you will need to have installed the test utilities
|
|
from the gnome-vfs-2.4.x package. The easiest way to do this is to download and compile
|
|
the gnome-vfs-2 package, e.g. download from:
|
|
|
|
http://ftp.gnome.org/pub/GNOME/desktop/2.4/2.4.0/sources/gnome-vfs-2.4.0.tar.gz
|
|
|
|
Then run ./configure followed by make and make install (as root). This will install
|
|
it into /usr/local so it should not conflict with your existing installation from
|
|
rpm or deb packages which will be in /usr.
|
|
|
|
Note you may also need to add /usr/local/lib to /etc/ld.so.conf and then run ldconfig
|
|
(as root) to let your system see the installed gnome-vfs-2.4.x libraries.
|
|
|
|
Then run ./configure followed by make and make install (as root) in the main
|
|
.BR ntfsprogs
|
|
directory to build and install the
|
|
.BR libntfs-gnomevfs
|
|
module and
|
|
.BR libntfs
|
|
library which is used by the module.
|
|
|
|
.SS Copying a file from an NTFS partition
|
|
.PP
|
|
To copy the file autoexec.bat from the main directory of an NTFS partition (/dev/hda1)
|
|
to the /tmp directory on your system you could run:
|
|
|
|
/path/to/gnome-vfs-2.4.x/test/test-xfer file:///dev/hda1#libntfs:/autoexec.bat /tmp/autoexec.bat
|
|
|
|
To copy a file from a directory inside the NTFS partition you would just specify the full path.
|
|
So for example to copy the file win.ini from the Windows directory you would run:
|
|
|
|
/path/to/gnome-vfs-2.4.x/test/test-xfer file:///dev/hda1#libntfs:/Windows/win.ini /tmp/win.ini
|
|
|
|
.SS Shell access to an NTFS partition
|
|
.PP
|
|
For debugging it is most useful to be able to do various things to the NTFS partition while it
|
|
is being operated upon by
|
|
.BR libntfs .
|
|
This is achieved using the test-shell utility (from the gnome-vfs-2.4.x package) by running:
|
|
/path/to/gnome-vfs-2.4.x/test/test-shell
|
|
|
|
This drops you into the GNOME VFS shell from where you can now cd into the NTFS partition (/dev/hda1)
|
|
by typing: cd file:///dev/hda1#libntfs:/
|
|
|
|
You are now in the root directory of the NTFS partition. The first thing you will probably want to
|
|
do is to type "ls" to display the directory contents.
|
|
|
|
You could then change directories using the "cd" command, e.g. to enter the Windows directory you
|
|
would type: cd Windows
|
|
|
|
You can then open files, seek inside files, read from files (write is not enabled at present), etc
|
|
thus exercising large portions of the NTFS library.
|
|
|
|
Use the "help" command while in the shell to see the available commands.
|
|
|
|
.SH BUGS
|
|
.PP
|
|
No bugs are known but there are several limitations at the moment:
|
|
|
|
You cannot get information about files other than what the "ls" command
|
|
in the test-shell can give you, i.e. the "info" command in the test-shell
|
|
does not work.
|
|
|
|
Further access to the partition is read-only and hence you cannot write
|
|
to files. This will be changed in the future once the module has had
|
|
more wide testing.
|
|
|
|
There may be other limitations and possibly bugs. Please report any
|
|
problems to the NTFS mailing list: linux-ntfs-dev@lists.sourceforge.net
|
|
|
|
.SH AUTHORS
|
|
.PP
|
|
The
|
|
.BR libntfs-gnomevfs
|
|
module was written by Jan Kratochvil. This man page was written by Anton Altaparmakov.
|
|
|
|
.SH AVAILABILITY
|
|
The
|
|
.BR ntfsprogs
|
|
package which contains the
|
|
.BR libntfs-gnomevfs
|
|
module can be downloaded from http://linux-ntfs.sourceforge.net/downloads.html
|
|
.BR
|
|
These manual pages can be viewed online at http://linux-ntfs.sourceforge.net/man/ntfsprogs.html
|
|
|
|
.SH SEE ALSO
|
|
.BR ntfsprogs (8)
|
|
|