From fa080de7afc95aa1c19a6e6fc0e0708ced2eadc4 Mon Sep 17 00:00:00 2001 From: Joseph Hunkeler Date: Wed, 8 Jul 2015 20:46:52 -0400 Subject: Initial commit --- vendor/voclient/libsamp/doc/html/annotated.html | 36 + vendor/voclient/libsamp/doc/html/classes.html | 36 + vendor/voclient/libsamp/doc/html/doxygen.css | 441 ++ vendor/voclient/libsamp/doc/html/doxygen.png | Bin 0 -> 1281 bytes vendor/voclient/libsamp/doc/html/files.html | 46 + vendor/voclient/libsamp/doc/html/functions.html | 170 + .../voclient/libsamp/doc/html/functions_vars.html | 170 + vendor/voclient/libsamp/doc/html/globals.html | 61 + vendor/voclient/libsamp/doc/html/globals_0x6c.html | 56 + vendor/voclient/libsamp/doc/html/globals_0x6d.html | 59 + vendor/voclient/libsamp/doc/html/globals_0x6e.html | 65 + vendor/voclient/libsamp/doc/html/globals_0x6f.html | 55 + vendor/voclient/libsamp/doc/html/globals_0x70.html | 56 + vendor/voclient/libsamp/doc/html/globals_0x73.html | 671 ++ vendor/voclient/libsamp/doc/html/globals_defs.html | 48 + vendor/voclient/libsamp/doc/html/globals_func.html | 652 ++ vendor/voclient/libsamp/doc/html/globals_type.html | 57 + vendor/voclient/libsamp/doc/html/globals_vars.html | 68 + vendor/voclient/libsamp/doc/html/index.html | 25 + .../voclient/libsamp/doc/html/sampClient_8c.html | 497 ++ .../voclient/libsamp/doc/html/sampCommands_8c.html | 362 + vendor/voclient/libsamp/doc/html/sampDecl_8h.html | 6737 +++++++++++++++++++ .../libsamp/doc/html/sampDecl_8h_source.html | 410 ++ .../voclient/libsamp/doc/html/sampHandlers_8c.html | 1819 +++++ vendor/voclient/libsamp/doc/html/sampHub_8c.html | 624 ++ vendor/voclient/libsamp/doc/html/sampList_8c.html | 544 ++ vendor/voclient/libsamp/doc/html/sampLog_8c.html | 169 + .../voclient/libsamp/doc/html/sampMTypes_8c.html | 1012 +++ vendor/voclient/libsamp/doc/html/sampMap_8c.html | 593 ++ .../voclient/libsamp/doc/html/sampMethods_8c.html | 294 + vendor/voclient/libsamp/doc/html/sampMsg_8c.html | 163 + vendor/voclient/libsamp/doc/html/sampParam_8c.html | 392 ++ vendor/voclient/libsamp/doc/html/sampUtil_8c.html | 278 + vendor/voclient/libsamp/doc/html/samp_8c.html | 1285 ++++ vendor/voclient/libsamp/doc/html/samp_8h.html | 7080 ++++++++++++++++++++ .../voclient/libsamp/doc/html/samp_8h_source.html | 481 ++ vendor/voclient/libsamp/doc/html/structClient.html | 61 + vendor/voclient/libsamp/doc/html/structHub.html | 287 + vendor/voclient/libsamp/doc/html/structSamp.html | 479 ++ vendor/voclient/libsamp/doc/html/structSubs.html | 111 + vendor/voclient/libsamp/doc/html/structappMD.html | 174 + vendor/voclient/libsamp/doc/html/tab_b.gif | Bin 0 -> 35 bytes vendor/voclient/libsamp/doc/html/tab_l.gif | Bin 0 -> 706 bytes vendor/voclient/libsamp/doc/html/tab_r.gif | Bin 0 -> 2585 bytes vendor/voclient/libsamp/doc/html/tabs.css | 105 + 45 files changed, 26729 insertions(+) create mode 100644 vendor/voclient/libsamp/doc/html/annotated.html create mode 100644 vendor/voclient/libsamp/doc/html/classes.html create mode 100644 vendor/voclient/libsamp/doc/html/doxygen.css create mode 100644 vendor/voclient/libsamp/doc/html/doxygen.png create mode 100644 vendor/voclient/libsamp/doc/html/files.html create mode 100644 vendor/voclient/libsamp/doc/html/functions.html create mode 100644 vendor/voclient/libsamp/doc/html/functions_vars.html create mode 100644 vendor/voclient/libsamp/doc/html/globals.html create mode 100644 vendor/voclient/libsamp/doc/html/globals_0x6c.html create mode 100644 vendor/voclient/libsamp/doc/html/globals_0x6d.html create mode 100644 vendor/voclient/libsamp/doc/html/globals_0x6e.html create mode 100644 vendor/voclient/libsamp/doc/html/globals_0x6f.html create mode 100644 vendor/voclient/libsamp/doc/html/globals_0x70.html create mode 100644 vendor/voclient/libsamp/doc/html/globals_0x73.html create mode 100644 vendor/voclient/libsamp/doc/html/globals_defs.html create mode 100644 vendor/voclient/libsamp/doc/html/globals_func.html create mode 100644 vendor/voclient/libsamp/doc/html/globals_type.html create mode 100644 vendor/voclient/libsamp/doc/html/globals_vars.html create mode 100644 vendor/voclient/libsamp/doc/html/index.html create mode 100644 vendor/voclient/libsamp/doc/html/sampClient_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampCommands_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampDecl_8h.html create mode 100644 vendor/voclient/libsamp/doc/html/sampDecl_8h_source.html create mode 100644 vendor/voclient/libsamp/doc/html/sampHandlers_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampHub_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampList_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampLog_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampMTypes_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampMap_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampMethods_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampMsg_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampParam_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/sampUtil_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/samp_8c.html create mode 100644 vendor/voclient/libsamp/doc/html/samp_8h.html create mode 100644 vendor/voclient/libsamp/doc/html/samp_8h_source.html create mode 100644 vendor/voclient/libsamp/doc/html/structClient.html create mode 100644 vendor/voclient/libsamp/doc/html/structHub.html create mode 100644 vendor/voclient/libsamp/doc/html/structSamp.html create mode 100644 vendor/voclient/libsamp/doc/html/structSubs.html create mode 100644 vendor/voclient/libsamp/doc/html/structappMD.html create mode 100644 vendor/voclient/libsamp/doc/html/tab_b.gif create mode 100644 vendor/voclient/libsamp/doc/html/tab_l.gif create mode 100644 vendor/voclient/libsamp/doc/html/tab_r.gif create mode 100644 vendor/voclient/libsamp/doc/html/tabs.css (limited to 'vendor/voclient/libsamp/doc/html') diff --git a/vendor/voclient/libsamp/doc/html/annotated.html b/vendor/voclient/libsamp/doc/html/annotated.html new file mode 100644 index 00000000..50be4f37 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/annotated.html @@ -0,0 +1,36 @@ + + +SAMP Client Library: Data Structures + + + + + +
+

Data Structures

Here are the data structures with brief descriptions: + + + + + +
appMD
Client
Hub
Samp
Subs
+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/classes.html b/vendor/voclient/libsamp/doc/html/classes.html new file mode 100644 index 00000000..6ce31513 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/classes.html @@ -0,0 +1,36 @@ + + +SAMP Client Library: Alphabetical List + + + + + +
+

Data Structure Index

A | C | H | S

+ +
  A  
+
  C  
+
  H  
+
  S  
+		Subs   
appMD   Client   Hub   Samp   

A | C | H | S

+

