kup-server(1) [debian man page]

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)

MYSQL_INSTALL_DB()														MYSQL_INSTALL_DB()

NAME

       mysql_install_db - initialize MySQL data directory

SYNOPSIS

       mysql_install_db [options]

DESCRIPTION

       mysql_install_db initializes the MySQL data directory and creates the system tables that it contains, if they do not exist.

       To invoke mysql_install_db, use the following syntax:

	   shell> mysql_install_db [options]

       Because the MySQL server, mysqld, needs to access the data directory when it runs later, you should either run mysql_install_db from the
       same account that will be used for running mysqld or run it as root and use the --user option to indicate the user name that mysqld will
       run as. It might be necessary to specify other options such as --basedir or --datadir if mysql_install_db does not use the correct
       locations for the installation directory or data directory. For example:

	   shell> bin/mysql_install_db --user=mysql 
		    --basedir=/opt/mysql/mysql 
		    --datadir=/opt/mysql/mysql/data

       mysql_install_db needs to invoke mysqld with the --bootstrap and --skip-grant-tables options (see Section 2.3.2, "Typical configure
       Options"). If MySQL was configured with the --disable-grant-options option, --bootstrap and --skip-grant-tables will be disabled. To handle
       this, set the MYSQLD_BOOTSTRAP environment variable to the full path name of a server that has all options enabled.  mysql_install_db will
       use that server.

       mysql_install_db supports the following options, which can be specified on the command line or in the [mysql_install_db] and (if they are
       common to mysqld) [mysqld] option file groups.

       o   --basedir=path

	   The path to the MySQL installation directory.

       o   --force

	   Cause mysql_install_db to run even if DNS does not work. In that case, grant table entries that normally use host names will use IP
	   addresses.

       o   --datadir=path, --ldata=path

	   The path to the MySQL data directory.

       o   --rpm

	   For internal use. This option is used by RPM files during the MySQL installation process.

       o   --skip-name-resolve

	   Use IP addresses rather than host names when creating grant table entries. This option can be useful if your DNS does not work.

       o   --srcdir=path

	   For internal use. The directory under which mysql_install_db looks for support files such as the error message file and the file for
	   populating the help tables. This option was added in MySQL 5.1.14.

       o   --user=user_name

	   The login user name to use for running mysqld. Files and directories created by mysqld will be owned by this user. You must be root to
	   use this option. By default, mysqld runs using your current login name and files and directories that it creates will be owned by you.

       o   --verbose

	   Verbose mode. Print more information about what the program does.

       o   --windows

	   For internal use. This option is used for creating Windows distributions.

COPYRIGHT

       Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.

       This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as
       published by the Free Software Foundation; version 2 of the License.

       This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation,
       Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or see http://www.gnu.org/licenses/.

SEE ALSO

       For more information, please refer to the MySQL Reference Manual, which may already be installed locally and which is also available online
       at http://dev.mysql.com/doc/.

AUTHOR

       Sun Microsystems, Inc. (http://www.mysql.com/).

																MYSQL_INSTALL_DB()