summaryrefslogtreecommitdiff
path: root/sbin/mount_ntfs
diff options
context:
space:
mode:
authorTed Unangst <tedu@cvs.openbsd.org>2003-05-20 03:18:24 +0000
committerTed Unangst <tedu@cvs.openbsd.org>2003-05-20 03:18:24 +0000
commit98c5e8c191240737f6b45f2a821a2aad3caf2754 (patch)
treef485f87c1e4ab39de4680f27303314b3903005fd /sbin/mount_ntfs
parent9a54ecb5f0c0b4dbda905441c3a275279fc63e54 (diff)
mount_ntfs, from NetBSD via Julien Bordet
Diffstat (limited to 'sbin/mount_ntfs')
-rw-r--r--sbin/mount_ntfs/Makefile11
-rw-r--r--sbin/mount_ntfs/mount_ntfs.8188
-rw-r--r--sbin/mount_ntfs/mount_ntfs.c214
3 files changed, 413 insertions, 0 deletions
diff --git a/sbin/mount_ntfs/Makefile b/sbin/mount_ntfs/Makefile
new file mode 100644
index 00000000000..1c80fa716f0
--- /dev/null
+++ b/sbin/mount_ntfs/Makefile
@@ -0,0 +1,11 @@
+# $Id: Makefile,v 1.1 2003/05/20 03:18:23 tedu Exp $
+
+PROG= mount_ntfs
+SRCS= mount_ntfs.c getmntopts.c
+MAN= mount_ntfs.8
+
+MOUNT= ${.CURDIR}/../mount
+CFLAGS+= -I${MOUNT}
+.PATH: ${MOUNT}
+
+.include <bsd.prog.mk>
diff --git a/sbin/mount_ntfs/mount_ntfs.8 b/sbin/mount_ntfs/mount_ntfs.8
new file mode 100644
index 00000000000..8d8c432ba37
--- /dev/null
+++ b/sbin/mount_ntfs/mount_ntfs.8
@@ -0,0 +1,188 @@
+.\" $NetBSD: mount_ntfs.8,v 1.13 2003/02/14 16:21:48 grant Exp $
+.\"
+.\" Copyright (c) 1993,1994 Christopher G. Demetriou
+.\" Copyright (c) 1999 Semen Ustimenko
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\" must display the following acknowledgment:
+.\" This product includes software developed by Christopher G. Demetriou.
+.\" 3. The name of the author may not be used to endorse or promote products
+.\" derived from this software without specific prior written permission
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.\" Id: mount_ntfs.8,v 1.3 1999/05/04 11:34:33 jkoshy Exp
+.\"
+.Dd October 31, 2001
+.Dt MOUNT_NTFS 8
+.Os
+.Sh NAME
+.Nm mount_ntfs
+.Nd mount an NTFS file system
+.Sh SYNOPSIS
+.Nm mount_ntfs
+.Op Fl a
+.Op Fl i
+.Op Fl u Ar uid
+.Op Fl g Ar gid
+.Op Fl m Ar mask
+.Pa special
+.Pa node
+.Sh DESCRIPTION
+The
+.Nm
+command attaches the NTFS filesystem residing on the device
+.Pa special
+to the global filesystem namespace at the location
+indicated by
+.Pa node .
+This command is normally executed by
+.Xr mount 8
+at boot time, but can be used by any user to mount an
+NTFS file system on any directory that they own (provided,
+of course, that they have appropriate access to the device that
+contains the file system).
+.Pp
+The supported NTFS versions include both NTFS4, as used by Microsoft
+Windows NT 4.0, and NTFS5, as used by Microsoft Windows 2000 and XP.
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl a
+Force behaviour to return MS-DOS 8.3 names also on
+.Fn readdir .
+.It Fl i
+Make name lookup case insensitive for all names except POSIX names.
+.It Fl u Ar uid
+Set the owner of the files in the file system to
+.Ar uid .
+The default owner is the owner of the directory
+on which the file system is being mounted.
+.It Fl g Ar gid
+Set the group of the files in the file system to
+.Ar gid .
+The default group is the group of the directory
+on which the file system is being mounted.
+.It Fl m Ar mask
+Specify the maximum file permissions for files
+in the file system.
+.El
+.Sh FEATURES
+.Ss NTFS file attributes
+NTFS file attributes can be accessed in following way:
+.Bd -literal -offset indent
+foo[[:ATTRTYPE]:ATTRNAME]
+.Ed
+.Pp
+.Sq ATTRTYPE
+is one of identifier listed in $AttrDef file of volume.
+Default is $DATA.
+.Sq ATTRNAME
+is an attribute name.
+Default is none.
+.Pp
+.Sy Examples :
+.Pp
+To get volume name (in Unicode):
+.Bd -literal -offset indent
+# cat /mnt/\\$Volume:\\$VOLUME_NAME
+.Ed
+.Pp
+To read directory raw data:
+.Bd -literal -offset indent
+# cat /mnt/foodir:\\$INDEX_ROOT:\\$I30
+.Ed
+.Ss Limited support for writing
+There is limited writing ability for files.
+Limitations:
+.Bl -bullet -compact
+.It
+file must be nonresident
+.It
+file must
+.Em not
+contain any holes (uninitialized areas)
+.It
+file can't be compressed
+.El
+.Pp
+Note that that it's not currently possible to create or remove files
+on NTFS filesystem.
+.Pp
+.Sy Warning :
+do not mount NTFS filesystems read-write.
+The write support is not very useful and is not tested well.
+It's not safe to write to any file on NTFS, you might damage the filesystem.
+Unless you want to debug NTFS filesystem code, mount the NTFS filesystem
+read-only.
+.Sh SEE ALSO
+.Xr mount 2 ,
+.Xr unmount 2 ,
+.Xr fstab 5 ,
+.Xr disklabel 8 ,
+.Xr mbrlabel 8 ,
+.Xr mount 8
+.Sh HISTORY
+Support for NTFS first appeared in
+.Fx 3.0 .
+It has been ported to
+.Nx
+and first appeared in
+.Nx 1.5 .
+.Sh AUTHORS
+NTFS kernel implementation,
+.Nm
+and this manual were originally written by
+.An Semen Ustimenko Aq semenu@FreeBSD.org .
+.Pp
+The
+.Nx
+port was done by
+.An Christos Zoulas
+.Aq christos@NetBSD.org
+and
+.An Jaromir Dolecek
+.Aq jdolecek@NetBSD.org .
+.Sh BUGS
+The write support should be enhanced to actually be able change
+file size, and to create and remove files and directories.
+It's not very useful right now.
+.Pp
+If the attempt to mount NTFS gives you error like this:
+.Bd -literal
+# mount -t ntfs /dev/wd0k /mnt
+mount_ntfs: /dev/wd0k on /mnt: Invalid argument
+.Ed
+.Pp
+make sure that appropriate partition has correct entry in the
+disk label, particularly that the partition offset is correct.
+If the NTFS partition is the first partition on the disk, the
+offset should be '63' on i386 (see
+.Xr disklabel 8 ) .
+.Xr mbrlabel 8
+could help you to setup the disk label correctly.
+.Pp
+If you mark the NTFS partition as
+.Ql dynamic
+under Microsoft Windows XP,
+it won't be possible to access it under
+.Nx
+anymore.
diff --git a/sbin/mount_ntfs/mount_ntfs.c b/sbin/mount_ntfs/mount_ntfs.c
new file mode 100644
index 00000000000..e2855a3b5ab
--- /dev/null
+++ b/sbin/mount_ntfs/mount_ntfs.c
@@ -0,0 +1,214 @@
+/* $Id */
+/* $NetBSD: mount_ntfs.c,v 1.9 2003/05/03 15:37:08 christos Exp $ */
+
+/*
+ * Copyright (c) 1994 Christopher G. Demetriou
+ * Copyright (c) 1999 Semen Ustimenko
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * 3. All advertising materials mentioning features or use of this software
+ * must display the following acknowledgement:
+ * This product includes software developed by Christopher G. Demetriou.
+ * 4. The name of the author may not be used to endorse or promote products
+ * derived from this software without specific prior written permission
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+ * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+ * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+ * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+ * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * Id: mount_ntfs.c,v 1.1.1.1 1999/02/03 03:51:19 semenu Exp
+ */
+
+#include <sys/cdefs.h>
+#include <sys/param.h>
+#define NTFS
+#include <sys/mount.h>
+#include <sys/stat.h>
+#include <ctype.h>
+#include <err.h>
+#include <grp.h>
+#include <pwd.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <sysexits.h>
+#include <unistd.h>
+#include <util.h>
+
+#include <mntopts.h>
+
+static const struct mntopt mopts[] = {
+ MOPT_STDOPTS,
+#ifdef MNT_GETARGS
+ MOPT_GETARGS,
+#endif
+ { NULL }
+};
+
+#ifndef __dead2
+#define __dead2 __attribute__((__noreturn__))
+#endif
+
+static void usage __P((void)) __dead2;
+int main __P((int, char **));
+int mount_ntfs __P((int argc, char **argv));
+
+#ifndef MOUNT_NOMAIN
+int
+main(argc, argv)
+ int argc;
+ char **argv;
+{
+ return mount_ntfs(argc, argv);
+}
+#endif
+
+int
+mount_ntfs(argc, argv)
+ int argc;
+ char **argv;
+{
+ struct ntfs_args args;
+ struct stat sb;
+ int c, mntflags, set_gid, set_uid, set_mask;
+ char *dev, *dir, ndir[MAXPATHLEN+1];
+#ifdef __FreeBSD__
+#if __FreeBSD_version >= 300000
+ struct vfsconf vfc;
+#else
+ struct vfsconf *vfc;
+#endif
+#endif
+
+ mntflags = set_gid = set_uid = set_mask = 0;
+ (void)memset(&args, '\0', sizeof(args));
+
+ while ((c = getopt(argc, argv, "aiu:g:m:o:")) != -1) {
+ switch (c) {
+ case 'u':
+ args.uid = strtoul(optarg, NULL, 10);
+ set_uid = 1;
+ break;
+ case 'g':
+ args.gid = strtoul(optarg, NULL, 10);
+ set_gid = 1;
+ break;
+ case 'm':
+ args.mode = atoi(optarg);
+ set_mask = 1;
+ break;
+ case 'i':
+ args.flag |= NTFS_MFLAG_CASEINS;
+ break;
+ case 'a':
+ args.flag |= NTFS_MFLAG_ALLNAMES;
+ break;
+ case 'o':
+ getmntopts(optarg, mopts, &mntflags);
+ break;
+ case '?':
+ default:
+ usage();
+ break;
+ }
+ }
+
+ if (optind + 2 != argc)
+ usage();
+
+ dev = argv[optind];
+ dir = argv[optind + 1];
+ if (dir[0] != '/') {
+ warnx("\"%s\" is a relative path", dir);
+ if (getcwd(ndir, sizeof(ndir)) == NULL)
+ err(EX_OSERR, "getcwd");
+ strncat(ndir, "/", sizeof(ndir) - strlen(ndir) - 1);
+ strncat(ndir, dir, sizeof(ndir) - strlen(ndir) - 1);
+ dir = ndir;
+ warnx("using \"%s\" instead", dir);
+ }
+
+ args.fspec = dev;
+ args.export.ex_root = 65534; /* unchecked anyway on DOS fs */
+ if (mntflags & MNT_RDONLY)
+ args.export.ex_flags = MNT_EXRDONLY;
+ else
+ args.export.ex_flags = 0;
+ if (!set_gid || !set_uid || !set_mask) {
+ if (stat(dir, &sb) == -1)
+ err(EX_OSERR, "stat %s", dir);
+
+ if (!set_uid)
+ args.uid = sb.st_uid;
+ if (!set_gid)
+ args.gid = sb.st_gid;
+ if (!set_mask)
+ args.mode = sb.st_mode & (S_IRWXU | S_IRWXG | S_IRWXO);
+ }
+#ifdef __FreeBSD__
+#if __FreeBSD_version >= 300000
+ c = getvfsbyname("ntfs", &vfc);
+ if (c && vfsisloadable("ntfs")) {
+ if (vfsload("ntfs"))
+#else
+ vfc = getvfsbyname("ntfs");
+ if (!vfc && vfsisloadable("ntfs")) {
+ if (vfsload("ntfs"))
+#endif
+ err(EX_OSERR, "vfsload(ntfs)");
+ endvfsent(); /* clear cache */
+#if __FreeBSD_version >= 300000
+ c = getvfsbyname("ntfs", &vfc);
+#else
+ vfc = getvfsbyname("ntfs");
+#endif
+ }
+#if __FreeBSD_version >= 300000
+ if (c)
+#else
+ if (!vfc)
+#endif
+ errx(EX_OSERR, "ntfs filesystem is not available");
+
+#if __FreeBSD_version >= 300000
+ if (mount(vfc.vfc_name, dir, mntflags, &args) < 0)
+#else
+ if (mount(vfc->vfc_index, dir, mntflags, &args) < 0)
+#endif
+#else
+ if (mount(MOUNT_NTFS, dir, mntflags, &args) < 0)
+#endif
+ err(EX_OSERR, "%s on %s", dev, dir);
+
+#ifdef MNT_GETARGS
+ if (mntflags & MNT_GETARGS) {
+ char buf[1024];
+ (void)snprintb(buf, sizeof(buf), NTFS_MFLAG_BITS, args.flag);
+ printf("uid=%d, gid=%d, mode=0%o, flags=%s\n", args.uid,
+ args.gid, args.mode, buf);
+ }
+#endif
+ exit (0);
+}
+
+static void
+usage()
+{
+ fprintf(stderr, "usage: mount_ntfs [-a] [-i] [-u user] [-g group] [-m mask] bdev dir\n");
+ exit(EX_USAGE);
+}