[apple/system_cmds.git] / mkfile.tproj / mkfile.8

.\" (c) 1997 Apple Computer, Inc.
.TH MKFILE 8 "1 September 1997"
.SH NAME
mkfile \- create a file
.SH SYNOPSIS
.B mkfile
.RB [ " -nv " ]
.I size\c
[\c
.BR b | k | m | g\c
]
.IR filename " .\|.\|."
.SH DESCRIPTION
.B mkfile
creates one or more files that are suitable for use as
.SM NFS-\s0mounted
swap areas.  The sticky bit is set, and
the file is padded with zeroes by default.
Non-root users must set the sticky bit using
chmod(1).
The default size unit is bytes, but the following suffixes
may be used to multiply by the given factor:
.B b
(512),
.B k
(1024),
.B m
(1048576), and
.B g
(1073741824).
.SH OPTIONS
.TP
.B \-n
Create an empty
.IR filename .
The size is noted, but disk blocks aren't allocated until data is
written to them.
.TP
.B \-v
Verbose.  Report the names and sizes of created files.
.SH WARNING
If a client's swap file is removed and recreated, it must be
re-exported before the client will be able to access it.
This action may only be done when the client is not running.
.SH "SEE ALSO"
.TP
chmod(2), stat(2), exportfs(8), sticky(8)
Commit	Line	Data
b51d5b5f A	1	.\" (c) 1997 Apple Computer, Inc.
	2	.TH MKFILE 8 "1 September 1997"
	3	.SH NAME
	4	mkfile \- create a file
	5	.SH SYNOPSIS
	6	.B mkfile
	7	.RB [ " -nv " ]
	8	.I size\c
	9	[\c
	10	.BR b \| k \| m \| g\c
	11	]
	12	.IR filename " .\\|.\\|."
	13	.SH DESCRIPTION
	14	.B mkfile
	15	creates one or more files that are suitable for use as
	16	.SM NFS-\s0mounted
	17	swap areas. The sticky bit is set, and
	18	the file is padded with zeroes by default.
	19	Non-root users must set the sticky bit using
	20	chmod(1).
	21	The default size unit is bytes, but the following suffixes
	22	may be used to multiply by the given factor:
	23	.B b
	24	(512),
	25	.B k
	26	(1024),
	27	.B m
	28	(1048576), and
	29	.B g
	30	(1073741824).
	31	.SH OPTIONS
	32	.TP
	33	.B \-n
	34	Create an empty
	35	.IR filename .
	36	The size is noted, but disk blocks aren't allocated until data is
	37	written to them.
	38	.TP
	39	.B \-v
	40	Verbose. Report the names and sizes of created files.
	41	.SH WARNING
	42	If a client's swap file is removed and recreated, it must be
	43	re-exported before the client will be able to access it.
	44	This action may only be done when the client is not running.
	45	.SH "SEE ALSO"
	46	.TP
	47	chmod(2), stat(2), exportfs(8), sticky(8)