tools/mpack-1.6/unixpk.man

.TH MPACK 1
.SH NAME
mpack \- pack a file in MIME format
.SH SYNOPSIS
.B mpack
[
.B \-a
]
[
.B \-s
.I subject
]
[
.B \-d
.I descriptionfile
]
[
.B \-m
.I maxsize
]
[
.B \-c
.I content-type
]
.I file
.I "address \&..."
.br
.B mpack
[
.B \-a
]
[
.B \-s
.I subject
]
[
.B \-d
.I descriptionfile
]
[
.B \-m
.I maxsize
]
[
.B \-c
.I content-type
]
.B \-o
.I outputfile
.I file
.br
.B mpack
[
.B \-a
]
[
.B \-s
.I subject
]
[
.B \-d
.I descriptionfile
]
[
.B \-m
.I maxsize
]
[
.B \-c
.I content-type
]
.B \-n
.I newsgroups
.I file
.SH DESCRIPTION
The 
.I mpack
program encodes the 
the named file in one or more MIME messages.
The resulting messages are mailed to one or more recipients,
written to a named file or set of files, or posted to a set of
newsgroups.
.PP
.SH OPTIONS
.TP
.BI \-a
Set the Content-Disposition to attachment.  If \-a is not used
the Content-Disposition is inline.
.TP
.BI \-s " subject"
Set the 
.B Subject
header field to
.IR Subject .
By default,
.B mpack
will prompt for the contents of the subject header.
.TP
.BI \-d " descriptionfile
Include the contents of the file
.I descriptionfile
in an introductory section at the beginning of the first
generated message.
.TP
.BI \-m " maxsize"
Split the message (if necessary) into partial messages, each not
exceeding
.I maxsize
characters.  The default limit is the value of the 
.B SPLITSIZE
environment variable, or no limit if the environment variable
does not exist.
Specifying a 
.I maxsize
of 0 means there is no limit to the size of the generated message.
.TP
.BI \-c " content-type"
Label the included file as being of MIME type
.IR content-type ,
which must be a subtype of 
.BR application ,
.BR audio ,
.BR image ,
or 
.BR video .
If this switch is not given,
.B mpack
examines the file to determine its type.
.TP
.BI \-o " outputfile"
Write the generated message to the file
.IR outputfile .
If the message has to be split, the partial messages will instead be
written to the files
.IR outputfile .01,
.IR outputfile .02,
etc.
.TP
.BI \-n " newsgroups"
Post the generated message(s) to the comma-separated netnews
.IR newsgroups .
.TP
.I file
Encode the named
.IR file .
.TP
.I "address \&..."
Mail the generated messages to the specified addresses.
.SH ENVIRONMENT
.TP
.B TMPDIR
Directory to store temporary files.  Default is /var/tmp.
.TP
.B SPLITSIZE
Default value of the -m switch.
1	edhill	1.1	.TH MPACK 1
2			.SH NAME
3			mpack \- pack a file in MIME format
4			.SH SYNOPSIS
5			.B mpack
6			[
7	jmc	1.2	.B \-a
8			]
9			[
10	edhill	1.1	.B \-s
11			.I subject
12			]
13			[
14			.B \-d
15			.I descriptionfile
16			]
17			[
18			.B \-m
19			.I maxsize
20			]
21			[
22			.B \-c
23			.I content-type
24			]
25			.I file
26			.I "address \&..."
27			.br
28			.B mpack
29			[
30	jmc	1.2	.B \-a
31			]
32			[
33	edhill	1.1	.B \-s
34			.I subject
35			]
36			[
37			.B \-d
38			.I descriptionfile
39			]
40			[
41			.B \-m
42			.I maxsize
43			]
44			[
45			.B \-c
46			.I content-type
47			]
48			.B \-o
49			.I outputfile
50			.I file
51			.br
52			.B mpack
53			[
54	jmc	1.2	.B \-a
55			]
56			[
57	edhill	1.1	.B \-s
58			.I subject
59			]
60			[
61			.B \-d
62			.I descriptionfile
63			]
64			[
65			.B \-m
66			.I maxsize
67			]
68			[
69			.B \-c
70			.I content-type
71			]
72			.B \-n
73			.I newsgroups
74			.I file
75			.SH DESCRIPTION
76			The
77			.I mpack
78			program encodes the
79			the named file in one or more MIME messages.
80			The resulting messages are mailed to one or more recipients,
81			written to a named file or set of files, or posted to a set of
82			newsgroups.
83			.PP
84			.SH OPTIONS
85			.TP
86	jmc	1.2	.BI \-a
87			Set the Content-Disposition to attachment. If \-a is not used
88			the Content-Disposition is inline.
89			.TP
90	edhill	1.1	.BI \-s " subject"
91			Set the
92			.B Subject
93			header field to
94			.IR Subject .
95			By default,
96			.B mpack
97			will prompt for the contents of the subject header.
98			.TP
99			.BI \-d " descriptionfile
100			Include the contents of the file
101			.I descriptionfile
102			in an introductory section at the beginning of the first
103			generated message.
104			.TP
105			.BI \-m " maxsize"
106			Split the message (if necessary) into partial messages, each not
107			exceeding
108			.I maxsize
109			characters. The default limit is the value of the
110			.B SPLITSIZE
111			environment variable, or no limit if the environment variable
112			does not exist.
113			Specifying a
114			.I maxsize
115			of 0 means there is no limit to the size of the generated message.
116			.TP
117			.BI \-c " content-type"
118			Label the included file as being of MIME type
119			.IR content-type ,
120			which must be a subtype of
121			.BR application ,
122			.BR audio ,
123			.BR image ,
124			or
125			.BR video .
126			If this switch is not given,
127			.B mpack
128			examines the file to determine its type.
129			.TP
130			.BI \-o " outputfile"
131			Write the generated message to the file
132			.IR outputfile .
133			If the message has to be split, the partial messages will instead be
134			written to the files
135			.IR outputfile .01,
136			.IR outputfile .02,
137			etc.
138			.TP
139			.BI \-n " newsgroups"
140			Post the generated message(s) to the comma-separated netnews
141			.IR newsgroups .
142			.TP
143			.I file
144			Encode the named
145			.IR file .
146			.TP
147			.I "address \&..."
148			Mail the generated messages to the specified addresses.
149			.SH ENVIRONMENT
150			.TP
151			.B TMPDIR
152	jmc	1.2	Directory to store temporary files. Default is /var/tmp.
153	edhill	1.1	.TP
154			.B SPLITSIZE
155			Default value of the -m switch.