|
2333
|
1 @c Copyright (C) 1996 John W. Eaton |
|
|
2 @c This is part of the Octave manual. |
|
|
3 @c For copying conditions, see the file gpl.texi. |
|
|
4 |
|
|
5 @node System Utilities, Command History Functions, String Functions, Top |
|
|
6 @chapter System Utilities |
|
|
7 |
|
|
8 This chapter describes the functions that are available to allow you to |
|
|
9 get information about what is happening outside of Octave, while it is |
|
|
10 still running, and use this information in your program. For example, |
|
|
11 you can get information about environment variables, the current time, |
|
|
12 and even start other programs from the Octave prompt. |
|
|
13 |
|
|
14 @menu |
|
|
15 * Timing Utilities:: |
|
|
16 * Filesystem Utilities:: |
|
|
17 * Interacting with the OS:: |
|
2460
|
18 * Password Database Functions:: |
|
2475
|
19 * Group Database Functions:: |
|
2333
|
20 * System Information:: |
|
|
21 * Other Functions:: |
|
|
22 @end menu |
|
|
23 |
|
|
24 @node Timing Utilities, Filesystem Utilities, System Utilities, System Utilities |
|
|
25 @section Timing Utilities |
|
|
26 |
|
2465
|
27 @deftypefn {Loadable Function} {} time () |
|
2449
|
28 Return the current time as the number of seconds since the epoch. The |
|
|
29 epoch is referenced to 00:00:00 CUT (Coordinated Universal Time) 1 Jan |
|
|
30 1970. |
|
|
31 @end deftypefn |
|
2333
|
32 |
|
|
33 Several of Octave's time functions a data structure for time that |
|
|
34 includes the following elements: |
|
|
35 |
|
|
36 @table @code |
|
|
37 @item usec |
|
|
38 Microseconds after the second (0-999999). |
|
|
39 |
|
|
40 @item sec |
|
|
41 Seconds after the minute (0-61). This number can be 61 to account |
|
|
42 for leap seconds. |
|
|
43 |
|
|
44 @item min |
|
|
45 Minutes after the hour (0-59). |
|
|
46 |
|
|
47 @item hour |
|
|
48 Hours since midnight (0-23). |
|
|
49 |
|
|
50 @item mday |
|
|
51 Day of the month (1-31). |
|
|
52 |
|
|
53 @item mon |
|
|
54 Months since January (0-11). |
|
|
55 |
|
|
56 @item year |
|
|
57 Years since 1900. |
|
|
58 |
|
|
59 @item wday |
|
|
60 Days since Sunday (0-6). |
|
|
61 |
|
|
62 @item yday |
|
|
63 Days since January 1 (0-365). |
|
|
64 |
|
|
65 @item isdst |
|
|
66 Daylight Savings Time flag. |
|
|
67 |
|
|
68 @item zone |
|
|
69 Time zone. |
|
|
70 @end table |
|
|
71 |
|
2465
|
72 @deftypefn {Loadable Function} {} mktime (@var{time_struct}) |
|
2449
|
73 Convert a time structure to the number of seconds since the epoch. |
|
|
74 @end deftypefn |
|
2333
|
75 |
|
2465
|
76 @deftypefn {Loadable Function} {} localtime (@var{t}) |
|
2449
|
77 Given a value returned from time (or any nonnegative integer), |
|
|
78 return a time structure corresponding to the local time zone. |
|
|
79 @end deftypefn |
|
2333
|
80 |
|
2465
|
81 @deftypefn {Loadable Function} {} gmtime (@var{t}) |
|
2449
|
82 Given a value returned from time (or any nonnegative integer), |
|
|
83 return a time structure corresponding to CUT. |
|
|
84 @end deftypefn |
|
2333
|
85 |
|
2449
|
86 @deftypefn {Function File} {} asctime (@var{time_struct}) |
|
|
87 Convert a time structure to a string using the following five-field |
|
|
88 format: Thu Mar 28 08:40:14 1996. The function @code{ctime (time)} is |
|
|
89 equivalent to @code{asctime (localtime (time))}. |
|
|
90 @end deftypefn |
|
2333
|
91 |
|
2465
|
92 @deftypefn {Loadable Function} {} strftime (@var{time_struct}) |
|
2449
|
93 Format a time structure in a flexible way using @samp{%} substitutions |
|
|
94 similar to those in @code{printf}. Except where noted, substituted |
|
|
95 fields have a fixed size; numeric fields are padded if necessary. |
|
|
96 Padding is with zeros by default; for fields that display a single |
|
|
97 number, padding can be changed or inhibited by following the @samp{%} |
|
|
98 with one of the modifiers described below. Unknown field specifiers are |
|
|
99 copied as normal characters. All other characters are copied to the |
|
|
100 output without change. |
|
2333
|
101 |
|
|
102 Octave's @code{strftime} function supports a superset of the ANSI C |
|
|
103 field specifiers. |
|
|
104 |
|
|
105 @noindent |
|
|
106 Literal character fields: |
|
|
107 |
|
|
108 @table @code |
|
|
109 @item % |
|
|
110 % character. |
|
|
111 |
|
|
112 @item n |
|
|
113 Newline character. |
|
|
114 |
|
|
115 @item t |
|
|
116 Tab character. |
|
|
117 @end table |
|
|
118 |
|
|
119 @noindent |
|
|
120 Numeric modifiers (a nonstandard extension): |
|
|
121 |
|
|
122 @table @code |
|
|
123 @item - |
|
|
124 Do not pad the field. |
|
|
125 |
|
|
126 @item _ |
|
|
127 Pad the field with spaces. |
|
|
128 @end table |
|
|
129 |
|
|
130 @noindent |
|
|
131 Time fields: |
|
|
132 |
|
|
133 @table @code |
|
|
134 @item %H |
|
|
135 Hour (00-23). |
|
|
136 |
|
|
137 @item %I |
|
|
138 Hour (01-12). |
|
|
139 |
|
|
140 @item %k |
|
|
141 Hour (0-23). |
|
|
142 |
|
|
143 @item %l |
|
|
144 Hour (1-12). |
|
|
145 |
|
|
146 @item %M |
|
|
147 Minute (00-59). |
|
|
148 |
|
|
149 @item %p |
|
|
150 Locale's AM or PM. |
|
|
151 |
|
|
152 @item %r |
|
|
153 Time, 12-hour (hh:mm:ss [AP]M). |
|
|
154 |
|
|
155 @item %R |
|
|
156 Time, 24-hour (hh:mm). |
|
|
157 |
|
|
158 @item %s |
|
|
159 Time in seconds since 00:00:00, Jan 1, 1970 (a nonstandard extension). |
|
|
160 |
|
|
161 @item %S |
|
|
162 Second (00-61). |
|
|
163 |
|
|
164 @item %T |
|
|
165 Time, 24-hour (hh:mm:ss). |
|
|
166 |
|
|
167 @item %X |
|
|
168 Locale's time representation (%H:%M:%S). |
|
|
169 |
|
|
170 @item %Z |
|
|
171 Time zone (EDT), or nothing if no time zone is determinable. |
|
|
172 @end table |
|
|
173 |
|
|
174 @noindent |
|
|
175 Date fields: |
|
|
176 |
|
|
177 @table @code |
|
|
178 @item %a |
|
|
179 Locale's abbreviated weekday name (Sun-Sat). |
|
|
180 |
|
|
181 @item %A |
|
|
182 Locale's full weekday name, variable length (Sunday-Saturday). |
|
|
183 |
|
|
184 @item %b |
|
|
185 Locale's abbreviated month name (Jan-Dec). |
|
|
186 |
|
|
187 @item %B |
|
|
188 Locale's full month name, variable length (January-December). |
|
|
189 |
|
|
190 @item %c |
|
|
191 Locale's date and time (Sat Nov 04 12:02:33 EST 1989). |
|
|
192 |
|
|
193 @item %C |
|
|
194 Century (00-99). |
|
|
195 |
|
|
196 @item %d |
|
|
197 Day of month (01-31). |
|
|
198 |
|
|
199 @item %e |
|
|
200 Day of month ( 1-31). |
|
|
201 |
|
|
202 @item %D |
|
|
203 Date (mm/dd/yy). |
|
|
204 |
|
|
205 @item %h |
|
|
206 Same as %b. |
|
|
207 |
|
|
208 @item %j |
|
|
209 Day of year (001-366). |
|
|
210 |
|
|
211 @item %m |
|
|
212 Month (01-12). |
|
|
213 |
|
|
214 @item %U |
|
|
215 Week number of year with Sunday as first day of week (00-53). |
|
|
216 |
|
|
217 @item %w |
|
|
218 Day of week (0-6). |
|
|
219 |
|
|
220 @item %W |
|
|
221 Week number of year with Monday as first day of week (00-53). |
|
|
222 |
|
|
223 @item %x |
|
|
224 Locale's date representation (mm/dd/yy). |
|
|
225 |
|
|
226 @item %y |
|
|
227 Last two digits of year (00-99). |
|
|
228 |
|
|
229 @item %Y |
|
|
230 Year (1970-). |
|
|
231 @end table |
|
2449
|
232 @end deftypefn |
|
2333
|
233 |
|
2449
|
234 @deftypefn {Function File} {} clock () |
|
|
235 Return a vector containing the current year, month (1-12), day (1-31), |
|
|
236 hour (0-23), minute (0-59) and second (0-61). For example, |
|
2333
|
237 |
|
|
238 @example |
|
|
239 octave:13> clock |
|
|
240 ans = |
|
|
241 |
|
|
242 1993 8 20 4 56 1 |
|
|
243 @end example |
|
|
244 |
|
|
245 The function clock is more accurate on systems that have the |
|
|
246 @code{gettimeofday} function. |
|
2449
|
247 @end deftypefn |
|
2333
|
248 |
|
2449
|
249 @deftypefn {Function File} {} date () |
|
|
250 Returns the date as a character string in the form DD-MMM-YY. For |
|
|
251 example, |
|
2333
|
252 |
|
|
253 @example |
|
|
254 octave:13> date |
|
|
255 ans = 20-Aug-93 |
|
|
256 @end example |
|
2449
|
257 @end deftypefn |
|
2333
|
258 |
|
2449
|
259 @deftypefn {Function File} {} tic () |
|
|
260 @deftypefnx {Function File} {} toc () |
|
|
261 These functions set and check a wall-clock timer. For example, |
|
2333
|
262 |
|
|
263 @example |
|
|
264 tic (); |
|
|
265 # many computations later... |
|
|
266 elapsed_time = toc (); |
|
|
267 @end example |
|
|
268 |
|
|
269 @noindent |
|
|
270 will set the variable @code{elapsed_time} to the number of seconds since |
|
|
271 the most recent call to the function @code{tic}. |
|
2449
|
272 @end deftypefn |
|
2333
|
273 |
|
2449
|
274 @deftypefn {Function File} {} etime (@var{t1}, @var{t2}) |
|
|
275 Return the difference (in seconds) between two time values returned from |
|
|
276 @code{clock}. For example: |
|
2333
|
277 |
|
|
278 @example |
|
|
279 t0 = clock (); |
|
|
280 # many computations later... |
|
|
281 elapsed_time = etime (clock (), t0); |
|
|
282 @end example |
|
|
283 |
|
|
284 @noindent |
|
|
285 will set the variable @code{elapsed_time} to the number of seconds since |
|
|
286 the variable @code{t0} was set. |
|
2449
|
287 @end deftypefn |
|
2333
|
288 |
|
2449
|
289 @deftypefn {Built-in Function} {[@var{total}, @var{user}, @var{system}] =} cputime (); |
|
|
290 Return the CPU time used by your Octave session. The first output is |
|
2333
|
291 the total time spent executing your process and is equal to the sum of |
|
|
292 second and third outputs, which are the number of CPU seconds spent |
|
|
293 executing in user mode and the number of CPU seconds spent executing in |
|
|
294 system mode, respectively. If your system does not have a way to report |
|
|
295 CPU time usage, @code{cputime} returns 0 for each of its output values. |
|
2449
|
296 @end deftypefn |
|
2333
|
297 |
|
2449
|
298 @deftypefn {Function File} {} is_leap_year (@var{year}) |
|
|
299 Return 1 if the given year is a leap year and 0 otherwise. If no |
|
|
300 arguments are provided, @code{is_leap_year} will use the current year. |
|
|
301 For example, |
|
2333
|
302 |
|
|
303 @example |
|
|
304 octave:13> is_leap_year (2000) |
|
|
305 ans = 1 |
|
|
306 @end example |
|
2449
|
307 @end deftypefn |
|
2333
|
308 |
|
|
309 @node Filesystem Utilities, Interacting with the OS, Timing Utilities, System Utilities |
|
|
310 @section Filesystem Utilities |
|
|
311 |
|
|
312 Octave includes the following functions for renaming and deleting files, |
|
|
313 creating, deleting, and reading directories, and for getting information |
|
|
314 about the status of files. |
|
|
315 |
|
2449
|
316 @deftypefn {Built-in Function} {} rename (@var{from}, @var{to}) |
|
2333
|
317 Rename a file. |
|
2449
|
318 @end deftypefn |
|
2333
|
319 |
|
2449
|
320 @deftypefn {Built-in Function} {} unlink (@var{file}) |
|
2333
|
321 Delete a file. |
|
2449
|
322 @end deftypefn |
|
2333
|
323 |
|
2449
|
324 @deftypefn {Built-in Function} {} readdir (@var{dir}) |
|
2333
|
325 Returns names of files in the directory @var{dir} as an array of |
|
|
326 strings. |
|
2449
|
327 @end deftypefn |
|
2333
|
328 |
|
2449
|
329 @deftypefn {Built-in Function} {} mkdir (@var{dir}) |
|
|
330 Create a directory |
|
|
331 @end deftypefn |
|
2333
|
332 |
|
2449
|
333 @deftypefn {Built-in Function} {} rmdir (@var{dir}) |
|
|
334 Remove a directory. |
|
|
335 @end deftypefn |
|
|
336 |
|
2333
|
337 @c XXX FIXME XXX -- this needs to be explained, but I don't feel up to |
|
|
338 @c it just now... |
|
|
339 |
|
2449
|
340 @deftypefn {Built-in Function} {} umask (@var{mask}) |
|
|
341 Set permission mask for file creation. |
|
|
342 @end deftypefn |
|
|
343 |
|
|
344 @deftypefn {Built-in Function} {} stat (@var{file}) |
|
2333
|
345 Get information about a file. If @var{file} is a symbolic link, |
|
|
346 @code{stat} returns information about the file that the symbolic link |
|
|
347 references. |
|
2449
|
348 @end deftypefn |
|
2333
|
349 |
|
2449
|
350 @deftypefn {Built-in Function} {} lstat (@var{file}) |
|
2333
|
351 Get information about a symbolic link. If @var{file} is not a symbolic |
|
|
352 link, @code{lstat} is equivalent to @code{stat}. |
|
2449
|
353 @end deftypefn |
|
2333
|
354 |
|
2460
|
355 @node Interacting with the OS, Password Database Functions, Filesystem Utilities, System Utilities |
|
2333
|
356 @section Interacting with the OS |
|
|
357 |
|
2449
|
358 @deftypefn {Built-in Function} {} fork () |
|
|
359 Create a copy of the current process. |
|
|
360 @end deftypefn |
|
|
361 |
|
|
362 @deftypefn {Built-in Function} {} exec (@var{file}, @var{args}) |
|
|
363 Replace current process with a new process. |
|
|
364 @end deftypefn |
|
|
365 |
|
|
366 @deftypefn {Built-in Function} {fid =} dup2 (@var{old}, @var{new}) |
|
|
367 Duplicate a file descriptor. |
|
|
368 @end deftypefn |
|
|
369 |
|
|
370 @deftypefn {Built-in Function} {[@var{file_ids}, @var{status}] =} pipe () |
|
|
371 Create an interprocess channel. |
|
|
372 @end deftypefn |
|
|
373 |
|
|
374 @deftypefn {Built-in Function} {} fcntl (@var{fid}, @var{request}, @var{argument}) |
|
|
375 Control open file descriptors. |
|
|
376 |
|
|
377 @vtable @code |
|
|
378 @item F_DUPFD |
|
|
379 @item F_GETFD |
|
|
380 @item F_GETFL |
|
|
381 @item F_SETFD |
|
|
382 @item F_SETFL |
|
|
383 @item O_APPEND |
|
|
384 @item O_CREAT |
|
|
385 @item O_EXCL |
|
|
386 @item O_NONBLOCK |
|
|
387 @item O_RDONLY |
|
|
388 @item O_RDWR |
|
|
389 @item O_TRUNC |
|
|
390 @item O_WRONLY |
|
|
391 @end vtable |
|
|
392 @end deftypefn |
|
2333
|
393 |
|
2449
|
394 @deftypefn {Built-in Function} {} getpgrp () |
|
|
395 Return the process group id of the current process. |
|
|
396 @end deftypefn |
|
|
397 |
|
|
398 @deftypefn {Built-in Function} {} getpid () |
|
|
399 Return the process id of the current process. |
|
|
400 @end deftypefn |
|
|
401 |
|
|
402 @deftypefn {Built-in Function} {} getppid () |
|
|
403 Return the process id of the parent process. |
|
|
404 @end deftypefn |
|
|
405 |
|
2475
|
406 @deftypefn {Built-in Function} {} geteuid () |
|
|
407 Return the effective user id of the current process. |
|
|
408 @end deftypefn |
|
|
409 |
|
|
410 @deftypefn {Built-in Function} {} getuid () |
|
|
411 Return the real user id of the current process. |
|
|
412 @end deftypefn |
|
|
413 |
|
|
414 @deftypefn {Built-in Function} {} getegid () |
|
|
415 Return the effective group id of the current process. |
|
|
416 @end deftypefn |
|
|
417 |
|
|
418 @deftypefn {Built-in Function} {} getgid () |
|
|
419 Return the real group id of the current process. |
|
|
420 @end deftypefn |
|
|
421 |
|
2449
|
422 @deftypefn {Built-in Function} {} mkfifo |
|
|
423 Create a FIFO special file. |
|
|
424 @end deftypefn |
|
|
425 |
|
|
426 @deftypefn {Built-in Function} {} waitpid |
|
|
427 Check the status of or wait for subprocesses. |
|
|
428 @end deftypefn |
|
2333
|
429 |
|
2449
|
430 @deftypefn {Built-in Function} {} atexit (@var{fcn}) |
|
|
431 Register function to be called when Octave exits. |
|
|
432 @end deftypefn |
|
|
433 |
|
|
434 @deftypefn {Built-in Function} {} system (@var{string}, @var{return_output}, @var{type}) |
|
|
435 Execute a shell command specified by @var{string}. The second argument is optional. |
|
|
436 If @var{type} is @code{"async"}, the process is started in the |
|
|
437 background and the process id of the child proces is returned |
|
|
438 immediately. Otherwise, the process is started, and Octave waits until |
|
|
439 it exits. If @var{type} argument is omitted, a value of @code{"sync"} |
|
|
440 is assumed. |
|
|
441 |
|
|
442 If two input arguments are given (the actual value of |
|
|
443 @var{return_output} is irrelevant) and the subprocess is started |
|
|
444 synchronously, or if @var{system} is called with one input argument and |
|
|
445 one or more output arguments, the output from the command is returned. |
|
|
446 Otherwise, if the subprocess is executed synchronously, it's output is |
|
|
447 sent to the standard output. To send the output of a command executed |
|
|
448 with @var{system} through the pager, use a command like |
|
2333
|
449 |
|
|
450 @example |
|
2449
|
451 disp (system (cmd, 1)); |
|
2333
|
452 @end example |
|
|
453 |
|
|
454 @noindent |
|
2449
|
455 or |
|
2333
|
456 |
|
|
457 @example |
|
2449
|
458 printf ("%s\n", system (cmd, 1)); |
|
2333
|
459 @end example |
|
|
460 |
|
|
461 The @code{system} function can return two values. The first is any |
|
|
462 output from the command that was written to the standard output stream, |
|
|
463 and the second is the output status of the command. For example, |
|
|
464 |
|
|
465 @example |
|
|
466 [output, status] = system ("echo foo; exit 2"); |
|
|
467 @end example |
|
|
468 |
|
|
469 @noindent |
|
|
470 will set the variable @code{output} to the string @samp{foo}, and the |
|
|
471 variable @code{status} to the integer @samp{2}. |
|
2449
|
472 @end deftypefn |
|
2333
|
473 |
|
2449
|
474 @defvr {Built-in Variable} EXEC_PATH |
|
|
475 The variable @code{EXEC_PATH} is a colon separated list of directories |
|
|
476 to search when executing subprograms. Its initial value is taken from |
|
|
477 the environment variable @code{OCTAVE_EXEC_PATH} (if it exists) or |
|
|
478 @code{PATH}, but that value can be overridden by the the command line |
|
|
479 argument @code{--exec-path PATH}, or by setting the value of |
|
|
480 @code{EXEC_PATH} in a startup script. If the value of @code{EXEC_PATH} |
|
|
481 begins (ends) with a colon, the directories |
|
2469
|
482 @code{OCTAVE_HOME/libexec/octave/site/exec/ARCH}, |
|
2449
|
483 @code{OCTAVE_HOME/libexec/octave/VERSION/exec/ARCH} and |
|
2469
|
484 @code{OCTAVE_HOME/bin} are prepended (appended) to @code{EXEC_PATH}, |
|
|
485 where @code{OCTAVE_HOME} is the top-level directory where all of Octave |
|
|
486 is installed (@file{/usr/local} by default). If you don't specify a |
|
|
487 value for @code{EXEC_PATH} explicitly, these special directories are |
|
|
488 prepended to your shell path. |
|
2449
|
489 @end defvr |
|
2333
|
490 |
|
2449
|
491 @deftypefn {Built-in Function} {} getenv (@var{var}) |
|
|
492 Returns the value of the environment variable @var{var}. For example, |
|
2333
|
493 |
|
|
494 @example |
|
|
495 getenv ("PATH") |
|
|
496 @end example |
|
|
497 |
|
|
498 @noindent |
|
|
499 returns a string containing the value of your path. |
|
2449
|
500 @end deftypefn |
|
2333
|
501 |
|
2449
|
502 @deftypefn {Built-in Function} {} putenv (@var{var}, @var{value}) |
|
|
503 Set the value of the environment variable @var{var} to @var{value}. |
|
|
504 @end deftypefn |
|
2333
|
505 |
|
2449
|
506 @deftypefn {Built-in Function} {} clc () |
|
|
507 @deftypefnx {Built-in Function} {} home () |
|
|
508 Clear the terminal screen and move the cursor to the upper left corner. |
|
|
509 @end deftypefn |
|
2333
|
510 |
|
2449
|
511 @deffn {Command} cd dir |
|
|
512 @deffnx {Command} chdir dir |
|
|
513 Change the current working directory to @var{dir}. For example, |
|
2333
|
514 |
|
|
515 @example |
|
|
516 cd ~/octave |
|
|
517 @end example |
|
|
518 |
|
|
519 @noindent |
|
|
520 Changes the current working directory to @file{~/octave}. If the |
|
|
521 directory does not exist, an error message is printed and the working |
|
|
522 directory is not changed. |
|
2449
|
523 @end deffn |
|
2333
|
524 |
|
2449
|
525 @deftypefn {Built-in Function} {} pwd () |
|
|
526 Returns the current working directory. |
|
|
527 @end deftypefn |
|
2333
|
528 |
|
2449
|
529 @defvr {Built-in Variable} PWD |
|
|
530 The current working directory. The value of @code{PWD} is updated each |
|
|
531 time the current working directory is changed with the @samp{cd} |
|
|
532 command. |
|
|
533 @end defvr |
|
2333
|
534 |
|
2449
|
535 @deffn {Command} ls |
|
|
536 @deffnx {Command} dir |
|
|
537 List directory contents. For example, |
|
2333
|
538 |
|
|
539 @example |
|
|
540 octave:13> ls -l |
|
|
541 total 12 |
|
|
542 -rw-r--r-- 1 jwe users 4488 Aug 19 04:02 foo.m |
|
|
543 -rw-r--r-- 1 jwe users 1315 Aug 17 23:14 bar.m |
|
|
544 @end example |
|
|
545 |
|
|
546 The @code{dir} and @code{ls} commands are implemented by calling your |
|
|
547 system's directory listing command, so the available options may vary |
|
|
548 from system to system. |
|
2449
|
549 @end deffn |
|
2333
|
550 |
|
2475
|
551 @node Password Database Functions, Group Database Functions, Interacting with the OS, System Utilities |
|
2460
|
552 @section Password Database Functions |
|
|
553 |
|
|
554 Octave's password database functions return information in a structure |
|
|
555 with the following fields. |
|
|
556 |
|
|
557 @table @code |
|
|
558 @item name |
|
|
559 The user name. |
|
|
560 |
|
|
561 @item passwd |
|
|
562 The encrypted password, if available. |
|
|
563 |
|
|
564 @item uid |
|
|
565 The numeric user id. |
|
|
566 |
|
|
567 @item gid |
|
|
568 The numeric group id. |
|
|
569 |
|
|
570 @item gecos |
|
|
571 The GECOS field. |
|
|
572 |
|
|
573 @item dir |
|
|
574 The home directory. |
|
|
575 |
|
|
576 @item shell |
|
|
577 The initial shell. |
|
|
578 @end table |
|
|
579 |
|
2465
|
580 @deftypefn {Loadable Function} {passwd_struct =} getpwent () |
|
2460
|
581 Return an entry from the password database, opening it if necessary. |
|
|
582 Once the end of the data has been reached, @code{getpwent} returns 0. |
|
|
583 @end deftypefn |
|
|
584 |
|
2465
|
585 @deftypefn {Loadable Function} {passwd_struct =} getpwuid (@var{uid}). |
|
2460
|
586 Return the first entry from the password database with the user ID |
|
|
587 @var{uid}. If the user ID does not exist in the database, |
|
2462
|
588 @code{getpwuid} returns 0. |
|
2460
|
589 @end deftypefn |
|
|
590 |
|
2465
|
591 @deftypefn {Loadable Function} {passwd_struct =} getpwnam (@var{name}) |
|
2460
|
592 Return the first entry from the password database with the user name |
|
|
593 @var{name}. If the user name does not exist in the database, |
|
2462
|
594 @code{getpwname} returns 0. |
|
2460
|
595 @end deftypefn |
|
|
596 |
|
2465
|
597 @deftypefn {Loadable Function} {} setpwent () |
|
2460
|
598 Return the internal pointer to the beginning of the password database. |
|
|
599 @end deftypefn |
|
|
600 |
|
2465
|
601 @deftypefn {Loadable Function} {} endpwent () |
|
2460
|
602 Close the password database. |
|
|
603 @end deftypefn |
|
|
604 |
|
2475
|
605 @node Group Database Functions, System Information, Password Database Functions, System Utilities |
|
|
606 @section Group Database Functions |
|
|
607 |
|
|
608 Octave's group database functions return information in a structure |
|
|
609 with the following fields. |
|
|
610 |
|
|
611 @table @code |
|
|
612 @item name |
|
|
613 The user name. |
|
|
614 |
|
|
615 @item passwd |
|
|
616 The encrypted password, if available. |
|
|
617 |
|
|
618 @item gid |
|
|
619 The numeric group id. |
|
|
620 |
|
|
621 @item mem |
|
|
622 The members of the group. |
|
|
623 @end table |
|
|
624 |
|
|
625 @deftypefn {Loadable Function} {group_struct =} getgrent () |
|
|
626 Return an entry from the group database, opening it if necessary. |
|
|
627 Once the end of the data has been reached, @code{getgrent} returns 0. |
|
|
628 @end deftypefn |
|
|
629 |
|
|
630 @deftypefn {Loadable Function} {group_struct =} getgrgid (@var{gid}). |
|
|
631 Return the first entry from the group database with the group ID |
|
|
632 @var{gid}. If the group ID does not exist in the database, |
|
|
633 @code{getgrgid} returns 0. |
|
|
634 @end deftypefn |
|
|
635 |
|
|
636 @deftypefn {Loadable Function} {group_struct =} getgrnam (@var{name}) |
|
|
637 Return the first entry from the group database with the group name |
|
|
638 @var{name}. If the group name does not exist in the database, |
|
|
639 @code{getgrname} returns 0. |
|
|
640 @end deftypefn |
|
|
641 |
|
|
642 @deftypefn {Loadable Function} {} setgrent () |
|
|
643 Return the internal pointer to the beginning of the group database. |
|
|
644 @end deftypefn |
|
|
645 |
|
|
646 @deftypefn {Loadable Function} {} endgrent () |
|
|
647 Close the group database. |
|
|
648 @end deftypefn |
|
|
649 |
|
|
650 @node System Information, Other Functions, Group Database Functions, System Utilities |
|
2333
|
651 @section System Information |
|
|
652 |
|
2449
|
653 @deftypefn {Built-in Function} {} computer () |
|
|
654 Returns a string of the form @var{cpu}-@var{vendor}-@var{os} that |
|
|
655 identifies the kind of computer Octave is running on. For example, |
|
2333
|
656 |
|
|
657 @example |
|
|
658 octave:13> computer |
|
|
659 sparc-sun-sunos4.1.2 |
|
|
660 @end example |
|
2449
|
661 @end deftypefn |
|
2333
|
662 |
|
2449
|
663 @deftypefn {Built-in Function} {} isieee () |
|
|
664 Return 1 if your computer claims to conform to the IEEE standard for |
|
|
665 floating point calculations. |
|
|
666 @end deftypefn |
|
2333
|
667 |
|
2449
|
668 @deftypefn {Built-in Function} {} version () |
|
|
669 Returns Octave's version number as a string. This is also the value of |
|
|
670 the built-in variable @code{OCTAVE_VERSION}. @xref{Built-in Variables}. |
|
|
671 @end deftypefn |
|
2333
|
672 |
|
2465
|
673 @deftypefn {Loadable Function} {} getrusage () |
|
2449
|
674 Return a structure containing a number of statistics about the current |
|
|
675 Octave process. Not all fields are available on all systems. If it is |
|
|
676 not possible to get CPU time statistics, the CPU time slots are set to |
|
|
677 zero. Other missing data are replaced by NaN. Here is a list of all |
|
|
678 the possible fields that can be present in the structure returned by |
|
|
679 @code{getrusage}: |
|
2333
|
680 |
|
|
681 @table @code |
|
|
682 @item |
|
|
683 @item idrss |
|
|
684 Unshared data size. |
|
|
685 |
|
|
686 @item inblock |
|
|
687 Number of block input operations. |
|
|
688 |
|
|
689 @item isrss |
|
|
690 Unshared stack size. |
|
|
691 |
|
|
692 @item ixrss |
|
|
693 Shared memory size. |
|
|
694 |
|
|
695 @item majflt |
|
|
696 Number of major page faults. |
|
|
697 |
|
|
698 @item maxrss |
|
|
699 Maximum data size. |
|
|
700 |
|
|
701 @item minflt |
|
|
702 Number of minor page faults. |
|
|
703 |
|
|
704 @item msgrcv |
|
|
705 Number of messages received. |
|
|
706 |
|
|
707 @item msgsnd |
|
|
708 Number of messages sent. |
|
|
709 |
|
|
710 @item nivcsw |
|
|
711 Number of involuntary context switches. |
|
|
712 |
|
|
713 @item nsignals |
|
|
714 Number of signals received. |
|
|
715 |
|
|
716 @item nswap |
|
|
717 Number of swaps. |
|
|
718 |
|
|
719 @item nvcsw |
|
|
720 Number of voluntary context switches. |
|
|
721 |
|
|
722 @item oublock |
|
|
723 Number of block output operations. |
|
|
724 |
|
|
725 @item stime |
|
|
726 A structure containing the system CPU time used. The structure has the |
|
|
727 elements @code{sec} (seconds) @code{usec} (microseconds). |
|
|
728 |
|
|
729 @item utime |
|
|
730 A structure containing the user CPU time used. The structure has the |
|
|
731 elements @code{sec} (seconds) @code{usec} (microseconds). |
|
|
732 @end table |
|
2449
|
733 @end deftypefn |
|
2333
|
734 |
|
|
735 @node Other Functions, , System Information, System Utilities |
|
|
736 @section Other Functions |
|
|
737 |
|
2449
|
738 @c XXX FIXME XXX -- need to define tilde expansion. |
|
|
739 |
|
|
740 @deftypefn {Built-in Function} {} tilde_expand (@var{string}) |
|
|
741 Performs tilde expansion on @var{string}. |
|
|
742 @end deftypefn |
|
2333
|
743 |
|
2449
|
744 @deftypefn {Built-in Function} {} pause (@var{seconds}) |
|
|
745 Suspend the execution of the program. If invoked without any arguments, |
|
|
746 Octave waits until you type a character. With a numeric argument, it |
|
|
747 pauses for the given number of seconds. For example, the following |
|
|
748 statement prints a message and then waits 5 seconds before clearing the |
|
|
749 screen. |
|
2333
|
750 |
|
|
751 @example |
|
2449
|
752 @group |
|
|
753 fprintf (stderr, "wait please...\n"); |
|
|
754 pause (5); |
|
|
755 clc; |
|
|
756 @end group |
|
2333
|
757 @end example |
|
2449
|
758 @end deftypefn |
