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

FreeBSD Manual Pages

  
 
  

home | help
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>

home | help