.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "OVSQLITE-SERVER 8"
.TH OVSQLITE-SERVER 8 2024-05-19 "INN 2.7.4" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
ovsqlite\-server \- Sole owner of the ovsqlite database
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBovsqlite-server\fR [\fB\-d\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The \fBovsqlite-server\fR daemon is the only program that opens the overview
SQLite database.  It accepts connections from the other parts of INN that
want to operate on overview data (\fBinnd\fR, \fBnnrpd\fR, \fBexpireover\fR,
\&\fBmakehistory\fR).
.PP
This daemon must therefore be started before any other process can access the
overview database.  \fBovsqlite-server\fR is normally invoked automatically by
\&\fBrc.news\fR when starting the news system.  It is also stopped automatically by
\&\fBrc.news\fR when stopping the news system.
.PP
In case you need to talk to this daemon from Perl, the binary protocol used to
communicate with it has been implemented in the \f(CW\*(C`INN::ovsqlite_client\*(C'\fR Perl
module.  See its manual page for more information about its possibilities.
.SH OPTIONS
.IX Header "OPTIONS"
.IP \fB\-d\fR 4
.IX Item "-d"
\&\fBovsqlite-server\fR normally puts itself into the background, points
its standard output and error to log files, and disassociates itself
from the terminal.  Using \fB\-d\fR prevents all of this, resulting in log
messages being written to the standard error output; this is generally
useful only for debugging.
.SH FILES
.IX Header "FILES"
.IP \fIpathetc\fR/ovsqlite.conf 4
.IX Item "pathetc/ovsqlite.conf"
The configuration file.  See ovsqlite(5).
.IP \fIpathoverview\fR/ovsqlite.db 4
.IX Item "pathoverview/ovsqlite.db"
The SQLite database file.
.IP \fIpathrun\fR/ovsqlite.pid 4
.IX Item "pathrun/ovsqlite.pid"
Stores the PID of the server process while it's running.
.IP \fIpathrun\fR/ovsqlite.sock 4
.IX Item "pathrun/ovsqlite.sock"
When Unix-domain sockets are available, the server binds its listening
socket to this path.
.IP \fIpathrun\fR/ovsqlite.port 4
.IX Item "pathrun/ovsqlite.port"
When Unix-domain sockets \fIaren't\fR available, the server binds its
listening socket to a dynamic TCP port on the IPv4 loopback interface and
stores the port number in this file.
.SH HISTORY
.IX Header "HISTORY"
Initial implementation of ovsqlite written by Bo Lindbergh
<2bfjdsla52kztwejndzdstsxl9athp@gmail.com> for InterNetNews.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
INN::ovsqlite_client(3pm), ovsqlite(5), rc.news(8).