2 * Copyright (c) 1995-2001, Index Data
3 * See the file LICENSE for details.
6 * Revision 1.115 2001-03-13 18:10:58 adam
7 * Added option -c to set CCL config file.
9 * Revision 1.114 2001/02/21 13:46:53 adam
12 * Revision 1.113 2001/02/21 09:41:15 adam
13 * Fixed problem with old codecs.
15 * Revision 1.112 2001/02/20 11:25:32 adam
16 * Added ill_get_APDU and ill_get_Cancel.
18 * Revision 1.111 2001/01/30 15:52:48 ja7
19 * added command for setting packageName in ES packages!
20 * command is named packagename default is NULL for server suplyed package name
22 * Revision 1.110 2001/01/29 11:19:05 adam
23 * Clients prints options in InitResponse.
25 * Revision 1.109 2001/01/22 10:41:47 adam
26 * Multiple attribute may be specified for sorging.
28 * Revision 1.108 2000/11/23 10:58:32 adam
29 * SSL comstack support. Separate POSIX thread support library.
31 * Revision 1.107 2000/11/16 13:11:07 adam
32 * Changed because ccl_rpn_query sets attribute set.
34 * Revision 1.106 2000/11/13 09:44:59 adam
35 * Work on SCAN: RPN2CCL conversion and proper "next" scan.
37 * Revision 1.105 2000/10/02 11:07:44 adam
38 * Added peer_name member for bend_init handler. Changed the YAZ
39 * client so that tcp: can be avoided in target spec.
41 * Revision 1.104 2000/09/04 08:58:15 adam
42 * Added prefix yaz_ for most logging utility functions.
44 * Revision 1.103 2000/08/10 08:41:26 adam
47 * Revision 1.102 2000/05/18 11:57:04 adam
48 * Client display time elapsed.
50 * Revision 1.101 2000/04/05 07:39:54 adam
51 * Added shared library support (libtool).
53 * Revision 1.100 2000/03/20 19:29:59 adam
56 * Revision 1.99 2000/03/20 19:06:25 adam
57 * Added Segment request for fronend server. Work on admin for client.
59 * Revision 1.98 2000/03/16 13:55:49 ian
60 * Added commands for sending shutdown and startup admin requests via the admin ES.
62 * Revision 1.97 2000/03/14 14:06:04 ian
63 * Minor change to order of debugging output for send_apdu,
64 * fixed encoding of admin request.
66 * Revision 1.96 2000/03/14 09:27:07 ian
67 * Added code to enable sending of admin extended service requests
69 * Revision 1.95 2000/02/28 11:20:05 adam
70 * Using autoconf. New definitions: YAZ_BEGIN_CDECL/YAZ_END_CDECL.
72 * Revision 1.94 2000/01/31 13:15:21 adam
73 * Removed uses of assert(3). Cleanup of ODR. CCL parser update so
74 * that some characters are not surrounded by spaces in resulting term.
77 * Revision 1.93 2000/01/15 09:39:50 adam
78 * Implemented ill_get_ILLRequest. More ILL testing for client.
80 * Revision 1.92 1999/12/21 16:24:48 adam
81 * More robust ISO2709 handling (in case of real bad formats).
83 * Revision 1.91 1999/12/16 23:36:19 adam
84 * Implemented ILL protocol. Minor updates ASN.1 compiler.
86 * Revision 1.90 1999/11/30 13:47:11 adam
87 * Improved installation. Moved header files to include/yaz.
89 * Revision 1.89 1999/11/04 14:58:44 adam
90 * Added status elements for backend delete result set handler.
91 * Updated delete result result set command for client.
93 * Revision 1.88 1999/10/11 10:00:29 adam
94 * Modified printing of records.
96 * Revision 1.87 1999/08/27 09:40:32 adam
97 * Renamed logf function to yaz_log. Removed VC++ project files.
99 * Revision 1.86 1999/07/06 12:13:35 adam
100 * Added "schema" command.
102 * Revision 1.85 1999/06/16 11:55:24 adam
103 * Added APDU log to client.
105 * Revision 1.84 1999/06/01 14:29:11 adam
106 * Work on Extended Services.
108 * Revision 1.83 1999/05/26 15:24:26 adam
109 * Fixed minor bugs regarding DB Update (introduced by previous commit).
111 * Revision 1.82 1999/05/26 13:49:12 adam
112 * DB Update implemented in client (very basic).
114 * Revision 1.81 1999/04/20 09:56:48 adam
115 * Added 'name' paramter to encoder/decoder routines (typedef Odr_fun).
116 * Modified all encoders/decoders to reflect this change.
118 * Revision 1.80 1999/03/31 11:18:24 adam
119 * Implemented odr_strdup. Added Reference ID to backend server API.
121 * Revision 1.79 1999/03/23 14:14:25 adam
124 * Revision 1.78 1999/03/18 12:57:18 adam
127 * Revision 1.77 1999/03/11 15:26:51 adam
128 * Fixed bug (introduced by previous commit).
130 * Revision 1.76 1999/03/11 11:12:07 adam
131 * Added GNU readline support. HTML display in client.
133 * Revision 1.75 1999/02/01 15:37:32 adam
134 * Fixed minor bug introduced by previous commit.
136 * Revision 1.74 1999/02/01 15:35:21 adam
139 * Revision 1.73 1998/10/20 13:55:43 quinn
140 * Fixed Scan bug in asn and client
142 * Revision 1.72 1998/10/20 13:23:15 quinn
143 * changed preferred pos to 1
145 * Revision 1.71 1998/10/20 13:21:43 adam
146 * Fixed scan response handler.
148 * Revision 1.70 1998/09/22 09:40:37 adam
149 * Minor changes in sort spec.
151 * Revision 1.69 1998/08/19 16:10:06 adam
152 * Changed som member names of DeleteResultSetRequest/Response.
154 * Revision 1.68 1998/07/20 12:37:06 adam
155 * Added 'delete <resultset>' command. Changed open command so that
156 * it reconnects if already connected.
158 * Revision 1.67 1998/06/09 13:55:06 adam
161 * Revision 1.66 1998/05/18 13:06:53 adam
162 * Changed the way attribute sets are handled by the retriaval module.
163 * Extended Explain conversion / schema.
164 * Modified server and client to work with ASN.1 compiled protocol handlers.
166 * Revision 1.65 1998/03/31 15:13:19 adam
167 * Development towards compiled ASN.1.
169 * Revision 1.64 1998/03/31 11:07:44 adam
170 * Furhter work on UNIverse resource report.
171 * Added Extended Services handling in frontend server.
173 * Revision 1.63 1998/03/05 08:05:10 adam
174 * Added a few casts to make C++ happy.
176 * Revision 1.62 1998/02/11 11:53:33 adam
177 * Changed code so that it compiles as C++.
179 * Revision 1.61 1998/02/10 11:03:06 adam
180 * Implemented command refid. Client prints reference-ID's, when present,
183 * Revision 1.60 1998/01/29 14:08:52 adam
184 * Better sort diagnostics.
186 * Revision 1.59 1998/01/29 13:17:56 adam
189 * Revision 1.58 1998/01/07 13:51:45 adam
192 * Revision 1.57 1998/01/07 12:58:22 adam
193 * Using fgets instead of gets.
195 * Revision 1.56 1997/11/05 09:18:31 adam
196 * The client handles records with no associated syntax.
198 * Revision 1.55 1997/10/31 12:20:08 adam
199 * Improved memory debugging for xmalloc/nmem.c. References to NMEM
200 * instead of ODR in n ESPEC-1 handling in source d1_espec.c.
201 * Bug fix: missing fclose in data1_read_espec1.
203 * Revision 1.54 1997/10/27 13:52:46 adam
204 * Header yaz-util includes all YAZ utility header files.
206 * Revision 1.53 1997/09/29 13:18:59 adam
207 * Added function, oid_ent_to_oid, to replace the function
208 * oid_getoidbyent, which is not thread safe.
210 * Revision 1.52 1997/09/29 07:20:31 adam
211 * Client code uses nmem_init.
213 * Revision 1.51 1997/09/26 09:41:55 adam
214 * Updated client to handle multiple diagnostics.
216 * Revision 1.50 1997/09/17 12:10:29 adam
219 * Revision 1.49 1997/09/04 13:45:17 adam
220 * Added UNImarc to list of available syntaxes.
222 * Revision 1.48 1997/09/01 08:48:44 adam
223 * New windows NT/95 port using MSV5.0. Only a few changes made
224 * to avoid warnings. Sub project created: client.dsp.
226 * Revision 1.47 1997/07/01 13:49:56 adam
227 * Take care of case when invalid target is specified on command line.
229 * Revision 1.46 1997/06/23 10:30:18 adam
230 * Added call to ccl_rpn_delete in search. Added ODR stream "out"
231 * as parameter to ccl_rpn_query to release RPN query.
233 * Revision 1.45 1997/05/14 06:53:29 adam
236 * Revision 1.44 1997/05/05 11:20:35 adam
237 * Client uses "options" utility and marc dump filename may be specified
238 * as an option (-m <file>).
240 * Revision 1.43 1996/11/08 11:03:26 adam
241 * Client accepts multiple database names.
243 * Revision 1.42 1996/10/08 10:44:57 quinn
244 * Resolved conflicts.
246 * Revision 1.41 1996/10/07 15:29:03 quinn
249 * Revision 1.40 1996/08/29 14:19:34 quinn
250 * Fixed conflict (CVS)
252 * Revision 1.39 1996/08/27 10:43:22 quinn
253 * Made select() optional
255 * Revision 1.38 1996/08/12 14:09:11 adam
256 * Default prefix query attribute set defined by using p_query_attset.
258 * Revision 1.37 1996/07/06 19:58:29 quinn
259 * System headerfiles gathered in yconfig
261 * Revision 1.36 1996/06/10 08:53:47 quinn
264 * Revision 1.35 1996/06/03 09:45:50 quinn
265 * Added display of OIDs in the GRS routine.
267 * Revision 1.34 1996/05/09 07:26:49 quinn
268 * *** empty log message ***
270 * Revision 1.33 1996/05/09 07:25:22 quinn
273 * Revision 1.32 1996/03/15 11:05:33 adam
274 * The user can set the preferred query type (prefix, ccl, ..) with the
277 * Revision 1.31 1996/02/20 12:51:54 quinn
278 * Fixed problems with EXTERNAL.
280 * Revision 1.30 1996/02/12 18:18:09 quinn
283 * Revision 1.29 1996/01/02 08:57:25 quinn
284 * Changed enums in the ASN.1 .h files to #defines. Changed oident.class to oclass
286 * Revision 1.28 1995/12/14 11:09:31 quinn
287 * Added Explain record syntax to the format command.
289 * Revision 1.27 1995/12/12 16:37:02 quinn
290 * Added destroy element to data1_node.
292 * Revision 1.26 1995/12/12 14:11:00 quinn
295 * Revision 1.25 1995/11/13 09:27:22 quinn
296 * Fiddling with the variant stuff.
298 * Revision 1.24 1995/10/30 12:41:13 quinn
299 * Added hostname lookup for server.
301 * Revision 1.23 1995/10/18 16:12:30 quinn
302 * Better diagnostics.
304 * Revision 1.22 1995/10/11 14:49:12 quinn
307 * Revision 1.21 1995/09/29 17:01:47 quinn
310 * Revision 1.20 1995/08/29 14:24:13 quinn
311 * Added second half of close-handshake
313 * Revision 1.19 1995/08/29 11:17:28 quinn
314 * Added code to receive close
316 * Revision 1.18 1995/08/28 12:21:27 quinn
317 * Client can now ask for simple element set names.
319 * Revision 1.17 1995/08/17 12:45:02 quinn
320 * Fixed minor problems with GRS-1. Added support in c&s.
322 * Revision 1.16 1995/08/15 12:00:04 quinn
325 * Revision 1.15 1995/06/22 09:28:03 quinn
326 * Fixed bug in SUTRS processing.
328 * Revision 1.14 1995/06/19 12:37:41 quinn
331 * Revision 1.13 1995/06/16 10:29:11 quinn
332 * *** empty log message ***
334 * Revision 1.12 1995/06/15 07:44:57 quinn
337 * Revision 1.11 1995/06/14 15:26:40 quinn
338 * *** empty log message ***
340 * Revision 1.10 1995/06/06 14:56:58 quinn
341 * Better diagnostics.
343 * Revision 1.9 1995/06/06 08:15:19 quinn
346 * Revision 1.8 1995/06/05 10:52:22 quinn
349 * Revision 1.7 1995/06/02 09:50:09 quinn
352 * Revision 1.6 1995/05/31 08:29:21 quinn
353 * Nothing significant.
355 * Revision 1.5 1995/05/29 08:10:47 quinn
356 * Moved oid.c to util.
358 * Revision 1.4 1995/05/22 15:30:13 adam
359 * Client uses prefix query notation.
361 * Revision 1.3 1995/05/22 15:06:53 quinn
362 * *** empty log message ***
364 * Revision 1.2 1995/05/22 14:56:40 quinn
365 * *** empty log message ***
367 * Revision 1.1 1995/05/22 11:30:31 quinn
368 * Added prettier client.
374 * This is the obligatory little toy client, whose primary purpose is
375 * to illustrate the use of the YAZ service-level API.
382 #include <yaz/yaz-util.h>
384 #include <yaz/tcpip.h>
386 #include <yaz/xmosi.h>
389 #include <yaz/proto.h>
390 #include <yaz/marcdisp.h>
391 #include <yaz/diagbib1.h>
393 #include <yaz/pquery.h>
400 #include <yaz/yaz-ccl.h>
403 #if HAVE_READLINE_READLINE_H
404 #include <readline/readline.h>
406 #if HAVE_READLINE_HISTORY_H
407 #include <readline/history.h>
412 #define C_PROMPT "Z> "
414 static ODR out, in, print; /* encoding and decoding streams */
415 static FILE *apdu_file = 0;
416 static COMSTACK conn = 0; /* our z-association */
417 static Z_IdAuthentication *auth = 0; /* our current auth definition */
418 char *databaseNames[128];
419 int num_databaseNames = 0;
420 static Z_External *record_last = 0;
421 static int setnumber = 0; /* current result set number */
422 static int smallSetUpperBound = 0;
423 static int largeSetLowerBound = 1;
424 static int mediumSetPresentNumber = 0;
425 static Z_ElementSetNames *elementSetNames = 0;
426 static int setno = 1; /* current set offset */
427 static enum oid_proto protocol = PROTO_Z3950; /* current app protocol */
428 static enum oid_value recordsyntax = VAL_USMARC;
429 static enum oid_value schema = VAL_NONE;
430 static int sent_close = 0;
431 static NMEM session_mem = NULL; /* memory handle for init-response */
432 static Z_InitResponse *session = 0; /* session parameters */
433 static char last_scan_line[512] = "0";
434 static char last_scan_query[512] = "0";
435 static char ccl_fields[512] = "default.bib";
436 char* esPackageName = 0;
438 static char last_cmd[100] = "?";
439 static FILE *marcdump = 0;
440 static char *refid = NULL;
448 static QueryType queryType = QueryType_Prefix;
451 static CCL_bibset bibset; /* CCL bibset handle */
454 ODR getODROutputStream()
459 void send_apdu(Z_APDU *a)
466 z_APDU(print, &a, 0, 0);
469 if (!z_APDU(out, &a, 0, 0))
471 odr_perror(out, "Encoding APDU");
474 buf = odr_getbuf(out, &len, 0);
475 /* printf ("sending APDU of size %d\n", len); */
476 if (cs_put(conn, buf, len) < 0)
478 fprintf(stderr, "cs_put: %s", cs_errmsg(cs_errno(conn)));
481 odr_reset(out); /* release the APDU structure */
484 static void print_refid (Z_ReferenceId *id)
488 printf ("ReferenceId: '%.*s'\n", id->len, id->buf);
492 static Z_ReferenceId *set_refid (ODR out)
497 id = (Z_ReferenceId *) odr_malloc (out, sizeof(*id));
498 id->size = id->len = strlen(refid);
499 id->buf = (unsigned char *) odr_malloc (out, id->len);
500 memcpy (id->buf, refid, id->len);
504 /* INIT SERVICE ------------------------------- */
506 static void send_initRequest()
508 Z_APDU *apdu = zget_APDU(out, Z_APDU_initRequest);
509 Z_InitRequest *req = apdu->u.initRequest;
511 ODR_MASK_SET(req->options, Z_Options_search);
512 ODR_MASK_SET(req->options, Z_Options_present);
513 ODR_MASK_SET(req->options, Z_Options_namedResultSets);
514 ODR_MASK_SET(req->options, Z_Options_triggerResourceCtrl);
515 ODR_MASK_SET(req->options, Z_Options_scan);
516 ODR_MASK_SET(req->options, Z_Options_sort);
517 ODR_MASK_SET(req->options, Z_Options_extendedServices);
518 ODR_MASK_SET(req->options, Z_Options_delSet);
520 ODR_MASK_SET(req->protocolVersion, Z_ProtocolVersion_1);
521 ODR_MASK_SET(req->protocolVersion, Z_ProtocolVersion_2);
522 ODR_MASK_SET(req->protocolVersion, Z_ProtocolVersion_3);
524 *req->maximumRecordSize = 1024*1024;
525 *req->preferredMessageSize = 1024*1024;
527 req->idAuthentication = auth;
530 printf("Sent initrequest.\n");
533 static int process_initResponse(Z_InitResponse *res)
535 /* save session parameters for later use */
536 session_mem = odr_extract_mem(in);
540 printf("Connection rejected by target.\n");
542 printf("Connection accepted by target.\n");
543 if (res->implementationId)
544 printf("ID : %s\n", res->implementationId);
545 if (res->implementationName)
546 printf("Name : %s\n", res->implementationName);
547 if (res->implementationVersion)
548 printf("Version: %s\n", res->implementationVersion);
549 if (res->userInformationField)
551 printf("UserInformationfield:\n");
552 if (!z_External(print, (Z_External**)&res-> userInformationField,
555 odr_perror(print, "Printing userinfo\n");
558 if (res->userInformationField->which == Z_External_octet)
560 printf("Guessing visiblestring:\n");
561 printf("'%s'\n", res->userInformationField->u. octet_aligned->buf);
566 if (ODR_MASK_GET(res->options, Z_Options_search))
568 if (ODR_MASK_GET(res->options, Z_Options_present))
570 if (ODR_MASK_GET(res->options, Z_Options_delSet))
572 if (ODR_MASK_GET(res->options, Z_Options_resourceReport))
573 printf (" resourceReport");
574 if (ODR_MASK_GET(res->options, Z_Options_resourceCtrl))
575 printf (" resourceCtrl");
576 if (ODR_MASK_GET(res->options, Z_Options_accessCtrl))
577 printf (" accessCtrl");
578 if (ODR_MASK_GET(res->options, Z_Options_scan))
580 if (ODR_MASK_GET(res->options, Z_Options_sort))
582 if (ODR_MASK_GET(res->options, Z_Options_extendedServices))
583 printf (" extendedServices");
584 if (ODR_MASK_GET(res->options, Z_Options_level_1Segmentation))
585 printf (" level1Segmentation");
586 if (ODR_MASK_GET(res->options, Z_Options_level_2Segmentation))
587 printf (" level2Segmentation");
588 if (ODR_MASK_GET(res->options, Z_Options_concurrentOperations))
589 printf (" concurrentOperations");
590 if (ODR_MASK_GET(res->options, Z_Options_namedResultSets))
591 printf (" namedResultSets");
597 static int cmd_base(char *arg)
604 printf("Usage: base <database> <database> ...\n");
607 for (i = 0; i<num_databaseNames; i++)
608 xfree (databaseNames[i]);
609 num_databaseNames = 0;
612 if (!(cp = strchr(arg, ' ')))
613 cp = arg + strlen(arg);
616 databaseNames[num_databaseNames] = (char *)xmalloc (1 + cp - arg);
617 memcpy (databaseNames[num_databaseNames], arg, cp - arg);
618 databaseNames[num_databaseNames++][cp - arg] = '\0';
627 int cmd_open(char *arg)
630 char type_and_host[101], base[101];
636 printf("Already connected.\n");
642 nmem_destroy (session_mem);
648 if (sscanf (arg, "%100[^/]/%100s", type_and_host, base) < 1)
650 if (strncmp (type_and_host, "tcp:", 4) == 0)
651 host = type_and_host + 4;
652 else if (strncmp (type_and_host, "ssl:", 4) == 0)
654 #if HAVE_OPENSSL_SSL_H
657 printf ("SSL not supported\n");
659 host = type_and_host + 4;
662 host = type_and_host;
665 protocol = PROTO_Z3950;
667 if (!(conn = cs_create(t, 1, protocol)))
672 if (!(add = cs_straddr(conn, host)))
677 printf("Connecting...");
679 if (cs_connect(conn, add) < 0)
691 int cmd_authentication(char *arg)
693 static Z_IdAuthentication au;
694 static char open[256];
698 printf("Auth field set to null\n");
703 au.which = Z_IdAuthentication_open;
709 /* SEARCH SERVICE ------------------------------ */
711 static void display_variant(Z_Variant *v, int level)
715 for (i = 0; i < v->num_triples; i++)
717 printf("%*sclass=%d,type=%d", level * 4, "", *v->triples[i]->zclass,
718 *v->triples[i]->type);
719 if (v->triples[i]->which == Z_Triple_internationalString)
720 printf(",value=%s\n", v->triples[i]->value.internationalString);
726 static void display_grs1(Z_GenericRecord *r, int level)
732 for (i = 0; i < r->num_elements; i++)
736 printf("%*s", level * 4, "");
740 printf("%d,", *t->tagType);
743 if (t->tagValue->which == Z_StringOrNumeric_numeric)
744 printf("%d) ", *t->tagValue->u.numeric);
746 printf("%s) ", t->tagValue->u.string);
747 if (t->content->which == Z_ElementData_subtree)
750 display_grs1(t->content->u.subtree, level+1);
752 else if (t->content->which == Z_ElementData_string)
753 printf("%s\n", t->content->u.string);
754 else if (t->content->which == Z_ElementData_numeric)
755 printf("%d\n", *t->content->u.numeric);
756 else if (t->content->which == Z_ElementData_oid)
758 int *ip = t->content->u.oid;
761 if ((oent = oid_getentbyoid(t->content->u.oid)))
762 printf("OID: %s\n", oent->desc);
766 while (ip && *ip >= 0)
767 printf(" %d", *(ip++));
771 else if (t->content->which == Z_ElementData_noDataRequested)
772 printf("[No data requested]\n");
773 else if (t->content->which == Z_ElementData_elementEmpty)
774 printf("[Element empty]\n");
775 else if (t->content->which == Z_ElementData_elementNotThere)
776 printf("[Element not there]\n");
779 if (t->appliedVariant)
780 display_variant(t->appliedVariant, level+1);
781 if (t->metaData && t->metaData->supportedVariants)
785 printf("%*s---- variant list\n", (level+1)*4, "");
786 for (c = 0; c < t->metaData->num_supportedVariants; c++)
788 printf("%*svariant #%d\n", (level+1)*4, "", c);
789 display_variant(t->metaData->supportedVariants[c], level + 2);
795 static void print_record(const unsigned char *buf, size_t len)
798 for (i = 0; i<len; i++)
799 if ((buf[i] <= 126 && buf[i] >= 32) || strchr ("\n\r\t\f", buf[i]))
800 fputc (buf[i], stdout);
802 printf ("\\X%02X", buf[i]);
803 /* add newline if not already added ... */
804 if (i <= 0 || buf[i-1] != '\n')
805 fputc ('\n', stdout);
808 static void display_record(Z_DatabaseRecord *p)
810 Z_External *r = (Z_External*) p;
811 oident *ent = oid_getentbyoid(r->direct_reference);
815 * Tell the user what we got.
817 if (r->direct_reference)
819 printf("Record type: ");
821 printf("%s\n", ent->desc);
822 else if (!odr_oid(print, &r->direct_reference, 0, 0))
824 odr_perror(print, "print oid");
828 /* Check if this is a known, ASN.1 type tucked away in an octet string */
829 if (ent && r->which == Z_External_octet)
831 Z_ext_typeent *type = z_ext_getentbyref(ent->value);
837 * Call the given decoder to process the record.
839 odr_setbuf(in, (char*)p->u.octet_aligned->buf,
840 p->u.octet_aligned->len, 0);
841 if (!(*type->fun)(in, (char **)&rr, 0, 0))
843 odr_perror(in, "Decoding constructed record.");
844 fprintf(stderr, "[Near %d]\n", odr_offset(in));
845 fprintf(stderr, "Packet dump:\n---------\n");
846 odr_dumpBER(stderr, (char*)p->u.octet_aligned->buf,
847 p->u.octet_aligned->len);
848 fprintf(stderr, "---------\n");
852 * Note: we throw away the original, BER-encoded record here.
853 * Do something else with it if you want to keep it.
855 r->u.sutrs = (Z_SUTRS *) rr; /* we don't actually check the type here. */
856 r->which = type->what;
859 if (ent && ent->value == VAL_SOIF)
860 print_record((const unsigned char *) r->u.octet_aligned->buf, r->u.octet_aligned->len);
861 else if (r->which == Z_External_octet && p->u.octet_aligned->len)
863 const char *octet_buf = (char*)p->u.octet_aligned->buf;
864 if (ent->value == VAL_TEXT_XML || ent->value == VAL_APPLICATION_XML ||
865 ent->value == VAL_HTML)
866 print_record((const unsigned char *) octet_buf,
867 p->u.octet_aligned->len);
870 if (marc_display (octet_buf, NULL) <= 0)
872 printf ("ISO2709 decoding failed, dumping record as is:\n");
873 print_record((const unsigned char*) octet_buf,
874 p->u.octet_aligned->len);
878 fwrite (octet_buf, 1, p->u.octet_aligned->len, marcdump);
880 else if (ent && ent->value == VAL_SUTRS)
882 if (r->which != Z_External_sutrs)
884 printf("Expecting single SUTRS type for SUTRS.\n");
887 print_record(r->u.sutrs->buf, r->u.sutrs->len);
889 else if (ent && ent->value == VAL_GRS1)
891 if (r->which != Z_External_grs1)
893 printf("Expecting single GRS type for GRS.\n");
896 display_grs1(r->u.grs1, 0);
900 printf("Unknown record representation.\n");
901 if (!z_External(print, &r, 0, 0))
903 odr_perror(print, "Printing external");
910 static void display_diagrecs(Z_DiagRec **pp, int num)
914 Z_DefaultDiagFormat *r;
916 printf("Diagnostic message(s) from database:\n");
917 for (i = 0; i<num; i++)
919 Z_DiagRec *p = pp[i];
920 if (p->which != Z_DiagRec_defaultFormat)
922 printf("Diagnostic record not in default format.\n");
926 r = p->u.defaultFormat;
927 if (!(ent = oid_getentbyoid(r->diagnosticSetId)) ||
928 ent->oclass != CLASS_DIAGSET || ent->value != VAL_BIB1)
929 printf("Missing or unknown diagset\n");
930 printf(" [%d] %s", *r->condition, diagbib1_str(*r->condition));
934 case Z_DefaultDiagFormat_v2Addinfo:
935 printf (" -- v2 addinfo '%s'\n", r->u.v2Addinfo);
937 case Z_DefaultDiagFormat_v3Addinfo:
938 printf (" -- v3 addinfo '%s'\n", r->u.v3Addinfo);
942 if (r->addinfo && *r->addinfo)
943 printf(" -- '%s'\n", r->addinfo);
951 static void display_nameplusrecord(Z_NamePlusRecord *p)
954 printf("[%s]", p->databaseName);
955 if (p->which == Z_NamePlusRecord_surrogateDiagnostic)
956 display_diagrecs(&p->u.surrogateDiagnostic, 1);
957 else if (p->which == Z_NamePlusRecord_databaseRecord)
958 display_record(p->u.databaseRecord);
961 static void display_records(Z_Records *p)
965 if (p->which == Z_Records_NSD)
968 Z_DiagRec dr, *dr_p = &dr;
969 dr.which = Z_DiagRec_defaultFormat;
970 dr.u.defaultFormat = p->u.nonSurrogateDiagnostic;
971 display_diagrecs (&dr_p, 1);
973 display_diagrecs (&p->u.nonSurrogateDiagnostic, 1);
976 else if (p->which == Z_Records_multipleNSD)
977 display_diagrecs (p->u.multipleNonSurDiagnostics->diagRecs,
978 p->u.multipleNonSurDiagnostics->num_diagRecs);
981 printf("Records: %d\n", p->u.databaseOrSurDiagnostics->num_records);
982 for (i = 0; i < p->u.databaseOrSurDiagnostics->num_records; i++)
983 display_nameplusrecord(p->u.databaseOrSurDiagnostics->records[i]);
987 static int send_deleteResultSetRequest(char *arg)
992 Z_APDU *apdu = zget_APDU(out, Z_APDU_deleteResultSetRequest);
993 Z_DeleteResultSetRequest *req = apdu->u.deleteResultSetRequest;
995 req->referenceId = set_refid (out);
997 req->num_resultSetList =
998 sscanf (arg, "%30s %30s %30s %30s %30s %30s %30s %30s",
999 names[0], names[1], names[2], names[3],
1000 names[4], names[5], names[6], names[7]);
1002 req->deleteFunction = (int *)
1003 odr_malloc (out, sizeof(*req->deleteFunction));
1004 if (req->num_resultSetList > 0)
1006 *req->deleteFunction = Z_DeleteRequest_list;
1007 req->resultSetList = (char **)
1008 odr_malloc (out, sizeof(*req->resultSetList)*
1009 req->num_resultSetList);
1010 for (i = 0; i<req->num_resultSetList; i++)
1011 req->resultSetList[i] = names[i];
1015 *req->deleteFunction = Z_DeleteRequest_all;
1016 req->resultSetList = 0;
1020 printf("Sent deleteResultSetRequest.\n");
1024 static int send_searchRequest(char *arg)
1026 Z_APDU *apdu = zget_APDU(out, Z_APDU_searchRequest);
1027 Z_SearchRequest *req = apdu->u.searchRequest;
1031 struct ccl_rpn_node *rpn = NULL;
1034 char setstring[100];
1035 Z_RPNQuery *RPNquery;
1039 if (queryType == QueryType_CCL2RPN)
1041 rpn = ccl_find_str(bibset, arg, &error, &pos);
1044 printf("CCL ERROR: %s\n", ccl_err_msg(error));
1049 req->referenceId = set_refid (out);
1050 if (!strcmp(arg, "@big")) /* strictly for troublemaking */
1052 static unsigned char big[2100];
1053 static Odr_oct bigo;
1055 /* send a very big referenceid to test transport stack etc. */
1056 memset(big, 'A', 2100);
1057 bigo.len = bigo.size = 2100;
1059 req->referenceId = &bigo;
1064 sprintf(setstring, "%d", ++setnumber);
1065 req->resultSetName = setstring;
1067 *req->smallSetUpperBound = smallSetUpperBound;
1068 *req->largeSetLowerBound = largeSetLowerBound;
1069 *req->mediumSetPresentNumber = mediumSetPresentNumber;
1070 if (smallSetUpperBound > 0 || (largeSetLowerBound > 1 &&
1071 mediumSetPresentNumber > 0))
1075 prefsyn.proto = protocol;
1076 prefsyn.oclass = CLASS_RECSYN;
1077 prefsyn.value = recordsyntax;
1078 req->preferredRecordSyntax =
1079 odr_oiddup(out, oid_ent_to_oid(&prefsyn, oid));
1080 req->smallSetElementSetNames =
1081 req->mediumSetElementSetNames = elementSetNames;
1083 req->num_databaseNames = num_databaseNames;
1084 req->databaseNames = databaseNames;
1086 req->query = &query;
1090 case QueryType_Prefix:
1091 query.which = Z_Query_type_1;
1092 RPNquery = p_query_rpn (out, protocol, arg);
1095 printf("Prefix query error\n");
1098 query.u.type_1 = RPNquery;
1101 query.which = Z_Query_type_2;
1102 query.u.type_2 = &ccl_query;
1103 ccl_query.buf = (unsigned char*) arg;
1104 ccl_query.len = strlen(arg);
1107 case QueryType_CCL2RPN:
1108 query.which = Z_Query_type_1;
1109 RPNquery = ccl_rpn_query(out, rpn);
1112 printf ("Couldn't convert from CCL to RPN\n");
1115 query.u.type_1 = RPNquery;
1116 ccl_rpn_delete (rpn);
1120 printf ("Unsupported query type\n");
1125 printf("Sent searchRequest.\n");
1129 static int process_searchResponse(Z_SearchResponse *res)
1131 printf ("Received SearchResponse.\n");
1132 print_refid (res->referenceId);
1133 if (*res->searchStatus)
1134 printf("Search was a success.\n");
1136 printf("Search was a bloomin' failure.\n");
1137 printf("Number of hits: %d, setno %d\n",
1138 *res->resultCount, setnumber);
1139 printf("records returned: %d\n",
1140 *res->numberOfRecordsReturned);
1141 setno += *res->numberOfRecordsReturned;
1143 display_records(res->records);
1147 static void print_level(int iLevel)
1150 for (i = 0; i < iLevel * 4; i++)
1154 static void print_int(int iLevel, const char *pTag, int *pInt)
1158 print_level(iLevel);
1159 printf("%s: %d\n", pTag, *pInt);
1163 static void print_string(int iLevel, const char *pTag, const char *pString)
1165 if (pString != NULL)
1167 print_level(iLevel);
1168 printf("%s: %s\n", pTag, pString);
1172 static void print_oid(int iLevel, const char *pTag, Odr_oid *pOid)
1178 print_level(iLevel);
1179 printf("%s:", pTag);
1180 for (; *pInt != -1; pInt++)
1181 printf(" %d", *pInt);
1186 static void print_referenceId(int iLevel, Z_ReferenceId *referenceId)
1188 if (referenceId != NULL)
1192 print_level(iLevel);
1193 printf("Ref Id (%d, %d): ", referenceId->len, referenceId->size);
1194 for (i = 0; i < referenceId->len; i++)
1195 printf("%c", referenceId->buf[i]);
1200 static void print_string_or_numeric(int iLevel, const char *pTag, Z_StringOrNumeric *pStringNumeric)
1202 if (pStringNumeric != NULL)
1204 switch (pStringNumeric->which)
1206 case Z_StringOrNumeric_string:
1207 print_string(iLevel, pTag, pStringNumeric->u.string);
1210 case Z_StringOrNumeric_numeric:
1211 print_int(iLevel, pTag, pStringNumeric->u.numeric);
1215 print_level(iLevel);
1216 printf("%s: valid type for Z_StringOrNumeric\n", pTag);
1222 static void print_universe_report_duplicate(int iLevel, Z_UniverseReportDuplicate *pUniverseReportDuplicate)
1224 if (pUniverseReportDuplicate != NULL)
1226 print_level(iLevel);
1227 printf("Universe Report Duplicate: \n");
1229 print_string_or_numeric(iLevel, "Hit No", pUniverseReportDuplicate->hitno);
1233 static void print_universe_report_hits(int iLevel, Z_UniverseReportHits *pUniverseReportHits)
1235 if (pUniverseReportHits != NULL)
1237 print_level(iLevel);
1238 printf("Universe Report Hits: \n");
1240 print_string_or_numeric(iLevel, "Database", pUniverseReportHits->database);
1241 print_string_or_numeric(iLevel, "Hits", pUniverseReportHits->hits);
1245 static void print_universe_report(int iLevel, Z_UniverseReport *pUniverseReport)
1247 if (pUniverseReport != NULL)
1249 print_level(iLevel);
1250 printf("Universe Report: \n");
1252 print_int(iLevel, "Total Hits", pUniverseReport->totalHits);
1253 switch (pUniverseReport->which)
1255 case Z_UniverseReport_databaseHits:
1256 print_universe_report_hits(iLevel, pUniverseReport->u.databaseHits);
1259 case Z_UniverseReport_duplicate:
1260 print_universe_report_duplicate(iLevel, pUniverseReport->u.duplicate);
1264 print_level(iLevel);
1265 printf("Type: %d\n", pUniverseReport->which);
1271 static void print_external(int iLevel, Z_External *pExternal)
1273 if (pExternal != NULL)
1275 print_level(iLevel);
1276 printf("External: \n");
1278 print_oid(iLevel, "Direct Reference", pExternal->direct_reference);
1279 print_int(iLevel, "InDirect Reference", pExternal->indirect_reference);
1280 print_string(iLevel, "Descriptor", pExternal->descriptor);
1281 switch (pExternal->which)
1283 case Z_External_universeReport:
1284 print_universe_report(iLevel, pExternal->u.universeReport);
1288 print_level(iLevel);
1289 printf("Type: %d\n", pExternal->which);
1295 static int process_resourceControlRequest (Z_ResourceControlRequest *req)
1297 printf ("Received ResourceControlRequest.\n");
1298 print_referenceId(1, req->referenceId);
1299 print_int(1, "Suspended Flag", req->suspendedFlag);
1300 print_int(1, "Partial Results Available", req->partialResultsAvailable);
1301 print_int(1, "Response Required", req->responseRequired);
1302 print_int(1, "Triggered Request Flag", req->triggeredRequestFlag);
1303 print_external(1, req->resourceReport);
1307 void process_ESResponse(Z_ExtendedServicesResponse *res)
1309 printf("process_ESResponse status=");
1310 switch (*res->operationStatus)
1312 case Z_ExtendedServicesResponse_done:
1315 case Z_ExtendedServicesResponse_accepted:
1316 printf ("accepted\n");
1318 case Z_ExtendedServicesResponse_failure:
1319 printf ("failure\n");
1320 display_diagrecs(res->diagnostics, res->num_diagnostics);
1327 const char *get_ill_element (void *clientData, const char *element)
1329 printf ("%s\n", element);
1333 static Z_External *create_external_itemRequest()
1335 struct ill_get_ctl ctl;
1336 ILL_ItemRequest *req;
1338 int item_request_size = 0;
1339 char *item_request_buf = 0;
1343 ctl.f = get_ill_element;
1345 req = ill_get_ItemRequest(&ctl, "ill", 0);
1347 printf ("ill_get_ItemRequest failed\n");
1349 if (!ill_ItemRequest (out, &req, 0, 0))
1353 ill_ItemRequest(print, &req, 0, 0);
1356 item_request_buf = odr_getbuf (out, &item_request_size, 0);
1357 if (item_request_buf)
1358 odr_setbuf (out, item_request_buf, item_request_size, 1);
1359 printf ("Couldn't encode ItemRequest, size %d\n", item_request_size);
1366 item_request_buf = odr_getbuf (out, &item_request_size, 0);
1367 oid.proto = PROTO_GENERAL;
1368 oid.oclass = CLASS_GENERAL;
1369 oid.value = VAL_ISO_ILL_1;
1371 r = (Z_External *) odr_malloc (out, sizeof(*r));
1372 r->direct_reference = odr_oiddup(out,oid_getoidbyent(&oid));
1373 r->indirect_reference = 0;
1375 r->which = Z_External_single;
1377 r->u.single_ASN1_type = (Odr_oct *)
1378 odr_malloc (out, sizeof(*r->u.single_ASN1_type));
1379 r->u.single_ASN1_type->buf = (unsigned char *)
1380 odr_malloc (out, item_request_size);
1381 r->u.single_ASN1_type->len = item_request_size;
1382 r->u.single_ASN1_type->size = item_request_size;
1383 memcpy (r->u.single_ASN1_type->buf, item_request_buf,
1385 printf ("len = %d\n", item_request_size);
1390 static Z_External *create_external_itemRequest()
1397 static Z_External *create_external_ILL_APDU(int which)
1399 struct ill_get_ctl ctl;
1402 int ill_request_size = 0;
1403 char *ill_request_buf = 0;
1407 ctl.f = get_ill_element;
1409 ill_apdu = ill_get_APDU(&ctl, "ill", 0);
1411 if (!ill_APDU (out, &ill_apdu, 0, 0))
1415 printf ("-------------------\n");
1416 ill_APDU(print, &ill_apdu, 0, 0);
1418 printf ("-------------------\n");
1420 ill_request_buf = odr_getbuf (out, &ill_request_size, 0);
1421 if (ill_request_buf)
1422 odr_setbuf (out, ill_request_buf, ill_request_size, 1);
1423 printf ("Couldn't encode ILL-Request, size %d\n", ill_request_size);
1429 ill_request_buf = odr_getbuf (out, &ill_request_size, 0);
1431 oid.proto = PROTO_GENERAL;
1432 oid.oclass = CLASS_GENERAL;
1433 oid.value = VAL_ISO_ILL_1;
1435 r = (Z_External *) odr_malloc (out, sizeof(*r));
1436 r->direct_reference = odr_oiddup(out,oid_getoidbyent(&oid));
1437 r->indirect_reference = 0;
1439 r->which = Z_External_single;
1441 r->u.single_ASN1_type = (Odr_oct *)
1442 odr_malloc (out, sizeof(*r->u.single_ASN1_type));
1443 r->u.single_ASN1_type->buf = (unsigned char *)
1444 odr_malloc (out, ill_request_size);
1445 r->u.single_ASN1_type->len = ill_request_size;
1446 r->u.single_ASN1_type->size = ill_request_size;
1447 memcpy (r->u.single_ASN1_type->buf, ill_request_buf, ill_request_size);
1448 printf ("len = %d\n", ill_request_size);
1453 static Z_External *create_external_ILLRequest()
1460 static Z_External *create_ItemOrderExternal(const char *type, int itemno)
1462 Z_External *r = (Z_External *) odr_malloc(out, sizeof(Z_External));
1463 oident ItemOrderRequest;
1465 ItemOrderRequest.proto = PROTO_Z3950;
1466 ItemOrderRequest.oclass = CLASS_EXTSERV;
1467 ItemOrderRequest.value = VAL_ITEMORDER;
1469 r->direct_reference = odr_oiddup(out,oid_getoidbyent(&ItemOrderRequest));
1470 r->indirect_reference = 0;
1473 r->which = Z_External_itemOrder;
1475 r->u.itemOrder = (Z_ItemOrder *) odr_malloc(out,sizeof(Z_ItemOrder));
1476 memset(r->u.itemOrder, 0, sizeof(Z_ItemOrder));
1478 r->u.itemOrder->which=Z_IOItemOrder_esRequest;
1480 r->u.itemOrder->which=Z_ItemOrder_esRequest;
1483 r->u.itemOrder->u.esRequest = (Z_IORequest *)
1484 odr_malloc(out,sizeof(Z_IORequest));
1485 memset(r->u.itemOrder->u.esRequest, 0, sizeof(Z_IORequest));
1487 r->u.itemOrder->u.esRequest->toKeep = (Z_IOOriginPartToKeep *)
1488 odr_malloc(out,sizeof(Z_IOOriginPartToKeep));
1489 memset(r->u.itemOrder->u.esRequest->toKeep, 0, sizeof(Z_IOOriginPartToKeep));
1490 r->u.itemOrder->u.esRequest->notToKeep = (Z_IOOriginPartNotToKeep *)
1491 odr_malloc(out,sizeof(Z_IOOriginPartNotToKeep));
1492 memset(r->u.itemOrder->u.esRequest->notToKeep, 0, sizeof(Z_IOOriginPartNotToKeep));
1494 r->u.itemOrder->u.esRequest->toKeep->supplDescription = NULL;
1495 r->u.itemOrder->u.esRequest->toKeep->contact = NULL;
1496 r->u.itemOrder->u.esRequest->toKeep->addlBilling = NULL;
1498 r->u.itemOrder->u.esRequest->notToKeep->resultSetItem =
1499 (Z_IOResultSetItem *) odr_malloc(out, sizeof(Z_IOResultSetItem));
1500 memset(r->u.itemOrder->u.esRequest->notToKeep->resultSetItem, 0, sizeof(Z_IOResultSetItem));
1501 r->u.itemOrder->u.esRequest->notToKeep->resultSetItem->resultSetId = "1";
1503 r->u.itemOrder->u.esRequest->notToKeep->resultSetItem->item =
1504 (int *) odr_malloc(out, sizeof(int));
1505 *r->u.itemOrder->u.esRequest->notToKeep->resultSetItem->item = itemno;
1508 if (!strcmp (type, "item") || !strcmp(type, "2"))
1510 printf ("using item-request\n");
1511 r->u.itemOrder->u.esRequest->notToKeep->itemRequest =
1512 create_external_itemRequest();
1514 else if (!strcmp(type, "ill") || !strcmp(type, "1"))
1516 printf ("using ILL-request\n");
1517 r->u.itemOrder->u.esRequest->notToKeep->itemRequest =
1518 create_external_ILL_APDU(ILL_APDU_ILL_Request);
1521 r->u.itemOrder->u.esRequest->notToKeep->itemRequest = 0;
1524 r->u.itemOrder->u.esRequest->notToKeep->itemRequest = 0;
1529 static int send_itemorder(const char *type, int itemno)
1531 Z_APDU *apdu = zget_APDU(out, Z_APDU_extendedServicesRequest);
1532 Z_ExtendedServicesRequest *req = apdu->u.extendedServicesRequest;
1533 oident ItemOrderRequest;
1535 ItemOrderRequest.proto = PROTO_Z3950;
1536 ItemOrderRequest.oclass = CLASS_EXTSERV;
1537 ItemOrderRequest.value = VAL_ITEMORDER;
1538 req->packageType = odr_oiddup(out,oid_getoidbyent(&ItemOrderRequest));
1539 req->packageName = esPackageName;
1541 req->taskSpecificParameters = create_ItemOrderExternal(type, itemno);
1547 static int cmd_update(char *arg)
1549 Z_APDU *apdu = zget_APDU(out, Z_APDU_extendedServicesRequest );
1550 Z_ExtendedServicesRequest *req = apdu->u.extendedServicesRequest;
1553 Z_IUOriginPartToKeep *toKeep;
1554 Z_IUSuppliedRecords *notToKeep;
1556 printf ("Update request\n");
1561 update_oid.proto = PROTO_Z3950;
1562 update_oid.oclass = CLASS_EXTSERV;
1563 update_oid.value = VAL_DBUPDATE;
1564 oid_ent_to_oid (&update_oid, oid);
1565 req->packageType = odr_oiddup(out,oid);
1566 req->packageName = esPackageName;
1568 r = req->taskSpecificParameters = (Z_External *)
1569 odr_malloc (out, sizeof(*r));
1570 r->direct_reference = odr_oiddup(out,oid);
1571 r->indirect_reference = 0;
1573 r->which = Z_External_update;
1574 r->u.update = (Z_IUUpdate *) odr_malloc(out, sizeof(*r->u.update));
1575 r->u.update->which = Z_IUUpdate_esRequest;
1576 r->u.update->u.esRequest = (Z_IUUpdateEsRequest *)
1577 odr_malloc(out, sizeof(*r->u.update->u.esRequest));
1578 toKeep = r->u.update->u.esRequest->toKeep = (Z_IUOriginPartToKeep *)
1579 odr_malloc(out, sizeof(*r->u.update->u.esRequest->toKeep));
1580 toKeep->databaseName = databaseNames[0];
1582 toKeep->elementSetName = 0;
1583 toKeep->actionQualifier = 0;
1584 toKeep->action = (int *) odr_malloc(out, sizeof(*toKeep->action));
1585 *toKeep->action = Z_IUOriginPartToKeep_recordInsert;
1587 notToKeep = r->u.update->u.esRequest->notToKeep = (Z_IUSuppliedRecords *)
1588 odr_malloc(out, sizeof(*r->u.update->u.esRequest->notToKeep));
1590 notToKeep->elements = (Z_IUSuppliedRecords_elem **)
1591 odr_malloc(out, sizeof(*notToKeep->elements));
1592 notToKeep->elements[0] = (Z_IUSuppliedRecords_elem *)
1593 odr_malloc(out, sizeof(**notToKeep->elements));
1594 notToKeep->elements[0]->u.number = 0;
1595 notToKeep->elements[0]->supplementalId = 0;
1596 notToKeep->elements[0]->correlationInfo = 0;
1597 notToKeep->elements[0]->record = record_last;
1604 /* II : Added to do DALI Item Order Extended services request */
1605 static int cmd_itemorder(char *arg)
1610 if (sscanf (arg, "%10s %d", type, &itemno) != 2)
1613 printf("Item order request\n");
1615 send_itemorder(type, itemno);
1619 static int cmd_find(char *arg)
1623 printf("Find what?\n");
1628 printf("Not connected yet\n");
1631 if (!send_searchRequest(arg))
1636 static int cmd_delete(char *arg)
1640 printf("Not connected yet\n");
1643 if (!send_deleteResultSetRequest(arg))
1648 static int cmd_ssub(char *arg)
1650 if (!(smallSetUpperBound = atoi(arg)))
1655 static int cmd_lslb(char *arg)
1657 if (!(largeSetLowerBound = atoi(arg)))
1662 static int cmd_mspn(char *arg)
1664 if (!(mediumSetPresentNumber = atoi(arg)))
1669 static int cmd_status(char *arg)
1671 printf("smallSetUpperBound: %d\n", smallSetUpperBound);
1672 printf("largeSetLowerBound: %d\n", largeSetLowerBound);
1673 printf("mediumSetPresentNumber: %d\n", mediumSetPresentNumber);
1677 static int cmd_setnames(char *arg)
1681 printf("Set numbering enabled.\n");
1686 printf("Set numbering disabled.\n");
1692 /* PRESENT SERVICE ----------------------------- */
1694 static int send_presentRequest(char *arg)
1696 Z_APDU *apdu = zget_APDU(out, Z_APDU_presentRequest);
1697 Z_PresentRequest *req = apdu->u.presentRequest;
1698 Z_RecordComposition compo;
1703 char setstring[100];
1705 req->referenceId = set_refid (out);
1706 if ((p = strchr(arg, '+')))
1713 if (p && (p=strchr(p+1, '+')))
1715 strcpy (setstring, p+1);
1716 req->resultSetId = setstring;
1718 else if (setnumber >= 0)
1720 sprintf(setstring, "%d", setnumber);
1721 req->resultSetId = setstring;
1726 static Z_Range range;
1727 static Z_Range *rangep = ⦥
1728 req->num_ranges = 1;
1730 req->resultSetStartPoint = &setno;
1731 req->numberOfRecordsRequested = &nos;
1732 prefsyn.proto = protocol;
1733 prefsyn.oclass = CLASS_RECSYN;
1734 prefsyn.value = recordsyntax;
1735 req->preferredRecordSyntax =
1736 odr_oiddup (out, oid_ent_to_oid(&prefsyn, oid));
1738 if (schema != VAL_NONE)
1742 prefschema.proto = protocol;
1743 prefschema.oclass = CLASS_SCHEMA;
1744 prefschema.value = schema;
1746 req->recordComposition = &compo;
1747 compo.which = Z_RecordComp_complex;
1748 compo.u.complex = (Z_CompSpec *)
1749 odr_malloc(out, sizeof(*compo.u.complex));
1750 compo.u.complex->selectAlternativeSyntax = (bool_t *)
1751 odr_malloc(out, sizeof(bool_t));
1752 *compo.u.complex->selectAlternativeSyntax = 0;
1754 compo.u.complex->generic = (Z_Specification *)
1755 odr_malloc(out, sizeof(*compo.u.complex->generic));
1756 compo.u.complex->generic->schema = (Odr_oid *)
1757 odr_oiddup(out, oid_ent_to_oid(&prefschema, oid));
1758 if (!compo.u.complex->generic->schema)
1760 /* OID wasn't a schema! Try record syntax instead. */
1761 prefschema.oclass = CLASS_RECSYN;
1762 compo.u.complex->generic->schema = (Odr_oid *)
1763 odr_oiddup(out, oid_ent_to_oid(&prefschema, oid));
1765 if (!elementSetNames)
1766 compo.u.complex->generic->elementSpec = 0;
1769 compo.u.complex->generic->elementSpec = (Z_ElementSpec *)
1770 odr_malloc(out, sizeof(Z_ElementSpec));
1771 compo.u.complex->generic->elementSpec->which =
1772 Z_ElementSpec_elementSetName;
1773 compo.u.complex->generic->elementSpec->u.elementSetName =
1774 elementSetNames->u.generic;
1776 compo.u.complex->num_dbSpecific = 0;
1777 compo.u.complex->dbSpecific = 0;
1778 compo.u.complex->num_recordSyntax = 0;
1779 compo.u.complex->recordSyntax = 0;
1781 else if (elementSetNames)
1783 req->recordComposition = &compo;
1784 compo.which = Z_RecordComp_simple;
1785 compo.u.simple = elementSetNames;
1788 printf("Sent presentRequest (%d+%d).\n", setno, nos);
1792 void process_close(Z_Close *req)
1794 Z_APDU *apdu = zget_APDU(out, Z_APDU_close);
1795 Z_Close *res = apdu->u.close;
1797 static char *reasons[] =
1802 "cost limit reached",
1804 "security violation",
1811 printf("Reason: %s, message: %s\n", reasons[*req->closeReason],
1812 req->diagnosticInformation ? req->diagnosticInformation : "NULL");
1819 nmem_destroy (session_mem);
1826 *res->closeReason = Z_Close_finished;
1828 printf("Sent response.\n");
1833 static int cmd_show(char *arg)
1837 printf("Not connected yet\n");
1840 if (!send_presentRequest(arg))
1845 int cmd_quit(char *arg)
1847 printf("See you later, alligator.\n");
1852 int cmd_cancel(char *arg)
1854 Z_APDU *apdu = zget_APDU(out, Z_APDU_triggerResourceControlRequest);
1855 Z_TriggerResourceControlRequest *req =
1856 apdu->u.triggerResourceControlRequest;
1861 printf("Session not initialized yet\n");
1864 if (!ODR_MASK_GET(session->options, Z_Options_triggerResourceCtrl))
1866 printf("Target doesn't support cancel (trigger resource ctrl)\n");
1869 *req->requestedAction = Z_TriggerResourceCtrl_cancel;
1870 req->resultSetWanted = &rfalse;
1873 printf("Sent cancel request\n");
1877 int send_scanrequest(const char *query, int pp, int num, const char *term)
1879 Z_APDU *apdu = zget_APDU(out, Z_APDU_scanRequest);
1880 Z_ScanRequest *req = apdu->u.scanRequest;
1885 if (queryType == QueryType_CCL2RPN)
1889 struct ccl_rpn_node *rpn;
1891 rpn = ccl_find_str (bibset, query, &error, &pos);
1894 printf("CCL ERROR: %s\n", ccl_err_msg(error));
1898 bib1.proto = PROTO_Z3950;
1899 bib1.oclass = CLASS_ATTSET;
1900 bib1.value = VAL_BIB1;
1901 req->attributeSet = oid_ent_to_oid (&bib1, oid);
1902 if (!(req->termListAndStartPoint = ccl_scan_query (out, rpn)))
1904 printf("Couldn't convert CCL to Scan term\n");
1907 ccl_rpn_delete (rpn);
1910 if (use_rpn && !(req->termListAndStartPoint =
1911 p_query_scan(out, protocol, &req->attributeSet, query)))
1913 printf("Prefix query error\n");
1918 if (req->termListAndStartPoint->term &&
1919 req->termListAndStartPoint->term->which == Z_Term_general &&
1920 req->termListAndStartPoint->term->u.general)
1922 req->termListAndStartPoint->term->u.general->buf =
1923 (unsigned char *) odr_strdup(out, term);
1924 req->termListAndStartPoint->term->u.general->len =
1925 req->termListAndStartPoint->term->u.general->size =
1929 req->referenceId = set_refid (out);
1930 req->num_databaseNames = num_databaseNames;
1931 req->databaseNames = databaseNames;
1932 req->numberOfTermsRequested = #
1933 req->preferredPositionInResponse = &pp;
1938 int send_sortrequest(char *arg, int newset)
1940 Z_APDU *apdu = zget_APDU(out, Z_APDU_sortRequest);
1941 Z_SortRequest *req = apdu->u.sortRequest;
1942 Z_SortKeySpecList *sksl = (Z_SortKeySpecList *)
1943 odr_malloc (out, sizeof(*sksl));
1945 char sort_string_buf[32], sort_flags[32];
1951 sprintf (setstring, "%d", setnumber);
1953 sprintf (setstring, "default");
1955 req->referenceId = set_refid (out);
1958 req->num_inputResultSetNames = 1;
1959 req->inputResultSetNames = (Z_InternationalString **)
1960 odr_malloc (out, sizeof(*req->inputResultSetNames));
1961 req->inputResultSetNames[0] = odr_strdup (out, setstring);
1963 req->inputResultSetNames =
1964 (Z_StringList *)odr_malloc (out, sizeof(*req->inputResultSetNames));
1965 req->inputResultSetNames->num_strings = 1;
1966 req->inputResultSetNames->strings =
1967 (char **)odr_malloc (out, sizeof(*req->inputResultSetNames->strings));
1968 req->inputResultSetNames->strings[0] =
1969 odr_strdup (out, setstring);
1972 if (newset && setnumber >= 0)
1973 sprintf (setstring, "%d", ++setnumber);
1975 req->sortedResultSetName = odr_strdup (out, setstring);
1977 req->sortSequence = sksl;
1978 sksl->num_specs = 0;
1979 sksl->specs = (Z_SortKeySpec **)odr_malloc (out, sizeof(sksl->specs) * 20);
1981 bib1.proto = protocol;
1982 bib1.oclass = CLASS_ATTSET;
1983 bib1.value = VAL_BIB1;
1984 while ((sscanf (arg, "%31s %31s%n", sort_string_buf, sort_flags, &off)) == 2
1988 char *sort_string_sep;
1989 char *sort_string = sort_string_buf;
1990 Z_SortKeySpec *sks = (Z_SortKeySpec *)odr_malloc (out, sizeof(*sks));
1991 Z_SortKey *sk = (Z_SortKey *)odr_malloc (out, sizeof(*sk));
1994 sksl->specs[sksl->num_specs++] = sks;
1995 sks->sortElement = (Z_SortElement *)odr_malloc (out, sizeof(*sks->sortElement));
1996 sks->sortElement->which = Z_SortElement_generic;
1997 sks->sortElement->u.generic = sk;
1999 if ((sort_string_sep = strchr (sort_string, '=')))
2002 sk->which = Z_SortKey_sortAttributes;
2003 sk->u.sortAttributes =
2004 (Z_SortAttributes *)odr_malloc (out, sizeof(*sk->u.sortAttributes));
2005 sk->u.sortAttributes->id = oid_ent_to_oid(&bib1, oid);
2006 sk->u.sortAttributes->list =
2007 (Z_AttributeList *)odr_malloc (out, sizeof(*sk->u.sortAttributes->list));
2008 sk->u.sortAttributes->list->attributes =
2009 (Z_AttributeElement **)
2010 odr_malloc (out, 10 *
2011 sizeof(*sk->u.sortAttributes->list->attributes));
2012 while (i < 10 && sort_string && sort_string_sep)
2014 Z_AttributeElement *el = (Z_AttributeElement *)
2015 odr_malloc (out, sizeof(*el));
2016 sk->u.sortAttributes->list->attributes[i] = el;
2017 el->attributeSet = 0;
2018 el->attributeType = (int *)odr_malloc (out, sizeof(*el->attributeType));
2019 *el->attributeType = atoi (sort_string);
2020 el->which = Z_AttributeValue_numeric;
2021 el->value.numeric = (int *)odr_malloc (out, sizeof(*el->value.numeric));
2022 *el->value.numeric = atoi (sort_string_sep + 1);
2024 sort_string = strchr(sort_string, ',');
2028 sort_string_sep = strchr (sort_string, '=');
2031 sk->u.sortAttributes->list->num_attributes = i;
2035 sk->which = Z_SortKey_sortField;
2036 sk->u.sortField = odr_strdup (out, sort_string);
2038 sks->sortRelation = (int *)odr_malloc (out, sizeof(*sks->sortRelation));
2039 *sks->sortRelation = Z_SortRelation_ascending;
2040 sks->caseSensitivity = (int *)odr_malloc (out, sizeof(*sks->caseSensitivity));
2041 *sks->caseSensitivity = Z_SortCase_caseSensitive;
2044 sks->which = Z_SortKeySpec_null;
2045 sks->u.null = odr_nullval ();
2047 sks->missingValueAction = NULL;
2050 for (i = 0; sort_flags[i]; i++)
2052 switch (sort_flags[i])
2057 *sks->sortRelation = Z_SortRelation_descending;
2062 *sks->sortRelation = Z_SortRelation_ascending;
2066 *sks->caseSensitivity = Z_SortCase_caseInsensitive;
2070 *sks->caseSensitivity = Z_SortCase_caseSensitive;
2075 if (!sksl->num_specs)
2077 printf ("Missing sort specifications\n");
2084 void display_term(Z_TermInfo *t)
2086 if (t->term->which == Z_Term_general)
2088 printf("%.*s", t->term->u.general->len, t->term->u.general->buf);
2089 sprintf(last_scan_line, "%.*s", t->term->u.general->len,
2090 t->term->u.general->buf);
2093 printf("Term (not general)");
2094 if (t->globalOccurrences)
2095 printf (" (%d)\n", *t->globalOccurrences);
2100 void process_scanResponse(Z_ScanResponse *res)
2103 Z_Entry **entries = NULL;
2104 int num_entries = 0;
2106 printf("Received ScanResponse\n");
2107 print_refid (res->referenceId);
2108 printf("%d entries", *res->numberOfEntriesReturned);
2109 if (res->positionOfTerm)
2110 printf (", position=%d", *res->positionOfTerm);
2112 if (*res->scanStatus != Z_Scan_success)
2113 printf("Scan returned code %d\n", *res->scanStatus);
2116 if ((entries = res->entries->entries))
2117 num_entries = res->entries->num_entries;
2118 for (i = 0; i < num_entries; i++)
2120 int pos_term = res->positionOfTerm ? *res->positionOfTerm : -1;
2121 if (entries[i]->which == Z_Entry_termInfo)
2123 printf("%c ", i + 1 == pos_term ? '*' : ' ');
2124 display_term(entries[i]->u.termInfo);
2127 display_diagrecs(&entries[i]->u.surrogateDiagnostic, 1);
2129 if (res->entries->nonsurrogateDiagnostics)
2130 display_diagrecs (res->entries->nonsurrogateDiagnostics,
2131 res->entries->num_nonsurrogateDiagnostics);
2134 void process_sortResponse(Z_SortResponse *res)
2136 printf("Received SortResponse: status=");
2137 switch (*res->sortStatus)
2139 case Z_SortStatus_success:
2140 printf ("success"); break;
2141 case Z_SortStatus_partial_1:
2142 printf ("partial"); break;
2143 case Z_SortStatus_failure:
2144 printf ("failure"); break;
2146 printf ("unknown (%d)", *res->sortStatus);
2149 print_refid (res->referenceId);
2151 if (res->diagnostics)
2152 display_diagrecs(res->diagnostics,
2153 res->num_diagnostics);
2155 if (res->diagnostics)
2156 display_diagrecs(res->diagnostics->diagRecs,
2157 res->diagnostics->num_diagRecs);
2161 void process_deleteResultSetResponse (Z_DeleteResultSetResponse *res)
2163 printf("Got deleteResultSetResponse status=%d\n",
2164 *res->deleteOperationStatus);
2165 if (res->deleteListStatuses)
2168 for (i = 0; i < res->deleteListStatuses->num; i++)
2170 printf ("%s status=%d\n", res->deleteListStatuses->elements[i]->id,
2171 *res->deleteListStatuses->elements[i]->status);
2176 int cmd_sort_generic(char *arg, int newset)
2180 printf("Session not initialized yet\n");
2183 if (!ODR_MASK_GET(session->options, Z_Options_sort))
2185 printf("Target doesn't support sort\n");
2190 if (send_sortrequest(arg, newset) < 0)
2197 int cmd_sort(char *arg)
2199 return cmd_sort_generic (arg, 0);
2202 int cmd_sort_newset (char *arg)
2204 return cmd_sort_generic (arg, 1);
2207 int cmd_scan(char *arg)
2211 printf("Session not initialized yet\n");
2214 if (!ODR_MASK_GET(session->options, Z_Options_scan))
2216 printf("Target doesn't support scan\n");
2221 strcpy (last_scan_query, arg);
2222 if (send_scanrequest(arg, 1, 20, 0) < 0)
2227 if (send_scanrequest(last_scan_query, 1, 20, last_scan_line) < 0)
2233 int cmd_schema(char *arg)
2240 schema = oid_getvalbyname (arg);
2241 if (schema == VAL_NONE)
2243 printf ("unknown schema\n");
2249 int cmd_format(char *arg)
2253 printf("Usage: format <recordsyntax>\n");
2256 recordsyntax = oid_getvalbyname (arg);
2257 if (recordsyntax == VAL_NONE)
2259 printf ("unknown record syntax\n");
2265 int cmd_elements(char *arg)
2267 static Z_ElementSetNames esn;
2268 static char what[100];
2272 elementSetNames = 0;
2276 esn.which = Z_ElementSetNames_generic;
2277 esn.u.generic = what;
2278 elementSetNames = &esn;
2282 int cmd_attributeset(char *arg)
2288 printf("Usage: attributeset <setname>\n");
2291 sscanf(arg, "%s", what);
2292 if (p_query_attset (what))
2294 printf("Unknown attribute set name\n");
2300 int cmd_querytype (char *arg)
2302 if (!strcmp (arg, "ccl"))
2303 queryType = QueryType_CCL;
2304 else if (!strcmp (arg, "prefix") || !strcmp(arg, "rpn"))
2305 queryType = QueryType_Prefix;
2307 else if (!strcmp (arg, "ccl2rpn") || !strcmp (arg, "cclrpn"))
2308 queryType = QueryType_CCL2RPN;
2312 printf ("Querytype must be one of:\n");
2313 printf (" prefix - Prefix query\n");
2314 printf (" ccl - CCL query\n");
2316 printf (" ccl2rpn - CCL query converted to RPN\n");
2323 int cmd_refid (char *arg)
2329 refid = (char *) xmalloc (strlen(arg)+1);
2330 strcpy (refid, arg);
2335 int cmd_close(char *arg)
2342 apdu = zget_APDU(out, Z_APDU_close);
2343 req = apdu->u.close;
2344 *req->closeReason = Z_Close_finished;
2346 printf("Sent close request.\n");
2351 int cmd_packagename(char* arg) {
2352 xfree (esPackageName);
2353 esPackageName = NULL;
2356 esPackageName = (char *) xmalloc (strlen(arg)+1);
2357 strcpy (esPackageName, arg);
2362 static void initialize(void)
2368 if (!(out = odr_createmem(ODR_ENCODE)) ||
2369 !(in = odr_createmem(ODR_DECODE)) ||
2370 !(print = odr_createmem(ODR_PRINT)))
2372 fprintf(stderr, "failed to allocate ODR streams\n");
2375 setvbuf(stdout, 0, _IONBF, 0);
2377 odr_setprint(print, apdu_file);
2380 bibset = ccl_qual_mk ();
2381 inf = fopen (ccl_fields, "r");
2384 ccl_qual_file (bibset, inf);
2388 cmd_base("Default");
2391 static int client(int wait)
2395 int (*fun)(char *arg);
2398 {"open", cmd_open, "('tcp'|'osi')':'[<tsel>'/']<host>[':'<port>]"},
2399 {"quit", cmd_quit, ""},
2400 {"find", cmd_find, "<query>"},
2401 {"delete", cmd_delete, "<setname>"},
2402 {"base", cmd_base, "<base-name>"},
2403 {"show", cmd_show, "<rec#>['+'<#recs>['+'<setname>]]"},
2404 {"scan", cmd_scan, "<term>"},
2405 {"sort", cmd_sort, "<sortkey> <flag> <sortkey> <flag> ..."},
2406 {"sort+", cmd_sort_newset, "<sortkey> <flag> <sortkey> <flag> ..."},
2407 {"authentication", cmd_authentication, "<acctstring>"},
2408 {"lslb", cmd_lslb, "<largeSetLowerBound>"},
2409 {"ssub", cmd_ssub, "<smallSetUpperBound>"},
2410 {"mspn", cmd_mspn, "<mediumSetPresentNumber>"},
2411 {"status", cmd_status, ""},
2412 {"setnames", cmd_setnames, ""},
2413 {"cancel", cmd_cancel, ""},
2414 {"format", cmd_format, "<recordsyntax>"},
2415 {"schema", cmd_schema, "<schema>"},
2416 {"elements", cmd_elements, "<elementSetName>"},
2417 {"close", cmd_close, ""},
2418 {"attributeset", cmd_attributeset, "<attrset>"},
2419 {"querytype", cmd_querytype, "<type>"},
2420 {"refid", cmd_refid, "<id>"},
2421 {"itemorder", cmd_itemorder, "ill|item <itemno>"},
2422 {"update", cmd_update, "<item>"},
2423 {"packagename", cmd_packagename, "<packagename>"},
2425 /* Server Admin Functions */
2426 {"adm-reindex", cmd_adm_reindex, "<database-name>"},
2427 {"adm-truncate", cmd_adm_truncate, "('database'|'index')<object-name>"},
2428 {"adm-create", cmd_adm_create, ""},
2429 {"adm-drop", cmd_adm_drop, "('database'|'index')<object-name>"},
2430 {"adm-import", cmd_adm_import, "<record-type> <dir> <pattern>"},
2431 {"adm-refresh", cmd_adm_refresh, ""},
2432 {"adm-commit", cmd_adm_commit, ""},
2433 {"adm-shutdown", cmd_adm_shutdown, ""},
2434 {"adm-startup", cmd_adm_startup, ""},
2439 int netbufferlen = 0;
2442 #if HAVE_GETTIMEOFDAY
2443 struct timeval tv_start, tv_end;
2444 gettimeofday (&tv_start, 0);
2453 char line[1024], word[1024], arg[1024];
2459 FD_SET(cs_fileno(conn), &input);
2460 if ((res = select(20, &input, 0, 0, 0)) < 0)
2467 if (!wait && FD_ISSET(0, &input))
2472 #if HAVE_READLINE_READLINE_H
2474 line_in=readline(C_PROMPT);
2477 #if HAVE_READLINE_HISTORY_H
2479 add_history(line_in);
2481 strcpy(line,line_in);
2487 if (!fgets(line, 1023, stdin))
2489 if ((end_p = strchr (line, '\n')))
2492 #if HAVE_GETTIMEOFDAY
2493 gettimeofday (&tv_start, 0);
2496 if ((res = sscanf(line, "%s %[^;]", word, arg)) <= 0)
2498 strcpy(word, last_cmd);
2503 strcpy(last_cmd, word);
2504 for (i = 0; cmd[i].cmd; i++)
2505 if (!strncmp(cmd[i].cmd, word, strlen(word)))
2507 res = (*cmd[i].fun)(arg);
2510 if (!cmd[i].cmd) /* dump our help-screen */
2512 printf("Unknown command: %s.\n", word);
2513 printf("Currently recognized commands:\n");
2514 for (i = 0; cmd[i].cmd; i++)
2515 printf(" %s %s\n", cmd[i].cmd, cmd[i].ad);
2526 && FD_ISSET(cs_fileno(conn), &input)
2532 if ((res = cs_get(conn, &netbuffer, &netbufferlen)) < 0)
2539 printf("Target closed connection.\n");
2542 odr_reset(in); /* release APDU from last round */
2544 odr_setbuf(in, netbuffer, res, 0);
2545 if (!z_APDU(in, &apdu, 0, 0))
2547 odr_perror(in, "Decoding incoming APDU");
2548 fprintf(stderr, "[Near %d]\n", odr_offset(in));
2549 fprintf(stderr, "Packet dump:\n---------\n");
2550 odr_dumpBER(stderr, netbuffer, res);
2551 fprintf(stderr, "---------\n");
2553 z_APDU(print, &apdu, 0, 0);
2556 if (apdu_file && !z_APDU(print, &apdu, 0, 0))
2558 odr_perror(print, "Failed to print incoming APDU");
2564 case Z_APDU_initResponse:
2565 process_initResponse(apdu->u.initResponse);
2567 case Z_APDU_searchResponse:
2568 process_searchResponse(apdu->u.searchResponse);
2570 case Z_APDU_scanResponse:
2571 process_scanResponse(apdu->u.scanResponse);
2573 case Z_APDU_presentResponse:
2574 print_refid (apdu->u.presentResponse->referenceId);
2576 *apdu->u.presentResponse->numberOfRecordsReturned;
2577 if (apdu->u.presentResponse->records)
2578 display_records(apdu->u.presentResponse->records);
2580 printf("No records.\n");
2581 printf ("nextResultSetPosition = %d\n",
2582 *apdu->u.presentResponse->nextResultSetPosition);
2584 case Z_APDU_sortResponse:
2585 process_sortResponse(apdu->u.sortResponse);
2587 case Z_APDU_extendedServicesResponse:
2588 printf("Got extended services response\n");
2589 process_ESResponse(apdu->u.extendedServicesResponse);
2592 printf("Target has closed the association.\n");
2593 process_close(apdu->u.close);
2595 case Z_APDU_resourceControlRequest:
2596 process_resourceControlRequest
2597 (apdu->u.resourceControlRequest);
2599 case Z_APDU_deleteResultSetResponse:
2600 process_deleteResultSetResponse(apdu->u.
2601 deleteResultSetResponse);
2604 printf("Received unknown APDU type (%d).\n",
2609 while (conn && cs_more(conn));
2610 #if HAVE_GETTIMEOFDAY
2611 gettimeofday (&tv_end, 0);
2614 printf ("Elapsed: %.6f\n", (double) tv_end.tv_usec /
2615 1e6 + tv_end.tv_sec -
2616 ((double) tv_start.tv_usec / 1e6 + tv_start.tv_sec));
2624 int main(int argc, char **argv)
2631 while ((ret = options("c:a:m:v:", argv, argc, &arg)) != -2)
2639 if (cmd_open (arg) == 2)
2644 if (!(marcdump = fopen (arg, "a")))
2651 strncpy (ccl_fields, arg, sizeof(ccl_fields)-1);
2652 ccl_fields[sizeof(ccl_fields)-1] = '\0';
2655 if (!strcmp(arg, "-"))
2658 apdu_file=fopen(arg, "a");
2661 yaz_log_init (yaz_log_mask_str(arg), "", NULL);
2664 fprintf (stderr, "Usage: %s [-m <marclog>] [ -a <apdulog>] "
2665 "[-c cclfields] [<server-addr>]\n",
2672 return client (opened);