gacutil(1)

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
   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.

   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_prefix/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
   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.

   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.

   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
   assemblies. 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
   <assembly_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_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:
        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.
   <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:
           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)

                                                         gacutil(Mono 1.0)

---

More Linux Commands

---