⏸ [KEEP-PR] When using Real I/F only.

[ren510dev]

• WARNING：Do not merge this branch

Real I/Fを使用したEchomanを試す場合はこのブランチを使用します

[ren510dev]

🐶 echoman: Simple echo server using Rawsocket

🌱 Overview

• これはTCP/IPの上でClientがパケットを生成してServerへ送信するだけの簡単なツールです
• Serverはsrc/dst L2,L3アドレス, L4ポート番号を入れ替えてデータをechoします（ただし、TypeCodeやCheckSumなどの一部パラメータは再計算する）
• Rawsocketを使用してL2レベル（syscall.ETH_P_IP）でパケットを操作
  • LayersType: LayerTypeEthernet

⚡️ Generating socket descriptors

Socket functions

Used function

args	syscall
Domain	AF_PACKET
Type	SOCK_RAW
Protocols	ETH_P_IP

### 送信ソケットの生成funcetherSendSock(intfIndex*net.Interface) (int, error) {
fd, err:=syscall.Socket(syscall.AF_PACKET, syscall.SOCK_RAW, int(htons(syscall.ETH_P_IP)))
iferr!=nil {
return-1, err
}
addr:= syscall.SockaddrLinklayer{
Protocol: htons(syscall.ETH_P_ALL),
Ifindex: intfIndex.Index,
}
iferr:=syscall.Bind(fd, &addr); err!=nil {
return-1, err
}
returnfd, nil
}
### 受信ソケットの生成funcetherRecvSock(intfIndex*net.Interface) (int, error) {
fd, err:=syscall.Socket(syscall.AF_PACKET, syscall.SOCK_RAW, int(htons(syscall.ETH_P_IP)))
iferr!=nil {
return-1, err
}
addr:= syscall.SockaddrLinklayer{
Protocol: htons(syscall.ETH_P_ALL),
Ifindex: intfIndex.Index,
}
iferr:=syscall.Bind(fd, &addr); err!=nil {
return-1, err
}
// Received in promiscuous modeiferr:=syscall.SetLsfPromisc(intfIndex.Name, true); err!=nil {
return-1, err
}
returnfd, nil
}
### Ethernetパケット（L2~）の送信funcSendEtherPacket(fdint, b []byte) error {
if_, err:=syscall.Write(fd, b); err!=nil {
returnerr
}
returnnil
}

🤝 Requirement

• ⚠️WARNING：https://docs.docker.com/desktop/previous-versions/3.x-mac/#new-9

First version of docker compose (as an alternative to the existing docker-compose). Supports some basic commands but not the complete functionality of docker-compose yet.

Languages / Frameworks	Version
Golang	1.19.1
Docker Desktop	4.12.0
docker	20.10.17
docker-compose	1.29.2

🚀 Usage

### envをコピー
$ cp server/.env{.sample,}
$ cp client/.env{.sample,}
### .envの中身を環境に合わせて書き換える
※注意: Docker networkではMACアドレスはランダムに生成されます
### docker-composeを起動
$ make up
### 実行
---
### 1枚目のTerminal: Echoman server を起動
$ make exec/server
# make run### 2枚目のTerminal: Echoman client を起動
$ make exec/client
# make run
---
### Echoman clientはデフォルトでUDPを喋ります
-> .env を編集することで生成するパケットタイプを切り替える
PACKET_TYPE=[パケットタイプ]

PacketType	Env Value
ICMPv4	ICMPV4
UDPv4	UDPV4

📖 Default Information

Device	Information
Echoman Server IPv4 address	10.0.3.95
Echoman Server Port number	30005
Echoman Client IPv4 address	10.0.3.96
Echoman Client Port number	30006

📚 References

• RFC 792
• RFC 768
• Checksum計算