services.h 15.7 KB
Newer Older
Linus Tolke's avatar
Linus Tolke committed
1
/*
2
 * $Id: services.h,v 0.67 2003/08/16 17:37:44 ceder Exp $
3
 * Copyright (C) 1991-1999, 2001-2002  Lysator Academic Computer Association.
Linus Tolke's avatar
Linus Tolke committed
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
 *
 * This file is part of the LysKOM server.
 * 
 * LysKOM 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 1, or (at your option) 
 * any later version.
 * 
 * LysKOM 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 LysKOM; see the file COPYING.  If not, write to
 * Lysator, c/o ISY, Linkoping University, S-581 83 Linkoping, SWEDEN,
 * or the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, 
 * MA 02139, USA.
 *
Per Cederqvist's avatar
Per Cederqvist committed
23
 * Please report bugs at http://bugzilla.lysator.liu.se/. 
Linus Tolke's avatar
Linus Tolke committed
24
 */
Per Cederqvist's avatar
.  
Per Cederqvist committed
25
26
27
28
/*
 *  services.h  --  All the services the LysKOM server makes available
 *		    for clients.
 *
29
30
 *  These functions match the requests defined in doc/Protocol-A.texi.
 *  See the descriptions in that file for documentation.
Per Cederqvist's avatar
.  
Per Cederqvist committed
31
32
33
34
35
 *
 *  Created by ceder 1990-03-23
 */


36
37
#ifndef  SERVICES_H_ALREADY_INCLUDED
#define  SERVICES_H_ALREADY_INCLUDED
Per Cederqvist's avatar
.  
Per Cederqvist committed
38
39
40
41
42
43
44



/*
 * Session control
 */

45
extern  Success
46
47
login_old (Pers_no	person,
	   const String	passwd);
48

Per Cederqvist's avatar
.  
Per Cederqvist committed
49
extern  Success
50
51
52
login (Pers_no		person,
       const String	passwd,
       Bool		invisible);
Per Cederqvist's avatar
.  
Per Cederqvist committed
53
54

extern  Success
55
logout (void);	/* can never fail */
Per Cederqvist's avatar
.  
Per Cederqvist committed
56
57
58

/* Change Conference */
extern  Success
59
change_conference (Conf_no conference);
Per Cederqvist's avatar
.  
Per Cederqvist committed
60
61
62
63


/* Change name of a person or conference. */
extern  Success
64
65
change_name (Conf_no	  conf_no,
	     const String new_name);
Per Cederqvist's avatar
.  
Per Cederqvist committed
66
67

extern  Success
68
change_what_i_am_doing (String  what_am_i_doing);
Per Cederqvist's avatar
.  
Per Cederqvist committed
69

70
71
/* Client version: one call to set, two to retrieve. */
extern  Success
72
73
set_client_version (const String client_name,
		    const String client_version);
74
75

extern  Success
76
77
get_client_name (Session_no session_no,
		 String *result);
78
79

