[thirdparty/cups.git] / cups / usersys.c

/*
 * "$Id: usersys.c 4918 2006-01-12 05:14:40Z mike $"
 *
 *   User, system, and password routines for the Common UNIX Printing
 *   System (CUPS).
 *
 *   Copyright 1997-2006 by Easy Software Products.
 *
 *   These coded instructions, statements, and computer programs are the
 *   property of Easy Software Products and are protected by Federal
 *   copyright law.  Distribution and use rights are outlined in the file
 *   "LICENSE.txt" which should have been included with this file.  If this
 *   file is missing or damaged please contact Easy Software Products
 *   at:
 *
 *       Attn: CUPS Licensing Information
 *       Easy Software Products
 *       44141 Airport View Drive, Suite 204
 *       Hollywood, Maryland 20636 USA
 *
 *       Voice: (301) 373-9600
 *       EMail: cups-info@cups.org
 *         WWW: http://www.cups.org
 *
 *   This file is subject to the Apple OS-Developed Software exception.
 *
 * Contents:
 *
 *   cupsEncryption()    - Get the default encryption settings.
 *   cupsGetPassword()   - Get a password from the user.
 *   cupsServer()        - Return the hostname of the default server.
 *   cupsSetEncryption() - Set the encryption preference.
 *   cupsSetPasswordCB() - Set the password callback for CUPS.
 *   cupsSetServer()     - Set the default server name.
 *   cupsSetUser()       - Set the default user name.
 *   cupsUser()          - Return the current users name.
 *   _cupsGetPassword()  - Get a password from the user.
 */

/*
 * Include necessary headers...
 */

#include "http-private.h"
#include "globals.h"
#include <stdlib.h>
#ifdef WIN32
#  include <windows.h>
#endif /* WIN32 */


/*
 * 'cupsEncryption()' - Get the default encryption settings.
 *
 * The default encryption setting comes from the CUPS_ENCRYPTION
 * environment variable, then the ~/.cupsrc file, and finally the
 * /etc/cups/client.conf file. If not set, the default is
 * HTTP_ENCRYPT_IF_REQUESTED.
 */

http_encryption_t			/* O - Encryption settings */
cupsEncryption(void)
{
  cups_file_t	*fp;			/* client.conf file */
  char		*encryption;		/* CUPS_ENCRYPTION variable */
  const char	*home;			/* Home directory of user */
  char		line[1024],		/* Line from file */
		*value;			/* Value on line */
  int		linenum;		/* Line number */
  _cups_globals_t *cg = _cupsGlobals();	/* Pointer to library globals */


 /*
  * First see if we have already set the encryption stuff...
  */

  if (cg->encryption == (http_encryption_t)-1)
  {
   /*
    * Then see if the CUPS_ENCRYPTION environment variable is set...
    */

    if ((encryption = getenv("CUPS_ENCRYPTION")) == NULL)
    {
     /*
      * Next check to see if we have a $HOME/.cupsrc or client.conf file...
      */

      if ((home = getenv("HOME")) != NULL)
      {
	snprintf(line, sizeof(line), "%s/.cupsrc", home);
	fp = cupsFileOpen(line, "r");
      }
      else
	fp = NULL;

      if (fp == NULL)
      {
	snprintf(line, sizeof(line), "%s/client.conf", cg->cups_serverroot);
	fp = cupsFileOpen(line, "r");
      }

      encryption = "IfRequested";

      if (fp != NULL)
      {
       /*
	* Read the config file and look for an Encryption line...
	*/

        linenum = 0;

	while (cupsFileGetConf(fp, line, sizeof(line), &value, &linenum) != NULL)
	  if (!strcasecmp(line, "Encryption") && value)
	  {
	   /*
	    * Got it!
	    */

	    encryption = value;
	    break;
	  }

	cupsFileClose(fp);
      }
    }

   /*
    * Set the encryption preference...
    */

    if (!strcasecmp(encryption, "never"))
      cg->encryption = HTTP_ENCRYPT_NEVER;
    else if (!strcasecmp(encryption, "always"))
      cg->encryption = HTTP_ENCRYPT_ALWAYS;
    else if (!strcasecmp(encryption, "required"))
      cg->encryption = HTTP_ENCRYPT_REQUIRED;
    else
      cg->encryption = HTTP_ENCRYPT_IF_REQUESTED;
  }

  return (cg->encryption);
}


