ObjFW  History of src/ObjFW.h of 9a6b5d6cc44f538a

OFINICategory is provided as a deprecated subclass of OFINISection to
maintain API and ABI compatibility. file: [2d3e9eef3e] check-in: [0fead8a915] user: js, branch: trunk, size: 7392 [annotate] [blame] [check-ins using] [diff]

Only supports Nintendo 3DS so far. file: [04ce1fb016] check-in: [a0f4283e81] user: js, branch: gamecontroller, size: 7395 [annotate] [blame] [check-ins using] [diff]

Only support for reading so far.

Compression methods 0 (uncompressed) and 2 (LZ77 + Huffman, apparently
identical to lh4/lh5) are supported. file: [c01c2395b8] check-in: [9a95da71d5] user: js, branch: trunk, size: 7102 [annotate] [blame] [check-ins using] [diff]

These will be useful for 3D graphics. file: [1712ca6be5] check-in: [44eb35b212] user: js, branch: trunk, size: 7047 [annotate] [blame] [check-ins using] [diff]

It seems that neither Windows nor macOS support DDP sockets, but only
the layers on top, while neither Linux nor NetBSD support the layers on
top, but only provide DDP.

It seems that DDP is not meant to be used directly, while Linux and
NetBSD only provide the minimum to use netatalk, which is DDP. ObjFW
would need to use the layers on top on Windows and macOS and implement
those layers itself on Linux and NetBSD. This also means that no code
would be shared between Linux / NetBSD and Windows / macOS, as it's
impossible to have one implementation that works for everything. At this
point, the effort required doesn't make sense. file: [db1b63a56b] check-in: [0b4f713964] user: js, branch: trunk, size: 6889 [annotate] [blame] [check-ins using] [diff]

Ever since the introduction of OFRunLoop, this wasn't terribly useful
anymore, and even things such as OFHTTPServer that have a thread pool
don't use it. file: [8e529c90da] check-in: [06763e3c67] user: js, branch: trunk, size: 6865 [annotate] [blame] [check-ins using] [diff]

It is no longer used. file: [47b701ca13] check-in: [5ee9765356] user: js, branch: trunk, size: 6891 [annotate] [blame] [check-ins using] [diff]

This implements OFTLSStream using Apple's Secure Transport. While Secure
Transport is declared deprecated by Apple, Apple so far has failed to
provide a suitable replacement. They recommend Network.framework as a
replacement, however it can neither work on arbitrary sockets, nor can
it do STARTTLS. file: [4b80c7d121] check-in: [112eb62f7b] user: js, branch: trunk, size: 7028 [annotate] [blame] [check-ins using] [diff]

The previous API could never work cleanly and would always require
hacks, as it needed intercepting all interactions of OFTCPSocket with
the raw socket and did not work at all if the OFTCPSocket had anything
in its read buffer before starting the TLS handshake. This also could
not be fixed easily, as it would have required the object to contain two
read buffers, one for the unencrypted connection and one for the
encrypted connection. There was also no clean way to perform the
handshake in a non-blocking way.

The new API is a lot cleaner and requires none of the hacks, but using
it requires slightly more work. But this is more than made up for by
making a fully asynchronous handshake possible. It uses the concept of a
stream wrapping another stream, meaning the entire connecting part is
being handled by OFTCPSocket and then the connected socket is passed off
to OFTLSStream to wrap it. This also makes for a lot cleaner separation
of concerns. file: [b540b51725] check-in: [d30efa8bbf] user: js, branch: trunk, size: 6955 [annotate] [blame] [check-ins using] [diff]

While something similar can be achieved by spawning OFThreads and
dispatching to their run loops, this means dispatching work to a
specific thread, while OFThreadPool will create a pool of threads and
not assign any job to a specific thread - instead, the first thread to
become ready will pick up the next job until there's no work left. file: [2e31ed4971] check-in: [116375820d] user: js, branch: 1.0, size: 6794 [annotate] [blame] [check-ins using] [diff]

It has been moved to the "asn1" branch until it is ready. file: [d76330f616] check-in: [edc3ddf026] user: js, branch: trunk, size: 6863 [annotate] [blame] [check-ins using] [diff]

