KUP-SERVER(1)							    kernel.org							     KUP-SERVER(1)

NAME

       kup-server - kernel.org upload server utility

DESCRIPTION

       The  program  kup-server  is expected to be the receiver of an ssh shell, configured with the following or similar options in ~/.ssh/autho-
       rized_keys:

	      command="/usr/bin/kup-server",no-agent-forwarding,no-port-forwarding,no-pty,no-user-rc,no-X11-forwarding ssh-rsa AAAA[...]

       Each user should have their own UID, as Unix user permissions are used for specific tree access control. On the client side, a  correspond-
       ing client-side utility kup is used to initiate the connection and perform the uploads.

GLOBAL CONFIG

       The configuration file for kup-server is located in /etc/kup/kup-server.cfg and has the following options:

       [paths]
	      All paths in this section should be disjoint. Do not combine any of them into one directory.

       data_path = /var/lib/kup/pub
	      Path for public consumption, e.g. served via http or rsync.

       git_path = /var/cache/git
	      This is the path where git trees (for the TAR and DIFF options) are available.  Those should be readonly for the uploaders.

       lock_file = /run/kup/lock
	      A  common lock file for data_path.  No program should modify the content in data_path without holding an flock on this file.  Should
	      be readonly for the uploaders.

       tmp_path = /var/cache/kup/tmp/
	      tmp_path can be either:

	      1. a directory writable by every user and with the sticky bit set (typically mode 1777 or 1770).	In that case, DO NOT end the  path
	      with a slash, or:

	      2. A directory containing an empty directory for each user (named for that user), owned by that user and mode 0700. In this case, DO
	      end the path with a slash.

	      In either case, this directory tree MUST be on the same filesystem as data_path, since the script expects  tocreate  files  in  this
	      directory and rename() them into data_path.

       pgp_path = /var/lib/kup/pgp
	      A directory containing a GnuPG public keyring for each user, named <user>.gpg and readable (but not writable) by that user.

       [limits]
	      All sizes are in bytes, all times in seconds.

       max_data = 8589934592
	      Max size of uploaded data.

       bufsiz = 262144
	      Buffer size when reading data.

       timeout_command = 30
	      How long to wait for a command to time out.

       timeout_data = 300
	      Must read at least bufsiz bytes in this timespan.

       timeout_compress = 900
	      Uncompressing tarballs must take at most this long.

       timeout_compress_cpu = 900
	      Each compression command must take at most this long in CPU time.

AUTHOR

       Written by H. Peter Anvin <hpa@zytor.com>.

COPYRIGHT

       Copyright (C) 2011 Intel Corporation

       This  program  is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
       the Free Software Foundation, Inc.; either version 2 of the License, or (at your option) any later version; incorporated herein	by  refer-
       ence.  There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       kup(1)

kernel.org upload server utility				       2011							     KUP-SERVER(1)