From a302fa22aabb922ade087eeac0d4d7c4aaf0732d Mon Sep 17 00:00:00 2001 From: "Viral B. Shah" Date: Sat, 14 Nov 2026 23:24:06 -0500 Subject: [PATCH] Generate toolchain, GPU and MPI pages; add a Yggdrasil section Pages generated at build time (utils.jl): - /toolchains/: every GCC, LLVM, Rust, Go and OCaml version, and the versions each platform supports, computed from BinaryBuilderBase with the same rules as choose_shards and the default LLVM - /gpus/: CUDA toolkits and their x86_64, ARM server and Jetson builds from Yggdrasil's platforms/cuda.jl, and NVIDIA, AMD, Intel, Apple and cross-vendor GPU libraries with versions from the General registry - /mpi/: MPI implementations and the platforms each is built for, from Yggdrasil's platforms/mpi.jl The homepage platform count, toolchain count, OS list and CPU list come from the same data. Homepage: - Fix the unclosed rows="27 attribute that dropped the player's poster - Split into BinaryBuilder features and a Yggdrasil section, with an icon traced from the Yggdrasil logo - Link features to the relevant documentation - Load the asciinema player only on the homepage - Add alt text to the feature icons Build: - Project.toml lists Franklin, NodeJS, BinaryBuilderBase, Downloads and RegistryInstances, with compat bounds - Build in a read-only job on pushes, pull requests, weekly and on demand; deploy from a separate job only from master - Update actions/checkout and julia-actions/setup-julia - Keep Project.toml, Manifest.toml and npm files out of the site - Remove the unused GitLab CI file and Franklin template assets Fixes #2 Co-Authored-By: Claude Opus 5.5 --- .github/workflows/deploy.yml | 46 ++- .gitignore | 4 + .gitlab-ci.yml | 9 - Project.toml | 14 + _assets/hamburger.svg | 1 - _assets/rndimg.jpg | Bin 18569 -> 0 bytes _assets/scripts/generate_results.jl | 27 -- _assets/scripts/output/script1.out | 5 - _assets/scripts/output/script2.svg | 581 ---------------------------- _assets/scripts/script1.jl | 10 - _assets/scripts/script2.jl | 4 - _assets/yggdrasil.svg | 311 +++++++++++++++ _css/franklin.css | 47 +++ _layout/foot.html | 2 +- _layout/head.html | 10 +- config.md | 3 + gpus.md | 55 +++ index.md | 63 ++- mpi.md | 25 ++ toolchains.md | 25 ++ utils.jl | 416 ++++++++++++++++++++ 21 files changed, 989 insertions(+), 669 deletions(-) delete mode 100644 .gitlab-ci.yml create mode 100644 Project.toml delete mode 100644 _assets/hamburger.svg delete mode 100644 _assets/rndimg.jpg delete mode 100644 _assets/scripts/generate_results.jl delete mode 100644 _assets/scripts/output/script1.out delete mode 100644 _assets/scripts/output/script2.svg delete mode 100644 _assets/scripts/script1.jl delete mode 100644 _assets/scripts/script2.jl create mode 100644 _assets/yggdrasil.svg create mode 100644 gpus.md create mode 100644 mpi.md create mode 100644 toolchains.md create mode 100644 utils.jl diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index b4ba06e..580d081 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -3,10 +3,20 @@ on: push: branches: - master + pull_request: + # The toolchain, GPU and MPI pages are generated from BinaryBuilderBase, Yggdrasil + # and the General registry, so rebuild weekly to pick up their changes. + schedule: + - cron: '0 6 * * 1' + workflow_dispatch: + permissions: - contents: write + contents: read + jobs: - build-and-deploy: + # Builds the site with read-only permissions, since it runs code downloaded from + # Yggdrasil (see utils.jl). Pull requests stop here. + build: runs-on: ubuntu-latest steps: - name: Checkout @@ -17,14 +27,36 @@ jobs: uses: julia-actions/setup-julia@v3 with: version: '1' - - run: julia -e ' - using Pkg; Pkg.add(["NodeJS", "Franklin"]); + - name: Build site + run: julia --project=. -e ' + using Pkg; Pkg.instantiate(); using NodeJS; run(`$(npm_cmd()) install highlight.js`); using Franklin; - Pkg.activate("."); Pkg.instantiate(); optimize(minify=false)' - - name: Build and Deploy - uses: JamesIves/github-pages-deploy-action@releases/v4 + - name: Upload site + uses: actions/upload-artifact@v7 + with: + name: site + path: __site + + deploy: + needs: build + if: github.event_name != 'pull_request' && github.ref == 'refs/heads/master' + runs-on: ubuntu-latest + permissions: + contents: write + steps: + - name: Checkout + uses: actions/checkout@v7 + with: + persist-credentials: false + - name: Download site + uses: actions/download-artifact@v8 + with: + name: site + path: __site + - name: Deploy + uses: JamesIves/github-pages-deploy-action@v4 with: token: ${{ secrets.GITHUB_TOKEN }} branch: gh-pages diff --git a/.gitignore b/.gitignore index 0804690..5177325 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,6 @@ .DS_Store __site +Manifest.toml +node_modules/ +package.json +package-lock.json diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml deleted file mode 100644 index c26e6c8..0000000 --- a/.gitlab-ci.yml +++ /dev/null @@ -1,9 +0,0 @@ -pages: - stage: deploy - script: - - mv __site public - artifacts: - paths: - - public - only: - - master diff --git a/Project.toml b/Project.toml new file mode 100644 index 0000000..edc7fe4 --- /dev/null +++ b/Project.toml @@ -0,0 +1,14 @@ +[deps] +BinaryBuilderBase = "7f725544-6523-48cd-82d1-3fa08ff4056e" +Downloads = "f43a241f-c20a-4ad4-852c-f6b1247861c6" +Franklin = "713c75ef-9fc9-4b05-94a9-213340da978e" +NodeJS = "2bd173c7-0d6d-553b-b6af-13a54713934c" +RegistryInstances = "2792f1a3-b283-48e8-9a74-f99dce5104f3" + +[compat] +BinaryBuilderBase = "1.49" +Downloads = "1" +Franklin = "0.10" +NodeJS = "2" +RegistryInstances = "0.1" +julia = "1.10" diff --git a/_assets/hamburger.svg b/_assets/hamburger.svg deleted file mode 100644 index 233bf21..0000000 --- a/_assets/hamburger.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/_assets/rndimg.jpg b/_assets/rndimg.jpg deleted file mode 100644 index 98be38d7ab67b4c9a149370e4abc9a2932881c85..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 18569 zcmb5Vbxa)26E=RhyOb-39&W|mDemqRcX!vKJ=_mC+@-h_O7Y{MxLYZ11&S96^!NGZ zO@7Jy=R2EhvYDMHo5^NoGxO}f)qg($genTk3IHS|BtZLr1Mu$^V4&dSYDeqi;pc5* zCraz+>+31{?wyT?o12Hb4_APbi<6t3t&0Dz40KQH|Mf{KQWf)2p=pHh+#fQ*EK zf{ccYii(Dcgo*+{LPi0g5}^^(@yMW)&}&PDB5 z%X$B24@3g|-`M}h9_>FB6A=Iz`9Clu)c>acBS^?ZbUY};GW4h<+E%jv0hj(;2jHS0 z{dZUtB7hX25QEk}5nvtJ<%*<8w_BojXtso3sBNYP^wEeMZDTh1AeydWufgg!q)TT6 zvsvM1?~-ub$R2YFEqrSQbXLAJWQhL}ZE#<&|D=VDN4&Bv7>fr@<3}bsd|ousgqCD# zZ#qV{6bR@NY1`N3CySC5+tSB}JF6`rJIz8G``L2pq4id3tQIbjO<*XL%aIR!%H(_- zBT=VSrBuZ&w~$m|Q=#kOHolvz>Mp9SB{NV?jL%9*MT>df&$iU{r%HPmuF@cbLqhAHrg!ggV~jcx8}+7RsDNZs}k`HAN;AjBapd^4$<@!%uo0x|Atpg1oDu zOKLV5=_IkZ#tdaURnhffW=cX~fyp}g4Lb;g&Pc00PKlB}bQhDFdFzZsK>J15?BduS z>-l6Amb^Qi((rS?zAG**uMi;x4fAVJlpXM@zsulK7lw*M$;$SjzTh{Q&a!X$<#l+j zOkz=p(&sBk=O{g$P0_G1C4aEtw`-~VnLBKW{f?)zR$h@Xdr8Gh7WFl>z9N-O8&s%I z2uU{B*IOmh>*gOS7KMIcJgk-WnR){t&9IS2UmwE)RxMv8nLCPlsW-w^KG|hp$6|oA zy($f{eao#O4;3vnN$^qQgQc22z5C_nSuiu1Tq9^VE~g`p>`xt{R&}|~p86J7mrqOA zn|>-GcUByGRuUz_+m}7+Rhy&k$tjbn9b0|Dl28s zaGI@dXSYsBek_smF<{6OuE}`|zA^;w<}#FTC-vA>DOkm}vh|3Np#}ei`m(-Hge_@* zf-*o>W_$R@4R8)t#*&~LMjbIcxzU%%KPw**=`%H*uq$z4ySc<4H zMTH2m*Fpi4tkAApVI)n@S?rQgXgX{SRdVfm^|?d(vcIg(yldc6*C4`lA) zKgsms`PH}dK2*10OVUM~09JrIm#F7ZR9y=0bYzOl10-ab@vMwOV&)SQx#c-x2w|aL$G;Bt>YqZ%Zbw=sokS8b(A_T--FbLew^Bg!GEYmw;f#yRJ^jD zxWxac{=L}H0k7S=1hCQUS^iwj3}&!hTCNhKx;7ypoQPt}9g37<5&j1VHe@_TNFgyV zRJ?J+DEg=ytFJjiaSGqy-~Da|M)^Z8LkY$b*?^;cdsqS1SG4AH>1t)~7!mU&GFiiH zVEEfN%`+Q^8P3#9=2A+LBT36{d>q%8K&^7-01>bR#+3TxYx1JY7lQ=2Yck3uQK~k! z70raA+5>!bPH_1txne=>FsyO{JSC!^Y~)KJetUjt6f#3;I*bB$BoC>|{9P6w#9))_ zdV9aOo?{WXpx;i^Ys^qdA;MKN6)9|9`at8ohG@+F7}eM|%lI_R;J%_IFU%m1l*ZnV zAH-a8vQ3uUkMBQ`&||rpoIcj~WQ>@u1V~ z3AHObxA$LPaHX!4l?c+1Lc`bx9Do`et`ULU( zAM{sB2uNNb@9m7Xe(YeS4TA~~M7vp%N4CN!@TcFr%cK%ktMc}`DM1k%#g~oQ6rzScJ5h+UpK>W~CN!|Yo|5=X6k0dGbSRC)~ ztD5rbEI97V($LTel41toD$Z6l{Bop@+Ms5Kl9GeS)i7sKNcBx2x4o}jemG_XMGZRCZcqtSLPqK{_rI-}0i#93*h-I3Jd0v^W$<`83 zCmtFLMRh%T6KH(P?RQ~CPCM4yY324Rq#kQ~x~LQ^@@culnG8|d96*I>ta#ig?OfMs zGT4BHs~RkE94gP&w~FFmt)&W1G!tEM>+iUaXvu9>2_Sc8s=uC%#hV+fNjus&=A^O< z;e$Kbao)kNUtI?JG(GAj{ZJG|3owl_ueW58@uhcK4Qo;D+ucuU)$tmipT_KD*f)*H zxxWx~TnnanMGb-_rj$o~=X$%Z7#h7oyMo7HR|-v>=X-Z-u4;u`-lq3Jfs|zr+ojvl zpbSdSx`xhI=L>8FRgy{Et0>4}@#^}j@mRVk!q*LGBu5 zijX4+XWzVQ>Ui<@Y)UG)gwKr0(n-Vhntj1(-rA|Z0T%>EG4NxUqHB&TvefyBrW*r^ zNp82B;Det12NvTEg|rQ?=#8}C!k=E5>eUPUx8%EqebMZNkLm)DShFTx(n!T~QxA+| za;HQZm5|vyFNVh?#u){iqW!Snl8Yf)#Dn&^JBO{mZ#JE=7<@!8Zr-YiJ98UrAhAus z@@JgwBx9?cbx(3d3r4QLi(iR>-Q&2c9d)D%B$6F?As&o356_`Mwr)xceya#Qz58P ze7Uh))x|4}!_)ED#{;cItjb;(`_qQko)PL%rqI%N9ECwwF|&!HHF@87&jsuD ztC&p3m%y^@lAx&yp2+6tP2%BPn;DC|2AFX55AdR^UqQYA=0%6{XGZt%swLV~%b#fG zqghC^M9P@u*=^umh<;r}a8pH9vn)6Q$|l0z$e%2G_(SCU*Fg>|7N#LE6a>QEPlYZR z2l77skPp+6{?z3?kP+|yXq85$sN-W=k74UD_eqeHTyns^;N;0+5p(@encnb@%m`tp z;RzS_iHTbIrZVr`$<3K%5=tWDf*vr*;l+|+Ey@V;b{Rh>HuiH2q!RcB|Atr>QM{R4aOcu_-#fjMoWOQb=Lug8 zd!lxBPtp|+m&Gg{|Ezt5@zJ-SHuL2Dy5F!LTLAnWGv^HLKY)gq0m?}5`zPwE`?jtE zY7}|VcV+StgC`FSv96}t?9eC7QI&jJV>w1ehp!}%71yc~BT5CV6K$R=g{;FmzlI^? zt0e*&^b{|>bQP=P{l$U082!4Xnh?qJdLn1qC4@qxKUx6U?V@tIg5C1^(&zY!w~e=w zz6Sjrvb}MyNlJg1r9ur0t2)YO0yy_0o~5*rIDvAOok~zyEN@M(r((Cx3R_XX*=S66 z#_IxCU8Y-~l#cMkJfP#I8w*fJvlC`H{O`?}_I#>aC61X~T#nr`2m zh`x?Q8ybMl@q;$5puAYOo&$1?^uYK$T-%F{+1Hq6vV*HLsE<yONZe_v)a zJE+~-y=sh2H)dRCSUotOuS5H#)ZwcuY43jj18}MZzjq-L^Y6GD=J@yzAfydnPn}Cn z{{myV{j1lP9D(!OHY*)wln;s&v(!6aegv|>2K}u3&_=GN*c56B9o-$iun?xFP6RT4 z16gM)@8KCL-MBV+aJnDTlENt9HJ>SP7Eq~OIBWilX;!O?4PP@BHpW8_f1o*`*y8?- znGR;#BXfOX%p5&*dGltyXhXFFcJY({Z;0KeV9aSxZb?lOqps&TCnxIolEAOm$ioLi zNdAfMD~IdxBGX5fq2cXZ7TijTTp6gsO3k;x{|?OdYH;=r7{lD4jHqjC~C z23PoZVjB>@?Va$9nx8zR}eo_WR{o*Qw=2 zwYH18j|X+XX%_zgsZ|jGvH6kt$A0Ky(gdn%8v8zR?YTQEH#Fu^Sj$rrL%6KiENLmF zsWkI@fOo+s+o;(6o1uHqU#;X(jcvVl^$#bu`5Eh$cH@*os2pangsAW3 zmFh16ihlrz)6o2^S-ih1H*dHCc7N=_CmsxxW&zkg09l98JNtZ&qm*41f?T>A*q}oe?8e*!&v>M&Sx1B7SA%9!g#x?n>3Dv(9cGn4b8qP%&C&xXXMCKoz3Z zWfI#|Tze9bX}(QEmkJGy9O0h!R%ZLvbMU2b?xHS_)amCvB~b*%@8kB;JD%|Zt-LY9 zcNo#!{Ua&i3NGdzCa~6t3LEuEvz9SJ@q(zV~bJCU9Ugx5pQPyOUfNY=E z`@asZLi!64+bu5*ml!x9DPh$a>wV z+h$1y2M6IaH4Xi><=ajQjEk1seKEAQpipArX)*llrrADo_tC}!bSGk+&U>Xp0hlZ| zN@h2oLmJ>{qtU6usG*}#lu{_hF?LpE5}OEU zkL@8W%4%ZC`73HGL~o>{hBc0Sx4f5Ms$evfH)SkRHfnInO8mo5Q_2>fnpFg2-*F?m zbP2`2tL@%%RVR9IV>J~%=1FSsn79EI?Uw74lWpuj087|N>OH?-SA2*1yo>`!0FPoW z2NO#5AoX44V#B-k9>y?1AXg(*7pmMTB!J>lwR~~v6Pr0$J~Qumbs|!7#AixYL#`sy zdcNavPtskrqui5Zy@4&KoLjM>Mcg*)&u>RLaspg7bs|W^X{;bYA_}_`Pj& zaB(t}-CXCVA6@SAo0GUZItrAtS-60qdX^#HXblCv`%3cl?EA6?8)D-Tg#)^T42@Oh z5*l~sEm@cPf)9*Ml-{2+-V`FGc)f_tKMCxi56dl9tFs;kHU3~}(w=A1ci^SwHtu1E zeJaGyvf$!hxp`1|$B-8*Z)o5!$PjC(b$5&j@-o`SuVebe*m&DK3?ZSD{5tR(`K8tQ zA7Gd94tdJ+(v_^-h+CFrrkd7&hSmpiPs+|uLzW`YsKH*)>&C6nFzlnw=APCR>e{V~4HgKLYRBStRX(0He^=oTa28$u1 zgN6bQ=oZ5{B^bY>lA3P8;df@^ePJ%SmLk0+RfgO97gT}mb%s%o2uyh7A_N7VYKGcW(p`?-2~cjsxz_OdZlN9no0XB z{&lxoYZ2>kpuc6D!4WQj$Rq7tiSLWWnL@$oVwgW{&<0lqv&04)u~Ds2bXLWitUJg2 z#^3RFqsV$dHnHj9Xq7fbO|=F*!sYde88~d$HI?nGS~u0}Y2|&4V@Rv0iRwlR zF8VLeuzL&tsf7ByIdpQ=sUGpP@{DC(1}2_72E}dC$;=d;A_1hBdqB=~HOh*Yyn<_i3Au zTw*Z=MSpBfi9Ziyr!c%e(a0S7yGs;KCpqXD^30n z*ydXWs(3c~?Q>ji3V%?)|Ke8O9Mt+*h?~RQBvHp{pi;dn7+lqXU+%ta(qBqd*^Uph zZ3yHTMk4X>+4M)wI)y6amj-#BKE#~J~%bd_1?IPG|UQ$_YLsAfhvRz|pkC>4V_ z?r^9KhwjtE2tG!FW)0Hu})DU8lOd(T{yrE@1-(G-jRAflcpjCs{cfOR`K6 z9$?!{$YWwu42?V1AZV%92V{`rHNIh-?f+gcY5+JO9=q>%tij$SF6UEjtX|pYHRZq` z?)pY;AA!^6UB7`*ML-q2FzpS=3}&_fwsAS*ahlhge)4X6yzh0O98rRM7w*Ji{t8Rs zmgjOp6U}g*Rh>Mnx5laqSef12O+pf2&|B7UNvKO0HTl?FEJQZs0mWNQYM4wi!M2eS zOX;|oh6kG-?Uo-MePsvor01q|sH)3h@rtetW;mjPzl-cKRr*wPR=dxcD@46n#4Q(= z+^tJqrw4jL3s*?g)-q&6LbQ0YmV84@jYeEh>f^z5+<-q4r}behRzjonajw>qk@sUF zr2haWeLXFGEvpk(AEb4!-uT0H6lqFm=0A73sSJ_lT>JpiS_1Du+H1vV;D>fH9->f|o2r-jGQ zpd#)EL_qC?h`Fs zPTr2i)G8XM7d_#U&%mgS`79TWE-Z!WJN_$tv05{S(u3gC@Mk_%X#{J*B3UZnLIU6P zuWu#vwd&ew&ZKoLmn4G$=P|VJCi6m>N(|dh%*6DVS*-{Y>Q+nn5snj+y0V~=DJw`2 zeyzB}-hxs$DAA{lAfKCzM$WvD{s*wg`eZH^o7O?X{>jeitpbR8nCgqJx%%eu)%p<8 zn`z?YfpZShpGeWc`;giCYIUmU>73~sbztuIfPT1U7Q7Y1)TUaO%TjL)bJF1wpu3lDregy(%Jtk%C7t zK83Qjy{gWy5&FV*g+zb2&6WSC7X9s&`L;1W{_b1_?A*wiQ|g2h$wi+#kyRB;o%}ax z=!erqtDTK7I0TS~Gb1cAEpBf24XuSyT>|UtyzA~3%+LZh+T8VN?JW&m-B%E{wLy#Hcez&WS zG1=?C433{%no97QLhp9EBUP#Py~7C>RqS+M9Uq8!@zJr4T4qcH97QF>q+9db5gzBi zmdZJ{RRe!rPfYOisG!7+@kGiDp2$Z~W*N=62S%69{;{Ou8Dv36kL0}XW1x8^(b zN6W5Fjg1`dl@!KUhD10Wzzb|X(beUwfYfw7XZus8oGWU|WbJ4+1hwvI1uA;-Vz3Ow zY0%MEaMcN<5#yAg?9sE_sPS_S<974hfum>mESwc_kH zarao_&>!Sr)1)lW*jbI6IgIxyxXNumHWRo`x)&Kl!IXO%Aaq%c;Lj!OBN3I=Cernv zRobfsAj=+Is*3+)zs86N;2fEv`>%kW0b+>NYb}<|mgP(Jf$UN2rp}VTF-?{|X|zs9 zR>pEH26fIhPfUDW(9@jcTam24u#q1w+2GTrbkHoyj@COTDj<*C6~fVG zn! z+lJBlCNIm7cq(t)J#%ElkuzAg|IGtCcW2x-CTWBAM+0y_0HFVwpWUeUT@D*?0l5G{ zF}NEA6L&~DZuMm=OqUV6QQS=7QK|k3V-ZA6?RN_$4xMfIBS1tq1*XEI&*ay6tBcw< zH;0g>>mUxQ`5r3E(|m`n?ul-B5f-1q zzn1BU6V-RCbGEl<3sh~xE{?@{^=Nwm2vi5EZziyJ41^fk&VN&P*a$`}PBpc7q`!Z1 z3FFsMqtnq?0#mF9VW8~$T*;okxnXaahRgN5)klC{t!C8p7;zAGqJ!m2V3Jp~?qsqs z!i{oPu`d|zKmB%dH`+C9Q@+*3KWwO3Gq=yfOOG{{hUC6mnSUBNN{$JxT}O#w=_IUz$u=ECU@D zc9p^Qfm=CR-gQb8xZzu3w+&U%kTC$6Rf&~kMcf|t5M~Rhy_wa6FQ7#@B#zXxjU5=PyzJDYWCoK>+fI5CZ;zLqlbktOz zAT;tR8fFUt(#zZoGNc4&NNye1Z+N+|d>n6;ZR4x2+B=jCLb<1yk#MekR~E0C!s-UT z`B))O9P?ER)&L#v$TnQ z?U@OlIn^a@$gnb}oZV}R=n9_Q!fYbTM+r(0e@I3j{ZQx-H5)SjsX*BlU7sLlLJ~dV zP^rvH09J$Wx_#&k?V5<6K{?v%pbX%^678BF8$=S8Y>v1X-1~f6`R3kL`Ueh8sP7Bg zCp;BXtQ^)Gexl+D(bP_-NcUeWs?aHOx*XtvJ=+d%v;e5hVG~v?A*TK0ACKGisX$Xy zOc7ZzZp*y0bQ&;?#0){o9DLy;a={bGS9Q^%%lb*2X9&2JghzS`SDE0KhCFLmJ579@ zVfOvlVn>~sJxK9qppkme*WJ~3sX1RjHOP1^uhd@z1B4sR?FFA%uePgkUI~sKy5`R2 z9p#lVvsp~oi+?VsOV!Bg9d6q;-Cl#!Z>jSUftgnsFn{q>kT`2UVUD+3J`1UJCs>;DYS9M( zaPjLi00X$9)OYzSjIWI1D+`e+W?et+W#vGz7;!ox!XC5pqY`|4bG{#d%49FY5g7jf z$2UWBasiOG*0lPff!kxH7pFI$sI3C{1w9y`;xfs7ObSxUg~^RDnKQ%#S=JZm(}N~& zUIqD_T?}g$+c(+ZYz4^-MU?gSr}*UECEtX>I7*i>TconY=x9=RUdw}2xtZ7bP^bP4 z8`eOkIa?UfEfjCLB67^$37l3pHW29pxtLZ&!8rOV(#Z(ccdE?((w@=3d$f5^+Bx*g z8uK3z)>^dbEc zW)o3m41SJ0=Z@%)53I}CX7Yv08AjfsKB^bAe@ZP+?T*mY@d@}>w7Lcuu(dP@*0Tn+ zU|GKEs$f^2^-c?#-)m6J&jJpPoW+ajDDhqw5fk5*A=djRNC-vCw_!!or94T~OzH6q zw>S?1l?$PQuo$mHvlh#S+HCok;LN|el{uKy?51Q!rSdelVIt!f;c)c4gdf80ZxugH zbXt}M1h5xv`cbt?vP}@hT_ZLtV`F&s)S0H&*9ofP_!zL|*qS8Nc(Ei}pwoc?TDD&n ziBHtHTY+&a2cFX6BnU7D^=_x9GJYj`T~`9QU~-#i3u2QA3l}vkJZl+6>jZBcD22Vp z@B0Us=}^t65a-5fP-9xIj+^UxpN5`1E<)EM@^~)0?sPp7UZ!urg2P631PHg@(xj@{ zkZ$cNVCU-`%uVki4i6W()K8SmSvO5Y5+Vi=$?iwuE3m2XCkeS4HkgesYb%T-0v~W` z4A0K>SZ$&6MC^}vwD^NxKa>iHeauiU%Z@awGUUY&-nWbV`L-W(L=&ekB;9i$9kREc zP1`BlnR(`Z*cr7?KJxlsxYkzS%RFDXOmU+A%nPs0H?cZ&+dvjlT8t2L==6!&KL6nN z;&FUr(8Ve+vbsSrqwzQ+b9tGh@8ZJWWO1Nhm3=+WvoW*1@q~@FN{x}zieoeq=a*q@ zI6v}J2tgJ6dMh#gcE{k*AanBQ6^8%IGEx+Bf2sQReVpd7{!k$@0W%Cg1e&#;B-RV3 zNESua(vaMKyi_YSMoF_i@3a!*YZKJ{o)x`%8MPh=+Wn3naW&AFyty6nby#)Nd}#nE$l znlh4XnP9=xnBQhI>mP6&9Z>c>9SqDY#{+m+6m&pGT_ z*)lDPGH~>nN^F4&^qAgoGa(qq1CLbJ8`y$04>DXmEtY-Dr0N|Qq6FTS`oAOVulIlG zPK(>WiXOO@KGkcUamPavGalVJ@dNG?h$jp&c|3iDMWz;i4P9;;c_2DDzOL-?Hdf|H zFPT>0LmUB_q3ZmpVfBn(GCBL~KDdBtEdwbofFey5_sLq`9wXynERtm*_MGiw$ z{N$%wsnuES@tNH>L2GtO;7w%2K~y(xaCVHX*TB~M(}!l0^>R~@AD8*eehlM2kKe+J z#-vmX9cc1fkBBkJ6(((cdNWMxk;7(CL$o!vViZ1^b?5WHu{r7IdTU@winn+1O&FEv z+;~!%qw$AcszWBF`v<|Dl%Gme8gKkJ_fj6KOkibnJ%RLz7fg;rayX+9^5>aIp6Osn zOv)lxz9U^^U$1ol<3YR?-XQG}1mx*8gHdS}x4VWs=I8Mg z(*}}EJ;v2{%Naj5nBO3f>-D< z;o`qO2g1|Ceb33fdBlANMBVpNO9OeXN1(l&|3nM9Brwl}xe0O?f?Cwam-4s&H z1|4+n)sQ*;10?D&(!h*Q{U3P7wl&=d*+qFv>_wz0jxOgD`wHB0fNN@>qCe&Q$4d)) zb-}8%$iHJ3VJO<;3+J6kK4tSM`r5Xf_hTEu6OxK>kJ>Zt%yGRJzJz&8x@7p2mk~9y zKFd=z5FrS&?Hs>4t7Nmo%0Un>)ee_#aOz}^&hiu&xrV}g(7vC93t#PqvhCccpSRW& z3B^8!cYj3g-Y-W9jh~N_YKJo1@=gXCJ;yw-AgW$%$O3AqLKC}S(kf;WZ)V|GAXuW` z(J8&?AQed>64WGhV-bY6x87|F4O}ctWo`Bhe%3X*sQT894gET=Wa@4@+Xus_@T+pw z)w&sV0%n}*8&Ic#qS9Bb+rG>sWbqhb`ddXB`O?sk6@P0pHFWrrU+G#%=bHIYbFw_7 zcT+)`N{dS@>ZNi`)Sn~AQ0)YdOHj`8+MQbzDo{pL9W?X-B z^_Zl!MgX^aA~R}7fAtF9CN_RDE7i}ZGushN?mmAi3@Ei;u04I&W1fvU{em`r{hpt)CEq9K0(r_0A^N2tRf!koNUqE|5}P#!r0_{o zw2)+HHx64AKjysFwqN207rq}8 zEz~I(;Z>O`%mL1*xJ9m+2`#I;B8bQSYgGcqU9a(3vv1?Z)@&%eN&9660Jnc{|Asxy zeDnakwm3Auf(s!d+?os`r`r@T=`;wE^mx-$F96J#Q zKVYy@mhkpgRJ*UJ68zEwxlFcHx_6_P0p0C=y9F&s_z`cb7{R399z-|mQON7Az97US zT(#!~2SPBeO=?vQ|n=B&hzbR7uLygY>I{NTx}>o zH}J1mK){Dmb%p64r_wfC2N~&+d%!{FP8n36q;o7+x83{$g&?&M=&p!=5SQk`KS1{$ z1`Sir_c=s_P|@2_F)sg0I;AmgUZ28$0OwYm8v8ZN+P53;NBGD9xPSM6_YdU;t?aAU z^GGNx&=Vb8r3kDjTYai#OpK+))Zpc>BaOEiJ!_P5)Ntdz(ahBEl>MHXm&Q1zpU|St zx!TY8lg(`njj~PrbjNwAmBshCmrVp08%r+1=2A`G^-(*U^4 zsBTQ|`J^ei=S9+mu1Kvhvp|S~MqpE?d828q%u+5uSKqaYRiO8$cD)cq*)AmqPv3ll zHmeg=bY05+0-has!8JS`U@hYR55N~PNBst(z_eJk17>3R2lxkg@4a2Jch>+y#{8$p8KJC{bl}Aq>e(v>)BJi`DAK|?t{;5X&B;ZVxdV(qq|1c zUDx_Qs4frR(G6Grs{cjORkKbsrTa zg3i|~poJ+-i}gr3uQt zK)}SEphsMh!7KW_f^b_^Fv`9yv;7-d+a9I`&Yxk|sC|h^9Rp@4eYQ85izz-o+HyL(h}J%3h zF$<=+B>$%YE3N0GBi{8dwd9|&gLMfbo42_(QZ?$%xn0!$i@tONL>JqzzTX%$zvq)R zlt&y#(@j2@w1}kZfpGW!BbkWlwIv0OcR8e2M6f1~afh%_iI9?4dU!uYDwp|p4-K^J zrO6DHo~z%)Xzl}+KeFwwh zurO-Ug42poaPJd($~+8Gb$`zM<>>a&Dht%KtH_yN7$KuqfjDk6YJCNbX;ExUhY=&C zYPL`nys#AUo?>)<;!MxMBd*ji)%G-paLRD# zfhVyGyTPb7jIEOY0N+RplbZRxHC`~2gjdnnFva(;eWo0m9oOp|m5y<%2{TkxO|58@$Lc3T%@1Mg};^4A||*TxR~LByL+T zNF2hdbSwACxJ+M-7?d?LW6@;Hj;_%{q~}NkR^`YVliBB+2>(Q}K1Y4VE#3yrCG|x* zl$)S{)EPYZXgTT8Xz^E3eFu(&&s0NIgYo-X6p~2|KEAI5frz4wQ++a{C0W+qY5rcu zrt|@|bx8yEpMQt^eK^eiqzyDEdW)l*qYqvh*h{sRs*zm!ik~j>G2qK+J26@k{S??8 zSB^R|mMS=erc+e7rz2;LgNx&mF{mQVo>zt~e}KVu$7^vfTAnM>(#=Auq8p}ao2Vz| zz=kRImHDs!7X}jZ(-lG)KMsQsl_@sX=WmmRmMIEhe|_W+AxY2gnR>sNCY;YN;cMU5 zVuua9!mFKWRGYs%$wSbtE0`zNv2(#<32-{ab2$1JQ-kiDyO^zZm&m%yN4@6#)b&qo zz9~{A+1r?yx-Fl$WF}JJpEa`EqYS7Y+$?iujTs0;>3KI96sME_NR~ZPh6C;b1e!ev zKWt%s(3?Le(NdP%N+5~TzQFhIISuhd2b>*VD>7{SSOGifXAk1^ve~>AFGTh|o%FP(3i6sKKllTDk|0V0yG_`dCSRecQJuxk z^aQ*?;5dMVu@ODXg*xtpqKVti_A9-abL%5J*|!~rOuo8FY4$e{^H_YoFxXGHbpwX`fO6vz|9Y2gtnf|q6sYOO)JhyYp;(a_O0 zN{U4HUjtM9uPN&Ls=%|zZ#RGan48HK4=5T7Peiz>RDSV2dWjHo2^Ouw&o2J~L@Gr8 zBVp=_iOEK`#!lEN>^vWBLLV98)W5H>VeQ}5iEqLP-A*<5{sBZ+@)2SVzH~~3^*P_Q zf1vC6o_G*XwKM0g%?D_n55o>UnarSZn z6h&hACi$cMQY3RPXtX%RAqf*G#BH^U+myfNS)mcB9~Fw$$&jN`SjJPBJ8zN#dt;u) zx6lY2iB=|G3_Fgw{a1m@{2=Km;Cf8n}5e;?vF@S{4z|J>H%`Qi12?JrppfzW9J>Jy3$ z=R*4H-6;Df(Xy;qL$#b>)Ay~)sE{*$1%5hPEe$N@a@NDj>QVG+yC6}sap(lM?Z;HL zxd?9EwYDjtB{%t(ywz5^Pgs;Zs5GA8M+`Lct#fi-sB@D}e}wSWN)Vj8$(#)?@H+zk;zGL z@T47sLBc#HWMRxU$2z3tRVz3axtw5rb6|>Ho*_heBvMd;+Z2W39CBl>ox(e=e59Cb zvcWi>-`AW(!uX9vrjXbOV#5%Am}{X-+8U(Qa-HRXS}XNhO%?CF6?il>>$Glb(i97B zMb+<)#TrC)@Q(C>hZfKGy(}x!84HQAUs#*{*Fksyckdl0rFODsvq_GP@Q!z*7VddG zQMbEjw2~_#Ma_UyUGa;gmUCsbyMmhmaEgf?D@veGkgh#b%aM~tE`k~?V*geDLQ5uFtR-0i*&e)-< zOP&dnMd0N%K}*e@V~E-%URS!WJ)Jq>`T7gGB2(dy&9PkjA0(i@tY@C&ZSfSbW%mjH zB)+ce3z4I5-=>7;&cDxdB3$2>L|$-Xp=92ZwkEd`&@SkpDGj;z*xmrW(&{vI!d~y( z>%C~^DP`P^)3e+y@MSK70|o_r-|YU_k-z1oU9V@(`*?wo#x3gUGxJqoiE+U}F9Zvc zK0f?iwt$xact;SPC%)|7O!}43s3u483v4qXPPQS4V+{zF;2V?rQP5Fgs8qK6{^FePhjV`1kY7Q`KnE=2tR|5Jl<+-;n-=ft|M*F1M_-5JBlUw z#Kxs<6!sLUN^zY3&Xds7vmSpfg^@E)Li5zACH^Mt=j+y&=Y>391ReBOgMwmK{TPEQ zGA|EeH(h0jD2QT<{K2Lf)-4PMe-0Mo@q>6x;(Bw_yTQsLSVYE@&r%{D^d}JHR{ept zIhF~fGGNEkM}Wg;%_zC)%#(Zn-xK}1y!rSaZr*#v!Oe78)!Rkw8b_xY71FSzZ{y5t zcj6H=jaam0IDTB&D9RNI3s%tx&wy|`Dl)GDl+XQ6w7p-xbmyL$7mDSuGkj!upbgmv zEf;Q%)^JcjPa1ZApg{#^YgcivR%+n7uy*L-6jY(tu{7z278O`6{g;2#xbS{gPf4?L z+hTS&+h|IEsdkFAro|bc$P{4c?i0|!F%^CRkzT})yL%H!y z{2itTZQt+L4sY@kd{=i+E#)Fn`_=5#V8g*u@5yn_4en-|TKZ>3i5u<1BiF7s#J9t>S;1Nyv@yiQ&vG!<} z2PjT!O1#Y>uYS3wR4%N@XSvdIZf#?fLN(osG>Dx=w&E6n67_e^B(xQ+J$v*0xQq=Z zS`^JhbxB=&8Db-Y43A}N#>4&LgLdH<=^k4TVnzdYm=e7{KZZpN6yL*fb9(@)-2zyE zFOH_?`Ua|dc38Te5yUpRZaw?%j}l>5$~Q%SyP3hvO<`vNjVO)3)`p#Pd1Rmbt0fw* zm5eiNH7jK$QV)Mp_bnUT-@oGIyK4W6 zU4CUwIWJEVA&sIJ4qOG1fxF8eEMosUOgZx>9%iV@cjYkP98gVvU)#666Zbn;*Edy+Cg z%iQLYbv=zAj*mgpr?$ELIT0o-ua%3d5|1bg-S z*Pq&I6WTg}+m$)Sf3-bLUJ0EgcXe<&_dlmke}ho_ZZ8KyWMN|lK zxD6i%CAuG1_NizAG^CSIvb?lOG>idaL!NfGOyiz=Warwbhf;eBr&+wup^>uj_Q@MqgWLM_p|0g$HN3nj z9-c-z&*NS+}2C{Lh#gDP2%5a(CpJ?I8|Ok z5ypN2?f%r0LcNmK<76dOJh8P(o}T{z-n~CZ)GhT(QDc0{@X9?b?Uld-10>|I=NK3S zio9JDtHIe=#~)Q zMJsI#MhY<_(0hKJpz2|OMsyC32c$>qnU zT=|lIQ|Tu@{kZw9NZBI>w5Up7!{iVC;2VG=jEZz_V7<0qq%p|jks!eY{kv5u;rU8J z)7--gzDWrnko<1;`*TK3;oT+%c_IEFWDB^+BoM0{cK~oRnl#=~ige9k?R5yExe550 z+N2f-KN#!9Hr2F3!2`8M*B4rR zi!+fDGVKg_B-KEupPYl-b zt8UuCxLyZS@5N>SyGv_GjK5N$nH7phlDo1vVn+l209;~SKb217=w<#wNVWA@H2@_l5fF%juea>kf+>^386tu^f>QNOwpE; zJ;c$&5zLaXMIR*KS65QRc|0DUJaO1tTcSuJ(=2V;S8{_Bx%8%TIV{_V9PqW^J~`G^ zNRG~8^BGGQ>9qd$e1k!SMa&b_a{pXeKtQbjh%dp5# zAEr4by1Kl+71`T6d0k-*yfLEO3$%v&PLYwL-hrVz82c5MNzJ=HRS*;~_|PZWknBxax2K#aFC&O8)>( zxcW%1tu9O?gS6}lIT$1Y7?Ip!y1JuD?4xctLUhuuTJ7RhmE4ehH;{$`&_n`GC zXR@9@Mur(96B5yvQoDz^ z&u_JLbr%$1?I!L!IVZQcw~FCzp>%EF5~m)LK66WT{Sx9GKTo^OxPnN`V5b?!etMpH z_O7m}w@i4eyDQReyg#H|g_6y+nbdP|;}EIuwln#F_inz`=r(>nl`OYeHLa(Xo}u)R zs)gr}g@4rZU0qa_^}8gVXoiP%r|Psk?T++)g}vsP z8Z?&Eh~J4wZ_C(x5&BnGResc36T7oT{Bp-o(;CwBPVbF^IMda@AQEx^06z7Vo5K2a z#Gu+saGsOtk=FnYM<2I-)z#IyD4;nu#vj5~(k6o9@)IG4AZ!~X8^4&IM>zbv*PQsW zJJE8cSjdUFQX6uf`5d0TYpbiCNoABzNK0uP(#z$dGdp$zn$+mJdnDxDL;+AS8Rbd& z#dUQUK}lrNbUd@uL}==qN6T(;llC6mQ+VxH)8{!Q{a7a;*H>3UijI*hY&JV#0F0uj z&#NQ<03Yf8)qLuFmJ*M|{G*OB@Af$#x%L&+)UuPYl0e#lkXkT>)Dmz3=PQB7_5T3& z$JiB;SmsrhHi?PG*#RSv26}Ux07&))Ko!;1H1k7HP2GjGwo - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/_assets/scripts/script1.jl b/_assets/scripts/script1.jl deleted file mode 100644 index bc4dc52..0000000 --- a/_assets/scripts/script1.jl +++ /dev/null @@ -1,10 +0,0 @@ -using LinearAlgebra # HIDE -using Random:seed! # HIDE -seed!(0) # HIDE - # HIDE -x = randn(5) -y = randn(5) - -for i in 1:5 - println(rpad("*"^i, 10, '-'), round(dot(x, y), digits=1)) -end diff --git a/_assets/scripts/script2.jl b/_assets/scripts/script2.jl deleted file mode 100644 index 0fa6c42..0000000 --- a/_assets/scripts/script2.jl +++ /dev/null @@ -1,4 +0,0 @@ -using PyPlot -x = range(0, stop=1, length=50) -plot(x, sin.(2x).*exp.(-x/3)) -savefig(joinpath(@__DIR__, "output", "script2.svg")) diff --git a/_assets/yggdrasil.svg b/_assets/yggdrasil.svg new file mode 100644 index 0000000..d3921c8 --- /dev/null +++ b/_assets/yggdrasil.svg @@ -0,0 +1,311 @@ + + + + diff --git a/_css/franklin.css b/_css/franklin.css index 11ced6e..9ca577b 100644 --- a/_css/franklin.css +++ b/_css/franklin.css @@ -239,3 +239,50 @@ return{c:[{cN:"metaj",b:/^julia>/,r:10,starts:{e:/^(?![ ]{6})/,sL:"julia"},alias color: white; border-radius: 0.3em; } + +.titlebar a { + color: inherit; + text-decoration: none; +} +.intro p a { + color: inherit; + text-decoration: underline; +} + +/* Section heading with a centered icon, e.g. Yggdrasil on the homepage */ +.section-head { + text-align: center; + margin: 1.5em 0 2em 0; +} +.section-head img { + display: block; + height: 6em; + margin: 0 auto 0.5em auto; +} +.franklin-content .section-head h2 { + text-align: center; + margin: 0 0 0.3em 0; +} +.section-head p { + margin: 0; +} + +/* Generated toolchain tables (see utils.jl) */ +.table-scroll { + overflow-x: auto; + margin: 1em 0; +} +.franklin-content table.toolchains { + font-size: 90%; +} +.franklin-content table.toolchains th { + background-color: #f2f2f2; + padding: 6px 10px; +} +.franklin-content table.toolchains td { + text-align: left; + padding: 6px 10px; +} +.franklin-content table.toolchains td code { + white-space: nowrap; +} diff --git a/_layout/foot.html b/_layout/foot.html index 77f7f93..4a3be05 100644 --- a/_layout/foot.html +++ b/_layout/foot.html @@ -5,6 +5,6 @@ {{ if hascode }} {{ insert foot_highlight.html }} {{ end }} - + {{ispage index.html}}{{end}} diff --git a/_layout/head.html b/_layout/head.html index 676c7fc..f6e108c 100644 --- a/_layout/head.html +++ b/_layout/head.html @@ -6,7 +6,7 @@ - + {{ispage index.html}}{{end}} {{if hasmath}} {{insert head_katex.html }} {{end}} {{if hascode}} {{insert head_highlight.html }} {{end}} @@ -19,14 +19,15 @@
-