/*
 * 'cupsGetPassword()' - Get a password from the user.
 *
 * Returns NULL if the user does not provide a password.
 */

const char *				/* O - Password */
cupsGetPassword(const char *prompt)	/* I - Prompt string */
{
  return ((*_cupsGlobals()->password_cb)(prompt));
}


/*
 * 'cupsSetEncryption()' - Set the encryption preference.
 */

void
cupsSetEncryption(http_encryption_t e)	/* I - New encryption preference */
{
  _cupsGlobals()->encryption = e;
}


/*
 * 'cupsServer()' - Return the hostname/address of the default server.
 *
 * The returned value can be a fully-qualified hostname, a numeric
 * IPv4 or IPv6 address, or a domain socket pathname.
 */

const char *				/* O - Server name */
cupsServer(void)
{
  cups_file_t	*fp;			/* client.conf file */
  char		*server;		/* Pointer to server name */
  const char	*home;			/* Home directory of user */
  char		*port;			/* Port number */
  char		line[1024],		/* Line from file */
		*value;			/* Value on line */
  int		linenum;		/* Line number in file */
  _cups_globals_t *cg = _cupsGlobals();	/* Pointer to library globals */


 /*
  * First see if we have already set the server name...
  */

  if (!cg->server[0])
  {
   /*
    * Then see if the CUPS_SERVER environment variable is set...
    */

    if ((server = getenv("CUPS_SERVER")) == NULL)
    {
     /*
      * Next check to see if we have a $HOME/.cupsrc or client.conf file...
      */

      if ((home = getenv("HOME")) != NULL)
      {
	snprintf(line, sizeof(line), "%s/.cupsrc", home);
	fp = cupsFileOpen(line, "r");
      }
      else
	fp = NULL;

      if (fp == NULL)
      {
	snprintf(line, sizeof(line), "%s/client.conf", cg->cups_serverroot);
	fp = cupsFileOpen(line, "r");
      }

#ifdef CUPS_DEFAULT_DOMAINSOCKET
      if (!access(CUPS_DEFAULT_DOMAINSOCKET, 0))
        server = CUPS_DEFAULT_DOMAINSOCKET;
      else
#endif /* CUPS_DEFAULT_DOMAINSOCKET */
      server = "localhost";

      if (fp != NULL)
      {
       /*
	* Read the config file and look for a ServerName line...
	*/

        linenum = 0;
	while (cupsFileGetConf(fp, line, sizeof(line), &value, &linenum) != NULL)
	  if (!strcasecmp(line, "ServerName") && value)
	  {
	   /*
	    * Got it!
	    */

	    server = value;
	    break;
	  }

	cupsFileClose(fp);
      }
    }

   /*
    * Copy the server name over and set the port number, if any...
    */

    strlcpy(cg->server, server, sizeof(cg->server));

    if (cg->server[0] != '/' && (port = strrchr(cg->server, ':')) != NULL &&
        !strchr(port, ']') && isdigit(port[1] & 255))
    {
      *port++ = '\0';

      ippSetPort(atoi(port));
    }

    if (cg->server[0] == '/')
      strcpy(cg->servername, "localhost");
    else
      strlcpy(cg->servername, cg->server, sizeof(cg->servername));
  }

  return (cg->server);
}


/*
 * 'cupsSetPasswordCB()' - Set the password callback for CUPS.
 *
 * Pass NULL to restore the default (console) password callback.
 */

void
cupsSetPasswordCB(cups_password_cb_t cb)/* I - Callback function */
{
  _cups_globals_t *cg = _cupsGlobals();	/* Pointer to library globals */


  if (cb == (const char *(*)(const char *))0)
    cg->password_cb = _cupsGetPassword;
  else
    cg->password_cb = cb;
}


/*
 * 'cupsSetServer()' - Set the default server name.
 *
 * The "server" string can be a fully-qualified hostname, a numeric
 * IPv4 or IPv6 address, or a domain socket pathname. Pass NULL to
 * restore the default server name.
 */