It has been moved to the "sctp" branch until it is ready. file: [fa4bd9f945] check-in: [a863ef544f] user: js, branch: trunk, size: 7185 [annotate] [blame] [check-ins using] [diff]

It is unclear whether the same API can be applied to other sandboxing
frameworks. file: [2bba394ec2] check-in: [510628432f] user: js, branch: 1.0, size: 6844 [annotate] [blame] [check-ins using] [diff]

This should not be part of the 1.0 API, as it's unclear how useful it
actually is. file: [e3a54792ac] check-in: [38cf0b9cef] user: js, branch: 1.0, size: 6732 [annotate] [blame] [check-ins using] [diff]

This is no longer necessary now that the ObjFW runtime offers the same
API as the Apple runtime. file: [771661c2a9] check-in: [a989f0ab6f] user: js, branch: trunk, size: 7080 [annotate] [blame] [check-ins using] [diff]

This temporarily doesn't use the search domains anymore and makes CNAMEs
slightly more inefficient. The next commits will fix both. file: [7965915726] check-in: [ee592cf603] user: js, branch: trunk, size: 7108 [annotate] [blame] [check-ins using] [diff]

This is now in alignment with the terminology of the RFC. file: [1f291aba5e] check-in: [d69f7bc1ff] user: js, branch: trunk, size: 6981 [annotate] [blame] [check-ins using] [diff]

OFAutoreleasePools have long been discouraged in favor of the runtime's
autorelease pools. file: [9b95780617] check-in: [09be825f88] user: js, branch: trunk, size: 6933 [annotate] [blame] [check-ins using] [diff]

This allows the runtime to only link against the parts it needs, without
pulling in unnecessary parts like thread spawning, TLS and conditions. file: [a9de46c0be] check-in: [5358e9ea6a] user: js, branch: trunk, size: 6963 [annotate] [blame] [check-ins using] [diff]

As OFFileManager also works with remote URLs, it makes sense to also
make it available when local files are disabled. In this case, all
path-based methods are unavailable. file: [927e22debb] check-in: [c52f38388c] user: js, branch: trunk, size: 6907 [annotate] [blame] [check-ins using] [diff]

The reason for this is that OFASN1Value requires an initializer for DER
encoding, however, it might be beneficial to create an ASN.1 type
without providing DER encoding for it. file: [fa03da00eb] check-in: [b1944fd052] user: js, branch: trunk, size: 6674 [annotate] [blame] [check-ins using] [diff]

Instead, OFDNSResolver is used for everything now. file: [ee89e1ae2e] check-in: [6e9ee122eb] user: js, branch: trunk, size: 6352 [annotate] [blame] [check-ins using] [diff]

This avoids unnecessary string construction and parsing and removes
duplicate code to convert an address into a string. file: [3fac06979c] check-in: [75d2d3ba01] user: js, branch: trunk, size: 6404 [annotate] [blame] [check-ins using] [diff]

Instead of containing a struct sockaddr_storage - which does not exist
on all supported platforms - it now contains a union of all struct
sockaddr_* types.

Additionally, if struct sockaddr_in6 does not exist, it is defined so
that an IPv6 can be stored even if the system does not support IPv6. file: [410a981ac1] check-in: [8f810ecb7e] user: js, branch: trunk, size: 6371 [annotate] [blame] [check-ins using] [diff]

This does nothing more than parse /etc/hosts and /etc/resolv.conf so
far. file: [e64e015cee] check-in: [dd375b6d4e] user: js, branch: trunk, size: 6082 [annotate] [blame] [check-ins using] [diff]

This also adds a parameter for the actual and expected checksum. file: [d8f06920eb] check-in: [8f21e8acb5] user: js, branch: trunk, size: 6055 [annotate] [blame] [check-ins using] [diff]

This is currently limited to reading uncompressed LHA level 2 files. file: [42d5f9fcae] check-in: [790b5344d6] user: js, branch: trunk, size: 6010 [annotate] [blame] [check-ins using] [diff]

This is useful so that multiple libraries using ObjFW can share the same
type for colors, similar to e.g. of_rectangle_t. file: [8e512daaa9] check-in: [f484fedee2] user: js, branch: trunk, size: 5897 [annotate] [blame] [check-ins using] [diff]

