#!/usr/bin/less

################################################################################

Program		: utmpctl
Version		: 0.1.6
Purpose		: UTMP records modifications
License		: GNU GPL v2 or later (see LICENSE and file COPYING)
Author		: Samuel Behan <behan@frida.fri.utc.sk> (c) 2000-2001
Requirements 	: (as usual)
		  
################################################################################


ABOUT
-----
	Utmpctl is a program to (manualy) modify/create utmp records.
  This way you can add/destroy/modify/hide/unhide sessions logged in the
  utmp database. There are several new function waiting for implementation
  in the later versions (see TODO).
  Important: see section TECHNICAL NOTES before start
  ---
  Any bugs, tips or good ideas  send to <behan@frida.fri.utc.sk> and
   i'll try to help you ;-)


INSTALATION
-----------
	as usual ;-)

ARGUMENTS
---------
	record	position of record to modify
	-l	list utmp database (default action)
	-a	add this session to utmp
	-d	delete this session from utmp
	-i	make this session invisible
	-u	uninvisible this session
	-T type record type (1..6) (see UTMP TYPES)
	-P pid	pid (ie. 1234)
	-D dev	device (ie. tty1, pts/2)
	-I id	device id (tty1 = 1, pts/2 = 2)
	-U user username (ie. root)
	-H host hostname (ie. localhost.localdomain)
	-h help


UTMP TYPES
----------
    0 = UT_UNKNOWN	- unkown record
    1 = RUN_LEVEL	- created at boot time, stores current run level number
    2 = BOOT_TIME	- time we have booted in
    3 = NEW_TIME	- stores newly set time
    4 = OLD_TIME	- stores old time before the new has been set
    5 = INIT_PROCESS	- proccess set by the init
    6 = LOGIN_PROCESS	- login process (ie. login waiting for login name)
    7 = USER_PROCESS	- user process (ie. process set up by login)
    8 = DEAD_PROCESS	- dead process (ie. after telnet signoff)
    9 = ACCOUNTING	- dont know '-)

    
TECHNICAL NOTES
---------------
   <Modifying record types>
      Program determines which record to modify by the record position
      number or if number is ommitted by the 'pattern' of the record id 
      (option '-I') and optionaly record type (option '-T').
      This behaviour is given by the library calls program uses to modify
      the record. A due to this restriction you can not modify the id 
      of the record since this is the only unique item in the utmp database.
    

LICENSE
-------
	This program is distibuted under terms of General Public License
  version 2 or later from Free Software Foundation (see file LICENSE
  ditributed within this package). If terms of GNU GPL license are in
  contradiction of your copyright law, this program should be used as
  freeware - you can use it for free, but you can not distribute or
  modify it or use it's components in your programs.