modules_k/usrloc/dlist.h File Reference

USRLOC - List of registered domains. More...

#include <stdio.h>
#include "../../str.h"
#include "usrloc.h"
#include "udomain.h"
#include "udomain.h"

Include dependency graph for modules_k/usrloc/dlist.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

• struct dlist

  List of all domains registered with usrloc. More...
  

Typedefs

• typedef struct dlist dlist_t

  List of all domains registered with usrloc.
  

Functions

• int find_domain (str *_d, udomain_t **_p)

  Find a particular domain, small wrapper around find_dlist.
  

• void free_all_udomains (void)

  Free all allocated memory for domains.
  

• int get_all_ucontacts (void *buf, int len, unsigned int flags, unsigned int part_idx, unsigned int part_max)

  Get all contacts from the usrloc, in partitions if wanted.
  

• unsigned long get_number_of_users (void)

  Loops through all domains summing up the number of users.
  

• int get_udomain (const char *_n, udomain_t **_d)

  Find and return usrloc domain.
  

• void print_all_udomains (FILE *_f)

  Print all domains, just for debugging.
  

• int register_udomain (const char *_n, udomain_t **_d)

  Registers a new domain with usrloc.
  

• int synchronize_all_udomains (int istart, int istep)

  Run timer handler of all domains.
  

Variables

• dlist_t * root

  Global list of all registered domains.
  

---

Detailed Description

Definition in file modules_k/usrloc/dlist.h.

---

Function Documentation

int find_domain	(	str *	_d,
		udomain_t **	_p
	)

Parameters:

	_d	domain name
	_p	pointer to domain if found

Returns:

1 if domain was found, 0 otherwise

Definition at line 633 of file modules_k/usrloc/dlist.c.

References dlist::d, and find_dlist().

Here is the call graph for this function:

int get_all_ucontacts	(	void *	buf,
		int	len,
		unsigned int	flags,
		unsigned int	part_idx,
		unsigned int	part_max
	)

Return list of all contacts for all currently registered users in all domains. The caller must provide buffer of sufficient length for fitting all those contacts. In the case when buffer was exhausted, the function returns estimated amount of additional space needed, in this case the caller is expected to repeat the call using this value as the hint.

Information is packed into the buffer as follows:

+------------+----------+-----+------+-----+ |contact1.len|contact1.s|sock1|flags1|path1| +------------+----------+-----+------+-----+ |contact2.len|contact2.s|sock2|flags2|path1| +------------+----------+-----+------+-----+ |..........................................| +------------+----------+-----+------+-----+ |contactN.len|contactN.s|sockN|flagsN|pathN| +------------+----------+-----+------+-----+ |000000000000| +------------+

Parameters:

	buf	target buffer
	len	length of buffer
	flags	contact flags
	part_idx	part index
	part_max	maximal part

Returns:

0 on success, positive if buffer size was not sufficient, negative on failure

Definition at line 162 of file modules_k/p_usrloc/dlist.c.

References db_mode, DB_ONLY, get_all_db_ucontacts(), and get_all_mem_ucontacts().

Here is the call graph for this function:

unsigned long get_number_of_users

(

void

)

Returns:

the number of users, could be zero

Definition at line 154 of file modules_k/p_usrloc/dlist.c.

References dlist::d, dlist::next, and udomain::users.

int get_udomain	(	const char *	_n,
		udomain_t **	_d
	)

Parameters:

	_n	domain name
	_d	usrloc domain (location table)

Returns:

0 on success, -1 on failure

Find and return usrloc domain.

Find and return a usrloc domain (location table)

Parameters:

	_n	domain name
	_d	usrloc domain

Returns:

0 on success, -1 on failure

Definition at line 462 of file modules_k/usrloc/dlist.c.

References dlist::d, find_dlist(), _str::len, and _str::s.

Here is the call graph for this function:

void print_all_udomains

(

FILE *

_f

)

Parameters:

_f

output file

Definition at line 567 of file modules_k/usrloc/dlist.c.

References dlist::d, dlist::next, and print_udomain().

Here is the call graph for this function:

int register_udomain	(	const char *	_n,
		udomain_t **	_d
	)

Registers a new domain with usrloc. If the domain exists, a pointer to existing structure will be returned, otherwise a new domain will be created

Parameters:

	_n	domain name
	_d	new created domain

Returns:

0 on success, -1 on failure

Definition at line 124 of file modules_k/p_usrloc/dlist.c.

References find_dlist(), _str::len, and _str::s.

Here is the call graph for this function:

int synchronize_all_udomains	(	int	istart,
		int	istep
	)

Returns:

0 if all timer return 0, != 0 otherwise

Definition at line 608 of file modules_k/usrloc/dlist.c.

References dlist::d, db_mode, DB_ONLY, db_timer_udomain(), get_act_time(), mem_timer_udomain(), and dlist::next.

Here is the call graph for this function: