Hide keyboard shortcuts

Hot-keys on this page

r m x p   toggle line displays

j k   next/prev highlighted chunk

0   (zero) top of page

1   (one) first highlighted chunk

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

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

318

319

320

321

322

# 

# errors.py: exception classes used throughout anaconda 

# 

# Copyright (C) 2012 Red Hat, Inc. All rights reserved. 

# 

# This program is free software; you can redistribute it and/or modify 

# it under the terms of the GNU General Public License as published by 

# the Free Software Foundation; either version 2 of the License, or 

# (at your option) any later version. 

# 

# This program is distributed in the hope that it will be useful, 

# but WITHOUT ANY WARRANTY; without even the implied warranty of 

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 

# GNU General Public License for more details. 

# 

# You should have received a copy of the GNU General Public License 

# along with this program. If not, see <http://www.gnu.org/licenses/>. 

 

from pyanaconda.core.i18n import _, C_ 

from pyanaconda.flags import flags 

 

__all__ = ["ERROR_RAISE", "ERROR_CONTINUE", "ERROR_RETRY", "errorHandler", "InvalidImageSizeError", 

"MissingImageError", "ScriptError", "NonInteractiveError", "CmdlineError", "ExitError"] 

 

 

class InvalidImageSizeError(Exception): 

def __init__(self, message, filename): 

Exception.__init__(self, message) 

self.filename = filename 

 

 

class MissingImageError(Exception): 

pass 

 

 

class ScriptError(Exception): 

def __init__(self, lineno, details): 

Exception.__init__(self) 

self.lineno = lineno 

self.details = details 

 

 

class NonInteractiveError(Exception): 

pass 

 

 

class CmdlineError(NonInteractiveError): 

pass 

 

 

class RemovedModuleError(ImportError): 

pass 

 

 

class PasswordCryptError(Exception): 

def __init__(self, algo): 

Exception.__init__(self) 

self.algo = algo 

 

 

class ZIPLError(Exception): 

pass 

 

 

class ExitError(RuntimeError): 

pass 

 

 

# These constants are returned by the callback in the ErrorHandler class. 

# Each represents a different kind of action the caller can take: 

# 

# ERROR_RAISE - This is a fatal error, and anaconda can do nothing but quit 

# or raise an exception. This then feeds into the exception 

# handling framework. 

# 

# ERROR_CONTINUE - anaconda should continue with whatever it was going to do. 

# This result comes from non-fatal errors, asking yes/no 

# questions, and the like. 

# 

# ERROR_RETRY - This is a serious problem, but anaconda should attempt to 

# try again. Continued failures may eventually result in an 

# ERROR_RAISE. 

ERROR_RAISE = 0 

ERROR_CONTINUE = 1 

ERROR_RETRY = 2 

 

 

### 

### TOP-LEVEL ERROR HANDLING OBJECT 

### 

 

class ErrorHandler(object): 

"""This object makes up one part of anaconda's error handling system. This 

part is the UI-agnostic error callback. Throughout anaconda, various 

error conditions can occur in places that need to pop up a dialog, but 

should not know anything about the type or details of the UI. In order 

to accomplish this, each pyanaconda.ui.UserInterface subclass presents a 

common set of dialog methods. 

 

The entry point to these methods is through the cb method of this class, 

which acts as a dispatcher to the appropriate handler, which in turn 

pops up the correct kind of dialog. The result of all this is one of the 

ERROR_* constants defined elsewhere in this module. The original calling 

code must then interpret this result and take the appropriate action. 

 

For details on the other parts of the error handling system, see the 

documentation for pyanaconda.ui.UserInterface and pyanaconda.exception. 

""" 

def __init__(self, ui=None): 

self.ui = ui 

 

def _partitionErrorHandler(self, exn): 

message = _("The following errors occurred with your partitioning:\n\n%(errortxt)s\n\n" 

"The installation will now terminate.") % {"errortxt": exn} 

self.ui.showError(message) 

return ERROR_RAISE 

 

def _fsResizeHandler(self, exn): 

message = _("An error occurred while resizing the device %s.") % exn 

 

if exn.details: 

message += "\n\n%s" % exn.details 

 

self.ui.showError(message) 

return ERROR_RAISE 

 

def _storageResetHandler(self, exn): 

message = (_("There is a problem with your existing storage " 

"configuration: %(errortxt)s\n\n" 

"You must resolve this matter before the installation can " 

"proceed. There is a shell available for use which you " 

"can access by pressing ctrl-alt-f1 and then ctrl-b 2." 

"\n\nOnce you have resolved the issue you can retry the " 

"storage scan. If you do not fix it you will have to exit " 

"the installer.") % {"errortxt": exn}) 

details = _(exn.suggestion) 

buttons = (C_("GUI|Storage Detailed Error Dialog", "_Exit Installer"), 

C_("GUI|Storage Detailed Error Dialog", "_Retry")) 

if self.ui.showDetailedError(message, details, buttons=buttons): 

return ERROR_RETRY 

else: 

return ERROR_RAISE 

 

def _noDisksHandler(self, exn): 

message = _("An error has occurred - no valid devices were found on " 

"which to create new file systems. Please check your " 

"hardware for the cause of this problem.") 

self.ui.showError(message) 

return ERROR_RAISE 

 

def _fstabTypeMismatchHandler(self, exn): 

# FIXME: include the two types in the message instead of including 

# the raw exception text 

message = _("There is an entry in your /etc/fstab file that contains " 

"an invalid or incorrect file system type:\n\n") 

message += " " + str(exn) 

self.ui.showError(message) 

 

def _invalidImageSizeHandler(self, exn): 

