1 /* This file is part of Pazpar2.
2 Copyright (C) 2006-2013 Index Data
4 Pazpar2 is free software; you can redistribute it and/or modify it under
5 the terms of the GNU General Public License as published by the Free
6 Software Foundation; either version 2, or (at your option) any later
9 Pazpar2 is distributed in the hope that it will be useful, but WITHOUT ANY
10 WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
24 #include <sys/types.h>
33 #include <yaz/snprintf.h>
34 #include <yaz/yaz-util.h>
38 #include "parameters.h"
47 void print_meminfo(WRBUF wrbuf)
49 struct mallinfo minfo;
51 wrbuf_printf(wrbuf, " <memory>\n"
52 " <arena>%d</arena>\n"
53 " <uordblks>%d</uordblks>\n"
54 " <fordblks>%d</fordblks>\n"
55 " <ordblks>%d</ordblks>\n"
56 " <keepcost>%d</keepcost>\n"
57 " <hblks>%d</hblks>\n"
58 " <hblkhd>%d</hblkhd>\n"
60 " <virtuse>%d</virtuse>\n"
62 minfo.arena, minfo.uordblks, minfo.fordblks,minfo.ordblks, minfo.keepcost, minfo.hblks, minfo.hblkhd, minfo.arena + minfo.hblkhd, minfo.uordblks + minfo.hblkhd);
66 #define print_meminfo(x)
70 // Update this when the protocol changes
71 #define PAZPAR2_PROTOCOL_VERSION "1"
73 #define HTTP_COMMAND_RESPONSE_PREFIX "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
76 IOCHAN timeout_iochan; // NOTE: This is NOT associated with a socket
77 struct session *psession;
78 unsigned int session_id;
83 http_sessions_t http_sessions;
84 struct http_session *next;
87 struct http_sessions {
88 struct http_session *session_list;
93 static YAZ_MUTEX g_http_session_mutex = 0;
94 static int g_http_sessions = 0;
96 static void show_records_ready(void *data);
98 int get_version(struct http_request *rq) {
99 const char *version = http_argbyname(rq, "version");
101 if (version && strcmp(version, "")) {
102 version_no = atoi(version);
108 int http_session_use(int delta)
111 if (!g_http_session_mutex)
112 yaz_mutex_create(&g_http_session_mutex);
113 yaz_mutex_enter(g_http_session_mutex);
114 g_http_sessions += delta;
115 sessions = g_http_sessions;
116 yaz_mutex_leave(g_http_session_mutex);
117 yaz_log(YLOG_DEBUG, "%s sessions=%d", delta == 0 ? "" : (delta > 0 ? "INC" : "DEC"), sessions);
122 http_sessions_t http_sessions_create(void)
124 http_sessions_t hs = xmalloc(sizeof(*hs));
125 hs->session_list = 0;
127 pazpar2_mutex_create(&hs->mutex, "http_sessions");
128 hs->log_level = yaz_log_module_level("HTTP");
132 void http_sessions_destroy(http_sessions_t hs)
136 struct http_session *s = hs->session_list;
139 struct http_session *s_next = s->next;
140 iochan_destroy(s->timeout_iochan);
141 session_destroy(s->psession);
142 nmem_destroy(s->nmem);
145 yaz_mutex_destroy(&hs->mutex);
150 void http_session_destroy(struct http_session *s);
152 static void session_timeout(IOCHAN i, int event)
154 struct http_session *s = iochan_getdata(i);
155 http_session_destroy(s);
158 struct http_session *http_session_create(struct conf_service *service,
159 http_sessions_t http_sessions,
162 NMEM nmem = nmem_create();
163 struct http_session *r = nmem_malloc(nmem, sizeof(*r));
166 sprintf(tmp_str, "session#%u", sesid);
167 r->psession = new_session(nmem, service, sesid);
168 r->session_id = sesid;
171 r->destroy_counter = r->activity_counter = 0;
172 r->http_sessions = http_sessions;
174 yaz_mutex_enter(http_sessions->mutex);
175 r->next = http_sessions->session_list;
176 http_sessions->session_list = r;
177 yaz_mutex_leave(http_sessions->mutex);
179 r->timeout_iochan = iochan_create(-1, session_timeout, 0,
180 "http_session_timeout");
181 iochan_setdata(r->timeout_iochan, r);
183 session_log(r->psession, http_sessions->log_level,
184 "HTTP session create. timeout chan=%p ses=%d",
185 r->timeout_iochan, service->session_timeout);
186 iochan_settimeout(r->timeout_iochan, service->session_timeout);
188 iochan_add(service->server->iochan_man, r->timeout_iochan);
193 void http_session_destroy(struct http_session *s)
195 int must_destroy = 0;
197 http_sessions_t http_sessions = s->http_sessions;
199 session_log(s->psession, http_sessions->log_level,
200 "HTTP session destroy");
201 yaz_mutex_enter(http_sessions->mutex);
202 /* only if http_session has no active http sessions on it can be destroyed */
203 if (s->destroy_counter == s->activity_counter)
205 struct http_session **p = 0;
207 for (p = &http_sessions->session_list; *p; p = &(*p)->next)
214 yaz_mutex_leave(http_sessions->mutex);
216 { /* destroying for real */
217 session_log(s->psession, http_sessions->log_level, "About to destroyd");
218 iochan_destroy(s->timeout_iochan);
219 session_destroy(s->psession);
220 http_session_use(-1);
221 nmem_destroy(s->nmem);
225 session_log(s->psession, http_sessions->log_level,
226 "Destroy delayed. Active clients (%d-%d)",
227 s->activity_counter, s->destroy_counter);
232 static const char *get_msg(enum pazpar2_error_code code)
234 struct pazpar2_error_msg {
235 enum pazpar2_error_code code;
238 static const struct pazpar2_error_msg ar[] = {
239 { PAZPAR2_NO_SESSION, "Session does not exist or it has expired"},
240 { PAZPAR2_MISSING_PARAMETER, "Missing parameter"},
241 { PAZPAR2_MALFORMED_PARAMETER_VALUE, "Malformed parameter value"},
242 { PAZPAR2_MALFORMED_PARAMETER_ENCODING, "Malformed parameter encoding"},
243 { PAZPAR2_MALFORMED_SETTING, "Malformed setting argument"},
244 { PAZPAR2_HITCOUNTS_FAILED, "Failed to retrieve hitcounts"},
245 { PAZPAR2_RECORD_MISSING, "Record missing"},
246 { PAZPAR2_NO_TARGETS, "No targets"},
247 { PAZPAR2_CONFIG_TARGET, "Target cannot be configured"},
248 { PAZPAR2_RECORD_FAIL, "Record command failed"},
249 { PAZPAR2_NOT_IMPLEMENTED, "Not implemented"},
250 { PAZPAR2_NO_SERVICE, "No service"},
251 { PAZPAR2_ALREADY_BLOCKED, "Already blocked in session on: "},
252 { PAZPAR2_LAST_ERROR, "Last error"},
258 if (code == ar[i].code)
265 static void error(struct http_response *rs,
266 enum pazpar2_error_code code,
269 struct http_channel *c = rs->channel;
270 WRBUF text = wrbuf_alloc();
271 const char *http_status = "417";
272 const char *msg = get_msg(code);
274 rs->msg = nmem_strdup(c->nmem, msg);
275 strcpy(rs->code, http_status);
277 wrbuf_printf(text, HTTP_COMMAND_RESPONSE_PREFIX "<error code=\"%d\" msg=\"%s\">", (int) code,
280 wrbuf_xmlputs(text, addinfo);
281 wrbuf_puts(text, "</error>");
283 yaz_log(YLOG_WARN, "HTTP %s %s%s%s", http_status,
284 msg, addinfo ? ": " : "" , addinfo ? addinfo : "");
285 rs->payload = nmem_strdup(c->nmem, wrbuf_cstr(text));
287 http_send_response(c);
290 static void response_open_command(struct http_channel *c, const char *command)
292 wrbuf_rewind(c->wrbuf);
293 wrbuf_puts(c->wrbuf, HTTP_COMMAND_RESPONSE_PREFIX);
295 wrbuf_printf(c->wrbuf, "<%s>", command);
298 static void response_open_ok(struct http_channel *c, const char *command)
300 response_open_command(c, command);
301 wrbuf_puts(c->wrbuf, "<status>OK</status>");
304 static void response_close(struct http_channel *c, const char *command)
306 struct http_response *rs = c->response;
309 wrbuf_printf(c->wrbuf, "</%s>", command);
310 rs->payload = nmem_strdup(c->nmem, wrbuf_cstr(c->wrbuf));
311 http_send_response(c);
314 unsigned int make_sessionid(void)
316 static int seq = 0; /* thread pr */
320 if (global_parameters.predictable_sessions)
329 if (gettimeofday(&t, 0) < 0)
331 yaz_log(YLOG_WARN|YLOG_ERRNO, "gettimeofday");
334 /* at most 256 sessions per second ..
335 (long long would be more appropriate)*/
337 res = ((res << 8) | (seq & 0xff)) & ((1U << 31) - 1);
343 static struct http_session *locate_session(struct http_channel *c)
345 struct http_request *rq = c->request;
346 struct http_response *rs = c->response;
347 struct http_session *p;
348 const char *session = http_argbyname(rq, "session");
349 http_sessions_t http_sessions = c->http_sessions;
354 error(rs, PAZPAR2_MISSING_PARAMETER, "session");
358 yaz_mutex_enter(http_sessions->mutex);
359 for (p = http_sessions->session_list; p; p = p->next)
360 if (id == p->session_id)
363 p->activity_counter++;
364 yaz_mutex_leave(http_sessions->mutex);
366 iochan_activity(p->timeout_iochan);
368 error(rs, PAZPAR2_NO_SESSION, session);
372 // Call after use of locate_session, in order to increment the destroy_counter
373 static void release_session(struct http_channel *c,
374 struct http_session *session)
376 http_sessions_t http_sessions = c->http_sessions;
377 yaz_mutex_enter(http_sessions->mutex);
379 session->destroy_counter++;
380 yaz_mutex_leave(http_sessions->mutex);
383 // Decode settings parameters and apply to session
384 // Syntax: setting[target]=value
385 static int process_settings(struct session *se, struct http_request *rq,
386 struct http_response *rs)
388 struct http_argument *a;
390 for (a = rq->arguments; a; a = a->next)
391 if (strchr(a->name, '['))
398 // Nmem_strsplit *rules*!!!
399 nmem_strsplit(se->session_nmem, "[]", a->name, &res, &num);
402 error(rs, PAZPAR2_MALFORMED_SETTING, a->name);
407 session_apply_setting(se, dbname, setting,
408 nmem_strdup(se->session_nmem, a->value));
413 static void cmd_exit(struct http_channel *c)
415 yaz_log(YLOG_WARN, "exit");
417 response_open_ok(c, "exit");
418 response_close(c, "exit");
419 if (global_parameters.debug_mode)
420 http_close_server(c->server);
423 static void cmd_init(struct http_channel *c)
425 struct http_request *r = c->request;
426 const char *clear = http_argbyname(r, "clear");
427 const char *content_type = http_lookup_header(r->headers, "Content-Type");
429 struct http_session *s;
430 struct http_response *rs = c->response;
431 struct conf_service *service = 0; /* no service (yet) */
433 if (r->content_len && content_type &&
434 !yaz_strcmp_del("text/xml", content_type, "; "))
436 xmlDoc *doc = xmlParseMemory(r->content_buf, r->content_len);
440 error(rs, PAZPAR2_MALFORMED_SETTING, 0);
443 root_n = xmlDocGetRootElement(doc);
444 service = service_create(c->server, root_n);
448 error(rs, PAZPAR2_MALFORMED_SETTING, 0);
455 const char *service_name = http_argbyname(c->request, "service");
456 service = locate_service(c->server, service_name);
459 error(rs, PAZPAR2_NO_SERVICE, service_name ? service_name : "unnamed");
463 sesid = make_sessionid();
464 s = http_session_create(service, c->http_sessions, sesid);
466 if (!clear || *clear == '0')
467 session_init_databases(s->psession);
469 session_log(s->psession, YLOG_LOG, "No databases preloaded");
471 if (process_settings(s->psession, c->request, c->response) < 0)
474 response_open_ok(c, "init");
475 wrbuf_printf(c->wrbuf, "<session>%d", sesid);
476 if (c->server->server_id)
478 wrbuf_puts(c->wrbuf, ".");
479 wrbuf_puts(c->wrbuf, c->server->server_id);
481 wrbuf_puts(c->wrbuf, "</session>"
482 "<protocol>" PAZPAR2_PROTOCOL_VERSION "</protocol>");
484 wrbuf_printf(c->wrbuf, "<keepAlive>%d</keepAlive>\n", 1000 * ((s->psession->service->session_timeout >= 20) ?
485 (s->psession->service->session_timeout - 10) : 50));
486 response_close(c, "init");
489 static void apply_local_setting(void *client_data,
492 struct session *se = (struct session *) client_data;
494 session_apply_setting(se, nmem_strdup(se->session_nmem, set->target),
495 nmem_strdup(se->session_nmem, set->name),
496 nmem_strdup(se->session_nmem, set->value));
499 static void cmd_settings(struct http_channel *c)
501 struct http_response *rs = c->response;
502 struct http_request *rq = c->request;
503 struct http_session *s = locate_session(c);
504 const char *content_type = http_lookup_header(rq->headers, "Content-Type");
509 if (rq->content_len && content_type &&
510 !yaz_strcmp_del("text/xml", content_type, "; "))
512 xmlDoc *doc = xmlParseMemory(rq->content_buf, rq->content_len);
517 error(rs, PAZPAR2_MALFORMED_SETTING, 0);
518 release_session(c,s);
521 root_n = xmlDocGetRootElement(doc);
522 ret = settings_read_node_x(root_n, s->psession, apply_local_setting);
526 error(rs, PAZPAR2_MALFORMED_SETTING, 0);
527 release_session(c,s);
531 if (process_settings(s->psession, rq, rs) < 0)
533 release_session(c, s);
536 response_open_ok(c, "settings");
537 response_close(c, "settings");
538 release_session(c, s);
541 static void termlist_response(struct http_channel *c, struct http_session *s, const char *cmd_status)
543 struct http_request *rq = c->request;
544 const char *name = http_argbyname(rq, "name");
545 const char *nums = http_argbyname(rq, "num");
546 int version = get_version(rq);
553 status = session_active_clients(s->psession);
555 response_open_command(c, "termlist");
556 /* new protocol add a status to response. Triggered by a status parameter */
558 wrbuf_printf(c->wrbuf, "<status>%s</status>\n", cmd_status);
559 wrbuf_printf(c->wrbuf, "<activeclients>%d</activeclients>\n", status);
561 perform_termlist(c, s->psession, name, num, version);
563 response_close(c, "termlist");
566 static void termlist_result_ready(void *data)
568 struct http_channel *c = (struct http_channel *) data;
569 struct http_request *rq = c->request;
570 const char *report = http_argbyname(rq, "report");
571 const char *status = 0;
572 struct http_session *s = locate_session(c);
573 if (report && !strcmp("status", report))
577 session_log(s->psession, c->http_sessions->log_level,
578 "termlist watch released");
579 termlist_response(c, s, status);
580 release_session(c,s);
584 static void cmd_termlist(struct http_channel *c)
586 struct http_request *rq = c->request;
587 struct http_response *rs = c->response;
588 struct http_session *s = locate_session(c);
589 const char *block = http_argbyname(rq, "block");
590 const char *report = http_argbyname(rq, "report");
591 int report_status = 0;
592 int report_error = 0;
593 const char *status_message = 0;
596 if (report && !strcmp("error", report))
599 status_message = "OK";
601 if (report && !strcmp("status", report))
604 status_message = "OK";
609 active_clients = session_active_clients(s->psession);
610 if (block && !strcmp("1", block) && active_clients)
612 // if there is already a watch/block. we do not block this one
613 if (session_set_watch(s->psession, SESSION_WATCH_TERMLIST,
614 termlist_result_ready, c, c) != 0)
616 session_log(s->psession, YLOG_WARN, "Attempt to block "
617 "multiple times on termlist block. Not supported!");
619 error(rs, PAZPAR2_ALREADY_BLOCKED, "termlist");
620 release_session(c, s);
623 else if (report_status)
624 status_message = "WARNING (Already blocked on termlist)";
626 session_log(s->psession, YLOG_WARN,
627 "Ignoring termlist block. Return current result");
631 session_log(s->psession, c->http_sessions->log_level,
632 "Blocking on command termlist");
633 release_session(c, s);
638 termlist_response(c, s, status_message);
639 release_session(c, s);
642 size_t session_get_memory_status(struct session *session);
644 static void session_status(struct http_channel *c, struct http_session *s)
647 wrbuf_printf(c->wrbuf, "<http_count>%u</http_count>\n", s->activity_counter);
648 wrbuf_printf(c->wrbuf, "<http_nmem>%zu</http_nmem>\n", nmem_total(s->nmem) );
649 session_nmem = session_get_memory_status(s->psession);
650 wrbuf_printf(c->wrbuf, "<session_nmem>%zu</session_nmem>\n", session_nmem);
653 static void cmd_service(struct http_channel *c)
655 struct http_session *s = locate_session(c);
660 response_open_command(c, 0);
661 xml_node = s->psession->service->xml_node;
664 xmlNode *tmp = xmlCopyNode(xml_node, 1);
665 xmlBufferPtr buf = xmlBufferCreate();
667 xmlNodeDump(buf, tmp->doc, tmp, 0, 0);
669 wrbuf_write(c->wrbuf, (const char *) buf->content, buf->use);
674 response_close(c, 0);
675 release_session(c, s);
678 static void cmd_session_status(struct http_channel *c)
680 struct http_session *s = locate_session(c);
684 response_open_ok(c, "session-status");
685 session_status(c, s);
686 response_close(c, "session-status");
687 release_session(c, s);
690 int sessions_count(void);
691 int clients_count(void);
692 #ifdef HAVE_RESULTSETS_COUNT
693 int resultsets_count(void);
695 #define resultsets_count() 0
698 static void cmd_server_status(struct http_channel *c)
700 int sessions = sessions_count();
701 int clients = clients_count();
702 int resultsets = resultsets_count();
704 response_open_ok(c, "server-status");
705 wrbuf_printf(c->wrbuf, "\n <sessions>%u</sessions>\n", sessions);
706 wrbuf_printf(c->wrbuf, " <clients>%u</clients>\n", clients);
707 /* Only works if yaz has been compiled with enabling of this */
708 wrbuf_printf(c->wrbuf, " <resultsets>%u</resultsets>\n",resultsets);
709 print_meminfo(c->wrbuf);
711 /* TODO add all sessions status */
712 /* http_sessions_t http_sessions = c->http_sessions; */
713 /* struct http_session *p; */
715 yaz_mutex_enter(http_sessions->mutex);
716 for (p = http_sessions->session_list; p; p = p->next)
718 p->activity_counter++;
719 wrbuf_puts(c->wrbuf, "<session-status>\n");
720 wrbuf_printf(c->wrbuf, "<id>%s</id>\n", p->session_id);
721 yaz_mutex_leave(http_sessions->mutex);
722 session_status(c, p);
723 wrbuf_puts(c->wrbuf, "</session-status>\n");
724 yaz_mutex_enter(http_sessions->mutex);
725 p->activity_counter--;
727 yaz_mutex_leave(http_sessions->mutex);
729 response_close(c, "server-status");
733 static void bytarget_response(struct http_channel *c, struct http_session *s, const char *cmd_status) {
735 struct hitsbytarget *ht;
736 struct http_request *rq = c->request;
737 const char *settings = http_argbyname(rq, "settings");
738 int version = get_version(rq);
739 ht = get_hitsbytarget(s->psession, &count, c->nmem);
741 /* Old protocol, always ok */
742 response_open_ok(c, "bytarget");
744 /* New protocol, OK or WARNING (...)*/
745 response_open_command(c, "bytarget");
746 wrbuf_printf(c->wrbuf, "<status>%s</status>", cmd_status);
750 session_log(s->psession, YLOG_WARN,
751 "Empty bytarget Response. No targets found!");
752 for (i = 0; i < count; i++)
754 wrbuf_puts(c->wrbuf, "\n<target>");
756 wrbuf_puts(c->wrbuf, "<id>");
757 wrbuf_xmlputs(c->wrbuf, ht[i].id);
758 wrbuf_puts(c->wrbuf, "</id>\n");
760 if (ht[i].name && ht[i].name[0])
762 wrbuf_puts(c->wrbuf, "<name>");
763 wrbuf_xmlputs(c->wrbuf, ht[i].name);
764 wrbuf_puts(c->wrbuf, "</name>\n");
767 wrbuf_printf(c->wrbuf, "<hits>" ODR_INT_PRINTF "</hits>\n", ht[i].hits);
768 wrbuf_printf(c->wrbuf, "<diagnostic>%d</diagnostic>\n", ht[i].diagnostic);
769 if (ht[i].diagnostic)
771 wrbuf_puts(c->wrbuf, "<message>");
772 wrbuf_xmlputs(c->wrbuf, ht[i].message);
773 wrbuf_puts(c->wrbuf, "</message>\n");
774 wrbuf_puts(c->wrbuf, "<addinfo>");
776 wrbuf_xmlputs(c->wrbuf, ht[i].addinfo);
777 wrbuf_puts(c->wrbuf, "</addinfo>\n");
780 wrbuf_printf(c->wrbuf, "<records>%d</records>\n", ht[i].records - ht[i].filtered);
782 wrbuf_printf(c->wrbuf, "<filtered>%d</filtered>\n", ht[i].filtered);
783 wrbuf_printf(c->wrbuf, "<approximation>" ODR_INT_PRINTF "</approximation>\n", ht[i].approximation);
785 wrbuf_puts(c->wrbuf, "<state>");
786 wrbuf_xmlputs(c->wrbuf, ht[i].state);
787 wrbuf_puts(c->wrbuf, "</state>\n");
788 if (settings && *settings == '1')
790 wrbuf_puts(c->wrbuf, "<settings>\n");
791 wrbuf_puts(c->wrbuf, ht[i].settings_xml);
792 wrbuf_puts(c->wrbuf, "</settings>\n");
794 if (ht[i].suggestions_xml && ht[i].suggestions_xml[0]) {
795 wrbuf_puts(c->wrbuf, "<suggestions>");
796 wrbuf_puts(c->wrbuf, ht[i].suggestions_xml);
797 wrbuf_puts(c->wrbuf, "</suggestions>");
799 wrbuf_puts(c->wrbuf, "</target>");
801 response_close(c, "bytarget");
804 static void bytarget_result_ready(void *data)
806 struct http_channel *c = (struct http_channel *) data;
807 struct http_session *s = locate_session(c);
808 const char *status_message = "OK";
811 session_log(s->psession, c->http_sessions->log_level,
812 "bytarget watch released");
813 bytarget_response(c, s, status_message);
814 release_session(c, s);
817 yaz_log(c->http_sessions->log_level,
818 "No Session found for released bytarget watch");
822 static void cmd_bytarget(struct http_channel *c)
824 struct http_request *rq = c->request;
825 struct http_response *rs = c->response;
826 struct http_session *s = locate_session(c);
827 const char *block = http_argbyname(rq, "block");
828 const char *report = http_argbyname(rq, "report");
829 int report_error = 0;
830 int report_status = 0;
831 const char *status_message = "OK";
834 if (report && !strcmp("error", report))
836 if (report && !strcmp("status", report))
842 no_active = session_active_clients(s->psession);
843 if (block && !strcmp("1", block) && no_active)
845 // if there is already a watch/block. we do not block this one
846 if (session_set_watch(s->psession, SESSION_WATCH_BYTARGET,
847 bytarget_result_ready, c, c) != 0)
849 session_log(s->psession, YLOG_WARN, "Attempt to block "
850 "multiple times on bytarget block. Not supported!");
853 error(rs, PAZPAR2_ALREADY_BLOCKED, "bytarget");
854 release_session(c, s);
857 else if (report_status)
858 status_message = "WARNING (Already blocked on bytarget)";
860 session_log(s->psession, YLOG_WARN, "Ignoring bytarget block."
861 " Return current result.");
866 session_log(s->psession, c->http_sessions->log_level,
867 "Blocking on command bytarget");
868 release_session(c, s);
872 bytarget_response(c, s, status_message);
873 release_session(c, s);
876 static void write_metadata(WRBUF w, struct conf_service *service,
877 struct record_metadata **ml, int full, int indent)
881 for (imeta = 0; imeta < service->num_metadata; imeta++)
883 struct conf_metadata *cmd = &service->metadata[imeta];
884 struct record_metadata *md;
885 if (!cmd->brief && !full)
887 for (md = ml[imeta]; md; md = md->next)
889 struct record_metadata_attr *attr = md->attributes;
891 for (i = 0; i < indent; i++)
893 wrbuf_printf(w, "<md-%s", cmd->name);
895 for (; attr; attr = attr->next)
897 wrbuf_printf(w, " %s=\"", attr->name);
898 wrbuf_xmlputs(w, attr->value);
904 case Metadata_type_generic:
905 wrbuf_xmlputs(w, md->data.text.disp);
907 case Metadata_type_year:
908 wrbuf_printf(w, "%d", md->data.number.min);
909 if (md->data.number.min != md->data.number.max)
910 wrbuf_printf(w, "-%d", md->data.number.max);
913 wrbuf_puts(w, "[can't represent]");
916 wrbuf_printf(w, "</md-%s>\n", cmd->name);
921 static void write_subrecord(struct record *r, WRBUF w,
922 struct conf_service *service, int show_details)
924 const char *name = session_setting_oneval(
925 client_get_database(r->client), PZ_NAME);
927 wrbuf_puts(w, " <location id=\"");
928 wrbuf_xmlputs(w, client_get_id(r->client));
929 wrbuf_puts(w, "\"\n");
931 wrbuf_puts(w, " name=\"");
932 wrbuf_xmlputs(w, *name ? name : "Unknown");
933 wrbuf_puts(w, "\" ");
935 wrbuf_puts(w, "checksum=\"");
936 wrbuf_printf(w, "%u", r->checksum);
937 wrbuf_puts(w, "\">\n");
939 write_metadata(w, service, r->metadata, show_details, 2);
940 wrbuf_puts(w, " </location>\n");
943 static void show_raw_record_error(void *data, const char *addinfo)
945 http_channel_observer_t obs = data;
946 struct http_channel *c = http_channel_observer_chan(obs);
947 struct http_response *rs = c->response;
949 http_remove_observer(obs);
951 error(rs, PAZPAR2_RECORD_FAIL, addinfo);
954 static void show_raw_record_ok(void *data, const char *buf, size_t sz)
956 http_channel_observer_t obs = data;
957 struct http_channel *c = http_channel_observer_chan(obs);
958 struct http_response *rs = c->response;
960 http_remove_observer(obs);
962 wrbuf_write(c->wrbuf, buf, sz);
963 rs->payload = nmem_strdup(c->nmem, wrbuf_cstr(c->wrbuf));
964 http_send_response(c);
968 static void show_raw_record_ok_binary(void *data, const char *buf, size_t sz)
970 http_channel_observer_t obs = data;
971 struct http_channel *c = http_channel_observer_chan(obs);
972 struct http_response *rs = c->response;
974 http_remove_observer(obs);
976 wrbuf_write(c->wrbuf, buf, sz);
977 rs->payload = nmem_strdup(c->nmem, wrbuf_cstr(c->wrbuf));
979 rs->content_type = "application/octet-stream";
980 http_send_response(c);
984 void show_raw_reset(void *data, struct http_channel *c, void *data2)
986 //struct client *client = data;
987 //client_show_raw_remove(client, data2);
990 static void cmd_record_ready(void *data);
992 static void show_record(struct http_channel *c, struct http_session *s)
994 struct http_response *rs = c->response;
995 struct http_request *rq = c->request;
996 struct record_cluster *rec, *prev_r, *next_r;
997 struct conf_service *service;
998 const char *idstr = http_argbyname(rq, "id");
999 const char *offsetstr = http_argbyname(rq, "offset");
1000 const char *binarystr = http_argbyname(rq, "binary");
1001 const char *checksumstr = http_argbyname(rq, "checksum");
1005 service = s->psession->service;
1008 error(rs, PAZPAR2_MISSING_PARAMETER, "id");
1011 wrbuf_rewind(c->wrbuf);
1012 if (!(rec = show_single_start(s->psession, idstr, &prev_r, &next_r)))
1014 if (session_active_clients(s->psession) == 0)
1016 error(rs, PAZPAR2_RECORD_MISSING, idstr);
1018 else if (session_set_watch(s->psession, SESSION_WATCH_RECORD,
1019 cmd_record_ready, c, c) != 0)
1021 error(rs, PAZPAR2_RECORD_MISSING, idstr);
1025 if (offsetstr || checksumstr)
1027 const char *syntax = http_argbyname(rq, "syntax");
1028 const char *esn = http_argbyname(rq, "esn");
1030 struct record*r = rec->records;
1032 const char *nativesyntax = http_argbyname(rq, "nativesyntax");
1034 if (binarystr && *binarystr != '0')
1039 unsigned v = strtoul(checksumstr, 0, 10);
1040 for (i = 0; r; r = r->next)
1041 if (v == r->checksum)
1044 error(rs, PAZPAR2_RECORD_FAIL, "no record");
1048 int offset = atoi(offsetstr);
1049 for (i = 0; i < offset && r; r = r->next, i++)
1052 error(rs, PAZPAR2_RECORD_FAIL, "no record at offset given");
1056 http_channel_observer_t obs =
1057 http_add_observer(c, r->client, show_raw_reset);
1058 int ret = client_show_raw_begin(r->client, r->position,
1061 show_raw_record_error,
1063 show_raw_record_ok_binary :
1064 show_raw_record_ok),
1069 http_remove_observer(obs);
1070 error(rs, PAZPAR2_NO_SESSION, 0);
1077 response_open_command(c, "record");
1078 wrbuf_puts(c->wrbuf, "\n <recid>");
1079 wrbuf_xmlputs(c->wrbuf, rec->recid);
1080 wrbuf_puts(c->wrbuf, "</recid>\n");
1083 wrbuf_puts(c->wrbuf, " <prevrecid>");
1084 wrbuf_xmlputs(c->wrbuf, prev_r->recid);
1085 wrbuf_puts(c->wrbuf, "</prevrecid>\n");
1089 wrbuf_puts(c->wrbuf, " <nextrecid>");
1090 wrbuf_xmlputs(c->wrbuf, next_r->recid);
1091 wrbuf_puts(c->wrbuf, "</nextrecid>\n");
1093 wrbuf_printf(c->wrbuf, " <activeclients>%d</activeclients>\n",
1094 session_active_clients(s->psession));
1095 write_metadata(c->wrbuf, service, rec->metadata, 1, 1);
1096 for (r = rec->records; r; r = r->next)
1097 write_subrecord(r, c->wrbuf, service, 2);
1098 response_close(c, "record");
1100 show_single_stop(s->psession, rec);
1103 static void cmd_record_ready(void *data)
1105 struct http_channel *c = (struct http_channel *) data;
1106 struct http_session *s = locate_session(c);
1109 session_log(s->psession, c->http_sessions->log_level,
1110 "record watch released");
1112 release_session(c,s);
1116 static void cmd_record(struct http_channel *c)
1118 struct http_session *s = locate_session(c);
1121 release_session(c,s);
1126 static void show_records(struct http_channel *c, struct http_session *s, int active)
1128 struct http_request *rq = c->request;
1129 struct http_response *rs = c->response;
1130 struct record_cluster **rl;
1131 struct reclist_sortparms *sp;
1132 const char *start = http_argbyname(rq, "start");
1133 const char *num = http_argbyname(rq, "num");
1134 const char *sort = http_argbyname(rq, "sort");
1135 int version = get_version(rq);
1141 Odr_int approx_hits;
1143 struct conf_service *service = 0;
1147 // We haven't counted clients yet if we're called on a block release
1149 active = session_active_clients(s->psession);
1152 startn = atoi(start);
1156 service = s->psession->service;
1158 sort = service->default_sort;
1160 if (!(sp = reclist_parse_sortparms(c->nmem, sort, service)))
1162 error(rs, PAZPAR2_MALFORMED_PARAMETER_VALUE, "sort");
1167 rl = show_range_start(s->psession, sp, startn, &numn, &total,
1168 &total_hits, &approx_hits, show_records_ready, c);
1172 response_open_ok(c, "show");
1173 wrbuf_printf(c->wrbuf, "\n<activeclients>%d</activeclients>\n", active);
1174 wrbuf_printf(c->wrbuf, "<merged>%d</merged>\n", total);
1175 wrbuf_printf(c->wrbuf, "<total>" ODR_INT_PRINTF "</total>\n", total_hits);
1177 wrbuf_printf(c->wrbuf, "<approximation>" ODR_INT_PRINTF "</approximation>\n", approx_hits);
1179 wrbuf_printf(c->wrbuf, "<start>%d</start>\n", startn);
1180 wrbuf_printf(c->wrbuf, "<num>%d</num>\n", numn);
1182 for (i = 0; i < numn; i++)
1186 struct record_cluster *rec = rl[i];
1187 struct conf_service *service = s->psession->service;
1189 wrbuf_puts(c->wrbuf, "<hit>\n");
1190 write_metadata(c->wrbuf, service, rec->metadata, 0, 1);
1191 for (ccount = 0, p = rl[i]->records; p; p = p->next, ccount++)
1192 write_subrecord(p, c->wrbuf, service, 0); // subrecs w/o details
1193 wrbuf_printf(c->wrbuf, " <count>%d</count>\n", ccount);
1194 if (strstr(sort, "relevance"))
1196 wrbuf_printf(c->wrbuf, " <relevance>%d</relevance>\n",
1197 rec->relevance_score);
1198 if (service->rank_debug)
1200 wrbuf_printf(c->wrbuf, " <relevance_info>\n");
1201 wrbuf_xmlputs(c->wrbuf, wrbuf_cstr(rec->relevance_explain1));
1202 wrbuf_xmlputs(c->wrbuf, wrbuf_cstr(rec->relevance_explain2));
1203 wrbuf_printf(c->wrbuf, " </relevance_info>\n");
1206 wrbuf_puts(c->wrbuf, " <recid>");
1207 wrbuf_xmlputs(c->wrbuf, rec->recid);
1208 wrbuf_puts(c->wrbuf, "</recid>\n");
1209 wrbuf_puts(c->wrbuf, "</hit>\n");
1212 show_range_stop(s->psession, rl);
1214 response_close(c, "show");
1217 static void show_records_ready(void *data)
1219 struct http_channel *c = (struct http_channel *) data;
1220 struct http_session *s = locate_session(c);
1223 session_log(s->psession, c->http_sessions->log_level,
1224 "show watch released");
1225 show_records(c, s, -1);
1228 /* some error message */
1230 release_session(c,s);
1233 static void cmd_show(struct http_channel *c)
1235 struct http_request *rq = c->request;
1236 struct http_response *rs = c->response;
1237 struct http_session *s = locate_session(c);
1238 const char *block = http_argbyname(rq, "block");
1239 const char *sort = http_argbyname(rq, "sort");
1240 const char *block_error = http_argbyname(rq, "report");
1241 const char *mergekey = http_argbyname(rq, "mergekey");
1242 const char *rank = http_argbyname(rq, "rank");
1243 struct conf_service *service = 0;
1245 struct reclist_sortparms *sp;
1247 int report_error = 0;
1248 if (block_error && !strcmp("1", block_error)) {
1254 service = s->psession->service;
1256 sort = service->default_sort;
1259 if (!(sp = reclist_parse_sortparms(c->nmem, sort, service)))
1261 error(c->response, PAZPAR2_MALFORMED_PARAMETER_VALUE, "sort");
1262 release_session(c, s);
1265 session_sort(s->psession, sp, mergekey, rank);
1267 status = session_active_clients(s->psession);
1271 if (!strcmp(block, "preferred") && !session_is_preferred_clients_ready(s->psession) && reclist_get_num_records(s->psession->reclist) == 0)
1273 // if there is already a watch/block. we do not block this one
1274 if (session_set_watch(s->psession, SESSION_WATCH_SHOW_PREF,
1275 show_records_ready, c, c) == 0)
1277 session_log(s->psession, c->http_sessions->log_level,
1278 "Blocking on command show (preferred targets)");
1279 release_session(c, s);
1284 session_log(s->psession, YLOG_WARN, "Attempt to block"
1285 " multiple times on show (preferred targets) block."
1289 error(rs, PAZPAR2_ALREADY_BLOCKED,
1290 "show (preferred targets)");
1291 release_session(c, s);
1295 session_log(s->psession, YLOG_WARN,
1296 "Ignoring show(preferred) block."
1297 " Returning current result");
1303 // if there is already a watch/block. we do not block this one
1304 if (session_set_watch(s->psession, SESSION_WATCH_SHOW,
1305 show_records_ready, c, c) != 0)
1307 session_log(s->psession, YLOG_WARN, "Attempt to block"
1308 " multiple times on show block. Not supported!");
1311 error(rs, PAZPAR2_ALREADY_BLOCKED, "show");
1312 release_session(c, s);
1316 session_log(s->psession, YLOG_WARN, "Ignoring show block."
1317 " Returning current result");
1321 session_log(s->psession, c->http_sessions->log_level,
1322 "Blocking on command show");
1323 release_session(c, s);
1328 show_records(c, s, status);
1329 release_session(c, s);
1332 static void cmd_ping(struct http_channel *c)
1334 struct http_session *s = locate_session(c);
1337 response_open_ok(c, "ping");
1338 response_close(c, "ping");
1339 release_session(c, s);
1342 static void cmd_search(struct http_channel *c)
1344 struct http_request *rq = c->request;
1345 struct http_response *rs = c->response;
1346 struct http_session *s = locate_session(c);
1347 const char *query = http_argbyname(rq, "query");
1348 const char *filter = http_argbyname(rq, "filter");
1349 const char *maxrecs = http_argbyname(rq, "maxrecs");
1350 const char *startrecs = http_argbyname(rq, "startrecs");
1351 const char *limit = http_argbyname(rq, "limit");
1352 const char *sort = http_argbyname(rq, "sort");
1353 const char *mergekey = http_argbyname(rq, "mergekey");
1354 const char *rank = http_argbyname(rq, "rank");
1355 enum pazpar2_error_code code;
1356 const char *addinfo = 0;
1357 struct reclist_sortparms *sp;
1358 struct conf_service *service = 0;
1365 error(rs, PAZPAR2_MISSING_PARAMETER, "query");
1366 release_session(c, s);
1369 if (!yaz_utf8_check(query))
1371 error(rs, PAZPAR2_MALFORMED_PARAMETER_ENCODING, "query");
1372 release_session(c, s);
1375 service = s->psession->service;
1377 sort = service->default_sort;
1379 if (!(sp = reclist_parse_sortparms(c->nmem, sort, s->psession->service)))
1381 error(c->response, PAZPAR2_MALFORMED_PARAMETER_VALUE, "sort");
1382 release_session(c, s);
1386 code = session_search(s->psession, query, startrecs, maxrecs, filter, limit,
1387 &addinfo, sp, mergekey, rank);
1390 error(rs, code, addinfo);
1391 release_session(c, s);
1394 response_open_ok(c, "search");
1395 response_close(c, "search");
1396 release_session(c, s);
1400 static void cmd_stat(struct http_channel *c)
1402 struct http_session *s = locate_session(c);
1403 struct statistics stat;
1411 clients = session_active_clients(s->psession);
1412 statistics(s->psession, &stat);
1414 if (stat.num_clients > 0)
1416 progress = (stat.num_clients - clients) / (float)stat.num_clients;
1419 response_open_command(c, "stat");
1420 wrbuf_printf(c->wrbuf, "\n <activeclients>%d</activeclients>\n", clients);
1421 wrbuf_printf(c->wrbuf, " <hits>" ODR_INT_PRINTF "</hits>\n", stat.num_hits);
1422 wrbuf_printf(c->wrbuf, " <records>%d</records>\n", stat.num_records);
1423 wrbuf_printf(c->wrbuf, " <clients>%d</clients>\n", stat.num_clients);
1424 wrbuf_printf(c->wrbuf, " <unconnected>%d</unconnected>\n", stat.num_no_connection);
1425 wrbuf_printf(c->wrbuf, " <connecting>%d</connecting>\n", stat.num_connecting);
1426 wrbuf_printf(c->wrbuf, " <working>%d</working>\n", stat.num_working);
1427 wrbuf_printf(c->wrbuf, " <idle>%d</idle>\n", stat.num_idle);
1428 wrbuf_printf(c->wrbuf, " <failed>%d</failed>\n", stat.num_failed);
1429 wrbuf_printf(c->wrbuf, " <error>%d</error>\n", stat.num_error);
1430 wrbuf_printf(c->wrbuf, " <progress>%.2f</progress>\n", progress);
1431 response_close(c, "stat");
1432 release_session(c, s);
1435 static void cmd_info(struct http_channel *c)
1437 char yaz_version_str[20];
1438 char yaz_sha1_str[42];
1440 response_open_command(c, "info");
1441 wrbuf_puts(c->wrbuf, "\n <version>\n");
1442 wrbuf_puts(c->wrbuf, " <pazpar2");
1443 #ifdef PAZPAR2_VERSION_SHA1
1444 wrbuf_printf(c->wrbuf, " sha1=\"%s\"", PAZPAR2_VERSION_SHA1);
1446 wrbuf_puts(c->wrbuf, ">");
1447 wrbuf_xmlputs(c->wrbuf, VERSION);
1448 wrbuf_puts(c->wrbuf, "</pazpar2>\n");
1450 yaz_version(yaz_version_str, yaz_sha1_str);
1451 wrbuf_puts(c->wrbuf, " <yaz compiled=\"");
1452 wrbuf_xmlputs(c->wrbuf, YAZ_VERSION);
1453 wrbuf_puts(c->wrbuf, "\" sha1=\"");
1454 wrbuf_xmlputs(c->wrbuf, yaz_sha1_str);
1455 wrbuf_puts(c->wrbuf, "\">");
1456 wrbuf_xmlputs(c->wrbuf, yaz_version_str);
1457 wrbuf_puts(c->wrbuf, "</yaz>\n");
1459 wrbuf_puts(c->wrbuf, " </version>\n");
1462 char hostname_str[64];
1463 if (gethostname(hostname_str, sizeof(hostname_str)) == 0)
1465 wrbuf_puts(c->wrbuf, " <host>");
1466 wrbuf_xmlputs(c->wrbuf, hostname_str);
1467 wrbuf_puts(c->wrbuf, "</host>\n");
1471 info_services(c->server, c->wrbuf);
1473 response_close(c, "info");
1478 void (*fun)(struct http_channel *c);
1480 { "init", cmd_init },
1481 { "settings", cmd_settings },
1482 { "stat", cmd_stat },
1483 { "bytarget", cmd_bytarget },
1484 { "show", cmd_show },
1485 { "search", cmd_search },
1486 { "termlist", cmd_termlist },
1487 { "exit", cmd_exit },
1488 { "session-status", cmd_session_status },
1489 { "server-status", cmd_server_status },
1490 { "service", cmd_service },
1491 { "ping", cmd_ping },
1492 { "record", cmd_record },
1493 { "info", cmd_info },
1497 void http_command(struct http_channel *c)
1499 const char *command = http_argbyname(c->request, "command");
1500 struct http_response *rs = http_create_response(c);
1505 http_addheader(rs, "Expires", "Thu, 19 Nov 1981 08:52:00 GMT");
1506 http_addheader(rs, "Cache-Control", "no-store, no-cache, must-revalidate, post-check=0, pre-check=0");
1510 error(rs, PAZPAR2_MISSING_PARAMETER, "command");
1513 for (i = 0; commands[i].name; i++)
1514 if (!strcmp(commands[i].name, command))
1516 (*commands[i].fun)(c);
1519 if (!commands[i].name)
1520 error(rs, PAZPAR2_MALFORMED_PARAMETER_VALUE, "command");
1528 * c-file-style: "Stroustrup"
1529 * indent-tabs-mode: nil
1531 * vim: shiftwidth=4 tabstop=8 expandtab