View | Details | Raw Unified | Return to bug 252519
Collapse All | Expand All

(-)b/en_US.ISO8859-1/books/arch-handbook/boot/chapter.xml (-4 / +4 lines)
Lines 404-410 FreeBSD clang version 3.3 (tags/RELEASE_33/final 183502) 20130610</screen></entr Link Here
404
      jmp main-0x7c00+0x600	# Jump to relocated code</programlisting>
404
      jmp main-0x7c00+0x600	# Jump to relocated code</programlisting>
405
    </figure>
405
    </figure>
406
406
407
    <para>Because <filename>boot0</filename> is loaded by the
407
    <para>As <filename>boot0</filename> is loaded by the
408
      <acronym>BIOS</acronym> to address <literal>0x7C00</literal>, it
408
      <acronym>BIOS</acronym> to address <literal>0x7C00</literal>, it
409
      copies itself to address <literal>0x600</literal> and then
409
      copies itself to address <literal>0x600</literal> and then
410
      transfers control there (recall that it was linked to execute at
410
      transfers control there (recall that it was linked to execute at
Lines 1021-1027 main.3: Link Here
1021
      bytes of <filename>boot</filename> and, because
1021
      bytes of <filename>boot</filename> and, because
1022
      <filename>boot</filename> is written to the first sector of the
1022
      <filename>boot</filename> is written to the first sector of the
1023
      &os; slice, <filename>boot1</filename> fits exactly in this
1023
      &os; slice, <filename>boot1</filename> fits exactly in this
1024
      first sector.  Because <literal>nread</literal> reads the first
1024
      first sector.  When <literal>nread</literal> reads the first
1025
      16 sectors of the &os; slice, it effectively reads the entire
1025
      16 sectors of the &os; slice, it effectively reads the entire
1026
      <filename>boot</filename> file
1026
      <filename>boot</filename> file
1027
      <footnote>
1027
      <footnote>
Lines 1440-1446 init: cli # Disable interrupts Link Here
1440
      flags in the EFLAGS register.  Note that the
1440
      flags in the EFLAGS register.  Note that the
1441
      <literal>popfl</literal> instruction pops out a doubleword (4
1441
      <literal>popfl</literal> instruction pops out a doubleword (4
1442
      bytes) from the stack and places it in the EFLAGS register.
1442
      bytes) from the stack and places it in the EFLAGS register.
1443
      Because the value actually popped is <literal>2</literal>, the
1443
      As the value actually popped is <literal>2</literal>, the
1444
      EFLAGS register is effectively cleared (IA-32 requires that bit
1444
      EFLAGS register is effectively cleared (IA-32 requires that bit
1445
      2 of the EFLAGS register always be 1).</para>
1445
      2 of the EFLAGS register always be 1).</para>
1446
1446
Lines 1583-1589 init.3: lea 0x8(%di),%di # Next entry Link Here
1583
      abstraction.  The IA-32 architecture demands the creation and
1583
      abstraction.  The IA-32 architecture demands the creation and
1584
      use of <emphasis>at least</emphasis> one <acronym>TSS</acronym>
1584
      use of <emphasis>at least</emphasis> one <acronym>TSS</acronym>
1585
      if multitasking facilities are used or different privilege
1585
      if multitasking facilities are used or different privilege
1586
      levels are defined.  Because the <filename>boot2</filename>
1586
      levels are defined.  Since the <filename>boot2</filename>
1587
      client is executed in privilege level 3, but the
1587
      client is executed in privilege level 3, but the
1588
      <acronym>BTX</acronym> server does in privilege level 0, a
1588
      <acronym>BTX</acronym> server does in privilege level 0, a
1589
      <acronym>TSS</acronym> must be defined:</para>
1589
      <acronym>TSS</acronym> must be defined:</para>
(-)b/en_US.ISO8859-1/books/arch-handbook/driverbasics/chapter.xml (-2 / +2 lines)
Lines 397-406 Closing device "echo".</screen> Link Here
397
    <para>For this reason, no serious applications rely on block
397
    <para>For this reason, no serious applications rely on block
398
      devices, and in fact, almost all applications which access
398
      devices, and in fact, almost all applications which access
399
      disks directly take great pains to specify that character
399
      disks directly take great pains to specify that character
400
      (or <quote>raw</quote>) devices should always be used.  Because
400
      (or <quote>raw</quote>) devices should always be used.  As
401
      the implementation of the aliasing of each disk (partition) to
401
      the implementation of the aliasing of each disk (partition) to
402
      two devices with different semantics significantly complicated
402
      two devices with different semantics significantly complicated
403
      the relevant kernel code &os; dropped support for cached disk
403
      the relevant kernel code, &os; dropped support for cached disk
404
      devices as part of the modernization of the disk I/O
404
      devices as part of the modernization of the disk I/O
405
      infrastructure.</para>
405
      infrastructure.</para>
406
  </sect1>
406
  </sect1>
(-)b/en_US.ISO8859-1/books/arch-handbook/isa/chapter.xml (-5 / +5 lines)
Lines 375-381 Link Here
375
        with PnP. This feature is not implemented in any existing
375
        with PnP. This feature is not implemented in any existing
376
        driver and is not considered further in this document.</para>
376
        driver and is not considered further in this document.</para>
377
377
378
      <para>Because the PnP devices are disabled when probing the
378
      <para>As the PnP devices are disabled when probing the
379
        legacy devices they will not be attached twice (once as legacy
379
        legacy devices they will not be attached twice (once as legacy
380
        and once as PnP).  But in case of device-dependent identify
380
        and once as PnP).  But in case of device-dependent identify
381
        routines it is the responsibility of the driver to make sure
381
        routines it is the responsibility of the driver to make sure
Lines 1019-1025 Link Here
1019
              Free the memory allocated by
1019
              Free the memory allocated by
1020
              <function>bus_dmamem_alloc()</function>. At present,
1020
              <function>bus_dmamem_alloc()</function>. At present,
1021
              freeing of the memory allocated with ISA restrictions is
1021
              freeing of the memory allocated with ISA restrictions is
1022
              not implemented.  Because of this the recommended model
1022
              not implemented.  Due to this the recommended model
1023
              of use is to keep and re-use the allocated areas for as
1023
              of use is to keep and re-use the allocated areas for as
1024
              long as possible. Do not lightly free some area and then
1024
              long as possible. Do not lightly free some area and then
1025
              shortly allocate it again. That does not mean that
1025
              shortly allocate it again. That does not mean that
Lines 1322-1332 Link Here
1322
          Before calling the callback function from
1322
          Before calling the callback function from
1323
          <function>bus_dmamap_load()</function> the segment array is
1323
          <function>bus_dmamap_load()</function> the segment array is
1324
          stored in the stack. And it gets pre-allocated for the
1324
          stored in the stack. And it gets pre-allocated for the
1325
          maximal number of segments allowed by the tag. Because of
1325
          maximal number of segments allowed by the tag. As a result of
1326
          this the practical limit for the number of segments on i386
1326
          this the practical limit for the number of segments on i386
1327
          architecture is about 250-300 (the kernel stack is 4KB minus
1327
          architecture is about 250-300 (the kernel stack is 4KB minus
1328
          the size of the user structure, size of a segment array
1328
          the size of the user structure, size of a segment array
1329
          entry is 8 bytes, and some space must be left). Because the
1329
          entry is 8 bytes, and some space must be left). Since the
1330
          array is allocated based on the maximal number this value
1330
          array is allocated based on the maximal number this value
1331
          must not be set higher than really needed. Fortunately, for
1331
          must not be set higher than really needed. Fortunately, for
1332
          most of hardware the maximal supported number of segments is
1332
          most of hardware the maximal supported number of segments is
Lines 2192-2198 Link Here
2192
          int error = 0;</programlisting>
2192
          int error = 0;</programlisting>
2193
2193
2194
        <para>Then allocate and activate all the necessary
2194
        <para>Then allocate and activate all the necessary
2195
          resources. Because normally the port range will be released
2195
          resources. As normally the port range will be released
2196
          before returning from probe, it has to be allocated
2196
          before returning from probe, it has to be allocated
2197
          again. We expect that the probe routine had properly set all
2197
          again. We expect that the probe routine had properly set all
2198
          the resource ranges, as well as saved them in the structure
2198
          the resource ranges, as well as saved them in the structure
(-)b/en_US.ISO8859-1/books/arch-handbook/pccard/chapter.xml (-1 / +1 lines)
Lines 52-58 Link Here
52
      <indexterm><primary>Linksys</primary></indexterm>
52
      <indexterm><primary>Linksys</primary></indexterm>
53
      <indexterm><primary>D-Link</primary></indexterm>
53
      <indexterm><primary>D-Link</primary></indexterm>
54
54
55
      <para>Because of this practice, FreeBSD drivers usually rely on
55
      <para>Due to this practice, FreeBSD drivers usually rely on
56
	numeric IDs for device identification.  Using numeric IDs and
56
	numeric IDs for device identification.  Using numeric IDs and
57
	a centralized database complicates adding IDs and support for
57
	a centralized database complicates adding IDs and support for
58
	cards to the system.  One must carefully check to see who
58
	cards to the system.  One must carefully check to see who
(-)b/en_US.ISO8859-1/books/arch-handbook/scsi/chapter.xml (-4 / +4 lines)
Lines 103-109 Link Here
103
      then also converting the SCSI commands to the native commands of
103
      then also converting the SCSI commands to the native commands of
104
      the hardware).</para>
104
      the hardware).</para>
