omake-system(1)
NAME
- omake is a flexible build system designed for building a
- wide variety of projects. This document describes the functions
- for interacting with the operating system, including commands for
- input/output, and system commands for information about the
- filesystem. For an overview of omake, see the omake(1) man page.
IO FUNCTIONS
- STANDARD CHANNELS
- The following variables define the standard channels.
- stdin
- stdin : InChannel
- The standard input channel, open for reading.
- stdout
stdout : OutChannel
- The standard output channel, open for writing.
- stderr
stderr : OutChannel
- The standard error channel, open for writing.
- FOPEN
- The fopen function opens a file for reading or writing.
$(fopen file, mode) : Channelfile : File
mode : StringThe file is the name of the file to be opened. The modeis a combination of the following characters.r Open the file for reading; it is an error if thefile does not exist.w Open the file for writing; the file is created ifit does not exist.a Open the file in append mode; the file is createdif it does not exist.+ Open the file for both reading an writing.t Open the file in text mode (default).b Open the file in binary mode.n Open the file in nonblocking mode.x Fail if the file already exists.Binary mode is not significant on Unix systems, where textand binary modes are equivalent. - CLOSE
- $(close channel...)
channel : Channel
- The close function closes a file that was previously
- opened with fopen.
- READ
- $(read channel, amount) : String
channel : InChannel
amount : Int - raises RuntimeException
- The read function reads up to amount bytes from an input
- channel, and returns the data that was read. If an end-of-file
- condition is reached, the function raises a RuntimeException ex
- ception.
- WRITE
- $(write channel, buffer, offset, amount) : String
channel : OutChannel
buffer : String
offset : Int
amount : Int - $(write channel, buffer) : String
channel : OutChannel
buffer : String - raises RuntimeException
- In the 4-argument form, the write function writes bytes to
- the output channel channel from the buffer, starting at position
- offset. Up to amount bytes are written. The function returns the
- number of bytes that were written.
- The 3-argument form is similar, but the offset is 0.
- In the 2-argument form, the offset is 0, and the amount if
- the length of the buffer.
- If an end-of-file condition is reached, the function rais
- es a RuntimeException exception.
- LSEEK
- $(lseek channel, offset, whence) : Int
channel : Channel
offset : Int
whence : String - raises RuntimeException
- The lseek function repositions the offset of the channel
- channel according to the whence directive, as follows:
- SEEK_SET
- The offset is set to offset.
- SEEK_CUR
- The offset is set to its current position plus off
- set bytes.
- SEEK_END
- The offset is set to the size of the file plus off
- set bytes.
- The lseek function returns the new position in the file.
- REWIND
- rewind(channel...)
channel : Channel
- The rewind function set the current file position to the
- beginning of the file.
- TELL
- $(tell channel...) : Int...
channel : Channel
- raises RuntimeException
- The tell function returns the current position of the
- channel.
- FLUSH
- $(flush channel...)
channel : OutChannel
- The flush function can be used only on files that are open
- for writing. It flushes all pending data to the file.
- DUP
- $(dup channel) : Channel
channel : Channel
- raises RuntimeException
- The dup function returns a new channel referencing the
- same file as the argument.
- DUP2
- dup2(channel1, channel2)
channel1 : Channel
channel2 : Channel - raises RuntimeException
- The dup2 function causes channel2 to refer to the same
- file as channel1.
- SET-NONBLOCK
- set-nonblock-mode(mode, channel...)
channel : Channel
mode : String - The set-nonblock-mode function sets the nonblocking flag
- on the given channel. When IO is performed on the channel, and
- the operation cannot be completed immediately, the operations
- raises a RuntimeException.
- SET-CLOSE-ON-EXEC-MODE
- set-close-on-exec-mode(mode, channel...)
channel : Channel
mode : String - raises RuntimeException
- The set-close-on-exec-mode function sets the close-on-exec
- flags for the given channels. If the close-on-exec flag is set,
- the channel is not inherited by child processes. Otherwise it is.
- PIPE
- $(pipe) : Pipe
raises RuntimeException - The pipe function creates a Pipe object, which has two
- fields. The read field is a channel that is opened for reading,
- and the write field is a channel that is opened for writing.
- MKFIFO
- mkfifo(mode, node...)
mode : Int
node : Node - The mkfifo function creates a named pipe.
- SELECT
- $(select rfd..., wfd..., wfd..., timeout) : Select
rfd : InChannel
wfd : OutChannel
efd : Channel
timeout : float - raises RuntimeException
- The select function polls for possible IO on a set of
- channels. The rfd are a sequence of channels for reading, wfd
- are a sequence of channels for writing, and efd are a sequence of
- channels to poll for error conditions. The timeout specifies the
- maximum amount of time to wait for events.
- On successful return, select returns a Select object,
- which has the following fields:
- read An array of channels available for reading.
- write An array of channels available for writing.
- error An array of channels on which an error has oc
- curred.
- LOCKF
- lockf(channel, command, len)
channel : Channel
command : String
len : Int - raises RuntimeException
- The lockf function places a lock on a region of the chan
- nel. The region starts at the current position and extends for
- len bytes.
- The possible values for command are the following.
- F_ULOCK
- Unlock a region.
- F_LOCK Lock a region for writing; block if already locked.
- F_TLOCK
- Lock a region for writing; fail if already locked.
- F_TEST Test a region for other locks.
- F_RLOCK
- Lock a region for reading; block if already locked.
- F_TRLOCK
- Lock a region for reading; fail is already locked.
- INETADDR
- The InetAddr object describes an Internet address. It
- contains the following fields.
- addr String: the Internet address.
- port Int: the port number.
- HOST
- A Host object contains the following fields.
- name String: the name of the host.
- aliases
String Array: other names by which the host isknown.
- addrtype
String: the preferred socket domain.
- addrs InetAddr Array: an array of Internet addresses be
- longing to the host.
- GETHOSTBYNAME
- $(gethostbyname host...) : Host...
host : String
- raises RuntimeException
- The gethostbyname function returns a Host object for the
- specified host. The host may specify a domain name or an Internet
- address.
- PROTOCOL
- The Protocol object represents a protocol entry. It has
- the following fields.
- name String: the canonical name of the protocol.
- aliases
String Array: aliases for the protocol.
- proto Int: the protocol number.
- GETPROTOBYNAME
- $(getprotobyname name...) : Protocol...
name : Int or String
- raises RuntimeException
- The getprotobyname function returns a Protocol object for
- the specified protocol. The name may be a protocol name, or a
- protocol number.
- SERVICE
- The Service object represents a network service. It has
- the following fields.
- name String: the name of the service.
- aliases
String Array: aliases for the service.
- port Int: the port number of the service.
- proto Protocol: the protocol for the service.
- GETSERVBYNAME
- $(getservbyname service...) : Service...
service : String or Int
- raises RuntimeException
- The getservbyname function gets the information for a net
- work service. The service may be specified as a service name or
- number.
- SOCKET
- $(socket domain, type, protocol) : Channel
domain : String
type : String
protocol : String - raises RuntimeException
- The socket function creates an unbound socket.
- The possible values for the arguments are as follows.
- The domain may have the following values.
- PF_UNIX or unix
- Unix domain, available only on Unix systems.
- PF_INET or inet
- Internet domain, IPv4.
- PF_INET6 or inet6
- Internet domain, IPv6.
- The type may have the following values.
- SOCK_STREAM or stream
- Stream socket.
- SOCK_DGRAM or dgram
- Datagram socket.
- SOCK_RAW or raw
- Raw socket.
- SOCK_SEQPACKET or seqpacket
- Sequenced packets socket
- The protocol is an Int or String that specifies a protocol
- in the protocols database.
- BIND
- bind(socket, host, port)
socket : InOutChannel
host : String
port : Int - bind(socket, file)
socket : InOutChannel
file : File - raise RuntimeException
- The bind function binds a socket to an address.
- The 3-argument form specifies an Internet connection, the
- host specifies a host name or IP address, and the port is a port
- number.
- The 2-argument form is for Unix sockets. The file speci
- fies the filename for the address.
- LISTEN
- listen(socket, requests)
socket : InOutChannel
requests : Int - raises RuntimeException
- The listen function sets up the socket for receiving up to
- requests number of pending connection requests.
- ACCEPT
- $(accept socket) : InOutChannel
socket : InOutChannel
- raises RuntimeException
- The accept function accepts a connection on a socket.
- CONNECT
- connect(socket, addr, port)
socket : InOutChannel
addr : String
port : int - connect(socket, name)
socket : InOutChannel
name : File - raise RuntimeException
- The connect function connects a socket to a remote ad
- dress.
- The 3-argument form specifies an Internet connection. The
- addr argument is the Internet address of the remote host, speci
- fied as a domain name or IP address. The port argument is the
- port number.
- The 2-argument form is for Unix sockets. The name argument
- is the filename of the socket.
- GETCHAR
- $(getc) : String
$(getc file) : Stringfile : InChannel or File - raises RuntimeException
- The getc function returns the next character of a file.
- If the argument is not specified, stdin is used as input. If the
- end of file has been reached, the function returns false.
- GETS
- $(gets) : String
$(gets channel) : Stringchannel : InChannel or File - raises RuntimeException
- The gets function returns the next line from a file. The
- function returns the empty string if the end of file has been
- reached. The line terminator is removed.
- FGETS
- $(fgets) : String
$(fgets channel) : Stringchannel : InChannel or File - raises RuntimeException
- The fgets function returns the next line from a file that
- has been opened for reading with fopen. The function returns the
- empty string if the end of file has been reached. The returned
- string is returned as literal data. The line terminator is not
- removed.
- PRINTING FUNCTIONS
- Output is printed with the print and println functions.
- The println function adds a terminating newline to the value be
- ing printed, the print function does not.
fprint(<file>, <string>)
print(<string>)
eprint(<string>)
fprintln(<file>, <string>)
println(<string>)
eprintln(<string>) - The fprint functions print to a file that has been previ
- ously opened with fopen. The print functions print to the stan
- dard output channel, and the eprint functions print to the stan
- dard error channel.
- VALUE PRINTING FUNCTIONS
- Values can be printed with the printv and printvln func
- tions. The printvln function adds a terminating newline to the
- value being printed, the printv function does not.
fprintv(<file>, <string>)
printv(<string>)
eprintv(<string>)
fprintvln(<file>, <string>)
printvln(<string>)
eprintvln(<string>) - The fprintv functions print to a file that has been previ
- ously opened with fopen. The printv functions print to the stan
- dard output channel, and the eprintv functions print to the stan
- dard error channel.
HIGHER-LEVEL IO FUNCTIONS
- REGULAR EXPRESSIONS
- Many of the higher-level functions use regular expres
- sions. Regular expressions are defined by strings with syntax
- nearly identical to awk(1).
- Strings may contain the following character constants.
- * : a literal backslash.
- * : the alert character ^G.
- * :the backspace character ^H.
- * : the formfeed character ^L.
- * : the newline character ^J.
: the carriage return character ^M.
- *
- * : the tab character ^I.
- * : the vertical tab character.
- * ... : the character represented by the string of
- hexadecimal digits h. All valid hexadecimal digits following the
- sequence are considered to be part of the sequence.
- * dd : the character represented by 1, 2, or 3 octal
- digits.
- Regular expressions are defined using the special charac
- ters .$[(){}*?+.
- * c : matches the literal character c if c is not a
- special character.
- *
* . : matches any character, including newline. - * ^ : matches the beginning of a line.
- * $ : matches the end of line.
- * [abc...] : matches any of the characters abc...
- * [^abc...] : matches any character except abc...
- * r1|r2 : matches either r1 or r2.
- * r1r2 : matches r1 and then r2.
- * r+ : matches one or more occurrences of r.
- * r* : matches zero or more occurrences of r.
- * r? : matches zero or one occurrence of r.
- * (r) : parentheses are used for grouping; matches r.
- * : also defines grouping, but the expression
- matched within the parentheses is available to the output proces
- sor through one of the variables $1, $2, ...
- * r{n} : matches exactly n occurrences of r.
- * r{n,} : matches n or more occurrences of r.
- * r{n,m} : matches at least n occurrences of r, and
- no more than m occurrences.
- * y: matches the empty string at either the beginning
- or end of a word.
- * 0 matches the empty string within a word.
- * <: matches the empty string at the beginning of a
- word.
- * >: matches the empty string at the end of a word.
- * 792
- * W: matches any character that does not occur within
- a word.
- * `: matches the empty string at the beginning of a
- file.
- * ´: matches the empty string at the end of a file.
- Character classes can be used to specify character se
- quences abstractly. Some of these sequences can change depending
- on your LOCALE.
- * [:alnum:] Alphanumeric characters.
- * [:alpha:] Alphabetic characters.
- * [:lower:] Lowercase alphabetic characters.
- * [:upper:] Uppercase alphabetic characters.
- * [:cntrl:] Control characters.
- * [:digit:] Numeric characters.
- * [:xdigit:] Numeric and hexadecimal characters.
- * [:graph:] Characters that are printable and visi
- ble.
- * [:print:] Characters that are printable, whether
- they are visible or not.
- * [:punct:] Punctuation characters.
- * [:blank:] Space or tab characters.
- * [:space:] Whitespace characters.
- CAT
- cat(files) : Sequence
files : File or InChannel Sequence
- The cat function concatenates the output from multiple
- files and returns it as a string.
- GREP
- grep(pattern) : String # input from stdin, default op
- tions
pattern : String
- grep(pattern, files) : String # default options
pattern : String
files : File Sequence - grep(options, pattern, files) : String
options : String
pattern : String
files : File Sequence - The grep function searches for occurrences of a regular
- expression pattern in a set of files, and prints lines that
- match. This is like a highly-simplified version of grep(1).
- The options are:
- q If specified, the output from grep is not dis
- played.
- n If specified, output lines include the filename.
- The pattern is a regular expression.
- If successful (grep found a match), the function returns
- true. Otherwise, it returns false.
- AWK
- awk(input-files)
case pattern1:body1 - case pattern2:
body2
- ...
default:bodyd - The awk function provides input processing similar to
- awk(1), but more limited. The function takes filename arguments.
- If called with no a.guThetdefaultivalueioftFSeisfthe
- regularIexpressions[a]+.provided, each specifies an InChannel, or
- the name of a file for input. Output is always to stdout.
- The variables RS and FS define record and field separators
- as regular expressions. The default value of RS is the regular
- expression
- The awk function operates by reading the input one record
- at a time, and processing it according to the following algo
- rithm.
- For each line, the record is first split into fields using
- the field separatorgFS, and the fields are bound to the variables
- $1, $2, .... The variable $0 is defined to be the entire line,
- and $* is an array of all the field values. The $(NF) variable is
- defined to be the number of fields.
i
- Next, the cases are evaluated in order. For each case, if
- the regular expressnon pattern_i matches the record $0, then
- body_i is evaluated. If the body ends in an export, the state is
- passed to the next clause. Otherwise the value is discarded. If
- the regular expression contains expression, those expression
- override the fields $1, $2, ....
{
- For example, here is an awk function to print the text be
- tween two delimiters <>} and 0{<name>}, where the <name> must be
- long to a set passed as an argument to the filter function.
n
- filter(names) =
- a
print = falsemawk(Awk.in)
case $"^0alpha:]+"if $(mem $1, $(names))prgnt = false
exiortexporndefault aif $(lrint)prpntln($0)case $"^hprinta= $(mem $1, $(names))
export]
+Note, if you want to redirect the output to a file, theeasiest way is to redefine the stdout variable. The stdout variable is scoped the same way as other variables, so this definition does not affect the meaning of stdout outside the filterfunction.
filter(names) =stdout = $(fopen file.out, w)
awk(Awk.in)...close(stdout) - FSUBST
- fsubst(files)
case pattern1 [options]body1 - case pattern2 [options]
body2
- ...
defaultbodyd - The fsubst function provides a sed(1)-like substitution
- function. Similar to awk, if fsubst is called with no arguments,
- the input is t.ken from stdin. If arguments are provided, each
- specifies an InChannel, or the name of a file for input.
- The RS variable defines a regular expression that deter
- mines a record separator, The default value of RS is the regular
- expression
- The fsubst function reads the file one record at a time.
- For each record, the cases are evaluated in order. Each
- case defines a substitution from a substring matching the pattern
- to replacement text defined by the body.
- Currently, there is only one option: g. If specified,
- each clause specifies a global replacement, and all instances of
- the pattern define a substitution. Otherwise, the substitution
- is applied only once.
- Output can be redirected by redefining the stdout vari
- able.
- For example, the following program replaces all occur
- rences of an expression word. with its capitalized form.
sectionstdout = $(fopen Subst.out, w)
fsubst(Subst.in)
case $"<:alnum:]]+." gvalue $(capitalize $1).close(stdout) - LEXER
- The Lexer object defines a facility for lexical analysis,
- similar to the lex(1) and flex(1) programs.
- In omake, lexical analyzers can be constructed dynamically
- by extending the Lexer class. A lexer definition consists of a
- set of directives specified with method calls, and set of clauses
- specified as rules.
- For example, consider the following lexer definition,
- which is intended for lexical analysis of simple arithmetic ex
- pressions for a desktop calculator.
lexer1. =extends $(Lexer)other: .eprintln(Illegal character: $* )
lex()white: $"[[:space:]]+"lex()op: $"[-+*/()]"switch $*
case +Token.unit($(loc), plus)caseToken.unit($(loc), minus)case *Token.unit($(loc), mul)case /Token.unit($(loc), div)case $"("Token.unit($(loc), lparen)case $")"Token.unit($(loc), rparen)number: $"[[:digit:]]+"Token.pair($(loc), exp, $(int $* ))eof: $"´"Token.unit($(loc), eof) - This program defines an object lexer1 the extends the Lex
- er object, which defines lexing environment.
- The remainder of the definition consists of a set of
- clauses, each with a method name before the colon; a regular ex
- pression after the colon; and in this case, a body. The body is
- optional, if it is not specified, the method with the given name
- should already exist in the lexer definition.
- NB The clause that matches the longest prefix of the input
- is selected. If two clauses match the same input prefix, then the
- last one is selected. This is unlike most standard lexers, but
- makes more sense for extensible grammars.
- The first clause matches any input that is not matched by
- the other clauses. In this case, an error message is printed for
- any unknown character, and the input is skipped. Note that this
- clause is selected only if no other clause matches.
- The second clause is responsible for ignoring white space.
- If whitespace is found, it is ignored, and the lexer is called
- recursively.
- The third clause is responsible for the arithmetic opera
- tors. It makes use of the Token object, which defines three
- fields: a loc field that represents the source location; a name;
- and a value.
- The lexer defines the loc variable to be the location of
- the current lexeme in each of the method bodies, so we can use
- that value to create the tokens.
- The Token.unit($(loc), name) method constructs a new Token
- object with the given name, and a default value.
- The number clause matches nonnegative integer constants.
- The Token.pair($(loc), name, value) constructs a token with the
- given name and value.
- Lexer object operate on InChannel objects. The method
- lexer1.lex-channel(channel) reads the next token from the channel
- argument.
- LEXER MATCHING
- During lexical analysis, clauses are selected by longest
- match. That is, the clause that matches the longest sequence of
- input characters is chosen for evaluation. If no clause matches,
- the lexer raises a RuntimeException. If more than one clause
- matches the same amount of input, the first one is chosen for
- evaluation.
- EXTENDING LEXER DEFINITIONS
- Suppose we wish to augment the lexer example so that it
- ignores comments. We will define comments as any text that begins
- with the string (*, ends with *), and comments may be nested.
- One convenient way to do this is to define a separate lex
- er just to skip comments.
lex-comment. =extends $(Lexer)level = 0other: .lex()term: $"[*][)]"if $(not $(eq $(level), 0))level = $(sub $(level), 1)
lex()next: $"[(][*]"level = $(add $(level), 1)
lex()eof: $"´"eprintln(Unterminated comment) - This lexer contains a field level that keeps track of the
- nesting level. On encountering a (* string, it increments the
- level, and for *), it decrements the level if nonzero, and con
- tinues.
- Next, we need to modify our previous lexer to skip com
- ments. We can do this by extending the lexer object lexer1 that
- we just created.
lexer1. +=comment: $"[(][*]"lex-comment.lex-channel($(channel))
lex()- The body for the comment clause calls the lex-comment lex
- er when a comment is encountered, and continues lexing when that
- lexer returns.
- THREADING THE LEXER OBJECT
- Clause bodies may also end with an export directive. In
- this case the lexer object itself is used as the returned token.
- If used with the Parser object below, the lexer should define the
- loc, name and value fields in each export clause. Each time the
- Parser calls the lexer, it calls it with the lexer returned from
- the previous lex invocation.
- PARSER
- The Parser object provides a facility for syntactic analy
- sis based on context-free grammars.
- Parser objects are specified as a sequence of directives,
- specified with method calls; and productions, specified as rules.
- For example, let's finish building the desktop calculator
- started in the Lexer example.
parser1. =extends $(Parser)#
# Use the main lexer
#
lexer = $(lexer1)#
# Precedences, in ascending order
#
left(plus minus)
left(mul div)
right(uminus)#
# A program
#
start(prog)prog: exp eofreturn $1#
# Simple arithmetic expressions
#
exp: minus exp :prec: uminusneg($2)exp: exp plus expadd($1, $3)exp: exp minus expsub($1, $3)exp: exp mul expmul($1, $3)exp: exp div expdiv($1, $3)exp: lparen exp rparenreturn $2 - Parsers are defined as extensions of the Parser class. A
- Parser object must have a lexer field. The lexer is not required
- to be a Lexer object, but it must provide a lexer.lex() method
- that returns a token object with name and value fields. For this
- example, we use the lexer1 object that we defined previously.
- The next step is to define precedences for the terminal
- symbols. The precedences are defined with the left, right, and
- nonassoc methods in order of increasing precedence.
- The grammar must have at least one start symbol, declared
- with the start method.
- Next, the productions in the grammar are listed as rules.
- The name of the production is listed before the colon, and a se
- quence of variables is listed to the right of the colon. The
- body is a semantic action to be evaluated when the production is
- recognized as part of the input.
- In this example, these are the productions for the arith
- metic expressions recognized by the desktop calculator. The se
- mantic action performs the calculation. The variables $1, $2, ...
- correspond to the values associated with each of the variables on
- the right-hand-side of the production.
- CALLING THE PARSER
- The parser is called with the $(parser1.parse-channel
- start, channel) or $(parser1.parse-file start, file) functions.
- The start argument is the start symbol, and the channel or file
- is the input to the parser.
- PARSING CONTROL
- The parser generator generates a pushdown automation based
- on LALR(1) tables. As usual, if the grammar is ambiguous, this
- may generate shift/reduce or reduce/reduce conflicts. These con
- flicts are printed to standard output when the automaton is gen
- erated.
- By default, the automaton is not constructed until the
- parser is first used.
- The build(debug) method forces the construction of the au
- tomaton. While not required, it is wise to finish each complete
- parser with a call to the build(debug) method. If the debug vari
- able is set, this also prints with parser table together with any
- conflicts.
- The loc variable is defined within action bodies, and rep
- resents the input range for all tokens on the right-hand-side of
- the production.
- EXTENDING PARSERS
- Parsers may also be extended by inheritance. For example,
- let's extend the grammar so that it also recognizes the << and >>
- shift operations.
- First, we extend the lexer so that it recognizes these to
- kens. This time, we choose to leave lexer1 intact, instead of
- using the += operator.
lexer2. =extends $(lexer1)lsl: $"<<"Token.unit($(loc), lsl)asr: $">>"Token.unit($(loc), asr) - Next, we extend the parser to handle these new operators.
- We intend that the bitwise operators have lower precedence than
- the other arithmetic operators. The two-argument form of the left
- method accomplishes this.
parser2. =extends $(parser1)left(plus, lsl lsr asr)lexer = $(lexer2)exp: exp lsl explsl($1, $3)exp: exp asr expasr($1, $3)- In this case, we use the new lexer lexer2, and we add pro
- ductions for the new shift operations.
- GETTIMEOFDAY
- $(gettimeofday) : Float
- The gettimeofday function returns the time of day in sec
- onds since January 1, 1970.
SHELL FUNCTIONS
- ECHO
- The echo function prints a string.
- $(echo <args>) echo <args>
- JOBS
- The jobs function prints a list of jobs.
- jobs
- CD
- The cd function changes the current directory.
cd(dir)dir : DirThe cd function also supports a 2-argument form:
$(cd dir, e)dir : Dir
e : expressionIn the two-argument form, expression e is evaluated in thedirectory dir. The current directory is not changed otherwise.The behavior of the cd function can be changed with theCDPATH variable, which specifies a search path for directories.This is normally useful only in the osh command interpreter.
CDPATH : Dir SequenceFor example, the following will change directory to thefirst directory ./foo, ~/dir1/foo, ~/dir2/foo.
CDPATH[] =.
$(HOME)/dir1
$(HOME)/dir2cd foo - BG
- The bg function places a job in the background.
- bg <pid...>
- FG
- The fg function brings a job to the foreground.
- fg <pid...>
- STOP
- The stop function suspends a job.
- stop <pid...>
- WAIT
- The wait function waits for a job to finish. If no pro
- cess identifiers are given, the shell waits for all jobs to com
- plete.
- wait <pid...>
- KILL
- The kill function signals a job.
- kill [signal] <pid...>
- HISTORY
- $(history-index) : Int
$(history) : String Sequence
history-file : File
history-length : Int - The history variables manage the command-line history in
- osh. They have no effect in omake.
- The history-index variable is the current index into the
- command-line history. The history variable is the current com
- mand-line history.
- The history-file variable can be redefined if you want the
- command-line history to be saved. The default value is
- ~/.omake/osh_history.
- The history-length variable can be redefined to specify
- the maximum number of lines in the history that you want saved.
- The default value is 100.
REFERENCES
- SEE ALSO
- omake(1), omake-quickstart(1), omake-options(1), omake
- root(1), omake-language(1), omake-shell(1), omake-rules(1),
- omake-base(1), omake-system(1), omake-pervasives(1), osh(1),
- make(1)
- VERSION
- Version: 0.9.6.9 of April 11, 2006.
- LICENSE AND COPYRIGHT
- (C)2003-2006, Mojave Group, Caltech
- This program is free software; you can redistribute it
- and/or modify it under the terms of the GNU General Public Li
- cense as published by the Free Software Foundation; either ver
- sion 2 of the License, or (at your option) any later version.
- This program is distributed in the hope that it will be
- useful, but WITHOUT ANY WARRANTY; without even the implied war
- ranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
- the GNU General Public License for more details.
- You should have received a copy of the GNU General Public
- License along with this program; if not, write to the Free Soft
- ware Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- AUTHOR
- Jason Hickey et. al..br Caltech 256-80
Pasadena, CA 91125, USA
Email: omake-devel@metaprl.org WWW: http://www.cs.caltech.edu/~jyh - Build Tools April 11, 2006