From patchwork Sun Jun 29 16:16:32 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "H. Peter Anvin" X-Patchwork-Id: 115262 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id EAF143852FF3 for ; Sun, 29 Jun 2025 16:22:35 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org EAF143852FF3 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=zytor.com header.i=@zytor.com header.a=rsa-sha256 header.s=2025062101 header.b=QvhUjU3C X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail.zytor.com (terminus.zytor.com [IPv6:2607:7c80:54:3::136]) by sourceware.org (Postfix) with ESMTPS id 875EF3852FE1 for ; Sun, 29 Jun 2025 16:16:41 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 875EF3852FE1 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=zytor.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=zytor.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 875EF3852FE1 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2607:7c80:54:3::136 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1751213801; cv=none; b=DFyvLGgeODmvGOgqG0ICfH3t+3yZOui/V0Au1N18cbkmvEXFI+DkXGArPLucQhprdFVTN+SMGpzC/93iAqvWVpuJ8M93JmGJkt5BJvOgqw+lS+hTdjK3bvTVE8VDBKGBjMIY3ysMiHSRWaNiBC502pZaS95RawkgpK/Zbj4viQM= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1751213801; c=relaxed/simple; bh=PaJ8K5Hmcl45DV1ZxYjmVjoL0D9oHr8vJHURUxT1SFo=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=qoCkJOZpUUBzqCZLXSV9wfThBz1Os7zkJ2yiWKZ2yWAlQ664NyzKaX9VJ4mAPYetVDt207urtiGnUZ8W7nnavTKWAtu4dRKsQC4AfOijY+Q4Wgb+eXqMx2GxkgU/N0mDKqMVkjsgkMGdTSHUrVCzbYJ1dvoZ3HN9XDJ9CEVSa7w= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 875EF3852FE1 Received: from mail.zytor.com ([IPv6:2601:646:8081:9482:ef13:4515:a701:e3bb]) (authenticated bits=0) by mail.zytor.com (8.18.1/8.17.1) with ESMTPSA id 55TGGcKq3515149 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NO); Sun, 29 Jun 2025 09:16:40 -0700 DKIM-Filter: OpenDKIM Filter v2.11.0 mail.zytor.com 55TGGcKq3515149 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=zytor.com; s=2025062101; t=1751213800; bh=nNB4RS+xSd7gHASqZTMQPNg9UdB8HvVC9F6FLSr77Rw=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=QvhUjU3C3LajQvT8I8KuKmg99mWGlHIR8ED/q3IiJhJ+CMwxHJTaimqZzwUlzo7N5 tm2B8Sm0mEPh+8ohXcTHjcsUDj5iONz/a3CN0gOonEjHJflJ5qZErxs7vOKLK5TES0 /8URfmlVjyjU0mjxaLQ6FGf4c5AB5OLd+LkHqd2HNdFiT8PM5YMRLJa+wboRTo/7Tf Iv/gJNR95jrT4IJ+a9jNBmn1lrKFDJnD+SaoTWdXMrR9O6A97Gdl1KW9IBCg3/PZNv Z143nOyV1fQE48Ms8iU+fZKqhIAye2K+0lA6J4I6oGFE7l8Y7JKpBqYj/fQwT9oUQh czCBDe9TfKL5Q== From: "H. Peter Anvin" To: libc-alpha@sourceware.org Cc: "H. Peter Anvin" Subject: [PATCH v2 5/5] termios: manual: document the _SPEED_MAX and _BAUD_MAX constants Date: Sun, 29 Jun 2025 09:16:32 -0700 Message-ID: <20250629161632.581628-6-hpa@zytor.com> X-Mailer: git-send-email 2.50.0 In-Reply-To: <20250629161632.581628-1-hpa@zytor.com> References: <20250629161632.581628-1-hpa@zytor.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, SPF_HELO_PASS, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libc-alpha-bounces~patchwork=sourceware.org@sourceware.org Add the _SPEED_MAX and _BAUD_MAX constants to the manual. Signed-off-by: "H. Peter Anvin" (Intel) --- manual/terminal.texi | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/manual/terminal.texi b/manual/terminal.texi index b43231b8bf2a..b716117233bb 100644 --- a/manual/terminal.texi +++ b/manual/terminal.texi @@ -1264,6 +1264,17 @@ BSD defines two additional speed symbols as aliases: @code{EXTA} is an alias for @code{B19200} and @code{EXTB} is an alias for @code{B38400}. These aliases are obsolete. +@deftypevr Macro speed_t _SPEED_MAX +@standards{GNU, termios.h} + +@theglibc{} defines the constant @code{_SPEED_MAX} for the largest valid +value of type @code{speed_t}. This value may be smaller than the +underlying C type can store. + +For compatiblity with some other platforms the alias @code{__MAX_BAUD} +is defined for this constant. +@end deftypevr + @deftypefun speed_t cfgetospeed (const struct termios *@var{termios-p}) @standards{POSIX.1, termios.h} @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} @@ -1347,6 +1358,13 @@ may not be the case in future versions or on other implementations; it is specifically not guaranteed to be an integer type. @end deftp +@deftypevr Macro baud_t _BAUD_MAX +@standards{GNU, termios.h} +The constant @code{_BAUD_MAX} is defined to the maximum valid value of +type @code{baud_t}. This value may be smaller than the underlying C +type can store. +@end deftypevr + @deftypefun baud_t cfgetobaud (const struct termios *@var{termios-p}) @standards{GNU, termios.h} @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}