105
105
106
    <para>Because we are interested in writing a SCSI adapter driver
106
    <para>As we are interested in writing a SCSI adapter driver
107
      here, from this point on we will consider everything from the
107
      here, from this point on we will consider everything from the
108
      SIM standpoint.</para>
108
      SIM standpoint.</para>
109
109
Lines 1076-1082 Link Here
1076
	  the timeout to make sure that the target is not sleeping
1076
	  the timeout to make sure that the target is not sleeping
1077
	  forever.  If the command would not get aborted in some
1077
	  forever.  If the command would not get aborted in some
1078
	  reasonable time like 10 seconds the timeout routine would go
1078
	  reasonable time like 10 seconds the timeout routine would go
1079
	  ahead and reset the whole SCSI bus.  Because the command
1079
	  ahead and reset the whole SCSI bus.  Since the command
1080
	  will be aborted in some reasonable time we can just return
1080
	  will be aborted in some reasonable time we can just return
1081
	  the abort request now as successfully completed, and mark
1081
	  the abort request now as successfully completed, and mark
1082
	  the aborted CCB as aborted (but not mark it as done
1082
	  the aborted CCB as aborted (but not mark it as done
Lines 1116-1122 Link Here
1116
    return;</programlisting>
1116
    return;</programlisting>
1117
1117
1118
	<para>That is all for the ABORT request, although there is one
1118
	<para>That is all for the ABORT request, although there is one
1119
	  more issue.  Because the ABORT message cleans all the
1119
	  more issue.  As the ABORT message cleans all the
1120
	  ongoing transactions on a LUN we have to mark all the other
1120
	  ongoing transactions on a LUN we have to mark all the other
1121
	  active transactions on this LUN as aborted.  That should be
1121
	  active transactions on this LUN as aborted.  That should be
1122
	  done in the interrupt routine, after the transaction gets
1122
	  done in the interrupt routine, after the transaction gets
Lines 1634-1640 Link Here
1634
      routine (or the other way around, the poll routine may be doing
1634
      routine (or the other way around, the poll routine may be doing
1635
      the real action and the interrupt routine would just call the
1635
      the real action and the interrupt routine would just call the
1636
      poll routine).  Why bother about a separate function then?
1636
      poll routine).  Why bother about a separate function then?
1637
      Because of different calling conventions.  The
1637
      Due to different calling conventions.  The
1638
      <function>xxx_poll</function> routine gets the struct cam_sim
1638
      <function>xxx_poll</function> routine gets the struct cam_sim
1639
      pointer as its argument when the PCI interrupt routine by common
1639
      pointer as its argument when the PCI interrupt routine by common
1640
      convention gets pointer to the struct
1640
      convention gets pointer to the struct
(-)b/en_US.ISO8859-1/books/arch-handbook/usb/chapter.xml (-1 / +1 lines)
Lines 668-674 This part is unclear, is it an unformatted code example? Link Here
668
668
669
    <para>Example: Firmware download Many devices that have been
669
    <para>Example: Firmware download Many devices that have been
670
      developed are based on a general purpose processor with an
670
      developed are based on a general purpose processor with an
671
      additional USB core added to it.  Because the development of
671
      additional USB core added to it.  As the development of
672
      drivers and firmware for USB devices is still very new, many
672
      drivers and firmware for USB devices is still very new, many
673
      devices require the downloading of the firmware after they have
673
      devices require the downloading of the firmware after they have
674
      been connected.</para>
674
      been connected.</para>
(-)b/en_US.ISO8859-1/books/developers-handbook/ipv6/chapter.xml (-2 / +2 lines)
Lines 822-834 fe80:2::%ep0/64 link#2 UC ep0</screen> Link Here
822
	  packet processing code in the way BSD IPv4 code is
822
	  packet processing code in the way BSD IPv4 code is
823
	  implemented, kernel stack may overflow due to long function
823
	  implemented, kernel stack may overflow due to long function
824
	  call chain.  sys/netinet6 code is carefully designed to
824
	  call chain.  sys/netinet6 code is carefully designed to
825
	  avoid kernel stack overflow.  Because of this, sys/netinet6
825
	  avoid kernel stack overflow, so sys/netinet6
826
	  code defines its own protocol switch structure, as "struct
826
	  code defines its own protocol switch structure, as "struct
827
	  ip6protosw" (see
827
	  ip6protosw" (see
828
	  <filename>netinet6/ip6protosw.h</filename>).  There is no
828
	  <filename>netinet6/ip6protosw.h</filename>).  There is no
