adding freeside-sqlradius-seconds
[freeside.git] / FS / bin / freeside-sqlradius-seconds
1 #!/usr/bin/perl -Tw
2
3 use strict;
4 use Date::Parse;
5 use FS::UID qw(adminsuidsetup);
6 use FS::Record qw(qsearchs);
7 use FS::svc_acct;
8
9 my $fs_user = shift or die &usage;
10 adminsuidsetup( $fs_user );
11
12 my $target_user = shift or die &usage;
13 my $start = shift or die &usage;
14 my $stop = shift || time;
15
16 my $svc_acct = qsearchs( 'svc_acct', { 'username' => $target_user } );
17 die "username $target_user not found\n" unless $svc_acct;
18
19 print $svc_acct->seconds_since_sqlradacct( str2time($start), str2time($stop) );
20
21 sub usage {
22   die "Usage:\n\n  freeside-sqlradius-seconds freeside_username target_username start_date stop_date\n";
23 }
24
25
26 =head1 NAME
27
28 freeside-sqlradius-seconds - Real-time radacct import daemon
29
30 =head1 SYNOPSIS
31
32   freeside-sqlradius-seconds freeside_username target_username start_date [ stop_date ]
33
34 =head1 DESCRIPTION
35
36 Returns the number of seconds the specified username has been online between
37 start_date (inclusive) and stop_date (exclusive).
38 See L<FS::svc_acct/seconds_since_sqlradacct>
39
40 B<freeside_username> is a username added by freeside-adduser.
41 B<target_username> is the username of the user account to query.
42 B<start_date> and B<stop_date> are in any format Date::Parse is happy with.
43 B<stop_date> defaults to now if not specified.
44
45 =head1 BUGS
46
47 Selection of the account in question is rather simplistic in that
48 B<target_username> doesn't necessarily identify a unique account (and wouldn't
49 even if a domain was specified), and no sqlradius export is checked for.
50
51 =head1 SEE ALSO
52
53 L<FS::svc_acct/seconds_since_sqlradacct>
54
55 =cut
56
57 1;