Crypto algorithm implementations for the 65816
Go to file
2017-11-26 09:25:41 -06:00
.gitignore Add all generated programs and libraries to .gitignore. 2017-11-20 14:59:28 -06:00
aes.asm Fix typos in comments. 2017-11-26 09:25:41 -06:00
aes.h Add implementation and test for AES CTR mode. 2017-07-02 18:25:43 -05:00
aes.macros state -> context 2017-06-29 16:52:34 -05:00
aescbctest.c Mention sources of AES test vectors. 2017-11-25 21:27:25 -06:00
aescrypt.c Add copyright notices and comments. 2017-07-02 18:41:21 -05:00
aesctrtest.c Mention sources of AES test vectors. 2017-11-25 21:27:25 -06:00
aesmodes.c Add copyright notices and comments. 2017-07-02 18:41:21 -05:00
aestest.c Mention sources of AES test vectors. 2017-11-25 21:27:25 -06:00
cksumcommon.h Don't call srand unless we're actually randomizing read sizes. 2017-11-19 23:47:30 -06:00
LICENSE Add LICENSE file. 2017-11-20 14:51:00 -06:00
Makefile Use a common template for all the file checksum programs. 2017-11-19 22:43:31 -06:00
md5.asm Force MD5 tables to be page-aligned, which should save a cycle in some cases. 2017-07-04 14:37:17 -05:00
md5.cc Add implementation of MD5 hash function. 2017-07-04 12:15:00 -05:00
md5.h Add implementation of MD5 hash function. 2017-07-04 12:15:00 -05:00
md5.macros One more tweak to MD5 rotate optimizations. 2017-07-04 14:42:01 -05:00
md5sum.c Use a common template for all the file checksum programs. 2017-11-19 22:43:31 -06:00
md5test.c Add implementation of MD5 hash function. 2017-07-04 12:15:00 -05:00
pagealign.asm Force MD5 tables to be page-aligned, which should save a cycle in some cases. 2017-07-04 14:37:17 -05:00
README.md Add README. 2017-11-25 21:26:13 -06:00
rotate.macros Add comments and copyright notices, and rename chunk to block. 2017-07-01 17:53:49 -05:00
sha1.asm Add comments and copyright notices, and rename chunk to block. 2017-07-01 17:53:49 -05:00
sha1.cc Add comments and copyright notices, and rename chunk to block. 2017-07-01 17:53:49 -05:00
sha1.h Add comments and copyright notices, and rename chunk to block. 2017-07-01 17:53:49 -05:00
sha1.macros Typos 2017-07-02 22:54:18 -05:00
sha1sum.c Use a common template for all the file checksum programs. 2017-11-19 22:43:31 -06:00
sha1test.c Add comments and copyright notices, and rename chunk to block. 2017-07-01 17:53:49 -05:00
sha256.asm Add initialization function to permit computation of SHA-224 hashes. 2017-07-03 23:40:36 -05:00
sha256.cc Add update and finalize functions for SHA-256. 2017-07-03 23:53:43 -05:00
sha256.h Add initialization function to permit computation of SHA-224 hashes. 2017-07-03 23:40:36 -05:00
sha256.macros Remove unused macros. 2017-07-03 23:05:51 -05:00
sha256sum.c Use a common template for all the file checksum programs. 2017-11-19 22:43:31 -06:00
sha256test.c Work around ORCA/C bug that affects lower optimization levels. 2017-07-05 12:24:37 -05:00

65816 Cryptographic & Hash Libraries

This package contains libraries implementing cryptographic algorithms for the 65816, suitable for use on the Apple IIgs and potentially also other 65816-based systems. Currently, it includes implementations of AES encryption and decryption (in lib65816crypto), and of the MD5, SHA-1, and SHA-256 hash functions (in lib65816hash). The core algorithms for each of these are written in carefully optimized assembly code, and they can generally process at least several thousand bytes per second on a 2.8 MHz Apple IIgs.

Using the Libraries

These libraries can easily be used from ORCA/C, or from ORCA/M or other assemblers that permit linking to OMF libraries. (With appropriate glue code, they could also be used from other languages.) Refer to the included header files for documentation on how to call them. Note that each algorithm uses a 'context' structure which must be in bank 0. This can be allocated on the stack (e.g. by using a local variable in C), although maximum performance will be obtained if it is page-aligned.

If you are calling these algorithms from assembly language, simply follow the usual conventions for calling ORCA/C code: push the arguments on the stack in reverse order, and then JSL to the function. The data bank must be set to the bank containing the library code (which is in the default, blank-named load segment), and the functions must be called in full native mode.

If you use these libraries in your program, you will need to link them into it. You can either place the libraries in the Libraries directory of your ORCA installation, or place them somewhere else and specify them on the command line when linking your program. When using certain algorithms (currently AES and MD5), you may also need to include pagealign.root as the first file on the linker command line. This file contains no code, but simply specifies that the default load segment should be page-aligned. This is needed because those algorithms include data tables that are page-aligned to maximize performance.

Note that some of the algorithms implemented in this package (including MD5 and SHA-1) have known security weaknesses. If you are using them in a situation where security is important, you should refer to up-to-date cryptanalytic results and advice to determine whether they are appropriate for your application.

Building the Libraries

If you want to build these libraries yourself, you will need ORCA/M and ORCA/C. To ensure everything builds correctly, I recommend using ORCA/C 2.2.0 B1 or later. The included Makefile is set up to build the libraries and test programs on a modern system using Golden Gate, but they could also be build under the ORCA shell or GNO with a suitable build script.

File Checksum Programs

This package also includes versions of the md5sum, sha1sum, and sha256sum programs, which can be run under the ORCA shell or GNO. These utilities compute file checksums using the corresponding hash algorithms and can be useful for verifying the integrity of files.