From nobody Sun Jul 2 20:37:57 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QvLTy2SFDz4l6DT for ; Sun, 2 Jul 2023 20:37:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QvLTy1kWpz3s4p; Sun, 2 Jul 2023 20:37:58 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688330278; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=P66xNu1a8N5Kq+I9569urusXtQ13XHqgYPcT1alB3BA=; b=q34+T5cgiw/1h8TrfM3MibDjJ8bk42rlfqoCNAxbdaOxwOFp1SFRMA/2lLV36/Q135forC wL48LQ+/zxSKvtYaWvOz8PNp2q8bk4Imyp54EG75r053zZipUaVV0DZ5u4H+or4nChfYWS zsO1j4zoGlQhv4vfZjdDB8Qax8nTu9x+mFYMx/Oa9ZjOh0/wrMLBt/IG5pdqoOgmMzbUqZ zDvCNxsHOpLuEptj5COlL5XIsn7z2Ydzn4MtvNPzFURJRQTqQY4aiIsCqhW1QPiWEeGD2U LnoLL52ymzXiAq2JHQDJntzcegCibREJUWDvLleEbihWbirqzq9rIHk6I+Dr1w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688330278; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=P66xNu1a8N5Kq+I9569urusXtQ13XHqgYPcT1alB3BA=; b=wFZNNt2CRkC0Zcq0s1VWfSkIYJZuI+36qlbD2tI3NJAwouKVJg8orP5qipGKMFDdC9QpOa E41zaQ4eJMQjz68HBGK3zmxMqli+hLIRqxPlbk8EEB4ASbhG5eMC2jQv5MpEVLeZ1+Ain1 XWQXoBcswbaxIWp8hCypWX5YeGKN8OD0ZtCvhK64HsmW/yZt8JHCFahAKc6DNk/XhGWv9J hKBaOyrj7i5OTGEH2XQXZbnQq+2WJgcD1t3wEu0wEqBrNROkfaBFPma5J8ZRmdOKhXLUun h3rB675BqlyynBZu7Ek44qIA1OmcTg/eB5R1aCH4+xqEe/sH1ScX1yEbsR6RhA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688330278; a=rsa-sha256; cv=none; b=LpXeEecxR/34oms72eXF8l1szqZvmvJeKY9rRbHzoI4o5S7jxkqssXT7T9fLofxRhShvxl KLBzipswtoKAvGEwUSHJpRJVdAkSBS6A+2al1R8Yb71LdlaKaUk5GKhxQ3JQ6czRjukJ69 2QKatKRGchRki/qdGcYTyksmTXiBJr3X6RbGQhg4rCnvToimbL2xccZ/X2bOAWi6nUHQm7 IlOa7Zw4FpGx9xwEaDypujL0k6W6WJw0Wp9SdH+GvhcOnUGaSNLtfPMOM9nCblmy4mX6jT IV2RwRDYQePbfERPBU5No2DIElJKXm4D6in6CqLONBb12NLvGApEcnrB1TwYRw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QvLTy0gYKzN6r; Sun, 2 Jul 2023 20:37:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 362KbwXY066215; Sun, 2 Jul 2023 20:37:58 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 362Kbvuv066213; Sun, 2 Jul 2023 20:37:57 GMT (envelope-from git) Date: Sun, 2 Jul 2023 20:37:57 GMT Message-Id: <202307022037.362Kbvuv066213@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: 82deda5ebd - main - pt-br/books/fdp-primer: Sync with en 0f02d4b List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 82deda5ebd272f25432a49d9236c213865258f1e Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=82deda5ebd272f25432a49d9236c213865258f1e commit 82deda5ebd272f25432a49d9236c213865258f1e Author: Danilo G. Baio AuthorDate: 2023-07-02 20:34:18 +0000 Commit: Danilo G. Baio CommitDate: 2023-07-02 20:34:18 +0000 pt-br/books/fdp-primer: Sync with en 0f02d4b - Add Weblate chapter Obtained from: https://translate-dev.freebsd.org --- .../content/pt-br/books/fdp-primer/_index.adoc | 2 +- .../content/pt-br/books/fdp-primer/book.adoc | 6 +- .../books/fdp-primer/editor-config/_index.adoc | 6 +- .../pt-br/books/fdp-primer/editor-config/_index.po | 8 +- .../books/fdp-primer/manual-pages/_index.adoc | 6 +- .../pt-br/books/fdp-primer/manual-pages/_index.po | 20 +- .../books/fdp-primer/po-translations/_index.adoc | 81 +- .../books/fdp-primer/po-translations/_index.po | 528 ++++---- .../pt-br/books/fdp-primer/see-also/_index.adoc | 4 +- .../pt-br/books/fdp-primer/see-also/_index.po | 13 +- .../pt-br/books/fdp-primer/trademarks/_index.adoc | 4 +- .../pt-br/books/fdp-primer/trademarks/_index.po | 22 +- .../pt-br/books/fdp-primer/weblate/_index.adoc | 454 +++++++ .../pt-br/books/fdp-primer/weblate/_index.po | 1279 ++++++++++++++++++++ .../books/fdp-primer/writing-style/_index.adoc | 4 +- .../pt-br/books/fdp-primer/writing-style/_index.po | 16 +- 16 files changed, 2093 insertions(+), 360 deletions(-) diff --git a/documentation/content/pt-br/books/fdp-primer/_index.adoc b/documentation/content/pt-br/books/fdp-primer/_index.adoc index 8433026c82..aacb2a95eb 100644 --- a/documentation/content/pt-br/books/fdp-primer/_index.adoc +++ b/documentation/content/pt-br/books/fdp-primer/_index.adoc @@ -11,7 +11,7 @@ path: /books/fdp-primer/ showBookMenu: 'true' tags: ["FDP", "documentation", "FreeBSD", "Index"] title: 'Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores' -trademarks: ["general"] +trademarks: ["freebsd", "general", "git"] weight: 10 --- diff --git a/documentation/content/pt-br/books/fdp-primer/book.adoc b/documentation/content/pt-br/books/fdp-primer/book.adoc index c19ac3a030..d0e40494b3 100644 --- a/documentation/content/pt-br/books/fdp-primer/book.adoc +++ b/documentation/content/pt-br/books/fdp-primer/book.adoc @@ -3,11 +3,11 @@ add_split_page_link: 'true' authors: - author: 'The FreeBSD Documentation Project' -copyright: '1998-2021 DocEng' +copyright: '1998-2023 The FreeBSD Documentation Project' description: 'Tudo que você precisa saber para começar a contribuir para o Projeto de Documentação do FreeBSD' tags: ["FDP", "documentation", "FreeBSD", "Index"] title: 'Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores' -trademarks: ["general"] +trademarks: ["freebsd", "general", "git"] --- = Primer do Projeto de Documentação do FreeBSD para Novos Colaboradores @@ -83,6 +83,8 @@ include::{chapters-path}translations/_index.adoc[leveloffset=+1] include::{chapters-path}po-translations/_index.adoc[leveloffset=+1] +include::{chapters-path}weblate/_index.adoc[leveloffset=+1] + include::{chapters-path}manual-pages/_index.adoc[leveloffset=+1] include::{chapters-path}writing-style/_index.adoc[leveloffset=+1] diff --git a/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc b/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc index 467d848db6..a9adb7a4e1 100644 --- a/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc +++ b/documentation/content/pt-br/books/fdp-primer/editor-config/_index.adoc @@ -5,7 +5,7 @@ path: /books/fdp-primer/ prev: books/fdp-primer/writing-style showBookMenu: 'true' tags: ["editor", "configuration", "vim", "emacs", "FreeBSD"] -title: 'Capítulo 12. Configuração do Editor' +title: 'Capítulo 13. Configuração do Editor' weight: 13 --- @@ -17,7 +17,7 @@ weight: 13 :icons: font :sectnums: :sectnumlevels: 6 -:sectnumoffset: 12 +:sectnumoffset: 13 :partnums: :source-highlighter: rouge :experimental: @@ -58,7 +58,7 @@ Instale o package:editors/vim[], ou package:editors/vim-console[], em seguida si === Uso Os escritores de páginas de manuais podem usar os seguintes atalhos de teclado para reformatar: -+ + * Pressione kbd:[P] para reformatar parágrafos ou texto selecionado no modo Visual. * Pressione kbd:[T] para substituir grupos de oito espaços por um tab. diff --git a/documentation/content/pt-br/books/fdp-primer/editor-config/_index.po b/documentation/content/pt-br/books/fdp-primer/editor-config/_index.po index 7ce30e761e..3cab9abbd5 100644 --- a/documentation/content/pt-br/books/fdp-primer/editor-config/_index.po +++ b/documentation/content/pt-br/books/fdp-primer/editor-config/_index.po @@ -6,8 +6,8 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2023-04-20 20:56-0300\n" -"PO-Revision-Date: 2023-04-22 03:54+0000\n" +"POT-Creation-Date: 2023-06-19 21:07-0300\n" +"PO-Revision-Date: 2023-07-02 17:42+0000\n" "Last-Translator: \"Danilo G. Baio\" \n" "Language-Team: Portuguese (Brazil) \n" @@ -27,8 +27,8 @@ msgstr "Configuração usada nos editores de textos do Projeto de Documentação #. type: YAML Front Matter: title #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:1 #, no-wrap -msgid "Chapter 12. Editor Configuration" -msgstr "Capítulo 12. Configuração do Editor" +msgid "Chapter 13. Editor Configuration" +msgstr "Capítulo 13. Configuração do Editor" #. type: Title = #: documentation/content/en/books/fdp-primer/editor-config/_index.adoc:13 diff --git a/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.adoc b/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.adoc index 2ca6787827..7cdc122252 100644 --- a/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.adoc +++ b/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.adoc @@ -2,10 +2,10 @@ description: 'Como trabalhar com as Páginas de Manual do FreeBSD' next: books/fdp-primer/writing-style path: /books/fdp-primer/ -prev: books/fdp-primer/po-translations +prev: books/fdp-primer/weblate showBookMenu: 'true' tags: ["manual pages", "introduction", "guide", "reference"] -title: 'Capítulo 10. Páginas de Manual' +title: 'Capítulo 11. Páginas de Manual' weight: 11 --- @@ -17,7 +17,7 @@ weight: 11 :icons: font :sectnums: :sectnumlevels: 6 -:sectnumoffset: 10 +:sectnumoffset: 11 :partnums: :source-highlighter: rouge :experimental: diff --git a/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.po b/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.po index 8c018bb9f6..9345dbf5ae 100644 --- a/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.po +++ b/documentation/content/pt-br/books/fdp-primer/manual-pages/_index.po @@ -2,12 +2,13 @@ # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. # Danilo G. Baio , 2021, 2022. +# "Danilo G. Baio" , 2023. msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2022-02-01 10:28-0300\n" -"PO-Revision-Date: 2022-02-06 19:23+0000\n" -"Last-Translator: Danilo G. Baio \n" +"POT-Creation-Date: 2023-06-19 21:07-0300\n" +"PO-Revision-Date: 2023-07-02 17:42+0000\n" +"Last-Translator: \"Danilo G. Baio\" \n" "Language-Team: Portuguese (Brazil) \n" "Language: pt_BR\n" @@ -15,7 +16,7 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=n > 1;\n" -"X-Generator: Weblate 4.10.1\n" +"X-Generator: Weblate 4.17\n" #. type: YAML Front Matter: description #: documentation/content/en/books/fdp-primer/manual-pages/_index.adoc:1 @@ -26,8 +27,8 @@ msgstr "Como trabalhar com as Páginas de Manual do FreeBSD" #. type: YAML Front Matter: title #: documentation/content/en/books/fdp-primer/manual-pages/_index.adoc:1 #, no-wrap -msgid "Chapter 10. Manual Pages" -msgstr "Capítulo 10. Páginas de Manual" +msgid "Chapter 11. Manual Pages" +msgstr "Capítulo 11. Páginas de Manual" #. type: Title = #: documentation/content/en/books/fdp-primer/manual-pages/_index.adoc:13 @@ -559,8 +560,8 @@ msgid "" "to the beginning of flags, so this appears in the manual page as `--libxo`." msgstr "" "Uma _Optional_ _Flag_ chamada `-libxo` é mostrada. A macro `Fl` adiciona um " -"traço ao início das flags, então isso aparece na página de manual " -"como`--libxo`." +"traço ao início das flags, então isso aparece na página de manual como`--" +"libxo`." #. type: Plain text #: documentation/content/en/books/fdp-primer/manual-pages/_index.adoc:219 @@ -970,8 +971,7 @@ msgid "" "Called with a name as a parameter on the first use, then used later without the parameter to display the name that has already been defined." msgstr "" "Nome.\n" -"Chamado com um nome como parâmetro no primeiro uso, depois usado sem o " -"parâmetro para exibir o nome que já foi definido." +"Chamado com um nome como parâmetro no primeiro uso, depois usado sem o parâmetro para exibir o nome que já foi definido." #. type: Table #: documentation/content/en/books/fdp-primer/manual-pages/_index.adoc:361 diff --git a/documentation/content/pt-br/books/fdp-primer/po-translations/_index.adoc b/documentation/content/pt-br/books/fdp-primer/po-translations/_index.adoc index 20d72137ab..54f27ddcbd 100644 --- a/documentation/content/pt-br/books/fdp-primer/po-translations/_index.adoc +++ b/documentation/content/pt-br/books/fdp-primer/po-translations/_index.adoc @@ -1,12 +1,12 @@ --- description: 'Como trabalhar com tradução de arquivos PO no Projeto de Documentação do FreeBSD' -next: books/fdp-primer/manual-pages +next: books/fdp-primer/weblate path: /books/fdp-primer/ prev: books/fdp-primer/translations showBookMenu: 'true' tags: ["po", "translations", "tutorial", "quick start"] title: 'Capítulo 9. Traduções PO' -weight: 10 +weight: 9 --- [[po-translations]] @@ -86,13 +86,17 @@ Quando uma nova tradução é criada pela primeira vez, a estrutura do diretóri % mkdir ~/doc/documentation/content/es/articles/leap-seconds .... -. Copie o [.filename]#_index.adoc# do documento original para o diretório de tradução: +. Copie o [.filename]#_index.po# do documento original para o diretório de tradução: + [source, shell] .... -% cp ~/doc/documentation/content/en/articles/leap-seconds/_index.adoc \ +% cp ~/doc/documentation/content/en/articles/leap-seconds/_index.po \ ~/doc/documentation/content/es/articles/leap-seconds/ .... + +Supondo que o documento ou idioma também esteja sendo traduzido via Weblate. Nesse caso, é bom pegar o arquivo `.po` de lá e carregar o documento de tradução de volta na plataforma, centralizando os esforços de tradução via Weblate para evitar retrabalho. + +Veja como baixar os arquivos `.po` no capítulo crossref:weblate[weblate-translating-offline,Traduzindo Offline no Weblate]. ==== [[po-translations-quick-start-translation]] @@ -100,26 +104,8 @@ Quando uma nova tradução é criada pela primeira vez, a estrutura do diretóri ==== .Procedimento. Tradução -A tradução de um documento consiste em duas etapas: extrair strings traduzíveis do documento original e inserir as traduções dessas strings. Essas etapas são repetidas até que o tradutor sinta que o documento foi traduzido o suficiente para produzir um documento traduzido que seja utilizável. +Use um editor PO para inserir as traduções no arquivo PO. Existem vários editores diferentes disponíveis. O [.filename]#poedit# do package:editors/poedit[] é mostrado aqui. -. Extraia as strings traduzíveis da versão original em Inglês para um arquivo PO: -+ -[source, shell] -.... -% cd ~/doc -% po4a-gettextize \ - --format asciidoc \ - --option compat=asciidoctor \ - --option yfm_keys=title,part,description \ - --master "documentation/content/en/articles/leap-seconds/_index.adoc" \ - --master-charset "UTF-8" \ - --copyright-holder "The FreeBSD Project" \ - --package-name "FreeBSD Documentation" \ - --po "documentation/content/es/articles/leap-seconds/_index.po" -.... -+ -. Use um editor PO para inserir as traduções no arquivo PO. Existem vários editores diferentes disponíveis. O [.filename]#poedit# do package:editors/poedit[] é mostrado aqui. -+ [source, shell] .... % poedit documentation/content/es/articles/leap-seconds/_index.po @@ -135,16 +121,7 @@ A tradução de um documento consiste em duas etapas: extrair strings traduzíve [source, shell] .... % cd ~/doc -% po4a-translate \ - --format asciidoc \ - --option compat=asciidoctor \ - --option yfm_keys=title,part,description \ - --master "documentation/content/en/articles/leap-seconds/_index.adoc" \ - --master-charset "UTF-8" \ - --po "documentation/content/es/articles/leap-seconds/_index.po" \ - --localized "documentation/content/es/articles/leap-seconds/_index.adoc" \ - --localized-charset "UTF-8" \ - --keep 0 +% ./tools/translate.sh documentation es articles/leap-seconds .... + O nome do documento gerado corresponde ao nome do original em Inglês, geralmente [.filename]#_index.adoc#. @@ -296,39 +273,9 @@ Um editor PO é usado para editar o arquivo. package:editors/poedit[] é usado n É importante preservar o arquivo PO. Ele contém todo o trabalho que os tradutores fizeram. -[[po-translations-translating-example]] -.Traduzindo o Porter's Handbook para o Espanhol -[example] +[IMPORTANT] ==== - -[.procedure] -====== -. Mude para o diretório base e atualize todos os arquivos PO. -+ -[source, shell] -.... -% cd ~/doc -% po4a-gettextize \ - --format asciidoc \ - --option compat=asciidoctor \ - --option yfm_keys=title,part,description \ - --master "documentation/content/en/books/porters-handbook/_index.adoc" \ - --master-charset "UTF-8" \ - --copyright-holder "The FreeBSD Project" \ - --package-name "FreeBSD Documentation" \ - --po "documentation/content/es/books/porters-handbook/_index.po" -.... - -. Realize as traduções usando um editor de PO: -+ -[source, shell] -.... -% poedit documentation/content/es/books/porters-handbook/_index.po -.... -====== - -Essas etapas são necessárias para todos os arquivos `.adoc`, exceto `chapters-order.adoc` e `toc-*.adoc`. - +Traduzir documentos online tende a ser o método mais fácil para tradução de documentos no FreeBSD, pois permite que vários usuários colaborem no mesmo arquivo, distribuindo a carga de trabalho de forma eficaz. Para obter mais detalhes, consulte o próximo capítulo, crossref:weblate[weblate-introduction,Traduções Weblate]. ==== [[po-translations-tips]] @@ -387,6 +334,8 @@ O conteúdo de algumas tags devem ser copiadas igualmente, sem realizar traduç Uma versão traduzida do documento original pode ser criada a qualquer momento. Quaisquer porções não traduzidas do original serão incluídas em Inglês no documento resultante. A maioria dos editores PO tem um indicador que mostra quanto da tradução foi realizada. Isso torna mais fácil para o tradutor ver quantas strings foram traduzidas para tornar a compilação do documento final utilizável. +O capítulo Weblate fornece um exemplo completo sobre crossref:weblate[weblate-building,Compilando o Documento Traduzido]. + [[po-translations-submitting]] == Submetendo a Nova Tradução @@ -410,4 +359,6 @@ Os arquivos diff criados por esses exemplos podem ser anexados a um https://bugs .... ====== +O capítulo Weblate fornece um exemplo completo sobre crossref:weblate[weblate-submit-translations,Enviando Traduções]. + ==== diff --git a/documentation/content/pt-br/books/fdp-primer/po-translations/_index.po b/documentation/content/pt-br/books/fdp-primer/po-translations/_index.po index 0b13d0a8c4..7c9d44f9eb 100644 --- a/documentation/content/pt-br/books/fdp-primer/po-translations/_index.po +++ b/documentation/content/pt-br/books/fdp-primer/po-translations/_index.po @@ -6,8 +6,8 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2022-02-01 10:28-0300\n" -"PO-Revision-Date: 2023-04-22 03:54+0000\n" +"POT-Creation-Date: 2023-06-19 21:07-0300\n" +"PO-Revision-Date: 2023-07-02 18:16+0000\n" "Last-Translator: \"Danilo G. Baio\" \n" "Language-Team: Portuguese (Brazil) \n" @@ -149,81 +149,54 @@ msgstr "% mkdir ~/doc/documentation/content/es/articles/leap-seconds\n" #. type: Plain text #: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:97 msgid "" -"Copy the [.filename]#_index.adoc# from the original document into the " +"Copy the [.filename]#_index.po# from the original document into the " "translation directory:" msgstr "" -"Copie o [.filename]#_index.adoc# do documento original para o diretório de " +"Copie o [.filename]#_index.po# do documento original para o diretório de " "tradução:" #. type: delimited block . 4 #: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:102 #, no-wrap msgid "" -"% cp ~/doc/documentation/content/en/articles/leap-seconds/_index.adoc \\\n" +"% cp ~/doc/documentation/content/en/articles/leap-seconds/_index.po \\\n" " ~/doc/documentation/content/es/articles/leap-seconds/\n" msgstr "" -"% cp ~/doc/documentation/content/en/articles/leap-seconds/_index.adoc \\\n" +"% cp ~/doc/documentation/content/en/articles/leap-seconds/_index.po \\\n" " ~/doc/documentation/content/es/articles/leap-seconds/\n" -#. type: Block title -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:108 -#, no-wrap -msgid "Procedure: Translation" -msgstr "Procedimento. Tradução" - #. type: Plain text -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:112 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:106 msgid "" -"Translating a document consists of two steps: extracting translatable " -"strings from the original document, and entering translations for those " -"strings. These steps are repeated until the translator feels that enough of " -"the document has been translated to produce a usable translated document." +"Suppose the document or language is also being translated via Weblate. In " +"that case, it is good to get the `.po` file from there and upload the " +"translation document back into the platform, centralizing the translating " +"efforts via Weblate to avoid rework." msgstr "" -"A tradução de um documento consiste em duas etapas: extrair strings " -"traduzíveis do documento original e inserir as traduções dessas strings. " -"Essas etapas são repetidas até que o tradutor sinta que o documento foi " -"traduzido o suficiente para produzir um documento traduzido que seja " -"utilizável." +"Supondo que o documento ou idioma também esteja sendo traduzido via Weblate. " +"Nesse caso, é bom pegar o arquivo `.po` de lá e carregar o documento de " +"tradução de volta na plataforma, centralizando os esforços de tradução via " +"Weblate para evitar retrabalho." #. type: Plain text -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:114 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:108 msgid "" -"Extract the translatable strings from the original English version into a PO " -"file:" +"See how to download the `.po` files in the crossref:weblate[weblate-" +"translating-offline,Translating Offline on Weblate] chapter." msgstr "" -"Extraia as strings traduzíveis da versão original em Inglês para um arquivo " -"PO:" +"Veja como baixar os arquivos `.po` no capítulo crossref:weblate[weblate-" +"translating-offline,Traduzindo Offline no Weblate]." -#. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:127 +#. type: Block title +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:113 #, no-wrap -msgid "" -"% cd ~/doc\n" -"% po4a-gettextize \\\n" -" --format asciidoc \\\n" -" --option compat=asciidoctor \\\n" -" --option yfm_keys=title,part,description \\\n" -" --master \"documentation/content/en/articles/leap-seconds/_index.adoc\" \\\n" -" --master-charset \"UTF-8\" \\\n" -" --copyright-holder \"The FreeBSD Project\" \\\n" -" --package-name \"FreeBSD Documentation\" \\\n" -" --po \"documentation/content/es/articles/leap-seconds/_index.po\"\n" -msgstr "" -"% cd ~/doc\n" -"% po4a-gettextize \\\n" -" --format asciidoc \\\n" -" --option compat=asciidoctor \\\n" -" --option yfm_keys=title,part,description \\\n" -" --master \"documentation/content/en/articles/leap-seconds/_index.adoc\" \\\n" -" --master-charset \"UTF-8\" \\\n" -" --copyright-holder \"The FreeBSD Project\" \\\n" -" --package-name \"FreeBSD Documentation\" \\\n" -" --po \"documentation/content/es/articles/leap-seconds/_index.po\"\n" +msgid "Procedure: Translation" +msgstr "Procedimento. Tradução" #. type: Plain text -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:130 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:117 msgid "" -"Use a PO editor to enter translations in the PO file. There are several " +"Use a PO editor to enter translations in the PO file. There are several " "different editors available. [.filename]#poedit# from package:editors/" "poedit[] is shown here." msgstr "" @@ -232,52 +205,34 @@ msgstr "" "poedit[] é mostrado aqui." #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:134 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:121 #, no-wrap msgid "% poedit documentation/content/es/articles/leap-seconds/_index.po\n" msgstr "% poedit documentation/content/es/articles/leap-seconds/_index.po\n" #. type: Block title -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:140 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:127 #, no-wrap msgid "Procedure: Generating a Translated Document" msgstr "Procedimento. Gerando um Documento Traduzido" #. type: Plain text -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:142 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:129 msgid "Generate the translated document:" msgstr "Gere o documento traduzido:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:156 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:134 #, no-wrap msgid "" "% cd ~/doc\n" -"% po4a-translate \\\n" -" --format asciidoc \\\n" -" --option compat=asciidoctor \\\n" -" --option yfm_keys=title,part,description \\\n" -" --master \"documentation/content/en/articles/leap-seconds/_index.adoc\" \\\n" -" --master-charset \"UTF-8\" \\\n" -" --po \"documentation/content/es/articles/leap-seconds/_index.po\" \\\n" -" --localized \"documentation/content/es/articles/leap-seconds/_index.adoc\" \\\n" -" --localized-charset \"UTF-8\" \\\n" -" --keep 0\n" +"% ./tools/translate.sh documentation es articles/leap-seconds\n" msgstr "" "% cd ~/doc\n" -"% po4a-translate \\\n" -" --format asciidoc \\\n" -" --option compat=asciidoctor \\\n" -" --option yfm_keys=title,part,description \\\n" -" --master \"documentation/content/en/articles/leap-seconds/_index.adoc\" \\\n" -" --master-charset \"UTF-8\" \\\n" -" --po \"documentation/content/es/articles/leap-seconds/_index.po\" \\\n" -" --localized \"documentation/content/es/articles/leap-seconds/_index.adoc\" \\\n" -" --localized-charset \"UTF-8\" \\\n" -" --keep 0\n" +"% ./tools/translate.sh documentation es articles/leap-seconds\n" #. type: Plain text -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:159 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:137 msgid "" "The name of the generated document matches the name of the English original, " "usually [.filename]#_index.adoc#." @@ -286,7 +241,7 @@ msgstr "" "geralmente [.filename]#_index.adoc#." #. type: Plain text -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:161 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:139 msgid "" "Check the generated file by rendering it to HTML and viewing it with a web " "browser:" @@ -295,7 +250,7 @@ msgstr "" "navegador web:" #. type: delimited block . 4 -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:166 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:144 #, no-wrap msgid "" "% cd ~/doc/documentation\n" @@ -305,13 +260,13 @@ msgstr "" "% make\n" #. type: Title == -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:170 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:148 #, no-wrap msgid "Creating New Translations" msgstr "Criando Novas Traduções" #. type: delimited block = 4 -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:175 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:153 msgid "" "The first step to creating a new translated document is locating or creating " "a directory to hold it. FreeBSD puts translated documents in a subdirectory " @@ -324,368 +279,368 @@ msgstr "" "_lang_ é um código minúsculo de dois caracteres." #. type: Block title -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:177 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:155 #, no-wrap msgid "Language Names" msgstr "Nomes de Idioma" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:181 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:159 #, no-wrap msgid "Language" msgstr "Idioma" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:182 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:160 #, no-wrap msgid "Region" msgstr "Região" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:184 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:162 #, no-wrap msgid "Translated Directory Name" msgstr "Nome do Diretório da Tradução" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:185 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:163 #, no-wrap msgid "English" msgstr "English" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:186 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:164 #, no-wrap msgid "United States" msgstr "United States" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:188 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:166 #, no-wrap msgid "[.filename]#en#" msgstr "[.filename]#en#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:189 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:167 #, no-wrap msgid "Bengali" msgstr "Bengali" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:190 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:168 #, no-wrap msgid "Bangladesh" msgstr "Bangladesh" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:192 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:170 #, no-wrap msgid "[.filename]#bn-bd#" msgstr "[.filename]#bn-bd#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:193 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:171 #, no-wrap msgid "Danish" msgstr "Danish" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:194 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:172 #, no-wrap msgid "Denmark" msgstr "Denmark" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:196 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:174 #, no-wrap msgid "[.filename]#da#" msgstr "[.filename]#da#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:197 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:175 #, no-wrap msgid "German" msgstr "German" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:198 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:176 #, no-wrap msgid "Germany" msgstr "Germany" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:200 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:178 #, no-wrap msgid "[.filename]#de#" msgstr "[.filename]#de#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:201 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:179 #, no-wrap msgid "Greek" msgstr "Greek" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:202 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:180 #, no-wrap msgid "Greece" msgstr "Greece" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:204 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:182 #, no-wrap msgid "[.filename]#el#" msgstr "[.filename]#el#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:205 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:183 #, no-wrap msgid "Spanish" msgstr "Spanish" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:206 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:184 #, no-wrap msgid "Spain" msgstr "Spain" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:208 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:186 #, no-wrap msgid "[.filename]#es#" msgstr "[.filename]#es#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:209 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:187 #, no-wrap msgid "French" msgstr "French" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:210 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:188 #, no-wrap msgid "France" msgstr "France" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:212 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:190 #, no-wrap msgid "[.filename]#fr#" msgstr "[.filename]#fr#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:213 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:191 #, no-wrap msgid "Hungarian" msgstr "Hungarian" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:214 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:192 #, no-wrap msgid "Hungary" msgstr "Hungary" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:216 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:194 #, no-wrap msgid "[.filename]#hu#" msgstr "[.filename]#hu#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:217 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:195 #, no-wrap msgid "Italian" msgstr "Italian" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:218 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:196 #, no-wrap msgid "Italy" msgstr "Italy" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:220 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:198 #, no-wrap msgid "[.filename]#it#" msgstr "[.filename]#it#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:221 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:199 #, no-wrap msgid "Japanese" msgstr "Japanese" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:222 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:200 #, no-wrap msgid "Japan" msgstr "Japan" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:224 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:202 #, no-wrap msgid "[.filename]#ja#" msgstr "[.filename]#ja#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:225 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:203 #, no-wrap msgid "Korean" msgstr "Korean" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:226 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:204 #, no-wrap msgid "Korea" msgstr "Korea" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:228 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:206 #, no-wrap msgid "[.filename]#ko#" msgstr "[.filename]#ko#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:229 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:207 #, no-wrap msgid "Mongolian" msgstr "Mongolian" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:230 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:208 #, no-wrap msgid "Mongolia" msgstr "Mongolia" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:232 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:210 #, no-wrap msgid "[.filename]#mn#" msgstr "[.filename]#mn#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:233 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:211 #, no-wrap msgid "Dutch" msgstr "Dutch" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:234 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:212 #, no-wrap msgid "Netherlands" msgstr "Netherlands" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:236 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:214 #, no-wrap msgid "[.filename]#nl#" msgstr "[.filename]#nl#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:237 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:215 #, no-wrap msgid "Polish" msgstr "Polish" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:238 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:216 #, no-wrap msgid "Poland" msgstr "Poland" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:240 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:218 #, no-wrap msgid "[.filename]#pl#" msgstr "[.filename]#pl#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:241 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:219 #, no-wrap msgid "Portuguese" msgstr "Portuguese" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:242 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:220 #, no-wrap msgid "Brazil" msgstr "Brazil" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:244 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:222 #, no-wrap msgid "[.filename]#pt-br#" msgstr "[.filename]#pt-br#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:245 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:223 #, no-wrap msgid "Russian" msgstr "Russian" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:246 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:224 #, no-wrap msgid "Russia" msgstr "Russia" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:248 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:226 #, no-wrap msgid "[.filename]#ru#" msgstr "[.filename]#ru#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:249 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:227 #, no-wrap msgid "Turkish" msgstr "Turkish" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:250 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:228 #, no-wrap msgid "Turkey" msgstr "Turkey" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:252 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:230 #, no-wrap msgid "[.filename]#tr#" msgstr "[.filename]#tr#" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:253 -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:257 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:231 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:235 #, no-wrap msgid "Chinese" msgstr "Chinese" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:254 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:232 #, no-wrap msgid "China" msgstr "China" #. type: Table -#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:256 +#: documentation/content/en/books/fdp-primer/po-translations/_index.adoc:234 #, no-wrap msgid "[.filename]#zh-cn#" msgstr "[.filename]#zh-cn#" *** 2516 LINES SKIPPED *** From nobody Sun Jul 2 20:37:59 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QvLTz51BWz4l6Dd for ; Sun, 2 Jul 2023 20:37:59 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QvLTz2wM8z3s72; Sun, 2 Jul 2023 20:37:59 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688330279; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=l7p+WCDi++5GgWWR2b7IjmirNGyVP75Vdw4zEWdrzmk=; b=HPuXvhu5toIVdlbp7q+LhmTWIZP9k9e3DLqfoAagRwBU+lHmxwkpxxTjvaKHrzJIH0R/Oa QwcRZiu6ROC0a6yiIpv/QE6ScpoBGwviHvIBNqdMQizEwZSVFHxKR8V2FORo3ajRY+GO3W dql2WU3WOQIvAYIAKNg95LnJKxPYWWcARJ0sPPUzKXIFqDrGUZIHRfcbORv+H0pqgSpba1 06qLHGdZ1Bllc+B/yPQpFwtpLnn5zGXf9SUSa0ef9RwfnRCEiSG+B5SFk0r1PQmTTlc/1X neF4DEkdblZbT7NXQscpSURMSzKRVYI3kDqbmUWSWfbdFSr6KZxjPcmI73dJ2Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688330279; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=l7p+WCDi++5GgWWR2b7IjmirNGyVP75Vdw4zEWdrzmk=; b=FU35HINZ7050ax4m92SYQ9ol2N+XYNFwUi/YZ5yLH0LtM8+62y0keEDR1Ptda7lifIKEGp A6IgoubLbZxTgctCf7obkfc/CzSvPA8phpginiJX1r8hjzVAn34woRfm9JcIx5C1kwGHpM nqUNMHsjrRTDua49gPLj4g4Vp8mE9VNFWQrB3h4JxNWHIqsnEZerkGYi9Edrdf7FcXE6vw kvZFvoK7NYncYnCcm5qiucLqiKsArULf5OiCJPH9ndj7RbLzMogF9F6pyZs5MRD80CL0un nn3c/y8Lqf5kDk/Vt1f/ifCouOkKT7z8qPobQtPIYnPgNgk1MEVqgZQXePZqvw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688330279; a=rsa-sha256; cv=none; b=Ir6TpjDnMfd9LilwvFZosOfPBMMbHywLg2yIzPoZAiZp5MQpQS06u84+RTGK08k88mF6LX /ccHTYnLsjpXTInbujUClOlss+u/OMyLCDn/kKY40PsxYF0PcjmUNsrq+WfxxbZRjq6Pc+ WDuT1QDQT520WEA3dC0zA6eLH8oB03HQaj3b3nYfCMoQRqJoZPaBCgBBFxY63XmbLiU+uz EMa/AG9y/aDzdY4znQpgpUWtpWIIKYtGm+xrDVtQDoxR7dZhUtspd3mNccJYojoWzlIJxo WjUNpW0eW6p4MlPS3r+cnC9g1vrKwiGJ//0OLSxMiiRLBXO005PsH1902q+xRQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QvLTz1F3szN9N; Sun, 2 Jul 2023 20:37:59 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 362KbxqE066236; Sun, 2 Jul 2023 20:37:59 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 362KbxZ3066235; Sun, 2 Jul 2023 20:37:59 GMT (envelope-from git) Date: Sun, 2 Jul 2023 20:37:59 GMT Message-Id: <202307022037.362KbxZ3066235@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: 90c2a38cb0 - main - shared/pt-br/mailing-lists: Add freebsd-translators mailing list List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 90c2a38cb0ba103acb863ab0b633cdacd97fd7ca Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=90c2a38cb0ba103acb863ab0b633cdacd97fd7ca commit 90c2a38cb0ba103acb863ab0b633cdacd97fd7ca Author: Danilo G. Baio AuthorDate: 2023-07-02 20:35:11 +0000 Commit: Danilo G. Baio CommitDate: 2023-07-02 20:35:11 +0000 shared/pt-br/mailing-lists: Add freebsd-translators mailing list --- shared/pt-br/mailing-lists.adoc | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/shared/pt-br/mailing-lists.adoc b/shared/pt-br/mailing-lists.adoc index d548026098..40865d4308 100644 --- a/shared/pt-br/mailing-lists.adoc +++ b/shared/pt-br/mailing-lists.adoc @@ -497,6 +497,10 @@ :freebsd-toolchain-url: https://lists.FreeBSD.org/subscription/freebsd-toolchain :freebsd-toolchain: {freebsd-toolchain-url}[{freebsd-toolchain-desc}] +:freebsd-translators-desc: lista de discussão sobre as traduções do FreeBSD +:freebsd-translators-url: https://lists.FreeBSD.org/subscription/freebsd-translators +:freebsd-translators: {freebsd-translators-url}[{freebsd-translators-desc}] + :freebsd-usb-desc: lista de discussão sobre o suporte USB do FreeBSD :freebsd-usb-url: https://lists.FreeBSD.org/subscription/freebsd-usb :freebsd-usb: {freebsd-usb-url}[{freebsd-usb-desc}] From nobody Tue Jul 4 15:49:15 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QwRzw13jbz4mH1j for ; Tue, 4 Jul 2023 15:49:16 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QwRzw0ctxz4B8V; Tue, 4 Jul 2023 15:49:16 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688485756; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=rAqp+Jp7gyruuNibFuZBlAVj+DMYyTLkZD3oGwF5J3w=; b=OnQsAC+kzrmJLg4s1NlSWarro0G18OnP/L48L2ccUR2GSBr7stiZ6wXq+Bau7jtsJUheij wSe/kDfVGTUCiHpJqQLZ1eIgmTLu/ARKR/bc25f1XKRcCoEPmuG7LPrC4orAdtDY5wZg34 ZfBpdOt7e2AnJv4wm3B0+TVzCcuOAaYvXwgKdN90W0iPLWSsayvAxBZbYQjnC9jw9mPeR2 U3Kpmkbpgkt62s08jQBoPDCbnk16uG3shBYb/jzRDBBR2kXjHoRxD2puIyiSqxsKglvIMA 12DBrLc9pdTvy0GbhQsRRTmgBo3t2TxsBNaFb2Xb6boO9KBWubXEakjKmzfSGw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688485756; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=rAqp+Jp7gyruuNibFuZBlAVj+DMYyTLkZD3oGwF5J3w=; b=hjixsmnEmABmXbtT1nTFwLkpxLw5cMKs8g74gaCNheseIMqg8yxqXuM3TtQenwZ/PVSyZb UJlgsMbpGNrD5PQ+j5uCYm+BinpyRGK3oA/UdJL39TTte4Sq/GgBDFKn70W7nG6uu/oMOf zfJ4igyJy0YF7vAyeIk2fjRhsCRcspOUADKkrHQ07flWYsMfJyujiTPZEJuHmGHCXRDswU N1TaZCgzrU7aZTV+ubSiAwjDeLsXae1bFEFdBohd4AewwFeVnCmwnmw2K2avUKSicUEuO7 l8NFJM0x4iIAxdNVRbRA++gjcypYD5e9Rad7bQ4+HwY4USMWuhi2nbez52VfLQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688485756; a=rsa-sha256; cv=none; b=fkbdp8uG/xyEz4EddDPkEIbh5xYGg4x42nBBQXBYQtownJFPXNW1e5RhEA7VgUL+1/9r+g 8ZVNizFT5/iNXu6nQpEpIa0FLDgqnmOV/M6KOKGOQi0XkFWEdB/X4LGyYndBdcG3osBdeq 2d4eW2GYi/ilOiN3TdrRxjZN9pyprw2esXuh+4OGPhEIm37umxcbkUeRIBuJTfHZebMell aL8SzbtuZ9kWNXLK4tnVDa97Psv0ny3C94CKTByqbh8ebTg7ytoyT0PzeEWCVCRtirBzPj TNDY6lY6eYFpbfk0ZGIZ3/uEhyX0xQEbQadAWoFuN44G39ZmuImCHoUKOcxiEA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QwRzv6qPTzf5H; Tue, 4 Jul 2023 15:49:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 364FnFqV049694; Tue, 4 Jul 2023 15:49:15 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 364FnFSe049693; Tue, 4 Jul 2023 15:49:15 GMT (envelope-from git) Date: Tue, 4 Jul 2023 15:49:15 GMT Message-Id: <202307041549.364FnFSe049693@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: f6eac14aeb - main - Status/2023Q2/gcc.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f6eac14aeb7e404a243fe6ca2c1442caeb4e291f Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=f6eac14aeb7e404a243fe6ca2c1442caeb4e291f commit f6eac14aeb7e404a243fe6ca2c1442caeb4e291f Author: Lorenzo Salvadore AuthorDate: 2023-06-21 15:46:16 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-04 15:47:51 +0000 Status/2023Q2/gcc.adoc: Add report Reviewed by: status (Pau Amma + +Upstream has released link:https://gcc.gnu.org/gcc-13[GCC 13]. +As announced in the past status report, I plan to attempt an update of GCC_DEFAULT right from the first GCC 13 release, thus much of this quarter work has been in preparation of this. + +With the release of GCC 13.1 (first GCC 13 release: I remind that GCC counts minor version releases starting from 1), two new ports have been created in the ports tree: + +* package:lang/gcc13[], tracking GCC 13 releases; +* package:lang/gcc14-devel[], tracking snapshots from the new GCC 14 upstream branch. + +==== The *-devel ports + +A few significant changes have been made on the *-devel ports, which will be forwarded to the production ports together with more changes (see below): + +* enable support for .init_array and .fini_array, which FreeBSD supports since commit gitref:83aa9cc00c2d83d05a0efe7a1496d8aab4a153bb[repository=src]; + +* switch back to STANDARD_BOOTSTRAP on i386, amd64 and aarch64 as default option instead of LTO_BOOTSTRAP: LTO bootstrap produces too many failures on the package builders for those architectures. +Users wanting to use LTO_BOOTSTRAP can still enable the option manually. + +==== The production ports + +Upstream has released GCC 13, for which the new port package:lang/gcc13[] has been created. +GCC 11 and GCC 12 have been updated upstream and a new release of GCC 10 is planned. +All corresponding ports now need to be updated. + +To ease the work of both ports maintainers and users, I plan to test and update together all the following changes: + +* updates of package:lang/gcc10[], package:lang/gcc11[], package:lang/gcc12[]; +* update of GCC_DEFAULT to 13; +* enabling of .init_array and .fini_array on the production ports; +* switching back from LTO_BOOTSTRAP to STANDARD_BOOTSTRAP on the production ports. + +This will provide the following advantages: + +* more testing with less exp-runs; +* fewer builds for ports users. From nobody Tue Jul 4 15:49:16 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QwRzx2wMPz4mH8q for ; Tue, 4 Jul 2023 15:49:17 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QwRzx1rQVz4Bnh; Tue, 4 Jul 2023 15:49:17 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688485757; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=oGWukDXit3JJX1z/iDTnWLseVs+z9ZQAU2XfAYRADLU=; b=sVk+UA/k+TulS4+XZU1Gfh7KkIRdPsuD2N2ayI+tk44Ac6XR2SKfITRynOn4fmH8Cna+HP +VJls9yPXVOox6E7UlgQOhLmb/6NjCM0OUKK0NBecZWkS6etOfgdXYPcaJaNsew/6UCDKH lCFykhmjJVfdbo9cKcsR8jmhxXLLUcDz7tVpxCBk8ikXiodq6g4TS0ZWK170QrwcZKldue MW8x4XLE2OZRW+XAjzPScGsL1dfSQHU4fHH8Q8AyaCuFndcqnXGqrUziotz8+wzMp3drzo ms6C5TFC07PdqPu1bTXaOr+Ff87/aU/57nhFGFa8QooZLhCb0fFL9type6LibA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688485757; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=oGWukDXit3JJX1z/iDTnWLseVs+z9ZQAU2XfAYRADLU=; b=Y0hLMtmQKk+5jfWnj+MrdMPjLkwixFih2YK367XFSt36wkxXcntZZ+A4Z0xe4VNr91qFIg 2oc/fSOdkUleffvQdLaizNt2HHQRpha9O+TaHOBZcm5ndx78SMp1tm+Z1vXJrYy9Ih0IOj K/OQXPuTmM2aN6HdiRCN+xYAGvk3eFCM3qPs0DUQSqH0AwxoJeGqMSxwd3jNVWJ2W6bIVx 6pGNPVZVL765zySO9jfGSlEwXX1r6EC0uZ/JUPd4w0E8s7kkTIpdW/1+xNRoIK1/P247Dp 8oZC+7ljKAUvCuQJiBm2GkeNdPsNS8CQEmgksiqo8KS5oszvtxfXoHJU/7k2fQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688485757; a=rsa-sha256; cv=none; b=PqUYYPgOyPf2fJIktjnVNqBgHhEFwgXHfykKUZ144C2/q+pqVm3TWv2msz/mfcqqjemyfR 6EWQ3cq4mHyNewm/L/lZSI3hoqXIOEmY9K0zTkkcLjLX0n59Xv3EwFCOlNf8DbCIWmRmCB FdnUVJ6blUv67GFmdh82qkZjysCE4W6Dos4o4n60D0ov1sfoj1AbItTODTHzTlYU7uOL8E v+aoxAeuS5NM4pfxiIoB68NPVvWNIce1aX8SPAs0ppchuqRcyMNKvWobunUNrrImwQpUWP uMHKLJaalcuMiduO0mXU9xDsHxhNBQB9prbiinteT2cGKqHPZYdqBu+nZb0ZbQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QwRzx0Wr6zdrQ; Tue, 4 Jul 2023 15:49:17 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 364FnGA1049715; Tue, 4 Jul 2023 15:49:16 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 364FnG7o049714; Tue, 4 Jul 2023 15:49:16 GMT (envelope-from git) Date: Tue, 4 Jul 2023 15:49:16 GMT Message-Id: <202307041549.364FnG7o049714@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: dec7526dc3 - main - Status/2023Q2/compaction.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: dec7526dc36ae1a262d67aefe412b9ae97f2d2f1 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=dec7526dc36ae1a262d67aefe412b9ae97f2d2f1 commit dec7526dc36ae1a262d67aefe412b9ae97f2d2f1 Author: Bojan Novković AuthorDate: 2023-07-04 10:52:09 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-04 15:48:18 +0000 Status/2023Q2/compaction.adoc: Add report Approved by: dbaio (mentor, implicit), carlavilla (mentor, implicit) --- .../status/report-2023-04-2023-06/compaction.adoc | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/compaction.adoc b/website/content/en/status/report-2023-04-2023-06/compaction.adoc new file mode 100644 index 0000000000..b3577d51bf --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/compaction.adoc @@ -0,0 +1,21 @@ +=== Physical memory compaction for the FreeBSD kernel + +Links: + +link:https://wiki.freebsd.org/SummerOfCode2023Projects/PhysicalMemoryAntiFragmentationMechanisms[GSoC project wiki page] URL: link:https://wiki.freebsd.org/SummerOfCode2023Projects/PhysicalMemoryAntiFragmentationMechanisms[] + +link:https://reviews.freebsd.org/D40575[Differential revision 40575] URL: link:https://reviews.freebsd.org/D40575[] +link:https://reviews.freebsd.org/D40772[Differential revision 407725] URL: link:https://reviews.freebsd.org/D407724[] + +Contact: Bojan Novković + +Most modern CPU architectures offer performance boosts by supporting pages that are larger than the standard page size. +Unfortunately, allocating such pages can fail due to a high degree of physical memory fragmentation. +This work implements physical memory compaction as a means of actively reducing fragmentation in running systems. +This work is part of an ongoing Google Summer of Code project whose goal is to add various physical memory anti-fragmentation measures to the virtual memory subsystem. + +Differential link:https://reviews.freebsd.org/D40575[D40575] implements a well-known metric used for quantifying the degree of physical memory fragmentation. +Differential link:https://reviews.freebsd.org/D40772[D40772] implements physical memory compaction and adds a daemon that monitors the system and performs compaction when needed. + +Planned future work includes designing an appropriate benchmarking suite, running tests, and tweaking the code using feedback from reviews and test results. +This is still a work in progress, so any testing, reviews, and feedback would be greatly appreciated. + +Sponsor: The Google Summer of Code '23 program From nobody Tue Jul 4 15:49:18 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QwRzy35zfz4mHCJ for ; Tue, 4 Jul 2023 15:49:18 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QwRzy2FHWz4CMb; Tue, 4 Jul 2023 15:49:18 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688485758; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=H4bLff4/pDQuS9RI1fmVqj467Q5f0Hw5kPrijrjL2Og=; b=dC/JHSxYXSVENJat2VHByTaxakUb8xG3OTy+i9nVZEsbTagX4sob+LurJDr9NaQDteyVl4 emMXBIPr2aQeBPktMDzqF37XSduQKGeYFER2LSfmB4GEEuNh0MgU/GeZCta7EGzCHJKb9T zFuvrCDuqFKjp+YVgNaV7jwhHEShhpkbOHjCgeL4sfaZCu9C3pG4ecYPRd7XclvePebCpG jB12TEFGdz5foEBJ8tkB/h20EUMMwQDB1LwoianruEnUIpUBKl4VQ89KSt4ukCl0uD0q+7 ji1WqmGnO4jfqJAhjswGg4jVY+FyoZJvsr7yGfBsCtVdmRO2gA2k+j2Z8Lh6og== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688485758; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=H4bLff4/pDQuS9RI1fmVqj467Q5f0Hw5kPrijrjL2Og=; b=LH1+Vfzfn0aT/BUUB/9ijrk3Xfg8FAgwa8JwQ+1EPmyUf0y76OyHCmTlyWd8dRKjQyxaw8 vnhkPYObIbr/fiXISVH6KPwq30CDNWLs8xA/6nOPdKpYd3TN6YKxJdnVCFelbO7b6l/+Zx gho/ETnTRCx24TRhxoYUSG4UTqnCe8qIORnHfF64t3qBn2ki6AbqNx4Jdzzbe7B7YKNxMU BRWNQtiq3Y1uPIZLzOTQ3OVrw++GD6dtvIr2EMrb+75SDsvJlW9KALz7F9kT54X4m9oXVv 5mqMsAh49eSv8owVQOTJYXR/uSowbtMFBxXdZtrxu9Q8gLS12EURvqm8xEKT1w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688485758; a=rsa-sha256; cv=none; b=gJP0jqoYdmGoVaMIWUTs3PaYpD5u4u61k2vmIIdjkjTP7hP+RdXc406dq0J+rb2J2jYEzH JIfOvUeYV1dMz2UZflqxTVlzIvCKqPr9f7tNUUw3uBLe7xkyJW8jSJ0Jk/PCLE2WAal6c+ /LTm3lr85gFcnHpl1a/+mffVC9V2DY4sdIMfcUYlNqFYGJaM7Fc8b36DHhE4cbUufTkBVK h6Uigr2SRCj9sCZEirtP2yVrDUL1HoUSTIdEfsVz00efmqFfU0yKqjpBot52r9b6Rxfraw kO2vp2PnB3MSgUkya0sA88mpdZWX/AqJ6MQGaAFFf4sblXOoPHKweoz8soemIw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QwRzy0wTdzdrR; Tue, 4 Jul 2023 15:49:18 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 364FnICW049741; Tue, 4 Jul 2023 15:49:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 364FnIcZ049740; Tue, 4 Jul 2023 15:49:18 GMT (envelope-from git) Date: Tue, 4 Jul 2023 15:49:18 GMT Message-Id: <202307041549.364FnIcZ049740@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: c6d6c48402 - main - Status/2023Q2/mfsdbsd.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c6d6c48402dc7cf1f5bbcc33d265cb2270a29f19 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=c6d6c48402dc7cf1f5bbcc33d265cb2270a29f19 commit c6d6c48402dc7cf1f5bbcc33d265cb2270a29f19 Author: Soobin Rho AuthorDate: 2023-07-04 14:32:00 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-04 15:48:18 +0000 Status/2023Q2/mfsdbsd.adoc: Add report Reviewed by: jrm, status (Pau Amma ) Approved by: dbaio (mentor) Pull Request: https://github.com/freebsd/freebsd-doc/pull/192 --- .../en/status/report-2023-04-2023-06/mfsbsd.adoc | 28 ++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/mfsbsd.adoc b/website/content/en/status/report-2023-04-2023-06/mfsbsd.adoc new file mode 100644 index 0000000000..fc87253f1d --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/mfsbsd.adoc @@ -0,0 +1,28 @@ +=== Integrate mfsBSD into the release building tools + +Links: + +link:https://wiki.freebsd.org/SummerOfCode2023Projects/IntegrateMfsBSDIntoTheReleaseBuildingTools[Wiki Article] URL: link:https://wiki.freebsd.org/SummerOfCode2023Projects/IntegrateMfsBSDIntoTheReleaseBuildingTools[] + +Contact: Soobin Rho + +==== What is mfsBSD? + +"mfsBSD is a toolset to create small-sized but full-featured mfsroot based distributions of FreeBSD that store all files in memory (MFS) [Memory File System] and load from hard drive, usb storage device or optical media. +It can be used for a variety of purposes, including diskless systems, recovery partitions and remotely overwriting other operating systems." + +mailto:mm@FreeBSD.org[Martin Matuska] is both the author of the link:https://people.freebsd.org/~mm/mfsbsd/mfsbsd.pdf[mfsBSD white paper] and the maintainer of the link:https://github.com/mmatuska/mfsbsd[mfsBSD repository]. + +==== Purpose of this project + +This project creates an additional target of the weekly snapshots of -current and -stable versions of mfsBSD images in the src/release makefile. +Currently, only the release versions of mfsBSD images are produced, which means they tend to get out of sync with the tools in base. +This project aims to address that problem. + +==== Location of this project + +This project is a GSoC 2023 (Google Summer of Code) project, under mentorship from mailto:otis@FreeBSD.org[Juraj Lutter] and mailto:jrm@FreeBSD.org[Joseph Mingrone]. + +As a GSoC project, the official coding period is between May 29, 2023 and August 28, 2023. +As a humble beginner in the open-source community, the author of this project welcomes all comments / suggestions / PR's to the link:https://github.com/soobinrho/freebsd-src/tree/integrate-mfsBSD-building[project repository], which is where all the code for this project will be located for the duration of the official GSoC coding period. + +Sponsor: Google, Inc. (GSoC 2023) From nobody Tue Jul 4 15:49:19 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QwRzz3bpHz4mGws for ; Tue, 4 Jul 2023 15:49:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QwRzz30drz4BqM; Tue, 4 Jul 2023 15:49:19 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688485759; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=NG9pNMuVy0EAgYSP0j1qM1dtEmalx9+L7KS/D0/k/Zs=; b=kMgqALDxhKyYd3W93K5kHeb1hm9tRYofgZU7I9bgK5EUkoOxBRUFaJFJAP2VG0yIcmsCXs MKRWWNBP1bvX6ECNoP+PSppadr8w0JtKNuABmI/jwAvs8qGvhL0+JFpHh/Lf6AbOyjFwT+ a4mAV8p2k/Jm2GcswV7n28b9AatAFgMmMCzi7Jyo5kyEGh3A5yeXQLdfj9hxPq7+9wLkUd fe0Uv2PjF8Ihq1/Uk3ZHTdpWQjjKm25KgQVNQBqcjxseZxab2tQ+iP0OzBcNskCvfSjoOU draafEFsGHU44dXgTcf+YODMKwA7ZNaRELds+U5VN+q0AwcjFTfErVxAytouZg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688485759; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=NG9pNMuVy0EAgYSP0j1qM1dtEmalx9+L7KS/D0/k/Zs=; b=EGxgRRd0JT81s8v+pbW+AM8Sx/3m+Co/cDdqnAFikp6a6wCMuyug9grmU6VLqn4GzBvZxM 6eZY3HflSpk7P3/bPsFcxNfqxquh/S+xnefIcR08KrAiprplK/a2HPxEM5Q2FtOdYPAFCk z4HlKDzZ+rm2IxDT9uF8V+XOpOJQJuzzgTtAcMV6QzPLxu967e4vyldMKRlHm6Hx7J4VYk lt2mYSAQko4yknfAWa90MS+eTzRpkb2sgcOWHTxwJjHYRhWR631766KHpDaobrL8zj/rMN 15b2DBdbfz5M6q3cL9trzswsNqXthOKaZvS2RIFu9mf/HzZ2glpCxkyPmygG3w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688485759; a=rsa-sha256; cv=none; b=K5t0RsjYeuLlxpskvFa8SG9KOEbtRg2qx6V6e0eU/6hg3tBsDOdEqLFzKmzfUTFDuA1vuK qVFDR6SDfcex7nORhUqNAvgX2EdM3ud0YBZElEz3WlTb7OagH3GBcQn2j2JWeeX6Qf3SGa gyhSLG8bmKEkvTuK1TKjrHLchiX+/X8TAnwkjZkMish2mxOzufXs34L1ka9t0ocdEk4h8o cskeLCXsAxVzwy+nf8OBMSr5D4gYECx7HzsLaaVlcRiO4iCrqvPywaDjBTEKvwTZ+fUiKz NK4BiqTEbrOPUvmFeVtjhcmr9l9BK4BE7aGRdlVzgHMIsiIJ5XYS9715HFVwBQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QwRzz1qfwzf0g; Tue, 4 Jul 2023 15:49:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 364FnJS5049760; Tue, 4 Jul 2023 15:49:19 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 364FnJWU049759; Tue, 4 Jul 2023 15:49:19 GMT (envelope-from git) Date: Tue, 4 Jul 2023 15:49:19 GMT Message-Id: <202307041549.364FnJWU049759@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: f90edb875e - main - Status/2023Q2/openstack.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f90edb875ed8afaf8c760bc5f1599bc4fe6bcbf1 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=f90edb875ed8afaf8c760bc5f1599bc4fe6bcbf1 commit f90edb875ed8afaf8c760bc5f1599bc4fe6bcbf1 Author: Chih-Hsin Chang AuthorDate: 2023-07-04 15:34:40 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-04 15:48:18 +0000 Status/2023Q2/openstack.adoc: Add report Approved by: dbaio (mentor) Pull Request: https://github.com/freebsd/freebsd-doc/pull/194 --- .../status/report-2023-04-2023-06/openstack.adoc | 30 ++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/openstack.adoc b/website/content/en/status/report-2023-04-2023-06/openstack.adoc new file mode 100644 index 0000000000..8b0ae34e4f --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/openstack.adoc @@ -0,0 +1,30 @@ +=== OpenStack on FreeBSD + +Links: + +link:https://www.openstack.org/[OpenStack] URL: link:https://www.openstack.org/[] + +link:https://github.com/openstack-on-freebsd[OpenStack on FreeBSD] URL: link:https://github.com/openstack-on-freebsd[] + + +Contact: Chih-Hsin Chang + +Contact: Li-Wen Hsu + +This project aims to port key OpenStack components such as keystone, nova, neutron, etc., so that FreeBSD can function as an OpenStack host. + +In 2023 Q2, we start porting `nova-novncproxy` and `nova-serialproxy` to increase the ways to access the instance console. +To lower the threshold for people who want to give it a try on the project, we also migrate our development environment from a physical machine to a virtual one. +But there is still a problem running bhyve VMs on top of Linux KVM. +A detailed writeup for the issue can be found link:https://hackmd.io/@starbops/SkdJON2un[here]. +Other achievements include: + +* Sorting out network connectivity issues inside the instances +* Able to spawn multiple instances +* Porting from Python 3.8 to 3.9 + +In the next quarter, we will continue working on the console proxy services to make the overall workflow more fluent. + +The step-by-step documents for constructing a POC site can also be found link:https://github.com/openstack-on-freebsd/docs[in the `docs` repository]. +The patched version of each OpenStack component is under the same GitHub organization. + +People interested in helping with the project can first help check the documentation by following the installation guide. +Feedback and help are always welcome. + +Sponsor: The FreeBSD Foundation From nobody Wed Jul 5 01:52:19 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QwjMl40Hrz4lpw9 for ; Wed, 5 Jul 2023 01:52:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QwjMl3Cjwz4J4W; Wed, 5 Jul 2023 01:52:19 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688521939; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Ra8qgclRnX4tObpjad5g2PGEtz+9PaghB4ZoKdqDrIY=; b=nd78AtbkbwtvOtarM0S5PxVEvXpU3ailpb0SJYT/+3GPZRFPWF4A3EMlYAO9hfDpJZGlvh wCh2kfGfv8fX14NQIyZ4M3qyZXbY0i4qWDzJasHYXMD4Wa/Ver5GcWNRSnI92pptep7rDC blfp6rD5xv3RPjgDvkPgzjsB/Yk6gx6au6aCxUsDX6abjFKSUWXJ0hiQJ+T95x7wuCjpfX 6U2Mdln4Z3vowom3TVQ8Ve9ENqmRAH/ObgWeLFroN46cv14JH7EwQqPF7p9O4/R9KstB3R t1mgl+H4HcZvWH3Hf01o1KQac1nAFwoUVXoSv9KK6qKJ2lEYtrkarbbQeQRM2Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688521939; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Ra8qgclRnX4tObpjad5g2PGEtz+9PaghB4ZoKdqDrIY=; b=AZRce506Ck2YjcbidN2MHSkNJKwS8yZNLH+a8r9QtJVxii5v2tMHn6PupqMJSkpUhXg6Ol k4b81mr6NYvype8KNeLeg08s0L5BgjuzSZvkawJaFXmn0ShVKUwfFGU+QIqgDwBsmGfbDQ xSzZ8Z4Eb7RBV0kMpCK1RcsZDp/5GJg8bwGRnLdF2ltFF8CujfTps55wCMfzc9CO/SM2ok 2rTJTU7KSgRNBq6HG/m7d9Ar2js6l8YOGnWSRpSkmpM/pmyoJ+Tlie3MiGy7xabajqOqMA yj0Zo6qlaEryz5t5i90tQGhP8xQnHvyKu6Q0yh3X0NJ7BCM6w8Ppe4Z2YMe1Xw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688521939; a=rsa-sha256; cv=none; b=WeMmw0mJtQ6hUxO5SmQ6+webARQOcD70XYsliyqFrUo//AqYmu9ZNJykYJVaior0TR2aCN FPcyyp/pS8j5xBRbhGO3Fl/l9jJr6tnDfKvtgsMZKM3GpWBpKyGXAJ+f/HMFTlqzI/s5N8 07fd+8EvnZRYqUKGl7ikhvfpGPs88ETHHqNGV+dNuKrzTBJkZ7SOKspVFtnQYe6jiRBPeX vk/UCyzyLEpSqPMzzoW4HPkTAy1xO6UR/r5A8W5MzYq3Jy8oysXayv6mvQr6UJqXeT9RgS rBIYzwwsM6AYudQt8GhVdd5FNJYOgsZcZnUk9Tz4KbUPh46K84qsCs8xoX2Iqw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QwjMl2GVrzwms; Wed, 5 Jul 2023 01:52:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 3651qJDc056368; Wed, 5 Jul 2023 01:52:19 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 3651qJSO056367; Wed, 5 Jul 2023 01:52:19 GMT (envelope-from git) Date: Wed, 5 Jul 2023 01:52:19 GMT Message-Id: <202307050152.3651qJSO056367@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: "Danilo G. Baio" Subject: git: 3db500c1fa - main - status: Add 2023Q2 report from clusteradm List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: dbaio X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 3db500c1fae6a9fa88fc504ebf3ce1c70e45b75e Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by dbaio: URL: https://cgit.FreeBSD.org/doc/commit/?id=3db500c1fae6a9fa88fc504ebf3ce1c70e45b75e commit 3db500c1fae6a9fa88fc504ebf3ce1c70e45b75e Author: Danilo G. Baio AuthorDate: 2023-07-05 01:50:37 +0000 Commit: Danilo G. Baio CommitDate: 2023-07-05 01:50:37 +0000 status: Add 2023Q2 report from clusteradm --- .../status/report-2023-04-2023-06/clusteradm.adoc | 55 ++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/clusteradm.adoc b/website/content/en/status/report-2023-04-2023-06/clusteradm.adoc new file mode 100644 index 0000000000..eddb077707 --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/clusteradm.adoc @@ -0,0 +1,55 @@ +=== Cluster Administration Team + +Links: + +link:https://www.freebsd.org/administration/#t-clusteradm[Cluster Administration Team members] URL: link:https://www.freebsd.org/administration/#t-clusteradm[] + +Contact: Cluster Administration Team + +FreeBSD Cluster Administration Team members are responsible for managing the machines the Project relies on to synchronise its distributed work and communications. + +In this quarter, the team has worked on the following: + +* Regular support for FreeBSD.org user accounts. +* Regular disk and parts support (and replacement) for all physical hosts and mirrors. +* Enable mirroring of www.FreeBSD.org and docs.FreeBSD.org in the FreeBSD project-managed mirrors. +* Cluster refresh, upgrading all hosts and jails to the most recent versions of 14-CURRENT, 13-STABLE, and 12-STABLE. + +==== Work in progress + +* Large-scale network upgrade at our primary site. +** New link:https://www.juniper.net/[Juniper] switches arrived at our primary site to replace the former ones. +We thank Juniper for the donation. +* Replace old servers in our primary site and a few mirrors. +** Besides the broken CI servers, we have a few old servers with broken disks and faulty PSUs. +This task is in conjunction with the FreeBSD Foundation and donors/sponsors. +* Install new CI (Continuous Integration) machines repurposed from the package builders. +* Review the backup configuration of the services running in the FreeBSD cluster. + +==== FreeBSD Official Mirrors Overview + +Current locations are Australia, Brazil, Germany, Japan (two full mirror sites), Malaysia, South Africa, Taiwan, United Kingdom (full mirror site), United States of America -- California, New Jersey (primary site), and Washington. + +The hardware and network connection have been generously provided by: + +* https://www.bytemark.co.uk/[Bytemark Hosting] +* Cloud and SDN Laboratory at https://www.bbtower.co.jp/en/corporate/[BroadBand Tower, Inc] +* https://www.cs.nycu.edu.tw/[Department of Computer Science, National Yang Ming Chiao Tung University] +* https://deploy.equinix.com/[Equinix] +* https://internet.asn.au/[Internet Association of Australia] +* https://www.isc.org/[Internet Systems Consortium] +* https://www.inx.net.za/[INX-ZA] +* https://www.kddi-webcommunications.co.jp/english/[KDDI Web Communications Inc] +* https://www.mohe.gov.my/en/services/research/myren[Malaysian Research & Education Network] +* https://www.metapeer.com/[Metapeer] +* https://nic.br/[NIC.br] +* https://your.org/[Your.Org] +* https://365datacenters.com/[365 Data Centers] + +The Frankfurt single server mirror is the primary Europe mirror in bandwidth and usage. + +We are still looking for an additional full mirror site (five servers) in Europe to replace old servers in the United Kingdom full mirror site. + +We see a good pattern in having single mirrors in Internet Exchange Points worldwide (Australia, Brazil, and South Africa); if you know or work for some of them that could sponsor a single mirror server, please get in touch. +United States (West Coast) and Europe (anywhere) are preferable places. + +See link:https://wiki.freebsd.org/Teams/clusteradm/generic-mirror-layout[generic mirrored layout] for full mirror site specs and link:https://wiki.freebsd.org/Teams/clusteradm/tiny-mirror[tiny-mirror] for a single mirror site. From nobody Wed Jul 5 15:36:36 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Qx3fr6CNpz4lLDb for ; Wed, 5 Jul 2023 15:36:36 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Qx3fr4bGDz49j4; Wed, 5 Jul 2023 15:36:36 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688571396; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Pw0QiNb0c27oSndDFBNnRjIrQnVAndFxO2Xyymq7ovM=; b=AVoL6vB+Xq4bJGcwfIbxKRVFP2HquKKy83G9UAEmE7l1C4lJfy3WYfkR8LFUUG7ulwM5tD 4nMC1xyVgGpBrTDR6cExTDNgUYxG1qOK+4t8xTXSTYXTAN5YO+DszX4HaIF5VvzIO8LnI5 dZ8soQ6/S1gDwwzG1TIS3o6csffST+PZ7WoR+PWvL8nABcM7o0r4kaYKvl9EbHkk5oXkRn g/Bb+tfNTWPK8odKflioNU1AHV2Mz1mXW8XStQzRyAxdyq8l/1m9aDVdQP/4Y3Y9N5sXX7 vOIQoEFOCkxaiSA8LUm+rPsrosYcctrkwnJkeUugywtaUxrjw4ioltAZRQDgOw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688571396; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=Pw0QiNb0c27oSndDFBNnRjIrQnVAndFxO2Xyymq7ovM=; b=QQljt5f/zlnrM9UJGhFWMVJI3CNRg0yim/8TK+QPDLmNUnPJ1KKicLD9aI+h+oSBfZrWCx 1UbrPaKFDcf/bKPw5U3WMY2BURQLOm+CjDOoxfepOQAR5w71eno1RdZLjZANSJmTF1gosU Aj9UIiTR7JvuiyKxlOnPzEboQXlOSVltA5aWzsq53B4YyWk/tgQ2+sw2C0U5912UoIlgYI uFBw8g2az7YjFiQzE6O9FbgTKVhwCLWqer0hpVpjWEMDwTF4z0VvQoUZ8bCxeguj3LUb6n KdEqbv6MmQGhWoVQux7niO1x6JV9nBTcu933+kzD2Ap5Nb72V6zTkdQ/SH6BQw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688571396; a=rsa-sha256; cv=none; b=TkQlcSoL54SZh3dAVcoehV0AP4exweYXef8F/2xmctHe1EyELHvGyvVkz3skMHw7ofuVwx JHbUT2nLH6bwFWVA3NpacqPS/BYq+rlqoWOEcUr8gDeJLnIzQemvAuHtrmOpnk8BRWVbUk nT7IeQhKJjpIcH9zSC2gcuz/gR4a549tFa1uvm5nrjFmMUgXoWg/1TQb+vr2GgUxbGBgLh es5C8pmflQBDld49vW9jKnMABWy9cjU98xW34580ufRDqVmqzzeo6MOrED/ms0FaBdV8iE jyc43aT/UKPAfR9J8GCi3pt4dYK6BMQo+rrStCY38iiz3dKw1q18D7+9j2pDdA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Qx3fr3GMmzKs7; Wed, 5 Jul 2023 15:36:36 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 365Faawa017423; Wed, 5 Jul 2023 15:36:36 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 365FaaaA017422; Wed, 5 Jul 2023 15:36:36 GMT (envelope-from git) Date: Wed, 5 Jul 2023 15:36:36 GMT Message-Id: <202307051536.365FaaaA017422@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: 87bd216d39 - main - Status/2023Q2/wazuh.adoc Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 87bd216d39b0fb0b48075e04ed233d42ce58965c Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=87bd216d39b0fb0b48075e04ed233d42ce58965c commit 87bd216d39b0fb0b48075e04ed233d42ce58965c Author: José Alonso Cárdenas Márquez AuthorDate: 2023-07-05 15:27:26 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-05 15:33:31 +0000 Status/2023Q2/wazuh.adoc Add report Reviewed by: status (Pau Amma ) Approved by: dbaio (mentor, implicit) --- .../en/status/report-2023-04-2023-06/wazuh.adoc | 40 ++++++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/wazuh.adoc b/website/content/en/status/report-2023-04-2023-06/wazuh.adoc new file mode 100644 index 0000000000..6d0589b5c6 --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/wazuh.adoc @@ -0,0 +1,40 @@ +=== Wazuh on FreeBSD + +Links: + +link:https://www.wazuh.com/[Wazuh] URL: link:https://www.wazuh.com/[] + + +Contact: José Alonso Cárdenas Márquez + +Wazuh is a free and open source platform used for threat prevention, detection, and response. +It is capable of protecting workloads across on-premises, virtualized, containerized, and cloud-based environments. + +The Wazuh solution consists of an endpoint security agent, deployed to the monitored systems, and a management server, which collects and analyzes data gathered by the agents. +Besides, Wazuh has been fully integrated with the Elastic Stack or OpenSearch Stack, providing a search engine and data visualization tool that allows users to navigate through their security alerts. + +Wazuh porting to FreeBSD was started by mailto:m.muenz@gmail.com[Michael Muenz]. +The first Wazuh port he added to the FreeBSD ports tree was package:security/wazuh-agent[] in September 2021. +In July 2022, I took maintainership of this port and I started porting other Wazuh components. + +Currently, all Wazuh components are part of the FreeBSD ports tree. It includes package:security/wazuh-manager[], package:security/wazuh-agent[], +package:security/wazuh-server[], package:security/wazuh-indexer[] and package:security/wazuh-dashboard[] ports. + +On FreeBSD, package:security/wazuh-manager[] and package:security/wazuh-agent[] are compiled from Wazuh source code. +package:security/wazuh-indexer[] is an adapted package:textproc/opensearch[] used for storing agents data. +package:security/wazuh-server[] is a port for installing the package:security/wazuh-manager[], package:sysutils/beats8[] (filebeat), and package:sysutils/logstash8[] components. +It includes adapted configuration files to work on FreeBSD. +package:security/wazuh-dashboard[] uses an adapted package:textproc/opensearch-dashboards[] and the wazuh-kibana-app plugin generated from wazuh-kibana-app source code for FreeBSD. + +The main goal of this work is enhancing visibility of FreeBSD as a useful platform for information security or cybersecurity. + +Additionally, you can test a Wazuh single-node infrastructure (All-in-one) easily using link:https://github.com/alonsobsd/wazuh-makejail[] or link:https://github.com/AppJail-makejails/wazuh[] from link:https://github.com/DtxdF/AppJail[AppJail]. +AppJail is a good tool for managing jail containers from the command line. + +People interested in helping with the project are welcome. + +Current version: 4.4.4 + +TODO + +* Add Wazuh cluster-mode infrastructure makejail (Work in progress) +* Add FreeBSD to platforms officially supported by Wazuh Inc; see link:https://github.com/wazuh/wazuh-kibana-app/pull/5413[] +* Add FreeBSD SCA Policy (Work in progress) From nobody Wed Jul 5 15:36:37 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Qx3ft032Jz4lLDh for ; Wed, 5 Jul 2023 15:36:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Qx3fs6CvMz49pF; Wed, 5 Jul 2023 15:36:37 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688571397; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=02esavhs2QzlIXOKZUaWRqfOt0CrPMVCLxriA8MF/2g=; b=FjSfnUwV/BZTxCnouOXfgcTHRtCARVEKoZfcuKIoMvArvn6LEQ0WH2wrrDYcKcND4Pe9sj KnIFgwMp3aBQh1BYhMpQhn9/IBP+qMh0WVDUOxqCJd3Go1Hdd4TeYiqF0IFmCcnO3PGD+F iP44RhGZkZIiCMp825HnPf2sFqbRTovpoud0kG5MdYk1FNHlnQiVFANA/7FBHZTYCvpAs+ R8T/OpQZZk1rEpWLuDBJKhj1VaOOTbMAX8dBmzH4DDgUlmYSNtolD7bl5UJrnY7zMHChIY O3FGUX0jM2tfYb9UfoQBFNk7HCk71gtaWipBqWIb772CP64t8MQ7L2ZuBse85g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688571397; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=02esavhs2QzlIXOKZUaWRqfOt0CrPMVCLxriA8MF/2g=; b=PY3sHtcJJmqLeil+DXpXvie2UuajaPNlcS0srdoVbzEg4ll/YYWgB7enKXd9SnDTAVSHFO /HX1dDqERXCyK0YKXiZtKJHYCANAP4bRn4D9wEu7sR4NSackQTEAILl42E9GYpt7uMBFva nOWi60bL1GSk0NegulUIBOUOLGj/SXSnVt2hiHDjUGzcclEp9m3JISm+v8G/i3Qb9JTXyG dC09xYqBO6T3iPUhBybQzHgMhXeqceFYgcfl3zTHxN6mZeSx7C97ylJU/5KE4swlPqBV9I /coZIQreSyUMBVAI0GSQ0Gzfs+h6caYyblf2H6r1glg3O0Q/CluJ+hwFaIswiw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688571397; a=rsa-sha256; cv=none; b=mQUph4YXbNHDjxDNxGdJRX2fUR+FyoKTrhLd4YtsLRkv1UckP3yaJEZ5EKLXg/1aDtdWDG VLCDZItBWk5ucLcQO44JLSrn0FIY5p086x3lZ7puz/Nfj/VH1rZKiXbH8EL3rc+x5qu6TF 4pGftFq4yy4dLK2U5s7czlC+s3OuvjbP63q4ClIYOlosqnn+zFsN/FjoO/wEl5riPJOU7g lYZMHuGZIJ6Jw/n31qYyTNq53HoiHpV8m/ZY0Wde1h1DVO/3aCZyHwOQX9ueCq8hgcLiRk g8FG03SxRE6GH+PPGMz8AtXkIevPRaQrSQWztnyEItk/pw/8v1Oxka2bjOURnw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Qx3fs483zzLNq; Wed, 5 Jul 2023 15:36:37 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 365FabCR017449; Wed, 5 Jul 2023 15:36:37 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 365FabOD017448; Wed, 5 Jul 2023 15:36:37 GMT (envelope-from git) Date: Wed, 5 Jul 2023 15:36:37 GMT Message-Id: <202307051536.365FabOD017448@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: fa89a6fa3e - main - Status/2023Q2/caldera.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: fa89a6fa3e28e6c72a1f371cd4cbf4f692186b2d Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=fa89a6fa3e28e6c72a1f371cd4cbf4f692186b2d commit fa89a6fa3e28e6c72a1f371cd4cbf4f692186b2d Author: José Alonso Cárdenas Márquez AuthorDate: 2023-07-05 15:19:24 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-05 15:33:46 +0000 Status/2023Q2/caldera.adoc: Add report Reviewed by: status (Pau Amma ) Approved by: dbaio (mentor, implicit) --- .../en/status/report-2023-04-2023-06/caldera.adoc | 29 ++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/caldera.adoc b/website/content/en/status/report-2023-04-2023-06/caldera.adoc new file mode 100644 index 0000000000..35c26bc640 --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/caldera.adoc @@ -0,0 +1,29 @@ +=== MITRE Caldera on FreeBSD + +Links: + +link:https://www.caldera.com/[MITRE Caldera] URL: link:https://www.caldera.com/[] + +link:http://www.redcanary.com[Red Canary] URL: link:http://www.redcanary.com/[] + + +Contact: José Alonso Cárdenas Márquez + +MITRE Caldera is a cybersecurity platform designed to easily automate adversary emulation, assist manual red teams, and automate incident response. + +It is built on the MITRE ATT&CK framework and is an active research project at MITRE. + +MITRE Caldera (package:security/caldera[]) was added to the ports tree in April 2023. +This port includes support for the link:https://github.com/redcanaryco/atomic-red-team[Atomic Red Team Project] used by the link:https://github.com/mitre/atomic[MITRE Caldera atomic plugin]. + +The main goal of this work is enhancing visibility of FreeBSD as a useful platform for information security or cybersecurity. + +Additionally, you can test a MITRE Caldera infrastructure easily using link:https://github.com/alonsobsd/caldera-makejail[] or link:https://github.com/AppJail-makejails/caldera[] from link:https://github.com/DtxdF/AppJail[AppJail]. +AppJail is a good tool for managing jail containers from the command line. + +People interested in helping with the project are welcome. + +Current version: 4.2.0 + +TODO + +* Add Caldera testing infrastructure makejail +* Add FreeBSD to platforms officially supported by MITRE Caldera, see link:https://github.com/mitre/caldera/pull/2752[] +* Add FreeBSD to platforms officially supported by Red Canary, see link:https://github.com/redcanaryco/atomic-red-team/pull/2450[] From nobody Wed Jul 5 15:36:38 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Qx3fv29Nzz4lLDl for ; Wed, 5 Jul 2023 15:36:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Qx3ft5ygcz49Vy; Wed, 5 Jul 2023 15:36:38 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688571398; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=CQnwvFIiukXTgZ81UE/1fQyMK7ILVLQ5hLFr5lfw1tU=; b=FG33kK7aAHA/DisqmPi6X6WzSXV56upEw/tGlPWj9fCq1OSugp5y4CPxdyWKZA9N8apZlO 10ppJzA3y37XFiyin18zIn/9D/JzNkLdWqdYpw2hmhfRbPAuPLuVLIW1QLpuY1dJJ85O30 /o6gPOQ4gkKC0IMr3ey5k79PZiYBH1GtHxeGUOUoDgaFtEh+THDa9nIXuHbUJKC0lBj+8E JRjKOnHaUdR/h7eGkfiaphHznltOKQOeXM7BDuMoZwG/I3G8N34PU3RbljzpDg+uBdfwI0 2LRoNHsFE0kfnY1ikk7GeGYR8iTCcf0VybNqLtYy/q9DQePLCoKLdUxvAY3mrQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688571398; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=CQnwvFIiukXTgZ81UE/1fQyMK7ILVLQ5hLFr5lfw1tU=; b=Y5gENATG07bK5ELa/jrh+GmpuS1oi3kGX/z07lyRt2bT41FwkXz3usQsb0iL+bpKPZdn35 5xOa/130UEqQsDhw85DOLv4Xo4lF+wbEEtdjlcDUReF3peZ/snnHRNcRg6v62E9Klo5uAI VpRpp8obYcprhEzJtQHHiRB+wR5mdNyVc02MbTModvEpQCuKk4rHCpQ5cgrRDBvaQ0o/Ou WgKxXfd96m3uXvOS4iAnQIZiNWsor/BsxX/m+1kb3DgaBHgalsz7V7JCLq0KAo2o8emlD9 16fpW43ZFIbQ3q4idStajcNRiDmiunkGiRK/jERVPKjHJw1ffathOhU2BeST4w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688571398; a=rsa-sha256; cv=none; b=pyVeLowz/XIGppYGlRI7VL59dnqMreIaixlKHOpbX52lFDqn1cn8fwpLY8Slq7xJ3hduCQ ARXOozfd5krIBajFRhI9YhPme5nUUdWt4I+NWJkLvh98uM4G03t1tSs1HMJx30qt4Ppvnw 86m1FSPsiJ16t6tToRfTNTjno9i8mLp0fz9Bf8gV7jxVXfQaswpuEJ9UBT1M3tKfZuqToP 2dhqyb4jcecNMuqgqgLovzEDHTv+/+3J7WsKbzzxDHXN0caoXQSBa3m2z4P+5txCTuYuZ+ YFt6JE/g9kCu/rPNAfzZKHKaIpy/sb72xMqGKBv55P6pVXo9t7U0cgffY38Leg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Qx3ft52QnzLNr; Wed, 5 Jul 2023 15:36:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 365FaclG017471; Wed, 5 Jul 2023 15:36:38 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 365Facad017470; Wed, 5 Jul 2023 15:36:38 GMT (envelope-from git) Date: Wed, 5 Jul 2023 15:36:38 GMT Message-Id: <202307051536.365Facad017470@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: f243b7e5d6 - main - Status/2023Q2/service-jails.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: f243b7e5d622fe00ee446f8705dcbdb54ef2c905 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=f243b7e5d622fe00ee446f8705dcbdb54ef2c905 commit f243b7e5d622fe00ee446f8705dcbdb54ef2c905 Author: Alexander Leidinger AuthorDate: 2023-07-05 12:20:15 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-05 15:34:24 +0000 Status/2023Q2/service-jails.adoc: Add report Reviewed by: status (Pau Amma ) Approved by: dbaio (mentor, implicit) --- .../report-2023-04-2023-06/service-jails.adoc | 27 ++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/service-jails.adoc b/website/content/en/status/report-2023-04-2023-06/service-jails.adoc new file mode 100644 index 0000000000..efb58e7163 --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/service-jails.adoc @@ -0,0 +1,27 @@ +=== Service Jails - automatic jailing of rc.d services + +Links: + + +link:https://reviews.freebsd.org/D40369[D40369: Extend /usr/bin/service with the possibility to set ENV vars] URL: link:https://reviews.freebsd.org/D40369[] + +link:https://reviews.freebsd.org/D40370[D40370: Infrastructure for automatic jailing of rc.d-services] URL: link:https://reviews.freebsd.org/D40370[] + +link:https://reviews.freebsd.org/D40371[D40371: automatic service jails: some setup for full functionality of the services in automatic service jails] URL: link:https://reviews.freebsd.org/D40371[] + +Contact: Alexander Leidinger + +Service Jails are an extension to the rc system which allows automatic jailing of rc.d services. +Service jails inherit the filesystem of the parent host or jail, but use all the other limits of a jail (process visibility, restricted network access, filesystem mounting permissions, sysvipc, ...) by default. +Additional configuration allows to inherit the IPs of the parent, sysvipc, memory page locking, and use of the bhyve virtual machine monitor (man:vmm[4]). + +If you want to put e.g. local_unbound into a service jail and allow IPv4 and IPv6 access, you simply have to change rc.conf to have +---- +local_unbound_svcj_options=net_basic +local_unbound_svcj=YES +---- + +While this doesn't have the same security benefits of a manual jail setup with a separate filesystem and IP/VNET, it is much easier to setup while providing some of the security benefits of a jail like hiding other processes of the same user. + +The patches in the links are a rewrite of link:https://lists.freebsd.org/pipermail/freebsd-jail/2019-February/003710.html[what I presented in 2019]. +The main difference is that an ENV variable is used to do some more rational tracking and as such requires a change to man:service[8]. + +My intent is to commit link:https://reviews.freebsd.org/D40369[D40369] before the branch of 14-stable (which may have happened already when you read this). +I will not commit link:https://reviews.freebsd.org/D40370[D40370] and link:https://reviews.freebsd.org/D40371[D40371] before 14.0 is released and both would benefit of some more eyes looking at them. From nobody Wed Jul 5 15:36:39 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Qx3fw4FdYz4lLMB for ; Wed, 5 Jul 2023 15:36:40 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Qx3fw0H6Yz49m7; Wed, 5 Jul 2023 15:36:39 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688571400; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=s7mdltRKxYgcJ+PnqkwQGWyCG8HykZ9vXq/goU4Plaw=; b=Kg6KfF9l94Z33dAibQcmUElTw9sMPmqpDxjkPxdA+wmlcXi5xuoNH4fnwo/wQW6VzscU+W i+ZoJDUPiWUzoVaHzloXDBZ/m/IG+qkxtgf9ldagsHv5Kb2ziroaX5s5LkRr5WW8V4iVbK nUUy1ITf29tobeXS3dAiivSL6DJRSUz+oIUWRVM6W1Ln2lUppCIVpJDMQT+R2HTpazmXDR siYRnxj7vISq5sYqlLhJiX4Ztbp9DmKhXpr21KX9lminRfxxoJgm2qDt4kRdecK3WH1TMz j8x/6ka7p1sfskT2XHaakhjJCI1p0+XXCdd/okNDOUck4dd+4WCHYNi9OVl3+g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688571400; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=s7mdltRKxYgcJ+PnqkwQGWyCG8HykZ9vXq/goU4Plaw=; b=m2my6kbjkG13NguvdWWwrKIPnJapBGfTtPQX1ucuhLAh1Pot3Qn9xVVN9P6DyuXAZcqaDQ 1ZHUMen72KxJc27jfd2/3tX+wS0og2ntGrzMH/nanwJ+/cPOE/Kr3Rv+8rR3olJjAcI9OE NIkZlprtYL6HnS3gKUUKXorOUb4MyjYhvIV0o7maDMYVXwxR6upJGLRog32gunhe6ezvp6 GL9SVEW4W1bGEdKfcFbmKy1VoucK3S7u9oaoqy3xVhF3fcNM2v56PoTPVUkS9aa7si+Mp9 6ifcTS1YCHWTfwsIAUbgkMxYCVXd+g6tG7HnaJkSNfcjx5f7kpnNaKpfPnFn9w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688571400; a=rsa-sha256; cv=none; b=xERVqOyYnrbg4jxoAjI/Jws0sMQSPYTeSmT+MhYLd6TRYwMVPFRhgEj2LkqjDQ0z3xoXFh 8ilQyF0pNL+CJ1NtSWq9RUTI/1wC/8WJdIkOFOxzg4KyHpIskbepBvhzmxfwLP12XDYCP6 8eyN8a2ABUdQuH0qPzdpFesTDXnrKMuEs/5nBCYhiNxSo32dsTzsSQEflyC6y9m8hdWPDA /IE95ZExebmBmgIujQijx5+4sNyU3jJh/+uAYlsOFmpOahyfMD4BM9Y2b4k/zXe76rSdQy +OrBFF+zVZ4h15Cbh7Cc/1zQYMRAnwuR9iFvIoPpXSGo2BBp7CuU5L43v2LBdQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Qx3fv60VZzKhT; Wed, 5 Jul 2023 15:36:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 365Fad70017491; Wed, 5 Jul 2023 15:36:39 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 365Fadc5017490; Wed, 5 Jul 2023 15:36:39 GMT (envelope-from git) Date: Wed, 5 Jul 2023 15:36:39 GMT Message-Id: <202307051536.365Fadc5017490@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: dbf834744f - main - Status/2023Q2/releng.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: dbf834744ff8f1d67b73091752a5edcee37fd523 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=dbf834744ff8f1d67b73091752a5edcee37fd523 commit dbf834744ff8f1d67b73091752a5edcee37fd523 Author: Glen Barber AuthorDate: 2023-07-05 13:11:31 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-05 15:34:31 +0000 Status/2023Q2/releng.adoc: Add report Reviewed by: status (Pau Amma ) Approved by: dbaio (mentor, implicit) --- .../en/status/report-2023-04-2023-06/releng.adoc | 24 ++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/releng.adoc b/website/content/en/status/report-2023-04-2023-06/releng.adoc new file mode 100644 index 0000000000..c854bf9f7f --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/releng.adoc @@ -0,0 +1,24 @@ +=== FreeBSD Release Engineering Team + +Links: + +link:https://www.freebsd.org/releases/13.2R/schedule/[FreeBSD 13.2-RELEASE schedule] URL: link:https://www.freebsd.org/releases/13.2R/schedule/[] + +link:https://www.freebsd.org/releases/14.0R/schedule/[FreeBSD 14.0-RELEASE schedule] URL: link:https://www.freebsd.org/releases/14.0R/schedule/[] + +link:https://download.freebsd.org/releases/ISO-IMAGES/[FreeBSD releases] URL: link:https://download.freebsd.org/releases/ISO-IMAGES/[] + +link:https://download.freebsd.org/snapshots/ISO-IMAGES/[FreeBSD development snapshots] URL: link:https://download.freebsd.org/snapshots/ISO-IMAGES/[] + +Contact: FreeBSD Release Engineering Team, + +The FreeBSD Release Engineering Team is responsible for setting and publishing release schedules for official project releases of FreeBSD, announcing code freezes and maintaining the respective branches, among other things. + +During the second quarter of 2023, the Release Engineering Team continued work on the 13.2-RELEASE. +The 13.2 cycle had closely followed the set schedule, with the addition of three additional RC builds at the end, and the final RELEASE build and announcement in mid-April. + +In coordination with various teams within the Project management, the FreeBSD Release Engineering Team reconsidered the original schedule for the upcoming 14.0-RELEASE, primarily due to some work that was in progress. +The updated schedule was discussed and adjusted slightly to account for some concerns, and ultimately published publicly on the FreeBSD Project website. +The new schedule targets 14.0-RELEASE for October, 2023. + +The Release Engineering Team continued providing weekly development snapshot builds for the *main*, *stable/13*, and *stable/12* branches. +Note, there will no longer be snapshot builds against *stable/12* moving forward. + +Sponsor: Tarsnap +Sponsor: The FreeBSD Foundation From nobody Wed Jul 5 22:05:04 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QxDH45qt3z4lpb3 for ; Wed, 5 Jul 2023 22:05:04 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QxDH45KW4z40nQ; Wed, 5 Jul 2023 22:05:04 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688594704; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=BKzTUY8ncy9s5BoyE2ShI9Vi14Z7Suo0BhZsF6n2GWk=; b=w5ogMlAmxA1CPSP7kdSFzNzii9pwk2z8o5l26OX+qgbtPFusd+1MxfvXaN6aQdHU6tZUqM qZ8avCrs6jSkn7ouHD+SqVtEgj3OsJ00Y5A78x1vNJlJBYQmZbUNfegWlP2q3Lw8tyxKEV tdWc7KI5kjhbae0F9V8kzHZKuxj0qOipB6uZWyChPV+WvAhkdc7r4Pr+iNt3swilc7GFF9 wpf7LfMv3nhGRDyo9xjeIJ5GQcCDNUEHudWUmM9yZsUK4RAJInmipdL0t/NzeM7S5RF8qd 30W53rL3krA7vYW0pKC6xi91cetnz9qwpOxJHf2SV0ba/3SBZQYeU8k9Xh8Yhg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688594704; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=BKzTUY8ncy9s5BoyE2ShI9Vi14Z7Suo0BhZsF6n2GWk=; b=pZ1Vb4+ElD292J0uWdd7mGJFhDPia011YE/GFQf0oM4odyFalYLWcb+gzohoA1iwRXEs4a bTpRxyV7L/xLA5bqzdUQgZ63f2pkO0SzW8DamvOPV4VnqdHV6sdIizTPjqACAsgGMIWBuM v/WIfrk7SylYcTQZVioQ05Pyk6x9eJocmbesgRlp5DIVUzhBGy0ABMmtm7rKHdamyamBce EKNHutIT48cqghQ+F/fwzgWbr1wCyFX8x2m9lLy5orvKnjrYy/E4BvkY6gEYZsze7SSAAu uWkGbyiV9KvKNbfE/LwQavU7+6Nwcvn4RJEXKcd2V+EviqH9E+u4oJ56l25ATw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688594704; a=rsa-sha256; cv=none; b=VwMTtiIQSs4L7tH3/UmAX7lxNT66y2Z9X4xss8nWy95+LQrhkVoPt2RJqYMlDMechC/szh PD5GNdM+TkYGV0d89xEIR4BhvlRz4iDteV/UCZHW8bsZtJQzYLo5n911727Kohur2CR9x9 O25+SiFK3CPdCtsHU1iwPYYrD2N6TWtCi9E4WR5NLNb3PRwLMge5OWoYqkF5vd1KmpP/Yw q8CknGkW21C9NT5dBgDnu1TKE0LWnf6f1yBrjLdvq1ET7CBxobADUcmatIuCq3azESPvrn +HCqrOn5QuOLbY+jokXYrvCPUhOlw1Its01SnlqQL4adjbiya0DZ8cr6ADV2QQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QxDH44NJRzXBW; Wed, 5 Jul 2023 22:05:04 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 365M546P062350; Wed, 5 Jul 2023 22:05:04 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 365M5422062349; Wed, 5 Jul 2023 22:05:04 GMT (envelope-from git) Date: Wed, 5 Jul 2023 22:05:04 GMT Message-Id: <202307052205.365M5422062349@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: John Baldwin Subject: git: 3ba5fc40d0 - main - 2023Q2 status report for NVMe over Fabrics List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: jhb X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 3ba5fc40d0f5a946ffb89268c319c8967365d5fb Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by jhb: URL: https://cgit.FreeBSD.org/doc/commit/?id=3ba5fc40d0f5a946ffb89268c319c8967365d5fb commit 3ba5fc40d0f5a946ffb89268c319c8967365d5fb Author: John Baldwin AuthorDate: 2023-07-05 22:04:31 +0000 Commit: John Baldwin CommitDate: 2023-07-05 22:04:31 +0000 2023Q2 status report for NVMe over Fabrics Reviewed by: Pau Amma , salvadore Differential Revision: https://reviews.freebsd.org/D40792 --- .../en/status/report-2023-04-2023-06/nvmf.adoc | 71 ++++++++++++++++++++++ 1 file changed, 71 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/nvmf.adoc b/website/content/en/status/report-2023-04-2023-06/nvmf.adoc new file mode 100644 index 0000000000..445119c7f9 --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/nvmf.adoc @@ -0,0 +1,71 @@ +=== NVMe over Fabrics + +Links: + +link:https://github.com/bsdjhb/freebsd/tree/nvmf2[nvmf2 branch] URL: link:https://github.com/bsdjhb/freebsd/tree/nvmf2[] + +Contact: John Baldwin + +NVMe over Fabrics enables communication with a storage device using +the NVMe protocol over a network fabric. +This is similar to using iSCSI to export a storage device over a +network using SCSI commands. + +NVMe over Fabrics currently defines network transports for +Fibre Channel, RDMA, and TCP. + +The work in the nvmf2 branch includes a userland library (lib/libnvmf) +which contains an abstraction for transports and an implementation of +a TCP transport. +It also includes changes to man:nvmecontrol[8] to add 'discover', +'connect', and 'disconnect' commands to manage connections to a remote +controller. + +The branch also contains an in-kernel Fabrics implementation. +[.filename]#nvmf_transport.ko# contains a transport abstraction that +sits in between the nvmf host (initiator in SCSI terms) and the +individual transports. +[.filename]#nvmf_tcp.ko# contains an implementation of the TCP +transport layer. +[.filename]#nvmf.ko# contains an NVMe over Fabrics host (initiator) +which connects to a remote controller and exports remote namespaces as +disk devices. +Similar to the man:nvme[4] driver for NVMe over PCI-express, +namespaces are exported via [.filename]#/dev/nvmeXnsY# devices which +only support simple operations, but are also exported as ndaX disk +devices via CAM. +Unlike man:nvme[4], man:nvmf[4] does not support the man:nvd[4] disk +driver. +nvmecontrol can be used with remote namespaces and remote controllers, +for example to fetch log pages, display identify info, etc. + +Note that man:nvmf[4] is currently a bit simple and some error cases +are still a TODO. +If an error occurs, the queues (and backing network connections) are +dropped, but the devices stay around, but with I/O requests paused. +'nvmecontrol reconnect' can be used to connect a new set of network +connections to resume operation. +Unlike iSCSI which uses a persistent daemon (man:iscsid[8]) to +reconnect after an error, reconnections must be done manually. + +The current code is very new and likely not robust. +It is certainly not ready for production use. +Experienced users who do not mind all their data vanishing in a puff +of smoke after a kernel panic and who have an interest in NVMe over +Fabrics can start testing it at their own risk. + +The next main task is to implement a Fabrics controller (target in +SCSI language). +Probably a simple one in userland first followed by a "real" one that +offloads the data handling to the kernel but is somewhat integrated +with man:ctld[8] so that individual disk devices can be exported +either via iSCSI or NVMe or both using a single config file and daemon +to manage all of that. +This may require a fair bit of refactoring in ctld to make it less +iSCSI-specific. +Working on the controller side will also validate some of the +currently under-tested API design decisions in the +transport-independent layer. +I think it probably does not make sense to merge any of the NVMe over +Fabrics changes into the tree until after this step. + +Sponsored by: Chelsio Communications From nobody Thu Jul 6 12:09:18 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Qxb1B6Ls4z4lxpl for ; Thu, 6 Jul 2023 12:09:18 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Qxb1B690Rz44Ll; Thu, 6 Jul 2023 12:09:18 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688645358; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=mCUcmn0XkBD8qqRObXfbPoqiStb9zfgoM9nC7v0MMm8=; b=okgBlVMMyzV7Io7Mv8iQd9oRzvsLzi6/5Qo30RwXHqBaVsZF229pLEuuN9omacvYpnuLuE a2upoWzO/VI2ckogycHOcoJUv8r3aUdk9jECCdXl0shqAyc/2DexUbGqLtgxTEymuh3Tvy adsm3MeS7OIrqdYjOUCEDdpRoYegGxTS2V8AXHnIgmCp+zYpoxNxrX/+LPQ7gbk+YY6FvD XQ/dGnqk5pyj953SH+8j3BvOzxNH1tmsxxj0vUN4uXRIMxtKRpOTPeExeCUHqMgBwlzHOc LVnim0qm6pxt3t3cQxHpll3ve8PRCzvohumhK7416Sympj+ID7IX+R47Ye2+Ww== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688645358; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=mCUcmn0XkBD8qqRObXfbPoqiStb9zfgoM9nC7v0MMm8=; b=JemJaDmtk5j4RIiHfIrgsXZ+MvWiU0SmOsrn2nAhky34B08hik5bD45TWhYxyi+P5gqi7g 5+4pWSafBsAblrKZ3qISMV6M2FGbKvVFW5w1rD8pf++x+/lReJ+GPNnAu2HAOtev/emkaq ZqzHidK6K+tkRD7vHbvi4F5apuEtBQ/jy/GYlVYxvhPnCnPkgfdsa9s1sQTxci06SD6sI4 I1C6PIuUvbErFtvbnY+/8Yj/z7gxGti5fWsHpW/yqRGhkAlEkesVUQz9pdA79ZL4hPBIBI 8v6+Zd+64QXVu6XURu+1TiTzlQXNTdQHYBsV5cfowOXPx3r7vjvhOv4Mi69l7w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688645358; a=rsa-sha256; cv=none; b=WYv9+txmM7Xa5JtUJJppcfOl+O2HsO/i0WOYuum5k9v9V9ItM1/GZS+VHzKIFAEPHiT5+w KngGwx07LbonpKzZHiCdkgf5aPraNgI1QSBb91Kg/YXZhAozVEUK3sPifWQXejcMSa6bHT REk/Ygosk4FCBR36+mwGBhiSklXTrT6zAn1wkldU45xnMb+3/UHeZ9hsmLOCulS69AUj1C r8RuOIFZQyN0I9vxmRttudF31bATunpgaVEMAraHGSWKfv6h35qE0JQKcNcIj9Rob5Psuu NY1qS0n59oINqof4Y1rSnBPycdXOHl78lLV7P6Ta0DuierfB1PvzfKjcqmaUeA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Qxb1B56qPzvtl; Thu, 6 Jul 2023 12:09:18 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 366C9I9E054161; Thu, 6 Jul 2023 12:09:18 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 366C9IeC054160; Thu, 6 Jul 2023 12:09:18 GMT (envelope-from git) Date: Thu, 6 Jul 2023 12:09:18 GMT Message-Id: <202307061209.366C9IeC054160@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: b113509f32 - main - Handbook WG - Create a new network chapter List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: b113509f32da681db41fd60594b723c13334df8e Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=b113509f32da681db41fd60594b723c13334df8e commit b113509f32da681db41fd60594b723c13334df8e Author: Sergio Carlavilla Delgado AuthorDate: 2023-07-06 12:04:54 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2023-07-06 12:04:54 +0000 Handbook WG - Create a new network chapter Create a new chaper with the basic configuration of a wired and wireless networks in FreeBSD. Sections of the new chapter: - Synopsis - Setting up the Network - Wired Networks - Wireless Networks - Hostname - DNS - Troubleshooting Changes: - Move wired network section from config to network - Move virtual hosts section from config to advanced networking - Move basic wireless section from advanced networking to network - Move IPv6 from advanced networking to network - Upgrade all command outputs - Use sysrc - Improve AsciiDoc syntax Differential Revision: https://reviews.freebsd.org/D40546 Reviewed by: bcr, dbaio, fernape, karels Sponsored by: Daifressh --- .../books/handbook/advanced-networking/_index.adoc | 897 +------------------ .../content/en/books/handbook/audit/_index.adoc | 6 +- .../en/books/handbook/bibliography/_index.adoc | 2 +- documentation/content/en/books/handbook/book.adoc | 2 + .../content/en/books/handbook/boot/_index.adoc | 6 +- .../content/en/books/handbook/colophon.adoc | 2 +- .../content/en/books/handbook/config/_index.adoc | 492 +---------- .../en/books/handbook/cutting-edge/_index.adoc | 8 +- .../content/en/books/handbook/desktop/_index.adoc | 6 +- .../content/en/books/handbook/disks/_index.adoc | 6 +- .../content/en/books/handbook/dtrace/_index.adoc | 6 +- .../en/books/handbook/eresources/_index.adoc | 2 +- .../en/books/handbook/filesystems/_index.adoc | 6 +- .../en/books/handbook/firewalls/_index.adoc | 6 +- .../content/en/books/handbook/geom/_index.adoc | 6 +- .../content/en/books/handbook/glossary.adoc | 4 +- .../content/en/books/handbook/jails/_index.adoc | 6 +- .../en/books/handbook/kernelconfig/_index.adoc | 153 ++-- .../content/en/books/handbook/l10n/_index.adoc | 6 +- .../content/en/books/handbook/linuxemu/_index.adoc | 42 +- .../content/en/books/handbook/mac/_index.adoc | 6 +- .../content/en/books/handbook/mail/_index.adoc | 6 +- .../content/en/books/handbook/mirrors/_index.adoc | 8 +- .../en/books/handbook/multimedia/_index.adoc | 6 +- .../en/books/handbook/network-servers/_index.adoc | 6 +- .../content/en/books/handbook/network/_index.adoc | 951 +++++++++++++++++++++ .../content/en/books/handbook/partii.adoc | 4 +- .../content/en/books/handbook/partiii.adoc | 2 +- .../content/en/books/handbook/partiv.adoc | 2 +- documentation/content/en/books/handbook/partv.adoc | 2 +- .../content/en/books/handbook/pgpkeys/_index.adoc | 2 +- .../content/en/books/handbook/ports/_index.adoc | 28 +- .../en/books/handbook/ppp-and-slip/_index.adoc | 6 +- .../content/en/books/handbook/printing/_index.adoc | 6 +- .../content/en/books/handbook/security/_index.adoc | 12 +- .../en/books/handbook/serialcomms/_index.adoc | 6 +- .../en/books/handbook/usb-device-mode/_index.adoc | 6 +- .../en/books/handbook/virtualization/_index.adoc | 6 +- .../content/en/books/handbook/wayland/_index.adoc | 2 +- .../content/en/books/handbook/wine/_index.adoc | 6 +- .../content/en/books/handbook/zfs/_index.adoc | 11 +- 41 files changed, 1202 insertions(+), 1546 deletions(-) diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc index 732de75166..b9194449cd 100644 --- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc +++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc @@ -1,12 +1,12 @@ --- -title: Chapter 33. Advanced Networking +title: Chapter 34. Advanced Networking part: IV. Network Communication prev: books/handbook/firewalls next: books/handbook/partv description: "Advanced networking in FreeBSD: basics of gateways and routes, CARP, how to configure multiple VLANs on FreeBSD, etc" -tags: ["Advanced Networking", "Handbook", "gateway", "routes", "wireless", "tethering", "bluetooth", "bridging", "ipv6", "CARP", "VLAN"] +tags: ["Advanced Networking", "Handbook", "gateway", "routes", "wireless", "tethering", "bluetooth", "bridging", "CARP", "VLAN"] showBookMenu: true -weight: 38 +weight: 39 path: "/books/handbook/" --- @@ -18,7 +18,7 @@ path: "/books/handbook/" :icons: font :sectnums: :sectnumlevels: 6 -:sectnumoffset: 33 +:sectnumoffset: 34 :partnums: :source-highlighter: rouge :experimental: @@ -60,7 +60,6 @@ After reading this chapter, you will know: * How to set up IEEE(R) 802.11 and Bluetooth(R) devices. * How to make FreeBSD act as a bridge. * How to set up network PXE booting. -* How to set up IPv6 on a FreeBSD machine. * How to enable and utilize the features of the Common Address Redundancy Protocol (CARP) in FreeBSD. * How to configure multiple VLANs on FreeBSD. * Configure bluetooth headset. @@ -69,6 +68,7 @@ Before reading this chapter, you should: * Understand the basics of the [.filename]#/etc/rc# scripts. * Be familiar with basic network terminology. +* Understand basic network configuration on FreeBSD (crossref:network[network,FreeBSD network]). * Know how to configure and install a new FreeBSD kernel (crossref:kernelconfig[kernelconfig,Configuring the FreeBSD Kernel]). * Know how to install additional third-party software (crossref:ports[ports,Installing Applications: Packages and Ports]). @@ -329,500 +329,65 @@ DVMRP has largely been replaced by the PIM protocol in many multicast installati Refer to man:pim[4] for more information. ==== -[[network-wireless]] -== Wireless Networking +[[configtuning-virtual-hosts]] +== Virtual Hosts -=== Wireless Networking Basics +A common use of FreeBSD is virtual site hosting, where one server appears to the network as many servers. +This is achieved by assigning multiple network addresses to a single interface. -Most wireless networks are based on the IEEE(R) 802.11 standards. -A basic wireless network consists of multiple stations communicating with radios that broadcast in either the 2.4GHz or 5GHz band, though this varies according to the locale and is also changing to enable communication in the 2.3GHz and 4.9GHz ranges. - -802.11 networks are organized in two ways. -In _infrastructure mode_, one station acts as a master with all the other stations associating to it, the network is known as a BSS, and the master station is termed an access point (AP). -In a BSS, all communication passes through the AP; even when one station wants to communicate with another wireless station, messages must go through the AP. -In the second form of network, there is no master and stations communicate directly. -This form of network is termed an IBSS and is commonly known as an _ad-hoc network_. - -802.11 networks were first deployed in the 2.4GHz band using protocols defined by the IEEE(R) 802.11 and 802.11b standard. -These specifications include the operating frequencies and the MAC layer characteristics, including framing and transmission rates, as communication can occur at various rates. -Later, the 802.11a standard defined operation in the 5GHz band, including different signaling mechanisms and higher transmission rates. -Still later, the 802.11g standard defined the use of 802.11a signaling and transmission mechanisms in the 2.4GHz band in such a way as to be backwards compatible with 802.11b networks. - -Separate from the underlying transmission techniques, 802.11 networks have a variety of security mechanisms. -The original 802.11 specifications defined a simple security protocol called WEP. -This protocol uses a fixed pre-shared key and the RC4 cryptographic cipher to encode data transmitted on a network. -Stations must all agree on the fixed key in order to communicate. -This scheme was shown to be easily broken and is now rarely used except to discourage transient users from joining networks. -Current security practice is given by the IEEE(R) 802.11i specification that defines new cryptographic ciphers and an additional protocol to authenticate stations to an access point and exchange keys for data communication. -Cryptographic keys are periodically refreshed and there are mechanisms for detecting and countering intrusion attempts. -Another security protocol specification commonly used in wireless networks is termed WPA, which was a precursor to 802.11i. -WPA specifies a subset of the requirements found in 802.11i and is designed for implementation on legacy hardware. -Specifically, WPA requires only the TKIP cipher that is derived from the original WEP cipher. -802.11i permits use of TKIP but also requires support for a stronger cipher, AES-CCM, for encrypting data. -The AES cipher was not required in WPA because it was deemed too computationally costly to be implemented on legacy hardware. - -The other standard to be aware of is 802.11e. It defines protocols for deploying multimedia applications, such as streaming video and voice over IP (VoIP), in an 802.11 network. -Like 802.11i, 802.11e also has a precursor specification termed WME (later renamed WMM) that has been defined by an industry group as a subset of 802.11e that can be deployed now to enable multimedia applications while waiting for the final ratification of 802.11e. -The most important thing to know about 802.11e and WME/WMM is that it enables prioritized traffic over a wireless network through Quality of Service (QoS) protocols and enhanced media access protocols. -Proper implementation of these protocols enables high speed bursting of data and prioritized traffic flow. - -FreeBSD supports networks that operate using 802.11a, 802.11b, and 802.11g. -The WPA and 802.11i security protocols are likewise supported (in conjunction with any of 11a, 11b, and 11g) and QoS and traffic prioritization required by the WME/WMM protocols are supported for a limited set of wireless devices. - -[[network-wireless-quick-start]] -=== Quick Start - -Connecting a computer to an existing wireless network is a very common situation. -This procedure shows the steps required. - -[.procedure] -. Obtain the SSID (Service Set Identifier) and PSK (Pre-Shared Key) for the wireless network from the network administrator. -. Identify the wireless adapter. The FreeBSD [.filename]#GENERIC# kernel includes drivers for many common wireless adapters. -If the wireless adapter is one of those models, it will be listed in the man:sysctl[8] `net.wlan.devices` variable: -+ -[source,shell] -.... -% sysctl net.wlan.devices -.... -+ -If a wireless adapter is not listed, an additional kernel module might be required, or it might be a model not supported by FreeBSD. -+ -This example shows the Atheros `ath0` wireless adapter. -. Add an entry for this network to [.filename]#/etc/wpa_supplicant.conf#. If the file does not exist, create it. Replace _myssid_ and _mypsk_ with the SSID and PSK provided by the network administrator. -+ -[.programlisting] -.... -network={ - ssid="myssid" - psk="mypsk" -} -.... - -. Add entries to [.filename]#/etc/rc.conf# to configure the network on startup: -+ -[.programlisting] -.... -wlans_ath0="wlan0" -ifconfig_wlan0="WPA SYNCDHCP" -.... - -. Restart the computer, or restart the network service to connect to the network: -+ -[source,shell] -.... -# service netif restart -.... - -[[network-wireless-basic]] -=== Basic Setup - -==== Kernel Configuration - -To use wireless networking, a wireless networking card is needed and the kernel needs to be configured with the appropriate wireless networking support. -The kernel is separated into multiple modules so that only the required support needs to be configured. - -The most commonly used wireless devices are those that use parts made by Atheros. -These devices are supported by man:ath[4] and require the following line to be added to [.filename]#/boot/loader.conf#: - -[.programlisting] -.... -if_ath_load="YES" -.... - -The Atheros driver is split up into three separate pieces: the driver (man:ath[4]), the hardware support layer that handles chip-specific functions (man:ath_hal[4]), and an algorithm for selecting the rate for transmitting frames. -When this support is loaded as kernel modules, any dependencies are automatically handled. -To load support for a different type of wireless device, specify the module for that device. -This example is for devices based on the Intersil Prism parts (man:wi[4]) driver: - -[.programlisting] -.... -if_wi_load="YES" -.... - -[NOTE] -==== -The examples in this section use an man:ath[4] device and the device name in the examples must be changed according to the configuration. -A list of available wireless drivers and supported adapters can be found in the FreeBSD Hardware Notes, available on the https://www.FreeBSD.org/releases/[Release Information] page of the FreeBSD website. -If a native FreeBSD driver for the wireless device does not exist, it may be possible to use the Windows(R) driver with the help of the crossref:config[config-network-ndis,NDIS] driver wrapper. -==== - -In addition, the modules that implement cryptographic support for the security protocols to use must be loaded. -These are intended to be dynamically loaded on demand by the man:wlan[4] module, but for now they must be manually configured. -The following modules are available: man:wlan_wep[4], man:wlan_ccmp[4], and man:wlan_tkip[4]. -The man:wlan_ccmp[4] and man:wlan_tkip[4] drivers are only needed when using the WPA or 802.11i security protocols. -If the network does not use encryption, man:wlan_wep[4] support is not needed. -To load these modules at boot time, add the following lines to [.filename]#/boot/loader.conf#: - -[.programlisting] -.... -wlan_wep_load="YES" -wlan_ccmp_load="YES" -wlan_tkip_load="YES" -.... - -Once this information has been added to [.filename]#/boot/loader.conf#, reboot the FreeBSD box. -Alternately, load the modules by hand using man:kldload[8]. - -[NOTE] -==== -For users who do not want to use modules, it is possible to compile these drivers into the kernel by adding the following lines to a custom kernel configuration file: - -[.programlisting] -.... -device wlan # 802.11 support -device wlan_wep # 802.11 WEP support -device wlan_ccmp # 802.11 CCMP support -device wlan_tkip # 802.11 TKIP support -device wlan_amrr # AMRR transmit rate control algorithm -device ath # Atheros pci/cardbus NIC's -device ath_hal # pci/cardbus chip support -options AH_SUPPORT_AR5416 # enable AR5416 tx/rx descriptors -device ath_rate_sample # SampleRate tx rate control for ath -.... - -With this information in the kernel configuration file, recompile the kernel and reboot the FreeBSD machine. -==== - -Information about the wireless device should appear in the boot messages, like this: - -[source,shell] -.... -ath0: mem 0x88000000-0x8800ffff irq 11 at device 0.0 on cardbus1 -ath0: [ITHREAD] -ath0: AR2413 mac 7.9 RF2413 phy 4.5 -.... - -==== Setting the Correct Region - -Since the regulatory situation is different in various parts of the world, it is necessary to correctly set the domains that apply to your location to have the correct information about what channels can be used. - -The available region definitions can be found in [.filename]#/etc/regdomain.xml#. -To set the data at runtime, use `ifconfig`: - -[source,shell] -.... -# ifconfig wlan0 regdomain ETSI country AT -.... - -To persist the settings, add it to [.filename]#/etc/rc.conf#: - -[source,shell] -.... -# sysrc create_args_wlan0="country AT regdomain ETSI" -.... - -=== Infrastructure Mode - -Infrastructure (BSS) mode is the mode that is typically used. -In this mode, a number of wireless access points are connected to a wired network. -Each wireless network has its own name, called the SSID. -Wireless clients connect to the wireless access points. - -==== FreeBSD Clients - -===== How to Find Access Points - -To scan for available networks, use man:ifconfig[8]. -This request may take a few moments to complete as it requires the system to switch to each available wireless frequency and probe for available access points. -Only the superuser can initiate a scan: - -[source,shell] -.... -# ifconfig wlan0 create wlandev ath0 -# ifconfig wlan0 up -# ifconfig wlan0 scan -SSID/MESH ID BSSID CHAN RATE S:N INT CAPS -dlinkap 00:13:46:49:41:76 11 54M -90:96 100 EPS WPA WME -freebsdap 00:11:95:c3:0d:ac 1 54M -83:96 100 EPS WPA -.... - -[NOTE] -==== -The interface must be `up` before it can scan. -Subsequent scan requests do not require the interface to be marked as up again. -==== - -The output of a scan request lists each BSS/IBSS network found. -Besides listing the name of the network, the `SSID`, the output also shows the `BSSID`, which is the MAC address of the access point. -The `CAPS` field identifies the type of each network and the capabilities of the stations operating there (see the definition of `list scan` in man:ifconfig[8] for more details). - -One can also display the current list of known networks with: - -[source,shell] -.... -# ifconfig wlan0 list scan -.... - -This information may be updated automatically by the adapter or manually with a `scan` request. -Old data is automatically removed from the cache, so over time this list may shrink unless more scans are done. - -===== Basic Settings - -This section provides a simple example of how to make the wireless network adapter work in FreeBSD without encryption. -Once familiar with these concepts, it is strongly recommend to use <> to set up the wireless network. - -There are three basic steps to configure a wireless network: select an access point, authenticate the station, and configure an IP address. -The following sections discuss each step. - -====== Selecting an Access Point - -Most of the time, it is sufficient to let the system choose an access point using the builtin heuristics. -This is the default behavior when an interface is marked as up or it is listed in [.filename]#/etc/rc.conf#: - -[.programlisting] -.... -wlans_ath0="wlan0" -ifconfig_wlan0="DHCP" -.... - -If there are multiple access points, a specific one can be selected by its SSID: - -[.programlisting] -.... -wlans_ath0="wlan0" -ifconfig_wlan0="ssid your_ssid_here DHCP" -.... - -In an environment where there are multiple access points with the same SSID, which is often done to simplify roaming, it may be necessary to associate to one specific device. -In this case, the BSSID of the access point can be specified, with or without the SSID: - -[.programlisting] -.... -wlans_ath0="wlan0" -ifconfig_wlan0="ssid your_ssid_here bssid xx:xx:xx:xx:xx:xx DHCP" -.... - -There are other ways to constrain the choice of an access point, such as limiting the set of frequencies the system will scan on. -This may be useful for a multi-band wireless card as scanning all the possible channels can be time-consuming. -To limit operation to a specific band, use the `mode` parameter: - -[.programlisting] -.... -wlans_ath0="wlan0" -ifconfig_wlan0="mode 11g ssid your_ssid_here DHCP" -.... - -This example will force the card to operate in 802.11g, which is defined only for 2.4GHz frequencies so any 5GHz channels will not be considered. -This can also be achieved with the `channel` parameter, which locks operation to one specific frequency, and the `chanlist` parameter, to specify a list of channels for scanning. -More information about these parameters can be found in man:ifconfig[8]. - -====== Authentication - -Once an access point is selected, the station needs to authenticate before it can pass data. -Authentication can happen in several ways. -The most common scheme, open authentication, allows any station to join the network and communicate. -This is the authentication to use for test purposes the first time a wireless network is setup. -Other schemes require cryptographic handshakes to be completed before data traffic can flow, either using pre-shared keys or secrets, or more complex schemes that involve backend services such as RADIUS. -Open authentication is the default setting. -The next most common setup is WPA-PSK, also known as WPA Personal, which is described in <>. - -[NOTE] -==== -If using an Apple(R) AirPort(R) Extreme base station for an access point, shared-key authentication together with a WEP key needs to be configured. -This can be configured in [.filename]#/etc/rc.conf# or by using man:wpa_supplicant[8]. -For a single AirPort(R) base station, access can be configured with: - -[.programlisting] -.... -wlans_ath0="wlan0" -ifconfig_wlan0="authmode shared wepmode on weptxkey 1 wepkey 01234567 DHCP" -.... - -In general, shared key authentication should be avoided because it uses the WEP key material in a highly-constrained manner, making it even easier to crack the key. -If WEP must be used for compatibility with legacy devices, it is better to use WEP with `open` authentication. -More information regarding WEP can be found in <>. -==== - -====== Getting an IP Address with DHCP - -Once an access point is selected and the authentication parameters are set, an IP address must be obtained in order to communicate. -Most of the time, the IP address is obtained via DHCP. -To achieve that, edit [.filename]#/etc/rc.conf# and add `DHCP` to the configuration for the device: - -[.programlisting] -.... -wlans_ath0="wlan0" -ifconfig_wlan0="DHCP" -.... - -The wireless interface is now ready to bring up: +A given network interface has one "real" address, and may have any number of "alias" addresses. +These aliases are normally added by placing alias entries in [.filename]#/etc/rc.conf#, as seen in this example: [source,shell] .... -# service netif start +# sysrc ifconfig_fxp0_alias0="inet xxx.xxx.xxx.xxx netmask xxx.xxx.xxx.xxx" .... -Once the interface is running, use man:ifconfig[8] to see the status of the interface [.filename]#ath0#: +Alias entries must start with `alias__0__` using a sequential number such as `alias0`, `alias1`, and so on. +The configuration process will stop at the first missing number. -[source,shell] -.... -# ifconfig wlan0 -wlan0: flags=8843 mtu 1500 - ether 00:11:95:d5:43:62 - inet 192.168.1.100 netmask 0xffffff00 broadcast 192.168.1.255 - media: IEEE 802.11 Wireless Ethernet OFDM/54Mbps mode 11g - status: associated - ssid dlinkap channel 11 (2462 Mhz 11g) bssid 00:13:46:49:41:76 - country US ecm authmode OPEN privacy OFF txpower 21.5 bmiss 7 - scanvalid 60 bgscan bgscanintvl 300 bgscanidle 250 roam:rssi 7 - roam:rate 5 protmode CTS wme burst -.... - -The `status: associated` line means that it is connected to the wireless network. -The `bssid 00:13:46:49:41:76` is the MAC address of the access point and `authmode OPEN` indicates that the communication is not encrypted. - -====== Static IP Address - -If an IP address cannot be obtained from a DHCP server, set a fixed IP address. -Replace the `DHCP` keyword shown above with the address information. -Be sure to retain any other parameters for selecting the access point: - -[.programlisting] -.... -wlans_ath0="wlan0" -ifconfig_wlan0="inet 192.168.1.100 netmask 255.255.255.0 ssid your_ssid_here" -.... - -[[network-wireless-wpa]] -===== WPA - -Wi-Fi Protected Access (WPA) is a security protocol used together with 802.11 networks to address the lack of proper authentication and the weakness of WEP. -WPA leverages the 802.1X authentication protocol and uses one of several ciphers instead of WEP for data integrity. -The only cipher required by WPA is the Temporary Key Integrity Protocol (TKIP). -TKIP is a cipher that extends the basic RC4 cipher used by WEP by adding integrity checking, tamper detection, and measures for responding to detected intrusions. -TKIP is designed to work on legacy hardware with only software modification. -It represents a compromise that improves security but is still not entirely immune to attack. -WPA also specifies the AES-CCMP cipher as an alternative to TKIP, and that is preferred when possible. -For this specification, the term WPA2 or RSN is commonly used. +The calculation of alias netmasks is important. +For a given interface, there must be one address which correctly represents the network's netmask. +Any other addresses which fall within this network must have a netmask of all ``1``s, expressed as either `255.255.255.255` or `0xffffffff`. -WPA defines authentication and encryption protocols. -Authentication is most commonly done using one of two techniques: by 802.1X and a backend authentication service such as RADIUS, or by a minimal handshake between the station and the access point using a pre-shared secret. -The former is commonly termed WPA Enterprise and the latter is known as WPA Personal. -Since most people will not set up a RADIUS backend server for their wireless network, WPA-PSK is by far the most commonly encountered configuration for WPA. - -The control of the wireless connection and the key negotiation or authentication with a server is done using man:wpa_supplicant[8]. -This program requires a configuration file, [.filename]#/etc/wpa_supplicant.conf#, to run. -More information regarding this file can be found in man:wpa_supplicant.conf[5]. - -[[network-wireless-wpa-wpa-psk]] -====== WPA-PSK - -WPA-PSK, also known as WPA Personal, is based on a pre-shared key (PSK) which is generated from a given password and used as the master key in the wireless network. -This means every wireless user will share the same key. -WPA-PSK is intended for small networks where the use of an authentication server is not possible or desired. - -[WARNING] -==== -Always use strong passwords that are sufficiently long and made from a rich alphabet so that they will not be easily guessed or attacked. -==== - -The first step is the configuration of [.filename]#/etc/wpa_supplicant.conf# with the SSID and the pre-shared key of the network: - -[.programlisting] -.... -network={ - ssid="freebsdap" - psk="freebsdmall" -} -.... - -Then, in [.filename]#/etc/rc.conf#, indicate that the wireless device configuration will be done with WPA and the IP address will be obtained with DHCP: - -[.programlisting] -.... -wlans_ath0="wlan0" -ifconfig_wlan0="WPA DHCP" -.... - -Then, bring up the interface: - -[source,shell] -.... -# service netif start -Starting wpa_supplicant. -DHCPDISCOVER on wlan0 to 255.255.255.255 port 67 interval 5 -DHCPDISCOVER on wlan0 to 255.255.255.255 port 67 interval 6 -DHCPOFFER from 192.168.0.1 -DHCPREQUEST on wlan0 to 255.255.255.255 port 67 -DHCPACK from 192.168.0.1 -bound to 192.168.0.254 -- renewal in 300 seconds. -wlan0: flags=8843 mtu 1500 - ether 00:11:95:d5:43:62 - inet 192.168.0.254 netmask 0xffffff00 broadcast 192.168.0.255 - media: IEEE 802.11 Wireless Ethernet OFDM/36Mbps mode 11g - status: associated - ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac - country US ecm authmode WPA2/802.11i privacy ON deftxkey UNDEF - AES-CCM 3:128-bit txpower 21.5 bmiss 7 scanvalid 450 bgscan - bgscanintvl 300 bgscanidle 250 roam:rssi 7 roam:rate 5 protmode CTS - wme burst roaming MANUAL -.... +For example, consider the case where the `fxp0` interface is connected to two networks: `10.1.1.0` with a netmask of `255.255.255.0` and `202.0.75.16` with a netmask of `255.255.255.240`. +The system is to be configured to appear in the ranges `10.1.1.1` through `10.1.1.5` and `202.0.75.17` through `202.0.75.20`. +Only the first address in a given network range should have a real netmask. +All the rest (`10.1.1.2` through `10.1.1.5` and `202.0.75.18` through `202.0.75.20`) must be configured with a netmask of `255.255.255.255`. -Or, try to configure the interface manually using the information in [.filename]#/etc/wpa_supplicant.conf#: +The following [.filename]#/etc/rc.conf# entries configure the adapter correctly for this scenario: [source,shell] .... -# wpa_supplicant -i wlan0 -c /etc/wpa_supplicant.conf -Trying to associate with 00:11:95:c3:0d:ac (SSID='freebsdap' freq=2412 MHz) -Associated with 00:11:95:c3:0d:ac -WPA: Key negotiation completed with 00:11:95:c3:0d:ac [PTK=CCMP GTK=CCMP] -CTRL-EVENT-CONNECTED - Connection to 00:11:95:c3:0d:ac completed (auth) [id=0 id_str=] +# sysrc ifconfig_fxp0="inet 10.1.1.1 netmask 255.255.255.0" +# sysrc ifconfig_fxp0_alias0="inet 10.1.1.2 netmask 255.255.255.255" +# sysrc ifconfig_fxp0_alias1="inet 10.1.1.3 netmask 255.255.255.255" +# sysrc ifconfig_fxp0_alias2="inet 10.1.1.4 netmask 255.255.255.255" +# sysrc ifconfig_fxp0_alias3="inet 10.1.1.5 netmask 255.255.255.255" +# sysrc ifconfig_fxp0_alias4="inet 202.0.75.17 netmask 255.255.255.240" +# sysrc ifconfig_fxp0_alias5="inet 202.0.75.18 netmask 255.255.255.255" +# sysrc ifconfig_fxp0_alias6="inet 202.0.75.19 netmask 255.255.255.255" +# sysrc ifconfig_fxp0_alias7="inet 202.0.75.20 netmask 255.255.255.255" .... -The next operation is to launch man:dhclient[8] to get the IP address from the DHCP server: +A simpler way to express this is with a space-separated list of IP address ranges. +The first address will be given the indicated subnet mask and the additional addresses will have a subnet mask of `255.255.255.255`. [source,shell] .... -# dhclient wlan0 -DHCPREQUEST on wlan0 to 255.255.255.255 port 67 -DHCPACK from 192.168.0.1 -bound to 192.168.0.254 -- renewal in 300 seconds. -# ifconfig wlan0 -wlan0: flags=8843 mtu 1500 - ether 00:11:95:d5:43:62 - inet 192.168.0.254 netmask 0xffffff00 broadcast 192.168.0.255 - media: IEEE 802.11 Wireless Ethernet OFDM/36Mbps mode 11g - status: associated - ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac - country US ecm authmode WPA2/802.11i privacy ON deftxkey UNDEF - AES-CCM 3:128-bit txpower 21.5 bmiss 7 scanvalid 450 bgscan - bgscanintvl 300 bgscanidle 250 roam:rssi 7 roam:rate 5 protmode CTS - wme burst roaming MANUAL +# sysrc ifconfig_fxp0_aliases="inet 10.1.1.1-5/24 inet 202.0.75.17-20/28" .... -[NOTE] -==== -If [.filename]#/etc/rc.conf# has an `ifconfig_wlan0="DHCP"` entry, man:dhclient[8] will be launched automatically after man:wpa_supplicant[8] associates with the access point. -==== - -If DHCP is not possible or desired, set a static IP address after man:wpa_supplicant[8] has authenticated the station: - -[source,shell] -.... -# ifconfig wlan0 inet 192.168.0.100 netmask 255.255.255.0 -# ifconfig wlan0 -wlan0: flags=8843 mtu 1500 - ether 00:11:95:d5:43:62 - inet 192.168.0.100 netmask 0xffffff00 broadcast 192.168.0.255 - media: IEEE 802.11 Wireless Ethernet OFDM/36Mbps mode 11g - status: associated - ssid freebsdap channel 1 (2412 Mhz 11g) bssid 00:11:95:c3:0d:ac - country US ecm authmode WPA2/802.11i privacy ON deftxkey UNDEF - AES-CCM 3:128-bit txpower 21.5 bmiss 7 scanvalid 450 bgscan - bgscanintvl 300 bgscanidle 250 roam:rssi 7 roam:rate 5 protmode CTS - wme burst roaming MANUAL -.... +[[network-advanced-wireless]] +== Wireless Advanced Authentication -When DHCP is not used, the default gateway and the nameserver also have to be manually set: +FreeBSD supports different ways of connecting to a wireless network. +This section describes how to perform advanced authentication to a Wireless Network. -[source,shell] -.... -# route add default your_default_router -# echo "nameserver your_DNS_server" >> /etc/resolv.conf -.... +To make a connection and basic authentication to a wireless network the section crossref:network[wireless-authentication,Connection and Authentication to a Wireless Network] in the Network Chapter describes how to do it. [[network-wireless-wpa-eap-tls]] -====== WPA with EAP-TLS +=== WPA with EAP-TLS The second way to use WPA is with an 802.1X backend authentication server. In this case, WPA is called WPA Enterprise to differentiate it from the less secure WPA Personal. @@ -896,7 +461,7 @@ wlan0: flags=8843 mtu 1500 It is also possible to bring up the interface manually using man:wpa_supplicant[8] and man:ifconfig[8]. [[network-wireless-wpa-eap-ttls]] -====== WPA with EAP-TTLS +=== WPA with EAP-TTLS With EAP-TLS, both the authentication server and the client need a certificate. With EAP-TTLS, a client certificate is optional. @@ -957,7 +522,7 @@ wlan0: flags=8843 mtu 1500 .... [[network-wireless-wpa-eap-peap]] -====== WPA with EAP-PEAP +=== WPA with EAP-PEAP [NOTE] ==== @@ -1027,54 +592,8 @@ wlan0: flags=8843 mtu 1500 wme burst roaming MANUAL .... -[[network-wireless-wep]] -===== WEP - -Wired Equivalent Privacy (WEP) is part of the original 802.11 standard. -There is no authentication mechanism, only a weak form of access control which is easily cracked. - -WEP can be set up using man:ifconfig[8]: - -[source,shell] -.... -# ifconfig wlan0 create wlandev ath0 -# ifconfig wlan0 inet 192.168.1.100 netmask 255.255.255.0 \ - ssid my_net wepmode on weptxkey 3 wepkey 3:0x3456789012 -.... - -* The `weptxkey` specifies which WEP key will be used in the transmission. This example uses the third key. This must match the setting on the access point. When unsure which key is used by the access point, try `1` (the first key) for this value. -* The `wepkey` selects one of the WEP keys. It should be in the format _index:key_. Key `1` is used by default; the index only needs to be set when using a key other than the first key. -+ -[NOTE] -==== -Replace the `0x3456789012` with the key configured for use on the access point. -==== - -Refer to man:ifconfig[8] for further information. - -The man:wpa_supplicant[8] facility can be used to configure a wireless interface with WEP. -The example above can be set up by adding the following lines to [.filename]#/etc/wpa_supplicant.conf#: - -[.programlisting] -.... -network={ - ssid="my_net" - key_mgmt=NONE - wep_key3=3456789012 - wep_tx_keyidx=3 -} -.... - -Then: - -[source,shell] -.... -# wpa_supplicant -i wlan0 -c /etc/wpa_supplicant.conf -Trying to associate with 00:13:46:49:41:76 (SSID='dlinkap' freq=2437 MHz) -Associated with 00:13:46:49:41:76 -.... - -=== Ad-hoc Mode +[[wireless-ad-hoc-mode]] +== Wireless Ad-hoc Mode IBSS mode, also called ad-hoc mode, is designed for point to point connections. For example, to establish an ad-hoc network between the machines `A` and `B`, choose two IP addresses and a SSID. @@ -1308,85 +827,6 @@ Once the AP is running, the clients can associate with it. See <> for more details. It is possible to see the stations associated with the AP using `ifconfig _wlan0_ list sta`. -==== WEP Host-based Access Point - -It is not recommended to use WEP for setting up an AP since there is no authentication mechanism and the encryption is easily cracked. -Some legacy wireless cards only support WEP and these cards will only support an AP without authentication or encryption. - -The wireless device can now be put into hostap mode and configured with the correct SSID and IP address: - -[source,shell] -.... -# ifconfig wlan0 create wlandev ath0 wlanmode hostap -# ifconfig wlan0 inet 192.168.0.1 netmask 255.255.255.0 \ - ssid freebsdap wepmode on weptxkey 3 wepkey 3:0x3456789012 mode 11g -.... - -* The `weptxkey` indicates which WEP key will be used in the transmission. This example uses the third key as key numbering starts with `1`. This parameter must be specified in order to encrypt the data. -* The `wepkey` sets the selected WEP key. It should be in the format _index:key_. If the index is not given, key `1` is set. The index needs to be set when using keys other than the first key. - -Use man:ifconfig[8] to see the status of the [.filename]#wlan0# interface: - -[source,shell] -.... -# ifconfig wlan0 - wlan0: flags=8843 metric 0 mtu 1500 - ether 00:11:95:c3:0d:ac - inet 192.168.0.1 netmask 0xffffff00 broadcast 192.168.0.255 - media: IEEE 802.11 Wireless Ethernet autoselect mode 11g - status: running - ssid freebsdap channel 4 (2427 Mhz 11g) bssid 00:11:95:c3:0d:ac - country US ecm authmode OPEN privacy ON deftxkey 3 wepkey 3:40-bit - txpower 21.5 scanvalid 60 protmode CTS wme burst dtimperiod 1 -dfs -.... - -From another wireless machine, it is now possible to initiate a scan to find the AP: - -[source,shell] -.... -# ifconfig wlan0 create wlandev ath0 -# ifconfig wlan0 up scan -SSID BSSID CHAN RATE S:N INT CAPS -freebsdap 00:11:95:c3:0d:ac 1 54M 22:1 100 EPS -.... - -In this example, the client machine found the AP and can associate with it using the correct parameters. -See <> for more details. - -=== Using Both Wired and Wireless Connections - -A wired connection provides better performance and reliability, while a wireless connection provides flexibility and mobility. -Laptop users typically want to roam seamlessly between the two types of connections. - -On FreeBSD, it is possible to combine two or even more network interfaces together in a "failover" fashion. -This type of configuration uses the most preferred and available connection from a group of network interfaces, and the operating system switches automatically when the link state changes. - -Link aggregation and failover is covered in <> and an example for using both wired and wireless connections is provided at <>. - -=== Troubleshooting - -This section describes a number of steps to help troubleshoot common wireless networking problems. - -* If the access point is not listed when scanning, check that the configuration has not limited the wireless device to a limited set of channels. -* If the device cannot associate with an access point, verify that the configuration matches the settings on the access point. This includes the authentication scheme and any security protocols. Simplify the configuration as much as possible. If using a security protocol such as WPA or WEP, configure the access point for open authentication and no security to see if traffic will pass. -+ -Debugging support is provided by man:wpa_supplicant[8]. Try running this utility manually with `-dd` and look at the system logs. -* Once the system can associate with the access point, diagnose the network configuration using tools like man:ping[8]. -* There are many lower-level debugging tools. Debugging messages can be enabled in the 802.11 protocol support layer using man:wlandebug[8]. For example, to enable console messages related to scanning for access points and the 802.11 protocol handshakes required to arrange communication: -+ -[source,shell] -.... -# wlandebug -i wlan0 +scan+auth+debug+assoc - net.wlan.0.debug: 0 => 0xc80000 -.... -+ -Many useful statistics are maintained by the 802.11 layer and `wlanstats`, found in [.filename]#/usr/src/tools/tools/net80211#, will dump this information. -These statistics should display all errors identified by the 802.11 layer. -However, some errors are identified in the device drivers that lie below the 802.11 layer so they may not show up. -To diagnose device-specific problems, refer to the driver documentation. - -If the above information does not help to clarify the problem, submit a problem report and include output from the above tools. - [[network-usb-tethering]] == USB Tethering @@ -2742,255 +2182,6 @@ The `BUGS` sections in man:tftpd[8] and man:tftp[1] document some limitations wi .... **** -[[network-ipv6]] -== IPv6 - -IPv6 is the new version of the well known IP protocol, also known as IPv4. -IPv6 provides several advantages over IPv4 as well as many new features: - -* Its 128-bit address space allows for 340,282,366,920,938,463,463,374,607,431,768,211,456 addresses. This addresses the IPv4 address shortage and eventual IPv4 address exhaustion. -* Routers only store network aggregation addresses in their routing tables, thus reducing the average space of a routing table to 8192 entries. This addresses the scalability issues associated with IPv4, which required every allocated block of IPv4 addresses to be exchanged between Internet routers, causing their routing tables to become too large to allow efficient routing. - -* Address autoconfiguration (http://www.ietf.org/rfc/rfc2462.txt[RFC2462]). -* Mandatory multicast addresses. -* Built-in IPsec (IP security). -* Simplified header structure. -* Support for mobile IP. -* IPv6-to-IPv4 transition mechanisms. - -FreeBSD includes the http://www.kame.net/[http://www.kame.net/] IPv6 reference implementation and comes with everything needed to use IPv6. -This section focuses on getting IPv6 configured and running. - -=== Background on IPv6 Addresses - -There are three different types of IPv6 addresses: - -Unicast:: -A packet sent to a unicast address arrives at the interface belonging to the address. - -Anycast:: -These addresses are syntactically indistinguishable from unicast addresses but they address a group of interfaces. -The packet destined for an anycast address will arrive at the nearest router interface. -Anycast addresses are only used by routers. - -Multicast:: -These addresses identify a group of interfaces. -A packet destined for a multicast address will arrive at all interfaces belonging to the multicast group. -The IPv4 broadcast address, usually `xxx.xxx.xxx.255`, is expressed by multicast addresses in IPv6. - -When reading an IPv6 address, the canonical form is represented as `x:x:x:x:x:x:x:x`, where each `x` represents a 16 bit hex value. -An example is `FEBC:A574:382B:23C1:AA49:4592:4EFE:9982`. - -Often, an address will have long substrings of all zeros. -A `::` (double colon) can be used to replace one substring per address. -Also, up to three leading ``0``s per hex value can be omitted. -For example, `fe80::1` corresponds to the canonical form `fe80:0000:0000:0000:0000:0000:0000:0001`. - -A third form is to write the last 32 bits using the well known IPv4 notation. -For example, `2002::10.0.0.1` corresponds to the hexadecimal canonical representation `2002:0000:0000:0000:0000:0000:0a00:0001`, which in turn is equivalent to `2002::a00:1`. - -To view a FreeBSD system's IPv6 address, use man:ifconfig[8]: - -[source,shell] -.... -# ifconfig -.... - -[.programlisting] -.... -rl0: flags=8943 mtu 1500 - inet 10.0.0.10 netmask 0xffffff00 broadcast 10.0.0.255 - inet6 fe80::200:21ff:fe03:8e1%rl0 prefixlen 64 scopeid 0x1 - ether 00:00:21:03:08:e1 - media: Ethernet autoselect (100baseTX ) - status: active -.... - -In this example, the [.filename]#rl0# interface is using `fe80::200:21ff:fe03:8e1%rl0`, an auto-configured link-local address which was automatically generated from the MAC address. - -Some IPv6 addresses are reserved. -A summary of these reserved addresses is seen in <>: - -[[reservedip6]] -.Reserved IPv6 Addresses -[cols="1,1,1,1", frame="none", options="header"] -|=== -| IPv6 address -| Prefixlength (Bits) -| Description -| Notes - -|`::` -|128 bits -|unspecified -|Equivalent to `0.0.0.0` in IPv4. - -|`::1` -|128 bits -|loopback address -|Equivalent to `127.0.0.1` in IPv4. - -|`::00:xx:xx:xx:xx` -|96 bits -|embedded IPv4 -|The lower 32 bits are the compatible IPv4 address. - -|`::ff:xx:xx:xx:xx` -|96 bits -|IPv4 mapped IPv6 address -|The lower 32 bits are the IPv4 address for hosts which do not support IPv6. - -|`fe80::/10` -|10 bits -|link-local -|Equivalent to 169.254.0.0/16 in IPv4. - -|`fc00::/7` -|7 bits -|unique-local -|Unique local addresses are intended for local communication and are only routable within a set of cooperating sites. - -|`ff00::` -|8 bits -|multicast -| - -|``2000::-3fff::`` -|3 bits -|global unicast -|All global unicast addresses are assigned from this pool. The first 3 bits are `001`. -|=== - -For further information on the structure of IPv6 addresses, refer to http://www.ietf.org/rfc/rfc3513.txt[RFC3513]. - -=== Configuring IPv6 - -To configure a FreeBSD system as an IPv6 client, add these two lines to [.filename]#rc.conf#: - -[.programlisting] -.... -ifconfig_rl0_ipv6="inet6 accept_rtadv" -rtsold_enable="YES" -.... - -The first line enables the specified interface to receive router advertisement messages. -The second line enables the router solicitation daemon, man:rtsol[8]. - -If the interface needs a statically assigned IPv6 address, add an entry to specify the static address and associated prefix length: - -[.programlisting] -.... -ifconfig_rl0_ipv6="inet6 2001:db8:4672:6565:2026:5043:2d42:5344 prefixlen 64" -.... - -To assign a default router, specify its address: - -[.programlisting] -.... -ipv6_defaultrouter="2001:db8:4672:6565::1" -.... - -=== Connecting to a Provider - -In order to connect to other IPv6 networks, one must have a provider or a tunnel that supports IPv6: - -* Contact an Internet Service Provider to see if they offer IPv6. -* http://www.tunnelbroker.net[Hurricane Electric] offers tunnels with end-points all around the globe. - -[NOTE] -==== -Install the package:net/freenet6[] package or port for a dial-up connection. -==== - -This section demonstrates how to take the directions from a tunnel provider and convert them into [.filename]#/etc/rc.conf# settings that will persist through reboots. *** 3028 LINES SKIPPED *** From nobody Thu Jul 6 16:02:05 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Qxh9n3gbhz4lc7L for ; Thu, 6 Jul 2023 16:02:05 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Qxh9n3G1Sz3Hpf; Thu, 6 Jul 2023 16:02:05 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688659325; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=pTEgKhIak0qhFiR9ksN7izhTMOirmW+woGeJm/RxGkU=; b=W7Li+tRzB/3nVWqMuClMF5OFiZ/S2cjgzTy8cIOlA/GyC0St30ttxihBCPxjfZulO4CXIH FOknJtuLm9/ei7/I4SWAS4GScN7D7yw1P/seMCPVcGBZRRBFxemUVPPHVzYQjWM2bMVs5P RqSqoEDBErUO0qKQBrq4Cvt5UNhTgx+gpvO51LXJ4wzX2iKtrMWVhw6b3vKNCZ79f0Yc/G Klb74PU6uD6295dV1goqi70wdVRHEluY2aLUJtK0N1fL9HQOPpEsUgiy8bJpKVA7txUmUJ eFVIl60C0PYVBqOtddaS6wMjWmh0Ke6nMXhPeTI52TcboC5AMeNMmVHScmq76w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688659325; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=pTEgKhIak0qhFiR9ksN7izhTMOirmW+woGeJm/RxGkU=; b=m0OSymg5/B/pcZksbrOhvCBrQp2EJiHY6vizg+QBesCxYnEs3mNP5T5cK4YZT3n0jxIJab fY907bXkVrY88a/XyEC9ySqT/2Pziby8MmMsaqFZLmHlUk6TN69feTVQGInADH7T5aLgX5 YvEAFW5GiXZgV7oMUJtOfi0Yu1MgdtU8xSHFUhuBXZgXPcNLh1Ey5RD15x1mgFwVs5Y42+ PnKVR/9HEfcEGReB0tzidz3BN4rq8dqsH98LN4uJDhnuI3jh5Stc0EjYTmEiaiNXxNhzZm KMgQFapPHxksQLgSw0UMthLhxf0tcuVdSYeq/hZqUG8yq9r//Cv3PmbYFLjaeA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688659325; a=rsa-sha256; cv=none; b=x4f2T8qsKza8KUuXMts9XLApOvkvuEjrcc/S+TRS1D+nFFOIszVCMgdF8Yk+RvWJa+NkK1 ftHzWlOvxNc/xUYOwDqvrD9ej8cY1GI1W5yPGHTMhDCjFQc46sWy2oV+qgYu/bJ5MkyX8c Ex9n8vg9jFAwxVWYd8qtM3lWjngsANKMsLaEEcBszsMw3xEozm4uR/4SeMwHiUhNRBjllH P076CHTeCW4f20BHYncyXuIUzzTmL0Yc75VB/WIYEUvz1dgFs6mezs0tZV9LAKtXEArzxC D4Y4Gh459DXG8gB+kwMCoPnJE1WROhsMYLJ6PeoI05ST/1puUSqPvdSX4DE6YQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Qxh9n2LnQz136s; Thu, 6 Jul 2023 16:02:05 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 366G25nR049408; Thu, 6 Jul 2023 16:02:05 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 366G25mj049407; Thu, 6 Jul 2023 16:02:05 GMT (envelope-from git) Date: Thu, 6 Jul 2023 16:02:05 GMT Message-Id: <202307061602.366G25mj049407@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: bd0a6f54b7 - main - Status/2023Q2/doceng.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: bd0a6f54b79f90acc5bd93b73e23fa4cecbb24c0 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=bd0a6f54b79f90acc5bd93b73e23fa4cecbb24c0 commit bd0a6f54b79f90acc5bd93b73e23fa4cecbb24c0 Author: Fernando Apesteguía AuthorDate: 2023-07-06 15:32:19 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-06 16:01:11 +0000 Status/2023Q2/doceng.adoc: Add report Approved by: dbaio (mentor, implicit) --- .../en/status/report-2023-04-2023-06/doceng.adoc | 102 +++++++++++++++++++++ 1 file changed, 102 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/doceng.adoc b/website/content/en/status/report-2023-04-2023-06/doceng.adoc new file mode 100644 index 0000000000..fa6e336069 --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/doceng.adoc @@ -0,0 +1,102 @@ +//// +Quarter: 2nd quarter of 2023 +Prepared by: fernape +Reviewed by: dbaio, carlavilla +Last edit: $Date: 2023-06-25 15:11:08 +0200 (Sun, 25 Jun 2023) $ +Version: $Id: doceng-2023-2nd-quarter-status-report.adoc 415 2023-06-25 13:11:08Z carlavilla $ +//// + +=== Documentation Engineering Team + +Link: link:https://www.freebsd.org/docproj/[FreeBSD Documentation Project] URL: link:https://www.freebsd.org/docproj/url[] + +Link: link:https://docs.freebsd.org/en/books/fdp-primer/[FreeBSD Documentation Project Primer for New Contributors] URL: link:https://docs.freebsd.org/en/books/fdp-primer/url[] + +Link: link:https://www.freebsd.org/administration/#t-doceng[Documentation Engineering Team] URL: link:https://www.freebsd.org/administration/#t-docengurl[] + +Contact: FreeBSD Doceng Team + +The doceng@ team is a body to handle some of the meta-project issues associated with the FreeBSD Documentation Project; for more information, see link:https://www.freebsd.org/internal/doceng/[FreeBSD Doceng Team Charter]. + +During the last quarter: + +* fernape@ has been appointed as a new Doceng team member. +* The package:www/gohugo[] port maintainership has been transfered to doceng@ since it is a critical part of our documentation infrastructure. +This was agreed with the former maintainer. +* Improvements to the translation workflow (described in the following sections). + +==== Porter's Handbook: + +The missing link:https://cgit.freebsd.org/doc/commit/?id=634a34b7bb37650e4f8fcbea9fd7428b3f5b911a[Uses=nextcloud has been documented.] + +==== FDP Primer: + +* A new chapter focusing on Weblate has been recently added to the link:https://docs.freebsd.org/en/books/fdp-primer/weblate/[FreeBSD Documentation Project Primer for New Contributors book]. +This comprehensive chapter provides step-by-step guidance on joining the FreeBSD translators team, both for translating online on Weblate and offline. +It offers valuable insights and practical suggestions for efficient translation, proofreading, and testing processes. +Furthermore, this chapter equips contributors with the necessary knowledge to formally submit their translations to the documentation repository, ensuring a seamless integration of their work. + +==== FreeBSD Translations on Weblate + +Link: link:https://wiki.freebsd.org/Doc/Translation/Weblate[Translate FreeBSD on Weblate] URL: link:https://wiki.freebsd.org/Doc/Translation/Weblateurl[] + +Link: link:https://translate-dev.freebsd.org/[FreeBSD Weblate Instance] URL: link:https://translate-dev.freebsd.org/url[] + +===== Q2 2023 Status + +* 15 languages +* 183 registered users +* link:https://lists.freebsd.org/archives/freebsd-translators/2023-April/000111.html[New Weblate server] + +The FreeBSD Weblate instance now operates on a dedicated server, significantly improving its speed and enhancing the efficiency of translation work. +Our heartfelt appreciation goes to ebrandi@ for providing this hardware upgrade. + +===== Languages + +* Chinese (Simplified) (zh-cn) (progress: 7%) +* Chinese (Traditional) (zh-tw) (progress: 3%) +* Dutch (nl) (progress: 1%) +* French (fr) (progress: 1%) +* German (de) (progress: 1%) +* Indonesian (id) (progress: 1%) +* Italian (it) (progress: 5%) +* Korean (ko) (progress: 32%) +* Norwegian (nb-no) (progress: 1%) +* Persian (fa-ir) (progress: 3%) +* Polish (progress: 1%) +* Portuguese (pt-br) (progress: 22%) +* Sinhala (si) (progress: 1%) +* Spanish (es) (progress: 33%) +* Turkish (tr) (progress: 2%) + +We want to thank everyone that contributed, translating or reviewing documents. + +And please, help promote this effort on your local user group, we always need more volunteers. + +==== FreeBSD Handbook working group + +Contact: Sergio Carlavilla + + * link:https://reviews.freebsd.org/D40546[The Network chapter is being reworked] + +==== FreeBSD Website Revamp - WebApps working group + +Contact: Sergio Carlavilla + +Working group in charge of creating the new FreeBSD Documentation Portal and redesigning the FreeBSD main website and its components. +FreeBSD developers can follow and join the working group on the FreeBSD Slack channel #wg-www21. +The work will be divided into four phases: + +. Redesign of the Documentation Portal ++ +Create a new design, responsive and with global search. (_Complete_) + +. Redesign of the Manual Pages on web ++ +Scripts to generate the HTML pages using mandoc. (_Complete_) +Public instance on https://man-dev.FreeBSD.org + +. Redesign of the Ports page on web ++ +Ports scripts to create an applications portal. (_Work in progress_) + +. Redesign of the FreeBSD main website ++ +New design, responsive and dark theme. (_Work in progress_) From nobody Thu Jul 6 16:02:06 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Qxh9q03b2z4lc55 for ; Thu, 6 Jul 2023 16:02:07 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Qxh9p4MnCz3Hdt; Thu, 6 Jul 2023 16:02:06 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688659326; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=BJakBT+XhIYm3Sq6uq0y+xOU2MPVw3m75qqKTsJuByU=; b=hh+FGI4e5joEosuKU9/aicNPoqW3N03WGAcHlBaGU35lAw3AEFCpW1jfH9eTCs1QCJfEAs hEjhlTrHQlzVMdLqVoqOKENszsNqbA2aZbUEgokrU/McFr+DEF0eHUS03qFivSU7VAyGPT sdbbAXT4yqmbO9drimXp5EDZmMuaz6zVu19FZXZe0qN8Lilxrqbgo+cR/JJD3qX9iMrTG+ +r9SmAi9ye/fkUG3yetXHnN6OH1iqTAGG5wWJqMXQzfdryk0xX4pCXg8+BRH2PcS7+pAit uAVEI+fG0852fQw9zTwD3jmB9t7phRFPfyWSnDyW9DQ9qsJJNjXIm+4kqpDfeQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688659326; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=BJakBT+XhIYm3Sq6uq0y+xOU2MPVw3m75qqKTsJuByU=; b=Z+vnb8VF5ebi5ZEA9ynDSZYRJXeaGwmZH4CrNQ+F5NZA0IbM+mH3fRRt/s0olkfgh9Wmfs nzaMMxqem4bwnIAWk/YPF7wb4AXFlntqNT+4bmz5Vpu0Onb2B9RG2jjV7A9gSJurhT0BPx +Aa/uxjuskWSAaHSu5hEkA4gA6O/1tYW4zfcQPVIJl2POS0StpJF5bodx0P+PVw0Yhl0QW auyQz3PfcrMh+Uvh3WRkVNM+OydiAMd4qrW0sVgm1FxSZbxhy7fHQlwog2wWmQS+t8ASX7 SxeHSGrVv199Qur7xj6qnEB4PZseXjtFANsIGRqhPytapOEAVnGegs/jpPxJBA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688659326; a=rsa-sha256; cv=none; b=ZBAPh/JrzKgmCtiBMeS1D0Q9omMSlx3O1bifiii+ZgKKqSB98vOcy+eSjF5RVOFDemWzxb PJV0SfqkSdIHxgJ3h8S/JDQE/ROw+6ecZngIdkLSYtyN5a7QqFH/OTaU52vbb/mRmUySFA oEad7s+M9XvJDvUd3DmHP3mF/uV+rpZBEqMyN3NrD1DATb2jb02qX6EeeTeHYc4S8cvS+y nGIKZOCZDFatnWe6Z4t/TJ1f+jLHyqwSVbaehUMP0DL7verv7PN2Yg29b0F7obTXu5GZvZ 9qSh9bmV32wcFz3HnTYGfCyHfMBI+etHGBPICwIu8RNBCGN0MxWwfTAZV4Lnjw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Qxh9p3Fr7z12rV; Thu, 6 Jul 2023 16:02:06 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 366G26Ma049430; Thu, 6 Jul 2023 16:02:06 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 366G268x049429; Thu, 6 Jul 2023 16:02:06 GMT (envelope-from git) Date: Thu, 6 Jul 2023 16:02:06 GMT Message-Id: <202307061602.366G268x049429@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: 9427ae6f36 - main - Status/2023Q2/simd.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 9427ae6f360fcd8761d25b04dd63d1ab5429f7ff Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=9427ae6f360fcd8761d25b04dd63d1ab5429f7ff commit 9427ae6f360fcd8761d25b04dd63d1ab5429f7ff Author: Robert Clausecker AuthorDate: 2023-07-06 15:52:31 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-06 16:01:17 +0000 Status/2023Q2/simd.adoc: Add report Reviewed by: status (Pau Amma ) Approved by: dbaio (mentor, implicit) --- .../en/status/report-2023-04-2023-06/simd.adoc | 23 ++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/website/content/en/status/report-2023-04-2023-06/simd.adoc b/website/content/en/status/report-2023-04-2023-06/simd.adoc new file mode 100644 index 0000000000..db3ce322e1 --- /dev/null +++ b/website/content/en/status/report-2023-04-2023-06/simd.adoc @@ -0,0 +1,23 @@ +=== SIMD enhancements for amd64 + +Links: + +link:https://reviews.freebsd.org/D40693[SIMD dispatch framework draft] URL: link:https://reviews.freebsd.org/D40693[] + +link:http://fuz.su/~fuz/freebsd/2023-04-05_libc-proposal.txt[project proposal] URL: link:http://fuz.su/~fuz/freebsd/2023-04-05_libc-proposal.txt + +Contact: Robert Clausecker + +SIMD instruction set extensions such as SSE, AVX, and NEON are ubiquitous on modern computers and offer performance advantages for many applications. +The goal of this project is to provide SIMD-enhanced versions of common libc functions (mostly those described in man:string[3]), speeding up most C programs. + +For each function optimised, up to four implementations will be provided: + + * a *scalar* implementation optimised for amd64, but without any SIMD usage, + * a *baseline* implementation using SSE and SSE2 or alternatively an *x86-64-v2* implementation using all SSE extensions up to SSE4.2, + * an *x86-64-v3* implementation using AVX and AVX2, and + * an *x86-64-v4* implementation using AVX-512F/BW/CD/DQ. + +Users will be able to select which level of SIMD enhancements to use by setting the `AMD64_ARCHLEVEL` environment variable. + +While the current project only concerns amd64, the work may be expanded to other architectures like arm64 in the future. + +Sponsor: The FreeBSD Foundation From nobody Thu Jul 6 16:15:27 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QxhTC47NFz4lddK for ; Thu, 6 Jul 2023 16:15:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QxhTC3Y0Fz3K6d; Thu, 6 Jul 2023 16:15:27 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688660127; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=xUO5HBoPTWW1TB20k6fwiRGvyvFuet7WsWC0K13clGc=; b=BQWFLrtc9VQ7aBG+KfFfdMOn4nMNoba0HT3wZwE9tcSMb2HIng+FuNVUYLO3CPOeOv4plN kUd107dxnLRjhftqjbzrLGfpnrWRxH1tBO4ToKyWgmvp7bWPmpzdifrgECl0w6fSdJ9eLY GKtJUkANJLvh48Xkk2GjLYunakufXXDl6gTcKQMufP5Xsv+P8T9hnQIJTvKikT8HjPqmf1 s+SVlDR1SAoramHoa/L6Pk03cOMd899Y8/OIq4Xx4G9+xQiZObjzBUpaPGsGVZnzt15d+F Lgvg+Uptefu4jyi3jiI7gqBQUXVNstdTIpbw6ntmrKyD79goa2CZ/jzQagi5cA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688660127; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=xUO5HBoPTWW1TB20k6fwiRGvyvFuet7WsWC0K13clGc=; b=yieiB4U6lO+UmIBDmmaq1Idzz2TUouEiJXA8xjteWn5cI+vCSnylTLReWMtAoNbRHxZX4m b+RZjoRmRvMvhY1X1kAdv2XTRi5g4i/iNJUB9qR9fnO/o4Bjdom/Wx+3E9j7246LabA9EB Fzeu115rcWguPEPoY/vCIs8wuQhB147tCHzrKCnhtUDPB01L1abQoEoukBJzZJuyAC8qkE cS9rGjPJeqOOkRiXBj0AhNTMaAQysA3jiIIg+YxKbES90bQOrcg6W5ozr31fUlNlqoMvxa 7uVb0WtJHF1sAWJSkhK1wNpXEjZ6t9EtZn1xUDzbWCmVRle//jNZozsRGsZOlQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688660127; a=rsa-sha256; cv=none; b=HZPZu0AyjWsYB+AzBqZRRFvt6tO8ySzlBCnrZCjnhNEUJrDw7ror6UbW1ecKFJoGEQYovO RlMc/gRAxUVgSVeGT6/sPW69kHsc6qXCh3QsJx/OPHKnXHfneRdWEFHnZksUufQ9KTaiHv xsj3GXe7wFSRGAH6UX1c4zjxl/Hr9jhhiP+QoszLpc21dan1H/aTmqZRrZ5Qx0Kro7lJy8 f6Nuja3N8oOunb85Y2AlQEnr4OmoPy7XmBmatrYcvvSsQ/xAyybhKm4inMH37PyGyHJbyO t8WVfLrIYiEYIjYVNZ61g/Xpn0H4wWlw1GkiBFl0mBO32d8byaFmJTrz02bgvw== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QxhTC2cZBz135N; Thu, 6 Jul 2023 16:15:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 366GFRcd066671; Thu, 6 Jul 2023 16:15:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 366GFRTh066670; Thu, 6 Jul 2023 16:15:27 GMT (envelope-from git) Date: Thu, 6 Jul 2023 16:15:27 GMT Message-Id: <202307061615.366GFRTh066670@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Maxim Konovalov Subject: git: c1e6e656ee - main - Status/2023Q2/doceng.adoc: a typo fixed List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: maxim X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: c1e6e656eeb48e51cc4bb2f20b4040484b77934a Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by maxim: URL: https://cgit.FreeBSD.org/doc/commit/?id=c1e6e656eeb48e51cc4bb2f20b4040484b77934a commit c1e6e656eeb48e51cc4bb2f20b4040484b77934a Author: Maxim Konovalov AuthorDate: 2023-07-06 16:14:23 +0000 Commit: Maxim Konovalov CommitDate: 2023-07-06 16:14:57 +0000 Status/2023Q2/doceng.adoc: a typo fixed --- website/content/en/status/report-2023-04-2023-06/doceng.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/content/en/status/report-2023-04-2023-06/doceng.adoc b/website/content/en/status/report-2023-04-2023-06/doceng.adoc index fa6e336069..4346cac6e1 100644 --- a/website/content/en/status/report-2023-04-2023-06/doceng.adoc +++ b/website/content/en/status/report-2023-04-2023-06/doceng.adoc @@ -19,7 +19,7 @@ The doceng@ team is a body to handle some of the meta-project issues associated During the last quarter: * fernape@ has been appointed as a new Doceng team member. -* The package:www/gohugo[] port maintainership has been transfered to doceng@ since it is a critical part of our documentation infrastructure. +* The package:www/gohugo[] port maintainership has been transferred to doceng@ since it is a critical part of our documentation infrastructure. This was agreed with the former maintainer. * Improvements to the translation workflow (described in the following sections). From nobody Thu Jul 6 17:57:06 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QxkkY12Hjz4lwyl for ; Thu, 6 Jul 2023 17:57:09 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QxkkY0WXtz3mxY; Thu, 6 Jul 2023 17:57:09 +0000 (UTC) (envelope-from jhb@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688666229; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ZzEoWe1I37AEkfq3NiDKM2cp/0+2oIBccge6/Qe82bg=; b=Z5npDK2KHKdrjl/PflZ5Pe741NfeVd4POmIDM1M4WQPZmBlUK5iRO2bZv4D7BppmnIZIjT JdCr0knUNUnjLcUp5wbu6Lmf7yyEQv3xzqKidhtJjqZYXdoyM9ANSKscEVKZJES/4sHLKB 9xhCS4r9QyDe5ozgCqWPQK5HofQrv2FWJLof1xyJdCfyP0ZORBvZySAx8IQbuwDWplkogs hvYqbTulvesYQIKhED2+kQUls9LE8BZEvM//tK8HebxhSvgUxjp5fU73D7orZ/XQu5qs1X 1yUMNB4cNh6G22kTsIdFJJg6171OcfWgSNDzVx0ns362kBUyEz1I16oODw1OhA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688666229; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ZzEoWe1I37AEkfq3NiDKM2cp/0+2oIBccge6/Qe82bg=; b=TQ7MEjUyywWfNgOfzflW0bsdt6IghxN7Mz7uS+KP3RCQXJS7dI3LBlWWX6qvlcYtFwOH1n W+fd+cfGxRxhjOOo726CIbNOy49zlAfk5Tsz8ku+Oy2O9NB6MZSTgFHCkMV7+0kh8/2zbI AVGFdOAyMh0M2BqapmIuPg26+UK6JlTJX/DCjNztejJ+ELGLFH2OaND/PeiRFeYCa52llp 1C4DFHVKg8qaoaK/08DuARhl2OEXUZSjB63UjQ3rqthfumf4nG5HgGOId/6/Uow+Mm8aQ/ r8tV+JIPqpHcvf+JYzRCfhfZNfmBjVEsLbizzf78eFsksPGMXrEeOBaueKwImA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688666229; a=rsa-sha256; cv=none; b=D/YjSngIMBN18QcxNxqj+SN51rkI344SnaOvdk4VA/QjBxmWwdO3Q5u1I1ipgEY2vVLy7Z 23Jf46v0tJyjhubdGiaFLOHO/LiLAp0gM1ngqJE/T/OP9WpsYcLnfH0g4L0DVh0PtJg45b e5eM6zzA+9H8Ha0O+QIkwTRJJk5DKH/6l9W4bDkRopxR9Lg55rldVYznIaSYCDQXLnTOzd 5bNJzTBeTwKq7Hrf5Gl9/EXAEJGH+wig6ZYK/5HpeT4tEkHd3cyUCbcID1vnzYJKsixHsx j6xsz2ZdFJYk6EsPV7Rr4jyJjBHC7+9ZnSpZFRzuylvUp/VfEYMg7nqcyU77EQ== Received: from [IPV6:2601:648:8680:16b0:9018:f799:cdac:ccb1] (unknown [IPv6:2601:648:8680:16b0:9018:f799:cdac:ccb1]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (Client did not present a certificate) (Authenticated sender: jhb) by smtp.freebsd.org (Postfix) with ESMTPSA id 4QxkkX45jxzLFW; Thu, 6 Jul 2023 17:57:08 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Message-ID: Date: Thu, 6 Jul 2023 10:57:06 -0700 List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Thunderbird/102.12.0 Subject: Re: git: b113509f32 - main - Handbook WG - Create a new network chapter Content-Language: en-US To: Sergio Carlavilla Delgado , doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org References: <202307061209.366C9IeC054160@gitrepo.freebsd.org> From: John Baldwin In-Reply-To: <202307061209.366C9IeC054160@gitrepo.freebsd.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-ThisMailContainsUnwantedMimeParts: N On 7/6/23 5:09 AM, Sergio Carlavilla Delgado wrote: > The branch main has been updated by carlavilla: > > URL: https://cgit.FreeBSD.org/doc/commit/?id=b113509f32da681db41fd60594b723c13334df8e > > commit b113509f32da681db41fd60594b723c13334df8e > Author: Sergio Carlavilla Delgado > AuthorDate: 2023-07-06 12:04:54 +0000 > Commit: Sergio Carlavilla Delgado > CommitDate: 2023-07-06 12:04:54 +0000 > > Handbook WG - Create a new network chapter > > Create a new chaper with the basic configuration of a wired > and wireless networks in FreeBSD. > > Sections of the new chapter: > - Synopsis > - Setting up the Network > - Wired Networks > - Wireless Networks > - Hostname > - DNS > - Troubleshooting > > Changes: > - Move wired network section from config to network > - Move virtual hosts section from config to advanced networking > - Move basic wireless section from advanced networking to network > - Move IPv6 from advanced networking to network > - Upgrade all command outputs > - Use sysrc > - Improve AsciiDoc syntax > > Differential Revision: https://reviews.freebsd.org/D40546 > Reviewed by: bcr, dbaio, fernape, karels > Sponsored by: Daifressh > --- > .../books/handbook/advanced-networking/_index.adoc | 897 +------------------ > .../content/en/books/handbook/audit/_index.adoc | 6 +- > .../en/books/handbook/bibliography/_index.adoc | 2 +- > documentation/content/en/books/handbook/book.adoc | 2 + > .../content/en/books/handbook/boot/_index.adoc | 6 +- > .../content/en/books/handbook/colophon.adoc | 2 +- > .../content/en/books/handbook/config/_index.adoc | 492 +---------- > .../en/books/handbook/cutting-edge/_index.adoc | 8 +- > .../content/en/books/handbook/desktop/_index.adoc | 6 +- > .../content/en/books/handbook/disks/_index.adoc | 6 +- > .../content/en/books/handbook/dtrace/_index.adoc | 6 +- > .../en/books/handbook/eresources/_index.adoc | 2 +- > .../en/books/handbook/filesystems/_index.adoc | 6 +- > .../en/books/handbook/firewalls/_index.adoc | 6 +- > .../content/en/books/handbook/geom/_index.adoc | 6 +- > .../content/en/books/handbook/glossary.adoc | 4 +- > .../content/en/books/handbook/jails/_index.adoc | 6 +- > .../en/books/handbook/kernelconfig/_index.adoc | 153 ++-- > .../content/en/books/handbook/l10n/_index.adoc | 6 +- > .../content/en/books/handbook/linuxemu/_index.adoc | 42 +- > .../content/en/books/handbook/mac/_index.adoc | 6 +- > .../content/en/books/handbook/mail/_index.adoc | 6 +- > .../content/en/books/handbook/mirrors/_index.adoc | 8 +- > .../en/books/handbook/multimedia/_index.adoc | 6 +- > .../en/books/handbook/network-servers/_index.adoc | 6 +- > .../content/en/books/handbook/network/_index.adoc | 951 +++++++++++++++++++++ > .../content/en/books/handbook/partii.adoc | 4 +- > .../content/en/books/handbook/partiii.adoc | 2 +- > .../content/en/books/handbook/partiv.adoc | 2 +- > documentation/content/en/books/handbook/partv.adoc | 2 +- > .../content/en/books/handbook/pgpkeys/_index.adoc | 2 +- > .../content/en/books/handbook/ports/_index.adoc | 28 +- > .../en/books/handbook/ppp-and-slip/_index.adoc | 6 +- > .../content/en/books/handbook/printing/_index.adoc | 6 +- > .../content/en/books/handbook/security/_index.adoc | 12 +- > .../en/books/handbook/serialcomms/_index.adoc | 6 +- > .../en/books/handbook/usb-device-mode/_index.adoc | 6 +- > .../en/books/handbook/virtualization/_index.adoc | 6 +- > .../content/en/books/handbook/wayland/_index.adoc | 2 +- > .../content/en/books/handbook/wine/_index.adoc | 6 +- > .../content/en/books/handbook/zfs/_index.adoc | 11 +- > 41 files changed, 1202 insertions(+), 1546 deletions(-) > > diff --git a/documentation/content/en/books/handbook/advanced-networking/_index.adoc b/documentation/content/en/books/handbook/advanced-networking/_index.adoc > index 732de75166..b9194449cd 100644 > --- a/documentation/content/en/books/handbook/advanced-networking/_index.adoc > +++ b/documentation/content/en/books/handbook/advanced-networking/_index.adoc > @@ -1,12 +1,12 @@ > --- > -title: Chapter 33. Advanced Networking > +title: Chapter 34. Advanced Networking > part: IV. Network Communication > prev: books/handbook/firewalls > next: books/handbook/partv > description: "Advanced networking in FreeBSD: basics of gateways and routes, CARP, how to configure multiple VLANs on FreeBSD, etc" > -tags: ["Advanced Networking", "Handbook", "gateway", "routes", "wireless", "tethering", "bluetooth", "bridging", "ipv6", "CARP", "VLAN"] > +tags: ["Advanced Networking", "Handbook", "gateway", "routes", "wireless", "tethering", "bluetooth", "bridging", "CARP", "VLAN"] > showBookMenu: true > -weight: 38 > +weight: 39 > path: "/books/handbook/" > --- > > @@ -18,7 +18,7 @@ path: "/books/handbook/" > :icons: font > :sectnums: > :sectnumlevels: 6 > -:sectnumoffset: 33 > +:sectnumoffset: 34 > :partnums: > :source-highlighter: rouge > :experimental: It seems a bit unfortunate (and fragile?) that chapter and section numbers had to be manually changed in this commit for other chapters besides the added one. Is there a way to use a counter to auto-generate these similar to using tags in DocBook or \begin{chapter} in LaTeX? Also, I'm kind of curious what the "weight" attribute is and if it can similarly be auto-computed and not manually set? -- John Baldwin From nobody Thu Jul 6 18:52:38 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Qxlyb0nlSz4m9bc for ; Thu, 6 Jul 2023 18:52:39 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Qxlyb0MkYz3wqs; Thu, 6 Jul 2023 18:52:39 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688669559; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=+jSKi+RsNiNdLc/FiyIPs2ycC7LpsMpLnhyksAy8xsk=; b=bReMz1ed3LRiaOn5c8qsttI1nf+sjzUImnwqoVWm26d4OEr5uQciKbBP7sqSWjGNA3fxo9 +dlaSl8F57sYPyVq3Tqphhoy/Y9f5fk0q9cstn13taQZYhL8L1CwMH3ruaSpmbrI6U2apw fPJz7Lz2bicHGfdTwInQdSdYrLdXkNAEZf6MIi9HVjvROSrLHGex5XNkR/yx/HEn69OOD5 HH+uf/bnNUhhDiWuVHRUS5/zKm/+mtWBI0V8WhfgZx8VevnZIclGugDzKYxWHorHC6SZnU i109+6UJ7l9Od+QsbJWlFD8AdMKCUV9h3tyKV4xtML4PKM2vaxNh6inTJZewfA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688669559; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=+jSKi+RsNiNdLc/FiyIPs2ycC7LpsMpLnhyksAy8xsk=; b=UNn1C1CYHRWG1lzBgCdRXYBk0B1LBAMNd7uVutPXLQR6sD8sg2p3nyVpibIPh4A8NQ1LfY Kil+A4GLh4g2Z32JURzEZ4laM+eU0x54+Vi8+hbCOU2xCr1WEOHF8fSTB2x1PSOkau8EjN eHw/C0jCJBs6F8HU86EfjqBpLtKXCeNfgaR+w6pPtnYDyDuIGNU8b4udAEA+05U2MFLt4T TKWvChpeMB2y4aI1ct8gHwrV7I1/NuUXmIxEGbgu4f5PgLCapnENt5p2MLZFdAw6GRZw/Z UBC1nqsZde8Pg3UM/Z2oCXDCbsi0KuF0xgIVKazLmwOGXhBU9fjdfxP5UUHuJw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688669559; a=rsa-sha256; cv=none; b=eub40VwIN1BjYm3aQWHlL0S0rFlkp8opflS9LvvjDUlWIHm/fCvzFmbjQZ1E27nqGhIZuK Zg0Bxr3uszFN7V6X5vxrNiPxaJ86HnhV6ar6OxbtzO0mfRfnJmagjhGRMx9gXHVBWZnej3 M+1F8T1HGHbqHpmGel5TBZyHAVCvjD0plbi8XItnyNssHbhOMrS0iWI1qM/5o1Rapg3VEr WD4Xq3Qq+qgVX6BkTWmUo13WAjL4vmJx6QkRZEEEfwONmqIptUxR6PD67591saMpF7Dfgk sXXR0gi2lKz3xnTP7AS6ofpF3D2c2JKksYyCWUPgpusuW1ck+bvvEyIcWcGROA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4QxlyZ6XW1z17Qq; Thu, 6 Jul 2023 18:52:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 366IqcCx030455; Thu, 6 Jul 2023 18:52:38 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 366IqcXj030454; Thu, 6 Jul 2023 18:52:38 GMT (envelope-from git) Date: Thu, 6 Jul 2023 18:52:38 GMT Message-Id: <202307061852.366IqcXj030454@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Graham Perrin Subject: git: 6db2c54e27 - main - status: 2023q2: boot performance: improvements List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: grahamperrin X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 6db2c54e2767c550b36d89a99e955b446979330d Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by grahamperrin: URL: https://cgit.FreeBSD.org/doc/commit/?id=6db2c54e2767c550b36d89a99e955b446979330d commit 6db2c54e2767c550b36d89a99e955b446979330d Author: Graham Perrin AuthorDate: 2023-07-06 18:48:35 +0000 Commit: Graham Perrin CommitDate: 2023-07-06 18:48:35 +0000 status: 2023q2: boot performance: improvements If the links section is too narrow to state the title of the BSDCan session, then state it elsewhere. For consistency: efforts (plural). I think, no need to repeat the full name beneath the sentence that names Colin Percival (in full) as the sole contact. Approved-by: cperciva, salvadore Pull-request: https://github.com/freebsd/freebsd-doc/pull/199 --- .../content/en/status/report-2023-04-2023-06/boot-performance.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/website/content/en/status/report-2023-04-2023-06/boot-performance.adoc b/website/content/en/status/report-2023-04-2023-06/boot-performance.adoc index fe0d49ff12..01ecf983f0 100644 --- a/website/content/en/status/report-2023-04-2023-06/boot-performance.adoc +++ b/website/content/en/status/report-2023-04-2023-06/boot-performance.adoc @@ -6,14 +6,14 @@ link:https://www.bsdcan.org/events/bsdcan_2023/sessions/session/116/slides/44/BS Contact: Colin Percival -Colin Percival is coordinating an effort to speed up the FreeBSD boot process. +Colin is coordinating efforts to speed up the FreeBSD boot process. Recent efforts have moved from EC2 to the Firecracker virtual machine manager, which provides a very minimalist environment; stripping the boot process down to the bare minimum makes it easier to identify the remaining time and determine whether it can be optimized further. With some experimental patches to both FreeBSD and Firecracker, it is now possible to boot a FreeBSD kernel in under 20 ms. -Some of the recent improvements were discussed in Colin's recent BSDCan talk. +Some of the recent improvements were discussed in Colin's _Porting FreeBSD to Firecracker_ session at BSDCan. -This work is supported by Colin's FreeBSD/EC2 Patreon. +This work is supported by his FreeBSD/EC2 Patreon. Sponsor: https://www.patreon.com/cperciva From nobody Fri Jul 7 18:49:19 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4QyMrK1FWgz4lLMk for ; Fri, 7 Jul 2023 18:49:21 +0000 (UTC) (envelope-from grahamperrin@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4QyMrK0TJsz3NYy; Fri, 7 Jul 2023 18:49:21 +0000 (UTC) (envelope-from grahamperrin@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688755761; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=vc2d5n+EKSu6rp3H0wyZ3n4Pg2x5Al2bN1eCXDLchX8=; b=we0r18GxIVIh6jjQ2zNs5eMteZFszMViDv4Hh3/vBkdstJ5w6K/kYVlEOFzzcTqGdGDP+m 8LjAX/e1aPL8VQgYfHWKXm6daKaIhEjDmw3/JNM4cJYtFMAX+OrGru5zpqTACn4rfn/NmA BrWbJH/oYij+fMoq9GeHr8WZF/LZsx+VyqQPJu2f9XHG81URjFEk7qOVcyr7lyEIbb6tAu kap0DxRK8uEHHOa91pc4P/1ufmGdLasbogRu/J9q6ECqqc+hOLygx6mmHrBj56FhJqMszD Q5Z+/KJ83+4tnt/zJVDt7YKWnXSbnsC9SlQ2aE8pmhu4/v3j/Gm+1FEVXxCvbg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688755761; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=vc2d5n+EKSu6rp3H0wyZ3n4Pg2x5Al2bN1eCXDLchX8=; b=wL3C+phF81YDop7DipuOAVOCy3XaxQ5MonkoTLRryAHFaMLY4f4ay5qnw8O8NMPUplNEeY PVRjaLSkO00QCJDWg5AuYcfZD3Zup0p6mav4UiD2KtMNYozYwGchW2mUqSslnyGfXTql01 k16VQaexQi86ZIzKx62B+4Ghm+5d+2/q1nNCl2lV6OkFLtSqlgQ4/dFKEKf1hGByXmBc+L x7567Z90oObbuOsrxMZhCil1DEpXrG34UwU/QouXeTpjEniEbq2rXHgEiBmvH8+tfuXZRL YpPY5TwsAQGLJeYrC3jK/zjQsJ1VVEkCdJnI41nh086S1WDT3vImFYLK00SM9Q== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688755761; a=rsa-sha256; cv=none; b=tkQcUzcph5AF6TWusROlvV2TGQT59L+dzvw2S1erlxSl+n35dtx3CIpYFWTT3jND/rOYi0 zxPFlnfcEnbkmzI5sLqO9gYtFYWP9s7aiAc/1T2O7/v1fKChyUTrr5kAKAES80Axvt1YYX 7RVSQhyZLTEvYEx+yD5GqIShmGqrA6p/IccG2oy/sl+/DkwuvkDlmYj3ivgK5k72AIzvLa c8ILULZReD8HrreLmp0kkIo9D/GkhyF9Jcmw09XpdnTHtXldAMj1SRzrWNfAEJTZT+AyzL KtR2UwoDn9zndl8XJ0abYNV/B0BFTVGC81R8RCNdLnBjQFm0IZ+L5tFIHUeMrw== Received: from [192.168.1.10] (host-2-100-161-236.as13285.net [2.100.161.236]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (Client did not present a certificate) (Authenticated sender: grahamperrin) by smtp.freebsd.org (Postfix) with ESMTPSA id 4QyMrJ4JBczpFV; Fri, 7 Jul 2023 18:49:20 +0000 (UTC) (envelope-from grahamperrin@freebsd.org) Message-ID: <7b88a460-40db-42aa-0f1d-71e1a5525b90@freebsd.org> Date: Fri, 7 Jul 2023 19:49:19 +0100 List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:102.0) Gecko/20100101 Thunderbird/102.12.0 Subject: Re: git: b113509f32 - main - Handbook WG - Create a new network chapter Content-Language: en-US To: Sergio Carlavilla Cc: dev-commits-doc-all@freebsd.org, John Baldwin References: <202307061209.366C9IeC054160@gitrepo.freebsd.org> From: Graham Perrin Organization: FreeBSD In-Reply-To: Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="------------sAUPzvk7qifPdYE0f6i7ZNrF" X-ThisMailContainsUnwantedMimeParts: N This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --------------sAUPzvk7qifPdYE0f6i7ZNrF Content-Type: multipart/mixed; boundary="------------dMBd2lEYO0izDOevdtEEPD56"; protected-headers="v1" From: Graham Perrin To: Sergio Carlavilla Cc: dev-commits-doc-all@freebsd.org, John Baldwin Message-ID: <7b88a460-40db-42aa-0f1d-71e1a5525b90@freebsd.org> Subject: Re: git: b113509f32 - main - Handbook WG - Create a new network chapter References: <202307061209.366C9IeC054160@gitrepo.freebsd.org> In-Reply-To: --------------dMBd2lEYO0izDOevdtEEPD56 Content-Type: multipart/alternative; boundary="------------3m2SgQ50eWt9QXnO6n0bm0bA" --------------3m2SgQ50eWt9QXnO6n0bm0bA Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: base64 T24gMDcvMDcvMjAyMyAwOTozNiwgU2VyZ2lvIENhcmxhdmlsbGEgd3JvdGU6DQo+IOKApiBJ IGhvcGUgdGhpcyBzaGVkcyBzb21lIGxpZ2h0IG9uIHdoeSBpdCdzIGRvbmUgdGhpcyB3YXku IOKApg0KDQoNClRoYW5rcyENCg0KSSBhaW1lZCB0byBib29rbWFyayB0aGlzIHBhcnQgb2Yg dGhlIGRpc2N1c3Npb24sIGhvd2V2ZXIgKFNlcmdpbykgeW91ciANCnJlcGx5IGlzIG1pc3Np bmcgZnJvbSANCjxodHRwczovL2xpc3RzLmZyZWVic2Qub3JnL2FyY2hpdmVzL2Rldi1jb21t aXRzLWRvYy1hbGwvMjAyMy1KdWx5Lz4uDQoNCkZvciB0aGlzIGVtYWlsIEkgZHJvcHBlZCBk b2MtY29tbWl0dGVycyBmcm9tIHRoZSBsaXN0IG9mIGNjIHJlY2lwaWVudHMsIA0KSSB3b25k ZXIgd2hldGhlciB0aGlzIGVtYWlsIHdpbGwgYmUgYXJjaGl2ZWQg4oCmDQoNCg== --------------3m2SgQ50eWt9QXnO6n0bm0bA Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
On 07/07/2023 09:36, Sergio Carlavilla= wrote:
=E2=80=A6 I hope this sheds =
some light on why it's done this way. =E2=80=A6


