Skip to content

Commit b58af1f

Browse files
mumumumumumu
committed
[reference/sockets] sync with en
1 parent ef6a727 commit b58af1f

File tree

2 files changed

+179
-6
lines changed

2 files changed

+179
-6
lines changed

‎reference/sockets/constants.xml‎

Lines changed: 171 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: cbf8c6363038ffd8cccbb8151bff68993d71a3e2 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 42402941bba0208a919e03e1320ca4732330eafa Maintainer: takagi Status: ready -->
44
<appendix xml:id="sockets.constants" xmlns="http://docbook.org/ns/docbook">
55
&reftitle.constants;
66
&extension.constants;
@@ -106,6 +106,54 @@
106106
</simpara>
107107
</listitem>
108108
</varlistentry>
109+
<varlistentry xml:id="constant.sock-conn-dgram">
110+
<term>
111+
<constant>SOCK_CONN_DGRAM</constant>
112+
(<type>int</type>)
113+
</term>
114+
<listitem>
115+
<simpara>
116+
コネクション志向のデータグラムをソケットに設定します。
117+
PHP 8.4.0 以降で利用可能(NetBSD のみ)
118+
</simpara>
119+
</listitem>
120+
</varlistentry>
121+
<varlistentry xml:id="constant.sock-dccp">
122+
<term>
123+
<constant>SOCK_DCCP</constant>
124+
(<type>int</type>)
125+
</term>
126+
<listitem>
127+
<simpara>
128+
データグラム輻輳制御プロトコルをソケットに設定します。
129+
PHP 8.4.0 以降で利用可能(NetBSD のみ)
130+
</simpara>
131+
</listitem>
132+
</varlistentry>
133+
<varlistentry xml:id="constant.sock-nonblock">
134+
<term>
135+
<constant>SOCK_NONBLOCK</constant>
136+
(<type>int</type>)
137+
</term>
138+
<listitem>
139+
<simpara>
140+
ノンブロッキング状態フラグを設定します。
141+
PHP 8.4.0 以降で利用可能(NetBSD のみ)
142+
</simpara>
143+
</listitem>
144+
</varlistentry>
145+
<varlistentry xml:id="constant.sock-cloexec">
146+
<term>
147+
<constant>SOCK_CLOEXEC</constant>
148+
(<type>int</type>)
149+
</term>
150+
<listitem>
151+
<simpara>
152+
close-on-exec ソケット状態フラグを設定します。
153+
PHP 8.4.0 以降で利用可能(NetBSD のみ)
154+
</simpara>
155+
</listitem>
156+
</varlistentry>
109157
<varlistentry xml:id="constant.msg-oob">
110158
<term>
111159
<constant>MSG_OOB</constant>
@@ -714,6 +762,18 @@
714762
</simpara>
715763
</listitem>
716764
</varlistentry>
765+
<varlistentry xml:id="constant.tcp-syncnt">
766+
<term>
767+
<constant>TCP_SYNCNT</constant>
768+
(<type>int</type>)
769+
</term>
770+
<listitem>
771+
<simpara>
772+
TCP が接続試行を中止する前に、送信すべき SYN 再送信の回数を設定します。
773+
PHP 8.4.0 以降で利用可能(Linux のみ)。
774+
</simpara>
775+
</listitem>
776+
</varlistentry>
717777
<varlistentry xml:id="constant.ip-dontfrag">
718778
<term>
719779
<constant>IP_DONTFRAG</constant>
@@ -2762,6 +2822,55 @@
27622822
</simpara>
27632823
</listitem>
27642824
</varlistentry>
2825+
<varlistentry xml:id="constant.ip-portrange">
2826+
<term>
2827+
<constant>IP_PORTRANGE</constant>
2828+
(<type>int</type>)
2829+
</term>
2830+
<listitem>
2831+
<simpara>
2832+
ローカルのポート番号を選択する用途に使われる、
2833+
ポートの範囲を設定します。
2834+
PHP 8.4.0 以降で利用可能(FreeBSD/NetBSD/OpenBSD のみ)。
2835+
</simpara>
2836+
</listitem>
2837+
</varlistentry>
2838+
<varlistentry xml:id="constant.ip-portrange-default">
2839+
<term>
2840+
<constant>IP_PORTRANGE_DEFAULT</constant>
2841+
(<type>int</type>)
2842+
</term>
2843+
<listitem>
2844+
<simpara>
2845+
デフォルトのポートの範囲を設定します。
2846+
PHP 8.4.0 以降で利用可能(FreeBSD/NetBSD/OpenBSD のみ)。
2847+
</simpara>
2848+
</listitem>
2849+
</varlistentry>
2850+
<varlistentry xml:id="constant.ip-portrange-high">
2851+
<term>
2852+
<constant>IP_PORTRANGE_HIGH</constant>
2853+
(<type>int</type>)
2854+
</term>
2855+
<listitem>
2856+
<simpara>
2857+
高い範囲のポートを使います。
2858+
PHP 8.4.0 以降で利用可能(FreeBSD/NetBSD/OpenBSD のみ)。
2859+
</simpara>
2860+
</listitem>
2861+
</varlistentry>
2862+
<varlistentry xml:id="constant.ip-portrange-low">
2863+
<term>
2864+
<constant>IP_PORTRANGE_LOW</constant>
2865+
(<type>int</type>)
2866+
</term>
2867+
<listitem>
2868+
<simpara>
2869+
低い範囲のポートを使います。
2870+
PHP 8.4.0 以降で利用可能(FreeBSD/NetBSD/OpenBSD のみ)。
2871+
</simpara>
2872+
</listitem>
2873+
</varlistentry>
27652874
<varlistentry xml:id="constant.mcast-block-source">
27662875
<term>
27672876
<constant>MCAST_BLOCK_SOURCE</constant>
@@ -3002,6 +3111,67 @@
30023111
</simpara>
30033112
</listitem>
30043113
</varlistentry>
3114+
<varlistentry xml:id="constant.so-exclusiveaddruse">
3115+
<term>
3116+
<constant>SO_EXCLUSIVEADDRUSE</constant>
3117+
(<type>int</type>)
3118+
</term>
3119+
<listitem>
3120+
<simpara>
3121+
他のソケットが同じアドレスとポートに強制的にバインドされるのを防ぎます。
3122+
PHP 8.4.0 以降で利用可能(Windows のみ)。
3123+
</simpara>
3124+
</listitem>
3125+
</varlistentry>
3126+
<varlistentry xml:id="constant.so-exclbind">
3127+
<term>
3128+
<constant>SO_EXCLBIND</constant>
3129+
(<type>int</type>)
3130+
</term>
3131+
<listitem>
3132+
<simpara>
3133+
ソケットの排他的なバインディングを有効/無効にします。
3134+
PHP 8.4.0 以降で利用可能(Solaris のみ)。
3135+
</simpara>
3136+
</listitem>
3137+
</varlistentry>
3138+
<varlistentry xml:id="constant.so-nosigpipe">
3139+
<term>
3140+
<constant>SO_NOSIGPIPE</constant>
3141+
(<type>int</type>)
3142+
</term>
3143+
<listitem>
3144+
<simpara>
3145+
ソケットが SIGPIPE を生成するかどうかを制御します。
3146+
PHP 8.4.0 以降で利用可能(macOS と FreeBSD のみ)。
3147+
</simpara>
3148+
</listitem>
3149+
</varlistentry>
3150+
<varlistentry xml:id="constant.so-linger-sec">
3151+
<term>
3152+
<constant>SO_LINGER_SEC</constant>
3153+
(<type>int</type>)
3154+
</term>
3155+
<listitem>
3156+
<simpara>
3157+
<constant>SO_LINGER</constant> に似ていますが、
3158+
macOs の time clicks とは対象的に、秒単位で設定します。
3159+
PHP 8.4.0 以降で利用可能(macOS のみ)。
3160+
</simpara>
3161+
</listitem>
3162+
</varlistentry>
3163+
<varlistentry xml:id="constant.so-bindtoifindex">
3164+
<term>
3165+
<constant>SO_BINDTOIFINDEX</constant>
3166+
(<type>int</type>)
3167+
</term>
3168+
<listitem>
3169+
<simpara>
3170+
特定のネットワークインターフェイスに、インデックスでソケットをバインドします。
3171+
PHP 8.4.0 以降で利用可能。
3172+
</simpara>
3173+
</listitem>
3174+
</varlistentry>
30053175
</variablelist>
30063176

