Project Asmosis

Contents:

• Description
• Screenshots
• Download
• Installing the software
• Reporting issues
• My projects on SourceForge
• My other software
• Contact information
• Page information

Description

Project Asmosis provides some tools for assembly language programmers. It is meant primarily for programmers who program for the x86 and amd64 (x86-64, x64) processor families (known as Intel/AMD-compatible processors).

Just like Osmosis is a movement of molecules to impact other areas, Asmosis is about impacting and influencing of other programming languages by assembly language.

Not many realize this, but various areas of computing are influenced by assembly language. To name some examples:

• How does your computer start? Think about what language the BIOS is written in to fit on a chip.
• How does the operating system on your computer boot? Think about what language the bootsector/bootloader is written in to fit in 512 bytes. Take a look at an example GNU GRUB source code file.
• You can read the Oracle VM VirtualBox requirements: All VirtualBox hosts must have the virtualization extensions from AMD (AMD-V) and Intel (VT-x) enabled.
• You can read some of the Autodesk requirements: requires that the computer's processor supports the SSE 4.1 instruction set.
• You can look at some optimized code for the strchr function in glibc, the GNU C library.
• MPlayer documentation says the software requires compatible assemblers that understand new instruction sets. You can also enable run-time CPU detection that allows the program to choose optimized code at run-time.

The tools Project Asmosis provides include:

• the Asm::X86 Perl module (documentation is available on CPAN Asm::X86 POD),
• AsmDoc - a HTML documentation generator for assembly language,
• assembly source code converters between NASM, fasm and GNU as (fasm2gas, fasm2nasm, gas2fasm, gas2nasm, nasm2fasm, nasm2gas),
• C header to assembly header converters (h2fasm, h2gas, h2nasm),
• Makefile generator for fasm (make4fasm),
• Linux 2.6 kernel module helper for fasm and NASM (symvers-nasm, symvers-fasm),
• Asm4Doxy - Assembly converter for Doxygen,
• util-macros.* - some utility macros for fasm and NASM,
• Autoconf macros that check for existence and command-line options of the various assemblers ( ax_prog_nasm.m4, ax_prog_nasm_opt.m4, ax_prog_fasm.m4, ax_prog_fasm_opt.m4, ax_prog_yasm.m4, ax_prog_yasm_opt.m4, ax_prog_tasm.m4, ax_prog_tasm_opt.m4, ax_prog_masm.m4, ax_prog_masm_opt.m4, ax_prog_hla.m4, ax_prog_hla_opt.m4),
• OS parts - sample pieces of code that may be useful for starting developing a simple operating system.

AsmDoc and Asm4Doxy process specially-formatted documentation comments. Documentation comments should start with ;; or /** and end with ;; or */. Example:

	;;
	; This procedure reads data.
	; @param CX - number of bytes
	; @return DI - address of data
	;;
	procedure01:
		...
		ret

The most up-to-date documentation can be found in the packages. A generated copy of Asm::X86 documentation is available on CPAN Asm::X86 POD.

Documentation is also available on the Asmosis wiki.

Screenshots of Asmosis

Screenshots are available on the SourceForge project page.

Download Asmosis

Current version of Asm::X86 is 0.70.
Current version of the Autoconf macros is 1.2.
Current version of the assembly-to-assembly converters is 3.3.
Current version of C-header-to-assembly-header converters is 3.0.
Current version of the documentation generators is 4.4.
Current version of the additional tools is 4.5.
Current version of the OS parts is 0.0.1.
Download everything at SourceForge.

Asmosis release file feed

Current version of Parse::H (required by the C-header-to-assembly-header converters) is 0.21.

Parse::H release file feed on CPAN

Free badges provided by Shields.io.

Installing the software

1. unpack the archive, e.g. tar zxf Asm-X86-0.70.tar.gz
2. change into the unpacked directory: cd Asm-X86-0.70
3. run perl Makefile.PL
4. run make
5. run make install

1. unpack the archive, e.g. tar zxf Asm-X86-0.70.tar.gz
2. change into the unpacked directory: cd Asm-X86-0.70
3. run perl Makefile.PL INSTALL_BASE=/your/path
4. run make
5. run make install

1. unpack the archive, e.g. tar zxf asmosis-converters-asm2asm-X.Y.tar.gz
2. follow the instructions provided in the INSTALL-*.txt file

System compatibility

Various tools from Asmosis, in various versions, have successfully been used with the following components in the following versions:

1. Perl:
   • v5.12.3
   • v5.22.1
   • v5.34.0
2. NASM:
   • 2.15.05
3. GCC:
   • 4.6.1
   • 11.2.0

Reporting issues

Any defects or issues can be reported by e-mail or in the SourceForge project defect manager (in English).

Any improvement suggestions can be reported by e-mail or in the SourceForge project ticket manager (in English).

To report usage problems, include:

1. the name of the tool you're having the problem with, e.g. Asm::X86 0.70,
2. (if you're using one of the Perl tools) the Perl version you're using, e.g. the output of perl --version:

   	This is perl 5, version 34, subversion 0 (v5.34.0) built for x86_64-linux-thread-multi

3. if applicable, the name and version of the assembler you're using,
4. a description of the problem that the software causes,
5. any error messages that are displayed,
6. any other information that you think could lead to solving the problem.

Help in victory, play a game, send regards, or at least stop using some products

My projects on SourceForge

• WipeFreeSpace - a program for cleaning of free space on filesystems
• LibSecRm - a security wrapper library for C library functions which insecurely delete data
• Trinventum - software that helps manage an e-business
• Meqaris - meeting room and equipment booking system using e-mail invitations
• JYMAG - a program for serial-based (AT-based) mobile phones (like Sagem) and a serial port terminal
• IMYplay - a program for playing iMelody ringtones (IMY files) and an IMY-to-MIDI converter
• LibHideIP - a security wrapper library for C library functions which could lead to revealing your local IP address
• LibNetBlock - a security wrapper library that ensures that no program under its control can access the network
• FMSec - a set of extensions to file managers that enable some security-related operations to be easily performed. The operations include:
  • Secure removal of files using shred,
  • Secure removal of directories,
  • Mounting block devices and regular files using VeraCrypt,
  • Unmounting directories using VeraCrypt,
  • Wiping block devices (without removing them) using shred (the filesystem itself is destroyed too)
  • Wiping free space on filesystems on block devices or inside regular files using WipeFreeSpace,
  • Encrypting and decrypting files using OpenSSL,
  • running programs with LibSecRm preloaded,
  • running programs with LibHideIP preloaded,
  • running programs with LibNetBlock preloaded.
  FMSec consists of projects formerly known as KonqSec/Konq4Sec/Konq5Sec.
• Project Asmosis - a set of tools for assembly language programmers:
  • the Asm::X86 Perl module,
  • AsmDoc - a HTML documentation generator for assembly language,
  • assembly source code converters between NASM, fasm and GNU as,
  • C header to assembly header converters (h2fasm, h2gas, h2nasm),
  • Makefile generator for fasm (make4fasm),
  • Linux 2.6 kernel module helpers for fasm and NASM (symvers-nasm, symvers-fasm),
  • Asm4Doxy - Assembly converter for Doxygen,
  • util-macros.* - some utility macros for fasm and NASM,
  • Autoconf macros that check for existence and command-line options of the various assemblers (ax_prog_nasm.m4, ax_prog_nasm_opt.m4, ax_prog_fasm.m4, ax_prog_fasm_opt.m4, ax_prog_yasm.m4, ax_prog_yasm_opt.m4, ax_prog_tasm.m4, ax_prog_tasm_opt.m4, ax_prog_masm.m4, ax_prog_masm_opt.m4, ax_prog_hla.m4, ax_prog_hla_opt.m4),
  • OS parts - sample pieces of code that may be useful for starting developing a simple operating system.
• KeyParaStocX - is an extension for LibreOffice, Apache OpenOffice and the old OpenOffice.org that searches for keywords in a text, changes their style and builds a Table of Contents for them (formerly: "PozeraczUstaw").
• Fronsetia - a web application that allows testing webservices (formerly: SOAPServiceTester).

The always-up-to-date list of my SourceForge projects is on my profile page on SourceForge.

My other software

• primary site - rudy.mif.pg.gda.pl/~bogdro/soft - down
• first backup site - bogdro.ciki.me/soft - down
• second backup site - bogdro.fulba.com/soft - down
• third backup site (also available over HTTPS)
• fourth backup site (also available over HTTPS)

1. Certificate and key generators
2. E-mail address verifiers
3. LastMod - a script that inserts or updates a META element with the Last-Modified HTTP header
4. Atom2Rss - a script that converts an Atom (RFC 4287) channel XML file to an RSS 2.0 XML file
5. List2Atom - a script that generates an Atom (RFC 4287) channel XML file from a list of files
6. InSyTrack - telemetry software to track program flow (calls) across libraries, threads, programming languages or even different systems on different machines

• primary site with assembly tools - rudy.mif.pg.gda.pl/~bogdro/inne - down
• first backup site with assembly tools - bogdro.ciki.me/inne - down
• second backup site with assembly tools - bogdro.fulba.com/inne - down
• third backup site with assembly tools (also available over HTTPS)
• fourth backup site with assembly tools (also available over HTTPS)

1. Kate/KWrite syntax highlighting for NASM/fasm

Contact information

Contact me: bogdro AT users . sourceforge . net (English accepted, just say '[SOFT]' in the title).

The certificate of the timestamping server which confirms the signature time, can be found on freeTSA.org.

Page information

This page is hosted at SourceForge.net.
This page is written using valid HTML 4.01 , , for all browsers:

This page uses a valid CSS

This page has a content security policy.

This page doesn't use GIF images and doesn't use JPG images.

This page is pure HTML and CSS.

The project icon was created using Inkscape™.

Legal information

Oracle®, Java, and MySQL are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

LINUX® is a registered trademark of Linus Torvalds.

AMD is a trademark of Advanced Micro Devices, Inc.

Intel is a trademark of Intel Corporation or its subsidiaries.

Autodesk is a registered trademark of Autodesk, Inc.

All other trademarks, logos and names on this page and all subpages are properties of their respective owners and are given here only as an example.