Put local variables footer in all c, h files.
[idzebra-moved-to-github.git] / index / zserver.c
index 3077ed1..8989087 100644 (file)
@@ -1,6 +1,6 @@
-/* $Id: zserver.c,v 1.126 2004-12-21 22:00:57 adam Exp $
-   Copyright (C) 1995,1996,1997,1998,1999,2000,2001,2002,2003,2004
-   Index Data Aps
+/* $Id: zserver.c,v 1.146 2006-05-10 08:13:23 adam Exp $
+   Copyright (C) 1995-2005
+   Index Data ApS
 
 This file is part of the Zebra server.
 
@@ -20,14 +20,16 @@ Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
 02111-1307, USA.
 */
 
-#include <stdio.h>
 #include <assert.h>
+#include <stdio.h>
+#include <stdlib.h>
 #include <fcntl.h>
 #ifdef WIN32
 #include <io.h>
 #include <process.h>
 #include <sys/locking.h>
-#else
+#endif
+#if HAVE_UNISTD_H
 #include <unistd.h>
 #endif
 
@@ -35,6 +37,7 @@ Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
 #include <yaz/log.h>
 #include <yaz/ill.h>
 #include <yaz/yaz-util.h>
+#include <yaz/diagbib1.h>
 
 #include <sys/types.h>
 
@@ -73,10 +76,10 @@ bend_initresult *bend_init (bend_initrequest *q)
     yaz_log (YLOG_DEBUG, "bend_init");
 
     sob = statserv_getcontrol ();
-    if (!(zh = zebra_open (sob->handle)))
+    if (!(zh = zebra_open (sob->handle, 0)))
     {
        yaz_log (YLOG_WARN, "Failed to read config `%s'", sob->configname);
-       r->errcode = 1;
+       r->errcode = YAZ_BIB1_PERMANENT_SYSTEM_ERROR;
        return r;
     }
     r->handle = zh;
@@ -102,9 +105,9 @@ bend_initresult *bend_init (bend_initrequest *q)
            passwd = idPass->password;
        }
     }
-    if (zebra_auth (zh, user, passwd))
+    if (zebra_auth(zh, user, passwd) != ZEBRA_OK)
     {
-       r->errcode = 222;
+       r->errcode = YAZ_BIB1_INIT_AC_BAD_USERID_AND_OR_PASSWORD;
        r->errstring = user;
        return r;
     }
@@ -169,18 +172,15 @@ bend_initresult *bend_init (bend_initrequest *q)
     return r;
 }
 
