SPB Git

Repository Public License

offline.md 16.6 KB 257 lines markdown

1# ORIX Convert — offline proof23> Generated file — do not edit. Written by `Scripts/offline-check.sh` on 2026-11-21T19:20:58Z (Apple M5 Max, macOS 27.0).45What is shown here: which networking code exists in the tool and in every bundled binary (stated as found, component by component),6why that code is not reached, and three dynamic checks: conversions under a sandbox that denies IP networking, conversions of documents7that point at a local canary server, and the list of helper executables that were really started.89## 1. Static scan (`otool -L`, `nm -u`)1011For each Mach-O: the networking libraries it links and the networking symbols it imports (resolver, BSD sockets, CFNetwork,12Network.framework, URLSession, curl, TLS). "—" means none were found. A binary that imports `socket`/`connect` can open a network13connection; the last column says what stands in the way.1415| Binary | Size | Networking libraries linked | Networking symbols imported | Why it is not reached |16|---|---:|---|---|---|17| `orix-convert` | 37.2 MB | CFNetwork,WebKit | — | No engine and no core source file calls a networking API (source scan below). WebKit is linked for HTML/SVG rendering: see section 2. |18| `libduckdb.dylib` (data engine) | 62.4 MB | — | bind,connect,getaddrinfo,getnameinfo,socket | The data engine opens every database with `enable_external_access = false`, `autoinstall_known_extensions = false` and `autoload_known_extensions = false`; no `httpfs` extension is loaded. |19| `orix-model3d-helper` | 10.7 MB | — | — | Reads one model file and writes a blob in a private folder; no networking call in its sources. |20| `orix-hdf5-probe` | 10.5 MB | — | — | Opens one HDF5/NetCDF file in its own process to contain crashes of the HDF5 library; no networking call in its sources. |21| `ffmpeg` | 28.2 MB | — | — | Every input is opened with `-protocol_whitelist file,pipe`; the protocols compiled in are listed below. |22| `ffprobe` | 28.0 MB | — | — | Same whitelist as ffmpeg. |23| `pandoc` | 187.8 MB | — | accept,bind,connect,getaddrinfo,getnameinfo,listen,recvfrom,sendto,socket | Pandoc contains an HTTP client (it can fetch remote images). The engine runs every conversion with a Lua filter that replaces remote images by their alternative text and blanks remote URLs in raw HTML, and with `http_proxy`/`https_proxy`/`all_proxy` pointing at a closed local port (127.0.0.1:9). |2425ffmpeg input protocols compiled into the bundled build: `file pipe`.26Of these, network protocols: none.2728`libduckdb.dylib` mentions `httpfs` in 195 string(s): the name of the optional extension is known to DuckDB, but the extension itself is not29part of the library and cannot be installed or loaded (auto-install and auto-load are off, external access is off).3031### LibreOffice.app (460M, 121 Mach-O files)3233**LibreOffice contains networking code**: 11 of its 121 Mach-O files link a networking library or import networking symbols.34It ships its own HTTP stack (curl), TLS (NSS), a Firebird database client, GnuPG helpers and its UNO socket layer:3536| File (inside LibreOffice.app) | Networking libraries linked | Networking symbols imported |37|---|---|---|38| `Contents/Frameworks/libLanguageToollo.dylib` | libcurl.4.dylib | curl_easy_cleanup,curl_easy_getinfo,curl_easy_init,curl_easy_perform,curl_easy_setopt,curl_easy_strerror,curl_slist_append,curl_version_info |39| `Contents/Frameworks/libassuan.9.dylib` | — | accept,bind,connect,socket |40| `Contents/Frameworks/libcurl.4.dylib` | libcurl.4.dylib,libresolv.9.dylib | SecTrustCreateWithCertificates,SecTrustEvaluateWithError,SecTrustSetOCSPResponse,accept,bind,connect,getaddrinfo,gethostbyname,getnameinfo,listen,recvfrom,sendt… |41| `Contents/Frameworks/libfbclient.dylib.3.0.14` | — | accept,bind,connect,getaddrinfo,getnameinfo,listen,socket |42| `Contents/Frameworks/libgpg-error.0.dylib` | — | connect,socket |43| `Contents/Frameworks/libgpgme.11.dylib` | — | connect,socket |44| `Contents/Frameworks/libmergedlo.dylib` | libcurl.4.dylib | accept,bind,connect,curl_easy_cleanup,curl_easy_escape,curl_easy_getinfo,curl_easy_init,curl_easy_perform,curl_easy_reset,curl_easy_setopt,curl_easy_strerror,cu… |45| `Contents/Frameworks/libnspr4.dylib` | — | accept,bind,connect,getaddrinfo,gethostbyname,gethostbyname2,getnameinfo,listen,recvfrom,sendto,socket |46| `Contents/Frameworks/libsdlo.dylib` | — | bind,recvfrom,sendto,socket |47| `Contents/Frameworks/libssl3.dylib` | libssl3.dylib | — |48| `Contents/Frameworks/libuno_sal.dylib.3` | — | accept,bind,connect,getaddrinfo,getnameinfo,listen,recvfrom,sendto,socket |4950Bundled curl library: Contents/Frameworks/libcurl.4.dylib.5152Why it is not reached: the engines start `soffice` headless for one document, with a fresh private profile whose configuration sets53an HTTP and HTTPS proxy on a closed local port (`127.0.0.1:9`, proxy type "manual", empty no-proxy list),54and never refreshes linked content (images, OLE links, sections, DDE); macros are disabled. The update check is not switched off by a55setting of its own; if a headless run attempted it, the request would meet the same closed proxy. A request LibreOffice would still attempt56ends at the closed port. Sections 2 and 3 check this by running it.5758### Source scan5960First-party source lines naming a networking API:6162```63Packages/EngineDocuments/Sources/EngineDocuments/WebPDF.swift:135:                webView.load(URLRequest(url: url))64```6566(`WebPDF.swift` builds a `URLRequest` for the document's own private scheme, served from memory by a `WKURLSchemeHandler`; it is how67WebKit is told to load the local document, not a network request.)6869WebKit (`WKWebView`) is used by: Packages/EngineDocuments/Sources/EngineDocuments/WebPDF.swift,Packages/EngineVector/Sources/EngineVector/SVGWebRenderer.swift. WebKit is a system framework with its own networking process. The engines load70the document from memory or through a private URL scheme, with JavaScript disabled, a non-persistent data store, a content-rule list that71blocks every URL except the document's own scheme, `data:` and `about:`, and a navigation delegate that cancels any other navigation.72The SVG renderer additionally wraps the drawing in a page whose Content-Security-Policy is `default-src 'none'; img-src data:`.7374**Finding:** the content-rule list of the SVG renderer (`EngineVector/SVGWebRenderer.swift`) uses the filter `^(about|data):`. WebKit's rule75compiler rejects disjunctions ("Disjunctions are not supported yet", printed on stderr at run time), the compilation result is discarded with76`try?`, and the renderer then runs **without** its rule list. The CSP, the disabled JavaScript and the navigation delegate remain; the canary77test in section 3 shows whether that is enough. Fix: two rules, `^about:` and `^data:`, as the documents engine does.7879## 2. Conversions under a sandbox that denies networking8081Method: `sandbox-exec -f no-network.sb` (deprecated by Apple but present and working on this system). Profile:8283```84(version 1)85(allow default)86(deny network*)87; LibreOffice talks to itself through a UNIX-domain socket in its private profile folder; nothing else is allowed.88(allow network* (local unix-socket))89(allow network* (remote unix-socket))90```9192Control: a TCP connection to a listener on 127.0.0.1 succeeds outside the sandbox (yes) and is refused inside it (yes).93The profile applies to `orix-convert` and to every process it starts (ffmpeg, ffprobe, pandoc, soffice, the 3D helper).94It does **not** apply to WebKit's own helper processes, which the system starts outside the tool's process tree; section 3 covers those.95With `(deny network*)` alone LibreOffice does not start (it needs its local UNIX-domain socket), hence the two `allow` lines for UNIX sockets only.9697| Engine | Conversion | Exit status | Seconds |98|---|---|---:|---:|99| image | png → jpeg | 0 | .113 |100| vector | png → svg (--operation image.vectorize) | 0 | .439 |101| vector (WebKit) | svg → png | 0 | .579 |102| pdf | pdf → png | 0 | .247 |103| video (ffmpeg) | mp4 → mov | 0 | .413 |104| audio (ffmpeg) | wav → mp3 | 0 | .208 |105| documents (Pandoc) | markdown → docx | 0 | .179 |106| documents (LibreOffice) | docx → pdf | 0 | 1.355 |107| documents (WebKit) | html → pdf | 0 | .442 |108| ebooks | epub → html | 0 | .220 |109| presentations (LibreOffice) | pptx → pdf | 0 | 1.499 |110| data (DuckDB) | csv → parquet | 0 | .177 |111| data (LibreOffice) | xlsx → xls | 0 | 3.907 |112| archive | zip → folder (--operation archive.extract) | 0 | .090 |113| font | ttf → woff2 | 0 | 1.229 |114| subtitle | srt → vtt | 0 | .086 |115| model3d | obj → glb | 0 | .136 |116| geo | geojson → kml | 0 | .092 |117| scientific | hdf5 → csv | 0 | .113 |11811919 of 19 conversions succeeded with networking denied.120121## 3. Documents that reference a server: canary test122123A web server listens on `127.0.0.1:23103` and logs every request (control request seen: yes).124The sources below reference it in every way their format allows (images, stylesheets, `@import`, fonts, scripts, frames, objects, SVG125`<image>` and `<use>`, LaTeX `\includegraphics`, reStructuredText `image`). The conversions run **without** the sandbox, so a fetch126would succeed if any component attempted it — including WebKit's helper processes. The documents produced by the first pass (DOCX, ODT, EPUB,127which may still carry the remote reference as a link) are then converted again by LibreOffice and the ebook engine.128129| Source | Destination | Converter | Exit status | Requests received during the conversion |130|---|---|---|---:|---:|131| `page.html` | pdf | WebKit | 0 | 0 |132| `page.html` | docx | Pandoc | 0 | 0 |133| `page.html` | odt | Pandoc or LibreOffice | 0 | 0 |134| `page.html` | epub | Pandoc | 0 | 0 |135| `page.html` | markdown | Pandoc | 0 | 0 |136| `page.html` | rtf | documents | 0 | 0 |137| `note.md` | pdf | Pandoc + WebKit | 0 | 0 |138| `note.md` | docx | Pandoc | 0 | 0 |139| `note.md` | html | Pandoc | 0 | 0 |140| `note.md` | epub | Pandoc | 1 | 0 |141| `drawing.svg` | png | WebKit | 0 | 0 |142| `drawing.svg` | pdf | WebKit | 0 | 0 |143| `paper.tex` | docx | Pandoc | 0 | 0 |144| `page.rst` | html | Pandoc | 0 | 0 |145| `page.docx` (made above) | pdf | LibreOffice | 0 | 0 |146| `page.odt` (made above) | pdf | LibreOffice | 0 | 0 |147| `page.epub` (made above) | html | ebooks | 0 | 0 |148| `page.epub` (made above) | pdf | ebooks + WebKit | 1 | 0 |149150**The canary server received no request from any conversion** (only the control request).151A non-zero exit status in the table is not a network event: the conversion ran, the remote reference was blocked (the job log says152`remote-content-blocked`), and the documents engine then failed its own "Images kept" verification because the blocked picture is153missing from the output — a defect of that verification, reported to the engine's author (the logs are quoted below for the first case).154155```156```157158## 4. No tool from PATH, Homebrew or an installed application159160All runs above use `env -i PATH=/usr/bin:/bin HOME=… TMPDIR=…`: no Homebrew directory is in the environment. The end-to-end sweep161(`Scripts/matrix.sh --verify`, `docs/reports/e2e-matrix.md`) runs with the same environment and records its PATH.162163**Installed software hidden.** The 19 representative conversions were run under a sandbox profile that denies reading and executing164anything under `/opt/homebrew`, `/usr/local`, `/opt/local`, `/Applications/LibreOffice.app` and the Python framework165(control: `ls /opt/homebrew/bin` is refused inside the profile: yes). Result: **19 of 19 succeeded**.166167Helper executables observed in the process tree of `orix-convert` while the 19 representative conversions ran again (the process168table is sampled about every 50 ms, so a helper that lives for a few milliseconds can be missed; the sandbox run above is the complete check):169170```171EmbeddedEngines/tools/LibreOffice.app/Contents/MacOS/soffice172```173174Every helper comes from the repository (`EmbeddedEngines/tools` or the build folder).17517619 of 19 conversions succeeded in that run (minimal environment, no sandbox).177178Software installed on this Mac that the tool could have picked up by mistake, and did not:179180| Candidate | Present on this Mac | Used |181|---|---|---|182| `/opt/homebrew/bin/ffmpeg` | yes | no |183| `/opt/homebrew/bin/ffprobe` | yes | no |184| `/opt/homebrew/bin/pandoc` | yes | no |185| `/opt/homebrew/bin/soffice` | yes | no |186| `/usr/local/bin/ffmpeg` | no | no |187| `/usr/local/bin/pandoc` | no | no |188| `/Applications/LibreOffice.app` | yes | no |189| `/opt/homebrew/bin/duckdb` | no | no |190| `/opt/homebrew/bin/7z` | no | no |191192`orix-convert doctor` in the same minimal environment (tool search directories and resolved paths):193194```195orix-convert 1.0.0196Executable: <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug/orix-convert (development build, outside an app bundle)197198Engines (15, from 12 package(s))199  ENGINE         NAME                 PACKAGE           PATHS  HEAVY  AVAILABLE200  -------------  -------------------  ----------------  -----  -----  ---------201  image          Images               EngineImage       443    —      yes202  pdf            PDF                  EnginePDF         24     —      yes203  vector         Vector Studio        EngineVector      26     —      yes204  video          Video                EngineMedia       302    yes    yes205  audio          Audio                EngineMedia       132    —      yes206  documents      Documents            EngineDocuments   82     yes    yes207  ebooks         Ebooks               EngineDocuments   23     —      yes208  presentations  Presentations        EngineDocuments   24     yes    yes209  data           Spreadsheets & Data  EngineData        219    —      yes210  archive        Archives             EngineArchive     119    —      yes211  font           Fonts                EngineFont        11     —      yes212  subtitle       Subtitles            EngineSubtitle    30     —      yes213  model3d        3D Models            EngineModel3D     132    yes    yes214  geo            Geospatial           EngineGeo         36     —      yes215  scientific     Scientific Data      EngineScientific  10     —      yes216  Registry: 117 formats, 1533 source → destination pairs, 1613 paths, 29 named operations217218Tool search directories (in order; PATH is never searched)219  <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug  [ORIX_CONVERT_TOOLS]220  <repo>/EmbeddedEngines/tools  [repository]221222Bundled tools223  TOOL                 VERSION   SIZE      FROM                PATH224  -------------------  --------  --------  ------------------  ------------------------------------------------------------------------------------------------------------------------------------225  ffmpeg               9.1       29.6 MB   repository          <repo>/EmbeddedEngines/tools/ffmpeg226  ffprobe              9.1       29.4 MB   repository          <repo>/EmbeddedEngines/tools/ffprobe227  pandoc               3.14      197.0 MB  repository          <repo>/EmbeddedEngines/tools/pandoc228  LibreOffice          26.8.3.1  34.4 KB   repository          <repo>/EmbeddedEngines/tools/LibreOffice.app/Contents/MacOS/soffice229  orix-model3d-helper  n/a       11.2 MB   ORIX_CONVERT_TOOLS  <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug/orix-model3d-helper230  orix-hdf5-probe      n/a       11.1 MB   ORIX_CONVERT_TOOLS  <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug/orix-hdf5-probe231232Linked libraries233  LIBRARY         VERSION            LINKAGE                                    USED BY234  --------------  -----------------  -----------------------------------------  ------------------235  DuckDB          v2.0.1             bundled dynamic library (libduckdb.dylib)  data236  SQLite          3.54.0             macOS system library                       data, geo, history237  libarchive      libarchive 3.8.11  static (CArchive.xcframework)              archive238  libwebp         1.6.0              static (CWebP.xcframework)                 image239  Assimp          6.0.2              static (CAssimp.xcframework)               model3d240  woff2 + brotli  not reported       static (CWOFF2.xcframework)                font241  HDF5            2.2.0              static (CHDF5.xcframework)                 scientific242243Images loaded from outside /System and /usr/lib244  <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug/orix-convert245  <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug/libduckdb.dylib246247No problem found: every engine is available and every tool and library comes from the bundle or the repository.248```249250Caveat that applies to an installed copy: `BundledTools` (core) also searches `EmbeddedEngines/tools` found by walking up from the path of its own251source file as recorded at build time. On a user's Mac that path does not exist; on the build machine it does, so a missing tool in an252app bundle would silently be taken from the repository there. `doctor` prints the search directories for that reason.253254## Result255256All checks passed.257
Files main
Menu

Theme