remove extraneous svn:executable properties
[asterisk/asterisk.git] / utils / astman.1
1 .\" $Header$
2 .\"
3 .\"     transcript compatibility for postscript use.
4 .\"
5 .\"     synopsis:  .P! <file.ps>
6 .\"
7 .de P!
8 .fl
9 \!!1 setgray
10 .fl
11 \\&.\"
12 .fl
13 \!!0 setgray
14 .fl                     \" force out current output buffer
15 \!!save /psv exch def currentpoint translate 0 0 moveto
16 \!!/showpage{}def
17 .fl                     \" prolog
18 .sy sed \-e 's/^/!/' \\$1\" bring in postscript file
19 \!!psv restore
20 .
21 .de pF
22 .ie     \a\\*(f1\a\a .ds f1 \\n(.f
23 .el .ie \a\\*(f2\a\a .ds f2 \\n(.f
24 .el .ie \a\\*(f3\a\a .ds f3 \\n(.f
25 .el .ie \a\\*(f4\a\a .ds f4 \\n(.f
26 .el .tm ? font overflow
27 .ft \\$1
28 ..
29 .de fP
30 .ie     !\a\\*(f4\a\a \{\
31 .       ft \\*(f4
32 .       ds f4\"
33 '       br \}
34 .el .ie !\a\\*(f3\a\a \{\
35 .       ft \\*(f3
36 .       ds f3\"
37 '       br \}
38 .el .ie !\a\\*(f2\a\a \{\
39 .       ft \\*(f2
40 .       ds f2\"
41 '       br \}
42 .el .ie !\a\\*(f1\a\a \{\
43 .       ft \\*(f1
44 .       ds f1\"
45 '       br \}
46 .el .tm ? font underflow
47 ..
48 .ds f1\"
49 .ds f2\"
50 .ds f3\"
51 .ds f4\"
52 '\" t 
53 .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n  
54 .TH ASTMAN 1 "Jun 12th, 2005" "astman" "Linux Programmer's Manual"
55 .SH NAME
56 .B astman
57 -- a client to asterisk's manager interface
58 .SH SYNOPSIS
59 .PP 
60 .B astman
61 .I hostname
62
63 .SH DESCRIPTION
64 .B astman
65 This program is a full-screen (terminal) client for Asterisk's manager
66 interface.
67
68 .SH OPTIONS
69 .B hostname
70
71 The host name or IP address to connect to (TCP port 5038). If astman 
72 fails to connect it will exit immidiately.
73
74 .SH USAGE
75 If \fBastman\fR has successfully cunnected to the manager port it will 
76 prompt the user for a username and a secret (password) for the manager 
77 interface on the remote Asterisk manager interface. It will then be able 
78 to report existing channels (calls). You will then be able to redirect 
79 calls to or terminate them.
80
81 .SH "SEE ALSO" 
82 asterisk(8)
83
84 http://www.voip-info.org/wiki-Asterisk+astman
85
86 .SH BUGS
87 The hostname does not default to localhost.  
88
89 Impossible to use a port other than 5038.
90
91 The username and password cannot be defined from the command-line.
92
93 I mean, what's the point in a man page if the syntax is so simple?
94
95 .SH "AUTHOR" 
96 This manual page was written by Tzafrir Cohen <tzafrir.cohen@xorcom.com> 
97 Permission is granted to copy, distribute and/or modify this document under 
98 the terms of the GNU General Public License, Version 2 any  
99 later version published by the Free Software Foundation. 
100
101 On Debian systems, the complete text of the GNU General Public 
102 License can be found in /usr/share/common-licenses/GPL.