Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
DNETC(1)		FreeBSD	General	Commands Manual		      DNETC(1)

     dnetc -- distributed computing client for FreeBSD

     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]

     dnetc is a	distributed computing client that coordinates with servers op-
     erated by 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	keyservers. It is de-
     signed to run in idle time	so as to not impact the	normal operation of
     the computer.

     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.

     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

     -nodisk	 don't use disk	buffer files

     -n	_count_	 packets to complete. -1 forces	exit when buffer is empty.

		 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:
		 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

		 don't fallback	to a 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)

		 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

		 allow/disallow	multiple instances of the client to run
		 The default is	'allow'	for all	platforms but Windows.

		 don't display work completion as a running percentage

		 suppress screen output	(== detach for some clients)

     -noquiet	 don't suppress	screen output (override	ini quiet setting)

BUGS 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 bug tracking data-
     base at

     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".

     dnetc_opt (or the upper-case version thereof)
     Additional	source of command line options (parsed first)

     Additional	sources	of command line	options	(parsed	last)

     Client documentation: dnetc.txt and


			       January 18, 2021


Want to link to this manual page? Use this URL:

home | help