~ubuntu-branches/ubuntu/trusty/hfsprogs/trusty-proposed

« back to all changes in this revision

Viewing changes to .pc/80-fix_manpages.patch/newfs_hfs.tproj/newfs_hfs.8

  • Committer: Bazaar Package Importer
  • Author(s): Rogério Brito
  • Date: 2010-11-25 03:11:42 UTC
  • Revision ID: james.westby@ubuntu.com-20101125031142-vgsaqd0t71xvxo7r
Tags: 332.25-9
* debian/patches/80-remove_see-also_from_manpage.patch:
  + Fix spelling in fsck.hfsplus's manpage. Closes: #575201.
    Thanks Lionel Elie Mamane <lmamane@debian.org>.
  + Fix manpages not reflecting the situation of Linux/Debian systems.
    Closes: #598714. Thanks Christoph Hellwig <hch@lst.de>.
* debian/patches:
  + Move 80-remove_see-also_from_manpage.patch to 80-fix_manpages.patch.
  + Integrate 90-fix_manpage_typos.patch into 80-fix_manpages.patch.
  + Update series.
* debian/control:
  + Update Standards-Version to 3.9.1, with no further changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Copyright (c) 2002-2003 Apple Computer, Inc. All rights reserved.
 
2
.\" 
 
3
.\" The contents of this file constitute Original Code as defined in and
 
4
.\" are subject to the Apple Public Source License Version 1.1 (the
 
5
.\" "License").  You may not use this file except in compliance with the
 
6
.\" License.  Please obtain a copy of the License at
 
7
.\" http://www.apple.com/publicsource and read it before using this file.
 
8
.\" 
 
9
.\" This Original Code and all software distributed under the License are
 
10
.\" distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 
11
.\" EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 
12
.\" INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 
13
.\" FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
 
14
.\" License for the specific language governing rights and limitations
 
15
.\" under the License.
 
16
.\" 
 
17
.\"     @(#)newfs_hfs.8
 
18
.Dd April 1, 2003
 
19
.Dt NEWFS_HFS 8
 
20
.Os "Mac OS X"
 
21
.Sh NAME
 
22
.Nm newfs_hfs
 
23
.Nd construct a new HFS Plus file system
 
24
.Sh SYNOPSIS
 
25
.Nm newfs_hfs
 
26
.Op Fl N Ar [partition-size]
 
27
.Op Fl U Ar uid
 
28
.Op Fl G Ar gid
 
29
.Op Fl M Ar mask
 
30
.Op Fl h | w
 
31
.Op Fl s
 
32
.Op Fl b Ar block-size
 
33
.Op Fl c Ar clump-size-list
 
34
.Op Fl i Ar first-cnid
 
35
.Op Fl J Ar [journal-size]
 
36
.Op Fl n Ar node-size-list
 
37
.Op Fl v Ar volume-name
 
38
.Ar special
 
39
.Sh DESCRIPTION
 
40
.Nm Newfs_hfs
 
41
builds an HFS Plus file system on the specified special device.
 
42
Before running 
 
43
.Nm newfs_hfs
 
44
the disk should be partitioned using the
 
45
.Em Disk Utility
 
46
application or
 
47
.Xr pdisk 8 .
 
48
.Pp
 
49
The file system default parameters are calculated based on
 
50
the size of the disk partition. Typically the defaults are
 
51
reasonable, however
 
52
.Nm newfs_hfs
 
53
has several options to allow the defaults to be selectively overridden.
 
54
The options are as follows:
 
55
.Bl -tag -width Fl
 
56
.It Fl N Ar [partition-size]
 
57
Causes the file system parameters to be printed out
 
58
without really creating the file system.
 
59
.It Fl U Ar uid
 
60
Set the owner of the file system's root directory to
 
61
.Pa uid .
 
62
.It Fl G Ar gid
 
63
Set the group of the file system's root directory to
 
64
.Pa gid .
 
65
.It Fl M Ar mask
 
66
Specify the access permissions mask for the file system's root directory.
 
67
.It Fl h
 
68
Creates a legacy HFS format filesystem. This option
 
69
is not recomended for file systems that will be
 
70
primarily used with Mac OS X or Darwin.
 
71
.It Fl s
 
72
Creates a case-sensitive HFS Plus filesystem. By
 
73
default a case-insensitive filesystem is created.
 
74
Case-sensitive HFS Plus file systems require a Mac OS X
 
75
version of 10.3 (Darwin 7.0) or later. 
 
76
.It Fl w
 
77
Adds an HFS wrapper around the HFS Plus file system.
 
78
This wrapper is required if the file system will be used
 
79
to boot natively into Mac OS 9.
 
80
.It Fl b Ar block-size
 
81
The allocation block size of the file system.  
 
82
The default value is 4096.
 
83
.It Fl c Ar clump-size-list
 
84
This specifies the
 
85
.Em clump
 
86
and/or
 
87
.Em initial
 
88
sizes, in allocation
 
89
blocks, for the various metadata files.
 
90
.Em Clump
 
91
sizes are specified with the
 
92
.Fl c
 
93
option followed by a comma
 
94
separated list of the form arg=blocks.
 
95
.Pp
 
96
Example:  \-c c=5000,e=500
 
97
.Bl -tag -width Fl
 
98
.It Em a=blocks
 
99
Set the attribute file clump size.
 
100
.It Em b=blocks
 
101
Set the allocation bitmap file clump size.
 
102
.It Em c=blocks
 
103
Set the catalog file clump size.
 
104
.It Em e=blocks
 
105
Set the extent overflow file clump size.
 
106
.El
 
107
.It Fl i Ar first-cnid
 
108
This specifies the initial catalog node ID for user files
 
109
and directories. The default value is 16.
 
110
.It Fl J Ar [journal-size]
 
111
Creates a journaled HFS+ volume.
 
112
The default journal size is 8MB.  Appending an 'M' to the
 
113
journal size implies megabytes (i.e. 64M is 64 megabytes).
 
114
The maximum journal size is 512 megabytes.
 
115
.It Fl n Ar node-size-list
 
116
This specifies the b-tree
 
117
.Em node
 
118
sizes, in bytes,
 
119
for the various b-tree files.
 
120
.Em Node
 
121
sizes are specified with the
 
122
.Fl n
 
123
option followed by a comma separated list of
 
124
the form arg=bytes. The
 
125
.Em node
 
126
size must be a power of two and no larger than
 
127
32768 bytes.
 
128
.Pp
 
129
Example:  \-n c=8192,e=4096
 
130
.Bl -tag -width Fl
 
131
.It Em a=bytes
 
132
Set the attribute b-tree node size.
 
133
.It Em c=bytes
 
134
Set the catalog b-tree node size.
 
135
.It Em e=bytes
 
136
Set the extent overflow b-tree node size.
 
137
.El
 
138
.It Fl v Ar volume-name
 
139
Volume name (file system name) in ascii or UTF-8 format.
 
140
.El
 
141
.Sh SEE ALSO
 
142
.Xr mount 8 ,
 
143
.Xr pdisk 8
 
144
.Sh HISTORY
 
145
The
 
146
.Nm
 
147
command appeared in Mac OS X Server 1.0 .