|
Finger-Based Drink Client
Introduction
This page describes how to use the drink system's finger-protocol-based client
to access information regarding each of the drink machines and their users..
Most notably, the client allows users to quickly receive a slot listing for a specific
machine, without logging in.
Basics
Each of the drink machines run a finger-protocol server. By using the 'finger'
command with the appropriate information, the finger client will connect to the
machine, send the specified target to the machine, and display the response.
For example, a user might issue the following command on their own machine:
'finger @drink.csh.rit.edu'.
That command will connect to drink.csh.rit.edu on TCP port 79, and send a
zero-length string as the finger target to the machine. The machine will
interpret that as a request for a basic listing, and will return the machine's
slot printout and temperature readings.
Basic Usage
To use the client, finger one of the targets on the machine you desire.
finger syntax is '[target]@[host]'
target - can be a username or a simple informational target.
host - the hostname of the machine whose finger server you wish to
connect to. Also see the section Hostnames.
Note that the finger command is conventionally used to finger a user on a
computer system.
The targets are:
- @machine
- temp@machine
- help@machine; info@machine
- [slot index]@machine; [slot name]@machine
- [user]@machine
Finger Targets
Here is a breakdown of each target, and what it does.
- @machine - returns a basic listing of beverages:
fury(~) > finger @drink
[drink]
Motd: Welcome !
Location: NRH (North)
SLOT DRINK COST # LEFT # SOLD
-----------------------------------------------
0 Yoohoo 50 6 314
1 Cherry Coke 50 50 115
2 Coke 50 21 191
3 Dr. Pepper 50 50 206
4 Barqs 40 6 5
5 IBC Rootbeer 50 0 96
6 Jolt 60 35 101
-----------------------------------------------
The power supply heatsink temp is 42.0
Drink temperature is 42.0
- temp@machine - returns various temperature readings.
fury(~) > finger temp@drink
[drink]
Motd: Welcome !
Location: NRH (North)
The power supply heatsink temp is 42.0
Drink temperature is 42.0
- info@machine; help@machine - provides a simple help message.
fury(~) > finger info@drink
[drink]
Motd: Welcome !
Location: NRH (North)
Welcome to the CSH drink server.
Drink currently contains:
Yoohoo, Cherry Coke, Coke, Dr. Pepper, Barqs, IBC Rootbeer & Jolt.
For general stats finger @drink.csh.rit.edu,
for stats on a specific slot finger
[name]@drink.csh.rit.edu or by slot number
[number]@drink.csh.rit.edu.
- [slot index]@machine; [slot name]@machine - Provides information about a single slot in the machine.
[feature currently not available]
- [user]@machine - Provides information on a drink users account.
fury(~) >finger antiduh@drink
[drink]
Motd: Welcome !
Location: NRH (North)
Drink info on antiduh.
Balance: 290
antiduh is an admin.
Drink Machine Hostnames
Current, there are two drink machines on CSH's floor. Big Drink (also
known as just 'Drink') and Little Drink.
Both machines each have two hostnames:
Big drink has drink.csh.rit.edu and d.csh.rit.edu.
Little drink has littledrink.csh.rit.edu and ld.csh.rit.edu
The smaller hostnames are provided for simplicity. They were provided because
the machines are connected to commonly from CSH's own network, and thus just the
machine name could be used to connect.
For example:
fury(~) > finger @d
This document is maintained by Kevin Thompson [antiduh@csh.rit.edu]
Last Revised: $Date: 2003/08/10 $
|