4f31bd9340
This commit beefs up the Makefile to do the build, instead of the Rakefile. It also removes from the Rakefile the dependency on rake_utils, which should mean it's ok to build in a schroot. The files are reorganised to make the Makefile rules more tractable, although the reorganisation reveals a problem with our current code organisation. The problem is that the proxy-specific code transitively depends on the server code via flexnbd.h, which has a circular dependency on the server and client structs. This should be broken in a future commit by separating the flexnbd struct into a shared config struct and server-specific parts, so that the server code can be moved into src/server to more accurately show the functional dependencies.
102 lines
2.6 KiB
C
102 lines
2.6 KiB
C
#ifndef STATUS_H
|
|
#define STATUS_H
|
|
|
|
|
|
/* Status reports
|
|
*
|
|
* The status will be reported by writing to a file descriptor. The
|
|
* status report will be on a single line. The status format will be:
|
|
*
|
|
* A=B C=D
|
|
*
|
|
* That is, a space-separated list of label,value pairs, each pair
|
|
* separated by an '=' character. Neither ' ' nor '=' will appear in
|
|
* either labels or values.
|
|
*
|
|
* Boolean values will appear as the strings "true" and "false".
|
|
*
|
|
* The following status fields are defined:
|
|
*
|
|
* pid:
|
|
* The current process ID.
|
|
*
|
|
* size:
|
|
* The size of the backing file being served, in bytes.
|
|
*
|
|
* has_control:
|
|
* This will be false when the server is listening for an incoming
|
|
* migration. It will switch to true when the end-of-migration
|
|
* handshake is successfully completed.
|
|
* If the server is started in "serve" mode, this will never be
|
|
* false.
|
|
*
|
|
* clients_allowed:
|
|
* This will be false if the server is not currently allowing new
|
|
* connections, for instance, if we're in the migration endgame.
|
|
*
|
|
* num_clients:
|
|
* This tells us how many clients are currently running. If we're in the
|
|
* migration endgame, it should be 0
|
|
*
|
|
* is_migrating:
|
|
* This will be false when the server is started in either "listen"
|
|
* or "serve" mode. It will become true when a server in "serve"
|
|
* mode starts a migration, and will become false again when the
|
|
* migration terminates, successfully or not.
|
|
* If the server is currently in "listen" mode, this will never be
|
|
* true.
|
|
*
|
|
*
|
|
* If is_migrating is true, then a number of other attributes may appear,
|
|
* relating to the progress of the migration.
|
|
*
|
|
* migration_duration:
|
|
* How long the migration has been running for, in ms.
|
|
*
|
|
* migration_speed:
|
|
* Network transfer speed, in bytes/second. This only takes dirty bytes
|
|
* into account.
|
|
*
|
|
* migration_speed_limit:
|
|
* If set, the speed we're going to try to limit the migration to.
|
|
*
|
|
* migration_seconds_left:
|
|
* Our current best estimate of how many seconds are left before the migration
|
|
* migration is finished.
|
|
*
|
|
*/
|
|
|
|
|
|
#include "serve.h"
|
|
|
|
#include <sys/types.h>
|
|
#include <unistd.h>
|
|
|
|
struct status {
|
|
pid_t pid;
|
|
uint64_t size;
|
|
int has_control;
|
|
int clients_allowed;
|
|
int num_clients;
|
|
int is_mirroring;
|
|
|
|
uint64_t migration_duration;
|
|
uint64_t migration_speed;
|
|
uint64_t migration_speed_limit;
|
|
uint64_t migration_seconds_left;
|
|
};
|
|
|
|
/** Create a status object for the given server. */
|
|
struct status * status_create( struct server * );
|
|
|
|
/** Output the given status object to the given file descriptot */
|
|
int status_write( struct status *, int fd );
|
|
|
|
/** Free the status object */
|
|
void status_destroy( struct status * );
|
|
|
|
|
|
|
|
#endif
|
|
|