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
|
NAME
FS::svc_domain - Object methods for svc_domain records
SYNOPSIS
use FS::svc_domain;
$record = new FS::svc_domain \%hash;
$record = new FS::svc_domain { 'column' => 'value' };
$error = $record->insert;
$error = $new_record->replace($old_record);
$error = $record->delete;
$error = $record->check;
$error = $record->suspend;
$error = $record->unsuspend;
$error = $record->cancel;
DESCRIPTION
An FS::svc_domain object represents a domain. FS::svc_domain
inherits from FS::svc_Common. The following fields are currently
supported:
svcnum - primary key (assigned automatically for new accounts)
domain
METHODS
new HASHREF
Creates a new domain. To add the domain to the database, see
the section on "insert".
insert
Adds this domain to the database. If there is an error,
returns the error, otherwise returns false.
The additional fields *pkgnum* and *svcpart* (see the
FS::cust_svc manpage) should be defined. An FS::cust_svc
record will be created and inserted.
The additional field *action* should be set to *N* for new
domains or *M* for transfers.
A registration or transfer email will be submitted unless
$FS::svc_domain::whois_hack is true.
The additional field *email* can be used to manually set the
admin contact email address on this email. Otherwise, the
svc_acct records for this package (see the FS::cust_pkg
manpage) are searched. If there is exactly one svc_acct
record in the same package, it is automatically used.
Otherwise an error is returned.
delete
Deletes this domain from the database. If there is an error,
returns the error, otherwise returns false.
The corresponding FS::cust_svc record will be deleted as
well.
replace OLD_RECORD
Replaces OLD_RECORD with this one in the database. If there
is an error, returns the error, otherwise returns false.
suspend
Just returns false (no error) for now.
Called by the suspend method of FS::cust_pkg (see the
FS::cust_pkg manpage).
unsuspend
Just returns false (no error) for now.
Called by the unsuspend method of FS::cust_pkg (see the
FS::cust_pkg manpage).
cancel
Just returns false (no error) for now.
Called by the cancel method of FS::cust_pkg (see the
FS::cust_pkg manpage).
check
Checks all fields to make sure this is a valid domain. If
there is an error, returns the error, otherwise returns
false. Called by the insert and replace methods.
Sets any fixed values; see the FS::part_svc manpage.
_whois
Executes the command:
whois do $domain
and returns the output.
(Always returns *No match for domian "$domain".* if
$FS::svc_domain::whois_hack is set true.)
submit_internic
Submits a registration email for this domain.
VERSION
$Id: svc_domain.txt,v 1.4 1999-04-08 13:39:32 ivan Exp $
BUGS
All BIND/DNS fields should be included (and exported).
Delete doesn't send a registration template.
All registries should be supported.
Should change action to a real field.
The $recref stuff in sub check should be cleaned up.
SEE ALSO
the FS::svc_Common manpage, the FS::Record manpage, the FS::Conf
manpage, the FS::cust_svc manpage, the FS::part_svc manpage, the
FS::cust_pkg manpage, the FS::SSH manpage, the ssh manpage, the
dot-qmail manpage, schema.html from the base documentation,
config.html from the base documentation.
HISTORY
ivan@voicenet.com 97-jul-21
rewrite ivan@sisd.com 98-mar-10
add internic bits ivan@sisd.com 98-mar-14
Changed 'day' to 'daytime' because Pg6.3 reserves the day word
bmccane@maxbaud.net 98-apr-3
/var/spool/freeside/conf/registries/internic/, Mail::Internet,
etc. ivan@sisd.com 98-jul-17-19
pod, some FS::Conf (not complete) ivan@sisd.com 98-sep-23
$Log: svc_domain.txt,v $
Revision 1.4 1999-04-08 13:39:32 ivan
convert from pod for 1.2.0 release
Revision 1.7 1999/04/07 14:40:15 ivan
use all stuff that's qsearch'ed to avoid warnings
Revision 1.6 1999/01/25 12:26:17 ivan yet more mod_perl stuff
Revision 1.5 1998/12/30 00:30:47 ivan svc_ stuff is more
properly OO - has a common superclass FS::svc_Common
Revision 1.3 1998/11/13 09:56:57 ivan change configuration file
layout to support multiple distinct databases (with own set of
config files, export, etc.)
Revision 1.2 1998/10/14 08:18:21 ivan More informative error
messages and better doc for admin contact email stuff
|