BinaryBuilder

+

BinaryBuilder

+ {{ispage index.html}}
-

Build native binaries for 18 platforms in minutes. See how.

+

Build native binaries for {{platform_count}} platforms in minutes. See how.

-
@@ -39,5 +40,6 @@

BinaryBuilder

+ {{end}} diff --git a/config.md b/config.md index 399fb68..f7149a8 100644 --- a/config.md +++ b/config.md @@ -6,3 +6,6 @@ @def generate_rss = false \newcommand{\style}[2]{~~~
~~~!#2~~~
~~~} + + +@def ignore = ["Project.toml", "Manifest.toml", "package.json", "package-lock.json"] diff --git a/gpus.md b/gpus.md new file mode 100644 index 0000000..c100569 --- /dev/null +++ b/gpus.md @@ -0,0 +1,55 @@ +@def title = "Yggdrasil GPUs" +@def hasmath = false +@def hascode = false + +# GPUs + +[Yggdrasil](https://github.com/JuliaPackaging/Yggdrasil/), the community build tree for BinaryBuilder recipes, builds packages for NVIDIA, AMD, Intel and Apple GPUs, and for the cross-vendor OpenCL, Vulkan and SPIR-V standards. Library versions on this page are the latest ones in Julia's General registry when the site was built. + +## NVIDIA + +Yggdrasil recipes that use CUDA are built for {{cuda_default_count}} of the {{cuda_count}} CUDA toolkits below by default. Each build is tagged with its CUDA version, and Julia installs the one that works with the user's CUDA runtime: a build for CUDA 12.2 works with any CUDA 12 runtime from 12.2 onwards. Program NVIDIA GPUs from Julia with [CUDA.jl](https://github.com/JuliaGPU/CUDA.jl), and start a recipe from the [`HelloWorldCUDA`](https://github.com/JuliaPackaging/Yggdrasil/tree/master/H/HelloWorldCUDA) example. + +~~~ +{{cuda_table}} +~~~ + +From CUDA 13, a single aarch64 build covers both ARM servers and Jetson. Toolkits marked opt-in or preview are left out of `CUDA.supported_platforms()` by default; recipes include them with its `min_version` and `prereleases` keywords. + +~~~ +{{gpu_packages NVIDIA}} +~~~ + +## AMD + +Program AMD GPUs from Julia with [AMDGPU.jl](https://github.com/JuliaGPU/AMDGPU.jl). + +~~~ +{{gpu_packages AMD}} +~~~ + +## Intel + +Program Intel GPUs from Julia with [oneAPI.jl](https://github.com/JuliaGPU/oneAPI.jl). + +~~~ +{{gpu_packages Intel}} +~~~ + +## Apple + +Program Apple GPUs from Julia with [Metal.jl](https://github.com/JuliaGPU/Metal.jl). + +~~~ +{{gpu_packages Apple}} +~~~ + +## OpenCL, Vulkan and SPIR-V + +Use OpenCL from Julia with [OpenCL.jl](https://github.com/JuliaGPU/OpenCL.jl) and Vulkan with [Vulkan.jl](https://github.com/JuliaGPU/Vulkan.jl). + +~~~ +{{gpu_packages Cross-vendor}} +~~~ + +The CUDA toolkits come from Yggdrasil's [`platforms/cuda.jl`](https://github.com/JuliaPackaging/Yggdrasil/blob/master/platforms/cuda.jl) each time the site is built. diff --git a/index.md b/index.md index b79e6f2..16e7959 100644 --- a/index.md +++ b/index.md @@ -7,24 +7,24 @@
- +

