prvrsion.h
上传用户:goldcmy89
上传日期:2017-12-03
资源大小:2246k
文件大小:5k
源码类别:

PlugIns编程

开发平台:

Visual C++

  1. /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
  2. /* ***** BEGIN LICENSE BLOCK *****
  3.  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
  4.  *
  5.  * The contents of this file are subject to the Mozilla Public License Version
  6.  * 1.1 (the "License"); you may not use this file except in compliance with
  7.  * the License. You may obtain a copy of the License at
  8.  * http://www.mozilla.org/MPL/
  9.  *
  10.  * Software distributed under the License is distributed on an "AS IS" basis,
  11.  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  12.  * for the specific language governing rights and limitations under the
  13.  * License.
  14.  *
  15.  * The Original Code is the Netscape Portable Runtime (NSPR).
  16.  *
  17.  * The Initial Developer of the Original Code is
  18.  * Netscape Communications Corporation.
  19.  * Portions created by the Initial Developer are Copyright (C) 1998-2000
  20.  * the Initial Developer. All Rights Reserved.
  21.  *
  22.  * Contributor(s):
  23.  *
  24.  * Alternatively, the contents of this file may be used under the terms of
  25.  * either the GNU General Public License Version 2 or later (the "GPL"), or
  26.  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  27.  * in which case the provisions of the GPL or the LGPL are applicable instead
  28.  * of those above. If you wish to allow use of your version of this file only
  29.  * under the terms of either the GPL or the LGPL, and not to allow others to
  30.  * use your version of this file under the terms of the MPL, indicate your
  31.  * decision by deleting the provisions above and replace them with the notice
  32.  * and other provisions required by the GPL or the LGPL. If you do not delete
  33.  * the provisions above, a recipient may use your version of this file under
  34.  * the terms of any one of the MPL, the GPL or the LGPL.
  35.  *
  36.  * ***** END LICENSE BLOCK ***** */
  37. /* author: jstewart */
  38. #if defined(_PRVERSION_H)
  39. #else
  40. #define _PRVERSION_H
  41. #include "prtypes.h"
  42. PR_BEGIN_EXTERN_C
  43. /* All components participating in the PR version protocol must expose
  44.  * a structure and a function. The structure is defined below and named
  45.  * according to the naming conventions outlined further below.  The function
  46.  * is called libVersionPoint and returns a pointer to this structure.
  47.  */
  48. /* on NT, always pack the structure the same. */
  49. #ifdef _WIN32
  50. #pragma pack(push, 8)
  51. #endif
  52. typedef struct {
  53.     /*
  54.      * The first field defines which version of this structure is in use.
  55.      * At this time, only version 2 is specified. If this value is not 
  56.      * 2, you must read no further into the structure.
  57.      */
  58.     PRInt32    version; 
  59.   
  60.     /* for Version 2, this is the body format. */
  61.     PRInt64         buildTime;      /* 64 bits - usecs since midnight, 1/1/1970 */
  62.     char *          buildTimeString;/* a human readable version of the time */
  63.   
  64.     PRUint8   vMajor;               /* Major version of this component */
  65.     PRUint8   vMinor;               /* Minor version of this component */
  66.     PRUint8   vPatch;               /* Patch level of this component */
  67.   
  68.     PRBool          beta;           /* true if this is a beta component */
  69.     PRBool          debug;          /* true if this is a debug component */
  70.     PRBool          special;        /* true if this component is a special build */
  71.   
  72.     char *          filename;       /* The original filename */
  73.     char *          description;    /* description of this component */
  74.     char *          security;       /* level of security in this component */
  75.     char *          copyright;      /* The copyright for this file */
  76.     char *          comment;        /* free form field for misc usage */
  77.     char *          specialString;  /* the special variant for this build */
  78. } PRVersionDescription;
  79. /* on NT, restore the previous packing */
  80. #ifdef _WIN32
  81. #pragma pack(pop)
  82. #endif
  83. /*
  84.  * All components must define an entrypoint named libVersionPoint which
  85.  * is of type versionEntryPointType.
  86.  *
  87.  * For example, for a library named libfoo, we would have:
  88.  *
  89.  *   PRVersionDescription prVersionDescription_libfoo =
  90.  *   {
  91.  *       ...
  92.  *   };
  93.  *
  94.  *   PR_IMPLEMENT(const PRVersionDescription*) libVersionPoint(void)
  95.  *   {
  96.  *       return &prVersionDescription_libfoo;
  97.  *   }
  98.  */
  99. typedef const PRVersionDescription *(*versionEntryPointType)(void);
  100. /* 
  101.  * Where you declare your libVersionPoint, do it like this: 
  102.  * PR_IMPLEMENT(const PRVersionDescription *) libVersionPoint(void) {
  103.  *  fill it in...
  104.  * }
  105.  */
  106. /*
  107.  * NAMING CONVENTION FOR struct
  108.  *
  109.  * all components should also expose a static PRVersionDescription
  110.  * The name of the struct should be calculated as follows:
  111.  * Take the value of filename. (If filename is not specified, calculate
  112.  * a short, unique string.)  Convert all non-alphanumeric characters
  113.  * to '_'.  To this, prepend "PRVersionDescription_".  Thus for libfoo.so,
  114.  * the symbol name is "PRVersionDescription_libfoo_so".
  115.  * so the file should have
  116.  * PRVersionDescription PRVersionDescription_libfoo_so { fill it in };
  117.  * on NT, this file should be declspec export.
  118.  */
  119. PR_END_EXTERN_C
  120. #endif  /* defined(_PRVERSION_H) */
  121. /* prvrsion.h */