Skip to content

Commit 132cae4

Browse files
committed
doc: Mention the flat directory structure for uploads
The uploaded binaries need to match the same flat directory structure of the SHA256SUMS file in order for torrent downloaders to be able to verify the download without moving files. Mention this in the release process doc.
1 parent fb17c99 commit 132cae4

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

doc/release-process.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -206,17 +206,26 @@ cat "$VERSION"/*/all.SHA256SUMS.asc > SHA256SUMS.asc
206206
```
207207

208208

209-
- Upload to the bitcoincore.org server (`/var/www/bin/bitcoin-core-${VERSION}`):
210-
1. The contents of `./bitcoin/guix-build-${VERSION}/output`, except for
209+
- Upload to the bitcoincore.org server (`/var/www/bin/bitcoin-core-${VERSION}/`):
210+
1. The contents of each `./bitcoin/guix-build-${VERSION}/output/${HOST}/` directory, except for
211211
`*-debug*` files.
212212

213+
Guix will output all of the results into host subdirectories, but the SHA256SUMS
214+
file does not include these subdirectories. In order for downloads via torrent
215+
to verify without directory structure modification, all of the uploaded files
216+
need to be in the same directory as the SHA256SUMS file.
217+
213218
The `*-debug*` files generated by the guix build contain debug symbols
214219
for troubleshooting by developers. It is assumed that anyone that is
215220
interested in debugging can run guix to generate the files for
216221
themselves. To avoid end-user confusion about which file to pick, as well
217222
as save storage space *do not upload these to the bitcoincore.org server,
218223
nor put them in the torrent*.
219224

225+
```sh
226+
find guix-build-${VERSION}/output/ -maxdepth 2 -type f -not -name "SHA256SUMS.part" -and -not -name "*debug*" -exec scp {} [email protected]:/var/www/bin/bitcoin-core-${VERSION} \;
227+
```
228+
220229
2. The `SHA256SUMS` file
221230

222231
3. The `SHA256SUMS.asc` combined signature file you just created

0 commit comments

Comments
 (0)