User Guide

Appendix B. OSW Command-line Options

This section describes the various command-line options available when running OSW.

General Options

-h, --help
Display list of available command-line options.
-V, --version
Display OSW version.
--server
Run OSW in server mode. Option not available on Windows.
--debug
Run OSW inside the GNU debugger gdb. Option not available on Windows.

Audio Options

-b, --set-buffer-size
Set the default sample buffer size (vector size) for audio signals.
-dr, --driver
Select the audio driver model to use. Use the -l option to find available drivers for your platform. The value none is available on all platforms to disable audio I/O.
-l, --list-drivers
List availalbe audio drivers, along with options and devices available for each driver.
-o, --driver-option
Set options for driver. Each option is of the form "-o option-name value". The following driver-specific options are currently available:

ALSA (Linux)
--device name: name of specific ALSA device to use (default is hw:0).
WinMME (Windows)
--device number: number of specific Windows MME device to use (default is to use load all audio devices except Microsoft Sound Mapper). Devices can be listed using the -l option.
ASIO (Windows)
--device number: number of specific ASIO device to use (default is to use load the first valid ASIO device). Devices can be listed using the -l option.

Other drivers (e.g., CoreAudio) do not currently define options.
-r, --set-sample-rate
Set default audio sample rate.

Linux-specific options

-tt, --task-threads
Set the number of task threads. On Linux, the default is the number of processors in the system (e.g., 1 for uniprocessor systems).

Open Sound World User Guide
© 2000-2004 Amar Chaudhary. All rights reserved.