Thanks!

I aimed to bookmark this part of the discussion, however (Sergio) your reply is missing from <https://lists.freebsd.org/archiv= es/dev-commits-doc-all/2023-July/>.=C2=A0

For this email I dropped doc-committers from the list of cc recipients, I wonder whether this email will be archived =E2=80=A6<= br>

--------------3m2SgQ50eWt9QXnO6n0bm0bA-- --------------dMBd2lEYO0izDOevdtEEPD56-- --------------sAUPzvk7qifPdYE0f6i7ZNrF Content-Type: application/pgp-signature; name="OpenPGP_signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="OpenPGP_signature" -----BEGIN PGP SIGNATURE----- wsF5BAABCAAjFiEEWT/lssMHB+28ly8Kt2dIb0oY1AsFAmSoXi8FAwAAAAAACgkQt2dIb0oY1Ast fQ//WX8EuI0iS4jXoDU4+XwyOaceUy1j4tBg4HnNF8LZF0KMzX+BYv1pr653ASC6iDo1MP+1basg +POEMhvocCNfdEnzdL60cI3qkmiRMzxtU3FDZKwStmwNX+/OAU/zq8/kGUIDS+C2zKcU0k1B7ehg kBKvgs1DiBWdtCxJoXGlXbh32wuECxsp45Fp76MMzgcVRAWy5MnvWLIHWLOxdyow5qCRSe238VmY DJ89Gcb95gA/oMKNyNwp3Y1+wsgaJno6e6IzQsFcZHYE9+wF+DJYXgSGLDJL9Y/O56AU9f83P/p7 27AYOF07J73aIdBHBjM3PwOwOW2g8kb30EAKznBe2UcxkobrIAnHaJxqwPazSXY11X1IZftjjLxT wbf9c6CPDpWPEV8XEunPaQ6f0xo62oM3jHizrPB+5r29eiudyAczCyZdPcE5CKFoRP0Gs5zBiKSV sgT5k7sUd6fwHuJHV7Z5ZEVOKov2m4cQORV60+dcBTzb1ZWo7EixxtCwqFKAGhsi80K38eHHV5lz grg60XoUKIx8igSMicQHFmRZ71/gbQXq0j+Ay7T4QkhdreeVTp8+z62Qaw6ns+gK9knl+fDjRidq gzRCQVX9gbqe6i6O0wGc2z24qxHS7+omugVrbUSPUTLHlGtLHgadagpRKw6uxi+snyg5ub4LYf+w Fyk= =i5fB -----END PGP SIGNATURE----- --------------sAUPzvk7qifPdYE0f6i7ZNrF--