README.md

   1 # Ravenports
   2 Universal package builder system
   3
   4 ## Objective
   5
   6 To develop the next generation software collection builder and packager
   7 that is also truly cross-platform.  Think FreeBSD ports with several new
   8 cutting edge features and enhancements, but with equal support to Linux,
   9 Solaris(like), MacOS, and all BSD platforms.
  10
  11 It is not a reinvention of pkgsrc.  The approach is new and not based
  12 on make.
  13
  14 ## Ravenports Triad
  15
  16 There are three main components of Ravenports.
  17
  18   1. **Source ports:**
  19 This component, known as "ravensource" is not seen or utilized by
  20 regular users.  It resembles
  21 the ports tree seen in FreeBSD and pkgsrc, but only at the individual
  22 port directory level.  It is not arranged in categories.  The contents
  23 of each port directory is used to generate a port buildsheet.
  24
  25   2. **Conspiracy:**
  26 The conspiracy repository contains all the buildsheets, separated into
  27 256 bucket directories.  These single files are the complete recipe for
  28 building the software for which they were created.  These buildsheets
  29 are not meant to be viewed directly, as their information can be queried
  30 by the ravenadm tool.  The conspiracy buildsheets are "compiled" from
  31 ravensource and getting the latest ports is accomplished by updating the
  32 repository.  This README is contained within the Conspiracy repository.
  33
  34   3. **Raven administration tool:**
  35 The administration tool for Ravenports is "ravenadm".  It can query the
  36 ports for many types of information like a database.  It can build
  37 packages in parallel (think synth interface).  It controls the build
  38 environment such that it is the same across users, even if those
  39 users are on different operating systems.  Raven also plays a part
  40 in the development of ports and features inbuilt lint, sanity checks
  41 and compile checks.  If somebody develops a buildsheet that passes
  42 all checks and builds, it likely can be incorporated in the source
  43 tree as submitted, especially if the submission process includes
  44 automated testing on all supported platforms.
  45
  46 ## Make has really been eliminated?
  47
  48 Actually, not really.  Make is pretty good at the actual building of the
  49 port.  A significant chunk of FreeBSD's build logic will be retained
  50 (although improved upon).  Raven will generate a makefile dynamically
  51 depending on options and variants requested for the purpose of
  52 building and packaging the software.  The logic will be straight-forward
  53 without recursion or shell forking.  Keeping this logic at
  54 ${RAVENBASE}/share/mk will ensure adaptability.
  55
  56 The options handling and other complex logic that affect package
  57 dependencies will be done by the ravenadm internally.  This will
  58 enable speedups by magnitudes as compared to other ports systems.
  59
  60 ## Official Website
  61
  62 Please visit
  63 [http://www.ravenports.com](http://www.ravenports.com)
  64 for additional and current information.
  65
  66 ## License
  67
  68 The contents of this repository are available under the
  69 conditions defined by the Internet Systems Consortium (ISC) license:
  70
  71 ---
  72
  73 ```
  74 Copyright (c) 2017-2020, The Ravenports Project.
  75
  76 Permission to use, copy, modify, and/or distribute this software for any
  77 purpose with or without fee is hereby granted, provided that the above
  78 copyright notice and this permission notice appear in all copies.
  79
  80 THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  81 WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  82 MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  83 ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  84 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  85 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  86 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  87 ```
  88
  89 ## SHA256 digests for Ravenports bootstrap files
  90
  91 Currently the repositories are only available via HTTP.  The SHA256 digests
  92 are listed before for confidence the bootstrap ravensw(8) binaries are the ones
  93 we generated.
  94
  95 ```
  96 e28fde00276880da2183439eb1e45c962147f90aca5482b9ac2df1a28dfd011a raven-darwin-bootstrap.tar.gz
  97 957b12522aa1e73173c98dca0e5fab9fba7961da149a02b63925bcaf7310de85 ravensw-dragonfly-58-bootstrap.tar.gz
  98 6ace12f1b1e2ceebb4bb0efcf1016a22f72cd24ca35c248234a71ef05dfa5b3d ravensw-freebsd64-bootstrap.tar.gz
  99 3c7090bc98eb8def52328b94096581ec9c7bea78c8e8676fb532dc0695041a00 ravensw-linux-bootstrap.tar.gz
 100 3b37a88000b2156d137a44d684abfcdc646f1f34fa87410af3167c8614e3b41d ravensw-sunos-bootstrap.tar.gz
 101 ```
 102
 103 ## Ravenports public key
 104
 105 All Ravenports repositories are signed by the following key.
 106
 107 ```
 108 -----BEGIN PUBLIC KEY-----
 109 MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4rhIOkp+aJS04AOz/V0S
 110 gKOg7Ol/rUTUeHUwzbE45vvGq+M7s00MKDhzdU6QBPnhRLaPdRf8jJNCcNIEIjQ4
 111 fON43BNJfJX1q5T1jnT4Dd+pyyejPv3gOQdDARYt4risfeey3BBYQMuOghGoCNDt
 112 DYPsWaBUPHUR+Um96U0CYHl3ZeAbovq466Wn3OuYX3gvg4QPaMPKmx1fgI3V9bDA
 113 KuOBD5JEVzhJgtzv33e7C0murs4WWJpRv3eSinZsUKoFbt4F4To+YrIXnOQPrNdr
 114 u25Z5hSBdNT5gM43JKWWqM57Zi60Poj5nG6p+GxGePWrraOQY68mgDEScTrJLIXj
 115 UwIDAQAB
 116 -----END PUBLIC KEY-----
 117 ```
 118
 119 An example of use is to save the contents to
 120 /raven/etc/ravensw/keys/ravenports.key.  The ravensw repository
 121 configuration file might look like this:
 122
 123 ```
 124 > cat /raven/etc/ravensw/repos/01_raven.conf
 125 Raven: {
 126     url            : http://www.ravenports.com/repository/${ABI},
 127     pubkey         : /raven/etc/ravensw/keys/ravenports.key,
 128     signature_type : PUBKEY,
 129     priority       : 0,
 130     enabled        : yes
 131 }
 132 ```