NAME
rsub
—
substitute lines or block of
text
SYNOPSIS
rsub |
[-A ] -r
line_regex -l
line_text target |
rsub |
target < block_content |
DESCRIPTION
rsub
is shipped to remote machines by
rset(1) to provide a standard method of modifying
configuration parameters within a file. Two modes of operation are
supported: line substitution and block replacement.
Single line replacements are defined by the flags
-r
and -l
, while the content
for a text block is provided on STDIN.
The arguments for line substitution are as follows:
-A
- Append line if the pattern is not found.
-r
- A regular expression matching the line to replace.
-l
- The replacement text for a matching line. Newlines are not permitted as part of the replacement string.
ENVIRONMENT
When updating a block of text, RSUB_START
and RSUB_END
define the beginning and ending
markers.
EXIT STATUS
The rsub
utility exits with one of the
following values:
EXAMPLES
Ensure a single configuration parameter is set
$SD/rsub -r '^AllowTcpForwarding .+' -l 'AllowTcpForwarding yes' \ /etc/ssh/sshd_config
Update a managed block of text
$SD/rsub /etc/fstab <<-CONF /dev/ada0p1 /vm ufs rw 0 0
CONF