|
1
|
1 /* |
|
|
2 |
|
7017
|
3 Copyright (C) 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, |
|
|
4 2002, 2003, 2004, 2005, 2006, 2007 John W. Eaton |
|
1
|
5 |
|
|
6 This file is part of Octave. |
|
|
7 |
|
|
8 Octave is free software; you can redistribute it and/or modify it |
|
|
9 under the terms of the GNU General Public License as published by the |
|
7016
|
10 Free Software Foundation; either version 3 of the License, or (at your |
|
|
11 option) any later version. |
|
1
|
12 |
|
|
13 Octave is distributed in the hope that it will be useful, but WITHOUT |
|
|
14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
|
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
|
16 for more details. |
|
|
17 |
|
|
18 You should have received a copy of the GNU General Public License |
|
7016
|
19 along with Octave; see the file COPYING. If not, see |
|
|
20 <http://www.gnu.org/licenses/>. |
|
1
|
21 |
|
|
22 */ |
|
|
23 |
|
|
24 // Born February 20, 1992. |
|
|
25 |
|
240
|
26 #ifdef HAVE_CONFIG_H |
|
1192
|
27 #include <config.h> |
|
1
|
28 #endif |
|
|
29 |
|
1355
|
30 #include <cassert> |
|
|
31 #include <cstdlib> |
|
|
32 #include <cstring> |
|
|
33 #include <ctime> |
|
|
34 |
|
3503
|
35 #include <fstream> |
|
|
36 #include <iostream> |
|
1355
|
37 |
|
|
38 #ifdef HAVE_UNISTD_H |
|
2442
|
39 #ifdef HAVE_SYS_TYPES_H |
|
1
|
40 #include <sys/types.h> |
|
2442
|
41 #endif |
|
139
|
42 #include <unistd.h> |
|
|
43 #endif |
|
1355
|
44 |
|
2926
|
45 #include "cmd-edit.h" |
|
3690
|
46 #include "f77-fcn.h" |
|
4097
|
47 #include "file-ops.h" |
|
2926
|
48 #include "file-stat.h" |
|
240
|
49 #include "lo-error.h" |
|
2926
|
50 #include "oct-env.h" |
|
3019
|
51 #include "pathsearch.h" |
|
1907
|
52 #include "str-vec.h" |
|
223
|
53 |
|
2492
|
54 #include <defaults.h> |
|
3933
|
55 #include "Cell.h" |
|
1355
|
56 #include "defun.h" |
|
|
57 #include "error.h" |
|
|
58 #include "file-io.h" |
|
1
|
59 #include "input.h" |
|
|
60 #include "lex.h" |
|
5832
|
61 #include "load-path.h" |
|
4113
|
62 #include "octave.h" |
|
1742
|
63 #include "oct-hist.h" |
|
5654
|
64 #include "oct-map.h" |
|
3195
|
65 #include "oct-obj.h" |
|
2375
|
66 #include "ops.h" |
|
1670
|
67 #include "toplev.h" |
|
1
|
68 #include "parse.h" |
|
562
|
69 #include "procstream.h" |
|
1817
|
70 #include "prog-args.h" |
|
1355
|
71 #include "sighandlers.h" |
|
|
72 #include "sysdep.h" |
|
2375
|
73 #include "ov.h" |
|
1
|
74 #include "unwind-prot.h" |
|
1355
|
75 #include "utils.h" |
|
|
76 #include "variables.h" |
|
2492
|
77 #include <version.h> |
|
1
|
78 |
|
4159
|
79 // Kluge. |
|
5990
|
80 extern "C" F77_RET_T |
|
|
81 F77_FUNC (xerbla, XERBLA) (F77_CONST_CHAR_ARG_DECL, const octave_idx_type& |
|
|
82 F77_CHAR_ARG_LEN_DECL); |
|
4159
|
83 |
|
2910
|
84 extern void install_builtins (void); |
|
|
85 |
|
1704
|
86 #if !defined (HAVE_ATEXIT) && defined (HAVE_ON_EXIT) |
|
|
87 extern "C" int on_exit (); |
|
|
88 #define atexit on_exit |
|
|
89 #endif |
|
|
90 |
|
1907
|
91 // The command-line options. |
|
|
92 static string_vector octave_argv; |
|
1
|
93 |
|
5780
|
94 // The name used to invoke Octave. |
|
|
95 static std::string |
|
|
96 octave_program_invocation_name; |
|
|
97 |
|
|
98 // The last component of octave_program_invocation_name. |
|
|
99 static std::string octave_program_name; |
|
|
100 |
|
2239
|
101 // TRUE means we read ~/.octaverc and ./.octaverc. |
|
|
102 // (--norc; --no-init-file; -f) |
|
|
103 static bool read_init_files = true; |
|
|
104 |
|
|
105 // TRUE means we read the site-wide octaverc files. |
|
|
106 // (--norc; --no-site-file; -f) |
|
2240
|
107 static bool read_site_files = true; |
|
1
|
108 |
|
6365
|
109 // TRUE means we set the initial path to configured defaults. |
|
|
110 // (--no-initial-path) |
|
|
111 static bool set_initial_path = true; |
|
|
112 |
|
3019
|
113 // TRUE means we don't print the usual startup message. |
|
616
|
114 // (--quiet; --silent; -q) |
|
2239
|
115 static bool inhibit_startup_message = false; |
|
1
|
116 |
|
3019
|
117 // TRUE means we turn on compatibility options. |
|
1410
|
118 // (--traditional) |
|
2239
|
119 static bool traditional = false; |
|
1410
|
120 |
|
3019
|
121 // If TRUE, print verbose info in some cases. |
|
1825
|
122 // (--verbose; -V) |
|
2239
|
123 static bool verbose_flag = false; |
|
1825
|
124 |
|
1
|
125 // Usage message |
|
139
|
126 static const char *usage_string = |
|
5189
|
127 "octave [-?HVdfhiqvx] [--debug] [--echo-commands] [--eval CODE]\n\ |
|
5814
|
128 [--exec-path path] [--help] [--image-path path] [--info-file file]\n\ |
|
6938
|
129 [--info-program prog] [--interactive] [--line-editing] [--no-history] [--no-init-file]\n\ |
|
6365
|
130 [--no-line-editing] [--no-site-file] [--no-init-path] [-p path]\n\ |
|
|
131 [--path path] [--silent] [--traditional] [--verbose] [--version] [file]"; |
|
1
|
132 |
|
1358
|
133 // This is here so that it's more likely that the usage message and |
|
1410
|
134 // the real set of options will agree. Note: the `+' must come first |
|
|
135 // to prevent getopt from permuting arguments! |
|
3180
|
136 static const char *short_opts = "+?HVdfhip:qvx"; |
|
139
|
137 |
|
5189
|
138 // The code to evaluate at startup (--eval CODE) |
|
|
139 static std::string code_to_eval; |
|
|
140 |
|
|
141 // If TRUE, don't exit after evaluating code given by --eval option. |
|
|
142 static bool persist = false; |
|
4356
|
143 |
|
1103
|
144 // Long options. See the comments in getopt.h for the meanings of the |
|
|
145 // fields in this structure. |
|
5189
|
146 #define EVAL_OPTION 1 |
|
|
147 #define EXEC_PATH_OPTION 2 |
|
5814
|
148 #define IMAGE_PATH_OPTION 3 |
|
|
149 #define INFO_FILE_OPTION 4 |
|
|
150 #define INFO_PROG_OPTION 5 |
|
|
151 #define NO_INIT_FILE_OPTION 6 |
|
|
152 #define NO_LINE_EDITING_OPTION 7 |
|
|
153 #define NO_SITE_FILE_OPTION 8 |
|
6365
|
154 #define NO_INITIAL_PATH_OPTION 9 |
|
|
155 #define PERSIST_OPTION 10 |
|
|
156 #define TRADITIONAL_OPTION 11 |
|
6938
|
157 #define LINE_EDITING_OPTION 12 |
|
1817
|
158 long_options long_opts[] = |
|
139
|
159 { |
|
1855
|
160 { "debug", prog_args::no_arg, 0, 'd' }, |
|
2277
|
161 { "braindead", prog_args::no_arg, 0, TRADITIONAL_OPTION }, |
|
1855
|
162 { "echo-commands", prog_args::no_arg, 0, 'x' }, |
|
5189
|
163 { "eval", prog_args::required_arg, 0, EVAL_OPTION }, |
|
1855
|
164 { "exec-path", prog_args::required_arg, 0, EXEC_PATH_OPTION }, |
|
|
165 { "help", prog_args::no_arg, 0, 'h' }, |
|
5814
|
166 { "image-path", prog_args::required_arg, 0, IMAGE_PATH_OPTION }, |
|
1855
|
167 { "info-file", prog_args::required_arg, 0, INFO_FILE_OPTION }, |
|
|
168 { "info-program", prog_args::required_arg, 0, INFO_PROG_OPTION }, |
|
|
169 { "interactive", prog_args::no_arg, 0, 'i' }, |
|
6938
|
170 { "line-editing", prog_args::no_arg, 0, LINE_EDITING_OPTION }, |
|
3180
|
171 { "no-history", prog_args::no_arg, 0, 'H' }, |
|
2239
|
172 { "no-init-file", prog_args::no_arg, 0, NO_INIT_FILE_OPTION }, |
|
1855
|
173 { "no-line-editing", prog_args::no_arg, 0, NO_LINE_EDITING_OPTION }, |
|
2239
|
174 { "no-site-file", prog_args::no_arg, 0, NO_SITE_FILE_OPTION }, |
|
6365
|
175 { "no-initial-path", prog_args::no_arg, 0, NO_INITIAL_PATH_OPTION }, |
|
1855
|
176 { "norc", prog_args::no_arg, 0, 'f' }, |
|
|
177 { "path", prog_args::required_arg, 0, 'p' }, |
|
5189
|
178 { "persist", prog_args::no_arg, 0, PERSIST_OPTION }, |
|
1855
|
179 { "quiet", prog_args::no_arg, 0, 'q' }, |
|
|
180 { "silent", prog_args::no_arg, 0, 'q' }, |
|
|
181 { "traditional", prog_args::no_arg, 0, TRADITIONAL_OPTION }, |
|
|
182 { "verbose", prog_args::no_arg, 0, 'V' }, |
|
|
183 { "version", prog_args::no_arg, 0, 'v' }, |
|
3019
|
184 { 0, 0, 0, 0 } |
|
139
|
185 }; |
|
1
|
186 |
|
1355
|
187 // Store the command-line options for later use. |
|
|
188 |
|
|
189 static void |
|
|
190 intern_argv (int argc, char **argv) |
|
|
191 { |
|
4892
|
192 symbol_record *nargin_sr = top_level_sym_tab->lookup ("__nargin__", true); |
|
|
193 |
|
|
194 nargin_sr->mark_as_static (); |
|
|
195 |
|
|
196 nargin_sr->define (argc-1); |
|
3195
|
197 |
|
1355
|
198 if (argc > 1) |
|
|
199 { |
|
5780
|
200 octave_argv.resize (argc-1); |
|
3933
|
201 |
|
2495
|
202 // Skip program name in argv. |
|
3933
|
203 int i = argc; |
|
|
204 while (--i > 0) |
|
5780
|
205 octave_argv[i-1] = *(argv+i); |
|
1355
|
206 } |
|
|
207 } |
|
|
208 |
|
1792
|
209 static void |
|
|
210 initialize_pathsearch (void) |
|
|
211 { |
|
|
212 // This may seem odd, but doing it this way means that we don't have |
|
|
213 // to modify the kpathsea library... |
|
|
214 |
|
3523
|
215 std::string odb = octave_env::getenv ("OCTAVE_DB_PATH"); |
|
3141
|
216 |
|
|
217 // For backward compatibility. |
|
1792
|
218 |
|
2926
|
219 if (odb.empty ()) |
|
3141
|
220 odb = octave_env::getenv ("OCTAVE_DB_DIR"); |
|
1792
|
221 |
|
3141
|
222 if (odb.empty ()) |
|
4101
|
223 odb = Vdata_dir + file_ops::dir_sep_str + "octave:" |
|
|
224 + Vlibexec_dir + file_ops::dir_sep_str + "octave"; |
|
1792
|
225 } |
|
|
226 |
|
5654
|
227 DEFUN (__version_info__, args, , |
|
|
228 "-*- texinfo -*-\n\ |
|
6678
|
229 @deftypefn {Built-in Function} {retval =} __version_info__ (@var{name}, @var{version}, @var{release}, @var{date})\n\ |
|
6945
|
230 Undocumented internal function.\n\ |
|
5654
|
231 @end deftypefn") |
|
|
232 { |
|
|
233 octave_value retval; |
|
|
234 |
|
|
235 static Octave_map vinfo; |
|
|
236 |
|
|
237 int nargin = args.length (); |
|
|
238 |
|
5658
|
239 if (nargin == 4) |
|
5654
|
240 { |
|
6639
|
241 if (vinfo.nfields () == 0) |
|
5781
|
242 { |
|
|
243 vinfo.assign ("Name", args (0)); |
|
|
244 vinfo.assign ("Version", args (1)); |
|
|
245 vinfo.assign ("Release", args (2)); |
|
|
246 vinfo.assign ("Date", args (3)); |
|
|
247 } |
|
|
248 else |
|
|
249 { |
|
|
250 octave_idx_type n = vinfo.numel () + 1; |
|
5654
|
251 |
|
5781
|
252 vinfo.resize (dim_vector (n, 1)); |
|
|
253 |
|
|
254 octave_value idx (n); |
|
|
255 |
|
|
256 vinfo.assign (idx, "Name", Cell (octave_value (args (0)))); |
|
|
257 vinfo.assign (idx, "Version", Cell (octave_value (args (1)))); |
|
|
258 vinfo.assign (idx, "Release", Cell (octave_value (args (2)))); |
|
|
259 vinfo.assign (idx, "Date", Cell (octave_value (args (3)))); |
|
|
260 } |
|
5654
|
261 } |
|
|
262 else if (nargin == 0) |
|
|
263 retval = vinfo; |
|
|
264 else |
|
5823
|
265 print_usage (); |
|
5654
|
266 |
|
|
267 return retval; |
|
|
268 } |
|
|
269 |
|
|
270 static void |
|
|
271 initialize_version_info (void) |
|
|
272 { |
|
|
273 octave_value_list args; |
|
|
274 |
|
5658
|
275 args(3) = OCTAVE_RELEASE_DATE; |
|
|
276 args(2) = OCTAVE_RELEASE; |
|
5654
|
277 args(1) = OCTAVE_VERSION; |
|
|
278 args(0) = "GNU Octave"; |
|
|
279 |
|
|
280 F__version_info__ (args, 0); |
|
|
281 } |
|
|
282 |
|
581
|
283 // Initialize by reading startup files. |
|
|
284 |
|
1
|
285 static void |
|
|
286 execute_startup_files (void) |
|
|
287 { |
|
2985
|
288 unwind_protect::begin_frame ("execute_startup_files"); |
|
315
|
289 |
|
3019
|
290 unwind_protect_bool (input_from_startup_file); |
|
1651
|
291 |
|
3019
|
292 input_from_startup_file = true; |
|
315
|
293 |
|
793
|
294 int verbose = (verbose_flag && ! inhibit_startup_message); |
|
578
|
295 |
|
2239
|
296 if (read_site_files) |
|
1
|
297 { |
|
2239
|
298 // Execute commands from the site-wide configuration file. |
|
|
299 // First from the file $(prefix)/lib/octave/site/m/octaverc |
|
|
300 // (if it exists), then from the file |
|
3597
|
301 // $(prefix)/share/octave/$(version)/m/octaverc (if it exists). |
|
1755
|
302 |
|
2897
|
303 parse_and_execute (Vlocal_site_defaults_file, verbose); |
|
1755
|
304 |
|
2897
|
305 parse_and_execute (Vsite_defaults_file, verbose); |
|
1
|
306 } |
|
|
307 |
|
2239
|
308 if (read_init_files) |
|
|
309 { |
|
2512
|
310 // Try to execute commands from $HOME/$OCTAVE_INITFILE and |
|
|
311 // $OCTAVE_INITFILE. If $OCTAVE_INITFILE is not set, .octaverc |
|
|
312 // is assumed. |
|
2239
|
313 |
|
4804
|
314 bool home_rc_already_executed = false; |
|
2512
|
315 |
|
3523
|
316 std::string initfile = octave_env::getenv ("OCTAVE_INITFILE"); |
|
2512
|
317 |
|
2926
|
318 if (initfile.empty ()) |
|
2512
|
319 initfile = ".octaverc"; |
|
|
320 |
|
3523
|
321 std::string home_dir = octave_env::get_home_directory (); |
|
2926
|
322 |
|
4804
|
323 std::string home_rc = octave_env::make_absolute (initfile, home_dir); |
|
|
324 |
|
|
325 std::string local_rc; |
|
2239
|
326 |
|
5781
|
327 if (! home_rc.empty ()) |
|
2239
|
328 { |
|
2897
|
329 parse_and_execute (home_rc, verbose); |
|
2239
|
330 |
|
|
331 // Names alone are not enough. |
|
|
332 |
|
|
333 file_stat fs_home_rc (home_rc); |
|
|
334 |
|
|
335 if (fs_home_rc) |
|
|
336 { |
|
4804
|
337 // We want to check for curr_dir after executing home_rc |
|
|
338 // because doing that may change the working directory. |
|
|
339 |
|
|
340 std::string curr_dir = octave_env::getcwd (); |
|
|
341 |
|
|
342 local_rc = octave_env::make_absolute (initfile, curr_dir); |
|
|
343 |
|
6598
|
344 home_rc_already_executed = same_file (home_rc, local_rc); |
|
2239
|
345 } |
|
|
346 } |
|
|
347 |
|
|
348 if (! home_rc_already_executed) |
|
4804
|
349 { |
|
|
350 if (local_rc.empty ()) |
|
|
351 { |
|
|
352 std::string curr_dir = octave_env::getcwd (); |
|
|
353 |
|
|
354 local_rc = octave_env::make_absolute (initfile, curr_dir); |
|
|
355 } |
|
|
356 |
|
|
357 parse_and_execute (local_rc, verbose); |
|
|
358 } |
|
2239
|
359 } |
|
315
|
360 |
|
2985
|
361 unwind_protect::run_frame ("execute_startup_files"); |
|
1
|
362 } |
|
|
363 |
|
5189
|
364 static int |
|
|
365 execute_eval_option_code (const std::string& code) |
|
|
366 { |
|
|
367 unwind_protect::begin_frame ("execute_eval_option_code"); |
|
|
368 |
|
7202
|
369 octave_save_signal_mask (); |
|
|
370 |
|
|
371 can_interrupt = true; |
|
|
372 |
|
|
373 octave_signal_hook = octave_signal_handler; |
|
|
374 octave_interrupt_hook = unwind_protect::run_all; |
|
|
375 octave_bad_alloc_hook = unwind_protect::run_all; |
|
|
376 |
|
|
377 octave_catch_interrupts (); |
|
|
378 |
|
|
379 octave_initialized = true; |
|
|
380 |
|
5189
|
381 unwind_protect_bool (interactive); |
|
|
382 |
|
|
383 interactive = false; |
|
|
384 |
|
|
385 int parse_status = 0; |
|
|
386 |
|
6487
|
387 try |
|
|
388 { |
|
|
389 eval_string (code, false, parse_status, 0); |
|
|
390 } |
|
7202
|
391 catch (octave_interrupt_exception) |
|
|
392 { |
|
|
393 recover_from_exception (); |
|
|
394 octave_stdout << "\n"; |
|
|
395 } |
|
6487
|
396 catch (std::bad_alloc) |
|
|
397 { |
|
6680
|
398 std::cerr << "error: memory exhausted or requested size too large for range of Octave's index type -- eval failed" |
|
|
399 << std::endl; |
|
6487
|
400 } |
|
5189
|
401 |
|
|
402 unwind_protect::run_frame ("execute_eval_option_code"); |
|
|
403 |
|
|
404 return parse_status; |
|
|
405 } |
|
|
406 |
|
|
407 static void |
|
|
408 execute_command_line_file (const std::string& fname) |
|
|
409 { |
|
|
410 unwind_protect::begin_frame ("execute_command_line_file"); |
|
|
411 |
|
7202
|
412 octave_save_signal_mask (); |
|
|
413 |
|
|
414 can_interrupt = true; |
|
|
415 |
|
|
416 octave_signal_hook = octave_signal_handler; |
|
|
417 octave_interrupt_hook = unwind_protect::run_all; |
|
|
418 octave_bad_alloc_hook = unwind_protect::run_all; |
|
|
419 |
|
|
420 octave_catch_interrupts (); |
|
|
421 |
|
|
422 octave_initialized = true; |
|
|
423 |
|
5189
|
424 unwind_protect_bool (interactive); |
|
|
425 unwind_protect_bool (reading_script_file); |
|
|
426 unwind_protect_bool (input_from_command_line_file); |
|
|
427 |
|
|
428 unwind_protect_str (curr_fcn_file_name); |
|
|
429 unwind_protect_str (curr_fcn_file_full_name); |
|
|
430 |
|
5780
|
431 unwind_protect_str (octave_program_invocation_name); |
|
|
432 unwind_protect_str (octave_program_name); |
|
5189
|
433 |
|
|
434 interactive = false; |
|
|
435 reading_script_file = true; |
|
|
436 input_from_command_line_file = true; |
|
|
437 |
|
|
438 curr_fcn_file_name = fname; |
|
|
439 curr_fcn_file_full_name = curr_fcn_file_name; |
|
|
440 |
|
5780
|
441 octave_program_invocation_name = curr_fcn_file_name; |
|
5189
|
442 |
|
|
443 size_t pos = curr_fcn_file_name.find_last_of (file_ops::dir_sep_chars); |
|
|
444 |
|
|
445 std::string tmp = (pos != NPOS) |
|
|
446 ? curr_fcn_file_name.substr (pos+1) : curr_fcn_file_name; |
|
|
447 |
|
5780
|
448 octave_program_name = tmp; |
|
5189
|
449 |
|
6504
|
450 try |
|
|
451 { |
|
|
452 parse_and_execute (fname, false, "octave"); |
|
|
453 } |
|
7202
|
454 catch (octave_interrupt_exception) |
|
|
455 { |
|
|
456 recover_from_exception (); |
|
|
457 octave_stdout << "\n"; |
|
|
458 } |
|
6504
|
459 catch (std::bad_alloc) |
|
|
460 { |
|
6680
|
461 std::cerr << "error: memory exhausted or requested size too large for range of Octave's index type -- execution of " |
|
|
462 << fname << " failed" << std::endl; |
|
6504
|
463 } |
|
5189
|
464 |
|
|
465 unwind_protect::run_frame ("execute_command_line_file"); |
|
|
466 } |
|
|
467 |
|
581
|
468 // Usage message with extra help. |
|
|
469 |
|
1
|
470 static void |
|
|
471 verbose_usage (void) |
|
|
472 { |
|
3922
|
473 std::cout << OCTAVE_NAME_VERSION_COPYRIGHT_COPYING_AND_WARRANTY "\n\ |
|
1613
|
474 \n\ |
|
|
475 Usage: octave [options]\n\ |
|
|
476 \n\ |
|
|
477 Options:\n\ |
|
1119
|
478 \n\ |
|
3180
|
479 --debug, -d Enter parser debugging mode.\n\ |
|
|
480 --echo-commands, -x Echo commands as they are executed.\n\ |
|
5191
|
481 --eval CODE Evaluate CODE. Exit when done unless --persist.\n\ |
|
1613
|
482 --exec-path PATH Set path for executing subprograms.\n\ |
|
3180
|
483 --help, -h, -? Print short help message and exit.\n\ |
|
6615
|
484 --image-path PATH Set initial IMAGE_PATH to PATH.\n\ |
|
1613
|
485 --info-file FILE Use top-level info file FILE.\n\ |
|
|
486 --info-program PROGRAM Use PROGRAM for reading info files.\n\ |
|
3180
|
487 --interactive, -i Force interactive behavior.\n\ |
|
6938
|
488 --line-editing Force readline use for command-line editing.\n\ |
|
3180
|
489 --no-history, -H Don't save commands to the history list\n\ |
|
2470
|
490 --no-init-file Don't read the ~/.octaverc or .octaverc files.\n\ |
|
2212
|
491 --no-line-editing Don't use readline for command-line editing.\n\ |
|
2470
|
492 --no-site-file Don't read the site-wide octaverc file.\n\ |
|
3238
|
493 --norc, -f Don't read any initialization files.\n\ |
|
5814
|
494 --path PATH, -p PATH Set initial function search path to PATH.\n\ |
|
5189
|
495 --persist Go interactive after --eval or reading from FILE.\n\ |
|
3180
|
496 --silent, -q Don't print message at startup.\n\ |
|
1613
|
497 --traditional Set compatibility variables.\n\ |
|
3180
|
498 --verbose, -V Enable verbose output in some cases.\n\ |
|
|
499 --version, -v Print version number and exit.\n\ |
|
1119
|
500 \n\ |
|
5190
|
501 FILE Execute commands from FILE. Exit when done\n\ |
|
5191
|
502 unless --persist is also specified.\n\ |
|
4829
|
503 \n" |
|
|
504 OCTAVE_WWW_STATEMENT "\n\ |
|
4356
|
505 \n" |
|
|
506 OCTAVE_CONTRIB_STATEMENT "\n\ |
|
|
507 \n" |
|
|
508 OCTAVE_BUGS_STATEMENT "\n"; |
|
285
|
509 |
|
613
|
510 exit (0); |
|
1
|
511 } |
|
|
512 |
|
581
|
513 // Terse usage messsage. |
|
|
514 |
|
1
|
515 static void |
|
|
516 usage (void) |
|
|
517 { |
|
3531
|
518 std::cerr << "usage: " << usage_string << "\n"; |
|
1
|
519 exit (1); |
|
|
520 } |
|
|
521 |
|
|
522 static void |
|
|
523 print_version_and_exit (void) |
|
|
524 { |
|
3922
|
525 std::cout << OCTAVE_NAME_VERSION_COPYRIGHT_COPYING_WARRANTY_AND_BUGS "\n"; |
|
1
|
526 exit (0); |
|
|
527 } |
|
|
528 |
|
721
|
529 static void |
|
|
530 initialize_error_handlers () |
|
|
531 { |
|
|
532 set_liboctave_error_handler (error); |
|
3325
|
533 set_liboctave_warning_handler (warning); |
|
5781
|
534 set_liboctave_warning_with_id_handler (warning_with_id); |
|
721
|
535 } |
|
|
536 |
|
1410
|
537 // What happens on --traditional. |
|
|
538 |
|
|
539 static void |
|
|
540 maximum_braindamage (void) |
|
|
541 { |
|
5189
|
542 persist = true; |
|
|
543 |
|
5794
|
544 bind_internal_variable ("PS1", ">> "); |
|
|
545 bind_internal_variable ("PS2", ""); |
|
|
546 bind_internal_variable ("beep_on_error", true); |
|
|
547 bind_internal_variable ("crash_dumps_octave_core", false); |
|
|
548 bind_internal_variable ("default_save_options", "-mat-binary"); |
|
|
549 bind_internal_variable ("fixed_point_format", true); |
|
|
550 bind_internal_variable ("history_timestamp_format_string", |
|
5305
|
551 "%%-- %D %I:%M %p --%%"); |
|
5794
|
552 bind_internal_variable ("page_screen_output", false); |
|
|
553 bind_internal_variable ("print_empty_dimensions", false); |
|
5904
|
554 |
|
6159
|
555 disable_warning ("Octave:fopen-file-in-path"); |
|
5904
|
556 disable_warning ("Octave:function-name-clash"); |
|
6159
|
557 disable_warning ("Octave:load-file-in-path"); |
|
1410
|
558 } |
|
|
559 |
|
581
|
560 // You guessed it. |
|
|
561 |
|
1
|
562 int |
|
4368
|
563 octave_main (int argc, char **argv, int embedded) |
|
1
|
564 { |
|
3019
|
565 octave_env::set_program_name (argv[0]); |
|
|
566 |
|
5780
|
567 octave_program_invocation_name = octave_env::get_program_invocation_name (); |
|
|
568 octave_program_name = octave_env::get_program_name (); |
|
|
569 |
|
2205
|
570 // The order of these calls is important. The call to |
|
2926
|
571 // install_defaults must come before install_builtins because |
|
3019
|
572 // default variable values must be available for the variables to be |
|
2205
|
573 // installed, and the call to install_builtins must come before the |
|
|
574 // options are processed because some command line options override |
|
5794
|
575 // defaults by calling bind_internal_variable. |
|
721
|
576 |
|
5844
|
577 init_signals (); |
|
|
578 |
|
1
|
579 sysdep_init (); |
|
|
580 |
|
4159
|
581 // The idea here is to force xerbla to be referenced so that we will |
|
|
582 // link to our own version instead of the one provided by the BLAS |
|
|
583 // library. But octave_NaN should never be -1, so we should never |
|
|
584 // actually call xerbla. |
|
|
585 |
|
|
586 if (octave_NaN == -1) |
|
|
587 F77_FUNC (xerbla, XERBLA) ("octave", 13, 6L); |
|
|
588 |
|
721
|
589 initialize_error_handlers (); |
|
223
|
590 |
|
5794
|
591 initialize_default_warning_state (); |
|
|
592 |
|
2926
|
593 install_defaults (); |
|
1
|
594 |
|
1792
|
595 initialize_pathsearch (); |
|
1744
|
596 |
|
4368
|
597 if (! embedded) |
|
|
598 install_signal_handlers (); |
|
2205
|
599 |
|
|
600 initialize_file_io (); |
|
|
601 |
|
2375
|
602 initialize_symbol_tables (); |
|
|
603 |
|
|
604 install_types (); |
|
|
605 |
|
|
606 install_ops (); |
|
2205
|
607 |
|
|
608 install_builtins (); |
|
|
609 |
|
1817
|
610 prog_args args (argc, argv, short_opts, long_opts); |
|
|
611 |
|
6938
|
612 bool forced_line_editing = false; |
|
|
613 |
|
139
|
614 int optc; |
|
1817
|
615 while ((optc = args.getopt ()) != EOF) |
|
1
|
616 { |
|
139
|
617 switch (optc) |
|
1
|
618 { |
|
3180
|
619 case 'H': |
|
5794
|
620 bind_internal_variable ("saving_history", false); |
|
3180
|
621 break; |
|
|
622 |
|
793
|
623 case 'V': |
|
2239
|
624 verbose_flag = true; |
|
793
|
625 break; |
|
|
626 |
|
1
|
627 case 'd': |
|
4753
|
628 // This is the same as yydebug in parse.y. |
|
|
629 octave_debug++; |
|
1
|
630 break; |
|
777
|
631 |
|
1
|
632 case 'f': |
|
2239
|
633 read_init_files = false; |
|
|
634 read_site_files = false; |
|
1
|
635 break; |
|
777
|
636 |
|
1
|
637 case 'h': |
|
|
638 case '?': |
|
|
639 verbose_usage (); |
|
|
640 break; |
|
777
|
641 |
|
1
|
642 case 'i': |
|
3019
|
643 forced_interactive = true; |
|
1
|
644 break; |
|
777
|
645 |
|
1
|
646 case 'p': |
|
1817
|
647 if (args.optarg ()) |
|
5832
|
648 load_path::set_command_line_path (args.optarg ()); |
|
1
|
649 break; |
|
777
|
650 |
|
1
|
651 case 'q': |
|
2239
|
652 inhibit_startup_message = true; |
|
1
|
653 break; |
|
777
|
654 |
|
1
|
655 case 'x': |
|
2205
|
656 { |
|
|
657 double tmp = (ECHO_SCRIPTS | ECHO_FUNCTIONS | ECHO_CMD_LINE); |
|
5794
|
658 bind_internal_variable ("echo_executing_commands", tmp); |
|
2205
|
659 } |
|
1
|
660 break; |
|
777
|
661 |
|
1
|
662 case 'v': |
|
|
663 print_version_and_exit (); |
|
|
664 break; |
|
777
|
665 |
|
5189
|
666 case EVAL_OPTION: |
|
|
667 if (args.optarg ()) |
|
5193
|
668 { |
|
|
669 if (code_to_eval.empty ()) |
|
|
670 code_to_eval = args.optarg (); |
|
|
671 else |
|
|
672 code_to_eval += std::string (" ") + args.optarg (); |
|
|
673 } |
|
5189
|
674 break; |
|
|
675 |
|
1613
|
676 case EXEC_PATH_OPTION: |
|
1817
|
677 if (args.optarg ()) |
|
5814
|
678 set_exec_path (args.optarg ()); |
|
|
679 break; |
|
|
680 |
|
|
681 case IMAGE_PATH_OPTION: |
|
|
682 if (args.optarg ()) |
|
|
683 set_image_path (args.optarg ()); |
|
1613
|
684 break; |
|
|
685 |
|
186
|
686 case INFO_FILE_OPTION: |
|
1817
|
687 if (args.optarg ()) |
|
5794
|
688 bind_internal_variable ("info_file", args.optarg ()); |
|
186
|
689 break; |
|
777
|
690 |
|
1613
|
691 case INFO_PROG_OPTION: |
|
1817
|
692 if (args.optarg ()) |
|
5794
|
693 bind_internal_variable ("info_program", args.optarg ()); |
|
1613
|
694 break; |
|
|
695 |
|
6938
|
696 case LINE_EDITING_OPTION: |
|
|
697 forced_line_editing = true; |
|
|
698 break; |
|
|
699 |
|
2239
|
700 case NO_INIT_FILE_OPTION: |
|
|
701 read_init_files = false; |
|
|
702 break; |
|
|
703 |
|
1821
|
704 case NO_LINE_EDITING_OPTION: |
|
3019
|
705 line_editing = false; |
|
2239
|
706 break; |
|
|
707 |
|
|
708 case NO_SITE_FILE_OPTION: |
|
|
709 read_site_files = 0; |
|
1821
|
710 break; |
|
|
711 |
|
6365
|
712 case NO_INITIAL_PATH_OPTION: |
|
|
713 set_initial_path = false; |
|
|
714 break; |
|
|
715 |
|
1410
|
716 case TRADITIONAL_OPTION: |
|
2239
|
717 traditional = true; |
|
1410
|
718 break; |
|
|
719 |
|
5189
|
720 case PERSIST_OPTION: |
|
|
721 persist = true; |
|
|
722 break; |
|
|
723 |
|
1
|
724 default: |
|
|
725 usage (); |
|
|
726 break; |
|
|
727 } |
|
|
728 } |
|
|
729 |
|
1651
|
730 #if defined (HAVE_ATEXIT) || defined (HAVE_ON_EXIT) |
|
2077
|
731 // Make sure we clean up when we exit. Also allow users to register |
|
|
732 // functions. If we don't have atexit or on_exit, we're going to |
|
|
733 // leave some junk files around if we exit abnormally. |
|
|
734 |
|
|
735 atexit (do_octave_atexit); |
|
318
|
736 #endif |
|
1
|
737 |
|
1358
|
738 // These can come after command line args since none of them set any |
|
|
739 // defaults that might be changed by command line options. |
|
581
|
740 |
|
2926
|
741 initialize_command_input (); |
|
315
|
742 |
|
578
|
743 if (! inhibit_startup_message) |
|
3538
|
744 std::cout << OCTAVE_STARTUP_MESSAGE "\n" << std::endl; |
|
578
|
745 |
|
1410
|
746 if (traditional) |
|
|
747 maximum_braindamage (); |
|
|
748 |
|
4217
|
749 octave_interpreter_ready = true; |
|
|
750 |
|
5654
|
751 initialize_version_info (); |
|
|
752 |
|
6365
|
753 load_path::initialize (set_initial_path); |
|
4217
|
754 |
|
2239
|
755 execute_startup_files (); |
|
1651
|
756 |
|
5794
|
757 initialize_history (); |
|
1
|
758 |
|
578
|
759 if (! inhibit_startup_message && reading_startup_message_printed) |
|
3538
|
760 std::cout << std::endl; |
|
578
|
761 |
|
5189
|
762 // Is input coming from a terminal? If so, we are probably |
|
|
763 // interactive. |
|
1358
|
764 |
|
5189
|
765 interactive = (! embedded |
|
|
766 && isatty (fileno (stdin)) && isatty (fileno (stdout))); |
|
|
767 |
|
6938
|
768 if (! interactive && ! forced_line_editing) |
|
5189
|
769 line_editing = false; |
|
1
|
770 |
|
1358
|
771 // If there is an extra argument, see if it names a file to read. |
|
|
772 // Additional arguments are taken as command line options for the |
|
|
773 // script. |
|
1
|
774 |
|
1817
|
775 int last_arg_idx = args.optind (); |
|
3019
|
776 |
|
1817
|
777 int remaining_args = argc - last_arg_idx; |
|
3019
|
778 |
|
5189
|
779 if (! code_to_eval.empty ()) |
|
149
|
780 { |
|
5189
|
781 // We probably want all the args for an --eval option. |
|
1355
|
782 |
|
|
783 intern_argv (argc, argv); |
|
|
784 |
|
5189
|
785 int parse_status = execute_eval_option_code (code_to_eval); |
|
|
786 |
|
5242
|
787 if (! (persist || remaining_args > 0)) |
|
5502
|
788 clean_up_and_exit (parse_status || error_state ? 1 : 0); |
|
1
|
789 } |
|
|
790 |
|
5189
|
791 if (remaining_args > 0) |
|
|
792 { |
|
|
793 // If we are running an executable script (#! /bin/octave) then |
|
|
794 // we should only see the args passed to the script. |
|
|
795 |
|
|
796 intern_argv (remaining_args, argv+last_arg_idx); |
|
|
797 |
|
|
798 execute_command_line_file (argv[last_arg_idx]); |
|
|
799 |
|
|
800 if (! persist) |
|
5502
|
801 clean_up_and_exit (error_state ? 1 : 0); |
|
5189
|
802 } |
|
|
803 |
|
|
804 // Avoid counting commands executed from startup files. |
|
|
805 |
|
|
806 command_editor::reset_current_command_number (1); |
|
|
807 |
|
|
808 // Now argv should have the full set of args. |
|
|
809 intern_argv (argc, argv); |
|
|
810 |
|
|
811 if (! embedded) |
|
|
812 switch_to_buffer (create_buffer (get_input_from_stdin ())); |
|
|
813 |
|
1358
|
814 // Force input to be echoed if not really interactive, but the user |
|
|
815 // has forced interactive behavior. |
|
1
|
816 |
|
1907
|
817 if (! interactive && forced_interactive) |
|
287
|
818 { |
|
2926
|
819 command_editor::blink_matching_paren (false); |
|
1588
|
820 |
|
5775
|
821 // FIXME -- is this the right thing to do? |
|
1588
|
822 |
|
5794
|
823 bind_internal_variable ("echo_executing_commands", ECHO_CMD_LINE); |
|
287
|
824 } |
|
1
|
825 |
|
4368
|
826 if (embedded) |
|
5502
|
827 { |
|
5775
|
828 // FIXME -- do we need to do any cleanup here before |
|
5502
|
829 // returning? If we don't, what will happen to Octave functions |
|
|
830 // that have been registered to execute with atexit, for example? |
|
|
831 |
|
|
832 return 1; |
|
|
833 } |
|
4368
|
834 |
|
5189
|
835 int retval = main_loop (); |
|
1
|
836 |
|
1005
|
837 if (retval == 1 && ! error_state) |
|
|
838 retval = 0; |
|
|
839 |
|
1
|
840 clean_up_and_exit (retval); |
|
4247
|
841 |
|
|
842 return 0; |
|
1
|
843 } |
|
|
844 |
|
5780
|
845 DEFUN (argv, args, , |
|
|
846 "-*- texinfo -*-\n\ |
|
|
847 @deftypefn {Built-in Function} {} argv ()\n\ |
|
|
848 Return the command line arguments passed to Octave. For example,\n\ |
|
|
849 if you invoked Octave using the command\n\ |
|
|
850 \n\ |
|
|
851 @example\n\ |
|
|
852 octave --no-line-editing --silent\n\ |
|
|
853 @end example\n\ |
|
|
854 \n\ |
|
|
855 @noindent\n\ |
|
|
856 @code{argv} would return a cell array of strings with the elements\n\ |
|
|
857 @code{--no-line-editing} and @code{--silent}.\n\ |
|
|
858 \n\ |
|
|
859 If you write an executable Octave script, @code{argv} will return the\n\ |
|
|
860 list of arguments passed to the script. @xref{Executable Octave Programs},\n\ |
|
|
861 for an example of how to create an executable Octave script.\n\ |
|
|
862 @end deftypefn") |
|
|
863 { |
|
|
864 octave_value retval; |
|
|
865 |
|
|
866 if (args.length () == 0) |
|
|
867 retval = Cell (octave_argv); |
|
|
868 else |
|
5823
|
869 print_usage (); |
|
5780
|
870 |
|
|
871 return retval; |
|
|
872 } |
|
|
873 |
|
|
874 DEFUN (program_invocation_name, args, , |
|
|
875 "-*- texinfo -*-\n\ |
|
|
876 @deftypefn {Built-in Function} program_invocation_name ()\n\ |
|
|
877 Return the name that was typed at the shell prompt to run Octave.\n\ |
|
|
878 \n\ |
|
|
879 If executing a script from the command line (e.g., @code{octave foo.m})\n\ |
|
|
880 or using an executable Octave script, the program name is set to the\n\ |
|
|
881 name of the script. @xref{Executable Octave Programs}, for an example of\n\ |
|
|
882 how to create an executable Octave script.\n\ |
|
|
883 @seealso{program_name}\n\ |
|
|
884 @end deftypefn") |
|
|
885 { |
|
|
886 octave_value retval; |
|
|
887 |
|
|
888 if (args.length () == 0) |
|
|
889 retval = octave_program_invocation_name; |
|
|
890 else |
|
5823
|
891 print_usage (); |
|
5780
|
892 |
|
|
893 return retval; |
|
|
894 } |
|
|
895 |
|
|
896 DEFUN (program_name, args, , |
|
|
897 "-*- texinfo -*-\n\ |
|
|
898 @deftypefn {Built-in Function} {} program_name ()\n\ |
|
|
899 Return the last component of of the value returned by\n\ |
|
|
900 @code{program_invocation_name}.\n\ |
|
|
901 @seealso{program_invocation_name}\n\ |
|
|
902 @end deftypefn") |
|
|
903 { |
|
|
904 octave_value retval; |
|
|
905 |
|
|
906 if (args.length () == 0) |
|
|
907 retval = octave_program_name; |
|
|
908 else |
|
5823
|
909 print_usage (); |
|
5780
|
910 |
|
|
911 return retval; |
|
|
912 } |
|
|
913 |
|
560
|
914 /* |
|
1
|
915 ;;; Local Variables: *** |
|
|
916 ;;; mode: C++ *** |
|
|
917 ;;; End: *** |
|
|
918 */ |
