FreeBSD Manual Pages
DNETC(1) FreeBSD General Commands Manual DNETC(1) NAME dnetc -- distributed.net distributed computing client for FreeBSD SYNOPSIS dnetc [-config] [-flush] [-fetch] [-update] [-benchmark [prj]] [-benchmark2 [prj]] [-bench [prj [cn]]] [-test [prj [cn]]] [-stress [prj [cn]]] [-cpuinfo] [-restart] [-shutdown] [-pause] [-unpause] [-import <filename>] [-forceunlock <fn>] [-help] [-version] [-ini <filename>] [-e <address>] [-nodisk] [-n <count>] [-runbuffers] [-frequent] [-inbase <fname>] [-outbase <fname>] [-ckpoint <fname>] [-bin <prj> <n>] [-btime [prj] <n>] [-runoffline] [-runonline] [-nettimeout <secs>] [-a <address>] [-p <port>] [-nofallback] [-u <method>] [-ha <address>] [-hp <port>] [-lurk] [-lurkonly] [-interfaces <list>] [-c [prj] <n>] [-numcpu <n>] [-devicenum <n>] [-priority <0-9>] [-l <filename>] [-smtplen <len>] [-smtpsrvr <host>] [-smtpport <port>] [-smtpfrom <id>] [-smtpdest <id>] [-h <hours[:min]>] [-until <HH:MM>] [-noexitfilecheck] [-pausefile <fn>] [-exitfile <fn>] [-multiok[=|:][0|1]] [-percentoff] [-quiet/-hide] [-noquiet] DESCRIPTION dnetc is a distributed computing client that coordinates with servers op- erated by distributed.net to cooperate with other network-connected com- puters to work on a common task. It communicates over public networks and processes work assigned by the distributed.net keyservers. It is de- signed to run in idle time so as to not impact the normal operation of the computer. INSTALLATION Since you are already reading this, I assume you know how to unpack an archive into a directory of your choice. :) Now, simply fire up the client... If you have never run the client before, it will initiate the menu-driven configuration. Save and quit when done, the configuration file will be saved in the same directory as the client. Now, simply restart the client. From that point on it will use the saved configuration. The configuration options are fairly self-explanatory and can be run at any time by starting the client with the '-config' option. A list of com- mand line options is listed below. OPTIONS In addition to the conventional command line passed to the client from a shell, options may also be passed to the client using either or both of the following methods: - using the dnetc_opt= environment variable. If set, this is parsed before the normal command line. - using the /usr/local/etc/dnetc.opt and/or /etc/dnetc.opt command files. If found, these are parsed after the normal command line. "Mode commands" (see below) cannot be executed using these methods, and there is no run-time display of modified settings (unless the settings are also modified using the conventional command line, in which case the last effective change is displayed). Mode commands: (the client will execute the option and then exit) -config start the configuration menu -flush flush all output buffers -fetch fill all input buffers -update fetch + flush -benchmark [prj] 16-20 sec speed check [optional: only project prj] -benchmark2 [prj] half (8-10 sec) and slightly inaccurate -benchmark -bench [prj [cn] -benchmark all cores [optional: only project prj] [optional: only core cn, must be used with prj] -test [prj [cn] tests for core errors [optional: only project prj] [optional: only core cn, must be used with prj] -stress [prj [cn] more thorough and longer running variant of -test -cpuinfo print information about the detected cpu(s) -restart restart all active clients -shutdown gracefully shut down all active clients -pause pause all active clients -unpause unpause all active clients -import _filename_ import packets from file <filename> into client buffers -forceunlock _fn_ unlock buffer file <fn> -help display this text -version print version information Project and buffer related options: -ini _filename_ override default name of INI file -e _address_ the email id by which you are known to distributed.net -nodisk don't use disk buffer files -n _count_ packets to complete. -1 forces exit when buffer is empty. -runbuffers set -n == -1 (exit when buffers are empty) -frequent frequently check if buffers need topping-up -inbase _fname_ input buffer basename (ie without 'extension'/suffix) -outbase _fname_ output buffer basename (ie without 'extension'/suffix) -ckpoint _fname_ set the name of the checkpoint file -bin _prj_ _n_ set fetch buffer threshold to <n> work units -btime [prj _n_] set fetch time threshold to <n> hours If not specified, project name <prj> defaults to RC5 Network update related options: -runoffline disable network access -runonline enable network access -nettimeout _secs_ set the network timeout. Use -1 to force blocking mode -a _address_ keyserver name or IP address -p _port_ keyserver port number -nofallback don't fallback to a distributed.net keyserver -u _method_ use this UUE/HTTP encoding method (see -config) -ha _address_ http/socks proxy name or IP address -hp _port_ http/socks proxy port -lurk automatically detect modem connections -lurkonly perform buffer updates only when a connection is detected -interfaces _list_ limit the interfaces to monitor for online/offline status Performance related options: -c [prj _n_] core number (run -config for a list of valid core numbers) project name 'prj' defaults to RC5 -numcpu _n_ run <n> threads/run on <n> cpus. 0 forces single-threading. -devicenum _n_ run on device <n> only. -priority _0-9_ scheduling priority from 0 (lowest/idle) to 9 (normal/user) Logging options: -l _filename_ name of the log file -smtplen _len_ max size (in bytes) of a mail message (0 means no mail) -smtpsrvr _host_ name or IP address of mail (SMTP) server -smtpport _port_ mail (SMTP) server port number -smtpfrom _id_ who the client should say is sending the message -smtpdest _id_ who the client should send mail to Miscellaneous runtime options: -h _hours[:min]_ time limit in hours -until _HH:MM_ quit at HH:MM (eg 07:30) -noexitfilecheck override .ini exit flagfile setting -pausefile _fn_ name of file that causes the client to pause -exitfile _fn_ name of file that causes the client to exit -multiok[=|:][0|1] allow/disallow multiple instances of the client to run The default is 'allow' for all platforms but Windows. -percentoff don't display work completion as a running percentage -quiet/-hide suppress screen output (== detach for some clients) -noquiet don't suppress screen output (override ini quiet setting) BUGS distributed.net maintains a database to assist with the tracking and res- olution of bugs in dnetc and related software. If you believe you have found a bug, please submit it to the distributed.net bug tracking data- base at http://bugs.distributed.net/ Please provide the entire version descriptor as displayed on client start when doing so. For example, the client version this manpage was generated for was "dnetc v2.9112-521-CTR-16021317 for FreeBSD". ENVIRONMENT dnetc_opt (or the upper-case version thereof) Additional source of command line options (parsed first) FILES /usr/local/etc/dnetc.opt /etc/dnetc.opt Additional sources of command line options (parsed last) SEE ALSO Client documentation: dnetc.txt and http://faq.distributed.net/ AUTHOR distributed.net http://www.distributed.net/ January 18, 2021
NAME | SYNOPSIS | DESCRIPTION | INSTALLATION | OPTIONS | BUGS | ENVIRONMENT | FILES | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dnetc&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>