nutop(8) [debian man page]

NUTOP(8)																  NUTOP(8)

NAME

       nutop - display top NUFW Users

SYNOPSIS

       nutop [ -help ] [ -c config file ] [ -delay refresh delay (seconds) ] [ -line number of lines to display ] [ -databasetype  mysql/pgsql ] [
       -host db host ] [ -user db username ] [ -pass db password ] [ -databasename db database name ] [ -tablename db table ] [ -port db port ]

DESCRIPTION

       This manual page documents the nutop command.

       Nutop is to be used by administrators willing to view users activity on a NuFW server, in real time. The display is designed to look a  lot
       like the well known top command, as far as general layout is concerned.

       The  default  configuration  file (containing SQL connections parameters) is located at /etc/nufw/nutop.conf. If decided to customize it to
       their needs, care should be taken about file permissions on that file, as it might let any user of the system access to the NuFW connection
       tracking database.

       Original packaging and informations and help can be found from http://www.nufw.org/

OPTIONS

       -help  Issues usage details and exits.

       -c config file
	      Specifies config file to read SQL parameters from. Default is /etc/nufw/nutop.conf

       -delay number
	      Specifies a rate to refresh display. This parameter is interpeted as a number of seconds. Default is 2s.

       -line number
	      Number of lines to display. Default : 20

       -databasetype mysql/pgsql
	      Type of database to connect to. Default is mysql. This setting also sets the default port setting.

       -host hostname/IP
	      IP address or FQDN of database we connect to.  Default value : 127.0.0.1

       -user username
	      Database username to connect as. Default is "nutop"

       -pass password
	      Password to use to connect to database.

       -databasename name of database
	      Name of database we connect to. Default is "nulog"

       -tablename name of table
	      Name of SQL table to use for queries. Default is "ulog"

       -port TCP port
	      TCP numeric port to use for database connection. Default is 3306 if databasetype is mysql, 5432 if pgsql.

SEE ALSO

       nuauth(8), nufw(8)

AUTHOR

       Nufw  was designed and coded by Eric Leblond, aka Regit (<eric@inl.fr>) , and Vincent Deffontaines, aka gryzor (<vincent@inl.fr>). Original
       idea in 2001, while working on NSM Ldap support.

       This manual page was written by Vincent Deffontaines

       Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version  2	as
       published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.

								   18 mars 2007 							  NUTOP(8)

PG_PCONNECT(3)															    PG_PCONNECT(3)

pg_pconnect - Open a persistent PostgreSQL connection

SYNOPSIS

       resource pg_pconnect (string  $connection_string, [int  $connect_type])

DESCRIPTION

       pg_pconnect(3) opens a connection to a PostgreSQL database. It returns a connection resource that is needed by other PostgreSQL functions.

	If  a  second  call  is made to pg_pconnect(3) with the same $connection_string as an existing connection, the existing connection will be
       returned unless you pass PGSQL_CONNECT_FORCE_NEW as $connect_type.

	To enable persistent connection, the pgsql.allow_persistent php.ini directive must be set to "On" (which is the default). The maximum num-
       ber of persistent connection can be defined with the pgsql.max_persistent php.ini directive (defaults to -1 for no limit). The total number
       of connections can be set with the pgsql.max_links php.ini directive.

       pg_close(3) will not close persistent links generated by pg_pconnect(3).

PARAMETERS

	      o $connection_string
		- The $connection_string can be empty to use all default parameters, or it can contain one or more parameter settings separated by
		whitespace.  Each  parameter  setting is in the form keyword = value. Spaces around the equal sign are optional. To write an empty
		value or a value containing spaces, surround it with single quotes, e.g., keyword =  'a  value'.  Single  quotes  and  backslashes
		within	the  value  must  be  escaped  with a backslash, i.e., ' and \.  The currently recognized parameter keywords are: $host,
		$hostaddr, $port, $dbname, $user, $password, $connect_timeout, $options, $tty  (ignored),  $sslmode,  $requiressl  (deprecated	in
		favor of $sslmode), and $service. Which of these arguments exist depends on your PostgreSQL version.

	      o $connect_type
		- If PGSQL_CONNECT_FORCE_NEW is passed, then a new connection is created, even if the $connection_string is identical to an exist-
		ing connection.

RETURN VALUES

	PostgreSQL connection resource on success, FALSE on failure.

EXAMPLES

       Example #1

	      Using pg_pconnect(3)

	      <?php
	      $dbconn = pg_pconnect("dbname=mary");
	      //connect to a database named "mary"

	      $dbconn2 = pg_pconnect("host=localhost port=5432 dbname=mary");
	      // connect to a database named "mary" on "localhost" at port "5432"

	      $dbconn3 = pg_pconnect("host=sheep port=5432 dbname=mary user=lamb password=foo");
	      //connect to a database named "mary" on the host "sheep" with a username and password

	      $conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
	      $dbconn4 = pg_pconnect($conn_string);
	      //connect to a database named "test" on the host "sheep" with a username and password
	      ?>

SEE ALSO

       pg_connect(3),  Persistent Database Connections.

PHP Documentation Group 													    PG_PCONNECT(3)