Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MSED(1)			FreeBSD	General	Commands Manual		       MSED(1)

NAME
     msed -- manipulate	message	headers

SYNOPSIS
     msed script [msgs ...]

DESCRIPTION
     msed prints the messages msgs with	message	headers	transformed by the
     commands in script.  (See mmsg(7) for the message argument	syntax.)  If
     no	msgs are passed, msed will default to the current message.

     msed scripts are akin to a	subset of sed(1) scripts, but optimized	for
     modifying messages.  Note that msed unfolds and normalizes	message	head-
     ers, so they may need to be passed	through	mmime(7) to ensure RFC 5322
     conformance.  The message body is not affected.

     msed supports the following commands.  The	separators after the command
     letter may	be substituted with an arbitrary symbol, just as in sed(1).
     Multiple commands can be separated	by `;'.

     /header/a/value/
	     If	the header `header:' is	not set	in the message,	add it with
	     the given value.

     /headers/c/value/
	     Change colon-separated headers matching the regular expression
	     headers, with implicit anchoring to the header name, to the value
	     given in value.

     /headers/d
	     Delete colon-separated headers matching the regular expression
	     headers, with implicit anchoring to the header name.  Use ex-
	     plicit `.*' to match arbitrary strings at the beginning or	end of
	     the headers.

	     For example, `/x-.*/d' will delete	all headers starting with `X-'
	     (always case insensitive),	and `/from:to:cc/d' will delete	the
	     headers `From:', `To:', and `Cc:'.

     [/headers/]s/regex/replacement/[flags]
	     Substitute	matches	of the POSIX Basic Regular Expression regex in
	     headers matching the POSIX	Basic Regular Expression headers, with
	     implicit anchoring	to the header name (or all headers, if
	     omitted), with the	string replacement, expanding `&' to the
	     matched string, and `\N' to the Nth sub-expression, where N is
	     between 1 and 9.

	     If	flags contains the letter `d', the header is removed if	regex
	     matched.

	     By	default, only the first	match is replaced, unless flags	con-
	     tains the letter `g'.

	     By	default, regex is matched case sensitively, unless flags con-
	     tains the letter `i'.

EXIT STATUS
     The msed utility exits 0 on success, and >0 if an error occurs.

SEE ALSO
     sed(1), mmsg(7), regex(7) / re_format(7)

AUTHORS
     Leah Neukirchen <leah@vuxu.org>

LICENSE
     msed is in	the public domain.

     To	the extent possible under law, the creator of this work	has waived all
     copyright and related or neighboring rights to this work.

     http://creativecommons.org/publicdomain/zero/1.0/

FreeBSD	13.0			August 1, 2016			  FreeBSD 13.0

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | SEE ALSO | AUTHORS | LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=msed&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help