summaryrefslogtreecommitdiffstats
path: root/NEWS
blob: 4a7f5c5cd3fb8e6c694a040e3a79a5009d2668a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
ProteanOS Development Kit version 3.0.0
---------------------------------------

Released: ????-??-??

This new major version of prokit has been in development since
2020-06-22.  Notable new features in this release include unified
installers (the separate "prokit installer-pc" and "prokit mkinitramfs"
being merged into "prokit install"), "prokit build" saving detailed
build logs, and the use of package archive section feeds.

New features:

  * "prokit install" is now a frontend for all installers.  The separate
    "prokit installer-pc" and "prokit mkinitramfs" commands have been
    removed and merged into "prokit install", which determines which
    backend to use for a requested platform.  The "pcramfs" backend now
    installs a system and packs it into a RAM-based file system, all in
    one command; it also removes all of the installed files that get
    packed into the RAM-based file system.
  * "prokit install" no longer supports installing to block devices
    platforms that are intended to run under chroot (such as ProteanOS's
    "dev" platform).
  * "prokit install" now determines the correct architecture for a
    requested platform.  The "-a" option is now only necessary if
    installing ProteanOS's "dev" platform for an architecture different
    from but compatible with the native architecture.
  * "prokit install"'s "<suite>" argument is now optional.  On ProteanOS
    the default is "rel/trunk", the rolling release suite.
  * "prokit build" now passes an "-a" option, if supported, to opkg to
    install host-architecture non-coinstallable dependencies (such as
    library development packages) when cross building.
  * Newly installed ProteanOS systems now have feeds for sections
    "base", "boot", "lib", "share", and "util" listed in their opkg
    configuration (previously only "base").  Systems of profile "dev"
    additionally have "dev" and "libdev" section feeds.  A "src" section
    for architecture "src" and platform "all" has also been added.  The
    recommended way to add these section feeds to an existing system is
    to install a new system of the same architecture and platform and
    copy its opkg configuration into the old system.
  * In the ProteanOS profile, the "base-files" and "config-base"
    packages and their dependencies are installed.  Previously, all
    packages marked "Essential: yes" and their dependencies were
    installed, which was a long-standing misuse of the "Essential"
    field.
  * "prokit build" now saves logs of builds and prints detailed
    information about the build and its results.
  * "C" and "POSIX" locales have been added.  They are identical to the
    "en_US" locale.

Error handling and bug fixes:

  * "prokit shell", "prokit opkg", and "prokit build" now pass through
    relevant exit statuses.  "prokit build" also no longer tries to run
    opkbuild after opkg exits with an error.
  * If prokit received a signal while running a command under chroot, it
    could have failed to unmount a file system on a block device.  This
    has been improved.
  * An incompatibility with GNU Bash, Z shell, KornShell, MirBSD Korn
    Shell, and possibly others (except Almquist shell derivatives DASH
    and BusyBox ash) present since prokit version 2.0.0 has been fixed.
  * Installation commands no longer assume that the "cut" utility is
    usable within the root being installed.  ProteanOS's busybox
    1.32.0-1 manages "cut" and almost all other utility links using
    update-alternatives, so they aren't usable until after installation.
  * A potential infinite loop in the dependency solver has been fixed.
  * The dependency solver now solves dependencies of packages whose
    names contain ":" (such as coinstallable library development
    packages in ProteanOS).
  * The foreign installation service initialization script is now
    scheduled to run before any other initialization scripts on a newly
    installed system.

ProteanOS Development Kit version 2.0.1
---------------------------------------

Released: 2019-09-30

Bug fixes and minor changes:

  * An expansion of an undefined variable in a function called during
    "prokit build" has been fixed.
  * opkg-cert (executed by "prokit install" and "prokit installer-pc")
    no longer prints a wrong and confusing "Clock incorrect" message
    after the "Invalid certificate" message when a mirror has an expired
    certificate.
  * "prokit install" and "prokit installer-pc" in the ProteanOS profile
    now support FTP mirrors.

ProteanOS Development Kit version 2.0.0
---------------------------------------

Released: 2019-04-27

This major new release of prokit has been in development since
2014-10-13.  Major new features include automatic block device mounting;
new "prokit installer-pc" and "prokit mkinitramfs" commands; downloading
and storing gzip-compressed package feed index files; verifying package
feed index file signatures against a validated archive certificate; and
fetching lists of ProteanOS architectures, platforms, and archive
mirrors.

Security fix:

  * An unsafe "eval" command has been fixed.  Running prokit's "install"
    command with an untrusted "root" directory argument, as in the shell
    command `prokit install dev/trunk "root'; echo hello #"`, allows
    arbitrary code execution.  This is fixed by Git commit 1ce4ec3.
    This is considered a low-impact vulnerability, because running
    prokit's "install" command with untrusted arguments is an unlikely
    use case.

