mirror of
https://github.com/SSCLI/sscli_20021101
synced 2026-06-08 12:28:57 +00:00
yallie
171 lines
4.8 KiB
HTML
171 lines
4.8 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<TITLE>Global Assembly Cache Tool (gacutil.exe)</TITLE>
|
|
<link rel="stylesheet" type="text/css" href="../rotor.css">
|
|
</head>
|
|
<body>
|
|
<H1>Global Assembly Cache Tool (gacutil.exe/gacutil)</H1>
|
|
|
|
<P>The Global Assembly Cache tool allows you to view and manipulate the contents
|
|
of the global assembly cache. </P>
|
|
|
|
<P>This application file is named gacutil.exe on a Shared Source
|
|
CLI (SSCLI)
|
|
built on Microsoft Windows®. It is named gacutil on UNIX system-based platforms.</P>
|
|
|
|
<P> Note: the SSCLI implementation of the gacutil tool does not
|
|
support code download or precompiled JIT.
|
|
</P>
|
|
|
|
<P> The following options of the gacutil tool supported on the Microsoft® .NET Framework
|
|
implementation were removed from the SSCLI:</P>
|
|
|
|
<ul>
|
|
<li><b>/cdl</b> <ul>
|
|
<li>Deletes the contents of the download cache.</li>
|
|
</ul>
|
|
|
|
</li>
|
|
<li><b>/help</b>
|
|
|
|
<ul>
|
|
<li>Sends usage output to the console. Use <b>/?</b> instead.</li>
|
|
</ul>
|
|
|
|
</li>
|
|
<li><b>/if </b> <ul>
|
|
<li>Installs an assembly to the global assembly cache and forces
|
|
overwrite if the assembly already exists in cache. </li>
|
|
</ul>
|
|
|
|
</li>
|
|
<li><b>/ir</b> <ul>
|
|
<li>Installs an assembly to the global assembly cache with traced
|
|
reference. </li>
|
|
</ul>
|
|
|
|
</li>
|
|
<li><b>/ldl</b> <ul>
|
|
<li>Lists the contents of the downloaded files cache.</li>
|
|
</ul>
|
|
|
|
</li>
|
|
<li><b>/lr</b> <ul>
|
|
<li>Lists the contents of
|
|
the global assembly cache with traced reference information.</li>
|
|
</ul>
|
|
|
|
</li>
|
|
<li><b>/ungen</b>
|
|
|
|
<ul>
|
|
<li>If ngen is specified, the assembly is removed from the
|
|
cache of native image files.</li>
|
|
</ul>
|
|
|
|
</li>
|
|
</ul>
|
|
|
|
<p>The following options are supported by the SSCLI implementation of the Global
|
|
Assembly Cache tool.</p>
|
|
|
|
<h4>Usage</h4>
|
|
|
|
<blockquote>
|
|
|
|
<PRE class="syntax"><B>gacutil</B> [<I>options</I>] [<I>assembly</I>]</PRE>
|
|
</blockquote>
|
|
|
|
<table border=1 width="90%">
|
|
|
|
<TR VALIGN="top">
|
|
<TH width=25%>Argument</TH>
|
|
<TH width=75%>Description</TH>
|
|
</TR>
|
|
|
|
<TR VALIGN="top">
|
|
<TD width=25%><I>assembly</I></TD>
|
|
<TD width=75%>The name of a file that contains an assembly manifest.</TD>
|
|
</TR>
|
|
</table>
|
|
|
|
<h4> Options</h4>
|
|
|
|
<P> Options can be specified using either a dash (-) or a slash
|
|
(/).
|
|
</P>
|
|
|
|
<table border=1 width="90%">
|
|
<TR VALIGN="top">
|
|
<TH width=25%>Option</TH>
|
|
<TH width=75%>Description</TH>
|
|
</TR>
|
|
|
|
<TR VALIGN="top">
|
|
<TD width=25%><B>/i</B> <I>assembly</I></TD>
|
|
<TD width=75%>Installs an assembly into the global assembly cache. </TD>
|
|
</TR>
|
|
|
|
<TR VALIGN="top">
|
|
<TD width=25%><B>/l</B></TD>
|
|
<TD width=75%>Lists the contents of the global assembly cache.</TD>
|
|
</TR>
|
|
|
|
<TR VALIGN="top">
|
|
<TD width=25%><B>/nologo</B></TD>
|
|
<TD width=75%>Suppresses the Microsoft startup banner display.</TD>
|
|
</TR>
|
|
|
|
<TR VALIGN="top">
|
|
<TD width=25%><B>/silent</B></TD>
|
|
<TD width=75%>Suppresses the display of all output.</TD>
|
|
</TR>
|
|
|
|
<TR VALIGN="top">
|
|
<TD width=25%><B>/u</B> <I>assemblyfile</I></TD>
|
|
<TD width=75%>Uninstalls a specified assembly,<i> assemblyfile,</i> from the global assembly cache.
|
|
</TD>
|
|
</TR>
|
|
|
|
<TR VALIGN="top">
|
|
<TD width=25%><B>/?</B></TD>
|
|
<TD width=75%>Displays command syntax and options for the tool.<p>When using
|
|
this tool on UNIX system-based platforms <b>/?</b> may expand to a filename.
|
|
Instead use <b>-?</b>, or enclose the
|
|
<b>/?</b> option in quotes: "<b>/?</b>".</TD>
|
|
</TR>
|
|
</table>
|
|
|
|
<H4>Remarks</H4>
|
|
|
|
<P>The Global Assembly Cache allows you to install assemblies into the cache, remove them from the cache, and list the contents of the cache. </P>
|
|
|
|
<H4>Examples</H4>
|
|
|
|
<P>The following command inserts the file <CODE>mydll.dll</CODE> into the global assembly cache.</P>
|
|
|
|
<PRE>gacutil /i mydll.dll</PRE>
|
|
|
|
<P>The following command removes the assembly <CODE>hello</CODE> from the global assembly cache.</P>
|
|
|
|
<PRE>gacutil /u hello</PRE>
|
|
|
|
<P>Note that the prior command might remove more than one assembly from the assembly cache because the assembly name is not fully specified. For example, if both version 1.0.0.0 and 3.2.2.1 of <CODE>hello</CODE> are installed in the cache, the command <CODE>gacutil /u hello</CODE> removes both of the assemblies.</P>
|
|
|
|
<P>Use the following example to avoid removing more than one assembly. This command removes only the <CODE>hello</CODE> assembly that matches the fully specified version number, culture, and public key.</P>
|
|
|
|
<PRE>gacutil /u hello,
|
|
Version=1.0.0.1,Culture="de",PublicKeyToken=45e343aae32233ca</PRE>
|
|
|
|
<P>The following command lists the contents of the global assembly cache.</P>
|
|
|
|
<PRE>gacutil /l</PRE>
|
|
|
|
<h5>See Also</h5>
|
|
|
|
<P><a href="Tools_Index.html">Tools Index</a></P>
|
|
<hr>
|
|
<p><i>Copyright (c) 2002 Microsoft Corporation. All rights reserved.</i></p>
|
|
</BODY>
|
|
</HTML> |