Toolchains

-

45 well maintained toolchains for major platforms

+

{{toolchain_count}} well maintained toolchains for major platforms

- +

Sandbox

-

All the tools you need in one isolated Linux environment

+

All the tools you need in one isolated Linux environment

- +

Audit

Automated analysis finds and fixes common mistakes

- +

Wizard

-

An interactive environment simplifies authoring

+

An interactive environment simplifies authoring

@@ -33,39 +33,62 @@

OS Support

-

BinaryBuilder produces binaries for Linux, macOS, Windows and FreeBSD with a single script.

+

BinaryBuilder produces binaries for {{os_list}} with a single script.

CPU support

-

BinaryBuilder supports x86_64, x86, ARMv6, ARMv7, AArch64, PPC64LE, and Riscv64. Automatically!

+

BinaryBuilder supports {{cpu_list}}. Automatically!

Language support

-

Build native binaries for your C, C++, Fortran, Rust and Go packages.

+

Build native binaries for your C, C++, Fortran, Rust, Go and OCaml packages.

Just tarballs

-

BinaryBuilder output is just a tarball. Grab the one for your ABI and go. No root or special tools required!

+

BinaryBuilder output is just a tarball. Grab the one for your ABI and go. No root or special tools required!

Hints

-

Common build systems are automatically detected. The wizard will give you the right command.

