crashpad/third_party/apple_cf/README.crashpad

Name: Apple CF-Lite
Short Name: CF
URL: https://opensource.apple.com/source/CF/
URL: https://opensource.apple.com/tarballs/CF/
Version: 1153.18 (from OS X 10.10.3)
License: APSL 2.0
License File: APPLE_LICENSE
Security Critical: no

Description:
CF-Lite is an open-source version of the CoreFoundation framework. This
contains non-public but stable header files.

Local Modifications:
 - Only CFStreamAbstract.h is included.
Remove NSInputStream used in HTTPTransportMac and use a CFReadStream instead. NSInputStream requires overriding and implementing private methods in order to use it with NSURLConnection [1]. It is cleaner to use the private but stable and open source CFStreamAbstract.h header from CF-Lite to implement a CFReadStream. Since CFReadStream is toll-free bridged to NSInputStream, the remainder of the HTTPTransport code can remain unchanged. [1] http://lists.apple.com/archives/macnetworkprog/2007/May/msg00055.html BUG=crashpad:15 R=mark@chromium.org Review URL: https://codereview.chromium.org/993413003 2015-03-11 16:59:59 -04:00			`Name: Apple CF-Lite`
			`Short Name: CF`
			`URL: https://opensource.apple.com/source/CF/`
			`URL: https://opensource.apple.com/tarballs/CF/`
compat: Provide <elf.h> and <mach-o/loader.h> for everyone I’m working on something that I’m not ready to share, but maintaining these compat headers in my local branch is becoming annoying because “git cl format” keeps reformatting them since they were added since my local branch point. Because these headers are non-trivial, they’re brought nearly unmodified from upstream into third_party, with forwarding from the appropriate locations in compat. <elf.h> comes from glibc 2.29 (2019-01-31) and was modified to remove the #include of <features.h> and to replace the use of __BEGIN_DECLS and __END_DECLS with the proper conditional extern "C" construct. <mach-o/loader.h> comes from xnu 4903.221.2 (macOS 10.14.1, 2018-10-30) and was modified to remove the unused #includes of <mach/machine/thread_status.h> and <architecture/byte_order.h>. Rather than taking <mach/machine.h> and <mach/vm_prot.h> with a spider web of other dependencies from xnu, compat has cut-back versions of these headers that provide only the required typedefs. This also includes an update of apple_cf to 1153.18 (OS X 10.10.3, 2015-04-08), the last public release of CF-Lite. The change doesn’t do much for our purposes, but it restores the file to an Apple-shipped state, trailing whitespace and all. This also canonically formats BUILD.gn. 48ee086ca4c4c didn’t format it. Change-Id: Ib4f28ad53d9757bd0eed838e148c51172bfe30b1 Reviewed-on: https://chromium-review.googlesource.com/c/1489795 Reviewed-by: Robert Sesek <rsesek@chromium.org> Commit-Queue: Mark Mentovai <mark@chromium.org> 2019-02-26 16:59:46 -05:00			`Version: 1153.18 (from OS X 10.10.3)`
Remove NSInputStream used in HTTPTransportMac and use a CFReadStream instead. NSInputStream requires overriding and implementing private methods in order to use it with NSURLConnection [1]. It is cleaner to use the private but stable and open source CFStreamAbstract.h header from CF-Lite to implement a CFReadStream. Since CFReadStream is toll-free bridged to NSInputStream, the remainder of the HTTPTransport code can remain unchanged. [1] http://lists.apple.com/archives/macnetworkprog/2007/May/msg00055.html BUG=crashpad:15 R=mark@chromium.org Review URL: https://codereview.chromium.org/993413003 2015-03-11 16:59:59 -04:00			`License: APSL 2.0`
			`License File: APPLE_LICENSE`
			`Security Critical: no`

			`Description:`
			`CF-Lite is an open-source version of the CoreFoundation framework. This`
			`contains non-public but stable header files.`

			`Local Modifications:`
			`- Only CFStreamAbstract.h is included.`