165 lines
3.5 KiB
Forth
165 lines
3.5 KiB
Forth
# System Interaction
|
|
|
|
The `unix:` namespace contains words for interacting with the
|
|
host operating system on Unix style systems.
|
|
|
|
~~~
|
|
:io:unix-syscall (:n-)
|
|
DEVICE:UNIX io:scan-for
|
|
dup n:negative? [ drop 'Error:_UNIX_device_not_found s:put nl ] if;
|
|
io:invoke ;
|
|
~~~
|
|
|
|
`unix:system` runs another application using the system shell
|
|
and returns after execution is completed.
|
|
|
|
~~~
|
|
:unix:system (:s-) #0 io:unix-syscall ;
|
|
~~~
|
|
|
|
`unix:fork` forks the current process and returns a process
|
|
identifier.
|
|
|
|
~~~
|
|
:unix:fork (:-n) #1 io:unix-syscall ;
|
|
~~~
|
|
|
|
This group is used to execute a new process in place of the
|
|
current one. These take a program and optionally 1-3 arguments.
|
|
They map to the execl() system call.
|
|
|
|
Example:
|
|
|
|
'/usr/bin/cal '2 '2019 unix:exec2
|
|
|
|
~~~
|
|
:unix:exec0 (:s-) #2 io:unix-syscall ;
|
|
:unix:exec1 (:ss-) #3 io:unix-syscall ;
|
|
:unix:exec2 (:sss-) #4 io:unix-syscall ;
|
|
:unix:exec3 (:ssss-) #5 io:unix-syscall ;
|
|
~~~
|
|
|
|
`unix:exit` takes a return code and exits RRE, returning the
|
|
specified code.
|
|
|
|
~~~
|
|
:unix:exit (:n-) #6 io:unix-syscall ;
|
|
~~~
|
|
|
|
`unix:getpid` returns the current process identifier.
|
|
|
|
~~~
|
|
:unix:getpid (:-n) #7 io:unix-syscall ;
|
|
~~~
|
|
|
|
`unix:wait` waits for a child process to complete. This maps to
|
|
the wait() system call.
|
|
|
|
~~~
|
|
:unix:wait (:-n) #8 io:unix-syscall ;
|
|
~~~
|
|
|
|
`unix:kill` terminates a process. Takes a process and a signal
|
|
to send.
|
|
|
|
~~~
|
|
:unix:kill (:nn-) #9 io:unix-syscall ;
|
|
~~~
|
|
|
|
The next two words allow opening and closing pipes. The first,
|
|
`unix:popen` takes the name of a program and a file mode and
|
|
returns a file handle usable with words in the `file:` namespace.
|
|
The second, `unix:pclose` closes the pipe.
|
|
|
|
~~~
|
|
:unix:popen (:sn-n) #10 io:unix-syscall ;
|
|
:unix:pclose (:n-) #11 io:unix-syscall ;
|
|
~~~
|
|
|
|
`unix:chdir` changes the current working directory to the
|
|
specified one.
|
|
|
|
~~~
|
|
:unix:chdir (:s-) #13 io:unix-syscall ;
|
|
~~~
|
|
|
|
~~~
|
|
:unix:getenv (:sa-) #14 io:unix-syscall ;
|
|
:unix:putenv (:s-) #15 io:unix-syscall ;
|
|
~~~
|
|
|
|
`unix:sleep` pauses execution for the specified number of
|
|
seconds.
|
|
|
|
~~~
|
|
:unix:sleep (:n-) #16 io:unix-syscall ;
|
|
~~~
|
|
|
|
~~~
|
|
:unix:execute (:s-) #17 io:unix-syscall ;
|
|
~~~
|
|
|
|
|
|
~~~
|
|
:unix:pipe (:s-s)
|
|
file:R unix:popen &file:read-line &unix:pclose bi ;
|
|
~~~
|
|
|
|
~~~
|
|
:unix:get-cwd (:-s)c
|
|
'pwd unix:pipe s:trim '/ s:append ;
|
|
~~~
|
|
|
|
~~~
|
|
:unix:count-files-in-cwd (:-n)
|
|
'ls_-1_|_wc_-l unix:pipe s:trim s:to-number ;
|
|
~~~
|
|
|
|
~~~
|
|
:unix:for-each-file (:q-)
|
|
'ls_-1_-p file:R unix:popen
|
|
unix:count-files-in-cwd
|
|
[ [ file:read-line s:temp over call ] sip ] times
|
|
unix:pclose drop ;
|
|
~~~
|
|
|
|
~~~
|
|
{{
|
|
:start swap buffer:set file:R unix:popen ;
|
|
:read dup file:read dup buffer:add n:zero? ;
|
|
:finish unix:pclose buffer:size ;
|
|
---reveal---
|
|
:unix:slurp-pipe (:as-n)
|
|
[ start &read until finish ] buffer:preserve ;
|
|
}}
|
|
~~~
|
|
|
|
## d:source
|
|
|
|
~~~
|
|
'interface/unix.retro s:dedup
|
|
dup 'unix:slurp-pipe d:set-source
|
|
dup 'unix:for-each-file d:set-source
|
|
dup 'unix:count-files-in-cwd d:set-source
|
|
dup 'unix:get-cwd d:set-source
|
|
dup 'unix:pipe d:set-source
|
|
dup 'unix:execute d:set-source
|
|
dup 'unix:sleep d:set-source
|
|
dup 'unix:putenv d:set-source
|
|
dup 'unix:getenv d:set-source
|
|
dup 'unix:chdir d:set-source
|
|
dup 'unix:pclose d:set-source
|
|
dup 'unix:popen d:set-source
|
|
dup 'unix:kill d:set-source
|
|
dup 'unix:wait d:set-source
|
|
dup 'unix:getpid d:set-source
|
|
dup 'unix:exit d:set-source
|
|
dup 'unix:exec3 d:set-source
|
|
dup 'unix:exec2 d:set-source
|
|
dup 'unix:exec1 d:set-source
|
|
dup 'unix:exec0 d:set-source
|
|
dup 'unix:fork d:set-source
|
|
dup 'unix:system d:set-source
|
|
dup 'io:unix-syscall d:set-source
|
|
drop
|
|
~~~
|