falrun(1)

1flcrun(1)                     Falcon User Manuals                    flcrun(1)
2
3
4

NAME

6       flcrun - The Falcon command line execution tool
7
8

SYNOPSIS

10       falrun [options] [main_script] [script_options]
11
12

DESCRIPTION

14       The  falrun command line tool is a subset of the falcon(1) command line
15       interpreter which only executes pre-compiled falcon scripts  in  ".fam"
16       module  files.  This  is meant to launch Falcon based application which
17       were compiled on a different system, and whose source is not shipped.
18
19

OPTIONS

21       -e <enc>
22              Set given encoding as default for VM  I/O.  Unless  the  scripts
23              select  a  different I/O encoding, the streams that are provided
24              to the falcon VM (like the output stream for printf) are encoded
25              using  the given ISO encoding. This overrides the default encod‐
26              ing that is detected by reading  the  environment  settings.  In
27              example, if your system uses iso-8859-1 encoding by default, but
28              you want your script to read and  write  utf-8  files,  use  the
29              option -e utf-8
30
31
32       -h or -?
33              Prints a brief help on stdout and exits.
34
35       -L <path>
36              Changes  the default load path. This overrides both the internal
37              built in settings and the contents of environment variable  FAL‐
38              CON_LOAD_PATH. Each directory in the path should be separated by
39              ";" and use forward slashes, like this:
40
41                   falrun -L ./;/usr/share/falcon_mod;./myapp
42
43
44       -p <module>
45              Preloads the given module as if  it  were  loaded  by  the  main
46              script.
47
48       -P     Ignore default load paths and uses only the paths set via the -L
49              switch.
50
51       -v     Prints copyright notice and version and exits.
52
53

FILES

55       /usr/lib/libfalcon_engine.so
56              Default location of the Falcon Engine loadable module.
57
58       /usr/lib/falcon
59              Default directory containing Falcon binary modules.
60
61

ENVIRONMENT

63       FALCON_LOAD_PATH
64              Default search path for modules loaded by the scripts.
65
66
67       FALCON_SRC_ENCODING
68              Default encoding for the source scripts loaded by  falcon  (when
69              different from the system default).
70
71
72       FALCON_VM_ENCODING
73              Default  encoding  for  the  VM I/O streams (when different from
74              system default).
75
76
77

AUTHOR

79       Giancarlo Niccolai <gc@falconpl.org>
80
81

LICENSE

87       This document is released under the "GNU  Free  Documentation  License,
88       version  1.2".   On Debian systems, the complete text of the Free Docu‐
89       mentation  License,  version  1.2,  can  be  found  in  /usr/share/com‐
90       mon-licenses/.
91
92
93
94
95Falcon toolset                    April 2007                         flcrun(1)