handbook/boot: fix internal xrefs

[ziaee]

Summary

Internal crossreferences in the FreeBSD handbook using crossref: are currently broken on PDF output. The official docs [0] say to use <<here-is-the-xref>>. Most xrefs are already written in that notation, they are clean and work great. Update the rest of the remaining xrefs in this chapter to this notation.

[0] : https://docs.asciidoctor.org/asciidoc/latest/macros/xref/

Related bug : https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=266107

Similar fix for bsdinstall : https://reviews.freebsd.org/D46262
Similar fix for audit : https://reviews.freebsd.org/D46261
Similar fix for basics : https://reviews.freebsd.org/D46260
Similar fix for advanced networking : https://reviews.freebsd.org/D46258

Test Plan

Building in en/{html,pdf}, and testing links.

[fernape]

See https://reviews.freebsd.org/D46266#inline-277720 before working on this

[ziaee]

Closing: overcome by events: Fernape fixed the internal macro in D46480!

[ziaee]

Closing: overcome by events: Fernape fixed the internal macro in D46480!

documentation/content/en/books/handbook/boot/_index.adoc

 #endif  /* _KERNEL || _WANT_TCPCB */
 
 #ifdef _KERNEL
 struct tcptemp {
         u_char        tt_ipgen[40]; /* the size must be of max ip header, now IPv6 */
         struct  tcphdr tt_t;
 };
 
+/* SACK scoreboard update status */
+typedef enum {
+        SACK_NOCHANGE = 0,
+        SACK_CHANGE,
+        SACK_NEWLOSS
+} sackstatus_t;
+
 /* Enable TCP/UDP tunneling port */
 #define TCP_TUNNELING_PORT_MIN          0
 #define TCP_TUNNELING_PORT_MAX          65535
 #define TCP_TUNNELING_PORT_DEFAULT      0
 
 /* Enable TCP/UDP tunneling port */
 #define TCP_TUNNELING_OVERHEAD_MIN      sizeof(struct udphdr)
 #define TCP_TUNNELING_OVERHEAD_MAX      1024

 VNET_DECLARE(int, tcp_sc_rst_sock_fail);
 VNET_DECLARE(int, tcp_sendspace);
 VNET_DECLARE(int, tcp_udp_tunneling_overhead);
 VNET_DECLARE(int, tcp_udp_tunneling_port);
 VNET_DECLARE(struct inpcbinfo, tcbinfo);
 
 #define V_tcp_do_lrd                    VNET(tcp_do_lrd)
 #define V_tcp_do_prr                    VNET(tcp_do_prr)
-#define V_tcp_do_prr_conservative       VNET(tcp_do_prr_conservative)
 #define V_tcp_do_newcwv                 VNET(tcp_do_newcwv)
 #define V_drop_synfin                   VNET(drop_synfin)
 #define V_path_mtu_discovery            VNET(path_mtu_discovery)
 #define V_tcbinfo                       VNET(tcbinfo)
 #define V_tcp_abc_l_var                 VNET(tcp_abc_l_var)
 #define V_tcp_autorcvbuf_max            VNET(tcp_autorcvbuf_max)
 #define V_tcp_autosndbuf_inc            VNET(tcp_autosndbuf_inc)
 #define V_tcp_autosndbuf_max            VNET(tcp_autosndbuf_max)

 void          cc_after_idle(struct tcpcb *tp);
 
 extern        struct protosw tcp_protosw;                /* shared for TOE */
 extern        struct protosw tcp6_protosw;                /* shared for TOE */
 
 uint32_t tcp_new_ts_offset(struct in_conninfo *);
 tcp_seq         tcp_new_isn(struct in_conninfo *);
 
-int         tcp_sack_doack(struct tcpcb *, struct tcpopt *, tcp_seq);
+sackstatus_t
+         tcp_sack_doack(struct tcpcb *, struct tcpopt *, tcp_seq);
 int         tcp_dsack_block_exists(struct tcpcb *);
 void         tcp_update_dsack_list(struct tcpcb *, tcp_seq, tcp_seq);
 void         tcp_update_sack_list(struct tcpcb *tp, tcp_seq rcv_laststart, tcp_seq rcv_lastend);
 void         tcp_clean_dsack_blocks(struct tcpcb *tp);
 void         tcp_clean_sackreport(struct tcpcb *tp);
 void         tcp_sack_adjust(struct tcpcb *tp);
 struct sackhole *tcp_sack_output(struct tcpcb *tp, int *sack_bytes_rexmt);
-void         tcp_do_prr_ack(struct tcpcb *, struct tcphdr *, struct tcpopt *);
+void         tcp_do_prr_ack(struct tcpcb *, struct tcphdr *, struct tcpopt *, sackstatus_t);
 void         tcp_lost_retransmission(struct tcpcb *, struct tcphdr *);
 void         tcp_sack_partialack(struct tcpcb *, struct tcphdr *);
 void         tcp_free_sackholes(struct tcpcb *tp);
 void         tcp_sack_lost_retransmission(struct tcpcb *, struct tcphdr *);
 int         tcp_newreno(struct tcpcb *, struct tcphdr *);
 int         tcp_compute_pipe(struct tcpcb *);
 uint32_t tcp_compute_initwnd(uint32_t);
 void         tcp_sndbuf_autoscale(struct tcpcb *, struct socket *, uint32_t);