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

FreeBSD Manual Pages

  
 
  

home | help
MSED(1)			    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
       headers,	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
	       contains	the letter `i'.

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

SEE ALSO
       sed(1), mhdr(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	Ports 14.quarterly	August 1, 2016			       MSED(1)

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

home | help