From patchwork Tue Apr 5 05:24:31 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Schmidt, Adriaan" X-Patchwork-Id: 1653 Return-Path: Received: from shymkent.ilbers.de ([unix socket]) by shymkent (Cyrus 2.5.10-Debian-2.5.10-3) with LMTPA; Tue, 05 Apr 2022 15:25:02 +0200 X-Sieve: CMU Sieve 2.4 Received: from mail-wr1-f61.google.com (mail-wr1-f61.google.com [209.85.221.61]) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPS id 235DOuX3023873 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 5 Apr 2022 15:24:56 +0200 Received: by mail-wr1-f61.google.com with SMTP id q15-20020adfab0f000000b002060c75e65asf1545523wrc.5 for ; Tue, 05 Apr 2022 06:24:56 -0700 (PDT) ARC-Seal: i=3; a=rsa-sha256; t=1649165091; cv=pass; d=google.com; s=arc-20160816; b=Xr2lAtVKkkMcM4Erdz9SbuwNulJ7O/Z0SNkshUd1KktjVMvJ+YqwPEIXlHq+rMeP+l jiIaidxBwJw8W+le3gyk52JtllsXksZRpC1XtAk+IPujyIqUnnUvOsvaxNg363e1Re9F iZ4m52FaXvGDqA+bBors6xks0BueZuGUR682+GVYXSMY59m0GiHD9NHc247F38cnZ7Js MxVgF4dqVdra1Y5lYoA8st/UExbIoBfbSOlg5+Qm+/p7Id0/2EwuKG6g6JrPBUfsctSD ahBblN2nXAyHXPtBD1UkNgELu6ttm1tfSLPXLsYq4GQbopZnev1fMsaEmLU7MlOLRcib XlyQ== ARC-Message-Signature: i=3; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:sender:dkim-signature; bh=rRuBQjRa5QvRo3Ek4ifRKPaFc5mdf9cAlX5NUGT2h6o=; b=dEG0YuM/si28XQ6jPYsrjRzwEbTE3CkNwgthchASZbY4M9KkixL0iK0knWFXXERGEG T6lzQd4qjFjcn8JapZNkyxr03Hrf1s5L1oxuK5FD9PhxF6sznW1bhhgTZmkL+4TEhoB9 95grSdbcWUgHL8NvLeuMJ1ucFMEEsismZmRpSTxfqZipUcKQA9IFkfkI0msljy1m6aKb hUlWLr6UGoKYbuL6Gvp70x5ptC3oE04ie+/yghDQc3MtZO0W7pE37VWg+Kt9mx/BfVCB u4YkxP5VEYfQmWVEzzYLtOXt3j1XC0NARdag9LfKApbZQ43wssgAQDD1II70Fb2RnPeC qwkw== ARC-Authentication-Results: i=3; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=g53VmH2w; arc=pass (i=1 spf=pass spfdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:fe0c::61f as permitted sender) smtp.mailfrom=adriaan.schmidt@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20210112; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=rRuBQjRa5QvRo3Ek4ifRKPaFc5mdf9cAlX5NUGT2h6o=; b=dtt0RqOvUIslIBR610g8tr3xhCLWjP2Q3jYpdmKCr5HV7Q5syIa9/rjKmUmRIMfPim owY1EJVKzJhMSHvKhYeTHMUXektG45Kud1fRjUIb7Cb+zuTl6U3VITzXZmV/DFkVu9bo b3V/zgvQRdbc7d1kNcOUY0gEkRLWCxW3g+EfiKxA+rzKgFqnurFusDWBd+xu2MKdD67R lYK51sqSUIsN0iuAyLYZA3bAWoBNmgHHMmnMfWQyuyksor8/mW3X91fxj1/E6F5zxpu6 hwFaAN9+WIDhYmMI3TPCcipYk+EtwbszW+FLhBfuJq0iuJTloVr+syIk/Y+0gzeyU4CF u4wA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=sender:x-gm-message-state:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=rRuBQjRa5QvRo3Ek4ifRKPaFc5mdf9cAlX5NUGT2h6o=; b=wXjlBWGuJ7zke0vGUDV8WZjBvba5/kzlTKlghu8QbD6CI8e8ZDrjWBQnfK0nI6cvip bf5cgrKGPnkj4yNDTdYwJgnXW/s9weCDOX8m+eyQvMNKaMBb2B/BFYW94a/vfehSoL7y 8UbsovYRVdEdjSZcKL3Ji+e2GFkf7rxmQRa6Zag14iFw3SqIkvpqT6vbaLLmezWio5OJ UbxoYmXN/iz3WZ007gEyVRiFjdByaYc9HzW9hXxBiNXSB7ObOFETAtGmEVtZLEwypyxK GhACzg8FKqPOwnuouEjcopgNfe14lbm0PMwbBo6yyaty+8pvqkuqtDq3F47nG4Gfcaef ckXQ== Sender: isar-users@googlegroups.com X-Gm-Message-State: AOAM532+SLYxTDJHJRgOceqDHG2ll6fSRCpyAwWA/qQLnygItWHyRM0i poczTMw3dLXJ0zTAD9O896c= X-Google-Smtp-Source: ABdhPJypdWUzJxpUyruQy4d1/iw+5+whNA5YBTWR63NHHs4wSHpHUGp5bvQHU57QMJhH1iJv8FjKGg== X-Received: by 2002:a7b:cf12:0:b0:38e:6b0e:a41d with SMTP id l18-20020a7bcf12000000b0038e6b0ea41dmr3223928wmg.8.1649165090867; Tue, 05 Apr 2022 06:24:50 -0700 (PDT) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a5d:5306:0:b0:206:e61:ce02 with SMTP id e6-20020a5d5306000000b002060e61ce02ls753565wrv.2.gmail; Tue, 05 Apr 2022 06:24:50 -0700 (PDT) X-Received: by 2002:a05:6000:1545:b0:205:a82d:8007 with SMTP id 5-20020a056000154500b00205a82d8007mr2850137wry.88.1649165090109; Tue, 05 Apr 2022 06:24:50 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1649165090; cv=pass; d=google.com; s=arc-20160816; b=Syl96FH93QiVUFPI/JRJWs1Beqi4UWJiSQBKq0GsZ6i2xnM2sPNTKHp2VXBbrWfd1X NfMn0MjNh54UUHwdOlpV1p72oWT9K4VxTLMRS6Nza6JLUAnsTks+M4afKRPsYbh1oXkh 05a9A/hVGjAhdl2T98B991B/egQsxnAB3/EDZ4yzYvSfeCQyXnYzoYm/bA5eaCrb8dIq 9QOMfq3Bn/wgARu9kt+fg8OWsvT+C9KypCGDYqSTyESza8Dpp1/Cuu8zG2yNUG7YaPmV +o7vAvoutZ7DPpfG+RUnwqz0OVup5/eKTU7TDlBsqna7Tac34Q3pnLQ8+bVDOEemmSjL LGPg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=2HD6zLVkVS+uwkUrcyrdajsiSwQcYgw3hvjPFJNmHsc=; b=S4Y/NUw1W9PPfBeh3bzDA1vgz/2HAS5AdMxsXwH5CKBNzWMHyTyx50LouMSF7YR8+B J3dvytn2Mcn4UowYjgtsx2X+i2+6CFgWZi18yJ16cSiqYZ/0pFtGESDPIkdY06jbKdTp pgy2NucIDHDel5+S7940Zax7pdsIKUdNPIrKjUhresSNjs4nlQEbbWMrxbreBd8yMhli gSO8KpoCWqjXgesGbWpmPoYGumLEVCJuiQkJIXNjLA9jtLyQrID8FqItag8m+M7fu+6u RYQ/Ii0KoWgnFpS+BeU4dZNU+XuXtlSd/M8zyS1vkKxxajAKoiYa97lkV+gnvfXuuT2M vd4g== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=g53VmH2w; arc=pass (i=1 spf=pass spfdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:fe0c::61f as permitted sender) smtp.mailfrom=adriaan.schmidt@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Received: from EUR04-DB3-obe.outbound.protection.outlook.com (mail-db3eur04on061f.outbound.protection.outlook.com. [2a01:111:f400:fe0c::61f]) by gmr-mx.google.com with ESMTPS id n14-20020a5d588e000000b0020614342564si339204wrf.7.2022.04.05.06.24.49 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Tue, 05 Apr 2022 06:24:50 -0700 (PDT) Received-SPF: pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:fe0c::61f as permitted sender) client-ip=2a01:111:f400:fe0c::61f; ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=f6mVL0Jt1ObcLH1U3cUZL5aHjgKyKSKHGXrliL90ywhItUmuhLQo2njrFuHA9E9SZNF/UHusCms59BMYPzrozFS87gkq/B7CeFR+LffJN8j9fbhe5JTFQbHu3AFjr+9sx/eEfcmSSHTn7cStdU+EgNhdEitygy6uzgtYUWNoGKFUaatLQRjv/oXsimwQlAeDDP0vU6bDeLwBRGX/BqiVVanHU3HSyhc90FTsiWG8kfdPRALySFJsMBF3dvYdtmcVUZF3kAwA2YIpg1tPxAgCw4hsDgp76lDZiokNSIQ97rMPFiLna0vxzJYgYQZQufAvjta7xDB27u5ojEaCz6OcuQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=2HD6zLVkVS+uwkUrcyrdajsiSwQcYgw3hvjPFJNmHsc=; b=Y13Vk23yaMl6dq5BS2zhYzZN33Ykit10Q38DenMzlzoETJOj1l41uHnSrsUVNEi6JZW42VUjdHLW+cpmZ4O6Aw4Qmq1cXAEgoFYEJk/y6KaHiIL2NsT8SAg9Qf6r0pCarCOs3GpX5thvvMRslh6J1d8TOttubmD4ZotyuvSdy1fp5erPfwaGOuYtVDQb8F2FOA4yQG4Lb1ELs4IPyI46nG9oq7QqP0dfZsc7dnqTTQLrDc52hGcXztFsM4MApfrm8LCcDRddno8gAhGFNcSPa2TOiqbsOIKKkmQ1LrrLnMTGMpir7GF7CHHU5XWgjtk74JcZW7Z2BOGzMDxtB5knug== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 194.138.21.71) smtp.rcpttodomain=googlegroups.com smtp.mailfrom=siemens.com; dmarc=pass (p=none sp=none pct=100) action=none header.from=siemens.com; dkim=none (message not signed); arc=none Received: from AM5PR0601CA0045.eurprd06.prod.outlook.com (2603:10a6:203:68::31) by HE1PR1001MB1097.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:3:6b::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5123.31; Tue, 5 Apr 2022 13:24:48 +0000 Received: from VE1EUR01FT093.eop-EUR01.prod.protection.outlook.com (2603:10a6:203:68:cafe::88) by AM5PR0601CA0045.outlook.office365.com (2603:10a6:203:68::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5123.31 via Frontend Transport; Tue, 5 Apr 2022 13:24:48 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 194.138.21.71) smtp.mailfrom=siemens.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=siemens.com; Received-SPF: Pass (protection.outlook.com: domain of siemens.com designates 194.138.21.71 as permitted sender) receiver=protection.outlook.com; client-ip=194.138.21.71; helo=hybrid.siemens.com; Received: from hybrid.siemens.com (194.138.21.71) by VE1EUR01FT093.mail.protection.outlook.com (10.152.3.129) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.5123.19 via Frontend Transport; Tue, 5 Apr 2022 13:24:48 +0000 Received: from DEMCHDC89XA.ad011.siemens.net (139.25.226.103) by DEMCHDC9SKA.ad011.siemens.net (194.138.21.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.24; Tue, 5 Apr 2022 15:24:48 +0200 Received: from random.ppmd.siemens.net (139.25.68.25) by DEMCHDC89XA.ad011.siemens.net (139.25.226.103) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2375.24; Tue, 5 Apr 2022 15:24:47 +0200 From: Adriaan Schmidt To: CC: Adriaan Schmidt Subject: [PATCH v2 7/7] docs: add new imagetypes to user manual Date: Tue, 5 Apr 2022 15:24:31 +0200 Message-ID: <20220405132431.2895832-8-adriaan.schmidt@siemens.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20220405132431.2895832-1-adriaan.schmidt@siemens.com> References: <20220405132431.2895832-1-adriaan.schmidt@siemens.com> MIME-Version: 1.0 X-Originating-IP: [139.25.68.25] X-ClientProxiedBy: DEMCHDC8A0A.ad011.siemens.net (139.25.226.106) To DEMCHDC89XA.ad011.siemens.net (139.25.226.103) X-TM-AS-Product-Ver: SMEX-14.0.0.3080-8.6.1018-26680.007 X-TM-AS-Result: No-10--16.244900-8.000000 X-TMASE-MatchedRID: f6Rj31JPTe4QwVtkLIfLLbHs1wZTXKHBYlldA0POS1Jtdr9d0G+tOpho XhL48wE7eucl7MdNw8RlgPlELHsWWRyr9kofgD0FFR00oYoqDJafbxa3A1yTpzfu+RTlciXg/Md +OvVRT/kR34ro7k23nVBtcAz9x24SKWZyYRZycgtJ/2MFRNZuNR+X41oiFhcu6HuV1BUJYPNBJ1 CxuVkwjUtcaZvMECGy1Br5wWX7YQ2okitJmrFCuON7MovG9cvQ9eUjmTFKQ/T8OMEMU7OyZtPZW t1+42smTPm/MsQarwMBIoIumpW6V/4yf+7IYDgcsW3Cgu625dVTZyP+S3GVYH0OE02QLVC+WRYt BXVuRSVGMe+tDjQ3FnIin2hX71Kr5shPFSKOueR6p3UUV82FSRVdTj9tM44xggra2NOo2i3jLrH qvAiSy6lTFDGZMPhCixP77M1esQwZmf7ofP3gccKwBNRhxAkuxQuyWuTn6yqXfrypKnpvnre2wM m8sT5/E4klva9z5Jx6RaSpHJq/AA/hpPV0bNgBIvabuzhmQeCEtFE/+7XCuolSWYvdSPSYf3PPz 7C7ukZr9YiEX0WhNplA4IpB7gNOs8mgqR6m778aiTke3N9xUXdpFkj4BgGZCtzGvPCy/m68xE2H 2EuMWS5MlWghP7UmX46iGZTPpJ6qqsCwzad2bB6kX/VShDhejxn4v13MgUbB6S7ffS3eayLLJGC SgZKk4PdcWsl+C/MTUMg5euvPiXUbN++MZYTqFUGiMcidh6Px9/PgR0+rlqubsOtSWY2QgDLqnr RlXrZ8nn9tnqel2MprJP8FBOIaA/3R8k/14e0= X-TM-AS-User-Approved-Sender: No X-TM-AS-User-Blocked-Sender: No X-TMASE-Result: 10--16.244900-8.000000 X-TMASE-Version: SMEX-14.0.0.3080-8.6.1018-26680.007 X-TM-SNTS-SMTP: 60F348F3D8EAAC89E06641B59C6039F5A89169D6BF3AEAD2EE61E2C871266AAB2000:8 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 32a86d89-40fa-4fb2-ce87-08da1707a86d X-MS-TrafficTypeDiagnostic: HE1PR1001MB1097:EE_ X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: TQvZVAbW0s3hJsOBhZWfL5223F/Icuadruum9WhY5QoBDdH9fKR78KRJ+ijMjLG+TopoALOb0NTgEqO2NdBN/+GLV1Dn7lsJjnciXxIZXTO1lkUfj9IaLg9ybS5a/ECUX2ELDWqCQENzwgrkEZkhB7H+yS26UPi+y64qVHvv7rRnN9wBVWxt71cOKc51+GliJ4BxckvSx/s+V6Ph9TblGCCt8pIJUx22UvdTzE+MycWT4/gwhjTAE7Nn4FLwIK2OlnkuCA83YpzFWNDKlJqkBaqOrsZMAfgKQmZJQlrbyPQGJqY89EscPLzZp9ltMXsLXRypp1MZtaQYeDqJMouJ4fWDBf91k1DoO+rfZMA/Bl2WiLt7y79aDSAZZUHuFYxMAtEujpSBzNk6J8z3WO1RjAQ1FyKOh0Nm8oVGzSzqYWC1V/CwYJy0EDvfuqRgStauGP5ID1ta0Z7S7Fo6A7CdMWamRW4YYtJIxqpc9Jb5hyQKnTm9Ha390OajmuJw+2ePB1vnYK97oi+qfqgvqUjISQ/0reSmSmwaQFviHMLtVHA4ZQ8RQZlUxxazZdECxG1x+2yiRC6aORrkE5UNdgaaNLai46LNBMk6dGA0SmkVu5jXdunNX+8Wn5tua1u9MYRTeATl8culJmt+4kwoGl9UeCd5oRyoplrKEv00RuSFcMdTlbD35EPb+YFhWGnGN5lPzoe7GLzhY4vUI5vTsUcP4jAWEfFBX/j1X3Fbazb20F151OALs4wMfMlXW319THFqp7MnVP3AfksR57N7gINMD+/z8BrN81eHeegzhTKB+awhWFCoHEaYS9hOSpS3uhuiCdONqa0OuBEPtvzbLicbArDpS+bLfDaSQRCgJECzGwI= X-Forefront-Antispam-Report: CIP:194.138.21.71; CTRY:DE; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:hybrid.siemens.com; PTR:InfoDomainNonexistent; CAT:NONE; SFS:(13230001)(4636009)(40470700004)(36840700001)(46966006)(508600001)(81166007)(36756003)(82960400001)(966005)(86362001)(40460700003)(5660300002)(8936002)(336012)(6666004)(44832011)(107886003)(36860700001)(26005)(82310400005)(1076003)(6916009)(316002)(186003)(47076005)(16526019)(2616005)(70586007)(956004)(70206006)(356005)(83380400001)(4326008)(2906002)(8676002)(403724002)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: siemens.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Apr 2022 13:24:48.3856 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 32a86d89-40fa-4fb2-ce87-08da1707a86d X-MS-Exchange-CrossTenant-Id: 38ae3bcd-9579-4fd4-adda-b42e1495d55a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=38ae3bcd-9579-4fd4-adda-b42e1495d55a; Ip=[194.138.21.71]; Helo=[hybrid.siemens.com] X-MS-Exchange-CrossTenant-AuthSource: VE1EUR01FT093.eop-EUR01.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: HE1PR1001MB1097 X-Original-Sender: adriaan.schmidt@siemens.com X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@siemens.com header.s=selector2 header.b=g53VmH2w; arc=pass (i=1 spf=pass spfdomain=siemens.com dmarc=pass fromdomain=siemens.com); spf=pass (google.com: domain of adriaan.schmidt@siemens.com designates 2a01:111:f400:fe0c::61f as permitted sender) smtp.mailfrom=adriaan.schmidt@siemens.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=siemens.com Precedence: list Mailing-list: list isar-users@googlegroups.com; contact isar-users+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: isar-users@googlegroups.com X-Google-Group-Id: 914930254986 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIMWL_WL_MED, DKIM_SIGNED, DKIM_VALID,DKIM_VALID_EF,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H2,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-getmail-retrieved-from-mailbox: INBOX Signed-off-by: Adriaan Schmidt --- doc/user_manual.md | 86 ++++++++++++++++++++++++++++------------------ 1 file changed, 53 insertions(+), 33 deletions(-) diff --git a/doc/user_manual.md b/doc/user_manual.md index b950ff7f..334e91a1 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -213,7 +213,7 @@ tmp/deploy/images/rpi/isar-image-base-raspbian-stretch-rpi.wic.img ### Generate full disk image -A bootable disk image is generated if `wic-img` is listed in IMAGE_FSTYPES. +A bootable disk image is generated if `wic` is listed in IMAGE_FSTYPES. Behind the scenes a tool called `wic` is used to assemble the images. It is controlled by a `.wks` file which you can choose with changing WKS_FILE. Some examples in the tree use that feature already. @@ -253,7 +253,8 @@ https://github.com/intel/bmap-tools ### Generate container image with root filesystem A runnable container image is generated if IMAGE_FSTYPES variable includes -'container-img'. +one of the supported container formats `oci`, `oci-archive`, `docker-archive`, +`docker-daemon`, or `containers-storage`. Getting a container image can be the main purpose of an Isar configuration, but not only. A container image created from an Isar configuration meant for bare-metal or @@ -261,10 +262,9 @@ virtual machines can be helpfull to test certain applications which requirements (e.g. libraries) can be easily resolved in a containerized environment. -Container images can be generated in different formats, selected with the -variable `CONTAINER_IMAGE_FORMATS`. One or more (whitespace separated) of following -options can be given: - - `docker-archive`: (default) an archive containing a Docker image that can +Container images can be generated in different formats. One or more (whitespace +separated) of following options can be given: + - `docker-archive`: an archive containing a Docker image that can be imported with [`docker load`](https://docs.docker.com/engine/reference/commandline/load) - `docker-daemon`: resulting container image is made available on the local Docker Daemon @@ -280,12 +280,6 @@ It's technically possible, but requires making host resources (e.g. the Docker Daemon socket) accessible in the container, which can endanger the stability and security of the host. -The resulting container image archives (only for `docker-archive` and -`oci-archive`) are made available as -`tmp/deploy/images/${MACHINE}/${DISTRO}-${DISTRO_ARCH}-${container_format}.tar.xz` -(being `container_format` each one of the formats specified in -`CONTAINER_IMAGE_FORMATS`). - ### Example - Make the relevant environment variables available to the task @@ -293,9 +287,8 @@ The resulting container image archives (only for `docker-archive` and For one-shot builds (use `local.conf` otherwise): ``` -export BB_ENV_EXTRAWHITE="$BB_ENV_EXTRAWHITE IMAGE_TYPE CONTAINER_IMAGE_FORMATS" -export IMAGE_FSTYPES="container-img" -export CONTAINER_IMAGE_FORMATS="docker-archive" +export BB_ENV_EXTRAWHITE="$BB_ENV_EXTRAWHITE IMAGE_FSTYPES" +export IMAGE_FSTYPES="docker-archive.xz" ``` - Trigger creation of container image from root filesystem @@ -307,7 +300,7 @@ bitbake mc:qemuarm-buster:isar-image-base - Load the container image into the Docker Daemon ``` -docker load -i build/tmp/deploy/images/qemuarm/isar-image-base-debian-buster-armhf-1.0-r0-docker-archive.tar.xz +docker load -i build/tmp/deploy/images/qemuarm/isar-image-base-debian-buster-armhf-1.0-r0.docker-archive.xz ``` - Run a container using the container image (following commands starting with @@ -460,10 +453,15 @@ Isar can generate various images types for specific machine. The type of the image to be generated may be specified through the `IMAGE_FSTYPES` variable. Currently, the following image types are provided: - - `ext4` - Raw ext4 filesystem image (default option for `qemuarm` machine). - - `wic-img` - A full disk image with user-specified partitions created and populated using the wic tool. - - `ubi-img` - A image for use on mtd nand partitions employing UBI - - `vm-img` - A image for use on VirtualBox or VMware + - `tar` - tarball of the root file system + - `cpio` - cpio archive + - `ext4` - raw ext4 filesystem image (default option for `qemuarm` machine) + - `wic` - full disk image with user-specified partitions created and populated using the wic tool + - `ubi` - image for use on mtd nand partitions employing UBI + - `ova` - Open Virtual Appliance: image for use on VirtualBox or VMware + +In addition, image types can be converted using suffixes, e.g. `tar.gz`. +Available conversions are `gz` and `xz`, which both provide image compression. There are several image types can be listed in `IMAGE_FSTYPES` divided by space. @@ -539,7 +537,7 @@ IMAGE_PREINSTALL = "linux-image-rpi-rpfv \ KERNEL_IMAGE = "vmlinuz-4.4.0-1-rpi" INITRD_IMAGE = "initrd.img-4.4.0-1-rpi" MACHINE_SERIAL = "ttyAMA0" -IMAGE_FSTYPES = "wic-img" +IMAGE_FSTYPES = "wic" WKS_FILE = "rpi-sdimg" ``` @@ -579,22 +577,44 @@ Every image type in Isar is implemented as a `bitbake` class. The goal of these ### Create Custom Image Type -As already mentioned, Isar uses `bitbake`to accomplish the work. The whole build process is a sequence of tasks. This sequence is generated using task dependencies, so the next task in chain requires completion of previous ones. -The last task of image recipe is `do_populate`, so the class that implement new image type should continue execution from this point. According to the BitBake syntax, this can be implemented as follows: +The following steps are required to implement a custom image type: Create a new class: ``` $ vim meta-user/classes/my-image.bbclass ``` -Add these lines: + +Specify the command to generate the new image, and optionally image type +dependencies or required arguments: ``` -do_my_image() { +IMAGE_TYPEDEPS_my_image = "ext4" +IMAGE_CMD_REQUIRED_ARGS_my_image = "MY_ARG" +IMAGE_CMD_my_image() { + INPUT="${PP_DEPLOY}/${IMAGE_FULLNAME}.ext4" + ${SUDO_CHROOT} my_command ${MY_ARG }-i ${INPUT} -o ${IMAGE_FILE_CHROOT} } -addtask my_image before do_build after do_populate ``` -The content of `do_my_image` function can be implemented either in shell or in Python. +The IMAGE_CMD is a shell function, and the environment has some pre-set +variables: + + - `IMAGE_FILE_HOST` and `IMAGE_FILE_CHROOT` are the paths of the output image + (including extension) in the host or buildchroot. + - `SUDO_CHROOT` is a prefix you can use to have a command run inside the + buildchroot. + +If the code you provide in `IMAGE_CMD` requires the building and/or installation +of additional packages in the buildchroot, you can specify this: +``` +IMAGER_BULID_DEPS_my_image = "my_command" +IMAGER_INSTALL_my_image = "my_command" +``` + +To use your custom image class, add it to `IMAGE_CLASSES` in your machine config: +``` +IMAGE_CLASSES += "my-image" +``` -In the machine configuration file, set the following: +And finally select the new image type: ``` IMAGE_FSTYPES = "my-image" ``` @@ -603,11 +623,11 @@ IMAGE_FSTYPES = "my-image" Isar contains additional image type classes that can be used as reference: - - `ext4-img` - - `targz-img` - - `ubifs-img` - - `ubi-img` - - `wic-img` + - `ext4` + - `tar.gz` + - `ubifs` + - `ubi` + - `wic` ---