message = _("The ISO image %s has a size which is not " 

"a multiple of 2048 bytes. This may mean " 

"it was corrupted on transfer to this computer." 

"\n\n" 

"It is recommended that you exit and abort your " 

"installation, but you can choose to continue if " 

"you think this is in error. Would you like to " 

"continue using this image?") % exn.filename 

if self.ui.showYesNoQuestion(message): 

return ERROR_CONTINUE 

else: 

return ERROR_RAISE 

 

def _missingImageHandler(self, exn): 

message = _("The installer has tried to mount the " 

"installation image, but cannot find it on " 

"the hard drive.\n\n" 

"Should I try again to locate the image?") 

if self.ui.showYesNoQuestion(message): 

return ERROR_RETRY 

else: 

return ERROR_RAISE 

 

def _noSuchGroupHandler(self, exn): 

if exn.required: 

message = _("The group '%s' is required for this installation. " 

"This group does not exist. This is a fatal error and " 

"installation will be aborted.") % exn.group 

self.ui.showError(message) 

return ERROR_RAISE 

elif exn.adding: 

message = _("You have specified that the group '%s' should be " 

"installed. This group does not exist. Would you like " 

"to ignore this group and continue with " 

"installation?") % exn.group 

else: 

message = _("You have specified that the group '%s' should be " 

"excluded from installation. This group does not exist. " 

"Would you like to ignore this group and continue with " 

"installation?") % exn.group 

 

if self.ui.showYesNoQuestion(message): 

return ERROR_CONTINUE 

else: 

return ERROR_RAISE 

 

def _noSuchPackageHandler(self, exn): 

if exn.required: 

message = _("The package '%s' is required for this installation. " 

"This package does not exist. This is a fatal error and " 

"installation will be aborted.") % exn.package 

self.ui.showError(message) 

return ERROR_RAISE 

 

else: 

message = _("You have specified that the package '%s' should be " 

"installed. This package does not exist. Would you " 

"like to ignore this package and continue with " 

"installation?") % exn.package 

 

if self.ui.showYesNoQuestion(message): 

return ERROR_CONTINUE 

else: 

return ERROR_RAISE 

 

def _scriptErrorHandler(self, exn): 

message = _("There was an error running the kickstart script at line " 

"%(lineno)s. This is a fatal error and installation will be " 

"aborted. The details of this error are:\n\n%(details)s") % \ 

{"lineno": exn.lineno, "details": exn.details} 

self.ui.showError(message) 

return ERROR_RAISE 

 

def _payloadInstallHandler(self, exn): 

message = _("The following error occurred while installing. This is " 

"a fatal error and installation will be aborted.") 

message += "\n\n" + str(exn) 

 

self.ui.showError(message) 

return ERROR_RAISE 

 

def _dependencyErrorHandler(self, exn): 

message = _("The following software marked for installation has errors. " 

"This is likely caused by an error with\nyour installation source.") 

details = str(exn) 

 

self.ui.showDetailedError(message, details) 

return ERROR_RAISE 

 

def _bootLoaderErrorHandler(self, exn): 

message = _("The following error occurred while installing the boot loader. " 

"The system will not be bootable. " 

"Would you like to ignore this and continue with " 

"installation?") 

message += "\n\n" + str(exn) 

 

if self.ui.showYesNoQuestion(message): 

return ERROR_CONTINUE 

else: 

return ERROR_RAISE 

 

def _passwordCryptErrorHandler(self, exn): 

message = _("Unable to encrypt password: unsupported algorithm %s") % exn.algo 

 

self.ui.showError(message) 

return ERROR_RAISE 

 

def _ziplErrorHandler(self, exn): 

details = str(exn) 

message = _("Installation was stopped due to an error installing the " 

"boot loader. The exact error message is:\n\n%s\n\n" 

"The installer will now terminate.") % details 

 

self.ui.showError(message) 

return ERROR_RAISE 

 

def cb(self, exn): 

"""This method is the callback that all error handling should pass 

through. The return value is one of the ERROR_* constants defined 

in this module, though the exact constant returned depends on the 

kind of exception being handled. 

 

Arguments: 

 

exn -- An instance of some Exception. 

""" 

rc = ERROR_RAISE 

 

if not self.ui: 

raise exn 

 

if not flags.ksprompt: 

raise NonInteractiveError("Non interactive installation failed: %s" % exn) 

 

_map = {"PartitioningError": self._partitionErrorHandler, 

"FSResizeError": self._fsResizeHandler, 

"UnusableConfigurationError": self._storageResetHandler, 

"DiskLabelScanError": self._storageResetHandler, 

"CorruptGPTError": self._storageResetHandler, 

"DuplicateVGError": self._storageResetHandler, 

"NoDisksError": self._noDisksHandler, 

"FSTabTypeMismatchError": self._fstabTypeMismatchHandler, 

"InvalidImageSizeError": self._invalidImageSizeHandler, 

"MissingImageError": self._missingImageHandler, 

"NoSuchGroup": self._noSuchGroupHandler, 

"NoSuchPackage": self._noSuchPackageHandler, 

"ScriptError": self._scriptErrorHandler, 

"PayloadInstallError": self._payloadInstallHandler, 

"DependencyError": self._dependencyErrorHandler, 

"BootLoaderError": self._bootLoaderErrorHandler, 

"PasswordCryptError": self._passwordCryptErrorHandler, 

"ZIPLError": self._ziplErrorHandler} 

 

if exn.__class__.__name__ in _map: 

rc = _map[exn.__class__.__name__](exn) 

 

return rc 

 

 

# Create a singleton of the ErrorHandler class. It is up to the UserInterface 

# subclass to set errorHandler.ui before this class is ever used, or there will 

# be trouble. 

errorHandler = ErrorHandler()