You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
*[DOS .exe]({{site.releases}}/yasm-1.1.0-dos.exe) (for use on pure DOS or for use with [DJGPP](http://www.delorie.com/djgpp))
19
18
20
19
Visual Studio 2010 Integration
21
-
------------------------------
20
+
==============================
22
21
23
22
Download the appropriate VS2010 "vsyasm" zip file above for your system, and follow the readme.txt instructions for integrating yasm into Visual Studio 2010. Thanks to Brian Gladman for contributing this!
24
23
25
24
Visual Studio 2005/2008 Integration
26
-
-----------------------------------
25
+
===================================
27
26
28
27
See [VisualStudio2005]({{site.wiki}}/VisualStudio2005) for detailed instructions on integrating Yasm with Visual Studio 2005 (Visual Studio 2008 is similar).
29
28
30
29
See [Structured Exception Handling]({{site.manual}}/objfmt-win64-exception.html) (part of the [Yasm User's Manual]({{site.manual}}/)) for detailed information on using structured exception handling in the Windows x64 environment. Yasm also supports the SAFESEH directive for structured exception handling in the Win32 environment.
31
30
32
31
Nightly Development Snapshots
33
-
-----------------------------
32
+
=============================
34
33
35
34
A complete build of Yasm is performed daily at 1:20 AM PDT if there are any repository changes since the previous day. The [latest snapshot](http://www.tortall.net/projects/yasm/snapshots/latest/) is the most recent available. It is updated at the same time as the daily build. A Windows executable is also built nightly as "yasm-{version}.exe" in the latest snapshot directory. [Older snapshots](http://www.tortall.net/projects/yasm/snapshots/) are also available.
36
35
37
36
Git Repository
38
-
--------------
37
+
==============
39
38
40
39
All Yasm development is taking place using a [Git](http://git-scm.com/) repository. The repository is [browseable online](http://github.com/yasm/yasm/).
Copy file name to clipboardExpand all lines: HowToContribute.md
+6-5
Original file line number
Diff line number
Diff line change
@@ -1,27 +1,28 @@
1
1
---
2
2
title: Participate
3
+
longtitle: Participating in Yasm Development
3
4
layout: default
4
5
---
5
6
6
-
Participating in Yasm Development
7
-
=================================
7
+
Joining the Team
8
+
================
8
9
9
10
The [Yasm development team]({{site.wiki}}/YasmTeam) is currently very small, but we're open to more developers joining us! Now that the object format interface is reaching stability (except for debug format support), we're looking for developers interested in working on additional object format support as well as other portions of Yasm. [Peter Johnson]({{site.wiki}}/PeterJohnson) is the contact person for object formats and for development in general. Drop him a note if you're interested!
10
11
11
12
You can also work independently. Just [download](/Download.html) a nightly snapshot or get [Git](http://git-scm.com) and use it to download (recommended), and start hacking!
12
13
13
14
Feedback / Bugs
14
-
---------------
15
+
===============
15
16
16
17
Feel free to report bugs either on our [mailing lists](/MailingList.html) or (preferably) by using the [bug tracker](http://tortall.lighthouseapp.com/projects/78676-yasm). Other feedback and general discussion can be made to the yasm-devel mailing list.
17
18
18
19
Code Contributions
19
-
------------------
20
+
==================
20
21
21
22
These are *always* appreciated! If you have a great idea to add to yasm (which is wonderful) and have already written the code to do it (even better!) just let us know via the yasm-devel mailing list. If you just have a great idea, but no code, submit it as a ticket.. but it might take us a little bit to implement it!
22
23
23
24
Project Ideas
24
-
-------------
25
+
=============
25
26
26
27
If you want to work on something but don't know what, here are some suggestions. These projects range from little to huge (hopefully the task descriptions will give you an idea of what's involved).
Copy file name to clipboardExpand all lines: MailingList.md
+4-6
Original file line number
Diff line number
Diff line change
@@ -1,31 +1,29 @@
1
1
---
2
2
title: Mailing Lists
3
+
longtitle: Yasm Mailing Lists
3
4
layout: default
4
5
---
5
6
6
-
Yasm Mailing Lists
7
-
==================
8
-
9
7
Yasm has a number of mailing lists dedicated to development discussions and notices. Use [Mailman](http://cvs.tortall.net/mailman/listinfo/) to subscribe or view mailing list archives.
10
8
11
9
There are currently three main mailing lists for Yasm:
12
10
13
11
yasm-announce
14
-
-------------
12
+
=============
15
13
16
14
The [yasm-announce](http://cvs.tortall.net/mailman/listinfo/yasm-announce) mailing list is a low-traffic list only used for sending out major Yasm announcements, such as for new releases.
The [yasm-cvs](http://cvs.tortall.net/mailman/listinfo/yasm-cvs) mailing list records every commit made to the Yasm [Git repository](http://github.com/yasm/yasm/). High traffic, but perhaps interesting for those following Yasm development.
The [yasm-devel](http://cvs.tortall.net/mailman/listinfo/yasm-devel) mailing list is intended for general discussions of Yasm development. It's primarily a technical mailing list for those actively working on Yasm, or those interested in Yasm development.
Copy file name to clipboardExpand all lines: index.md
+2-2
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ Yasm currently supports the x86 and AMD64 instruction sets, accepts NASM and GAS
13
13
Yasm can be easily integrated into Visual Studio [2005/2008]({{site.wiki}}/VisualStudio2005) and [2010]({{site.manual}}/vsyasm.html) for assembly of NASM or GAS syntax code into Win32 or Win64 object files.
14
14
15
15
Key Current User-Visible Features
16
-
---------------------------------
16
+
=================================
17
17
18
18
* Nearly feature-complete lexing and parsing of [NASM syntax]({{site.wiki}}/NasmSyntax).
19
19
* Basic support for [TASM syntax]({{site.wiki}}/TasmSyntax).
@@ -38,7 +38,7 @@ Key Current User-Visible Features
38
38
* Internationalization support via [GNU gettext](http://www.gnu.org/software/gettext/gettext.html).
39
39
40
40
Key Internal Features
41
-
---------------------
41
+
=====================
42
42
43
43
The core focus of **Yasm** is not the *yasm* commandline frontend; rather, it is the [Libyasm]({{site.wiki}}/Libyasm) library and associated [loadable modules]({{site.wiki}}/LoadableModules) (see the [programmer references]({{site.wiki}}/ProgrammerReferences) for documentation). Libyasm and the modules are intended for reuse in other sorts of programs dealing with code at the assembly level (compilers, debuggers, etc). Someday, libyasm may be packaged separately from the rest of **Yasm**.
Copy file name to clipboardExpand all lines: releases/Release1.1.0.md
+16-16
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,11 @@
1
1
---
2
2
title: Yasm 1.1.0
3
+
longtitle: Yasm 1.1.0 Release Notes
3
4
layout: default
4
5
---
5
6
6
-
Yasm 1.1.0 Release Notes
7
-
========================
8
-
9
7
Target Audience
10
-
---------------
8
+
===============
11
9
12
10
Welcome to the 1.1.0 release of the Yasm Modular Assembler. Its target audience includes people who want to:
13
11
@@ -21,7 +19,7 @@ Welcome to the 1.1.0 release of the Yasm Modular Assembler. Its target audience
21
19
* contribute to Yasm development from a new release.
22
20
23
21
Download Yasm 1.1.0
24
-
-------------------
22
+
===================
25
23
26
24
A number of download formats are available. For Windows and DOS users, we recommend downloading the prebuilt binaries. The source tarball contains all sources needed to build Yasm on UNIX-compatible systems, Windows, and DOS. If you use Visual Studio 2010, we highly recommend downloading the appropriate vsyasm zip file and following its readme.txt directions for integration of yasm into the Visual Studio IDE.
27
25
@@ -37,9 +35,10 @@ A TASM-like frontend is also available. It defaults to the "tasm" parser and pr
* Fix a number of issues with Win32 SAFESEH support (#139).
45
44
* Fix several 32-bit Mach-O (macho32) bugs (#212 and others).
@@ -49,9 +48,10 @@ Features
49
48
* Don't emit unnecessary REX.W for pinsrw instruction (#207).
50
49
* Update gettext to 0.17 (#206).
51
50
52
-
### Features also include:
51
+
Features also include:
52
+
----------------------
53
53
54
-
####Object and debugging format support:
54
+
### Object and debugging format support:
55
55
56
56
* Full support for ELF, including support for both AMD64 and 32-bit x86 static and shared objects and thread local storage.
57
57
* Support for Mach-O object format used in MacOS X, including both the 32-bit (x86) and 64-bit (AMD64) versions.
@@ -63,18 +63,18 @@ Features
63
63
64
64
* STABS, DWARF2, and CodeView 8 debugging formats (enable with "-g ...").
65
65
66
-
####Assembler syntax support:
66
+
### Assembler syntax support:
67
67
68
68
* Full NASM-compatible parser, including the "real" NASM preprocessor (imported from NASM tree).
69
69
* GAS parser and preprocessor.
70
70
* Basic support for TASM syntax, based on the NASM parser and preprocessor.
71
71
72
-
####Architecture support:
72
+
### Architecture support:
73
73
74
74
* Support for AMD64 instruction set, registers, and addressing modes. This is enabled in one of three ways: using the `[BITS 64]` directive, using a 64-bit object format such as win64 or elf64, or setting the machine to "amd64". Only the last two will actually generate a 64-bit object file.
75
75
* Full support for AMD64 RIP-relative addressing; the forms supported in NASM syntax are `[rip+val]` (direct index) and `[sym wrt rip]` or `[rel sym]` (relocated relative).
76
76
77
-
####Other features:
77
+
### Other features:
78
78
79
79
* Fast and efficient "virtual multi-pass" optimizer that automatically generates much smaller code for jumps and immediates.
80
80
* Full warnings for integer overflow.
@@ -85,25 +85,25 @@ Features
85
85
* Man pages: yasm(1), yasm_objfmts(7), yasm_dbgfmts(7), and yasm_arch(7).
86
86
87
87
Important Differences from NASM
88
-
-------------------------------
88
+
===============================
89
89
90
90
* A number of command line options are different. Run "yasm --help" for a quick command line option summary, or read the full yasm(1) manpage for detailed descriptions of all command line options.
91
91
* Include files with relative paths are not searched in the same way. Yasm's search behavior is essentially that of most C compilers.
92
92
93
93
Known Issues
94
-
------------
94
+
============
95
95
96
96
As Yasm is still under development, there are some caveats and features that do not yet work or are not yet fully functional. See the Tickets area of Yasm's website for a list of active issues.
97
97
98
98
Compiling Yasm from source
99
-
--------------------------
99
+
==========================
100
100
101
101
On UNIX-compatible operating systems, Yasm builds using the standard "./configure; make; make install" commands. GNU make is not required. While Yasm development requires a larger toolchain (see the HACKING file), building Yasm should not require more than just a C compiler.
102
102
103
103
For Windows and DOS systems, we recommend simply downloading the prebuilt executables. However, for those that want to build YASM directly using [DJGPP](http://www.delorie.com/djgpp/), [CygWin](http://www.cygwin.com/), or Visual Studio, Makefiles and all required specialized files are provided in the Mkfiles/ directory of the distribution tarball.
0 commit comments