F b S r SSKJr SSKJr SSKJr SSKJr SSKrSSKrSSKrSSK r SSK
r
SSK r SSK r SSK
r
SSKJr SSKrSSKJr SS KJr SS
KJr SS KJr SS KJr SS
KJ r SSK J r SSK J r SSK J!r! SSK"J#r# SSK$J%r% SSK$J&r& SSK$J'r' Sr(S\(- S\'" 5 - - r) " S S\5 r*g)z5Implementation of update command for updating gsutil. )absolute_import)print_function)division)unicode_literalsN)input)Command) ApiSelector)CommandException)'CheckAndMaybePromptForAnalyticsEnabling)RegisterSignalHandler) system_util)GetConfigFilePaths) CERTIFICATE_VALIDATION_ENABLED)RELEASE_NOTES_URL)CompareVersions) DisallowUpdateIfDataInGsutilDir)LookUpGsutilVersion)GsutilPubTarballz!
gsutil update [-f] [-n] [url]
z
SYNOPSIS
a
DESCRIPTION
NOTE: This command is not available if you're using a gsutil installation
from a package manager or the Cloud SDK. When using the Cloud SDK, use
``gcloud components update``.
The gsutil update command downloads the latest gsutil release, checks its
version, and offers to let you update to it if it differs from the version
you're currently running.
Once you say "Y" to the prompt of whether to install the update, the gsutil
update command locates where the running copy of gsutil is installed,
unpacks the new version into an adjacent directory, moves the previous version
aside, moves the new version to where the previous version was installed,
and removes the moved-aside old version. Because of this, users are cautioned
not to store data in the gsutil directory, since that data will be lost
when you update gsutil. (Some users change directories into the gsutil
directory to run the command. We advise against doing that, for this reason.)
Note also that the gsutil update command will refuse to run if it finds user
data in the gsutil directory.
By default gsutil update will retrieve the new code from
%s, but you can optionally specify a URL to use
instead. This is primarily used for distributing pre-release versions of
the code to a small group of early test users.
NOTE: gsutil periodically checks whether a more recent software update is
available. By default this check is performed every 30 days; you can change
(or disable) this check by editing the software_update_check_period variable
in the .boto config file. Note also that gsutil will only check for software
updates if stdin, stdout, and stderr are all connected to a TTY, to avoid
interfering with cron jobs, streaming transfers, and other cases where gsutil
input or output are redirected from/to files or pipes. Software update
periodic checks are also disabled by the gsutil -q option (see
'gsutil help options')
OPTIONS
-f Forces the update command to offer to let you update, even if you
have the most current copy already. This can be useful if you have
a corrupted local copy.
-n Causes update command to run without prompting [Y/n] whether to
continue if an update is available.
c \ rS rSrSr\R " SS/\SSSSS S\R \R /\R S
9 r \R " SS/S S \
0 S
9rS r/ SQrS rS rS rS rSrg)
UpdateCommandf z(Implementation of gsutil update command.updaterefreshr fnTF)
command_name_aliasesusage_synopsismin_argsmax_argssupported_sub_args file_url_okprovider_url_okurls_start_arggs_api_supportgs_default_api command_helpz#Update to the latest gsutil release) help_namehelp_name_aliases help_typehelp_one_line_summary help_textsubcommand_help_textc
[ R ( d [ R ( a g[ R " 5 n[ R
" [ R 5 R U:X a g[ 5 nSR U5 nU R XU5 / nU H` n[ [
R " [ R
" U5 [
R 5 5 n UR SU < SU< 35 Mb [! SR [" R$ " S5 5 SU< SU< SU R& < S SR U5 < 3- S
S 9e) a Explains what to do if sudo needed to update gsutil software.
Happens if gsutil was previously installed by a different user (typically if
someone originally installed in a shared file system location, using sudo).
Args:
tf: Opened TarFile.
dirs_to_remove: List of directories to remove.
old_cwd: Path to the working directory we should chdir back to if sudo is
needed. It's possible that we've chdir'd to a temp directory that's
been deleted, which can cause odd behavior (e.g. OSErrors when opening
the metrics subprocess). If this is not truthy, we won't attempt to
chdir back to this value.
Raises:
CommandException: if errors encountered.
N z
sudo chmod
a Since it was installed by a different user previously, you will need to update using the following commands. You will be prompted for your password, and the install will run as "root". If you're unsure what this means please ask your system administrator for help:z
sudo chmod 0644 z
sudo env BOTO_CONFIG="z" z updateT
informational)r
IS_CYGWIN
IS_WINDOWSosgetuidstatgslib
GSUTIL_DIRst_uidr join_CleanUpUpdateCommandoctS_IMODEST_MODEappendr
textwrapwrap gsutil_path)
selftfdirs_to_removeold_cwduser_idconfig_file_list config_files
chmod_cmds config_filemodes
(platform/gsutil/gslib/commands/update.py_ExplainIfSudoNeeded"UpdateCommand._ExplainIfSudoNeeded s & 6 6 iikG wwu ''72 *+88 ,-L r7;
J'
rww{ 3DLL AC
Dd$ DE ( 499
H I J &|T5E5E *-M/ / *. / / )) applicationsautobinbootdesktopdevzdocuments and settingsetcexporthomekernelliblib32libraryz
lost+found mach_kernelmediamntnetnullnetworkoptprivateprocz
program filespythonrootsbinscriptssrvsyssystemtmpusersusrvarvolumeswinwin32windowswinntc U HU nU( d SnUR [ R 5 R 5 U R ; d MI [ SU- 5 e g)a Raises Exception if any of dirs is known to be unsafe for gsutil update.
This provides a fail-safe check to ensure we don't try to overwrite
or delete any important directories. (That shouldn't happen given the
way we construct tmp dirs, etc., but since the gsutil update cleanup
uses shutil.rmtree() it's prudent to add extra checks.)
Args:
dirs: List of directories to check.
Raises:
CommandException: If unsafe directory encountered.
rb zKEnsureDirsSafeForUpdate: encountered unsafe directory (%s); aborting updateN)lstripr4 seplowerunsafe_update_dirsr
)rC dirsds rM _EnsureDirsSafeForUpdate&UpdateCommand._EnsureDirsSafeForUpdate sX
"&& !T%<%< < ACD E F F rP c @ U( a UR 5 U R U5 U H n [ R " U5 M U( a [ R " U5 gg! [ a [
R ( d e Ma f = f! [ a gf = f)a Cleans up temp files etc. from running update command.
Args:
tf: Opened TarFile, or None if none currently open.
dirs_to_remove: List of directories to remove.
old_cwd: Path to the working directory we should chdir back to. It's
possible that we've chdir'd to a temp directory that's been deleted,
which can cause odd behavior (e.g. OSErrors when opening the metrics
subprocess). If this is not truthy, we won't attempt to chdir back
to this value.
N) closer~ shutilrmtreeOSErrorr
r3 r4 chdir)rC rD rE rF directorys rM r; #UpdateCommand._CleanUpUpdateCommand s
hhj!!.1#
i $
%%
&
s# A)B ) B
B
B B c
6 [ R ( a [ S5 e[ R " 5 ( a [ S5 e[
nU( d [ S5 e[
5 SnSnU R ( a' U R H u pEUS:X a SnUS:X d M SnM / n[ R " 5 nUR U5 [ R " 5 n[ R " U5 U( d U R R S5 U R ( a U R S n U R# S
5 ( d [ S 5 e[% U R' U 5 5 H u pU
S : a [ S 5 eU R( n U R+ 5 ( a) U R- 5 ( d U( d [ S
5 eM` U R/ 5 ( a U R1 5 ( a M [ S5 e O
[3 5 n [5 U R6 U 5 n
U
( a SnOrU R9 U 5 nUR; 5 [= [ R> RA SS5 S5 nURC 5 RE 5 n
SSS5 U( dN [ RF U
:X a: U RI XU5 U R ( a
[ SU - SS9e[ SSS9eU( d [K 5 [M U
[ RF 5 u nnU( aN [O SRA [P RR " SU
< S[ RT < S[V < S35 5 5 O![O SU
< S[ RT < 35 U RY XU5 U( a S nO [[ S 5 nU( a UR] 5 S S :w a U RI XU5 [ S SS9eU( d U R9 U 5 n[_ [` Rb [` Rd 5 [ R> Rg [ R> RA [ RT S 5 5 n[ R " US 9n[ R " US 9nUR U5 UR U5 U Ri U5 UR; US!9 [ Rl ( Gdk [ Rn " U5 GH u nnnU H n[ R< " [ R> RA UU5 [ Rp 5 n[ Rr " U[t Rv [t Rx - [t Rz - [t R| - 5 [ R~ " U5 M U H n [ R< " [ R> RA UU 5 [ Rp 5 n[ Rr " U[t R [t R - [t R - [t Rz - [t R| - 5 [ R~ " U5 M GM [ R< " [ R> RA USS5 [ Rp 5 n[ Rr " U[t R [t Rz - [t R - [t R| - [t R - 5 [ R~ " U5 [ R " [ RT [ R> RA US#5 5 [ R " [ R> RA US5 [ RT 5 U RI XU5 [_ [` Rb [` R 5 U R R S$5 g ! , ( d f GN= f! [j a% nU RI XU5 [ S"U- 5 eSnAff = f)%z+Command entry point for the update command.zThe update command is only available for gsutil installed from a tarball. If you installed gsutil via another method, use the same method to update it.aP The update command is disabled for Cloud SDK installs. Please run "gcloud components update" to update it. Note: the Cloud SDK incorporates updates to the underlying tools approximately every 2 weeks, so if you are attempting to update to a recently created release / pre-release of gsutil it may not yet be available via the Cloud SDK.zYour boto configuration has https_validate_certificates = False.
The update command cannot be run this way, for security reasons.Fz-fTz-nz Checking for software update...r z.tar.gzz0The update command only works with tar.gz files.z4Invalid update URL. Must name a single .tar.gz file.zG"update" command does not support "file://" URLs without the -f option.z;Invalid update object URL. Must name a single .tar.gz file.NgsutilVERSIONrz You already have %s installed.r0 z5You already have the latest gsutil release installed.r/ z!This command will update to the "z" version of gsutil at zl. NOTE: This a major new version, so it is strongly recommended that you review the release note details at zJ before updating to this version, especially if you use gsutil in scripts.z" version of
gsutil at yzProceed? [y/N] zNot running update.z..)dir)pathzUpdate failed: %s.oldzUpdate complete.)Er7 IS_PACKAGE_INSTALLr
r
InvokedViaCloudSdkr r sub_optstempfilemkdtempr? r4 getcwdr loggerinfoargsendswith enumerateWildcardIterator storage_url IsFileUrl IsDirectory
IsCloudUrlIsObjectr r
gsutil_api_FetchAndOpenGsutilTarball
extractallopenr r: readstripr r; r r printr@ rA r8 r rN r rz r signalSIGINTSIG_IGNnormpathr~ Exceptionr3 walkO_RDONLYfchmodr6 S_IWRITES_IRUSRS_IRGRPS_IROTHr S_IRWXUS_IXGRPS_IXOTHrenameSIG_DFL) rC https_validate_certificates force_update no_promptounused_arE tmp_dirrF update_from_url_striresultr tarball_versionrD ver_file_majoranswergsutil_bin_parent_dirold_dirnew_diredirnamesubdirs filenamesfilenamefdsubdirs rM
RunCommandUpdateCommand.RunCommand s]
!
" "
%%''
#A & M
N N $%LI }} +! 9 , 9) ' N G'"iikGHHW
kk89 yy IIaL
)
))
4
4 >@ @ !6!67J!KL)! q5 DF F (( " ";+B+B+D+D "
((**{/C/C/E/E KM M M - . *$//;NOO b * *+> ?bmmo Xy13 78"--///1 8 EMM_ <
W=
? 2 3-13 3
-/"?EMMBjq%
tyy MM
!%"2"24E G
HI K !1!13 5 b':f&'f V\\^A&#-
W= 2$ GG
* *+> ?b &-- 8 GG , ,
U%%t, . #89G #89G'"'"!!.17mmm! ! ! ! *,)9
%'7I!Hwwrww||GX6 D"
))BMMDLL04<<?$,,N P
((2, "
Fwwrww||GV4bkkB"
))$,, - n
` rP r )+r
__future__r r r r r4 r r r6 rl r r r@ six.movesr r7
gslib.commandr gslib.cs_api_mapr gslib.exceptionr
gslib.metricsr gslib.sig_handlingr gslib.utilsr
gslib.utils.boto_utilr r gslib.utils.constantsr gslib.utils.text_utilr gslib.utils.update_utilr r r r r r r rP rM r s < & % '
! ( , A 4 # 4 @ 3 1 C 7 4
.\ ].0 fkG krP