OLD | NEW |
1 # -*- coding: utf-8 -*- | 1 # -*- coding: utf-8 -*- |
2 # Copyright 2012 Google Inc. All Rights Reserved. | 2 # Copyright 2012 Google Inc. All Rights Reserved. |
3 # | 3 # |
4 # Licensed under the Apache License, Version 2.0 (the "License"); | 4 # Licensed under the Apache License, Version 2.0 (the "License"); |
5 # you may not use this file except in compliance with the License. | 5 # you may not use this file except in compliance with the License. |
6 # You may obtain a copy of the License at | 6 # You may obtain a copy of the License at |
7 # | 7 # |
8 # http://www.apache.org/licenses/LICENSE-2.0 | 8 # http://www.apache.org/licenses/LICENSE-2.0 |
9 # | 9 # |
10 # Unless required by applicable law or agreed to in writing, software | 10 # Unless required by applicable law or agreed to in writing, software |
(...skipping 88 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
99 before the entire transfer is complete (e.g. failing after 300 of | 99 before the entire transfer is complete (e.g. failing after 300 of |
100 1000 files have been transferred), you will need to restart the | 100 1000 files have been transferred), you will need to restart the |
101 entire transfer. | 101 entire transfer. |
102 | 102 |
103 Also, although most commands will normally fail upon encountering | 103 Also, although most commands will normally fail upon encountering |
104 an error when the -m flag is disabled, all commands will | 104 an error when the -m flag is disabled, all commands will |
105 continue to try all operations when -m is enabled with multiple | 105 continue to try all operations when -m is enabled with multiple |
106 threads or processes, and the number of failed operations (if any) | 106 threads or processes, and the number of failed operations (if any) |
107 will be reported at the end of the command's execution. | 107 will be reported at the end of the command's execution. |
108 | 108 |
109 WARNING: If you use the gsutil -m option when copying data | |
110 between versioned buckets, object version ordering will not be | |
111 preserved. For more information see the | |
112 "COPYING VERSIONED BUCKETS" section under | |
113 'gsutil help versions'. | |
114 | |
115 -o Set/override values in the boto configuration value, in the format | 109 -o Set/override values in the boto configuration value, in the format |
116 <section>:<name>=<value>, e.g. gsutil -o "Boto:proxy=host" ... | 110 <section>:<name>=<value>, e.g. gsutil -o "Boto:proxy=host" ... |
117 This will not pass the option to gsutil integration tests, which | 111 This will not pass the option to gsutil integration tests, which |
118 run in a separate process. | 112 run in a separate process. |
119 | 113 |
120 -q Causes gsutil to perform operations quietly, i.e., without | 114 -q Causes gsutil to perform operations quietly, i.e., without |
121 reporting progress indicators of files being copied or removed, | 115 reporting progress indicators of files being copied or removed, |
122 etc. Errors are still reported. This option can be useful for | 116 etc. Errors are still reported. This option can be useful for |
123 running gsutil from a cron job that logs its output to a file, for | 117 running gsutil from a cron job that logs its output to a file, for |
124 which the only information desired in the log is failures. | 118 which the only information desired in the log is failures. |
125 """) | 119 """) |
126 | 120 |
127 | 121 |
128 class CommandOptions(HelpProvider): | 122 class CommandOptions(HelpProvider): |
129 """Additional help about gsutil command-level options.""" | 123 """Additional help about gsutil command-level options.""" |
130 | 124 |
131 # Help specification. See help_provider.py for documentation. | 125 # Help specification. See help_provider.py for documentation. |
132 help_spec = HelpProvider.HelpSpec( | 126 help_spec = HelpProvider.HelpSpec( |
133 help_name='options', | 127 help_name='options', |
134 help_name_aliases=['arg', 'args', 'cli', 'opt', 'opts'], | 128 help_name_aliases=['arg', 'args', 'cli', 'opt', 'opts'], |
135 help_type='additional_help', | 129 help_type='additional_help', |
136 help_one_line_summary='Top-Level Command-Line Options', | 130 help_one_line_summary='Top-Level Command-Line Options', |
137 help_text=_DETAILED_HELP_TEXT, | 131 help_text=_DETAILED_HELP_TEXT, |
138 subcommand_help_text={}, | 132 subcommand_help_text={}, |
139 ) | 133 ) |
OLD | NEW |