README

   1 Update Feb 25, 2019
   2
   3 This project has many aggregate top-level targets. These map directly to build system aliases of Security in the obvious way:
   4 Alias                                   macOS Target                              iOS Target                                bridgeOS Target               tvOS Target                       watchOS Target
   5 --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
   6 Security                             |  Security_frameworks_osx                |  Security_frameworks_ios                |  Security_frameworks_bridge  | Security_frameworks_tvos        | Security_frameworks_watchos
   7 Security_executables_core            |  Security_executables_core_osx          |  Security_executables_core_ios          |                              | Security_executables_core_tvos  | Security_executables_core_watchos
   8 Security_executables                 |  Security_executables_osx               |  Security_executables_ios               |  Security_executables_bridge | Security_executables_tvos       | Security_executables_watchos
   9 Security_internal                    |  Security_internal_osx                  |  Security_internal_ios                  |                              | Security_internal_tvos          | Security_internal_watchos
  10 Security_executables_Swift           |  Security_executables_Swift             |  Security_executables_Swift             |                              | Security_executables_Swift      |
  11 Security_tests                       |  Security_tests_osx                     |  Security_tests_ios                     |  Security_tests_bridge       | Security_tests_tvos             | Security_tests_watchos
  12 Security_executables_darwinos_only   |  Security_executables_darwinos_only_osx |  Security_executables_darwinos_only_ios |                              |                                 |
  13 --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
  14
  15 Security_frameworks targets are for frameworks, dynamic libraries, or libraries that should be in the (public or private) SDK.
  16 Security_executables_core targets are for binaries (particularly daemons) that are absolutely necessary for base operation of any variant of the OS, including the recovery OS. If you are unsure, do not put your target here.
  17 Security_executables targets are for binaries that ship in customer images. These are daemons, tools, services, plug-ins, apps, etc.
  18 Security_internal targets are for non-test binaries that ship in internal images (e.g. /AppleInternal/*, /usr/local/*). These are usually tools and internal apps.
  19 Security_executables_Swift is for any and all Swift targets.
  20 Security_tests targets are for test binaries that ship in the TestsSupport dmg. These are usually xctests and test executables and test apps.
  21 Security_executables_darwinos_only targets are for binaries that should only ship in very special variants of the OS. If you are unsure, do not put your target here.
  22
  23 Security_all targets aggregate all of the above targets for each platform and are used by the local Xcode schemes.
  24
  25 Update Dec 1, 2016
  26
  27 This project currently does not build without internal headers that are not public.
  28
  29 Update June 17, 2014
  30
  31 Here lie the iOS and OS X versions of Security, including securityd and SecurityTool for OS X.
  32
  33 -----------
  34
  35
  36               Projects in Security
  37                Last update Dec 1 2005
  38
  39
  40 Standalone crypto libs
  41 ----------------------
  42
  43 libCert/
  44         Library to parse and verify X509 certificates. Uses libgRSA,
  45         libDER, libMD5, and libSHA1.
  46
  47 libDER/
  48         DER decoding library, ROM_capable, no malloc.
  49
  50 libGiants/
  51         General purpose ROM-capable giantIntegers package. No malloc.
  52         Performs unsigned arithmetic ONLY as of Nov. 28 2005.
  53
  54 libgRSA/
  55         Full ROM-capable RSA package based on libGiants.
  56         Provided to Mike Smith and Chris Aycock 8/23/05.
  57         Converted to unsigned libGiants circa 11/30/05.
  58
  59 libScripts/
  60         Scripts to build and test all of these libraries.
  61
  62 ====
  63
  64 To regenerate strings file run:
  65 genstrings -u -o resources/en.lproj -s SecString OSX/sec/Security/SecFrameworkStrings.h
  66
  67 in the top level dir.