babyutils/bas.1 at master · andy-bower/babyutils · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
.Dd February 9, 2023
.Os Linux
.Dt BAS 1 PRM
.Sh NAME
bas \- Assembler for Manchester Baby
.Sh SYNOPSIS
.Nm bas
.Fl h
.Nm bas
.Op Fl a
.Op Fl o Ar FILE
.Op Fl O Ar FMT
.Op Fl v
.Ar SOURCE...
.Sh DESCRIPTION
Assemble machine code for the Manchester Baby 'SSEM' from one or more source
files.
.Pp
.Nm
allows labels for addresses to be defined and used as symbols in place of
operands.
.Pp
A new directive,
.Ql EJA ,
encodes a data work that points to the instruction before the given location.
.Ss Options
.Bl -tag -width OOxxxxoutput-formatxFMTx
.It Fl h
Show usage
.It Fl a, -listing
Output listing
.It Fl m, -map
Output map
.It Fl o, -output Ar FILE
Write object output to
.Ar FILE ,
or stdout if
.Ql - .
(Default
.Ql b.out . )
.It Fl O, -output-format Ar FMT
Use
.Ar FMT
as object file format.
(Default
.Ql bits.snp . )
.It Fl v, -verbose
Output verbose information
.El
.Ss Output Formats
.Bl -tag -width bits.ssemx
.It Ic logisim
Logisim RAM image format
.It Ic binary
Binary in host endianness
.It Ic bits
Bit strings
.It Ic bits.ssem
Bit strings with LSB first
.It Ic bits.snp
SSEM Snapshot format (default)
.El
.Sh BUGS
Please raise bug reports at:
.Lk https://github.com/andy-bower/babyutils/issues
.Sh EXAMPLES
Assemble a source file to
.Ql b.out
with assembly listing to the terminal.

.Dl bas -a test/ldiv.asm
.Sh AUTHORS
.An Andrew Bower
.Sh COPYRIGHT
Copyright (c) 2023 Andrew Bower
.Pp
SPDX-License-Identifier: MIT