Print this page
9097 typos in makemap(1M)/editmap(1M)
*** 21,31 ****
.\" (iii) Neither the name of the University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. 6. Disclaimer/Limitation of Liability: THIS SOFTWARE IS PROVIDED BY SENDMAIL,
.\" INC. AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SENDMAIL, INC., THE REGENTS OF THE UNIVERSITY OF CALIFORNIA OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
.\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved.
! .TH EDITMAP 1M "Sep 14, 2001"
.SH NAME
editmap \- query and edit single records in database maps for sendmail
.SH SYNOPSIS
.LP
.nf
--- 21,32 ----
.\" (iii) Neither the name of the University nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. 6. Disclaimer/Limitation of Liability: THIS SOFTWARE IS PROVIDED BY SENDMAIL,
.\" INC. AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SENDMAIL, INC., THE REGENTS OF THE UNIVERSITY OF CALIFORNIA OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
.\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
.\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved.
! .\" Copyright (c) 2019 Peter Tribble.
! .TH EDITMAP 1M "Jan 21, 2019"
.SH NAME
editmap \- query and edit single records in database maps for sendmail
.SH SYNOPSIS
.LP
.nf
*** 32,42 ****
\fBeditmap\fR \fB-C\fR \fIfile\fR [\fB-N\fR] [\fB-f\fR] [\fB-q\fR | \fB-u\fR | \fB-x\fR] \fImaptype\fR \fImapname\fR \fIkey\fR
["\fIvalue\fR"]...
.fi
.SH DESCRIPTION
- .sp
.LP
The \fBeditmap\fR command queries or edits one record in a database maps used
by the keyed map lookups in \fBsendmail\fR(1M). Arguments are passed on the
command line and output (for queries) is directed to standard output.
.sp
--- 33,42 ----
*** 44,95 ****
Depending on how it is compiled, \fBeditmap\fR handles up to three different
database formats, selected using the \fImaptype\fR parameter. See
\fBOPERANDS\fR.
.sp
.LP
! If the \fBTrustedUser\fR option is set in the \fBsendmail\fR configuration
file and \fBeditmap\fR is invoked as root, the generated files are owned by the
specified \fBTrustedUser\fR.
.SH OPTIONS
- .sp
.LP
The following options are supported:
.sp
.ne 2
.na
! \fB\fB-C\fR \fIfile\fR\fR
.ad
.RS 11n
Use the specified \fBsendmail\fR configuration file (\fIfile\fR) to look up the
\fBTrustedUser\fR option.
.RE
.sp
.ne 2
.na
! \fB\fB-f\fR\fR
.ad
.RS 11n
Disable the folding of all upper case letters in the key to lower case.
! Normally, all upper case letters in the key are folded to upper case. This is
intended to mesh with the \fB-f\fR flag in the \fBK\fR line in
\fBsendmail.cf\fR. The value is never case folded.
.RE
.sp
.ne 2
.na
! \fB\fB-N\fR\fR
.ad
.RS 11n
! Include the null byte that terminates strings in the map (for alias maps).
.RE
.sp
.ne 2
.na
! \fB\fB-q\fR\fR
.ad
.RS 11n
Query the map for the specified key. If found, print value to standard output
and exit with \fB0\fR. If not found then print an error message to \fBstdout\fR
and exit with \fBEX_UNAVAILABLE\fR.
--- 44,94 ----
Depending on how it is compiled, \fBeditmap\fR handles up to three different
database formats, selected using the \fImaptype\fR parameter. See
\fBOPERANDS\fR.
.sp
.LP
! If the \fBTrustedUser\fR option is set in the \fBsendmail\fR configuration
file and \fBeditmap\fR is invoked as root, the generated files are owned by the
specified \fBTrustedUser\fR.
.SH OPTIONS
.LP
The following options are supported:
.sp
.ne 2
.na
! \fB-C\fR \fIfile\fR
.ad
.RS 11n
Use the specified \fBsendmail\fR configuration file (\fIfile\fR) to look up the
\fBTrustedUser\fR option.
.RE
.sp
.ne 2
.na
! \fB-f\fR
.ad
.RS 11n
Disable the folding of all upper case letters in the key to lower case.
! Normally, all upper case letters in the key are folded to lower case. This is
intended to mesh with the \fB-f\fR flag in the \fBK\fR line in
\fBsendmail.cf\fR. The value is never case folded.
.RE
.sp
.ne 2
.na
! \fB-N\fR
.ad
.RS 11n
! Include the null byte that terminates strings in the map (for alias maps).
.RE
.sp
.ne 2
.na
! \fB-q\fR
.ad
.RS 11n
Query the map for the specified key. If found, print value to standard output
and exit with \fB0\fR. If not found then print an error message to \fBstdout\fR
and exit with \fBEX_UNAVAILABLE\fR.
*** 96,130 ****
.RE
.sp
.ne 2
.na
! \fB\fB-u\fR\fR
.ad
.RS 11n
! Update the record for key with value or inserts a new record if one doesn't
! exist. Exits with \fB0\fR on success or \fBEX_IOERR\fR on failure.
.RE
.sp
.ne 2
.na
! \fB\fB-x\fR\fR
.ad
.RS 11n
! Delete the specific key from the map. Exit with \fB0\fR on success or
\fBEX_IOERR\fR on failure.
.RE
.SH OPERANDS
- .sp
.LP
The following operands are supported:
.sp
.ne 2
.na
! \fB\fIkey\fR\fR
.ad
.RS 12n
The left hand side of a record.
.sp
Each record is of the form:
--- 95,129 ----
.RE
.sp
.ne 2
.na
! \fB-u\fR
.ad
.RS 11n
! Update the record for the specified key with the specified value or inserts a
! new record if one doesn't exist. Exits with \fB0\fR on success or
! \fBEX_IOERR\fR on failure.
.RE
.sp
.ne 2
.na
! \fB-x\fR
.ad
.RS 11n
! Delete the specified key from the map. Exits with \fB0\fR on success or
\fBEX_IOERR\fR on failure.
.RE
.SH OPERANDS
.LP
The following operands are supported:
.sp
.ne 2
.na
! \fIkey\fR
.ad
.RS 12n
The left hand side of a record.
.sp
Each record is of the form:
*** 140,185 ****
.RE
.sp
.ne 2
.na
! \fB\fImapname\fR \fR
.ad
.RS 12n
File name of the database map being created.
.RE
.sp
.ne 2
.na
! \fB\fImaptype\fR \fR
.ad
.RS 12n
Specifies the database format. The following \fImaptype\fR parameters are
available:
.sp
.ne 2
.na
! \fB\fBdbm\fR \fR
.ad
.RS 10n
Specifies \fBDBM\fR format maps.
.RE
.sp
.ne 2
.na
! \fB\fBbtree\fR \fR
.ad
.RS 10n
Specifies B-Tree format maps.
.RE
.sp
.ne 2
.na
! \fB\fBhash\fR \fR
.ad
.RS 10n
Specifies hash format maps.
.RE
--- 139,184 ----
.RE
.sp
.ne 2
.na
! \fImapname\fR
.ad
.RS 12n
File name of the database map being created.
.RE
.sp
.ne 2
.na
! \fImaptype\fR
.ad
.RS 12n
Specifies the database format. The following \fImaptype\fR parameters are
available:
.sp
.ne 2
.na
! \fBdbm\fR
.ad
.RS 10n
Specifies \fBDBM\fR format maps.
.RE
.sp
.ne 2
.na
! \fBbtree\fR
.ad
.RS 10n
Specifies B-Tree format maps.
.RE
.sp
.ne 2
.na
! \fBhash\fR
.ad
.RS 10n
Specifies hash format maps.
.RE
*** 186,196 ****
.RE
.sp
.ne 2
.na
! \fB\fIvalue\fR\fR
.ad
.RS 12n
The right hand side of a record.
.sp
Each record is of the form:
--- 185,195 ----
.RE
.sp
.ne 2
.na
! \fIvalue\fR
.ad
.RS 12n
The right hand side of a record.
.sp
Each record is of the form:
*** 204,211 ****
\fIkey\fR and \fIvalue\fR are separated by white space.
.RE
.SH SEE ALSO
- .sp
.LP
\fBmakemap\fR(1M), \fBsendmail\fR(1M), \fBattributes\fR(5)
--- 203,209 ----