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
 122 .I \&.mh\(ruprofile
 123 file.  The correct procedure is to first use
 124 .B mhlist
 125 to find out what will be extracted.  Then
 126 .B mhstore
 127 can be invoked with
 128 .B \-auto
 129 to perform the extraction.
 130
 131 .SH FILES
 132 .fc ^ ~
 133 .nf
 134 .ta \w'%etcdir%/ExtraBigFileName  'u
 135 ^$HOME/\&.mh\(ruprofile~^The user profile
 136 .fi
 137
 138 .SH "PROFILE COMPONENTS"
 139 .fc ^ ~
 140 .nf
 141 .ta 2.4i
 142 .ta \w'ExtraBigProfileName  'u
 143 ^Path:~^To determine the user's nmh directory
 144 ^Current\-Folder:~^To find the default current folder
 145 .fi
 146
 147 .SH "SEE ALSO"
 148 mhbuild(1), mhlist(1), mhshow(1), mhstore(1).
 149 .I "Proposed Standard for Message Encapsulation"
 150 (RFC\-934)
 151
 152 .SH DEFAULTS
 153 .nf
 154 .RB ` \-noverbose '
 155 .fi
 156
 157 .SH CONTEXT
 158 None