Loading [MathJax]/extensions/tex2jax.js
LSST Applications g04a91732dc+a3f7a6a005,g07dc498a13+5ab4d22ec3,g0fba68d861+870ee37b31,g1409bbee79+5ab4d22ec3,g1a7e361dbc+5ab4d22ec3,g1fd858c14a+11200c7927,g20f46db602+25d63fd678,g35bb328faa+fcb1d3bbc8,g4d2262a081+cc8af5cafb,g4d39ba7253+6b9d64fe03,g4e0f332c67+5d362be553,g53246c7159+fcb1d3bbc8,g60b5630c4e+6b9d64fe03,g78460c75b0+2f9a1b4bcd,g786e29fd12+cf7ec2a62a,g7b71ed6315+fcb1d3bbc8,g8048e755c2+a1301e4c20,g8852436030+a750987b4a,g89139ef638+5ab4d22ec3,g89e1512fd8+a86d53a4aa,g8d6b6b353c+6b9d64fe03,g9125e01d80+fcb1d3bbc8,g989de1cb63+5ab4d22ec3,g9f33ca652e+38ca901d1a,ga9baa6287d+6b9d64fe03,gaaedd4e678+5ab4d22ec3,gabe3b4be73+1e0a283bba,gb1101e3267+aa269f591c,gb58c049af0+f03b321e39,gb90eeb9370+af74afe682,gc741bbaa4f+7f5db660ea,gcf25f946ba+a750987b4a,gd315a588df+b78635c672,gd6cbbdb0b4+c8606af20c,gd9a9a58781+fcb1d3bbc8,gde0f65d7ad+5839af1903,ge278dab8ac+932305ba37,ge82c20c137+76d20ab76d,w.2025.11
LSST Data Management Base Package
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Modules Pages
xpa.cc
Go to the documentation of this file.
1/*
2 * LSST Data Management System
3 *
4 * This product includes software developed by the
5 * LSST Project (http://www.lsst.org/).
6 * See the COPYRIGHT file
7 *
8 * This program is free software: you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation, either version 3 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the LSST License Statement and
19 * the GNU General Public License along with this program. If not,
20 * see <https://www.lsstcorp.org/LegalNotices/>.
21 */
22#include "pybind11/pybind11.h"
23
24#include "xpa.h"
26
27namespace py = pybind11;
28using namespace pybind11::literals;
29
30namespace lsst {
31namespace display {
32namespace ds9 {
33
34namespace {
35
36class myXPA {
37public:
38 static XPA get(bool reset = false) {
39 static myXPA *singleton = NULL;
40
41 if (reset && singleton != NULL) {
42 delete singleton;
43 singleton = NULL;
44 }
45
46 if (singleton == NULL) {
47 singleton = new myXPA("w");
48 }
49
50 return singleton->_xpa;
51 }
52
53private:
54 myXPA(myXPA &) = delete;
55 myXPA operator=(myXPA const &) = delete;
56
57 myXPA(char const *mode) {
58 _xpa = XPAOpen((char *)mode);
59
60 if (_xpa == NULL) {
61 throw LSST_EXCEPT(lsst::pex::exceptions::IoError, "Unable to open XPA");
62 }
63 }
64
65 ~myXPA() { XPAClose(_xpa); }
66
67 static XPA _xpa; // the real XPA connection
68};
69
70XPA myXPA::_xpa = NULL;
71
72/*
73 * A binding for XPAGet that talks to only one server, but doesn't have to talk (char **) with SWIG
74 */
75const char *XPAGet1(XPA xpa, char *xtemplate, char *paramlist, char *mode) {
76 char *buf = NULL; /* desired response */
77 size_t len = 0; /* length of buf; ignored */
78 char *error = NULL; /* returned error if any*/
79
80 if (xpa == NULL) {
81 xpa = myXPA::get();
82 }
83
84 int n = XPAGet(xpa, xtemplate, paramlist, mode, &buf, &len, NULL, &error, 1);
85
86 if (n == 0) {
87 throw LSST_EXCEPT(lsst::pex::exceptions::IoError, "XPAGet returned 0");
88 }
89 if (error != NULL) {
90 return error;
91 }
92 if (buf == NULL) {
93 throw LSST_EXCEPT(lsst::pex::exceptions::IoError, "XPAGet returned a null buffer pointer");
94 }
95
96 return (buf);
97}
98
99const char *XPASet1(XPA xpa, char *xtemplate, char *paramlist, char *mode,
100 char *buf, // desired extra data
101 int len = -1) // length of buf (or -1 to compute automatically)
102{
103 if (len < 0) {
104 len = strlen(buf); // length of buf
105 }
106 char *error = NULL; // returned error if any
107
108 if (xpa == NULL) {
109 xpa = myXPA::get();
110 }
111
112 int n = XPASet(xpa, xtemplate, paramlist, mode, buf, len, NULL, &error, 1);
113
114 if (n == 0) {
115 throw LSST_EXCEPT(lsst::pex::exceptions::IoError, "XPASet returned 0");
116 }
117 if (error != NULL) {
118 return error;
119 }
120
121 return "";
122}
123
124const char *XPASetFd1(XPA xpa, char *xtemplate, char *paramlist, char *mode,
125 int fd) /* file descriptor for xpa to read */
126{
127 char *error = NULL; /* returned error if any*/
128
129 if (xpa == NULL) {
130 xpa = myXPA::get();
131 }
132
133 int n = XPASetFd(xpa, xtemplate, paramlist, mode, fd, NULL, &error, 1);
134
135 if (n == 0) {
136 throw LSST_EXCEPT(lsst::pex::exceptions::IoError, "XPASetFd returned 0");
137 }
138 if (error != NULL) {
139 return error;
140 }
141 return "";
142}
143
144void reset() { myXPA::get(true); }
145
146} // <anonymous>
147
149 py::module::import("lsst.pex.exceptions");
150
151 py::class_<xparec> cls(mod, "xparec");
152 cls.def(py::init<>());
153
154 mod.def("get", &XPAGet1, "xpa"_a, "xtemplate"_a, "paramList"_a, "mode"_a);
155 mod.def("reset", &reset);
156 mod.def("set", &XPASet1, "xpa"_a, "xtemplate"_a, "paramList"_a, "mode"_a, "buf"_a, "len"_a = -1);
157 mod.def("setFd1", &XPASetFd1, "xpa"_a, "xtemplate"_a, "paramList"_a, "mode"_a, "fd"_a);
158}
159
160} // ds9
161} // display
162} // lsst
#define LSST_EXCEPT(type,...)
Create an exception with a given type.
Definition Exception.h:48
PYBIND11_MODULE(xpa, mod)
Definition xpa.cc:148
T strlen(T... args)