1
0
mirror of https://sourceware.org/git/glibc.git synced 2025-08-08 17:42:12 +03:00
Files
glibc/termios/baud.c
H. Peter Anvin (Intel) 5f138519eb termios: add new baud_t interface, defined to be explicitly numeric
Add an explicitly numeric interface for baudrate setting. For glibc,
this only announces what is a fair accompli, but this is a plausible
way forward for standardization, and may be possible to infill on
non-compliant systems. The POSIX committee has stated:

[https://www.austingroupbugs.net/view.php?id=1916#c7135]

	A future version of this standard is expected to add at least
	the following symbolic constants for use as values of objects
	of type speed_t: B57600, B115200, B230400, B460800, and
	B921600.

	Implementations are encouraged to propose additional
	interfaces which will make it possible to set and query a
	wider range of speeds than just those enumerated by the
	constants beginning with B. If a set of common interfaces
	emerges between several implementations, a future version of
	this standard will likely add those interfaces.

This is exactly that interface.

The use of the term "baud" is due to the need to have a term
contrasting "speed", and it is already well established as a legacy
term -- including in the names of the legacy Bxxx
constants. Futhermore, it *is* valid from the point of view that the
termios interface fundamentally emulates an RS-232 serial port as far
as the application software is concerned.

The documentation states that for the current version of glibc,
speed_t == baud_t, but explicitly declares that this may not be the
case in the future.

Signed-off-by: H. Peter Anvin (Intel) <hpa@zytor.com>
Reviewed-by: Adhemerval Zanella  <adhemerval.zanella@linaro.org>
2025-06-17 09:11:38 -03:00

57 lines
1.7 KiB
C

/* `struct termios' speed frobnication functions, baud rate wrappers.
Any platform which doesn't have Bxxx == xxx for all baud rate
constants will need to override this file.
Copyright (C) 1991-2025 Free Software Foundation, Inc.
This file is part of the GNU C Library.
The GNU C Library 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.1 of the License, or (at your option) any later version.
The GNU C 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 the GNU C Library; if not, see
<https://www.gnu.org/licenses/>. */
#include <stddef.h>
#include <errno.h>
#include <termios.h>
baud_t
__cfgetobaud (const struct termios *termios_p)
{
return __cfgetospeed (termios_p);
}
libc_hidden_def (__cfgetobaud)
weak_alias (__cfgetobaud, cfgetobaud)
baud_t
__cfgetibaud (const struct termios *termios_p)
{
return __cfgetispeed (termios_p);
}
libc_hidden_def (__cfgetibaud)
weak_alias (__cfgetibaud, cfgetibaud)
int
__cfsetobaud (struct termios *termios_p, baud_t baud)
{
return __cfsetospeed (termios_p, baud);
}
libc_hidden_def (__cfsetobaud)
weak_alias (__cfsetobaud, cfsetobaud)
int
__cfsetibaud (struct termios *termios_p, baud_t baud)
{
return __cfsetispeed (termios_p, baud);
}
libc_hidden_def (__cfsetibaud)
weak_alias (__cfsetibaud, cfsetibaud)