1Mono(gacutil) Mono(gacutil)
2
6 gacutil - Global Assembly Cache management utility.
7
9 gacutil [-user] [command] [options]
10
12 gacutil is a tool used by developers to install versioned assemblies
13 into the system Global Assembly Cache (GAC) to become part of the
14 assemblies that are available for all applications at runtime.
15 Notice that they are not directly available to the compiler. The con‐
17 vention is that assemblies must also be placed in a separate directory
18 to be accessed by the compiler. This is done with the -package direc‐
19 tive to gacutil.
20 The tool allows for installation, removal, and listing of the contents
22 of the assembly cache.
23 The GAC is relative to the Mono installation prefix: mono_pre‐
25 fix/lib/mono.
26
28 -i <assembly_path> [-check_refs] [-package NAME] [-root ROOTDIR]
29 [-gacdir GACDIR]
30 Installs an assembly into the global assembly cache. <assembly_path>
32 is the name of the file that contains the assembly manifest
33 The -package option can be used to also create a directory in in pre‐
35 fix/lib/mono with the name NAME, and a symlink is created from
36 NAME/assembly_name to the assembly on the GAC. This is used so devel‐
37 opers can reference a set of libraries at once.
38 The -root option is used to specify the "libdir" value of an installa‐
40 tion prefix which differs from the prefix of the system GAC. Typical
41 automake usage is "-root $(DESTDIR)$(prefix)/lib". To access assem‐
42 blies installed to a prefix other than the mono prefix, it is necessary
43 to set the MONO_GAC_PREFIX environment variable.
44 The -gacdir option is included for backward compatibility but is not
46 recommended for new code. Use the -root option instead.
47 The -check_refs option is used to ensure that the assembly being
49 installed into the GAC does not reference any non strong named assem‐
50 blies. Assemblies being installed to the GAC should not reference non
51 strong named assemblies, however the is an optional check.
52 -l [assembly_name] [-root ROOTDIR] [-gacdir GACDIR]
54 Lists the contents of the global assembly cache. When the <assem‐
56 bly_name> parameter is specified only matching assemblies are listed.
57 -u <assembly_display_name> [-package NAME] [-root ROOTDIR] [-gacdir
59 GACDIR]
60 Uninstalls an assembly from the global assembly cache. <assembly_dis‐
62 play_name> is the name of the assembly (partial or fully qualified) to
63 remove from the global assembly cache. If a partial name is specified
64 all matching assemblies will be uninstalled. As opposed to the install
65 option that takes a filename, this takes as an argument the assembly
66 name, which looks like this:
67 MyLibrary.Something, version=1.0.0.0, publicKeyToken=xxxx,culture=neutral
68 Notice that you can have spaces in the command line. There is no need
70 to quote them.
71 Performs a greedy removal. If you only specify one component like,
73 "MyLibrary.Something", it will remove all versions of the library.
74 -us <assembly_path> [-package NAME] [-root ROOTDIR] [-gacdir GACDIR]
76 Uninstalls an assembly using the specified assembly's full name.
77 <assembly path> is the path to an assembly. The full assembly name is
78 retrieved from the specified assembly if there is an assembly in the
79 GAC with a matching name, it is removed. Unlike the -u option this
80 option takes a file name, like this:
81 Example: -us myDll.dll
82 -ul <assembly_list_file> [-package NAME] [-root ROOTDIR] [-gacdir
84 GACDIR] Uninstalls one or more assemblies from the global assembly
85 cache. <assembly_list_file> is the path to a test file containing a
86 list of assembly names on separate lines.
87 Example -ul assembly_list.txt
88 assembly_list.txt contents:
89 assembly1,Version=1.0.0.0,Culture=en,PublicKeyToken=0123456789abcdef
90 assembly2,Version=2.0.0.0,Culture=en,PublicKeyToken=0123456789abcdef
91
93 On Unix assemblies are loaded from the installation lib directory. If
94 you set `prefix' to /usr, the assemblies will be located in /usr/lib.
95 On Windows, the assemblies are loaded from the directory where mono and
96 mint live.
97 /etc/mono/config, ~/.mono/config
99 Mono runtime configuration file. See the mono-config(5) manual page
101 for more information.
102
104 Visit: http://www.go-mono.com for details
105
107 mcs(1),[22mmono(1)
108 Mono(gacutil)