Added documentation.
This commit is contained in:
parent
6f98136102
commit
b375439f2a
3
.gitignore
vendored
3
.gitignore
vendored
@ -2,5 +2,8 @@
|
|||||||
build/*
|
build/*
|
||||||
!build/.keep
|
!build/.keep
|
||||||
|
|
||||||
|
# Ignore documentation
|
||||||
|
doc/*
|
||||||
|
|
||||||
# Ignore Vim temprary files
|
# Ignore Vim temprary files
|
||||||
*.sw[a-z]
|
*.sw[a-z]
|
||||||
|
@ -18,7 +18,3 @@
|
|||||||
*/
|
*/
|
||||||
|
|
||||||
#pragma once
|
#pragma once
|
||||||
|
|
||||||
int NeoComm_connect_all_nodes();
|
|
||||||
|
|
||||||
int NeoComm_disconnect();
|
|
||||||
|
@ -21,6 +21,11 @@
|
|||||||
|
|
||||||
#include "nodes.h"
|
#include "nodes.h"
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @file neocomm.h
|
||||||
|
* @brief Automated functions that manage the entire NeoComm framework.
|
||||||
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Initializes all modules of the NeoComm framework.
|
* @brief Initializes all modules of the NeoComm framework.
|
||||||
*
|
*
|
||||||
|
@ -19,10 +19,16 @@
|
|||||||
|
|
||||||
#pragma once
|
#pragma once
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @file nodes.h
|
||||||
|
* @brief Management of nodes.
|
||||||
|
* @details These functions are used to manage the global list of nodes.
|
||||||
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Simple address structure providing IP/DNS and port information.
|
* @brief Simple address structure providing IP/DNS and port information.
|
||||||
*/
|
*/
|
||||||
struct address {
|
struct NeoComm_address {
|
||||||
char *address; ///< IP/DNS string.
|
char *address; ///< IP/DNS string.
|
||||||
unsigned short port; ///< Port of address.
|
unsigned short port; ///< Port of address.
|
||||||
};
|
};
|
||||||
@ -30,9 +36,9 @@ struct address {
|
|||||||
/**
|
/**
|
||||||
* @brief Structure used for NeoComm nodes.
|
* @brief Structure used for NeoComm nodes.
|
||||||
*/
|
*/
|
||||||
struct node {
|
struct NeoComm_node {
|
||||||
/// The address of the node.
|
/// The address of the node.
|
||||||
struct address address;
|
struct NeoComm_address address;
|
||||||
/// Whether or not it is a directory node/server.
|
/// Whether or not it is a directory node/server.
|
||||||
int directory;
|
int directory;
|
||||||
/// Number of connections a directory has.
|
/// Number of connections a directory has.
|
||||||
@ -91,7 +97,7 @@ unsigned int NeoComm_get_node_count();
|
|||||||
* @return If the list is full then it will return NULL, else it will return
|
* @return If the list is full then it will return NULL, else it will return
|
||||||
* a pointer to the new (or old, if already existing) node.
|
* a pointer to the new (or old, if already existing) node.
|
||||||
*/
|
*/
|
||||||
struct node *NeoComm_add_node(struct address addr);
|
struct NeoComm_node *NeoComm_add_node(struct NeoComm_address addr);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Remove a node from the list.
|
* @brief Remove a node from the list.
|
||||||
@ -100,7 +106,7 @@ struct node *NeoComm_add_node(struct address addr);
|
|||||||
*
|
*
|
||||||
* @return If the node was not found it returns 0, else it returns 1.
|
* @return If the node was not found it returns 0, else it returns 1.
|
||||||
*/
|
*/
|
||||||
int NeoComm_remove_node(struct address addr);
|
int NeoComm_remove_node(struct NeoComm_address addr);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Get a pointer to the node with a given address.
|
* @brief Get a pointer to the node with a given address.
|
||||||
@ -109,4 +115,4 @@ int NeoComm_remove_node(struct address addr);
|
|||||||
*
|
*
|
||||||
* @return A modifiable pointer to the node or NULL if not found.
|
* @return A modifiable pointer to the node or NULL if not found.
|
||||||
*/
|
*/
|
||||||
struct node *NeoComm_get_node(struct address addr);
|
struct NeoComm_node *NeoComm_get_node(struct NeoComm_address addr);
|
||||||
|
@ -22,7 +22,7 @@
|
|||||||
#include "nodes.h"
|
#include "nodes.h"
|
||||||
|
|
||||||
// List of nodes
|
// List of nodes
|
||||||
extern struct node *node_list;
|
extern struct NeoComm_node *node_list;
|
||||||
// Maximum number of nodes
|
// Maximum number of nodes
|
||||||
extern unsigned int node_max;
|
extern unsigned int node_max;
|
||||||
// Number of nodes in the list
|
// Number of nodes in the list
|
||||||
|
11
src/nodes.c
11
src/nodes.c
@ -28,7 +28,7 @@
|
|||||||
int NeoComm_init_nodes(unsigned int max_nodes) {
|
int NeoComm_init_nodes(unsigned int max_nodes) {
|
||||||
if(max_nodes == 0)
|
if(max_nodes == 0)
|
||||||
return 1;
|
return 1;
|
||||||
node_list = calloc(max_nodes, sizeof(struct node));
|
node_list = calloc(max_nodes, sizeof(struct NeoComm_node));
|
||||||
if(!node_list)
|
if(!node_list)
|
||||||
return 0;
|
return 0;
|
||||||
|
|
||||||
@ -53,7 +53,8 @@ int NeoComm_resize_node_list(unsigned int new_max_nodes) {
|
|||||||
if(new_max_nodes <= node_max)
|
if(new_max_nodes <= node_max)
|
||||||
return 0;
|
return 0;
|
||||||
|
|
||||||
void* tmp_list = realloc(node_list, new_max_nodes * sizeof(struct node));
|
void* tmp_list =
|
||||||
|
realloc(node_list, new_max_nodes * sizeof(struct NeoComm_node));
|
||||||
if(!tmp_list)
|
if(!tmp_list)
|
||||||
return 0;
|
return 0;
|
||||||
|
|
||||||
@ -70,7 +71,7 @@ unsigned int NeoComm_get_node_count() {
|
|||||||
return node_count;
|
return node_count;
|
||||||
}
|
}
|
||||||
|
|
||||||
struct node *NeoComm_add_node(struct address addr) {
|
struct NeoComm_node *NeoComm_add_node(struct NeoComm_address addr) {
|
||||||
assert(node_list);
|
assert(node_list);
|
||||||
if(node_count >= node_max)
|
if(node_count >= node_max)
|
||||||
return NULL;
|
return NULL;
|
||||||
@ -97,7 +98,7 @@ struct node *NeoComm_add_node(struct address addr) {
|
|||||||
return NULL;
|
return NULL;
|
||||||
}
|
}
|
||||||
|
|
||||||
int NeoComm_remove_node(struct address addr) {
|
int NeoComm_remove_node(struct NeoComm_address addr) {
|
||||||
assert(node_list);
|
assert(node_list);
|
||||||
int removed = 0;
|
int removed = 0;
|
||||||
for(unsigned int i = 0; i < node_max; ++i)
|
for(unsigned int i = 0; i < node_max; ++i)
|
||||||
@ -117,7 +118,7 @@ int NeoComm_remove_node(struct address addr) {
|
|||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
struct node *NeoComm_get_node(struct address addr) {
|
struct NeoComm_node *NeoComm_get_node(struct NeoComm_address addr) {
|
||||||
assert(node_list);
|
assert(node_list);
|
||||||
for(unsigned int i = 0; i < node_max; ++i)
|
for(unsigned int i = 0; i < node_max; ++i)
|
||||||
{
|
{
|
||||||
|
Loading…
Reference in New Issue
Block a user