SPB Git

Repository Public License

offline.md 16.6 KB

# ORIX Convert — offline proof

Generated file — do not edit. Written by Scripts/offline-check.sh on 2026-11-21T19:20:58Z (Apple M5 Max, macOS 27.0).

What is shown here: which networking code exists in the tool and in every bundled binary (stated as found, component by component), why that code is not reached, and three dynamic checks: conversions under a sandbox that denies IP networking, conversions of documents that point at a local canary server, and the list of helper executables that were really started.

# 1. Static scan (otool -L, nm -u)

For each Mach-O: the networking libraries it links and the networking symbols it imports (resolver, BSD sockets, CFNetwork, Network.framework, URLSession, curl, TLS). "—" means none were found. A binary that imports socket/connect can open a network connection; the last column says what stands in the way.

Binary Size Networking libraries linked Networking symbols imported Why it is not reached
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.
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.
orix-model3d-helper 10.7 MB — — Reads one model file and writes a blob in a private folder; no networking call in its sources.
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.
ffmpeg 28.2 MB — — Every input is opened with -protocol_whitelist file,pipe; the protocols compiled in are listed below.
ffprobe 28.0 MB — — Same whitelist as ffmpeg.
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).

ffmpeg input protocols compiled into the bundled build: file pipe. Of these, network protocols: none.

libduckdb.dylib mentions httpfs in 195 string(s): the name of the optional extension is known to DuckDB, but the extension itself is not part of the library and cannot be installed or loaded (auto-install and auto-load are off, external access is off).

# LibreOffice.app (460M, 121 Mach-O files)

LibreOffice contains networking code: 11 of its 121 Mach-O files link a networking library or import networking symbols. It ships its own HTTP stack (curl), TLS (NSS), a Firebird database client, GnuPG helpers and its UNO socket layer:

File (inside LibreOffice.app) Networking libraries linked Networking symbols imported
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
Contents/Frameworks/libassuan.9.dylib — accept,bind,connect,socket
Contents/Frameworks/libcurl.4.dylib libcurl.4.dylib,libresolv.9.dylib SecTrustCreateWithCertificates,SecTrustEvaluateWithError,SecTrustSetOCSPResponse,accept,bind,connect,getaddrinfo,gethostbyname,getnameinfo,listen,recvfrom,sendt…
Contents/Frameworks/libfbclient.dylib.3.0.14 — accept,bind,connect,getaddrinfo,getnameinfo,listen,socket
Contents/Frameworks/libgpg-error.0.dylib — connect,socket
Contents/Frameworks/libgpgme.11.dylib — connect,socket
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…
Contents/Frameworks/libnspr4.dylib — accept,bind,connect,getaddrinfo,gethostbyname,gethostbyname2,getnameinfo,listen,recvfrom,sendto,socket
Contents/Frameworks/libsdlo.dylib — bind,recvfrom,sendto,socket
Contents/Frameworks/libssl3.dylib libssl3.dylib —
Contents/Frameworks/libuno_sal.dylib.3 — accept,bind,connect,getaddrinfo,getnameinfo,listen,recvfrom,sendto,socket

Bundled curl library: Contents/Frameworks/libcurl.4.dylib.

Why it is not reached: the engines start soffice headless for one document, with a fresh private profile whose configuration sets an HTTP and HTTPS proxy on a closed local port (127.0.0.1:9, proxy type "manual", empty no-proxy list), and never refreshes linked content (images, OLE links, sections, DDE); macros are disabled. The update check is not switched off by a setting of its own; if a headless run attempted it, the request would meet the same closed proxy. A request LibreOffice would still attempt ends at the closed port. Sections 2 and 3 check this by running it.

# Source scan

First-party source lines naming a networking API:

text
Packages/EngineDocuments/Sources/EngineDocuments/WebPDF.swift:135:                webView.load(URLRequest(url: url))

