]> git.ipfire.org Git - thirdparty/cups.git/blobdiff - backend/snmp-supplies.c
Merge changes from CUPS 1.6svn-r9939.
[thirdparty/cups.git] / backend / snmp-supplies.c
index 8a0d09f5a31da7fe486dc570f7a1d0a719ad4f99..92febb60215416fa862d6c9f534907c1b639aebc 100644 (file)
@@ -1,9 +1,9 @@
 /*
  * "$Id$"
  *
- *   SNMP supplies functions for the Common UNIX Printing System (CUPS).
+ *   SNMP supplies functions for CUPS.
  *
- *   Copyright 2008-2009 by Apple Inc.
+ *   Copyright 2008-2011 by Apple Inc.
  *
  *   These coded instructions, statements, and computer programs are the
  *   property of Apple Inc. and are protected by Federal copyright
@@ -17,7 +17,8 @@
  *
  *   backendSNMPSupplies()   - Get the current supplies for a device.
  *   backend_init_supplies() - Initialize the supplies list.
- *   backend_walk_cb()       - Interpret the supply value responses...
+ *   backend_walk_cb()       - Interpret the supply value responses.
+ *   utf16_to_utf8()         - Convert UTF-16 text to UTF-8.
  */
 
 /*
  */
 
 #define CUPS_MAX_SUPPLIES      32      /* Maximum number of supplies for a printer */
+#define CUPS_SUPPLY_TIMEOUT    2.0     /* Timeout for SNMP lookups */
+
+#define CUPS_DEVELOPER_LOW             1
+#define CUPS_DEVELOPER_EMPTY           2
+#define CUPS_MARKER_SUPPLY_LOW         4
+#define CUPS_MARKER_SUPPLY_EMPTY       8
+#define CUPS_OPC_NEAR_EOL              16
+#define CUPS_OPC_LIFE_OVER             32
+#define CUPS_TONER_LOW                 64
+#define CUPS_TONER_EMPTY               128
 
 
 /*
@@ -63,10 +74,13 @@ typedef struct                              /**** Printer state table ****/
 static http_addr_t     current_addr;   /* Current address */
 static int             current_state = -1;
                                        /* Current device state bits */
+static int             charset = -1;   /* Character set for supply names */
 static int             num_supplies = 0;
                                        /* Number of supplies found */
 static backend_supplies_t supplies[CUPS_MAX_SUPPLIES];
                                        /* Supply information */
+static int             supply_state = -1;
+                                       /* Supply state info */
 
 static const int       hrDeviceDescr[] =
                        { CUPS_OID_hrDeviceDescr, 1, -1 };
@@ -77,6 +91,13 @@ static const int     hrPrinterStatus[] =
 static const int       hrPrinterDetectedErrorState[] =
                        { CUPS_OID_hrPrinterDetectedErrorState, 1, -1 };
                                        /* Current printer state bits OID */
+static const int       prtGeneralCurrentLocalization[] =
+                       { CUPS_OID_prtGeneralCurrentLocalization, 1, -1 };
+static const int       prtLocalizationCharacterSet[] =
+                       { CUPS_OID_prtLocalizationCharacterSet, 1, 1, -1 },
+                       prtLocalizationCharacterSetOffset =
+                       (sizeof(prtLocalizationCharacterSet) /
+                        sizeof(prtLocalizationCharacterSet[0]));
 static const int       prtMarkerColorantValue[] =
                        { CUPS_OID_prtMarkerColorantValue, -1 },
                                        /* Colorant OID */
@@ -130,8 +151,8 @@ static const backend_state_t const printer_states[] =
                        {
                          { CUPS_TC_lowPaper, "media-low-report" },
                          { CUPS_TC_noPaper | CUPS_TC_inputTrayEmpty, "media-empty-warning" },
-                         { CUPS_TC_lowToner, "toner-low-report" },
-                         { CUPS_TC_noToner, "toner-empty-warning" },
+                         /* { CUPS_TC_lowToner, "toner-low-report" }, */ /* now use prtMarkerSupplies */
+                         /* { CUPS_TC_noToner, "toner-empty-warning" }, */ /* now use prtMarkerSupplies */
                          { CUPS_TC_doorOpen, "door-open-report" },
                          { CUPS_TC_jammed, "media-jam-warning" },
                          /* { CUPS_TC_offline, "offline-report" }, */ /* unreliable */
@@ -143,6 +164,18 @@ static const backend_state_t const printer_states[] =
                          { CUPS_TC_outputFull, "output-area-full-warning" }
                        };
 
