cgminer (1)

---

NAME

cgminer - multi-threaded multi-pool GPU, FPGA and CPU bitcoin miner.

SYNOPSIS

cgminer [-DdGEgIKklmpPQqsTouvwOchnV]

DESCRIPTION

multi-threaded multi-pool GPU, FPGA and CPU bitcoin miner. Built with bflsc GPU bitforce icarus avalon modminer scrypt mining support.

OPTIONS

Options for both config file and command line:

--api-allow <arg>

Allow API access only to the given list of [G:]IP[/Prefix] addresses[/subnets]

--api-description <arg>

Description placed in the API status header, default: cgminer version

--api-groups <arg>

API one letter groups G:cmd:cmd[,P:cmd:*...] defining the cmds a groups can use

--api-listen

Enable API, default: disabled

--api-network

Allow API (if enabled) to listen on/for any address, default: only 127.0.0.1

--api-port <arg>

Port number of miner API (default: 4028)

--balance

Change multipool strategy from failover to even share balance

--benchmark

Run cgminer in benchmark mode - produces no shares

--bfl-range

Use nonce range on bitforce devices if supported

--compact

Use compact display without per device statistics

--debug|-D

Enable debug output

--device|-d <arg>

Select device to use, (Use repeat -d for multiple devices, default: all)

--disable-gpu|-G

Disable GPU mining even if suitable devices exist

--disable-rejecting

Automatically disable pools that continually reject shares

--expiry|-E <arg>

Upper bound on how many seconds after getting work we consider a share from it stale (default: 120)

--failover-only

Don't leak work to backup pools when primary pool is lagging

--fix-protocol

Do not redirect to a different getwork protocol (eg. stratum)

--gpu-dyninterval <arg>

Set the refresh interval in ms for GPUs using dynamic intensity (default: 7)

--gpu-platform <arg>

Select OpenCL platform ID to use for GPU mining (default: -1)

--gpu-threads|-g <arg>

Number of threads per GPU (1 - 10) (default: -1)

--lookup-gap <arg>

Set GPU lookup gap for scrypt mining, comma separated

--intensity|-I <arg>

Intensity of GPU scanning (d or -10 -> 20, default: d to maintain desktop interactivity)

--hotplug <arg>

Seconds between hotplug checks (0 means never check)

--kernel-path|-K <arg>

Specify a path to where bitstream and kernel files are (default: "/usr/lib/cgminer")

--kernel|-k <arg>

Override sha256 kernel to use (diablo, poclbm, phatk or diakgcn) - one value or comma separated

--load-balance

Change multipool strategy from failover to efficiency based balance

--log|-l <arg>

Interval in seconds between log output (default: 5)

--lowmem

Minimise caching of shares for low memory applications

--monitor|-m <arg>

Use custom pipe cmd for output messages

--net-delay

Impose small delays in networking to not overload slow routers

--no-restart

Do not attempt to restart GPUs that hang

--no-submit-stale

Don't submit shares if they are detected as stale

--pass|-p <arg>

Password for bitcoin JSON-RPC server

--per-device-stats

Force verbose mode and output per-device statistics

--protocol-dump|-P

Verbose dump of protocol-level activities

--queue|-Q <arg>

Minimum number of work items to have queued (0+) (default: 1)

--quiet|-q

Disable logging output, display status and errors

--real-quiet

Disable all output

--remove-disabled

Remove disabled devices entirely, as if they didn't exist

--rotate <arg>

Change multipool strategy from failover to regularly rotate at N minutes (default: 0)

--round-robin

Change multipool strategy from failover to round robin on failure

--scan-time|-s <arg>

Upper bound on time spent scanning current work, in seconds (default: -1)

--sched-start <arg>

Set a time of day in HH:MM to start mining (a once off without a stop time)

--sched-stop <arg>

Set a time of day in HH:MM to stop mining (will quit without a start time)

--scrypt

Use the scrypt algorithm for mining (litecoin only)

--shaders <arg>

GPU shaders per card for tuning scrypt, comma separated

--sharelog <arg>

Append share log to file

--shares <arg>

Quit after mining N shares (default: unlimited)

--socks-proxy <arg>

Set socks4 proxy (host:port)

--syslog

Use system log for output messages (default: standard error)

--temp-cutoff <arg>

Temperature where a device will be automatically disabled, one value or comma separated list (default: 95)

--text-only|-T

Disable ncurses formatted screen output

--thread-concurrency <arg>

Set GPU thread concurrency for scrypt mining, comma separated

--url|-o <arg>

URL for bitcoin JSON-RPC server

--user|-u <arg>

Username for bitcoin JSON-RPC server

--usb <arg>

USB device selection

--vectors|-v <arg>

Override detected optimal vector (1, 2 or 4) - one value or comma separated list

--verbose

Log verbose output to stderr as well as status output

--worksize|-w <arg>

Override detected optimal worksize - one value or comma separated list

--userpass|-O <arg>

Username:Password pair for bitcoin JSON-RPC server

--worktime

Display extra work time debug information

Options for command line only:

--config|-c <arg>

Load a JSON-format configuration file See example.conf for an example configuration.

--default-config <arg>

Specify the filename of the default config file Loaded at start and used when saving without a name.

--help|-h

Print this message

--ndevs|-n

Display number of detected GPUs, OpenCL platform information, all USB devices, and exit

--version|-V

Display version and exit

---