← Back to branch summary

~azzar1/unity/add-show-desktop-key

« back to all changes in this revision

Viewing changes to doc/man/faq.rst

  • Committer: David Coles
  • Date: 2009-12-09 06:23:35 UTC
  • Revision ID: coles.david@gmail.com-20091209062335-yoyn9jmdqmu4jjwp
FAQs for common error messages

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/man/faq.rst
62
62
 
63
63
The default is :file:`/var/lib/ivle/sessions`.
64
64
 
 
65
 
 
66
... ivle-buildjail throw an UnsafeJail exception
 
67
------------------------------------------------
 
68
 
 
69
When running :program:`ivle-buildjail` you may occasionally see an error 
 
70
like::
 
71
 
 
72
    Traceback (most recent call last):
 
73
      File "bin/ivle-buildjail", line 158, in <module>
 
74
        raise UnsafeJail(d)
 
75
    __main__.UnsafeJail: /var/lib/ivle/jails/__base_build__/tmp/.ICE-unix
 
76
 
 
77
This means that writable files exist in the Jail template. If left in the jail 
 
78
then users would be able to edit a file that is shared between all jail 
 
79
instances. The usual solution is just to remove these file from the jail build 
 
80
directory and try again.
 
81
 
 
82
 
 
83
... the console return 'Console Restart' messages
 
84
-------------------------------------------------
 
85
 
 
86
There are three cases where a console may be restarted:
 
87
 
 
88
1. **Console Restart: The IVLE console has timed out due to inactivity**
 
89
 
 
90
    The Python console process is no longer running. This is most likey due to 
 
91
    the console process being automatically terminated due to no messages 
 
92
    being sent or received by the console in the previous 15 minutes.
 
93
 
 
94
    This message can also be triggered if the console is terminated for 
 
95
    another reason (such as being sent :const:`SIGKILL` from the system 
 
96
    command line or any other fatal signal).
 
97
 
 
98
2. **Console Restart: CPU Time Limit Exceeded**
 
99
 
 
100
   To prevent exhaustion of local system resources, Python console processes 
 
101
   are set with an CPU Time Limit of 25 seconds of user time (time executing 
 
102
   on the CPU rather than real "clock-on-the-wall" time).
 
103
 
 
104
   This setting can be configured by changing the values associated with 
 
105
   :const:`RLIMIT_CPU` in :file:`bin/trampoline/trampoline.c`.
 
106
 
 
107
3. **Console Restart: Communication to console process lost**
 
108
 
 
109
    IVLE was unable to understand a response from the console process. This 
 
110
    will only happen if the console sends a malformed response and quite 
 
111
    likely a bug.
 
112
 
 
113
4. **Console Restart: Communication to console process reset**
 
114
 
 
115
    IVLE's TCP connection to the console process was reset. May indicate 
 
116
    network issues.
 
117