Similarly to processes, Erlang ports allow a lot of introspection. The info can be accessed
by calling erlang:port_info(Port, Key) , and more info is available through the inet
module. Most of it has been regrouped by the recon:port_info/1-2 functions, which
work using a somewhat similar interface to their process-related counterparts.
Meta
id internal index of a port. Of no particular use except to differentiate ports.
name type of the port — with names such as "tcp_inet", "udp_inet", or "efile",
for example.
os_pid if the port is not an inet socket, but rather represents an external process or
program, this value contains the os pid related to the said external program.
**id** : 端口的内部索引。除了用于区分端口外没有其它特殊用途。
**name**: 端口的类型--比如：可以是"tcp_inet","upd_inet"或"efile"。
**os_pid**: 如果端口不是一个inet socket,而是代表一个外部进程或程序，这个值就是来表示他是一个外部程序的os pid。
Signals
connected Each port has a controlling process in charge of it, and this process’ pid
is the connected one.
links ports can be linked with processes, much like other processes can be. The list
of linked processes is contained here. Unless the process has been owned by or
manually linked to a lot of processes, this should be safe to use.
monitors ports that represent external programs can have these programs end up
monitoring Erlang processes. These processes are listed here.
**connected**: 每个端口都被一个控制进程所负责，这个就是控制进程的pid。
**links**: 端口可以link到进程，和其它进程一样的。返回它link的进程列表。在进程linked了很多进程时调用是不安全的。
**monitors**:端口可代表着外部程序，返回这个端口最终被那些Erlang进程监控。
**IO**
**input** the number of bytes read from the port.
**output** the number of bytes written to the port.
**IO**
**input**: 从端口读取的数据大小(bytes)。
**output**: 写入端口的数据大小(bytes)。
**Memory Used**
**memory** this is the memory (in bytes) allocated by the runtime system for the port. This number tends to be small-ish and excludes space allocated by the port itself. **queue_size** Port programs have a specific queue, called the driver queue 24. This return the size of this queue, in bytes.
**Memory Used**
**memory** : 运行时Erlang系统为端口分配的内存大小(bytes)。这个值往往会小于实际值，它忽略了端口自身的分配空间。
**queue_size**: 端口程序有一个特定的队列：叫做dirver queue24。返回这个队列的大小(bytes)。
Type-Specific
Inet Ports Returns inet-specific data, including statistics 25, the local address and
port number for the socket (sockname), and the inet options used 26.
Others currently no other form than inet ports are supported in recon, and an empty
list is returned.
**Inet Ports**: 返回inet-specific数据。包括statistics25：本地地址,sockname的端口数，和inet的使用的选项26。
**Others**:目前还没有其它选项recon可以支持，只返回一个空列表。 The list can be obtained as follows:
可以获取以下类似的列表：
---------------------------------------------------------
1> recon:port_info("#Port<0.818>").
[{meta,[{id,6544},{name,"tcp_inet"},{os_pid,undefined}]},
{signals,[{connected,<0.56.0>},
{links,[<0.56.0>]},
{monitors,[]}]},
{io,[{input,0},{output,0}]},
{memory_used,[{memory,40},{queue_size,0}]},
{type,[{statistics,[{recv_oct,0},
{recv_cnt,0},
{recv_max,0},
{recv_avg,0},
{recv_dvi,...},
{...}|...]},
{peername,{{50,19,218,110},80}},
{sockname,{{97,107,140,172},39337}},
{options,[{active,true},
{broadcast,false},
{buffer,1460},
{delay_send,...},
{...}|...]}]}]
---------------------------------------------------------
On top of this, functions to find out specific problematic ports exist the way they do
for processes. The gotcha is that so far, recon only supports them for inet ports and
with restricted attributes: the number of octets (bytes) sent, received, or both (send_oct, recv_oct, oct, respectively), or the number of packets sent, received, or both (send_cnt, recv_cnt, cnt, respectively).
So for the cumulative total, which can help find out who is slowly but surely eating up
all your bandwidth:
这些数据的累积，可以帮助你找出那一个端口慢并耗尽了你的带宽。
--------------------------------------------------------
2> recon:inet_count(oct, 3).
[{#Port<0.6821166>,15828716661,
[{recv_oct,15828716661},{send_oct,0}]},
{#Port<0.6757848>,15762095249,
[{recv_oct,15762095249},{send_oct,0}]},
{#Port<0.6718690>,15630954707,
[{recv_oct,15630954707},{send_oct,0}]}]
--------------------------------------------------------
Which suggest some ports are doing only input and eating lots of bytes. You can then
use recon:port_info("#Port<0.6821166>") to dig in and find who owns that socket, and
what is going on with it.
Or in any other case, we can look at what is sending the most data within any time
window 27 with the** recon:inet_window(Attribute, Count, Milliseconds)** function:
或者其它情况，我们可以使用窗口27全程查看数据的流向：** recon:inet_window(Attribute, Count, Milliseconds)**
--------------------------------------------------------
3> recon:inet_window(send_oct, 3, 5000).
[{#Port<0.11976746>,2986216,[{send_oct,4421857688}]},
{#Port<0.11704865>,1881957,[{send_oct,1476456967}]},
{#Port<0.12518151>,1214051,[{send_oct,600070031}]}]
--------------------------------------------------------
For this one, the value in the middle of the tuple is what send_oct was worth (or any
chosen attribute for each call) during the specific time interval chosen (5 seconds here).
There is still some manual work involved into properly linking a misbehaving port to a
process (and then possibly to a specific user or customer), but all the tools are in place.
还有一些涉及到link到行为不当的函数的手动工作(可能是一个特定的用户),但所有的工作都在已列这里啦。
[24] The driver queue is available to queue output from the emulator to the driver (data from the driver to the emulator is queued by the emulator in normal Erlang message queues). This can be useful if the driver has to wait for slow devices etc, and wants to yield back to the emulator.
[25] http://www.erlang.org/doc/man/inet.html#getstat-1
[26] http://www.erlang.org/doc/man/inet.html#setopts-2
[27] See the explanations for the recon:proc_window/3 in the preceding subsection
[注25]：http://www.erlang.org/doc/man/inet.html#getstat-1
[注26]：http://www.erlang.org/doc/man/inet.html#setopts-2
[注27]：可以在前面的面容中查看到recon:proc_window/3解释