text: /* a_strnid.c */
  /* Written by Dr Stephen N Henson (shenson@bigfoot.com) for the OpenSSL
   * project 1999.
   */
  /* ====================================================================
   * Copyright (c) 1999 The OpenSSL Project.  All rights reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer. 
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. All advertising materials mentioning features or use of this
   *    software must display the following acknowledgment:
   *    "This product includes software developed by the OpenSSL Project
   *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
   *
   * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
   *    endorse or promote products derived from this software without
   *    prior written permission. For written permission, please contact
   *    licensing@OpenSSL.org.
   *
   * 5. Products derived from this software may not be called "OpenSSL"
   *    nor may "OpenSSL" appear in their names without prior written
   *    permission of the OpenSSL Project.
   *
   * 6. Redistributions of any form whatsoever must retain the following
   *    acknowledgment:
   *    "This product includes software developed by the OpenSSL Project
   *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
   *
   * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
   * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
   * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
   * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
   * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
   * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
   * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
   * OF THE POSSIBILITY OF SUCH DAMAGE.
   * ====================================================================
   *
   * This product includes cryptographic software written by Eric Young
   * (eay@cryptsoft.com).  This product includes software written by Tim
   * Hudson (tjh@cryptsoft.com).
   *
   */
  
  #include <stdio.h>
  #include <ctype.h>
  #include "cryptlib.h"
  #include <openssl/asn1.h>
  #include <openssl/objects.h>
  
  
  static STACK_OF(ASN1_STRING_TABLE) *stable = NULL;
  static void st_free(ASN1_STRING_TABLE *tbl);
  static int sk_table_cmp(const ASN1_STRING_TABLE * const *a,
  			const ASN1_STRING_TABLE * const *b);
  static int table_cmp(const void *a, const void *b);
  
  
  /* This is the global mask for the mbstring functions: this is use to
   * mask out certain types (such as BMPString and UTF8String) because
   * certain software (e.g. Netscape) has problems with them.
   */
  
  static unsigned long global_mask = 0xFFFFFFFFL;
  
  void ASN1_STRING_set_default_mask(unsigned long mask)
  {
  	global_mask = mask;
  }
  
  unsigned long ASN1_STRING_get_default_mask(void)
  {
  	return global_mask;
  }
  
  /* This function sets the default to various "flavours" of configuration.
   * based on an ASCII string. Currently this is:
   * MASK:XXXX : a numerical mask value.
   * nobmp : Don't use BMPStrings (just Printable, T61).
   * pkix : PKIX recommendation in RFC2459.
   * utf8only : only use UTF8Strings (RFC2459 recommendation for 2004).
   * default:   the default value, Printable, T61, BMP.
   */
  
  int ASN1_STRING_set_default_mask_asc(char *p)
  {
  	unsigned long mask;
  	char *end;
  	if(!strncmp(p, "MASK:", 5)) {
  		if(!p[5]) return 0;
  		mask = strtoul(p + 5, &end, 0);
  		if(*end) return 0;
  	} else if(!strcmp(p, "nombstr"))
  		mask = ~((unsigned long)(B_ASN1_BMPSTRING|B_ASN1_UTF8STRING));
  	else if(!strcmp(p, "pkix"))
  			mask = ~((unsigned long)B_ASN1_T61STRING);
  	else if(!strcmp(p, "utf8only")) mask = B_ASN1_UTF8STRING;
  	else if(!strcmp(p, "default"))
  	    mask = 0xFFFFFFFFL;
  	else return 0;
  	ASN1_STRING_set_default_mask(mask);
  	return 1;
  }
  
  /* The following function generates an ASN1_STRING based on limits in a table.
   * Frequently the types and length of an ASN1_STRING are restricted by a 
   * corresponding OID. For example certificates and certificate requests.
   */
  
  ASN1_STRING *ASN1_STRING_set_by_NID(ASN1_STRING **out, const unsigned char *in,
  					int inlen, int inform, int nid)
  {
  	ASN1_STRING_TABLE *tbl;
  	ASN1_STRING *str = NULL;
  	unsigned long mask;
  	int ret;
  	if(!out) out = &str;
  	tbl = ASN1_STRING_TABLE_get(nid);
  	if(tbl) {
  		mask = tbl->mask;
  		if(!(tbl->flags & STABLE_NO_MASK)) mask &= global_mask;
  		ret = ASN1_mbstring_ncopy(out, in, inlen, inform, mask,
  					tbl->minsize, tbl->maxsize);
  	} else ret = ASN1_mbstring_copy(out, in, inlen, inform, DIRSTRING_TYPE & global_mask);
  	if(ret <= 0) return NULL;
  	return *out;
  }
  
  /* Now the tables and helper functions for the string table:
   */
  
  /* size limits: this stuff is taken straight from RFC2459 */
  
  #define ub_name				32768
  #define ub_common_name			64
  #define ub_locality_name		128
  #define ub_state_name			128
  #define ub_organization_name		64
  #define ub_organization_unit_name	64
  #define ub_title			64
  #define ub_email_address		128
  
  /* This table must be kept in NID order */
  
  static ASN1_STRING_TABLE tbl_standard[] = {
  {NID_commonName,		1, ub_common_name, DIRSTRING_TYPE, 0},
  {NID_countryName,		2, 2, B_ASN1_PRINTABLESTRING, STABLE_NO_MASK},
  {NID_localityName,		1, ub_locality_name, DIRSTRING_TYPE, 0},
  {NID_stateOrProvinceName,	1, ub_state_name, DIRSTRING_TYPE, 0},
  {NID_organizationName,		1, ub_organization_name, DIRSTRING_TYPE, 0},
  {NID_organizationalUnitName,	1, ub_organization_unit_name, DIRSTRING_TYPE, 0},
  {NID_pkcs9_emailAddress,	1, ub_email_address, B_ASN1_IA5STRING, STABLE_NO_MASK},
  {NID_pkcs9_unstructuredName,	1, -1, PKCS9STRING_TYPE, 0},
  {NID_pkcs9_challengePassword,	1, -1, PKCS9STRING_TYPE, 0},
  {NID_pkcs9_unstructuredAddress,	1, -1, DIRSTRING_TYPE, 0},
  {NID_givenName,			1, ub_name, DIRSTRING_TYPE, 0},
  {NID_surname,			1, ub_name, DIRSTRING_TYPE, 0},
  {NID_initials,			1, ub_name, DIRSTRING_TYPE, 0},
  {NID_name,			1, ub_name, DIRSTRING_TYPE, 0},
  {NID_dnQualifier,		-1, -1, B_ASN1_PRINTABLESTRING, STABLE_NO_MASK}
  };
  
  static int sk_table_cmp(const ASN1_STRING_TABLE * const *a,
  			const ASN1_STRING_TABLE * const *b)
  {
  	return (*a)->nid - (*b)->nid;
  }
  
  static int table_cmp(const void *a, const void *b)
  {
  	const ASN1_STRING_TABLE *sa = a, *sb = b;
  	return sa->nid - sb->nid;
  }
  
  ASN1_STRING_TABLE *ASN1_STRING_TABLE_get(int nid)
  {
  	int idx;
  	ASN1_STRING_TABLE *ttmp;
  	ASN1_STRING_TABLE fnd;
  	fnd.nid = nid;
  	ttmp = (ASN1_STRING_TABLE *) OBJ_bsearch((char *)&fnd,
  					(char *)tbl_standard, 
  			sizeof(tbl_standard)/sizeof(ASN1_STRING_TABLE),
  			sizeof(ASN1_STRING_TABLE), table_cmp);
  	if(ttmp) return ttmp;
  	if(!stable) return NULL;
  	idx = sk_ASN1_STRING_TABLE_find(stable, &fnd);
  	if(idx < 0) return NULL;
  	return sk_ASN1_STRING_TABLE_value(stable, idx);
  }
  	
  int ASN1_STRING_TABLE_add(int nid,
  		 long minsize, long maxsize, unsigned long mask,
  				unsigned long flags)
  {
  	ASN1_STRING_TABLE *tmp;
  	char new_nid = 0;
  	flags &= ~STABLE_FLAGS_MALLOC;
  	if(!stable) stable = sk_ASN1_STRING_TABLE_new(sk_table_cmp);
  	if(!stable) {
  		ASN1err(ASN1_F_ASN1_STRING_TABLE_ADD, ERR_R_MALLOC_FAILURE);
  		return 0;
  	}
  	if(!(tmp = ASN1_STRING_TABLE_get(nid))) {
  		tmp = OPENSSL_malloc(sizeof(ASN1_STRING_TABLE));
  		if(!tmp) {
  			ASN1err(ASN1_F_ASN1_STRING_TABLE_ADD,
  							ERR_R_MALLOC_FAILURE);
  			return 0;
  		}
  		tmp->flags = flags | STABLE_FLAGS_MALLOC;
  		tmp->nid = nid;
  		new_nid = 1;
  	} else tmp->flags = (tmp->flags & STABLE_FLAGS_MALLOC) | flags;
  	if(minsize != -1) tmp->minsize = minsize;
  	if(maxsize != -1) tmp->maxsize = maxsize;
  	tmp->mask = mask;
  	if(new_nid) sk_ASN1_STRING_TABLE_push(stable, tmp);
  	return 1;
  }
  
  void ASN1_STRING_TABLE_cleanup(void)
  {
  	STACK_OF(ASN1_STRING_TABLE) *tmp;
  	tmp = stable;
  	if(!tmp) return;
  	stable = NULL;
  	sk_ASN1_STRING_TABLE_pop_free(tmp, st_free);
  }
  
  static void st_free(ASN1_STRING_TABLE *tbl)
  {
  	if(tbl->flags & STABLE_FLAGS_MALLOC) OPENSSL_free(tbl);
  }
  
  IMPLEMENT_STACK_OF(ASN1_STRING_TABLE)
  