829
	  such update to IPv4 part (sys/netinet) for compatibility,
829
	  such update to IPv4 part (sys/netinet) for compatibility,
830
	  but small change is added to its pr_input() prototype.  So
830
	  but small change is added to its pr_input() prototype.  So
831
	  "struct ipprotosw" is also defined.  Because of this, if you
831
	  "struct ipprotosw" is also defined.  As a result, if you
832
	  receive IPsec-over-IPv4 packet with massive number of IPsec
832
	  receive IPsec-over-IPv4 packet with massive number of IPsec
833
	  headers, kernel stack may blow up.  IPsec-over-IPv6 is okay.
833
	  headers, kernel stack may blow up.  IPsec-over-IPv6 is okay.
834
	  (Off-course, for those all IPsec headers to be processed,
834
	  (Off-course, for those all IPsec headers to be processed,
(-)b/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.xml (-1 / +1 lines)
Lines 679-685 options DIAGNOSTIC</programlisting> Link Here
679
	&man.dcons.4; provides similar functionality as a serial
679
	&man.dcons.4; provides similar functionality as a serial
680
	console.  It emulates two serial ports, one for the console
680
	console.  It emulates two serial ports, one for the console
681
	and <acronym>DDB</acronym>, the other for
681
	and <acronym>DDB</acronym>, the other for
682
	<acronym>GDB</acronym>.  Because remote memory access is fully
682
	<acronym>GDB</acronym>.  Since remote memory access is fully
683
	handled by the hardware, the &man.dcons.4; buffer is
683
	handled by the hardware, the &man.dcons.4; buffer is
684
	accessible even when the system crashes.</para>
684
	accessible even when the system crashes.</para>
685
685
(-)b/en_US.ISO8859-1/books/developers-handbook/secure/chapter.xml (-1 / +1 lines)
Lines 310-316 int main() { Link Here
310
      <indexterm><primary>seteuid</primary></indexterm>
310
      <indexterm><primary>seteuid</primary></indexterm>
311
311
312
      <para>There are at least 6 different IDs associated with any
312
      <para>There are at least 6 different IDs associated with any
313
      given process.  Because of this you have to be very careful with
313
      given process, and you must therefore be very careful with
314
      the access that your process has at any given time.  In
314
      the access that your process has at any given time.  In
315
      particular, all seteuid applications should give up their
315
      particular, all seteuid applications should give up their
316
      privileges as soon as it is no longer required.</para>
316
      privileges as soon as it is no longer required.</para>
(-)b/en_US.ISO8859-1/books/developers-handbook/sockets/chapter.xml (-3 / +3 lines)
Lines 101-107 Link Here
101
      computer at speeds approaching the speed of light, it often
101
      computer at speeds approaching the speed of light, it often
102
      travels considerably slower between two computers.</para>
102
      travels considerably slower between two computers.</para>
103
103
104
    <para>Because the languages used in data communications are so
104
    <para>As the languages used in data communications are so
105
      terse, we usually refer to them as
105
      terse, we usually refer to them as
106
      <emphasis>protocols</emphasis> rather than languages.</para>
106
      <emphasis>protocols</emphasis> rather than languages.</para>
107
107
Lines 337-343 Link Here
337
      extract the <emphasis><acronym>PNG</acronym> file</emphasis>
337
      extract the <emphasis><acronym>PNG</acronym> file</emphasis>
338
      from it.</para>
338
      from it.</para>
339
339
340
    <para>Because of the complexity of internetworking, we cannot just
340
    <para>Due to the complexity of internetworking, we cannot just
341
      use the <function role="syscall">open</function> system call, or
341
      use the <function role="syscall">open</function> system call, or
342
      the <function>open()</function> C function.  Instead, we need to
342
      the <function>open()</function> C function.  Instead, we need to
343
      take several steps to <quote>opening</quote> a socket.</para>
343
      take several steps to <quote>opening</quote> a socket.</para>
Lines 1381-1387 int main() { Link Here
1381
1381
1382
	  <para>Not all protocols are that simple.  Many receive a
1382
	  <para>Not all protocols are that simple.  Many receive a
1383
	    request from the client, reply to it, then receive another
1383
	    request from the client, reply to it, then receive another
1384
	    request from the same client.  Because of that, they do
1384
	    request from the same client.  As a result, they do
1385
	    not know in advance how long they will be serving the
1385
	    not know in advance how long they will be serving the
1386
	    client.  Such servers usually start a new process for each
1386
	    client.  Such servers usually start a new process for each
1387
	    client.  While the new process is serving its client, the
1387
	    client.  While the new process is serving its client, the
(-)b/en_US.ISO8859-1/books/faq/book.xml (-2 / +2 lines)
Lines 2404-2410 kern.timecounter.hardware: TSC -&gt; i8254</screen> Link Here
2404
	    (&man.make.1;, &man.system.3;, &man.popen.3;, and
2404
	    (&man.make.1;, &man.system.3;, &man.popen.3;, and
2405
	    analogues in higher-level scripting languages like Perl
2405
	    analogues in higher-level scripting languages like Perl
2406
	    and Tcl) are specified to use the Bourne shell to
2406
	    and Tcl) are specified to use the Bourne shell to
2407
	    interpret commands.  Because the Bourne shell is so often
2407
	    interpret commands.  As the Bourne shell is so often
2408
	    and widely used, it is important for it to be quick to
2408
	    and widely used, it is important for it to be quick to
2409
	    start, be deterministic in its behavior, and have a small
2409
	    start, be deterministic in its behavior, and have a small
2410
	    memory footprint.</para>
2410
	    memory footprint.</para>
Lines 5037-5043 Key F15 A A Menu Workplace Nop</programlisting> Link Here
5037
	</question>
5037
	</question>
5038
5038
5039
	<answer>
5039
	<answer>
5040
	  <para>Because a packet is coming from outside the network
5040
	  <para>A packet is coming from outside the network
5041
	    unexpectedly.  To disable them, set
5041
	    unexpectedly.  To disable them, set
5042
	    <varname>net.link.ether.inet.log_arp_wrong_iface</varname>
5042
	    <varname>net.link.ether.inet.log_arp_wrong_iface</varname>
5043
	    to <literal>0</literal>.</para>
5043
	    to <literal>0</literal>.</para>
(-)b/en_US.ISO8859-1/books/fdp-primer/manpages/chapter.xml (-1 / +1 lines)
Lines 289-295 information.</programlisting> Link Here
289
	</callout>
289
	</callout>
290
290
291
	<callout arearefs="co-manpages-macro-example-ls-8">
291
	<callout arearefs="co-manpages-macro-example-ls-8">
292
	  <para>A final optional argument is defined.  Because no name
292
	  <para>A final optional argument is defined.  Since no name
293
	    is specified for the argument, the default of
293
	    is specified for the argument, the default of
294
	    <literal>file ...</literal> is used.</para>
294
	    <literal>file ...</literal> is used.</para>
295
	</callout>
295
	</callout>
(-)b/en_US.ISO8859-1/books/fdp-primer/po-translations/chapter.xml (-4 / +4 lines)
Lines 472-478 A pgpkeys</screen> Link Here
472
A         Makefile</screen>
472
A         Makefile</screen>
473
473
474
	  <para>Check the contents of the
474
	  <para>Check the contents of the
475
	    <filename>Makefile</filename>.  Because this is a simple
475
	    <filename>Makefile</filename>.  As this is a simple
476
	    article, in this case the <filename>Makefile</filename>
476
	    article, in this case the <filename>Makefile</filename>
477
	    can be used unchanged.  The <literal>$&os;...$</literal>
477
	    can be used unchanged.  The <literal>$&os;...$</literal>
478
	    version string on the second line will be replaced by the
478
	    version string on the second line will be replaced by the
Lines 744-750 DOC_PREFIX?= ${.CURDIR}/../../.. Link Here
744
744
745
      <procedure>
745
      <procedure>
746
	<step>
746
	<step>
747
	  <para>Build the translated document.  Because the original
747
	  <para>Build the translated document.  As the original
748
	    is a book, the generated document is
748
	    is a book, the generated document is
749
	    <filename>book.xml</filename>.</para>
749
	    <filename>book.xml</filename>.</para>
750
750
Lines 892-899 property 'svn:keywords' set on 'ko_KR.po'</screen> Link Here
892
892
893
	<step>
893
	<step>
894
	  <para>Set the <acronym>MIME</acronym> types of the files.
894
	  <para>Set the <acronym>MIME</acronym> types of the files.
895
	    Because these files use the <acronym>UTF-8</acronym>
895
	    These files use the <acronym>UTF-8</acronym>
896
	    character set, that is also specified.  To prevent the
896
	    character set, so that is also specified.  To prevent the
897
	    version control system from mistaking these files for
897
	    version control system from mistaking these files for
898
	    binary data, the <literal>fbsd:notbinary</literal>
898
	    binary data, the <literal>fbsd:notbinary</literal>
899
	    property is also set:</para>
899
	    property is also set:</para>
(-)b/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml (-2 / +2 lines)
Lines 214-220 Link Here
214
214
215
    <para>A tag is used to identify where a particular element starts,
215
    <para>A tag is used to identify where a particular element starts,
216
      and where the element ends.  <emphasis>The tag is not part of
216
      and where the element ends.  <emphasis>The tag is not part of
217
      the element itself</emphasis>.  Because each grammar was
217
      the element itself</emphasis>.  As each grammar was
218
      normally written to mark up specific types of information, each
218
      normally written to mark up specific types of information, each
219
      one will recognize different elements, and will therefore have
219
      one will recognize different elements, and will therefore have
220
      different names for the tags.</para>
220
      different names for the tags.</para>
Lines 596-602 example.xml:5: element head: validity error : Element head content does not foll Link Here
596
	      council delegated this to the American National
596
	      council delegated this to the American National
597
	      Standards Institute (<acronym>ANSI</acronym>).</para>
597
	      Standards Institute (<acronym>ANSI</acronym>).</para>
598
598
599
	    <para>Because the &os; Project has not been registered,
599
	    <para>Since the &os; Project has not been registered,
600
	      the owner string is <literal>-//&os;</literal>.  As seen
600
	      the owner string is <literal>-//&os;</literal>.  As seen
601
	      in the example, the <acronym>W3C</acronym> are not a
601
	      in the example, the <acronym>W3C</acronym> are not a
602
	      registered owner either.</para>
602
	      registered owner either.</para>
(-)b/en_US.ISO8859-1/books/handbook/basics/chapter.xml (-3 / +3 lines)
Lines 2867-2873 Swap: 2048M Total, 2048M Free Link Here
2867
	</step>
2867
	</step>
2868
2868
2869
	<step>
2869
	<step>
2870
	  <para>Use &man.kill.1; to send the signal.  Because
2870
	  <para>Use &man.kill.1; to send the signal.  As
2871
	    &man.inetd.8; is owned by
2871
	    &man.inetd.8; is owned by
2872
	    <systemitem class="username">root</systemitem>, use
2872
	    <systemitem class="username">root</systemitem>, use
2873
	    &man.su.1; to become
2873
	    &man.su.1; to become
Lines 3218-3225 Swap: 2048M Total, 2048M Free Link Here
3218
      <primary>editors</primary>
3218
      <primary>editors</primary>
3219
    </indexterm>
3219
    </indexterm>
3220
3220
3221
    <para>Most &os; configuration is done by editing text files.
3221
    <para>Most &os; configuration is done by editing text files, so
3222
      Because of this, it is a good idea to become familiar with a
3222
      it is a good idea to become familiar with a
3223
      text editor.  &os; comes with a few as part of the base system,
3223
      text editor.  &os; comes with a few as part of the base system,
3224
      and many more are available in the Ports Collection.</para>
3224
      and many more are available in the Ports Collection.</para>
3225
3225
(-)b/en_US.ISO8859-1/books/handbook/boot/chapter.xml (-1 / +1 lines)
Lines 217-223 Default: F2</screen> Link Here
217
      <title>Stage One and Stage Two</title>
217
      <title>Stage One and Stage Two</title>
218
218
219
      <para>Conceptually, the first and second stages are part of the
219
      <para>Conceptually, the first and second stages are part of the
220
	same program on the same area of the disk.  Because of space
220
	same program on the same area of the disk.  Due to space
221
	constraints, they have been split into two, but are always
221
	constraints, they have been split into two, but are always
222
	installed together.  They are copied from the combined
222
	installed together.  They are copied from the combined
223
	<filename>/boot/boot</filename> by the &os; installer or
223
	<filename>/boot/boot</filename> by the &os; installer or
(-)b/en_US.ISO8859-1/books/handbook/config/chapter.xml (-2 / +2 lines)
Lines 748-754 linuxemu/chapter.xml --> Link Here
748
	  Network Driver Interface Specification
748
	  Network Driver Interface Specification
749
	  (<acronym>NDIS</acronym>).  It includes &man.ndisgen.8;
749
	  (<acronym>NDIS</acronym>).  It includes &man.ndisgen.8;
750
	  which can be used to convert a &windowsxp; driver into a
750
	  which can be used to convert a &windowsxp; driver into a
751
	  format that can be used on &os;.  Because the &man.ndis.4;
751
	  format that can be used on &os;.  As the &man.ndis.4;
752
	  driver uses a &windowsxp; binary, it only runs on &i386;
752
	  driver uses a &windowsxp; binary, it only runs on &i386;
753
	  and amd64 systems.  <acronym>PCI</acronym>, CardBus,
753
	  and amd64 systems.  <acronym>PCI</acronym>, CardBus,
754
	  <acronym>PCMCIA</acronym>, and <acronym>USB</acronym>
754
	  <acronym>PCMCIA</acronym>, and <acronym>USB</acronym>
Lines 2344-2350 device_probe_and_attach: cbb0 attach returned 12</screen> Link Here
2344
	  referred to as <emphasis>journaling</emphasis>.
2344
	  referred to as <emphasis>journaling</emphasis>.
2345
	  Meta-data updates are still written synchronously, but only
2345
	  Meta-data updates are still written synchronously, but only
2346
	  into a small region of the disk.  Later on, they are moved
2346
	  into a small region of the disk.  Later on, they are moved
2347
	  to their proper location.  Because the logging area is a
2347
	  to their proper location.  Since the logging area is a
2348
	  small, contiguous region on the disk, there are no long
2348
	  small, contiguous region on the disk, there are no long
2349
	  distances for the disk heads to move, even during heavy
2349
	  distances for the disk heads to move, even during heavy
2350
	  operations, so these operations are quicker than synchronous
2350
	  operations, so these operations are quicker than synchronous
(-)b/en_US.ISO8859-1/books/handbook/geom/chapter.xml (-4 / +4 lines)
Lines 331-337 Done.</screen> Link Here
331
      <screen>&prompt.root; <userinput>gmirror clear ada8</userinput></screen>
331
      <screen>&prompt.root; <userinput>gmirror clear ada8</userinput></screen>
332
332
333
      <para>&man.gmirror.8; stores one block of metadata at the end of
333
      <para>&man.gmirror.8; stores one block of metadata at the end of
334
	the disk.  Because <acronym>GPT</acronym> partition schemes
334
	the disk.  As <acronym>GPT</acronym> partition schemes
335
	also store metadata at the end of the disk, mirroring entire
335
	also store metadata at the end of the disk, mirroring entire
336
	<acronym>GPT</acronym> disks with &man.gmirror.8; is not
336
	<acronym>GPT</acronym> disks with &man.gmirror.8; is not
337
	recommended.  <acronym>MBR</acronym> partitioning is used here
337
	recommended.  <acronym>MBR</acronym> partitioning is used here
Lines 451-457 Done.</screen> Link Here
451
      <para>Reboot the system to test the new mirror and verify that
451
      <para>Reboot the system to test the new mirror and verify that
452
	all data has been copied.  The <acronym>BIOS</acronym> will
452
	all data has been copied.  The <acronym>BIOS</acronym> will
453
	see the mirror as two individual drives rather than a mirror.
453
	see the mirror as two individual drives rather than a mirror.
454
	Because the drives are identical, it does not matter which is
454
	Since the drives are identical, it does not matter which is
455
	selected to boot.</para>
455
	selected to boot.</para>
456
456
457
      <para>See <xref linkend="gmirror-troubleshooting"/> if there are
457
      <para>See <xref linkend="gmirror-troubleshooting"/> if there are
Lines 1431-1439 ggate0 Link Here
1431
1431
1432
    <para>A better solution is to use <command>glabel</command> to
1432
    <para>A better solution is to use <command>glabel</command> to
1433
      label the disk devices and use the labels in
1433
      label the disk devices and use the labels in
1434
      <filename>/etc/fstab</filename>.  Because
1434
      <filename>/etc/fstab</filename>.
1435
      <command>glabel</command> stores the label in the last sector of
1435
      <command>glabel</command> stores the label in the last sector of
1436
      a given provider, the label will remain persistent across
1436
      a given provider, so the label will remain persistent across
1437
      reboots.  By using this label as a device, the file system may
1437
      reboots.  By using this label as a device, the file system may
1438
      always be mounted regardless of what device node it is accessed
1438
      always be mounted regardless of what device node it is accessed
1439
      through.</para>
1439
      through.</para>
(-)b/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml (-1 / +1 lines)
Lines 839-845 kern.ipc.shmall=32768</programlisting> Link Here
839
	    an <application>&xorg;</application> extension which
839
	    an <application>&xorg;</application> extension which
840
	    allows a program to bypass the
840
	    allows a program to bypass the
841
	    <application>&xorg;</application> server and directly
841
	    <application>&xorg;</application> server and directly
842
	    alter the framebuffer.  Because it relies on a low level
842
	    alter the framebuffer.  As it relies on a low level
843
	    memory mapping, programs using it must be run as
843
	    memory mapping, programs using it must be run as
844
	    <systemitem class="username">root</systemitem>.  The
844
	    <systemitem class="username">root</systemitem>.  The
845
	    <acronym>DGA</acronym> extension can be tested and
845
	    <acronym>DGA</acronym> extension can be tested and
(-)b/en_US.ISO8859-1/books/handbook/security/chapter.xml (-2 / +2 lines)
Lines 696-702 cat changed Link Here
696
      The authentication system keeps track of the last one-time
696
      The authentication system keeps track of the last one-time
697
      password used, and the user is authenticated if the hash of the
697
      password used, and the user is authenticated if the hash of the
698
      user-provided password is equal to the previous password.
698
      user-provided password is equal to the previous password.
699
      Because a one-way hash is used, it is impossible to generate
699
      Since a one-way hash is used, it is impossible to generate
700
      future one-time passwords if a successfully used password is
700
      future one-time passwords if a successfully used password is
701
      captured.  The iteration count is decremented after each
701
      captured.  The iteration count is decremented after each
702
      successful login to keep the user and the login program in sync.
702
      successful login to keep the user and the login program in sync.
Lines 1196-1202 sendmail : PARANOID : deny</programlisting> Link Here
1196
	<quote>trusted third party</quote> of the system.  It is the
1196
	<quote>trusted third party</quote> of the system.  It is the
1197
	computer that issues <application>Kerberos</application>
1197
	computer that issues <application>Kerberos</application>
1198
	tickets, which are used for clients to authenticate to
1198
	tickets, which are used for clients to authenticate to
1199
	servers.  Because the <acronym>KDC</acronym> is considered
1199
	servers.  As the <acronym>KDC</acronym> is considered
1200
	trusted by all other computers in the
1200
	trusted by all other computers in the
1201
	<application>Kerberos</application> realm, it has heightened
1201
	<application>Kerberos</application> realm, it has heightened
1202
	security concerns.  Direct access to the KDC should be
1202
	security concerns.  Direct access to the KDC should be
(-)b/en_US.ISO8859-1/books/handbook/serialcomms/chapter.xml (-2 / +2 lines)
Lines 1031-1037 ttyu5 "/usr/libexec/getty std.19200" vt100 on insecure</programlisting> Link Here
1031
      device provides a 16-character buffer, which allows for better
1031
      device provides a 16-character buffer, which allows for better
1032
      system performance.  Bugs in plain 16550 devices prevent the use
1032
      system performance.  Bugs in plain 16550 devices prevent the use
1033
      of the 16-character buffer, so use 16550A devices if possible.
1033
      of the 16-character buffer, so use 16550A devices if possible.
1034
      Because single-character-buffer devices require more work by the
1034
      As single-character-buffer devices require more work by the
1035
      operating system than the 16-character-buffer devices,
1035
      operating system than the 16-character-buffer devices,
1036
      16550A-based serial interface cards are preferred.  If the
1036
      16550A-based serial interface cards are preferred.  If the
1037
      system has many active serial ports or will have a heavy load,
1037
      system has many active serial ports or will have a heavy load,
Lines 1081-1087 ttyu5 "/usr/libexec/getty std.19200" vt100 on insecure</programlisting> Link Here
1081
1081
1082
      <para>The second method is to configure the
1082
      <para>The second method is to configure the
1083
	<acronym>RS-232</acronym> interface to vary its speed based on
1083
	<acronym>RS-232</acronym> interface to vary its speed based on
1084
	the remote user's connection speed.  Because
1084
	the remote user's connection speed.  As
1085
	<command>getty</command> does not understand any particular
1085
	<command>getty</command> does not understand any particular
1086
	modem's connection speed reporting, it gives a
1086
	modem's connection speed reporting, it gives a
1087
	<prompt>login:</prompt> message at an initial speed and
1087
	<prompt>login:</prompt> message at an initial speed and
(-)b/en_US.ISO8859-1/books/handbook/zfs/chapter.xml (-3 / +3 lines)
Lines 1282-1288 errors: No known data errors</screen> Link Here
1282
	2&nbsp;TB drive.  The usable space is 1&nbsp;TB.  When the
1282
	2&nbsp;TB drive.  The usable space is 1&nbsp;TB.  When the
1283
	1&nbsp;TB drive is replaced with another 2&nbsp;TB drive, the
1283
	1&nbsp;TB drive is replaced with another 2&nbsp;TB drive, the
1284
	resilvering process copies the existing data onto the new
1284
	resilvering process copies the existing data onto the new
1285
	drive.  Because
1285
	drive.  As
1286
	both of the devices now have 2&nbsp;TB capacity, the mirror's
1286
	both of the devices now have 2&nbsp;TB capacity, the mirror's
1287
	available space can be grown to 2&nbsp;TB.</para>
1287
	available space can be grown to 2&nbsp;TB.</para>
1288
1288
Lines 4045-4051 vfs.zfs.vdev.cache.size="5M"</programlisting> Link Here
4045
	      Clones can be <emphasis>promoted</emphasis>, reversing
4045
	      Clones can be <emphasis>promoted</emphasis>, reversing
4046
	      this dependency and making the clone the parent and the
4046
	      this dependency and making the clone the parent and the
4047
	      previous parent the child.  This operation requires no
4047
	      previous parent the child.  This operation requires no
4048
	      additional space.  Because the amount of space used by
4048
	      additional space.  Since the amount of space used by
4049
	      the parent and child is reversed, existing quotas and
4049
	      the parent and child is reversed, existing quotas and
4050
	      reservations might be affected.</entry>
4050
	      reservations might be affected.</entry>
4051
	  </row>
4051
	  </row>
Lines 4201-4207 vfs.zfs.vdev.cache.size="5M"</programlisting> Link Here
4201
	      blocks will be checked byte-for-byte to ensure it is
4201
	      blocks will be checked byte-for-byte to ensure it is
4202
	      actually identical.  If the data is not identical, the
4202
	      actually identical.  If the data is not identical, the
4203
	      hash collision will be noted and the two blocks will be
4203
	      hash collision will be noted and the two blocks will be
4204
	      stored separately.  Because <acronym>DDT</acronym> must
4204
	      stored separately.  As <acronym>DDT</acronym> must
4205
	      store the hash of each unique block, it consumes a very
4205
	      store the hash of each unique block, it consumes a very
4206
	      large amount of memory.  A general rule of thumb is
4206
	      large amount of memory.  A general rule of thumb is
4207
	      5-6&nbsp;GB of ram per 1&nbsp;TB of deduplicated data).
4207
	      5-6&nbsp;GB of ram per 1&nbsp;TB of deduplicated data).

Return to bug 252519