mblaze/man/msed.1

.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 mhdr 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/