From patchwork Tue Jul 6 00:18:22 2010 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tilman Schmidt X-Patchwork-Id: 57959 X-Patchwork-Delegate: davem@davemloft.net Return-Path: X-Original-To: patchwork-incoming@ozlabs.org Delivered-To: patchwork-incoming@ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 64D7EB6EF1 for ; Tue, 6 Jul 2010 10:22:47 +1000 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752128Ab0GFASn (ORCPT ); Mon, 5 Jul 2010 20:18:43 -0400 Received: from mail.pxnet.com ([89.1.7.7]:41922 "EHLO mail.pxnet.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752824Ab0GFASl (ORCPT ); Mon, 5 Jul 2010 20:18:41 -0400 Received: from xenon.ts.pxnet.com (pD9E860E3.dip.t-dialin.net [217.232.96.227]) (user=ts author=<> mech=DIGEST-MD5 bits=0) by mail.pxnet.com (8.13.8/8.13.8) with ESMTP id o660ISD2007142 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 6 Jul 2010 02:18:30 +0200 Received: by xenon.ts.pxnet.com (Postfix, from userid 1000) id 6A05740140; Tue, 6 Jul 2010 02:18:22 +0200 (CEST) Subject: [PATCH 1/2] Documentation/isdn: CAPI controller interface amendment From: Tilman Schmidt To: Karsten Keil , David Miller CC: Hansjoerg Lipp , Karsten Keil , i4ldeveloper@listserv.isdn4linux.de, netdev@vger.kernel.org, linux-kernel@vger.kernel.org Message-ID: <20100705-patch-isdn-01.tilman@imap.cc> In-Reply-To: <20100705-patch-isdn-00.tilman@imap.cc> References: <20100705-patch-isdn-00.tilman@imap.cc> Date: Tue, 6 Jul 2010 02:18:22 +0200 (CEST) X-Spam-Score: -2.062 () AWL,BAYES_00,RDNS_DYNAMIC X-Scanned-By: MIMEDefang 2.70 on 89.1.7.7 Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Mention that the CAPI controller methods load_firmware() and reset_ctr() are asynchronous, and should signal completion. Impact: documentation Signed-off-by: Tilman Schmidt --- Documentation/isdn/INTERFACE.CAPI | 8 ++++++-- 1 files changed, 6 insertions(+), 2 deletions(-) diff --git a/Documentation/isdn/INTERFACE.CAPI b/Documentation/isdn/INTERFACE.CAPI index f172091..309eb5e 100644 --- a/Documentation/isdn/INTERFACE.CAPI +++ b/Documentation/isdn/INTERFACE.CAPI @@ -113,12 +113,16 @@ char *driver_name int (*load_firmware)(struct capi_ctr *ctrlr, capiloaddata *ldata) (optional) pointer to a callback function for sending firmware and configuration data to the device + The function may return before the operation has completed. + Completion must be signalled by a call to capi_ctr_ready(). Return value: 0 on success, error code on error Called in process context. void (*reset_ctr)(struct capi_ctr *ctrlr) - (optional) pointer to a callback function for performing a reset on - the device, releasing all registered applications + (optional) pointer to a callback function for stopping the device, + releasing all registered applications + The function may return before the operation has completed. + Completion must be signalled by a call to capi_ctr_down(). Called in process context. void (*register_appl)(struct capi_ctr *ctrlr, u16 applid,