90 lines
2.2 KiB
HTML
90 lines
2.2 KiB
HTML
<!DOCTYPE html>
|
|
<!--
|
|
Copyright 2021 Bradley D. Nelson
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<head>
|
|
#include "head.html"
|
|
<title>µEforth for Linux</title>
|
|
</head>
|
|
|
|
<body>
|
|
<h1>µEforth for Linux</h1>
|
|
#include "menu.html"
|
|
<div class="wrapper">
|
|
|
|
<h2>Building</h2>
|
|
|
|
<p>Linux builds of µEforth are no longer published as this isn't really ideal for Linux anyway.</p>
|
|
<p>
|
|
Instead build as follows:
|
|
<pre>
|
|
sudo apt install ninja-build
|
|
git clone https://github.com/flagxor/ueforth
|
|
cd ueforth
|
|
./configure.py
|
|
ninja
|
|
</pre>
|
|
</p>
|
|
|
|
<p>
|
|
<a href="https://github.com/flagxor/ueforth" target="_blank">http://github.com/flagxor/ueforth</a>
|
|
- Complete Unprocessed Source Code
|
|
</p>
|
|
|
|
<h2>µEforth</h2>
|
|
|
|
<h3>µEforth Words</h3>
|
|
|
|
#include "common.html"
|
|
#include "files_common.html"
|
|
#include "posix_common.html"
|
|
|
|
<h3>Linux</h3>
|
|
|
|
<h4>Linux Opcodes</h4>
|
|
|
|
<p>
|
|
Linux libraries and the operating system can be accessed via the use
|
|
of the <code>DLSYM</code> word. Functions can be requested by name from
|
|
particular modules. As the dynamic linking module is already loaded initially,
|
|
a 0 for the module allows the library loading function (<code>dlopen</code>)
|
|
to be loaded from Forth.
|
|
</p>
|
|
|
|
<pre>
|
|
DLSYM ( module name-z -- fn )
|
|
</pre>
|
|
|
|
<p>
|
|
See <a href="https://github.com/flagxor/ueforth/blob/main/posix/posix_main.c">posix_main.c</a>.
|
|
</p>
|
|
|
|
<p>
|
|
Native functions all called with CALL(n) (see Windows & Linux Calling below).
|
|
</p>
|
|
|
|
<h4>Linux Imports</h4>
|
|
|
|
<p>
|
|
Various Linux calls including Xlib are imported in
|
|
<a href="https://github.com/flagxor/ueforth/blob/main/posix/posix.fs">posix.fs</a> and
|
|
<a href="https://github.com/flagxor/ueforth/blob/main/posix/xlib.fs">xlib.fs</a>.
|
|
In addition, <code>TYPE</code> and <code>KEY</code> are connected to
|
|
<code>stdin</code> and <code>stdout</code>.
|
|
</p>
|
|
|
|
#include "desktop_common.html"
|