xref: /freebsd/lib/libutil/login_auth.3 (revision 4aee48edccd1ec89a29a44be2a509c807b23c324)
1.\" Copyright (c) 1995 David Nugent <davidn@blaze.net.au>
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, is permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice immediately at the beginning of the file, without modification,
9.\"    this list of conditions, and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\" 3. This work was done expressly for inclusion into FreeBSD.  Other use
14.\"    is permitted provided this notation is included.
15.\" 4. Absolutely no warranty of function or purpose is made by the author
16.\"    David Nugent.
17.\" 5. Modifications may be freely made to this file providing the above
18.\"    conditions are met.
19.\"
20.\" $FreeBSD$
21.\"
22.Dd December 29, 1996
23.Os FreeBSD
24.Dt LOGIN_AUTH 3
25.Sh NAME
26.\" .Nm authenticate
27.\" .Nm auth_script
28.\" .Nm auth_env
29.\" .Nm auth_scan
30.\" .Nm auth_rmfiles
31.Nm auth_checknologin ,
32.Nm auth_cat
33.\" .Nm auth_ttyok
34.\" .Nm auth_hostok
35.\" .Nm auth_timesok
36.Nd authentication style support library for login class capabilities database.
37.Sh SYNOPSIS
38.Fd #include <sys/types.h>
39.Fd #include <login_cap.h>
40.\" .Ft int
41.\". Fn authenticate "const char *name" "const char *classname" "const char *style" "const char *service"
42.\" .Ft int
43.\" .Fn auth_script "const char * path" ...
44.\" .Ft void
45.\" .Fn auth_env "void"
46.\" .Ft int
47.\" .Fn auth_scan "int ok"
48.\" .Ft void
49.\" .Fn auth_rmfiles "void"
50.Ft void
51.Fn auth_checknologin "login_cap_t *lc"
52.Ft int
53.Fn auth_cat "const char *file"
54.\" .Ft int
55.\" .Fn auth_ttyok "login_cap_t *lc" "const char *tty"
56.\" .Ft int
57.\" .Fn auth_hostok "login_cap_t *lc" "const char *hostname" "char const *ip"
58.\" .Ft int
59.\" .Fn auth_timesok "login_cap_t *lc" "time_t now"
60.Pp
61Link with
62.Va -lutil
63on the
64.Xr cc 1
65command line.
66.Sh DESCRIPTION
67This set of functions support the login class authorisation style interface provided
68by
69.Xr login.conf 5 .
70.\" .Sh RETURN VALUES
71.Sh SEE ALSO
72.Xr getcap 3 ,
73.Xr login_cap 3 ,
74.Xr login_class 3 ,
75.Xr login.conf 5 ,
76.Xr termcap 5
77