+static const backend_state_t const supply_states[] =
+                       {
+                         { CUPS_DEVELOPER_LOW, "developer-low-report" },
+                         { CUPS_DEVELOPER_EMPTY, "developer-empty-warning" },
+                         { CUPS_MARKER_SUPPLY_LOW, "marker-supply-low-report" },
+                         { CUPS_MARKER_SUPPLY_EMPTY, "marker-supply-empty-warning" },
+                         { CUPS_OPC_NEAR_EOL, "opc-near-eol-report" },
+                         { CUPS_OPC_LIFE_OVER, "opc-life-over-warning" },
+                         { CUPS_TONER_LOW, "toner-low-report" },
+                         { CUPS_TONER_EMPTY, "toner-empty-warning" }
+                       };
+
 
 /*
  * Local functions...
@@ -150,6 +183,8 @@ static const backend_state_t const printer_states[] =
 
 static void    backend_init_supplies(int snmp_fd, http_addr_t *addr);
 static void    backend_walk_cb(cups_snmp_t *packet, void *data);
+static void    utf16_to_utf8(cups_utf8_t *dst, const unsigned char *src,
+                             size_t srcsize, size_t dstsize, int le);
 
 
 /*
@@ -167,8 +202,8 @@ backendSNMPSupplies(
     backend_init_supplies(snmp_fd, addr);
   else if (num_supplies > 0)
     _cupsSNMPWalk(snmp_fd, &current_addr, CUPS_SNMP_VERSION_1,
-                _cupsSNMPDefaultCommunity(), prtMarkerSuppliesLevel, 0.5,
-                backend_walk_cb, NULL);
+                 _cupsSNMPDefaultCommunity(), prtMarkerSuppliesLevel,
+                 CUPS_SUPPLY_TIMEOUT, backend_walk_cb, NULL);
 
   if (page_count)
     *page_count = -1;
@@ -179,13 +214,14 @@ backendSNMPSupplies(
   if (num_supplies > 0)
   {
     int                i,                      /* Looping var */
+               percent,                /* Percent full */
                new_state,              /* New state value */
-               change_state;           /* State change */
+               change_state,           /* State change */
+               new_supply_state = 0;   /* Supply state */
     char       value[CUPS_MAX_SUPPLIES * 4],
                                        /* marker-levels value string */
                *ptr;                   /* Pointer into value string */
     cups_snmp_t        packet;                 /* SNMP response packet */
