OS-9 notes

It seems, there aren't any mentions about real Cobol I-Code interpreter, so Lua can use this Type/Language values.

Lua chunk can access their arguments via special table named argv. The element at index 0 is always set to the script name. At index n, the table has the total number of arguments passed to the chunk (without argv[0]), the first argument is at index 1, etc.

New options for Lua binaries

-m module args

execute module as OS-9 memory module and pass all args to it via argv.

-x

compile into OS-9 memory module and save output to default execution directory

-m

compile into OS-9 memory module

Changes to Lua language

• Lua accepts hexadecimal numeric constants in C-language notation (0x12FE). This feature is not fully implemented (for example, tonumber() function will return nil fot that numbers).
• The token '!=' may be used as an alias to '~='
• The symbol '!' may be used instead of '|' as a pipe symbol (see readfrom() for description)

OSKLIB - OS-9 System Functions

• Change current working directory
• Change current execution directory
• Suspend process
• Get current time
• Get information about current process
• Get directory listing
• Get information about a file
• Catch signals
• Check file accessibility
• Read without echo
• Set user ID
• Execute Lua chunk in OS-9 memory module

In the pattern string, '*' matches any sequence of characters, `?' matches any character, [SET] matches any character in the specified set,  [^SET] matches any character not in the specified set. A set is composed of characters or ranges; a range looks like  character hyphen character (as in 0-9 or A-Z).  [0-9a-zA-Z_] is the set of characters allowed in C identifiers.  Any other character in the pattern must be matched exactly. To suppress the special syntactic significance of any of '[]*?^-\',  and match the character exactly, precede it with a '\'.
NOTE:The lower/upercase leters are different!

time()

This function returns a value approximating the current Calendar Time. Returns -1 to indicate an error.

access(file [ ,mode])

This function checks the file accessibility of the file named file, for the permissions indicated in the argument mode, a string containing any combination of the characters r,w,e,f with the following meanings:

'r'	File can be read
'w'	File can be written
'e'	File can be executed (and located in the default exec directory)
'f'	File exists

getpass([prompt])

This functions displays prompt and reads from the standard input turning off character echoing. Returns the user input string.

setuid(uid)

This functions sets the group/user ID of the current Lua process to uid. If the call fails, nil is returned with a string describing the error, otherwise it returns the number 0. uid must be in the notation "gid.uid", "21.34" for example.

stat(file [ ,selectorstring])

This function gets information about a file specified in file, that can be either a string containing a valid pathname, or an userdata object containing a file pointer (got from readfrom() or writeto() calls, for example). If the selectorstring argument is missing, stat returns a table with the fields shown in the table below. If a selector string is passed as second argument, only the value requested is returned. All fields are numeric values. File must be an RBF file.

mode	File mode
amode	File mode as a string (like "dsewrewr")
uid	User ID of the owner of the file
gid	Group ID of the owner of the file
size	File size in bytes
mtime	Time of last data modification
ctime	Time of file creation

intercept(func)

Sets the signal handler. func must be a function or nil, in which case the default signal handler is restored. The default handler just issues an error message and terminates the program (via exit call)
func is called with one argument, which is a signal number.

domodule(modname [, errormethod])

This function executes a given module as a Lua chunk. If there is any error executing the module, it returns nil. Otherwise, it returns the values returned by the chunk, or a non nil value if the chunk returns no values. If provided, errormethod is temporary set as the error method, while module runs. As an example, if errormethod  is nil, no error messages will be issued during the execution of the module.