1al(1)                       General Commands Manual                      al(1)
2
3
4

NAME

6       al, al2 - Mono Assembly Linker
7

SYNOPSIS

9       al [option] [source-files]
10

DESCRIPTION

12       AL is the Mono assembly linker.
13
14       This  linker  is  used  to put together assemblies from a collection of
15       modules (.netmodule files), assembly manifest files and resources.
16
17       Do not confuse this with the monolinker, which is a tool to reduce  the
18       size of assemblies based on the code used.
19
20       Use  al  for  processing  1.0 assemblies, use al2 to process 2.0 assem‐
21       blies.
22

OPTIONS

24       @<filename>
25              Read response file for more options.
26
27       -algid:<id>
28              Algorithm used to hash files. The  <id>  must  be  specified  in
29              hexadecimal.
30
31       -base:<addr> | -baseaddress:<addr>
32              Base address for the library. THIS FEATURE ISN'T IMPLEMENTED.
33
34       -bugreport:<filename>
35              Create a 'Bug Report' file. THIS FEATURE ISN'T IMPLEMENTED.
36
37       -comp:<text> | -company:<text>
38              This  inserts the company name into the assembly metadata.  This
39              is  equivalent  to  adding  the   [AssemblyCompany   ("<text>")]
40              attribute into C# source code.
41
42       -config:<text> | -configuration:<text>
43              This  inserts  the  configuration string into the assembly meta‐
44              data.  This is equivalent to adding  the  [AssemblyConfiguration
45              ("<text>")] attribute into C# source code.
46
47       -copy:<text> | -copyright:<text>
48              This  inserts  the copyright message into the assembly metadata.
49              This is equivalent to adding the [AssemblyCopyright  ("<text>")]
50              attribute into C# source code.
51
52       -c:<text> | -culture:<text>
53              This  inserts  the supported culture into the assembly metadata.
54              This is equivalent to adding  the  [AssemblyCulture  ("<text>")]
55              attribute into C# source code.
56
57       -delay | -delay+ | -delaysign | -delaysign+
58              The generated assembly will be delay signed.  This is equivalent
59              to adding the [AssemblyDelaySignAttribute (true)] attribute into
60              C# source code.
61
62       -delay- | -delaysign-
63              The  generated  assembly  will  be  fully signed (i.e. not delay
64              signed).  This is the default option when signing  (-keyfile  or
65              -keyname).
66
67       -descr:<text> | -description:<text>
68              This  inserts  a  description  of the assembly into the assembly
69              metadata.  This is equivalent to adding the [AssemblyDescription
70              ("<text>")] attribute into C# source code.
71
72       -e:<filename> | -evidence:<filename>
73              This  embed  into  the  assembly  the specified file as assembly
74              security evidences.
75
76       -fileversion:<version>
77              Optional Win32 version. This overrides the normal assembly  ver‐
78              sion.
79
80       -flags:<flags>
81              Assembly flags. The <flags> must be specified in hexadecimal.
82
83       -fullpaths
84              Display files using fully-qualified filenames.
85
86       -keyf:<filename> | -keyfile:<filename>
87              Strongname (sign) the output assembly using the key pair present
88              in the specified strong name key file (snk). A full key pair  is
89              required  unless  the  delay  signing  option  is also specified
90              (-delay+).  This is equivalent to  adding  the  [AssemblyKeyFile
91              ("<text>")] attribute into C# source code.
92
93       -keyn:<text> | -keyname:<text>
94              Strongname (sign) the output assembly using the key pair present
95              in the specified container. Delay signing isn't  supported  when
96              using  key containers.  This is equivalent to adding the [Assem‐
97              blyKeyName ("<text>")] attribute into C# source code.
98
99       -main:<method>
100              Specifies the method name of the assembly entry point.
101
102       -nologo
103              Suppress the startup banner and copyright message.
104
105       -out:<filename>
106              Output file name for the assembly manifest.
107
108       -prod:<text> | product:<text>
109              This inserts the product name into the assembly metadata.   This
110              is   equivalent   to  adding  the  [AssemblyProduct  ("<text>")]
111              attribute into C# source code.
112
113       -productv[ersion]:<text>
114              This inserts the product version  into  the  assembly  metadata.
115              This  is  equivalent to adding the [AssemblyInformationalVersion
116              ("<text>")] attribute into C# source code.
117
118       -t[arget]:<target> | -target=<target>
119              Valid <target>s are: lib | library to create a  library  (.dll),
120              exe  to  create a console executable (.exe), and win | winexe to
121              create a Windows executable (.exe).
122
123       -template:<filename>
124              Specifies an assembly to get default options from.
125
126       -title:<text>
127              This inserts an assembly title into the assembly metadata.  This
128              is equivalent to adding the [AssemblyTitle ("<text>")] attribute
129              into C# source code.
130
131       -trade:<text> | -trademark:<text>
132              This inserts a trademark message  into  the  assembly  metadata.
133              This  is equivalent to adding the [AssemblyTrademark ("<text>")]
134              attribute into C# source code.
135
136       -v:<version> | -version:<version>
137              This inserts the assembly version into  the  assembly  metadata.
138              You  can  use  *  to  auto-generate  remaining numbers.  This is
139              equivalent to adding the [AssemblyVersion ("<text>")]  attribute
140              into C# source code.
141
142       -win32icon:<filename>
143              Use this icon for the output.
144
145       -win32res:<filename>
146              Specifies the Win32 resource file.
147
148       -? | -help
149              Display information about AL
150

SEE ALSO

152       sn(1), monolinker(1)
153
155       Copyright (C) 2005 Novell, Inc (http://www.novell.com)
156

MAILING LISTS

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

WEB SITE

162       Visit: http://www.mono-project.com for details
163
164
165
166                                                                         al(1)
Impressum