(WebPDF.swift builds a URLRequest for the document's own private scheme, served from memory by a WKURLSchemeHandler; it is how WebKit is told to load the local document, not a network request.)

WebKit (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 load the document from memory or through a private URL scheme, with JavaScript disabled, a non-persistent data store, a content-rule list that blocks every URL except the document's own scheme, data: and about:, and a navigation delegate that cancels any other navigation. The SVG renderer additionally wraps the drawing in a page whose Content-Security-Policy is default-src 'none'; img-src data:.

Finding: the content-rule list of the SVG renderer (EngineVector/SVGWebRenderer.swift) uses the filter ^(about|data):. WebKit's rule compiler rejects disjunctions ("Disjunctions are not supported yet", printed on stderr at run time), the compilation result is discarded with try?, and the renderer then runs without its rule list. The CSP, the disabled JavaScript and the navigation delegate remain; the canary test in section 3 shows whether that is enough. Fix: two rules, ^about: and ^data:, as the documents engine does.

# 2. Conversions under a sandbox that denies networking

Method: sandbox-exec -f no-network.sb (deprecated by Apple but present and working on this system). Profile:

text
(version 1)
(allow default)
(deny network*)
; LibreOffice talks to itself through a UNIX-domain socket in its private profile folder; nothing else is allowed.
(allow network* (local unix-socket))
(allow network* (remote unix-socket))

Control: a TCP connection to a listener on 127.0.0.1 succeeds outside the sandbox (yes) and is refused inside it (yes). The profile applies to orix-convert and to every process it starts (ffmpeg, ffprobe, pandoc, soffice, the 3D helper). It does not apply to WebKit's own helper processes, which the system starts outside the tool's process tree; section 3 covers those. With (deny network*) alone LibreOffice does not start (it needs its local UNIX-domain socket), hence the two allow lines for UNIX sockets only.

Engine Conversion Exit status Seconds
image png → jpeg 0 .113
vector png → svg (--operation image.vectorize) 0 .439
vector (WebKit) svg → png 0 .579
pdf pdf → png 0 .247
video (ffmpeg) mp4 → mov 0 .413
audio (ffmpeg) wav → mp3 0 .208
documents (Pandoc) markdown → docx 0 .179
documents (LibreOffice) docx → pdf 0 1.355
documents (WebKit) html → pdf 0 .442
ebooks epub → html 0 .220
presentations (LibreOffice) pptx → pdf 0 1.499
data (DuckDB) csv → parquet 0 .177
data (LibreOffice) xlsx → xls 0 3.907
archive zip → folder (--operation archive.extract) 0 .090
font ttf → woff2 0 1.229
subtitle srt → vtt 0 .086
model3d obj → glb 0 .136
geo geojson → kml 0 .092
scientific hdf5 → csv 0 .113

19 of 19 conversions succeeded with networking denied.

# 3. Documents that reference a server: canary test

A web server listens on 127.0.0.1:23103 and logs every request (control request seen: yes). The sources below reference it in every way their format allows (images, stylesheets, @import, fonts, scripts, frames, objects, SVG <image> and <use>, LaTeX \includegraphics, reStructuredText image). The conversions run without the sandbox, so a fetch would succeed if any component attempted it — including WebKit's helper processes. The documents produced by the first pass (DOCX, ODT, EPUB, which may still carry the remote reference as a link) are then converted again by LibreOffice and the ebook engine.

Source Destination Converter Exit status Requests received during the conversion
page.html pdf WebKit 0 0
page.html docx Pandoc 0 0
page.html odt Pandoc or LibreOffice 0 0
page.html epub Pandoc 0 0
page.html markdown Pandoc 0 0
page.html rtf documents 0 0
note.md pdf Pandoc + WebKit 0 0
note.md docx Pandoc 0 0
note.md html Pandoc 0 0
note.md epub Pandoc 1 0
drawing.svg png WebKit 0 0
drawing.svg pdf WebKit 0 0
paper.tex docx Pandoc 0 0
page.rst html Pandoc 0 0
page.docx (made above) pdf LibreOffice 0 0
page.odt (made above) pdf LibreOffice 0 0
page.epub (made above) html ebooks 0 0
page.epub (made above) pdf ebooks + WebKit 1 0

The canary server received no request from any conversion (only the control request). A non-zero exit status in the table is not a network event: the conversion ran, the remote reference was blocked (the job log says remote-content-blocked), and the documents engine then failed its own "Images kept" verification because the blocked picture is missing from the output — a defect of that verification, reported to the engine's author (the logs are quoted below for the first case).

text

# 4. No tool from PATH, Homebrew or an installed application

All runs above use env -i PATH=/usr/bin:/bin HOME=… TMPDIR=…: no Homebrew directory is in the environment. The end-to-end sweep (Scripts/matrix.sh --verify, docs/reports/e2e-matrix.md) runs with the same environment and records its PATH.

Installed software hidden. The 19 representative conversions were run under a sandbox profile that denies reading and executing anything under /opt/homebrew, /usr/local, /opt/local, /Applications/LibreOffice.app and the Python framework (control: ls /opt/homebrew/bin is refused inside the profile: yes). Result: 19 of 19 succeeded.

Helper executables observed in the process tree of orix-convert while the 19 representative conversions ran again (the process table 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):

text
EmbeddedEngines/tools/LibreOffice.app/Contents/MacOS/soffice

Every helper comes from the repository (EmbeddedEngines/tools or the build folder).

19 of 19 conversions succeeded in that run (minimal environment, no sandbox).

Software installed on this Mac that the tool could have picked up by mistake, and did not:

Candidate Present on this Mac Used
/opt/homebrew/bin/ffmpeg yes no
/opt/homebrew/bin/ffprobe yes no
/opt/homebrew/bin/pandoc yes no
/opt/homebrew/bin/soffice yes no
/usr/local/bin/ffmpeg no no
/usr/local/bin/pandoc no no
/Applications/LibreOffice.app yes no
/opt/homebrew/bin/duckdb no no
/opt/homebrew/bin/7z no no

orix-convert doctor in the same minimal environment (tool search directories and resolved paths):

text
orix-convert 1.0.0
Executable: <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug/orix-convert (development build, outside an app bundle)

Engines (15, from 12 package(s))
  ENGINE         NAME                 PACKAGE           PATHS  HEAVY  AVAILABLE
  -------------  -------------------  ----------------  -----  -----  ---------
  image          Images               EngineImage       443    —      yes
  pdf            PDF                  EnginePDF         24     —      yes
  vector         Vector Studio        EngineVector      26     —      yes
  video          Video                EngineMedia       302    yes    yes
  audio          Audio                EngineMedia       132    —      yes
  documents      Documents            EngineDocuments   82     yes    yes
  ebooks         Ebooks               EngineDocuments   23     —      yes
  presentations  Presentations        EngineDocuments   24     yes    yes
  data           Spreadsheets & Data  EngineData        219    —      yes
  archive        Archives             EngineArchive     119    —      yes
  font           Fonts                EngineFont        11     —      yes
  subtitle       Subtitles            EngineSubtitle    30     —      yes
  model3d        3D Models            EngineModel3D     132    yes    yes
  geo            Geospatial           EngineGeo         36     —      yes
  scientific     Scientific Data      EngineScientific  10     —      yes
  Registry: 117 formats, 1533 source → destination pairs, 1613 paths, 29 named operations

Tool search directories (in order; PATH is never searched)
  <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug  [ORIX_CONVERT_TOOLS]
  <repo>/EmbeddedEngines/tools  [repository]

Bundled tools
  TOOL                 VERSION   SIZE      FROM                PATH
  -------------------  --------  --------  ------------------  ------------------------------------------------------------------------------------------------------------------------------------
  ffmpeg               9.1       29.6 MB   repository          <repo>/EmbeddedEngines/tools/ffmpeg
  ffprobe              9.1       29.4 MB   repository          <repo>/EmbeddedEngines/tools/ffprobe
  pandoc               3.14      197.0 MB  repository          <repo>/EmbeddedEngines/tools/pandoc
  LibreOffice          26.8.3.1  34.4 KB   repository          <repo>/EmbeddedEngines/tools/LibreOffice.app/Contents/MacOS/soffice
  orix-model3d-helper  n/a       11.2 MB   ORIX_CONVERT_TOOLS  <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug/orix-model3d-helper
  orix-hdf5-probe      n/a       11.1 MB   ORIX_CONVERT_TOOLS  <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug/orix-hdf5-probe

Linked libraries
  LIBRARY         VERSION            LINKAGE                                    USED BY
  --------------  -----------------  -----------------------------------------  ------------------
  DuckDB          v2.0.1             bundled dynamic library (libduckdb.dylib)  data
  SQLite          3.54.0             macOS system library                       data, geo, history
  libarchive      libarchive 3.8.11  static (CArchive.xcframework)              archive
  libwebp         1.6.0              static (CWebP.xcframework)                 image
  Assimp          6.0.2              static (CAssimp.xcframework)               model3d
  woff2 + brotli  not reported       static (CWOFF2.xcframework)                font
  HDF5            2.2.0              static (CHDF5.xcframework)                 scientific

Images loaded from outside /System and /usr/lib
  <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug/orix-convert
  <repo>/Packages/ConvertKit/.build/arm64-apple-macosx/debug/libduckdb.dylib

No problem found: every engine is available and every tool and library comes from the bundle or the repository.

Caveat that applies to an installed copy: BundledTools (core) also searches EmbeddedEngines/tools found by walking up from the path of its own source 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 an app bundle would silently be taken from the repository there. doctor prints the search directories for that reason.

# Result

All checks passed.

Files main
Menu

Theme