jrunscript.1 revision 4632
4169N/A." Copyright (c) 2006, 2011, Oracle and/or its affiliates. All rights reserved.
1178N/A." DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
1178N/A."
1178N/A." This code is free software; you can redistribute it and/or modify it
1178N/A." under the terms of the GNU General Public License version 2 only, as
1178N/A." published by the Free Software Foundation.
1178N/A."
1178N/A." This code is distributed in the hope that it will be useful, but WITHOUT
1178N/A." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
1178N/A." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
1178N/A." version 2 for more details (a copy is included in the LICENSE file that
1178N/A." accompanied this code).
1178N/A."
1178N/A." You should have received a copy of the GNU General Public License version
1178N/A." 2 along with this work; if not, write to the Free Software Foundation,
1178N/A." Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
1178N/A."
2362N/A." Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A." or visit www.oracle.com if you need additional information or have any
2362N/A." questions.
1178N/A."
4169N/A.TH jrunscript 1 "10 May 2011"
1178N/A
0N/A.LP
4033N/A.SH "Name"
1178N/Ajrunscript \- command line script shell
1178N/A.LP
4033N/A.SH "SYNOPSIS"
4033N/A.LP
0N/A.nf
1178N/A\f3
4033N/A.fl
0N/A\fP\f3jrunscript\fP [ \f2options\fP ] [ arguments... ]
4033N/A.fl
0N/A.fi
1178N/A
0N/A.LP
4033N/A.SH "PARAMETERS"
0N/A.LP
0N/A.RS 3
0N/A.TP 3
0N/Aoptions
0N/AOptions, if used, should follow immediately after the command name.
0N/A.TP 3
0N/Aarguments
0N/AArguments, if used, should follow immediately after options or command name.
0N/A.RE
0N/A
4033N/A.LP
1178N/A.SH "DESCRIPTION"
1178N/A.LP
4033N/A.LP
0N/A\f3jrunscript\fP is a command line script shell. jrunscript supports both an interactive (read\-eval\-print) mode and a batch (\-f option) mode of script execution. This is a scripting language independent shell. By default, JavaScript is the language used, but the \-l option can be used to specify a different language. Through Java to scripting language communication, jrunscript supports "exploratory programming" style.
0N/A.LP
0N/A.LP
1178N/A\f3NOTE:\fP This tool is \f3experimental\fP and may \f3not\fP be available in future versions of the JDK.
4033N/A.LP
0N/A.SH "OPTIONS"
1178N/A.LP
4033N/A.RS 3
1178N/A.TP 3
1178N/A\-classpath path
1178N/ASpecify where to find the user's .class files that are accessed by the script.
1178N/A.TP 3
4033N/A\-cp path
1178N/AThis is a synonym for \-classpath \f2path\fP
1178N/A.TP 3
4033N/A\-Dname=value
1178N/ASet a Java system property.
4033N/A.TP 3
1178N/A\-J<flag>
4033N/APass <flag> directly to the Java virtual machine on which jrunscript is run.
1178N/A.TP 3
4033N/A\-l language
1178N/AUse the specified scripting language. By default, JavaScript is used. Note that to use other scripting languages, you also need to specify the corresponding script engine's jar file using \-cp or \-classpath option.
1178N/A.TP 3
4033N/A\-e script
1178N/AEvaluate the given script. This option can be used to run "one liner" scripts specified completely on the command line.
1178N/A.TP 3
1178N/A\-encoding encoding
1178N/ASpecify the character encoding used while reading script files.
4033N/A.TP 3
0N/A\-f script\-file
0N/AEvaluate the given script file (batch mode).
0N/A.TP 3
0N/A\-f \-
0N/ARead and evaluate a script from standard input (interactive mode).
0N/A.TP 3
1178N/A\-help\
4033N/AOutput help message and exit.
1178N/A.TP 3
1178N/A\-?\
0N/AOutput help message and exit.
1178N/A.TP 3
4033N/A\-q\
1178N/AList all script engines available and exit.
0N/A.RE
0N/A
1178N/A.LP
0N/A.SH "ARGUMENTS"
1178N/A.LP
4033N/A.LP
1178N/AIf [arguments...] are present and if no \f3\-e\fP or \f3\-f\fP option is used, then the first argument is the script file and the rest of the arguments, if any, are passed as script arguments. If [arguments..] and \f3\-e\fP or \f3\-f\fP option are used, then all [arguments..] are passed as script arguments. If [arguments..], \f3\-e\fP and \f3\-f\fP are missing, interactive mode is used. Script arguments are available to a script in an engine variable named "arguments" of type String array.
1178N/A.LP
1178N/A.SH "EXAMPLES"
1178N/A.LP
0N/A.SS
1178N/AExecuting inline scripts
4033N/A.LP
1178N/A.nf
1178N/A\f3
1178N/A.fl
1178N/Ajrunscript \-e "print('hello world')"
0N/A.fl
0N/Ajrunscript \-e "cat('http://java.sun.com')"
4033N/A.fl
0N/A\fP
0N/A.fi
0N/A
1178N/A.LP
1178N/A.SS
1178N/AUse specified language and evaluate given script file
4033N/A.LP
1178N/A.nf
1178N/A\f3
1178N/A.fl
1178N/Ajrunscript \-l js \-f test.js
0N/A.fl
4033N/A\fP
0N/A.fi
0N/A
4033N/A.LP
1178N/A.SS
4033N/AInteractive mode
1178N/A.LP
4033N/A.nf
1178N/A\f3
4033N/A.fl
1178N/Ajrunscript
4033N/A.fl
1178N/Ajs> print('Hello World\\n');
1178N/A.fl
4033N/AHello World
1178N/A.fl
1178N/Ajs> 34 + 55
4033N/A.fl
1178N/A89.0
1178N/A.fl
1178N/Ajs> t = new java.lang.Thread(function() { print('Hello World\\n'); })
1178N/A.fl
1178N/AThread[Thread\-0,5,main]
4033N/A.fl
1178N/Ajs> t.start()
1178N/A.fl
4033N/Ajs> Hello World
1178N/A.fl
1178N/A
4033N/A.fl
0N/Ajs>
0N/A.fl
0N/A\fP
0N/A.fi
0N/A
0N/A.LP
0N/A.SS
0N/ARun script file with script arguments
0N/A.LP
0N/A.nf
0N/A\f3
4033N/A.fl
0N/Ajrunscript test.js arg1 arg2 arg3
0N/A.fl
0N/A\fP
0N/A.fi
0N/A
0N/A.LP
0N/Atest.js is script file to execute and arg1, arg2 and arg3 are passed to script as script arguments. Script can access these using "arguments" array.
0N/A.SH "SEE ALSO"
0N/A.LP
0N/A.LP
0N/AIf JavaScript is used, then before evaluating any user defined script, jrunscript initializes certain built\-in functions and objects. These JavaScript built\-ins are documented in
4033N/A.na
0N/A\f2jsdocs\fP @
0N/A.fi
0N/Ahttp://download.oracle.com/javase/7/docs/technotes/tools/share/jsdocs/allclasses\-noframe.html.
0N/A.LP
0N/A
0N/A