Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
USERNEU(1)	      User Contributed Perl Documentation	    USERNEU(1)

NAME
       userneu/userquick - A perl script to automatically create user accounts

SYNOPSIS
       userneu [ -cdhrsy ] [ -i	input file ] [ -g [primary group] ]
       [ -b [base directory for	$HOME] ] [ -S [smbpasswd binary] ] [ -o	[Out-
       put file] ] [ -m	[minimum password length] ] [ -x [maximum pass-
       word length] ] [	 -D [descriptors] ] [ -f [configuration	file] ]
       [ -G [member groups] ] [	-t [delimiter] ] [ [ -T	[target	system]	]
       [ -O [shellscript output] ]

       userquick [ -cdhrsy ] [ -u user information of single user ] [ -g pri-
       mary group ] [ -b [base directory for $HOME] ] [	-S [smbpasswd bi-
       nary] ] [ -o [Output file] ] [ -m [minimum password length] ]
       [ -x [maximum password length] ]	[  -D [descriptors] ] [	-f [configura-
       tion file] ] [ -G [member groups] ] [ [ -T [target system] ]
       [ -O [shellscript output] ]

DESCRIPTION
       userneu can either be invoked as	'userquick' or as 'userneu'. If	it is
       called as 'userneu' it processes	a list of usernames and	other informa-
       tion and	creates	user accounts based on that. If	it is called as
       'userquick' it creates one single account based on information given on
       the command line. The possible command line options are:

       -c   Create a shell script that does the	account	creation work on sys-
	    tems on systems that don't come with a Perl	distribution.

       -d   Enable the "dupe engine" which tries to "bruteforce" a username
	    that doesn't exist yet by appending	one or two random characters
	    to already existing	usernames it encounters. This is disabled by
	    default.

       -h   Display usage information.

       -r   Create strong passwords which means	completely random strings of
	    misc case letters, special characters and numbers with a length of
	    10 characters (if no different length is specified using the -m
	    and	-x switches). By default this is disabled and the script cre-
	    ates passwords that	are only composed of random lowercase letters
	    with a length of 8 characters.

       -s   Create Samba accounts in addition to traditional unix accounts. By
	    default this is disabled.

       -y   Append the "school year" to	the GECOS field	which is the period
	    between some day in	September and some day in July and is there-
	    fore composed of two calender years. I only	included this because
	    I originally wrote this script for creating	user accounts on my
	    school's network. If you need this option you probably know	what
	    I'm	talking	about, if not you can safely ignore this as it is dis-
	    abled by default anyway.

       -i [input file]
	    This option	is only	relevant if the	script is called as userneu.
	    It takes the location of the input file from which to read the
	    user information as	argument. Use "-" for STDIN.

       -g [primary group]
	    Specify the	primary	group for the users to be created, defaults to
	    'users'. If	this is	a percent sign followed	by a number (and the
	    script is called as	userneu) the script reads the primary group
	    information	from the field in the input file denoted by that num-
	    ber, e.g. a	value of '%4' causes the script	to use the value in
	    the	4th field of the input vile as primary group.  This is useful
	    if you don't want to specify the primary group globally for	all
	    new	users but individually for each	user.

       -G [member group1,member	group2,...]
	    Specify a comma separated list of member groups for	the users to
	    be created.	If this	is a percent sign followed by a	number (and
	    the	script is called as userneu) the script	reads the member group
	    information	from the field in the input file denoted by that num-
	    ber, e.g. a	value of '%4' causes the script	to use a comma-sepa-
	    rated list of groups in the	4th field of the input file as member
	    groups.  This is useful if you don't want to specify the primary
	    group globally for all new users but individually for each user.

       -B [directory]
	    Specify the	directory where	the home directories of	the created
	    users will be placed. Defaults to "/home/$group" where $group is
	    the	primary	group of the users.

       -S [location of smbpasswd(8)]
	    Specify the	location of smbpasswd(8). Defaults to "/usr/lo-
	    cal/bin/smbpasswd".	This implies -s.

       -o [output file]
	    Specify the	location of the	output file in which account informa-
	    tion is stored. Defaults to	'useraccounts' CAUTION:	This file con-
	    tains cleartext passwords and should be well protected. Although
	    the	script changes it's mode to 0600 it is no good idea to keep it
	    arround longer than	needed.	This option is only relevant if	the
	    script is called as	'userneu', if it is called as 'userquick' it
	    will just print that information on	the screen. Use	"-" for	STD-
	    OUT.

       -m [minimum password length]
	    Specify the	minimum	password length. This overrides	the default
	    value of 8 characters (no -r option	given) or 10 characters	(-r
	    option given).

       -x [maximum passsword length]
	    Specify the	maximum	password length. This overrides	the default
	    value of 8 characters (no -r option	given) or 10 characters	(-r
	    option given).

       -D [descriptor1;descriptor2;...]
	    Specify a semicolon	separated list of descriptors for the fields
	    in the input. The length of	this list has to match the actual
	    fields being present. This is relevant to either the input file of
	    'userneu' or the -u	option of 'userquick'.

       -f [configuration file
	    Specify the	location of the	configuration file. Defaults to
	    /etc/userneu.conf.

       -t [delimiter]
	    Specify the	delimiter for the fields in the	input file as perl
	    regular expression (slash delimited). The default is "/\t/", which
	    means the fields are separated by tabs. This is only relevant if
	    the	script is called as 'userneu'.

       -T [Target System]
	    Specify the	target system for which	to generate a shell script for
	    adding users. Implies -c. If -c is given but not -T	this defaults
	    to the OS the script is run	on.

       -O [shellscript output]
	    Specify the	location of the	shell script for creating users. Im-
	    plies -c.  If -c is	given but not -O this defaults to "crea-
	    teusers.sh". Use "-" for STDOUT.

FILES
	/etc/userneu.conf	       Configuration file of userneu/userquick

SEE ALSO
       userneu.conf(5)

AUTHOR
	Johannes Grassler <johannes.grassler@freenet.de>

perl v5.8.0			  2003-10-15			    USERNEU(1)

NAME | SYNOPSIS | DESCRIPTION | FILES | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=userneu&sektion=8&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help