git.marmaro.de Git - mmh/blob - man/sendfiles.man

   1 .\"
   2 .\" %nmhwarning%
   3 .\"
   4 .TH SENDFILES %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
   5 .SH NAME
   6 sendfiles \- send multiple files via a MIME message
   7 .SH SYNOPSIS
   8 .HP
   9 .na
  10 .B sendfiles
  11 .I mailpath
  12 .I subject
  13 .I file1
  14 .RI [ file2
  15 \&...]
  16 .ad
  17 .SH DESCRIPTION
  18 The shell script
  19 .BR sendfiles ,
  20 is used to send a collection
  21 of files and directories via electronic mail.
  22 .PP
  23 .RS 5
  24 sendfiles mailpath \*(lqsubject\*(rq files\0...
  25 .RE
  26 .PP
  27 .B sendfiles
  28 will archive the files and directories you name
  29 with the
  30 .B tar
  31 command, and then mail the compressed
  32 archive to the \*(lqmailpath\*(rq with the given \*(lqsubject\*(rq.
  33 .PP
  34 Sometimes you want
  35 .B sendfiles
  36 to pause after posting a partial
  37 message.  This is usually the case when you are running
  38 .B sendmail
  39 and expect to generate a lot of partial messages.  If the first
  40 argument given to
  41 .B sendfiles
  42 starts with a dash, then it is
  43 interpreted as the number of seconds to pause in between postings,
  44 e.g.,
  45 .PP
  46 .RS 5
  47 sendfiles -30 mailpath \*(lqsubject\*(rq files\0...
  48 .RE
  49 .PP
  50 will pause 30 seconds in between each posting.
  51 .PP
  52 .SS "Extracting the Received Files"
  53 When these messages are received, invoke
  54 .B mhstore
  55 once for
  56 the list of messages.  The default is for
  57 .B mhstore
  58 to store
  59 the combined parts as a new message in the current folder, although
  60 this can be changed using storage formatting strings.  You can then
  61 use
  62 .B mhlist
  63 to find out what's inside; possibly followed by
  64 .B mhstore
  65 again to write the archive to a file where you can
  66 subsequently uncompress and untar it.  For instance:
  67 .PP
  68 .RS 5
  69 .nf
  70 % mhlist 5-8
  71  msg part  type/subtype             size description
  72    5       message/partial           47K part 1 of 4
  73    6       message/partial           47K part 2 of 4
  74    7       message/partial           47K part 3 of 4
  75    8       message/partial           18K part 4 of 4
  76 % mhstore 5-8
  77 reassembling partials 5,6,7,8 to folder inbox as message 9
  78 % mhlist -verbose 9
  79  msg part  type/subtype             size description
  80    9       application/octet-stream 118K
  81              (extract with uncompress | tar xvpf -)
  82              type=tar
  83              conversions=compress
  84 % mhstore 9
  85 % uncompress < 9.tar.Z | tar xvpf -
  86 .fi
  87 .RE
  88 .PP
  89 Alternately, by using the
  90 .B \-auto
  91 switch,
  92 .B mhstore
  93 will automatically do the extraction for you:
  94 .PP
  95 .RS 5
  96 .nf
  97 % mhlist 5-8
  98  msg part  type/subtype             size description
  99    5       message/partial           47K part 1 of 4
 100    6       message/partial           47K part 2 of 4
 101    7       message/partial           47K part 3 of 4
 102    8       message/partial           18K part 4 of 4
 103 % mhstore 5-8
 104 reassembling partials 5,6,7,8 to folder inbox as message 9
 105 % mhlist -verbose 9
 106  msg part  type/subtype             size description
 107    9       application/octet-stream 118K
 108              (extract with uncompress | tar xvpf -)
 109              type=tar
 110              conversions=compress
 111 % mhstore -auto 9
 112 -- tar listing appears here as files are extracted
 113 .fi
 114 .RE
 115 .PP
 116 As the second
 117 .B tar
 118 listing is generated, the files are extracted.
 119 A prudent user will never put
 120 .B \-auto
 121 in the profile.
 122 The correct procedure is to first use
 123 .B mhlist
 124 to find out what will be extracted.  Then
 125 .B mhstore
 126 can be invoked with
 127 .B \-auto
 128 to perform the extraction.
 129
 130 .SH FILES
 131 .fc ^ ~
 132 .nf
 133 .ta \w'%etcdir%/ExtraBigFileName  'u
 134 ^$HOME/.mmh/profile~^The user profile
 135 .fi
 136
 137 .SH "PROFILE COMPONENTS"
 138 .fc ^ ~
 139 .nf
 140 .ta 2.4i
 141 .ta \w'ExtraBigProfileName  'u
 142 ^Path:~^To determine the user's mail storage
 143 ^Current\-Folder:~^To find the default current folder
 144 .fi
 145
 146 .SH "SEE ALSO"
 147 mhbuild(1), mhlist(1), mhshow(1), mhstore(1).
 148 .I "Proposed Standard for Message Encapsulation"
 149 (RFC\-934)
 150
 151 .SH DEFAULTS
 152 .nf
 153 .RB ` \-noverbose '
 154 .fi
 155
 156 .SH CONTEXT
 157 None