'\" t
.\" Title: ne_set_session_flag
.\" Author:
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 04/17/2025
.\" Manual: neon API reference
.\" Source: neon
.\" Language: English
.\"
.TH "NE_SET_SESSION_FLAG" "3" "04/17/2025" "neon" "neon API reference"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ne_set_session_flag, ne_get_session_flag \- set and retrieve session flags
.SH "SYNOPSIS"
.sp
.ft B
.nf
#include
.fi
.ft
.HP \w'void\ ne_set_session_flag('u
.BI "void ne_set_session_flag(ne_session\ *" "sess" ", ne_session_flag\ " "flag" ", int\ " "value" ");"
.HP \w'int\ ne_get_session_flag('u
.BI "int ne_get_session_flag(ne_session\ *" "sess" ", ne_session_flag\ " "flag" ");"
.SH "DESCRIPTION"
.PP
The
\fBne_set_session_flag\fR
function enables or disables a session flag\&. Passing a non\-zero
\fIvalue\fR
argument enables the flag, and zero disables it\&.
.PP
The following flags are defined:
.PP
\fBNE_SESSFLAG_PERSIST\fR (default on)
.RS 4
disable this flag to prevent use of persistent connections
.RE
.PP
\fBNE_SESSFLAG_ICYPROTO\fR (default off)
.RS 4
enable this flag to enable support for non\-HTTP ShoutCast\-style "ICY" responses
.RE
.PP
\fBNE_SESSFLAG_SSLv2\fR
.RS 4
this flag is ignored
.RE
.PP
\fBNE_SESSFLAG_RFC4918\fR (default off)
.RS 4
enable this flag to enable support for RFC4918\-only WebDAV features; losing backwards\-compatibility with RFC2518 servers
.RE
.PP
\fBNE_SESSFLAG_CONNAUTH\fR (default off)
.RS 4
enable this flag if an RFC\-violating connection\-based HTTP authentication scheme is in use
.RE
.PP
\fBNE_SESSFLAG_TLS_SNI\fR (default on)
.RS 4
disable this flag if a server is used which does not correctly support the TLS SNI extension
.RE
.PP
\fBNE_SESSFLAG_EXPECT100\fR (default off)
.RS 4
enable this flag to enable the request flag
\fBNE_REQFLAG_EXPECT100\fR
for new requests
.RE
.PP
\fBNE_SESSFLAG_SHAREPOINT\fR (default off)
.RS 4
enable this flag to use various workarounds to improve interoperability with SharePoint
.RE
.PP
\fBNE_SESSFLAG_STRICT\fR (default on)
.RS 4
disable this flag to parse HTTP/1\&.1 messages without strict requirements introduced in RFC 7230 and later
.RE
.SH "RETURN VALUE"
.PP
The
\fBne_get_session_flag\fR
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\&.
.SH "SEE ALSO"
.PP
ne_session_create,
ne_set_request_flag\&.
.SH "COPYRIGHT"
.br
Copyright \(co 2001-2024 Joe Orton
.br