\Header{library.dynam}{Loading Shared Libraries}
\alias{.Dyn.libs}{library.dynam}
\keyword{data}{library.dynam}
\begin{Usage}
\begin{verbatim}
library.dynam(chname, package = .packages(), lib.loc = .lib.loc)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\texttt{chname}] a character string naming a shared library to load.
\item[\texttt{package}] a character vector with the names of packages to search
through.
\item[\texttt{lib.loc}] a character vector describing the location of \R
library trees to search through.
\end{ldescription}
\end{Arguments}
\begin{Description}
\texttt{library.dynam} loads the specified (shared) object file if it
has not been loaded already.	It is designed to be used inside a
package rather than at the command line, and should really only be
used inside \texttt{\Link{.First.lib}()}.  The system-specific extension
for shared libraries (e.g., ``\file{.so}'' on Unix systems) should not
be added.\end{Description}
\begin{Value}
The \texttt{.Dyn.libs} vector with the names of packages
which have used \texttt{library.dynam(..)} in the current \R\ session.

It is returned as \texttt{\Link{invisible}}, unless the \texttt{chname}
argument is missing.

Users should never set \texttt{.Dyn.libs} directly.\end{Value}
\begin{SeeAlso}
\texttt{\Link{.First.lib}}, \texttt{\Link{library}},
\texttt{\Link{dyn.load}}, \texttt{\Link{.packages}},
\texttt{\Link{.lib.loc}}\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}
library.dynam()# which packages have been ``dynamically loaded''
\end{ExampleCode}
\end{Examples}

