diff options
author | rmudgett <rmudgett@f38db490-d61c-443f-a65b-d21fe96a405b> | 2011-05-26 18:10:46 +0000 |
---|---|---|
committer | rmudgett <rmudgett@f38db490-d61c-443f-a65b-d21fe96a405b> | 2011-05-26 18:10:46 +0000 |
commit | 6c93ad8de31d9c33c4a25361fa26fba48dc384e6 (patch) | |
tree | 0eefe7d45e725f6861f5961b628fdac2a3bcbec5 | |
parent | 6acee6697db89ee4d41083584f4d8b2d20203218 (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: http://svn.digium.com/svn/asterisk/trunk@321045 f38db490-d61c-443f-a65b-d21fe96a405b
-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; |