File: README

package info (click to toggle)
qtsmbstatus 2.2.1-2
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 1,364 kB
  • sloc: cpp: 4,333; sh: 131; makefile: 16
file content (161 lines) | stat: -rw-r--r-- 5,621 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
-*------------------------------------------------------------------------+-

       QtSmbstatus

       http://qtsmbstatus.free.fr/
       Daniel Rocher - ADELLA <daniel.rocher@adella.org>

-*------------------------------------------------------------------------+-

This program is licensed to you under the terms of the GNU General Public License version 2

QtSmbstatus is a smbstatus graphical interface (GUI).
It is meant to provide the possibility of administering remote machines. QtSmbstatus was designed as a client/server system secured with SSL. A login and password is required to log on to server. The server's application ought to be installed with samba-server.

qtsmbstatus-server provides the server-side application.
qtsmbstatus-client provides the qtsmbtatus client application.
qtsmbstatus-light provides the lightweight application which works only locally and doesn't require qtsmbstatus-server.

Possibilities include:
- view connections
- disconnect user
- send out  messages (popupwindows) to one or many users

1/ Compilation from the following sources
2/ Command line options
3/ Start and stop server
4/ Configure server
5/ Client for X11 (Unix/Linux)
6/ Client for Windows

-------------------------------------------------------------
1/ Compilation from the following sources:
-------------------------------------------------------------

        To install qtsmbstatus light:
        *****************************

        Check dependency: qt4-dev>=4.3

                  cd light
                  qmake (or qmake-qt4)
                  make

        and as root:
                  make install


        To install qtsmbstatus server:
        ******************************

        Check dependency: pam-dev and qt4-dev>=4.3

                  cd server
                  qmake (or qmake-qt4)
                  make

        and as root:
                  make install


        To install qtsmbstatus client:
        ******************************

        Check dependency: qt4-dev>=4.3

                  cd client
                  qmake (or qmake-qt4)
                  make

        and as root:
                  make install

-------------------------------------------------------------
2/ Command line options:
-------------------------------------------------------------

        qtsmbstatus (light, client and server) can accept some arguments from the command line, to know them:

        qtsmbstatusd --help (for server)
        qtsmbstatus --help (for client)
        qtsmbstatusl --help (for light)


-------------------------------------------------------------
3/ Start and stop server:
-------------------------------------------------------------

        Start server:
                  /etc/init.d/qtsmbstatusd start
              or 
                  service qtsmbstatusd start
                  Default port: 4443

        Stop server:
                  /etc/init.d/qtsmbstatusd stop
              or
                  service qtsmbstatusd stop

-------------------------------------------------------------
4/ Configure server:
-------------------------------------------------------------

        The server's configuration files are found at:
                  /etc/qtsmbstatusd/

        in this directory:
                  privkey.pem
                  qtsmbstatusd.conf
                  qtsmbstatusd.users
                  server.pem

        privkey.pem : private key (warning! Change file access permissions  : 640 ! )
        To make your own: openssl genrsa -des3 -out privkey.pem 2048
        
        server.pem : selfsigned certificat with key
        To make your own: openssl req -new -x509 -key privkey.pem -out server.pem -days 10000

        Options are saved into : qtsmbstatusd.conf
                port :                   Port where the server should listen at 
                private_key :            private key       
                certificat :             ssl certificate
                ssl_password :           password for ssl certificate
                permit_disconnect_user : Allow client to disconnect a user
                                         You can authorize a client to disconnect a user. Use Username
                                         or 'all' for all clients.
                permit_send_msg :        Allow client to send a message
                                         You can authorize a client to Send message. Use Username or 'all' for all clients.

        == PAM: ==
        PAM configuration file is distribution dependent. If logon failed, change it:
                /etc/pam.d/qtsmbstusd

       see samples here: ./server/pam.d/samples/

       The authorized users (PAM) are registered into: /etc/qtsmbstatusd/qtsmbstatusd.users
         (default as root)

------------------------------------------------------------- 
5/ Client for X11 (Unix/Linux) :
-------------------------------------------------------------

        Execute under X11: qtsmbstatus
        Enter server's IP address, connect and log on (login and password).
 
        Right clic on user to send him a message or to disconnect him.
        (popupwindows require smbclient)

         
------------------------------------------------------------- 
6/ Client for Windows :
-------------------------------------------------------------

        Install qtsmbstatus-client.X.X.X.exe
        Execute qtsmbstatus.exe
        
        Enter server's IP address, connect and log on (login and password).
 
        Right clic on user to send him a message or to disconnect him.
        (popupwindows require smbclient)