diff --git a/.github/workflows/deploy_pages.yml b/.github/workflows/deploy-pages.yml similarity index 62% rename from .github/workflows/deploy_pages.yml rename to .github/workflows/deploy-pages.yml index a134ff8..90a0f4c 100644 --- a/.github/workflows/deploy_pages.yml +++ b/.github/workflows/deploy-pages.yml @@ -1,9 +1,7 @@ -name: Deploy Pages +name: Deploy Jekyll with GitHub Pages on: - # Runs on pushes targeting the default branch push: - branches: [ main ] # Allows you to run this workflow manually from the Actions tab workflow_dispatch: @@ -25,46 +23,34 @@ jobs: build: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 - - name: Install build tools - run: | - sudo apt-get install -y markdown make + - name: Checkout + uses: actions/checkout@v4 + - name: Checkout c-ares docs + uses: actions/checkout@v4 + with: + repository: c-ares/c-ares + path: c-ares.git - name: Checkout roffit uses: actions/checkout@v4 with: repository: "bagder/roffit" - path: roffit + path: roffit.git - name: Build and Install roffit run: | - cd roffit + cd roffit.git sudo make install - - name: Checkout fcpp - uses: actions/checkout@v4 - with: - repository: "bagder/fcpp" - path: fcpp - - name: Build and Install fcpp - run: | - cd fcpp - sudo make install - - name: Checkout source needed to build docs - uses: actions/checkout@v4 - with: - repository: "c-ares/c-ares" - path: ares-cvs - name: Setup Pages - id: pages uses: actions/configure-pages@v5 - - name: Build pages + - name: Build external pages run: | make - - name: Clean up files we don't want deployed - run: | - rm -rf ares-cvs fcpp roffit .deps *.gen *.raw *.t *.md Makefile download/Makefile download/*.t + - name: Build with Jekyll + uses: actions/jekyll-build-pages@v1 + with: + source: ./ + destination: ./_site - name: Upload artifact uses: actions/upload-pages-artifact@v3 - with: - path: ./ # Deployment job deploy: @@ -73,6 +59,7 @@ jobs: url: ${{ steps.deployment.outputs.page_url }} runs-on: ubuntu-latest needs: build + if: github.repository == 'c-ares/c-ares.github.io' && github.refs == 'refs/heads/main' steps: - name: Deploy to GitHub Pages id: deployment diff --git a/.gitignore b/.gitignore index 194c770..c965f8c 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,10 @@ -*.html -*.raw -*.gen -ares-cvs +Gemfile.lock +_site +.sass-cache .deps +c-ares.git +roffit.git +docs +security.md +license.md + diff --git a/.htaccess b/.htaccess deleted file mode 100644 index e32b009..0000000 --- a/.htaccess +++ /dev/null @@ -1 +0,0 @@ -RedirectMatch "^/.git" https://c-ares.org/download/ diff --git a/404.html b/404.html new file mode 100644 index 0000000..c472b4e --- /dev/null +++ b/404.html @@ -0,0 +1,24 @@ +--- +layout: default +--- + + + +
Page not found :(
The requested page could not be found.
c-ares provides a set of library functions, datatypes, and enumerations -which integrators will use for their implementations. When you install c-ares, -you get man pages which describe their use and meanings. - -
- These packages are provided as a service to whoever might find these - useful. Please consider always getting and using the most recent - version, we have maintained API and ABI compatibility between releases since - v1.7.0 in 2009. We do not create releases for bugfixes or security fixes - for prior versions, however, we do maintain some prior version - branches where we - backport fixes for about a year from the release of that version. - -
- Valid PGP / GPG signing keys for packages are: -
- - c-ares 1.31.0 (18-jun-2024) -GPG Changelog - - c-ares 1.30.0 (7-jun-2024) -GPG Changelog - - c-ares 1.29.0 (24-may-2024) -GPG Changelog - - c-ares 1.28.1 (30-mar-2024) -GPG Changelog - - c-ares 1.28.0 (29-mar-2024) -GPG Changelog - - c-ares 1.27.0 (23-feb-2024) -GPG Changelog - - c-ares 1.26.0 (26-jan-2024) -GPG Changelog - - c-ares 1.25.0 (3-jan-2024) -GPG Changelog - - c-ares 1.24.0 (17-dec-2023) -GPG Changelog - - c-ares 1.23.0 (30-nov-2023) -GPG Changelog - - c-ares 1.22.1 (19-nov-2023) -GPG Changelog - - c-ares 1.22.0 (14-nov-2023) -GPG Changelog - - c-ares 1.21.0 (27-oct-2023) -GPG Changelog - - c-ares 1.20.1 (8-oct-2023) -GPG Changelog - - c-ares 1.20.0 (7-oct-2023) -GPG Changelog - - c-ares 1.19.1 (22-may-2023) -GPG Changelog - - c-ares 1.19.0 (28-jan-2023) -GPG Changelog - - c-ares 1.18.1 (27-oct-2021) -GPG Changelog - - c-ares 1.18.0 (25-oct-2021) -GPG Changelog - - c-ares 1.17.2 (10-aug-2021) -GPG Changelog - - c-ares 1.17.1 (19-nov-2020) -GPG Changelog - - c-ares 1.17.0 (16-nov-2020) -GPG Changelog - -c-ares 1.16.1 (11-may-2020) -GPG Changelog - -c-ares 1.16.0 (13-mar-2020) -GPG Changelog - -c-ares 1.15.0 (23-oct-2018) -GPG Changelog - -c-ares 1.14.0 (16-feb-2018) -GPG Changelog - -c-ares 1.13.0 (20-jun-2017) -GPG Changelog - -c-ares 1.12.0 (29-sep-2016) -GPG Changelog - -c-ares 1.11.0 (19-feb-2016) -GPG RELEASE-NOTES - -c-ares 1.10.0, 791KB (12-may-2013) -GPG RELEASE-NOTES - - c-ares 1.9.1, 765KB (18-jun-2012) -GPG RELEASE-NOTES - - c-ares 1.9.0, 762KB (17-jun-2012) -GPG RELEASE-NOTES - - c-ares 1.8.0, 761KB (27-apr-2012) -GPG RELEASE-NOTES - - c-ares 1.7.5, 729KB (16-aug-2011) -GPG RELEASE-NOTES - - c-ares 1.7.4, 629KB (9-dec-2010) GPG RELEASE-NOTES - - c-ares 1.7.3, 620KB (11-jun-2010) GPG RELEASE-NOTES - - c-ares 1.7.2, 615KB (10-jun-2010) GPG RELEASE-NOTES (doesn't build) - - c-ares 1.7.1, 613KB (23-mar-2010) GPG RELEASE-NOTES - - c-ares 1.7.0, 604KB (30-nov-2009) GPG RELEASE-NOTES - - - c-ares 1.6.0, 439KB (9-dec-2008) GPG RELEASE-NOTES - - c-ares 1.5.3, 470KB (29-aug-2008) GPG - - c-ares 1.5.2, 461KB (29-may-2008) GPG - - c-ares 1.5.1, 435KB (21-nov-2007) GPG - - c-ares 1.5.0, 435KB (21-nov-2007) GPG (doesn't build) - - c-ares 1.4.0, 421KB (8-jun-2007) GPG - - c-ares 1.3.2, 323KB (3-nov-2006) GPG - - c-ares 1.3.1, 311KB (23-jun-2006) GPG - - c-ares 1.3.0, 347KB (29-aug-2005) GPG - - c-ares 1.2.1, 325KB (20-oct-2004) GPG - - c-ares 1.2.0, 99KB (13-apr-2004). - - c-ares 1.1.0, 125KB (11-mar-2004). - - c-ares 1.0.0, 122KB (3-feb-2004). - -SUBTITLE(ares) -
- The c-ares project started off from the ares code base: -
-ares 1.1.1 (18-may-2001) - -BOXBOT - -#include "footer.t" diff --git a/footer.t b/footer.t deleted file mode 100644 index 2c82b3b..0000000 --- a/footer.t +++ /dev/null @@ -1,2 +0,0 @@ - - diff --git a/github.md b/github.md new file mode 100644 index 0000000..95a5025 --- /dev/null +++ b/github.md @@ -0,0 +1,4 @@ +--- +menu: GitHub +redirect_url: https://github.com/c-ares/c-ares +--- diff --git a/index.md b/index.md new file mode 100644 index 0000000..a696ab3 --- /dev/null +++ b/index.md @@ -0,0 +1,91 @@ +--- +layout: page +--- + +**c-ares** is a modern DNS (stub) resolver library, written in C. It provides +interfaces for asynchronous queries while trying to abstract the intricacies of +the underlying DNS protocol. It was originally intended for applications which +need to perform DNS queries without blocking, or need to perform multiple DNS +queries in parallel. + +One of the goals of c-ares is to be a better DNS resolver than is provided by +your system, regardless of which system you use. We recommend using +the c-ares library in all network applications even if the initial goal of +asynchronous resolution is not necessary to your application. + +c-ares will build with any C89 compiler and is [MIT licensed](/license), +which makes it suitable for both free and commercial software. c-ares runs on +Linux, FreeBSD, OpenBSD, MacOS, Solaris, AIX, Windows, Android, iOS and many +more operating systems. + +c-ares has a strong focus on security, implementing safe parsers and data +builders used throughout the code, thus avoiding many of the common pitfalls +of other C libraries. Through automated testing with our extensive testing +framework, c-ares is constantly validated with a range of static and dynamic +analyzers, as well as being constantly fuzzed by [OSS Fuzz](https://github.com/google/oss-fuzz). + +While c-ares has been around for over 20 years, it has been actively maintained +both in regards to the latest DNS RFCs as well as updated to follow the latest +best practices in regards to C coding standards. + +## Download + +[c-ares 1.32.0](https://github.com/c-ares/c-ares/releases/download/v1.32.0/c-ares-1.32.0.tar.gz) +(4-jul-2024) +[GPG](https://github.com/c-ares/c-ares/releases/download/v1.32.0/c-ares-1.32.0.tar.gz.asc) +[Changelog](/changelog.html) + +Valid PGP / GPG signing keys for packages are: + - Daniel Stenberg <daniel@haxx.se> - [27EDEAF22F3ABCEB50DB9A125CC908FDB71E12C2](https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x27edeaf22f3abceb50db9a125cc908fdb71e12c2) + - Brad House <brad@brad-house.com> - [DA7D64E4C82C6294CB73A20E22E3D13B5411B7CA](https://keyserver.ubuntu.com/pks/lookup?op=get&search=0xda7d64e4c82c6294cb73a20e22e3d13b5411b7ca) + +You can also [download old packages](/download) + +## Communication + +**Issues** and **Feature Requests** should be reported to our +[GitHub Issues](https://github.com/c-ares/c-ares/issues) page. + + +**Discussions** around c-ares and its use are held on +[GitHub Discussions](https://github.com/c-ares/c-ares/discussions/categories/q-a) +or the [Mailing List](https://lists.haxx.se/mailman/listinfo/c-ares). +Mailing list archive [here](https://lists.haxx.se/pipermail/c-ares/). +Please, do not mail volunteers privately about c-ares. + +**Security vulnerabilities** are treated according to our +[security procedure](/security.html), +please email c-ares-security at haxx.se if you suspect one. +[Previous security vulnerabilities](/vulns.html). + +## Source code + +Browse the git repository on [GitHub](https://github.com/c-ares/c-ares). + +Check out from git like this: +``` +git clone https://github.com/c-ares/c-ares.git +``` + + +## Who is c-ares? + +Contributions have been made by [these friendly people](https://github.com/c-ares/c-ares/blob/master/AUTHORS). + +c-ares is being used by: + - [libcurl](https://curl.haxx.se/libcurl/) + - [Wireshark](https://www.wireshark.org/) + - [NodeJS](https://nodejs.org/) + - [UnrealIRCd](https://www.unrealircd.com/) + - [BZFlag](http://www.bzflag.org/) + - [Xymon](http://xymon.sourceforge.net/) + - [libevnet](http://www.25thandclement.com/~william/projects/libevnet.html) + - [gLite](http://glite.web.cern.ch/glite/) + - [aria2](https://aria2.github.io/) + - [sipsak](http://sipsak.org/) + - [Second Life](http://secondlife.com/) + - [Apache Arrow](https://arrow.apache.org/) +... and more + +Please let us know if you use it! + diff --git a/index.t b/index.t deleted file mode 100644 index 0392005..0000000 --- a/index.t +++ /dev/null @@ -1,120 +0,0 @@ -#include "doctype.t" -
-
- c-ares is a modern DNS (stub) resolver library, written in C. It provides - interfaces for asynchronous queries while trying to abstract the intricacies of - the underlying DNS protocol. It was originally intended for applications which - need to perform DNS queries without blocking, or need to perform multiple DNS - queries in parallel. - -
- One of the goals of c-ares is to be a better DNS resolver than is provided by - your system, regardless of which system you use. We recommend using - the c-ares library in all network applications even if the initial goal of - asynchronous resolution is not necessary to your application. - -
- c-ares will build with any C89 compiler and is - MIT licensed, which makes it suitable for both free - and commercial software. c-ares runs on Linux, FreeBSD, OpenBSD, MacOS, Solaris, - AIX, Windows, Android, iOS and many more operating systems. - -
- c-ares has a strong focus on security, implementing safe parsers and data - builders used throughout the code, thus avoiding many of the common pitfalls - of other C libraries. Through automated testing with our extensive testing - framework, c-ares is constantly validated with a range of static and dynamic - analyzers, as well as being constantly fuzzed by - OSS Fuzz. - -
- While c-ares has been around for over 20 years, it has been actively maintained - both in regards to the latest DNS RFCs as well as updated to follow the latest - best practices in regards to C coding standards. - - -SUBTITLE(Download) -
- c-ares 1.31.0 (18-jun-2024) -GPG Changelog -
- You can also download old packages - -SUBTITLE(Communication) - -
- Issues and Feature Requests should be reported to our - GitHub Issues page. - -
- Discussions around c-ares and its use, are held on - GitHub Discussions - or the - Mailing List. - Mailing List archive - here. - Please, do not mail volunteers privately about c-ares. - -
- Security vulnerabilities are treated according to our - security procedure, please email c-ares-security at - haxx.se if you suspect one. - Previous security vulnerabilities. - - -SUBTITLE(Source code) -
- Browse the git repository on github. - -
- Check out from git like this: -
- git clone https://github.com/c-ares/c-ares.git -
- Contributions have been made by - these friendly people. - -
- c-ares is being used by - libcurl, - Wireshark, - NodeJS, - UnreadlIRCd, - BZFlag, - Xymon, - libevnet, - gLite, - aria2, - sipsak, - Second Life, - Apache Arrow -and more - -
- Please let us know if you use it! - -BOXBOT - -#include "footer.t" diff --git a/indexbot.t b/indexbot.t deleted file mode 100644 index d3d8f9c..0000000 --- a/indexbot.t +++ /dev/null @@ -1,4 +0,0 @@ - - - -