SecuritySNACCRuntime/c++-lib/inc/asn-octs.h

   1 /*
   2  * Copyright (c) 2000-2001 Apple Computer, Inc. All Rights Reserved.
   3  *
   4  * The contents of this file constitute Original Code as defined in and are
   5  * subject to the Apple Public Source License Version 1.2 (the 'License').
   6  * You may not use this file except in compliance with the License. Please obtain
   7  * a copy of the License at http://www.apple.com/publicsource and read it before
   8  * using this file.
   9  *
  10  * This Original Code and all software distributed under the License are
  11  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
  12  * OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, INCLUDING WITHOUT
  13  * LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
  14  * PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. Please see the License for the
  15  * specific language governing rights and limitations under the License.
  16  */
  17
  18
  19 // file: .../c++-lib/inc/asn-octs.h - ASN.1 OCTET STRING type
  20 //
  21 //  Mike Sample
  22 //  92/07/02
  23 // Copyright (C) 1992 Michael Sample and the University of British Columbia
  24 //
  25 // This library is free software; you can redistribute it and/or
  26 // modify it provided that this copyright/license information is retained
  27 // in original form.
  28 //
  29 // If you modify this file, you must clearly indicate your changes.
  30 //
  31 // This source code is distributed in the hope that it will be
  32 // useful, but WITHOUT ANY WARRANTY; without even the implied warranty
  33 // of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  34 //
  35 //
  36 // ------------------------------------------------------------------------
  37 // -  J.G. Van Dyke & Associates, Inc. Modification History of SNACC 1.3  -
  38 // ------------------------------------------------------------------------
  39 //
  40 // All modification are relative to the v1.3 of SNACC.  We used SunOS 4.1.3's
  41 // SCCS.  The revision #'s start at 1.1,  which is the original version from
  42 // SNACC 1.3.
  43 //
  44 //
  45 // ../SCCS/s.asn-octs.h:
  46 //
  47 // D 1.3        98/04/24 22:46:51 pleonber      3 2     00002/00000/00129
  48 // added INSERT_VDA_COMMENTS for script that adds SCCS history to file
  49 //
  50 // D 1.2        97/11/11 15:53:59 dharris       2 1     00004/00000/00125
  51 // changed == operator overide to remove warning
  52 //
  53 // D 1.1        97/11/11 15:50:52 cmmaster      1 0     00125/00000/00000
  54 // date and time created 97/11/11 15:50:52 by cmmaster
  55 //
  56 // ----------------------- End of VDA Modifications ---------------------------
  57 //
  58 //
  59 //
  60 // $Header: /cvs/Darwin/Security/SecuritySNACCRuntime/c++-lib/inc/asn-octs.h,v 1.1.1.1 2001/05/18 23:14:06 mb Exp $
  61 // $Log: asn-octs.h,v $
  62 // Revision 1.1.1.1  2001/05/18 23:14:06  mb
  63 // Move from private repository to open source repository
  64 //
  65 // Revision 1.3  2001/05/05 00:59:18  rmurphy
  66 // Adding darwin license headers
  67 //
  68 // Revision 1.2  2000/06/15 18:48:24  dmitch
  69 // Snacc-generated source files, now part of CVS tree to allow for cross-platform build of snaccRuntime.
  70 //
  71 // Revision 1.1.1.1  2000/03/09 01:00:05  rmurphy
  72 // Base Fortissimo Tree
  73 //
  74 // Revision 1.3  1999/03/21 02:07:33  mb
  75 // Added Copy to every AsnType.
  76 //
  77 // Revision 1.2  1999/03/18 22:35:27  mb
  78 // Made all destructors virtual.
  79 //
  80 // Revision 1.1  1999/02/25 05:21:44  mb
  81 // Added snacc c++ library
  82 //
  83 // Revision 1.5  1997/02/16 20:25:40  rj
  84 // check-in of a few cosmetic changes
  85 //
  86 // Revision 1.4  1995/07/24  17:46:52  rj
  87 // operator == and != return bool instead of int.
  88 //
  89 // #if TCL ... #endif wrapped into #if META ... #endif
  90 //
  91 // changed `_' to `-' in file names.
  92 //
  93 // Revision 1.3  1994/10/08  04:18:07  rj
  94 // code for meta structures added (provides information about the generated code itself).
  95 //
  96 // code for Tcl interface added (makes use of the above mentioned meta code).
  97 //
  98 // virtual inline functions (the destructor, the Clone() function, BEnc(), BDec() and Print()) moved from inc/*.h to src/*.C because g++ turns every one of them into a static non-inline function in every file where the .h file gets included.
  99 //
 100 // made Print() const (and some other, mainly comparison functions).
 101 //
 102 // several `unsigned long int' turned into `size_t'.
 103 //
 104 // Revision 1.2  1994/08/28  10:00:53  rj
 105 // comment leader fixed.
 106 //
 107 // Revision 1.1  1994/08/28  09:20:39  rj
 108 // first check-in. for a list of changes to the snacc-1.1 distribution please refer to the ChangeLog.
 109
 110 #ifndef _asn_octs_h_
 111 #define _asn_octs_h_
 112
 113 #include <string.h>
 114
 115 class AsnOcts: public AsnType
 116 {
 117 private:
 118   int                           OctsEquiv (const AsnOcts &o) const;
 119
 120   void                          FillBitStringStk (BUF_TYPE b, AsnLen elmtLen0, AsnLen& bytesDecoded, ENV_TYPE env);
 121
 122   void                          BDecConsOcts (BUF_TYPE b, AsnLen elmtLen, AsnLen &bytesDecoded, ENV_TYPE env);
 123
 124 protected:
 125   size_t                        octetLen;
 126   char                          *octs;
 127
 128 public:
 129
 130   // constructor and Set alway copy strings so destructor can always delete
 131                                 AsnOcts():
 132                                   octetLen (0),
 133                                   octs (NULL)
 134                                 {}
 135                                 AsnOcts (const char *str)               { Set (str); }
 136                                 AsnOcts (const char *str, const size_t len)
 137                                                                         { Set (str, len); }
 138                                 AsnOcts (const AsnOcts &o)              { Set (o); }
 139 #ifndef _IBM_ENC_
 140   virtual               ~AsnOcts();
 141 #else
 142   virtual               ~AsnOcts()                              { mem_mgr_ptr->Put ((void *)octs); }    // Guido Grassel, 11.8.93
 143 #endif /* _IBM_ENC_ */
 144
 145   virtual AsnType       *Clone() const;
 146   virtual AsnType       *Copy() const;
 147
 148   AsnOcts                       &operator = (const AsnOcts &o)          { ReSet (o); return *this; }
 149   AsnOcts                       &operator = (const char *str)           { ReSet (str); return *this; }
 150
 151   // these set the octs and octetLen values
 152   void                          Set (const char *str, size_t len);
 153   void                          Set (const AsnOcts &o);
 154   void                          Set (const char *str);
 155
 156   // these free the old octs value and
 157   // then reset the octs and octetLen values
 158   void                          ReSet (const char *str, size_t len);
 159   void                          ReSet (const AsnOcts &o);
 160   void                          ReSet (const char *str);
 161
 162   size_t                        Len() const                             { return octetLen; }
 163                                 operator const char* () const           { return octs; }
 164                                 operator char* ()                       { return octs; }
 165
 166 #ifdef VDADER_RULES
 167   bool operator == (const AsnOcts &o) const { if (OctsEquiv(o)) return true; else return false; }
 168 #else
 169   bool                          operator == (const AsnOcts &o) const    { return OctsEquiv (o); }
 170 #endif
 171   bool                          operator != (const AsnOcts &o) const    { return !OctsEquiv (o); }
 172
 173   AsnLen                        BEncContent (BUF_TYPE b);
 174   void                          BDecContent (BUF_TYPE b, AsnTag tagId, AsnLen elmtLen, AsnLen &bytesDecoded, ENV_TYPE env);
 175   AsnLen                        BEnc (BUF_TYPE b);
 176   void                          BDec (BUF_TYPE b, AsnLen &bytesDecoded, ENV_TYPE env);
 177
 178   PDU_MEMBER_MACROS
 179
 180   void                          Print (ostream &os) const;
 181
 182 #if META
 183   static const AsnOctsTypeDesc  _desc;
 184
 185   const AsnTypeDesc             *_getdesc() const;
 186
 187 #if TCL
 188   int                           TclGetVal (Tcl_Interp *) const;
 189   int                           TclSetVal (Tcl_Interp *, const char *val);
 190 #endif /* TCL */
 191 #endif /* META */
 192 };
 193
 194 #endif /* conditional include */