2
.\" Copyright (c) 2003 Anton Altaparmakov. All Rights Reserved.
3
.\" This file may be copied under the terms of the GNU Public License.
5
.TH NTFSPROGS 8 "November 2003" "Linux-NTFS version @VERSION@"
7
libntfs-gnomevfs \- Module for GNOME VFS that allows access to NTFS filesystems.
9
The GNOME virtual filesystem (VFS) provides universal access to different filesystems.
12
module enables GNOME VFS aware clients to seamlessly utilize the NTFS library
15
So you can access an NTFS filesystem without needing to use the NTFS utilities themselves
16
(at least in theory anyway). In practice this is probably more useful for programs and
17
programmers to make using
19
easier, more generic, and to allow easier debugging of
25
To be able to follow these examples you will need to have installed the test utilities
26
from the gnome-vfs-2.4.x package. The easiest way to do this is to download and compile
27
the gnome-vfs-2 package, e.g. download from:
29
http://ftp.gnome.org/pub/GNOME/desktop/2.4/2.4.0/sources/gnome-vfs-2.4.0.tar.gz
31
Then run ./configure followed by make and make install (as root). This will install
32
it into /usr/local so it should not conflict with your existing installation from
33
rpm or deb packages which will be in /usr.
35
Note you may also need to add /usr/local/lib to /etc/ld.so.conf and then run ldconfig
36
(as root) to let your system see the installed gnome-vfs-2.4.x libraries.
38
Then run ./configure followed by make and make install (as root) in the main
40
directory to build and install the
44
library which is used by the module.
46
.SS Copying a file from an NTFS partition
48
To copy the file autoexec.bat from the main directory of an NTFS partition (/dev/hda1)
49
to the /tmp directory on your system you could run:
51
/path/to/gnome-vfs-2.4.x/test/test-xfer file:///dev/hda1#libntfs:/autoexec.bat /tmp/autoexec.bat
53
To copy a file from a directory inside the NTFS partition you would just specify the full path.
54
So for example to copy the file win.ini from the Windows directory you would run:
56
/path/to/gnome-vfs-2.4.x/test/test-xfer file:///dev/hda1#libntfs:/Windows/win.ini /tmp/win.ini
58
.SS Shell access to an NTFS partition
60
For debugging it is most useful to be able to do various things to the NTFS partition while it
61
is being operated upon by
63
This is achieved using the test-shell utility (from the gnome-vfs-2.4.x package) by running:
64
/path/to/gnome-vfs-2.4.x/test/test-shell
66
This drops you into the GNOME VFS shell from where you can now cd into the NTFS partition (/dev/hda1)
67
by typing: cd file:///dev/hda1#libntfs:/
69
You are now in the root directory of the NTFS partition. The first thing you will probably want to
70
do is to type "ls" to display the directory contents.
72
You could then change directories using the "cd" command, e.g. to enter the Windows directory you
73
would type: cd Windows
75
You can then open files, seek inside files, read from files (write is not enabled at present), etc
76
thus exercising large portions of the NTFS library.
78
Use the "help" command while in the shell to see the available commands.
82
No bugs are known but there are several limitations at the moment:
84
You cannot get information about files other than what the "ls" command
85
in the test-shell can give you, i.e. the "info" command in the test-shell
88
Further access to the partition is read-only and hence you cannot write
89
to files. This will be changed in the future once the module has had
92
There may be other limitations and possibly bugs. Please report any
93
problems to the NTFS mailing list: linux-ntfs-dev@lists.sourceforge.net
99
module was written by Jan Kratochvil. This man page was written by Anton Altaparmakov.
104
package which contains the
106
module can be downloaded from http://linux-ntfs.sourceforge.net/downloads.html
108
These manual pages can be viewed online at http://linux-ntfs.sourceforge.net/man/ntfsprogs.html