source: trunk/athena/bin/athinfo/athinfo.1 @ 24428

Revision 24428, 5.0 KB checked in by broder, 15 years ago (diff)
athinfo: Apply the timeout to the entire query, not just the connection. An athinfo query could run for an arbitrary amount of time, which is really just as bad as taking an arbitrary time trying to establish a connection. Instead of timing out on the connect() itself, set an alarm before we connect and exit if the alarm goes off.
RevLine 
[22454]1.\" $Id: athinfo.1,v 1.5 2006-05-22 18:20:35 amb Exp $
[12111]2.\"
[23730]3.\" Copyright 1998-2009 by the Massachusetts Institute of Technology.
[12111]4.\"
5.\" Permission to use, copy, modify, and distribute this
6.\" software and its documentation for any purpose and without
7.\" fee is hereby granted, provided that the above copyright
8.\" notice appear in all copies and that both that copyright
9.\" notice and this permission notice appear in supporting
10.\" documentation, and that the name of M.I.T. not be used in
11.\" advertising or publicity pertaining to distribution of the
12.\" software without specific, written prior permission.
13.\" M.I.T. makes no representations about the suitability of
14.\" this software for any purpose.  It is provided "as is"
15.\" without express or implied warranty.
[23730]16.TH ATHINFO 1 "11 April 2009"
[12111]17.SH NAME
18athinfo \- Retrive information about a workstation
19.SH SYNOPSIS
[24423]20.B athinfo [-t \fIsecs\fP] \fIhost\fP \fIquery\fP
21.SH OPTIONS
22.IP "-t secs"
[24428]23max time to establish a connection and retrieve the query information
[12111]24.SH DESCRIPTION
25.B athinfo
26retrieves information from a workstation running the athinfo daemon
27(see
28.BR athinfod (8)).
[23730]29Standard queries implemented on Athena workstations typically include:
[12111]30.RS
[15089]31.TP 17
[12179]32.B queries
33The athinfo queries defined on the workstation
[15089]34.TP 17
[12111]35.B uname
36The workstation's "uname -a" output
[15089]37.TP 17
[12111]38.B machtype
39The platform name of the workstation
[15089]40.TP 17
[12111]41.B sysname
42The Athena system name of the workstation
[15089]43.TP 17
[22454]44.B cpuspeed
45The currently reported CPU speed of the workstation (may vary)
46.TP 17
[12111]47.B cputype
48The CPU type of the workstation
[15089]49.TP 17
[12111]50.B display
51The type of display on the workstation
[15089]52.TP 17
[12111]53.B disks
54The types of disks attached to the workstation
[15089]55.TP 17
[12111]56.B memory
57The amount of physical memory in the workstation
[15089]58.TP 17
[12179]59.B swap
60The workstation's swap configuration and free swap space
[15089]61.TP 17
[22454]62.B modules
63The workstation's currently-loaded kernel modules
64.TP 17
65.B packages
66The workstation's installed package list
67.TP 17
[12111]68.B rc.conf
69The contents of the workstation's Athena rc.conf file
[15089]70.TP 17
[12111]71.B version
72The contents of the workstation's Athena version file
[15089]73.TP 17
74.B clusterinfo
75The contents of the workstation's cached cluster information in C
76shell format.
77.TP 17
78.B clusterinfo.bsh
79The contents of the workstation's cached cluster information in Bourne
80shell format.
81.TP 17
[12111]82.B services
83The contents of the workstation's .services file
[15089]84.TP 17
85.B update.log
86The contents of the workstation's update log (only works if the
[23730]87workstation is set PUBLIC=true or is debathena-cluster)
[15089]88.TP 17
[23730]89.B reactivate.log
90The contents of the workstation's reactivate log (only works if the
91workstation is set PUBLIC=true or is debathena-cluster)
92.TP 17
93.B update-status
94On Debian/Ubuntu systems only, result of a simulated apt upgrade,
[24283]95including whether any packages were going to be upgraded. Note that
96this does not run aptitude update first!
[23730]97.TP 17
[24283]98.B policy
99On Debian/Ubuntu systems only, the apt repository policy, including
100all configured apt repositories/components and their priorities
101.TP 17
102.B hardware
103On Linux, the hardware's self-reported product name and version, from
104the DMI/SMBIOS interface
105.TP 17
[22454]106.B update.desync
[23730]107The contents of the workstation's update.desync file, if any
[22454]108.TP 17
109.B install.log
110The contents of the workstation's install log
111.TP 17
[12111]112.B date
113The workstation's local time
[15089]114.TP 17
[12111]115.B uptime
116The workstation's uptime, number of users, and load average
[15089]117.TP 17
[12111]118.B partitions
119The partition setup of the workstation's root disk
[15089]120.TP 17
121.B df
[22454]122The disk usage on the Athena-defined partitions of the workstation
[15089]123.TP 17
[12179]124.B interfaces
125The status of the workstation's network interfaces
[15089]126.TP 17
[12111]127.B routes
128The workstation's routing table
[15089]129.TP 17
[12111]130.B listeners
131A list of the workstation's TCP server sockets
[15089]132.TP 17
[12111]133.B login
1340 if logins on the workstation are enabled; 1 if not
[15089]135.TP 17
[22454]136.B patches
137On Solaris workstations only, the workstation's patch revision information
138.TP 17
139.B prom
140On Solaris workstations only, PROM version information
141.TP 17
142.B update.pkglog
143On Solaris workstations only, the contents of the workstation's package
144update log (only works if the workstation is set PUBLIC=true)
145.TP 17
146.B rvdinfo
147On Solaris workstations only, the contents of the .rvdinfo file on the
148workstation's system packs
149.TP 17
150.B verify.log
[23730]151On Red Hat workstations only, the contents of the workstation's boot-time
[22454]152public workstation verification log
153.TP 17
[22677]154.B xconf
[23730]155On Red Hat public workstations only, the contents of the workstation's X11
[22677]156configuration.
157.TP 17
[12148]158.B hinv
159On IRIX workstations only, displays the workstation's verbose hardware
160profile
[15089]161.TP 17
[12148]162.B instmach
[15089]163On IRIX workstations only, displays the machine variable settings
[22454]164determined by inst
[15089]165.TP 17
166.B instmachinv
[12148]167On IRIX workstations only, displays the machine variable settings used
[22454]168by inst the last time it ran
[15089]169.TP 17
[12148]170.B chkconfig
171On IRIX workstations only, displays the configuration settings set in
[22454]172.BR /etc/config
[12111]173.RE
174.SH "SEE ALSO"
175.BR athinfod (8)
176.SH AUTHOR
177Greg Hudson, MIT Information Systems
178.br
179Copyright 1998 by the Massachusetts Institute of Technology.
Note: See TracBrowser for help on using the repository browser.