extern  Success
80
81
get_client_version (Session_no session_no,
		    String *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
82

83
84
85
86
87
extern  Success
set_scheduling(Session_no session_no,
	       unsigned short priority,
	       unsigned short weight);

Per Cederqvist's avatar
.  
Per Cederqvist committed
88
89
90
/* Get info about a session */

extern  Success
91
92
get_session_info  (Session_no session_no,
		   Session_info *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
93

94
extern  Success
95
96
get_session_info_ident  (Session_no session_no,
			 Session_info_ident *result);
97

Per Cederqvist's avatar
Per Cederqvist committed
98
extern  Success
99
100
get_static_session_info (Session_no session_no,
			 Static_session_info *result);
101
102
103
104

extern  Success
get_scheduling(Session_no session_no,
	       Scheduling_info *result);
Per Cederqvist's avatar
Per Cederqvist committed
105

Per Cederqvist's avatar
.  
Per Cederqvist committed
106
107
108
109
110
111
/*
 * Disconnect a session. You can disconnect your own session (even if
 * you are not logged in) and any session where you are supervisor of
 * the user that is logged in on that session.
 */
extern  Success
112
disconnect (Session_no session_no);
Per Cederqvist's avatar
.  
Per Cederqvist committed
113
114
115
116
117

/*
 * Returns your session number
 */
extern  Success
118
who_am_i (Session_no *session_no);
Per Cederqvist's avatar
.  
Per Cederqvist committed
119

Per Cederqvist's avatar
Per Cederqvist committed
120
121
122
123
124
/*
 * Set state in the session
 */

extern  Success
125
user_active (void);
126
127
128
129
130

extern  Success
set_connection_time_format(int use_utc);
    

Per Cederqvist's avatar
.  
Per Cederqvist committed
131
132
133
134
135
136
137
138
139

/******************************
*     Person-related calls    *
******************************/

/*
 *  Create a new person.  Returns 0 if any error occured.
 */
extern  Pers_no
140
141
create_person_old (const String  name,
		   const String  passwd);
142
143

extern Pers_no
144
145
146
147
create_person (const String name,
	       const String passwd,
	       Personal_flags flags,
	       Aux_item_list *conf_aux);
Per Cederqvist's avatar
.  
Per Cederqvist committed
148
149


David Byers's avatar
David Byers committed
150
151
152
153
extern Success
set_pers_flags(Pers_no pers_no,
               Personal_flags flags);

Per Cederqvist's avatar
.  
Per Cederqvist committed
154
155
/* Obsolete call; use get_person_stat instead. */
extern  Success
156
157
158
get_person_stat_old (Pers_no		  person,
		     int		  mask,
		     Person		* result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
159
160

extern  Success
161
162
get_person_stat (Pers_no	  person,
		 Person		* result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
163
164

extern  Success
165
166
167
168
get_created_texts (Pers_no		  person,
		   Local_text_no	  first,
		   unsigned long	  no_of_texts,
		   L2g_iterator 	 *created_texts);
Per Cederqvist's avatar
.  
Per Cederqvist committed
169

170
extern  Success
171
172
173
174
map_created_texts (Pers_no	  person,
		   Local_text_no  first,
		   unsigned long  no_of_texts,
		   Text_mapping  *created_texts);
175

176
extern  Success
177
178
179
180
181
get_membership_old (Pers_no		  person,
		    unsigned short	  first,
		    unsigned short	  no_of_confs,
		    Bool		  want_read_texts,
		    Membership_list	* memberships);
182

Per Cederqvist's avatar
.  
Per Cederqvist committed
183
extern  Success
Per Cederqvist's avatar
Per Cederqvist committed
184
185
186
187
188
get_membership_10(Pers_no           person,
		  unsigned short    first,
		  unsigned short    no_of_confs,
		  Bool		    want_read_texts,
		  Membership_list * memberships);
Per Cederqvist's avatar
.  
Per Cederqvist committed
189

190
191
192
193
194
195
196
197
extern  Success
get_membership(Pers_no           person,
	       unsigned short    first,
	       unsigned short    no_of_confs,
	       Bool              want_read_ranges,
	       unsigned long     max_ranges,
	       Membership_list * memberships);

Per Cederqvist's avatar
.  
Per Cederqvist committed
198
extern  Success
199
200
set_priv_bits (Pers_no	 person,
	       Priv_bits privileges);
Per Cederqvist's avatar
.  
Per Cederqvist committed
201
202
203
204
205
206


/*  Set the password of PERSON to NEW_PWD.  OLD_PWD is the password
 *  of the person who does the set.  This is not necessarily the
 *  same as the one who gets it set.	*/
extern  Success
207
208
209
set_passwd (Pers_no	   person,
	    const String   old_pwd,
	    const String   new_pwd);
Per Cederqvist's avatar
.  
Per Cederqvist committed
210
211
212


/* You can query for unread texts without logging in. */
213
extern  Success
214
215
216
query_read_texts_old (Pers_no	     pers_no,
		      Conf_no	     conf_no,
		      Membership   * result  );
217

Per Cederqvist's avatar
.  
Per Cederqvist committed
218
extern  Success
Per Cederqvist's avatar
Per Cederqvist committed
219
220
221
query_read_texts_10(Pers_no      pers_no,
		    Conf_no      conf_no,
		    Membership * result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
222

223
224
225
226
227
228
229
230
extern  Success
query_read_texts(Pers_no        pers_no,
		 Conf_no        conf_no,
		 Bool           want_read_ranges,
		 unsigned long  max_ranges,
		 Membership    *result);


Per Cederqvist's avatar
.  
Per Cederqvist committed
231
232

extern Success
233
234
get_unread_confs(Pers_no       pers_no,
		 Conf_no_list *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
235
236

extern Success
237
238
set_user_area(Pers_no	pers_no,
	      Text_no	user_area);
Per Cederqvist's avatar
.  
Per Cederqvist committed
239
240
241
242
243
244
245
246


/****************************************
*	Conference-related calls	*
****************************************/


extern  Conf_no
247
248
create_conf_old (const String	  name,
		 Conf_type	  type);
249
250

extern Conf_no
251
252
253
create_conf (const String name,
	     Conf_type type,
	     Aux_item_list *aux);
254
255

extern Success
256
257
258
modify_conf_info (Conf_no conf_no,
		  Number_list *items_to_delete,
		  Aux_item_list *items_to_add);
Per Cederqvist's avatar
.  
Per Cederqvist committed
259
260
261
262


/*  Delete a conference.  Also used to delete persons.  */
extern  Success
263
delete_conf (Conf_no	conf);
Per Cederqvist's avatar
.  
Per Cederqvist committed
264
265
266
267
268


/*
 *  Map conference name to number.  Returns a list of the conferences
 *  that match the name NAME. Can be done without logging in.
269
 * This should be phased out.
Per Cederqvist's avatar
.  
Per Cederqvist committed
270
271
 */
extern  Success
272
273
lookup_name (const String   name,
	     Conf_list_old *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
274

275
extern Success
276
277
278
279
lookup_z_name (const String name,
	       int want_persons,
	       int want_confs,
	       Conf_z_info_list *result);
280

281
282
/* Use these two lookup-calls instead of lookup_name */
extern  Success
283
284
lookup_person (const String  pattern,
	       Conf_no_list  *result);
285
286

extern  Success
287
288
lookup_conf (const String  pattern,
	     Conf_no_list  *result);
289

290
291
/* Two functions for matching regexps. */
extern  Success
292
293
re_lookup_person (const String  regexp,
		  Conf_no_list  *result);
294
295

extern  Success
296
297
re_lookup_conf (const String  regexp,
		Conf_no_list  *result);
298

299
extern  Success
300
301
302
303
re_z_lookup (const String      regexp,
	     int               want_persons,
	     int	       want_confs,
	     Conf_z_info_list *result);
304

305
extern Success
306
get_collate_table (String * result);
307
308

extern  Success
309
310
311
get_conf_stat_older (Conf_no	 conf_no,
		     int	 mask,
		     Conference *result);
312

Per Cederqvist's avatar
.  
Per Cederqvist committed
313
extern  Success
314
315
get_conf_stat_old (Conf_no		  conf_no,
		   Conference		* result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
316
317

extern  Success
318
319
get_conf_stat (Conf_no		  conf_no,
	       Conference	* result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
320

321
extern Success
322
323
get_uconf_stat (Conf_no		  conf_no,
		Small_conf	* result);
324

Per Cederqvist's avatar
.  
Per Cederqvist committed
325
extern  Success
326
327
328
329
get_members (Conf_no	      conf,
	     unsigned short   first,
	     unsigned short   no_of_members,
	     Member_list    * members);
330
331

extern  Success
332
333
334
335
get_members_old (Conf_no	  conf,
		 unsigned short   first,
		 unsigned short   no_of_members,
		 Member_list	* members	);
Per Cederqvist's avatar
.  
Per Cederqvist committed
336
337
338
339
340



/* add_member is also used to change the priority of a conference */
extern  Success
341
342
343
344
345
add_member (Conf_no		conf_no,
	    Pers_no		pers_no,
	    unsigned char	priority,
	    unsigned short	where, /* Range of where is [0..] */
	    Membership_type   * type);
346
347

extern  Success
348
349
350
351
add_member_old (Conf_no		conf_no,
		Pers_no		pers_no,
		unsigned char	priority,
		unsigned short	where	); /* Range of where is [0..] */
352
353

extern Success
354
355
356
set_membership_type (Pers_no          pers_no,
		     Conf_no          conf_no,
		     Membership_type *type   );
Per Cederqvist's avatar
.  
Per Cederqvist committed
357
358
359


extern  Success
360
361
sub_member (Conf_no	conf_no,
	    Pers_no	pers_no);
Per Cederqvist's avatar
.  
Per Cederqvist committed
362
363
364
365
366


/*
 * Tell the server that I want to mark/unmark texts as read so that I
 * get no_of_unread unread texts in conf_no.
Kent Engström's avatar
Kent Engström committed
367
368
369
 *
 * The new alternative function marks last_read as the last read local
 * text. Use this one to avoid race conditions.
Per Cederqvist's avatar
.  
Per Cederqvist committed
370
 */
Kent Engström's avatar
Kent Engström committed
371

Per Cederqvist's avatar
.  
Per Cederqvist committed
372
extern  Success
373
374
set_unread (Conf_no   conf_no,
	    Text_no   no_of_unread);
Per Cederqvist's avatar
.  
Per Cederqvist committed
375

Kent Engström's avatar
Kent Engström committed
376
extern  Success
377
378
set_last_read (Conf_no       conf_no,
	       Local_text_no last_read);
Kent Engström's avatar
Kent Engström committed
379
380


Per Cederqvist's avatar
.  
Per Cederqvist committed
381
382
383
384
385
386
/*
 * set_presentation and set_etc_motd also does some magic with the
 * no_of_marks field in the Text_stat structure of the old and new text.
 */ 

extern  Success
387
388
set_presentation (Conf_no   conf_no,
		  Text_no   text_no); /* 0 to delete pres. */
Per Cederqvist's avatar
.  
Per Cederqvist committed
389
390

extern  Success
391
392
set_etc_motd (Conf_no	  conf_no,
	      Text_no	  text_no);
Per Cederqvist's avatar
.  
Per Cederqvist committed
393
394
395


extern  Success
396
397
set_supervisor (Conf_no	  conf_no,
		Conf_no	  admin	);
Per Cederqvist's avatar
.  
Per Cederqvist committed
398
399

extern  Success
400
401
set_permitted_submitters (Conf_no	  conf_no,
			  Conf_no	  perm_sub);
Per Cederqvist's avatar
.  
Per Cederqvist committed
402
403

extern  Success
404
405
set_super_conf (Conf_no	  conf_no,
		Conf_no	  super_conf);
Per Cederqvist's avatar
.  
Per Cederqvist committed
406
407

extern  Success
408
409
set_conf_type (Conf_no	  conf_no,
	       Conf_type  type	);
Per Cederqvist's avatar
.  
Per Cederqvist committed
410
extern  Success
411
412
set_garb_nice (Conf_no	  conf_no,
	       Garb_nice  days); /* number of days */
Per Cederqvist's avatar
.  
Per Cederqvist committed
413

414
extern  Success
415
416
set_expire (Conf_no	  conf_no,
	    Garb_nice	  expire); /* number of days */
417

Per Cederqvist's avatar
.  
Per Cederqvist committed
418

419
extern Success
420
421
set_keep_commented(Conf_no	conf_no,
                   Garb_nice	keep_commented);	/* number of days */
422

423
424
extern Success
first_unused_conf_no(Conf_no *result);
425

426
427
428
429
430
431
432
433
434
/*
 * Return next/previous existing text-no.
 */

extern  Success
find_next_conf_no(Conf_no start, Conf_no *result);

extern  Success
find_previous_conf_no(Conf_no start, Conf_no *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
435
436
437
438
439
440
441

/********************************
*     Calls to handle marks     *
********************************/


extern  Success
442
get_marks (Mark_list *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
443
444
445
446
447
448



/*
 *  Will fail if the user is not allowed to read the text.
 */
449
450
/* This function uses mark_type==0 to delete the mark. */
extern  Success
451
452
mark_text_old (Text_no	  	  text,
	       unsigned char	  mark_type);
453

454
455

/* Using this function, you can set mark_type==0. */
Per Cederqvist's avatar
.  
Per Cederqvist committed
456
extern  Success
457
458
mark_text (Text_no	  text,
	   unsigned char  mark_type);
459

Per Cederqvist's avatar
.  
Per Cederqvist committed
460

461
462
/* Remove a mark, reporting an error if you had not marked the text. */
extern  Success
463
unmark_text (Text_no	  text);
464

Per Cederqvist's avatar
.  
Per Cederqvist committed
465
466
467
468
469
470
471
472
473



/*******************************
*     Calls to handle texts    *
*******************************/


extern  Success
474
475
476
477
get_text (Text_no	  text,
	  String_size	  start_char,
	  String_size	  end_char,
	  String	* result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
478
479
480


extern  Success
481
482
get_text_stat (Text_no    text,
	       Text_stat *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
483

484
extern  Success
485
486
get_text_stat_old (Text_no    text,
		   Text_stat *result);
487

Per Cederqvist's avatar
.  
Per Cederqvist committed
488
extern  Success
489
490
491
mark_as_read (Conf_no		    conference,
	      int		    no_of_texts,
	      const Local_text_no * text_arr  );
Per Cederqvist's avatar
.  
Per Cederqvist committed
492

493
494
495
496
497
498
499
500
501
extern  Success
mark_as_unread(Conf_no         conference,
	       Local_text_no   lno);


extern  Success
set_read_ranges(Conf_no conference,
		const struct read_range_list *read_ranges);

Per Cederqvist's avatar
.  
Per Cederqvist committed
502
503
504

/* Returns 0 on error */
extern  Text_no
505
506
507
create_text (const String     message,
	     Misc_info_list * misc,
	     Aux_item_list  * aux);
508
509

extern Text_no
510
511
create_text_old (const String     message,
		 Misc_info_list	* misc	    );
Per Cederqvist's avatar
.  
Per Cederqvist committed
512

513
/* Returns 0 on error.  */
514
extern  Text_no
515
516
517
create_anonymous_text (const String      message,
		       Misc_info_list  * misc,
		       Aux_item_list    *aux);
518
519

extern  Text_no
520
521
create_anonymous_text_old (const String      message,
			   Misc_info_list  * misc);
522

Per Cederqvist's avatar
.  
Per Cederqvist committed
523
extern Success
524
delete_text( Text_no text_no);
Per Cederqvist's avatar
.  
Per Cederqvist committed
525

526
extern Success
527
528
529
modify_text_info(Text_no        text,
		 Number_list   *items_to_delete, 
		 Aux_item_list *aux);
Per Cederqvist's avatar
.  
Per Cederqvist committed
530
531
532


extern  Success
533
534
535
add_recipient (Text_no	      text_no,
	       Conf_no	      conf_no,
	       enum info_type type);
Per Cederqvist's avatar
.  
Per Cederqvist committed
536
537

extern  Success
538
539
sub_recipient (Text_no	  text_no,
	       Conf_no	  conf_no);
Per Cederqvist's avatar
.  
Per Cederqvist committed
540
541
542


extern  Success
543
544
add_comment (Text_no	  comment,
	     Text_no 	  comment_to);
Per Cederqvist's avatar
.  
Per Cederqvist committed
545
546
547
548
549
550


/*
 *  Make the text COMMENT to not be a comment to text COMMENT_TO
 */
extern  Success
551
552
sub_comment (Text_no	  comment,
	     Text_no	  comment_to);
Per Cederqvist's avatar
.  
Per Cederqvist committed
553
554

extern Success
555
556
add_footnote (Text_no	footnote,
	      Text_no 	footnote_to);
Per Cederqvist's avatar
.  
Per Cederqvist committed
557
558

extern Success
559
560
sub_footnote (Text_no	footnote,
	      Text_no	parent);
Per Cederqvist's avatar
.  
Per Cederqvist committed
561

562
563
564
extern Success
first_unused_text_no(Text_no *result);

Per Cederqvist's avatar
.  
Per Cederqvist committed
565
extern  Success
566
567
568
569
get_map (Conf_no	  conf_no,
	 Local_text_no	  first_local_no,
	 unsigned long	  no_of_texts,
	 L2g_iterator    *result);
570
571

extern Success
572
573
574
575
local_to_global (Conf_no       conf_No,
		 Local_text_no first_local_no,
		 unsigned long no_of_texts,
		 Text_mapping *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
576
577
578
579
580
581
582


/*
 *  Ask what the server thinks the time is. This
 *  might differ if on two different machines.
 */
extern  Success
583
get_time (time_t *t);
Per Cederqvist's avatar
.  
Per Cederqvist committed
584
585


Linus Tolke's avatar
Linus Tolke committed
586
587
588
/*
 *  Gets the last text before a given time.
 */
589

590
extern  Success
591
get_last_text (struct tm *clk, Text_no *result);
Linus Tolke's avatar
Linus Tolke committed
592

593
594
595
596
597
/*
 * Return next/previous existing text-no.
 */

extern  Success
598
find_next_text_no (Text_no start, Text_no *result);
599
600

extern  Success
601
find_previous_text_no (Text_no start, Text_no *result);
602
603


Per Cederqvist's avatar
.  
Per Cederqvist committed
604
605
606
607
/*
 * Who is logged on now?
 */
extern  Success
608
who_is_on_old (Who_info_list_old	* result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
609
610

extern  Success
611
who_is_on (Who_info_list	* result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
612

613
extern  Success
614
who_is_on_ident (Who_info_ident_list *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
615

Per Cederqvist's avatar
Per Cederqvist committed
616
extern  Success
617
618
619
620
who_is_on_dynamic (int want_visible,
		   int want_invisible,
		   long active_last,
		   Dynamic_session_info_list *result);
Per Cederqvist's avatar
Per Cederqvist committed
621

Per Cederqvist's avatar
.  
Per Cederqvist committed
622
623
624
/*
 *  Return various information about the server
 */
625
extern  Success
626
get_info_old (Info *result);
627

Per Cederqvist's avatar
.  
Per Cederqvist committed
628
extern  Success
629
get_info (Info *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
630

631
extern  Success
632
get_version_info (Version_info *result);
633

Per Cederqvist's avatar
.  
Per Cederqvist committed
634
635
636
637
638

/*
 * Privileged calls.
 */

David Byers's avatar
David Byers committed
639
extern Success
640
set_info(Info *info);
David Byers's avatar
David Byers committed
641

642
extern Success
643
modify_system_info(Number_list      *items_to_delete,
644
		   Aux_item_list    *items_to_add);
645

Per Cederqvist's avatar
.  
Per Cederqvist committed
646
extern Success
647
set_motd_of_lyskom (Text_no motd);
Per Cederqvist's avatar
.  
Per Cederqvist committed
648
649
650
651
652

/*
 * Set ena_level. 0 means don't use any privileges.
 */
extern Success
653
enable (unsigned char ena_level);
Per Cederqvist's avatar
.  
Per Cederqvist committed
654
655
656
657
658

/*
 * Make LysKOM sync its files.
 */
extern Success
659
sync_kom (void);
Per Cederqvist's avatar
.  
Per Cederqvist committed
660
661
662
663
664

/*
 * Close LysKOM.
 */
extern Success
665
shutdown_kom (int exit_val);
Per Cederqvist's avatar
.  
Per Cederqvist committed
666
667

/*
668
669
 * Send a message to all clients. This is obsoleted by send_message(),
 * but will remain for compatibility reasons.
Per Cederqvist's avatar
.  
Per Cederqvist committed
670
671
 */
extern Success
672
broadcast (const String message);
Per Cederqvist's avatar
.  
Per Cederqvist committed
673
674
675
676
677
678

/*
 * Send a message to a person, or all persons. If recipient == 0 all
 * connections will receive the message.
 */
extern Success
679
680
send_message (Conf_no recipient,
	      const String message);
Per Cederqvist's avatar
.  
Per Cederqvist committed
681

682
683
684
685
686
/*
 * Selection of asynchronous messages
 */

extern Success
687
accept_async(Number_list *accept_list);
688
689

extern Success
690
query_async(Number_list *result);
Per Cederqvist's avatar
.  
Per Cederqvist committed
691

692
693
694
695
696
/*
 * Aux-items
 */

extern Success
697
query_predefined_aux_items(Number_list *result);
698
699


700
701
702
703
704
705
706
707
708
/*
 * Measuread statistical numbers.
 */

extern Success
get_stats_description(Stats_description *result);

extern Success
get_stats(const String what,
709
	  Stats_list *result);
710

711
712
713
714
715
716
717
/*
 * Boot-time information.
 */

extern Success
get_boottime_info(Static_server_info *result);

718

719
720
#ifdef DEBUG_CALLS
extern Success
721
get_memory_info(Memory_info *result);
722
723

extern Success
724
set_marks(Text_no text_no, unsigned long no_of_marks);
725
726

extern Success
727
728
backdate_text(Text_no text_no,
	      unsigned long seconds);
729

730
731
732
733
734
735
/* Modify the "sent_at" item.  It must already exist. */
extern Success
backdate_comment_link(Text_no parent,
		      Text_no child,
		      unsigned long seconds);

Per Cederqvist's avatar
Per Cederqvist committed
736
737
738
extern Success
start_garb(void);

739
740
741
742
743
744
extern Success
cache_sync_start(void);

extern Success
cache_sync_finish(void);

745
746
747
extern Success
dump_cfg_timevals(void);

748
#endif
Per Cederqvist's avatar
.  
Per Cederqvist committed
749
750
    
#endif	/*  _SERVICES_H_ALREADY_INCLUDED__  */