Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/leto/asmutils

asmutils is a set of miscellaneous unix utilities written in assembly language
https://github.com/leto/asmutils

Last synced: about 2 months ago
JSON representation

asmutils is a set of miscellaneous unix utilities written in assembly language

Awesome Lists containing this project

README 

        

			       asmutils

			       ********



			    (version 0.18)



			http://linuxassembly.org



Legal stuff

===========



 All programs in this package are *copyrighted* by their authors,

 as stated in the source code and in the CREDITS file. The bulk

 of code is written by Konstantin Boldyshev, with contributions

 of various hackers all over the world.



 These programs are free software; you can redistribute and/or modify

 them under the terms of the version 2 (and only version 2) of the GNU

 General Public License as published by the Free Software Foundation.



 These programs are distributed in the hope that they will be useful,

 but WITHOUT ANY WARRANTY; without even the implied warranty

 of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

 See the version 2 of the GNU General Public License for more details

 .



 Authors are not responsible for any damage these programs can do.

 This is development version, use solely at your own risk.



Description

===========



 asmutils is a set of miscellaneous utilities written in assembly language,

 targeted on embedded systems and small distributions (e.g. installation

 or rescue disks); also it contains a small libc and a crypto library.

 It features the smallest possible size and memory requirements,

 the fastest speed, and offers fairly good functionality.

 Now project supports Linux and BSD family (FreeBSD, OpenBSD, NetBSD);

 Unixware, Solaris, and AtheOS support is in beta stage (also there's

 no more supported BeOS port), and it is /theoretically/ possible to

 port it to any i386 OS. 



 Another goal of this package is to provide a *portable* framework,

 and to encourage assembly programmers to write for Linux/UNIX.

 Usually UNIX is associated with C, and no one wants to deal with assembly..

 Browse the source, look -- it is simple. Read the docs, start to write,

 and you will like it; assembly programming is a lot of fun, especially

 when you deal with a UNIX-like operating systems.



 In addition, this package has some "special bonus" like small intros,

 games, and other various assembly snippets.



 These utilities also may be useful for system administrators;

 there were several reports that they have rescued when libc

 crashed and it was not possible to use usual system utilities.



 Hey, we are a light in the darkness of bloatware. Do you see?



How to install

==============



 REQUIREMENTS:



	1) i386 (however some programs may require higher CPU);

	   some programs may require FPU (or kernel emulation)



	2) UNIX-like kernel



	3) ELF/AOUT executable format (actually not a requirement,

	   you just need to write startup stack preparation

	   for your executable format on your own)



 For details on compilation process examine doc/Asmutils-HOWTO,

 then edit MCONFIG, run '[g]make' and hopefully all will be done.



 '[g]make install' creates bin directory in the source tree and stores

 compiled files there (it doesn't copy files elsewhere, neither to /bin

 or /usr/bin, nor to /usr/local/bin).



 You may also want to examine a-Linux -- a floppy-based mini-distribution

 consisting of Linux kernel and asmutils; it is available for download

 from the asmutils homepage as well.



 WARNING:

 

 Before using any utility first DO LOOK AT ITS SYNTAX; some utils may

 work not as you have expected. Syntax can be found in the appropriate

 source file (.asm) from the src directory (do not expect any answer

 from program on --help switch or without switches).



Feedback

========



 Contributions are welcome! If you want to contribute some code,

 please read the Asmutils-HOWTO in the doc directory.

 At least send a bugreport or a success story :)



 $Id: README,v 1.17 2006/02/18 10:13:42 konst Exp $