Jonathan Lebon
81b13da8e3
In FCOS and RHCOS, the need to configure software in the initramfs has come up multiple times. Sometimes, using kernel arguments suffices. Other times, it really must be a configuration file. Rebuilding the initramfs on the client-side however is a costly operation. Not only does it add complexity to the update workflow, it also erodes a lot of the value obtained from using the baked "blessed" initramfs from the tree itself. One elegant way to address this is to allow specifying multiple initramfses. This is supported by most bootloaders (notably GRUB) and results in each initrd being overlayed on top of each other. This patch allows libostree clients to leverage this so that they can avoid regenerating the initramfs entirely. libostree itself is agnostic as to what kind and how much data overlay initrds contain. It's up to the clients to enforce such boundaries. To implement this, we add a new ostree_sysroot_stage_overlay_initrd which takes a file descriptor and returns a checksum. Then users can pass these checksums when calling the deploy APIs via the new array option `overlay_initrds`. We copy these files into `/boot` and add them to the BLS as another `initrd` entry.
69 lines
2.1 KiB
C
69 lines
2.1 KiB
C
/*
|
|
* Copyright (C) 2015 Colin Walters <walters@verbum.org>
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Lesser General Public License as published
|
|
* by the Free Software Foundation; either version 2 of the licence or (at
|
|
* your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General
|
|
* Public License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "ostree-deployment.h"
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
|
|
/**
|
|
* OstreeDeployment:
|
|
* @parent_instance:
|
|
* @index: Global offset
|
|
* @osname:
|
|
* @csum: OSTree checksum of tree
|
|
* @deployserial: How many times this particular csum appears in deployment list
|
|
* @bootcsum: Checksum of kernel+initramfs
|
|
* @bootserial: An integer assigned to this tree per its ${bootcsum}
|
|
* @bootconfig: Bootloader configuration
|
|
* @origin: How to construct an upgraded version of this tree
|
|
* @unlocked: The unlocked state
|
|
* @staged: TRUE iff this deployment is staged
|
|
* @overlay_initrds: Checksums of staged additional initrds for this deployment
|
|
* @overlay_initrds_id: Unique ID generated from initrd checksums; used to compare deployments
|
|
*/
|
|
struct _OstreeDeployment
|
|
{
|
|
GObject parent_instance;
|
|
|
|
int index;
|
|
char *osname;
|
|
char *csum;
|
|
int deployserial;
|
|
char *bootcsum;
|
|
int bootserial;
|
|
OstreeBootconfigParser *bootconfig;
|
|
GKeyFile *origin;
|
|
OstreeDeploymentUnlockedState unlocked;
|
|
gboolean staged;
|
|
char **overlay_initrds;
|
|
char *overlay_initrds_id;
|
|
};
|
|
|
|
void _ostree_deployment_set_bootcsum (OstreeDeployment *self, const char *bootcsum);
|
|
|
|
void _ostree_deployment_set_overlay_initrds (OstreeDeployment *self,
|
|
char **overlay_initrds);
|
|
|
|
char** _ostree_deployment_get_overlay_initrds (OstreeDeployment *self);
|
|
|
|
G_END_DECLS
|