| 1545 | "pknotify v%(__version__)s (c) %(__years__)s %(__author__)s\n" |
| 1546 | "\n" |
| 1547 | "Notifie ou pose des questions aux utilisateurs finaux qui ont lanc� |
| 1548 | "l'application PyKotIcon.\n" |
| 1549 | "\n" |
| 1550 | "ligne de commande :\n" |
| 1551 | "\n" |
| 1552 | " pknotify [options] [arguments]\n" |
| 1553 | "\n" |
| 1554 | "options :\n" |
| 1555 | "\n" |
| 1556 | " -v | --version Prints pknotify's version number then exits.\n" |
| 1557 | " -h | --help Prints this message then exits.\n" |
| 1558 | " \n" |
| 1559 | " -d | --destination h[:p] Sets the destination hostname and optional\n" |
| 1560 | " port onto which contact the remote PyKotIcon\n" |
| 1561 | " application. This option is mandatory.\n" |
| 1562 | " When not specified, the port defaults to 7654.\n" |
| 1563 | " \n" |
| 1564 | " -a | --ask Tells pknotify to ask something to the end\n" |
| 1565 | " user. Then pknotify will output the result.\n" |
| 1566 | " \n" |
| 1567 | " -C | --checkauth When --ask is used and both an 'username' and " |
| 1568 | "a\n" |
| 1569 | " 'password' are asked to the end user, then\n" |
| 1570 | " pknotify will try to authenticate the user\n" |
| 1571 | " through PAM. If authentified, this program\n" |
| 1572 | " will print \"AUTH=YES\", else \"AUTH=NO\".\n" |
| 1573 | " If a field is missing, \"AUTH=IMPOSSIBLE\" " |
| 1574 | "will\n" |
| 1575 | " be printed. If the user is authenticated, then\n" |
| 1576 | " \"USERNAME=xxxx\" will be printed as well.\n" |
| 1577 | " \n" |
| 1578 | " -c | --confirm Tells pknotify to ask for either a " |
| 1579 | "confirmation \n" |
| 1580 | " or abortion.\n" |
| 1581 | " \n" |
| 1582 | " -D | --denyafter N With --checkauth above, makes pknotify " |
| 1583 | "loop \n" |
| 1584 | " up to N times if the password is incorrect.\n" |
| 1585 | " After having reached the limit, \"DENY\" will\n" |
| 1586 | " be printed, which effectively rejects the job.\n" |
| 1587 | " The default value of N is 1, meaning the job\n" |
| 1588 | " is denied after the first unsuccessful try.\n" |
| 1589 | " \n" |
| 1590 | " -n | --notify Tells pknotify to send an informational " |
| 1591 | "message\n" |
| 1592 | " message to the end user.\n" |
| 1593 | " \n" |
| 1594 | " -q | --quit Tells pknotify to send a message asking the\n" |
| 1595 | " PyKotIcon application to exit. This option can\n" |
| 1596 | " be combined with the other ones to make " |
| 1597 | "PyKotIcon\n" |
| 1598 | " exit after having sent the answer from the " |
| 1599 | "dialog.\n" |
| 1600 | " \n" |
| 1601 | " -t | --timeout T Tells pknotify to ignore the end user's answer " |
| 1602 | "if\n" |
| 1603 | " it comes pas T seconds after the dialog box " |
| 1604 | "being\n" |
| 1605 | " opened. The default value is 0 seconds, which \n" |
| 1606 | " tells pknotify to wait indefinitely.\n" |
| 1607 | " Use this option to avoid having an user who\n" |
| 1608 | " leaved his computer stall a whole print queue.\n" |
| 1609 | " \n" |
| 1610 | " You MUST specify either --ask, --confirm, --notify or --quit.\n" |
| 1611 | "\n" |
| 1612 | " arguments : \n" |
| 1613 | " \n" |
| 1614 | " -a | --ask : Several arguments are accepted, or the form\n" |
| 1615 | " \"label:varname:defaultvalue\". The result will\n" |
| 1616 | " be printed to stdout in the following format :\n" |
| 1617 | " VAR1NAME=VAR1VALUE\n" |
| 1618 | " VAR2NAME=VAR2VALUE\n" |
| 1619 | " ...\n" |
| 1620 | " If the dialog was cancelled, nothing will be\n" |
| 1621 | " printed. If one of the varname is 'password'\n" |
| 1622 | " then this field is asked as a password (you won't\n" |
| 1623 | " see what you type in), and is NOT printed. Although\n" |
| 1624 | " it is not printed, it will be used to check if\n" |
| 1625 | " authentication is valid if you specify --checkauth.\n" |
| 1626 | " \n" |
| 1627 | " -c | --confirm : A single argument is expected, representing the\n" |
| 1628 | " message to display. If the dialog is confirmed\n" |
| 1629 | " then pknotify will print OK, else CANCEL.\n" |
| 1630 | " \n" |
| 1631 | " -n | --notify : A single argument is expected, representing " |
| 1632 | "the \n" |
| 1633 | " message to display. In this case pknotify will\n" |
| 1634 | " always print OK.\n" |
| 1635 | " \n" |
| 1636 | "examples : \n" |
| 1637 | "\n" |
| 1638 | " pknotify -d client:7654 --confirm \"This job costs :\n" |
| 1639 | "10 credits !\"\n" |
| 1640 | " \n" |
| 1641 | " Would display the cost of a print job and asks for confirmation.\n" |
| 1642 | " \n" |
| 1643 | " pknotify --destination $PYKOTAJOBORIGINATINGHOSTNAME:7654 \\\n" |
| 1644 | " --checkauth --ask \"Your name:username:\" \"Your password:" |
| 1645 | "password:\"\n" |
| 1646 | " \n" |
| 1647 | " Asks an username and password, and checks if they are valid. \n" |
| 1648 | " NB : The PYKOTAJOBORIGINATINGHOSTNAME environment variable is\n" |
| 1649 | " only set if you launch pknotify from cupspykota through a directive\n" |
| 1650 | " in ~pykota/pykota.conf\n" |
| 1651 | " \n" |
| 1652 | " The TCP port you'll use must be reachable on the client from the\n" |
| 1653 | " print server.\n" |