From nobody Tue Aug 25 00:11:38 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) client-ip=192.237.175.120; envelope-from=xen-devel-bounces@lists.xenproject.org; helo=lists.xenproject.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=pass(p=quarantine dis=none) header.from=suse.com ARC-Seal: i=1; a=rsa-sha256; t=1783413340; cv=none; d=zohomail.com; s=zohoarc; b=IZnSE6enBuzV7YHR/BguB1lnpA8HPgKbsOzq1MLOydh4YA5/MfFyyZk2WZcVEbrxLrFKIhPNqjeaW0n22NfiBEuP9cMtVMLgDXAbKZiNvoss+6sBNuAtjUnLH5bXbbF6NgIR0R3RHDJ+BmO49SQEsXeW73m4H7Oz+2mdKZA8MSs= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1783413340; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=i7QVV4zU+HBTHHGxFIUYe6BxCNLKsfYFRbHiHIdGaFw=; b=egj+mNB2CiEJwzQOW8H3OrkwoOSTI6A97gjoY3wFGUDqfFRAh80pDyz+0JeoO3Odmu0XbC8N9+4m/fgY1f8fg6FGaNQVUgAj2injYqu1HYRXnmbT7ISNVdQSYtENtDK2bzkRSpNCQLn3jCDYkPp2uhelhu0TLo+Z0DT15LmS8RM= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.xenproject.org designates 192.237.175.120 as permitted sender) smtp.mailfrom=xen-devel-bounces@lists.xenproject.org; dmarc=pass header.from= (p=quarantine dis=none) Return-Path: Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) by mx.zohomail.com with SMTPS id 178341334053865.79381817511126; Tue, 7 Jul 2026 01:35:40 -0700 (PDT) Received: from list by lists.xenproject.org with outflank-mailman.1356038.1610715 (Exim 4.92) (envelope-from ) id 1wh1H4-0001Ot-Vc; Tue, 07 Jul 2026 08:35:26 +0000 Received: by outflank-mailman (output) from mailman id 1356038.1610715; Tue, 07 Jul 2026 08:35:26 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1wh1H4-0001Oe-Rd; Tue, 07 Jul 2026 08:35:26 +0000 Received: by outflank-mailman (input) for mailman id 1356038; Tue, 07 Jul 2026 08:35:26 +0000 Received: from mx.expurgate.net ([195.190.135.20]) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1wh1H4-0001Nb-7Q for xen-devel@lists.xenproject.org; Tue, 07 Jul 2026 08:35:26 +0000 Received: from mx.expurgate.net (helo=localhost) by mx.expurgate.net with esmtp id 1wh1H3-003BoA-KF for xen-devel@lists.xenproject.org; Tue, 07 Jul 2026 10:35:25 +0200 Received: from [10.42.69.8] (helo=localhost) by localhost with ESMTP (eXpurgate MTA 0.9.1) (envelope-from ) id 6a4cba42-5cb7-0a2a0a5109dd-0a2a45089baa-38 for ; Tue, 07 Jul 2026 10:35:25 +0200 Received: from [195.135.223.130] (helo=smtp-out1.suse.de) by tlsNG-c1860d.mxtls.expurgate.net with ESMTPS (eXpurgate 4.57.1) (envelope-from ) id 6a4cba4d-edec-0a2a45080019-c387df82e422-3 for ; Tue, 07 Jul 2026 10:35:25 +0200 Received: from imap1.dmz-prg2.suse.org (imap1.dmz-prg2.suse.org [IPv6:2a07:de40:b281:104:10:150:64:97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id 3951E7393D; Tue, 7 Jul 2026 08:35:25 +0000 (UTC) Received: from imap1.dmz-prg2.suse.org (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by imap1.dmz-prg2.suse.org (Postfix) with ESMTPS id EC335779AE; Tue, 7 Jul 2026 08:35:24 +0000 (UTC) Received: from dovecot-director2.suse.de ([2a07:de40:b281:106:10:150:64:167]) by imap1.dmz-prg2.suse.org with ESMTPSA id mbJnOEy6TGrvDAAAD6G6ig (envelope-from ); Tue, 07 Jul 2026 08:35:24 +0000 X-Outflank-Mailman: Message body and most headers restored to incoming version X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" Authentication-Results: eu.smtp.expurgate.cloud; dkim=pass header.s=susede1 header.d=suse.com header.i="@suse.com" header.h="From:Date:Message-ID:To:Cc:MIME-Version:Content-Transfer-Encoding:In-Reply-To:References"; dkim=pass header.s=susede1 header.d=suse.com header.i="@suse.com" header.h="From:Date:Message-ID:To:Cc:MIME-Version:Content-Transfer-Encoding:In-Reply-To:References" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1783413325; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=i7QVV4zU+HBTHHGxFIUYe6BxCNLKsfYFRbHiHIdGaFw=; b=A1qwsMhyXPPk7tBBqTA0eBQFS43sgaXhv+FHVOQq6v+tTuNzvB+8idgUnihIXDP0b+bOt9 IuB1OKyucGahsMu7Br1JRuG6WVtPejZg7OZu7hiosko8XCV/aKTpjmThq4E9Q5X6YJio+2 bJwU2VOmKFbZyuOw2XSN+LNzAfddQ40= Authentication-Results: smtp-out1.suse.de; dkim=pass header.d=suse.com header.s=susede1 header.b=A1qwsMhy DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1783413325; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=i7QVV4zU+HBTHHGxFIUYe6BxCNLKsfYFRbHiHIdGaFw=; b=A1qwsMhyXPPk7tBBqTA0eBQFS43sgaXhv+FHVOQq6v+tTuNzvB+8idgUnihIXDP0b+bOt9 IuB1OKyucGahsMu7Br1JRuG6WVtPejZg7OZu7hiosko8XCV/aKTpjmThq4E9Q5X6YJio+2 bJwU2VOmKFbZyuOw2XSN+LNzAfddQ40= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: Juergen Gross , Andrew Cooper , Anthony PERARD , Michal Orzel , Jan Beulich , Julien Grall , =?UTF-8?q?Roger=20Pau=20Monn=C3=A9?= , Stefano Stabellini Subject: [PATCH 4/5] docs: remove stale stubdom entries from stubdom.txt Date: Tue, 7 Jul 2026 10:34:55 +0200 Message-ID: <20260707083459.226297-5-jgross@suse.com> X-Mailer: git-send-email 2.54.0 In-Reply-To: <20260707083459.226297-1-jgross@suse.com> References: <20260707083459.226297-1-jgross@suse.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Rspamd-Action: no action X-Rspamd-Queue-Id: 3951E7393D X-Spam-Flag: NO X-Spam-Score: -3.01 X-Spam-Level: X-Spamd-Result: default: False [-3.01 / 50.00]; BAYES_HAM(-3.00)[99.99%]; MID_CONTAINS_FROM(1.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000]; R_MISSING_CHARSET(0.50)[]; R_DKIM_ALLOW(-0.20)[suse.com:s=susede1]; NEURAL_HAM_SHORT(-0.20)[-0.999]; MIME_GOOD(-0.10)[text/plain]; MX_GOOD(-0.01)[]; DKIM_SIGNED(0.00)[suse.com:s=susede1]; FUZZY_RATELIMITED(0.00)[rspamd.com]; MIME_TRACE(0.00)[0:+]; TO_MATCH_ENVRCPT_ALL(0.00)[]; ARC_NA(0.00)[]; RBL_SPAMHAUS_BLOCKED_OPENRESOLVER(0.00)[2a07:de40:b281:104:10:150:64:97:from]; DKIM_TRACE(0.00)[suse.com:+]; TO_DN_SOME(0.00)[]; RCVD_COUNT_TWO(0.00)[2]; FROM_EQ_ENVFROM(0.00)[]; FROM_HAS_DN(0.00)[]; RCVD_TLS_ALL(0.00)[]; DNSWL_BLOCKED(0.00)[2a07:de40:b281:104:10:150:64:97:from,2a07:de40:b281:106:10:150:64:167:received]; RCPT_COUNT_SEVEN(0.00)[9]; DWL_DNSWL_BLOCKED(0.00)[suse.com:dkim]; RCVD_VIA_SMTP_AUTH(0.00)[]; RECEIVED_SPAMHAUS_BLOCKED_OPENRESOLVER(0.00)[2a07:de40:b281:106:10:150:64:167:received]; DBL_BLOCKED_OPENRESOLVER(0.00)[suse.com:dkim,suse.com:email,suse.com:mid] X-Rspamd-Server: rspamd1.dmz-prg2.suse.org X-purgate-ID: tlsNG-c1860d/1783413325-A15273FC-BD564E03/0/0 X-purgate-type: clean X-purgate-size: 2552 X-ZohoMail-DKIM: pass (identity @suse.com) X-ZM-MESSAGEID: 1783413341880158500 Content-Type: text/plain; charset="utf-8" There are several stubdoms mentioned in docs/misc/stubdom.txt which no longer exist. Remove them. Signed-off-by: Juergen Gross --- docs/misc/stubdom.txt | 69 ------------------------------------------- 1 file changed, 69 deletions(-) diff --git a/docs/misc/stubdom.txt b/docs/misc/stubdom.txt index cfcba4ba96..3ee96d5063 100644 --- a/docs/misc/stubdom.txt +++ b/docs/misc/stubdom.txt @@ -85,72 +85,3 @@ To change the CD-ROM medium, libxl will: =20 The stubdom must internally add /dev/xvdc to an fdset in QEMU with opaque = set to "stub-devid:$devid". libxl will lookup the fdset with that string. - - PV-GRUB - =3D=3D=3D=3D=3D=3D=3D - - This replaces pygrub to boot domU images safely: it runs the regular grub -inside the created domain itself and uses regular domU facilities to read = the -disk / fetch files from network etc. ; it eventually loads the PV kernel a= nd -chain-boots it. - =20 -Configuration -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D - -In your PV config, - -- use pv-grub.gz as kernel: - -kernel =3D "pv-grub.gz" - -- set the path to menu.lst, as seen from the domU, in extra: - -extra =3D "(hd0,0)/boot/grub/menu.lst" - -or you can provide the content of a menu.lst stored in dom0 by passing it = as a -ramdisk: - -ramdisk =3D "/boot/domU-1-menu.lst" - -or you can also use a tftp path (dhcp will be automatically performed): - -extra =3D "(nd)/somepath/menu.lst" - -or you can set it in option 150 of your dhcp server and leave extra and ra= mdisk -empty (dhcp will be automatically performed) - -Limitations -=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D - -- You can not boot a 64bit kernel with a 32bit-compiled PV-GRUB and vice-v= ersa. -To cross-compile a 32bit PV-GRUB, - -export XEN_TARGET_ARCH=3Dx86_32 - -- bootsplash is supported, but the ioemu backend does not yet support rest= art -for use by the booted kernel. - -- PV-GRUB doesn't support virtualized partitions. For instance: - -disk =3D [ 'phy:hda7,hda7,w' ] - -will be seen by PV-GRUB as (hd0), not (hd0,6), since GRUB will not see any -partition table. - - - Your own stubdom - =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D - - By running - -cd stubdom/ -make c-stubdom - - or - -cd stubdom/ -make caml-stubdom - - you can compile examples of C or caml stub domain kernels. You can use = these -and the relevant Makefile rules as basis to build your own stub domain ker= nel. -Available libraries are libc, libxc, libxs, zlib and libpci. --=20 2.54.0