gacutil2

gacutil(Mono 1.0)                                            gacutil(Mono 1.0)



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
       assemblies 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    [-check_refs]  [-package  NAME]  [-root   ROOTDIR]
       [-gacdir GACDIR]

        Installs  an  assembly into the global assembly cache. 
       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/assembly_name to the assembly on the GAC.  This is used so  devel‐
       opers 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
       installed  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        bly_name> parameter is specified only matching assemblies are listed.

       -u  [-package  NAME]  [-root  ROOTDIR]  [-gacdir
       GACDIR]

       Uninstalls  an assembly from the global assembly cache.         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  [-package NAME] [-root  ROOTDIR]  [-gacdir  GACDIR]
       Uninstalls  an  assembly  using  the  specified  assembly's  full name.
        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:
               Example: -us myDll.dll

       -ul    [-package  NAME]  [-root  ROOTDIR]  [-gacdir
       GACDIR] Uninstalls one or more  assemblies  from  the  global  assembly
       cache.     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)





                                                             gacutil(Mono 1.0)