Home Page The Club Computers News Links Glossary EYAWTK
Before Amiga Background ICS OCS ECS AGA ??? PPC
U-Boot SLB Linux Amiga OS Dual Boot Motherboards Peripherals Other
Initialisation Installation OS4 Updates About OS4 File Systems Networking Printing Other
Introduction File System Workbench Preferences Commands Error Msgs Miscellaneous

AmigaOS 4.0 - About OS4 - Commands

RECORDER Internal
Purpose: Capture console output and store it in a file.
Format: RECORDER [ [TO] <filename>] [APPEND] [OFF] [LINE] [SIZE <number>] [FLUSH]
Template: TO, APPEND/S, OFF/S, LINE/S, SIZE/N/K, FLUSH/S
Path: Internal
RECORDER can be used to capture all data sent to a console window to be displayed. This includes both regular program output and shell commands entered on the command line.

Unless a name is given with the TO <filename> argument, (where the "TO" keyword is optional) RECORDER will send the output to a file named after the current shell process number. For example, if you were to start RECORDER in shell number 4 then it would choose to store the data in a file by the name of "Recorder_4.output".

Data can be stored in a newly created file or appended to an existing file; use the APPEND option for the latter. If the file to append data to does not exist yet it will be created. By default recording will store the incoming data as is, which can be problematic if many small writes are being made.

To avoid performance problems, you can use the LINE option to tell the capturing process to buffer incoming data until an entire line of text has been compiled. Alternatively, you can set a buffer size which controls how many characters have to arrive before they are written to the capture file with the SIZE <number> option. Note that if either the LINE or SIZE options are in effect, you may have to wait for the buffered data to be stored in the capture file.

To have the buffered data sent to the capture file immediately, use the FLUSH option. Note that if the FLUSH option is in effect, all other options will be ignored.

To turn off recording, start the RECORDER command with the OFF option. Note that the OFF option is processed before a new capture file is created, which allows you to stop and restart recording with a single command.

Recording will stop automatically when the console window associated with the shell is closed or when an error occurs while captured data is written to the recording file.

You can stop the recording by sending the recorder process a break signal.

Example 1:

3.OS4:> RECORDER capture APPEND starts recording, sending the data to the file "capture", creating the file if it does not exist yet, appending the new data to it.

Example 2:

3.OS4:> STATUS
Process  2: Loaded as command: C:NetLogViewer
Process  3: Loaded as command: STATUS
Process  5: Loaded as command: RECORDER [3]
3.OS4:> BREAK 5
stops the recording associated with a certain shell process.


Return to Commands Selection

Disclaimer: Amiga Auckland have prepared the above information for the use of its members based on our experiences and as such is subject to revision at any time. Amiga Auckland cannot guarantee any of the information and cannot be held accountable for any issues that may result from using it.


Copyright 2006 Amiga Auckland Inc. All rights reserved.
Revised: February 9, 2006.