2004-05-03 22:11:11 +04:00
|
|
|
..\"
|
|
|
|
|
.\" gacutil manual page.
|
|
|
|
|
.\" (C) 2004 Novell, Inc.
|
|
|
|
|
.\" Author:
|
|
|
|
|
.\" Miguel de Icaza (miguel@gnu.org)
|
|
|
|
|
.\"
|
|
|
|
|
.de Sp \" Vertical space (when we can't use .PP)
|
|
|
|
|
.if t .sp .5v
|
|
|
|
|
.if n .sp
|
|
|
|
|
..
|
|
|
|
|
.TH gacutil "Mono 1.0"
|
2004-05-03 22:06:25 +04:00
|
|
|
.SH NAME
|
2004-05-03 22:11:11 +04:00
|
|
|
gacutil \- Global Asssembly Cache management utility.
|
2004-05-03 22:06:25 +04:00
|
|
|
.SH SYNOPSIS
|
2004-05-03 22:11:11 +04:00
|
|
|
.PP
|
|
|
|
|
.B gacutil [-user] [command] [options]
|
2004-05-03 22:06:25 +04:00
|
|
|
.SH DESCRIPTION
|
2004-05-03 22:11:11 +04:00
|
|
|
\fIgacutil\fP is a tool used by developers to install assemblies into
|
|
|
|
|
the system Global Assembly Cache (GAC) to become part of the
|
|
|
|
|
assemblies that are available for all applications at runtime.
|
|
|
|
|
.PP
|
|
|
|
|
Notice that they are not directly available to the compiler, the
|
|
|
|
|
convention is that assemblies must also be placed in a separate
|
|
|
|
|
directory for being accessed to the compiler. This is done with the
|
|
|
|
|
-package directive to gacutil.
|
|
|
|
|
.PP
|
|
|
|
|
The tool allows for installationl, removal, and listing of the
|
|
|
|
|
contents of the assembly cache.
|
|
|
|
|
.PP
|
|
|
|
|
The GAC is relative to the Mono installation prefix:
|
|
|
|
|
mono_prefix/lib/mono.
|
|
|
|
|
.SH FLAGS
|
|
|
|
|
The "-user" flag enables you to install/remove the assembly into the
|
|
|
|
|
user's assembly cache, as opposed to the global one.
|
|
|
|
|
.PP
|
|
|
|
|
.SH COMMANDS
|
|
|
|
|
.I "-i path_to_assembly" [-f] [-root ROOTDIR] [-package NAME]
|
|
|
|
|
.Sp
|
|
|
|
|
The above installs the assembly into the GAC, use the -f flag to force
|
|
|
|
|
an installation an overwrite anything in there.
|
|
|
|
|
.Sp
|
|
|
|
|
The -package option can be used to also create a directory in in
|
|
|
|
|
prefix/lib/mono with the name NAME, and a symlink is created from
|
|
|
|
|
NAME/assembly_name to the assembly on the GAC. This is used so
|
|
|
|
|
developers can reference a set of libraries at once.
|
|
|
|
|
.Sp
|
|
|
|
|
The -root option is used by developers integrating this with automake
|
|
|
|
|
tools or packaging tools that require a prefix directory to be
|
|
|
|
|
specified. The root represents the "libdir" component of a prefix
|
|
|
|
|
(typically prefix/lib).
|
|
|
|
|
.fi
|
|
|
|
|
.PP
|
|
|
|
|
.I "-l"
|
|
|
|
|
.Sp
|
|
|
|
|
Lists the contents of the Global Assembly Cache
|
|
|
|
|
.PP
|
|
|
|
|
.I "-u assembly_name [-root]"
|
|
|
|
|
.Sp
|
|
|
|
|
The above removes the given assembly name from the Global Assembly
|
|
|
|
|
Cache. As opposed to the install option that takes a filename, this
|
|
|
|
|
takes as an argument the assembly name, which looks like this:
|
|
|
|
|
.nf
|
|
|
|
|
MyLibrary.Something, version=1.0.0.0, publicKeyToken=xxxx,culture=neutral
|
|
|
|
|
.fi
|
|
|
|
|
.Sp
|
|
|
|
|
Notice that you can have spaces in the command line, there is no need
|
|
|
|
|
to quote them.
|
|
|
|
|
.Sp
|
|
|
|
|
The removal performs a greedy removal, if you only specifiy one
|
|
|
|
|
component like, "MyLibrary.Something", it will remove all versions of
|
|
|
|
|
the library.
|
|
|
|
|
.SH FILES
|
|
|
|
|
On Unix assemblies are loaded from the installation lib directory. If you set
|
|
|
|
|
`prefix' to /usr, the assemblies will be located in /usr/lib. On
|
|
|
|
|
Windows, the assemblies are loaded from the directory where mono and
|
|
|
|
|
mint live.
|
|
|
|
|
.PP
|
|
|
|
|
/etc/mono/config, ~/.mono/config
|
|
|
|
|
.PP
|
|
|
|
|
Mono runtime configuration file. See the mono-config(5) manual page
|
|
|
|
|
for more information.
|
|
|
|
|
.SH WEB SITE
|
|
|
|
|
Visit: http://www.go-mono.com for details
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
.BR mcs(1), mono(1)
|
|
|
|
|
|
|
|
|
|
|
