.TH K3765-Z_UNLOCK "8" "September 2011" "SIM Unlocker"
.SH NAME
k3765-z_unlock \- unlocks SIM card on K3765-Z USB broadband modem
.SH SYNOPSIS
.B k3765-z_unlock
[\fI-force\fR]
.SH DESCRIPTION
.PP
This is a script to unlock the SIM card on a broadband (GPRS, UMTS)
modem contained in a USB device after connecting it. It is designed and
tested for the model "K3765-Z" (as distributed by Vodafone).
.PP
Arguments:
.TP
\fB\-force\fR
Perform or initiate operation independent on the result of previous runs.
.SS "Permanent Lock Prevention"
.PP
Care must be taken to not repeatedly send wrong PINs to the device,
because usually the SIM locks after the 3rd unsuccessful attempt, and
then requires a PUK to be usable again.
.PP
Therefore no operations will be done until the sequence is started
manually by a successful run using the \fB\-force\fR option, and are
kept until any error occurs, then switching to the inactive state again.
.SS "Exit status:"
.TP
0
if OK,
.TP
1
if the runtime directory is not present,
.TP
2
if the control file can not be deleted (override with option \fB\-force\fR),
.TP
3
if the last run was not successful or running the first time without
\fB\-force\fR
(this behaviour is intentional to prevent permanent lock of the SIM card),
.TP
4
if the expected character device is not present (usually means that the
adapter is not plugged in),
.TP
5
on error while sending the PIN to the device.
.SH FILES
.PP
Note: Paths may be different dependent on local installation.
.TP
/var/run/k3765-z_unlock/accepted
Controls whether more PINs should be attempted to be send to the modem
-- this is the case if present.
Then it contains information about whether a PIN was required on the
last run.
If not present either the command did never run, or an error occurred
the last time, preventing more attempts to avoid permanent lock.
.TP
/etc/udev/rules.d/51_vmc_zte_local.rules
Udev rules file.
.SH AUTHOR
Written by Gero Treuner (www.70t.de).
.SH COPYRIGHT
Copyright \(co 2011 Gero Treuner
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
.PP
The full documentation is in the README file.
\fBUDEV\fR(7), \fBchat\fR(8).