SYNOPSIS
cgminer [,-DlmpPqUTouOchnV/]DESCRIPTION
multi-threaded multi-pool GPU, FPGA and CPU bitcoin miner. Built with avalon avalon2 avalon4 bflsc bitfury cointerra drillbit hashfast icarus klondike mining support.
OPTIONS
Options for both config file and command line:
- --anu-freq <arg>
- Set AntminerU1/2 frequency in MHz, range 125-500 (default: 250.0)
- --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-mcast
- Enable API Multicast listener, default: disabled
- --api-mcast-addr <arg>
- API Multicast listen address
- --api-mcast-code <arg>
- Code expected in the API Multicast message, don't use '-'
- --api-mcast-des <arg>
- Description appended to the API Multicast reply, default: ''
- --api-mcast-port <arg>
- API Multicast listen port (default: 4028)
- --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)
- --api-host <arg>
- Specify API listen address, default: 0.0.0.0
- --au3-freq <arg>
- Set AntminerU3 frequency in MHz, range 100-250 (default: 225.0)
- --au3-volt <arg>
- Set AntminerU3 voltage in mv, range 725-850, 0 to not set (default: 775)
- --avalon-auto
- Adjust avalon overclock frequency dynamically for best hashrate
- --avalon-cutoff <arg>
- Set avalon overheat cut off temperature (default: 60)
- --avalon-fan
- Set fanspeed percentage for avalon, single value or range (default: 20-100)
- --avalon-freq
- Set frequency range for avalon-auto, single value or range
- --avalon-options <arg>
- Set avalon options baud:miners:asic:timeout:freq:tech
- --avalon-temp <arg>
- Set avalon target temperature (default: 50)
- --avalon2-freq
- Set frequency range for Avalon2, single value or range, step: 25
- --avalon2-voltage
- Set Avalon2 core voltage, in millivolts, step: 125
- --avalon2-fan
- Set Avalon2 target fan speed
- --avalon2-cutoff <arg>
- Set Avalon2 overheat cut off temperature (default: 98)
- --avalon2-fixed-speed
- Set Avalon2 fan to fixed speed
- --avalon2-polling-delay <arg>
- Set Avalon2 polling delay value (ms) (default: 20)
- --avalon4-automatic-voltage
- Automatic adjust voltage base on module DH
- --avalon4-voltage
- Set Avalon4 core voltage, in millivolts, step: 125
- --avalon4-freq
- Set frequency for Avalon4, 1 to 3 values, example: 445:385:370
- --avalon4-fan
- Set Avalon4 target fan speed range
- --avalon4-temp <arg>
- Set Avalon4 target temperature (default: 42)
- --avalon4-cutoff <arg>
- Set Avalon4 overheat cut off temperature (default: 65)
- --avalon4-polling-delay <arg>
- Set Avalon4 polling delay value (ms) (default: 20)
- --avalon4-ntime-offset <arg>
- Set Avalon4 MM ntime rolling max offset (default: 4)
- --avalon4-aucspeed <arg>
- Set Avalon4 AUC IIC bus speed (default: 400000)
- --avalon4-aucxdelay <arg>
- Set Avalon4 AUC IIC xfer read delay, 4800 ~= 1ms (default: 19200)
- --balance
- Change multipool strategy from failover to even share balance
- --benchfile <arg>
- Run cgminer in benchmark mode using a work file - produces no shares
- --benchfile-display
- Display each benchfile nonce found
- --benchmark
- Run cgminer in benchmark mode - produces no shares
- --bflsc-overheat <arg>
- Set overheat temperature where BFLSC devices throttle, 0 to disable (default: 85)
- --bitburner-voltage <arg>
- Set BitBurner (Avalon) core voltage, in millivolts
- --bitburner-fury-voltage <arg>
- Set BitBurner Fury core voltage, in millivolts
- --bitburner-fury-options <arg>
- Override avalon-options for BitBurner Fury boards baud:miners:asic:timeout:freq
- --bxf-bits <arg>
- Set max BXF/HXF bits for overclocking (default: 54)
- --bxf-debug <arg>
- BXF: Debug all USB I/O, > is to the board(s), < is from the board(s) (default: 0)
- --bxf-temp-target <arg>
- Set target temperature for BXF/HXF devices (default: 82)
- --bxm-bits <arg>
- Set BXM bits for overclocking (default: 54)
- --btc-address <arg>
- Set bitcoin target address when solo mining to bitcoind (mandatory)
- --btc-sig <arg>
- Set signature to add to coinbase when solo mining (optional)
- --compact
- Use compact display without per device statistics
- --cta-load <arg>
- Set load for CTA devices, 0-255 range (default: 0)
- --ps-load <arg>
- Set power supply load for CTA devices, 0-100 range (default: 0)
- --debug|-D
- Enable debug output
- --disable-rejecting
- Automatically disable pools that continually reject shares
- --drillbit-options <arg>
- Set drillbit options <int|ext>:clock[:clock_divider][:voltage]
- --drillbit-auto <arg>
- Enable drillbit automatic tuning <every>:[<gooderr>:<baderr>:<maxerr>]
- --fix-protocol
- Do not redirect to stratum protocol from GBT
- --hfa-hash-clock <arg>
- Set hashfast clock speed (default: 550)
- --hfa-fail-drop <arg>
- Set how many MHz to drop clockspeed each failure on an overlocked hashfast device (default: 10)
- --hfa-fan
- Set fanspeed percentage for hashfast, single value or range (default: 10-85)
- --hfa-name <arg>
- Set a unique name for a single hashfast device specified with --usb or the first device found
- --hfa-noshed
- Disable hashfast dynamic core disabling feature
- --hfa-options <arg>
- Set hashfast options name:clock (comma separated)
- --hfa-temp-overheat <arg>
- Set the hashfast overheat throttling temperature (default: 95)
- --hfa-temp-target <arg>
- Set the hashfast target temperature (0 to disable) (default: 88)
- --hro-freq
- Set the hashratio clock frequency
- --hotplug <arg>
- Seconds between hotplug checks (0 means never check)
- --klondike-options <arg>
- Set klondike options clock:temptarget
- --load-balance
- Change multipool strategy from failover to quota 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
- --nfu-bits <arg>
- Set nanofury bits for overclocking, range 32-63 (default: 50)
- --net-delay
- Impose small delays in networking to not overload slow routers
- --no-submit-stale
- Don't submit shares if they are detected as stale
- --osm-led-mode <arg>
- Set LED mode for OneStringMiner devices (default: 4)
- --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
- --quiet|-q
- Disable logging output, display status and errors
- --quota|-U <arg>
- quota;URL combination for server with load-balance strategy quotas
- --real-quiet
- Disable all output
- --rock-freq <arg>
- Set RockMiner frequency in MHz, range 125-500 (default: 270.0)
- --rotate <arg>
- Change multipool strategy from failover to regularly rotate at N minutes
- --round-robin
- Change multipool strategy from failover to round robin on failure
- --sched-start
- Set a time of day in HH:MM to start mining (a once off without a stop time)
- --sched-stop
- Set a time of day in HH:MM to stop mining (will quit without a start time)
- --sharelog
- Append share log to file
- --shares <arg>
- Quit after mining N shares (default: unlimited)
- --socks-proxy <arg>
- Set socks4 proxy (host:port)
- --suggest-diff <arg>
- Suggest miner difficulty for pool to user (default: none)
- --syslog
- Use system log for output messages (default: standard error)
- --temp-cutoff
- Temperature where a device will be automatically disabled, one value or comma separated list (default: 0)
- --text-only|-T
- Disable ncurses formatted screen output
- --url|-o <arg>
- URL for bitcoin JSON-RPC server
- --usb <arg>
- USB device selection
- --user|-u <arg>
- Username for bitcoin JSON-RPC server
- --userpass|-O <arg>
- Username:Password pair for bitcoin JSON-RPC server
- --verbose
- Log verbose output to stderr as well as status output
- --widescreen
- Use extra wide display without toggling
- --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 all USB devices and exit
- --version|-V
-
Display version and exit