This also changes OFFileManager to use a buffer with getcwd() rather
than depending on the extension that passing NULL as a buffer will
allocate one. file: [a25671fef1] check-in: [d133fa0a89] user: js, branch: trunk, size: 5877 [annotate] [blame] [check-ins using] [diff]

OFOpenItemFailedException was too unspecific and only allowed an errno,
but dlopen() uses dlerror() to report errors, which returns a string. file: [01ae715851] check-in: [4642bc76b0] user: js, branch: trunk, size: 5795 [annotate] [blame] [check-ins using] [diff]

This removes all query methods and replaces them by a single one that
returns a dictionary. Not only does this allow querying multiple
attributes at once, it is also more extensible, as the previous
attributes were specific to file URLs. file: [3aca01c885] check-in: [34fe205b84] user: js, branch: trunk, size: 5656 [annotate] [blame] [check-ins using] [diff]

So far this is only for x86_64 with the Apple runtime and does not yet
support all types. It also does not yet support passing arguments via
the stack. file: [478f0cae84] check-in: [95797a4d1c] user: js, branch: trunk, size: 5636 [annotate] [blame] [check-ins using] [diff]

There is not much point in having a bi-directional stream for Deflate
compression / decompression. file: [c85084515b] check-in: [f56a50ee50] user: js, branch: trunk, size: 5572 [annotate] [blame] [check-ins using] [diff]

Forgot to add 2017, even though I already did quite some changes in
2017. file: [9210a8d6e8] check-in: [44f45c2e35] user: js, branch: trunk, size: 5445 [annotate] [blame] [check-ins using] [diff]

This singleton gives access to all things locale, including the ability
to get localized strings.

This also adds the OF_LOCALIZED() macro. Its first argument is an ID for
the string to be localized and its second argument is the fallback
string to be used if it cannot retrieve the localized string. Following
that are variable name / value pairs to be replaced in the localized
string.

Getting translated strings is not implemented yet: Instead, it always
uses the fallback string.

This also switches ofhttp to localized strings. file: [b467e259b3] check-in: [06bcb21fc7] user: js, branch: trunk, size: 5439 [annotate] [blame] [check-ins using] [diff]

OFHash is too generic, as this protocol is for cryptographic hashes. It
also solves the ambiguity of the +[hash] method (which is now
+[cryptoHash]), which conflicted with -[hash] on the class itself,
resulting in classes conforming to OFHash not being able to be used as a
key in an OFDictionary. file: [8a14324578] check-in: [951f530aee] user: js, branch: trunk, size: 5328 [annotate] [blame] [check-ins using] [diff]

The reason for renaming to OFInflateStream was to have one stream for
decompression and one for compression in order to reduce memory usage if
only one of the two is needed, as the ivar layout will be smaller then.
However, it is more consistent with other stream classes to have one
stream that can handle both. The increased memory footprint of having
ivars for compression and decompression can be solved by having a
pointer to those instead. This will not incur any performance penalty,
as the pointer will be dereferenced instead of the ivars, meaning the
overhead is only getting the pointer from the ivars once. file: [c7a3d9e2ec] check-in: [134a1121c7] user: js, branch: trunk, size: 5025 [annotate] [blame] [check-ins using] [diff]

This only implements the UNIX v7 format for now. file: [5684940cda] check-in: [7ecdc71677] user: js, branch: trunk, size: 5025 [annotate] [blame] [check-ins using] [diff]

While at it, also update the mail address. file: [811d111089] check-in: [cec0f072f8] user: js, branch: 0.8, size: 4906 [annotate] [blame] [check-ins using] [diff]

While at it, also update the mail address. file: [38a800c5de] check-in: [2a27cf3000] user: js, branch: trunk, size: 4909 [annotate] [blame] [check-ins using] [diff]

This makes it possible to add support for delegates for file management
operations and on top makes it easier to add support for file management
operations on URLs. file: [4de76fa1b8] check-in: [f3c452dfef] user: js, branch: trunk, size: 4929 [annotate] [blame] [check-ins using] [diff]

It makes more sense to have one class for inflating and one for
deflating instead of having one that does both, as having one that does
both requires more memory per instance when only inflating or deflating
is used. file: [721e47329c] check-in: [2e9336b1ef] user: js, branch: trunk, size: 4902 [annotate] [blame] [check-ins using] [diff]

