diff options
Diffstat (limited to 'makemap/makemap.0')
| -rw-r--r-- | makemap/makemap.0 | 88 |
1 files changed, 50 insertions, 38 deletions
diff --git a/makemap/makemap.0 b/makemap/makemap.0 index 73d6ef09a37e..61f4d6f868dc 100644 --- a/makemap/makemap.0 +++ b/makemap/makemap.0 @@ -2,20 +2,20 @@ MAKEMAP(8) MAKEMAP(8) -NNAAMMEE +[1mNAME[0m makemap - create database maps for sendmail -SSYYNNOOPPSSIISS - mmaakkeemmaapp [--CC _f_i_l_e] [--NN] [--cc _c_a_c_h_e_s_i_z_e] [--dd] [--DD _c_o_m_m_e_n_t_c_h_a_r] [--ee] [--ff] - [--ll] [--oo] [--rr] [--ss] [--tt _d_e_l_i_m] [--uu] [--vv] _m_a_p_t_y_p_e _m_a_p_n_a_m +[1mSYNOPSIS[0m + [1mmakemap [22m[[1m-C [4m[22mfile[24m] [[1m-N[22m] [[1m-c [4m[22mcachesize[24m] [[1m-d[22m] [[1m-D [4m[22mcommentchar[24m] [[1m-e[22m] [[1m-f[22m] + [[1m-l[22m] [[1m-o[22m] [[1m-r[22m] [[1m-s[22m] [[1m-t [4m[22mdelim[24m] [[1m-u[22m] [[1m-v[22m] [4mmaptype[24m [4mmapnam[0m -DDEESSCCRRIIPPTTIIOONN - MMaakkeemmaapp creates the database maps used by the keyed map lookups in +[1mDESCRIPTION[0m + [1mMakemap [22mcreates the database maps used by the keyed map lookups in sendmail(8). It reads input from the standard input and outputs them - to the indicated _m_a_p_n_a_m_e_. + to the indicated [4mmapname.[0m - Depending on how it is compiled, mmaakkeemmaapp handles up to three different - database formats, selected using the _m_a_p_t_y_p_e parameter. They may be + Depending on how it is compiled, [1mmakemap [22mhandles different database + formats, selected using the [4mmaptype[24m parameter. They may be dbm DBM format maps. This requires the ndbm(3) library. @@ -23,67 +23,79 @@ DDEESSCCRRIIPPTTIIOONN hash Hash format maps. This also requires the Berkeley DB library. - In all cases, mmaakkeemmaapp reads lines from the standard input consisting of + cdb CDB (Constant DataBase) format maps. This requires the tinycdb + library. + + implicit + The first available format in the following order: hash, dbm, + and cdb. + + In all cases, [1mmakemap [22mreads lines from the standard input consisting of two words separated by white space. The first is the database key, the - second is the value. The value may contain ``%_n'' strings to indicate + second is the value. The value may contain ``%[4mn[24m'' strings to indicate parameter substitution. Literal percents should be doubled (``%%''). Blank lines and lines beginning with ``#'' are ignored. - Notice: do nnoott use mmaakkeemmaapp to create the aliases data base, but - nneewwaalliiaasseess which puts a special token into the data base that is - required by sseennddmmaaiill.. + Notice: do [1mnot [22muse [1mmakemap [22mto create the aliases data base, but + [1mnewaliases [22mwhich puts a special token into the data base that is + required by [1msendmail.[0m - If the _T_r_u_s_t_e_d_U_s_e_r option is set in the sendmail configuration file and - mmaakkeemmaapp is invoked as root, the generated files will be owned by the - specified _T_r_u_s_t_e_d_U_s_e_r_. + If the [4mTrustedUser[24m option is set in the sendmail configuration file and + [1mmakemap [22mis invoked as root, the generated files will be owned by the + specified [4mTrustedUser.[0m - FFllaaggss - --CC Use the specified sseennddmmaaiill configuration file for looking up the + [1mFlags[0m + [1m-C [22mUse the specified [1msendmail [22mconfiguration file for looking up the TrustedUser option. - --NN Include the null byte that terminates strings in the map. This + [1m-N [22mInclude the null byte that terminates strings in the map. This must match the -N flag in the sendmail.cf ``K'' line. - --cc Use the specified hash and B-Tree cache size. + [1m-c [22mUse the specified hash and B-Tree cache size. - --DD Use to specify the character to use to indicate a comment (which + [1m-D [22mUse to specify the character to use to indicate a comment (which is ignored) instead of the default of '#'. - --dd Allow duplicate keys in the map. This is only allowed on B-Tree + [1m-d [22mAllow duplicate keys in the map. This is only allowed on B-Tree format maps. If two identical keys are read, they will both be inserted into the map. - --ee Allow empty value (right hand side). + [1m-e [22mAllow empty value (right hand side). - --ff Normally all upper case letters in the key are folded to lower + [1m-f [22mNormally all upper case letters in the key are folded to lower case. This flag disables that behaviour. This is intended to - mesh with the -f flag in the KK line in sendmail.cf. The value + mesh with the -f flag in the [1mK [22mline in sendmail.cf. The value is never case folded. - --ll List supported map types. + [1m-l [22mList supported map types. - --oo Append to an old file. This allows you to augment an existing - file. + [1m-o [22mAppend to an old file. This allows you to augment an existing + file. Note: this might not be supported by all database types, + e.g., cdb. - --rr Allow replacement of existing keys. Normally mmaakkeemmaapp complains + [1m-r [22mAllow replacement of existing keys. Normally [1mmakemap [22mcomplains if you repeat a key, and does not do the insert. - --ss Ignore safety checks on maps being created. This includes - checking for hard or symbolic links in world writable directo- + [1m-s [22mIgnore safety checks on maps being created. This includes + checking for hard or symbolic links in world writable directo- ries. - --tt Use the specified delimiter instead of white space (also for + [1m-t [22mUse the specified delimiter instead of white space (also for dumping a map). - --uu dump (unmap) the content of the database to standard output. + [1m-u [22mdump (unmap) the content of the database to standard output. + + [1m-v [22mVerbosely print what it is doing. + - --vv Verbosely print what it is doing. +[1mExample[0m + makemap hash /etc/mail/access < /etc/mail/access -SSEEEE AALLSSOO +[1mSEE ALSO[0m sendmail(8), newaliases(1) -HHIISSTTOORRYY - The mmaakkeemmaapp command appeared in 4.4BSD. +[1mHISTORY[0m + The [1mmakemap [22mcommand appeared in 4.4BSD. |