Respect table prefix in sql-hash
[project/drush_extras.git] / README.txt
1
2 Drush extras
3 ------------
4 Drush extras is a place where auxiliary drush commands may be found. 
5 Typically, these "extra" commands are not be suitable for drush core 
6 due to limitations; for example, some may only support certain platforms, 
7 and others might require customization before use.
8
9 Drush extras welcomes contributions.
10
11
12 Installation Instructions
13 -------------------------
14 Use with drush-4.x or later.
15
16     $ drush dl drush_extras
17
18 This will download drush_extras and place it in your $HOME/.drush
19 folder.  You may also download the release manually from:
20
21     http://drupal.org/project/drush_extras
22
23 You may place drush_extras wherever you want, but if it is not
24 in a standard location for drush commands, you will need to add
25 it to your drush include file search path.  See examples/example.drushrc.php
26 in the drush project for more information.
27
28
29 Drush extras commands
30 ---------------------
31 Here is a brief overview of the commands available in drush_extras.
32 Please see the help text for more information.
33
34     drush pushkey user@host.domain.com
35
36         Creates an ssh public/private key pair in $HOME/.ssh, if
37         one does not already exist, and then pushes the public
38         key to the specified remote account.  The password for the
39         destination account must be entered once to push the
40         key over; after the key has been stored on the remote
41         system, subsequent ssh and remote drush commands may be
42         executed using the public/private key pair for authentication.
43         
44         IN DRUSH EXTRAS because is is Linux / openssl-specific.
45         
46
47     drush grep '#regex#' --content-types=node
48
49         Grep through a site's content using PCREs.
50
51         IN DRUSH EXTRAS because it is only applicable to small sites
52         (greping through enormous databases is impractically slow).
53
54
55     drush block-configure --module=block --delta=0 --region=right --wieght=10
56     drush block-disable --module=block --delta=0
57     drush block-show
58
59         Configure, disable or show settings for particular blocks.
60         
61         IN DRUSH EXTRAS because only Drupal 6 is supported.
62
63
64     drush give-node 27 bob
65     drush give-comment 7 bob
66
67         Change the ownership of a node or a comment.
68         
69         IN DRUSH EXTRAS because contributor deemed it to niche for drush core.
70
71
72     drush sql-hash
73     drush sql-compare @site1 @site2
74     
75         Output hash values for each table in the database, or compare two
76         Drupal sites to determine which tables have different content.  Run 
77         before and after an operation on a Drupal site to track table usage.
78
79         IN DRUSH EXTRAS because table usage often overlaps between different
80         operations (e.g. variables table).