+

Common build systems are automatically detected. The wizard will give you the right command.

-

Sensible defaults

-

If your build system is simple, our defaults will probably work for you.

+

Cross-platform consistency

+

You can build for several platforms using the same toolchain, getting consistent binaries across all target systems.

+
+ +
+ +
+ +

Yggdrasil

+

Yggdrasil is the community build tree for BinaryBuilder recipes, where the binary packages of the Julia ecosystem are built.

+
+ +
-

Experience

-

We've shipped millions of binaries this way. Where possible we've automated our learnings to help improve your binaries.

+

Community-driven

+

Build recipes for thousands of packages are already available, contributed by the community.

-

Cross-platform consistency

-

You can build for several platforms using the same toolchain, getting consistent binaries across all target systems.

+

JLL packages

+

Every merged recipe is built, uploaded and registered as a JLL package, so Julia users get the binaries with using LibFoo_jll.

-

Community-driven

-

Build recipes for hundreds of packages are already available in the community buildtree, Yggdrasil.

+

Contributing

+

Add or update a package by opening a pull request with its recipe. CI builds it for every platform it targets.

+
+
+

GPUs

+

Build code for NVIDIA, AMD, Intel and Apple GPUs. For CUDA, Julia automatically installs the build that matches the user's CUDA version.

