mirror of
https://github.com/leahneukirchen/mblaze
synced 2024-11-11 13:10:32 +00:00
141 lines
2.8 KiB
Groff
141 lines
2.8 KiB
Groff
.Dd August 1, 2016
|
|
.Dt MSED 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm msed
|
|
.Nd manipulate message headers
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Ar script
|
|
.Op Ar msgs\ ...
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
prints the messages
|
|
.Ar msgs
|
|
with message headers transformed by the commands in
|
|
.Ar script .
|
|
.Po
|
|
See
|
|
.Xr mmsg 7
|
|
for the message argument syntax.
|
|
.Pc
|
|
If no
|
|
.Ar msgs
|
|
are passed,
|
|
.Nm
|
|
will default to the current message.
|
|
.Pp
|
|
.Nm
|
|
scripts are akin to a subset of
|
|
.Xr sed 1
|
|
scripts, but optimized for modifying messages.
|
|
Note that
|
|
.Nm
|
|
unfolds and normalizes message headers,
|
|
so they may need to be passed through
|
|
.Xr mmime 7
|
|
to ensure RFC 5322 conformance.
|
|
The message body is not affected.
|
|
.Pp
|
|
.Nm
|
|
supports the following commands.
|
|
The separators
|
|
.Em after
|
|
the command letter may be substituted with an arbitrary symbol, just as in
|
|
.Xr sed 1 .
|
|
Multiple commands can be separated by
|
|
.Sq Cm \&; .
|
|
.Bl -tag -width Ds
|
|
.It Cm \&/ Ns Ar header Ns Cm \&/ Ns Ic a Ns Cm \&/ Ns Ar value Ns Cm \&/
|
|
If the header
|
|
.Sq Ar header Ns Cm \&:
|
|
is not set in the message, add it with the given
|
|
.Ar value .
|
|
.It Cm \&/ Ns Ar headers Ns Cm \&/ Ns Ic c Ns Cm \&/ Ns Ar value Ns Cm \&/
|
|
Change colon-separated headers matching the regular expression
|
|
.Ar headers ,
|
|
with implicit anchoring to the header name,
|
|
to the value given in
|
|
.Ar value .
|
|
.It Cm \&/ Ns Ar headers Ns Cm \&/ Ns Ic d
|
|
Delete colon-separated headers matching the regular expression
|
|
.Ar headers ,
|
|
with implicit anchoring to the header name.
|
|
Use explicit
|
|
.Sq Li \&.*
|
|
to match arbitrary strings at the beginning or end of the headers.
|
|
.Pp
|
|
For example,
|
|
.Sq Li "/x-.*/d"
|
|
will delete all headers starting with
|
|
.Sq Li "X-"
|
|
.Pq always case insensitive ,
|
|
and
|
|
.Sq Li "/from:to:cc/d"
|
|
will delete the headers
|
|
.Sq Li From\&: ,
|
|
.Sq Li To\&: ,
|
|
and
|
|
.Sq Li Cc\&: .
|
|
.It Oo Cm \&/ Ns Ar headers Ns Cm \&/ Oc Ns Ic s Ns Cm \&/ Ns Ar regex Ns Cm \&/ Ns Ar replacement Ns Cm \&/ Ns Op Ar flags
|
|
Substitute matches of the POSIX Basic Regular Expression
|
|
.Ar regex
|
|
in headers matching the POSIX Basic Regular Expression
|
|
.Ar headers ,
|
|
with implicit anchoring to the header name
|
|
.Pq or all headers, if omitted ,
|
|
with the string
|
|
.Ar replacement ,
|
|
expanding
|
|
.Sq Cm \&&
|
|
to the matched string,
|
|
and
|
|
.Sq Cm \e Ns Ar N
|
|
to the
|
|
.Ar N Ns
|
|
th
|
|
sub-expression,
|
|
where
|
|
.Ar N
|
|
is between 1 and 9.
|
|
.Pp
|
|
If
|
|
.Ar flags
|
|
contains the letter
|
|
.Sq Cm d ,
|
|
the header is removed if
|
|
.Ar regex
|
|
matched.
|
|
.Pp
|
|
By default, only the first match is replaced, unless
|
|
.Ar flags
|
|
contains the letter
|
|
.Sq Cm g .
|
|
.Pp
|
|
By default,
|
|
.Ar regex
|
|
is matched case sensitively, unless
|
|
.Ar flags
|
|
contains the letter
|
|
.Sq Cm i .
|
|
.El
|
|
.Sh EXIT STATUS
|
|
.Ex -std
|
|
.Sh SEE ALSO
|
|
.Xr sed 1 ,
|
|
.Xr mmsg 7 ,
|
|
.Xr regex 7 /
|
|
.Xr re_format 7
|
|
.Sh AUTHORS
|
|
.An Leah Neukirchen Aq Mt leah@vuxu.org
|
|
.Sh LICENSE
|
|
.Nm
|
|
is in the public domain.
|
|
.Pp
|
|
To the extent possible under law,
|
|
the creator of this work
|
|
has waived all copyright and related or
|
|
neighboring rights to this work.
|
|
.Pp
|
|
.Lk http://creativecommons.org/publicdomain/zero/1.0/
|