| /*- |
| * Copyright 2009 Colin Percival |
| * All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions |
| * are met: |
| * 1. Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * 2. Redistributions in binary form must reproduce the above copyright |
| * notice, this list of conditions and the following disclaimer in the |
| * documentation and/or other materials provided with the distribution. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND |
| * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
| * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE |
| * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
| * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS |
| * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) |
| * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT |
| * 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 |
| * SUCH DAMAGE. |
| * |
| * This file was originally written by Colin Percival as part of the Tarsnap |
| * online backup system. |
| */ |
| #ifndef _READPASS_H_ |
| #define _READPASS_H_ |
| |
| /** |
| * tarsnap_getpass(passwd, prompt, confirmprompt, devtty) |
| * If ${devtty} is non-zero, read a password from /dev/tty if possible; if |
| * not, read from stdin. If reading from a tty (either /dev/tty or stdin), |
| * disable echo and prompt the user by printing ${prompt} to stderr. If |
| * ${confirmprompt} is non-NULL, read a second password (prompting if a |
| * terminal is being used) and repeat until the user enters the same password |
| * twice. Return the password as a malloced NUL-terminated string via |
| * ${passwd}. The obscure name is to avoid namespace collisions due to the |
| * getpass / readpass / readpassphrase / etc. functions in various libraries. |
| */ |
| int tarsnap_readpass(char **, const char *, const char *, int); |
| |
| #endif /* !_READPASS_H_ */ |
