diff --git a/content/faq.en.md b/content/faq.en.md index 5d5169ec51997c5be0da7c9dc5d5ce7cd8864113..5468ac0c76522994e47786dce80657972ba9d668 100644 --- a/content/faq.en.md +++ b/content/faq.en.md @@ -192,8 +192,8 @@ We are moving to use Podman as our main compilation method, actually it's mature (Podman avoid environment problems on compilation) -- [Redox Book Guide] (Debian/Ubuntu/Pop OS!) -- [Redox Book Advanced Guide] (Debian/Ubuntu/Pop OS!) +- [Redox Book Guide] - (Debian/Ubuntu/Pop OS!) +- [Redox Book Advanced Guide] - (Debian/Ubuntu/Pop OS!) - [Redox Book Podman Guide] - [Redox Book Podman Advanced Guide] @@ -218,9 +218,9 @@ We are moving to use Podman as our main compilation method, actually it's mature - [How to make pull requests properly] - [GitLab Guide] -[GitLab Guide]: https://gitlab.redox-os.org/redox-os/redox/blob/master/CONTRIBUTING.md [Redox Book Contribution Guide]: https://doc.redox-os.org/book/ch10-02-low-hanging-fruit.html [How to make pull requests properly]: https://doc.redox-os.org/book/ch12-04-creating-proper-pull-requests.html +[GitLab Guide]: https://gitlab.redox-os.org/redox-os/redox/blob/master/CONTRIBUTING.md ### I have a problem/question for Redox team @@ -237,26 +237,26 @@ We are moving to use Podman as our main compilation method, actually it's mature ### How to update the sources and compile the changes? -- [Book Rebuild Guide] +- [Redox Book Rebuild Guide] -[Book Rebuild Guide]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#the-full-rebuild-cycle +[Redox Book Rebuild Guide]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#the-full-rebuild-cycle ### How to insert files inside Redox QEMU harddisk -- [Book QEMU Guide] +- [Redox Book QEMU Guide] -[Book QEMU Guide]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#patch-an-image +[Redox Book QEMU Guide]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#patch-an-image ### How to troubleshoot your build in case of errors -- [Book Troubleshooting Guide] +- [Redox Book Troubleshooting Guide] - [GitLab Troubleshooting Guide] -[Book Troubleshooting Guide]: https://doc.redox-os.org/book/ch08-05-troubleshooting.html +[Redox Book Troubleshooting Guide]: https://doc.redox-os.org/book/ch08-05-troubleshooting.html [GitLab Troubleshooting Guide]: https://gitlab.redox-os.org/redox-os/redox#help-redox-wont-compile diff --git a/content/faq.pt.md b/content/faq.pt.md index 8fc0b3a82e3cebc76ee48372e5edf48bc4667a38..70eef3554afef503b2fe974cad0b22b3edc6f707 100644 --- a/content/faq.pt.md +++ b/content/faq.pt.md @@ -2,236 +2,264 @@ title = "FAQ" +++ -This page covers the most asked questions. +Essa página cobre as perguntas mais comuns. +- [O que é um sistema Unix-like?](#o-que-%C3%A9-um-sistema-unix-like) +- [Como o Redox é inspirado em outros sistemas?](#como-o-redox-%C3%A9-inspirado-em-outros-sistemas) +- [O que é um microkernel?](#o-que-%C3%A9-um-microkernel) +- [Quais dispositivos o Redox suporta?](#quais-dispositivos-o-redox-suporta) +- [Como compilar o Redox?](#como-compilar-o-redox) +- [Como reportar bugs para o Redox?](#como-reportar-bugs-para-o-redox) +- [Como contribuir para o Redox?](#como-contribuir-para-o-redox) +- [Eu tenho um problema/pergunta para a equipe do Redox](#eu-tenho-um-problemapergunta-para-a-equipe-do-redox) +- [Como atualizar o código-fonte e compilar as mudanças?](#como-atualizar-o-c%C3%B3digo-fonte-e-compilar-as-mudan%C3%A7as) +- [Como inserir arquivos no disco rÃgido do QEMU](#como-inserir-arquivos-dentro-do-disco-r%C3%ADgido-do-qemu) +- [Como diagnosticar seu Redox em caso de erros](#como-diagnosticar-seu-redox-em-caso-de-erros) +- [Como abrir o QEMU sem interface gráfica](#como-abrir-o-qemu-sem-interface-gr%C3%A1fica) -- [What is an Unix-like OS?](#what-is-an-unix-like-os) -- [How Redox is inspired by other systems?](#how-redox-is-inspired-by-other-systems) -- [What is a microkernel?](#what-is-a-microkernel) -- [Which devices Redox support?](#which-devices-redox-support) -- [How to build Redox?](#how-to-build-redox) -- [How to report bugs on Redox?](#how-to-report-bugs-on-redox) -- [How to contribute for Redox?](#how-to-contribute-for-redox) -- [I have a problem/question for Redox team](#i-have-a-problemquestion-for-redox-team) -- [How to update the sources and compile the changes?](#how-to-update-the-sources-and-compile-the-changes) -- [How to insert files inside Redox QEMU harddisk](#how-to-insert-files-inside-redox-qemu-harddisk) -- [How to troubleshoot your build in case of errors](#how-to-troubleshoot-your-build-in-case-of-errors) -- [How to launch QEMU without GUI](#how-to-launch-qemu-without-gui) +### O que é um sistema Unix-like? -### What is an Unix-like OS? +Qualquer sistema com traços do design [Unix], tal como uma Shell, o conceito de "Tudo é um arquivo", multitarefa e multiusuário. -Any OS with [Unix] design aspects, such as shell, "everything is a file" concept, multitasking and multiuser. +É importante lembrar que o Unix foi o primeiro sistema de multitarefa moderno do mundo, então qualquer sistema pode ter usado aspectos do seu design de alguma forma. -It's important to remind that Unix was the first modern multitasking system of the world, then any system used his design choices in some way. +- [Artigo da Wikipedia] +[Unix]: https://pt.wikipedia.org/wiki/Unix +[Artigo da Wikipedia]: https://pt.wikipedia.org/wiki/Sistema_operacional_tipo_Unix -- [Wikipedia article] +### Como o Redox é inspirado em outros sistemas? -[Unix]: https://en.wikipedia.org/wiki/Unix -[Wikipedia article]: https://en.wikipedia.org/wiki/Unix-like -### How Redox is inspired by other systems? +[Plan 9] - Este sistema da Bell Labs trouxe o conceito de "Tudo é um arquivo" ao seu maior nÃvel, fazendo toda a comunicação do sistema pelo sistemas de arquivos. -[Plan 9] - This Bell Labs OS bring the concept of "everything is a file" to the highest level, doing all the system communication from the filesystem. +Você apenas precisa montar o software em algum local para obter a função desejada, qualquer software pode funcionar dessa forma. +- [Drew DeVault explicando o Plan 9] +- [Como o Redox utiliza o design do Plan 9] -You just need to mount your software on some path and it have the required functionality, any software can work with this interface. +[Plan 9]: http://9p.io/plan9/index.html +[Drew DeVault explicando o Plan 9]: https://drewdevault.com/2022/11/12/In-praise-of-Plan-9.html +[Como o Redox utiliza o design do Plan 9]: https://doc.redox-os.org/book/ch05-00-urls-schemes-resources.html -- [Drew DeVault explain the Plan 9] -- [How Redox use the Plan 9 design] +[Minix] - o sistema Unix-like com microkernel mais influente, ele possuà funções avançadas tais como modularidade do sistema, resistência a [quebra do kernel], reincarnação de driver, proteção contra drivers ruins e interfaces seguras para a [comunicação dos processos]. -[Plan 9]: http://9p.io/plan9/index.html -[Drew DeVault explain the Plan 9]: https://drewdevault.com/2022/11/12/In-praise-of-Plan-9.html -[How Redox use the Plan 9 design]: https://doc.redox-os.org/book/ch05-00-urls-schemes-resources.html +O Redox é largamente inspirado pelo Minix, ele tem basicamente as mesmas funções mas escritas em Rust. -[Minix] - the most influential Unix-like system with a microkernel, it has advanced features such as system modularity, [kernel panic] resistence, driver reincarnation, protection against bad drivers and secure interfaces for [process comunication]. +[Minix]: https://minix3.org/ +[quebra do kernel]: https://en.wikipedia.org/wiki/Kernel_panic +[comunicação dos processos]: https://en.wikipedia.org/wiki/Inter-process_communication +[Como o Redox implementa o design de microkernel do Minix]: https://doc.redox-os.org/book/ch04-01-microkernels.html -Redox is largely inspired by Minix, it have basically the same features but written in Rust. +[BSD] - Essa [famÃlia] de sistemas Unix fez diversas melhorias para os sistemas Unix, a mais notável são os [sockets BSD], eles trazem a comunicação de rede para o sistema de arquivos Unix (antes do Plan 9). -[Minix]: https://minix3.org/ -[kernel panic]: https://en.wikipedia.org/wiki/Kernel_panic -[process comunication]: https://en.wikipedia.org/wiki/Inter-process_communication -[How Redox implement the Minix microkernel design]: https://doc.redox-os.org/book/ch04-01-microkernels.html +- [Documentação do FreeBSD] -[BSD] - This Unix OS [family] did several improvements on Unix systems, the most notable is [BSD sockets], that brings network communication inside the Unix filesystem (before Plan 9). +[BSD]: https://www.bsd.org/ +[famÃlia]: https://en.wikipedia.org/wiki/Research_Unix +[sockets BSD]: https://en.wikipedia.org/wiki/Berkeley_sockets +[Documentação do FreeBSD]: https://docs.freebsd.org/en/books/developers-handbook/sockets/ +[Linux] - o kernel monolÃtico mais avançado do mundo e maior projeto de código-aberto do mundo, ele traz diversas melhorias/otimizações para sistemas Unix-like. -- [FreeBSD documentation] +O Redox tenta implementar as melhorias de desempenho do Linux em um design de microkernel. -[family]: https://en.wikipedia.org/wiki/Research_Unix -[BSD sockets]: https://en.wikipedia.org/wiki/Berkeley_sockets -[FreeBSD documentation]: https://docs.freebsd.org/en/books/developers-handbook/sockets/ +[Linux]: https://www.kernel.org/ -[Linux] - the most advanced monolithic kernel of the world and biggest open-source project of the world, it brings several improvements/optimizations to Unix-like systems. +### O que é um microkernel? -Redox tries to implement the Linux performance improvements in a microkernel design. +- [Explicação do livro Redox] +[Explicação do livro Redox]: https://doc.redox-os.org/book/ch04-01-microkernels.html -[Linux]: https://www.kernel.org/ +### Quais dispositivos o Redox suporta? -### What is a microkernel? +#### CPU -- [Redox Book explanation] -[Redox Book explanation]: https://doc.redox-os.org/book/ch04-01-microkernels.html +- [x86_64/AMD64] - (Intel/AMD) +- [x86/i686] - (Intel/AMD, incompleto) +- [ARM64] - (incompleto) +[x86_64/AMD64]: https://gitlab.redox-os.org/redox-os/kernel/-/tree/master/src/arch/x86_64 +[x86/i686]: https://gitlab.redox-os.org/redox-os/kernel/-/tree/master/src/arch/x86 +[ARM64]: https://gitlab.redox-os.org/redox-os/kernel/-/tree/master/src/arch/aarch64 -### Which devices Redox support? +#### Interfaces do Hardware -#### CPU +- [ACPI] +- [PCI] -- x86_64/AMD64 (Intel/AMD) -- x86/i686 (Intel/AMD, incomplete) -- ARM64 (WIP, incomplete) +(USB soon) +[ACPI]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/acpid +[PCI]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/pcid #### Internet -- Intel ethernet -- Realtek ethernet +- [Intel Gigabit ethernet] +- [Intel 10 Gigabit ethernet] +- [Realtek ethernet] -(Wi-Fi soon) +(Wi-Fi em breve) +[Intel Gigabit ethernet]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/e1000d +[Intel 10 Gigabit ethernet]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/ixgbed +[Realtek ethernet]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/rtl8168d -#### Sound +#### Som -- Intel chipsets -- Realtek chipsets +- [Intel chipsets] +- [Realtek chipsets] +[Intel chipsets]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/ihdad +[Realtek chipsets]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/ac97d #### Video -- VGA (BIOS) +- [VGA] - (BIOS) - GOP (UEFI) -- [LLVMpipe] (Software Rendering) - +- [LLVMpipe] - Renderização de Software -(Intel/AMD and others in the future) +(Intel/AMD e outros no futuro) +[VGA]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/vesad [LLVMpipe]: https://docs.mesa3d.org/drivers/llvmpipe.html #### Storage -- IDE (PATA) -- AHCI (SATA) -- NVMe +- [IDE] - (PATA) +- [AHCI] - (SATA) +- [NVMe] -(USB soon) + +(USB em breve) + +[IDE]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/ided +[AHCI]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/ahcid +[NVMe]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/nvmed + +#### Periféricos + + +- [Teclados PS/2] +- [Mouse PS/2] +- [Touchpad PS/2] -#### Input +(USB em breve) +[Teclados PS/2]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/ps2d +[Mouse PS/2]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/ps2d +[Touchpad PS/2]: https://gitlab.redox-os.org/redox-os/drivers/-/tree/master/ps2d -- PS/2 keyboards -- PS/2 mouse -- PS/2 touchpad +### Como compilar o Redox? -### How to build Redox? +Atualmente o Redox tem um script de bootstrap para o Debian/Ubuntu/Pop OS! com suporte não mantido para outras distribuições. -Currently Redox has a bootstrap script Debian/Ubuntu/Pop OS! with unmaintained support for other distributions. +Nós estamos em transição para o Podman como nosso método de compilação principal, atualmente ele é bem maduro e compila como o script normal. -We are moving to use Podman as our main compilation method, actually it's mature and compile like the raw script. +(O Podman evita problemas de ambiente durante a compilação) -(Podman avoid environment problems on compilation) +- [Guia no Livro do Redox] - (Debian/Ubuntu/Pop OS!) +- [Guia Avançado no Livro do Redox] - (Debian/Ubuntu/Pop OS!) +- [Guia do Podman no Livro do Redox] +- [Guia Avançado do Podman no Livro do Redox] -- [Redox Book Guide] (Debian/Ubuntu/Pop OS!) -- [Redox Book Advanced Guide] (Debian/Ubuntu/Pop OS!) -- [Redox Book Podman Guide] -- [Redox Book Podman Advanced Guide] +[Guia no Livro do Redox]: https://doc.redox-os.org/book/ch02-05-building-redox.html +[Guia Avançado no Livro do Redox]: https://doc.redox-os.org/book/ch08-01-advanced-build.html +[Guia do Podman no Livro do Redox]: https://doc.redox-os.org/book/ch02-06-podman-build.html +[Guia Avançado do Podman no Livro do Redox]: https://doc.redox-os.org/book/ch08-02-advanced-podman-build.html -[Redox Book Guide]: https://doc.redox-os.org/book/ch02-05-building-redox.html -[Redox Book Advanced Guide]: https://doc.redox-os.org/book/ch08-01-advanced-build.html -[Redox Book Podman Guide]: https://doc.redox-os.org/book/ch02-06-podman-build.html -[Redox Book Podman Advanced Guide]: https://doc.redox-os.org/book/ch08-02-advanced-podman-build.html +### Como reportar bugs para o Redox? -### How to report bugs on Redox? +- [Guia para Relatório de Bug no Livro do Redox] -- [Redox Book Bug Report Guide] +[Guia para Relatório de Bug no Livro do Redox]: https://doc.redox-os.org/book/ch12-03-creating-proper-bug-reports.html -[Redox Book Bug Report Guide]: https://doc.redox-os.org/book/ch12-03-creating-proper-bug-reports.html +### Como contribuir para o Redox? -### How to contribute for Redox? +- [Guia de Contribuição no Livro do Redox] +- [Como fazer pull requests corretamente] +- [Guia do GitLab] -- [GitLab Guide] -- [Redox Book Contribution Guide] -- [How to make pull requests properly] -[GitLab Guide]: https://gitlab.redox-os.org/redox-os/redox/blob/master/CONTRIBUTING.md -[Redox Book Contribution Guide]: https://doc.redox-os.org/book/ch10-02-low-hanging-fruit.html -[How to make pull requests properly]: https://doc.redox-os.org/book/ch12-04-creating-proper-pull-requests.html +[Guia de Contribuição no Livro do Redox]: https://doc.redox-os.org/book/ch10-02-low-hanging-fruit.html +[Como fazer pull requests corretamente]: https://doc.redox-os.org/book/ch12-04-creating-proper-pull-requests.html +[Guia do GitLab]: https://gitlab.redox-os.org/redox-os/redox/blob/master/CONTRIBUTING.md -### I have a problem/question for Redox team +### Eu tenho um problema/pergunta para a equipe do Redox -- Read all the [Redox book] to see if it answer your questions/fix your problem. -- If the book is not enough for you, make your question/say your problem on [Redox Support] or [Redox Dev] rooms on Matrix. +- Leia todo [livro do Redox] para ver se isso responde suas pergunta/corrige seu problema. +- Se o livro não for suficiente pra você, diga sua pergunta/problema nas salas [Redox Support] ou [Redox Dev] no Matrix. -[Redox book]: https://doc.redox-os.org/book/ +[livro do Redox]: https://doc.redox-os.org/book/ [Redox Support]: https://matrix.to/#/#redox-support:matrix.org [Redox Dev]: https://matrix.to/#/#redox-dev:matrix.org -### How to update the sources and compile the changes? +### Como atualizar o código-fonte e compilar as mudanças? -- [Book Rebuild Guide] +- [Guia de Recompilação no Livro do Redox] -[Book Rebuild Guide]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#the-full-rebuild-cycle +[Guia de Recompilação no Livro do Redox]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#the-full-rebuild-cycle -### How to insert files inside Redox QEMU harddisk +### Como inserir arquivos dentro do disco rÃgido do QEMU -- [Book QEMU Guide] +- [Guia do QEMU no livro do Redox] -[Book QEMU Guide]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#patch-an-image +[Guia do QEMU no livro do Redox]: https://doc.redox-os.org/book/ch09-02-coding-and-building.html#patch-an-image -### How to troubleshoot your build in case of errors +### Como diagnosticar seu Redox em caso de erros -- [Book Troubleshooting Guide] -- [GitLab Troubleshooting Guide] +- [Guia de Diagnóstico no Livro do Redox] +- [Guia de Diagnóstico no GitLab] -[Book Troubleshooting Guide]: https://doc.redox-os.org/book/ch08-05-troubleshooting.html -[GitLab Troubleshooting Guide]: https://gitlab.redox-os.org/redox-os/redox#help-redox-wont-compile +[Guia de Diagnóstico no Livro do Redox]: https://doc.redox-os.org/book/ch08-05-troubleshooting.html +[Guia de Diagnóstico no GitLab]: https://gitlab.redox-os.org/redox-os/redox#help-redox-wont-compile -### How to launch QEMU without GUI +### Como abrir o QEMU sem interface gráfica -- Run `make qemu vga=no` +- Execute `make qemu vga=no` -QEMU terminal will looks like a container/chroot. +O QEMU ficará semelhante a um container/chroot.