.\" -*-nroff-*-
.TH ushell 1 "20 April 1999" "Local tools"
.SH NAME
ushell \- display a user's shell
.SH SYNOPSIS
.B ushell
.I user
.SH USAGE
Writes the named user's default shell to standard output.  This is
useful in scripts sometimes.  In particular, it's handy in global
.B xdm/Xstartup
scripts for checking whether users have sensible shells:
.sp 1
.RS 5
.nf
.ft B
SHELL=`ushell $USER`
case $SHELL in
  */banned)
    xmessage -file $HOME/.banned
    exit 1
    ;;
  *)
    if ! grep -q "^$SHELL" /etc/shells; then
      xmessage "You're not allowed to log in this way."
      exit 1
    fi
    ;;
esac
.fi
.ft R
.SH BUGS
None planned.
.SH SEE ALSO
.BR banned (8),
.BR chrootsh (8).
.SH AUTHOR
Mark Wooding (mdw@nsict.org)