DataMuseum.dk

top - metrics - download

    Length: 2251 (0x8cb)
    Types: TextFile
    Names: »aliases.tex«

└─⟦2d1937cfd⟧ Bits:30007241 EUUGD22: P.P 5.0
    └─⟦35176feda⟧ »EurOpenD22/isode/isode-6.tar.Z« 
        └─⟦de7628f85⟧ 
            └─⟦this⟧ »isode-6.0/doc/manual/aliases.tex« 

TextFile

% run this through LaTeX with the appropriate wrapper

\f

\chapter	{The ISO Aliases Database}\label{isoaliases}
The database \file{isoaliases} in the ISODE \verb"ETCDIR" directory
(usually \file{/usr/etc/})
contains a simple mapping between
user-friendly strings and distinguished names.
This database is used by the directory services element when accessing the
``higher performance'' nameservice described in Section~\ref{acsap:ns}.

The database itself is an ordinary ASCII text file containing an entry for
each locally defined alias.
Each entry contains
\begin{itemize}
\item	the alias, a simple string; and,

\item	the prefix of the corresponding distinguished name.
\end{itemize}
Blanks and/or tab characters are used to seperate items.
However, double-quotes may be used to prevent separation for items containing
embedded whitspace.
The sharp character (`\verb"#"') at the beginning of a line indicates a
commentary line.

\f

\section	{Accessing the Database}\label{isoalias}
The \man libacsap(3n) library contains the routines used to access the
database.
There is one high-level routine, \verb"alias2name"
which returns the prefix of the distinguished name which corresponds to an
alias in the database.
\begin{quote}\index{alias2name}\small\begin{verbatim}
char   *alias2name (name)
char   *name;
\end{verbatim}\end{quote}
The parameter to this procedure is:
\begin{describe}
\item[\verb"name":] the alias to lookup.
\end{describe}
This returns the manifest constant \verb"NULLCP" if the given alias is
not in the database.

In order to load specific aliases other than those read in the
\man isoaliases(5) file, use the routine \verb"add_alias":
\begin{quote}\index{add\_alias}\small\begin{verbatim}
int     add_alias (name, value)
char   *name,
       *value;
\end{verbatim}\end{quote}
The parameters to this procedure are:
\begin{describe}
\item[\verb"name":] the alias to enter; and,

\item[\verb"value":] its value.
\end{describe}
This returns the manifest constant \verb"NOTOK" if the given alias can not
be added.

\f

\section	{User-Specific Aliases}
By default a user-specific aliases database is consulted before the
system-wide aliases file.
The user-specific file is called \file{\$HOME/.isode\_aliases} in the user's
home directory.