-static void search_terms (ZebraHandle zh, bend_search_rr *r)
+static void search_terms(ZebraHandle zh, bend_search_rr *r)
 {
-    zint count = 0;
     int no_terms;
     int i;
     int type = Z_Term_general;
     struct Z_External *ext;
     Z_SearchInfoReport *sr;
 
-    /* get no of terms for result set */
-    no_terms = 0; /* zebra_resultSetTerms (zh, r->setname, 0, 0, 0, 0, 0); */
-      /* FIXME - Rsets don't know number of terms no more ??? */
+    zebra_result_set_term_no(zh, r->setname, &no_terms);
     if (!no_terms)
         return;
 
@@ -207,36 +207,37 @@ static void search_terms (ZebraHandle zh, bend_search_rr *r)
                                sizeof(*sr->elements));
     for (i = 0; i<no_terms; i++)
     {
+       Z_SearchInfoReport_s *se;
         Z_Term *term;
+       zint count;
+       int approx;
         char outbuf[1024];
         size_t len = sizeof(outbuf);
-        /* FIXME - Can we just skip this ??? */
-        /*
-        zebra_resultSetTerms (zh, r->setname, i,
-                              &count, &type, outbuf, &len);
-        */
-        sr->elements[i] = odr_malloc (r->stream, sizeof(**sr->elements));
-        sr->elements[i]->subqueryId = 0;
-        sr->elements[i]->fullQuery = odr_malloc (r->stream, 
-                                                 sizeof(bool_t));
-        *sr->elements[i]->fullQuery = 0;
-        sr->elements[i]->subqueryExpression = 
+       const char *term_ref_id = 0;
+
+       zebra_result_set_term_info(zh, r->setname, i,
+                                  &count, &approx, outbuf, &len,
+                                  &term_ref_id);
+        se = sr->elements[i] = odr_malloc (r->stream, sizeof(**sr->elements));
+        se->subqueryId = term_ref_id ? 
+           odr_strdup(r->stream, term_ref_id) : 0;
+           
+        se->fullQuery = odr_intdup(r->stream, 0);
+        se->subqueryExpression = 
             odr_malloc (r->stream, sizeof(Z_QueryExpression));
-        sr->elements[i]->subqueryExpression->which = 
+        se->subqueryExpression->which = 
             Z_QueryExpression_term;
-        sr->elements[i]->subqueryExpression->u.term =
+        se->subqueryExpression->u.term =
             odr_malloc (r->stream, sizeof(Z_QueryExpressionTerm));
         term = odr_malloc (r->stream, sizeof(Z_Term));
-        sr->elements[i]->subqueryExpression->u.term->queryTerm = term;
+        se->subqueryExpression->u.term->queryTerm = term;
         switch (type)
         {
         case Z_Term_characterString:
-            yaz_log (YLOG_DEBUG, "term as characterString");
             term->which = Z_Term_characterString;
             term->u.characterString = odr_strdup (r->stream, outbuf);
             break;
         case Z_Term_general:
-            yaz_log (YLOG_DEBUG, "term as general");
             term->which = Z_Term_general;
             term->u.general = odr_malloc (r->stream, sizeof(*term->u.general));
             term->u.general->size = term->u.general->len = len;
@@ -247,27 +248,26 @@ static void search_terms (ZebraHandle zh, bend_search_rr *r)
             term->which = Z_Term_general;
             term->u.null = odr_nullval();
         }
-        sr->elements[i]->subqueryExpression->u.term->termComment = 0;
-        sr->elements[i]->subqueryInterpretation = 0;
-        sr->elements[i]->subqueryRecommendation = 0;
+        se->subqueryExpression->u.term->termComment = 0;
+        se->subqueryInterpretation = 0;
+        se->subqueryRecommendation = 0;
        if (count > 2000000000)
            count = 2000000000;
-        sr->elements[i]->subqueryCount = odr_intdup (r->stream, (int) count);
-        sr->elements[i]->subqueryWeight = 0;
-        sr->elements[i]->resultsByDB = 0;
+        se->subqueryCount = odr_intdup(r->stream, (int) count);
+        se->subqueryWeight = 0;
+        se->resultsByDB = 0;
     }
 }
 
 int bend_search (void *handle, bend_search_rr *r)
 {
     ZebraHandle zh = (ZebraHandle) handle;
+    zint zhits = 0;
+    ZEBRA_RES res;
 
-    r->hits = 0;
-    r->errcode = 0;
-    r->errstring = NULL;
-    
-    if (zebra_select_databases (zh, r->num_bases,
-                                (const char **) r->basenames))
+    res = zebra_select_databases (zh, r->num_bases,
+                                 (const char **) r->basenames);
+    if (res != ZEBRA_OK)
     {
         zebra_result (zh, &r->errcode, &r->errstring);
         return 0;
@@ -276,18 +276,25 @@ int bend_search (void *handle, bend_search_rr *r)
     switch (r->query->which)
     {
     case Z_Query_type_1: case Z_Query_type_101:
-       zebra_search_RPN (zh, r->stream, r->query->u.type_1,
-                         r->setname, &r->hits);
-        zebra_result (zh, &r->errcode, &r->errstring);
-        if (!r->errcode)
+       res = zebra_search_RPN(zh, r->stream, r->query->u.type_1,
+                              r->setname, &zhits);
+       if (res != ZEBRA_OK)
+           zebra_result(zh, &r->errcode, &r->errstring);
+       else
+       {
+           if (zhits >   2147483646)
+               r->hits = 2147483647;
+           else
+           r->hits = (int) zhits;
             search_terms (zh, r);
+       }
         break;
     case Z_Query_type_2:
-       r->errcode = 107;
+       r->errcode = YAZ_BIB1_QUERY_TYPE_UNSUPP;
        r->errstring = "type-2";
        break;
     default:
-        r->errcode = 107;
+        r->errcode = YAZ_BIB1_QUERY_TYPE_UNSUPP;
     }
     return 0;
 }
@@ -297,24 +304,28 @@ int bend_fetch (void *handle, bend_fetch_rr *r)
 {
     ZebraHandle zh = (ZebraHandle) handle;
     ZebraRetrievalRecord retrievalRecord;
+    ZEBRA_RES res;
 
     retrievalRecord.position = r->number;
     
     r->last_in_set = 0;
-    zebra_records_retrieve (zh, r->stream, r->setname, r->comp,
-                           r->request_format, 1, &retrievalRecord);
-    zebra_result (zh, &r->errcode, &r->errstring);
-    /*  non Surrogate Diagnostic OR Surrogate Diagnostic */
-    if (r->errcode == 0 && retrievalRecord.errCode)
+    res = zebra_records_retrieve (zh, r->stream, r->setname, r->comp,
+                                 r->request_format, 1, &retrievalRecord);
+    if (res != ZEBRA_OK)
+    {
+       /* non-surrogate diagnostic */
+       zebra_result (zh, &r->errcode, &r->errstring);
+    }
+    else if (retrievalRecord.errCode)
     {
+       /* surrogate diagnostic (diagnostic per record) */
        r->surrogate_flag = 1;
        r->errcode = retrievalRecord.errCode;
        r->errstring = retrievalRecord.errString;
        r->basename = retrievalRecord.base;
     }
-    else if (r->errcode == 0)        /* Database Record */
+    else
     {
-       r->errcode = 0;
        r->basename = retrievalRecord.base;
        r->record = retrievalRecord.buf;
        r->len = retrievalRecord.len;
@@ -328,34 +339,44 @@ static int bend_scan (void *handle, bend_scan_rr *r)
     ZebraScanEntry *entries;
     ZebraHandle zh = (ZebraHandle) handle;
     int is_partial, i;
+    ZEBRA_RES res;
 
-    if (zebra_select_databases (zh, r->num_bases, 
-                                (const char **) r->basenames))
+    res = zebra_select_databases(zh, r->num_bases, 
+                                (const char **) r->basenames);
+    if (res != ZEBRA_OK)
     {
         zebra_result (zh, &r->errcode, &r->errstring);
         return 0;
     }
     if (r->step_size != 0 && *r->step_size != 0) {
-       r->errcode = 205; /* "Only zero step size supported for Scan" */
+       r->errcode = YAZ_BIB1_ONLY_ZERO_STEP_SIZE_SUPPORTED_FOR_SCAN;
        r->errstring = 0;
         return 0;
     }
     r->entries = (struct scan_entry *)
        odr_malloc (r->stream, sizeof(*r->entries) * r->num_entries);
-    zebra_scan (zh, r->stream, r->term,
-               r->attributeset,
-               &r->term_position,
-               &r->num_entries, &entries, &is_partial);
-    if (is_partial)
-       r->status = BEND_SCAN_PARTIAL;
+    res = zebra_scan(zh, r->stream, r->term,
+                    r->attributeset,
+                    &r->term_position,
+                    &r->num_entries, &entries, &is_partial, 
+                    0 /* setname */);
+    if (res == ZEBRA_OK)
+    {
+       if (is_partial)
+           r->status = BEND_SCAN_PARTIAL;
+       else
+           r->status = BEND_SCAN_SUCCESS;
+       for (i = 0; i < r->num_entries; i++)
+       {
+           r->entries[i].term = entries[i].term;
+           r->entries[i].occurrences = entries[i].occurrences;
+       }
+    }
     else
-       r->status = BEND_SCAN_SUCCESS;
-    for (i = 0; i < r->num_entries; i++)
     {
-       r->entries[i].term = entries[i].term;
-       r->entries[i].occurrences = entries[i].occurrences;
+       r->status = BEND_SCAN_PARTIAL;
+       zebra_result(zh, &r->errcode, &r->errstring);
     }
-    zebra_result (zh, &r->errcode, &r->errstring);
     return 0;
 }
 
@@ -370,10 +391,11 @@ int bend_sort (void *handle, bend_sort_rr *rr)
 {
     ZebraHandle zh = (ZebraHandle) handle;
 
-    zebra_sort (zh, rr->stream,
-                rr->num_input_setnames, (const char **) rr->input_setnames,
-               rr->output_setname, rr->sort_sequence, &rr->sort_status);
-    zebra_result (zh, &rr->errcode, &rr->errstring);
+    if (zebra_sort (zh, rr->stream,
+                   rr->num_input_setnames, (const char **) rr->input_setnames,
+                   rr->output_setname, rr->sort_sequence, &rr->sort_status)
+       != ZEBRA_OK)
+       zebra_result (zh, &rr->errcode, &rr->errstring);
     return 0;
 }
 
@@ -381,14 +403,15 @@ int bend_delete (void *handle, bend_delete_rr *rr)
 {
     ZebraHandle zh = (ZebraHandle) handle;
 
-    rr->delete_status =        zebra_deleleResultSet(zh, rr->function,
+    rr->delete_status =        zebra_deleteResultSet(zh, rr->function,
                                              rr->num_setnames, rr->setnames,
                                              rr->statuses);
     return 0;
 }
 
-static int es_admin_request (ZebraHandle zh, Z_AdminEsRequest *r)
+static void es_admin_request (bend_esrequest_rr *rr, ZebraHandle zh, Z_AdminEsRequest *r)
 {
+    ZEBRA_RES res = ZEBRA_OK;
     if (r->toKeep->databaseName)
     {
        yaz_log(YLOG_LOG, "adm request database %s", r->toKeep->databaseName);
@@ -397,22 +420,26 @@ static int es_admin_request (ZebraHandle zh, Z_AdminEsRequest *r)
     {
     case Z_ESAdminOriginPartToKeep_reIndex:
        yaz_log(YLOG_LOG, "adm-reindex");
+       rr->errcode = YAZ_BIB1_ES_IMMEDIATE_EXECUTION_FAILED;
+       rr->errstring = "adm-reindex not implemented yet";
        break;
     case Z_ESAdminOriginPartToKeep_truncate:
+       rr->errcode = YAZ_BIB1_ES_IMMEDIATE_EXECUTION_FAILED;
+       rr->errstring = "adm-reindex not implemented yet";
        yaz_log(YLOG_LOG, "adm-truncate");
        break;
     case Z_ESAdminOriginPartToKeep_drop:
        yaz_log(YLOG_LOG, "adm-drop");
-       zebra_drop_database (zh, r->toKeep->databaseName);
+       res = zebra_drop_database (zh, r->toKeep->databaseName);
        break;
     case Z_ESAdminOriginPartToKeep_create:
        yaz_log(YLOG_LOG, "adm-create %s", r->toKeep->databaseName);
-       zebra_create_database (zh, r->toKeep->databaseName);
+       res = zebra_create_database (zh, r->toKeep->databaseName);
        break;
     case Z_ESAdminOriginPartToKeep_import:
        yaz_log(YLOG_LOG, "adm-import");
-       zebra_admin_import_begin (zh, r->toKeep->databaseName,
-                       r->toKeep->u.import->recordType);
+       res = zebra_admin_import_begin (zh, r->toKeep->databaseName,
+                                       r->toKeep->u.import->recordType);
        break;
     case Z_ESAdminOriginPartToKeep_refresh:
        yaz_log(YLOG_LOG, "adm-refresh");
@@ -420,12 +447,17 @@ static int es_admin_request (ZebraHandle zh, Z_AdminEsRequest *r)
     case Z_ESAdminOriginPartToKeep_commit:
        yaz_log(YLOG_LOG, "adm-commit");
        if (r->toKeep->databaseName)
-           zebra_select_database(zh, r->toKeep->databaseName);
+       {
+           if (zebra_select_database(zh, r->toKeep->databaseName) !=
+               ZEBRA_OK)
+               yaz_log(YLOG_WARN, "zebra_select_database failed in "
+                       "adm-commit");
+       }
        zebra_commit(zh);
        break;
     case Z_ESAdminOriginPartToKeep_shutdown:
        yaz_log(YLOG_LOG, "shutdown");
-       zebra_admin_shutdown(zh);
+       res = zebra_admin_shutdown(zh);
        break;
     case Z_ESAdminOriginPartToKeep_start:
        yaz_log(YLOG_LOG, "start");
@@ -433,25 +465,26 @@ static int es_admin_request (ZebraHandle zh, Z_AdminEsRequest *r)
        break;
     default:
        yaz_log(YLOG_LOG, "unknown admin");
+       rr->errcode = YAZ_BIB1_ES_IMMEDIATE_EXECUTION_FAILED;
+       rr->errstring = "adm-reindex not implemented yet";
     }
-    return 0;
+    if (res != ZEBRA_OK)
+       zebra_result(zh, &rr->errcode, &rr->errstring);
 }
 
-static int es_admin (ZebraHandle zh, Z_Admin *r)
+static void es_admin (bend_esrequest_rr *rr, ZebraHandle zh, Z_Admin *r)
 {
     switch (r->which)
     {
     case Z_Admin_esRequest:
-       es_admin_request (zh, r->u.esRequest);
-       break;
-    case Z_Admin_taskPackage:
-       yaz_log (YLOG_LOG, "adm taskpackage (unhandled)");
-       break;
+       es_admin_request (rr, zh, r->u.esRequest);
+       return;
     default:
        break;
     }
-
-    return 0;
+       yaz_log (YLOG_WARN, "adm taskpackage (unhandled)");
+    rr->errcode = YAZ_BIB1_ES_IMMEDIATE_EXECUTION_FAILED;
+    rr->errstring = "adm-task package (unhandled)";
 }
 
 int bend_segment (void *handle, bend_segment_rr *rr)
@@ -481,9 +514,7 @@ int bend_esrequest (void *handle, bend_esrequest_rr *rr)
     }
     else if (rr->esr->taskSpecificParameters->which == Z_External_ESAdmin)
     {
-       es_admin (zh, rr->esr->taskSpecificParameters->u.adminService);
-
-        zebra_result (zh, &rr->errcode, &rr->errstring);
+       es_admin(rr, zh, rr->esr->taskSpecificParameters->u.adminService);
     }
     else if (rr->esr->taskSpecificParameters->which == Z_External_update)
     {
@@ -535,20 +566,25 @@ int bend_esrequest (void *handle, bend_esrequest_rr *rr)
             else
             {
                 yaz_log (YLOG_WARN, "no database supplied for ES Update");
-                rr->errcode = 1008;
+                rr->errcode =
+                   YAZ_BIB1_ES_MISSING_MANDATORY_PARAMETER_FOR_SPECIFIED_FUNCTION_;
                 rr->errstring = "database";
                 return 0;
             }
-           if (notToKeep)
+           if (zebra_begin_trans(zh, 1) != ZEBRA_OK)
+           {
+               zebra_result(zh, &rr->errcode, &rr->errstring);
+           }
+           else
            {
                int i;
-                zebra_begin_trans (zh, 1);
-               for (i = 0; i < notToKeep->num; i++)
+               for (i = 0; notToKeep && i < notToKeep->num; i++)
                {
                    Z_External *rec = notToKeep->elements[i]->record;
                     struct oident *oident = 0;
                     Odr_oct *opaque_recid = 0;
-                   SYSNO sysno = 0;
+                   SYSNO *sysno = 0;
+                   SYSNO sysno_tmp;
 
                    if (notToKeep->elements[i]->u.opaque)
                    {
@@ -558,7 +594,8 @@ int bend_esrequest (void *handle, bend_esrequest_rr *rr)
                            opaque_recid = notToKeep->elements[i]->u.opaque;
                            break; /* OK, recid already set */
                        case Z_IUSuppliedRecords_elem_number:
-                           sysno = *notToKeep->elements[i]->u.number;
+                           sysno_tmp = *notToKeep->elements[i]->u.number;
+                           sysno = &sysno_tmp;
                            break;
                        }
                     }
@@ -593,7 +630,7 @@ int bend_esrequest (void *handle, bend_esrequest_rr *rr)
                    }
                     if (oident && oident->value != VAL_TEXT_XML)
                     {
-                        rr->errcode = 224;
+                        rr->errcode = YAZ_BIB1_ES_IMMEDIATE_EXECUTION_FAILED;
                         rr->errstring = "only XML update supported";
                         break;
                     }
@@ -616,7 +653,8 @@ int bend_esrequest (void *handle, bend_esrequest_rr *rr)
 
                         if (!action)
                         {
-                            rr->errcode = 224;
+                            rr->errcode =
+                               YAZ_BIB1_ES_IMMEDIATE_EXECUTION_FAILED;
                             rr->errstring = "unsupported ES Update action";
                             break;
                         }
@@ -624,34 +662,36 @@ int bend_esrequest (void *handle, bend_esrequest_rr *rr)
                        {
                             int r = zebra_admin_exchange_record (
                                 zh,
-                                rec->u.octet_aligned->buf,
+                                (const char *) rec->u.octet_aligned->buf,
                                 rec->u.octet_aligned->len,
-                                opaque_recid->buf, opaque_recid->len,
+                                (const char *) opaque_recid->buf,
+                               opaque_recid->len,
                                 action);
                             if (r)
                             {
-                                rr->errcode = 224;
-                                rr->errstring = "record exchange failed";
+                               zebra_result(zh, &rr->errcode,
+                                            &rr->errstring);
                                 break;
                             }
                        }
                        else
                        {
-                           int r = -1;
+                           ZEBRA_RES r = ZEBRA_FAIL;
                            switch(action) {
                            case 1:
                                r = zebra_insert_record(
                                    zh,
                                    0, /* recordType */
-                                   &sysno,
+                                   sysno,
                                    0, /* match */
                                    0, /* fname */
-                                   rec->u.octet_aligned->buf,
+                                   (const char *) rec->u.octet_aligned->buf,
                                    rec->u.octet_aligned->len,
                                    0);
-                               if (r)
+                               if (r == ZEBRA_FAIL)
                                {
-                                   rr->errcode = 224;
+                                   rr->errcode =
+                                       YAZ_BIB1_ES_IMMEDIATE_EXECUTION_FAILED;
                                    rr->errstring = "insert_record failed";
                                }
                                break;
@@ -660,15 +700,16 @@ int bend_esrequest (void *handle, bend_esrequest_rr *rr)
                                r = zebra_update_record(
                                    zh,
                                    0, /* recordType */
-                                   &sysno,
+                                   sysno,
                                    0, /* match */
                                    0, /* fname */
-                                   rec->u.octet_aligned->buf,
+                                   (const char *) rec->u.octet_aligned->buf,
                                    rec->u.octet_aligned->len,
                                    1);
-                               if (r)
+                               if (r == ZEBRA_FAIL)
                                {
-                                   rr->errcode = 224;
+                                   rr->errcode =
+                                       YAZ_BIB1_ES_IMMEDIATE_EXECUTION_FAILED;
                                    rr->errstring = "update_record failed";
                                }
                                break;
@@ -676,15 +717,16 @@ int bend_esrequest (void *handle, bend_esrequest_rr *rr)
                                r = zebra_delete_record(
                                    zh,
                                    0, /* recordType */
-                                   &sysno,
+                                   sysno,
                                    0, /* match */
                                    0, /* fname */
-                                   rec->u.octet_aligned->buf,
+                                   (const char *) rec->u.octet_aligned->buf,
                                    rec->u.octet_aligned->len,
                                    0);
-                               if (r)
+                               if (r == ZEBRA_FAIL)
                                {
-                                   rr->errcode = 224;
+                                   rr->errcode =
+                                       YAZ_BIB1_ES_IMMEDIATE_EXECUTION_FAILED;
                                    rr->errstring = "delete_record failed";
                                }
                                break;
@@ -692,7 +734,11 @@ int bend_esrequest (void *handle, bend_esrequest_rr *rr)
                        }
                     }
                }
-                zebra_end_trans (zh);
+                if (zebra_end_trans (zh) != ZEBRA_OK)
+               {
+                   yaz_log(YLOG_WARN, "zebra_end_trans failed for"
+                           " extended service operation");
+               }
            }
        }
     }
@@ -700,7 +746,7 @@ int bend_esrequest (void *handle, bend_esrequest_rr *rr)
     {
         yaz_log (YLOG_WARN, "Unknown Extended Service(%d)",
                 rr->esr->taskSpecificParameters->which);
-        rr->errcode = 221;
+        rr->errcode = YAZ_BIB1_ES_EXTENDED_SERVICE_TYPE_UNSUPP;
        
     }
     return 0;
@@ -795,3 +841,11 @@ int main (int argc, char **argv)
 
     return statserv_main (argc, argv, bend_init, bend_close);
 }
+/*
+ * Local variables:
+ * c-basic-offset: 4
+ * indent-tabs-mode: nil
+ * End:
+ * vim: shiftwidth=4 tabstop=8 expandtab
+ */
+