+
+
+

Parallelism

+

Build MPI and OpenMP code for parallel computing. Users can switch between MPI implementations, such as MPICH and Open MPI, without rebuilding.

+
+
+

Agents

+

Agents simplify authoring, guided by Yggdrasil's agent guide.

diff --git a/mpi.md b/mpi.md new file mode 100644 index 0000000..ada0815 --- /dev/null +++ b/mpi.md @@ -0,0 +1,25 @@ +@def title = "Yggdrasil MPI" +@def hasmath = false +@def hascode = false + +# MPI + +[Yggdrasil](https://github.com/JuliaPackaging/Yggdrasil/), the community build tree for BinaryBuilder recipes, builds packages that use MPI once for each of the {{mpi_count}} MPI implementations below, and tags each build with its implementation. Users choose an implementation with [MPIPreferences.jl](https://juliaparallel.org/MPI.jl/stable/configuration/); without a preference, Julia uses MPICH, or Microsoft MPI on Windows. Julia then installs the matching build of every package, so switching implementations doesn't require rebuilding anything. + +Use MPI from Julia with [MPI.jl](https://github.com/JuliaParallel/MPI.jl), and start a recipe from the [`HelloWorldMPI`](https://github.com/JuliaPackaging/Yggdrasil/tree/master/H/HelloWorldMPI) example. + +## Implementations + +~~~ +{{mpi_table}} +~~~ + +Compatible versions are the versions of each implementation that the builds work with. [`MPICH_CUDA_jll`](https://github.com/JuliaBinaryWrappers/MPICH_CUDA_jll.jl), a build of MPICH with CUDA support, can be selected in place of MPICH. Latest versions are the latest ones in Julia's General registry when the site was built. + +## Platforms + +~~~ +{{mpi_platform_table}} +~~~ + +The implementations come from Yggdrasil's [`platforms/mpi.jl`](https://github.com/JuliaPackaging/Yggdrasil/blob/master/platforms/mpi.jl) each time the site is built. diff --git a/toolchains.md b/toolchains.md new file mode 100644 index 0000000..c6b64a0 --- /dev/null +++ b/toolchains.md @@ -0,0 +1,25 @@ +@def title = "BinaryBuilder Toolchains" +@def hasmath = false +@def hascode = false + +# Toolchains + +BinaryBuilder provides {{toolchain_count}} compiler versions for {{platform_count}} platforms. All of them run in the same [sandboxed Linux environment](https://docs.binarybuilder.org/stable/rootfs/), so one build recipe produces binaries for every platform. + +A recipe chooses its compilers with the `compilers` keyword of `build_tarballs` and their versions with `preferred_gcc_version`, `preferred_llvm_version`, `preferred_rust_version`, `preferred_go_version` and `preferred_ocaml_version`. By default you get the oldest GCC that supports the platform, because older GCC versions produce binaries that run on more systems, and the newest LLVM, Rust, Go and OCaml. See [Building Packages](https://docs.binarybuilder.org/stable/building/) and the [build tips for each language](https://docs.binarybuilder.org/stable/build_tips/). + +## Compilers + +~~~ +{{toolchain_table}} +~~~ + +## Platforms + +These are the platforms returned by `supported_platforms()`, the default set that recipes build for. The table shows which GCC, Rust and OCaml versions are available for each one; the GCC versions are those usable with the default LLVM, {{default_llvm}}. LLVM/Clang and Go are not listed here because each version is a single build that targets every platform, although older releases can predate newer targets such as Apple silicon or RISC-V. See [Platforms](https://docs.binarybuilder.org/stable/building/#Platforms) in the documentation to choose which platforms a recipe builds for. + +~~~ +{{platform_table}} +~~~ + +This page is generated from [BinaryBuilderBase](https://github.com/JuliaPackaging/BinaryBuilderBase.jl) v{{bbb_version}} each time the site is built. The toolchains themselves are built by the recipes in [`Yggdrasil/0_RootFS`](https://github.com/JuliaPackaging/Yggdrasil/tree/master/0_RootFS). diff --git a/utils.jl b/utils.jl new file mode 100644 index 0000000..000931b --- /dev/null +++ b/utils.jl @@ -0,0 +1,416 @@ +# Helper functions for the Franklin build of binarybuilder.org. +# +# The platform, toolchain, GPU and MPI data shown on the site is computed at build +# time, so it stays in sync with what BinaryBuilder and Yggdrasil offer instead of +# being maintained by hand. See +# https://github.com/JuliaPackaging/binarybuilder.org/issues/2 +# +# Sources: +# - BinaryBuilderBase: platforms and compiler toolchains +# - Yggdrasil's platforms/cuda.jl and platforms/mpi.jl: CUDA and MPI builds +# - The General registry: latest versions of GPU and MPI packages + +using BinaryBuilderBase +using Base.BinaryPlatforms: AbstractPlatform, triplet, platforms_match, arch, os, tags +using Downloads, RegistryInstances + +const BBB = BinaryBuilderBase + +## HTML helpers +# +# Table cells are escaped unless wrapped in `Raw`, so text that comes from upstream +# data can't inject markup into the site. + +struct Raw + html::String +end + +escape_html(x) = replace(string(x), '&' => "&", '<' => "<", '>' => ">", '"' => """) +cell(x::Raw) = x.html +cell(x) = escape_html(x) + +const CHECK = Raw("✓") +const DASH = Raw("—") +code(s) = Raw("$(escape_html(s))") +link(href, text) = Raw("$(cell(text))") +jll_link(name) = link("https://github.com/JuliaBinaryWrappers/$(name).jl", code(name)) + +html_table(header, rows) = string( + "
\n", + join("" for h in header), + "\n\n", + join("" * join("" for c in row) * "\n" for row in rows), + "
$(cell(h))
$(cell(c))
\n") + +# "a, b and c" +join_and(xs) = length(xs) <= 1 ? join(xs) : join(xs[1:end-1], ", ") * " and " * last(xs) + +## Platforms + +const PLATFORMS = supported_platforms() + +# Display names, in the order they are listed on the site. +const OS_NAMES = ["linux" => "Linux", "macos" => "macOS", "windows" => "Windows", + "freebsd" => "FreeBSD"] +const ARCH_NAMES = ["x86_64" => "x86_64", "i686" => "i686", "armv6l" => "ARMv6", + "armv7l" => "ARMv7", "aarch64" => "AArch64", "powerpc64le" => "PPC64LE", + "riscv64" => "RISC-V"] +os_name(p) = get(Dict(OS_NAMES), os(p), os(p)) + +# Display names of the values `f` takes over the supported platforms, with any value +# missing from `names` listed last under its own name. +function display_names(f, names) + present = unique(f.(PLATFORMS)) + return [[name for (key, name) in names if key in present]; + [key for key in present if !any(n -> first(n) == key, names)]] +end + +""" + {{platform_count}} + +Number of platforms returned by `supported_platforms()`. +""" +hfun_platform_count() = string(length(PLATFORMS)) + +""" + {{os_list}} + +The operating systems of the supported platforms, e.g. "Linux, macOS, Windows and FreeBSD". +""" +hfun_os_list() = escape_html(join_and(display_names(os, OS_NAMES))) + +""" + {{cpu_list}} + +The CPU architectures of the supported platforms, e.g. "x86_64, i686 and AArch64". +""" +hfun_cpu_list() = escape_html(join_and(display_names(arch, ARCH_NAMES))) + +## Toolchains + +all_versions(builds) = sort(unique(BBB.getversion.(builds))) + +const COMPILERS = [ + (name = "GCC", versions = all_versions(BBB.available_gcc_builds), + note = "Cross-compiler and binutils built for each target platform."), + (name = "LLVM/Clang", versions = all_versions(BBB.available_llvm_builds), + note = "One build per version that targets every platform."), + (name = "Rust", versions = all_versions(BBB.available_rust_builds), + note = "Standard library built for each target platform."), + (name = "Go", versions = all_versions(BBB.available_go_builds), + note = "One build per version that targets every platform."), + (name = "OCaml", versions = all_versions(BBB.available_ocaml_builds), + note = "Cross-compiler built for each target platform."), +] +versions_of(name) = only(c.versions for c in COMPILERS if c.name == name) + +# Targets of each compiler shard, by shard name and version. Only one archive type +# is looked at, otherwise every shard would be counted twice (squashfs and unpacked). +const SHARD_TARGETS = let targets = Dict{Tuple{String,VersionNumber},Vector{AbstractPlatform}}() + for cs in BBB.all_compiler_shards() + (cs.archive_type === :unpacked && cs.target !== nothing) || continue + push!(get!(targets, (cs.name, cs.version), AbstractPlatform[]), cs.target) + end + targets +end +has_shard(name, version, p) = + any(t -> platforms_match(t, p), get(SHARD_TARGETS, (name, version), AbstractPlatform[])) + +# Versions of `compiler` whose `shard` exists for platform `p`. +shard_versions(shard, compiler, p) = filter(v -> has_shard(shard, v, p), versions_of(compiler)) + +# `choose_shards` defaults to the newest LLVM. +const DEFAULT_LLVM = BBB.getversion(last(BBB.available_llvm_builds)) + +# Mirror `BinaryBuilderBase.choose_shards`: a GCC build is usable for a platform if +# its shard exists for that target and `gcc_version` doesn't filter it out, given the +# default LLVM (e.g. riscv64 needs GCC 14 or later, and FreeBSD needs GCC 6 or later +# with LLVM 12 or later). +function gcc_versions(p) + builds = filter(b -> has_shard("GCCBootstrap", BBB.getversion(b), p), BBB.available_gcc_builds) + return sort(BBB.gcc_version(p, builds, [:c]; llvm_version=DEFAULT_LLVM)) +end + +# Show a long list of versions as a range when it contains every version of `all` +# between its endpoints, so that gaps (e.g. a platform missing some GCC versions) +# stay visible. Prerelease builds such as GCC 12.0.1-iains (which exists for +# aarch64-apple-darwin only) don't count as gaps. +function format_versions(vs, all) + isempty(vs) && return DASH + lo, hi = first(vs), last(vs) + between = filter(v -> lo <= v <= hi && (isempty(v.prerelease) || v in vs), all) + if length(vs) > 3 && between == vs + return Raw("$(escape_html(lo)) – $(escape_html(hi)) ($(length(vs)))") + end + return join(string.(vs), ", ") +end + +""" + {{toolchain_count}} + +Number of distinct compiler versions (GCC, LLVM, Rust, Go and OCaml) available. +""" +hfun_toolchain_count() = string(sum(length(c.versions) for c in COMPILERS)) + +""" + {{bbb_version}} + +Version of BinaryBuilderBase the toolchain data was generated from. +""" +hfun_bbb_version() = string(pkgversion(BinaryBuilderBase)) + +""" + {{default_llvm}} + +The LLVM version that recipes get by default. +""" +hfun_default_llvm() = string(DEFAULT_LLVM) + +""" + {{toolchain_table}} + +One row per compiler, listing every available version. +""" +hfun_toolchain_table() = html_table( + ["Compiler", "Versions", "Count", "Notes"], + [[c.name, join(string.(c.versions), ", "), length(c.versions), c.note] for c in COMPILERS]) + +""" + {{platform_table}} + +One row per supported platform, with the GCC, Rust and OCaml versions available for it. +""" +function hfun_platform_table() + rows = map(PLATFORMS) do p + [code(triplet(p)), os_name(p), arch(p), + format_versions(gcc_versions(p), versions_of("GCC")), + format_versions(shard_versions("RustToolchain", "Rust", p), versions_of("Rust")), + format_versions(shard_versions("OCaml", "OCaml", p), versions_of("OCaml"))] + end + return html_table(["Platform", "OS", "Architecture", "GCC", "Rust", "OCaml"], rows) +end + +## Yggdrasil's CUDA and MPI helpers +# +# CUDA and MPI builds are defined by Yggdrasil's platforms/cuda.jl and +# platforms/mpi.jl, not by BinaryBuilderBase, so they are loaded from Yggdrasil's +# master branch at build time. Set YGGDRASIL_DIR to read them from a local checkout +# instead. If they can't be loaded, the build fails, so the deployed site keeps its +# last good version rather than publishing wrong data. + +const YGGDRASIL_PLATFORMS_URL = + "https://raw.githubusercontent.com/JuliaPackaging/Yggdrasil/master/platforms/" + +function read_yggdrasil_file(file) + dir = get(ENV, "YGGDRASIL_DIR", "") + isempty(dir) || return read(joinpath(dir, "platforms", file), String) + url = YGGDRASIL_PLATFORMS_URL * file + for attempt in 1:3 + try + return String(take!(Downloads.download(url, IOBuffer()))) + catch err + attempt == 3 && error("Could not download $url: $(sprint(showerror, err))") + sleep(5 * attempt) + end + end +end + +function load_yggdrasil_helper(file, modname) + src = read_yggdrasil_file(file) + # The helpers only use types that BinaryBuilder re-exports from BinaryBuilderBase, + # so load them against BinaryBuilderBase instead of installing all of BinaryBuilder. + pattern = r"^(\s*)(using|import) BinaryBuilder\b"m + occursin(pattern, src) || + error("Yggdrasil's platforms/$file no longer loads BinaryBuilder as utils.jl expects") + src = replace(src, pattern => + s"\1using BinaryBuilderBase; const BinaryBuilder = BinaryBuilderBase; \2 BinaryBuilderBase") + m = Module() + try + Base.include_string(m, src, "Yggdrasil/platforms/$file") + return Base.invokelatest(getglobal, m, modname) + catch err + error("Could not load Yggdrasil's platforms/$file: $(sprint(showerror, err))") + end +end + +const CUDA_HELPER = load_yggdrasil_helper("cuda.jl", :CUDA) +const MPI_HELPER = load_yggdrasil_helper("mpi.jl", :MPI) + +## Registry + +const GENERAL = let regs = filter(r -> r.name == "General", RegistryInstances.reachable_registries()) + isempty(regs) && error("The General registry isn't installed; add it with `Pkg.Registry.add(\"General\")`") + first(regs) +end + +# Latest registered version of a package, without its build number. +function latest_version(name) + uuids = RegistryInstances.uuids_from_name(GENERAL, name) + if isempty(uuids) + @warn "$name is not registered in the General registry" + return nothing + end + info = RegistryInstances.registry_info(GENERAL[first(uuids)]) + versions = [v for (v, vinfo) in info.version_info if !vinfo.yanked] + isempty(versions) && return nothing + v = maximum(versions) + return VersionNumber(v.major, v.minor, v.patch, v.prerelease) +end +format_version(v) = v === nothing ? DASH : string(v) + +## CUDA + +cuda_series(v::VersionNumber) = "$(v.major).$(v.minor)" +const CUDA_VERSIONS = sort([CUDA_HELPER.cuda_full_versions; CUDA_HELPER.cuda_prerelease_versions]) +const CUDA_ALL_PLATFORMS = CUDA_HELPER.supported_platforms(; min_version=nothing, prereleases=true) +const CUDA_DEFAULT_SERIES = Set(tags(p)["cuda"] for p in CUDA_HELPER.supported_platforms()) +is_default_cuda(v) = + !(v in CUDA_HELPER.cuda_prerelease_versions) && cuda_series(v) in CUDA_DEFAULT_SERIES + +# The columns of the CUDA table that a build counts for. Before CUDA 13, aarch64 +# builds are split into ARM servers (SBSA) and Jetson by the `cuda_platform` tag; +# from CUDA 13 a single aarch64 build without that tag covers both. +const CUDA_COLUMNS = ["x86_64", "ARM servers (SBSA)", "Jetson"] +const CUDA_PLATFORM_NAMES = Dict("sbsa" => "ARM servers (SBSA)", "jetson" => "Jetson") +function cuda_columns(p) + Sys.islinux(p) && arch(p) == "x86_64" && return ["x86_64"] + if Sys.islinux(p) && arch(p) == "aarch64" + cp = get(tags(p), "cuda_platform", nothing) + return cp === nothing ? ["ARM servers (SBSA)", "Jetson"] : [get(CUDA_PLATFORM_NAMES, cp, cp)] + end + return ["$(os(p)) $(arch(p))"] +end +cuda_columns(ps::Vector) = reduce(vcat, cuda_columns.(ps); init=String[]) + +""" + {{cuda_count}} + +Number of CUDA toolkits that Yggdrasil can build against. +""" +hfun_cuda_count() = string(length(CUDA_VERSIONS)) + +""" + {{cuda_default_count}} + +Number of CUDA toolkits that Yggdrasil builds against by default. +""" +hfun_cuda_default_count() = string(count(is_default_cuda, CUDA_VERSIONS)) + +""" + {{cuda_table}} + +One row per CUDA toolkit, showing which platforms it is built for. +""" +function hfun_cuda_table() + # Show any new kind of platform as an extra column rather than dropping it. + columns = unique([CUDA_COLUMNS; cuda_columns(CUDA_ALL_PLATFORMS)]) + rows = map(CUDA_VERSIONS) do v + built = Set(cuda_columns(filter(p -> tags(p)["cuda"] == cuda_series(v), CUDA_ALL_PLATFORMS))) + status = v in CUDA_HELPER.cuda_prerelease_versions ? "Preview" : + is_default_cuda(v) ? "Yes" : "Opt-in" + [string(v), (c in built ? CHECK : DASH for c in columns)..., status] + end + return html_table(["CUDA toolkit", columns..., "Built by default"], rows) +end + +## GPU libraries +# +# The names and descriptions are curated; the versions come from the registry. + +const GPU_PACKAGES = Dict( + "NVIDIA" => [ + ("CUDNN_jll", "cuDNN: deep neural network primitives"), + ("CUTENSOR_jll", "cuTENSOR: tensor operations"), + ("CUDSS_jll", "cuDSS: sparse direct solvers"), + ("cuSolverMp_jll", "cuSOLVERMp: distributed dense linear algebra"), + ("cuQuantum_jll", "cuQuantum: quantum circuit simulation"), + ("NCCL_jll", "NCCL: communication between GPUs"), + ("TensorRT_jll", "TensorRT: deep learning inference"), + ("NVTX_jll", "NVTX: annotations for profilers"), + ], + "AMD" => [ + ("AMDGPU_LLVM_Backend_jll", "LLVM code generator for AMD GPUs"), + ("ROCmDeviceLibs_jll", "ROCm device libraries"), + ("hsa_rocr_jll", "ROCm runtime (HSA)"), + ("HIP_jll", "HIP runtime"), + ("rocBLAS_jll", "rocBLAS: dense linear algebra"), + ("rocSPARSE_jll", "rocSPARSE: sparse linear algebra"), + ("rocRAND_jll", "rocRAND: random number generation"), + ("MIOpen_jll", "MIOpen: deep learning primitives"), + ("rocminfo_jll", "rocminfo: device information tool"), + ], + "Intel" => [ + ("NEO_jll", "Compute runtime for Intel GPUs (NEO)"), + ("libigc_jll", "Intel Graphics Compiler"), + ("gmmlib_jll", "Intel graphics memory management library"), + ("oneAPI_Level_Zero_Loader_jll", "oneAPI Level Zero loader"), + ("oneAPI_Level_Zero_Headers_jll", "oneAPI Level Zero headers"), + ("oneAPI_Support_jll", "Support library for oneAPI.jl"), + ], + "Apple" => [ + ("Metal_LLVM_Tools_jll", "LLVM tools for generating Metal code"), + ("Metal_Shader_Converter_jll", "Metal shader converter"), + ], + "Cross-vendor" => [ + ("OpenCL_jll", "OpenCL ICD loader"), + ("OpenCL_Headers_jll", "OpenCL headers"), + ("pocl_jll", "PoCL: portable OpenCL implementation for CPUs"), + ("intel_opencl_rt_jll", "Intel OpenCL runtime for x86_64 CPUs"), + ("Vulkan_Loader_jll", "Vulkan loader"), + ("Vulkan_Headers_jll", "Vulkan headers"), + ("SPIRV_Tools_jll", "SPIR-V tools"), + ("SPIRV_LLVM_Translator_jll", "Translator between LLVM IR and SPIR-V"), + ("SPIRV_LLVM_Backend_jll", "LLVM code generator for SPIR-V"), + ], +) + +""" + {{gpu_packages vendor}} + +Table of the GPU libraries for `vendor` (a key of `GPU_PACKAGES`) with the latest +version of each in the General registry. +""" +function hfun_gpu_packages(params::Vector{String}) + rows = [[jll_link(name), desc, format_version(latest_version(name))] + for (name, desc) in GPU_PACKAGES[only(params)]] + return html_table(["Package", "Description", "Latest version"], rows) +end + +## MPI + +const MPI_ABIS = [(abi = abi, jll = pkg.name, compat = compat, platforms = filter(f, PLATFORMS)) + for (abi, pkg, compat, f) in MPI_HELPER.mpi_abis] + +# Show a Pkg compat entry such as "4.1.11, 5.0.14" as "4.x (≥ 4.1.11), 5.x (≥ 5.0.14)"; +# anything more complex is shown as it is. +function format_compat(compat) + parts = strip.(split(compat, ',')) + all(p -> occursin(r"^[1-9]\d*(\.\d+){0,2}$", p), parts) || return compat + return Raw(join(("$(first(split(p, '.'))).x (≥ $p)" for p in parts), ", ")) +end + +""" + {{mpi_count}} + +Number of MPI implementations that recipes are built for. +""" +hfun_mpi_count() = string(length(MPI_ABIS)) + +""" + {{mpi_table}} + +One row per MPI implementation that recipes are built for. +""" +hfun_mpi_table() = html_table( + ["Implementation", "Package", "Compatible versions", "Latest version", "Platforms"], + [[m.abi, jll_link(m.jll), format_compat(m.compat), format_version(latest_version(m.jll)), + "$(length(m.platforms)) of $(length(PLATFORMS))"] for m in MPI_ABIS]) + +""" + {{mpi_platform_table}} + +One row per supported platform, showing which MPI implementations are built for it. +""" +hfun_mpi_platform_table() = html_table( + ["Platform", (m.abi for m in MPI_ABIS)...], + [[code(triplet(p)), (p in m.platforms ? CHECK : DASH for m in MPI_ABIS)...] for p in PLATFORMS])