Mono(gacutil) Mono(gacutil)
NAME
gacutil - Global Assembly Cache management utility.
SYNOPSIS
gacutil [-user] [command] [options]
DESCRIPTION
gacutil is a tool used by developers to install versioned assemblies
into the system Global Assembly Cache (GAC) to become part of the as-
semblies that are available for all applications at runtime.
Notice that they are not directly available to the compiler. The con-
vention is that assemblies must also be placed in a separate directory
to be accessed by the compiler. This is done with the -package direc-
tive to gacutil.
The tool allows for installation, removal, and listing of the contents
of the assembly cache.
The GAC is relative to the Mono installation prefix: mono_pre-
fix/lib/mono.
COMMANDS
-i <assembly_path> [-check_refs] [-package NAME] [-root ROOTDIR]
[-gacdir GACDIR]
Installs an assembly into the global assembly cache. <assembly_path>
is the name of the file that contains the assembly manifest
The -package option can be used to also create a directory in in pre-
fix/lib/mono with the name NAME, and a symlink is created from NAME/as-
sembly_name to the assembly on the GAC. This is used so developers can
reference a set of libraries at once.
The -root option is used to specify the "libdir" value of an installa-
tion prefix which differs from the prefix of the system GAC. Typical
automake usage is "-root $(DESTDIR)$(prefix)/lib". To access assem-
blies installed to a prefix other than the mono prefix, it is necessary
to set the MONO_GAC_PREFIX environment variable.
The -gacdir option is included for backward compatibility but is not
recommended for new code. Use the -root option instead.
The -check_refs option is used to ensure that the assembly being in-
stalled into the GAC does not reference any non strong named assem-
blies. Assemblies being installed to the GAC should not reference non
strong named assemblies, however the is an optional check.
-l [assembly_name] [-root ROOTDIR] [-gacdir GACDIR]
Lists the contents of the global assembly cache. When the <assem-
bly_name> parameter is specified only matching assemblies are listed.
-u <assembly_display_name> [-package NAME] [-root ROOTDIR] [-gacdir
GACDIR]
Uninstalls an assembly from the global assembly cache. <assembly_dis-
play_name> is the name of the assembly (partial or fully qualified) to
remove from the global assembly cache. If a partial name is specified
all matching assemblies will be uninstalled. As opposed to the install
option that takes a filename, this takes as an argument the assembly
name, which looks like this:
MyLibrary.Something, version=1.0.0.0, publicKeyToken=xxxx,culture=neutral
Notice that you can have spaces in the command line. There is no need
to quote them.
Performs a greedy removal. If you only specify one component like,
"MyLibrary.Something", it will remove all versions of the library.
-us <assembly_path> [-package NAME] [-root ROOTDIR] [-gacdir GACDIR]
Uninstalls an assembly using the specified assembly's full name. <as-
sembly path> is the path to an assembly. The full assembly name is re-
trieved from the specified assembly if there is an assembly in the GAC
with a matching name, it is removed. Unlike the -u option this option
takes a file name, like this:
Example: -us myDll.dll
-ul <assembly_list_file> [-package NAME] [-root ROOTDIR] [-gacdir
GACDIR] Uninstalls one or more assemblies from the global assembly
cache. <assembly_list_file> is the path to a test file containing a
list of assembly names on separate lines.
Example -ul assembly_list.txt
assembly_list.txt contents:
assembly1,Version=1.0.0.0,Culture=en,PublicKeyToken=0123456789abcdef
assembly2,Version=2.0.0.0,Culture=en,PublicKeyToken=0123456789abcdef
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.
/etc/mono/config, ~/.mono/config
Mono runtime configuration file. See the mono-config(5) manual page
for more information.
WEB SITE
Visit: http://www.go-mono.com for details
SEE ALSO
mcs(1),mono(1)
Mono(gacutil)
Generated by dwww version 1.15 on Sat Jun 29 02:05:33 CEST 2024.