debian/0000755000000000000000000000000012250640510007161 5ustar debian/compat0000644000000000000000000000000212136700367010371 0ustar 9 debian/doc0000644000000000000000000000001312136676666007673 0ustar design.txt debian/changelog0000644000000000000000000000141312250620273011036 0ustar sgabios (0.0~svn8-3) unstable; urgency=low * Made sgabios multiarch aware (Closes: #731490) * Set Standards-Version to 3.9.5 (no changes needed) -- Daniel Beyer Fri, 06 Dec 2013 09:25:03 +0100 sgabios (0.0~svn8-2) unstable; urgency=low * Added build dependency on gcc-multilib [amd64]. (Closes: #718142) * Added a symlink /usr/share/qemu/sgabios.bin pointing to the sgabios x86 bios option rom. This link was provided by qemu-system-x86 but has been removed after 1.5.0+dfsg-5 to prevent a possibly dangling symlink. -- Daniel Beyer Sun, 28 Jul 2013 12:08:57 +0200 sgabios (0.0~svn8-1) unstable; urgency=low * Initial Release. (Closes: #706204) -- Daniel Beyer Tue, 30 Apr 2013 06:28:41 +0200 debian/copyright0000644000000000000000000000312612137015031011114 0ustar Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/ Upstream-Name: sgabios Source: http://code.google.com/p/sgabios/ Files: * Copyright: 2007, 2008, 2009, 2010 Google Inc. License: Apache-2.0 Licensed under the Apache License, Version 2.0 (the "License"); you may not use this software except in compliance with the License. You may obtain a copy of the License at . http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. . On Debian systems the complete text of Apache License, Version 2.0 can be found in /usr/share/common-licenses/Apache-2.0. Files: debian/* Copyright: 2013 Daniel Beyer License: GPL-3+ The files related to the Debian packaging are free software: you can redistribute them and/or modify them under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. . The Debian packaging has been done 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. . On Debian systems the complete text of the GNU General Public License in version 3 can be found in /usr/share/common-licenses/GPL-3. debian/README.Debian0000644000000000000000000001170312155271167011240 0ustar 1) About SGABIOS ================ The Google Serial Graphics Adapter BIOS or SGABIOS allows one to interact with a physical or emulated system independent from the operation system on BIOS level. It does that by providing over a serial port the output capabilities normally featured by a VGA graphics card and the input capabilities normally handled by a keyboard. This is useful for selecting a boot-device during startup or to access feature provided by option roms (e.g. accessing a gPXE console). Further details can be found in file design.txt or online at . 2) What does SGABIOS works with? ================================ SGABIOS is a 16bit X86 bios option rom. Therefore it can run only on physical or emulated x86 hardware and has to be called from a compatible 16bit X86 BIOS. SeaBIOS is a 16bit X86 BIOS known to to work together with SGABIOS. 2.1) Using SGABIOS on physical X86 hardware =========================================== If you plan to equip physical X86 hardware with a SGABIOS enabled SeaBIOS, you can do this by using coreboot. Doing this is not scope of this README, but instructions how to do this can be found at . Please be warned that you can easily fry your physical X86 hardware if you flash over our existing BIOS - especially if the new contents of the flash is not provided by the vendor of our hardware. 2.2) Using SGABIOS on emulated X86 hardware =========================================== For serial BIOS redirection with emulated X86 hardware, SGABIOS can be used together with qemu, since SeaBIOS is used by qemu for x86 based emulated hardware and SeaBIOS features support for addressing the SGABIOS option rom at the right stage during startup. Other emulators for virtual machines might support SGABIOS as well, but are not covered by this README. 3) SGABIOS with qemu ==================== Since I/O of the virtual server driven by gemu is provided through a serial device, it is possible with qemu to redirect this on the host system in various ways. On possibility is to the redirect it on the host system using telnet, allowing easy remote access to the virtual server without using VNC. For other ways how to redirect the serial device on the host system, please take a look into the man page of qemu(1) and search for option "-serial" in it. 3.1) Using SGABIOS together with qemu ===================================== Note that you need qemu to emulate X86 hardware for SGABIOS. In Debian you therefore need to install the package qemu-system-x86. 3.1.1) Standalone SGABIOS ------------------------- It is possible to use SGABIOS with no other graphic adapter installed. In order to do so, start qemu with the following additional options: -vga none -display none -device sga Output will be send solely to the serial device in this case. 3.1.1.2) Hybrid SGABIOS and VGA graphic adapter ----------------------------------------------- Using SGABIOS it is supported to have output on the virtual graphics card as well as on the serial device. To achieve this, start qemu with the following two additional options: -vga cirrus -device sga Output will be send to virtual graphics card and the serial device. 3.2) Limitations of SGABIOS with qemu ===================================== SGABIOS will always use the first serial device configured in qemu using the option "-serial". By default qemu configures a first serial device of type "vc" in graphical mode and "stdio" in non graphical mode, as long as neither option "-nodefaults" nor a option "-serial" is provided. Therefor it is strongly recommended to always provide a option "-serial (...)" together with "-device sga". 3.3) Examples how to use SGABIOS together with qemu =================================================== The commands and qemu-system-i386 and qemu-system-x86_64 mentioned in the examples below can be found in the Debian package qemu-system-x86. 3.3.1 ) Use VNC to access the graphical and telnet to access the serial output ------------------------------------------------------------------------------ a) Start qemu (you can use either use qemu-system-i386 or qemu-system-x86_64): # qemu-system-x86_64 -boot menu=on -vga cirrus -vnc localhost:1 \ -device sga -serial telnet:localhost:4444,server b) Connect via telnet: # telnet localhost 4444 c) Connect via VNC: # vncviewer localhost:1 3.3.2 ) Only provide serial access via telnet by multiplexing the qemu-monitor ------------------------------------------------------------------------------ a) Start qemu (you can use either use qemu-system-i386 or qemu-system-x86_64): # qemu-system-x86_64 -boot menu=on -vga none -display none \ -device sga -serial mon:telnet:localhost:4444,server b) Connect via netcat: # telnet localhost 4444 c) Toggle between serial console and qemu-monitor: Press '' and 'a' together, followed by a press of 'c'. -- Daniel Beyer Sat, 27 Apr 2013 17:18:12 +0200 debian/lintian-overrides0000644000000000000000000000011712137015031012537 0ustar # Upstream does not provide a changelog. sgabios binary: no-upstream-changelog debian/links0000644000000000000000000000006612175231540010233 0ustar usr/share/misc/sgabios.bin usr/share/qemu/sgabios.bin debian/rules0000755000000000000000000000031012155271167010247 0ustar #!/usr/bin/make -f %: +dh $@ override_dh_auto_clean: make clean rm -f .depend override_dh_auto_configure override_dh_auto_test: # nothing to do override_dh_auto_install: chmod 644 sgabios.bin debian/control0000644000000000000000000000175112250620273010574 0ustar Source: sgabios Section: otherosfs Priority: optional Maintainer: Daniel Beyer Uploaders: Michael Tokarev Homepage: https://code.google.com/p/sgabios/ Build-Depends: debhelper (>= 9), gcc-multilib [amd64] Standards-Version: 3.9.5 Vcs-Browser: https://github.com/ymc/sgabios-debian Vcs-Git: git://github.com/ymc/sgabios-debian.git Package: sgabios Architecture: all Multi-Arch: foreign Depends: ${misc:Depends} Replaces: qemu-system-x86 (<= 1.5.0+dfsg-5) Description: bios option rom to provide legacy serial console for x86 The Google Serial Graphics Adapter BIOS or SGABIOS provides a means for legacy x86 software to communicate with an attached serial console as if a video card were attached. SGABIOS is designed to be inserted into a BIOS as an option rom to provide over a serial port the display and input capabilities normally handled by a VGA adapter and a keyboard. SGABIOS can be used to feature OS independent serial console redirection in Qemu. debian/install0000644000000000000000000000003512155271167010564 0ustar sgabios.bin /usr/share/misc/ debian/source/0000755000000000000000000000000012137015031010457 5ustar debian/source/format0000644000000000000000000000001412136676666011717 0ustar 3.0 (quilt) debian/source/lintian-overrides0000644000000000000000000000022212137015031014034 0ustar # Upstream did not do a release of sgabios, yet. Therefore there is # nothing we possibly can watch. sgabios source: debian-watch-file-is-missing