X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmhstore.man1;h=faf8ea5d64ccf041310f4bf96fd812194507dc1d;hp=fcd833df379a6ebbf04858bff51999cf5c8221d2;hb=3410b680416c49a7617491af38bc1929855a331d;hpb=d1fefd9f614e4dc3cda16da6c69133c1b2005269 diff --git a/man/mhstore.man1 b/man/mhstore.man1 index fcd833d..faf8ea5 100644 --- a/man/mhstore.man1 +++ b/man/mhstore.man1 @@ -135,9 +135,9 @@ nmh-storage: /tmp If this entry isn't present, the current working directory is used. .PP -If the +By default (or if the .B \-auto -switch is given, then +switch is given), then .B mhstore will check if the message contains information indicating the filename that should @@ -145,13 +145,12 @@ be used to store the content. This information should be specified as the attribute \*(lqname=filename\*(rq in the \*(lqContent-Type\*(rq header for the content you are storing. For security reasons, this filename will be ignored if it begins with the character '/', '.', '|', or '!', -or if it contains the character '%'. For the sake of security, -this switch is not the default, and it is recommended that you do -NOT put the +or if it contains the character '%'. Now that tar files are not extracted +automatically anymore, having .B \-auto -switch in your -.I \&.mmh/profile -file. +as the default is quite safe. +Attachments are only stored below the current (or the storage) +directory. In the worst case, existing files there will be overwritten. .PP If the .B \-auto @@ -225,13 +224,6 @@ listed above) content, the p-escapes are ignored. .PP If no formatting string is found, .B mhstore -will check to see -if the content is application/octet-stream with parameter -\*(lqtype=tar\*(rq. If so, -.B mhstore -will choose an appropriate -filename. If the content is not application/octet-stream, then -.B mhstore will check to see if the content is a message. If so, .B mhstore @@ -297,48 +289,7 @@ are combined in the correct order. But if can not locate every partial necessary to reassemble the message, it will not store anything. -RE -.PP -By using the -.B \-auto -switch, -.B mhstore -will automatically do the extraction for you: -.PP -.RS 5 -.nf -% mhlist 5-8 - msg part type/subtype size description - 5 message/partial 47K part 1 of 4 - 6 message/partial 47K part 2 of 4 - 7 message/partial 47K part 3 of 4 - 8 message/partial 18K part 4 of 4 -% mhstore 5-8 -reassembling partials 5,6,7,8 to folder inbox as message 9 -% mhlist 9 - msg part type/subtype size description - 9 application/octet-stream 118K - (extract with uncompress | tar xvpf -) - type=tar - conversions=compress -% mhstore -auto 9 --- tar listing appears here as files are extracted -.fi .RE -.PP -As the second -.B tar -listing is generated, the files are extracted. -A prudent user will never put -.B \-auto -in the profile. -The correct procedure is to first use -.B mhlist -to find out what will be extracted. Then -.B mhstore -can be invoked with -.B \-auto -to perform the extraction. .SS "External Access" For contents of type message/external-body, \fImhstore\fR supports these access-types: @@ -433,7 +384,7 @@ mhbuild(1), mhlist(1), mhshow(1), sendfiles(1) .nf .RB ` +folder "' defaults to the current folder" .RB ` msgs "' defaults to cur" -.RB ` \-noauto ' +.RB ` \-auto ' .SH CONTEXT If a folder is given, it will become the current folder. The last