Low-level core library that forms the basis for projects such as GTK+ and GNOME.
Go to file
Michael Catanzaro c50e543e9d gtlscertificate: make private key properties readable
WebKit wants these private key properties to be readable in order to
implement a deserialization function. Currently they are read-only
because at the time GTlsCertificate was originally designed, the plan
was to support PKCS#11-backed private keys: private keys that are stored
on a smartcard, where the private key is completely unreadable. The
design goal was to support both memory-backed and smartcard-backed
private keys with the same GTlsCertificate API, abstracting away the
implementation differences such that code using GTlsCertificate doesn't
need to know the difference.

The original PKCS#11 implementation was never fully baked and at some
point in the past I deleted it all. It has since been replaced with a
new implementation, including a GTlsCertificate:private-key-pkcs11-uri
property, which is readable. So our current API already exposes the
differences between normal private keys and PKCS#11-backed private keys.
The point of making the private-key and private-key-pem properties
write-only was to avoid exposing this difference.

Do we have to make this API function readable? No, because WebKit could
be just as well served if we were to expose serialize and deserialize
functions instead. But WebKit needs to support serializing and
deserializing the non-private portion of GTlsCertificate with older
versions of GLib anyway, so we can do whatever is nicest for GLib. And I
think making this property readable is nicest, since the original design
reason for it to not be readable is now obsolete. The disadvantage to
this approach is that it's now possible for an application to read the
private-key or private-key-pem property, receive NULL, and think "this
certificate must not have a private key," which would be incorrect if
the private-key-pkcs11-uri property is set. That seems like a minor
risk, but it should be documented.
2021-06-15 16:06:52 -05:00
.gitlab-ci Rename the master branch to main 2021-06-07 14:03:48 +01:00
docs Distinguish more clearly between wait status and exit status 2021-06-15 14:33:14 +01:00
fuzzing docs: Update various external links to use HEAD instead of master 2021-06-07 14:03:48 +01:00
gio gtlscertificate: make private key properties readable 2021-06-15 16:06:52 -05:00
glib spawn: Clarify the most common non-exit reason for process termination 2021-06-15 14:33:17 +01:00
gmodule docs: Update various external links to use HEAD instead of master 2021-06-07 14:03:48 +01:00
gobject Merge branch 'g_obj_take_ref' into 'main' 2021-06-15 11:28:00 +00:00
gthread Meson: Override every dependency glib provides 2020-04-05 00:34:04 -04:00
m4macros m4macros: Increment serial number of glib-2.0.m4 2021-01-27 11:55:37 +00:00
po Update Hebrew translation 2021-05-28 19:58:35 +00:00
subprojects subprojects: Pin gtk-doc to a specific version 2021-06-07 13:12:11 +01:00
tests gobject: Allow passing %NULL for @data in g_object_remove_toggle_ref 2021-05-27 21:09:45 +05:30
.clang-format CI: Code check formating in CI 2019-11-21 14:03:01 -06:00
.dir-locals.el Add .dir-locals.el to tell Emacs users not to use tabs for C 2012-07-30 04:09:08 -04:00
.gitattributes git: Add .gitattributes file with EOL settings for README.win32 2017-07-10 11:35:31 +01:00
.gitignore build: Drop autotools support 2019-01-15 15:11:43 +00:00
.gitlab-ci.yml Rename the master branch to main 2021-06-07 14:03:48 +01:00
AUTHORS docs: Rename README.in to README.md for GitLab 2018-06-15 13:04:59 +01:00
check-abis.sh Correct shellcheck errors (and ignore world splitting when we want it) 2020-11-15 17:34:27 +01:00
clang-format-diff.py py: Reformat all Python files consistently 2020-11-17 15:50:07 +00:00
CONTRIBUTING.md Rename the master branch to main 2021-06-07 14:03:48 +01:00
COPYING Update COPYING file to LGPLv2.1 2017-05-29 19:53:35 +02:00
glib-gettextize.in tree: Fix various typos and outdated terminology 2020-06-12 15:01:08 +01:00
glib.doap docs: Update various external links to use HEAD instead of master 2021-06-07 14:03:48 +01:00
glib.supp docs: Update various external links to use HEAD instead of master 2021-06-07 14:03:48 +01:00
HACKING docs: Update HACKING and README to mention Meson rather than autotools 2019-01-15 15:11:43 +00:00
INSTALL.in docs: Update INSTALL.in to mention Meson rather than autotools 2019-01-15 15:11:43 +00:00
meson_options.txt build: Add glib_debug option 2021-01-20 16:05:36 +01:00
meson.build meson: Fix detection of static libintl on macOS 2021-05-16 11:58:26 +02:00
msvc_recommended_pragmas.h msvc_recommended_pragmas.h: Refine for clang-cl 2021-03-30 16:45:07 +08:00
NEWS 2.68.0 2021-03-18 13:27:26 +00:00
NEWS.pre-1-3 updates. 2001-04-03 19:22:44 +00:00
README docs: Rename README.in to README.md for GitLab 2018-06-15 13:04:59 +01:00
README.md docs: Add a section to the README about the branch rename 2021-06-07 14:03:48 +01:00
README.rationale docs: Add a README.rationale documenting major design decisions 2014-05-04 18:22:09 +01:00
README.win32 README.win32: Update and convert to markdown 2019-08-27 12:57:32 +05:30
README.win32.md README.win32.md: Mention about Window 8+ SDK requirement 2021-02-28 11:04:29 +02:00
SECURITY.md docs: Update various external links to use HEAD instead of master 2021-06-07 14:03:48 +01:00
template-tap.test.in tests: Remove redundant --tap options 2019-05-14 12:42:51 +01:00
template.test.in Meson: Install glib tests 2018-07-16 15:36:20 -04:00

GLib

GLib is the low-level core library that forms the basis for projects such as GTK and GNOME. It provides data structure handling for C, portability wrappers, and interfaces for such runtime functionality as an event loop, threads, dynamic loading, and an object system.

The official download locations are: https://download.gnome.org/sources/glib

The official web site is: https://www.gtk.org/

Installation

See the file 'INSTALL.in'

How to report bugs

Bugs should be reported to the GNOME issue tracking system. (https://gitlab.gnome.org/GNOME/glib/issues/new). You will need to create an account for yourself.

In the bug report please include:

  • Information about your system. For instance:
    • What operating system and version
    • For Linux, what version of the C library
    • And anything else you think is relevant.
  • How to reproduce the bug.
    • If you can reproduce it with one of the test programs that are built in the tests/ subdirectory, that will be most convenient. Otherwise, please include a short test program that exhibits the behavior. As a last resort, you can also provide a pointer to a larger piece of software that can be downloaded.
  • If the bug was a crash, the exact text that was printed out when the crash occurred.
  • Further information such as stack traces may be useful, but is not necessary.

Patches

Patches should also be submitted as merge requests to gitlab.gnome.org. If the patch fixes an existing issue, please refer to the issue in your commit message with the following notation (for issue 123): Closes: #123

Otherwise, create a new merge request that introduces the change, filing a separate issue is not required.

Default branch renamed to main

The default development branch of GLib has been renamed to main. To update your local checkout, use:

git checkout master
git branch -m master main
git fetch
git branch --unset-upstream
git branch -u origin/main
git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/main