This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
userdoc:kup [2014-06-12 18:35] korgadmin created |
userdoc:kup [2020-05-08 14:03] (current) mricon |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ~~REDIRECT>https://korg.docs.kernel.org/kup.html~~ | ||
+ | |||
====== Using kernel.org uploader (kup) ====== | ====== Using kernel.org uploader (kup) ====== | ||
Line 5: | Line 7: | ||
===== Before you begin ===== | ===== Before you begin ===== | ||
- | In order to use kup, you will need to have a [[userdoc:accounts|valid kernel.org account]]. If you already have access to kernel.org gitolite trees, then you are all set to use kup. If you do not have a current kernel.org account, you can [[userdoc:accounts|request that the account is created for you]]. | + | **EXTREMELY IMPORTANT:** Do not upload non-Open Source software without special prior permission. This includes binaries of software intended to be Open Source for which source code isn't actually available yet. |
+ | IN PARTICULAR, do not upload non-Open Source cryptographic software, or cryptographic binaries from source not available on the Internet, under any circumstances. This is absolutely essential. | ||
+ | |||
+ | If you have not yet set up your ssh access, first see [[userdoc:ssh_access]]. | ||
===== Obtaining kup ===== | ===== Obtaining kup ===== | ||
Line 12: | Line 17: | ||
yum install kup | yum install kup | ||
+ | |||
+ | :!: **NOTE: Make sure the version of kup is at least 0.3.6, as earlier versions will NOT work.** | ||
You can also check out the git tree to obtain the latest version of kup: | You can also check out the git tree to obtain the latest version of kup: | ||
Line 19: | Line 26: | ||
===== Configuring kup ===== | ===== Configuring kup ===== | ||
- | Set your ''$HOME/.kuprc'' as follows (requires kup >= 0.3.2): | + | Set your ''$HOME/.kuprc'' as follows (**requires kup >= 0.3.6**): |
- | rsh = ssh -a -x -T -i /home/yourname/.ssh/id_rsa_korg_gitolite | + | host = git@gitolite.kernel.org |
- | host = yourkorgusername@kup.kernel.org | + | subcmd = kup-server |
That should be all you need to do. You may test things by running: | That should be all you need to do. You may test things by running: | ||
- | kup ls /pub | + | kup info |
You should see the following or similar output: | You should see the following or similar output: | ||
- | +++ /pub/ | + | kup-server 0.3.6 (gitolite integrated) |
- | drwxrwsr-x 6 hpa 498 4096 2011-12-01 19:56:21 dist | + | |
- | drwxr-sr-x 13 root 498 4096 2011-11-16 18:36:48 linux | + | ls /* |
- | drwxrwsr-x 3 498 498 4096 2008-09-23 23:35:52 media | + | put/rm/mv/mkdir /testing/* |
- | drwxr-xr-x 2 root root 4096 2011-10-18 18:24:52 scm | + | put/rm/mv/mkdir /pub/linux/kernel/people/yourname/* |
- | drwxrwsr-x 2 hpa 498 4096 2011-12-01 19:56:21 site | + | |
- | drwxr-sr-x 13 root 498 4096 2011-11-27 17:31:37 software | + | |
- | drwxr-sr-x 3 498 498 4096 2008-04-30 22:31:54 tools | + | |
- | If you get an error in return, check to make sure you are using the correct private key and username (see [[userdoc:ssh_access]]). | + | :-/ If you get an error in return, check to make sure you have correctly set up your ssh access (see [[userdoc:ssh_access]]). Additionally, if you see a long list of gitolite repositories instead, make sure your version of kup is 0.3.6 or above, and that you have correctly set up your ''~/.kuprc'' to specify "''subcmd=kup-server''". |
If it is still not working for you, please [[userdoc:support|contact support]] for further assistance. | If it is still not working for you, please [[userdoc:support|contact support]] for further assistance. | ||
Line 49: | Line 53: | ||
man kup | man kup | ||
- | You can test kup by uploading into a special /test directory: | + | You can test kup by uploading into a special /testing directory: |
- | kup put foo.tar foo.tar.asc /test/foo.tar.gz | + | kup put foo.tar foo.tar.asc /testing/foo.tar.gz |
+ | |||
+ | 8-o: If you get "invalid signature", the most likely cause is that your signature is against the compressed version of the archive. Kup expects the signature to be against .tar, not .tar.?z. It uncompresses the file, then runs the verification check, then recompresses in multiple formats. | ||
Please remove anything you put there after you are done: | Please remove anything you put there after you are done: | ||
- | kup rm /test/foo.tar.gz | + | kup rm /testing/foo.tar.gz |
Anything uploaded to ''/pub'' will be rsynced to kernel.org frontends and will be available on [[http://kernel.org/pub]] after a few minutes. | Anything uploaded to ''/pub'' will be rsynced to kernel.org frontends and will be available on [[http://kernel.org/pub]] after a few minutes. |