+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/doxygen.css b/vendor/voclient/libsamp/doc/html/doxygen.css new file mode 100644 index 00000000..3767dc95 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/doxygen.css @@ -0,0 +1,441 @@ +body, table, div, p, dl { + font-family: Lucida Grande, Verdana, Geneva, Arial, sans-serif; + font-size: 12px; +} + +/* @group Heading Levels */ + +h1 { + text-align: center; + font-size: 150%; +} + +h2 { + font-size: 120%; +} + +h3 { + font-size: 100%; +} + +/* @end */ + +caption { + font-weight: bold; +} + +div.qindex, div.navtab{ + background-color: #e8eef2; + border: 1px solid #84b0c7; + text-align: center; + margin: 2px; + padding: 2px; +} + +div.qindex, div.navpath { + width: 100%; + line-height: 140%; +} + +div.navtab { + margin-right: 15px; +} + +/* @group Link Styling */ + +a { + color: #153788; + font-weight: normal; + text-decoration: none; +} + +.contents a:visited { + color: #1b77c5; +} + +a:hover { + text-decoration: underline; +} + +a.qindex { + font-weight: bold; +} + +a.qindexHL { + font-weight: bold; + background-color: #6666cc; + color: #ffffff; + border: 1px double #9295C2; +} + +.contents a.qindexHL:visited { + color: #ffffff; +} + +a.el { + font-weight: bold; +} + +a.elRef { +} + +a.code { +} + +a.codeRef { +} + +/* @end */ + +dl.el { + margin-left: -1cm; +} + +.fragment { + font-family: monospace, fixed; + font-size: 105%; +} + +pre.fragment { + border: 1px solid #CCCCCC; + background-color: #f5f5f5; + padding: 4px 6px; + margin: 4px 8px 4px 2px; +} + +div.ah { + background-color: black; + font-weight: bold; + color: #ffffff; + margin-bottom: 3px; + margin-top: 3px +} + +div.groupHeader { + margin-left: 16px; + margin-top: 12px; + margin-bottom: 6px; + font-weight: bold; +} + +div.groupText { + margin-left: 16px; + font-style: italic; +} + +body { + background: white; + color: black; + margin-right: 20px; + margin-left: 20px; +} + +td.indexkey { + background-color: #e8eef2; + font-weight: bold; + border: 1px solid #CCCCCC; + margin: 2px 0px 2px 0; + padding: 2px 10px; +} + +td.indexvalue { + background-color: #e8eef2; + border: 1px solid #CCCCCC; + padding: 2px 10px; + margin: 2px 0px; +} + +tr.memlist { + background-color: #f0f0f0; +} + +p.formulaDsp { + text-align: center; +} + +img.formulaDsp { + +} + +img.formulaInl { + vertical-align: middle; +} + +/* @group Code Colorization */ + +span.keyword { + color: #008000 +} + +span.keywordtype { + color: #604020 +} + +span.keywordflow { + color: #e08000 +} + +span.comment { + color: #800000 +} + +span.preprocessor { + color: #806020 +} + +span.stringliteral { + color: #002080 +} + +span.charliteral { + color: #008080 +} + +span.vhdldigit { + color: #ff00ff +} + +span.vhdlchar { + color: #000000 +} + +span.vhdlkeyword { + color: #700070 +} + +span.vhdllogic { + color: #ff0000 +} + +/* @end */ + +.search { + color: #003399; + font-weight: bold; +} + +form.search { + margin-bottom: 0px; + margin-top: 0px; +} + +input.search { + font-size: 75%; + color: #000080; + font-weight: normal; + background-color: #e8eef2; +} + +td.tiny { + font-size: 75%; +} + +.dirtab { + padding: 4px; + border-collapse: collapse; + border: 1px solid #84b0c7; +} + +th.dirtab { + background: #e8eef2; + font-weight: bold; +} + +hr { + height: 0; + border: none; + border-top: 1px solid #666; +} + +/* @group Member Descriptions */ + +.mdescLeft, .mdescRight, +.memItemLeft, .memItemRight, +.memTemplItemLeft, .memTemplItemRight, .memTemplParams { + background-color: #FAFAFA; + border: none; + margin: 4px; + padding: 1px 0 0 8px; +} + +.mdescLeft, .mdescRight { + padding: 0px 8px 4px 8px; + color: #555; +} + +.memItemLeft, .memItemRight, .memTemplParams { + border-top: 1px solid #ccc; +} + +.memTemplParams { + color: #606060; +} + +/* @end */ + +/* @group Member Details */ + +/* Styles for detailed member documentation */ + +.memtemplate { + font-size: 80%; + color: #606060; + font-weight: normal; + margin-left: 3px; +} + +.memnav { + background-color: #e8eef2; + border: 1px solid #84b0c7; + text-align: center; + margin: 2px; + margin-right: 15px; + padding: 2px; +} + +.memitem { + padding: 0; +} + +.memname { + white-space: nowrap; + font-weight: bold; +} + +.memproto, .memdoc { + border: 1px solid #84b0c7; +} + +.memproto { + padding: 0; + background-color: #d5e1e8; + font-weight: bold; + -webkit-border-top-left-radius: 8px; + -webkit-border-top-right-radius: 8px; + -moz-border-radius-topleft: 8px; + -moz-border-radius-topright: 8px; +} + +.memdoc { + padding: 2px 5px; + background-color: #eef3f5; + border-top-width: 0; + -webkit-border-bottom-left-radius: 8px; + -webkit-border-bottom-right-radius: 8px; + -moz-border-radius-bottomleft: 8px; + -moz-border-radius-bottomright: 8px; +} + +.paramkey { + text-align: right; +} + +.paramtype { + white-space: nowrap; +} + +.paramname { + color: #602020; + white-space: nowrap; +} +.paramname em { + font-style: normal; +} + +/* @end */ + +/* @group Directory (tree) */ + +/* for the tree view */ + +.ftvtree { + font-family: sans-serif; + margin: 0.5em; +} + +/* these are for tree view when used as main index */ + +.directory { + font-size: 9pt; + font-weight: bold; +} + +.directory h3 { + margin: 0px; + margin-top: 1em; + font-size: 11pt; +} + +/* +The following two styles can be used to replace the root node title +with an image of your choice. Simply uncomment the next two styles, +specify the name of your image and be sure to set 'height' to the +proper pixel height of your image. +*/ + +/* +.directory h3.swap { + height: 61px; + background-repeat: no-repeat; + background-image: url("yourimage.gif"); +} +.directory h3.swap span { + display: none; +} +*/ + +.directory > h3 { + margin-top: 0; +} + +.directory p { + margin: 0px; + white-space: nowrap; +} + +.directory div { + display: none; + margin: 0px; +} + +.directory img { + vertical-align: -30%; +} + +/* these are for tree view when not used as main index */ + +.directory-alt { + font-size: 100%; + font-weight: bold; +} + +.directory-alt h3 { + margin: 0px; + margin-top: 1em; + font-size: 11pt; +} + +.directory-alt > h3 { + margin-top: 0; +} + +.directory-alt p { + margin: 0px; + white-space: nowrap; +} + +.directory-alt div { + display: none; + margin: 0px; +} + +.directory-alt img { + vertical-align: -30%; +} + +/* @end */ + +address { + font-style: normal; + color: #333; +} diff --git a/vendor/voclient/libsamp/doc/html/doxygen.png b/vendor/voclient/libsamp/doc/html/doxygen.png new file mode 100644 index 00000000..f0a274bb Binary files /dev/null and b/vendor/voclient/libsamp/doc/html/doxygen.png differ diff --git a/vendor/voclient/libsamp/doc/html/files.html b/vendor/voclient/libsamp/doc/html/files.html new file mode 100644 index 00000000..cb9fd771 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/files.html @@ -0,0 +1,46 @@ + + +SAMP Client Library: File Index + + + + + +
+

File List

Here is a list of all documented files with brief descriptions: + + + + + + + + + + + + + + + +
samp.cTop-level interface to the SAMP library
samp.h [code]SAMP interface include file
sampClient.cClient callable methods
sampCommands.cSAMP commands used by app to send administrative messages
sampDecl.h [code]SAMP interface method declarations
sampHandlers.cMessage handlers for the interface
sampHub.cMethods related to the SAMP Hub interface
sampList.c(Internal) interface to support the List structure
sampLog.cSAMP trace and logging interface
sampMap.c(Internal) Interface to support the Map structure
sampMethods.cSAMP methods implemented by a callable client
sampMsg.c(Internal) Interface to Message objects
sampMTypes.cSAMP interface procedures for application mtypes
sampParam.c(Internal) Interface to Param objects
sampUtil.cUtility methods to convert struct pointers to user handles
+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/functions.html b/vendor/voclient/libsamp/doc/html/functions.html new file mode 100644 index 00000000..fcce9c07 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/functions.html @@ -0,0 +1,170 @@ + + +SAMP Client Library: Data Fields + + + + + +
+Here is a list of all documented struct and union fields with links to the struct/union documentation for each field: +

+

- a -

+

- c -

+

- d -

+

- e -

+

- h -

+

- i -

+

- l -

+

- m -

+

- n -

+

- p -

+

- s -

+

- t -

+

- u -

+

- v -

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/functions_vars.html b/vendor/voclient/libsamp/doc/html/functions_vars.html new file mode 100644 index 00000000..6d72cb8e --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/functions_vars.html @@ -0,0 +1,170 @@ + + +SAMP Client Library: Data Fields - Variables + + + + + +
+  +

+

- a -

+

- c -

+

- d -

+

- e -

+

- h -

+

- i -

+

- l -

+

- m -

+

- n -

+

- p -

+

- s -

+

- t -

+

- u -

+

- v -

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals.html b/vendor/voclient/libsamp/doc/html/globals.html new file mode 100644 index 00000000..8e0c8d64 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals.html @@ -0,0 +1,61 @@ + + +SAMP Client Library: Data Fields + + + + + +
+Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation: +

+

- h -

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals_0x6c.html b/vendor/voclient/libsamp/doc/html/globals_0x6c.html new file mode 100644 index 00000000..8bfefc64 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals_0x6c.html @@ -0,0 +1,56 @@ + + +SAMP Client Library: Data Fields + + + + + +
+Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation: +

+

- l -

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals_0x6d.html b/vendor/voclient/libsamp/doc/html/globals_0x6d.html new file mode 100644 index 00000000..8e11ad5f --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals_0x6d.html @@ -0,0 +1,59 @@ + + +SAMP Client Library: Data Fields + + + + + +
+Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation: +

+

- m -

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals_0x6e.html b/vendor/voclient/libsamp/doc/html/globals_0x6e.html new file mode 100644 index 00000000..3d4bdbf9 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals_0x6e.html @@ -0,0 +1,65 @@ + + +SAMP Client Library: Data Fields + + + + + +
+Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation: +

+

- n -

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals_0x6f.html b/vendor/voclient/libsamp/doc/html/globals_0x6f.html new file mode 100644 index 00000000..9b6f518f --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals_0x6f.html @@ -0,0 +1,55 @@ + + +SAMP Client Library: Data Fields + + + + + +
+Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation: +

+

- o -

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals_0x70.html b/vendor/voclient/libsamp/doc/html/globals_0x70.html new file mode 100644 index 00000000..e8e3097e --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals_0x70.html @@ -0,0 +1,56 @@ + + +SAMP Client Library: Data Fields + + + + + +
+Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation: +

+

- p -

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals_0x73.html b/vendor/voclient/libsamp/doc/html/globals_0x73.html new file mode 100644 index 00000000..96e37b25 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals_0x73.html @@ -0,0 +1,671 @@ + + +SAMP Client Library: Data Fields + + + + + +
+Here is a list of all documented functions, variables, defines, enums, and typedefs with links to the documentation: +

+

- s -

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals_defs.html b/vendor/voclient/libsamp/doc/html/globals_defs.html new file mode 100644 index 00000000..abc68a7f --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals_defs.html @@ -0,0 +1,48 @@ + + +SAMP Client Library: Data Fields + + + + + +
+  +

+

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals_func.html b/vendor/voclient/libsamp/doc/html/globals_func.html new file mode 100644 index 00000000..19f275e2 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals_func.html @@ -0,0 +1,652 @@ + + +SAMP Client Library: Data Fields + + + + + +
+  +

+

- s -

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals_type.html b/vendor/voclient/libsamp/doc/html/globals_type.html new file mode 100644 index 00000000..8f5f5751 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals_type.html @@ -0,0 +1,57 @@ + + +SAMP Client Library: Data Fields + + + + + +
+  +

+

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/globals_vars.html b/vendor/voclient/libsamp/doc/html/globals_vars.html new file mode 100644 index 00000000..7fab33c1 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/globals_vars.html @@ -0,0 +1,68 @@ + + +SAMP Client Library: Data Fields + + + + + +
+  +

+

+
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/index.html b/vendor/voclient/libsamp/doc/html/index.html new file mode 100644 index 00000000..baf13dea --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/index.html @@ -0,0 +1,25 @@ + + +SAMP Client Library: Main Page + + + + + +
+

SAMP Client Library Documentation

+

+

v1.0

+
Generated on Wed Feb 27 21:10:15 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampClient_8c.html b/vendor/voclient/libsamp/doc/html/sampClient_8c.html new file mode 100644 index 00000000..5627b620 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampClient_8c.html @@ -0,0 +1,497 @@ + + +SAMP Client Library: sampClient.c File Reference + + + + + +
+

sampClient.c File Reference

Client callable methods. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Functions

void samp_notify (handle_t handle, String recipId, Map msg)
 Make a notify() call to the Hub.
List samp_notifyAll (handle_t handle, Map msg)
 Make a notifyAll() call to the Hub.
String samp_call (handle_t handle, String recipId, String msg_tag, Map msg)
 Make a call() call to the Hub.
int samp_callAll (handle_t handle, String msg_tag, Map msg)
 Make a callAll() call to the Hub.
int samp_callAndWait (handle_t handle, String recipId, String msg_tag, Map msg)
 Make a callAndWait() call to the Hub.
int samp_Reply (handle_t handle, String msg_id, Map response)
 Reply to a message.
String samp_clientName (handle_t handle, String pubId)
 Get the Client name from a pubic-id.
int samp_setErr (handle_t handle, Map resp)
 Set the error response string.
String samp_getErr (handle_t handle)
 Get the error response string.
+

Detailed Description

+Client callable methods. +

+SAMPCLIENT.C -- Client callable methods.

+samp_notify (handle, recipId, msg_map) list = samp_notifyAll (handle, msg_map) str = samp_call (handle, recipId, tag, msg_map) map = samp_callAll (handle, msg_tag, msg_map) map = samp_callAndWait (handle, recipId, msg_tag, msg_map) stat = samp_Reply (handle, msg_id, resp_map)

+str = samp_clientName (handle, pubId) stat = samp_setErr (handle, resp_map) str = samp_getErr (handle)

+

Author:
Mike Fitzpatrick
+
Date:
7/10/11
+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
String samp_call (handle_t  handle,
String  recipId,
String  msg_tag,
Map  msg 
)
+
+
+ +

+Make a call() call to the Hub. +

+SAMP_CALL -- Make a call() call to the Hub

+

Parameters:
+ + + + + +
handle samp struct handle
recipId recipient ID
msg_tag message tag
msg message map
+
+
Returns:
message ID
+ +

References Samp::debug, Samp::errortxt, Samp::hub, hub, Hub::id, Hub::privateKey, samp_app2id(), and Samp::trace.

+ +

Referenced by samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_callAll (handle_t  handle,
String  msg_tag,
Map  msg 
)
+
+
+ +

+Make a callAll() call to the Hub. +

+SAMP_CALLALL -- Make a callAll() call to the Hub

+

Parameters:
+ + + + +
handle samp struct handle
msg_tag message tag
msg message map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::debug, Samp::errortxt, Samp::hub, hub, Hub::id, Hub::privateKey, samp_setErr(), and Samp::trace.

+ +

Referenced by samp_Ping(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_callAndWait (handle_t  handle,
String  recipId,
String  msg_tag,
Map  msg 
)
+
+
+ +

+Make a callAndWait() call to the Hub. +

+SAMP_CALLANDWAIT -- Make a callAndWait() call to the Hub

+

Parameters:
+ + + + + +
handle samp struct handle
recipId recipient ID
msg_tag message tag
msg message map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::debug, Samp::errortxt, Samp::hub, hub, Hub::id, Hub::privateKey, samp_app2id(), samp_setErr(), Hub::timeout, and Samp::trace.

+ +

Referenced by samp_Ping(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
String samp_clientName (handle_t  handle,
String  pubId 
)
+
+
+ +

+Get the Client name from a pubic-id. +

+SAMP_CLIENTNAME -- Get the Client name from a pubic-id.

+

Parameters:
+ + + +
handle samp struct handle
pubId public ID
+
+
Returns:
declared application name
+ +
+

+ +

+
+ + + + + + + + + +
String samp_getErr (handle_t  handle  ) 
+
+
+ +

+Get the error response string. +

+SAMP_GETERR -- Get the error response string.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
Error text string
+ +

References Samp::errortxt.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_notify (handle_t  handle,
String  recipId,
Map  msg 
)
+
+
+ +

+Make a notify() call to the Hub. +

+SAMP_NOTIFY -- Make a notify() call to the Hub

+

Parameters:
+ + + + +
handle samp struct handle
recipId recipient ID
msg message map
+
+
Returns:
nothing
+ +

References Samp::hub, hub, Hub::id, Hub::privateKey, samp_app2id(), and samp_nullResponse().

+ +

Referenced by samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
List samp_notifyAll (handle_t  handle,
Map  msg 
)
+
+
+ +

+Make a notifyAll() call to the Hub. +

+SAMP_NOTIFYALL -- Make a notifyAll() call to the Hub

+

Parameters:
+ + + +
handle samp struct handle
msg message map
+
+
Returns:
nothing
+ +

References Samp::debug, Samp::errortxt, Samp::hub, hub, Hub::id, Hub::privateKey, and Samp::trace.

+ +

Referenced by samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_Reply (handle_t  handle,
String  msg_id,
Map  response 
)
+
+
+ +

+Reply to a message. +

+SAMP_REPLY -- Reply to a message. All we do here is send the reply message, we require that the response Map already be defined.

+

Parameters:
+ + + + +
handle samp struct handle
msg_id message ID
response response map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, Hub::id, Hub::privateKey, and samp_nullResponse().

+ +

Referenced by samp_receiveCall().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_setErr (handle_t  handle,
Map  resp 
)
+
+
+ +

+Set the error response string. +

+SAMP_SETERR -- Set the error response string/code.

+

Parameters:
+ + + +
handle samp struct handle
resp Response map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::errortxt.

+ +

Referenced by samp_callAll(), samp_callAndWait(), samp_Ping(), and samp_sendMsg().

+ +
+

+

+
Generated on Wed Feb 27 21:10:15 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampCommands_8c.html b/vendor/voclient/libsamp/doc/html/sampCommands_8c.html new file mode 100644 index 00000000..9e26df34 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampCommands_8c.html @@ -0,0 +1,362 @@ + + +SAMP Client Library: sampCommands.c File Reference + + + + + +
+

sampCommands.c File Reference

SAMP commands used by app to send administrative messages. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include <time.h>
+#include <ctype.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Functions

int samp_Register (handle_t handle)
 Register with the Hub using the currently stored metadata.
int samp_UnRegister (handle_t handle)
 Un-Register from the hub.
int samp_DeclareMetadata (handle_t handle)
 (Re)Declare all of our metadata.
int samp_Ping (handle_t handle, String appName)
 Ping the hub/app to see if it is alive (returns >0).
Map samp_GetMetadata (handle_t handle, String pubId)
 Get the metadata for a specified app.
int samp_DeclareSubscriptions (handle_t handle)
 Declare the messages we're interested in.
+Map samp_GetSubscriptions (handle_t handle, String pubId)
List samp_GetRegisteredClients (handle_t handle)
 Get public-ids of the registered clients.
List samp_GetSubscribedClients (handle_t handle, String mtype)
 Get clients matching the mtype subscription.
+

Detailed Description

+SAMP commands used by app to send administrative messages. +

+SAMPCOMMANDS.C -- SAMP commands used by app to send administrative messages.

+stat = samp_Register (handle) stat = samp_UnRegister (handle) stat = samp_DeclareMetadata (handle) stat = samp_Ping (handle, appName) map = samp_GetMetadata (handle, pubId) samp_DeclareSubscriptions (handle) map = samp_GetSubscriptions (handle) list = samp_GetRegisteredClients (handle) list = samp_GetSubscribedClients (handle, mtype)

+

Author:
Mike Fitzpatrick
+
Date:
7/10/11
+

Function Documentation

+ +
+
+ + + + + + + + + +
int samp_DeclareMetadata (handle_t  handle  ) 
+
+
+ +

+(Re)Declare all of our metadata. +

+SAMP_DECLAREMETATA -- (Re)Declare all of our metadata.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, and samp_hubDeclareMetadata().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_DeclareSubscriptions (handle_t  handle  ) 
+
+
+ +

+Declare the messages we're interested in. +

+SAMP_DECLARESUBSCRIPIONS -- Declare the messages we're interested in.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, and samp_hubDeclareSubscriptions().

+ +

Referenced by samp_Unsubscribe().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
Map samp_GetMetadata (handle_t  handle,
String  pubId 
)
+
+
+ +

+Get the metadata for a specified app. +

+SAMP_GETMETADATA -- Get the metadata for a specified app.

+

Parameters:
+ + + +
handle samp struct handle
pubId App public-id
+
+
Returns:
Map to message response
+ +

References Samp::errortxt, Samp::hub, hub, Hub::id, and Hub::privateKey.

+ +

Referenced by samp_mapClients().

+ +
+

+ +

+
+ + + + + + + + + +
List samp_GetRegisteredClients (handle_t  handle  ) 
+
+
+ +

+Get public-ids of the registered clients. +

+SAMP_GETREGISTEREDCLIENTS -- Get public-ids of the registered clients.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
handle to list of registered clients
+ +

References Samp::hub, Hub::id, Hub::privateKey, samp_listLen(), samp_newList(), and samp_setStringInList().

+ +

Referenced by samp_mapClients().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
List samp_GetSubscribedClients (handle_t  handle,
String  mtype 
)
+
+
+ +

+Get clients matching the mtype subscription. +

+SAMP_GETSUBSCRIBEDCLIENTS -- Get clients matching the mtype subscription.

+

Parameters:
+ + + +
handle samp struct handle
mtype mtype string
+
+
Returns:
handle to list of clients having mtype subscription
+ +

References Samp::hub, Hub::id, Hub::privateKey, samp_listLen(), samp_newList(), and samp_setStringInList().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_Ping (handle_t  handle,
String  appName 
)
+
+
+ +

+Ping the hub/app to see if it is alive (returns >0). +

+SAMP_PING -- Ping the hub/app to see if it is alive (returns >0).

+

Parameters:
+ + + +
handle samp struct handle
appName application name
+
+
Returns:
OK or ERR if no response
+ +

References Samp::hub, samp_app2id(), samp_callAll(), samp_callAndWait(), samp_freeMap(), samp_freeMsg(), samp_hubPing(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_setErr().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_Register (handle_t  handle  ) 
+
+
+ +

+Register with the Hub using the currently stored metadata. +

+SAMP_REGISTER -- Register with the Hub using the currently stored metadata.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, Hub::hubId, Hub::id, Hub::privateKey, samp_replyStatus(), Hub::secret, and Hub::selfId.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_UnRegister (handle_t  handle  ) 
+
+
+ +

+Un-Register from the hub. +

+SAMP_UNREGISTER -- Un-Register from the hub.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, and samp_hubUnRegister().

+ +
+

+

+
Generated on Wed Feb 27 21:10:15 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampDecl_8h.html b/vendor/voclient/libsamp/doc/html/sampDecl_8h.html new file mode 100644 index 00000000..f7993df2 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampDecl_8h.html @@ -0,0 +1,6737 @@ + + +SAMP Client Library: sampDecl.h File Reference + + + + + +
+

sampDecl.h File Reference

SAMP interface method declarations. +More... +

+ +

+Go to the source code of this file. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Data Structures

struct  appMD
struct  Subs
struct  Client
struct  Hub
struct  Samp

Defines

#define SZ_NAME   256
+#define SZ_LINE   256
+#define SZ_SECRET   64
+#define SZ_DESC   8192
+#define SZ_URL   1024
+#define SZ_CMD   1024
+#define MAX_SAMPS   16
+#define MAX_HUBS   16
+#define MAX_MDATTRS   32
+#define MAX_SUBS   256
+#define MAX_CLIENTS   32
+#define MAX_ROWS   256
+#define MSG_SYNC   0
+#define MSG_ASYNC   1
+#define MSG_NOTIFY   2
+#define DEF_CALLMODE   MSG_ASYNC

Typedefs

+typedef XINT handle_t
typedef int Map
typedef int List
typedef int Msg
typedef int Param
typedef char * String
+typedef struct appMD * appMDP
+typedef struct Subs * SubsP
+typedef struct Client * ClientP
+typedef struct Hub * HubP
+typedef struct Samp * SampP

Functions

handle_t sampInit (String appName, String description)
 Initialize the SAMP interface.
void samp_Metadata (handle_t handle, String field, String value)
 Set a metadata field value for the application.
void samp_Subscribe (handle_t handle, String mtype, void *func)
 Subscribe to a given mtype.
void samp_Unsubscribe (handle_t handle, String mtype)
 Unsubscribe to a given mtype.
int sampStartup (handle_t handle)
 Startup the SAMP interface to send/receive messages.
int sampShutdown (handle_t handle)
 Shut down the active SAMP interface.
void sampClose (handle_t handle)
 Close the SAMP interface and free resources.
void samp_setSyncMode (handle_t handle)
 Set the calling mode to use synchronous messaging.
void samp_setASyncMode (handle_t handle)
 Set the calling mode to use asynchronous messaging.
void samp_setNotifyMode (handle_t handle)
 Set the calling mode to use notification messaging.
void samp_setCallByRef (handle_t handle)
 Have interface call user handlers by reference.
void samp_setCallMode (handle_t handle, int mode)
 Set the default calling mode (synch or asynch).
void samp_setReplyCallback (handle_t handle, int *func)
 Set the Reply callback. samp_setReplyCallback (handle_t handle, int *func).
void samp_setResponseCallback (handle_t handle, int *func)
 Set the Response callback. samp_setResponseCallback (handle_t handle, int *func).
void samp_setTimeout (handle_t handle, int timeout)
 Set the message timeout value (in seconds).
+void samp_setAppName (handle_t handle, String name)
void samp_setAppVersion (handle_t handle, String version)
 Set the application name string.
void samp_defaultReplyHandler (handle_t handle)
 The interface's default Reply handler.
+void samp_deaultfResponseHandler (handle_t handle)
int samp_replyStatus (handle_t handle)
 Reply with the status of the last message sent.
int samp_mapClients (handle_t handle)
int samp_listClients (handle_t handle)
int samp_addClient (handle_t handle, String name, String id)
int samp_removeClient (handle_t handle, String id)
Map samp_getOKMap (void)
Map samp_getNullMap (void)
int samp_Register (handle_t handle)
 Register with the Hub using the currently stored metadata.
int samp_UnRegister (handle_t handle)
 Un-Register from the hub.
int samp_DeclareMetadata (handle_t handle)
 (Re)Declare all of our metadata.
int samp_Ping (handle_t handle, String appName)
 Ping the hub/app to see if it is alive (returns >0).
Map samp_GetMetadata (handle_t handle, String pubId)
 Get the metadata for a specified app.
int samp_DeclareSubscriptions (handle_t handle)
 Declare the messages we're interested in.
+Map samp_GetSubscriptions (handle_t handle, String pubId)
List samp_GetRegisteredClients (handle_t handle)
 Get public-ids of the registered clients.
List samp_GetSubscribedClients (handle_t handle, String mtype)
 Get clients matching the mtype subscription.
int samp_tableLoadVOTable (handle_t handle, String recip, String url, String tableId, String name)
 Tell an app to load a VOTable.
int samp_tableLoadFITS (handle_t handle, String recip, String url, String tableId, String name)
 Tell an app to load a FITS table.
int samp_imageLoadFITS (handle_t handle, String recip, String url, String imageId, String name)
 Tell an app to load a FITS image.
int samp_tableHighlightRow (handle_t handle, String recip, String tableId, String url, int row)
 Tell an app to highlight a table row.
int samp_tableSelectRowList (handle_t handle, String recip, String tableId, String url, int rows[], int nrows)
 Tell an app to select a list of table rows.
int samp_coordPointAtSky (handle_t handle, String recip, float ra, float dec)
 Tell an app to point at an RA/Dec coordinate.
int samp_specLoadSSAGeneric (handle_t handle, String recip, String url, Map meta, String spectrumId, String name)
 Load a generic spectrum from an SSA service.
int samp_cmdExec (handle_t handle, String recip, String cmd)
 Execute a command in a remote application.
char * samp_envGet (handle_t handle, String recip, String name)
 Get an environment variable in a remote application.
int samp_envSet (handle_t handle, String recip, String name, String value)
 Set an environment variable in a remote application.
char * samp_paramGet (handle_t handle, String recip, String name)
 Get a parameter variable in a remote application.
int samp_paramSet (handle_t handle, String recip, String name, String value)
 Set an parameter variable in a remote application.
int samp_bibLoad (handle_t handle, String recip, String bibcode)
 Exchange a bibcode.
int samp_resourceLoad (handle_t handle, String recip, String type, String name, Map resMap)
 Exchange a resource list.
int samp_sendGeneric (handle_t handle, String recip, String mtype, String args[])
 Send a geenric message.
int samp_sendMsg (handle_t handle, String recip, Map msg)
 Send the specified message.
void samp_notify (handle_t handle, String recipId, Map msg)
 Make a notify() call to the Hub.
List samp_notifyAll (handle_t handle, Map msg)
 Make a notifyAll() call to the Hub.
String samp_call (handle_t handle, String recipId, String tag, Map msg)
 Make a call() call to the Hub.
int samp_callAll (handle_t handle, String msg_tag, Map msg)
 Make a callAll() call to the Hub.
int samp_callAndWait (handle_t handle, String recipId, String msg_tag, Map msg)
 Make a callAndWait() call to the Hub.
int samp_Reply (handle_t handle, String msg_id, Map resp)
 Reply to a message.
String samp_clientName (handle_t handle, String pubId)
 Get the Client name from a pubic-id.
int samp_setErr (handle_t handle, Map resp)
 Set the error response string.
String samp_getErr (handle_t handle)
 Get the error response string.
int samp_receiveCall (void *data)
 test.echo method
int samp_receiveNotification (void *data)
 receiveNotification () client method.
int samp_receiveResponse (void *data)
 receiveResponse () client method.
void samp_setUserHandler (handle_t handle, String mtype, void *func)
 Set the user-interface handler for the mtype.
void samp_setSampHandler (handle_t handle, String mtype, void *func)
 Set the SAMP interface handler for the mtype.
void * samp_getUserHandler (String mtype)
 Get the User handler for the named mtype.
void * samp_getSampHandler (String mtype)
 Get the Samphandler for the named mtype.
void samp_execUserHandler (String mtype, String sender, String msg_id, Map params)
 Execute the user-defined handler for the mtype.
+int samp_genericMsgHandler (String sender, String mtype, String msg_id, Map msg_map)
int samp_PingHandler (String sender, String mtype, String msg_id, Map msg_map)
 Is app alive and responding to messages?
int samp_StatusHandler (String sender, String mtype, String msg_id, Map msg_map)
 Return status of the task.
int samp_imLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle an image.load.fits message.
int samp_tbLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a generic table.load.* message.
int samp_tbLoadFITSHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a generic table.load.fits message.
int samp_tbLoadVOTHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a generic table.load.votable message.
int samp_specLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a spectrum.load.* message.
int samp_specSSAHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a spectrum.load.ssa-generic message.
int samp_tbHighlightHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a table.highlight.row message.
int samp_tbSelectHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a table.select.rowList message.
int samp_pointAtHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a coord.pointAt.sky message.
int samp_bibcodeHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a bibcode.load message.
int samp_cmdExecHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.cmd.exec message.
int samp_envGetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.env.set message.
int samp_envSetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.env.set message.
int samp_paramGetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.param.set message.
int samp_paramSetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.param.set message.
int samp_resLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resConeHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resSiapHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resSsapHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resTapHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resVOSpaceHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
+void samp_printMessage (String mtype, String sender, String msg_id, Map params)
void samp_printMap (String name, Map map)
int samp_nullResponse (void *data)
+int samp_testEcho (void *data)
handle_t samp_hubOpen (Samp *samp)
 Discover and open a connection to the SAMP Hub.
int samp_hubClose (handle_t handle)
 Close a connection to the Hub.
List samp_getAvailableHubs (handle_t handle)
 Get a list of available Hubs.
+char * samp_getActiveHubName (handle_t handle)
+int samp_getActiveHub (handle_t handle)
+int samp_hubInit (handle_t samp, char *appName, char *descr)
int samp_processHubEvent (String mtype, Map params)
 Determine the type of Hub event mtype.
int samp_hubEvent (String mtype)
 Determine the type of Hub event mtype.
int samp_hubRegister (Hub *hub)
 Send a Register message to the Hub.
int samp_hubUnRegister (Hub *hub)
 Send a UnRegister message to the Hub.
int samp_hubSendShutdown (Hub *hub)
 Send a samp.app.event.shutdown message to the Hub.
int samp_hubSetXmlrpcCallback (Hub *hub)
 Set the client callback and send to Hub.
int samp_hubPing (Hub *hub)
 Ping the Hub to see if it is alive.
int samp_hubDeclareMetadata (Hub *hub)
 Declare "standard" metadata to the Hub.
int samp_hubDeclareSubscriptions (Hub *hub)
 Declare mtype subscriptions to the Hub.
handle_t samp_newList ()
 Create a new List object.
void samp_freeList (List list)
 Free the given List object.
int samp_listLen (List list)
 Get number of elements in a List.
void samp_setStringInList (List list, char *value)
 Set a string in a List (append).
void samp_setMapInList (List list, Map map)
 Set a Map in a List (append).
void samp_setListInList (List list1, List list2)
 Set a List in another List (append).
void samp_setIntInList (List list, int value)
 Set an Int in a List (append).
void samp_setFloatInList (List list, float value)
 Set a Float in a List (append).
char * samp_getStringFromList (List list, int index)
 Get a string from the List.
Map samp_getMapFromList (List list, int index)
 Get a Map from the List.
List samp_getListFromList (List list, int index)
 Get a List from the List.
+int samp_getIntFromList (List list, int index)
float samp_getFloatFromList (List list, int index)
 Get a Float from the List.
handle_t samp_newMap (void)
 Create a new Map object.
void samp_freeMap (Map map)
 Free the given Map object.
+int samp_getMapSize (Map map)
+char * samp_getMapKey (Map map, int index)
+char * samp_getMapVal (Map map, int index)
void samp_setStringInMap (Map map, char *key, char *value)
 Set a string in a Map (append).
void samp_setMapInMap (Map map1, char *key, Map map2)
 Set a Map in a Map (append).
void samp_setListInMap (Map map, char *key, List list)
 Set a List in a Map (append).
void samp_setIntInMap (Map map, char *key, int value)
 Set a Int in a Map (append).
void samp_setFloatInMap (Map map, char *key, float value)
 Set a string in a Map (append).
char * samp_getStringFromMap (Map map, char *key)
 Get a string from the Map.
Map samp_getMapFromMap (Map map, char *key)
 Get a Map from the Map.
List samp_getListFromMap (Map map, char *key)
 Get a LIST from the Map.
int samp_getIntFromMap (Map map, char *key)
 Get a integer from the Map.
float samp_getFloatFromMap (Map map, char *key)
 Get a float from the Map.
Msg samp_newMsg (void)
 Create a new Msg object.
void samp_freeMsg (Msg msg)
 Free the given Msg object.
+void samp_msgMType (Msg msg, String mtype)
void samp_msgParam (Msg msg, Param param)
 Add a parameter to the Msg.
+char * samp_msgTag (void)
Param samp_newParam (void)
 Create a new Param object.
void samp_freeParam (Param param)
 Free the given Msg object.
Param samp_paramInit (Msg msg)
 Get number of Params.
+void samp_addStringParam (Msg msg, char *keyw, String val)
void samp_addMapParam (Msg msg, char *keyw, Map val)
 Add a parameter to the Param.
void samp_addListParam (Msg msg, char *keyw, List val)
 Add a parameter to the Param.
void samp_addIntParam (Msg msg, char *keyw, int val)
 Add a <SAMP int>=""> parameter to the Param.
void samp_addFloatParam (Msg msg, char *keyw, float val)
 Add a <SAMP float>=""> parameter to the Param.
int samp_paramLen (Msg msg)
 Get number of Params.
void sampLog (handle_t handle, char *format,...)
 SAMP message logger.
void sampTrace (handle_t handle, char *format,...)
 SAMP tracer.
+handle_t samp_newHandle (void *ptr)
+void samp_freeHandle (handle_t handle)
+handle_t samp_P2H (void *ptr)
+void * samp_H2P (handle_t handle)
char * samp_app2id (handle_t handle, char *appName)
 Convert an application name to a public-ID.
char * samp_id2app (handle_t handle, char *pubId)
 Convert a public-ID to the application name.
int samp_serverPort (void)
 Return a unique port number for the server.
void samp_printMetadata (handle_t handle, char *name)
 Print the metadata for the application.
char * samp_getMetadata (handle_t handle, char *name)
 Get the metadata item for the application.
+

Detailed Description

+SAMP interface method declarations. +

+SAMPDECL.H -- SAMP interface method declarations.

+

Author:
Mike FItzpatrick
+
Date:
8/10/11
+

Define Documentation

+ +
+
+ + + + +
#define SZ_NAME   256
+
+
+ +

+SAMP String datatype +

Referenced by samp_addClient(), samp_bibcodeHandler(), samp_envGetHandler(), samp_envSetHandler(), samp_execUserHandler(), samp_hubRunning(), samp_imLoadHandler(), samp_mapClients(), samp_paramGetHandler(), samp_paramSetHandler(), samp_removeClient(), samp_resConeHandler(), samp_resLoadHandler(), samp_resourceLoad(), samp_resSiapHandler(), samp_resSsapHandler(), samp_resTapHandler(), samp_resVOSpaceHandler(), samp_sendGeneric(), samp_specLoadHandler(), samp_specSSAHandler(), samp_tbHighlightHandler(), samp_tbLoadFITSHandler(), samp_tbLoadHandler(), samp_tbLoadVOTHandler(), and samp_tbSelectHandler().

+ +
+

+

Typedef Documentation

+ +
+
+ + + + +
typedef int List
+
+
+ +

+SAMP Map datatype +

+

+ +

+
+ + + + +
typedef int Map
+
+
+ +

+generic object handle +

+

+ +

+
+ + + + +
typedef int Msg
+
+
+ +

+SAMP List datatype +

+

+ +

+
+ + + + +
typedef int Param
+
+
+ +

+SAMP Msg datatype +

+

+ +

+
+ + + + +
typedef char* String
+
+
+ +

+SAMP Param datatype +

+

+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_addClient (handle_t  handle,
String  name,
String  id 
)
+
+
+ +

+SAMP_ADDCLIENT -- Add a newly registered client to the list of known apps so we can do the public-private name translation. +

References Samp::clients, Client::name, Samp::nclients, and SZ_NAME.

+ +

Referenced by samp_processHubEvent().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addFloatParam (Msg  msg,
char *  keyw,
float  val 
)
+
+
+ +

+Add a <SAMP float>=""> parameter to the Param. +

+SAMP_ADDFLOATPARAM -- Add a <SAMP float>=""> parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val floating point value
+
+
Returns:
nothing
+ +

References samp_paramInit().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addIntParam (Msg  msg,
char *  keyw,
int  val 
)
+
+
+ +

+Add a <SAMP int>=""> parameter to the Param. +

+SAMP_ADDINTPARAM -- Add a <SAMP int>=""> parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val integer value
+
+
Returns:
nothing
+ +

References samp_paramInit().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addListParam (Msg  msg,
char *  keyw,
List  val 
)
+
+
+ +

+Add a parameter to the Param. +

+SAMP_ADDLISTPARAM -- Add a List parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val value list
+
+
Returns:
nothing
+ +

References samp_paramInit().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addMapParam (Msg  msg,
char *  keyw,
Map  val 
)
+
+
+ +

+Add a parameter to the Param. +

+SAMP_ADDMAPPARAM -- Add a Map parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val value map
+
+
Returns:
nothing
+ +

References samp_paramInit().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char* samp_app2id (handle_t  handle,
char *  appName 
)
+
+
+ +

+Convert an application name to a public-ID. +

+SAMP_APP2ID -- Convert an application name to a public-ID.

+

Parameters:
+ + + +
handle samp struct handle
appName name of registered application
+
+
Returns:
public ID of application
+ +

References Samp::clients, Client::name, and Samp::nclients.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_bibcodeHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a bibcode.load message. +

+SAMP_BIBCODEHANDLER -- Handle a bibcode.load message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_bibLoad (handle_t  handle,
String  recip,
String  bibcode 
)
+
+
+ +

+Exchange a bibcode. +

+SAMP_BIBLOAD -- Exchange a bibcode.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
bibcode Bibcode string
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
String samp_call (handle_t  handle,
String  recipId,
String  msg_tag,
Map  msg 
)
+
+
+ +

+Make a call() call to the Hub. +

+SAMP_CALL -- Make a call() call to the Hub

+

Parameters:
+ + + + + +
handle samp struct handle
recipId recipient ID
msg_tag message tag
msg message map
+
+
Returns:
message ID
+ +

References Samp::debug, Samp::errortxt, Samp::hub, hub, Hub::id, Hub::privateKey, samp_app2id(), and Samp::trace.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_callAll (handle_t  handle,
String  msg_tag,
Map  msg 
)
+
+
+ +

+Make a callAll() call to the Hub. +

+SAMP_CALLALL -- Make a callAll() call to the Hub

+

Parameters:
+ + + + +
handle samp struct handle
msg_tag message tag
msg message map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::debug, Samp::errortxt, Samp::hub, hub, Hub::id, Hub::privateKey, samp_setErr(), and Samp::trace.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_callAndWait (handle_t  handle,
String  recipId,
String  msg_tag,
Map  msg 
)
+
+
+ +

+Make a callAndWait() call to the Hub. +

+SAMP_CALLANDWAIT -- Make a callAndWait() call to the Hub

+

Parameters:
+ + + + + +
handle samp struct handle
recipId recipient ID
msg_tag message tag
msg message map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::debug, Samp::errortxt, Samp::hub, hub, Hub::id, Hub::privateKey, samp_app2id(), samp_setErr(), Hub::timeout, and Samp::trace.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
String samp_clientName (handle_t  handle,
String  pubId 
)
+
+
+ +

+Get the Client name from a pubic-id. +

+SAMP_CLIENTNAME -- Get the Client name from a pubic-id.

+

Parameters:
+ + + +
handle samp struct handle
pubId public ID
+
+
Returns:
declared application name
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_cmdExec (handle_t  handle,
String  recip,
String  cmd 
)
+
+
+ +

+Execute a command in a remote application. +

+SAMP_CMDEXEC -- Execute a command in a remote application.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
cmd Command string
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_cmdExecHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.cmd.exec message. +

+SAMP_CMDEXECHANDLER -- Handle a client.cmd.exec message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), and samp_getUserHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_coordPointAtSky (handle_t  handle,
String  recip,
float  ra,
float  dec 
)
+
+
+ +

+Tell an app to point at an RA/Dec coordinate. +

+SAMP_COORDPOINTATSKY -- Tell an app to point at an RA/Dec coordinate.

+

Parameters:
+ + + + + +
handle samp struct handle
recip name of recipient (or 'all')
ra RA of coord in degrees
dec Dec of coord in degrees
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_addFloatParam(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_DeclareMetadata (handle_t  handle  ) 
+
+
+ +

+(Re)Declare all of our metadata. +

+SAMP_DECLAREMETATA -- (Re)Declare all of our metadata.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, and samp_hubDeclareMetadata().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_DeclareSubscriptions (handle_t  handle  ) 
+
+
+ +

+Declare the messages we're interested in. +

+SAMP_DECLARESUBSCRIPIONS -- Declare the messages we're interested in.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, and samp_hubDeclareSubscriptions().

+ +
+

+ +

+
+ + + + + + + + + +
void samp_defaultReplyHandler (handle_t  handle  ) 
+
+
+ +

+The interface's default Reply handler. +

+SAMP_DEFAULTREPLYHANDLER -- The interface's default Reply handler.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
char* samp_envGet (handle_t  handle,
String  recip,
String  name 
)
+
+
+ +

+Get an environment variable in a remote application. +

+SAMP_ENVGET -- Get an environment variable in a remote application.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
+
+
Returns:
NULL, Value of variable, or list of values
+ +

References Samp::clients, Samp::errortxt, Samp::hub, hub, Hub::id, Client::name, Samp::nclients, Hub::privateKey, samp_app2id(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and Hub::timeout.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_envGetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.env.set message. +

+SAMP_ENVGETHANDLER -- Handle a client.env.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_freeMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_newMap(), samp_setHandlerReply(), samp_setMapInMap(), samp_setStringInMap(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_envSet (handle_t  handle,
String  recip,
String  name,
String  value 
)
+
+
+ +

+Set an environment variable in a remote application. +

+SAMP_ENVSET -- Set an environment variable in a remote application.

+

Parameters:
+ + + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
value Value of variable or NULL
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_envSetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.env.set message. +

+SAMP_ENVSETHANDLER -- Handle a client.env.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
void samp_execUserHandler (String  sender,
String  mtype,
String  msg_id,
Map  params 
)
+
+
+ +

+Execute the user-defined handler for the mtype. +

+SAMP_EXECUSERHANDLER -- Execute the user-defined handler for the mtype.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message-id string
params Mtype parameter Map
+
+
Returns:
nothing
+ +

References Samp::defaultUserFunc, Samp::handlerMode, samp_getFloatFromMap(), samp_getIntFromMap(), samp_getListFromMap(), samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_listLen(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + +
void samp_freeList (List  list  ) 
+
+
+ +

+Free the given List object. +

+SAMP_FREELIST -- Free the given List object

+

Parameters:
+ + +
list List object handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
void samp_freeMap (Map  map  ) 
+
+
+ +

+Free the given Map object. +

+SAMP_FREEMAP -- Free the given Map object

+

Parameters:
+ + +
map Map object to free
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
void samp_freeMsg (Msg  msg  ) 
+
+
+ +

+Free the given Msg object. +

+SAMP_FREEMSG -- Free the given Msg object

+

Parameters:
+ + +
msg Msg object to free
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
void samp_freeParam (Param  param  ) 
+
+
+ +

+Free the given Msg object. +

+SAMP_FREEPARAM -- Free the given Param object

+

Parameters:
+ + +
param Param object to free
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
List samp_getAvailableHubs (handle_t  handle  ) 
+
+
+ +

+Get a list of available Hubs. +

+SAMP_GETAVAILABLEHUBS -- Get a list of available Hubs

+

Parameters:
+ + +
handle hub handle
+
+
Returns:
List of hub handles
+ +
+

+ +

+
+ + + + + + + + + +
String samp_getErr (handle_t  handle  ) 
+
+
+ +

+Get the error response string. +

+SAMP_GETERR -- Get the error response string.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
Error text string
+ +

References Samp::errortxt.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
float samp_getFloatFromList (List  list,
int  index 
)
+
+
+ +

+Get a Float from the List. +

+SAMP_GETFLOATFROMLIST -- Get a Float from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the desired value
+
+
Returns:
int value
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
float samp_getFloatFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a float from the Map. +

+SAMP_GETFLOATFROMMAP -- Get a float from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
floating point value
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_getIntFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a integer from the Map. +

+SAMP_GETINTFROMMAP -- Get a integer from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
integer value
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
List samp_getListFromList (List  list,
int  index 
)
+
+
+ +

+Get a List from the List. +

+Get an Int from the List.

+SAMP_GETLISTFROMLIST -- Get a List from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the List
+
+
Returns:
List handle
+SAMP_GETINTFROMLIST -- Get an Int from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the desired value
+
+
Returns:
int value
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
List samp_getListFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a LIST from the Map. +

+SAMP_GETLISTFROMMAP -- Get a LIST from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
handle to List value
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
Map samp_getMapFromList (List  list,
int  index 
)
+
+
+ +

+Get a Map from the List. +

+SAMP_GETMAPFROMLIST -- Get a Map from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the Map
+
+
Returns:
Map handle
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
Map samp_getMapFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a Map from the Map. +

+SAMP_GETMAPFROMMAP -- Get a Map from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
handle to Map value
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char* samp_getMetadata (handle_t  handle,
String  name 
)
+
+
+ +

+Get the metadata item for the application. +

+SAMP_GETMETADATA -- Get the metadata item for the application.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References appMD::aKey, appMD::aVal, Samp::description, appMD::docURL, appMD::iconURL, Samp::meta, and appMD::nkeys.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
Map samp_GetMetadata (handle_t  handle,
String  pubId 
)
+
+
+ +

+Get the metadata for a specified app. +

+SAMP_GETMETADATA -- Get the metadata for a specified app.

+

Parameters:
+ + + +
handle samp struct handle
pubId App public-id
+
+
Returns:
Map to message response
+ +

References Samp::errortxt, Samp::hub, hub, Hub::id, and Hub::privateKey.

+ +
+

+ +

+
+ + + + + + + + + +
Map samp_getNullMap (void   ) 
+
+
+ +

+SAMP_GETNULLMAP -- Generate a 'Null' map we can return to the Hub. +

References samp_newMap().

+ +
+

+ +

+
+ + + + + + + + + +
Map samp_getOKMap (void   ) 
+
+
+ +

+SAMP_GETOKMAP -- Generate an 'OK' map we can return to the Hub. +

References nullMap, samp_newMap(), samp_setMapInMap(), and samp_setStringInMap().

+ +
+

+ +

+
+ + + + + + + + + +
List samp_GetRegisteredClients (handle_t  handle  ) 
+
+
+ +

+Get public-ids of the registered clients. +

+SAMP_GETREGISTEREDCLIENTS -- Get public-ids of the registered clients.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
handle to list of registered clients
+ +

References Samp::hub, Hub::id, Hub::privateKey, samp_listLen(), samp_newList(), and samp_setStringInList().

+ +
+

+ +

+
+ + + + + + + + + +
void* samp_getSampHandler (String  mtype  ) 
+
+
+ +

+Get the Samphandler for the named mtype. +

+SAMP_GETSAMPHANDLER -- Get the Samphandler for the named mtype.

+

Parameters:
+ + +
mtype mtype string
+
+
Returns:
nothing
+ +

References Samp::nsubs, and Subs::sampFunc.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char* samp_getStringFromList (List  list,
int  index 
)
+
+
+ +

+Get a string from the List. +

+SAMP_GETSTRINGFROMLIST -- Get a string from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the string
+
+
Returns:
character string
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char* samp_getStringFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a string from the Map. +

+SAMP_GETSTRINGFROMMAP -- Get a string from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
string value from Map
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
List samp_GetSubscribedClients (handle_t  handle,
String  mtype 
)
+
+
+ +

+Get clients matching the mtype subscription. +

+SAMP_GETSUBSCRIBEDCLIENTS -- Get clients matching the mtype subscription.

+

Parameters:
+ + + +
handle samp struct handle
mtype mtype string
+
+
Returns:
handle to list of clients having mtype subscription
+ +

References Samp::hub, Hub::id, Hub::privateKey, samp_listLen(), samp_newList(), and samp_setStringInList().

+ +
+

+ +

+
+ + + + + + + + + +
void* samp_getUserHandler (String  mtype  ) 
+
+
+ +

+Get the User handler for the named mtype. +

+SAMP_GETUSERHANDLER -- Get the User handler for the named mtype.

+

Parameters:
+ + +
mtype mtype string
+
+
Returns:
nothing
+ +

References Samp::defaultUserFunc, Samp::nsubs, and Subs::userFunc.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubClose (handle_t  handle  ) 
+
+
+ +

+Close a connection to the Hub. +

+SAMP_HUBCLOSE -- Close a connection to the Hub.

+

Parameters:
+ + +
handle hub handle
+
+
Returns:
unregister status
+ +

References appMD::aKey, appMD::aVal, Hub::meta, appMD::nkeys, samp_freeHandle(), and samp_hubUnRegister().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubDeclareMetadata (Hub *  hub  ) 
+
+
+ +

+Declare "standard" metadata to the Hub. +

+SAMP_DECLAREMETADATA -- Declare "standard" metadata to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References appMD::aKey, appMD::aVal, Hub::description, appMD::docURL, appMD::iconURL, Hub::id, Hub::meta, appMD::nkeys, and Hub::privateKey.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubDeclareSubscriptions (Hub *  hub  ) 
+
+
+ +

+Declare mtype subscriptions to the Hub. +

+SAMP_HUBDECLARESUBSCRIPTIONS -- Declare mtype subscriptions to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::id, Samp::nsubs, nullMap, Hub::privateKey, Hub::samp, samp_freeMap(), and Subs::userFunc.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubEvent (String  mtype  ) 
+
+
+ +

+Determine the type of Hub event mtype. +

+SAMP_HUBEVENT -- Determine the type of Hub event mtype.

+

Parameters:
+ + +
mtype mtype string
+
+
Returns:
Hub event code or -1 if not found
+ +

References HUB_SHUTDOWN.

+ +
+

+ +

+
+ + + + + + + + + +
handle_t samp_hubOpen (Samp *  sampP  ) 
+
+
+ +

+Discover and open a connection to the SAMP Hub. +

+SAMP_HUBOPEN -- Discover and open a connection to the SAMP Hub.

+

Parameters:
+ + +
samp Same structure
+
+
Returns:
hub handle
+ +

References Hub::appId, Samp::appVer, Hub::appVer, appMD::desc, Hub::description, Samp::description, Hub::id, Hub::meta, Hub::samp, samp_hubRegister(), samp_hubSetXmlrpcCallback(), samp_newHandle(), samp_P2H(), Hub::timeout, and Hub::url.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubPing (Hub *  hub  ) 
+
+
+ +

+Ping the Hub to see if it is alive. +

+SAMP_HUBPING -- Ping the Hub to see if it is alive.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::id, and Hub::privateKey.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubRegister (Hub *  hub  ) 
+
+
+ +

+Send a Register message to the Hub. +

+SAMP_HUB_REGISTER -- Send a Register message to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::hubId, Hub::id, Hub::privateKey, Hub::secret, and Hub::selfId.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubSendShutdown (Hub *  hub  ) 
+
+
+ +

+Send a samp.app.event.shutdown message to the Hub. +

+SAMP_HUBSENDSHUTDOWN -- Send a samp.app.event.shutdown message to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::id, Hub::privateKey, and samp_nullResponse().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubSetXmlrpcCallback (Hub *  hub  ) 
+
+
+ +

+Set the client callback and send to Hub. +

+SAMP_HUBSETXMLRPCCALLBACK -- Set the client callback and send to Hub

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::id, Hub::privateKey, and samp_serverPort().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubUnRegister (Hub *  hub  ) 
+
+
+ +

+Send a UnRegister message to the Hub. +

+SAMP_HUBUNREGISTER -- Send a UnRegister message to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::id, and Hub::privateKey.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char* samp_id2app (handle_t  handle,
char *  pubId 
)
+
+
+ +

+Convert a public-ID to the application name. +

+SAMP_ID2APP -- Convert a public-ID to the application name.

+

Parameters:
+ + + +
handle samp struct handle
pubId public ID of application
+
+
Returns:
name of registered application
+ +

References Samp::clients, Client::name, and Samp::nclients.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_imageLoadFITS (handle_t  handle,
String  recip,
String  url,
String  imageId,
String  name 
)
+
+
+ +

+Tell an app to load a FITS image. +

+SAMP_IMAGELOADFITS -- Tell an app to load a FITS image.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
url URL to table to be loaded
imageId ID assigned to image (optional)
name Name assigned to image (optional)
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_imLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle an image.load.fits message. +

+SAMP_IMLOADHANDLER -- Handle an image.load.fits message.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_listClients (handle_t  handle  ) 
+
+
+ +

+SAMP_LISTCLIENTS -- List the available clients to stdout. +

References Samp::clients, Client::name, and Samp::nclients.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_listLen (List  list  ) 
+
+
+ +

+Get number of elements in a List. +

+SAMP_LISTLEN -- Get number of elements in a List.

+

Parameters:
+ + +
list List object handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
int samp_mapClients (handle_t  handle  ) 
+
+
+ +

+SAMP_MAPCLIENTS -- Map the public-ids of registered clients to the appName. +

References Samp::clients, Client::name, Samp::nclients, samp_freeList(), samp_GetMetadata(), samp_GetRegisteredClients(), samp_getStringFromList(), samp_listLen(), and SZ_NAME.

+ +

Referenced by sampStartup().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_Metadata (handle_t  handle,
String  field,
String  value 
)
+
+
+ +

+Set a metadata field value for the application. +

+SAMP_METADATA -- Set a metadata field for the application. This will be sent to the Hub later in a declareMetadata() call.

+

Parameters:
+ + + + +
handle samp handle
field metadata field to set (name, author, etc)
samp value of field
+
+
Returns:
nothing
+ +

References appMD::aKey, Samp::appVer, Hub::appVer, appMD::aVal, appMD::desc, Hub::description, Samp::description, appMD::docURL, Samp::hub, appMD::iconURL, Hub::meta, Samp::meta, appMD::nkeys, and sampTrace().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_msgParam (Msg  msg,
Param  param 
)
+
+
+ +

+Add a parameter to the Msg. +

+SAMP_MSGPARAM -- Add a parameter to the Msg.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
param parameter map
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
handle_t samp_newList (void   ) 
+
+
+ +

+Create a new List object. +

+SAMP_NEWLIST -- Create a new List object

+

Returns:
handle to List object
+ +
+

+ +

+
+ + + + + + + + + +
handle_t samp_newMap (void   ) 
+
+
+ +

+Create a new Map object. +

+SAMP_NEWMAP -- Create a new Map object

+

Returns:
handle to new Map
+ +
+

+ +

+
+ + + + + + + + + +
Msg samp_newMsg (void   ) 
+
+
+ +

+Create a new Msg object. +

+SAMP_NEWMSG -- Create a new Msg object

+

Returns:
handle to new Msg
+ +
+

+ +

+
+ + + + + + + + + +
Param samp_newParam (void   ) 
+
+
+ +

+Create a new Param object. +

+SAMP_NEWPARAM -- Create a new Param object

+

Returns:
handle to new Param
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_notify (handle_t  handle,
String  recipId,
Map  msg 
)
+
+
+ +

+Make a notify() call to the Hub. +

+SAMP_NOTIFY -- Make a notify() call to the Hub

+

Parameters:
+ + + + +
handle samp struct handle
recipId recipient ID
msg message map
+
+
Returns:
nothing
+ +

References Samp::hub, hub, Hub::id, Hub::privateKey, samp_app2id(), and samp_nullResponse().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
List samp_notifyAll (handle_t  handle,
Map  msg 
)
+
+
+ +

+Make a notifyAll() call to the Hub. +

+SAMP_NOTIFYALL -- Make a notifyAll() call to the Hub

+

Parameters:
+ + + +
handle samp struct handle
msg message map
+
+
Returns:
nothing
+ +

References Samp::debug, Samp::errortxt, Samp::hub, hub, Hub::id, Hub::privateKey, and Samp::trace.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_nullResponse (void *  data  ) 
+
+
+ +

+SAMP_NULLRESPONSE -- Handler to ignore async replies. +

+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
char* samp_paramGet (handle_t  handle,
String  recip,
String  name 
)
+
+
+ +

+Get a parameter variable in a remote application. +

+SAMP_PARAMGET -- Get a parameter variable in a remote application.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
+
+
Returns:
NULL, Value of variable, or list of values
+ +

References Samp::clients, Samp::errortxt, Samp::hub, hub, Hub::id, Client::name, Samp::nclients, Hub::privateKey, samp_app2id(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and Hub::timeout.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_paramGetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.param.set message. +

+SAMP_PARAMGETHANDLER -- Handle a client.param.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_freeMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_newMap(), samp_setHandlerReply(), samp_setMapInMap(), samp_setStringInMap(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + +
Param samp_paramInit (Msg  msg  ) 
+
+
+ +

+Get number of Params. +

+SAMP_PARAMINIT -- Get number of Params.

+

Parameters:
+ + +
msg handle to Msg object
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
int samp_paramLen (Msg  msg  ) 
+
+
+ +

+Get number of Params. +

+SAMP_PARAMLEN -- Get number of Params.

+

Parameters:
+ + +
msg handle to Msg object
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_paramSet (handle_t  handle,
String  recip,
String  name,
String  value 
)
+
+
+ +

+Set an parameter variable in a remote application. +

+SAMP_PARAMSET -- Set an parameter variable in a remote application.

+

Parameters:
+ + + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
value Value of variable or NULL
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_paramSetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.param.set message. +

+SAMP_PARAMSETHANDLER -- Handle a client.param.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_Ping (handle_t  handle,
String  appName 
)
+
+
+ +

+Ping the hub/app to see if it is alive (returns >0). +

+SAMP_PING -- Ping the hub/app to see if it is alive (returns >0).

+

Parameters:
+ + + +
handle samp struct handle
appName application name
+
+
Returns:
OK or ERR if no response
+ +

References Samp::hub, samp_app2id(), samp_callAll(), samp_callAndWait(), samp_freeMap(), samp_freeMsg(), samp_hubPing(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_setErr().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_PingHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Is app alive and responding to messages? +

+SAMP_PINGHANDLER -- Simple aliveness test function.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, and samp_getUserHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_pointAtHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a coord.pointAt.sky message. +

+SAMP_POINTATHANDLER -- Handle a coord.pointAt.sky message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getFloatFromMap(), and samp_getUserHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_printMap (String  name,
Map  map 
)
+
+
+ +

+SAMP_PRINTMAP -- Print the contents of a Map structure. +

+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_printMetadata (handle_t  handle,
String  name 
)
+
+
+ +

+Print the metadata for the application. +

+SAMP_PRINTMETADATA -- Print the metadata for the application.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References appMD::aKey, appMD::aVal, Samp::description, appMD::docURL, appMD::iconURL, Samp::meta, and appMD::nkeys.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_processHubEvent (String  mtype,
Map  params 
)
+
+
+ +

+Determine the type of Hub event mtype. +

+SAMP_HUBEVENT -- Determine the type of Hub event mtype.

+

Parameters:
+ + + +
mtype mtype string
params message parameter Map
+
+
Returns:
non-zero value if a Hub event was processed
+ +

References HUB_SHUTDOWN, samp_addClient(), samp_hubEvent(), samp_mutex, samp_P2H(), samp_removeClient(), sampH, and sampShutdown().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_receiveCall (void *  data  ) 
+
+
+ +

+test.echo method +

+receiveCall () client method.

+SAMP_TESTECHO -- test.echo method

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+SAMP_RECEIVECALL -- receiveCall() client method.

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+ +

References Samp::defaultUserFunc, OK_Map, samp_execUserHandler(), samp_getHandlerReply(), samp_getSampHandler(), samp_getUserHandler(), samp_Reply(), sampH, and Samp::trace.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_receiveNotification (void *  data  ) 
+
+
+ +

+receiveNotification () client method. +

+SAMP_RECEIVENOTIFICATION -- receiveNotification() client method.

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+ +

References Samp::defaultUserFunc, OK_Map, samp_execUserHandler(), samp_getHandlerReply(), samp_getSampHandler(), samp_getUserHandler(), samp_processHubEvent(), and Samp::trace.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_receiveResponse (void *  data  ) 
+
+
+ +

+receiveResponse () client method. +

+SAMP_RECEIVERESPONSE -- receiveResponse() client method.

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+ +

References Samp::defaultUserFunc, OK_Map, samp_execUserHandler(), and Samp::trace.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_Register (handle_t  handle  ) 
+
+
+ +

+Register with the Hub using the currently stored metadata. +

+SAMP_REGISTER -- Register with the Hub using the currently stored metadata.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, Hub::hubId, Hub::id, Hub::privateKey, samp_replyStatus(), Hub::secret, and Hub::selfId.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_removeClient (handle_t  handle,
String  id 
)
+
+
+ +

+SAMP_REMOVECLIENT -- Remove a registered client from the list of known apps that do the public-private name translation. +

References Samp::clients, Client::name, Samp::nclients, and SZ_NAME.

+ +

Referenced by samp_processHubEvent().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_Reply (handle_t  handle,
String  msg_id,
Map  response 
)
+
+
+ +

+Reply to a message. +

+SAMP_REPLY -- Reply to a message. All we do here is send the reply message, we require that the response Map already be defined.

+

Parameters:
+ + + + +
handle samp struct handle
msg_id message ID
response response map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, Hub::id, Hub::privateKey, and samp_nullResponse().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_replyStatus (handle_t  handle  ) 
+
+
+ +

+Reply with the status of the last message sent. +

+SAMP_REPLYSTATUS -- Reply with the status of the last message sent.

+May be used to 'poll' for a reponse from the caller in cases where use of a callback is a problem. Codes are: <0==ERR, 0==PENDING, 1==OK

+

Parameters:
+ + +
samp samp struct ptr
+
+
Returns:
message status
+ +

Referenced by samp_Register().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resConeHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESCONEHANDLER -- Handle a voresource.loadlist.cone message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_resLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESLOADHANDLER -- handle a voresource.loadlist.* message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resourceLoad (handle_t  handle,
String  recip,
String  type,
String  name,
Map  resMap 
)
+
+
+ +

+Exchange a resource list. +

+SAMP_RESOURCELOAD -- Exchange a resource list.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Name of recipient (or 'all')
type Resource type (or NULL)
name Descriptive name (optional)
resMap Resource map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_addMapParam(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), samp_sendMsg(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resSiapHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESSIAPHANDLER -- Handle a voresource.loadlist.siap message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_resLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resSsapHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESSSAPHANDLER -- Handle a voresource.loadlist.ssap message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_resLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resTapHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESTAPHANDLER -- Handle a voresource.loadlist.tap message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_resLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resVOSpaceHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESVOSPACEHANDLER -- Handle a voresource.loadlist.vospace message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_resLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_sendGeneric (handle_t  handle,
String  recip,
String  mtype,
String  args[] 
)
+
+
+ +

+Send a geenric message. +

+SAMP_SENDGENERIC -- Send a generic message.

+

Parameters:
+ + + + + +
handle samp struct handle
recip Name of recipient (or 'all')
mtype Message type
args Argument list
+
+
Returns:
SAMP_OK or SAMP_ERR
+This method can be used to send any user-defined message. The 'mtype' string is arbitrary, we just assume the receiving client can understand what it means. The 'args' String array can be an array of values in which case the parameter name will be a series of generic 'arg0' thru 'argN-1' names. +

References Samp::hub, hub, samp_addFloatParam(), samp_addIntParam(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), samp_sendMsg(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_sendMsg (handle_t  handle,
String  recip,
Map  msg 
)
+
+
+ +

+Send the specified message. +

+SAMP_SENDMSG -- Send the specified message.

+

Parameters:
+ + + + +
handle samp struct handle
recip Name of recipient (or 'all')
msg Message map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::clients, Samp::msgMode, Samp::nclients, samp_app2id(), samp_call(), samp_callAll(), samp_callAndWait(), samp_notify(), samp_notifyAll(), and samp_setErr().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_serverPort (void   ) 
+
+
+ +

+Return a unique port number for the server. +

+SAMP_SERVERPORT -- Return a unique port number for the server.

+

Returns:
port number
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setAppVersion (handle_t  handle,
String  version 
)
+
+
+ +

+Set the application name string. +

+Set the application version string.

+SAMP_SETAPPNAME -- Set the application name string.

+

Parameters:
+ + + +
handle samp handle
name application name
+
+
Returns:
nothing
+SAMP_SETAPPVERSION -- Set the application version string.

+

Parameters:
+ + + +
handle samp handle
name application version
+
+
Returns:
nothing
+ +

References Hub::appVer, Samp::appVer, and Samp::hub.

+ +
+

+ +

+
+ + + + + + + + + +
void samp_setASyncMode (handle_t  handle  ) 
+
+
+ +

+Set the calling mode to use asynchronous messaging. +

+SAMP_SETASYNCMODE -- Set the calling mode to use asynchronous messaging.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References Samp::msgMode.

+ +
+

+ +

+
+ + + + + + + + + +
void samp_setCallByRef (handle_t  handle  ) 
+
+
+ +

+Have interface call user handlers by reference. +

+SAMP_SETCALLBYREF -- Have interface call user handlers by reference.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References Samp::handlerMode.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setCallMode (handle_t  handle,
int  mode 
)
+
+
+ +

+Set the default calling mode (synch or asynch). +

+SAMP_SETCALLMODE -- Set the default calling mode (synch or asynch)

+

Parameters:
+ + + +
handle samp handle
mode call mode (synch or asynch)
+
+
Returns:
nothing
+ +

References Samp::msgMode.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_setErr (handle_t  handle,
Map  resp 
)
+
+
+ +

+Set the error response string. +

+SAMP_SETERR -- Set the error response string/code.

+

Parameters:
+ + + +
handle samp struct handle
resp Response map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::errortxt.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setFloatInList (List  list,
float  rval 
)
+
+
+ +

+Set a Float in a List (append). +

+SAMP_SETFLOATINLIST -- Set a Float in a List (append)

+

Parameters:
+ + + +
list1 List object handle
rval Float value to be appended
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setFloatInMap (Map  map,
char *  key,
float  value 
)
+
+
+ +

+Set a string in a Map (append). +

+SAMP_SETFLOATINMAP -- Set a Float in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
value value
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setIntInList (List  list,
int  ival 
)
+
+
+ +

+Set an Int in a List (append). +

+SAMP_SETINTINLIST -- Set an Int in a List (append)

+

Parameters:
+ + + +
list1 List object handle
ival Integer value to be appended
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setIntInMap (Map  map,
char *  key,
int  value 
)
+
+
+ +

+Set a Int in a Map (append). +

+SAMP_SETINTINMAP -- Set a Int in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
value value
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setListInList (List  list1,
List  list2 
)
+
+
+ +

+Set a List in another List (append). +

+SAMP_SETLISTINLIST -- Set a List in another List (append)

+

Parameters:
+ + + +
list1 List object handle
list2 List to be appended
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setListInMap (Map  map,
char *  key,
List  list 
)
+
+
+ +

+Set a List in a Map (append). +

+SAMP_SETLISTINMAP -- Set a List in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
list handle to List object to set
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setMapInList (List  list,
Map  map 
)
+
+
+ +

+Set a Map in a List (append). +

+SAMP_SETMAPINLIST -- Set a Map in a List (append)

+

Parameters:
+ + + +
list List object handle
map Map object to be set
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setMapInMap (Map  map1,
char *  key,
Map  map2 
)
+
+
+ +

+Set a Map in a Map (append). +

+SAMP_SETMAPINMAP -- Set a Map in a Map (append)

+

Parameters:
+ + + + +
map1 handle to Map object
key Map key
map2 handle to Map object to set
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
void samp_setNotifyMode (handle_t  handle  ) 
+
+
+ +

+Set the calling mode to use notification messaging. +

+SAMP_SETNOTIFYMODE -- Set the calling mode to use notification messaging.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References Samp::msgMode.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setReplyCallback (handle_t  handle,
int *  func 
)
+
+
+ +

+Set the Reply callback. samp_setReplyCallback (handle_t handle, int *func). +

+SAMP_SETREPLYCALLBACK -- Set the Reply callback.

+

Parameters:
+ + + +
handle samp handle
func callback for Reply message
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setResponseCallback (handle_t  handle,
int *  func 
)
+
+
+ +

+Set the Response callback. samp_setResponseCallback (handle_t handle, int *func). +

+SAMP_SETRESPONSECALLBACK -- Set the Response callback.

+

Parameters:
+ + + +
handle samp handle
func callback for message response
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setSampHandler (handle_t  handle,
String  mtype,
void *  func 
)
+
+
+ +

+Set the SAMP interface handler for the mtype. +

+SAMP_SETSAMPHANDLER -- Set the SAMP interface handler for the mtype.

+

Parameters:
+ + + + +
handle user handle to samp struct
mtype mtype name
func callback function
+
+
Returns:
nothing
+ +

References Samp::nsubs, and Subs::sampFunc.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setStringInList (List  list,
char *  value 
)
+
+
+ +

+Set a string in a List (append). +

+SAMP_SETSTRINGINLIST -- Set a string in a List (append)

+

Parameters:
+ + + +
list List object handle
value string value to set
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setStringInMap (Map  map,
char *  key,
char *  value 
)
+
+
+ +

+Set a string in a Map (append). +

+SAMP_SETSTRINGINMAP -- Set a string in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
value Map value
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
void samp_setSyncMode (handle_t  handle  ) 
+
+
+ +

+Set the calling mode to use synchronous messaging. +

+SAMP_SETSYNCMODE -- Set the calling mode to use synchronous messaging.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References Samp::msgMode.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setTimeout (handle_t  handle,
int  timeout 
)
+
+
+ +

+Set the message timeout value (in seconds). +

+SAMP_SETTIMEOUT -- Set the message timeout value (in seconds).

+

Parameters:
+ + + +
handle samp handle
name application name
+
+
Returns:
nothing
+ +

References Samp::hub, and Hub::timeout.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setUserHandler (handle_t  handle,
String  mtype,
void *  func 
)
+
+
+ +

+Set the user-interface handler for the mtype. +

+SAMP_SETUSERHANDLER -- Set the user-interface handler for the mtype.

+

Parameters:
+ + + + +
handle user handle to samp struct
mtype mtype name
func callback function
+
+
Returns:
nothing
+ +

References Samp::defaultUserFunc, Samp::nsubs, and Subs::userFunc.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_specLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a spectrum.load.* message. +

+SAMP_SPECLOADHANDLER -- Handle a spectrum.load.* message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_specLoadSSAGeneric (handle_t  handle,
String  recip,
String  url,
Map  meta,
String  spectrumId,
String  name 
)
+
+
+ +

+Load a generic spectrum from an SSA service. +

+SAMP_SPECLOADSSAGENERIC -- Load a generic spectrum from an SSA service.

+

Parameters:
+ + + + + + + +
handle samp struct handle
recip name of recipient (or 'all')
url URL of spectrum to load
meta Metadata map describing data found at the URL
spectrumId Identifier for spectrum (optional)
name Name used to label spectrum (optional);
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_addMapParam(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_specSSAHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a spectrum.load.ssa-generic message. +

+SAMP_SPECSSAHANDLER -- Handle a spectrum.load.ssa-generic message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_specLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_StatusHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Return status of the task. +

+SAMP_STATUSHANDLER -- Return status of the task.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, and samp_getUserHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_Subscribe (handle_t  handle,
String  mtype,
void *  userFunc 
)
+
+
+ +

+Subscribe to a given mtype. +

+SAMP_SUBSCRIBE -- Subscribe to a given mtype.

+

Parameters:
+ + + + +
handle user handle to samp struct
mtype mtype name
func callback function
+
+
Returns:
nothing
+ +

References Samp::nsubs, samp_getSampHandler(), samp_setSampHandler(), and samp_setUserHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tableHighlightRow (handle_t  handle,
String  recip,
String  tableId,
String  url,
int  row 
)
+
+
+ +

+Tell an app to highlight a table row. +

+SAMP_TABLEHIGHLIGHTROW -- Tell an app to highlight a table row.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
tableId ID associated with a previously loaded table
url URL to table to be loaded
rows List of (zero-based) row indices
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_addIntParam(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tableLoadFITS (handle_t  handle,
String  recip,
String  url,
String  tableId,
String  name 
)
+
+
+ +

+Tell an app to load a FITS table. +

+SAMP_TABLELOADFITS -- Tell an app to load a FITS table.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
url URL to table to be loaded
tableId ID assigned to table (optional)
name Name assigned to table (optional)
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tableLoadVOTable (handle_t  handle,
String  recip,
String  url,
String  tableId,
String  name 
)
+
+
+ +

+Tell an app to load a VOTable. +

+SAMP_TABLELOADVOTABLE -- Tell an app to load a VOTable.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
url URL to table to be loaded
tableId ID assigned to table (optional)
name Name assigned to table (optional)
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tableSelectRowList (handle_t  handle,
String  recip,
String  tableId,
String  url,
int  rows[],
int  nrows 
)
+
+
+ +

+Tell an app to select a list of table rows. +

+SAMP_TABLESELECTROWLIST -- Tell an app to select a list of table rows.

+

Parameters:
+ + + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
tableId ID associated with a previously loaded table
url URL to table to be loaded
rows Array of (zero-based) row indices
nrows Number of rows
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_addListParam(), samp_freeList(), samp_freeMsg(), samp_msgParam(), samp_newList(), samp_newMsg(), samp_newParam(), samp_sendMsg(), and samp_setIntInList().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbHighlightHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a table.highlight.row message. +

+SAMP_TBHIGHLIGHTHANDLER -- Handle a table.highlight.row message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getIntFromMap(), samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbLoadFITSHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a generic table.load.fits message. +

+SAMP_TBLOADFITSHANDLER -- Handle a generic table.load.fits message *

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), samp_tbLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a generic table.load.* message. +

+SAMP_TBLOADHANDLER -- Handle a generic table.load.* message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbLoadVOTHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a generic table.load.votable message. +

+SAMP_TBLOADVOTHANDLER -- Handle a generic table.load.votable message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), samp_tbLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbSelectHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a table.select.rowList message. +

+SAMP_TBSELECTHANDLER -- Handle a table.select.rowList message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getListFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_listLen(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_UnRegister (handle_t  handle  ) 
+
+
+ +

+Un-Register from the hub. +

+SAMP_UNREGISTER -- Un-Register from the hub.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, and samp_hubUnRegister().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_Unsubscribe (handle_t  handle,
String  mtype 
)
+
+
+ +

+Unsubscribe to a given mtype. +

+SAMP_UNSUBSCRIBE -- Unsubscribe to a given mtype.

+

Parameters:
+ + + +
handle user handle to samp struct
mtype mtype name
+
+
Returns:
nothing
+ +

References Samp::nsubs, samp_DeclareSubscriptions(), Subs::sampFunc, and Subs::userFunc.

+ +
+

+ +

+
+ + + + + + + + + +
void sampClose (handle_t  handle  ) 
+
+
+ +

+Close the SAMP interface and free resources. +

+SAMP_CLOSE -- Close the SAMP interface.

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +

References Samp::hub, Samp::hubHandle, samp_freeHandle(), samp_hubClose(), sampTrace(), and Samp::verbose.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
handle_t sampInit (String  appName,
String  description 
)
+
+
+ +

+Initialize the SAMP interface. +

+Prototype declarations.

+SAMP_INIT -- Initialize the SAMP interface.

+

Parameters:
+ + + +
appName application name
description description of application
+
+
Returns:
samp handle
+ +

References nullList, nullMap, OK_Map, samp_hubOpen(), samp_newHandle(), samp_newList(), samp_newMap(), samp_serverPort(), samp_setMapInMap(), samp_setStringInMap(), sampH, and sampTrace().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void sampLog (handle_t  handle,
char *  format,
  ... 
)
+
+
+ +

+SAMP message logger. +

+SAMPLOG -- SAMP message logger.

+

Parameters:
+ + + +
handle SAMP handle
format message format string
+
+
Returns:
nothing
+ +

References Samp::debug, and Samp::logfd.

+ +
+

+ +

+
+ + + + + + + + + +
int sampShutdown (handle_t  handle  ) 
+
+
+ +

+Shut down the active SAMP interface. +

+SAMP_SHUTDOWN -- Shut down the active SAMP interface.

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +

References Samp::active, Samp::hubHandle, samp_hubClose(), Samp::svrThread, and Samp::verbose.

+ +

Referenced by samp_processHubEvent().

+ +
+

+ +

+
+ + + + + + + + + +
int sampStartup (handle_t  handle  ) 
+
+
+ +

+Startup the SAMP interface to send/receive messages. +

+SAMP_STARTUP -- Startup the SAMP interface to send/receive messages.

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +

References Samp::active, Samp::clients, Samp::hub, Samp::hubHandle, Hub::id, Samp::mapClients, Client::name, Samp::nclients, samp_hubDeclareMetadata(), samp_hubDeclareSubscriptions(), samp_hubOpen(), samp_mapClients(), Samp::trace, and Samp::verbose.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void sampTrace (handle_t  handle,
char *  format,
  ... 
)
+
+
+ +

+SAMP tracer. +

+SAMPTRACE -- SAMP tracer.

+

Parameters:
+ + + +
handle SAMP handle
format message format string
+
+
Returns:
nothing
+ +

References Samp::trace.

+ +
+

+

+
Generated on Wed Feb 27 21:10:15 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampDecl_8h_source.html b/vendor/voclient/libsamp/doc/html/sampDecl_8h_source.html new file mode 100644 index 00000000..0683eed8 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampDecl_8h_source.html @@ -0,0 +1,410 @@ + + +SAMP Client Library: sampDecl.h Source File + + + + + +
Generated on Wed Feb 27 21:10:15 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampHandlers_8c.html b/vendor/voclient/libsamp/doc/html/sampHandlers_8c.html new file mode 100644 index 00000000..eaf68895 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampHandlers_8c.html @@ -0,0 +1,1819 @@ + + +SAMP Client Library: sampHandlers.c File Reference + + + + + +
+

sampHandlers.c File Reference

Message handlers for the interface. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include <time.h>
+#include <ctype.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Defines

+#define METH_DBG   (getenv("METH_DBG")!=NULL||access("/tmp/METH_DBG",F_OK)==0)
+#define OK_Map   samp_getOKMap()
+#define MATCH(s)   (func&&strncasecmp(mtype,s,min(len,16))==0)
+#define PMATCH(s)   (strcasecmp(mtype,s)==0)
+#define POPT(s)   (s[0]?s:"INDEF")

Functions

void samp_setUserHandler (handle_t handle, String mtype, void *func)
 Set the user-interface handler for the mtype.
void samp_setSampHandler (handle_t handle, String mtype, void *func)
 Set the SAMP interface handler for the mtype.
void * samp_getUserHandler (String mtype)
 Get the User handler for the named mtype.
void * samp_getSampHandler (String mtype)
 Get the Samphandler for the named mtype.
void samp_execUserHandler (String sender, String mtype, String msg_id, Map params)
 Execute the user-defined handler for the mtype.
int samp_hubHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle Hub event messages.
int samp_PingHandler (String sender, String mtype, String msg_id, Map msg_map)
 Is app alive and responding to messages?
int samp_StatusHandler (String sender, String mtype, String msg_id, Map msg_map)
 Return status of the task.
+int samp_genericMsgHandler (String sender, String mtype, String msg_id, Map msg_map)
int samp_imLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle an image.load.fits message.
int samp_tbLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a generic table.load.* message.
int samp_tbLoadFITSHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a generic table.load.fits message.
int samp_tbLoadVOTHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a generic table.load.votable message.
int samp_tbHighlightHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a table.highlight.row message.
int samp_tbSelectHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a table.select.rowList message.
int samp_pointAtHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a coord.pointAt.sky message.
int samp_specLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a spectrum.load.* message.
int samp_specSSAHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a spectrum.load.ssa-generic message.
int samp_cmdExecHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.cmd.exec message.
int samp_envGetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.env.set message.
int samp_envSetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.env.set message.
int samp_paramGetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.param.set message.
int samp_paramSetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.param.set message.
int samp_bibcodeHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a bibcode.load message.
int samp_resLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resConeHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resSiapHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resSsapHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resTapHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resVOSpaceHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
+void samp_printMessage (String mtype, String sender, String msg_id, Map params)
void samp_printMap (String name, Map map)
int samp_nullResponse (void *data)
+int samp_testEcho (void *data)

Variables

Map nullMap
List nullList
+Samp * sampP
handle_t sampH
+

Detailed Description

+Message handlers for the interface. +

+SAMPHANDLERS.C -- Message handlers for the interface.

+

Author:
Mike Fitzpatrick
+
Date:
7/10/09
+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_bibcodeHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a bibcode.load message. +

+SAMP_BIBCODEHANDLER -- Handle a bibcode.load message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_cmdExecHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.cmd.exec message. +

+SAMP_CMDEXECHANDLER -- Handle a client.cmd.exec message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), and samp_getUserHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_envGetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.env.set message. +

+SAMP_ENVGETHANDLER -- Handle a client.env.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_freeMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_newMap(), samp_setHandlerReply(), samp_setMapInMap(), samp_setStringInMap(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_envSetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.env.set message. +

+SAMP_ENVSETHANDLER -- Handle a client.env.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
void samp_execUserHandler (String  sender,
String  mtype,
String  msg_id,
Map  params 
)
+
+
+ +

+Execute the user-defined handler for the mtype. +

+SAMP_EXECUSERHANDLER -- Execute the user-defined handler for the mtype.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message-id string
params Mtype parameter Map
+
+
Returns:
nothing
+ +

References Samp::defaultUserFunc, Samp::handlerMode, samp_getFloatFromMap(), samp_getIntFromMap(), samp_getListFromMap(), samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_listLen(), and SZ_NAME.

+ +

Referenced by samp_receiveCall(), samp_receiveNotification(), and samp_receiveResponse().

+ +
+

+ +

+
+ + + + + + + + + +
void* samp_getSampHandler (String  mtype  ) 
+
+
+ +

+Get the Samphandler for the named mtype. +

+SAMP_GETSAMPHANDLER -- Get the Samphandler for the named mtype.

+

Parameters:
+ + +
mtype mtype string
+
+
Returns:
nothing
+ +

References Samp::nsubs, and Subs::sampFunc.

+ +

Referenced by samp_receiveCall(), samp_receiveNotification(), and samp_Subscribe().

+ +
+

+ +

+
+ + + + + + + + + +
void* samp_getUserHandler (String  mtype  ) 
+
+
+ +

+Get the User handler for the named mtype. +

+SAMP_GETUSERHANDLER -- Get the User handler for the named mtype.

+

Parameters:
+ + +
mtype mtype string
+
+
Returns:
nothing
+ +

References Samp::defaultUserFunc, Samp::nsubs, and Subs::userFunc.

+ +

Referenced by samp_bibcodeHandler(), samp_cmdExecHandler(), samp_envGetHandler(), samp_envSetHandler(), samp_execUserHandler(), samp_imLoadHandler(), samp_paramGetHandler(), samp_paramSetHandler(), samp_PingHandler(), samp_pointAtHandler(), samp_receiveCall(), samp_receiveNotification(), samp_resConeHandler(), samp_resLoadHandler(), samp_resSiapHandler(), samp_resSsapHandler(), samp_resTapHandler(), samp_resVOSpaceHandler(), samp_specLoadHandler(), samp_specSSAHandler(), samp_StatusHandler(), samp_tbHighlightHandler(), samp_tbLoadFITSHandler(), samp_tbLoadHandler(), samp_tbLoadVOTHandler(), and samp_tbSelectHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_hubHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle Hub event messages. +

+SAMP_HUBHANDLER -- Handle Hub event messages.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_imLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle an image.load.fits message. +

+SAMP_IMLOADHANDLER -- Handle an image.load.fits message.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_nullResponse (void *  data  ) 
+
+
+ +

+SAMP_NULLRESPONSE -- Handler to ignore async replies. +

Referenced by samp_hubSendShutdown(), samp_notify(), and samp_Reply().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_paramGetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.param.set message. +

+SAMP_PARAMGETHANDLER -- Handle a client.param.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_freeMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_newMap(), samp_setHandlerReply(), samp_setMapInMap(), samp_setStringInMap(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_paramSetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.param.set message. +

+SAMP_PARAMSETHANDLER -- Handle a client.param.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_PingHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Is app alive and responding to messages? +

+SAMP_PINGHANDLER -- Simple aliveness test function.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, and samp_getUserHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_pointAtHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a coord.pointAt.sky message. +

+SAMP_POINTATHANDLER -- Handle a coord.pointAt.sky message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getFloatFromMap(), and samp_getUserHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_printMap (String  name,
Map  map 
)
+
+
+ +

+SAMP_PRINTMAP -- Print the contents of a Map structure. +

+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resConeHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESCONEHANDLER -- Handle a voresource.loadlist.cone message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_resLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESLOADHANDLER -- handle a voresource.loadlist.* message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +

Referenced by samp_resConeHandler(), samp_resSiapHandler(), samp_resSsapHandler(), samp_resTapHandler(), and samp_resVOSpaceHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resSiapHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESSIAPHANDLER -- Handle a voresource.loadlist.siap message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_resLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resSsapHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESSSAPHANDLER -- Handle a voresource.loadlist.ssap message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_resLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resTapHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESTAPHANDLER -- Handle a voresource.loadlist.tap message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_resLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resVOSpaceHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESVOSPACEHANDLER -- Handle a voresource.loadlist.vospace message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_resLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setSampHandler (handle_t  handle,
String  mtype,
void *  func 
)
+
+
+ +

+Set the SAMP interface handler for the mtype. +

+SAMP_SETSAMPHANDLER -- Set the SAMP interface handler for the mtype.

+

Parameters:
+ + + + +
handle user handle to samp struct
mtype mtype name
func callback function
+
+
Returns:
nothing
+ +

References Samp::nsubs, and Subs::sampFunc.

+ +

Referenced by samp_Subscribe().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setUserHandler (handle_t  handle,
String  mtype,
void *  func 
)
+
+
+ +

+Set the user-interface handler for the mtype. +

+SAMP_SETUSERHANDLER -- Set the user-interface handler for the mtype.

+

Parameters:
+ + + + +
handle user handle to samp struct
mtype mtype name
func callback function
+
+
Returns:
nothing
+ +

References Samp::defaultUserFunc, Samp::nsubs, and Subs::userFunc.

+ +

Referenced by samp_Subscribe().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_specLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a spectrum.load.* message. +

+SAMP_SPECLOADHANDLER -- Handle a spectrum.load.* message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +

Referenced by samp_specSSAHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_specSSAHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a spectrum.load.ssa-generic message. +

+SAMP_SPECSSAHANDLER -- Handle a spectrum.load.ssa-generic message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getMapFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_specLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_StatusHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Return status of the task. +

+SAMP_STATUSHANDLER -- Return status of the task.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, and samp_getUserHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbHighlightHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a table.highlight.row message. +

+SAMP_TBHIGHLIGHTHANDLER -- Handle a table.highlight.row message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getIntFromMap(), samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbLoadFITSHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a generic table.load.fits message. +

+SAMP_TBLOADFITSHANDLER -- Handle a generic table.load.fits message *

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), samp_tbLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a generic table.load.* message. +

+SAMP_TBLOADHANDLER -- Handle a generic table.load.* message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), and SZ_NAME.

+ +

Referenced by samp_tbLoadFITSHandler(), and samp_tbLoadVOTHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbLoadVOTHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a generic table.load.votable message. +

+SAMP_TBLOADVOTHANDLER -- Handle a generic table.load.votable message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getStringFromMap(), samp_getUserHandler(), samp_tbLoadHandler(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbSelectHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a table.select.rowList message. +

+SAMP_TBSELECTHANDLER -- Handle a table.select.rowList message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::handlerMode, samp_getListFromMap(), samp_getStringFromMap(), samp_getUserHandler(), samp_listLen(), and SZ_NAME.

+ +
+

+

Variable Documentation

+ +
+
+ + + + +
List nullList
+
+
+ +

+SAMP_OK Map struct +

+

+ +

+
+ + + + +
Map nullMap
+
+
+ +

+SAMP handle +

+

+ +

+
+ + + + +
handle_t sampH
+
+
+ +

+SAMP struct pointer +

+

+

+
Generated on Wed Feb 27 21:10:15 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampHub_8c.html b/vendor/voclient/libsamp/doc/html/sampHub_8c.html new file mode 100644 index 00000000..ac8d5529 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampHub_8c.html @@ -0,0 +1,624 @@ + + +SAMP Client Library: sampHub.c File Reference + + + + + +
+

sampHub.c File Reference

Methods related to the SAMP Hub interface. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include <time.h>
+#include <pthread.h>
+#include <ctype.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Defines

+#define HUB_DBG   (getenv("HUB_DBG")!=NULL||access("/tmp/HUB_DBG",F_OK)==0)

Functions

handle_t samp_hubOpen (Samp *sampP)
 Discover and open a connection to the SAMP Hub.
int samp_hubClose (handle_t handle)
 Close a connection to the Hub.
int samp_hubRunning (void)
List samp_getAvailableHubs (handle_t handle)
 Get a list of available Hubs.
+char * samp_getActiveHubName (handle_t handle)
+int samp_getActiveHub (handle_t handle)
+int samp_hubInit (handle_t handle, char *appName, char *descr)
int samp_processHubEvent (String mtype, Map params)
 Determine the type of Hub event mtype.
int samp_hubEvent (String mtype)
 Determine the type of Hub event mtype.
int samp_hubRegister (Hub *hub)
 Send a Register message to the Hub.
int samp_hubUnRegister (Hub *hub)
 Send a UnRegister message to the Hub.
int samp_hubSendShutdown (Hub *hub)
 Send a samp.app.event.shutdown message to the Hub.
int samp_hubSetXmlrpcCallback (Hub *hub)
 Set the client callback and send to Hub.
int samp_hubPing (Hub *hub)
 Ping the Hub to see if it is alive.
int samp_hubDeclareMetadata (Hub *hub)
 Declare "standard" metadata to the Hub.
int samp_hubDeclareSubscriptions (Hub *hub)
 Declare mtype subscriptions to the Hub.

Variables

Hub * hub = (Hub *) NULL
int numHubs = 0
handle_t hubHandles [MAX_HUBS]
pthread_mutex_t samp_mutex = PTHREAD_MUTEX_INITIALIZER
+Samp * sampP
+int numSamps
+handle_t sampHandles [MAX_SAMPS]
Map nullMap
+

Detailed Description

+Methods related to the SAMP Hub interface. +

+SAMPHUB.C -- Methods related to the SAMP Hub interface.

+

Author:
Mike Fitzpatrick
+
Date:
7/10/09
+

Function Documentation

+ +
+
+ + + + + + + + + +
List samp_getAvailableHubs (handle_t  handle  ) 
+
+
+ +

+Get a list of available Hubs. +

+SAMP_GETAVAILABLEHUBS -- Get a list of available Hubs

+

Parameters:
+ + +
handle hub handle
+
+
Returns:
List of hub handles
+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubClose (handle_t  handle  ) 
+
+
+ +

+Close a connection to the Hub. +

+SAMP_HUBCLOSE -- Close a connection to the Hub.

+

Parameters:
+ + +
handle hub handle
+
+
Returns:
unregister status
+ +

References appMD::aKey, appMD::aVal, Hub::meta, appMD::nkeys, samp_freeHandle(), and samp_hubUnRegister().

+ +

Referenced by sampClose(), and sampShutdown().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubDeclareMetadata (Hub *  hub  ) 
+
+
+ +

+Declare "standard" metadata to the Hub. +

+SAMP_DECLAREMETADATA -- Declare "standard" metadata to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References appMD::aKey, appMD::aVal, Hub::description, appMD::docURL, appMD::iconURL, Hub::id, Hub::meta, appMD::nkeys, and Hub::privateKey.

+ +

Referenced by samp_DeclareMetadata(), and sampStartup().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubDeclareSubscriptions (Hub *  hub  ) 
+
+
+ +

+Declare mtype subscriptions to the Hub. +

+SAMP_HUBDECLARESUBSCRIPTIONS -- Declare mtype subscriptions to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::id, Samp::nsubs, nullMap, Hub::privateKey, Hub::samp, samp_freeMap(), and Subs::userFunc.

+ +

Referenced by samp_DeclareSubscriptions(), and sampStartup().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubEvent (String  mtype  ) 
+
+
+ +

+Determine the type of Hub event mtype. +

+SAMP_HUBEVENT -- Determine the type of Hub event mtype.

+

Parameters:
+ + +
mtype mtype string
+
+
Returns:
Hub event code or -1 if not found
+ +

References HUB_SHUTDOWN.

+ +

Referenced by samp_processHubEvent().

+ +
+

+ +

+
+ + + + + + + + + +
handle_t samp_hubOpen (Samp *  sampP  ) 
+
+
+ +

+Discover and open a connection to the SAMP Hub. +

+SAMP_HUBOPEN -- Discover and open a connection to the SAMP Hub.

+

Parameters:
+ + +
samp Same structure
+
+
Returns:
hub handle
+ +

References Hub::appId, Samp::appVer, Hub::appVer, appMD::desc, Hub::description, Samp::description, Hub::id, Hub::meta, Hub::samp, samp_hubRegister(), samp_hubSetXmlrpcCallback(), samp_newHandle(), samp_P2H(), Hub::timeout, and Hub::url.

+ +

Referenced by sampInit(), and sampStartup().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubPing (Hub *  hub  ) 
+
+
+ +

+Ping the Hub to see if it is alive. +

+SAMP_HUBPING -- Ping the Hub to see if it is alive.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::id, and Hub::privateKey.

+ +

Referenced by samp_Ping().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubRegister (Hub *  hub  ) 
+
+
+ +

+Send a Register message to the Hub. +

+SAMP_HUB_REGISTER -- Send a Register message to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::hubId, Hub::id, Hub::privateKey, Hub::secret, and Hub::selfId.

+ +

Referenced by samp_hubOpen().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubRunning (void   ) 
+
+
+ +

+SAMP_HUBRUNNING -- See whether a Hub is running. The test simply checks the existence of a Hub lockfile. +

References SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubSendShutdown (Hub *  hub  ) 
+
+
+ +

+Send a samp.app.event.shutdown message to the Hub. +

+SAMP_HUBSENDSHUTDOWN -- Send a samp.app.event.shutdown message to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::id, Hub::privateKey, and samp_nullResponse().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubSetXmlrpcCallback (Hub *  hub  ) 
+
+
+ +

+Set the client callback and send to Hub. +

+SAMP_HUBSETXMLRPCCALLBACK -- Set the client callback and send to Hub

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::id, Hub::privateKey, and samp_serverPort().

+ +

Referenced by samp_hubOpen().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubUnRegister (Hub *  hub  ) 
+
+
+ +

+Send a UnRegister message to the Hub. +

+SAMP_HUBUNREGISTER -- Send a UnRegister message to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

References Hub::id, and Hub::privateKey.

+ +

Referenced by samp_hubClose(), and samp_UnRegister().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_processHubEvent (String  mtype,
Map  params 
)
+
+
+ +

+Determine the type of Hub event mtype. +

+SAMP_HUBEVENT -- Determine the type of Hub event mtype.

+

Parameters:
+ + + +
mtype mtype string
params message parameter Map
+
+
Returns:
non-zero value if a Hub event was processed
+ +

References HUB_SHUTDOWN, samp_addClient(), samp_hubEvent(), samp_mutex, samp_P2H(), samp_removeClient(), sampH, and sampShutdown().

+ +

Referenced by samp_receiveNotification().

+ +
+

+

Variable Documentation

+ +
+
+ + + + +
Hub* hub = (Hub *) NULL
+
+
+ +

+empty List struct +

Referenced by samp_bibLoad(), samp_call(), samp_callAll(), samp_callAndWait(), samp_cmdExec(), samp_coordPointAtSky(), samp_DeclareMetadata(), samp_DeclareSubscriptions(), samp_envGet(), samp_envSet(), samp_GetMetadata(), samp_imageLoadFITS(), samp_notify(), samp_notifyAll(), samp_paramGet(), samp_paramSet(), samp_Register(), samp_Reply(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), samp_tableSelectRowList(), and samp_UnRegister().

+ +
+

+ +

+
+ + + + +
handle_t hubHandles[MAX_HUBS]
+
+
+ +

+No. of available hubs +

+

+ +

+
+ + + + +
Map nullMap
+
+
+ +

+SAMP handle +

+

+ +

+
+ + + + +
int numHubs = 0
+
+
+ +

+HUB connection +

+

+ +

+
+ + + + +
pthread_mutex_t samp_mutex = PTHREAD_MUTEX_INITIALIZER
+
+
+ +

+lock so we can update struct +

Referenced by samp_processHubEvent().

+ +
+

+

+
Generated on Wed Feb 27 21:10:15 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampList_8c.html b/vendor/voclient/libsamp/doc/html/sampList_8c.html new file mode 100644 index 00000000..8cda5200 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampList_8c.html @@ -0,0 +1,544 @@ + + +SAMP Client Library: sampList.c File Reference + + + + + +
+

sampList.c File Reference

(Internal) interface to support the List structure. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Functions

handle_t samp_newList ()
 Create a new List object.
void samp_freeList (List list)
 Free the given List object.
int samp_listLen (List list)
 Get number of elements in a List.
void samp_setStringInList (List list, char *value)
 Set a string in a List (append).
void samp_setMapInList (List list, Map map)
 Set a Map in a List (append).
void samp_setListInList (List list1, List list2)
 Set a List in another List (append).
void samp_setIntInList (List list, int ival)
 Set an Int in a List (append).
void samp_setFloatInList (List list, float rval)
 Set a Float in a List (append).
char * samp_getStringFromList (List list, int index)
 Get a string from the List.
Map samp_getMapFromList (List list, int index)
 Get a Map from the List.
List samp_getListFromList (List list, int index)
 Get a List from the List.
+int samp_getIntFromList (List list, int index)
float samp_getFloatFromList (List list, int index)
 Get a Float from the List.
+

Detailed Description

+(Internal) interface to support the List structure. +

+SAMPLIST.C -- (Internal) interface to support the List structure.

+list = samp_newList () samp_freeList (List list) len = samp_listLen (List list)

+samp_setStringInList (List list, char *value) samp_setMapInList (List list, Map map) samp_setListInList (List list1, List list2) samp_setIntInList (List list, int val) samp_setFloatInList (List list, float val)

+str = samp_getStringFromList (List list, int index) map = samp_getMapFromList (List list, int index) list = samp_getListFromList (List list, int index) ival = samp_getIntFromList (List list, int index) rval = samp_getFloatFromList (List list, int index)

+

Author:
Mike Fitzpatrick
+
Date:
7/10/09
+

Function Documentation

+ +
+
+ + + + + + + + + +
void samp_freeList (List  list  ) 
+
+
+ +

+Free the given List object. +

+SAMP_FREELIST -- Free the given List object

+

Parameters:
+ + +
list List object handle
+
+
Returns:
nothing
+ +

Referenced by samp_mapClients(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
float samp_getFloatFromList (List  list,
int  index 
)
+
+
+ +

+Get a Float from the List. +

+SAMP_GETFLOATFROMLIST -- Get a Float from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the desired value
+
+
Returns:
int value
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
List samp_getListFromList (List  list,
int  index 
)
+
+
+ +

+Get a List from the List. +

+Get an Int from the List.

+SAMP_GETLISTFROMLIST -- Get a List from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the List
+
+
Returns:
List handle
+SAMP_GETINTFROMLIST -- Get an Int from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the desired value
+
+
Returns:
int value
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
Map samp_getMapFromList (List  list,
int  index 
)
+
+
+ +

+Get a Map from the List. +

+SAMP_GETMAPFROMLIST -- Get a Map from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the Map
+
+
Returns:
Map handle
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char* samp_getStringFromList (List  list,
int  index 
)
+
+
+ +

+Get a string from the List. +

+SAMP_GETSTRINGFROMLIST -- Get a string from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the string
+
+
Returns:
character string
+ +

Referenced by samp_mapClients().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_listLen (List  list  ) 
+
+
+ +

+Get number of elements in a List. +

+SAMP_LISTLEN -- Get number of elements in a List.

+

Parameters:
+ + +
list List object handle
+
+
Returns:
nothing
+ +

Referenced by samp_execUserHandler(), samp_GetRegisteredClients(), samp_GetSubscribedClients(), samp_mapClients(), and samp_tbSelectHandler().

+ +
+

+ +

+
+ + + + + + + + + +
handle_t samp_newList (void   ) 
+
+
+ +

+Create a new List object. +

+SAMP_NEWLIST -- Create a new List object

+

Returns:
handle to List object
+ +

Referenced by samp_GetRegisteredClients(), samp_GetSubscribedClients(), samp_tableSelectRowList(), and sampInit().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setFloatInList (List  list,
float  rval 
)
+
+
+ +

+Set a Float in a List (append). +

+SAMP_SETFLOATINLIST -- Set a Float in a List (append)

+

Parameters:
+ + + +
list1 List object handle
rval Float value to be appended
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setIntInList (List  list,
int  ival 
)
+
+
+ +

+Set an Int in a List (append). +

+SAMP_SETINTINLIST -- Set an Int in a List (append)

+

Parameters:
+ + + +
list1 List object handle
ival Integer value to be appended
+
+
Returns:
nothing
+ +

Referenced by samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setListInList (List  list1,
List  list2 
)
+
+
+ +

+Set a List in another List (append). +

+SAMP_SETLISTINLIST -- Set a List in another List (append)

+

Parameters:
+ + + +
list1 List object handle
list2 List to be appended
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setMapInList (List  list,
Map  map 
)
+
+
+ +

+Set a Map in a List (append). +

+SAMP_SETMAPINLIST -- Set a Map in a List (append)

+

Parameters:
+ + + +
list List object handle
map Map object to be set
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setStringInList (List  list,
char *  value 
)
+
+
+ +

+Set a string in a List (append). +

+SAMP_SETSTRINGINLIST -- Set a string in a List (append)

+

Parameters:
+ + + +
list List object handle
value string value to set
+
+
Returns:
nothing
+ +

Referenced by samp_GetRegisteredClients(), and samp_GetSubscribedClients().

+ +
+

+

+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampLog_8c.html b/vendor/voclient/libsamp/doc/html/sampLog_8c.html new file mode 100644 index 00000000..e4549f8a --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampLog_8c.html @@ -0,0 +1,169 @@ + + +SAMP Client Library: sampLog.c File Reference + + + + + +
+

sampLog.c File Reference

SAMP trace and logging interface. +More... +

+#include <stdio.h>
+#include <fcntl.h>
+#include <signal.h>
+#include <unistd.h>
+#include <stdlib.h>
+#include <string.h>
+#include <stdarg.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + +

Defines

+#define SZ_FMTSPEC   25
+#define EOS   0
+#define T_INT   0
+#define T_DOUBLE   1
+#define T_CHAR   2

Functions

void sampLog (handle_t handle, char *format,...)
 SAMP message logger.
void sampTrace (handle_t handle, char *format,...)
 SAMP tracer.
+

Detailed Description

+SAMP trace and logging interface. +

+SAMPLOG.C -- SAMP trace and logging interface.

+

Author:
Mike Fitzpatrick
+
Date:
6/10/09
+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void sampLog (handle_t  handle,
char *  format,
  ... 
)
+
+
+ +

+SAMP message logger. +

+SAMPLOG -- SAMP message logger.

+

Parameters:
+ + + +
handle SAMP handle
format message format string
+
+
Returns:
nothing
+ +

References Samp::debug, and Samp::logfd.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void sampTrace (handle_t  handle,
char *  format,
  ... 
)
+
+
+ +

+SAMP tracer. +

+SAMPTRACE -- SAMP tracer.

+

Parameters:
+ + + +
handle SAMP handle
format message format string
+
+
Returns:
nothing
+ +

References Samp::trace.

+ +

Referenced by samp_Metadata(), sampClose(), and sampInit().

+ +
+

+

+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampMTypes_8c.html b/vendor/voclient/libsamp/doc/html/sampMTypes_8c.html new file mode 100644 index 00000000..4007553d --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampMTypes_8c.html @@ -0,0 +1,1012 @@ + + +SAMP Client Library: sampMTypes.c File Reference + + + + + +
+

sampMTypes.c File Reference

SAMP interface procedures for application mtypes. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include <time.h>
+#include <ctype.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Functions

int samp_tableLoadVOTable (handle_t handle, String recip, String url, String tableId, String name)
 Tell an app to load a VOTable.
int samp_tableLoadFITS (handle_t handle, String recip, String url, String tableId, String name)
 Tell an app to load a FITS table.
int samp_tableHighlightRow (handle_t handle, String recip, String tableId, String url, int row)
 Tell an app to highlight a table row.
int samp_tableSelectRowList (handle_t handle, String recip, String tableId, String url, int rows[], int nrows)
 Tell an app to select a list of table rows.
int samp_imageLoadFITS (handle_t handle, String recip, String url, String imageId, String name)
 Tell an app to load a FITS image.
int samp_coordPointAtSky (handle_t handle, String recip, float ra, float dec)
 Tell an app to point at an RA/Dec coordinate.
int samp_specLoadSSAGeneric (handle_t handle, String recip, String url, Map meta, String spectrumId, String name)
 Load a generic spectrum from an SSA service.
int samp_cmdExec (handle_t handle, String recip, String cmd)
 Execute a command in a remote application.
char * samp_envGet (handle_t handle, String recip, String name)
 Get an environment variable in a remote application.
int samp_envSet (handle_t handle, String recip, String name, String value)
 Set an environment variable in a remote application.
char * samp_paramGet (handle_t handle, String recip, String name)
 Get a parameter variable in a remote application.
int samp_paramSet (handle_t handle, String recip, String name, String value)
 Set an parameter variable in a remote application.
int samp_bibLoad (handle_t handle, String recip, String bibcode)
 Exchange a bibcode.
int samp_resourceLoad (handle_t handle, String recip, String type, String name, Map resMap)
 Exchange a resource list.
int samp_sendGeneric (handle_t handle, String recip, String mtype, String args[])
 Send a geenric message.
int samp_sendMsg (handle_t handle, String recip, Map msg)
 Send the specified message.
+

Detailed Description

+SAMP interface procedures for application mtypes. +

+SAMPMTYPES.C -- SAMP interface procedures for application mtypes.

+samp_tableLoadVOTable (handle, recip, url, tableId, name) samp_tableLoadFITS (handle, recip, url, tableId, name) samp_tableHighlightRow (handle, recip, tableId, url, row) samp_tableSelectRowList (handle, recip, tableId, url, rows[], nrows)

+samp_imageLoadFITS (handle, recip, url, imageId, name) samp_coordPointAtSky (handle, recip, ra, dec)

+samp_specLoadSSAGeneric (handle, recip, url, meta_map, specId, name) samp_cmdExec (handle, recip, cmd) samp_envGet (handle, recip, name) samp_envSet (handle, recip, name, value) samp_paramGet (handle, recip, name) samp_paramSet (handle, recip, name, value) samp_bibLoad (handle, recip, bibcode) samp_resourceLoad (handle, recip, type, resList[])

+samp_sendGeneric (handle, recip, mtype, args) samp_sendMsg (handle, recip, Map msg_map)

+

Author:
Mike Fitzpatrick
+
Date:
7/18/11
+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_bibLoad (handle_t  handle,
String  recip,
String  bibcode 
)
+
+
+ +

+Exchange a bibcode. +

+SAMP_BIBLOAD -- Exchange a bibcode.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
bibcode Bibcode string
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_cmdExec (handle_t  handle,
String  recip,
String  cmd 
)
+
+
+ +

+Execute a command in a remote application. +

+SAMP_CMDEXEC -- Execute a command in a remote application.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
cmd Command string
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_coordPointAtSky (handle_t  handle,
String  recip,
float  ra,
float  dec 
)
+
+
+ +

+Tell an app to point at an RA/Dec coordinate. +

+SAMP_COORDPOINTATSKY -- Tell an app to point at an RA/Dec coordinate.

+

Parameters:
+ + + + + +
handle samp struct handle
recip name of recipient (or 'all')
ra RA of coord in degrees
dec Dec of coord in degrees
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_addFloatParam(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
char* samp_envGet (handle_t  handle,
String  recip,
String  name 
)
+
+
+ +

+Get an environment variable in a remote application. +

+SAMP_ENVGET -- Get an environment variable in a remote application.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
+
+
Returns:
NULL, Value of variable, or list of values
+ +

References Samp::clients, Samp::errortxt, Samp::hub, hub, Hub::id, Client::name, Samp::nclients, Hub::privateKey, samp_app2id(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and Hub::timeout.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_envSet (handle_t  handle,
String  recip,
String  name,
String  value 
)
+
+
+ +

+Set an environment variable in a remote application. +

+SAMP_ENVSET -- Set an environment variable in a remote application.

+

Parameters:
+ + + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
value Value of variable or NULL
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_imageLoadFITS (handle_t  handle,
String  recip,
String  url,
String  imageId,
String  name 
)
+
+
+ +

+Tell an app to load a FITS image. +

+SAMP_IMAGELOADFITS -- Tell an app to load a FITS image.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
url URL to table to be loaded
imageId ID assigned to image (optional)
name Name assigned to image (optional)
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
char* samp_paramGet (handle_t  handle,
String  recip,
String  name 
)
+
+
+ +

+Get a parameter variable in a remote application. +

+SAMP_PARAMGET -- Get a parameter variable in a remote application.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
+
+
Returns:
NULL, Value of variable, or list of values
+ +

References Samp::clients, Samp::errortxt, Samp::hub, hub, Hub::id, Client::name, Samp::nclients, Hub::privateKey, samp_app2id(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and Hub::timeout.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_paramSet (handle_t  handle,
String  recip,
String  name,
String  value 
)
+
+
+ +

+Set an parameter variable in a remote application. +

+SAMP_PARAMSET -- Set an parameter variable in a remote application.

+

Parameters:
+ + + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
value Value of variable or NULL
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resourceLoad (handle_t  handle,
String  recip,
String  type,
String  name,
Map  resMap 
)
+
+
+ +

+Exchange a resource list. +

+SAMP_RESOURCELOAD -- Exchange a resource list.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Name of recipient (or 'all')
type Resource type (or NULL)
name Descriptive name (optional)
resMap Resource map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_addMapParam(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), samp_sendMsg(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_sendGeneric (handle_t  handle,
String  recip,
String  mtype,
String  args[] 
)
+
+
+ +

+Send a geenric message. +

+SAMP_SENDGENERIC -- Send a generic message.

+

Parameters:
+ + + + + +
handle samp struct handle
recip Name of recipient (or 'all')
mtype Message type
args Argument list
+
+
Returns:
SAMP_OK or SAMP_ERR
+This method can be used to send any user-defined message. The 'mtype' string is arbitrary, we just assume the receiving client can understand what it means. The 'args' String array can be an array of values in which case the parameter name will be a series of generic 'arg0' thru 'argN-1' names. +

References Samp::hub, hub, samp_addFloatParam(), samp_addIntParam(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), samp_sendMsg(), and SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_sendMsg (handle_t  handle,
String  recip,
Map  msg 
)
+
+
+ +

+Send the specified message. +

+SAMP_SENDMSG -- Send the specified message.

+

Parameters:
+ + + + +
handle samp struct handle
recip Name of recipient (or 'all')
msg Message map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::clients, Samp::msgMode, Samp::nclients, samp_app2id(), samp_call(), samp_callAll(), samp_callAndWait(), samp_notify(), samp_notifyAll(), and samp_setErr().

+ +

Referenced by samp_bibLoad(), samp_cmdExec(), samp_coordPointAtSky(), samp_envSet(), samp_imageLoadFITS(), samp_paramSet(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_specLoadSSAGeneric (handle_t  handle,
String  recip,
String  url,
Map  meta,
String  spectrumId,
String  name 
)
+
+
+ +

+Load a generic spectrum from an SSA service. +

+SAMP_SPECLOADSSAGENERIC -- Load a generic spectrum from an SSA service.

+

Parameters:
+ + + + + + + +
handle samp struct handle
recip name of recipient (or 'all')
url URL of spectrum to load
meta Metadata map describing data found at the URL
spectrumId Identifier for spectrum (optional)
name Name used to label spectrum (optional);
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_addMapParam(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tableHighlightRow (handle_t  handle,
String  recip,
String  tableId,
String  url,
int  row 
)
+
+
+ +

+Tell an app to highlight a table row. +

+SAMP_TABLEHIGHLIGHTROW -- Tell an app to highlight a table row.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
tableId ID associated with a previously loaded table
url URL to table to be loaded
rows List of (zero-based) row indices
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_addIntParam(), samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tableLoadFITS (handle_t  handle,
String  recip,
String  url,
String  tableId,
String  name 
)
+
+
+ +

+Tell an app to load a FITS table. +

+SAMP_TABLELOADFITS -- Tell an app to load a FITS table.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
url URL to table to be loaded
tableId ID assigned to table (optional)
name Name assigned to table (optional)
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tableLoadVOTable (handle_t  handle,
String  recip,
String  url,
String  tableId,
String  name 
)
+
+
+ +

+Tell an app to load a VOTable. +

+SAMP_TABLELOADVOTABLE -- Tell an app to load a VOTable.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
url URL to table to be loaded
tableId ID assigned to table (optional)
name Name assigned to table (optional)
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_freeMsg(), samp_msgParam(), samp_newMsg(), samp_newParam(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tableSelectRowList (handle_t  handle,
String  recip,
String  tableId,
String  url,
int  rows[],
int  nrows 
)
+
+
+ +

+Tell an app to select a list of table rows. +

+SAMP_TABLESELECTROWLIST -- Tell an app to select a list of table rows.

+

Parameters:
+ + + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
tableId ID associated with a previously loaded table
url URL to table to be loaded
rows Array of (zero-based) row indices
nrows Number of rows
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

References Samp::hub, hub, samp_addListParam(), samp_freeList(), samp_freeMsg(), samp_msgParam(), samp_newList(), samp_newMsg(), samp_newParam(), samp_sendMsg(), and samp_setIntInList().

+ +
+

+

+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampMap_8c.html b/vendor/voclient/libsamp/doc/html/sampMap_8c.html new file mode 100644 index 00000000..80ccf1c5 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampMap_8c.html @@ -0,0 +1,593 @@ + + +SAMP Client Library: sampMap.c File Reference + + + + + +
+

sampMap.c File Reference

(Internal) Interface to support the Map structure +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Functions

handle_t samp_newMap ()
 Create a new Map object.
void samp_freeMap (Map map)
 Free the given Map object.
+int samp_getMapSize (Map map)
+char * samp_getMapKey (Map map, int index)
+char * samp_getMapVal (Map map, int index)
void samp_setStringInMap (Map map, char *key, char *value)
 Set a string in a Map (append).
void samp_setMapInMap (Map map1, char *key, Map map2)
 Set a Map in a Map (append).
void samp_setListInMap (Map map, char *key, List list)
 Set a List in a Map (append).
void samp_setIntInMap (Map map, char *key, int value)
 Set a Int in a Map (append).
void samp_setFloatInMap (Map map, char *key, float value)
 Set a string in a Map (append).
char * samp_getStringFromMap (Map map, char *key)
 Get a string from the Map.
Map samp_getMapFromMap (Map map, char *key)
 Get a Map from the Map.
List samp_getListFromMap (Map map, char *key)
 Get a LIST from the Map.
int samp_getIntFromMap (Map map, char *key)
 Get a integer from the Map.
float samp_getFloatFromMap (Map map, char *key)
 Get a float from the Map.
+

Detailed Description

+(Internal) Interface to support the Map structure +

+SAMPMAP.C -- (Internal) Interface to support the Map structure

+map = samp_newMap () samp_freeMap (Map map)

+nelem = samp_getMapSize (Map map) key = samp_getMapKey (Map map, int index) val = samp_getMapVal (Map map, int index)

+samp_setStringInMap (Map map, char *value) samp_setMapInMap (Map map1, Map map2) samp_setListInMap (Map map, List list) samp_setIntInMap (Map map, int ival) samp_setFloatInMap (Map map, float rval)

+str = samp_getStringFromMap (Map map, char *key) map = samp_getMapFromMap (Map map, char *key) list = samp_getListFromMap (Map map, char *key) ival = samp_getIntFromMap (Map map, char *key) rval = samp_getFloatFromMap (Map map, char *key)

+

Author:
Mike Fitzpatrick
+
Date:
7/10/09
+

Function Documentation

+ +
+
+ + + + + + + + + +
void samp_freeMap (Map  map  ) 
+
+
+ +

+Free the given Map object. +

+SAMP_FREEMAP -- Free the given Map object

+

Parameters:
+ + +
map Map object to free
+
+
Returns:
nothing
+ +

Referenced by samp_envGetHandler(), samp_hubDeclareSubscriptions(), samp_paramGetHandler(), and samp_Ping().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
float samp_getFloatFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a float from the Map. +

+SAMP_GETFLOATFROMMAP -- Get a float from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
floating point value
+ +

Referenced by samp_execUserHandler(), and samp_pointAtHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_getIntFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a integer from the Map. +

+SAMP_GETINTFROMMAP -- Get a integer from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
integer value
+ +

Referenced by samp_execUserHandler(), and samp_tbHighlightHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
List samp_getListFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a LIST from the Map. +

+SAMP_GETLISTFROMMAP -- Get a LIST from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
handle to List value
+ +

Referenced by samp_execUserHandler(), and samp_tbSelectHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
Map samp_getMapFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a Map from the Map. +

+SAMP_GETMAPFROMMAP -- Get a Map from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
handle to Map value
+ +

Referenced by samp_execUserHandler(), samp_resConeHandler(), samp_resLoadHandler(), samp_resSiapHandler(), samp_resSsapHandler(), samp_resTapHandler(), samp_resVOSpaceHandler(), samp_specLoadHandler(), and samp_specSSAHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char* samp_getStringFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a string from the Map. +

+SAMP_GETSTRINGFROMMAP -- Get a string from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
string value from Map
+ +

Referenced by samp_bibcodeHandler(), samp_cmdExecHandler(), samp_envGetHandler(), samp_envSetHandler(), samp_execUserHandler(), samp_imLoadHandler(), samp_paramGetHandler(), samp_paramSetHandler(), samp_resConeHandler(), samp_resLoadHandler(), samp_resSiapHandler(), samp_resSsapHandler(), samp_resTapHandler(), samp_resVOSpaceHandler(), samp_specLoadHandler(), samp_specSSAHandler(), samp_tbHighlightHandler(), samp_tbLoadFITSHandler(), samp_tbLoadHandler(), samp_tbLoadVOTHandler(), and samp_tbSelectHandler().

+ +
+

+ +

+
+ + + + + + + + + +
handle_t samp_newMap (void   ) 
+
+
+ +

+Create a new Map object. +

+SAMP_NEWMAP -- Create a new Map object

+

Returns:
handle to new Map
+ +

Referenced by samp_envGetHandler(), samp_getNullMap(), samp_getOKMap(), samp_paramGetHandler(), and sampInit().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setFloatInMap (Map  map,
char *  key,
float  value 
)
+
+
+ +

+Set a string in a Map (append). +

+SAMP_SETFLOATINMAP -- Set a Float in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
value value
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setIntInMap (Map  map,
char *  key,
int  value 
)
+
+
+ +

+Set a Int in a Map (append). +

+SAMP_SETINTINMAP -- Set a Int in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
value value
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setListInMap (Map  map,
char *  key,
List  list 
)
+
+
+ +

+Set a List in a Map (append). +

+SAMP_SETLISTINMAP -- Set a List in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
list handle to List object to set
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setMapInMap (Map  map1,
char *  key,
Map  map2 
)
+
+
+ +

+Set a Map in a Map (append). +

+SAMP_SETMAPINMAP -- Set a Map in a Map (append)

+

Parameters:
+ + + + +
map1 handle to Map object
key Map key
map2 handle to Map object to set
+
+
Returns:
nothing
+ +

Referenced by samp_envGetHandler(), samp_getOKMap(), samp_paramGetHandler(), and sampInit().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setStringInMap (Map  map,
char *  key,
char *  value 
)
+
+
+ +

+Set a string in a Map (append). +

+SAMP_SETSTRINGINMAP -- Set a string in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
value Map value
+
+
Returns:
nothing
+ +

Referenced by samp_envGetHandler(), samp_getOKMap(), samp_paramGetHandler(), and sampInit().

+ +
+

+

+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampMethods_8c.html b/vendor/voclient/libsamp/doc/html/sampMethods_8c.html new file mode 100644 index 00000000..ad9c8b7a --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampMethods_8c.html @@ -0,0 +1,294 @@ + + +SAMP Client Library: sampMethods.c File Reference + + + + + +
+

sampMethods.c File Reference

SAMP methods implemented by a callable client. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include <time.h>
+#include <ctype.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Defines

+#define METH_DBG   (getenv("METH_DBG")!=NULL||access("/tmp/METH_DBG",F_OK)==0)
+#define OK_Map   samp_getOKMap()

Functions

int samp_receiveCall (void *data)
 test.echo method
int samp_receiveNotification (void *data)
 receiveNotification () client method.
int samp_receiveResponse (void *data)
 receiveResponse () client method.
void samp_setHandlerReply (Map resp)
 Set the Samp Handler reply map.
Map samp_getHandlerReply ()
 Get the Samp Handler reply map.

Variables

Map nullMap
List nullList
+Samp * sampP
handle_t sampH
+

Detailed Description

+SAMP methods implemented by a callable client. +

+SAMPMETHODS.C -- SAMP methods implemented by a callable client.

+

Author:
Mike Fitzpatrick
+
Date:
7/10/09
+

Function Documentation

+ +
+
+ + + + + + + + + +
Map samp_getHandlerReply (void   ) 
+
+
+ +

+Get the Samp Handler reply map. +

+SAMP_GETHANDLERREPLY -- Get the Samp Handler reply map.

+

Returns:
Map handle for reply map
+ +

References nullMap, and OK_Map.

+ +

Referenced by samp_receiveCall(), and samp_receiveNotification().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_receiveCall (void *  data  ) 
+
+
+ +

+test.echo method +

+receiveCall () client method.

+SAMP_TESTECHO -- test.echo method

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+SAMP_RECEIVECALL -- receiveCall() client method.

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+ +

References Samp::defaultUserFunc, OK_Map, samp_execUserHandler(), samp_getHandlerReply(), samp_getSampHandler(), samp_getUserHandler(), samp_Reply(), sampH, and Samp::trace.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_receiveNotification (void *  data  ) 
+
+
+ +

+receiveNotification () client method. +

+SAMP_RECEIVENOTIFICATION -- receiveNotification() client method.

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+ +

References Samp::defaultUserFunc, OK_Map, samp_execUserHandler(), samp_getHandlerReply(), samp_getSampHandler(), samp_getUserHandler(), samp_processHubEvent(), and Samp::trace.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_receiveResponse (void *  data  ) 
+
+
+ +

+receiveResponse () client method. +

+SAMP_RECEIVERESPONSE -- receiveResponse() client method.

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+ +

References Samp::defaultUserFunc, OK_Map, samp_execUserHandler(), and Samp::trace.

+ +
+

+ +

+
+ + + + + + + + + +
void samp_setHandlerReply (Map  resp  ) 
+
+
+ +

+Set the Samp Handler reply map. +

+SAMP_SETHANDLERREPLY -- Set the Samp Handler reply map.

+

Parameters:
+ + +
resp response map
+
+
Returns:
nothing
+ +

Referenced by samp_envGetHandler(), and samp_paramGetHandler().

+ +
+

+

Variable Documentation

+ +
+
+ + + + +
List nullList
+
+
+ +

+SAMP_OK Map struct +

Referenced by sampInit().

+ +
+

+ +

+
+ + + + +
Map nullMap
+
+
+ +

+SAMP handle +

Referenced by samp_getHandlerReply(), samp_getOKMap(), samp_hubDeclareSubscriptions(), and sampInit().

+ +
+

+ +

+
+ + + + +
handle_t sampH
+
+
+ +

+SAMP struct pointer +

Referenced by samp_processHubEvent(), samp_receiveCall(), and sampInit().

+ +
+

+

+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampMsg_8c.html b/vendor/voclient/libsamp/doc/html/sampMsg_8c.html new file mode 100644 index 00000000..98ae88ab --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampMsg_8c.html @@ -0,0 +1,163 @@ + + +SAMP Client Library: sampMsg.c File Reference + + + + + +
+

sampMsg.c File Reference

(Internal) Interface to Message objects. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + +

Functions

Msg samp_newMsg ()
 Create a new Msg object.
void samp_freeMsg (Msg msg)
 Free the given Msg object.
+void samp_msgMType (Msg msg, String mtype)
+char * samp_msgTag ()
void samp_msgParam (Msg msg, Param param)
 Add a parameter to the Msg.
+

Detailed Description

+(Internal) Interface to Message objects. +

+SAMPMSG.C -- (Internal) Interface to Message objects.

+msg = samp_newMsg () samp_msgMType (Msg msg, String mtype) samp_msgParam (Msg msg, Param param) samp_msgTag () samp_freeMsg (Msg msg)

+

Author:
Mike Fitzpatrick
+
Date:
7/10/11
+

Function Documentation

+ +
+
+ + + + + + + + + +
void samp_freeMsg (Msg  msg  ) 
+
+
+ +

+Free the given Msg object. +

+SAMP_FREEMSG -- Free the given Msg object

+

Parameters:
+ + +
msg Msg object to free
+
+
Returns:
nothing
+ +

Referenced by samp_bibLoad(), samp_cmdExec(), samp_coordPointAtSky(), samp_envGet(), samp_envSet(), samp_imageLoadFITS(), samp_paramGet(), samp_paramSet(), samp_Ping(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_msgParam (Msg  msg,
Param  param 
)
+
+
+ +

+Add a parameter to the Msg. +

+SAMP_MSGPARAM -- Add a parameter to the Msg.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
param parameter map
+
+
Returns:
nothing
+ +

Referenced by samp_bibLoad(), samp_cmdExec(), samp_coordPointAtSky(), samp_envGet(), samp_envSet(), samp_imageLoadFITS(), samp_paramGet(), samp_paramSet(), samp_Ping(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + +
Msg samp_newMsg (void   ) 
+
+
+ +

+Create a new Msg object. +

+SAMP_NEWMSG -- Create a new Msg object

+

Returns:
handle to new Msg
+ +

Referenced by samp_bibLoad(), samp_cmdExec(), samp_coordPointAtSky(), samp_envGet(), samp_envSet(), samp_imageLoadFITS(), samp_paramGet(), samp_paramSet(), samp_Ping(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), and samp_tableSelectRowList().

+ +
+

+

+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampParam_8c.html b/vendor/voclient/libsamp/doc/html/sampParam_8c.html new file mode 100644 index 00000000..279262d1 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampParam_8c.html @@ -0,0 +1,392 @@ + + +SAMP Client Library: sampParam.c File Reference + + + + + +
+

sampParam.c File Reference

(Internal) Interface to Param objects. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Functions

Param samp_newParam ()
 Create a new Param object.
void samp_freeParam (Param param)
 Free the given Msg object.
Param samp_paramInit (Msg msg)
 Get number of Params.
+void samp_addStringParam (Msg msg, char *keyw, String val)
void samp_addMapParam (Msg msg, char *keyw, Map val)
 Add a parameter to the Param.
void samp_addListParam (Msg msg, char *keyw, List val)
 Add a parameter to the Param.
void samp_addIntParam (Msg msg, char *keyw, int val)
 Add a <SAMP int>=""> parameter to the Param.
void samp_addFloatParam (Msg msg, char *keyw, float val)
 Add a <SAMP float>=""> parameter to the Param.
int samp_paramLen (Msg msg)
 Get number of Params.
+

Detailed Description

+(Internal) Interface to Param objects. +

+SAMPPARAM.C -- (Internal) Interface to Param objects.

+param = samp_newParam () samp_freeParam (Param param)

+param = samp_paramInit (Msg msg); samp_addStringParam (Msg msg, char *keyw, String val) samp_addListParam (Msg msg, char *keyw, List val) samp_addMapParam (Msg msg, char *keyw, Map val) N = samp_paramLen (Msg msg)

+

Author:
Mike Fitzpatrick
+
Date:
7/10/11
+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addFloatParam (Msg  msg,
char *  keyw,
float  val 
)
+
+
+ +

+Add a <SAMP float>=""> parameter to the Param. +

+SAMP_ADDFLOATPARAM -- Add a <SAMP float>=""> parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val floating point value
+
+
Returns:
nothing
+ +

References samp_paramInit().

+ +

Referenced by samp_coordPointAtSky(), and samp_sendGeneric().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addIntParam (Msg  msg,
char *  keyw,
int  val 
)
+
+
+ +

+Add a <SAMP int>=""> parameter to the Param. +

+SAMP_ADDINTPARAM -- Add a <SAMP int>=""> parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val integer value
+
+
Returns:
nothing
+ +

References samp_paramInit().

+ +

Referenced by samp_sendGeneric(), and samp_tableHighlightRow().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addListParam (Msg  msg,
char *  keyw,
List  val 
)
+
+
+ +

+Add a parameter to the Param. +

+SAMP_ADDLISTPARAM -- Add a List parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val value list
+
+
Returns:
nothing
+ +

References samp_paramInit().

+ +

Referenced by samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addMapParam (Msg  msg,
char *  keyw,
Map  val 
)
+
+
+ +

+Add a parameter to the Param. +

+SAMP_ADDMAPPARAM -- Add a Map parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val value map
+
+
Returns:
nothing
+ +

References samp_paramInit().

+ +

Referenced by samp_resourceLoad(), and samp_specLoadSSAGeneric().

+ +
+

+ +

+
+ + + + + + + + + +
void samp_freeParam (Param  param  ) 
+
+
+ +

+Free the given Msg object. +

+SAMP_FREEPARAM -- Free the given Param object

+

Parameters:
+ + +
param Param object to free
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
Param samp_newParam (void   ) 
+
+
+ +

+Create a new Param object. +

+SAMP_NEWPARAM -- Create a new Param object

+

Returns:
handle to new Param
+ +

Referenced by samp_bibLoad(), samp_cmdExec(), samp_coordPointAtSky(), samp_envGet(), samp_envSet(), samp_imageLoadFITS(), samp_paramGet(), samp_paramSet(), samp_Ping(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + +
Param samp_paramInit (Msg  msg  ) 
+
+
+ +

+Get number of Params. +

+SAMP_PARAMINIT -- Get number of Params.

+

Parameters:
+ + +
msg handle to Msg object
+
+
Returns:
nothing
+ +

Referenced by samp_addFloatParam(), samp_addIntParam(), samp_addListParam(), and samp_addMapParam().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_paramLen (Msg  msg  ) 
+
+
+ +

+Get number of Params. +

+SAMP_PARAMLEN -- Get number of Params.

+

Parameters:
+ + +
msg handle to Msg object
+
+
Returns:
nothing
+ +
+

+

+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/sampUtil_8c.html b/vendor/voclient/libsamp/doc/html/sampUtil_8c.html new file mode 100644 index 00000000..66601248 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/sampUtil_8c.html @@ -0,0 +1,278 @@ + + +SAMP Client Library: sampUtil.c File Reference + + + + + +
+

sampUtil.c File Reference

Utility methods to convert struct pointers to user handles. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include <time.h>
+#include <ctype.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Defines

+#define MAX_HANDLES   128

Functions

+handle_t samp_P2H (void *ptr)
+void * samp_H2P (handle_t handle)
+handle_t samp_newHandle (void *ptr)
+void samp_freeHandle (handle_t handle)
char * samp_app2id (handle_t handle, char *appName)
 Convert an application name to a public-ID.
char * samp_id2app (handle_t handle, char *pubId)
 Convert a public-ID to the application name.
int samp_serverPort ()
 Return a unique port number for the server.
void samp_printMetadata (handle_t handle, String name)
 Print the metadata for the application.
char * samp_getMetadata (handle_t handle, String name)
 Get the metadata item for the application.

Variables

+int numHandles = 0
+long sampHandles [MAX_HANDLES]
+

Detailed Description

+Utility methods to convert struct pointers to user handles. +

+SAMPUTIL.C -- Utility methods to convert struct pointers to user handles.

+

Author:
Mike Fitzpatrick
+
Date:
7/10/09
+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + +
char* samp_app2id (handle_t  handle,
char *  appName 
)
+
+
+ +

+Convert an application name to a public-ID. +

+SAMP_APP2ID -- Convert an application name to a public-ID.

+

Parameters:
+ + + +
handle samp struct handle
appName name of registered application
+
+
Returns:
public ID of application
+ +

References Samp::clients, Client::name, and Samp::nclients.

+ +

Referenced by samp_call(), samp_callAndWait(), samp_envGet(), samp_notify(), samp_paramGet(), samp_Ping(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char* samp_getMetadata (handle_t  handle,
String  name 
)
+
+
+ +

+Get the metadata item for the application. +

+SAMP_GETMETADATA -- Get the metadata item for the application.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References appMD::aKey, appMD::aVal, Samp::description, appMD::docURL, appMD::iconURL, Samp::meta, and appMD::nkeys.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char* samp_id2app (handle_t  handle,
char *  pubId 
)
+
+
+ +

+Convert a public-ID to the application name. +

+SAMP_ID2APP -- Convert a public-ID to the application name.

+

Parameters:
+ + + +
handle samp struct handle
pubId public ID of application
+
+
Returns:
name of registered application
+ +

References Samp::clients, Client::name, and Samp::nclients.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_printMetadata (handle_t  handle,
String  name 
)
+
+
+ +

+Print the metadata for the application. +

+SAMP_PRINTMETADATA -- Print the metadata for the application.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References appMD::aKey, appMD::aVal, Samp::description, appMD::docURL, appMD::iconURL, Samp::meta, and appMD::nkeys.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_serverPort (void   ) 
+
+
+ +

+Return a unique port number for the server. +

+SAMP_SERVERPORT -- Return a unique port number for the server.

+

Returns:
port number
+ +

Referenced by samp_hubSetXmlrpcCallback(), and sampInit().

+ +
+

+

+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/samp_8c.html b/vendor/voclient/libsamp/doc/html/samp_8c.html new file mode 100644 index 00000000..b709967e --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/samp_8c.html @@ -0,0 +1,1285 @@ + + +SAMP Client Library: samp.c File Reference + + + + + +
+

samp.c File Reference

Top-level interface to the SAMP library. +More... +

+#include <stdlib.h>
+#include <stdio.h>
+#include <unistd.h>
+#include <string.h>
+#include <time.h>
+#include <signal.h>
+#include <ctype.h>
+#include "samp.h"
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Defines

#define SZ_CLIENT_LIST   1024

Functions

handle_t sampInit (String appName, String description)
 Initialize the SAMP interface.
void sampClose (handle_t handle)
 Close the SAMP interface and free resources.
int sampDebug (handle_t handle, int value)
 Set interface debug level.
int sampVerbose (handle_t handle, int value)
 Set interface debug level.
int sampStartup (handle_t handle)
 Startup the SAMP interface to send/receive messages.
int sampShutdown (handle_t handle)
 Shut down the active SAMP interface.
int samp_hubActive (handle_t handle)
 Determine if the Hub is active (i.e. connected).
+int samp_setOpt (handle_t handle, char *opt, int value)
void samp_Metadata (handle_t handle, String field, String value)
 Set a metadata field value for the application.
void samp_Subscribe (handle_t handle, String mtype, void *userFunc)
 Subscribe to a given mtype.
void samp_Unsubscribe (handle_t handle, String mtype)
 Unsubscribe to a given mtype.
void samp_setCallMode (handle_t handle, int mode)
 Set the default calling mode (synch or asynch).
void samp_setSyncMode (handle_t handle)
 Set the calling mode to use synchronous messaging.
void samp_setASyncMode (handle_t handle)
 Set the calling mode to use asynchronous messaging.
void samp_setNotifyMode (handle_t handle)
 Set the calling mode to use notification messaging.
void samp_setMsgMode (handle_t handle, int mode)
 Set the message pattern to the specified mode.
void samp_setCallByRef (handle_t handle)
 Have interface call user handlers by reference.
void samp_setReplyCallback (handle_t handle, int *func)
 Set the Reply callback. samp_setReplyCallback (handle_t handle, int *func).
void samp_setResponseCallback (handle_t handle, int *func)
 Set the Response callback. samp_setResponseCallback (handle_t handle, int *func).
void samp_defaultReplyHandler (handle_t handle)
 The interface's default Reply handler.
+void samp_deaultfResponseHandler (handle_t handle)
int samp_replyStatus (handle_t handle)
 Reply with the status of the last message sent.
void samp_setTimeout (handle_t handle, int timeout)
 Set the message timeout value (in seconds).
+void samp_setAppName (handle_t handle, String name)
void samp_setAppVersion (handle_t handle, String version)
 Set the application name string.
int samp_mapClients (handle_t handle)
int samp_addClient (handle_t handle, String name, String id)
int samp_listClients (handle_t handle)
+char * samp_getClients (handle_t handle)
int samp_removeClient (handle_t handle, String id)
Map samp_getOKMap ()
Map samp_getNullMap ()

Variables

+Samp * sampP
handle_t sampH
Map nullMap
Map OK_Map
List nullList
Hub * hub
int numHubs
long hubHandles [MAX_HUBS]
+

Detailed Description

+Top-level interface to the SAMP library. +

+SAMP.C -- Top-level interface to the SAMP library.

+samp = sampInit (appName, descr) sampClose (samp)

+stat = sampStartup (samp) sampShutdown (samp)

+samp_Metadata (samp, field, value) samp_Subscribe (samp, mtype, handler) samp_Unsubscribe (samp, mtype)

+samp_setReplyCallback (samp, func) samp_setResponseCallback (samp, func) stat = samp_replyStatus (samp)

+Utility Methods: samp_setSyncMode (samp) // Default samp_setASyncMode (samp) samp_setNotifyMode (samp) samp_setCallByRef (samp)

+samp_setTimeout (samp, timeout) samp_setAppNmae (samp, version) samp_setAppVersion (samp, name)

+samp_mapClients (handle_t handle) samp_addClient (handle_t handle, String name, String id) samp_removeClient (handle_t handle, String id)

+

Author:
Mike Fitzpatrick
+
Date:
7/10/09
+

Define Documentation

+ +
+
+ + + + +
#define SZ_CLIENT_LIST   1024
+
+
+ +

+SAMP_GETCLIENTS -- Get a list of clients as a character string as the PubID and Name separated by a space, one client per line. +

+

+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_addClient (handle_t  handle,
String  name,
String  id 
)
+
+
+ +

+SAMP_ADDCLIENT -- Add a newly registered client to the list of known apps so we can do the public-private name translation. +

References Samp::clients, Client::name, Samp::nclients, and SZ_NAME.

+ +

Referenced by samp_processHubEvent().

+ +
+

+ +

+
+ + + + + + + + + +
samp_defaultReplyHandler (handle_t  handle  ) 
+
+
+ +

+The interface's default Reply handler. +

+SAMP_DEFAULTREPLYHANDLER -- The interface's default Reply handler.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
Map samp_getNullMap (void   ) 
+
+
+ +

+SAMP_GETNULLMAP -- Generate a 'Null' map we can return to the Hub. +

References samp_newMap().

+ +
+

+ +

+
+ + + + + + + + + +
Map samp_getOKMap (void   ) 
+
+
+ +

+SAMP_GETOKMAP -- Generate an 'OK' map we can return to the Hub. +

References nullMap, samp_newMap(), samp_setMapInMap(), and samp_setStringInMap().

+ +
+

+ +

+
+ + + + + + + + + +
samp_hubActive (handle_t  handle  ) 
+
+
+ +

+Determine if the Hub is active (i.e. connected). +

+SAMP_HUBACTIVE -- Determine if the Hub is active (i.e. connected).

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +

References Samp::active.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_listClients (handle_t  handle  ) 
+
+
+ +

+SAMP_LISTCLIENTS -- List the available clients to stdout. +

References Samp::clients, Client::name, and Samp::nclients.

+ +
+

+ +

+
+ + + + + + + + + +
int samp_mapClients (handle_t  handle  ) 
+
+
+ +

+SAMP_MAPCLIENTS -- Map the public-ids of registered clients to the appName. +

References Samp::clients, Client::name, Samp::nclients, samp_freeList(), samp_GetMetadata(), samp_GetRegisteredClients(), samp_getStringFromList(), samp_listLen(), and SZ_NAME.

+ +

Referenced by sampStartup().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
samp_Metadata (handle_t  handle,
String  field,
String  value 
)
+
+
+ +

+Set a metadata field value for the application. +

+SAMP_METADATA -- Set a metadata field for the application. This will be sent to the Hub later in a declareMetadata() call.

+

Parameters:
+ + + + +
handle samp handle
field metadata field to set (name, author, etc)
samp value of field
+
+
Returns:
nothing
+ +

References appMD::aKey, Samp::appVer, Hub::appVer, appMD::aVal, appMD::desc, Hub::description, Samp::description, appMD::docURL, Samp::hub, appMD::iconURL, Hub::meta, Samp::meta, appMD::nkeys, and sampTrace().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_removeClient (handle_t  handle,
String  id 
)
+
+
+ +

+SAMP_REMOVECLIENT -- Remove a registered client from the list of known apps that do the public-private name translation. +

References Samp::clients, Client::name, Samp::nclients, and SZ_NAME.

+ +

Referenced by samp_processHubEvent().

+ +
+

+ +

+
+ + + + + + + + + +
status samp_replyStatus (handle_t  handle  ) 
+
+
+ +

+Reply with the status of the last message sent. +

+SAMP_REPLYSTATUS -- Reply with the status of the last message sent.

+May be used to 'poll' for a reponse from the caller in cases where use of a callback is a problem. Codes are: <0==ERR, 0==PENDING, 1==OK

+

Parameters:
+ + +
samp samp struct ptr
+
+
Returns:
message status
+ +

Referenced by samp_Register().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
samp_setAppVersion (handle_t  handle,
String  version 
)
+
+
+ +

+Set the application name string. +

+Set the application version string.

+SAMP_SETAPPNAME -- Set the application name string.

+

Parameters:
+ + + +
handle samp handle
name application name
+
+
Returns:
nothing
+SAMP_SETAPPVERSION -- Set the application version string.

+

Parameters:
+ + + +
handle samp handle
name application version
+
+
Returns:
nothing
+ +

References Hub::appVer, Samp::appVer, and Samp::hub.

+ +
+

+ +

+
+ + + + + + + + + +
samp_setASyncMode (handle_t  handle  ) 
+
+
+ +

+Set the calling mode to use asynchronous messaging. +

+SAMP_SETASYNCMODE -- Set the calling mode to use asynchronous messaging.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References Samp::msgMode.

+ +
+

+ +

+
+ + + + + + + + + +
samp_setCallByRef (handle_t  handle  ) 
+
+
+ +

+Have interface call user handlers by reference. +

+SAMP_SETCALLBYREF -- Have interface call user handlers by reference.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References Samp::handlerMode.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
samp_setCallMode (handle_t  handle,
int  mode 
)
+
+
+ +

+Set the default calling mode (synch or asynch). +

+SAMP_SETCALLMODE -- Set the default calling mode (synch or asynch)

+

Parameters:
+ + + +
handle samp handle
mode call mode (synch or asynch)
+
+
Returns:
nothing
+ +

References Samp::msgMode.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
samp_setMsgMode (handle_t  handle,
int  mode 
)
+
+
+ +

+Set the message pattern to the specified mode. +

+SAMP_SETMSGMODE -- Set the message pattern to the specified mode.

+

Parameters:
+ + + +
handle samp handle
mode message mode
+
+
Returns:
nothing
+ +

References Samp::msgMode.

+ +
+

+ +

+
+ + + + + + + + + +
samp_setNotifyMode (handle_t  handle  ) 
+
+
+ +

+Set the calling mode to use notification messaging. +

+SAMP_SETNOTIFYMODE -- Set the calling mode to use notification messaging.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References Samp::msgMode.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setReplyCallback (handle_t  handle,
int *  func 
)
+
+
+ +

+Set the Reply callback. samp_setReplyCallback (handle_t handle, int *func). +

+SAMP_SETREPLYCALLBACK -- Set the Reply callback.

+

Parameters:
+ + + +
handle samp handle
func callback for Reply message
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setResponseCallback (handle_t  handle,
int *  func 
)
+
+
+ +

+Set the Response callback. samp_setResponseCallback (handle_t handle, int *func). +

+SAMP_SETRESPONSECALLBACK -- Set the Response callback.

+

Parameters:
+ + + +
handle samp handle
func callback for message response
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
samp_setSyncMode (handle_t  handle  ) 
+
+
+ +

+Set the calling mode to use synchronous messaging. +

+SAMP_SETSYNCMODE -- Set the calling mode to use synchronous messaging.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +

References Samp::msgMode.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
samp_setTimeout (handle_t  handle,
int  timeout 
)
+
+
+ +

+Set the message timeout value (in seconds). +

+SAMP_SETTIMEOUT -- Set the message timeout value (in seconds).

+

Parameters:
+ + + +
handle samp handle
name application name
+
+
Returns:
nothing
+ +

References Samp::hub, and Hub::timeout.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
samp_Subscribe (handle_t  handle,
String  mtype,
void *  func 
)
+
+
+ +

+Subscribe to a given mtype. +

+SAMP_SUBSCRIBE -- Subscribe to a given mtype.

+

Parameters:
+ + + + +
handle user handle to samp struct
mtype mtype name
func callback function
+
+
Returns:
nothing
+ +

References Samp::nsubs, samp_getSampHandler(), samp_setSampHandler(), and samp_setUserHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
samp_Unsubscribe (handle_t  handle,
String  mtype 
)
+
+
+ +

+Unsubscribe to a given mtype. +

+SAMP_UNSUBSCRIBE -- Unsubscribe to a given mtype.

+

Parameters:
+ + + +
handle user handle to samp struct
mtype mtype name
+
+
Returns:
nothing
+ +

References Samp::nsubs, samp_DeclareSubscriptions(), Subs::sampFunc, and Subs::userFunc.

+ +
+

+ +

+
+ + + + + + + + + +
sampClose (handle_t  handle  ) 
+
+
+ +

+Close the SAMP interface and free resources. +

+SAMP_CLOSE -- Close the SAMP interface.

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +

References Samp::hub, Samp::hubHandle, samp_freeHandle(), samp_hubClose(), sampTrace(), and Samp::verbose.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
sampDebug (handle_t  handle,
int  value 
)
+
+
+ +

+Set interface debug level. +

+SAMPDEBUG -- Set interface debug level.

+

Parameters:
+ + + +
handle user handle to samp struct
value debug value
+
+
Returns:
nothing
+ +

References Samp::debug, and Samp::verbose.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
handle sampInit (String  name,
String  descr 
)
+
+
+ +

+Initialize the SAMP interface. +

+SAMP_INIT -- Initialize the SAMP interface.

+

Parameters:
+ + + +
appName application name
description description of application
+
+
Returns:
samp handle
+ +

References nullList, nullMap, OK_Map, samp_hubOpen(), samp_newHandle(), samp_newList(), samp_newMap(), samp_serverPort(), samp_setMapInMap(), samp_setStringInMap(), sampH, and sampTrace().

+ +
+

+ +

+
+ + + + + + + + + +
sampShutdown (handle_t  handle  ) 
+
+
+ +

+Shut down the active SAMP interface. +

+SAMP_SHUTDOWN -- Shut down the active SAMP interface.

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +

References Samp::active, Samp::hubHandle, samp_hubClose(), Samp::svrThread, and Samp::verbose.

+ +

Referenced by samp_processHubEvent().

+ +
+

+ +

+
+ + + + + + + + + +
sampStartup (handle_t  handle  ) 
+
+
+ +

+Startup the SAMP interface to send/receive messages. +

+SAMP_STARTUP -- Startup the SAMP interface to send/receive messages.

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +

References Samp::active, Samp::clients, Samp::hub, Samp::hubHandle, Hub::id, Samp::mapClients, Client::name, Samp::nclients, samp_hubDeclareMetadata(), samp_hubDeclareSubscriptions(), samp_hubOpen(), samp_mapClients(), Samp::trace, and Samp::verbose.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
sampVerbose (handle_t  handle,
int  value 
)
+
+
+ +

+Set interface debug level. +

+SAMPVERBOSE -- Set interface verbose level.

+

Parameters:
+ + + +
handle user handle to samp struct
value verbose value
+
+
Returns:
nothing
+ +

References Samp::verbose.

+ +
+

+

Variable Documentation

+ +
+
+ + + + +
Hub* hub
+
+
+ +

+empty List struct +

Referenced by samp_bibLoad(), samp_call(), samp_callAll(), samp_callAndWait(), samp_cmdExec(), samp_coordPointAtSky(), samp_DeclareMetadata(), samp_DeclareSubscriptions(), samp_envGet(), samp_envSet(), samp_GetMetadata(), samp_imageLoadFITS(), samp_notify(), samp_notifyAll(), samp_paramGet(), samp_paramSet(), samp_Register(), samp_Reply(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), samp_tableSelectRowList(), and samp_UnRegister().

+ +
+

+ +

+
+ + + + +
long hubHandles[MAX_HUBS]
+
+
+ +

+No. of available hubs +

+

+ +

+
+ + + + +
List nullList
+
+
+ +

+SAMP_OK Map struct +

Referenced by sampInit().

+ +
+

+ +

+
+ + + + +
Map nullMap
+
+
+ +

+SAMP handle +

Referenced by samp_getHandlerReply(), samp_getOKMap(), samp_hubDeclareSubscriptions(), and sampInit().

+ +
+

+ +

+
+ + + + +
int numHubs
+
+
+ +

+HUB connection +

+

+ +

+
+ + + + +
Map OK_Map
+
+
+ +

+empty Map struct +

Referenced by samp_getHandlerReply(), samp_receiveCall(), samp_receiveNotification(), samp_receiveResponse(), and sampInit().

+ +
+

+ +

+
+ + + + +
handle_t sampH
+
+
+ +

+SAMP struct pointer +

Referenced by samp_processHubEvent(), samp_receiveCall(), and sampInit().

+ +
+

+

+
Generated on Wed Feb 27 21:10:15 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/samp_8h.html b/vendor/voclient/libsamp/doc/html/samp_8h.html new file mode 100644 index 00000000..6b45624a --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/samp_8h.html @@ -0,0 +1,7080 @@ + + +SAMP Client Library: samp.h File Reference + + + + + +
+

samp.h File Reference

SAMP interface include file. +More... +

+#include <xmlrpc-c/base.h>
+#include <xmlrpc-c/client.h>
+#include <xmlrpc-c/server.h>
+#include <xmlrpc-c/server_abyss.h>
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <unistd.h>
+#include "xrpc.h"
+ +

+Go to the source code of this file. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Data Structures

struct  appMD
struct  Subs
struct  Client
struct  Hub
struct  Samp

Defines

+#define SZ_NAME   256
+#define SZ_LINE   256
+#define SZ_SECRET   64
+#define SZ_DESC   8192
+#define SZ_URL   1024
+#define SZ_CMD   1024
+#define SZ_SBUF   65536
+#define SZ_RESSTR   1024
+#define DEF_PORT   9876
+#define DEF_TIMEOUT   "15"
+#define MAX_SAMPS   16
+#define MAX_HUBS   16
+#define MAX_MDATTRS   32
+#define MAX_SUBS   256
+#define MAX_CLIENTS   32
+#define MAX_ROWS   256
+#define SAMP_ERR   -1
+#define SAMP_PENDING   0
+#define SAMP_OK   1
+#define SAMP_CBR   0
+#define SAMP_CBV   1
+#define SAMP_SYNCH   0
+#define SAMP_ASYNCH   1
+#define SAMP_NOTIFY   2
+#define SAMP_INT   TY_INT
+#define SAMP_DOUBLE   TY_DOUBLE
+#define SAMP_BOOL   TY_BOOL
+#define SAMP_STRING   TY_STRING
+#define SAMP_DATETIME   TY_DATETIME
+#define SAMP_SAMPRUCT   TY_STRUCT
+#define SAMP_ARRAY   TY_ARRAY
+#define SAMP_TRACE   0
#define HUB_SHUTDOWN   0
+#define HUB_REGISTER   1
+#define HUB_UNREGISTER   2
+#define HUB_SUBSCRIPTIONS   3
+#define HUB_METADATA   4
+#define HUB_DISCONNECT   5
+#define LEN_DESC   32768
+#define min(a, b)   (a<b?a:b)
+#define max(a, b)   (a>b?a:b)
+#define MSG_SYNC   0
+#define MSG_ASYNC   1
+#define MSG_NOTIFY   2
+#define DEF_CALLMODE   MSG_ASYNC

Typedefs

+typedef long handle_t
typedef int Map
typedef int List
typedef int Msg
typedef int Param
typedef char * String
+typedef struct appMD * appMDP
+typedef struct Subs * SubsP
+typedef struct Client * ClientP
+typedef struct Hub * HubP
+typedef struct Samp * SampP

Functions

handle_t sampInit (String appName, String description)
 Initialize the SAMP interface.
void samp_Metadata (handle_t handle, String field, String value)
 Set a metadata field value for the application.
void samp_Subscribe (handle_t handle, String mtype, void *func)
 Subscribe to a given mtype.
void samp_Unsubscribe (handle_t handle, String mtype)
 Unsubscribe to a given mtype.
int sampStartup (handle_t handle)
 Startup the SAMP interface to send/receive messages.
int sampShutdown (handle_t handle)
 Shut down the active SAMP interface.
int sampDebug (handle_t handle, int value)
 Set interface debug level.
int sampVerbose (handle_t handle, int value)
 Set interface debug level.
void sampClose (handle_t handle)
 Close the SAMP interface and free resources.
int samp_hubActive (handle_t handle)
 Determine if the Hub is active (i.e. connected).
+int samp_setOpt (handle_t handle, char *opt, int value)
void samp_setSyncMode (handle_t handle)
 Set the calling mode to use synchronous messaging.
void samp_setASyncMode (handle_t handle)
 Set the calling mode to use asynchronous messaging.
void samp_setNotifyMode (handle_t handle)
 Set the calling mode to use notification messaging.
void samp_setMsgMode (handle_t handle, int mode)
 Set the message pattern to the specified mode.
void samp_setCallByRef (handle_t handle)
 Have interface call user handlers by reference.
void samp_setCallMode (handle_t handle, int mode)
 Set the default calling mode (synch or asynch).
void samp_setReplyCallback (handle_t handle, int *func)
 Set the Reply callback. samp_setReplyCallback (handle_t handle, int *func).
void samp_setResponseCallback (handle_t handle, int *func)
 Set the Response callback. samp_setResponseCallback (handle_t handle, int *func).
void samp_setTimeout (handle_t handle, int timeout)
 Set the message timeout value (in seconds).
+void samp_setAppName (handle_t handle, String name)
void samp_setAppVersion (handle_t handle, String version)
 Set the application name string.
void samp_defaultReplyHandler (handle_t handle)
 The interface's default Reply handler.
+void samp_deaultfResponseHandler (handle_t handle)
int samp_replyStatus (handle_t handle)
 Reply with the status of the last message sent.
int samp_mapClients (handle_t handle)
int samp_listClients (handle_t handle)
+char * samp_getClients (handle_t handle)
int samp_addClient (handle_t handle, String name, String id)
int samp_removeClient (handle_t handle, String id)
Map samp_getOKMap (void)
Map samp_getNullMap (void)
int samp_Register (handle_t handle)
 Register with the Hub using the currently stored metadata.
int samp_UnRegister (handle_t handle)
 Un-Register from the hub.
int samp_DeclareMetadata (handle_t handle)
 (Re)Declare all of our metadata.
int samp_Ping (handle_t handle, String appName)
 Ping the hub/app to see if it is alive (returns >0).
Map samp_GetMetadata (handle_t handle, String pubId)
 Get the metadata for a specified app.
int samp_DeclareSubscriptions (handle_t handle)
 Declare the messages we're interested in.
+Map samp_GetSubscriptions (handle_t handle, String pubId)
List samp_GetRegisteredClients (handle_t handle)
 Get public-ids of the registered clients.
List samp_GetSubscribedClients (handle_t handle, String mtype)
 Get clients matching the mtype subscription.
int samp_tableLoadVOTable (handle_t handle, String recip, String url, String tableId, String name)
 Tell an app to load a VOTable.
int samp_tableLoadFITS (handle_t handle, String recip, String url, String tableId, String name)
 Tell an app to load a FITS table.
int samp_imageLoadFITS (handle_t handle, String recip, String url, String imageId, String name)
 Tell an app to load a FITS image.
int samp_tableHighlightRow (handle_t handle, String recip, String tableId, String url, int row)
 Tell an app to highlight a table row.
int samp_tableSelectRowList (handle_t handle, String recip, String tableId, String url, int rows[], int nrows)
 Tell an app to select a list of table rows.
int samp_coordPointAtSky (handle_t handle, String recip, float ra, float dec)
 Tell an app to point at an RA/Dec coordinate.
int samp_specLoadSSAGeneric (handle_t handle, String recip, String url, Map meta, String spectrumId, String name)
 Load a generic spectrum from an SSA service.
int samp_cmdExec (handle_t handle, String recip, String cmd)
 Execute a command in a remote application.
char * samp_envGet (handle_t handle, String recip, String name)
 Get an environment variable in a remote application.
int samp_envSet (handle_t handle, String recip, String name, String value)
 Set an environment variable in a remote application.
char * samp_paramGet (handle_t handle, String recip, String name)
 Get a parameter variable in a remote application.
int samp_paramSet (handle_t handle, String recip, String name, String value)
 Set an parameter variable in a remote application.
int samp_bibLoad (handle_t handle, String recip, String bibcode)
 Exchange a bibcode.
int samp_resourceLoad (handle_t handle, String recip, String type, String name, Map resMap)
 Exchange a resource list.
int samp_sendGeneric (handle_t handle, String recip, String mtype, String args[])
 Send a geenric message.
int samp_sendMsg (handle_t handle, String recip, Map msg)
 Send the specified message.
void samp_notify (handle_t handle, String recipId, Map msg)
 Make a notify() call to the Hub.
List samp_notifyAll (handle_t handle, Map msg)
 Make a notifyAll() call to the Hub.
String samp_call (handle_t handle, String recipId, String tag, Map msg)
 Make a call() call to the Hub.
int samp_callAll (handle_t handle, String msg_tag, Map msg)
 Make a callAll() call to the Hub.
int samp_callAndWait (handle_t handle, String recipId, String msg_tag, Map msg)
 Make a callAndWait() call to the Hub.
int samp_Reply (handle_t handle, String msg_id, Map resp)
 Reply to a message.
String samp_clientName (handle_t handle, String pubId)
 Get the Client name from a pubic-id.
int samp_setErr (handle_t handle, Map resp)
 Set the error response string.
String samp_getErr (handle_t handle)
 Get the error response string.
int samp_receiveCall (void *data)
 test.echo method
int samp_receiveNotification (void *data)
 receiveNotification () client method.
int samp_receiveResponse (void *data)
 receiveResponse () client method.
void samp_setHandlerReply (Map resp)
 Set the Samp Handler reply map.
Map samp_getHandlerReply (void)
 Get the Samp Handler reply map.
void samp_setUserHandler (handle_t handle, String mtype, void *func)
 Set the user-interface handler for the mtype.
void samp_setSampHandler (handle_t handle, String mtype, void *func)
 Set the SAMP interface handler for the mtype.
void * samp_getUserHandler (String mtype)
 Get the User handler for the named mtype.
void * samp_getSampHandler (String mtype)
 Get the Samphandler for the named mtype.
void samp_execUserHandler (String mtype, String sender, String msg_id, Map params)
 Execute the user-defined handler for the mtype.
+int samp_genericMsgHandler (String sender, String mtype, String msg_id, Map msg_map)
int samp_PingHandler (String sender, String mtype, String msg_id, Map msg_map)
 Is app alive and responding to messages?
int samp_StatusHandler (String sender, String mtype, String msg_id, Map msg_map)
 Return status of the task.
int samp_imLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle an image.load.fits message.
int samp_tbLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a generic table.load.* message.
int samp_tbLoadFITSHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a generic table.load.fits message.
int samp_tbLoadVOTHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a generic table.load.votable message.
int samp_tbHighlightHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a table.highlight.row message.
int samp_tbSelectHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a table.select.rowList message.
int samp_pointAtHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a coord.pointAt.sky message.
int samp_specLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a spectrum.load.* message.
int samp_specSSAHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a spectrum.load.ssa-generic message.
int samp_cmdExecHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.cmd.exec message.
int samp_envGetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.env.set message.
int samp_envSetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.env.set message.
int samp_paramGetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.param.set message.
int samp_paramSetHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a client.param.set message.
int samp_bibcodeHandler (String sender, String mtype, String msg_id, Map msg_map)
 Handle a bibcode.load message.
int samp_resLoadHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resConeHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resSiapHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resSsapHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resTapHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
int samp_resVOSpaceHandler (String sender, String mtype, String msg_id, Map msg_map)
 handle a voresource.loadlist message
+void samp_printMessage (String mtype, String sender, String msg_id, Map params)
void samp_printMap (String name, Map map)
int samp_nullResponse (void *data)
+int samp_testEcho (void *data)
handle_t samp_hubOpen (Samp *samp)
 Discover and open a connection to the SAMP Hub.
int samp_hubClose (handle_t handle)
 Close a connection to the Hub.
List samp_getAvailableHubs (handle_t handle)
 Get a list of available Hubs.
+char * samp_getActiveHubName (handle_t handle)
+int samp_getActiveHub (handle_t handle)
int samp_hubRunning (void)
+int samp_hubInit (handle_t samp, char *appName, char *descr)
int samp_processHubEvent (String mtype, Map params)
 Determine the type of Hub event mtype.
int samp_hubEvent (String mtype)
 Determine the type of Hub event mtype.
int samp_hubRegister (Hub *hub)
 Send a Register message to the Hub.
int samp_hubUnRegister (Hub *hub)
 Send a UnRegister message to the Hub.
int samp_hubSendShutdown (Hub *hub)
 Send a samp.app.event.shutdown message to the Hub.
int samp_hubSetXmlrpcCallback (Hub *hub)
 Set the client callback and send to Hub.
int samp_hubPing (Hub *hub)
 Ping the Hub to see if it is alive.
int samp_hubDeclareMetadata (Hub *hub)
 Declare "standard" metadata to the Hub.
int samp_hubDeclareSubscriptions (Hub *hub)
 Declare mtype subscriptions to the Hub.
handle_t samp_newList ()
 Create a new List object.
void samp_freeList (List list)
 Free the given List object.
int samp_listLen (List list)
 Get number of elements in a List.
void samp_setStringInList (List list, char *value)
 Set a string in a List (append).
void samp_setMapInList (List list, Map map)
 Set a Map in a List (append).
void samp_setListInList (List list1, List list2)
 Set a List in another List (append).
void samp_setIntInList (List list, int value)
 Set an Int in a List (append).
void samp_setFloatInList (List list, float value)
 Set a Float in a List (append).
char * samp_getStringFromList (List list, int index)
 Get a string from the List.
Map samp_getMapFromList (List list, int index)
 Get a Map from the List.
List samp_getListFromList (List list, int index)
 Get a List from the List.
+int samp_getIntFromList (List list, int index)
float samp_getFloatFromList (List list, int index)
 Get a Float from the List.
handle_t samp_newMap (void)
 Create a new Map object.
void samp_freeMap (Map map)
 Free the given Map object.
+int samp_getMapSize (Map map)
+char * samp_getMapKey (Map map, int index)
+char * samp_getMapVal (Map map, int index)
void samp_setStringInMap (Map map, char *key, char *value)
 Set a string in a Map (append).
void samp_setMapInMap (Map map1, char *key, Map map2)
 Set a Map in a Map (append).
void samp_setListInMap (Map map, char *key, List list)
 Set a List in a Map (append).
void samp_setIntInMap (Map map, char *key, int value)
 Set a Int in a Map (append).
void samp_setFloatInMap (Map map, char *key, float value)
 Set a string in a Map (append).
char * samp_getStringFromMap (Map map, char *key)
 Get a string from the Map.
Map samp_getMapFromMap (Map map, char *key)
 Get a Map from the Map.
List samp_getListFromMap (Map map, char *key)
 Get a LIST from the Map.
int samp_getIntFromMap (Map map, char *key)
 Get a integer from the Map.
float samp_getFloatFromMap (Map map, char *key)
 Get a float from the Map.
Msg samp_newMsg (void)
 Create a new Msg object.
void samp_freeMsg (Msg msg)
 Free the given Msg object.
+void samp_msgMType (Msg msg, String mtype)
void samp_msgParam (Msg msg, Param param)
 Add a parameter to the Msg.
+char * samp_msgTag (void)
Param samp_newParam (void)
 Create a new Param object.
void samp_freeParam (Param param)
 Free the given Msg object.
Param samp_paramInit (Msg msg)
 Get number of Params.
+void samp_addStringParam (Msg msg, char *keyw, String val)
void samp_addMapParam (Msg msg, char *keyw, Map val)
 Add a parameter to the Param.
void samp_addListParam (Msg msg, char *keyw, List val)
 Add a parameter to the Param.
void samp_addIntParam (Msg msg, char *keyw, int val)
 Add a <SAMP int>=""> parameter to the Param.
void samp_addFloatParam (Msg msg, char *keyw, float val)
 Add a <SAMP float>=""> parameter to the Param.
int samp_paramLen (Msg msg)
 Get number of Params.
void sampLog (handle_t handle, char *format,...)
 SAMP message logger.
void sampTrace (handle_t handle, char *format,...)
 SAMP tracer.
handle_t samp_newHandle (void *ptr)
 Get an unused object handle.
void samp_freeHandle (handle_t handle)
 Free the handle for later re-use.
handle_t samp_P2H (void *ptr)
 Convert a pointer to a handle.
+void * samp_H2P (handle_t handle)
char * samp_app2id (handle_t handle, char *appName)
 Convert an application name to a public-ID.
char * samp_id2app (handle_t handle, char *pubId)
 Convert a public-ID to the application name.
int samp_serverPort (void)
 Return a unique port number for the server.
void samp_printMetadata (handle_t handle, String name)
 Print the metadata for the application.
char * samp_getMetadata (handle_t handle, String name)
 Get the metadata item for the application.
+

Detailed Description

+SAMP interface include file. +

+SAMP.H -- SAMP interface include file.

+

Author:
Mike FItzpatrick
+
Date:
7/10/09
+

Define Documentation

+ +
+
+ + + + +
#define HUB_SHUTDOWN   0
+
+
+ +

+Special Hub events +

Referenced by samp_hubEvent(), and samp_processHubEvent().

+ +
+

+

Typedef Documentation

+ +
+
+ + + + +
typedef int List
+
+
+ +

+SAMP Map datatype +

+

+ +

+
+ + + + +
typedef int Map
+
+
+ +

+generic object handle +

+

+ +

+
+ + + + +
typedef int Msg
+
+
+ +

+SAMP List datatype +

+

+ +

+
+ + + + +
typedef int Param
+
+
+ +

+SAMP Msg datatype +

+

+ +

+
+ + + + +
typedef char* String
+
+
+ +

+SAMP Param datatype +

+

+

Function Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int samp_addClient (handle_t  handle,
String  name,
String  id 
)
+
+
+ +

+SAMP_ADDCLIENT -- Add a newly registered client to the list of known apps so we can do the public-private name translation. +

+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addFloatParam (Msg  msg,
char *  keyw,
float  val 
)
+
+
+ +

+Add a <SAMP float>=""> parameter to the Param. +

+SAMP_ADDFLOATPARAM -- Add a <SAMP float>=""> parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val floating point value
+
+
Returns:
nothing
+ +

Referenced by samp_coordPointAtSky(), and samp_sendGeneric().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addIntParam (Msg  msg,
char *  keyw,
int  val 
)
+
+
+ +

+Add a <SAMP int>=""> parameter to the Param. +

+SAMP_ADDINTPARAM -- Add a <SAMP int>=""> parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val integer value
+
+
Returns:
nothing
+ +

Referenced by samp_sendGeneric(), and samp_tableHighlightRow().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addListParam (Msg  msg,
char *  keyw,
List  val 
)
+
+
+ +

+Add a parameter to the Param. +

+SAMP_ADDLISTPARAM -- Add a List parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val value list
+
+
Returns:
nothing
+ +

Referenced by samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_addMapParam (Msg  msg,
char *  keyw,
Map  val 
)
+
+
+ +

+Add a parameter to the Param. +

+SAMP_ADDMAPPARAM -- Add a Map parameter to the Param.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
val value map
+
+
Returns:
nothing
+ +

Referenced by samp_resourceLoad(), and samp_specLoadSSAGeneric().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
pubId samp_app2id (handle_t  handle,
char *  appName 
)
+
+
+ +

+Convert an application name to a public-ID. +

+SAMP_APP2ID -- Convert an application name to a public-ID.

+

Parameters:
+ + + +
handle samp struct handle
appName name of registered application
+
+
Returns:
public ID of application
+ +

Referenced by samp_call(), samp_callAndWait(), samp_envGet(), samp_notify(), samp_paramGet(), samp_Ping(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_bibcodeHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a bibcode.load message. +

+SAMP_BIBCODEHANDLER -- Handle a bibcode.load message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
val samp_bibLoad (handle_t  handle,
String  recip,
String  bibcode 
)
+
+
+ +

+Exchange a bibcode. +

+SAMP_BIBLOAD -- Exchange a bibcode.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
bibcode Bibcode string
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
String msg id samp_call (handle_t  handle,
String  recipId,
String  msg_tag,
Map  msg 
)
+
+
+ +

+Make a call() call to the Hub. +

+SAMP_CALL -- Make a call() call to the Hub

+

Parameters:
+ + + + + +
handle samp struct handle
recipId recipient ID
msg_tag message tag
msg message map
+
+
Returns:
message ID
+ +

Referenced by samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
Map calls samp_callAll (handle_t  handle,
String  msg_tag,
Map  msg 
)
+
+
+ +

+Make a callAll() call to the Hub. +

+SAMP_CALLALL -- Make a callAll() call to the Hub

+

Parameters:
+ + + + +
handle samp struct handle
msg_tag message tag
msg message map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

Referenced by samp_Ping(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
status samp_callAndWait (handle_t  handle,
String  recipId,
String  msg_tag,
Map  msg 
)
+
+
+ +

+Make a callAndWait() call to the Hub. +

+SAMP_CALLANDWAIT -- Make a callAndWait() call to the Hub

+

Parameters:
+ + + + + +
handle samp struct handle
recipId recipient ID
msg_tag message tag
msg message map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

Referenced by samp_Ping(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
name samp_clientName (handle_t  handle,
String  pubId 
)
+
+
+ +

+Get the Client name from a pubic-id. +

+SAMP_CLIENTNAME -- Get the Client name from a pubic-id.

+

Parameters:
+ + + +
handle samp struct handle
pubId public ID
+
+
Returns:
declared application name
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_cmdExec (handle_t  handle,
String  recip,
String  cmd 
)
+
+
+ +

+Execute a command in a remote application. +

+SAMP_CMDEXEC -- Execute a command in a remote application.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
cmd Command string
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_cmdExecHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.cmd.exec message. +

+SAMP_CMDEXECHANDLER -- Handle a client.cmd.exec message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_coordPointAtSky (handle_t  handle,
String  recip,
float  ra,
float  dec 
)
+
+
+ +

+Tell an app to point at an RA/Dec coordinate. +

+SAMP_COORDPOINTATSKY -- Tell an app to point at an RA/Dec coordinate.

+

Parameters:
+ + + + + +
handle samp struct handle
recip name of recipient (or 'all')
ra RA of coord in degrees
dec Dec of coord in degrees
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + +
stat samp_DeclareMetadata (handle_t  handle  ) 
+
+
+ +

+(Re)Declare all of our metadata. +

+SAMP_DECLAREMETATA -- (Re)Declare all of our metadata.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + +
stat samp_DeclareSubscriptions (handle_t  handle  ) 
+
+
+ +

+Declare the messages we're interested in. +

+SAMP_DECLARESUBSCRIPIONS -- Declare the messages we're interested in.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

Referenced by samp_Unsubscribe().

+ +
+

+ +

+
+ + + + + + + + + +
void samp_defaultReplyHandler (handle_t  handle  ) 
+
+
+ +

+The interface's default Reply handler. +

+SAMP_DEFAULTREPLYHANDLER -- The interface's default Reply handler.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
val samp_envGet (handle_t  handle,
String  recip,
String  name 
)
+
+
+ +

+Get an environment variable in a remote application. +

+SAMP_ENVGET -- Get an environment variable in a remote application.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
+
+
Returns:
NULL, Value of variable, or list of values
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_envGetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.env.set message. +

+SAMP_ENVGETHANDLER -- Handle a client.env.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_envSet (handle_t  handle,
String  recip,
String  name,
String  value 
)
+
+
+ +

+Set an environment variable in a remote application. +

+SAMP_ENVSET -- Set an environment variable in a remote application.

+

Parameters:
+ + + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
value Value of variable or NULL
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_envSetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.env.set message. +

+SAMP_ENVSETHANDLER -- Handle a client.env.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
samp_execUserHandler (String  sender,
String  mtype,
String  msg_id,
Map  params 
)
+
+
+ +

+Execute the user-defined handler for the mtype. +

+SAMP_EXECUSERHANDLER -- Execute the user-defined handler for the mtype.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message-id string
params Mtype parameter Map
+
+
Returns:
nothing
+ +

Referenced by samp_receiveCall(), samp_receiveNotification(), and samp_receiveResponse().

+ +
+

+ +

+
+ + + + + + + + + +
void samp_freeHandle (handle_t  handle  ) 
+
+
+ +

+Free the handle for later re-use. +

+SAMP_FREEHANDLE -- Free the handle for later re-use.

+

Parameters:
+ + +
handle object handle
+
+
Returns:
nothing
+ +

Referenced by samp_hubClose(), and sampClose().

+ +
+

+ +

+
+ + + + + + + + + +
void samp_freeList (List  list  ) 
+
+
+ +

+Free the given List object. +

+SAMP_FREELIST -- Free the given List object

+

Parameters:
+ + +
list List object handle
+
+
Returns:
nothing
+ +

Referenced by samp_mapClients(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + +
void samp_freeMap (Map  map  ) 
+
+
+ +

+Free the given Map object. +

+SAMP_FREEMAP -- Free the given Map object

+

Parameters:
+ + +
map Map object to free
+
+
Returns:
nothing
+ +

Referenced by samp_envGetHandler(), samp_hubDeclareSubscriptions(), samp_paramGetHandler(), and samp_Ping().

+ +
+

+ +

+
+ + + + + + + + + +
void samp_freeMsg (Msg  msg  ) 
+
+
+ +

+Free the given Msg object. +

+SAMP_FREEMSG -- Free the given Msg object

+

Parameters:
+ + +
msg Msg object to free
+
+
Returns:
nothing
+ +

Referenced by samp_bibLoad(), samp_cmdExec(), samp_coordPointAtSky(), samp_envGet(), samp_envSet(), samp_imageLoadFITS(), samp_paramGet(), samp_paramSet(), samp_Ping(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + +
void samp_freeParam (Param  param  ) 
+
+
+ +

+Free the given Msg object. +

+SAMP_FREEPARAM -- Free the given Param object

+

Parameters:
+ + +
param Param object to free
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
status samp_getAvailableHubs (handle_t  handle  ) 
+
+
+ +

+Get a list of available Hubs. +

+SAMP_GETAVAILABLEHUBS -- Get a list of available Hubs

+

Parameters:
+ + +
handle hub handle
+
+
Returns:
List of hub handles
+ +
+

+ +

+
+ + + + + + + + + +
samp_getErr (handle_t  handle  ) 
+
+
+ +

+Get the error response string. +

+SAMP_GETERR -- Get the error response string.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
Error text string
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
ival samp_getFloatFromList (List  list,
int  index 
)
+
+
+ +

+Get a Float from the List. +

+SAMP_GETFLOATFROMLIST -- Get a Float from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the desired value
+
+
Returns:
int value
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
rval samp_getFloatFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a float from the Map. +

+SAMP_GETFLOATFROMMAP -- Get a float from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
floating point value
+ +

Referenced by samp_execUserHandler(), and samp_pointAtHandler().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_getHandlerReply (void   ) 
+
+
+ +

+Get the Samp Handler reply map. +

+SAMP_GETHANDLERREPLY -- Get the Samp Handler reply map.

+

Returns:
Map handle for reply map
+ +

References nullMap, and OK_Map.

+ +

Referenced by samp_receiveCall(), and samp_receiveNotification().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
ival samp_getIntFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a integer from the Map. +

+SAMP_GETINTFROMMAP -- Get a integer from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
integer value
+ +

Referenced by samp_execUserHandler(), and samp_tbHighlightHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
ival samp_getListFromList (List  list,
int  index 
)
+
+
+ +

+Get a List from the List. +

+Get an Int from the List.

+SAMP_GETLISTFROMLIST -- Get a List from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the List
+
+
Returns:
List handle
+SAMP_GETINTFROMLIST -- Get an Int from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the desired value
+
+
Returns:
int value
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
List samp_getListFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a LIST from the Map. +

+SAMP_GETLISTFROMMAP -- Get a LIST from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
handle to List value
+ +

Referenced by samp_execUserHandler(), and samp_tbSelectHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
Map samp_getMapFromList (List  list,
int  index 
)
+
+
+ +

+Get a Map from the List. +

+SAMP_GETMAPFROMLIST -- Get a Map from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the Map
+
+
Returns:
Map handle
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
Map samp_getMapFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a Map from the Map. +

+SAMP_GETMAPFROMMAP -- Get a Map from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
handle to Map value
+ +

Referenced by samp_execUserHandler(), samp_resConeHandler(), samp_resLoadHandler(), samp_resSiapHandler(), samp_resSsapHandler(), samp_resTapHandler(), samp_resVOSpaceHandler(), samp_specLoadHandler(), and samp_specSSAHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
str samp_getMetadata (handle_t  handle,
String  param 
)
+
+
+ +

+Get the metadata item for the application. +

+SAMP_GETMETADATA -- Get the metadata item for the application.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
map samp_GetMetadata (handle_t  handle,
String  pubId 
)
+
+
+ +

+Get the metadata for a specified app. +

+SAMP_GETMETADATA -- Get the metadata for a specified app.

+

Parameters:
+ + + +
handle samp struct handle
pubId App public-id
+
+
Returns:
Map to message response
+ +

Referenced by samp_mapClients().

+ +
+

+ +

+
+ + + + + + + + +
Map samp_getNullMap (  ) 
+
+
+ +

+SAMP_GETNULLMAP -- Generate a 'Null' map we can return to the Hub. +

+

+ +

+
+ + + + + + + + +
Map samp_getOKMap (  ) 
+
+
+ +

+SAMP_GETOKMAP -- Generate an 'OK' map we can return to the Hub. +

+

+ +

+
+ + + + + + + + + +
handle samp_GetRegisteredClients (handle_t  handle  ) 
+
+
+ +

+Get public-ids of the registered clients. +

+SAMP_GETREGISTEREDCLIENTS -- Get public-ids of the registered clients.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
handle to list of registered clients
+ +

Referenced by samp_mapClients().

+ +
+

+ +

+
+ + + + + + + + + +
func samp_getSampHandler (String  mtype  ) 
+
+
+ +

+Get the Samphandler for the named mtype. +

+SAMP_GETSAMPHANDLER -- Get the Samphandler for the named mtype.

+

Parameters:
+ + +
mtype mtype string
+
+
Returns:
nothing
+ +

Referenced by samp_receiveCall(), samp_receiveNotification(), and samp_Subscribe().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char * samp_getStringFromList (List  list,
int  index 
)
+
+
+ +

+Get a string from the List. +

+SAMP_GETSTRINGFROMLIST -- Get a string from the List

+

Parameters:
+ + + +
list List object handle
index List index containing the string
+
+
Returns:
character string
+ +

Referenced by samp_mapClients().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
char * samp_getStringFromMap (Map  map,
char *  key 
)
+
+
+ +

+Get a string from the Map. +

+SAMP_GETSTRINGFROMMAP -- Get a string from the Map

+

Parameters:
+ + + +
map handle to Map object
key Map key
+
+
Returns:
string value from Map
+ +

Referenced by samp_bibcodeHandler(), samp_cmdExecHandler(), samp_envGetHandler(), samp_envSetHandler(), samp_execUserHandler(), samp_imLoadHandler(), samp_paramGetHandler(), samp_paramSetHandler(), samp_resConeHandler(), samp_resLoadHandler(), samp_resSiapHandler(), samp_resSsapHandler(), samp_resTapHandler(), samp_resVOSpaceHandler(), samp_specLoadHandler(), samp_specSSAHandler(), samp_tbHighlightHandler(), samp_tbLoadFITSHandler(), samp_tbLoadHandler(), samp_tbLoadVOTHandler(), and samp_tbSelectHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
list samp_GetSubscribedClients (handle_t  handle,
String  mtype 
)
+
+
+ +

+Get clients matching the mtype subscription. +

+SAMP_GETSUBSCRIBEDCLIENTS -- Get clients matching the mtype subscription.

+

Parameters:
+ + + +
handle samp struct handle
mtype mtype string
+
+
Returns:
handle to list of clients having mtype subscription
+ +
+

+ +

+
+ + + + + + + + + +
func samp_getUserHandler (String  mtype  ) 
+
+
+ +

+Get the User handler for the named mtype. +

+SAMP_GETUSERHANDLER -- Get the User handler for the named mtype.

+

Parameters:
+ + +
mtype mtype string
+
+
Returns:
nothing
+ +

Referenced by samp_bibcodeHandler(), samp_cmdExecHandler(), samp_envGetHandler(), samp_envSetHandler(), samp_execUserHandler(), samp_imLoadHandler(), samp_paramGetHandler(), samp_paramSetHandler(), samp_PingHandler(), samp_pointAtHandler(), samp_receiveCall(), samp_receiveNotification(), samp_resConeHandler(), samp_resLoadHandler(), samp_resSiapHandler(), samp_resSsapHandler(), samp_resTapHandler(), samp_resVOSpaceHandler(), samp_specLoadHandler(), samp_specSSAHandler(), samp_StatusHandler(), samp_tbHighlightHandler(), samp_tbLoadFITSHandler(), samp_tbLoadHandler(), samp_tbLoadVOTHandler(), and samp_tbSelectHandler().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubActive (handle_t  handle  ) 
+
+
+ +

+Determine if the Hub is active (i.e. connected). +

+SAMP_HUBACTIVE -- Determine if the Hub is active (i.e. connected).

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +

References Samp::active.

+ +
+

+ +

+
+ + + + + + + + + +
status samp_hubClose (handle_t  handle  ) 
+
+
+ +

+Close a connection to the Hub. +

+SAMP_HUBCLOSE -- Close a connection to the Hub.

+

Parameters:
+ + +
handle hub handle
+
+
Returns:
unregister status
+ +

Referenced by sampClose(), and sampShutdown().

+ +
+

+ +

+
+ + + + + + + + + +
status samp_hubDeclareMetadata (Hub *  hub  ) 
+
+
+ +

+Declare "standard" metadata to the Hub. +

+SAMP_DECLAREMETADATA -- Declare "standard" metadata to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

Referenced by samp_DeclareMetadata(), and sampStartup().

+ +
+

+ +

+
+ + + + + + + + + +
status samp_hubDeclareSubscriptions (Hub *  hub  ) 
+
+
+ +

+Declare mtype subscriptions to the Hub. +

+SAMP_HUBDECLARESUBSCRIPTIONS -- Declare mtype subscriptions to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

Referenced by samp_DeclareSubscriptions(), and sampStartup().

+ +
+

+ +

+
+ + + + + + + + + +
code samp_hubEvent (String  mtype  ) 
+
+
+ +

+Determine the type of Hub event mtype. +

+SAMP_HUBEVENT -- Determine the type of Hub event mtype.

+

Parameters:
+ + +
mtype mtype string
+
+
Returns:
Hub event code or -1 if not found
+ +

Referenced by samp_processHubEvent().

+ +
+

+ +

+
+ + + + + + + + + +
handle samp_hubOpen (Samp *  sampP  ) 
+
+
+ +

+Discover and open a connection to the SAMP Hub. +

+SAMP_HUBOPEN -- Discover and open a connection to the SAMP Hub.

+

Parameters:
+ + +
samp Same structure
+
+
Returns:
hub handle
+ +

Referenced by sampInit(), and sampStartup().

+ +
+

+ +

+
+ + + + + + + + + +
status samp_hubPing (Hub *  hub  ) 
+
+
+ +

+Ping the Hub to see if it is alive. +

+SAMP_HUBPING -- Ping the Hub to see if it is alive.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

Referenced by samp_Ping().

+ +
+

+ +

+
+ + + + + + + + + +
status samp_hubRegister (Hub *  hub  ) 
+
+
+ +

+Send a Register message to the Hub. +

+SAMP_HUB_REGISTER -- Send a Register message to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

Referenced by samp_hubOpen().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_hubRunning (void   ) 
+
+
+ +

+SAMP_HUBRUNNING -- See whether a Hub is running. The test simply checks the existence of a Hub lockfile. +

References SZ_NAME.

+ +
+

+ +

+
+ + + + + + + + + +
status samp_hubSendShutdown (Hub *  hub  ) 
+
+
+ +

+Send a samp.app.event.shutdown message to the Hub. +

+SAMP_HUBSENDSHUTDOWN -- Send a samp.app.event.shutdown message to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +
+

+ +

+
+ + + + + + + + + +
status samp_hubSetXmlrpcCallback (Hub *  hub  ) 
+
+
+ +

+Set the client callback and send to Hub. +

+SAMP_HUBSETXMLRPCCALLBACK -- Set the client callback and send to Hub

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

Referenced by samp_hubOpen().

+ +
+

+ +

+
+ + + + + + + + + +
status samp_hubUnRegister (Hub *  hub  ) 
+
+
+ +

+Send a UnRegister message to the Hub. +

+SAMP_HUBUNREGISTER -- Send a UnRegister message to the Hub.

+

Parameters:
+ + +
hub hub struct pointer
+
+
Returns:
status
+ +

Referenced by samp_hubClose(), and samp_UnRegister().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
appName samp_id2app (handle_t  handle,
char *  pubId 
)
+
+
+ +

+Convert a public-ID to the application name. +

+SAMP_ID2APP -- Convert a public-ID to the application name.

+

Parameters:
+ + + +
handle samp struct handle
pubId public ID of application
+
+
Returns:
name of registered application
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_imageLoadFITS (handle_t  handle,
String  recip,
String  url,
String  tableId,
String  name 
)
+
+
+ +

+Tell an app to load a FITS image. +

+SAMP_IMAGELOADFITS -- Tell an app to load a FITS image.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
url URL to table to be loaded
imageId ID assigned to image (optional)
name Name assigned to image (optional)
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_imLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle an image.load.fits message. +

+SAMP_IMLOADHANDLER -- Handle an image.load.fits message.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + +
int samp_listClients (handle_t  handle  ) 
+
+
+ +

+SAMP_LISTCLIENTS -- List the available clients to stdout. +

+

+ +

+
+ + + + + + + + + +
int samp_listLen (List  list  ) 
+
+
+ +

+Get number of elements in a List. +

+SAMP_LISTLEN -- Get number of elements in a List.

+

Parameters:
+ + +
list List object handle
+
+
Returns:
nothing
+ +

Referenced by samp_execUserHandler(), samp_GetRegisteredClients(), samp_GetSubscribedClients(), samp_mapClients(), and samp_tbSelectHandler().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_mapClients (handle_t  handle  ) 
+
+
+ +

+SAMP_MAPCLIENTS -- Map the public-ids of registered clients to the appName. +

+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_Metadata (handle_t  handle,
String  field,
String  value 
)
+
+
+ +

+Set a metadata field value for the application. +

+SAMP_METADATA -- Set a metadata field for the application. This will be sent to the Hub later in a declareMetadata() call.

+

Parameters:
+ + + + +
handle samp handle
field metadata field to set (name, author, etc)
samp value of field
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_msgParam (Msg  msg,
Param  param 
)
+
+
+ +

+Add a parameter to the Msg. +

+SAMP_MSGPARAM -- Add a parameter to the Msg.

+

Parameters:
+ + + + +
msg handle to Msg object
keyw map keyword
param parameter map
+
+
Returns:
nothing
+ +

Referenced by samp_bibLoad(), samp_cmdExec(), samp_coordPointAtSky(), samp_envGet(), samp_envSet(), samp_imageLoadFITS(), samp_paramGet(), samp_paramSet(), samp_Ping(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + +
handle_t samp_newHandle (void *  ptr  ) 
+
+
+ +

+Get an unused object handle. +

+SAMP_NEWHANDLE -- Get an unused object handle.

+

Parameters:
+ + +
ptr pointer to object to be stored
+
+
Returns:
new object handle
+ +

Referenced by samp_hubOpen(), and sampInit().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_newList (void   ) 
+
+
+ +

+Create a new List object. +

+SAMP_NEWLIST -- Create a new List object

+

Returns:
handle to List object
+ +

Referenced by samp_GetRegisteredClients(), samp_GetSubscribedClients(), samp_tableSelectRowList(), and sampInit().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_newMap (void   ) 
+
+
+ +

+Create a new Map object. +

+SAMP_NEWMAP -- Create a new Map object

+

Returns:
handle to new Map
+ +

Referenced by samp_envGetHandler(), samp_getNullMap(), samp_getOKMap(), samp_paramGetHandler(), and sampInit().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_newMsg (void   ) 
+
+
+ +

+Create a new Msg object. +

+SAMP_NEWMSG -- Create a new Msg object

+

Returns:
handle to new Msg
+ +

Referenced by samp_bibLoad(), samp_cmdExec(), samp_coordPointAtSky(), samp_envGet(), samp_envSet(), samp_imageLoadFITS(), samp_paramGet(), samp_paramSet(), samp_Ping(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_newParam (void   ) 
+
+
+ +

+Create a new Param object. +

+SAMP_NEWPARAM -- Create a new Param object

+

Returns:
handle to new Param
+ +

Referenced by samp_bibLoad(), samp_cmdExec(), samp_coordPointAtSky(), samp_envGet(), samp_envSet(), samp_imageLoadFITS(), samp_paramGet(), samp_paramSet(), samp_Ping(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_notify (handle_t  handle,
String  recipId,
Map  msg 
)
+
+
+ +

+Make a notify() call to the Hub. +

+SAMP_NOTIFY -- Make a notify() call to the Hub

+

Parameters:
+ + + + +
handle samp struct handle
recipId recipient ID
msg message map
+
+
Returns:
nothing
+ +

Referenced by samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_notifyAll (handle_t  handle,
Map  msg 
)
+
+
+ +

+Make a notifyAll() call to the Hub. +

+SAMP_NOTIFYALL -- Make a notifyAll() call to the Hub

+

Parameters:
+ + + +
handle samp struct handle
msg message map
+
+
Returns:
nothing
+ +

Referenced by samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_nullResponse (void *  data  ) 
+
+
+ +

+SAMP_NULLRESPONSE -- Handler to ignore async replies. +

Referenced by samp_hubSendShutdown(), samp_notify(), and samp_Reply().

+ +
+

+ +

+
+ + + + + + + + + +
handle_t samp_P2H (void *  ptr  ) 
+
+
+ +

+Convert a pointer to a handle. +

+SAMP_P2H -- Convert a pointer to a handle

+

Parameters:
+ + +
ptr pointer to object
+
+
Returns:
handle to object, < 0 on error
+ +

Referenced by samp_hubOpen(), and samp_processHubEvent().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
val samp_paramGet (handle_t  handle,
String  recip,
String  name 
)
+
+
+ +

+Get a parameter variable in a remote application. +

+SAMP_PARAMGET -- Get a parameter variable in a remote application.

+

Parameters:
+ + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
+
+
Returns:
NULL, Value of variable, or list of values
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_paramGetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.param.set message. +

+SAMP_PARAMGETHANDLER -- Handle a client.param.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + +
nparam samp_paramInit (Msg  msg  ) 
+
+
+ +

+Get number of Params. +

+SAMP_PARAMINIT -- Get number of Params.

+

Parameters:
+ + +
msg handle to Msg object
+
+
Returns:
nothing
+ +

Referenced by samp_addFloatParam(), samp_addIntParam(), samp_addListParam(), and samp_addMapParam().

+ +
+

+ +

+
+ + + + + + + + + +
nparam samp_paramLen (Msg  msg  ) 
+
+
+ +

+Get number of Params. +

+SAMP_PARAMLEN -- Get number of Params.

+

Parameters:
+ + +
msg handle to Msg object
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_paramSet (handle_t  handle,
String  recip,
String  name,
String  value 
)
+
+
+ +

+Set an parameter variable in a remote application. +

+SAMP_PARAMSET -- Set an parameter variable in a remote application.

+

Parameters:
+ + + + + +
handle samp struct handle
recip name of recipient (or 'all')
name Name of variable in receiver's environment
value Value of variable or NULL
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_paramSetHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a client.param.set message. +

+SAMP_PARAMSETHANDLER -- Handle a client.param.set message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
stat samp_Ping (handle_t  handle,
String  appName 
)
+
+
+ +

+Ping the hub/app to see if it is alive (returns >0). +

+SAMP_PING -- Ping the hub/app to see if it is alive (returns >0).

+

Parameters:
+ + + +
handle samp struct handle
appName application name
+
+
Returns:
OK or ERR if no response
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_PingHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Is app alive and responding to messages? +

+SAMP_PINGHANDLER -- Simple aliveness test function.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_pointAtHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a coord.pointAt.sky message. +

+SAMP_POINTATHANDLER -- Handle a coord.pointAt.sky message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_printMap (String  name,
Map  map 
)
+
+
+ +

+SAMP_PRINTMAP -- Print the contents of a Map structure. +

+

+ +

+
+ + + + + + + + + + + + + + + + + + +
samp_printMetadata (handle_t  handle,
String  name 
)
+
+
+ +

+Print the metadata for the application. +

+SAMP_PRINTMETADATA -- Print the metadata for the application.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
valid samp_processHubEvent (String  mtype,
Map  params 
)
+
+
+ +

+Determine the type of Hub event mtype. +

+SAMP_HUBEVENT -- Determine the type of Hub event mtype.

+

Parameters:
+ + + +
mtype mtype string
params message parameter Map
+
+
Returns:
non-zero value if a Hub event was processed
+ +

Referenced by samp_receiveNotification().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_receiveCall (void *  data  ) 
+
+
+ +

+test.echo method +

+receiveCall () client method.

+SAMP_TESTECHO -- test.echo method

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+SAMP_RECEIVECALL -- receiveCall() client method.

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+ +
+

+ +

+
+ + + + + + + + + +
int samp_receiveNotification (void *  data  ) 
+
+
+ +

+receiveNotification () client method. +

+SAMP_RECEIVENOTIFICATION -- receiveNotification() client method.

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+ +
+

+ +

+
+ + + + + + + + + +
int samp_receiveResponse (void *  data  ) 
+
+
+ +

+receiveResponse () client method. +

+SAMP_RECEIVERESPONSE -- receiveResponse() client method.

+

Parameters:
+ + +
data caller param data
+
+
Returns:
status code or errno
+ +
+

+ +

+
+ + + + + + + + + +
handle samp_Register (handle_t  handle  ) 
+
+
+ +

+Register with the Hub using the currently stored metadata. +

+SAMP_REGISTER -- Register with the Hub using the currently stored metadata.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int samp_removeClient (handle_t  handle,
String  id 
)
+
+
+ +

+SAMP_REMOVECLIENT -- Remove a registered client from the list of known apps that do the public-private name translation. +

+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
status samp_Reply (handle_t  handle,
String  msg_id,
Map  response 
)
+
+
+ +

+Reply to a message. +

+SAMP_REPLY -- Reply to a message. All we do here is send the reply message, we require that the response Map already be defined.

+

Parameters:
+ + + + +
handle samp struct handle
msg_id message ID
response response map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

Referenced by samp_receiveCall().

+ +
+

+ +

+
+ + + + + + + + + +
int samp_replyStatus (handle_t  handle  ) 
+
+
+ +

+Reply with the status of the last message sent. +

+SAMP_REPLYSTATUS -- Reply with the status of the last message sent.

+May be used to 'poll' for a reponse from the caller in cases where use of a callback is a problem. Codes are: <0==ERR, 0==PENDING, 1==OK

+

Parameters:
+ + +
samp samp struct ptr
+
+
Returns:
message status
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resConeHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESCONEHANDLER -- Handle a voresource.loadlist.cone message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESLOADHANDLER -- handle a voresource.loadlist.* message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

Referenced by samp_resConeHandler(), samp_resSiapHandler(), samp_resSsapHandler(), samp_resTapHandler(), and samp_resVOSpaceHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
val samp_resourceLoad (handle_t  handle,
String  recip,
String  type,
String  name,
Map  resMap 
)
+
+
+ +

+Exchange a resource list. +

+SAMP_RESOURCELOAD -- Exchange a resource list.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Name of recipient (or 'all')
type Resource type (or NULL)
name Descriptive name (optional)
resMap Resource map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resSiapHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESSIAPHANDLER -- Handle a voresource.loadlist.siap message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resSsapHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESSSAPHANDLER -- Handle a voresource.loadlist.ssap message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resTapHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESTAPHANDLER -- Handle a voresource.loadlist.tap message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_resVOSpaceHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+handle a voresource.loadlist message +

+SAMP_RESVOSPACEHANDLER -- Handle a voresource.loadlist.vospace message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_sendGeneric (handle_t  handle,
String  recip,
String  mtype,
String  args[] 
)
+
+
+ +

+Send a geenric message. +

+SAMP_SENDGENERIC -- Send a generic message.

+

Parameters:
+ + + + + +
handle samp struct handle
recip Name of recipient (or 'all')
mtype Message type
args Argument list
+
+
Returns:
SAMP_OK or SAMP_ERR
+This method can be used to send any user-defined message. The 'mtype' string is arbitrary, we just assume the receiving client can understand what it means. The 'args' String array can be an array of values in which case the parameter name will be a series of generic 'arg0' thru 'argN-1' names. +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_sendMsg (handle_t  handle,
String  recip,
Map  msg 
)
+
+
+ +

+Send the specified message. +

+SAMP_SENDMSG -- Send the specified message.

+

Parameters:
+ + + + +
handle samp struct handle
recip Name of recipient (or 'all')
msg Message map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

Referenced by samp_bibLoad(), samp_cmdExec(), samp_coordPointAtSky(), samp_envSet(), samp_imageLoadFITS(), samp_paramSet(), samp_resourceLoad(), samp_sendGeneric(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), and samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + +
port samp_serverPort (void   ) 
+
+
+ +

+Return a unique port number for the server. +

+SAMP_SERVERPORT -- Return a unique port number for the server.

+

Returns:
port number
+ +

Referenced by samp_hubSetXmlrpcCallback(), and sampInit().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setAppVersion (handle_t  handle,
String  version 
)
+
+
+ +

+Set the application name string. +

+Set the application version string.

+SAMP_SETAPPNAME -- Set the application name string.

+

Parameters:
+ + + +
handle samp handle
name application name
+
+
Returns:
nothing
+SAMP_SETAPPVERSION -- Set the application version string.

+

Parameters:
+ + + +
handle samp handle
name application version
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
void samp_setASyncMode (handle_t  handle  ) 
+
+
+ +

+Set the calling mode to use asynchronous messaging. +

+SAMP_SETASYNCMODE -- Set the calling mode to use asynchronous messaging.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
void samp_setCallByRef (handle_t  handle  ) 
+
+
+ +

+Have interface call user handlers by reference. +

+SAMP_SETCALLBYREF -- Have interface call user handlers by reference.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setCallMode (handle_t  handle,
int  mode 
)
+
+
+ +

+Set the default calling mode (synch or asynch). +

+SAMP_SETCALLMODE -- Set the default calling mode (synch or asynch)

+

Parameters:
+ + + +
handle samp handle
mode call mode (synch or asynch)
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
stat samp_setErr (handle_t  handle,
Map  resp 
)
+
+
+ +

+Set the error response string. +

+SAMP_SETERR -- Set the error response string/code.

+

Parameters:
+ + + +
handle samp struct handle
resp Response map
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

Referenced by samp_callAll(), samp_callAndWait(), samp_Ping(), and samp_sendMsg().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setFloatInList (List  list,
float  rval 
)
+
+
+ +

+Set a Float in a List (append). +

+SAMP_SETFLOATINLIST -- Set a Float in a List (append)

+

Parameters:
+ + + +
list1 List object handle
rval Float value to be appended
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setFloatInMap (Map  map,
char *  key,
float  value 
)
+
+
+ +

+Set a string in a Map (append). +

+SAMP_SETFLOATINMAP -- Set a Float in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
value value
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
samp_setHandlerReply (Map  resp  ) 
+
+
+ +

+Set the Samp Handler reply map. +

+SAMP_SETHANDLERREPLY -- Set the Samp Handler reply map.

+

Parameters:
+ + +
resp response map
+
+
Returns:
nothing
+ +

Referenced by samp_envGetHandler(), and samp_paramGetHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setIntInList (List  list,
int  ival 
)
+
+
+ +

+Set an Int in a List (append). +

+SAMP_SETINTINLIST -- Set an Int in a List (append)

+

Parameters:
+ + + +
list1 List object handle
ival Integer value to be appended
+
+
Returns:
nothing
+ +

Referenced by samp_tableSelectRowList().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setIntInMap (Map  map,
char *  key,
int  value 
)
+
+
+ +

+Set a Int in a Map (append). +

+SAMP_SETINTINMAP -- Set a Int in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
value value
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setListInList (List  list1,
List  list2 
)
+
+
+ +

+Set a List in another List (append). +

+SAMP_SETLISTINLIST -- Set a List in another List (append)

+

Parameters:
+ + + +
list1 List object handle
list2 List to be appended
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setListInMap (Map  map,
char *  key,
List  list 
)
+
+
+ +

+Set a List in a Map (append). +

+SAMP_SETLISTINMAP -- Set a List in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
list handle to List object to set
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setMapInList (List  list,
Map  map 
)
+
+
+ +

+Set a Map in a List (append). +

+SAMP_SETMAPINLIST -- Set a Map in a List (append)

+

Parameters:
+ + + +
list List object handle
map Map object to be set
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setMapInMap (Map  map1,
char *  key,
Map  map2 
)
+
+
+ +

+Set a Map in a Map (append). +

+SAMP_SETMAPINMAP -- Set a Map in a Map (append)

+

Parameters:
+ + + + +
map1 handle to Map object
key Map key
map2 handle to Map object to set
+
+
Returns:
nothing
+ +

Referenced by samp_envGetHandler(), samp_getOKMap(), samp_paramGetHandler(), and sampInit().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setMsgMode (handle_t  handle,
int  mode 
)
+
+
+ +

+Set the message pattern to the specified mode. +

+SAMP_SETMSGMODE -- Set the message pattern to the specified mode.

+

Parameters:
+ + + +
handle samp handle
mode message mode
+
+
Returns:
nothing
+ +

References Samp::msgMode.

+ +
+

+ +

+
+ + + + + + + + + +
void samp_setNotifyMode (handle_t  handle  ) 
+
+
+ +

+Set the calling mode to use notification messaging. +

+SAMP_SETNOTIFYMODE -- Set the calling mode to use notification messaging.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setReplyCallback (handle_t  handle,
int *  func 
)
+
+
+ +

+Set the Reply callback. samp_setReplyCallback (handle_t handle, int *func). +

+SAMP_SETREPLYCALLBACK -- Set the Reply callback.

+

Parameters:
+ + + +
handle samp handle
func callback for Reply message
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setResponseCallback (handle_t  handle,
int *  func 
)
+
+
+ +

+Set the Response callback. samp_setResponseCallback (handle_t handle, int *func). +

+SAMP_SETRESPONSECALLBACK -- Set the Response callback.

+

Parameters:
+ + + +
handle samp handle
func callback for message response
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
samp_setSampHandler (handle_t  handle,
String  mtype,
void *  func 
)
+
+
+ +

+Set the SAMP interface handler for the mtype. +

+SAMP_SETSAMPHANDLER -- Set the SAMP interface handler for the mtype.

+

Parameters:
+ + + + +
handle user handle to samp struct
mtype mtype name
func callback function
+
+
Returns:
nothing
+ +

Referenced by samp_Subscribe().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setStringInList (List  list,
char *  value 
)
+
+
+ +

+Set a string in a List (append). +

+SAMP_SETSTRINGINLIST -- Set a string in a List (append)

+

Parameters:
+ + + +
list List object handle
value string value to set
+
+
Returns:
nothing
+ +

Referenced by samp_GetRegisteredClients(), and samp_GetSubscribedClients().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_setStringInMap (Map  map,
char *  key,
char *  value 
)
+
+
+ +

+Set a string in a Map (append). +

+SAMP_SETSTRINGINMAP -- Set a string in a Map (append)

+

Parameters:
+ + + + +
map handle to Map object
key Map key
value Map value
+
+
Returns:
nothing
+ +

Referenced by samp_envGetHandler(), samp_getOKMap(), samp_paramGetHandler(), and sampInit().

+ +
+

+ +

+
+ + + + + + + + + +
void samp_setSyncMode (handle_t  handle  ) 
+
+
+ +

+Set the calling mode to use synchronous messaging. +

+SAMP_SETSYNCMODE -- Set the calling mode to use synchronous messaging.

+

Parameters:
+ + +
handle samp handle
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_setTimeout (handle_t  handle,
int  timeout 
)
+
+
+ +

+Set the message timeout value (in seconds). +

+SAMP_SETTIMEOUT -- Set the message timeout value (in seconds).

+

Parameters:
+ + + +
handle samp handle
name application name
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
samp_setUserHandler (handle_t  handle,
String  mtype,
void *  func 
)
+
+
+ +

+Set the user-interface handler for the mtype. +

+SAMP_SETUSERHANDLER -- Set the user-interface handler for the mtype.

+

Parameters:
+ + + + +
handle user handle to samp struct
mtype mtype name
func callback function
+
+
Returns:
nothing
+ +

Referenced by samp_Subscribe().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_specLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a spectrum.load.* message. +

+SAMP_SPECLOADHANDLER -- Handle a spectrum.load.* message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

Referenced by samp_specSSAHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_specLoadSSAGeneric (handle_t  handle,
String  recip,
String  url,
Map  meta,
String  spectrumId,
String  name 
)
+
+
+ +

+Load a generic spectrum from an SSA service. +

+SAMP_SPECLOADSSAGENERIC -- Load a generic spectrum from an SSA service.

+

Parameters:
+ + + + + + + +
handle samp struct handle
recip name of recipient (or 'all')
url URL of spectrum to load
meta Metadata map describing data found at the URL
spectrumId Identifier for spectrum (optional)
name Name used to label spectrum (optional);
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_specSSAHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a spectrum.load.ssa-generic message. +

+SAMP_SPECSSAHANDLER -- Handle a spectrum.load.ssa-generic message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_StatusHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Return status of the task. +

+SAMP_STATUSHANDLER -- Return status of the task.

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
void samp_Subscribe (handle_t  handle,
String  mtype,
void *  userFunc 
)
+
+
+ +

+Subscribe to a given mtype. +

+SAMP_SUBSCRIBE -- Subscribe to a given mtype.

+

Parameters:
+ + + + +
handle user handle to samp struct
mtype mtype name
func callback function
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_tableHighlightRow (handle_t  handle,
String  recip,
String  tableId,
String  url,
int  row 
)
+
+
+ +

+Tell an app to highlight a table row. +

+SAMP_TABLEHIGHLIGHTROW -- Tell an app to highlight a table row.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
tableId ID associated with a previously loaded table
url URL to table to be loaded
rows List of (zero-based) row indices
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_tableLoadFITS (handle_t  handle,
String  recip,
String  url,
String  tableId,
String  name 
)
+
+
+ +

+Tell an app to load a FITS table. +

+SAMP_TABLELOADFITS -- Tell an app to load a FITS table.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
url URL to table to be loaded
tableId ID assigned to table (optional)
name Name assigned to table (optional)
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_tableLoadVOTable (handle_t  handle,
String  recip,
String  url,
String  tableId,
String  name 
)
+
+
+ +

+Tell an app to load a VOTable. +

+SAMP_TABLELOADVOTABLE -- Tell an app to load a VOTable.

+

Parameters:
+ + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
url URL to table to be loaded
tableId ID assigned to table (optional)
name Name assigned to table (optional)
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
stat samp_tableSelectRowList (handle_t  handle,
String  recip,
String  tableId,
String  url,
int  rows[],
int  nrows 
)
+
+
+ +

+Tell an app to select a list of table rows. +

+SAMP_TABLESELECTROWLIST -- Tell an app to select a list of table rows.

+

Parameters:
+ + + + + + + +
handle samp struct handle
recip Message recipient (or "all" for broadcast)
tableId ID associated with a previously loaded table
url URL to table to be loaded
rows Array of (zero-based) row indices
nrows Number of rows
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbHighlightHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a table.highlight.row message. +

+SAMP_TBHIGHLIGHTHANDLER -- Handle a table.highlight.row message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbLoadFITSHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a generic table.load.fits message. +

+SAMP_TBLOADFITSHANDLER -- Handle a generic table.load.fits message *

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbLoadHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a generic table.load.* message. +

+SAMP_TBLOADHANDLER -- Handle a generic table.load.* message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +

Referenced by samp_tbLoadFITSHandler(), and samp_tbLoadVOTHandler().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbLoadVOTHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a generic table.load.votable message. +

+SAMP_TBLOADVOTHANDLER -- Handle a generic table.load.votable message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int samp_tbSelectHandler (String  sender,
String  mtype,
String  msg_id,
Map  msg_map 
)
+
+
+ +

+Handle a table.select.rowList message. +

+SAMP_TBSELECTHANDLER -- Handle a table.select.rowList message

+

Parameters:
+ + + + + +
sender sender name
mtype mtype string
msg_id message id
msg_map message map struct
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + +
stat samp_UnRegister (handle_t  handle  ) 
+
+
+ +

+Un-Register from the hub. +

+SAMP_UNREGISTER -- Un-Register from the hub.

+

Parameters:
+ + +
handle samp struct handle
+
+
Returns:
SAMP_OK or SAMP_ERR
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
void samp_Unsubscribe (handle_t  handle,
String  mtype 
)
+
+
+ +

+Unsubscribe to a given mtype. +

+SAMP_UNSUBSCRIBE -- Unsubscribe to a given mtype.

+

Parameters:
+ + + +
handle user handle to samp struct
mtype mtype name
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
void sampClose (handle_t  handle  ) 
+
+
+ +

+Close the SAMP interface and free resources. +

+SAMP_CLOSE -- Close the SAMP interface.

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int sampDebug (handle_t  handle,
int  value 
)
+
+
+ +

+Set interface debug level. +

+SAMPDEBUG -- Set interface debug level.

+

Parameters:
+ + + +
handle user handle to samp struct
value debug value
+
+
Returns:
nothing
+ +

References Samp::debug, and Samp::verbose.

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
handle_t sampInit (String  appName,
String  description 
)
+
+
+ +

+Initialize the SAMP interface. +

+Prototype declarations.

+SAMP_INIT -- Initialize the SAMP interface.

+

Parameters:
+ + + +
appName application name
description description of application
+
+
Returns:
samp handle
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
sampLog (handle_t  handle,
char *  format,
  ... 
)
+
+
+ +

+SAMP message logger. +

+SAMPLOG -- SAMP message logger.

+

Parameters:
+ + + +
handle SAMP handle
format message format string
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
int sampShutdown (handle_t  handle  ) 
+
+
+ +

+Shut down the active SAMP interface. +

+SAMP_SHUTDOWN -- Shut down the active SAMP interface.

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + +
int sampStartup (handle_t  handle  ) 
+
+
+ +

+Startup the SAMP interface to send/receive messages. +

+SAMP_STARTUP -- Startup the SAMP interface to send/receive messages.

+

Parameters:
+ + +
handle user handle to samp struct
+
+
Returns:
nothing
+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
sampTrace (handle_t  handle,
char *  format,
  ... 
)
+
+
+ +

+SAMP tracer. +

+SAMPTRACE -- SAMP tracer.

+

Parameters:
+ + + +
handle SAMP handle
format message format string
+
+
Returns:
nothing
+ +

Referenced by samp_Metadata(), sampClose(), and sampInit().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + +
int sampVerbose (handle_t  handle,
int  value 
)
+
+
+ +

+Set interface debug level. +

+SAMPVERBOSE -- Set interface verbose level.

+

Parameters:
+ + + +
handle user handle to samp struct
value verbose value
+
+
Returns:
nothing
+ +

References Samp::verbose.

+ +
+

+

+
Generated on Wed Feb 27 21:10:15 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/samp_8h_source.html b/vendor/voclient/libsamp/doc/html/samp_8h_source.html new file mode 100644 index 00000000..9474ec50 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/samp_8h_source.html @@ -0,0 +1,481 @@ + + +SAMP Client Library: samp.h Source File + + + + + +
Generated on Wed Feb 27 21:10:15 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/structClient.html b/vendor/voclient/libsamp/doc/html/structClient.html new file mode 100644 index 00000000..5972b803 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/structClient.html @@ -0,0 +1,61 @@ + + +SAMP Client Library: Client Struct Reference + + + + + +
+

Client Struct Reference

#include <samp.h> +

+ + + + + + + +

Data Fields

+char pubId [SZ_NAME]
char name [SZ_NAME]
+

Detailed Description

+Registered Client name mappings.

Field Documentation

+ +
+
+ + + + +
char Client::name
+
+
+ +

+public name +

Referenced by samp_addClient(), samp_app2id(), samp_envGet(), samp_id2app(), samp_listClients(), samp_mapClients(), samp_paramGet(), samp_removeClient(), and sampStartup().

+ +
+

+

The documentation for this struct was generated from the following files: +
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/structHub.html b/vendor/voclient/libsamp/doc/html/structHub.html new file mode 100644 index 00000000..b1679a81 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/structHub.html @@ -0,0 +1,287 @@ + + +SAMP Client Library: Hub Struct Reference + + + + + +
+

Hub Struct Reference

#include <samp.h> +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Data Fields

+char appName [SZ_LINE]
char appVer [SZ_LINE]
char description [SZ_LINE]
appMD meta
char secret [SZ_SECRET]
char url [SZ_URL]
char version [SZ_NAME]
int id
char appId [SZ_NAME]
char privateKey [SZ_LINE]
char hubId [SZ_LINE]
char selfId [SZ_LINE]
char timeout [SZ_NAME]
void * samp
+

Detailed Description

+Hub description. Our application connects to this hub by default, but the structure will be valid for any Hub.

Field Documentation

+ +
+
+ + + + +
char Hub::appId
+
+
+ +

+Hub XML-RPC connection +

Referenced by samp_hubOpen().

+ +
+

+ +

+
+ + + + +
char Hub::appVer
+
+
+ +

+application name +

Referenced by samp_hubOpen(), samp_Metadata(), and samp_setAppVersion().

+ +
+

+ +

+
+ + + + +
char Hub::description
+
+
+ +

+application version +

Referenced by samp_hubDeclareMetadata(), samp_hubOpen(), and samp_Metadata().

+ +
+

+ +

+
+ + + + +
char Hub::hubId
+
+
+ +

+client key value +

Referenced by samp_hubRegister(), and samp_Register().

+ +
+

+ +

+
+ + + + +
int Hub::id
+
+
+ +

+Hub version string +

Referenced by samp_call(), samp_callAll(), samp_callAndWait(), samp_envGet(), samp_GetMetadata(), samp_GetRegisteredClients(), samp_GetSubscribedClients(), samp_hubDeclareMetadata(), samp_hubDeclareSubscriptions(), samp_hubOpen(), samp_hubPing(), samp_hubRegister(), samp_hubSendShutdown(), samp_hubSetXmlrpcCallback(), samp_hubUnRegister(), samp_notify(), samp_notifyAll(), samp_paramGet(), samp_Register(), samp_Reply(), and sampStartup().

+ +
+

+ +

+
+ + + + +
appMD Hub::meta
+
+
+ +

+descriptive text +

Referenced by samp_hubClose(), samp_hubDeclareMetadata(), samp_hubOpen(), and samp_Metadata().

+ +
+

+ +

+
+ + + + +
char Hub::privateKey
+
+
+ +

+client key +

Referenced by samp_call(), samp_callAll(), samp_callAndWait(), samp_envGet(), samp_GetMetadata(), samp_GetRegisteredClients(), samp_GetSubscribedClients(), samp_hubDeclareMetadata(), samp_hubDeclareSubscriptions(), samp_hubPing(), samp_hubRegister(), samp_hubSendShutdown(), samp_hubSetXmlrpcCallback(), samp_hubUnRegister(), samp_notify(), samp_notifyAll(), samp_paramGet(), samp_Register(), and samp_Reply().

+ +
+

+ +

+
+ + + + +
void * Hub::samp
+
+
+ +

+Sync msg timeout (str) +

Referenced by samp_hubDeclareSubscriptions(), and samp_hubOpen().

+ +
+

+ +

+
+ + + + +
char Hub::secret
+
+
+ +

+metadata +

Referenced by samp_hubRegister(), and samp_Register().

+ +
+

+ +

+
+ + + + +
char Hub::selfId
+
+
+ +

+Hub id value +

Referenced by samp_hubRegister(), and samp_Register().

+ +
+

+ +

+
+ + + + +
char Hub::timeout
+
+
+ +

+Client id value +

Referenced by samp_callAndWait(), samp_envGet(), samp_hubOpen(), samp_paramGet(), and samp_setTimeout().

+ +
+

+ +

+
+ + + + +
char Hub::url
+
+
+ +

+registration string +

Referenced by samp_hubOpen().

+ +
+

+ +

+
+ + + + +
char Hub::version
+
+
+ +

+Hub service endpoint +

+

+

The documentation for this struct was generated from the following files: +
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/structSamp.html b/vendor/voclient/libsamp/doc/html/structSamp.html new file mode 100644 index 00000000..a7a13c2f --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/structSamp.html @@ -0,0 +1,479 @@ + + +SAMP Client Library: Samp Struct Reference + + + + + +
+

Samp Struct Reference

#include <samp.h> +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Data Fields

+char appName [SZ_NAME]
char appVer [SZ_LINE]
char description [SZ_NAME]
char errortxt [SZ_LINE]
appMD meta
pthread_t svrThread
int(* defaultUserFunc )(char *sender, char *msgid, Map map)
+Subs subs [MAX_SUBS]
int nsubs
Client clients [MAX_CLIENTS]
int nclients
int serverTid
int serverPort
Hub * hub
handle_t hubHandle
int hubThreadID
int active
int mapClients
int msgMode
int handlerMode
FILE * logfd
int debug
int verbose
int trace
+

Detailed Description

+SAMP application description. By default this describes our app by may be used to store information about other apps in the network as well.

Field Documentation

+ +
+
+ + + + +
int Samp::active
+
+
+ +

+Hub thread id +

Referenced by samp_hubActive(), sampShutdown(), and sampStartup().

+ +
+

+ +

+
+ + + + +
char Samp::appVer
+
+
+ +

+application name +

Referenced by samp_hubOpen(), samp_Metadata(), and samp_setAppVersion().

+ +
+

+ +

+
+ + + + +
Client Samp::clients
+
+
+ +

+number of subscriptions +

Referenced by samp_addClient(), samp_app2id(), samp_envGet(), samp_id2app(), samp_listClients(), samp_mapClients(), samp_paramGet(), samp_removeClient(), samp_sendMsg(), and sampStartup().

+ +
+

+ +

+
+ + + + +
int Samp::debug
+
+
+ +

+log file descriptor +

Referenced by samp_call(), samp_callAll(), samp_callAndWait(), samp_notifyAll(), sampDebug(), and sampLog().

+ +
+

+ +

+
+ + + + + + + + + + + + + + + + + + + + + + + + +
int(* Samp::defaultUserFunc)(char *sender, char *msgid, Map map) (char *  sender,
char *  msgid,
Map  map 
)
+
+
+ +

+server thread number default user handler +

Referenced by samp_execUserHandler(), samp_getUserHandler(), samp_receiveCall(), samp_receiveNotification(), samp_receiveResponse(), and samp_setUserHandler().

+ +
+

+ +

+
+ + + + +
char Samp::description
+
+
+ +

+application version +

Referenced by samp_getMetadata(), samp_hubOpen(), samp_Metadata(), and samp_printMetadata().

+ +
+

+ +

+
+ + + + +
char Samp::errortxt
+
+
+ +

+application description +

Referenced by samp_call(), samp_callAll(), samp_callAndWait(), samp_envGet(), samp_getErr(), samp_GetMetadata(), samp_notifyAll(), samp_paramGet(), and samp_setErr().

+ +
+

+ +

+
+ + + + +
int Samp::handlerMode
+
+
+ +

+(a)synch message mode +

Referenced by samp_bibcodeHandler(), samp_cmdExecHandler(), samp_envGetHandler(), samp_envSetHandler(), samp_execUserHandler(), samp_imLoadHandler(), samp_paramGetHandler(), samp_paramSetHandler(), samp_PingHandler(), samp_pointAtHandler(), samp_resConeHandler(), samp_resLoadHandler(), samp_resSiapHandler(), samp_resSsapHandler(), samp_resTapHandler(), samp_resVOSpaceHandler(), samp_setCallByRef(), samp_specLoadHandler(), samp_specSSAHandler(), samp_StatusHandler(), samp_tbHighlightHandler(), samp_tbLoadFITSHandler(), samp_tbLoadHandler(), samp_tbLoadVOTHandler(), and samp_tbSelectHandler().

+ +
+

+ +

+
+ + + + +
Hub * Samp::hub
+
+
+ +

+samp server port +

Referenced by samp_bibLoad(), samp_call(), samp_callAll(), samp_callAndWait(), samp_cmdExec(), samp_coordPointAtSky(), samp_DeclareMetadata(), samp_DeclareSubscriptions(), samp_envGet(), samp_envSet(), samp_GetMetadata(), samp_GetRegisteredClients(), samp_GetSubscribedClients(), samp_imageLoadFITS(), samp_Metadata(), samp_notify(), samp_notifyAll(), samp_paramGet(), samp_paramSet(), samp_Ping(), samp_Register(), samp_Reply(), samp_resourceLoad(), samp_sendGeneric(), samp_setAppVersion(), samp_setTimeout(), samp_specLoadSSAGeneric(), samp_tableHighlightRow(), samp_tableLoadFITS(), samp_tableLoadVOTable(), samp_tableSelectRowList(), samp_UnRegister(), sampClose(), and sampStartup().

+ +
+

+ +

+
+ + + + +
handle_t Samp::hubHandle
+
+
+ +

+Hub connection +

Referenced by sampClose(), sampShutdown(), and sampStartup().

+ +
+

+ +

+
+ + + + +
int Samp::hubThreadID
+
+
+ +

+Hub handle alias +

+

+ +

+
+ + + + +
FILE * Samp::logfd
+
+
+ +

+CBR / CBV for user handlers +

Referenced by sampLog().

+ +
+

+ +

+
+ + + + +
int Samp::mapClients
+
+
+ +

+is interface active +

Referenced by sampStartup().

+ +
+

+ +

+
+ + + + +
appMD Samp::meta
+
+
+ +

+last msh error string +

Referenced by samp_getMetadata(), samp_Metadata(), and samp_printMetadata().

+ +
+

+ +

+
+ + + + +
int Samp::msgMode
+
+
+ +

+map other clients

+is interface active +

Referenced by samp_sendMsg(), samp_setASyncMode(), samp_setCallMode(), samp_setMsgMode(), samp_setNotifyMode(), and samp_setSyncMode().

+ +
+

+ +

+
+ + + + +
int Samp::nclients
+
+
+ +

+samp clients +

Referenced by samp_addClient(), samp_app2id(), samp_envGet(), samp_id2app(), samp_listClients(), samp_mapClients(), samp_paramGet(), samp_removeClient(), samp_sendMsg(), and sampStartup().

+ +
+

+ +

+
+ + + + +
int Samp::nsubs
+
+
+ +

+message subscriptions +

Referenced by samp_getSampHandler(), samp_getUserHandler(), samp_hubDeclareSubscriptions(), samp_setSampHandler(), samp_setUserHandler(), samp_Subscribe(), and samp_Unsubscribe().

+ +
+

+ +

+
+ + + + +
int Samp::serverPort
+
+
+ +

+samp server threadId +

+

+ +

+
+ + + + +
int Samp::serverTid
+
+
+ +

+number of samp clients +

+

+ +

+
+ + + + +
pthread_t Samp::svrThread
+
+
+ +

+metadata +

Referenced by sampShutdown().

+ +
+

+ +

+
+ + + + +
int Samp::trace
+
+
+ +

+verbose flag

+debug flag +

Referenced by samp_call(), samp_callAll(), samp_callAndWait(), samp_notifyAll(), samp_receiveCall(), samp_receiveNotification(), samp_receiveResponse(), sampStartup(), and sampTrace().

+ +
+

+ +

+
+ + + + +
int Samp::verbose
+
+
+ +

+debug flag +

Referenced by sampClose(), sampDebug(), sampShutdown(), sampStartup(), and sampVerbose().

+ +
+

+

The documentation for this struct was generated from the following files: +
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/structSubs.html b/vendor/voclient/libsamp/doc/html/structSubs.html new file mode 100644 index 00000000..f69e3c6a --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/structSubs.html @@ -0,0 +1,111 @@ + + +SAMP Client Library: Subs Struct Reference + + + + + +
+

Subs Struct Reference

#include <samp.h> +

+ + + + + + + + + +

Data Fields

+char mtype [SZ_LINE]
int(* userFunc )(void *p)
int(* sampFunc )(char *sid, char *sender, char *msgid, Map map)
+

Detailed Description

+Message subscription.

Field Documentation

+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
int(* Subs::sampFunc)(char *sid, char *sender, char *msgid, Map map) (char *  sid,
char *  sender,
char *  msgid,
Map  map 
)
+
+
+ +

+user handler function samp handler function +

Referenced by samp_getSampHandler(), samp_setSampHandler(), and samp_Unsubscribe().

+ +
+

+ +

+
+ + + + + + + + + +
int(* Subs::userFunc)(void *p) (void *  p  ) 
+
+
+ +

+mtype string +

Referenced by samp_getUserHandler(), samp_hubDeclareSubscriptions(), samp_setUserHandler(), and samp_Unsubscribe().

+ +
+

+

The documentation for this struct was generated from the following files: +
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/structappMD.html b/vendor/voclient/libsamp/doc/html/structappMD.html new file mode 100644 index 00000000..fd43ea07 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/structappMD.html @@ -0,0 +1,174 @@ + + +SAMP Client Library: appMD Struct Reference + + + + + +
+

appMD Struct Reference

#include <samp.h> +

+ + + + + + + + + + + + + + + + + + + +

Data Fields

+char name [SZ_LINE]
char desc [SZ_DESC]
char iconURL [SZ_URL]
char docURL [SZ_URL]
char * descHTML
int nkeys
char * aKey [MAX_MDATTRS]
char * aVal [MAX_MDATTRS]
+

Detailed Description

+SAMP String datatype Application (and Hub) metadata.

+Application (and Hub) metadata.

Field Documentation

+ +
+
+ + + + +
char * appMD::aKey
+
+
+ +

+number of meta keys +

Referenced by samp_getMetadata(), samp_hubClose(), samp_hubDeclareMetadata(), samp_Metadata(), and samp_printMetadata().

+ +
+

+ +

+
+ + + + +
char * appMD::aVal
+
+
+ +

+attr keyword +

Referenced by samp_getMetadata(), samp_hubClose(), samp_hubDeclareMetadata(), samp_Metadata(), and samp_printMetadata().

+ +
+

+ +

+
+ + + + +
char appMD::desc
+
+
+ +

+name +

Referenced by samp_hubOpen(), and samp_Metadata().

+ +
+

+ +

+
+ + + + +
char * appMD::descHTML
+
+
+ +

+documentation URL +

+

+ +

+
+ + + + +
char appMD::docURL
+
+
+ +

+icon URL +

Referenced by samp_getMetadata(), samp_hubDeclareMetadata(), samp_Metadata(), and samp_printMetadata().

+ +
+

+ +

+
+ + + + +
char appMD::iconURL
+
+
+ +

+descriptive text +

Referenced by samp_getMetadata(), samp_hubDeclareMetadata(), samp_Metadata(), and samp_printMetadata().

+ +
+

+ +

+
+ + + + +
int appMD::nkeys
+
+
+ +

+descriptive text (HTML) +

Referenced by samp_getMetadata(), samp_hubClose(), samp_hubDeclareMetadata(), samp_Metadata(), and samp_printMetadata().

+ +
+

+

The documentation for this struct was generated from the following files: +
+
Generated on Wed Feb 27 21:10:16 2013 for SAMP Client Library by  + +doxygen 1.5.9
+ + diff --git a/vendor/voclient/libsamp/doc/html/tab_b.gif b/vendor/voclient/libsamp/doc/html/tab_b.gif new file mode 100644 index 00000000..0d623483 Binary files /dev/null and b/vendor/voclient/libsamp/doc/html/tab_b.gif differ diff --git a/vendor/voclient/libsamp/doc/html/tab_l.gif b/vendor/voclient/libsamp/doc/html/tab_l.gif new file mode 100644 index 00000000..9b1e6337 Binary files /dev/null and b/vendor/voclient/libsamp/doc/html/tab_l.gif differ diff --git a/vendor/voclient/libsamp/doc/html/tab_r.gif b/vendor/voclient/libsamp/doc/html/tab_r.gif new file mode 100644 index 00000000..ce9dd9f5 Binary files /dev/null and b/vendor/voclient/libsamp/doc/html/tab_r.gif differ diff --git a/vendor/voclient/libsamp/doc/html/tabs.css b/vendor/voclient/libsamp/doc/html/tabs.css new file mode 100644 index 00000000..ab02c624 --- /dev/null +++ b/vendor/voclient/libsamp/doc/html/tabs.css @@ -0,0 +1,105 @@ +/* tabs styles, based on http://www.alistapart.com/articles/slidingdoors */ + +DIV.tabs +{ + float : left; + width : 100%; + background : url("tab_b.gif") repeat-x bottom; + margin-bottom : 4px; +} + +DIV.tabs UL +{ + margin : 0px; + padding-left : 10px; + list-style : none; +} + +DIV.tabs LI, DIV.tabs FORM +{ + display : inline; + margin : 0px; + padding : 0px; +} + +DIV.tabs FORM +{ + float : right; +} + +DIV.tabs A +{ + float : left; + background : url("tab_r.gif") no-repeat right top; + border-bottom : 1px solid #84B0C7; + font-size : 80%; + font-weight : bold; + text-decoration : none; +} + +DIV.tabs A:hover +{ + background-position: 100% -150px; +} + +DIV.tabs A:link, DIV.tabs A:visited, +DIV.tabs A:active, DIV.tabs A:hover +{ + color: #1A419D; +} + +DIV.tabs SPAN +{ + float : left; + display : block; + background : url("tab_l.gif") no-repeat left top; + padding : 5px 9px; + white-space : nowrap; +} + +DIV.tabs INPUT +{ + float : right; + display : inline; + font-size : 1em; +} + +DIV.tabs TD +{ + font-size : 80%; + font-weight : bold; + text-decoration : none; +} + + + +/* Commented Backslash Hack hides rule from IE5-Mac \*/ +DIV.tabs SPAN {float : none;} +/* End IE5-Mac hack */ + +DIV.tabs A:hover SPAN +{ + background-position: 0% -150px; +} + +DIV.tabs LI.current A +{ + background-position: 100% -150px; + border-width : 0px; +} + +DIV.tabs LI.current SPAN +{ + background-position: 0% -150px; + padding-bottom : 6px; +} + +DIV.navpath +{ + background : none; + border : none; + border-bottom : 1px solid #84B0C7; + text-align : center; + margin : 2px; + padding : 2px; +} -- cgit