diff options
author | Richard Mudgett <rmudgett@digium.com> | 2011-05-26 18:10:46 +0000 |
---|---|---|
committer | Richard Mudgett <rmudgett@digium.com> | 2011-05-26 18:10:46 +0000 |
commit | 74ba3af20119e561873e9bd491798e5b6975f07a (patch) | |
tree | 0eefe7d45e725f6861f5961b628fdac2a3bcbec5 /include | |
parent | 0c34e54d1ac88ab5d6666b3e0dbf19b1588f2436 (diff) |
Merged revisions 321044 via svnmerge from
https://origsvn.digium.com/svn/asterisk/branches/1.8
........
r321044 | rmudgett | 2011-05-26 13:10:17 -0500 (Thu, 26 May 2011) | 1 line
Update ast_sockaddr comment with an important note.
........
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@321045 65c4cc65-6c06-0410-ace0-fbb531ad65f3
Diffstat (limited to 'include')
-rw-r--r-- | include/asterisk/netsock2.h | 20 |
1 files changed, 15 insertions, 5 deletions
diff --git a/include/asterisk/netsock2.h b/include/asterisk/netsock2.h index 888861c65..c5c08cf73 100644 --- a/include/asterisk/netsock2.h +++ b/include/asterisk/netsock2.h @@ -43,12 +43,22 @@ enum { }; /*! - * Socket address structure. The first member is big enough to contain addresses - * of any family. The second member contains the length (in bytes) used in the - * first member. + * \brief Socket address structure. * - * Some BSDs have the length embedded in sockaddr structs. We ignore them. - * (This is the right thing to do.) + * \details + * The first member is big enough to contain addresses of any + * family. The second member contains the length (in bytes) used + * in the first member. + * + * \note + * Some BSDs have the length embedded in sockaddr structs. We + * ignore them. (This is the right thing to do.) + * + * \note + * It is important to always initialize ast_sockaddr before use + * -- even if they are passed to ast_sockaddr_copy() as the + * underlying storage could be bigger than what ends up being + * copied -- leaving part of the data unitialized. */ struct ast_sockaddr { struct sockaddr_storage ss; |