Took me some time to figure out the RFC is buggy and SSIG0(t-15) should
be SSIG0(W(t-15))... file: [1fc6cfc3bc] check-in: [46af1252a5] user: js, branch: trunk, size: 4772 [annotate] [blame] [check-ins using] [diff]

In case (v)asprintf was missing, this was exported instead of only being
used internally, potentially causing problems when linking against
another library which also detected libc is missing it. file: [4aaf711667] check-in: [ddbbd50e56] user: js, branch: trunk, size: 4747 [annotate] [blame] [check-ins using] [diff]

This means that OFObject.h imports macros.h now, making it unnecessary
to manually import macros.h in almost every file. And while at it, also
import autorelease.h in OFObject.h, so that this doesn't need to be
manually imported in almost every file as well. file: [06bed39988] check-in: [13ee56edf3] user: js, branch: trunk, size: 4768 [annotate] [blame] [check-ins using] [diff]

Async operations will follow later. file: [1d6ba8dd62] check-in: [5025cba435] user: js, branch: trunk, size: 4760 [annotate] [blame] [check-ins using] [diff]

This is in preparation for UDP sockets, so that they can share the
resolving functionality with TCP sockets. file: [87583c222f] check-in: [49b1989b63] user: js, branch: trunk, size: 4735 [annotate] [blame] [check-ins using] [diff]

This replaces +[OFFile copyFileAtPath:toPath:]. file: [9ac65f6b1e] check-in: [169f06e1ec] user: js, branch: trunk, size: 4648 [annotate] [blame] [check-ins using] [diff]

No compression support yet, only decompression.

Decompression speed is acceptable for productive use, but there is still
a lot of room for optimization as this is a very straightforward
implementation without much optimization. file: [ee41bf203d] check-in: [d83d3aa719] user: js, branch: trunk, size: 4620 [annotate] [blame] [check-ins using] [diff]

Still a lot to do, see list of FIXMEs in the source. file: [3262ca71e0] check-in: [1c78b3a4db] user: js, branch: trunk, size: 4588 [annotate] [blame] [check-ins using] [diff]

This only affects exceptions. file: [7016b0c88a] check-in: [f3654b5cc6] user: js, branch: trunk, size: 4563 [annotate] [blame] [check-ins using] [diff]

This is used for of_std{in,out,err} now instead of OFFile. file: [a29c563823] check-in: [085bfc12a0] user: js, branch: trunk, size: 4580 [annotate] [blame] [check-ins using] [diff]

This means that even if --disable-threads has been specified, it is
possible to use +[OFThread sleep*] to sleep the current (and only)
thread. file: [58cac27b30] check-in: [71d45a29d1] user: js, branch: trunk, size: 4554 [annotate] [blame] [check-ins using] [diff]

The class also has its own file now. file: [070a0731f0] check-in: [75f187cef5] user: js, branch: trunk, size: 4227 [annotate] [blame] [check-ins using] [diff]

It was time to finally have one file per class. file: [2df4cec6a1] check-in: [0a55edad35] user: js, branch: trunk, size: 4144 [annotate] [blame] [check-ins using] [diff]

This introduces OFInvalidJSONException, which has a property line to get
the line in which the parsing error occurred. file: [d4c97a2a17] check-in: [72c71c4eb2] user: js, branch: trunk, size: 3870 [annotate] [blame] [check-ins using] [diff]

Win32 implementation following later. file: [ec3eaa6f1a] check-in: [02ab9aa8a9] user: js, branch: trunk, size: 3822 [annotate] [blame] [check-ins using] [diff]

This is to reflect that it is a connection-based, sequenced, reliable,
two-way byte stream. file: [816eccd8cc] check-in: [28ea4a8a67] user: js, branch: trunk, size: 1085 [annotate] [blame] [check-ins using] [diff]

Changesets:
* b95fcaa6d694
* 804c68d222b4
* da8cd738da3d
* 1109d5ce3419
* d03f5c1ca95d
* 2a7017722165
* 4fccdc79eeb7
* d228149fbc04
* 8782d412a4a6 file: [7a8403f46d] check-in: [b91a8283fe] user: js, branch: 0.2, size: 799 [annotate] [blame] [check-ins using] [diff]