mirror of
https://github.com/servalproject/serval-dna.git
synced 2024-12-18 20:57:56 +00:00
83 lines
2.6 KiB
C
83 lines
2.6 KiB
C
/*
|
|
Serval DNA server main loop
|
|
Copyright (C) 2012-2015 Serval Project Inc.
|
|
Copyright (C) 2016 Flinders University
|
|
|
|
This program is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU General Public License
|
|
as published by the Free Software Foundation; either version 2
|
|
of the License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef __SERVAL_DNA__SERVER_H
|
|
#define __SERVAL_DNA__SERVER_H
|
|
|
|
#include "fdqueue.h"
|
|
#include "os.h" // for time_ms_t
|
|
#include "trigger.h"
|
|
|
|
enum server_mode {
|
|
SERVER_NOT_RUNNING = 0,
|
|
SERVER_RUNNING = 1,
|
|
SERVER_CLOSING = 2
|
|
};
|
|
|
|
DECLARE_ALARM(server_shutdown_check);
|
|
DECLARE_ALARM(server_watchdog);
|
|
DECLARE_ALARM(server_config_reload);
|
|
DECLARE_ALARM(rhizome_sync_announce);
|
|
DECLARE_ALARM(fd_periodicstats);
|
|
|
|
extern __thread enum server_mode serverMode;
|
|
|
|
/** Return the PID of the currently running server process, return 0 if there is none.
|
|
*/
|
|
int server_pid();
|
|
|
|
/* Call this method within a server process/thread to initialise the server:
|
|
* - marks the server state as "running" (thread-local variable)
|
|
* - sets up signal handling
|
|
* - calls the "startup" trigger
|
|
* - starts the HTTP server (if enabled)
|
|
* - creates the pidfile
|
|
* - initialises the network packet queues
|
|
* - schedules a periodic stats job
|
|
*/
|
|
int server_bind();
|
|
|
|
/* Call this method within a server process/thread to execute the server main
|
|
* loop. Only returns once the server is shut down.
|
|
*/
|
|
void server_loop(time_ms_t (*waiting)(time_ms_t, time_ms_t, time_ms_t), void (*wokeup)());
|
|
|
|
/* Call this method within a server process/thread to initiate an orderly
|
|
* shut-down of the server. It sets the server state as "closing" so that
|
|
* server_loop() will exit in an orderly fashion.
|
|
*/
|
|
void server_close();
|
|
|
|
/* These functions are called by various server subsystems to populate the
|
|
* "proc" directory, which gives information about the running server, such as:
|
|
* - port numbers
|
|
* - primary identity
|
|
* - etc.
|
|
*/
|
|
int server_write_proc_state(const char *path, const char *fmt, ...);
|
|
int server_unlink_proc_state(const char *path);
|
|
|
|
/* Triggers that are fired during server start-up and shut-down.
|
|
*/
|
|
DECLARE_TRIGGER(startup);
|
|
DECLARE_TRIGGER(shutdown);
|
|
|
|
#endif // __SERVAL_DNA__SERVER_H
|