30073177
</appendix>

‎reference/sockets/functions/socket-write.xml‎

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 14dc7c47365f2b71f6c907a5ba5bccf42534d5a9 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 2ca1058473429d338de6eb773f268fc18a71d2f9 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi -->
55
<refentry xml:id="function.socket-write" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -48,7 +48,7 @@
4848
<para>
4949
オプションのパラメータ <parameter>length</parameter> で、
5050
ソケットに書き込むバイト数を指定することが可能です。
51-
この値がバッファの長さより大きい場合、自動的にバッファのサイズに切り詰められます。
51+
この値が <parameter>data</parameter> より大きい場合、自動的に <parameter>data</parameter> のサイズに切り詰められます。
5252
</para>
5353
</listitem>
5454
</varlistentry>
@@ -101,10 +101,13 @@
101101
&reftitle.notes;
102102
<note>
103103
<para>
104-
<function>socket_write</function> は、バッファの内容を必ずしもすべて
104+
<function>socket_write</function> は、<parameter>data</parameter> の内容を必ずしもすべて
105105
書き込むとは限りません。ネットワークバッファの状態にもよりますが、
106-
たとえ 1 バイトだけ書き込まれたのであったとしても、それはエラーではなく正常な動作です。
107-
そのため、データがすべて書き込まれたのかどうかに注意する必要があります。
106+
ある量のデータだけ、たとえば 1 バイトだけ書き込まれたのであったとしても、
107+
そして <parameter>data</parameter> のサイズがそれより大きかったとしても、
108+
それはエラーではなく正常な動作です。
109+
そのため、<parameter>data</parameter> の残りが転送されたことを保証するには、
110+
ループを使う必要があります。
108111
</para>
109112
</note>
110113
</refsect1>

0 commit comments

Comments
 (0)