configuration.md

Configuration and command-line options

Work in progress!

Table of contents

• Configuration Settings Order
• Globals and the Default Profile
• Working with Profiles and Pool Specific Settings
• Include and Includes
• Events
• CLI Only options
• Config-file and CLI options
• Event options
• Event Types

---

Configuration Settings Order

The configuration settings in sgminer are applied in this order:

Command Line > Config File Globals > Default Profile > Pool's Profile > Pool-Specific Settings

Top

Globals and the Default Profile

The default profile contains the settings that are to be used as defaults throughout sgminer. Typically, unless you specify default-profile, those settings will be read from the global level of the config file or use sgminer's core defaults if nothing is at the global level. The pool or profile level settings will override the default profile's settings.

The example below has algorithm set at the global level. Anytime a pool or profile doesn't specify algorithm, "darkcoin-mod" will be used.

{
  "pools": [...],
  "algorithm":"darkcoin-mod",
  "intensity":"19",
  ...

In the example below, algorithm is not specified at the global level and no profile is used as default-profile. This means that the default profile's algorithm will be set to sgminer's core default: "scrypt".

{
  "pools": [
    {
      "url":"poolA:8334",
      ...
      "profile":"A"
    },
    {
      "url":"poolB:8334",
      ...
    }
  ],
  "profiles":[
    {
      "name":"A",
      "algorithm":"darkcoin-mod"
    }
  ],
  "intensity":"19"
}

When using the first pool, Profile A will be applied, so algorithm will be set to "darkcoin-mod". When using the second pool, the default profile is applied, and algorithm will be set to "scrypt". intensity, being set at the global level, will be the default profile's intensity value. intensity will be set to "19" for both pools, because it is never specified in the pool or profile settings.

When default-profile is specified, any settings contained in that profile will override globals. For example:

{
  "pools": [
    {
      "url":"poolA:8334",
      ...
      "profile":"A"
    },
    {
      "url":"poolB:8334",
      ...
    }
  ],
  "profiles":[
    {
      "name":"A",
      "algorithm":"darkcoin-mod"
    },
    {
      "name":"B",
      "algorithm":"ckolivas"
    }
  ],
  "default-profile":"B",
  "algorithm":"marucoin-mod",
  "intensity":"19"
}

Profile B will be used to set the default profile's settings, which means algorithm will be set to "ckolivas" and the global value of "marucoin-mod" will be discarded. The first pool will use Profile A's "darkcoin-mod" and the second pool will use the default profile's "ckolivas".

See the configuration settings order for more information about the order in which settings are applied.

Top

Working with Profiles and Pool Specific Settings

Profiles have been added assist in specifying different GPU and/or algorithm settings that could be (re-)used by one or more pools. Pool-specific settings will override profile settings, and profile settings will override the default profile/globals.

See the configuration settings order for more information about the order in which settings are applied.

{
  "pools": [
    {
      "url":"poolA:8334",
      ...
      "profile":"A"
    },
    {
      "url":"poolB:8334",
      ...
      "profile":"A",
      "gpu-engine":"1000"
    },
    {
      "url":"poolC:8334",
      ...
      "intensity":"13"
    }
  ],
  "profiles":[
    {
      "name":"A",
      "algorithm":"darkcoin-mod",
      "gpu-engine":"1050"
    },
    {
      "name":"B",
      "algorithm":"ckolivas"
    }
  ],
  "default-profile":"B",
  "intensity":"19",
  "gpu-engine":"1100"
}

In the example above, when using the second pool, Profile A is applied, which sets the algorithm to "darkcoin-mod", but since a gpu-engine of "1000" is specified in the pool, the value of "1050" is discarded.

A similar situation occurs in the third pool. No profile is specified so the default algorithm "ckolivas" is set along with the default gpu-engine of "1100". Because intensity is set to "13" in the pool, the default profile's value of "19" is discarded.

The end result of the above would look like this:

{
  "pools": [
    {
      "url":"poolA:8334",
      ...
      "algorithm":"darkcoin-mod",
      "intensity":"19",
      "gpu-engine":"1050"
    },
    {
      "url":"poolB:8334",
      ...
      "algorithm":"darkcoin-mod",
      "intensity":"19",
      "gpu-engine":"1000"
    },
    {
      "url":"poolC:8334",
      ...
      "algorithm":"ckolivas"
      "intensity":"13"
      "gpu-engine":"1100"
    }
  ]
}

Top

Include and Includes

include and includes are special keywords only available in the configuration file. You can include json-formatted files at any level of the configuration parsing. The values read in the included files are applied to the current object being parsed.

include is used to include one single file. If you want to include multiple files, use includes, which is an array of filenames.

As with config files, these files can be web URLs pointing to remote files.

/etc/pool.ip.credentials:
{
    "user":"user",
    "pass":"x"
}

sgminer.conf:
...
"pools":[
    {
        "url":"stratum+tcp://pool.ip:8334",
        "include":"/etc/pool.ip.credentials"
    }
],
...

In the example above, the parser will include the contents of the file /etc/pool.ip.credentials directly where it was called from. This will produce the following result:

sgminer.conf:
...
"pools":[
    {
        "url":"stratum+tcp://pool.ip:8334",
        "user":"user",
        "pass":"x"
    }
],
...

The example below shows how you could breakdown your config across multiple smaller files:

sgminer.conf:
"includes":[
    "/etc/pools.conf",
    "/etc/profiles.conf",
    "/etc/gpus.conf"
],
...

There is no limit as to how includes can be used as long as they follow proper json syntax.

Top

---

Events

Users can now execute commands or perform certain tasks when pre-defined events occur while mining.

For example, one might want their miner to email them via a script when the miner goes idle and reboot the computer when a GPU goes dead. This gives users a little more flexibility controlling their mining uptime without necessarily resorting to external watchdog programs that, in some cases, can be troublesome.

Here is a configuration example of the above scenario:

...
"events":[
  {
    "on":"idle",
    "runcmd":"/bin/mailscript \"Miner Idle\" \"Hey! My miner went idle!\""
  },
  {
    "on":"gpu_dead",
    "reboot":"yes"
  }
],
...

For more details on configuration options, see Event Options below.

Top

---

CLI Only options

• config --config or -c
• default-config --default-config
• help --help or -h
• ndevs -ndevs or -n
• version --version or -V

---

config

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

The filename can also be a web or ftp url for remote configuration files. The file will be downloaded locally before being loaded. Note: If a file by the same name exists, it will be overwritten. If you modify and save your configuration, the changes will only be made locally and future downloads will overwrite your changes. Also note that the remote configuration files are only available with libcurl.

Note that the configuration file's settings will override any settings passed via command line. For more information, see Configuration Settings Order.

Syntax: --config <value> or -c <value>

Argument: string Filename or URL

Example:

# ./sgminer -c example.conf

# ./sgminer -c http://www.mysite.com/configfiles/myconfig.conf

Top :: CLI Only options

default-config

Specifies the name of the default configuration file to be loaded at start up and also used to save any settings changes during operation.

Syntax: --default-config <value>

Argument: string Filename

Example:

# ./sgminer --default_config defaultconfig.conf

Top :: CLI Only options

help

Displays the current sgminer version string, followed by the command line syntax help and then exits.

Syntax: --help or -h

Example:

# ./sgminer -h
sgminer 4.2.1-116-g2e8b-dirty
Usage: ./sgminer [-DdEgXKlLmpPQqUsTouvwOchnV]
Options for both config file and command line:
--algorithm <arg>   Set mining algorithm and most common defaults, default: scrypt
--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: sgminer 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

...

Top :: CLI Only options

ndevs

Displays the number of GPUs detected, Open CL/ADL platform information and then exits.

Syntax: --ndevs or -n

Example:

# ./sgminer -n
[10:16:04] CL Platform vendor: Advanced Micro Devices, Inc.
[10:16:04] CL Platform name: AMD Accelerated Parallel Processing
[10:16:04] CL Platform version: OpenCL 1.2 AMD-APP (1348.5)
[10:16:04] Platform devices: 2
[10:16:04]      0       Tahiti
[10:16:04]      1       Tahiti
[10:16:04] Number of ADL devices: 2
[10:16:04] ATI ADL Overdrive5 API found.
[10:16:04] ATI ADL Overdrive6 API found.
[10:16:04] Found 12 logical ADL adapters

...

Top :: CLI Only options

version

Displays the current sgminer version string and exits.

Syntax: --version or -V

Example:

# ./sgminer -V
sgminer 4.2.1-116-g2e8b-dirty

Top :: CLI Only options

---

Config-file and CLI options

• API Options
  • api-allow
  • api-description
  • api-groups
  • api-listen
  • api-mcast
  • api-mcast-addr
  • api-mcast-code
  • api-mcast-des
  • api-mcast-port
  • api-network
  • api-port
• Algorithm Options
  • algorithm
  • lookup-gap
  • nfactor
  • blake-compact
  • hamsi-expand-big
  • hamsi-short
  • keccak-unroll
  • luffa-parallel
  • shaders
  • thread-concurrency
  • worksize
• GPU Options
  • auto-fan
  • auto-gpu
  • gpu-dyninterval
  • gpu-engine
  • gpu-platform
  • gpu-threads
  • gpu-fan
  • gpu-map
  • gpu-memclock
  • gpu-memdiff
  • gpu-powertune
  • gpu-reorder
  • gpu-threads
  • gpu-vddc
  • intensity
  • no-adl
  • no-restart
  • rawintensity
  • temp-cutoff
  • temp-hysteresis
  • temp-overheat
  • temp-target
  • xintensity
• Pool Options
  • algorithm
  • description
  • device
  • gpu-engine
  • gpu-fan
  • gpu-memclock
  • gpu-powertune
  • gpu-threads
  • gpu-vddc
  • intensity
  • lookup-gap
  • name
  • nfactor
  • no-extranonce
  • pass
  • priority
  • profile
  • quota
  • rawintensity
  • shaders
  • state
  • thread-concurrency
  • url
  • user
  • userpass
  • worksize
  • xintensity
• Pool Strategy Options
  • balance
  • disable-rejecting
  • failover-only
  • failover-switch-delay
  • load-balance
  • rotate
  • round-robin
• Profile Options
  • algorithm
  • device
  • gpu-engine
  • gpu-fan
  • gpu-memclock
  • gpu-powertune
  • gpu-threads
  • gpu-vddc
  • intensity
  • lookup-gap
  • name
  • nfactor
  • rawintensity
  • shaders
  • thread-concurrency
  • worksize
  • xintensity
• Miscellaneous Options
  • compact
  • debug
  • debug-log
  • default-profile
  • device
  • difficulty-multiplier
  • expiry
  • fix-protocol
  • incognito
  • kernel-path
  • log
  • log-file
  • log-show-date
  • lowmem
  • monitor
  • more-notices
  • net-delay
  • no-client-reconnect
  • per-device-stats
  • protocol-dump
  • queue
  • quiet
  • real-quiet
  • remove-disabled
  • scan-time
  • sched-start
  • sched-stop
  • sharelog
  • shares
  • socks-proxy
  • show-coindiff
  • syslog
  • tcp-keepalive
  • text-only
  • verbose
  • worktime

---

API Options

api-allow

Specifies the API access list.

Available: Global

Config File Syntax: "api-allow":"<value>"

Command Line Syntax: --api-allow "<value>"

Argument: comma (,) delimited list Format: [<Group ID>:]<IP>[/Prefix] <Addresses>[/subnets][,...]

Default: None

Example:

"api-allow":"W:127.0.0.1,W:192.168.0.10"

Top :: Config-file and CLI options :: API Options

api-description

Description placed in the API status header.

Available: Global

Config File Syntax: "api-description":"<value>"

Command Line Syntax: --api-description "<value>"

Argument: string

Default: sgminer version

Top :: Config-file and CLI options :: API Options

api-groups

Sets API groups which restrict group members to only a certain set of commands. The list of groups is comma(,) delimited and each entry has its parameters colon(:) delimited. The first parameter of an entry is always the Group Identifier, which consists of one letter. When defining a group, you can use the asterisk (*) to refer to all non-priviledged functions.

Two groups are pre-defined and may not be used with this option:

• R Access to all non-priviledged functions
• W Access to all priviledged and non-priviledged functions

Group Members are specified in api-allow where they are associated with a group by their IP address.

Available: Global

Config File Syntax: "api-groups":"<value>"

Command Line Syntax: --api-groups "<value>"

Argument: comma (,) delimited list Format: <Group ID>:<command>:<command>[:*][:...][,...]

Default: R Access to all non-priviledged functions W Access to all functions

Example:

"api-groups":"A:addpool:*,B:addpool:removepool:switchpool:gpurestart:gpuenable:gpudisable:save:quit",
"api-allow":"A:192.168.0.10,B:127.0.0.1"

The above example grants users of group A access to the addpool function as well as all non-priviledged functions. Group B users only have access to the following functions: addpool, removepool, switchpool, gpurestart, gpuenable, gpudisable, save, quit.

Top :: Config-file and CLI options :: API Options

api-listen

Enables the API.

Available: Global

Config File Syntax: "api-listen":true

Command Line Syntax: --api-listen

Argument: None

Default: false (disabled)

Top :: Config-file and CLI options :: API Options

api-mcast

Enables the API over multicast.

Available: Global

Config File Syntax: "api-mcast":true

Command Line Syntax: --api-mcast

Argument: None

Default: false (disabled)

Top :: Config-file and CLI options :: API Options

api-mcast-addr

Set the API multicast address.

Available: Global

Config File Syntax: "api-mcast-addr":"<value>"

Command Line Syntax: --api-mcast-addr <value>

Argument: string IP Address

Default: None

Top :: Config-file and CLI options :: API Options

api-mcast-code

Code to use in API multicast messages. Do not use the dash (-)

Available: Global

Config File Syntax: "api-mcast-code":"<value>"

Command Line Syntax: --api-mcast-code "<value>"

Argument: string

Default: None

Top :: Config-file and CLI options :: API Options

api-mcast-des

Description appended to API multicast replies.

Available: Global

Config File Syntax: "api-mcast-des":"<value>"

Command Line Syntax: --api-mcast-des "<value>"

Argument: string

Default: None

Top :: Config-file and CLI options :: API Options

api-mcast-port

Port to use for API multicast.

Available: Global

Config File Syntax: "api-mcast-port":"<value>"

Command Line Syntax: --api-mcast-port <value>

Argument: number Port Number between 1 and 65535

Default: 4028

Top :: Config-file and CLI options :: API Options

api-network

Needs clarification Allows API (if enabled) to listen on/for any address.

Available: Global

Config File Syntax: "api-network":true

Command Line Syntax: --api-network

Argument: None

Default: false

Top :: Config-file and CLI options :: API Options

api-port

Port to use for API.

Available: Global

Config File Syntax: "api-port":"<value>"

Command Line Syntax: --api-port <value>

Argument: number Port Number between 1 and 65535

Default: 4028

Top :: Config-file and CLI options :: API Options

---

Algorithm Options

algorithm

Formerly the kernel option. Sets the algorithm to use for mining.

Available: Global, Pool, Profile

Config File Syntax: "algorithm":"<value>"

Command Line Syntax: --algorithm <value> --pool-algorithm <value> --profile-algorithm <value>

Argument: string

Default: ckolivas

Top :: Config-file and CLI options :: Algorithm Options

lookup-gap

Set GPU lookup gap for scrypt mining.

Available: Global, Pool, Profile

Algorithms: scrypt nscrypt

Config File Syntax: "lookup-gap":"<value>"

Command Line Syntax: --lookup-gap "<value>" --pool-lookup-gap "<value>" --profile-lookup-gap "<value>"

Argument: One value or a comma (,) delimited list GPU lookup gap

Default: None

Top :: Config-file and CLI options :: Algorithm Options

nfactor

Overrides the default scrypt parameter N, specified as the factor of 2 (N = 2^nfactor).

Available: Global, Pool, Profile

Algorithms: nscrypt

Config File Syntax: "nfactor":"<value>"

Command Line Syntax: --nfactor <value> --pool-nfactor <value> --profile-nfactor <value>

Argument: number Nfactor 1 or greater

Default: 10

Top :: Config-file and CLI options :: Algorithm Options

blake-compact

Sets SPH_COMPACT_BLAKE64 for Xn derived algorithms. Changing this may improve hashrate. Which value is better depends on GPU type and even manufacturer (i.e. exact GPU model).

Available: Global

Algorithms: X11 X13 X14 X15

Config File Syntax: "blake-compact":true

Command Line Syntax: --blake-compact

Argument: None

Default: false

Top :: Config-file and CLI options :: Algorithm Options

hamsi-expand-big

Sets SPH_HAMSI_EXPAND_BIG for X13 derived algorithms. Values "4" and "1" are commonly used. Changing this may improve hashrate. Which value is better depends on GPU type and even manufacturer (i.e. exact GPU model).

Available: Global

Algorithms: X13 X14 X15

Config File Syntax: "hamsi-expand-big":"<value>"

Command Line Syntax: --hamsi-expand-big <value>

Argument: number (1 or 4 are common)

Default: 1 (4 for kernels labeled "old")

Top :: Config-file and CLI options :: Algorithm Options

hamsi-short

Sets SPH_HAMSI_SHORT for X13 derived algorithms. Changing this may improve hashrate. Which value is better depends on GPU type and even manufacturer (i.e. exact GPU model).

Available: Global

Algorithms: X13 X14 X15

Config File Syntax: "hamsi-short":true

Command Line Syntax: --hamsi-short

Argument: None

Default: false

Top :: Config-file and CLI options :: Algorithm Options

keccak-unroll

Sets SPH_KECCAK_UNROLL for Xn derived algorithms. Changing this may improve hashrate. Which value is better depends on GPU type and even manufacturer (i.e. exact GPU model).

Available: Global

Algorithms: X11 X13 X14 X15

Config File Syntax: "keccak-unroll":"<value>"

Command Line Syntax: --keccak-unroll <value>

Argument: number

Default: 0

Top :: Config-file and CLI options :: Algorithm Options

luffa-parallel

Sets SPH_LUFFA_PARALLEL for Xn derived algorithms. Changing this may improve hashrate. Which value is better depends on GPU type and even manufacturer (i.e. exact GPU model).

Available: Global

Algorithms: X11 X13 X14 X15

Config File Syntax: "luffa-parallel":true

Command Line Syntax: --luffa-parallel

Argument: None

Default: false

Top :: Config-file and CLI options :: Algorithm Options

shaders

Number of shaders per GPU for algorithm tuning. This is used to calculate thread-concurrency if not specified.

Available: Global, Pool, Profile

Algorithms: scrypt nscrypt

Config File Syntax: "shaders":"<value>"

Command Line Syntax: --shaders "<value>" --pool-shaders "<value>" --profile-shaders "<value>"

Argument: One value or a comma (,) delimited list GPU shaders

Default: None

Top :: Config-file and CLI options :: Algorithm Options

thread-concurrency

Number of concurrent threads per GPU for mining.

Available: Global, Pool, Profile

Algorithms: scrypt nscrypt

Config File Syntax: "thread-concurrency":"<value>"

Command Line Syntax: --thread-concurrency "<value>" --pool-thread-concurrency "<value>" --profile-thread-concurrency "<value>"

Argument: One value or a comma (,) delimited list GPU thread concurrency

Default: None

Top :: Config-file and CLI options :: Algorithm Options

worksize

Amount of work handled by GPUs per work request.

Available: Global, Pool, Profile

Algorithms: all

Config File Syntax: "worksize":"<value>"

Command Line Syntax: --worksize "<value>" -w "<value>" --pool-worksize "<value>" --profile-worksize "<value>"

Argument: One value or a comma (,) delimited list GPU worksize

Default: None

Top :: Config-file and CLI options :: Algorithm Options

---

GPU Options

auto-fan

Automatically adjust all GPU fan speeds to maintain a target temperature.

Used with temp-target, temp-cutoff, temp-overheat and temp-hysteresis.

Available: Global

Config File Syntax: "auto-fan":true

Command Line Syntax: --auto-fan

Argument: None

Default: false

Top :: Config-file and CLI options :: GPU Options

auto-gpu

Automatically adjust all GPU engine clock speeds to maintain a target temperature.

Used with temp-target, temp-cutoff, temp-overheat and temp-hysteresis.

Available: Global

Config File Syntax: "auto-gpu":true

Command Line Syntax: --auto-gpu

Argument: None

Default: false

Top :: Config-file and CLI options :: GPU Options

gpu-dyninterval

Need clarification Refresh interval in milliseconds (ms) for GPUs using dynamic intensity.

Available: Global

Config File Syntax: "gpu-dyninterval":"<value>"

Command Line Syntax: --gpu-dyninterval <value>

Argument: number Number of milliseconds from 1 to 65535.

Default: 7

Top :: Config-file and CLI options :: GPU Options

gpu-engine

Set the GPU core clock range in Mhz.

Available: Global, Pool, Profile

Config File Syntax: "gpu-engine":"<value>"

Command Line Syntax: --gpu-engine "<value>" --pool-gpu-engine "<value>" --profile-gpu-engine "<value>"

Argument: One value, range and/or comma (,) separated list GPU engine clocks in Mhz

Default: None

Example:

"gpu-engine":"1000,950-1100,1050-1050"

Top :: Config-file and CLI options :: GPU Options

gpu-fan

Set the GPU fan percentage range.

Available: Global, Pool, Profile

Config File Syntax: "gpu-fan":"<value>"

Command Line Syntax: --gpu-fan "<value>" --pool-gpu-fan "<value>" --profile-gpu-fan "<value>"

Argument: One value, range and/or comma (,) separated list GPU fan speed percentage

Default: None

Example:

"gpu-fan":"75-85,100,50-50"

Top :: Config-file and CLI options :: GPU Options

gpu-map

Manually map OpenCL to ADL devices.

Available: Global

Config File Syntax: "gpu-map":"<value>"

Command Line Syntax: --gpu-map "<value>"

Argument: comma (,) delimited list Format: <OpenCL ID>:<ADL ID>,<OpenCL ID>:<ADL ID>[,...]

Default: None

Example:

"gpu-map":"1:0,2:1,3:2"

Top :: Config-file and CLI options :: GPU Options

gpu-memclock

Set the GPU memory clock in Mhz.

Available: Global, Pool, Profile

Config File Syntax: "gpu-memclock":"<value>"

Command Line Syntax: --gpu-memclock "<value>" --pool-gpu-memclock "<value>" --profile-gpu-memclock "<value>"

Argument: one value and/or comma (,) delimited list GPU memory clocks in Mhz

Default: None

Example:

"gpu-memclock":"1500,1250,1000"

Top :: Config-file and CLI options :: GPU Options

gpu-memdiff

Set a fixed difference between the GPU core clock and memory clock while in auto-gpu mode.

Available: Global

Config File Syntax: "gpu-memdiff":"<value>"

Command Line Syntax: --gpu-memdiff "<value>"

Argument: number Clock difference in Mhz

Default: None

Example:

"auto-gpu":true,
"gpu-engine":"900-1100",
"gpu-memclock":"400"

With the above, memory clock would range between 1300Mhz and 1500Mhz.

Top :: Config-file and CLI options :: GPU Options

gpu-platform

Need clarification Select the OpenCL platform ID to use for GPU mining.

Available: Global

Config File Syntax: "gpu-platform":"<value>"

Command Line Syntax: --gpu-platform <value>

Argument: number OpenCL Platform ID number between 0 and 9999.

Default: None

Top :: Config-file and CLI options :: GPU Options

gpu-powertune

Set the GPU Powertune percentage.

Available: Global, Pool, Profile

Config File Syntax: "gpu-powertune":"<value>"

Command Line Syntax: --gpu-powertune "<value>" -g "<value>" --pool-gpu-powertune "<value>" --profile-gpu-powertune "<value>"

Argument: one value or a comma (,) delimited list GPU Powertune percentages

Default: 0

Top :: Config-file and CLI options :: GPU Options

gpu-reorder

Attempts to reorder the GPUs according to their PCI Bus ID.

Available: Global

Config File Syntax: "gpu-reorder":true

Command Line Syntax: --gpu-reorder

Argument: None

Default: false

Top :: Config-file and CLI options :: GPU Options

gpu-threads

Number of mining threads per GPU.

Available: Global, Pool, Profile

Config File Syntax: "gpu-threads":"<value>"

Command Line Syntax: --gpu-threads "<value>" -g "<value>" --pool-gpu-threads "<value>" --profile-gpu-threads "<value>"

Argument: one value or (,) delimited list GPU threads

Default: 1

Top :: Config-file and CLI options :: GPU Options

gpu-vddc

Set the GPU voltage in Volts.

Available: Global, Pool, Profile

Config File Syntax: "gpu-vddc":"<value>"

Command Line Syntax: --gpu-vddc "<value>" --pool-gpu-vddc "<value>" --profile-gpu-vddc "<value>"

Argument: one value or comma (,) delimited list GPU voltage in Volts

Default: None

Top :: Config-file and CLI options :: GPU Options

intensity

Intensity of GPU scanning.

Overridden by xintensity and rawintensity.

Available: Global, Pool, Profile

Config File Syntax: "intensity":"<value>"

Command Line Syntax: --intensity "<value>" -I "<value>" --pool-intensity "<value>" --profile-intensity "<value>"

Argument: one value or a comma (,) delimited list GPU Intensity between 8 and 31. Use d instead of a number to maintain desktop interactivity.

Default: d

Top :: Config-file and CLI options :: GPU Options

no-adl

Disable the AMD ADL library. Note that without ADL, all GPU monitoring is disabled and all GPU parameter functions will not work.

Available: Global

Config File Syntax: "no-adl":true

Command Line Syntax: --no-adl

Argument: None

Default: false

Top :: Config-file and CLI options :: GPU Options

no-restart

Do not attempt to restart GPUs that hang.

Available: Global

Config File Syntax: "no-restart":true

Command Line Syntax: --no-restart

Argument: None

Default: false

Top :: Config-file and CLI options :: GPU Options

rawintensity

Raw intensity of GPU scanning.

Overriddes by intensity and xintensity.

Available: Global, Pool, Profile

Config File Syntax: "rawintensity":"<value>"

Command Line Syntax: --rawintensity "<value>" --pool-rawintensity "<value>" --profile-rawintensity "<value>"

Argument: one value or a comma (,) delimited list GPU Raw intensity between 1 and 2147483647.

Default: None

Top :: Config-file and CLI options :: GPU Options

temp-cutoff

Temperature at which a GPU will be disabled at.

Used with auto-fan and auto-gpu.

Available: Global

Config File Syntax: "temp-cutoff":"<value>"

Command Line Syntax: --temp-cutoff "<value>"

Argument: one value or a comma (,) delimited list Temperature in Celcius

Default: 95

Top :: Config-file and CLI options :: GPU Options

temp-cutoff

Set the allowable temperature fluctuation a GPU can operate outside of limits.

Used with auto-fan and auto-gpu.

Available: Global

Config File Syntax: "temp-hysteresis":"<value>"

Command Line Syntax: --temp-hysteresis <value>

Argument: number Temperature in Celcius between 0 and 10

Default: 3

Top :: Config-file and CLI options :: GPU Options

temp-overheat

Temperature at which a GPU will be throttled.

Used with auto-fan and auto-gpu.

Available: Global

Config File Syntax: "temp-overheat":"<value>"

Command Line Syntax: --temp-overheat "<value>"

Argument: one value or a comma (,) delimited list Temperature in Celcius

Default: 85

Top :: Config-file and CLI options :: GPU Options

temp-target

Temperature at which a GPU should stay at.

Used with auto-fan and auto-gpu.

Available: Global

Config File Syntax: "temp-target":"<value>"

Command Line Syntax: --temp-target "<value>"

Argument: one value or a comma (,) delimited list Temperature in Celcius

Default: 75

Top :: Config-file and CLI options :: GPU Options

xintensity

Shader based intensity of GPU scanning.

Overridden by rawintensity and overrides intensity.

Available: Global, Pool, Profile

Config File Syntax: "xintensity":"<value>"

Command Line Syntax: --xintensity "<value>" -X "<value>" --pool-xintensity "<value>" --profile-xintensity "<value>"

Argument: one value or a comma (,) delimited list GPU Xintensity between 1 and 9999.

Default: None

Top :: Config-file and CLI options :: GPU Options

---

Pool Options

[pool-]algorithm

See algorithm

Top :: Config-file and CLI options :: Pool Options

description

Set the pool's description

Available: Pool

Config File Syntax: "description":"<value>"

Command Line Syntax: --pool-description "<value>"

Argument: string

Default: None

Top :: Config-file and CLI options :: Pool Options

[pool-]device

See device.

Top :: Config-file and CLI options :: Pool Options

[pool-]gpu-engine

See gpu-engine

Top :: Config-file and CLI options :: Pool Options

[pool-]gpu-fan

See gpu-fan

Top :: Config-file and CLI options :: Pool Options

[pool-]gpu-memclock

See gpu-memclock

Top :: Config-file and CLI options :: Pool Options

[pool-]gpu-powertune

See gpu-powertune

Top :: Config-file and CLI options :: Pool Options

[pool-]gpu-threads

See gpu-threads

Top :: Config-file and CLI options :: Pool Options

[pool-]gpu-vddc

See gpu-vddc

Top :: Config-file and CLI options :: Pool Options

[pool-]intensity

See intensity

Top :: Config-file and CLI options :: Pool Options

[pool-]lookup-gap

See lookup-gap

Top :: Config-file and CLI options :: Pool Options

[pool-]name

Set a name for a pool.

Available: Pool

Config File Syntax: "name":"<value>"

Command Line Syntax: --name "<value>" --pool-name "<value>"

Argument: string Name of the pool

Default: None

Top :: Config-file and CLI options :: Pool Options

[pool-]nfactor

See nfactor

Top :: Config-file and CLI options :: Pool Options

no-extranonce

Disable 'extranonce' stratum subscribe for pool.

Available: Pool

Config File Syntax: "no-extranonce":true

Command Line Syntax: --no-extranonce --pool-no-extranonce

Argument: None

Default: false

Top :: Config-file and CLI options :: Pool Options

pass

Set pool password.

Available: Pool

Config File Syntax: "pass":"<value>"

Command Line Syntax: --pass "<value>" -p "<value>" --pool-pass "<value>"

Argument: string Pool password

Default: None

Top :: Config-file and CLI options :: Pool Options

priority

Set the priority of the pool other than the order it is entered in the pool list.

Available: Pool

Config File Syntax: "priority":"<value>"

Command Line Syntax: --priority <value> --pool-priority <value>

Argument: number Pool priority

Default: None

Top :: Config-file and CLI options :: Pool Options

profile

Set the profile to use for this pool's settings.

Available: Pool

Config File Syntax: "profile":"<value>"

Command Line Syntax: --pool-profile "<value>"

Argument: string Pool profile name

Default: None

Top :: Config-file and CLI options :: Pool Options

quota

Replaces the pool url when using the load-balance multipool strategy and enables setting a quota percentage for the pool.

Available: Pool

Config File Syntax: "quota":"<value>"

Command Line Syntax: --quota "<value>" --pool-quota "<value>" -U "<value>"

Argument: string Pool quota and url in the form <quota percent>;<pool url>

Default: None

Top :: Config-file and CLI options :: Pool Options

[pool-]rawintensity

See rawintensity

Top :: Config-file and CLI options :: Pool Options

[pool-]shaders

See shaders

Top :: Config-file and CLI options :: Pool Options

state

Set the pool state at startup.

Available: Pool

Config File Syntax: "state":"<value>"

Command Line Syntax: --state "<value>" --pool-state "<value>"

Argument: string Pool state. Possible values: enabled disabled hidden rejecting

Default: enabled

Top :: Config-file and CLI options :: Pool Options

[pool-]thread-concurrency

See thread-concurrency

Top :: Config-file and CLI options :: Pool Options

url

Set the Pool URL.

Available: Pool

Config File Syntax: "url":"<value>"

Command Line Syntax: --url "<value>" --pool-url "<value>" -o "<value>"

Argument: string Pool URL

Default: None

Top :: Config-file and CLI options :: Pool Options

user

Set the Pool username.

Available: Pool

Config File Syntax: "user":"<value>"

Command Line Syntax: --user "<value>" --pool-user "<value>" -u "<value>"

Argument: string Pool username

Default: None

Top :: Config-file and CLI options :: Pool Options

userpass

Set the Pool username and password.

Available: Pool

Config File Syntax: "userpass":"<value>"

Command Line Syntax: --userpass "<value>" --pool-userpass "<value>" -O "<value>"

Argument: string Pool username and password <user>:<pass>

Default: None

Top :: Config-file and CLI options :: Pool Options

[pool-]worksize

See worksize

Top :: Config-file and CLI options :: Pool Options

[pool-]xintensity

See intensity

Top :: Config-file and CLI options :: Pool Options

---

Pool Strategy Options

balance

Changes the multipool strategy to even share balance.

Available: Global

Config File Syntax: "balance":true

Command Line Syntax: --balance

Argument: None

Default: false

Top :: Config-file and CLI options :: Pool Strategy Options

disable-rejecting

Automatically disable a pool that continually reject shares.

Available: Global

Config File Syntax: "disable-rejecting":true

Command Line Syntax: --disable-rejecting

Argument: None

Default: false

Top :: Config-file and CLI options :: Pool Strategy Options

failover-only

Use the first pool alive based on pool priority.

Available: Global

Config File Syntax: "failover-only":true

Command Line Syntax: --failover-only

Argument: None

Default: true

Top :: Config-file and CLI options :: Pool Strategy Options

failover-switch-delay

Number of seconds to wait before switching back to a previously failed pool.

Available: Global

Config File Syntax: "failover-switch-delay":"<value>"

Command Line Syntax: --failover-switch-delay <value>

Argument: number Number of seconds between 1 and 65535.

Default: 60

Top :: Config-file and CLI options :: Pool Strategy Options

load-balance

Changes the multipool strategy to quota based balance.

Note: Use quota instead of url in pool settings when using this multipool strategy.

Available: Global

Config File Syntax: "load-balance":true

Command Line Syntax: --load-balance

Argument: None

Default: false

Top :: Config-file and CLI options :: Pool Strategy Options

rotate

Changes the multipool strategy to rotate between pools after a certain amount of time in seconds.

Available: Global

Config File Syntax: "rotate":"<value>"

Command Line Syntax: --rotate <value>

Argument: number Number of seconds between 0 and 9999 before switching to the next pool

Default: None

Top :: Config-file and CLI options :: Pool Strategy Options

round-robin

Changes the multipool strategy to round-robin.

Available: Global

Config File Syntax: "round-robin":true

Command Line Syntax: --round-robin

Argument: None

Default: false

Top :: Config-file and CLI options :: Pool Strategy Options

---

Profile Options

[profile-]algorithm

See algorithm

Top :: Config-file and CLI options :: Profile Options

[profile-]device

See device.

Top :: Config-file and CLI options :: Profile Options

[profile-]gpu-engine

See gpu-engine.

Top :: Config-file and CLI options :: Profile Options

[profile-]gpu-fan

See gpu-fan.

Top :: Config-file and CLI options :: Profile Options

[profile-]gpu-memclock

See gpu-memclock.

Top :: Config-file and CLI options :: Profile Options

[profile-]gpu-powertune

See gpu-powertune.

Top :: Config-file and CLI options :: Profile Options

[profile-]gpu-threads

See gpu-threads.

Top :: Config-file and CLI options :: Profile Options

[profile-]gpu-vddc

See gpu-vddc.

Top :: Config-file and CLI options :: Profile Options

[profile-]intensity

See intensity.

Top :: Config-file and CLI options :: Profile Options

[profile-]lookup-gap

See lookup-gap.

Top :: Config-file and CLI options :: Profile Options

[profile-]name

Set a name for a profile.

Note if no profile name is set, the profile name defaults to the profile number in the order that it was entered starting with 0.

Available: Profile

Config File Syntax: "name":"<value>"

Command Line Syntax: --profile-name "<value>"

Argument: string Name of the profile

Default: Profile number

Top :: Config-file and CLI options :: Profile Options

[profile-]nfactor

See nfactor.

Top :: Config-file and CLI options :: Profile Options

[profile-]rawintensity

See rawintensity.

Top :: Config-file and CLI options :: Profile Options

[profile-]shaders

See shaders

Top :: Config-file and CLI options :: Profile Options

[profile-]thread-concurrency

See thread-concurrency

Top :: Config-file and CLI options :: Profile Options

[profile-]worksize

See worksize

Top :: Config-file and CLI options :: Profile Options

[profile-]xintensity

See xintensity.

Top :: Config-file and CLI options :: Profile Options

---

Miscellaneous Options

compact

Use a compact display, without per device statistics.

Available: Global

Config File Syntax: "compact":true

Command Line Syntax: --compact

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

debug

Enable debug output.

Available: Global

Config File Syntax: "debug":true

Command Line Syntax: --debug or -D

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

debug-log

Enable debug logging when stderr is redirected to file.

Available: Global

Config File Syntax: "debug-log":false

Command Line Syntax: --debug-log

Argument: None

Default: true

Top :: Config-file and CLI options :: Miscellaneous Options

default-profile

Use this profile for sgminer's default settings.

Available: Global

Config File Syntax: "default-profile":"<value>"

Command Line Syntax: --default-profile <value>

Argument: string Profile name

Default: None

Top :: Config-file and CLI options :: Miscellaneous Options

device

Select devices to use.

Note: if you assign per-profile or per-pool devices to be turned on or off, it is recommended to specify "device":"*" on the other pools or profiles that should use all devices.

Available: Global, Pool, Profile

Config File Syntax: "device":"<value>"

Command Line Syntax: --device "<value>" -d "<value>" --pool-device "<value>" --profile-device "<value>"

Argument: one value, range and/or a comma (,) separated list with a combination of both To enable all devices use the asterisk (*) or the word "all".

Default: None (all devices enabled)

Example:

{
"pools":[
    {
        "url":"stratum+tcp://pool.ip:8334",
        "user":"user",
        "pass":"x"
    },
    {
        "url":"stratum+tcp://pool2.ip:3333",
        "user":"user",
        "pass":"x",
        "profile":"x11"
    }
],
"profiles":[
    {
        "name":"x11",
        "algorithm":"darkcoin-mod",
        "devices":"*"
    }
],
...
"algorithm":"ckolivas",
"device":"0,2-5"
...
}

The above would start mining scrypt on pool.ip with devices 0, 2, 3, 4, 5. Upon switching to pool2.ip, all devices would be enabled to mine x11.

Top :: Config-file and CLI options :: Miscellaneous Options

difficulty-multiplier

DEPRECATED Set the difficulty multiplier for jobs received from stratum pools.

Available: Global

Config File Syntax: "difficulty-multiplier":"<value>"

Command Line Syntax: --difficulty-multiplier <value>

Argument: number Decimal multiplier

Default: 0.0

Top :: Config-file and CLI options :: Miscellaneous Options

expiry

Set how many seconds to wait after getting work before sgminer considers it a stale share.

Available: Global

Config File Syntax: "expiry":"<value>"

Command Line Syntax: --expiry <value> or -E <value>

Argument: number Number of seconds between 0 and 9999.

Default: 28

Top :: Config-file and CLI options :: Miscellaneous Options

fix-protocol

Need clarification Do not redirect to a different getwork protocol (e.g. stratum).

Available: Global

Config File Syntax: "fix-protocol":true

Command Line Syntax: --fix-protocol

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

incognito

Do not display user name in status window.

Available: Global

Config File Syntax: "incognito":true

Command Line Syntax: --incognito

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

kernel-path

Path to where the kernel files are.

Available: Global

Config File Syntax: "kernel-path":"<value>"

Command Line Syntax: --kernel-path "<value>" -K "<value>"

Argument: string Path to kernel files

Default: /path/to/sgminer

Top :: Config-file and CLI options :: Miscellaneous Options

log

Set the interval in seconds between log outputs.

Available: Global

Config File Syntax: "log":"<value>"

Command Line Syntax: --log <value> -l <value>

Argument: number Number of seconds between 0 and 9999.

Default: 5

Top :: Config-file and CLI options :: Miscellaneous Options

log-file

Log stderr to file.

Available: Global

Config File Syntax: "log-file":"<path>"

Command Line Syntax: --log-file <path>

Argument: path Path to log file, or FD number, or - to redirect to stdout.

Default: will log to stderr

Top :: Config-file and CLI options :: Miscellaneous Options

log-show-date

Show a timestamp on every log line.

Available: Global

Config File Syntax: "log-show-date":true

Command Line Syntax: --log-show-date -L

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

lowmem

Minimize caching of shares for low memory systems.

Available: Global

Config File Syntax: "lowmem":true

Command Line Syntax: --lowmem

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

monitor

Use custom pipe command for output messages. Only available on unix based operating systems.

Available: Global

Config File Syntax: "monitor":"<value>"

Command Line Syntax: --monitor "<value>" -m "<value>"

Argument: string Command to pipe messages through.

Default: None

Top :: Config-file and CLI options :: Miscellaneous Options

more-notices

Display work restart and new block notices.

Available: Global

Config File Syntax: "more-notices":true

Command Line Syntax: --more-notices

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

net-delay

Set small delays in networking not to overload slower routers.

Available: Global

Config File Syntax: "net-delay":true

Command Line Syntax: --net-delay

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

no-client-reconnect

Disabled the 'client.reconnect' stratum functionality.

Available: Global

Config File Syntax: "no-client-reconnect":true

Command Line Syntax: --no-client-reconnect

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

no-submit-stale

Do not submit shares that are detected as stale.

Available: Global

Config File Syntax: "no-submit-stale":true

Command Line Syntax: --no-submit-stale

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

per-device-stats

Force output of per-device statistics.

Available: Global

Config File Syntax: "per-device-stats":true

Command Line Syntax: --per-device-stats

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

protocol-dump

Force output of protocol-level activities.

Available: Global

Config File Syntax: "protocol-dump":true

Command Line Syntax: --protocol-dump -P

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

queue

Minimum number of work items to have queued.

Available: Global

Config File Syntax: "queue":"<value>"

Command Line Syntax: --queue <value> -Q <value>

Argument: number Work items to have queued 0 to 9999

Default: 1

Top :: Config-file and CLI options :: Miscellaneous Options

quiet

Disables logging output, display status and errors.

Available: Global

Config File Syntax: "quiet":true

Command Line Syntax: --quiet -q

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

real-quiet

Disables all output.

Available: Global

Config File Syntax: "real-quiet":true

Command Line Syntax: --real-quiet

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

remove-disabled

Remove disabled devices completely as if they never existed.

Available: Global

Config File Syntax: "remove-disabled":true

Command Line Syntax: --remove-disabled

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

scan-time

Set how many seconds to spend scanning for current work.

Available: Global

Config File Syntax: "scan-time":"<value>"

Command Line Syntax: --scan-time <value> or -s <value>

Argument: number Number of seconds between 0 and 9999.

Default: 7

Top :: Config-file and CLI options :: Miscellaneous Options

sched-start

Set a time of day to start mining at. Used with sched-stop.

Available: Global

Config File Syntax: "sched-start":"<value>"

Command Line Syntax: --sched-start "<value>"

Argument: string Time of day HH:MM

Default: None

Top :: Config-file and CLI options :: Miscellaneous Options

sched-stop

Set a time of day to stop mining at. Used with sched-start.

Available: Global

Config File Syntax: "sched-stop":"<value>"

Command Line Syntax: --sched-stop "<value>"

Argument: string Time of day HH:MM

Default: None

Top :: Config-file and CLI options :: Miscellaneous Options

sharelog

Appends share log to file.

Available: Global

Config File Syntax: "sharelog":"<value>"

Command Line Syntax: --sharelog "<value>"

Argument: string Filename of log

Default: None

Top :: Config-file and CLI options :: Miscellaneous Options

shares

Quit after mining a certain amount of shares.

Available: Global

Config File Syntax: "shares":"<value>"

Command Line Syntax: --shares <value>

Argument: number Number of shares

Default: Unlimited

Top :: Config-file and CLI options :: Miscellaneous Options

socks-proxy

Use a socks4 proxy.

Available: Global

Config File Syntax: "socks-proxy":"<value>"

Command Line Syntax: --socks-proxy "<value>"

Argument: string Socks proxy settings <host>:<port>

Default: None

Top :: Config-file and CLI options :: Miscellaneous Options

show-coindiff

Display the coin difficulty rather than the hash value of a share.

Available: Global

Config File Syntax: "show-coindiff":true

Command Line Syntax: --show-coindiff

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

syslog

Output messages to syslog. Note: only available on operating systems with syslogd.

Available: Global

Config File Syntax: "syslog":true

Command Line Syntax: --syslog

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

tcp-keepalive

Set the TCP keepalive packet idle timeout in seconds. Note: only available with libcurl and keepalive enabled.

Available: Global

Config File Syntax: "tcp-keepalive":"<value>"

Command Line Syntax: --tcp-keepalive <value>

Argument: number Number of seconds between 0 and 9999.

Default: 30

Top :: Config-file and CLI options :: Miscellaneous Options

text-only

Disables the ncurses formatted screen output and user interface.

Available: Global

Config File Syntax: "text-only":true

Command Line Syntax: --text-only -T

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

verbose

Outputs log and status to stderr. Note: only available on unix based operating systems.

Available: Global

Config File Syntax: "verbose":true

Command Line Syntax: --verbose -v

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

worktime

Displays extra work time debug information.

Available: Global

Config File Syntax: "worktime":true

Command Line Syntax: --worktime

Argument: None

Default: false

Top :: Config-file and CLI options :: Miscellaneous Options

---

Event options

• on
• runcmd
• reboot
• reboot-delay
• quit
• quit-message

on

Specify which event type to respond on. See below for a list of supported event types

Available: Events

Config File Syntax: "on":"<value>"

Command Line Syntax: --event-on <value>

Argument: string Name of the event type

Default: None

Top :: Event options

runcmd

Specify a command to run when the event occurs. Please remember to properly escape quotes (") with backslashes (\) if you need to specify multi-word parameters enclosed in quotes (") for your commands: \"

Available: Events

Config File Syntax: "runcmd":"<value>"

Command Line Syntax: --event-runcmd <value>

Argument: string Command to execute on event

Default: None

Top :: Event options

reboot

Reboot when event occurs.

Available: Events

Config File Syntax: "reboot":"<value>"

Command Line Syntax: --event-reboot <value>

Argument: string Yes: "true" "yes" "1" or No: "false" "no" "0"

Default: false

Top :: Event options

reboot-delay

Wait a number of seconds before rebooting when event occurs. This is useful if you also want to fire off a script via runcmd prior to rebooting, giving it extra seconds to finish.

Available: Events

Config File Syntax: "reboot-delay":"<value>"

Command Line Syntax: --event-reboot-delay <value>

Argument: number Seconds to wait before reboot

Default: 0

Top :: Event options

quit

Exit sgminer when event occurs.

Available: Events

Config File Syntax: "quit":"<value>"

Command Line Syntax: --event-quit <value>

Argument: string Yes: "true" "yes" "1" or No: "false" "no" "0"

Default: false

Top :: Event options

quit-message

Message to display on sgminer exit when event occurs.

Available: Events

Config File Syntax: "quit-message":"<value>"

Command Line Syntax: --event-quit-message "<value>"

Argument: string Message

Default: event_type

Top :: Event options

---

Event Types

• idle Occurs when a GPU goes idle for not performing any work or when no work has been received in 10 minutes.
• gpu_sick Occurs when a GPU fails to respond for 2 minutes
• gpu_dead Occurs when a GPU fails to respond for 10 minutes

Top