diff options
Diffstat (limited to 'doc/ref/sessflags.xml')
-rw-r--r-- | doc/ref/sessflags.xml | 104 |
1 files changed, 104 insertions, 0 deletions
diff --git a/doc/ref/sessflags.xml b/doc/ref/sessflags.xml new file mode 100644 index 0000000..0b8cf3f --- /dev/null +++ b/doc/ref/sessflags.xml @@ -0,0 +1,104 @@ +<refentry id="refsessflags"> + + <refmeta> + <refentrytitle>ne_set_session_flag</refentrytitle> + <manvolnum>3</manvolnum> + </refmeta> + + <refnamediv> + <refname id="ne_set_session_flag">ne_set_session_flag</refname> + <refname id="ne_get_session_flag">ne_get_session_flag</refname> + <refpurpose>set and retrieve session flags</refpurpose> + </refnamediv> + + <refsynopsisdiv> + + <funcsynopsis> + + <funcsynopsisinfo>#include <ne_request.h></funcsynopsisinfo> + + <funcprototype> + <funcdef>void <function>ne_set_session_flag</function></funcdef> + <paramdef>ne_session *<parameter>sess</parameter></paramdef> + <paramdef>ne_session_flag <parameter>flag</parameter></paramdef> + <paramdef>int <parameter>value</parameter></paramdef> + </funcprototype> + + <funcprototype> + <funcdef>int <function>ne_get_session_flag</function></funcdef> + <paramdef>ne_session *<parameter>sess</parameter></paramdef> + <paramdef>ne_session_flag <parameter>flag</parameter></paramdef> + </funcprototype> + + </funcsynopsis> + + </refsynopsisdiv> + + <refsect1> + <title>Description</title> + + <para>The <function>ne_set_session_flag</function> function + enables or disables a session flag. Passing a non-zero + <parameter>value</parameter> argument enables the flag, and zero + disables it.</para> + + <para>The following flags are defined:</para> + + <variablelist> + <varlistentry> + <term><constant>NE_SESSFLAG_PERSIST</constant></term> + <listitem> + <simpara>disable this flag to prevent use of persistent + connections</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><constant>NE_SESSFLAG_ICYPROTO</constant></term> + <listitem> + <simpara>enable this flag to enable support for non-HTTP + ShoutCast-style "ICY" responses</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><constant>NE_SESSFLAG_SSLv2</constant></term> + <listitem> + <simpara>disable this flag to disable support for the SSLv2 + protocol</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><constant>NE_SESSFLAG_RFC4918</constant></term> + <listitem> + <simpara>enable this flag to enable support for + RFC4918-only WebDAV features; losing + backwards-compatibility with RFC2518 servers</simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><constant>NE_SESSFLAG_CONNAUTH</constant></term> + <listitem> + <simpara>enable this flag if an RFC-violating + connection-based HTTP authentication scheme is in + use</simpara> + </listitem> + </varlistentry> + + </variablelist> + </refsect1> + + <refsect1> + <title>Return value</title> + + <para>The <function>ne_get_session_flag</function> function + returns zero if a flag is disabled, less than zero if the flag is + not supported, or greater than zero if the flag is enabled.</para> + </refsect1> + + <refsect1> + <title>See also</title> + + <para><xref linkend="ne_session_create"/>.</para> + + </refsect1> + +</refentry> |