## Gw Manual

2000
John Fleck

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license can be found here.

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and those trademarks are made aware to the members of the GNOME Documentation Project, the names have been printed in caps or initial caps.

This is version 1.1 of Gw manual.

## Introduction

Gw displays a listing of all the users currently logged onto your machine, along with information about what they're up to. It also gives you the ability to communicate with them.

To run Gw, select User Listing from the System submenu of the Main Menu, or type `gw` on the command line.

Gw is included in the `GNOME-utils` package, which is part of the GNOME desktop environment. This document describes version &version; of Gw.

## Using Gw

Gw can be used to monitor users on your system, and to communicate with them.

### Basic usage

Starting Gw opens the Main window, shown in .

#### Gw Main Window

Gw Main Window

On launch, Gw displays a listing of all users.

To update the data, click on the Update Information button.

The data displayed includes:

- USER — user's login name.

- TTY — the terminal the user is connected through.

- FROM — The remote host from which the user logged in, or the X display terminal if the user is local.

- LOGIN@ — The time the user logged in.

- IDLE — The amount of idle CPU time associated with that login.

- JCPU — The CPU time used by all processes associated with the login.

- PCPU — The CPU time associated with the process listed in the WHAT field.

- WHAT — The command currently being executed by the user.

#### Update

Gw does not update its statistics automatically. You must click on the Update Information to have the program display the latest information.

### Menus

The menu bar, located at the top of the Main Window, contains the following menus:

File

  This menu contains: Ctrl-Q Quit which exits the program.

Settings

  This menu contains:

  Ctrl-P Preferences which opens a dialog box allowing you to set up a menu executing other commands, such as talk, through Gw's interface to communicate with others users on the machine. For more information on talk, see the talk man page.

Help

  This menu contains:

  - Help — shows this manual.

  - About — shows basic information about Gw, such as the author's name and the application version number.

## Customization

By right-clicking on Gw's main window, you can bring up a pop-up menu of commands to be used for communicating with other users. But before you can do that, you need to configure the program's preferences settings to set up the menu.

To do that, select Preferences… from the Settings menu. This opens the Menu items dialog, shown in .

### Preferences Dialog

Preferences dialog

The main window pane of the Menu items window contains a listing the commands you'll see on the right-click menu. If the pane is empty, click on the Add some defaults button to fill in a list of basic commands useful in this situation.

Each command has a Name field and a Command Line field. The Name is the word that will appear on the right-click menu in GW's main window. The Command Line field is the command that will be executed.

For example, the predefined `talk` command, one of the defaults included when you click on Add some defaults, works this way: In Gw's main window, click on the name of the person you want to talk with, then right-click in Gw's main window and click on the talk menu item. Gw will execute the `talk` command, opening up an xterm and commencing a talk session with the user and terminal you had selected in the main window.

To add a command, click add and type in the command name and command in the text boxes at the top of the window. To delete a command, click on the command you want to delete, then the delete button.

After you have made all the changes you want, click on Apply to apply the changes, or OK to apply the changes and close the Properties dialog. To cancel the changes and return to previous values, click the Close button.

## Authors

Gw was written by Havoc Pennington (hp@redhat.com). Please send all comments, suggestions, and bug reports to the GNOME bug tracking database. (Instructions for submitting bug reports can be found on-line.) If you are using GNOME 1.1 or later, you can also use Bug Report Tool (`bug-buddy`), available in the Utilities submenu of Main Menu, for submitting bug reports.

This manual was written by John Fleck (jfleck@inkstain.net). Please send all comments and suggestions regarding this manual to the GNOME Documentation Project by sending an email to docs@gnome.org. You can also add your comments online by using the GNOME Documentation Status Table.

## License

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; either version 2 of the License, or (at your option) any later version.

This program 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 may obtain a copy of the GNU General Public License from the Free Software Foundation by visiting their Web site or by writing to

        Free Software Foundation, Inc.
        59 Temple Place - Suite 330
        Boston, MA 02111-1307
        USA