2022-02-14 15:23:02 +00:00
|
|
|
.TH "U6A" "1" "Jan 30, 2020" "0.1.1" "U6a User Manual"
|
2020-01-30 10:11:10 +00:00
|
|
|
.
|
|
|
|
.SH NAME
|
2020-10-10 19:31:31 +00:00
|
|
|
u6a - Runtime for the Unlambda programming language
|
2020-01-30 10:11:10 +00:00
|
|
|
.
|
|
|
|
.SH SYNOPSIS
|
2020-10-10 19:31:31 +00:00
|
|
|
.B u6a
|
|
|
|
.RI [ options ]
|
|
|
|
.I bytecode-file
|
2020-01-30 10:11:10 +00:00
|
|
|
.
|
|
|
|
.SH DESCRIPTION
|
2020-10-10 19:31:31 +00:00
|
|
|
Load and execute Unlambda bytecode from the given
|
|
|
|
.IR bytecode-file ,
|
|
|
|
or
|
|
|
|
.B STDIN
|
|
|
|
if "-" is given.
|
2020-01-30 10:11:10 +00:00
|
|
|
.
|
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
2020-10-10 19:31:31 +00:00
|
|
|
\fB\-s\fR, \fB\-\-stack\-segment\-size\=\fIelem-count\fR
|
|
|
|
Specify size of each stack segment of Unlambda VM to
|
|
|
|
.IR elem-count .
|
|
|
|
Default: 256.
|
2020-01-30 10:11:10 +00:00
|
|
|
.TP
|
2020-10-10 19:31:31 +00:00
|
|
|
\fB\-p\fR, \fB\-\-pool\-size\fR=\fIelem-count\fR
|
|
|
|
Specify size of object pool of Unlambda VM to
|
|
|
|
.IR elem-count .
|
|
|
|
Deafult: 1048576.
|
2020-01-30 10:11:10 +00:00
|
|
|
.TP
|
|
|
|
\fB\-i\fR, \fB\-\-info\fR
|
2020-10-10 19:31:31 +00:00
|
|
|
Print info (version, segment size, etc.) corresponding to the
|
|
|
|
.IR bytecode-file ,
|
|
|
|
then exit.
|
2020-01-30 10:11:10 +00:00
|
|
|
.TP
|
|
|
|
\fB\-f\fR, \fB\-\-force\fR
|
2020-10-10 19:31:31 +00:00
|
|
|
Attempt to execute even when the
|
|
|
|
.I bytecode-file
|
|
|
|
version is not compatible.
|
|
|
|
Meanwhile, ignore unrecognizable instructions and data during execution.
|
2020-01-30 10:11:10 +00:00
|
|
|
.TP
|
|
|
|
\fB\-H\fR, \fB\-\-help\fR
|
|
|
|
Prints help message, then exit.
|
|
|
|
.TP
|
|
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
|
|
Prints version number, then exit.
|
|
|
|
.
|
|
|
|
.SH NOTES
|
|
|
|
.SS Bytecode Files
|
|
|
|
.TP
|
|
|
|
Version compatiblility:
|
2020-10-10 19:31:31 +00:00
|
|
|
Definition of Unlambda bytecode may differ across multiple versions of u6a.
|
2022-02-14 15:23:02 +00:00
|
|
|
Execution result is guaranteed to be consistent when both major and minor
|
|
|
|
versions of bytecode file and the interpreter matches. Otherwise, the code
|
|
|
|
may not work as expected and the interpreter will refuse to execute unless
|
2020-10-10 19:31:31 +00:00
|
|
|
.B -f
|
|
|
|
option is provided.
|
2020-01-30 10:11:10 +00:00
|
|
|
.TP
|
|
|
|
Redundant data:
|
2020-10-10 19:31:31 +00:00
|
|
|
While reading data from
|
|
|
|
.IR bytecode-file ,
|
|
|
|
any bytes before the first occurrence of magic number
|
|
|
|
.I 0xDC
|
|
|
|
is ignored.
|
|
|
|
The same is true for bytes after
|
|
|
|
.I .rodata
|
|
|
|
segment, however, if read from
|
|
|
|
.BR STDIN ,
|
|
|
|
they could be read by the current Unlambda program.
|
2020-01-30 10:11:10 +00:00
|
|
|
.
|
|
|
|
.SH SEE ALSO
|
2020-10-10 19:31:31 +00:00
|
|
|
.BR u6ac (1)
|
2020-01-30 10:11:10 +00:00
|
|
|
.
|
|
|
|
.SH COPYRIGHT
|
2020-10-10 19:31:31 +00:00
|
|
|
Copyright (c) 2020 CismonX <admin@cismon.net>
|
|
|
|
.PP
|
2022-02-14 15:23:02 +00:00
|
|
|
Copying and distribution of this file, with or without modification, are
|
|
|
|
permitted in any medium without royalty, provided the copyright notice and
|
|
|
|
this notice are preserved. This file is offered as-is, without any warranty.
|