LoLMiner Command Line Manual

lolMiner 0.43

For basic settings like changing pool and user settings and how to select a user profile please refer to the quickstart manual.

This document presents further options when running lolMiner 0.43.

Using settings from Command Line

Every normal option that can be passed to the miner via configuration file can also be passed to the miner by using the command line. The general syntax is if the parameter in configuration file is a pair “KEY” : “VALUE”, then the command line equivalent is given by -KEY=VALUE. For example

./lolMiner -profile=EXAMPLE_MNX -digits=2

will overwrite any “DIGITS” : entry from config file. Generally the values in command line have higher priority then those from other sources.

For adding connection information use the parameters
-pool=
-port=
-user=<userName.workerName>
and (optionally) -pass= (the default is “x”).

Internally this will create a pool list with one entry corresponding to the given data. Giving fail-over pools is currently not supported over command line.

Changing the Mining Devices

The parameter “DEVICES” can be modified in the following way:

“DEVICES” : “AUTO” : Mine will all found AMD & Nvidia GPUs in your rig
“DEVICES” : “AMD” or “DEVICES” : “NVIDIA” : Mine will all GPUs from one of the vendors (only works with official vendor drivers, with 3rd party and opensource drivers this may not work) “DEVICES” : [0,1,3] work with the first, second and 4th device of your rig. You can explicitly control which GPUs to use, but stay within the range 0 to #GPUs-1 and every GPU id may only appear once.

For selecting the devices in command line you can use -device= and then a comma separated list of device numbers or “AUTO”, “AMD” or “NVIDIA”, e.g. -devices=0,1,2.

Mining Equihash 144.5 or 192.7 with Nvidia 3G / 4G cards

The Nvidia driver is very restrict regarding the reported maximal size of the memory allowed in a single buffer. That said often using bigger memory buffers then reported by the driver often do in fact work. Therefore to mine Equihash 144.5 on 3G and 4G cards or to mine 192.7 on 4G cards you have to use the new “DISABLE_MEMCHECK” : 1 (config file) or -disable_memcheck=1 (command line) parameter.

Do not use this for mining 96.5 (MinexCoin) since it also disturbs the work- batch calculation.

Activating the API

The parameter “APIPORT” : controls the activation of the lolMiner API. When a port numer > 0 is set the miner will try to open the selected port and the mining rig will be able to accept connections on this port.

When connecting, lolMiner returns current mining statistics in JSON format. For example:

{

“Software”: “lolMiner 0.4”,

“Startup”: “2018-07-22 22:08:37 “,

“Coin”: “MinexCoin (MNX)”, “Algorithm”: “Equihash 96.5”,

“LastUpdate(5s)”: “22:33:46 “,

“LastUpdate(60s)”: “22:32:55 “, “GPU0”: {

“Name”: “AMD Radeon (TM) RX 480 Graphics”, “Speed(5s)”: “13468.8252”,

“Speed(60s)”: “13429.5117”

}, “GPU1”: {

“Name”: “Radeon RX 580 Series”, “Speed(5s)”: “11253.1973”,

“Speed(60s)”: “11262.5537”

}

}

Trouble-Shooting:

If lolMiner is not allowed to open the port there will be a hint “access denied” on startup. The mining process itself is not affected by this, but the API will not work. We recomment trying an other port, best in the 4 digit range.

Modify the Statistics Output

All parameters described in this section can be seen in the EXAMPLE_BTG profile in the shipped user_config.json.

With the parameters “SHORTSTATS” : and “LONGSTATS” : you can modify the two statistic interval length. The number should be an integer and the values will be handled as seconds. Setting one or both values to 0 will deactivate the corresponding statistics print as well in console as in the API.

The parameter “DIGITS” : can be used to fix the sol/s output of a GPU to a fixed number of digits after the decimal delimiter. For example “DIGITS” : 0 will chop of all digits after the decimal delimiter. The default for this parameter is 1.

The parameter “TIMEPRINT”:1 or -timeprint=1 will activate the current daytime to be printed in the command-line console at each statistics output.

The parameter “SHORTACCEPT”:1 or -shotaccept=1 will replace the “submitting share / share accepted” message pair by * symbols at the short statistics interval output. Every star stands for an accepted share.

Chosing new locations for the config file and the kernel directiory

A new config file name can only be chosen by command line parameter -usercfg=, replacing the ./user_config.json. The path can be absolute or relative to the current execution directory.

The kernels direction can be chosen by the parameter “KERNELSDIR” : “pathToDir” or -kernelsdir= (in command line). Again the path can be relative or absolute, the default is “./kernels”.

Adjusting the Failover Pool Function

By the parameter “CONNECTION_ATTEMPTS” : you can specify how many connection attempts are done before the miner tries to switch to the fail-over pool for the first time.

By the parameter “RECONNECTION_TIMER” : you specify the minutes on how long the miner should stay on a failover pool before attempting to reconnect to the first priority pool. If that is still not reachable, the miner will reconnect to the first available fail-over pool. Setting the number to 0 will deactivate reconnection attempts, unless the end of the list of fail-over pools is reached at some time.

Setting the WorkBatch (MNX, Equihash 96.5 only)

The Equihash 96.5 algorithm uses only few memory, so the GPU can handle multiple instances of this algorithm at once. The parameter “WORKBATCH” :