1gacutil(Mono 1.0)                                            gacutil(Mono 1.0)
2
3
4

NAME

6       gacutil - Global Assembly Cache management utility.
7

SYNOPSIS

9       gacutil [-user] [command] [options]
10

DESCRIPTION

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
16       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
21       The tool allows for installation, removal, and listing of the  contents
22       of the assembly cache.
23
24       The  GAC  is  relative  to  the  Mono  installation  prefix:  mono_pre‐
25       fix/lib/mono.
26

COMMANDS

28       -i  <assembly_path>  [-check_refs]  [-package  NAME]  [-root   ROOTDIR]
29       [-gacdir GACDIR]
30
31        Installs  an  assembly into the global assembly cache. <assembly_path>
32       is the name of the file that contains the assembly manifest
33
34       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
39       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
45       The  -gacdir  option  is included for backward compatibility but is not
46       recommended for new code. Use the -root option instead.
47
48       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
53       -l [assembly_name] [-root ROOTDIR] [-gacdir GACDIR]
54
55       Lists  the  contents  of  the  global  assembly cache. When the <assem‐
56       bly_name> parameter is specified only matching assemblies are listed.
57
58       -u <assembly_display_name> [-package  NAME]  [-root  ROOTDIR]  [-gacdir
59       GACDIR]
60
61       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
69       Notice that you can have spaces in the command line. There is  no  need
70       to quote them.
71
72       Performs  a  greedy  removal.  If  you only specify one component like,
73       "MyLibrary.Something", it will remove all versions of the library.
74
75       -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
83       -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

FILES

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
98       /etc/mono/config, ~/.mono/config
99
100       Mono  runtime  configuration  file.  See the mono-config(5) manual page
101       for more information.
102

WEB SITE

104       Visit: http://www.go-mono.com for details
105

SEE ALSO

107       mcs(1),mono(1)
108
109
110
111
112
113                                                             gacutil(Mono 1.0)
Impressum