Skip to content

Commit a7ecc71

Browse files
committed
Note the incomplete Command support in the apple-tvos.md document
1 parent 37854aa commit a7ecc71

File tree

1 file changed

+16
-3
lines changed

1 file changed

+16
-3
lines changed

src/doc/rustc/src/platform-support/apple-tvos.md

+16-3
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@ These targets are cross-compiled. You will need appropriate versions of Xcode
1818
and the SDKs for tvOS (`AppleTVOS.sdk`) and/or the tvOS Simulator
1919
(`AppleTVSimulator.sdk`) to build a toolchain and target these platforms.
2020

21-
The targets support the full standard library including the allocator to the
22-
best of my knowledge, however they are very new, not yet well-tested, and
23-
it is possible that there are various bugs.
21+
The targets support most (see below) of the standard library including the
22+
allocator to the best of my knowledge, however they are very new, not yet
23+
well-tested, and it is possible that there are various bugs.
2424

2525
In theory we support back to tvOS version 7.0, although the actual minimum
2626
version you can target may be newer than this, for example due to the versions
@@ -30,6 +30,19 @@ As with the other Apple targets, `rustc` respects the common environment
3030
variables used by Xcode to configure this, in this case
3131
`TVOS_DEPLOYMENT_TARGET`.
3232

33+
#### Incompletely supported library functionality
34+
35+
As mentioned, "most" of the standard library is supported, which means that some portions
36+
are known to be unsupported. The following APIs are currently known to have
37+
missing or incomplete support:
38+
39+
- `std::process::Command`'s API will return an error if it is configured in a
40+
manner which cannot be performed using `posix_spawn` -- this is because the
41+
more flexible `fork`/`exec`-based approach is prohibited on these platforms in
42+
favor of `posix_spawn{,p}`. A concrete set of cases where this will occur is
43+
difficult to enumerate (and would quickly become stale), but in some cases it
44+
may be worked around by tweaking the manner in which `Command` is invoked.
45+
3346
## Building the target
3447

3548
The targets can be built by enabling them for a `rustc` build in `config.toml`, by adding, for example:

0 commit comments

Comments
 (0)