<2010年1月>
272829303112
3456789
10111213141516
17181920212223
24252627282930
31123456

统计

  • 随笔 - 21
  • 文章 - 0
  • 评论 - 2
  • 引用 - 0

常用链接

留言簿

随笔分类

随笔档案

搜索

  •  

最新评论

阅读排行榜

评论排行榜

飞鸽协议以及其使用的UDP数据包格式和文件传输逻辑

Original ipmsg protocol specification is written in Japanese.

This document was translated by Mr.Kanazawa.

This document is not verified yet.

 

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

        IP Messenger communication protocol (Draft-9)    1996/02/21

                                                Modified 2003/01/14

 

                                                       H.Shirouzu

                                               shirouzu@h.email.ne.jp

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

 

About IP Messenger

         This is a Send/Receive message service using the TCP/UDP Port.

 

Characteristics

         IP Messenger can be installed in any OS if TCP/IP is used on your machine.

         Dynamic member recognition can be done within your network or specified network.

         You can exchange messages between all IPMsg members.

 

Function description

         Use TCP/UDP port(default:2425). See the following descriptions

         (Message Send/Receive: UDP, File Send/Receive: TCP)

 

  1. Command

 

     1) Command functions (Low 8 bits from command number 32 bits)

 

         IPMSG_NOOPERATION   No Operation

         IPMSG_BR_ENTRY           Entry to service (Start-up with a Broadcast command)

         IPMSG_BR_EXIT                Exit from service (End with a Broadcast command)

         IPMSG_ANSENTRY           Notify a new entry

         IPMSG_BR_ABSENCE      Change absence mode

 

         IPMSG_BR_ISGETLIST     Search valid sending host members

         IPMSG_OKGETLIST           Host list sending notice

         IPMSG_GETLIST                Host list sending request

         IPMSG_ANSLIST                Host list sending

 

         IPMSG_SENDMSG            Message transmission

         IPMSG_RECVMSG            Message receiving check

 

         IPMSG_READMSG            Message open notice

         IPMSG_DELMSG               Message discarded notice

         IPMSG_ANSREADMSG    Message open confirmation notice(added from version-8)

 

         IPMSG_GETFILEDATA      File Transfer request by TCP

         IPMSG_RELEASEFILES      Discard attachment file

         IPMSG_GETDIRFILES       Attachment hierarchical file request

 

         IPMSG_GETINFO               Get IPMSG version info.

         IPMSG_SENDINFO            Send IPMSG version info.

 

         IPMSG_GETABSENCEINFO       Get absence sentence

         IPMSG_SENDABSENCEINFO    Send absence sentence

 

         IPMSG_GETPUBKEY                  RSA Public Key Acquisition

         IPMSG_ANSPUBKEY                  RSA Public Key Response

 

     2) Option flag (High 24 bits from command number 32 bits)

 

         IPMSG_ABSENCEOPT      Absence mode(Member recognition command)

         IPMSG_SERVEROPT                   Server(Reserved)

         IPMSG_DIALUPOPT                   Send individual member recognition command

 

         IPMSG_SENDCHECKOPT Transmission check

         IPMSG_SECRETOPT                   Sealed message

         IPMSG_READCHECKOPT Sealed message check(added from ver8)

         IPMSG_PASSWORDOPT   Lock

         IPMSG_BROADCASTOPT          Broadcast message

         IPMSG_MULTICASTOPT  Multi-cast(Multiple casts selection)

         IPMSG_NEWMUTIOPT    New version multi-cast(reserved)

         IPMSG_AUTORETOPT      Automatic response(Ping-pong protection)

         IPMSG_NOLOGOPT          No log files

         IPMSG_NOADDLISTOPT  Notice to the members outside of BR_ENTRY

 

         IPMSG_FILEATTACHOPT File attachment

         IPMSG_ENCRYPTOPT      Code

 

         IPMSG_NOPOPUPOPT     (No longer valid)

         IPMSG_RETRYOPT            Re-send flag(Use when acquiring HOSTLIST)

 

     3) Extended code flag (hex format combination)

 

         IPMSG_RSA_512

         IPMSG_RSA_1024

         IPMSG_RSA_2048

         IPMSG_RC2_40

         IPMSG_RC2_128

         IPMSG_RC2_256

         IPMSG_BLOWFISH_128

         IPMSG_BLOWFISH_256

         IPMSG_SIGN_MD5

 

     4) Extended files for attachment (fileattr low 8 bits)

 

         IPMSG_FILE_REGULAR

         IPMSG_FILE_DIR

         IPMSG_FILE_RETPARENT

         IPMSG_FILE_SYMLINK

         IPMSG_FILE_CDEV

         IPMSG_FILE_BDEV

         IPMSG_FILE_FIFO

         IPMSG_FILE_RESFORK

 

     5) Attachment file extended attribute(fileattr high 24 bits)

 

         IPMSG_FILE_RONLYOPT

         IPMSG_FILE_HIDDENOPT

         IPMSG_FILE_EXHIDDENOPT

         IPMSG_FILE_ARCHIVEOPT

         IPMSG_FILE_SYSTEMOPT

 

     6) Extended file attribute for attachment file

 

         IPMSG_FILE_UID

         IPMSG_FILE_USERNAME

         IPMSG_FILE_GID

         IPMSG_FILE_GROUPNAME

         IPMSG_FILE_PERM

         IPMSG_FILE_MAJORNO

         IPMSG_FILE_MINORNO

         IPMSG_FILE_CTIME

         IPMSG_FILE_MTIME

         IPMSG_FILE_ATIME

         IPMSG_FILE_CREATETIME

 

         IPMSG_FILE_CREATOR

         IPMSG_FILE_FILETYPE

         IPMSG_FILE_FINDERINFO

 

         IPMSG_FILE_ACL

         IPMSG_FILE_ALIASFNAME

         IPMSG_FILE_UNICODEFNAME

 

 

  2.Command format(Use all character strings)

 

     1) Command(Format version-1)

 

         Ver(1) : PacketNo : SenderName : SenderHost : CommandNo : AdditionalSection

 

     2) An example for Message Send/Receive by using the current command format

 

         "1:100:shirouzu:jupiter:32:Hello"

 

 

  3.Command process overview

 

     1) Member recognition

 

         An IPMSG_BR_ENTRY command notifies a new entry to the current

         members at start-up.

 

         All members add the new member to their list after getting a notification message.

         An IPMSG_ANSENTRY command sends a message back to the new member.

 

         The new member gets the current member data by a

         IPMSG_ANSENTRY command. All members can communicate as long as an

         IP packet exists.

 

         An IPMSG_BR_ABSENCE command broadcasts absence mode cancel or

         nickname change to all members. However, an IPMSG_ANSENTRY command

         does not send a message back, which is different from an IPMSG_BR_ENTRY

         command.

 

         IPMSG_BR_ENTRY, IPMSG_ANSENTRY, and IPMSG_BR_ABSENCE commands

         use an IPMSG_ABSENCEOPT flag for absence mode. Input a nickname to

         additional command.

         Add an IPMSG_DIALUPOPT flag for dial-up users who can't be reached by

         a broadcast command.  A member recognition command needs to be

         sent individually to the members with this optional flag.

 

         (Extended group)IPMSG_BR_ENTRY and IPMSG_BR_ABSENCE commands

         sends a group name by adding the new group name after the current

         command format character strings (Input '\0' between the current

         command and extended name).

 

     2) Send/Receive Message

         Send Message uses an IPMSG_SENDMSG command that can input a message

         in the extended area.

         Receive Message sends back an IPMSG_RECVMSG command only

         if an IPMSG_SENDCHECKOPT flag is ON. Input the original packet number

         to the extended area.

 

         Broadcast Message Send uses an IPMSG_BOADCASTOPT command

         and an IPMSG_SENDMSG flag should be ON.

         Auto-Send packet(absence notice) needs to be added to IPMSG_AUTORETOPT

         for ping-pong protection. If either one or another packet is ON, then

         confirmation/auto-send packet is not sent back.

 

         Send Message Sealing needs to be an IPMSG_SECRETOPT packet ON.

         In this case, Receive Message sends an IPMSG_READMSG command.

         Input the original packet number to the extended area.

 

         (Additional IPMSG_NOADDLISTOPT)

         When receiving an IPMSG_SENDMSG packet from a host that is

         not on your Send/Receive list, IPMsg will either confirm a host by

         sending an IPMSG_BR_ENTRY command or add a host name to

         the Send/Receive list.

         However, single-shot Message Send/Receive action needs to be avoided.

         Add an IPMSG_NOADDLISTOPT flag to an IPMSG_SENDMSG command.

 

         (Additional IPMSG_READCHECKOPT from version-8)

         When an IPMSG_READMSG command contains an IPMSG_READCHECKOPT flag,

         IPMsg process is the same as IPMSG_SENDMSG with an

         IPMSG_SENDCHECKOPT flag.

         However, Send Message uses an IPMSG_ANSREADMSG command, 

         not IPMSG_RECVMSG.

 

     3) Message Send/Receive encrypted extension (Added in the version-9)

 

         Use the combination of Public-key(RSA) and common key(RC2/Blowfish).

         (Encrypted extension area is used in hex format.)

 

         (Public key acquisition)Send an IPMSG_GETPUBKEY command to Receive

         Message. Receive Message gets an IPMSG_ANSPUBKEY that

         means receiving RSA public key from Send Message.

 

         IPMSG_GETPUBKEY/IPMSG_ANSPUBKEY both require the value which is

         encryption capability (Exp. IPMSG_RSA_1024) flag uses "OR" at first

         part of extension 

 

         In addition, In IPMSG_ANSPUBKEY, public key written as EE-NNNNNN

         E=ExponentN=method)devide by ':'. and Input the Fdelimiter '-'

         between E and N.

 

         This sequence can be skipped after the 2nd Send/Receive process by

         memorizing public key and encrypted data.

        

         (Encrypted message)After a sender creates a common key that is

         supported both sender and receiver, a common key can encrypt a message.

         In addition, a receiver's public key encrypts the common key.

 

 

         (Encrypted message transmission) IPMSG_ENCRYPTOPT is used in

         IPMSG_SENDMSG. At the first part of extension, input the value which

         is 'or' resoult from Convination of public key and common key type .

         Then use common key which encrypt with public key devide by ':'.

         Then input message which is eccrypted by public key devide by ':'.

         If both supports IPMSG_SIGN_XXX, then add ':' and signeture.

 

         Also, In the method of encode padding, PKCS#1ECB key is used for RSA,

         PKCS#5 CBC common key is used for RC2/blowfish.

 

         Also, The Packet related to Entry manifestation the capability of

         ecryption support using  IPMSG_ENCRYPTOPT

 

     4) Extension with file attachment(Available from version-9)

 

         An IPMSG_SENDMSG command with an IPMSG_FILEATTACHOPT flag for

         File transfer (download permission)notification sends a message

         with attachment.

         Input '\0' after the message and attachment file data.

        

 

         fileID:filename:size:mtime:fileattr[:extend-attr=val1

         [,val2...][:extend-attr2=...]]:\a:fileID...

         (size, mtime, and fileattr describe hex format.

          If a filename contains ':', please replace with "::".)

 

         When Receive Message downloads an attachment file, an IPMSG_GETFILEDATA

         command requests a data transmission packet to the TCP port that is the same number 

         as the UDP sending port number. Input packetID:fileID:offset to the extended area.

         (Use all hex format.)

         File Transfer side receives the request. After recognizing that it's a correct request,

         then send the specified data (no format)

 

         When the data receiving side downloads a hierarchical attachment file,

         use an IPMSG_GETDIRFILES command and input a packetID:fileID

         to the extended area and send a data transmission request packet.

         (all hex format)

 

         Data sending side sends the following hierarchical data format.

         header-size:filename:file-size:fileattr[:extend-attr=val1

         [,val2...][:extend-attr2=...]]:contents-data

         Next headersize: Next filename...

         (All hex format except for filename and contetns-data)

 

         header-size is from the beginning of header-size to the delimiter ':'

         that is before contents-data. extend-attr can be omitted and used multiple

         extended attributes. Use '=' for data input.

 

         When fileattr is IPMSG_FILE_DIR, IPMsg recognizes that it is automatically

         in the directory, the next file data is after the directory.

 

         When fileattr is IPMSG_FILE_RETPARENT, IMPsg recognizes that it returns

         to the parent directory. In this case, File name is always "." and the attribute

         value is the current directory data.

 

         Sending process starts from the attachment directly and returns the

         IPMSG_FILE_RETPARENT command to the attachment directory.

 

         Add an IPMSG_FILEATTACHOPT flag for an Entry packet to support the

         attachment file.

 

     5) Other commands

 

         When acquiring different versions, send an IPMSG_GETINFO command.

         Receiving side sends the version information character string to

         extended area.

 

         Send an IPMSG_GETABSENCEINFO command for acquiring an absence message.

         Receiving side sends an IPMSG_SENDABSENCEINFO back if the status is absence mode.

         If the status is not absence mode, a character string "Not absence mode" will be sent back.

 

     6) Confirmation/Retry

 

         If a confirmation packet for IPMSG_SENDMSG or IPMSG_RECVMSG is not delivered

         within a specified time, then it will be sent again.

         A number of retry actions or interval period is depended on the current condition.

 

 

  4. Other

 

     1) Linefeed

 

         Linefeed characters in Send Message is standardized with UNIX type ('0x0a').

         Please change if needed.

 

     2) Delimiter ':'

 

         ':' is used as a delimiter. You can't use this delimiter for user name

         and host name.

         If the use/host names contain a ':', please replace with another sign,

         for an example ';'.

         Although using this delimiter isn't problem as yet, I may create an

         escape sequence.

        

 

     3) Kanji codes

 

         SJIS

 

 

  5. Contact e-mail address

 

         E-Mail shirouzu@h.email.ne.jp

 

 

Note

         See ipmsg.h for command codes.

         Please e-mail me your comments and suggestions.

 

 

 

Ipmsg里面UDP使用的数据包是下面msgMng的结构组成

msgMng数据包格式:

1 程序版本号

2数据包序列号

3用户名

4主机名5

5命令

6消息内容

7 额外数据

 

15的内容是以“:”为分隔符,消息和额外数据以数据“0“分隔

 

 

 

发送文件的整个逻辑过程:

 

1发送端发送一个UDP数据包,通知接收端准备接收文件,通知在一个socket上监听TCP连接事件

 

2 接收端回发一个UDP数据包,告诉发送端已准备好接收数据,并请求一个TCP的连接

 

3发送端接收连接的请求,并将文件映射到内存中,然后创建发送文件线程,开始进行数据的发送

 

4接收端创建接收的文件,然后创建接收数据的线程,开始收取数据.接受完以后,将数据写入到创建好的文件中.

posted on 2010-01-11 15:23 ChinaPanda 阅读(1954) 评论(0)  编辑 收藏 引用 所属分类: network


只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理