Changes

Jump to navigation Jump to search
1,766 bytes added ,  02:06, 30 January 2019
→‎External terminal: make it more English
Line 8: Line 8:  
== Supported terminal types ==
 
== Supported terminal types ==
   −
There are wide range of terminals exist in linux world: ''unix98'' psesudoterminals ('''pty'''), ''bsd'' terminals, ''virtual'' terminals ('''vt''') and etc. In CRIU we support the '''pty''' completely and '''vt''' in a way full enough for enough for work. By full support we mean complete save of pty internal state including queued data. In turn for '''vt''' only plain restoration supported which means it is complete enough to do a traditional operations with terminals after restore but if there was some data queued and not yet delivered to a terminal user it will be lost. It is worth to mention that such situation should not be treated as any kind of error -- the terminal transport layer never ever be one with guaranteed data delivery.
+
There are wide range of terminals exist in linux world: ''unix98'' psesudoterminals ('''pty'''), ''bsd'' terminals, ''virtual'' terminals ('''vt''') and etc. In CRIU we support the '''pty''' completely and '''vt''' in a way full enough for work. By full support we mean complete save of '''pty''' internal state including queued data. In turn for '''vt''' only plain restoration supported which means it is complete enough to do a traditional operations with terminals after restore but if there was some data queued and not yet delivered to a terminal user it will be lost. It is worth to mention that such situation should not be treated as any kind of error - the terminal transport layer never ever be one with guaranteed data delivery.
 +
 
 +
Overall CRIU supports the following terminals:
 +
 
 +
* console
 +
* current
 +
* virtual
 +
* external
 +
* serial
 +
* unix98
 +
 
 +
=== Console terminal ===
 +
 
 +
'''console''' terminal is the most simple one. Its restore is just literally <code>open(/dev/console)</code>.
 +
 
 +
=== Current terminal ===
 +
 
 +
'''current''' terminal is rather an abstraction over real terminal an application uses. Upon its opening the kernel simply provides back the reference to the real one thus the same way as for '''console''' its restore is just <code>open(/dev/tty)</code> with one exception - it must be restored last, ie after all other terminals are restored.
 +
 
 +
=== Virtual terminal ===
 +
 
 +
'''vt''' stands for ''ttyN'' devices for which restore we simply do <code>open(/dev/ttyN)</code>, where N is a number.
 +
 
 +
=== External terminal ===
 +
 
 +
'''external''' terminals stands for cases when file descriptors known to be changing between checkpoint/restore cycles and passed from command line options, see [[Inheriting FDs on restore]] for details. For this kind of terminals we are relying on the file descriptors to be already opened and passed, so on restore we simply reuse them.
 +
 
 +
=== Serial terminal ===
 +
 
 +
'''serial''' terminals are supported for debug purpose mostly, in particular some developers pass through into virtual machine with this terminals. Its restore as simple as plain <code>open()</code> call.
 +
 
 +
=== Unix98 terminal ===
 +
 
 +
'''pty''' terminals are most commonly used over all other kinds. The '''pty''' represent a pair of peers: upon <code>open(/dev/ptmx)</code> the kernel automatically create <code>/dev/pts/N</code> slave peer, where N is a numeric index of the pair opened. Thus on restore we simply need ''ptmx'' device and give process master and slave descriptors.
 +
 
 +
== See also ==
 +
* [[External files]]

Navigation menu