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

FreeBSD Manual Pages


home | help

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

       inadyn-mt - a client for	open DNS servers.

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

       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: (requires SSL bridge, like stunnel)

       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.

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

	      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.

	      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

	      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, /, /, /, among others.  And,  of  course,  dynamic
	      dns server should	be set to one that supports IPv6.

	      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.

	      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.

	      The update path inside the DynDNS	server.

	      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

	      An optional DNS service. For

	      the   acceptable	 services   are	  one	of, or

	      There	is     only	one	acceptable     service	   for, which is
	      Other services are:
		     Requires SSL bridge, like stunnel;	set --server_host_name
		     See  also	custom	 server	  options,   --svr_rsp_succes,
		     --svr_rsp_other, --svr_ip_param,  --svr_ip_in_rsp
	      The  default  service is, which	is believed to
	      be used by most users, at	least initially.

	      An http proxy server name	and port. The default is none.

	      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.

	      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.

	      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.

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

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

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

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

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

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

	      Explicitly sending the output to a syslog	 like  file,  such  as

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

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

	      Network comm miliseconds retry interval, 0  to  30,000,  default

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

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

	      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.

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

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

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

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

	      Audible  network status alerts toggle (log output	only), default

	      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.

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

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

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

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

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

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

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

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

	      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.

	      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.

       inadyn-mt -u username -p	password -a

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

       inadyn-mt --background -u test -p test  --update_period	60000  --alias --alias my.second.domain --log_file inadyn-mt.log
       inadyn-mt   --dyndns_system	 -a  my.regis-,hash_from_freedns

       inadyn-mt --update_period 60000 --alias,hash_for_host1
       -a my.second.domain,hash2 --dyndns_system

       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


       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.

       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.

       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.

   Other manual	pages
       The  syntax  of	the  optional  configuration  file is given by inadyn-

   Internet resources



       inadyn was written by Narcis Ilisei, <>;  inadyn-
       advanced,  Steve	 Horbachuk;  inadyn-mt	unicode,  other	augmentations,
       Bryan Hoover <>

       This manual page	was written by Shaul Karl, <>, 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)


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

home | help