Scroll to navigation

BFGMINER(1) User Commands BFGMINER(1)


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




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

Lowlevel: ftdi pci pci:uio pci:vfio spi usb vcom

Drivers: antminer avalon bfx bifury bigpic bitforce bitforce:pci bitfury_gpio cairnsmore drillbit dualminer erupter gridseed hashbusteravalon hashbusterusb hashfast icarus klondike littlefury modminer opencl opencl:adl opencl:sensors proxy proxy:getwork proxy:stratum rockminer twinfury x6500 ztex

Algorithms: SHA256d scrypt

Options: ncursesw5


Options for both config file and command line:

Allow API access only to the given list of [G:]IP[/Prefix] addresses[/subnets]
Description placed in the API status header, default: BFGMiner version
API one letter groups G:cmd:cmd[,P:cmd:*...] defining the cmds a groups can use
Enable API, default: disabled
Enable API Multicast listener, default: disabled
API Multicast listen address (default: "")
Code expected in the API Multicast message, don't use '-' (default: "FTW")
Description appended to the API Multicast reply, default: ''
API Multicast listen port (default: 4028)
Allow API (if enabled) to listen on/for any address, default: only
Port number of miner API (default: 4028)
Change multipool strategy from failover to even share balance
Run BFGMiner in benchmark mode - produces no shares
Use nonce range on bitforce devices if supported
Chroot to a directory right after startup
Execute a command when a device is allowed to be idle (rest or wait)
Execute a command when a device is declared sick
Execute a command when a device is declared dead
Set coinbase payout address for solo mining
Set coinbase signature when possible
Use compact display without per device statistics
Enable debug output
Enable debug logging
Verbose dump of device protocol-level activities
Enable only devices matching pattern (default: all)
Automatically disable pools that continually reject shares
Port number to listen on for HTTP getwork miners (-1 means disabled) (default: -1)
Upper bound on how many seconds after getting work we consider a share from it stale (w/o longpoll active) (default: 120)
Upper bound on how many seconds after getting work we consider a share from it stale (with longpoll active) (default: 3600)
Don't leak work to backup pools when primary pool is lagging
Delay in seconds before switching back to a failed pool (default: 300)
Always initialize devices when possible (such as bitstream uploads to some FPGAs)
Select OpenCL platform ID to use for GPU mining (default: -1)
Map OpenCL to ADL device order manually, paired CSV (e.g. 1:0,2:1 maps OpenCL 1 to ADL 0, 2 to 1)
Attempt to reorder GPU devices according to PCI Bus ID
Specify a path to where bitstream and kernel files are (default: "/usr/share/bfgminer")
Set klondike options clock:temptarget
Change multipool strategy from failover to quota based balance
Interval in seconds between log output (default: 20)
Append log file for output messages
Include microseconds in log output
Use custom pipe cmd for output messages
Impose small delays in networking to avoid overloading slow routers
Disable the ATI display library used for monitoring and setting GPU parameters
Disable getblocktemplate support
Disable getwork support
Disable hotplug detection
Disable X-Long-Polling support
Ignore pool requests to redirect to another server
Do not attempt to restart devices that hang
Disable Stratum detection
Don't submit shares if they are detected as stale
Don't use Unicode characters in TUI
Create log of all nonces found
Password for bitcoin JSON-RPC server
Force verbose mode and output per-device statistics
Priority for just the previous-defined pool
Proxy URI to use for connecting to just the previous-defined pool
Verbose dump of protocol-level activities
Minimum number of work items to have queued (0+) (default: 1)
Disable logging output, display status and errors
Summary printed when you quit: none/devs/procs/detailed
quota;URL combination for server with load-balance strategy quotas
Disable all output
Request a specific difficulty from pools (default: 1.0)
Number of times to retry failed submissions before giving up (-1 means never) (default: -1)
Change multipool strategy from failover to regularly rotate at N minutes (default: 0)
Change multipool strategy from failover to round robin on failure
Configure how to scan for mining devices
Upper bound on time spent scanning current work, in seconds (default: 60)
Set a time of day in HH:MM to start mining (a once off without a stop time)
Set a time of day in HH:MM to stop mining (will quit without a start time)
Use the scrypt algorithm for mining (non-bitcoin)
Set default parameters on devices; eg, NFY:osc6_bits=50
Username of an unprivileged user to run as
Append share log to file
Quit after mining 2^32 * N hashes worth of shares (default: unlimited)
Show per processor statistics in summary
Skip security checks sometimes to save bandwidth; only check 1/<arg>th of the time (default: never skip)
Set socks proxy (host:port)
Port number to listen on for stratum miners (-1 means disabled) (default: -1)
Minimum number of concurrent share submissions (default: 64) (default: 64)
Use system log for output messages (default: standard error)
Set how much the temperature can fluctuate outside limits when automanaging speeds (default: 3)
Disable ncurses formatted screen output
Use Unicode characters in TUI
URL for bitcoin JSON-RPC server
Username for bitcoin JSON-RPC server
Log verbose output to stderr as well as status output
Display statistics weighed to difficulty 1
Username:Password pair for bitcoin JSON-RPC server
Display extra work time debug information

Options for command line only:

Load a JSON-format configuration file See example.conf for an example configuration.
Inhibit loading default config file
Print this message
Display version and exit
June 2014 bfgminer 4.2.0