New dependencies:

  * prokit now requires OpenWrt's usign utility, which verifies ed25519
    signatures compatible with OpenBSD's signify utility.  An embedded
    copy of usign is included, which additionally requires CMake to
    build, or a system copy can be used instead.
  * prokit now requires gunzip, either sfdisk or fdisk, mke2fs, cpio,
    and xz from XZ Utils.

Command-line interface:

  * "prokit install", "prokit shell", "prokit opkg", and "prokit build"
    now accept either a block device file name or a directory name
    (previously only accepting the latter).  A block device is
    automatically mounted and unmounted on a mount point managed by
    prokit.
  * A new "prokit installer-pc" command has been added to install a PC
    system onto a block device.
  * A new "prokit mkinitramfs" command has been added to generate an
    initramfs containing an installed system.

System installation changes:

  * A basic "/etc/group" file is now generated on ProteanOS systems.
  * "prokit install" in the ProteanOS profile now only copies
    "/etc/resolv.conf" and "/etc/hostname" from the host system if the
    platform is "dev".  It also now does not enable system services on
    the "dev" platform.  On other platforms, it enables services and
    sets the hostname to "proteanos".
  * A list of valid ProteanOS architectures and platforms is no longer
    hardcoded.  This list could become outdated between prokit versions
    or even ProteanOS suites.
  * A list of ProteanOS package archive mirrors is no longer hardcoded.
    Instead, the list is fetched from the ProteanOS files site as
    needed.
  * ProteanOS package feed index files are now downloaded and stored in
    gzip-compressed form.
  * ProteanOS package feed index file signatures are now verified
    against the archive certificate, which in turn is validated against
    the root archive key.

Bug fixes:

  * "prokit install" now only throws a "Directory ... exists" error if
    the specified root directory is not empty.
  * Two bugs related to gzip-compressed package feed index files have
    been fixed.

Build system and code quality:

  * The build system now links all shell objects into the prokit
    executable instead of distributing shell modules that are linked
    into prokit at run time.
  * Git commit information is now shown in "prokit version" output and
    manual pages if built from a Git repository.
  * Various error conditions are now handled more cleanly.
  * Uses of the non-portable "%s" date format conversion specifier and
    "expr" command have been replaced.
  * The test suite is now based around the TAP protocol.
  * Code quality has been improved: eval commands are now safer against
    mistakes in input validation/escaping, echo commands have been
    replaced, errors are handled (making the shell "-e" option safe), an
    obselescent [ (test) command option has been removed, and commands
    are protected from variable arguments beginning with "-".

ProteanOS Development Kit version 1.1.0
---------------------------------------

Released: 2014-10-08

Changes in this release:

  * The previously missing prokit-install(8) manual page is now
    distributed and installed.
  * Some logic of "prokit install" has been simplified as ProteanOS
    packages now have the necessary data files and control fields.
  * "prokit build" now parses substvars files without errors.
  * The current working directory is bind mounted within the isolated
    file system environment and used as the working directory for the
    "prokit shell" and "prokit opkg" commands.
  * Compatibility with older versions of opkbuild has been dropped.
    Before running "prokit build", make sure your ProteanOS system has
    version 3.0.0~beta6-1 or later of the opkbuild package.
  * The list of mirrors has been updated.  Thanks to Morten 'Jobbe'
    Jakobsen for providing another mirror.
  * Session management has been added to allow multiple instances of
    prokit to run simultaneously.  The first instance started will mount
    the basic file systems, and the last instance exited will unmount
    them.  A mutex is used to eliminate race conditions on changes to
    the sessions pool.
  * Whitespace in arguments to "prokit shell" and "prokit build" is now
    preserved.
  * Signals are handled during active sessions with callbacks for the
    "prokit opkg" and "prokit build" commands, to ensure that the
    isolated file system environment is left in a clean state when a
    signal like SIGINT (Ctrl+C) is received.

ProteanOS Development Kit version 1.0.0
---------------------------------------

Released: 2014-09-02

Changes in this release:

  * A new "prokit opkg" command has been added.
  * A new "prokit build" command has been added.
  * "prokit shell" now accepts optional command arguments.
  * Manual pages for prokit commands that require superuser privileges
    have been moved to section 8.

ProteanOS Development Kit version 0.1.0
---------------------------------------

Released: 2014-08-26

This is the initial release of the ProteanOS Development Kit, in
development since 2013-10-22.

This is a preview release for testing, providing only the "install" and
"shell" action commands.  Currently, prokit approximately matches
miniprokit in features, though the latter is still recommended for
normal use.

Copyright Information
---------------------

Copyright (C) 2014, 2015, 2019-2021  Patrick McDermott

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.