Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
reorganization, additions
[simgrid.git] / cruft / doc / tmpl / gras-unused.sgml
1 <!-- ##### SECTION ./tmpl/ErrLog.sgml:Long_Description ##### -->
2 <para>
3
4 </para>
5
6
7 <!-- ##### SECTION ./tmpl/ErrLog.sgml:See_Also ##### -->
8 <para>
9
10 </para>
11
12
13 <!-- ##### SECTION ./tmpl/ErrLog.sgml:Short_Description ##### -->
14
15
16
17 <!-- ##### SECTION ./tmpl/ErrLog.sgml:Title ##### -->
18 ErrLog
19
20
21 <!-- ##### SECTION ./tmpl/config.sgml:Long_Description ##### -->
22 <para>
23
24 </para>
25
26
27 <!-- ##### SECTION ./tmpl/config.sgml:See_Also ##### -->
28 <para>
29
30 </para>
31
32
33 <!-- ##### SECTION ./tmpl/config.sgml:Short_Description ##### -->
34
35
36
37 <!-- ##### SECTION ./tmpl/config.sgml:Title ##### -->
38 config
39
40
41 <!-- ##### SECTION ./tmpl/dico.sgml:Long_Description ##### -->
42 <para>
43
44 </para>
45
46
47 <!-- ##### SECTION ./tmpl/dico.sgml:See_Also ##### -->
48 <para>
49
50 </para>
51
52
53 <!-- ##### SECTION ./tmpl/dico.sgml:Short_Description ##### -->
54
55
56
57 <!-- ##### SECTION ./tmpl/dico.sgml:Title ##### -->
58 dico
59
60
61 <!-- ##### SECTION ./tmpl/dynar.sgml:Long_Description ##### -->
62 <para>
63 This module provide the quite usual dynamic array facility.
64 </para>
65
66
67 <!-- ##### SECTION ./tmpl/dynar.sgml:See_Also ##### -->
68 <para>
69
70 </para>
71
72
73 <!-- ##### SECTION ./tmpl/dynar.sgml:Short_Description ##### -->
74 Dynamic array
75
76
77 <!-- ##### SECTION ./tmpl/dynar.sgml:Title ##### -->
78 dynar
79
80
81 <!-- ##### SECTION ./tmpl/gras-overview.sgml:Long_Description ##### -->
82     <para>This document introduce the GRAS library (<emphasis>Grid Reality
83     And Simulation</emphasis>, or according to my english dictionary,
84     <emphasis>Generally Recognized As Safe</emphasis> ;).</para>
85     
86     <refsect2>
87       <title>Overview</title>
88       <para>The purpose of the GRAS is to allow the developpement of
89       distributed programs which will work with as few as possible
90       modification both on the SimGrid simulator (SG), and in the Real Life
91       (RL).</para>
92
93       <para>Here are the problems when you want to do so:
94         <itemizedlist>
95           <listitem>
96             <para>Communication in SG is done by passing tasks, while in
97             RL, you have to deal with sockets (or any wrapper to it).</para>
98           </listitem>
99           <listitem><para>In RL, each process should provide a main()
100             function, and it's obviously not the case in SG.</para>
101           </listitem>
102         </itemizedlist>
103       </para>
104     </refsect2>
105     <refsect2>
106       <title>Application class target</title>
107       <para>If you want to run your code both in RL and in SG, you won't be
108       able to use the full set of features offered by any of those two
109       worlds. GRAS tries to provide a suffisent set of features to develop
110       your application, and implement them in both worlds.</para>
111
112       <para>GRAS uses the paradigm of <emphasis>event-driven 
113       programming</emphasis>, which is an extension to the message-passing
114       one. Any process of a typical event-driven application declares
115       callback to incoming events, which can be messages from other
116       processes, timers or others.</para>
117
118       <para>All messages have an header, specifying its type, and attached
119       data, represented as one or several C structures. In order to send
120       the data over the network in RL, a type-description mecanism is
121       provided, and the RL version of GRAS implements CDR
122       functionnalities. That is to say that the data are sent in the native
123       format of the sender host, and converted on the destination host only
124       if needed.</para>
125
126       <para>In order to not reimplement the wheel, GRAS use existing code,
127       and adapt them to make them work together. The SG version naturally
128       use the SimGrid toolkit, while the RL version is based over the
129       communication library used in NWS (note that this library was somehow
130       modified, since the previous version use XDR, ie both the sender and
131       the receiver convert the data from/to a so called network
132       format). That's why some basic knowledge about how NWS work is
133       supposed in this document. But don't worry, you only have to know the
134       basics about NWS, the internals needed to understand the document
135       will be presented when needed.</para>
136     </refsect2>
137
138
139 <!-- ##### SECTION ./tmpl/gras-overview.sgml:See_Also ##### -->
140 <para>
141
142 </para>
143
144
145 <!-- ##### SECTION ./tmpl/gras-overview.sgml:Short_Description ##### -->
146 Overview of the GRAS library
147
148
149 <!-- ##### SECTION ./tmpl/gras-overview.sgml:Title ##### -->
150 Overview
151
152
153 <!-- ##### SECTION ./tmpl/gras.sgml:Long_Description ##### -->
154 <para>
155
156 </para>
157
158
159 <!-- ##### SECTION ./tmpl/gras.sgml:See_Also ##### -->
160 <para>
161
162 </para>
163
164
165 <!-- ##### SECTION ./tmpl/gras.sgml:Short_Description ##### -->
166
167
168
169 <!-- ##### SECTION ./tmpl/gras.sgml:Title ##### -->
170 gras
171
172
173 <!-- ##### SECTION ./tmpl/nws_comm.sgml:Long_Description ##### -->
174 <para>
175
176 </para>
177
178
179 <!-- ##### SECTION ./tmpl/nws_comm.sgml:See_Also ##### -->
180 <para>
181
182 </para>
183
184
185 <!-- ##### SECTION ./tmpl/nws_comm.sgml:Short_Description ##### -->
186
187
188
189 <!-- ##### SECTION ./tmpl/nws_comm.sgml:Title ##### -->
190 nws_comm
191
192
193 <!-- ##### MACRO BEGIN_DECL ##### -->
194 <para>
195
196 </para>
197
198
199 <!-- ##### MACRO CCRITICAL0 ##### -->
200 <para>
201
202 </para>
203
204 @c: 
205 @f: 
206
207 <!-- ##### MACRO CCRITICAL1 ##### -->
208 <para>
209
210 </para>
211
212 @c: 
213 @f: 
214 @a1: 
215
216 <!-- ##### MACRO CCRITICAL2 ##### -->
217 <para>
218
219 </para>
220
221 @c: 
222 @f: 
223 @a1: 
224 @a2: 
225
226 <!-- ##### MACRO CCRITICAL3 ##### -->
227 <para>
228
229 </para>
230
231 @c: 
232 @f: 
233 @a1: 
234 @a2: 
235 @a3: 
236
237 <!-- ##### MACRO CCRITICAL4 ##### -->
238 <para>
239
240 </para>
241
242 @c: 
243 @f: 
244 @a1: 
245 @a2: 
246 @a3: 
247 @a4: 
248
249 <!-- ##### MACRO CCRITICAL5 ##### -->
250 <para>
251
252 </para>
253
254 @c: 
255 @f: 
256 @a1: 
257 @a2: 
258 @a3: 
259 @a4: 
260 @a5: 
261
262 <!-- ##### MACRO CDEBUG0 ##### -->
263 <para>
264
265 </para>
266
267 @c: 
268 @f: 
269
270 <!-- ##### MACRO CDEBUG1 ##### -->
271 <para>
272
273 </para>
274
275 @c: 
276 @f: 
277 @a1: 
278
279 <!-- ##### MACRO CDEBUG2 ##### -->
280 <para>
281
282 </para>
283
284 @c: 
285 @f: 
286 @a1: 
287 @a2: 
288
289 <!-- ##### MACRO CDEBUG3 ##### -->
290 <para>
291
292 </para>
293
294 @c: 
295 @f: 
296 @a1: 
297 @a2: 
298 @a3: 
299
300 <!-- ##### MACRO CDEBUG4 ##### -->
301 <para>
302
303 </para>
304
305 @c: 
306 @f: 
307 @a1: 
308 @a2: 
309 @a3: 
310 @a4: 
311
312 <!-- ##### MACRO CDEBUG5 ##### -->
313 <para>
314
315 </para>
316
317 @c: 
318 @f: 
319 @a1: 
320 @a2: 
321 @a3: 
322 @a4: 
323 @a5: 
324
325 <!-- ##### MACRO CERROR0 ##### -->
326 <para>
327
328 </para>
329
330 @c: 
331 @f: 
332
333 <!-- ##### MACRO CERROR1 ##### -->
334 <para>
335
336 </para>
337
338 @c: 
339 @f: 
340 @a1: 
341
342 <!-- ##### MACRO CERROR2 ##### -->
343 <para>
344
345 </para>
346
347 @c: 
348 @f: 
349 @a1: 
350 @a2: 
351
352 <!-- ##### MACRO CERROR3 ##### -->
353 <para>
354
355 </para>
356
357 @c: 
358 @f: 
359 @a1: 
360 @a2: 
361 @a3: 
362
363 <!-- ##### MACRO CERROR4 ##### -->
364 <para>
365
366 </para>
367
368 @c: 
369 @f: 
370 @a1: 
371 @a2: 
372 @a3: 
373 @a4: 
374
375 <!-- ##### MACRO CERROR5 ##### -->
376 <para>
377
378 </para>
379
380 @c: 
381 @f: 
382 @a1: 
383 @a2: 
384 @a3: 
385 @a4: 
386 @a5: 
387
388 <!-- ##### MACRO CINFO0 ##### -->
389 <para>
390
391 </para>
392
393 @c: 
394 @f: 
395
396 <!-- ##### MACRO CINFO1 ##### -->
397 <para>
398
399 </para>
400
401 @c: 
402 @f: 
403 @a1: 
404
405 <!-- ##### MACRO CINFO2 ##### -->
406 <para>
407
408 </para>
409
410 @c: 
411 @f: 
412 @a1: 
413 @a2: 
414
415 <!-- ##### MACRO CINFO3 ##### -->
416 <para>
417
418 </para>
419
420 @c: 
421 @f: 
422 @a1: 
423 @a2: 
424 @a3: 
425
426 <!-- ##### MACRO CINFO4 ##### -->
427 <para>
428
429 </para>
430
431 @c: 
432 @f: 
433 @a1: 
434 @a2: 
435 @a3: 
436 @a4: 
437
438 <!-- ##### MACRO CINFO5 ##### -->
439 <para>
440
441 </para>
442
443 @c: 
444 @f: 
445 @a1: 
446 @a2: 
447 @a3: 
448 @a4: 
449 @a5: 
450
451 <!-- ##### MACRO CLOG0 ##### -->
452 <para>
453
454 </para>
455
456 @c: 
457 @p: 
458 @f: 
459
460 <!-- ##### MACRO CLOG1 ##### -->
461 <para>
462
463 </para>
464
465 @c: 
466 @p: 
467 @f: 
468 @a1: 
469
470 <!-- ##### MACRO CLOG2 ##### -->
471 <para>
472
473 </para>
474
475 @c: 
476 @p: 
477 @f: 
478 @a1: 
479 @a2: 
480
481 <!-- ##### MACRO CLOG3 ##### -->
482 <para>
483
484 </para>
485
486 @c: 
487 @p: 
488 @f: 
489 @a1: 
490 @a2: 
491 @a3: 
492
493 <!-- ##### MACRO CLOG4 ##### -->
494 <para>
495
496 </para>
497
498 @c: 
499 @p: 
500 @f: 
501 @a1: 
502 @a2: 
503 @a3: 
504 @a4: 
505
506 <!-- ##### MACRO CLOG5 ##### -->
507 <para>
508
509 </para>
510
511 @c: 
512 @p: 
513 @f: 
514 @a1: 
515 @a2: 
516 @a3: 
517 @a4: 
518 @a5: 
519
520 <!-- ##### MACRO CLOG6 ##### -->
521 <para>
522
523 </para>
524
525 @c: 
526 @p: 
527 @f: 
528 @a1: 
529 @a2: 
530 @a3: 
531 @a4: 
532 @a5: 
533 @a6: 
534
535 <!-- ##### MACRO CRITICAL0 ##### -->
536 <para>
537
538 </para>
539
540 @f: 
541
542 <!-- ##### MACRO CRITICAL1 ##### -->
543 <para>
544
545 </para>
546
547 @f: 
548 @a1: 
549
550 <!-- ##### MACRO CRITICAL2 ##### -->
551 <para>
552
553 </para>
554
555 @f: 
556 @a1: 
557 @a2: 
558
559 <!-- ##### MACRO CRITICAL3 ##### -->
560 <para>
561
562 </para>
563
564 @f: 
565 @a1: 
566 @a2: 
567 @a3: 
568
569 <!-- ##### MACRO CRITICAL4 ##### -->
570 <para>
571
572 </para>
573
574 @f: 
575 @a1: 
576 @a2: 
577 @a3: 
578 @a4: 
579
580 <!-- ##### MACRO CRITICAL5 ##### -->
581 <para>
582
583 </para>
584
585 @f: 
586 @a1: 
587 @a2: 
588 @a3: 
589 @a4: 
590 @a5: 
591
592 <!-- ##### FUNCTION CallAddr ##### -->
593 <para>
594
595 </para>
596
597 @addr: 
598 @Param2: 
599 @sock: 
600 @timeOut: 
601 @Returns: 
602
603 <!-- ##### FUNCTION CreateLocalChild ##### -->
604 <para>
605
606 </para>
607
608 @pid: 
609 @parentToChild: 
610 @childToParent: 
611 @Returns: 
612
613 <!-- ##### FUNCTION DROP_SOCKET ##### -->
614 <para>
615
616 </para>
617
618 @sock: 
619 @Returns: 
620
621 <!-- ##### MACRO END_DECL ##### -->
622 <para>
623
624 </para>
625
626
627 <!-- ##### MACRO EODD ##### -->
628 <para>
629
630 </para>
631
632
633 <!-- ##### FUNCTION EstablishAnEar ##### -->
634 <para>
635
636 </para>
637
638 @Param1: 
639 @Param2: 
640 @ear: 
641 @earPort: 
642 @Returns: 
643
644 <!-- ##### MACRO GRAS_LOG_MAYDAY ##### -->
645 <para>
646
647 </para>
648
649
650 <!-- ##### MACRO GRAS_LOG_ROOT_CAT ##### -->
651 <para>
652
653 </para>
654
655
656 <!-- ##### MACRO HAVE_DLFCN_H ##### -->
657 <para>
658
659 </para>
660
661
662 <!-- ##### MACRO HAVE_INTTYPES_H ##### -->
663 <para>
664
665 </para>
666
667
668 <!-- ##### MACRO HAVE_LIBPTHREAD ##### -->
669 <para>
670
671 </para>
672
673
674 <!-- ##### MACRO HAVE_MEMORY_H ##### -->
675 <para>
676
677 </para>
678
679
680 <!-- ##### MACRO HAVE_STDINT_H ##### -->
681 <para>
682
683 </para>
684
685
686 <!-- ##### MACRO HAVE_STDLIB_H ##### -->
687 <para>
688
689 </para>
690
691
692 <!-- ##### MACRO HAVE_STRINGS_H ##### -->
693 <para>
694
695 </para>
696
697
698 <!-- ##### MACRO HAVE_STRING_H ##### -->
699 <para>
700
701 </para>
702
703
704 <!-- ##### MACRO HAVE_SYS_STAT_H ##### -->
705 <para>
706
707 </para>
708
709
710 <!-- ##### MACRO HAVE_SYS_TYPES_H ##### -->
711 <para>
712
713 </para>
714
715
716 <!-- ##### MACRO HAVE_UNISTD_H ##### -->
717 <para>
718
719 </para>
720
721
722 <!-- ##### TYPEDEF IPAddress ##### -->
723 <para>
724
725 </para>
726
727
728 <!-- ##### FUNCTION IPAddressImage ##### -->
729 <para>
730
731 </para>
732
733 @addr: 
734 @Returns: 
735
736 <!-- ##### FUNCTION IPAddressImage_r ##### -->
737 <para>
738
739 </para>
740
741 @addr: 
742 @Returns: 
743
744 <!-- ##### FUNCTION IPAddressMachine ##### -->
745 <para>
746
747 </para>
748
749 @addr: 
750 @Returns: 
751
752 <!-- ##### FUNCTION IPAddressMachine_r ##### -->
753 <para>
754
755 </para>
756
757 @addr: 
758 @Returns: 
759
760 <!-- ##### MACRO IPAddressValue ##### -->
761 <para>
762
763 </para>
764
765 @machineOrAddress: 
766 @address: 
767
768 <!-- ##### FUNCTION IPAddressValues ##### -->
769 <para>
770
771 </para>
772
773 @machineOrAddress: 
774 @addressList: 
775 @atMost: 
776 @Returns: 
777
778 <!-- ##### FUNCTION IncomingRequest ##### -->
779 <para>
780
781 </para>
782
783 @timeOut: 
784 @sd: 
785 @ldap: 
786 @Returns: 
787
788 <!-- ##### FUNCTION IsOkay ##### -->
789 <para>
790
791 </para>
792
793 @sd: 
794 @Returns: 
795
796 <!-- ##### FUNCTION IsPipe ##### -->
797 <para>
798
799 </para>
800
801 @sd: 
802 @Returns: 
803
804 <!-- ##### MACRO IsValidIP ##### -->
805 <para>
806
807 </para>
808
809 @machineOrAddress: 
810
811 <!-- ##### MACRO LOG6 ##### -->
812 <para>
813
814 </para>
815
816 @p: 
817 @f: 
818 @a1: 
819 @a2: 
820 @a3: 
821 @a4: 
822 @a5: 
823 @a6: 
824
825 <!-- ##### FUNCTION MyMachineName ##### -->
826 <para>
827
828 </para>
829
830 @Returns: 
831
832 <!-- ##### MACRO NO_SOCKET ##### -->
833 <para>
834
835 </para>
836
837
838 <!-- ##### FUNCTION NotifyOnDisconnection ##### -->
839 <para>
840
841 </para>
842
843 @notifyFn: 
844
845 <!-- ##### FUNCTION OpenClientSocket ##### -->
846 <para>
847
848 </para>
849
850 @addr: 
851 @Param2: 
852 @sock: 
853 @Returns: 
854
855 <!-- ##### FUNCTION OpenServerSocket ##### -->
856 <para>
857
858 </para>
859
860 @Param1: 
861 @Param2: 
862 @ear: 
863 @earPort: 
864 @Returns: 
865
866 <!-- ##### MACRO PACKAGE ##### -->
867 <para>
868
869 </para>
870
871
872 <!-- ##### MACRO PACKAGE_BUGREPORT ##### -->
873 <para>
874
875 </para>
876
877
878 <!-- ##### MACRO PACKAGE_NAME ##### -->
879 <para>
880
881 </para>
882
883
884 <!-- ##### MACRO PACKAGE_STRING ##### -->
885 <para>
886
887 </para>
888
889
890 <!-- ##### MACRO PACKAGE_TARNAME ##### -->
891 <para>
892
893 </para>
894
895
896 <!-- ##### MACRO PACKAGE_VERSION ##### -->
897 <para>
898
899 </para>
900
901
902 <!-- ##### FUNCTION PassSocket ##### -->
903 <para>
904
905 </para>
906
907 @sock: 
908 @child: 
909 @Returns: 
910
911 <!-- ##### FUNCTION Peer ##### -->
912 <para>
913
914 </para>
915
916 @sd: 
917 @Returns: 
918
919 <!-- ##### FUNCTION PeerName ##### -->
920 <para>
921
922 </para>
923
924 @sd: 
925 @Returns: 
926
927 <!-- ##### FUNCTION PeerName_r ##### -->
928 <para>
929
930 </para>
931
932 @sd: 
933 @Returns: 
934
935 <!-- ##### MACRO STDC_HEADERS ##### -->
936 <para>
937
938 </para>
939
940
941 <!-- ##### TYPEDEF Socket ##### -->
942 <para>
943
944 </para>
945
946
947 <!-- ##### FUNCTION SocketFailure ##### -->
948 <para>
949
950 </para>
951
952 @sig: 
953
954 <!-- ##### USER_FUNCTION SocketFunction ##### -->
955 <para>
956
957 </para>
958
959 @Param1: 
960
961 <!-- ##### FUNCTION SocketInUse ##### -->
962 <para>
963
964 </para>
965
966 @sd: 
967 @Returns: 
968
969 <!-- ##### FUNCTION SocketIsAvailable ##### -->
970 <para>
971
972 </para>
973
974 @sd: 
975 @Returns: 
976
977 <!-- ##### MACRO VERSION ##### -->
978 <para>
979
980 </para>
981
982
983 <!-- ##### USER_FUNCTION grasCallbackFunction ##### -->
984 <para>
985
986 </para>
987
988 @sd: 
989 @msgType: 
990 @vdata: 
991
992 <!-- ##### FUNCTION grasCloseSocket ##### -->
993 <para>
994
995 </para>
996
997 @sock: 
998 @Returns: 
999
1000 <!-- ##### FUNCTION grasDataDescCmp ##### -->
1001 <para>
1002
1003 </para>
1004
1005 @dd1: 
1006 @c1: 
1007 @dd2: 
1008 @c2: 
1009 @Returns: 
1010 @description: 
1011
1012 <!-- ##### FUNCTION grasDataDescCount ##### -->
1013 <para>
1014
1015 </para>
1016
1017 @description: 
1018 @Returns: 
1019
1020 <!-- ##### FUNCTION grasDataRecv ##### -->
1021 <para>
1022
1023 </para>
1024
1025 @sd: 
1026 @data: 
1027 @description: 
1028 @description_length: 
1029 @repetition: 
1030 @Returns: 
1031
1032 <!-- ##### FUNCTION grasDataSend ##### -->
1033 <para>
1034
1035 </para>
1036
1037 @sd: 
1038 @data: 
1039 @description: 
1040 @description_length: 
1041 @repetition: 
1042 @Returns: 
1043
1044 <!-- ##### FUNCTION grasDataSize ##### -->
1045 <para>
1046
1047 </para>
1048
1049 @description: 
1050 @ft: 
1051 @Returns: 
1052
1053 <!-- ##### ENUM grasError_t ##### -->
1054 <para>
1055
1056 </para>
1057
1058 @no_error: 
1059 @malloc_error: 
1060 @mismatch_error: 
1061 @sanity_error: 
1062 @system_error: 
1063 @network_error: 
1064 @timeout_error: 
1065 @thread_error: 
1066 @unknown_error: 
1067
1068 <!-- ##### FUNCTION grasLock ##### -->
1069 <para>
1070
1071 </para>
1072
1073 @Returns: 
1074
1075 <!-- ##### TYPEDEF grasMessageType_t ##### -->
1076 <para>
1077
1078 </para>
1079
1080
1081 <!-- ##### FUNCTION grasMsgDiscard ##### -->
1082 <para>
1083
1084 </para>
1085
1086 @sd: 
1087 @size: 
1088
1089 <!-- ##### FUNCTION grasMsgEntryGet ##### -->
1090 <para>
1091
1092 </para>
1093
1094 @id: 
1095 @Returns: 
1096
1097 <!-- ##### TYPEDEF grasMsgEntry_t ##### -->
1098 <para>
1099
1100 </para>
1101
1102
1103 <!-- ##### FUNCTION grasMsgFree ##### -->
1104 <para>
1105
1106 </para>
1107
1108 @msg: 
1109
1110 <!-- ##### FUNCTION grasMsgHandle ##### -->
1111 <para>
1112
1113 </para>
1114
1115 @timeOut: 
1116
1117 <!-- ##### FUNCTION grasMsgHeaderNew ##### -->
1118 <para>
1119
1120 </para>
1121
1122 @msgId: 
1123 @dataSize: 
1124 @seqCount: 
1125 @Returns: 
1126
1127 <!-- ##### FUNCTION grasMsgNew ##### -->
1128 <para>
1129
1130 </para>
1131
1132 @msgId: 
1133 @free_data_on_free: 
1134 @seqCount: 
1135 @Varargs: 
1136 @Returns: 
1137
1138 <!-- ##### FUNCTION grasMsgRegister ##### -->
1139 <para>
1140
1141 </para>
1142
1143 @message: 
1144 @name: 
1145 @sequence_count: 
1146 @Varargs: 
1147 @Returns: 
1148
1149 <!-- ##### FUNCTION grasMsgSend ##### -->
1150 <para>
1151
1152 </para>
1153
1154 @sd: 
1155 @message: 
1156 @sequence_count: 
1157 @Varargs: 
1158 @Returns: 
1159
1160 <!-- ##### FUNCTION grasMsgWait ##### -->
1161 <para>
1162
1163 </para>
1164
1165 @sd: 
1166 @timeout: 
1167 @message: 
1168 @sequence_count: 
1169 @Varargs: 
1170 @Returns: 
1171
1172 <!-- ##### FUNCTION grasMyMachineName ##### -->
1173 <para>
1174
1175 </para>
1176
1177 @Returns: 
1178
1179 <!-- ##### FUNCTION grasOpenClientSocket ##### -->
1180 <para>
1181
1182 </para>
1183
1184 @host: 
1185 @Param2: 
1186 @sock: 
1187 @Returns: 
1188
1189 <!-- ##### FUNCTION grasOpenServerSocket ##### -->
1190 <para>
1191
1192 </para>
1193
1194 @Param1: 
1195 @Param2: 
1196 @sock: 
1197 @Returns: 
1198
1199 <!-- ##### MACRO grasPROTOCOL ##### -->
1200 <para>
1201
1202 </para>
1203
1204
1205 <!-- ##### FUNCTION grasPeerGetAddress ##### -->
1206 <para>
1207
1208 </para>
1209
1210 @sd: 
1211 @Returns: 
1212
1213 <!-- ##### FUNCTION grasPeerGetName ##### -->
1214 <para>
1215
1216 </para>
1217
1218 @sd: 
1219 @Returns: 
1220
1221 <!-- ##### FUNCTION grasRecvData ##### -->
1222 <para>
1223
1224 </para>
1225
1226 @sd: 
1227 @data: 
1228 @description: 
1229 @Returns: 
1230
1231 <!-- ##### FUNCTION grasRegisterCallback ##### -->
1232 <para>
1233
1234 </para>
1235
1236 @message: 
1237 @TTL: 
1238 @cb: 
1239
1240 <!-- ##### FUNCTION grasSendData ##### -->
1241 <para>
1242
1243 </para>
1244
1245 @sd: 
1246 @data: 
1247 @description: 
1248 @Returns: 
1249
1250 <!-- ##### FUNCTION grasUnlock ##### -->
1251 <para>
1252
1253 </para>
1254
1255 @Returns: 
1256
1257 <!-- ##### FUNCTION grasUserdataGet ##### -->
1258 <para>
1259
1260 </para>
1261
1262
1263 <!-- ##### MACRO grasUserdataNew ##### -->
1264 <para>
1265
1266 </para>
1267
1268 @type: 
1269
1270 <!-- ##### FUNCTION grasUserdataSet ##### -->
1271 <para>
1272
1273 </para>
1274
1275 @ud: 
1276
1277 <!-- ##### FUNCTION gras_dict_cursor_next ##### -->
1278 <para>
1279
1280 </para>
1281
1282 @cursor: 
1283 @Returns: 
1284
1285 <!-- ##### FUNCTION gras_dynar_first ##### -->
1286 <para>
1287
1288 </para>
1289
1290 @dynar: 
1291 @cursor: 
1292 @Returns: 
1293
1294 <!-- ##### FUNCTION gras_dynar_next ##### -->
1295 <para>
1296
1297 </para>
1298
1299 @dynar: 
1300 @cursor: 
1301 @whereto: 
1302 @Returns: 
1303
1304 <!-- ##### FUNCTION gras_log_parent_set ##### -->
1305 <para>
1306
1307 </para>
1308
1309 @cat: 
1310 @parent: 
1311
1312 <!-- ##### FUNCTION gras_log_threshold_set ##### -->
1313 <para>
1314
1315 </para>
1316
1317 @cat: 
1318 @thresholdPriority: 
1319