void
cupsSetServer(const char *server)	/* I - Server name */
{
  char		*port;			/* Pointer to port */
  _cups_globals_t *cg = _cupsGlobals();	/* Pointer to library globals */


  if (server)
  {
    strlcpy(cg->server, server, sizeof(cg->server));

    if (cg->server[0] != '/' && (port = strrchr(cg->server, ':')) != NULL &&
        !strchr(port, ']') && isdigit(port[1] & 255))
    {
      *port++ = '\0';

      ippSetPort(atoi(port));
    }

    if (cg->server[0] == '/')
      strcpy(cg->servername, "localhost");
    else
      strlcpy(cg->servername, cg->server, sizeof(cg->servername));
  }
  else
  {
    cg->server[0]     = '\0';
    cg->servername[0] = '\0';
  }
}


/*
 * 'cupsSetUser()' - Set the default user name.
 *
 * Pass NULL to restore the default user name.
 */

void
cupsSetUser(const char *user)		/* I - User name */
{
  _cups_globals_t *cg = _cupsGlobals();	/* Pointer to library globals */


  if (user)
    strlcpy(cg->user, user, sizeof(cg->user));
  else
    cg->user[0] = '\0';
}


#if defined(WIN32)
/*
 * WIN32 username and password stuff.
 */

/*
 * 'cupsUser()' - Return the current user's name.
 */

const char *				/* O - User name */
cupsUser(void)
{
  _cups_globals_t *cg = _cupsGlobals();	/* Pointer to library globals */


  if (!cg->user[0])
  {
    DWORD	size;		/* Size of string */


    size = sizeof(cg->user);
    if (!GetUserName(cg->user, &size))
    {
     /*
      * Use the default username...
      */

      strcpy(cg->user, "unknown");
    }
  }

  return (cg->user);
}


/*
 * '_cupsGetPassword()' - Get a password from the user.
 */

const char *				/* O - Password */
_cupsGetPassword(const char *prompt)	/* I - Prompt string */
{
  return (NULL);
}
#else
/*
 * UNIX username and password stuff...
 */

#  include <pwd.h>

/*
 * 'cupsUser()' - Return the current user's name.
 */

const char *				/* O - User name */
cupsUser(void)
{
  struct passwd	*pwd;			/* User/password entry */
  _cups_globals_t *cg = _cupsGlobals();	/* Pointer to library globals */


  if (!cg->user[0])
  {
   /*
    * Rewind the password file...
    */

    setpwent();

   /*
    * Lookup the password entry for the current user.
    */

    if ((pwd = getpwuid(getuid())) == NULL)
      strcpy(cg->user, "unknown");	/* Unknown user! */
    else
    {
     /*
      * Copy the username...
      */

      setpwent();

      strlcpy(cg->user, pwd->pw_name, sizeof(cg->user));
    }

   /*
    * Rewind the password file again...
    */

    setpwent();
  }

  return (cg->user);
}


/*
 * '_cupsGetPassword()' - Get a password from the user.
 */

const char *				/* O - Password */
_cupsGetPassword(const char *prompt)	/* I - Prompt string */
{
  return (getpass(prompt));
}
#endif /* WIN32 */


/*
 * End of "$Id: usersys.c 4918 2006-01-12 05:14:40Z mike $".
 */
