Date: Fri, 22 Jun 2001 16:03:09 -0500 (CDT) From: "G. Adam Stanislav" <adam@whizkidtech.net> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/28352: Typos in Sockets Message-ID: <200106222103.f5ML39l00778@whizkidtech.net>
next in thread | raw e-mail | index | archive | help
>Number: 28352
>Category: docs
>Synopsis: Typos in my Sockets chapter
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Fri Jun 22 14:10:01 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator: G. Adam Stanislav
>Release: FreeBSD 4.3-20010525-STABLE i386
>Organization:
>Environment:
System: FreeBSD whizkidtech.net 4.3-20010525-STABLE FreeBSD 4.3-20010525-STABLE #0: Fri May 25 12:00:06 GMT 2001 root@usw3.freebsd.org:/usr/src/sys/compile/GENERIC i386
I really hate this damn machine,
I wish they would sell it.
It never does just what I want:
It only does what I tell it!
>Description:
I'm just correcting some typos in my Sockets chapter of the Developers'
Handbook, plus adding a few minor clarifications.
The file is in doc/en_US.ISO8859-1/books/developers/handbook/sockets/ .
>How-To-Repeat:
>Fix:
--- chapter.sgml.orig Fri Jun 22 03:49:11 2001
+++ chapter.sgml Fri Jun 22 15:52:37 2001
@@ -56,7 +56,7 @@
your head sideways meant <emphasis>yes</emphasis>. Quickly, I
started nodding my head up and down. The vendor noticed, took
his almonds, and walked away. To an uninformed observer, I did
- not changed the body language: I continued using the language of
+ not change the body language: I continued using the language of
shaking and nodding my head. What changed was the
<emphasis>meaning</emphasis> of the body language. At first, the
vendor and I interpreted the same language as having completely
@@ -335,7 +335,7 @@
</sect1>
- <sect1 id="sockets-essetial-functions">
+ <sect1 id="sockets-essential-functions">
<title>Essential Socket Functions</title>
<para>While FreeBSD offers different functions to work with
@@ -377,7 +377,7 @@
<para>Use <constant>PF_INET</constant> for
<acronym>UDP</acronym>, <acronym>TCP</acronym> and other
- Internet protocols.</para>
+ Internet protocols (<acronym>IP</acronym>v4).</para>
<para>Five values are defined for the
<varname>type</varname> argument, again, in
@@ -385,11 +385,14 @@
<quote><constant>SOCK_</constant></quote>. The most
common one is <constant>SOCK_STREAM</constant>, which
tells the system you are asking for a <emphasis>reliable
- stream delivery service</emphasis>.</para>
+ stream delivery service</emphasis> (which is
+ <acronym>TCP</acronym> when used with
+ <constant>PF_INET</constant>).</para>
<para>If you asked for <constant>SOCK_DGRAM</constant>, you
would be requesting a <emphasis>connectionless datagram
- delivery service</emphasis>.</para>
+ delivery service</emphasis> (in our case,
+ <acronym>UDP</acronym>).</para>
<para>If you wanted to be in charge of the low-level
protocols (such as <acronym>IP</acronym>), or even network
@@ -710,7 +713,7 @@
usually do not know whether it stores data <emphasis>most
significant byte</emphasis> (<acronym>MSB</acronym>) or
<emphasis>least significant byte</emphasis>
- (<acronym>LSB</acronym>) byte first.</para>
+ (<acronym>LSB</acronym>) first.</para>
<para>You might be wondering, <emphasis><quote>So, will
sockets not handle it for me?</quote></emphasis></para>
@@ -1271,7 +1274,7 @@
successfully, we are ready to become a
<emphasis>daemon</emphasis>: We use
<function>fork</function> to create a child process. In
- both, the parent and the child the <varname>s</varname>
+ both, the parent and the child, the <varname>s</varname>
variable is our socket. The parent process will not need
it, so it calls <function>close</function>, then it
returns <constant>0</constant> to inform its own parent it
@@ -1395,7 +1398,7 @@
<para>Now, go ahead, save the above source code as
<filename>daytimed.c</filename> (it is customary to end
the names of daemons with the letter
- <constant>d</constant>. After you have compiled it, try
+ <constant>d</constant>). After you have compiled it, try
running it:</para>
<screen>
@@ -1466,7 +1469,7 @@
whizkid ttyp0 Jun 19 16:59 (216.127.220.143)
xxx ttyp1 Jun 19 16:06 (xx.xx.xx.xx)
-&prompt.user; <userinput>telnet 216.127.220.107 13</userinput>
+&prompt.user; <userinput>telnet 216.127.220.143 13</userinput>
Trying 216.127.220.143...
Connected to r47.bfm.org.
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200106222103.f5ML39l00778>