1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
.\"
.\" 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 0.5v
.if n .sp
..
.TH Mono "gacutil"
.SH NAME
gacutil \- Global Assembly Cache management utility.
.SH SYNOPSIS
.B gacutil
.RI [ \-user "] [" command "] [" options ]
.SH DESCRIPTION
\fIgacutil\fP is a tool used by developers to install versioned
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 to be accessed by the compiler. This is done with the
\-package directive to gacutil.
.PP
The tool allows for installation, 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 COMMANDS
.\".I \-i <assembly_path> [\-check_refs] [\-package NAME] [\-root ROOTDIR] [\-gacdir GACDIR]
.B \-i
.I <assembly_path>
.RB [ \-check_refs "] [" \-package
.IR NAME ]
.RB [ \-root
.IR ROOTDIR ]
.RB [ \-gacdir
.IR GACDIR ]
.Sp
Installs an assembly into the global assembly cache.
<assembly_path> is the name of the file that contains the assembly manifest
.Sp
The \-package option can be used to also create a directory 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 to specify the "libdir" value of an installation
prefix which differs from the prefix of the system GAC.
Typical automake usage is "\-root $(DESTDIR)$(prefix)/lib".
To access assemblies installed to a prefix other than the mono prefix,
it is necessary to set the MONO_GAC_PREFIX environment variable.
.Sp
The \-gacdir option is included for backward compatibility but is not
recommended for new code.
Use the \-root option instead.
.Sp
The \-check_refs option is used to ensure that the assembly being
installed into the GAC does not reference any non strong named
assemblies.
Assemblies being installed to the GAC should not reference
non strong named assemblies, however the is an optional check.
.PP
.\".I "\-l" [assembly_name] [\-root ROOTDIR] [\-gacdir GACDIR]
.br
.B \-l
.RI [ assembly_name ]
.RB [ \-root
.IR ROOTDIR ]
.RB [ \-gacdir
.IR GACDIR ]
.Sp
Lists the contents of the global assembly cache.
When the <assembly_name> parameter is specified only matching assemblies are
listed.
.PP
.\".I "\-u" <assembly_display_name> [\-package NAME] [\-root ROOTDIR] [\-gacdir GACDIR]
.B \-u
.I <assembly_display_name>
.RB [ \-package
.IR NAME ]
.RB [ \-root
.IR ROOTDIR ]
.RB [ \-gacdir
.IR GACDIR ]
.Sp
Uninstalls an assembly from the global assembly cache.
<assembly_display_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:
.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
Performs a greedy removal.
If you only specify one component like,
"MyLibrary.Something",
it will remove all versions of the library.
.Sp
.\".I "\-us" <assembly_path> [\-package NAME] [\-root ROOTDIR] [\-gacdir GACDIR]
.B \-us
.I <assembly_path>
.RB [ \-package
.IR NAME ]
.RB [ \-root
.IR ROOTDIR ]
.RB [ \-gacdir
.IR GACDIR ]
.Sp
Uninstalls an assembly using the specified assembly's full name.
<assembly path> is the path to an assembly.
The full assembly name
is retrieved 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:
.nf
Example: \-us myDll.dll
.fi
.Sp
.\".I "\-ul" <assembly_list_file> [\-package NAME] [\-root ROOTDIR] [\-gacdir GACDIR]
.B \-ul
.I <assembly_list_file>
.RB [ \-package
.IR NAME ]
.RB [ \-root
.IR ROOTDIR ]
.RB [ \-gacdir
.IR GACDIR ]
.Sp
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.
.nf
Example \-ul assembly_list.txt
.fi
.nf
assembly_list.txt contents:
assembly1,Version=1.0.0.0,Culture=en,PublicKeyToken=0123456789abcdef
assembly2,Version=2.0.0.0,Culture=en,PublicKeyToken=0123456789abcdef
.fi
.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
.BR 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)
|