Commit	Line	Data
ef416fc2	1	/*
	2	* "$Id: usersys.c 4918 2006-01-12 05:14:40Z mike $"
	3	*
	4	* User, system, and password routines for the Common UNIX Printing
	5	* System (CUPS).
	6	*
	7	* Copyright 1997-2006 by Easy Software Products.
	8	*
	9	* These coded instructions, statements, and computer programs are the
	10	* property of Easy Software Products and are protected by Federal
	11	* copyright law. Distribution and use rights are outlined in the file
	12	* "LICENSE.txt" which should have been included with this file. If this
	13	* file is missing or damaged please contact Easy Software Products
	14	* at:
	15	*
	16	* Attn: CUPS Licensing Information
	17	* Easy Software Products
	18	* 44141 Airport View Drive, Suite 204
	19	* Hollywood, Maryland 20636 USA
	20	*
	21	* Voice: (301) 373-9600
	22	* EMail: cups-info@cups.org
	23	* WWW: http://www.cups.org
	24	*
	25	* This file is subject to the Apple OS-Developed Software exception.
	26	*
	27	* Contents:
	28	*
	29	* cupsEncryption() - Get the default encryption settings.
	30	* cupsGetPassword() - Get a password from the user.
	31	* cupsServer() - Return the hostname of the default server.
	32	* cupsSetEncryption() - Set the encryption preference.
	33	* cupsSetPasswordCB() - Set the password callback for CUPS.
	34	* cupsSetServer() - Set the default server name.
	35	* cupsSetUser() - Set the default user name.
	36	* cupsUser() - Return the current users name.
	37	* _cupsGetPassword() - Get a password from the user.
	38	*/
	39
	40	/*
	41	* Include necessary headers...
	42	*/
	43
	44	#include "http-private.h"
	45	#include "globals.h"
	46	#include <stdlib.h>
	47	#ifdef WIN32
	48	# include <windows.h>
	49	#endif /* WIN32 */
	50
	51
	52	/*
	53	* 'cupsEncryption()' - Get the default encryption settings.
	54	*
	55	* The default encryption setting comes from the CUPS_ENCRYPTION
	56	* environment variable, then the ~/.cupsrc file, and finally the
	57	* /etc/cups/client.conf file. If not set, the default is
	58	* HTTP_ENCRYPT_IF_REQUESTED.
	59	*/
	60
	61	http_encryption_t /* O - Encryption settings */
	62	cupsEncryption(void)
	63	{
	64	cups_file_t fp; / client.conf file */
65	char encryption; / CUPS_ENCRYPTION variable */
66	const char home; / Home directory of user */
67	char line[1024], /* Line from file */
68	value; / Value on line */
69	int linenum; /* Line number */
70	_cups_globals_t cg = _cupsGlobals(); / Pointer to library globals */
71
72
73	/*
74	* First see if we have already set the encryption stuff...
75	*/
76
77	if (cg->encryption == (http_encryption_t)-1)
78	{
79	/*
80	* Then see if the CUPS_ENCRYPTION environment variable is set...
81	*/
82
83	if ((encryption = getenv("CUPS_ENCRYPTION")) == NULL)
84	{
85	/*
86	* Next check to see if we have a $HOME/.cupsrc or client.conf file...
87	*/
88
89	if ((home = getenv("HOME")) != NULL)
90	{
91	snprintf(line, sizeof(line), "%s/.cupsrc", home);
92	fp = cupsFileOpen(line, "r");
93	}
94	else
95	fp = NULL;
96
97	if (fp == NULL)
98	{
99	snprintf(line, sizeof(line), "%s/client.conf", cg->cups_serverroot);
100	fp = cupsFileOpen(line, "r");
101	}
102
103	encryption = "IfRequested";
104
105	if (fp != NULL)
106	{
107	/*
108	* Read the config file and look for an Encryption line...
109	*/
110
111	linenum = 0;
112
113	while (cupsFileGetConf(fp, line, sizeof(line), &value, &linenum) != NULL)
114	if (!strcasecmp(line, "Encryption") && value)
115	{
116	/*
117	* Got it!
118	*/
119
120	encryption = value;
121	break;
122	}
123
124	cupsFileClose(fp);
125	}
126	}
127
128	/*
129	* Set the encryption preference...
130	*/
131
132	if (!strcasecmp(encryption, "never"))
133	cg->encryption = HTTP_ENCRYPT_NEVER;
134	else if (!strcasecmp(encryption, "always"))
135	cg->encryption = HTTP_ENCRYPT_ALWAYS;
136	else if (!strcasecmp(encryption, "required"))
137	cg->encryption = HTTP_ENCRYPT_REQUIRED;
138	else
139	cg->encryption = HTTP_ENCRYPT_IF_REQUESTED;
140	}
141
142	return (cg->encryption);
143	}
144
145
146	/*
147	* 'cupsGetPassword()' - Get a password from the user.
148	*
149	* Returns NULL if the user does not provide a password.
150	*/
151
152	const char * /* O - Password */
153	cupsGetPassword(const char prompt) / I - Prompt string */
154	{
155	return ((*_cupsGlobals()->password_cb)(prompt));
156	}
157
158
159	/*
160	* 'cupsSetEncryption()' - Set the encryption preference.
161	*/
162
163	void
164	cupsSetEncryption(http_encryption_t e) /* I - New encryption preference */
165	{
166	_cupsGlobals()->encryption = e;
167	}
168
169
170	/*
171	* 'cupsServer()' - Return the hostname/address of the default server.
172	*
173	* The returned value can be a fully-qualified hostname, a numeric
174	* IPv4 or IPv6 address, or a domain socket pathname.
175	*/
176
177	const char * /* O - Server name */
178	cupsServer(void)
179	{
180	cups_file_t fp; / client.conf file */
181	char server; / Pointer to server name */
182	const char home; / Home directory of user */
183	char port; / Port number */
184	char line[1024], /* Line from file */
185	value; / Value on line */
186	int linenum; /* Line number in file */
187	_cups_globals_t cg = _cupsGlobals(); / Pointer to library globals */
188
189
190	/*
191	* First see if we have already set the server name...
192	*/
193
194	if (!cg->server[0])
195	{
196	/*
197	* Then see if the CUPS_SERVER environment variable is set...
198	*/
199
200	if ((server = getenv("CUPS_SERVER")) == NULL)
201	{
202	/*
203	* Next check to see if we have a $HOME/.cupsrc or client.conf file...
204	*/
205
206	if ((home = getenv("HOME")) != NULL)
207	{
208	snprintf(line, sizeof(line), "%s/.cupsrc", home);
209	fp = cupsFileOpen(line, "r");
210	}
211	else
212	fp = NULL;
213
214	if (fp == NULL)
215	{
216	snprintf(line, sizeof(line), "%s/client.conf", cg->cups_serverroot);
217	fp = cupsFileOpen(line, "r");
218	}
219
220	#ifdef CUPS_DEFAULT_DOMAINSOCKET
221	if (!access(CUPS_DEFAULT_DOMAINSOCKET, 0))
222	server = CUPS_DEFAULT_DOMAINSOCKET;
223	else
224	#endif /* CUPS_DEFAULT_DOMAINSOCKET */
225	server = "localhost";
226
227	if (fp != NULL)
228	{
229	/*
230	* Read the config file and look for a ServerName line...
231	*/
232
233	linenum = 0;
234	while (cupsFileGetConf(fp, line, sizeof(line), &value, &linenum) != NULL)
235	if (!strcasecmp(line, "ServerName") && value)
236	{
237	/*
238	* Got it!
239	*/
240
241	server = value;
242	break;
243	}
244
245	cupsFileClose(fp);
246	}
247	}
248
249	/*
250	* Copy the server name over and set the port number, if any...
251	*/
252
253	strlcpy(cg->server, server, sizeof(cg->server));
254
255	if (cg->server[0] != '/' && (port = strrchr(cg->server, ':')) != NULL &&
256	!strchr(port, ']') && isdigit(port[1] & 255))
257	{
258	*port++ = '\0';
259
260	ippSetPort(atoi(port));
261	}
262
263	if (cg->server[0] == '/')
264	strcpy(cg->servername, "localhost");
265	else
266	strlcpy(cg->servername, cg->server, sizeof(cg->servername));
267	}
268
269	return (cg->server);
270	}
271
272
273	/*
274	* 'cupsSetPasswordCB()' - Set the password callback for CUPS.
275	*
276	* Pass NULL to restore the default (console) password callback.
277	*/
278
279	void
280	cupsSetPasswordCB(cups_password_cb_t cb)/* I - Callback function */
281	{
282	_cups_globals_t cg = _cupsGlobals(); / Pointer to library globals */
283
284
285	if (cb == (const char ()(const char *))0)
286	cg->password_cb = _cupsGetPassword;
287	else
288	cg->password_cb = cb;
289	}
290
291
292	/*
293	* 'cupsSetServer()' - Set the default server name.
294	*
295	* The "server" string can be a fully-qualified hostname, a numeric
296	* IPv4 or IPv6 address, or a domain socket pathname. Pass NULL to
297	* restore the default server name.
298	*/
299
300	void
301	cupsSetServer(const char server) / I - Server name */
302	{
303	char port; / Pointer to port */
304	_cups_globals_t cg = _cupsGlobals(); / Pointer to library globals */
305
306
307	if (server)
308	{
309	strlcpy(cg->server, server, sizeof(cg->server));
310
311	if (cg->server[0] != '/' && (port = strrchr(cg->server, ':')) != NULL &&
312	!strchr(port, ']') && isdigit(port[1] & 255))
313	{
314	*port++ = '\0';
315
316	ippSetPort(atoi(port));
317	}
318
319	if (cg->server[0] == '/')
320	strcpy(cg->servername, "localhost");
321	else
322	strlcpy(cg->servername, cg->server, sizeof(cg->servername));
323	}
324	else
325	{
326	cg->server[0] = '\0';
327	cg->servername[0] = '\0';
328	}
329	}
330
331
332	/*
333	* 'cupsSetUser()' - Set the default user name.
334	*
335	* Pass NULL to restore the default user name.
336	*/
337
338	void
339	cupsSetUser(const char user) / I - User name */
340	{
341	_cups_globals_t cg = _cupsGlobals(); / Pointer to library globals */
342
343
344	if (user)
345	strlcpy(cg->user, user, sizeof(cg->user));
346	else
347	cg->user[0] = '\0';
348	}
349
350
351	#if defined(WIN32)
352	/*
353	* WIN32 username and password stuff.
354	*/
355
356	/*
357	* 'cupsUser()' - Return the current user's name.
358	*/
359
360	const char * /* O - User name */
361	cupsUser(void)
362	{
363	_cups_globals_t cg = _cupsGlobals(); / Pointer to library globals */
364
365
366	if (!cg->user[0])
367	{
368	DWORD size; /* Size of string */
369
370
371	size = sizeof(cg->user);
372	if (!GetUserName(cg->user, &size))
373	{
374	/*
375	* Use the default username...
376	*/
377
378	strcpy(cg->user, "unknown");
379	}
380	}
381
382	return (cg->user);
383	}
384
385
386	/*
387	* '_cupsGetPassword()' - Get a password from the user.
388	*/
389
390	const char * /* O - Password */
391	_cupsGetPassword(const char prompt) / I - Prompt string */
392	{
393	return (NULL);
394	}
395	#else
396	/*
397	* UNIX username and password stuff...
398	*/
399
400	# include <pwd.h>
401
402	/*
403	* 'cupsUser()' - Return the current user's name.
404	*/
405
406	const char * /* O - User name */
407	cupsUser(void)
408	{
409	struct passwd pwd; / User/password entry */
410	_cups_globals_t cg = _cupsGlobals(); / Pointer to library globals */
411
412
413	if (!cg->user[0])
414	{
415	/*
416	* Rewind the password file...
417	*/
418
419	setpwent();
420
421	/*
422	* Lookup the password entry for the current user.
423	*/
424
425	if ((pwd = getpwuid(getuid())) == NULL)
426	strcpy(cg->user, "unknown"); /* Unknown user! */
427	else
428	{
429	/*
430	* Copy the username...
431	*/
432
433	setpwent();
434
435	strlcpy(cg->user, pwd->pw_name, sizeof(cg->user));
436	}
437
438	/*
439	* Rewind the password file again...
440	*/
441
442	setpwent();
443	}
444
445	return (cg->user);
446	}
447
448
449	/*
450	* '_cupsGetPassword()' - Get a password from the user.
451	*/
452
453	const char * /* O - Password */
454	_cupsGetPassword(const char prompt) / I - Prompt string */
455	{
456	return (getpass(prompt));
457	}
458	#endif /* WIN32 */
459
460
461	/*
462	* End of "$Id: usersys.c 4918 2006-01-12 05:14:40Z mike $".
463	*/