-      
 
    /*
     * Generate the marker-levels value string...
@@ -193,17 +229,84 @@ backendSNMPSupplies(
 
     for (i = 0, ptr = value; i < num_supplies; i ++, ptr += strlen(ptr))
     {
+      if (supplies[i].max_capacity > 0 && supplies[i].level >= 0)
+       percent = 100 * supplies[i].level / supplies[i].max_capacity;
+      else
+        percent = 50;
+
+      if (percent <= 5)
+      {
+        switch (supplies[i].type)
+        {
+          case CUPS_TC_toner :
+          case CUPS_TC_tonerCartridge :
+              if (percent <= 1)
+                new_supply_state |= CUPS_TONER_EMPTY;
+              else
+                new_supply_state |= CUPS_TONER_LOW;
+              break;
+          case CUPS_TC_wasteToner :
+          case CUPS_TC_wasteInk :
+              break;
+          case CUPS_TC_ink :
+          case CUPS_TC_inkCartridge :
+          case CUPS_TC_inkRibbon :
+          case CUPS_TC_solidWax :
+          case CUPS_TC_ribbonWax :
+              if (percent <= 1)
+                new_supply_state |= CUPS_MARKER_SUPPLY_EMPTY;
+              else
+                new_supply_state |= CUPS_MARKER_SUPPLY_LOW;
+              break;
+          case CUPS_TC_developer :
+              if (percent <= 1)
+                new_supply_state |= CUPS_DEVELOPER_EMPTY;
+              else
+                new_supply_state |= CUPS_DEVELOPER_LOW;
+              break;
+          case CUPS_TC_coronaWire :
+          case CUPS_TC_fuser :
+          case CUPS_TC_opc :
+          case CUPS_TC_transferUnit :
+              if (percent <= 1)
+                new_supply_state |= CUPS_OPC_LIFE_OVER;
+              else
+                new_supply_state |= CUPS_OPC_NEAR_EOL;
+              break;
+        }
+      }
+
       if (i)
         *ptr++ = ',';
 
-      if (supplies[i].max_capacity > 0)
-        sprintf(ptr, "%d", 100 * supplies[i].level / supplies[i].max_capacity);
+      if (supplies[i].max_capacity > 0 && supplies[i].level >= 0)
+        sprintf(ptr, "%d", percent);
       else
         strcpy(ptr, "-1");
     }
 
     fprintf(stderr, "ATTR: marker-levels=%s\n", value);
 
+    if (supply_state < 0)
+      change_state = 0xffff;
+    else
+      change_state = supply_state ^ new_supply_state;
+
+    fprintf(stderr, "DEBUG: new_supply_state=%x, change_state=%x\n",
+            new_supply_state, change_state);
+
+    for (i = 0;
+         i < (int)(sizeof(supply_states) / sizeof(supply_states[0]));
+         i ++)
+      if (change_state & supply_states[i].bit)
+      {
+       fprintf(stderr, "STATE: %c%s\n",
+               (new_supply_state & supply_states[i].bit) ? '+' : '-',
+               supply_states[i].keyword);
+      }
+
+    supply_state = new_supply_state;
+
    /*
     * Get the current printer status bits...
     */
@@ -213,25 +316,35 @@ backendSNMPSupplies(
                        hrPrinterDetectedErrorState))
       return (-1);
 
-    if (!_cupsSNMPRead(snmp_fd, &packet, 0.5) ||
+    if (!_cupsSNMPRead(snmp_fd, &packet, CUPS_SUPPLY_TIMEOUT) ||
         packet.object_type != CUPS_ASN1_OCTET_STRING)
       return (-1);
 
-    new_state = (packet.object_value.string.bytes[0] << 8) |
-               packet.object_value.string.bytes[1];
+    if (packet.object_value.string.num_bytes == 2)
+      new_state = (packet.object_value.string.bytes[0] << 8) |
+                 packet.object_value.string.bytes[1];
+    else if (packet.object_value.string.num_bytes == 1)
+      new_state = (packet.object_value.string.bytes[0] << 8);
+    else
+      new_state = 0;
 
     if (current_state < 0)
       change_state = 0xffff;
     else
       change_state = current_state ^ new_state;
 
+    fprintf(stderr, "DEBUG: new_state=%x, change_state=%x\n", new_state,
+            change_state);
+
     for (i = 0;
          i < (int)(sizeof(printer_states) / sizeof(printer_states[0]));
          i ++)
       if (change_state & printer_states[i].bit)
+      {
        fprintf(stderr, "STATE: %c%s\n",
-               (new_state & printer_states[i].bit) ? '+' : '-',
+               (new_state & printer_states[i].bit) ? '+' : '-',
                printer_states[i].keyword);
+      }
 
     current_state = new_state;
 
@@ -246,7 +359,7 @@ backendSNMPSupplies(
                         hrPrinterStatus))
        return (-1);
 
-      if (!_cupsSNMPRead(snmp_fd, &packet, 0.5) ||
+      if (!_cupsSNMPRead(snmp_fd, &packet, CUPS_SUPPLY_TIMEOUT) ||
          packet.object_type != CUPS_ASN1_INTEGER)
        return (-1);
 
@@ -264,7 +377,7 @@ backendSNMPSupplies(
                         prtMarkerLifeCount))
        return (-1);
 
