[asterisk-bugs] [Asterisk 0017054]: strange documentation of tlsbindaddr in sip.conf

[Asterisk Bug Tracker]

A NOTE has been added to this issue. 
====================================================================== 
https://issues.asterisk.org/view.php?id=17054 
====================================================================== 
Reported By:                klaus3000
Assigned To:                lmadsen
====================================================================== 
Project:                    Asterisk
Issue ID:                   17054
Category:                   Documentation
Reproducibility:            always
Severity:                   minor
Priority:                   normal
Status:                     closed
Asterisk Version:           SVN 
JIRA:                       SWP-1112 
Regression:                 No 
Reviewboard Link:            
SVN Branch (only for SVN checkouts, not tarball releases): N/A 
SVN Revision (number only!):  
Request Review:              
Resolution:                 fixed
Fixed in Version:           
====================================================================== 
Date Submitted:             2010-03-18 09:20 CDT
Last Modified:              2010-03-26 14:17 CDT
====================================================================== 
Summary:                    strange documentation of tlsbindaddr in sip.conf
Description: 
sipc.conf.sample cotains:

;tlsenable=no                   ; Enable server for incoming TLS (secure)
connections (default is no)
;tlsbindaddr=0.0.0.0            ; IP address for TLS server to bind to
(0.0.0.0) binds to all interfaces)
                                ; Optionally add a port number,
192.168.1.1:5063 (default is port 5061)
                                ; Remember that the DNS entry for the
common name (server name) in the
                                ; certificate must point to the IP address
you bind to,
                                ; so you don't want to bind a TLS socket
to multiple IP addresses.

The part starting with "Remember that the DNS ..." is not correct
(multiple IP addresses serving the same domain (e.g. mutliple A records)
work well) and IMO it is very confusing. IMO a better text would be: "For
details how to construct a certificate for SIP see
http://tools.ietf.org/html/draft-ietf-sip-domain-certs"
====================================================================== 

---------------------------------------------------------------------- 
 (0119947) svnbot (reporter) - 2010-03-26 14:17
 https://issues.asterisk.org/view.php?id=17054#c119947 
---------------------------------------------------------------------- 
Repository: asterisk
Revision: 255026

_U  branches/1.6.1/
U   branches/1.6.1/configs/sip.conf.sample

------------------------------------------------------------------------
r255026 | lmadsen | 2010-03-26 14:17:42 -0500 (Fri, 26 Mar 2010) | 16
lines

Merged revisions 255021 via svnmerge from 
https://origsvn.digium.com/svn/asterisk/trunk

........
  r255021 | lmadsen | 2010-03-26 14:07:38 -0500 (Fri, 26 Mar 2010) | 8
lines
  
  Update confusing documentation for tlsbindaddr.
  
  Update some confusing documentation for the tlsbindaddr
  option in sip.conf.sample. Point at a link instead which
  has better documentation.
  
  (closes issue https://issues.asterisk.org/view.php?id=17054)
  Reported by: klaus3000
........

------------------------------------------------------------------------

http://svn.digium.com/view/asterisk?view=rev&revision=255026 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2010-03-26 14:17 svnbot         Checkin                                      
2010-03-26 14:17 svnbot         Note Added: 0119947                          
======================================================================