|
From: Anton A. <an...@us...> - 2001-06-10 18:30:21
|
Changes by: antona
Update of /cvsroot/linux-ntfs/linux-ntfs/ntfstools
In directory usw-pr-cvs1:/tmp/cvs-serv18514/ntfstools
Modified Files:
Makefile.am Makefile.in ntfsdump_logfile.c
Added Files:
mkntfs.8.in
Log Message:
Preparations for the 0.1.0 release. Updating documentation and information.
Updating rpm generation and added mkntfs man page which currently is not
accurate as it shows all the mke2fs options in it while mkntfs doesn't actually
accept any options except for device at all but it is a good starting point.
--- NEW FILE ---
.\" -*- nroff -*-
.\" Copyright (c) 2001 Anton Altaparmakov. All Rights Reserved.
.\" This file may be copied under the terms of the GNU Public License.
.\" Adapted from e2fsprogs-1.19/misc/mke2fs.8.in by Theodore Ts'o.
.\"
.TH MKNTFS 8 "June 2001" "Linux-NTFS version @VERSION@"
.SH NAME
mkntfs \- create a NTFS 1.2 (Windows NT 4.0) file system
.SH SYNOPSIS
.B mkntfs
[
.B \-c
|
.\" .B \-t
.\" .I test
.\" |
.B \-l
.I filename
]
[
.B \-b
.I block-size
]
[
.B \-f
.I fragment-size
]
[
.B \-i
.I bytes-per-inode
]
[
.B \-N
.I number-of-inodes
]
[
.B -n
]
[
.B \-m
.I reserved-blocks-percentage
]
[
.B \-o
.I creator-os
]
[
.B \-O
.IR feature [,...]
]
[
.B \-q
]
[
.B \-r
.I fs-revision-level
]
[
.B \-R
.I raid_options
]
[
.B \-s
.I sparse-super-flag
]
[
.B \-v
]
[
.B \-F
]
[
.B \-L
.I volume-label
]
[
.B \-M
.I last-mounted-directory
]
[
.B \-S
]
[
.B \-T
.I filesystem-type
]
[
.B \-V
]
.I device
[
.I blocks-count
]
.SH DESCRIPTION
.B mkntfs
is used to create a NTFS 1.2 (Windows NT 4.0) file system on a device (usually
a disk partition).
.I device
is the special file corresponding to the device (e.g
.IR /dev/hdXX ).
.I blocks-count
is the number of blocks on the device. If omitted,
.B mkntfs
automagically figures the file system size.
.SH OPTIONS
.TP
.BI \-b " block-size"
Specify the size of blocks in bytes. Valid block size vales are 1024,
2048 and 4096 bytes per block. If omitted,
.B mkntfs
block-size is determined by the file system size and the expected usage
of the filesystem (see the
.B \-T
option).
.TP
.B \-c
Check the device for bad blocks before creating the file system, using a
fast read-only test.
.TP
.BI \-f " fragment-size"
Specify the size of fragments in bytes.
.TP
.BI \-i " bytes-per-inode"
Specify the bytes/inode ratio.
.B mkntfs
creates an inode for every
.I bytes-per-inode
bytes of space on the disk.
The larger the
.I bytes-per-inode
ratio, the fewer inodes will be created.
This value generally shouldn't be smaller than
the blocksize of the filesystem, since then too many inodes will be made.
Be warned that is not possible to expand the number of inodes on a
filesystem after it is created, so be careful decided the correct
value for this parameter.
.TP
.B \-n
causes mkntfs to not actually create a filesystem, but display what it
would do if it were to create a filesystem.
.TP
.BI \-N " number-of-inodes"
overrides the default calculation of the number of inodes that should be
reserved for the filesystem (which is based on the number of blocks and
the
.I bytes-per-inode
ratio). This allows the user to specify the number
of desired inodes directly.
.TP
.BI \-O " feature\fR[,...]"
Create the filesystem with the listed set of features
(filesystem options). The following features are supported:
.IR sparse_super ,
which cause the filesystem to use sparse superblocks, and
.IR filetype ,
which will cause the filesystem to store file type information in
directory entries. Currently, both features are turned on by default
unless
.B mkntfs
is run on a system with a pre-2.2 Linux kernel.
.B Warning:
Pre-2.2 Linux kernels do not properly
support the filesystems that use either of these two features. Filesystems
that may need to mounted on pre-2.2 kernels should be created with
.B -O
.I none
which will disable both of these features, even if
.B mkntfs
is run on a system which can support these features.
.TP
.BI \-l " filename"
Read the bad blocks list from
.I filename.
\.
.TP
.BI -m " reserved-blocks-percentage"
Specify the percentage of reserved blocks for the super-user. This value
defaults to 5%.
.\" .TP
.\" .BI \-t " test"
.\" Check the device for bad blocks before creating the file system
.\" using the specified test.
.TP
.B \-o
Manually override the default value of the "creator os" field of the
filesystem. Normally the creator field is set by default to the native OS
of the
.B mkntfs
executable.
.TP
.B \-q
Quiet execution. Useful if
.B mkntfs
is run in a script.
.TP
.BI \-s " sparse-super-flag"
If
.I sparse-super-flag
is 1, then turn on the sparse superblock flag in the superblock.
.B Note:
This option is deprecated; use the
.B \-O
option instead.
.TP
.B \-v
Verbose execution.
.TP
.B \-F
Force
.B mkntfs
to run, even if the specified device is not a
block special device, or appears to be mounted.
.TP
.B \-L
Set the volume label for the filesystem.
.TP
.B \-M
Set the last mounted directory for the filesystem. This might be useful
for the sake of utilities that key off of the last mounted directory to
determine where the filesytem should be mounted.
.TP
.BI -r " revision"
Set the filesystem revision for the new filesystem. Note that 1.2
kernels only support revision 0 filesystems.
.TP
.BI \-R " raid_options"
Set raid-related options for the filesystem. Raid options are comma
separated, and may take an argument using the equals ('=') sign.
Currently the only supported argument is
.I stride
which takes as its argument the number of blocks in a RAID stripe.
.TP
.B \-S
Write superblock and group descriptors only. This is useful if all of
the superblock and backup superblocks are corrupted, and a last-ditch
recovery method is desired. It causes
.B mkntfs
to reinitialize the
superblock and group descriptors, while not touching the inode table
and the block and inode bitmaps. The
.B e2fsck
program should be run immediately after this option is used, and there
is no guarantee that any data will be salvageable.
.TP
.B \-V
Print the version number of
.B mkntfs
and exit.
.SH AUTHOR
This version of
.B mkntfs
has been written by Anton Altaparmakov <ai...@ca...> or if that fails
<an...@us...>.
.SH BUGS
.B mkntfs
writes the backup boot sector to the last sector of the block device. However,
current versions of the Linux kernel (all versions up to today's 2.4.5) only
report an even number of sectors when the sector size is below 1024 bytes,
which is the case for most hard drives today (512 bytes sector size). This
means that when a partition has an odd number of 512-byte sectors, the last
sector is not reported to us and hence the created NTFS volume will have the
backup boot sector placed one sector ahead of where it should be. For this
reason, mkntfs marks the NTFS volume dirty so that when you reboot into
Windows, check disk runs automatically and creates a copy of the backup boot
sector in the correct location. This also has the benefit of catching any bugs
in mkntfs as check disk would find any corrupt on disk structures and repair
them as well as report them. - If you do see any problems reported, please
report the messages to the author (see below). Thank you.
.br
There may be others. Please, report them to the author.
.SH AVAILABILITY
.B mkntfs
is part of the Linux-NTFS project and is available for download from
http://sf.net/project/showfiles.php?group_id=13956 in source (tar ball and
rpm) and pre-compiled binary (i386 rpm) form.
.SH SEE ALSO
.BR badblocks (8)
Index: Makefile.am
===================================================================
RCS file: /cvsroot/linux-ntfs/linux-ntfs/ntfstools/Makefile.am,v
retrieving revision 1.6
retrieving revision 1.7
diff -U2 -r1.6 -r1.7
--- Makefile.am 2001/06/04 23:38:55 1.6
+++ Makefile.am 2001/06/10 18:30:17 1.7
@@ -7,4 +7,6 @@
bin_PROGRAMS = ntfsfix ntfsdump_logfile mkntfs ldm
+man_MANS = mkntfs.8
+EXTRA_DIST = $(man_MANS)
linux_ntfsincludedir = -I$(top_srcdir)/include
Index: Makefile.in
===================================================================
RCS file: /cvsroot/linux-ntfs/linux-ntfs/ntfstools/Makefile.in,v
retrieving revision 1.5
retrieving revision 1.6
diff -U2 -r1.5 -r1.6
--- Makefile.in 2001/06/04 23:38:55 1.5
+++ Makefile.in 2001/06/10 18:30:17 1.6
@@ -93,4 +93,6 @@
bin_PROGRAMS = ntfsfix ntfsdump_logfile mkntfs ldm
+man_MANS = mkntfs.8
+EXTRA_DIST = $(man_MANS)
linux_ntfsincludedir = -I$(top_srcdir)/include
@@ -114,5 +116,5 @@
mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
CONFIG_HEADER = ../config.h
-CONFIG_CLEAN_FILES =
+CONFIG_CLEAN_FILES = mkntfs.8
bin_PROGRAMS = ntfsfix$(EXEEXT) ntfsdump_logfile$(EXEEXT) \
mkntfs$(EXEEXT) ldm$(EXEEXT)
@@ -137,7 +139,11 @@
CCLD = $(CC)
LINK = $(LIBTOOL) --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(LDFLAGS) -o $@
-DIST_COMMON = Makefile.am Makefile.in
+man8dir = $(mandir)/man8
+MANS = $(man_MANS)
+NROFF = nroff
+DIST_COMMON = Makefile.am Makefile.in mkntfs.8.in
+
DISTFILES = $(DIST_COMMON) $(SOURCES) $(HEADERS) $(TEXINFOS) $(EXTRA_DIST)
@@ -159,4 +165,6 @@
&& CONFIG_FILES=$(subdir)/$@ CONFIG_HEADERS= $(SHELL) ./config.status
+mkntfs.8: $(top_builddir)/config.status mkntfs.8.in
+ cd $(top_builddir) && CONFIG_FILES=$(subdir)/$@ CONFIG_HEADERS= $(SHELL) ./config.status
mostlyclean-binPROGRAMS:
@@ -239,4 +247,43 @@
$(LINK) $(ldm_LDFLAGS) $(ldm_OBJECTS) $(ldm_LDADD) $(LIBS)
+install-man8:
+ $(mkinstalldirs) $(DESTDIR)$(man8dir)
+ @list='$(man8_MANS)'; \
+ l2='$(man_MANS)'; for i in $$l2; do \
+ case "$$i" in \
+ *.8*) list="$$list $$i" ;; \
+ esac; \
+ done; \
+ for i in $$list; do \
+ if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \
+ else file=$$i; fi; \
+ ext=`echo $$i | sed -e 's/^.*\\.//'`; \
+ inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
+ inst=`echo $$inst | sed '$(transform)'`.$$ext; \
+ echo " $(INSTALL_DATA) $$file $(DESTDIR)$(man8dir)/$$inst"; \
+ $(INSTALL_DATA) $$file $(DESTDIR)$(man8dir)/$$inst; \
+ done
+
+uninstall-man8:
+ @list='$(man8_MANS)'; \
+ l2='$(man_MANS)'; for i in $$l2; do \
+ case "$$i" in \
+ *.8*) list="$$list $$i" ;; \
+ esac; \
+ done; \
+ for i in $$list; do \
+ ext=`echo $$i | sed -e 's/^.*\\.//'`; \
+ inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
+ inst=`echo $$inst | sed '$(transform)'`.$$ext; \
+ echo " rm -f $(DESTDIR)$(man8dir)/$$inst"; \
+ rm -f $(DESTDIR)$(man8dir)/$$inst; \
+ done
+install-man: $(MANS)
+ @$(NORMAL_INSTALL)
+ $(MAKE) $(AM_MAKEFLAGS) install-man8
+uninstall-man:
+ @$(NORMAL_UNINSTALL)
+ $(MAKE) $(AM_MAKEFLAGS) uninstall-man8
+
tags: TAGS
@@ -331,5 +378,5 @@
install-exec: install-exec-am
-install-data-am:
+install-data-am: install-man
install-data: install-data-am
@@ -337,12 +384,12 @@
@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
install: install-am
-uninstall-am: uninstall-binPROGRAMS
+uninstall-am: uninstall-binPROGRAMS uninstall-man
uninstall: uninstall-am
-all-am: Makefile $(PROGRAMS)
+all-am: Makefile $(PROGRAMS) $(MANS)
all-redirect: all-am
install-strip:
$(MAKE) $(AM_MAKEFLAGS) AM_INSTALL_PROGRAM_FLAGS=-s install
installdirs:
- $(mkinstalldirs) $(DESTDIR)$(bindir)
+ $(mkinstalldirs) $(DESTDIR)$(bindir) $(DESTDIR)$(mandir)/man8
@@ -387,13 +434,13 @@
mostlyclean-compile distclean-compile clean-compile \
maintainer-clean-compile mostlyclean-libtool distclean-libtool \
-clean-libtool maintainer-clean-libtool tags mostlyclean-tags \
-distclean-tags clean-tags maintainer-clean-tags distdir \
-mostlyclean-depend distclean-depend clean-depend \
-maintainer-clean-depend info-am info dvi-am dvi check check-am \
-installcheck-am installcheck install-exec-am install-exec \
-install-data-am install-data install-am install uninstall-am uninstall \
-all-redirect all-am all installdirs mostlyclean-generic \
-distclean-generic clean-generic maintainer-clean-generic clean \
-mostlyclean distclean maintainer-clean
+clean-libtool maintainer-clean-libtool install-man8 uninstall-man8 \
+install-man uninstall-man tags mostlyclean-tags distclean-tags \
+clean-tags maintainer-clean-tags distdir mostlyclean-depend \
+distclean-depend clean-depend maintainer-clean-depend info-am info \
+dvi-am dvi check check-am installcheck-am installcheck install-exec-am \
+install-exec install-data-am install-data install-am install \
+uninstall-am uninstall all-redirect all-am all installdirs \
+mostlyclean-generic distclean-generic clean-generic \
+maintainer-clean-generic clean mostlyclean distclean maintainer-clean
Index: ntfsdump_logfile.c
===================================================================
RCS file: /cvsroot/linux-ntfs/linux-ntfs/ntfstools/ntfsdump_logfile.c,v
retrieving revision 1.8
retrieving revision 1.9
diff -U2 -r1.8 -r1.9
--- ntfsdump_logfile.c 2001/06/10 15:54:20 1.8
+++ ntfsdump_logfile.c 2001/06/10 18:30:17 1.9
@@ -1,4 +1,4 @@
const char *EXEC_NAME = "NtfsDump_LogFile";
-const char *EXEC_VERSION = "0.0.2";
+const char *EXEC_VERSION = "0.9";
/*
* $Id$
|
