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

FreeBSD Manual Pages

  
 
  

home | help
w.

inadyn-mt(8)		  System management commands		  inadyn-mt(8)

NAME
       inadyn-mt - a client for	open DNS servers.

SYNOPSIS
       inadyn-mt  [-h  |  --help] [-u |	--username username] [-p | -- password
       password] [-a | --alias alias[,hash] [dual | coupled  |	ip4  |	ip6  |
       auto]]  [--input_file  path/name]  [--ip_server_name server[:port] url]
       [--dyndns_server_name server[:port]] [--dyndns_server_url url]  [--dyn-
       dns_system  service] [--proxy_server[:port] proxy[:port]] [--update_pe-
       riod  ms]  [--update_period_sec	 sec]	[--forced_update_period	  sec]
       [--log_file  path/name]	[--background] [--verbose level] [--iterations
       iterations] [--syslog] [--change_persona	uid[:gid]]

DESCRIPTION
       inadyn-mt is a client for `open'	name servers. That is, it  allows  the
       user's machine to have an Internet recognized name by transferring some
       control over a name server not managed by the user. Some	 of  the  ser-
       vices  that  are	offered	by those open name servers are free of charge,
       and work	even when the client machine does not have a static IP.	  Sup-
       ports both IPv4,	and IPv6 addresses.

       Supported name servers are:

       http://www.dyndns.org

       http://freedns.afraid.org

       http://www.zoneedit.com

       http://www.no-ip.com

       http://www.easydns.com

       http://www.3322.org

       http://www.sitelutions.com

       http://www.tzo.com

       http://www.dnsomatic.com

       http://www.tunnelbroker.net

       http://www.dynsip.org

       http://www.dhis.org

       http://www.zerigo.com

       http://www.two-dns.de

       http://www.dnsdynamic.org

       http://dnspark.com

       http://regfish.de

       http://www.ovh.com

       http://joker.com

       http://dyndns.strato.com

       http://system-ns.com

       http://www.dtdns.com

       http://changeip.com

       http://dnsexit.com

       http://nsupdate.info

       http://loopia.com

       http://domains.google.com (requires SSL bridge, like stunnel)

       http://duckdns.org

       Its  basic  operation is	to periodically	check whether the actual IP of
       the client machine is the same one that is recorded in the name server,
       and update the name server records when there is	a mismatch.

       For IPv6	addresses, see below, alias, and ip_server_name	options.

       Also,  network  status can be checked at	a user specified interval, and
       audible alerts issued in	event of network status	down.

   OPTIONS
       "-h, --help"
	      Print a summary of the options to	inadyn-mt and exit.

       "-u, --username"
	      The username, if applicable. This	might be referred to as	hash.

       "-p, --password"
	      The password, if applicable.

       "-a, --alias[,hash] [dual | coupled | ip4 | ip6 | auto]"
	      A	host name alias, optional comma	delimited hash,	 and  optional
	      ip version, default auto.	This option can	appear multiple	times,
	      for each domain that has the same	IP.

	      For alias	ip type, it may	often suffice to use either dual,  for
	      dual stack clients updating a given alias	to both	IPv4, and IPv6
	      addresses, or ip4	when the client	is dual	stack and requires  at
	      least  one  IPv4 only address update.  Leaving ip	type up	to the
	      ip server	(see ip_server_name option, below)  may	 be  also,  in
	      many instances, sufficient (auto alias ip	type, which is the de-
	      fault).

	      Use ip type coupled instead of dual in cases where ip server up-
	      date  specification  requires dual stack updates in a single up-
	      date request, i.e., both ip address types	may be sent in a comma
	      delimited	list fashion.

       --input_file
	      The file name that contains inadyn-mt command options exactly as
	      specified	in the command line  syntax  (adds  to	those  already
	      present in the cmd line).	The default configuration file name is
	      '/etc/inadyn.conf'. It is	looked at automatically	 if  inadyn-mt
	      is called	without	any command line options. The format is	as ex-
	      pected for a **NIX config	  the hash character is	used  to  com-
	      ment  entire  lines. Spaces are ingored. The long	options	may be
	      specified	without	-- if placed at	the beginning of the line.

       --ip_server_name[:port] url
	      The  client  IP  is  detected  by	 calling   'url'   from	  this
	      'ip_server_name:port'.

	      Choice  of  ip  server  name parameter option can	determine what
	      type of address is updated.  To update an	IPv6  address,	simply
	      choose  an  ip  server  that  supports  IPv6, such as, ip6.me /,
	      myip.dk /, dhis.org /, among others.  And,  of  course,  dynamic
	      dns server should	be set to one that supports IPv6.

       --ip_server_host
	      Host  name used in http request to ip server if differnt from ip
	      server name, as when, e.g., ip_server_name is 'localhost:port /'
	      through an SSL bridge. Defaults to ip server name.

       --dyndns_server_name[:port]
	      The  server that receives	the update DNS requests. When no proxy
	      is specified it is sufficient to set the dyndns_system  so  that
	      the  default  servers  will  be  taken. The option is useful for
	      generic DynDNS services that support HTTP	update.

       --dyndns_server_url
	      The update path inside the DynDNS	server.

       --dyndns_server_host
	      Host name	used in	http update DNS	 request,  if  different  from
	      dyndns  server  name,  as	 when, e.g., ip_server_name is 'local-
	      host:port' through an SLL	bridge.	  Defaults  to	dyndns	server
	      name.

       --dyndns_system
	      An optional DNS service. For

	      http://www.dyndns.org

	      the   acceptable	 services   are	  one	of  dyndns@dyndns.org,
	      statdns@dyndns.org or custom@dyndns.org.

	      There	is     only	one	acceptable     service	   for
	      http://freedns.afraid.org, which is default@freedns.afraid.org.
	      Other services are:
	      default@zoneedit.com
	      default@no-ip.com
	      default@easydns.com
	      dyndns@3322.org
	      default@sitelutions.com
	      default@dnsomatic.com
	      ipv6tb@he.net
	      default@tzo.com
	      default@dynsip.org
	      default@dhis.org
	      default@zerigo.com
	      default@two-dns.de
	      default@dnsdynamic.org
	      default@dnspark.com
	      ipv4@regfish.de
	      ipv6@regfish.de
	      default@ovh.com
	      default@joker.com
	      default@strato.com
	      default@system-ns.com
	      default@dtdns.com
	      default@changeip.com
	      default@dnsexit.com
	      ipv4@nsupdate.info
	      ipv6@nsupdate.info
	      default@loopia.com
	      default@domains.google.com
		     Requires SSL bridge, like stunnel;	set --server_host_name
		     domains.google.com
	      default@duckdns.org
	      custom@http_svr_basic_auth
		     See  also	custom	 server	  options,   --svr_rsp_succes,
		     --svr_rsp_other, --svr_ip_param,  --svr_ip_in_rsp
	      The  default  service is dyndns@dyndns.org, which	is believed to
	      be used by most users, at	least initially.

       --proxy_server[:port]
	      An http proxy server name	and port. The default is none.

       --update_period
	      How often	the IP is  checked.  This  value  denotes  millisecond
	      (There  are  1000	milliseconds in	one second). 30000..864000000.
	      Default is about 10 min.	maximum	is 10 days.

       --update_period_sec
	      How often	the IP is checked. Here	 the  value  denotes  seconds.
	      30..864000.   The	default	is about 10 min.  The maximum value is
	      10 days.

       --forced_update_period
	      How often	the IP should be updated even if it  is	 not  changed.
	      The time should be given in seconds.  30 sec..30 days.  Default,
	      30 days.

       --forced_update_adjust
	      Fine timer control.  Slow, or speed timer	 between  -4..5.   De-
	      fault, 0.

       --log_file
	      The name,	including the full path, of a log file.

       --cache_dir
	      Directory	 to  which ip, and time	update files are written.  De-
	      faults to	/tmp on	**NIX systems.

       --background
	      run in background. Output	is sent	to the UNIX syslog  facilities
	      or to a log file,	if one was specified.

       --verbose
	      Set the debug level, which is an integer between 0 to 5.

       --iterations
	      Set the number of	DNS updates. The default is 0, which means in-
	      finity.

       --syslog
	      Explicitly sending the output to a syslog	 like  file,  such  as
	      /var/log/messages.

       --change_persona	uid[:gid]
	      After  init  changes  user ID and	group ID to the	provided ones.
	      This allows dropping unneeded [root] privileges after startup.

       --retries
	      Network comm retry attempts.  0 to 100, default 0.

       --retry_interval
	      Network comm miliseconds retry interval, 0  to  30,000,  default
	      1,000.

       --retry_pending
	      Retry  ip	update even after network comm retries exhausted,  de-
	      fault on.

       --retry_pending_interval
	      Network comm seconds update retry	interval,  after  retries  ex-
	      hausted.	5 to 3600, default 300.

       --lang_file
	      Language file path, and file name, defaults to either ../inadyn-
	      mt/lang/en.lng, or etc/inadyn-mt/en.lng.	 No  parameter	option
	      gives hard coded defaults.

       --online_check_url
	      srv_name[:port]  local_url - URL to reach	to confirm online sta-
	      tus.

       --status_interval
	      Seconds [30..864000] interval at which to	check  online  status,
	      defaults to 600.

       --alert_retries
	      Network  retries before audible network status alerts. [0..100],
	      default 0.

       --status_offline_interval
	      Seconds [0..864000] interval at which to	check  online  status,
	      after offline detected, defaults to 15.

       --audible
	      Audible  network status alerts toggle (log output	only), default
	      off.

       --wave_file
	      Audible network status alerts wave file path, and	file name. de-
	      faults  to  either ../inadyn-mt/extra/wav/alarm.wav, or etc/ina-
	      dyn-mt/extra/wav/alarm.wav.  [wave loops:	0..100;	-1  for	 infi-
	      nite]  same  as wave_loops below -- optional number of times per
	      wave play	call to	repeat wave file play, default 0.

       --wave_loops
	      Same as wave_file	parameter optional parameter --	0..100;	-1 for
	      infinite number of times per wave	play call to play wave file.

       --wave_buff
	      Wave  file output	buffer size control -- integer or float	multi-
	      ple of wave file bytes per sec. [.25..10], default .25.

       --wave_gain
	      Gain (amplitude adjust) at which to play audible	alert  (beware
	      clipping),  integer or float. [-10..10], default 10 (0db,	no at-
	      tenuation).

       --alert_interval
	      Time in miliseconds between consecutive audible  network	status
	      alerts, [0..3600000], default 0.

       --svr_rsp_success
	      Optional	for  custom  DDNS  updates.   A	quoted comma delimited
	      string, e.g., "good, nochg",  representing  custom  DDNS	server
	      successful update	return values.

       --svr_rsp_other
	      Optional	for  custom  DDNS  updates.   A	quoted comma delimited
	      string, e.g., "dnserr,911", representing custom DDNS server non-
	      fatal update failure return values.

       --svr_ip_param
	      Optional for custom DDNS updates.	 DDNS url parameter for	ip ad-
	      dress, e.g., myip.

       --svr_ip_in_rsp
	      Optional for custom DDNS updates.	Flag that custom  DDNS	server
	      returns your ip address on update	success.  Defaults to false.

       --svr_add_cfg
	      Additional   servers  file.  Default  search  for	 servers_addi-
	      tional.cfg in ./extra, /etc, /etc/inadyn-mt,  /etc/inadyn-mt/ex-
	      tra.   Contains additional preconfigured DDNS servers to be used
	      as --dyndns_system option	parameter in same fashion  as  servers
	      inadyn-mt	 supports  natively.   Should  appear  before any dyn-
	      dns_system, option in inadyn-mt.conf or command line if not  us-
	      ing inadyn-mt.conf.

       --if   Name  of network interface to use	for ip server, and DDNS	server
	      comm.  Defaults to system	configured default.

       --addr_pref
	      ipv6 privacy extensions address  preference.   Valid  parameters
	      are  'pub,'  'policy,'  'home,'  'careof,' 'crypto,' 'nocrypto,'
	      'tmp,' 'pubtmp.'	Defaults to 'pub.'   See  rfc5014.   Combining
	      via logical OR not presently supported.

TYPICAL	USAGE
   http://www.dyndns.org
       inadyn-mt -u username -p	password -a my.registered.name

       inadyn-mt --username test --password test --update_period 60000 --alias
       test.homeip.net --alias my.second.domain

       inadyn-mt --background -u test -p test  --update_period	60000  --alias
       inarcis.homeip.net --alias my.second.domain --log_file inadyn-mt.log

   http://freedns.afraid.org
       inadyn-mt   --dyndns_system   default@freedns.afraid.org	 -a  my.regis-
       trated.name,hash_from_freedns

       inadyn-mt --update_period 60000 --alias	test.homeip.net,hash_for_host1
       -a my.second.domain,hash2 --dyndns_system default@freedns.afraid.org

       The 'hash' should be extracted from the grab url	batch file that	can be
       downloaded from the site. A single hashed (base64  encoded)  string  is
       preferred  upon	a username and password	pair, apparently to reduce the
       computational resources that is required	on their  side.	 Unfortunately
       the hash	can not	be computed by inadyn-mt because it requires the index
       to the username record in the freedns database, which is	not known. The
       simplest	 solution  seems  to  be a copy&paste action from the grab url
       batch file offered on their website. When the batch file	looks is like

       graburl	 http://freedns.afraid.org/dynamic/update.php?YUGIUGSEIUFGOUI-
       HEOIFEOIHJFEIO=

       the  hash  string, which	is what	the user should	copy and paste,	is the
       string that begins right	after the '?' character	and ends with the  end
       of  line.  This	string shell be	used as	the username in	inadyn-mt com-
       mand.  When the user has	several	names then each	name  should  be  fol-
       lowed with that name hash string.

OUTPUT
       inadyn-mt prints	a message when the IP is updated.  When	the connection
       goes down it could be that inadyn-mt will print	some  error  messages.
       Those  are  harmless  and should	be followed by 'OK' messages after the
       connection is back up.

Signals
       Any of the SIG_HUP, SIG_INT, SIG_QUIT will cause	inadyn-mt to terminate
       gracefully.  SIG_USR1 will cause	inadyn-mt to update ip,	if changed.

SEE ALSO
   Other manual	pages
       The  syntax  of	the  optional  configuration  file is given by inadyn-
       mt.conf(5).

   Internet resources
       inadyn:

       http://www.inatech.eu/

       inadyn-advanced:

       http://sourceforge.net/projects/inadyn-advanced/

       inadyn-mt:

       http://sourceforge.net/projects/inadyn-mt/

AUTHOR
       inadyn was written by Narcis Ilisei, <inarcis2002@hotpop.com>;  inadyn-
       advanced,  Steve	 Horbachuk;  inadyn-mt	unicode,  other	augmentations,
       Bryan Hoover <bhoover@wecs.com>

       This manual page	was written by Shaul Karl, <shaul@debian.org>, for the
       Debian GNU/Linux	system,	based on the readme.html file that is found in
       the source.

Linux applications		September, 2009			  inadyn-mt(8)

NAME | SYNOPSIS | DESCRIPTION | TYPICAL USAGE | OUTPUT | Signals | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=inadyn-mt&sektion=8&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help