|
996
|
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36.
|
|
|
2 .TH CFUNGE "1" "July 2009" "cfunge 0.9.0" "User Commands"
|
|
|
3 .SH NAME
|
|
|
4 cfunge \- A fast Befunge93/98/109 interpreter in C
|
|
|
5 .SH SYNOPSIS
|
|
|
6 .B cfunge
|
|
|
7 [\fIOPTIONS\fR] [\fIFILE\fR] [\fIPROGRAM OPTIONS\fR]
|
|
|
8 .SH DESCRIPTION
|
|
|
9 A fast Befunge interpreter in C
|
|
|
10 .TP
|
|
|
11 \fB\-b\fR
|
|
|
12 Use fully buffered output (default is system default for stdout).
|
|
|
13 .TP
|
|
|
14 \fB\-E\fR
|
|
|
15 Show non\-fatal error messages, fatal ones are always shown.
|
|
|
16 .TP
|
|
|
17 \fB\-F\fR
|
|
|
18 Disable all fingerprints.
|
|
|
19 .TP
|
|
|
20 \fB\-f\fR
|
|
|
21 Show list of features and fingerprints supported in this binary.
|
|
|
22 .TP
|
|
|
23 \fB\-h\fR
|
|
|
24 Show this help and exit.
|
|
|
25 .TP
|
|
|
26 \fB\-S\fR
|
|
|
27 Enable sandbox mode (see README for details).
|
|
|
28 .TP
|
|
|
29 \fB\-s\fR standard
|
|
|
30 Use the given standard (one of 93, 98 [default] and 109).
|
|
|
31 .TP
|
|
|
32 \fB\-t\fR level
|
|
|
33 Use given trace level. Default 0.
|
|
|
34 .TP
|
|
|
35 \fB\-V\fR
|
|
|
36 Show version and copyright info and exit.
|
|
|
37 .TP
|
|
|
38 \fB\-v\fR
|
|
|
39 Show version and build info and exit.
|
|
|
40 .TP
|
|
|
41 \fB\-W\fR
|
|
|
42 Show warnings.
|
|
|
43 .SH "SANDBOX MODE"
|
|
|
44 Sandbox mode prevents Funge programs from doing "harmful" things, this includes,
|
|
|
45 but is not limited to:
|
|
|
46 .TP
|
|
|
47 Any file or filesystem IO is forbidden.
|
|
|
48 .TP
|
|
|
49 The list of environment variables the program can see in y are restricted.
|
|
|
50 .TP
|
|
|
51 Non-safe fingerprints can not be loaded (this includes network and file system access as well as other things).
|
|
|
52 .SH "IMPLEMENTATION DEFINED BEHAVIOUR"
|
|
|
53 The Befunge98 standard leaves some things undefined, here is what cfunge do for some of those cases:
|
|
|
54 .TP
|
|
|
55 y pushes time in UTC not local time.
|
|
|
56 .TP
|
|
|
57 k with a negative argument reflects.
|
|
|
58 .TP
|
|
|
59 # across edge of Funge-Space may or may not skip first char after wrapping depending on exact situation.
|
|
|
60 .TP
|
|
|
61 ( and ) with a negative count reflects and doesn't pop any fingerprint.
|
|
|
62 .TP
|
|
|
63 Loaded fingerprints are inherited to child IPs at split (t).
|
|
|
64 .TP
|
|
|
65 Standard output is flushed at the end of the program and just before any instruction reading standard input. However it is of course possible that the operating system decides to flush anyway.
|
|
|
66 .TP
|
|
|
67 Standard input is read one line at a time and buffered internally. Those instructions reading chars fetch one char from this buffer, leaving the rest (if any) including any ending newline. Instructions reading an integer will leave anything after the integer in the buffer with one exception: if the next char is a newline it will be discarded.
|
|
|
68 .SH FINGERPRINTS
|
|
|
69 Short descriptions of implemented fingerprints:
|
|
|
70 .TP
|
|
|
71 3DSP
|
|
|
72 3D space manipulation extension
|
|
|
73 .TP
|
|
|
74 BASE
|
|
|
75 I/O for numbers in other bases
|
|
|
76 .TP
|
|
|
77 CPLI
|
|
|
78 Complex Integer extension
|
|
|
79 .TP
|
|
|
80 DATE
|
|
|
81 Date Functions
|
|
|
82 .TP
|
|
|
83 DIRF
|
|
|
84 Directory functions extension (not available in sandbox mode)
|
|
|
85 .TP
|
|
|
86 FILE
|
|
|
87 File I/O functions (not available in sandbox mode)
|
|
|
88 .TP
|
|
|
89 FING
|
|
|
90 Operate on single fingerprint semantics
|
|
|
91 .TP
|
|
|
92 FIXP
|
|
|
93 Some useful math functions
|
|
|
94 .TP
|
|
|
95 FPDP
|
|
|
96 Double precision floating point
|
|
|
97 .TP
|
|
|
98 FPSP
|
|
|
99 Single precision floating point
|
|
|
100 .TP
|
|
|
101 FRTH
|
|
|
102 Some common forth commands
|
|
|
103 .TP
|
|
|
104 HRTI
|
|
|
105 High-Resolution Timer Interface
|
|
|
106 .TP
|
|
|
107 INDV
|
|
|
108 Pointer functions
|
|
|
109 .TP
|
|
|
110 JSTR
|
|
|
111 Read and write strings in Funge-Space
|
|
|
112 .TP
|
|
|
113 MODU
|
|
|
114 Modulo Arithmetic
|
|
|
115 .TP
|
|
|
116 NCRS
|
|
|
117 ncurses extension
|
|
|
118 .TP
|
|
|
119 NULL
|
|
|
120 Null Fingerprint
|
|
|
121 .TP
|
|
|
122 ORTH
|
|
|
123 Orthogonal Easement Library
|
|
|
124 .TP
|
|
|
125 PERL
|
|
|
126 Generic Interface to the Perl Language (not available in sandbox mode)
|
|
|
127 .TP
|
|
|
128 REFC
|
|
|
129 Referenced Cells Extension
|
|
|
130 .TP
|
|
|
131 REXP
|
|
|
132 Regular Expression Matching
|
|
|
133 .TP
|
|
|
134 ROMA
|
|
|
135 Roman Numerals
|
|
|
136 .TP
|
|
|
137 SCKE
|
|
|
138 TCP/IP async socket and dns resolving extension (not available in sandbox mode)
|
|
|
139 .TP
|
|
|
140 SOCK
|
|
|
141 TCP/IP socket extension (not available in sandbox mode)
|
|
|
142 .TP
|
|
|
143 STRN
|
|
|
144 String functions
|
|
|
145 .TP
|
|
|
146 SUBR
|
|
|
147 Subroutine extension
|
|
|
148 .TP
|
|
|
149 TERM
|
|
|
150 Terminal control functions
|
|
|
151 .TP
|
|
|
152 TIME
|
|
|
153 Time and Date functions
|
|
|
154 .TP
|
|
|
155 TOYS
|
|
|
156 Funge-98 Standard Toys
|
|
|
157 .TP
|
|
|
158 TURT
|
|
|
159 Simple Turtle Graphics Library
|
|
|
160 .LP
|
|
|
161 For more details please see the specs for each fingerprint.
|
|
|
162 In cases of undefined behaviour in fingerprints, cfunge mostly tries to do the
|
|
|
163 same thing as CCBI.
|
|
|
164 .SH AUTHOR
|
|
|
165 Written by Arvid Norlander.
|
|
|
166 .SH COPYRIGHT
|
|
|
167 Copyright \(co 2008-2009 Arvid Norlander.
|
|
|
168 .br
|
|
|
169 This is free software. You may redistribute copies of it under the terms of
|
|
|
170 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
|
|
|
171 There is NO WARRANTY, to the extent permitted by law.
|
