1
0
mirror of https://sourceware.org/git/glibc.git synced 2025-06-27 00:01:05 +03:00
Files
glibc/sysdeps/unix/sysv/linux/cfsetspeed.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

60 lines
1.9 KiB
C

/* cfsetspeed(), Linux version.
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 <termios_internals.h>
/* Set both the input and output baud rates stored in *TERMIOS_P to SPEED. */
int
__cfsetspeed (struct termios *termios_p, speed_t speed)
{
tcflag_t cbaud = ___speed_to_cbaud (speed);
termios_p->c_ospeed = speed;
termios_p->c_ispeed = speed;
termios_p->c_cflag &= ~(CBAUD | CIBAUD);
termios_p->c_cflag |= cbaud | (cbaud << IBSHIFT);
return 0;
}
libc_hidden_def (__cfsetspeed)
versioned_symbol (libc, __cfsetspeed, cfsetspeed, GLIBC_2_42);
#if _TERMIOS_OLD_COMPAT
int
attribute_compat_text_section
__old_cfsetspeed (old_termios_t *termios_p, speed_t speed)
{
speed_t real_speed = ___cbaud_to_speed (speed, -1);
if (real_speed == (speed_t)-1)
return INLINE_SYSCALL_ERROR_RETURN_VALUE (EINVAL);
#if !_HAVE_STRUCT_OLD_TERMIOS
/* Otherwise these fields don't exist in old_termios_t */
termios_p->c_ospeed = real_speed;
termios_p->c_ispeed = real_speed;
#endif
termios_p->c_cflag &= ~(CBAUD | CIBAUD);
termios_p->c_cflag |= speed | (speed << IBSHIFT);
return 0;
}
compat_symbol (libc, __old_cfsetspeed, cfsetspeed, GLIBC_2_0);
#endif /* _TERMIOS_OLD_COMPAT */