ruser Command

Commands Reference, Volume 4

ruser Command

Purpose

Directly manipulates entries in three separate system databases that control foreign host access to programs.

Syntax

To Add or Delete a Database File Name Entry

ruser { -a | -d } { -f "UserName ..." | -p "HostName ..." | -r "HostName ..." }

To Delete or Display All Name Entries in a Database File

ruser { -X | -s } { -F | -P | -R }

Description

The ruser low-level command adds or deletes entries in three separate system databases. Which database you are manipulating is determined by using the -p, -r, or -f flags. In addition, the ruser command can show one or all entries in one of the databases. Each database is a list of names. The three databases are as follows:

/etc/ftpusers file
/etc/hosts.equiv file
/etc/hosts.lpd file.
Note: The -p and -r options can be used together to add a name to databases at the same time, but the -f option cannot be used with either.

You can use a Web-based System Manager application (wsm users fast path) to run this command. You could also use the System Management Interface Tool (SMIT) smit users fast path to run this command.

smit rprint

Flags

-a	Adds a name to the database. The -a flag must be used with either the -p, -r, or -f flag.
-d	Deletes a name from the database. Must be used with either the -p, -r, or -f flag.
-F	Deletes or shows all entries in the /etc/ftpusers file. Use this flag with the -X flag to delete all entries. Use this flag with the -s flag to show all entries.
-f "UserName ..."	Adds or deletes the user name specified by the UserName variable to the /etc/ftpusers database that contains a list of local user names that cannot be used by remote FTP clients. The -f flag must be used with either the -a or -d flag.
-P	Deletes or shows all entries in the /etc/hosts.lpd file. Use this flag with the -X flag to delete all entries. Use this flag with the -s flag to show all entries.
-p "HostName ..."
	Adds or deletes the host name, specified by the HostName variable, in the database that specifies which foreign host may print on your machine. The -p flag must be used with either the -a or -d flag.
-R	Deletes or shows all entries in the /etc/hosts.equiv file. Use this flag with the -X flag to delete all entries. Use this flag with the -s flag to show all entries.
-r "HostName ..."
	Adds or deletes the host name, specified by the HostName variable, in the /etc/hosts.equiv database that specifies which foreign host may perform the remote commands (rlogin, rcp, rsh, or print) on your machine. The -r flag must be used with either the -a or -d flag.
-s	Shows all entries in the database. Use this flag with either the -P, -R, or -F flag.
-X	Deletes all names from the database. Use this flag with either the -P, -R, or -F flag.

Examples

To add an entry in the /etc/hosts.lpd database, which specifies which foreign host may print on the local machine, enter the command in the following format:
```
ruser -a -p "host1"
```
In this example, the foreign host is host1.
To delete an entry in the database that controls printing only (/etc/hosts.lpd) and delete as well the same name from the database that controls remote access for the rlogin, rcp, and rsh commands (/etc/hosts.equiv), enter:
```
ruser -d -r "host2" -p "host1"
```
In this example, the host from which the database entry is deleted is host1.

Related Information

The lpd daemon, rshd daemon, rlogind daemon.

The ftpusers file format, hosts.equiv file format, hosts.lpd file format.

Setting up and running Web-based System Manager in AIX Version 4.3 System Management Guide: Operating System and Devices.

Understanding the TCP/IP Reference in AIX Version 4.3 System Management Guide: Communications and Networks.