al(1)                                                         General Commands Manual                                                        al(1)

NAME

       al, al2 - Mono Assembly Linker

SYNOPSIS

       al [option] [source-files]

DESCRIPTION

       AL is the Mono assembly linkder.

       This linker is used to put together assemblies from a collection of modules (.netmodule files), assembly manifest files and resources.

       Do not confuse this with the monolinker, which is a tool to reduce the size of assemblies based on the code used.

       Use al for processing 1.0 assemblies, use al2 to process 2.0 assemblies.

OPTIONS

       @<filename>
              Read response file for more options.

       -algid:<id>
              Algorithm used to hash files. The <id> must be specified in hexadecimal.

       -base:<addr> | -baseaddress:<addr>
              Base address for the library. THIS FEATURE ISN'T IMPLEMENTED.

       -bugreport:<filename>
              Create a 'Bug Report' file. THIS FEATURE ISN'T IMPLEMENTED.

       -comp:<text> | -company:<text>
              This  inserts  the company name into the assembly metadata.  This is equivalent to adding the [AssemblyCompany ("<text>")] attribute
              into C# source code.

       -config:<text> | -configuration:<text>
              This inserts the configuration string into  the  assembly  metadata.   This  is  equivalent  to  adding  the  [AssemblyConfiguration
              ("<text>")] attribute into C# source code.

       -copy:<text> | -copyright:<text>
              This  inserts  the  copyright  message  into the assembly metadata.  This is equivalent to adding the [AssemblyCopyright ("<text>")]
              attribute into C# source code.

       -c:<text> | -culture:<text>
              This inserts the supported culture into the assembly metadata.  This  is  equivalent  to  adding  the  [AssemblyCulture  ("<text>")]
              attribute into C# source code.

       -delay | -delay+ | -delaysign | -delaysign+
              The generated assembly will be delay signed.  This is equivalent to adding the [AssemblyDelaySignAttribute (true)] attribute into C#
              source code.

       -delay- | -delaysign-
              The generated assembly will be fully signed (i.e. not delay signed).  This is the default option when  signing  (-keyfile  or  -key-
              name).

       -descr:<text> | -description:<text>
              This  inserts  a  description  of  the  assembly  into the assembly metadata.  This is equivalent to adding the [AssemblyDescription
              ("<text>")] attribute into C# source code.

       -e:<filename> | -evidence:<filename>
              This embed into the assembly the specified file as assembly security evidences.

       -fileversion:<version>
              Optional Win32 version. This overrides the normal assembly version.

       -flags:<flags>
              Assembly flags. The <flags> must be specified in hexadecimal.

       -fullpaths
              Display files using fully-qualified filenames.

       -keyf:<filename> | -keyfile:<filename>
              Strongname (sign) the output assembly using the key pair present in the specified strong name key file (snk). A  full  key  pair  is
              required unless the delay signing option is also specified (-delay+).  This is equivalent to adding the [AssemblyKeyFile ("<text>")]
              attribute into C# source code.

       -keyn:<text> | -keyname:<text>
              Strongname (sign) the output assembly using the key pair present in the specified container.  Delay  signing  isn't  supported  when
              using key containers.  This is equivalent to adding the [AssemblyKeyName ("<text>")] attribute into C# source code.

       -main:<method>
              Specifies the method name of the assembly entry point.

       -nologo
              Suppress the startup banner and copyright message.

       -out:<filename>
              Output file name for the assembly manifest.

       -prod:<text> | product:<text>
              This  inserts  the product name into the assembly metadata.  This is equivalent to adding the [AssemblyProduct ("<text>")] attribute
              into C# source code.

       -productv[ersion]:<text>
              This inserts the product version into the assembly  metadata.   This  is  equivalent  to  adding  the  [AssemblyInformationalVersion
              ("<text>")] attribute into C# source code.

       -t[arget]:<target> | -target=<target>
              Valid <target>s are: lib | library to create a library (.dll), exe to create a console executable (.exe), and win | winexe to create
              a Windows executable (.exe).

       -template:<filename>
              Specifies an assembly to get default options from.

       -title:<text>
              This inserts an assembly title into the assembly metadata.  This is equivalent to adding the  [AssemblyTitle  ("<text>")]  attribute
              into C# source code.

       -trade:<text> | -trademark:<text>
              This  inserts  a  trademark  message  into  the  assembly metadata.  This is equivalent to adding the [AssemblyTrademark ("<text>")]
              attribute into C# source code.

       -v:<version> | -version:<version>
              This inserts the assembly version into the assembly metadata. You can use * to auto-generate remaining numbers.  This is  equivalent
              to adding the [AssemblyVersion ("<text>")] attribute into C# source code.

       -win32icon:<filename>
              Use this icon for the output.

       -win32res:<filename>
              Specifies the Win32 resource file.

       -? | -help
              Display information about AL

SEE ALSO

       sn(1), monolinker(1)

COPYRIGHT

       Copyright (C) 2005 Novell, Inc (http://www.novell.com)

MAILING LISTS

       Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for details.

WEB SITE

       Visit: http://www.mono-project.com for details

                                                                                                                                             al(1)