From f0309984c8c7eb818c99337d6d8280618bfb2398 Mon Sep 17 00:00:00 2001 From: core Date: Thu, 27 Jul 2023 17:35:26 -0400 Subject: [PATCH] more docs improvements --- docs/tfclient/untested_os.md | 2 -- docs/tfclient/why_not_this_os.md | 6 ++++-- index.md | 4 ++++ 3 files changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/tfclient/untested_os.md b/docs/tfclient/untested_os.md index 3560ea5..a07fc1b 100644 --- a/docs/tfclient/untested_os.md +++ b/docs/tfclient/untested_os.md @@ -11,5 +11,3 @@ If you aren't able to get tfclient to compile with nebula-ffi, consider trying i Any findings, positive or negative, can be posted straight to [trifid-devel](https://lists.e3t.cc/~core/trifid-devel). Thanks! We really appreciate it. - -[Return home](docs/tfclient/index.md) diff --git a/docs/tfclient/why_not_this_os.md b/docs/tfclient/why_not_this_os.md index d34e562..281d0fd 100644 --- a/docs/tfclient/why_not_this_os.md +++ b/docs/tfclient/why_not_this_os.md @@ -1,9 +1,11 @@ # Why cant tfclient support XXXXX? -There are limits to what operating systems and architectures tfclient can support. As you may know, tfclient is based upon the [Nebula](https://github.com/slackhq/nebula) project, maintained by Slack. tfclient can only support architectures and operating systems that [Nebula itself supports](https://github.com/slackhq/nebula/releases/). +There are limits to what operating systems and architectures tfclient can support. As you may know, tfclient is based upon the [Nebula](https://github.com/slackhq/nebula) project, maintained by Slack and Defined Networking. tfclient can only support architectures and operating systems that [Nebula itself supports](https://github.com/slackhq/nebula/releases/). In addition, tfclient, being written in Rust, can only function in environments [where Rust compiles well](https://doc.rust-lang.org/nightly/rustc/platform-support.html). For example, this rules out MIPS - `rustc` currently does not function correctly on that architecture, and thus tfclient cannot, and likely never will support that architecture. +Finally, tfclient generally requires a functioning CGo compiler, in order to properly link to Nebula. If this is not available, but tfclient itself compiles fine, this is known as a 'Tier 2' platform - you must compile and run Nebula separately, and tfclient will be unable to manage it other than providing it's config. + Did Nebula add a new architecture, and we missed it? Rust supports a new architecture in a new release? [Let us know!](https://lists.e3t.cc/~core/trifid-devel) We love adding support for new systems whenever we can. -Did we miss an architecture? If your architecture is supported by BOTH Nebula and Rust, but you still get `This architecture is not supported yet :(` when trying to build tfclient, we might have missed you - [get in touch](https://lists.e3t.cc/~core/trifid-devel) and we will work with you to get your system supported :D \ No newline at end of file +Did we miss an architecture? If your architecture is supported by Nebula, Rust, and CGo, but you still get linking errors or segfaults when trying to build tfclient, we might have missed you - [get in touch](https://lists.e3t.cc/~core/trifid-devel) and we will work with you to get your system supported :D diff --git a/index.md b/index.md index 1e33a30..2257258 100644 --- a/index.md +++ b/index.md @@ -38,6 +38,10 @@ The API implementation is tested with the official dnclient implementation, and See the [main trifid project page](https://hub.e3t.cc/~core/trifid) for an up-to-date platform support table. +## Why don't mobile devices work? + +See the [page on this topic](docs/tfclient/mobile.md). + # Get in touch Have a question about trifid? Check out the [discussion mailing list](https://lists.e3t.cc/~core/trifid-discuss)! `trifid-discuss` is a mailing list for end-user discussion and questions related to the trifid project.