source: networking/netlibs/nghttp2.xml@ e40b2f25

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since e40b2f25 was e40b2f25, checked in by Xi Ruoyao <xry111@…>, 15 months ago

tag, mainly for CA related stuff

  • Property mode set to 100644
File size: 6.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY nghttp2-download-http "https://github.com/nghttp2/nghttp2/releases/download/v&nghttp2-version;/nghttp2-&nghttp2-version;.tar.xz">
8 <!ENTITY nghttp2-download-ftp " ">
9 <!ENTITY nghttp2-md5sum "d9702786d89ec8053a96ab4768a172e4">
10 <!ENTITY nghttp2-size "3.8 MB">
11 <!ENTITY nghttp2-buildsize "21 MB">
12 <!ENTITY nghttp2-time "0.1 SBU">
13]>
14
15<sect1 id="nghttp2" xreflabel="nghttp2-&nghttp2-version;">
16 <?dbhtml filename="nghttp2.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>nghttp2-&nghttp2-version;</title>
23
24 <indexterm zone="nghttp2">
25 <primary sortas="a-nghttp2">nghttp2</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to nghttp2</title>
30
31 <para>
32 <application>nghttp2</application> is an implementation of HTTP/2 and
33 its header compression algorithm, HPACK.
34 </para>
35
36 &lfs110a_checked;
37
38 <bridgehead renderas="sect3">Package Information</bridgehead>
39 <itemizedlist spacing="compact">
40 <listitem>
41 <para>
42 Download (HTTP): <ulink url="&nghttp2-download-http;"/>
43 </para>
44 </listitem>
45 <listitem>
46 <para>
47 Download (FTP): <ulink url="&nghttp2-download-ftp;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download MD5 sum: &nghttp2-md5sum;
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download size: &nghttp2-size;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Estimated disk space required: &nghttp2-buildsize;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated build time: &nghttp2-time;
68 </para>
69 </listitem>
70 </itemizedlist>
71
72 <bridgehead renderas="sect3">nghttp2 Dependencies</bridgehead>
73
74 <bridgehead renderas="sect4">Recommended</bridgehead>
75 <para role="required">
76 <xref linkend="libxml2"/>
77 </para>
78
79 <bridgehead renderas="sect4">Optional</bridgehead>
80 <para role="optional">
81 <xref linkend="boost"/>, <!--required for the C++ asio library)-->
82 <xref linkend="c-ares"/>, <!-- required to build the HPACK tools -->
83 <xref linkend="jansson"/>, <!-- required to build the HPACK tools -->
84 <xref linkend="libevent"/>, <!--required to build the examples-->
85 <!--<xref linkend="python2"/>,--> <!--required for the python bindings)-->
86<!--- <phrase revision="systemd">
87 <xref linkend="setuptools"/>, <!- -(required for the python bindings- ->
88 </phrase> -->
89 <ulink url="http://cunit.sourceforge.net/">CUnit</ulink> (required for
90 the testsuite),
91 <ulink url="http://cython.org/">Cython</ulink>, <!--required for the
92 python bindings-->
93<!-- <ulink url="http://www.digip.org/jansson/">Jansson</ulink>, <!- -required
94 to build the HPACK tools-->
95 <ulink url="http://jemalloc.net/">jemalloc</ulink>,
96 <!--required for the example HTTP server-->
97 <ulink url="http://software.schmorp.de/pkg/libev.html">libev</ulink>,
98 <!--required to build the applications-->
99 <ulink url="https://mruby.org/">mruby</ulink>, <!--provides ruby support
100 in the sample HTTP server-->
101<!-- <phrase revision="sysv">
102 <ulink url="https://pypi.python.org/pypi/setuptools/">Setuptools</ulink>,
103 </phrase> -->
104 <ulink url="https://tatsuhiro-t.github.io/spdylay/">Spdylay</ulink>, and
105 <!--provide SPDY functionality-->
106 <ulink url="http://sphinx-doc.org/">Sphinx</ulink>. <!--required to build
107 documentation-->
108 </para>
109
110 <para condition="html" role="usernotes">
111 User Notes: <ulink url="&blfs-wiki;/nghttp2"/>
112 </para>
113 </sect2>
114
115 <sect2 role="installation">
116 <title>Installation of nghttp2</title>
117
118 <para>
119 Install <application>nghttp2</application> by running the following
120 commands:
121 </para>
122
123<screen><userinput>./configure --prefix=/usr \
124 --disable-static \
125 --enable-lib-only \
126 --docdir=/usr/share/doc/nghttp2-&nghttp2-version; &amp;&amp;
127make</userinput></screen>
128
129 <para>
130 This package does not come with a usable test suite.
131 </para>
132
133 <para>
134 Now, as the <systemitem class="username">root</systemitem> user:
135 </para>
136
137<screen role="root"><userinput>make install</userinput></screen>
138
139 </sect2>
140
141 <sect2 role="commands">
142 <title>Command Explanations</title>
143
144 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
145 href="../../xincludes/static-libraries.xml"/>
146
147 <para>
148 <parameter>--enable-lib-only</parameter>: only build libnghttp2. Omit
149 this switch if you'd like to build the example applications, Python
150 bindings, or the C++ asio library.
151 </para>
152
153 </sect2>
154
155 <sect2 role="content">
156 <title>Contents</title>
157
158 <segmentedlist>
159 <segtitle>Installed Programs</segtitle>
160 <segtitle>Installed Libraries</segtitle>
161 <segtitle>Installed Directories</segtitle>
162
163 <seglistitem>
164 <seg>
165 None
166 </seg>
167 <seg>
168 libnghttp2.so
169 </seg>
170 <seg>
171 /usr/include/nghttp2,
172 /usr/share/nghttp2, and
173 /usr/share/doc/nghttp2-&nghttp2-version;
174 </seg>
175 </seglistitem>
176 </segmentedlist>
177
178 <variablelist>
179 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
180 <?dbfo list-presentation="list"?>
181 <?dbhtml list-presentation="table"?>
182
183 <varlistentry id="libnghttp2">
184 <term><filename class="libraryfile">libnghttp2.so</filename></term>
185 <listitem>
186 <para>
187 an implementation of the Hypertext Transfer Protocol version 2 in C
188 </para>
189 <indexterm zone="nghttp2 libnghttp2">
190 <primary sortas="c-libnghttp2">libnghttp2.so</primary>
191 </indexterm>
192 </listitem>
193 </varlistentry>
194
195 </variablelist>
196
197 </sect2>
198
199</sect1>
Note: See TracBrowser for help on using the repository browser.