From patchwork Fri Oct 6 10:58:45 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Storm, Christian" X-Patchwork-Id: 822353 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=googlegroups.com (client-ip=2a00:1450:4010:c07::23e; helo=mail-lf0-x23e.google.com; envelope-from=swupdate+bncbdd6bwv65qpbb3gd3xhakgqecp7yjmq@googlegroups.com; receiver=) Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=googlegroups.com header.i=@googlegroups.com header.b="Xav5xIOs"; dkim-atps=neutral Received: from mail-lf0-x23e.google.com (mail-lf0-x23e.google.com [IPv6:2a00:1450:4010:c07::23e]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 3y7mpn6F3jz9t4R for ; Fri, 6 Oct 2017 21:58:56 +1100 (AEDT) Received: by mail-lf0-x23e.google.com with SMTP id l135sf1000463lfe.14 for ; Fri, 06 Oct 2017 03:58:56 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1507287533; cv=pass; d=google.com; s=arc-20160816; b=RpPpZlo9cSNVr16gQLuwDv2ZLxl5nAdYqPVpEBNJfnxCexZ7gN+SdfTiR/Cn2R8miU BZHUZddMz02jDeL0VA9dzk/nzSmgFlwaBRd94yBnLJcODMO1GS7GdlXrmc25pXDLbBHT OhbtgofEdW5K9Jn6uuiPW1RJlzmZ09Jf0396i9Qmj1mM3TCw4gO1qvm67aUX7p4GueWy xBuLD8vT8bFE1gNoT5MRHX/z73yn4Bh+k59/ZClv+LLifpS+/QNhdj6R+WmA/jANjjdE AZVinVAL+983GjJnxA+oy1f3I3QZSOiEB9Ctk4NcUeV3XtDbQnJkeJJGFxZkrKwYLNfC DWYQ== ARC-Message-Signature: i=2; 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:message-id:date:subject:cc:to:from :arc-authentication-results:arc-message-signature:mime-version :sender:dkim-signature:arc-authentication-results; bh=ImnG2TZMZ08v1UVZ39mT0tdGjM2A5GRAUXuyhW2SDV8=; b=lZNaf91R40Z/xtOBgH8n6W8oZSnboAFb2A+uhJgxTjGk2LemOM9b7R5TBJRQBWbyZx rilyLeAMrzl5ShOJVD1rVvKP1pqq4dk5QY4NviYQ9K5vy+byecQUO8mVjFYt3RCVm6Iq oakbHvbeDHEfs+5eX2Xuen4fpzNVq/h5/H9nFqkEflcEGmBPnijLfNddTS3WzEKI6X/T T27KFGdlAZMs1zXkYL173q4E/3lZAiCFW3cde0wHGJVrvnGkANHVgZ8eWSDh3yCoTiHK BVfYcx0dl+qs9n7VoKIYrU1eJIyfQpvuIrbRcKXZC75YtXRPAWUdaJ5kD0IWa7dGkUa5 ARTQ== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=neutral (google.com: 192.35.17.28 is neither permitted nor denied by best guess record for domain of christian.storm@siemens.com) smtp.mailfrom=christian.storm@siemens.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:mime-version:from:to:cc:subject:date:message-id :x-original-sender:x-original-authentication-results:precedence :mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=ImnG2TZMZ08v1UVZ39mT0tdGjM2A5GRAUXuyhW2SDV8=; b=Xav5xIOseAj1Ah2HU4n0BIt0lB/XBKCkvDO8+r7NnjsyMjgKfZo1hOkIsGNWaIbFiH LmVSmcKrTh+qRVtVLqrRugFRqsls+co0dV0KmcxzNKfs7UjoldVWilliqXgf2YXmpL0Y PRuc+HUM7jEhgx0aVl5x8nO52mJdcbzDIvY0iBDeWOLq5Z/zz7R0Vlq7d3deuHTM1sN6 E2bPv2aiUUy85WUcn+VF7daQX+qKeI1Jb9zsgys2w7d0e+x5wzy9eDc4rKp5id7xI5Q4 N4azIJGl5VyfkReGoH4QdmZS1LA/4RJ976wNTMeYfxAeAG92pKnO8xhF6VX2oF6P0ALz n9Kw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:mime-version:from:to:cc:subject:date :message-id: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=ImnG2TZMZ08v1UVZ39mT0tdGjM2A5GRAUXuyhW2SDV8=; b=T5jN5OJ94ejHrauqaVkk5DR2HwXVeSyKRTreELCB4hfCmu2rSak6LtHUY/BWqUo91E r+upP49PRfF3uBXfEswvxdv9i3t5k9KXGBP1zAL6tsXVq91B5ZB1wX6AWz+fbd1HJnfK 5I2G79/o5dlIXX0dqF2hIRsPEZi8fkno6H65oPuDuKZb6nszPY4vG/pdMkKkytK7r/6q hDxl3LQRj27Np/iFXvZ1/V9fXzWmixAWw6Ktdz5xLyByoSUrwKgvOxZTQxerWUTLRXAQ nZD/+fdTYkEURnFTE1mxEHMvEjRWJEbv3+S4V7XVAOi9jRAojHt6e2Mt7UUJgtl+dudM 5cnQ== Sender: swupdate@googlegroups.com X-Gm-Message-State: AMCzsaUdHpfuTANs9ZaDNCXX0GwvWPX/FOLGXWJU0ldHOkJ4mh0YVqMQ SvXM/THcb8jG+782UpTLFZg= X-Google-Smtp-Source: AOwi7QAQyG58JHwHRLc8+nkcRzqn0AdBQJ4IcgOoeoNX+FeWPv7cg5cvi0Cyz7Y/HlDnWi5yfB1C+w== X-Received: by 10.28.218.208 with SMTP id r199mr5160wmg.19.1507287532987; Fri, 06 Oct 2017 03:58:52 -0700 (PDT) MIME-Version: 1.0 X-BeenThere: swupdate@googlegroups.com Received: by 10.223.160.247 with SMTP id n52ls5970553wrn.6.gmail; Fri, 06 Oct 2017 03:58:52 -0700 (PDT) X-Received: by 10.223.133.244 with SMTP id 49mr162870wru.22.1507287532713; Fri, 06 Oct 2017 03:58:52 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1507287532; cv=none; d=google.com; s=arc-20160816; b=q8PsaGxiiDKy/rY99WScj9ocWiwRzEjAWsTw22cn7Ro9sh+9fG1auhhsJbUpi6VN+p ZUDsTq/htWXn0ClQajkOsDGeEx/OV7CsyKZOJXCEnlZYmjFsTZ5wlEqNn2rmtsU50CQ2 +OcQhrZao+jvCXd4HvFF1pk06r7mRfUlsFaeYx/HDXqZN/lscWDrKMXSuuoMxEzpJCqL MCJJK1zjW9prZxtUbcYFm6CQXt97zhGHU1033j48GuGYje9iUIU218X64O91rIAk5tql iXiHr9HM0NTeY/iF6azA/upIYjdlj2c1xBZLvrNt69pcdR6XaOI1TbeDO0AjP4QPMD2x GgcQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=message-id:date:subject:cc:to:from:arc-authentication-results; bh=P1lMlq4i16ia4H+BBVqlRcsc0s9z+rQ2g/ZZU2DnzHA=; b=qm9IYMlL+NP+QxwbBUrhrLVuboE2Dbyaf+cXhoCwYLpcOuehGBivuPcX4VoBRFif1S ZbIA6JdTsgJWk+a2/L4MxjFWlqmszpvtRv2J5qpdy5xPA/8ksS6b42GVAnVNBSOkE7i3 5Kr2eRsHhqLVrhQu0k4vErRZsjWfgxCrbm9g3E/7ZH0AsOaR8F91RRF5hmfM9WYrDaUj AWnRv49KsJpBpzKSejcpdvUEIRbTC/f9P0zFyDJDKEmrr/LTdvILNpqh7n1kzjfCta3B 7H3h8tDCvSz4d7Uj+DpH2jDQAu4Z2zja4xDqLd48Nr2jDoUrSF4si8a7A71Fzke91/bl s+ew== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=neutral (google.com: 192.35.17.28 is neither permitted nor denied by best guess record for domain of christian.storm@siemens.com) smtp.mailfrom=christian.storm@siemens.com Received: from goliath.siemens.de (goliath.siemens.de. [192.35.17.28]) by gmr-mx.google.com with ESMTPS id h17si157082wmd.0.2017.10.06.03.58.52 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 06 Oct 2017 03:58:52 -0700 (PDT) Received-SPF: neutral (google.com: 192.35.17.28 is neither permitted nor denied by best guess record for domain of christian.storm@siemens.com) client-ip=192.35.17.28; Received: from mail1.siemens.de (mail1.siemens.de [139.23.33.14]) by goliath.siemens.de (8.15.2/8.15.2) with ESMTPS id v96Awqij007903 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Fri, 6 Oct 2017 12:58:52 +0200 Received: from MD1KR9XC.ww002.siemens.net ([139.25.69.251]) by mail1.siemens.de (8.15.2/8.15.2) with ESMTP id v96Awpef012563; Fri, 6 Oct 2017 12:58:51 +0200 From: Christian Storm To: swupdate@googlegroups.com Cc: Christian Storm Subject: [swupdate] [PATCH] handlers: document handler masks Date: Fri, 6 Oct 2017 12:58:45 +0200 Message-Id: <20171006105845.32226-1-christian.storm@siemens.com> X-Mailer: git-send-email 2.14.2 X-Original-Sender: christian.storm@siemens.com X-Original-Authentication-Results: gmr-mx.google.com; spf=neutral (google.com: 192.35.17.28 is neither permitted nor denied by best guess record for domain of christian.storm@siemens.com) smtp.mailfrom=christian.storm@siemens.com Precedence: list Mailing-list: list swupdate@googlegroups.com; contact swupdate+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: swupdate@googlegroups.com X-Google-Group-Id: 605343134186 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Signed-off-by: Christian Storm --- doc/source/handlers.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/source/handlers.rst b/doc/source/handlers.rst index f2bc9ad..51e087f 100644 --- a/doc/source/handlers.rst +++ b/doc/source/handlers.rst @@ -78,7 +78,7 @@ The handler's developer registers his own handler with a call to: __attribute__((constructor)) void my_handler_init(void) { - register_handler("mytype", my_handler, data); + register_handler("mytype", my_handler, my_mask, data); } SWUpdate uses the gcc constructors, and all supplied handlers are registered @@ -88,12 +88,14 @@ register_handler has the syntax: :: - register_handler(my_image_type, my_handler, data); + register_handler(my_image_type, my_handler, my_mask, data); Where: - my_image_type : string identifying the own new image type. - my_handler : pointer to the installer to be registered. +- my_mask : ``HANDLER_MASK`` enum value(s) specifying what + input type(s) my_handler can process. - data : an optional pointer to an own structure, that SWUpdate saves in the handlers' list and pass to the handler when it will be executed.