2007-05-30 Chris Toshok <toshok@ximian.com>
[mono.git] / man / al.1
1 .TH "al" 1
2 .SH NAME
3 al, al2 \- Mono Assembly Linker
4 .SH SYNOPSIS
5 .B al [option] [source-files]
6 .SH DESCRIPTION
7 AL is the Mono assembly linkder. 
8 .PP
9 Use al for processing 1.0 assemblies, use al2 to process 2.0 assemblies.
10 .SH OPTIONS
11 .TP
12 .B @<filename>
13 Read response file for more options.
14 .TP
15 .B -algid:<id>
16 Algorithm used to hash files. The <id> must be specified in hexadecimal.
17 .TP
18 .B -base:<addr> | -baseaddress:<addr>
19 Base address for the library. THIS FEATURE ISN'T IMPLEMENTED.
20 .TP
21 .B -bugreport:<filename>
22 Create a 'Bug Report' file. THIS FEATURE ISN'T IMPLEMENTED.
23 .TP
24 .B -comp:<text> | -company:<text>
25 This inserts the company name into the assembly metadata.
26 This is equivalent to adding the [AssemblyCompany ("<text>")] attribute
27 into C# source code.
28 .TP
29 .B -config:<text> | -configuration:<text>
30 This inserts the configuration string into the assembly metadata.
31 This is equivalent to adding the [AssemblyConfiguration ("<text>")] 
32 attribute into C# source code.
33 .TP
34 .B -copy:<text> | -copyright:<text>
35 This inserts the copyright message into the assembly metadata.
36 This is equivalent to adding the [AssemblyCopyright ("<text>")] 
37 attribute into C# source code.
38 .TP
39 .B -c:<text> | -culture:<text>
40 This inserts the supported culture into the assembly metadata.
41 This is equivalent to adding the [AssemblyCulture ("<text>")] 
42 attribute into C# source code.
43 .TP
44 .B -delay | -delay+ | -delaysign | -delaysign+
45 The generated assembly will be delay signed. 
46 This is equivalent to adding the [AssemblyDelaySignAttribute (true)] 
47 attribute into C# source code.
48 .TP
49 .B -delay- | -delaysign-
50 The generated assembly will be fully signed (i.e. not delay signed).
51 This is the default option when signing (-keyfile or -keyname).
52 .TP
53 .B -descr:<text> | -description:<text>
54 This inserts a description of the assembly into the assembly metadata.
55 This is equivalent to adding the [AssemblyDescription ("<text>")] 
56 attribute into C# source code.
57 .TP
58 .B -e:<filename> | -evidence:<filename>
59 This embed into the assembly the specified file as assembly security
60 evidences.
61 .TP
62 .B -fileversion:<version>
63 Optional Win32 version. This overrides the normal assembly version.
64 .TP
65 .B -flags:<flags>
66 Assembly flags. The <flags> must be specified in hexadecimal.
67 .TP
68 .B -fullpaths
69 Display files using fully-qualified filenames.
70 .TP
71 .B -keyf:<filename> | -keyfile:<filename>
72 Strongname (sign) the output assembly using the key pair present in 
73 the specified strong name key file (snk). A full key pair is required
74 unless the delay signing option is also specified (-delay+).
75 This is equivalent to adding the [AssemblyKeyFile ("<text>")] 
76 attribute into C# source code.
77 .TP
78 .B -keyn:<text> | -keyname:<text>
79 Strongname (sign) the output assembly using the key pair present in 
80 the specified container. Delay signing isn't supported when using key
81 containers.
82 This is equivalent to adding the [AssemblyKeyName ("<text>")] 
83 attribute into C# source code.
84 .TP
85 .B -main:<method>
86 Specifies the method name of the assembly entry point.
87 .TP
88 .B -nologo
89 Suppress the startup banner and copyright message.
90 .TP
91 .B -out:<filename>
92 Output file name for the assembly manifest.
93 .TP
94 .B -prod:<text> | product:<text>
95 This inserts the product name into the assembly metadata.
96 This is equivalent to adding the [AssemblyProduct ("<text>")] 
97 attribute into C# source code.
98 .TP
99 .B -productv[ersion]:<text>
100 This inserts the product version into the assembly metadata.
101 This is equivalent to adding the [AssemblyInformationalVersion ("<text>")] 
102 attribute into C# source code.
103 .TP
104 .B -t[arget]:<target> | -target=<target>
105 Valid <target>s are:
106 .B lib | library
107 to create a library (.dll),
108 .B exe
109 to create a console executable (.exe), and
110 .B win | winexe
111 to create a Windows executable (.exe).
112 .TP
113 .B -template:<filename>
114 Specifies an assembly to get default options from.
115 .TP
116 .B -title:<text>
117 This inserts an assembly title into the assembly metadata.
118 This is equivalent to adding the [AssemblyTitle ("<text>")] 
119 attribute into C# source code.
120 .TP
121 .B -trade:<text> | -trademark:<text>
122 This inserts a trademark message into the assembly metadata.
123 This is equivalent to adding the [AssemblyTrademark ("<text>")] 
124 attribute into C# source code.
125 .TP
126 .B -v:<version> | -version:<version>
127 This inserts the assembly version into the assembly metadata. You can
128 use * to auto-generate remaining numbers.
129 This is equivalent to adding the [AssemblyVersion ("<text>")] 
130 attribute into C# source code.
131 .TP
132 .B -win32icon:<filename>
133 Use this icon for the output.
134 .TP
135 .B -win32res:<filename>
136 Specifies the Win32 resource file.
137 .TP
138 .B -? | -help
139 Display information about AL
140 .PP
141 .SH SEE ALSO
142 sn(1)
143 .SH COPYRIGHT
144 Copyright (C) 2005 Novell, Inc (http://www.novell.com)
145 .SH MAILING LISTS
146 Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for details.
147 .SH WEB SITE
148 Visit: http://www.mono-project.com for details