Differential D27623 Diff 80826 head/lib/libc/string/strerror.3

Changeset View

Standalone View

head/lib/libc/string/strerror.3

	Show All 26 Lines
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" @(#)strerror.3 8.1 (Berkeley) 6/9/93			.\" @(#)strerror.3 8.1 (Berkeley) 6/9/93
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd December 7, 2020			.Dd December 17, 2020
	.Dt STRERROR 3			.Dt STRERROR 3
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm perror ,			.Nm perror ,
	.Nm strerror ,			.Nm strerror ,
	.Nm strerror_l ,			.Nm strerror_l ,
	.Nm strerror_r ,			.Nm strerror_r ,
	.Nm sys_errlist ,			.Nm sys_errlist ,
	▲ Show 20 Lines • Show All 121 Lines • ▼ Show 20 Lines
	contains a count of the messages in			contains a count of the messages in
	.Va sys_errlist .			.Va sys_errlist .
	The use of these variables is deprecated;			The use of these variables is deprecated;
	.Fn strerror ,			.Fn strerror ,
	.Fn strerror_l ,			.Fn strerror_l ,
	or			or
	.Fn strerror_r			.Fn strerror_r
	should be used instead.			should be used instead.
				.Sh EXAMPLES
				The following example shows how to use
				.Fn perror
				to report an error.
				.Bd -literal -offset 2n
				#include <fcntl.h>
				#include <stdio.h>
				#include <stdlib.h>

				int
				main(void)
				{
				int fd;

				if ((fd = open("/nonexistent", O_RDONLY)) == -1) {
				perror("open()");
				exit(1);
				}
				printf("File descriptor: %d\en", fd);
				return (0);
				}
				.Ed
				.Pp
				When executed, the program will print an error message along the lines of
				.Ql "open(): No such file or directory" .
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr intro 2 ,			.Xr intro 2 ,
	.Xr err 3 ,			.Xr err 3 ,
	.Xr psignal 3			.Xr psignal 3
	.Sh STANDARDS			.Sh STANDARDS
	The			The
	.Fn perror			.Fn perror
	and			and
	▲ Show 20 Lines • Show All 42 Lines • Show Last 20 Lines