Ipmsg

Ipmsg
2010年12月22日
　　ipmsg全称：IP Messenger，中文名为"飞鸽传书"，是一款由一个名叫H.Shirouzu的日本人开发和维护的用C语言写的局域网聊天和文件传输工具。后来发展为很多志愿者共同开发多种版本。它是一个小巧方便的即时通信软件，它适合用于局域网内甚至广域网间进行实时通信和文档共享。特别是在局域网内传送文件/文件夹的效率很高。它具有很多优点，如数据通讯不需要建立服务器、直接在两台电脑间通信和数据传输，支持文件及文件目录的传输，安全快捷以及小巧方便等优异特点，因此很多公司都采用它作为部门、公司内部的IM即时通信工具。 
　　- IPMsg 是一款局域网内即时通信软件, 基于 TCP/IP(UDP). 
　　可运行于多种操作平台(Win/Mac/UNIX/Java), 并实现跨平台信息交流. 
　　- 不需要服务器支持(软件本身集成了服务端和客户端)
　　- 支持文件/文件夹的传送 (2.00版以上) 
　　- 通讯数据采用 RSA/Blofish 加密 (2.00版以上) 
　　- 十分小巧, 简单易用, 而且可以完全免费使用它 
　　- 目前已有的版本包括: Win32, Win16, MacOS, MacOSX, X11, GTK, GNOME, 
　　Java 等，并且公开源代码。  IP Messenger在程序结构方面采用了Windows SDK处理结构，通信方面采用了TCP/UDP通信方式，在文件传输处理方面采用文件映射技术，等等。通过分析IP Messenger的运行、工作原理，可以提高并加深对Windows处理流程的理解，提高SOCKET编程技术等，因此特对其源码进行分析，以抛砖引玉，共同提高大家的编程技术。
　　1、IP Messenger源代码的下载
　　在写这篇文章时，IP Messenger的最新版本是2.06，因此大家在下载时尽量选择最新版本下载。IP Messenger源代码的下载地址是http://www.ipmsg.org/，在网站的右上角，点击English page，网站转换到英文界面，网站有英文版以及其它语言的版本，当然还有中文版的链接（http://www.azhi.net/IPMsg/），建议大家尽量下载原版的英文版源代码，以利于学习。
　　2、IP Messenger源代码的目录及文件
　　IP Messenger源代码的目录结构及文件详见列表1.1 IP Messenger源代码主要的目录及文件：
　　列表1.1 IP Messenger源代码主要的目录及文件 属性 名称 描述 
　　目录 SRC 工程文件源代码和INSTALL目录 
　　文件 IPMSG.MAK VC4及以前版本使用的工程文件，用来指定如何建立一个工程，VC6把MAK文件转换成DSP文件来处理 
　　IPMSG.MDP 后缀MDP（Microsoft DevStudio Project的简称）是老版本的项目文件，相当于DSP文件 
　　PROT-ENG.TXT 英文版的协议描述 
　　PROTOCOL.TXT 日文版的协议描述 
　　README.TXT 英文版的README 
　　README-J.TXT 日文版的README 
　　IP Messenger的SRC目录内容描述在列表1.2，SRC目录及主要文件。 属性 名称 描述 
　　目录 INSTALL 安装程序源代码目录 
　　文件 BLOWFISH.CPP 加密算法源文件 
　　BLOWFISH.H 加密算法头文件 
　　BLOWFISH.H2 加密算法随机数头文件 
　　CFG.CPP 系统配置源文件 
　　IPMSG.CPP IPMSG的APP源文件 
　　IPMSG.H IPMSG头文件 
　　LOGDLG.CPP 日志DLG源文件 
　　LOGMNG.CPP 日志处理源文件 
　　MAINWIN.CPP IP Messenger主窗口源文件 
　　MISCDLG.CPP 消息DLG，关于DLG，以及控件子类化等源文件 
　　MSGMNG.CPP Socket管理源文件 
　　PLUGIN.CPP Dll plugin加载源文件 
　　RECVDLG.CPP 接收消息处理源文件 
　　SENDDLG.CPP 发送消息处理源文件 
　　SETUPDLG.CPP IP Messenger属性配置源文件 
　　SHARE.CPP 文件传输接收管理源文件 
　　TAPP.CPP 应用程序类源文件 
　　TDLG.CPP DLG类源文件 
　　TLIST.CPP 链表类源文件 
　　TREGIST.CPP 注册表操作类源文件 
　　TWIN.CPP 窗口类源文件 
　　MSGSTR.H 字符串常量头文件 
　　TLIB.H 类、结构等头文件 
　　另外在SRC目录下，还有一个INSTALL目录，该目录中的文件是IP Messenger安装程序的源代码，其主要文件描述在列表1.3 INSTALL目录主要文件。 以上是IP Messenger的主要目录及其主要源文件的描述，通过列表我们可以清晰看出IP Messenger的功能分布。在以下的详细分析中，我们主要围绕着这些源文件而展开。
　　3、IP Messenger源代码的工程转换
　　由于IP Messenger是使用以前版本的VC编写的，因此在打开工程文件时，需要转换该工程文件为VC6版本的工程文件。
　　双击打开IPMSG.MDP文件，系统提示转换IPMSG.MAK工程配置文件到VC6下的工程文件，如下图所示。
　　
　　单击 "是"按钮，确定将工程转换成VC6的工程。系统提示将MAK工程文件转换成DSP工程文件，如下图所示。
　　
　　单击"确定"按钮，系统根据MAK文件生成IPMSG.DSP文件，以及VC6下的IPMSG.DSW文件，另外系统还生成了IPMSG.NCB和IPMSG.OPT两个文件。" 
　　4、IP Messenger的工程配置
　　IP Messenger的配置和目前VC6的工程配置有些不同，其安装工程文件和工程文件在混合在一起，不像VC6工程文件，不同的工程在不同的项目下，分别进行配置。; 
　　单击"Build"菜单，选择"Set Active Configuration…"，弹出"Set Active Project Configuration"对话框，如下图所示：
　　
　　IP Messenger的工程配置有6个，分别是Release的英文、日文以及Debug的ipmsg工程和安装工程。通过选择不同的配置，可以编译出不同的工程。根据需要，我们选择ipmsg-Win32 Debug配置作为当前活动工程，此编译配置可以编译出Debug版的ipmsg。
　　单击"Project"菜单，选择"Settings…"，弹出"Project Settings"对话框，选择"C/C++"标签栏，如下图所示：
　　
　　可以看到，在"Preprocessor definition："中，工程使用了"JAPANESE"宏定义，也就是说，编译后的Debug版的ipmsg是日文版。当然，可以根据需要，修改此宏为"ENGLISH"，就可以编译出Debug版的英文ipmsg。
　　当然，在以后的分析中，我们将分析ipmsg的安装工程，那么就应当选择ipmsg-Win32 InstallerDbg配置作为当前活动工程，编译出Debug版的安装工程。 
　　-------------------------------------------------- ------------------------------
　　飞鸽传书 (IP Messenger) Ver2.06 
　　Copyright (C) 1996-2004 SHIROUZU Hiroaki
　　All Rights Reserved.
　　-------------------------------------------------- ------------------------------
　　目录:
　　1. 软件简介
　　2. 许可协议
　　3. 系统要求
　　4. 使用说明
　　5. 相关信息
　　6. 广域网设置(广播设置)
　　7. 补充
　　8. 支持
　　9. 更新历史
　　10. 感谢
　　================================================== ==============================
　　重要说明: comctl32.dll(公共控件) 要求 4.71 或以上版本
　　更多信息请参见 "系统要求"
　　================================================== ==============================
　　-------------------------------------------------- ------------------------------
　　1. 软件简介
　　- IPMsg 是一款局域网内即时通信软件, 基于 TCP/IP(UDP).
　　可运行于多种操作平台(Win/Mac/UNIX/Java), 并实现跨平台信息交流.
　　- 不需要服务器支持.
　　- 支持文件/文件夹的传送 (2.00版以上)
　　- 通讯数据采用 RSA/Blofish 加密 (2.00版以上)
　　- 十分小巧, 简单易用, 而且你可以完全免费使用它
　　- 目前已有的版本包括: Win32, Win16, MacOS, MacOSX, X11, GTK, GNOME,
　　Java 等, 并且公开源代码.
　　请查看以下地址以获得相关信息:
　　http://www.ipmsg.org/
　　-------------------------------------------------- ------------------------------
　　2. 许可协议 (BSD License)
　　Copyright (c) 1996-2004 SHIROUZU Hiroaki All rights reserved.
　　Redistribution and use in source and binary forms, with or without
　　modification, are permitted provided that the following conditions
　　are met:
　　Redistributions of source code must retain the above copyright
　　notice, this list of conditions and the following disclaimer. 
　　Redistributions in binary form must reproduce the above copyright
　　notice, this list of conditions and the following disclaimer in
　　the documentation and/or other materials provided with the
　　distribution.
　　Neither the name of the SHIROUZU Hiroaki nor the names of its
　　contributors may be used to endorse or promote products derived
　　from this software without specific prior written permission. 
　　THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
　　"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
　　LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
　　FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
　　COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
　　INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
　　BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
　　LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
　　CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
　　LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
　　ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
　　POSSIBILITY OF SUCH DAMAGE.
　　-------------------------------------------------- ------------------------------
　　3. 系统要求
　　Microsoft Windows 95/98/Me/NT4.0/2000/XP/2003
　　95/98/NT4.0 ... 要求 comctl32.dll(公共控件) 的版本为 5.x 或更高.
　　(如果你安装的 IE 是 5.x 或更高版本, 那么就不必担心这个问题了)
　　注意: Windows 3.1(和 NT3.5x), 请使用 IP Messenger for Win16.
　　-------------------------------------------------- ------------------------------
　　4. 使用说明
　　执行 setup.exe 你可以将 IPMsg 安装到指定目录, 或者重新注册到启动组.
　　如果需要删除 IPMsg, 请先从控制面板中卸载, 再手动删除 IPMsg 目录.
　　左键双击图标, 即可打开发送消息窗口.
　　右键点击图标, 可进入 [服务设置], [离开]等.
　　- 发送消息时, 若勾选了 [封装],  则接收者要先打开信封才能看到消息,
　　如果你还勾选了 [上锁], 则接收者在打开信封时还需要输入密码.
　　(密码是由接收者自己在 [服务设置] 中设置的)
　　- 若要发送文件/文件夹, 可直接将文件/文件夹拖入发送消息窗口
　　或在发送消息窗口上点击右键, 再选择发送文件或发送文件夹
　　- 传送文件/文件夹时, 当接收者还没有保存(下载)文件/文件夹时,
　　若发送者关闭或重启了 IPMsg, 则附带的文件信息将被清除, 
　　接收者将不能继续接收(下载)到此文件.
　　- 用户列表前缀符号说明
　　":" 表示用户处于离开模式.
　　"|" 表示用户使用的不是 2.0 以上版本的 IPMsg,
　　将不支持文件/文件夹的传送, 并且不支持通信数据加密.
　　"|"(短线) 表示只支持文件/文件夹的传送.
　　- 拖动列表表头标题项可改变其顺序, 并可点击右键选择"保存列表顺序"
　　- 在消息输入窗口中, 可使用 Ctrl+Tab 输入制表符 Tab.
　　- 在发送消息窗口上点击右键, 可以进入设置显示优先级, 选择工作组,
　　搜索用户(Ctrl+F), 传送文件, 传送文件夹, 保存列表顺序, 字体设置,
　　窗口大小设置, 固定窗口位置, 列表显示设置.
　　- 在用户名上点击右键, 可设置其显示优先级
　　优先级按由小到大的顺序排序
　　- 通过设置显示优先级, 可将经常联系的用户至于列表顶端, 
　　或者隐藏不需要联系的用户
　　- 在接收消息窗口上点击右键, 可以进入字体设置,
　　窗口大小设置, 固定窗口位置.
　　- 接收消息窗口标题栏中的 "+" 或 "-" 表示通信数据使用了加密算法
　　"+" 表示 RSA/1024 位, blowfish/128 位加密
　　"-" 表示 RSA/512 位, RC2/40 位加密
　　- 如果你收到的消息附带了文件, 将会显示出附件按钮.
　　点击按钮即可保存文件.
　　- 如果需要(通过路由器)连接到广域网, 则需要设置广播地址.
　　详见广域网设置(广播设置)
　　- 其它功能都很容易理解, 你试一试就明白了
　　-------------------------------------------------- ------------------------------
　　5. 相关信息
　　- 所有的设置信息都保存在注册表的以下位置:
　　\\HKEY_CURRENT_USER\Software\HSTools\
　　用户密码以不可逆加密方式存储.
　　************************************************** *****************
　　* 如果你忘记了密码, 可以在注册表中将此键值删除                    *
　　* \\HKEY_CURRENT_USER\Software\HSTools\IPMsgEng\Pass wordStr       * 
　　************************************************** *****************
　　- 本软件使用的默认端口为 2425
　　若仅使用 UDP 协议的端口, 将不能传送文件/文件夹
　　(如果安装了防火墙, 则必须打开相应的 TCP 和 UDP 端口)
　　- 本软件为自由软件, 你可以随意传播, 但源码使用请参见许可协议.
　　- 只有在启动或退出程序, 使用离开模式, 刷新在线用户时 IPMsg 才会进行消息广播.
　　- 本软件由 Microsoft Visual C++ 6.0 编译
　　-------------------------------------------------- ------------------------------
　　6. 广域网设置(广播设置)
　　- 主机号全部为 1 的 IP 地址, 即广播地址
　　例如, 连接到一个 C 类子网(即 24 位网络号, 8 位主机号), IP 地址为
　　aaa.bbb.ccc.ddd, 其广播地址即为: aaa.bbb.ccc.255
　　若对方处于另一个私有子网中, 广播可能无效.
　　- 更多问题, 请参阅相关资料或咨询你的网络管理员.
　　- 若两台主机的连接经过了多个路由器, 请直接指定对方IP地址
　　- 拨号上网用户请勾选 [拨号连接]
　　当刷新在线用户列表时, 列表不会被清空
　　-------------------------------------------------- ------------------------------
　　7. 补充
　　- 启动飞鸽传书前, 你可以指定其运行时使用的端口, 
　　且可以使用不同的端口打开多个窗口. 用法如下：
　　ipmsg.exe 2426 (你可在快捷方式上设置)
　　但是你只能与同时也使用该端口的用户通信.
　　- 所以你尽可选用你喜欢的端口运行本软件.
　　介于 10000 至 60000 可能更安全些.
　　你也可以咨询你的网络管理员.
　　- 如果有多个网卡(IP), 你可以将飞鸽传书与指定的网卡(IP)进行绑定.
　　命令格式如下(你可以在快捷方式上设置):
　　ipmsg.exe [端口] /NIC IP地址
　　例如:
　　C:\>ipmsg.exe /NIC 192.168.10.100
　　- 支持命令方式发送消息
　　命令格式如下：
　　ipmsg.exe [端口] /MSG [/LOG][/SEAL]  
　　例如：
　　C:\>ipmsg.exe /MSG /SEAL localhost Hello.
　　- 操作技巧.
　　1. 隐藏/显示 窗口  Ctrl + D
　　2. 按住 Ctrl 键再点 [刷新] 可保持现有用户, 搜索新上线的用户
　　3. 打开发送/接收消息窗口  Ctrl + Alt + S / R (需要进行详细设置)
　　4. 打开搜索窗口  Ctrl + F
　　5. 接收到多个文件, 保存时可勾选 [全部]
　　-------------------------------------------------- ------------------------------
　　8. 支持  - IPMsg 的技术讨论区是开放的.
　　如果你想订阅相关邮件, 请联系 [e-mail]
　　- 欢迎报告 bug, 以及提出建议
　　- 如果你有任何疑问,请 E-mail 联系.
　　[e-mail]
　　- 发送错误报告, 请务必记录以下信息:
　　软件版本, 操作系统, 故障描述, 以及故障重现方法等.
　　-------------------------------------------------- ------------------------------
　　9. 更新历史
　　ver 1.00 ... 日文版 (1996/08/19)
　　ver 1.31 ... 英文版/日文版 (1997/09/01)
　　ver 2.00 ... 英文版/日文版 (2002/11/19)
　　支持文件/文件夹传送
　　支持通信数据加密
　　ver 2.03 ... Bug 修正 (文件传送引起缓冲溢出)
　　广播设置支持主机地址(FQDN)解析
　　ver 2.04 ... 增加绑定网卡(IP)功能
　　ver 2.05 ... Bug 修正 (2.04版当激活发送/接收消息窗口时,无法注销/关闭系统)
　　ver 2.06 ... 很小的调整
　　-------------------------------------------------- ------------------------------
　　10. 感谢
　　- IPMsg 技术讨论区的所有成员
　　- Mr.Kanazawa (英文信息修正)
　　- 所有报告软件 bug 以及提出建议的朋友.
　　-------------------------------------------------- ------------------------------ Windows for English
　　IP Messenger for Win ver2.06 (103KB) by H.Shirouzu (2004/09/08) 
　　Source code of ipmsg v2.06 (166KB) File/Folder Transfer. (Very fast!)
　　RSA/Blowfish Encryption of communication data.
　　Host name (FQDN) support on Broadcast setup. 
　　Specifying NIC extension. Note: ipmsg v2.00-2.02's file/folder transfer function has a buffer overflow problem.
　　Please upgrade to ipmsg v2.03 or later.  IP Messenger for Win16 ver1.34 (49KB) by H.Shirouzu (98/08/30) 
　　Source code of ipmsg for Win16 ver1.34 r3 (115KB)  -------------------------------------------------- ------------------------------ Windows for Chinese
　　IP Messenger for Win Chinese Language Version translated by A zhi (2003/03/25)  -------------------------------------------------- ------------------------------ Windows for Korean(Hangul)
　　IP Messenger for Win Korean Transllation Version by A Hong Sung-Jae (2004/03/17)  -------------------------------------------------- ------------------------------ Windows for Brazil/Portuguese
　　IP Messenger for Win ver2.03 Brazil/Portuguese Translation Version by Marcelo Goncalves (2003/06/25) 
　　Source code -------------------------------------------------- ------------------------------ Windows for Tagalog
　　IP Messenger for Win ver2.05 Tagalog Translation Version by Virgilio So (2004/09/04) 
　　Source code
　　-------------------------------------------------- ------------------------------ Macintosh
　　IP Messenger for MacOS X by G.Ishiwata (2003/09/10)  Now, Macintosh 9(or earlier) version is only open to public in Japanese Page  -------------------------------------------------- ------------------------------ UNIX
　　X11R6 XIP Messenger by candy (97/09/14) GNOME/GTK+ Gnome IP Messenger by T.Matsumaru (99/09/29) GNOME2 IP Messenger by T.Kato (2008/02/13) -------------------------------------------------- ------------------------------ Java
　　Now, Java version is only open to public in Japanese Page  -------------------------------------------------- ------------------------------ IP Messenger Support Software & Link (98/07/26)
　　IPmsgView Log viewer for Win by J.Tsunoda