10271 Convert cf{get,set}ispeed.3C and cf{get,set}speed.3C to mandoc

*** 40,126 ****
  .\" information: Portions Copyright [yyyy] [name of copyright owner]
  .\"
  .\"
  .\" Portions Copyright (c) 1992, X/Open Company Limited.  All Rights Reserved.
  .\" Copyright (c) 2002, Sun Microsystems, Inc.  All Rights Reserved
  .\"
! .TH CFSETISPEED 3C "Jul 24, 2002"
! .SH NAME
! cfsetispeed, cfsetospeed \- set input and output baud rate
! .SH SYNOPSIS
! .LP
! .nf
! #include <termios.h>
! 
! \fBint\fR \fBcfsetispeed\fR(\fBstruct termios *\fR\fItermios_p\fR, \fBspeed_t\fR \fIspeed\fR);
! .fi
! 
! .LP
! .nf
! \fBint\fR \fBcfsetospeed\fR(\fBstruct termios *\fR\fItermios_p\fR, \fBspeed_t\fR \fIspeed\fR);
! .fi
! 
! .SH DESCRIPTION
! .sp
! .LP
! The \fBcfsetispeed()\fR function sets the input baud rate stored in the
! structure pointed to by \fItermios_p\fR to \fIspeed.\fR
! .sp
! .LP
! The \fBcfsetospeed()\fR function sets the output baud rate stored in the
! structure pointed to by \fItermios_p\fR to \fIspeed.\fR
! .sp
! .LP
  There is no effect on the baud rates set in the hardware until a subsequent
! successful call to \fBtcsetattr\fR(3C) on the same \fBtermios\fR structure.
! .SH RETURN VALUES
! .sp
! .LP
! Upon successful completion, \fBcfsetispeed()\fR and \fBcfsetospeed()\fR return
! \fB0\fR. Otherwise \fB\(mi1\fR is returned, and \fBerrno\fR may be set to
! indicate the error.
! .SH ERRORS
! .sp
! .LP
! The \fBcfsetispeed()\fR and \fBcfsetospeed()\fR functions may fail if:
! .sp
! .ne 2
! .na
! \fB\fBEINVAL\fR\fR
! .ad
! .RS 10n
! The \fIspeed\fR value is not a valid baud rate.
! .RE
! 
! .sp
! .ne 2
! .na
! \fB\fBEINVAL\fR\fR
! .ad
! .RS 10n
! The value of \fIspeed\fR is outside the range of possible speed values as
! specified in \fB<termios.h>\fR\&.
! .RE
! 
! .SH ATTRIBUTES
! .sp
! .LP
! See \fBattributes\fR(5) for descriptions of the following attributes:
! .sp
! 
! .sp
! .TS
! box;
! c | c
! l | l .
! ATTRIBUTE TYPE  ATTRIBUTE VALUE
! _
! Interface Stability     Standard
! _
! MT-Level        MT-Safe, and Async-Signal-Safe
! .TE
! 
! .SH SEE ALSO
! .sp
! .LP
! \fBcfgetispeed\fR(3C), \fBtcsetattr\fR(3C), \fBattributes\fR(5),
! \fBstandards\fR(5), \fBtermio\fR(7I)
--- 40,129 ----
  .\" information: Portions Copyright [yyyy] [name of copyright owner]
  .\"
  .\"
  .\" Portions Copyright (c) 1992, X/Open Company Limited.  All Rights Reserved.
  .\" Copyright (c) 2002, Sun Microsystems, Inc.  All Rights Reserved
+ .\" Copyright 2019, Joyent, Inc.
  .\"
! .Dd January 20, 2019
! .Dt CFSETISPEED 3C
! .Os
! .Sh NAME
! .Nm cfsetispeed ,
! .Nm cfsetospeed
! .Nd set input and output baud rate
! .Sh SYNOPSIS
! .In termios.h
! .Ft int
! .Fo cfsetispeed
! .Fa "struct termios *termios_p"
! .Fa "speed_t speed"
! .Fc
! .Ft int
! .Fo cfsetospeed
! .Fa "struct termios *termios_p"
! .Fa "speed_t speed"
! .Fc
! .Sh DESCRIPTION
! The
! .Fn cfsetispeed
! function sets the input baud rate stored in the
! structure pointed to by
! .Fa termios_p
! to
! .Fa speed .
! .Pp
! The
! .Fn cfsetospeed
! function sets the output baud rate stored in the
! structure pointed to by
! .Fa termios_p
! to
! .Fa speed .
! .Pp
  There is no effect on the baud rates set in the hardware until a subsequent
! successful call to
! .Xr tcsetattr 3C
! on the same
! .Vt termios
! structure.
! .Sh RETURN VALUES
! Upon successful completion,
! .Fn cfsetispeed
! and
! .Fn cfsetospeed
! return
! .Sy 0 .
! Otherwise
! .Sy \(mi1
! is returned, and
! .Va errno
! may be set to indicate the error.
! .Sh ERRORS
! The
! .Fn cfsetispeed
! and
! .Fn cfsetospeed
! functions may fail if:
! .Bl -tag -width EINVAL
! .It Er EINVAL
! The
! .Fa speed
! value is not a valid baud rate.
! .It Er EINVAL
! The value of
! .Fa speed
! is outside the range of possible speed values as specified in
! .In termios.h .
! .El
! .Sh INTERFACE STABILITY
! Standard
! .Sh MT-LEVEL
! MT-Safe
! .Pp
! Async-Signal-Safe
! .Sh SEE ALSO
! .Xr cfgetispeed 3C ,
! .Xr tcsetattr 3C ,
! .Xr attributes 5 ,
! .Xr standards 5 ,
! .Xr termio 7I