-      if (!_cupsSNMPRead(snmp_fd, &packet, 0.5) ||
+      if (!_cupsSNMPRead(snmp_fd, &packet, CUPS_SUPPLY_TIMEOUT) ||
          packet.object_type != CUPS_ASN1_COUNTER)
        return (-1);
 
@@ -348,6 +461,7 @@ backend_init_supplies(
   current_addr  = *addr;
   current_state = -1;
   num_supplies  = -1;
+  charset       = -1;
 
   memset(supplies, 0, sizeof(supplies));
 
@@ -355,9 +469,9 @@ backend_init_supplies(
   * See if we should be getting supply levels via SNMP...
   */
 
-  if ((ppd = ppdOpenFile(getenv("PPD"))) != NULL &&
-      (ppdattr = ppdFindAttr(ppd, "cupsSNMPSupplies", NULL)) != NULL &&
-      ppdattr->value && strcasecmp(ppdattr->value, "true"))
+  if ((ppd = ppdOpenFile(getenv("PPD"))) == NULL ||
+      ((ppdattr = ppdFindAttr(ppd, "cupsSNMPSupplies", NULL)) != NULL &&
+       ppdattr->value && _cups_strcasecmp(ppdattr->value, "true")))
   {
     ppdClose(ppd);
     return;
@@ -374,7 +488,7 @@ backend_init_supplies(
                     hrDeviceDescr))
     return;
 
-  if (!_cupsSNMPRead(snmp_fd, &packet, 0.5) ||
+  if (!_cupsSNMPRead(snmp_fd, &packet, CUPS_SUPPLY_TIMEOUT) ||
       packet.object_type != CUPS_ASN1_OCTET_STRING)
   {
     strlcpy(description, "Unknown", sizeof(description));
@@ -384,6 +498,8 @@ backend_init_supplies(
     strlcpy(description, (char *)packet.object_value.string.bytes,
             sizeof(description));
 
+  fprintf(stderr, "DEBUG2: hrDeviceDesc=\"%s\"\n", description);
+
  /*
   * See if we have already queried this device...
   */
@@ -401,28 +517,31 @@ backend_init_supplies(
    /*
     * Yes, read the cache file:
     *
-    *     1 num_supplies
+    *     2 num_supplies charset
     *     device description
     *     supply structures...
     */
 
     if (cupsFileGets(cachefile, value, sizeof(value)))
     {
-      if (sscanf(value, "1 %d", &num_supplies) == 1 &&
+      if (sscanf(value, "2 %d%d", &num_supplies, &charset) == 2 &&
           num_supplies <= CUPS_MAX_SUPPLIES &&
           cupsFileGets(cachefile, value, sizeof(value)))
       {
-        if ((ptr = value + strlen(value) - 1) >= value && *ptr == '\n')
-         *ptr = '\n';
-
         if (!strcmp(description, value))
          cupsFileRead(cachefile, (char *)supplies,
                       num_supplies * sizeof(backend_supplies_t));
         else
+       {
          num_supplies = -1;
+         charset      = -1;
+       }
       }
       else
+      {
         num_supplies = -1;
+       charset      = -1;
+      }
     }
 
     cupsFileClose(cachefile);
@@ -432,6 +551,55 @@ backend_init_supplies(
   * If the cache information isn't correct, scan for supplies...
   */
 
+  if (charset < 0)
+  {
+   /*
+    * Get the configured character set...
+    */
+
+    int        oid[CUPS_SNMP_MAX_OID];         /* OID for character set */
+
+
+    if (!_cupsSNMPWrite(snmp_fd, &current_addr, CUPS_SNMP_VERSION_1,
+                       _cupsSNMPDefaultCommunity(), CUPS_ASN1_GET_REQUEST, 1,
+                       prtGeneralCurrentLocalization))
+      return;
+
+    if (!_cupsSNMPRead(snmp_fd, &packet, CUPS_SUPPLY_TIMEOUT) ||
+       packet.object_type != CUPS_ASN1_INTEGER)
+    {
+      fprintf(stderr,
+              "DEBUG: prtGeneralCurrentLocalization type is %x, expected %x!\n",
+             packet.object_type, CUPS_ASN1_INTEGER);
+      return;
+    }
+
+    fprintf(stderr, "DEBUG2: prtGeneralCurrentLocalization=%d\n",
+            packet.object_value.integer);
+
+    _cupsSNMPCopyOID(oid, prtLocalizationCharacterSet, CUPS_SNMP_MAX_OID);
+    oid[prtLocalizationCharacterSetOffset - 2] = packet.object_value.integer;
+
+
+    if (!_cupsSNMPWrite(snmp_fd, &current_addr, CUPS_SNMP_VERSION_1,
+                       _cupsSNMPDefaultCommunity(), CUPS_ASN1_GET_REQUEST, 1,
+                       oid))
+      return;
+
+    if (!_cupsSNMPRead(snmp_fd, &packet, CUPS_SUPPLY_TIMEOUT) ||
+       packet.object_type != CUPS_ASN1_INTEGER)
+    {
+      fprintf(stderr,
+              "DEBUG: prtLocalizationCharacterSet type is %x, expected %x!\n",
+             packet.object_type, CUPS_ASN1_INTEGER);
+      return;
+    }
+
+    fprintf(stderr, "DEBUG2: prtLocalizationCharacterSet=%d\n",
+           packet.object_value.integer);
+    charset = packet.object_value.integer;
+  }
+
   if (num_supplies < 0)
   {
    /*
@@ -439,8 +607,8 @@ backend_init_supplies(
     */
 
     _cupsSNMPWalk(snmp_fd, &current_addr, CUPS_SNMP_VERSION_1,
-                _cupsSNMPDefaultCommunity(), prtMarkerSuppliesEntry, 0.5,
-                backend_walk_cb, NULL);
+                 _cupsSNMPDefaultCommunity(), prtMarkerSuppliesEntry,
+                 CUPS_SUPPLY_TIMEOUT, backend_walk_cb, NULL);
   }
 
  /*
@@ -452,7 +620,7 @@ backend_init_supplies(
 
   if ((cachefile = cupsFileOpen(cachefilename, "w")) != NULL)
   {
-    cupsFilePrintf(cachefile, "1 %d\n", num_supplies);
+    cupsFilePrintf(cachefile, "2 %d %d\n", num_supplies, charset);
     cupsFilePrintf(cachefile, "%s\n", description);
 
     if (num_supplies > 0)
@@ -473,8 +641,8 @@ backend_init_supplies(
     strcpy(supplies[i].color, "none");
 
   _cupsSNMPWalk(snmp_fd, &current_addr, CUPS_SNMP_VERSION_1,
-               _cupsSNMPDefaultCommunity(), prtMarkerColorantValue, 0.5,
-              backend_walk_cb, NULL);
+                _cupsSNMPDefaultCommunity(), prtMarkerColorantValue,
+               CUPS_SUPPLY_TIMEOUT, backend_walk_cb, NULL);
 
  /*
   * Output the marker-colors attribute...
@@ -536,7 +704,7 @@ backend_init_supplies(
 
 
 /*
- * 'backend_walk_cb()' - Interpret the supply value responses...
+ * 'backend_walk_cb()' - Interpret the supply value responses.
  */
 
 static void
@@ -612,14 +780,84 @@ backend_walk_cb(cups_snmp_t *packet,      /* I - SNMP packet */
         packet->object_type != CUPS_ASN1_OCTET_STRING)
       return;
 
-    fprintf(stderr, "DEBUG2: prtMarkerSuppliesDescription.1.%d = \"%s\"\n", i,
-            (char *)packet->object_value.string.bytes);
-
     if (i > num_supplies)
       num_supplies = i;
 
-    strlcpy(supplies[i - 1].name, (char *)packet->object_value.string.bytes,
-            sizeof(supplies[0].name));
+    switch (charset)
+    {
+      case CUPS_TC_csASCII :
+      case CUPS_TC_csUTF8 :
+      case CUPS_TC_csUnicodeASCII :
+         strlcpy(supplies[i - 1].name,
+                 (char *)packet->object_value.string.bytes,
+                 sizeof(supplies[0].name));
+          break;
+
+      case CUPS_TC_csISOLatin1 :
+      case CUPS_TC_csUnicodeLatin1 :
+         cupsCharsetToUTF8((cups_utf8_t *)supplies[i - 1].name,
+                           (char *)packet->object_value.string.bytes,
+                           sizeof(supplies[0].name), CUPS_ISO8859_1);
+          break;
+
+      case CUPS_TC_csShiftJIS :
+         cupsCharsetToUTF8((cups_utf8_t *)supplies[i - 1].name,
+                           (char *)packet->object_value.string.bytes,
+                           sizeof(supplies[0].name), CUPS_JIS_X0213);
+          break;
+
+      case CUPS_TC_csUCS4 :
+      case CUPS_TC_csUTF32 :
+      case CUPS_TC_csUTF32BE :
+      case CUPS_TC_csUTF32LE :
+         cupsUTF32ToUTF8((cups_utf8_t *)supplies[i - 1].name,
+                         (cups_utf32_t *)packet->object_value.string.bytes,
+                         sizeof(supplies[0].name));
+          break;
+
+      case CUPS_TC_csUnicode :
+      case CUPS_TC_csUTF16BE :
+      case CUPS_TC_csUTF16LE :
+         utf16_to_utf8((cups_utf8_t *)supplies[i - 1].name,
+                       packet->object_value.string.bytes,
+                       packet->object_value.string.num_bytes,
+                       sizeof(supplies[0].name), charset == CUPS_TC_csUTF16LE);
+          break;
+
+      default :
+        /*
+         * If we get here, the printer is using an unknown character set and
+         * we just want to copy characters that look like ASCII...
+         */
+
+          {
+           char        *src, *dst;     /* Pointers into strings */
+
+
+           /*
+           * Loop safe because both the object_value and supplies char arrays
+           * are CUPS_SNMP_MAX_STRING elements long.
+           */
+
+            for (src = (char *)packet->object_value.string.bytes,
+                    dst = supplies[i - 1].name;
+                *src;
+                src ++)
+           {
+             if ((*src & 0x80) || *src < ' ' || *src == 0x7f)
+               *dst++ = '?';
+             else
+               *dst++ = *src;
+           }
+
+           *dst = '\0';
+         }
+         break;
+    }
+
+    fprintf(stderr, "DEBUG2: prtMarkerSuppliesDescription.1.%d = \"%s\"\n", i,
+            supplies[i - 1].name);
+
   }
   else if (_cupsSNMPIsOIDPrefixed(packet, prtMarkerSuppliesLevel))
   {
@@ -681,6 +919,67 @@ backend_walk_cb(cups_snmp_t *packet,       /* I - SNMP packet */
 }
 
 
+/*
+ * 'utf16_to_utf8()' - Convert UTF-16 text to UTF-8.
+ */
+
+static void
+utf16_to_utf8(
+    cups_utf8_t         *dst,          /* I - Destination buffer */
+    const unsigned char *src,          /* I - Source string */
+    size_t             srcsize,        /* I - Size of source string */
+    size_t              dstsize,       /* I - Size of destination buffer */
+    int                 le)            /* I - Source is little-endian? */
+{
+  cups_utf32_t ch,                     /* Current character */
+               temp[CUPS_SNMP_MAX_STRING],
+                                       /* UTF-32 string */
+               *ptr;                   /* Pointer into UTF-32 string */
+
+
+  for (ptr = temp; srcsize >= 2;)
+  {
+    if (le)
+      ch = src[0] | (src[1] << 8);
+    else
+      ch = (src[0] << 8) | src[1];
+
+    src += 2;
+    srcsize -= 2;
+
+    if (ch >= 0xd800 && ch <= 0xdbff && srcsize >= 2)
+    {
+     /*
+      * Multi-word UTF-16 char...
+      */
+
+      int lch;                 /* Lower word */
+
+
+      if (le)
+       lch = src[0] | (src[1] << 8);
+      else
+       lch = (src[0] << 8) | src[1];
+
+      if (lch >= 0xdc00 && lch <= 0xdfff)
+      {
+       src += 2;
+       srcsize -= 2;
+
+       ch = (((ch & 0x3ff) << 10) | (lch & 0x3ff)) + 0x10000;
+      }
+    }
+
+    if (ptr < (temp + CUPS_SNMP_MAX_STRING - 1))
+      *ptr++ = ch;
+  }
+
+  *ptr = '\0';
+
+  cupsUTF32ToUTF8(dst, temp, dstsize);
+}
+
+
 /*
  * End of "$Id$".
  */