sup - En ligne dans le Cloud

PROGRAMME:

Nom

sup - protocole de mise à niveau du logiciel

SYNOPSIS

souper [ drapeaux ] [ supfile ] [ collection ...]

DESCRIPTION

Souper est un programme utilisé pour mettre à niveau des collections de fichiers d'autres machines vers votre
machine. vous exécutez souper, client programme, qui parle sur le réseau en utilisant IP/TCP
à filet serveur traiter. Le processus du serveur de fichiers coopère avec souper pour déterminer lequel
les fichiers de la collection doivent être mis à jour sur votre machine.

Les collections Sup peuvent avoir plusieurs versions. L'une des utilisations de ces versions est de fournir
différentes versions des mêmes fichiers. Chez CMU, par exemple, les binaires système ont alpha,
bêta et version par défaut correspondant aux différents niveaux de mise en scène du logiciel. Nous
utilisez également les noms de version par défaut et minimal pour fournir des versions complètes ou un sous-ensemble
libère. Dans ces deux cas, il n'est logique de suppléer qu'une seule version du
collectes. Les versions ont également été utilisées dans des sups privés ou externes pour fournir des sous-ensembles
de collections où il est logique de récupérer plusieurs des versions. Par exemple le
Les sources du noyau Mach 3.0 ont une version par défaut des sources indépendantes de la machine et des
versions de sources dépendantes de la machine pour chaque plate-forme prise en charge.

En effectuant une mise à niveau, le serveur de fichiers construit une liste de fichiers inclus dans le
version spécifiée de la collection. La liste est envoyée à votre machine, qui détermine
quels fichiers sont nécessaires. Ces fichiers sont ensuite envoyés depuis le serveur de fichiers. Ce sera le plus
utile pour courir souper en tant que démon chaque nuit afin que vous ayez continuellement la dernière version
des fichiers dans les collections nécessaires.

Le seul argument requis pour souper est le nom d'un fichier supfile. Il doit soit être donné
explicitement sur la ligne de commande, ou le -s indicateur doit être spécifié. Si la -s le drapeau est
donné, le supfile système sera utilisé et un argument de commande supfile ne doit pas être
spécifié. La liste des collections est facultative et si elle est spécifiée, elle sera la seule
collections améliorées. Les indicateurs suivants affectent toutes les collections spécifiées :

-s Comme décrit ci-dessus.

-t Lorsque ce drapeau est donné, souper imprimera l'heure de la dernière collecte
mis à niveau, plutôt que d'effectuer des mises à niveau réelles.

-u Lorsque ce drapeau est donné, souper n'essaiera pas de restaurer l'accès de l'utilisateur et modifié
fois des fichiers dans les collections du serveur.

-S Opérez silencieusement en imprimant des messages uniquement en cas d'erreur.

-N Souper tracera les messages réseau envoyés et reçus qui implémentent le souper réseau
protocole.

-P Sup utilisera un ensemble de ports réseau non privilégiés réservés à des fins de débogage.

Les indicateurs restants affectent toutes les collections à moins qu'une liste explicite de collections ne soit
donné avec les drapeaux. Plusieurs drapeaux peuvent être spécifiés ensemble qui affectent le même
collectes. Par souci de commodité, tous les indicateurs qui affectent toujours toutes les collections
peut être spécifié avec des indicateurs qui n'affectent que certaines collections. Par exemple, souper
-sde=coll1,coll2 effectuerait une mise à niveau du système, et les deux premières collectes permettraient
les suppressions de fichiers et les exécutions de commandes. Notez qu'il ne s'agit pas de la même commande que souper
-sde=coll1 coll2, qui effectuerait une mise à niveau du système de la seule collection coll2 et
ignorerait les indicateurs donnés pour la collection coll1.

-a Tous les fichiers de la collection seront copiés à partir du référentiel, quelle que soit leur
état sur la machine actuelle. De ce fait, c'est une opération très coûteuse
et ne devrait être fait que pour les petites collections si une corruption des données est suspectée et
été confirmée. Dans la plupart des cas, le -o le drapeau devrait suffire.

-b Si la -b drapeau s'il est donné, ou le sauvegarde l'option supfile est spécifiée, le contenu de
les fichiers normaux sur le système local seront enregistrés avant d'être écrasés par
nouvelles données. Le responsable de la collection de fichiers peut désigner des fichiers spécifiques dignes d'intérêt
de sauvegarder chaque fois qu'ils sont mis à niveau. Cependant, une telle sauvegarde ne prendra que
place si vous spécifiez ce drapeau ou le sauvegarde option pour autoriser les sauvegardes pour un fichier
collecte sur votre machine. Le mécanisme de sauvegarde créera une copie du
version d'un fichier immédiatement avant qu'une nouvelle copie ne soit reçue du serveur de fichiers ;
la copie porte le même nom que le fichier d'origine mais est placée dans un répertoire
appelé SAUVEGARDE dans le répertoire contenant le fichier d'origine. Par exemple,
/usr/sas/src/foo.c aurait une copie de sauvegarde appelée /usr/sas/src/BACKUP/foo.c.
Il n'y a aucune disposition pour maintenir automatiquement plusieurs anciennes versions de fichiers ;
vous devriez le faire vous-même.

-B La -B l'indicateur remplace et désactive le -b drapeau et le sauvegarde option supfile.

-d Les fichiers qui ne sont plus dans la collection sur le référentiel seront supprimés si
présent sur la machine locale et y ont été mis par un sup précédent. Cela peut aussi
être spécifié dans un fichier supfile avec le effacer option.

-D La -D l'indicateur remplace et désactive le -d drapeau et le effacer option supfile.

-e Sup exécutera les commandes envoyées depuis le référentiel qui doivent être exécutées lorsqu'un fichier
est mis à niveau. Si la -e flag est omis, Sup imprimera un message qui spécifie
la commande à exécuter. Cela peut également être spécifié dans un fichier supfile avec le exécuter
option.

-E La -E l'indicateur remplace et désactive le -e drapeau et le exécuter option supfile.

-f A liste uniquement la mise à niveau sera effectuée. Des messages seront imprimés indiquant ce que
se produirait si une mise à niveau réelle était effectuée.

-k Souper vérifiera les heures de modification des fichiers sur le disque local avant la mise à jour
eux. Seuls les fichiers plus récents sur le référentiel que sur le disque local seront
mis à jour; les fichiers les plus récents sur le disque local seront conservés tels quels. Ceci peut
également être spécifié dans un fichier supfile avec le garder option.

-K La -K l'indicateur remplace et désactive le -k drapeau et le garder option supfile.

-l Normalement, souper ne mettra pas à niveau une collection si le référentiel est sur le même
machine. Cela permet aux utilisateurs d'exécuter des mises à niveau sur toutes les machines sans avoir à faire
vérifications spéciales pour la machine du référentiel. Si la -l indicateur est spécifié,
les collections seront mises à niveau même si le référentiel est local.

-m Normalement, souper sortie standard utilisée pour les messages. Si la -m drapeau si donné, souper sera
envoyer un courrier à l'utilisateur en cours d'exécution souper, ou un utilisateur spécifié avec le notifier supfile
option, qui contient les messages imprimés par souper.

-M
comme -m mais envoyer un courrier à l'utilisateur spécifié.

-o Souper mettra normalement à niveau uniquement les fichiers qui ont changé sur le référentiel depuis le
la dernière fois qu'une mise à niveau a été effectuée. Autrement dit, si le fichier dans le référentiel est plus récent
que la date stockée dans le quand dossier sur le client. Les -o drapeau, ou le et les sites anciens
option supfile, provoquera souper pour vérifier tous les fichiers de la collection pour les changements
au lieu de juste les nouveaux.

-O La -O l'indicateur remplace et désactive le -o drapeau et le et les sites anciens option supfile.

-z Normalement sup transfère les fichiers directement sans aucun autre traitement, mais avec le -z
drapeau, ou le compresser option supfile, sup compressera le fichier avant de l'envoyer
à travers le réseau et décompressez-le et restaurez tous les attributs de fichier corrects à
l'extrémité réceptrice.

-Z La -Z l'indicateur remplace et désactive le -z drapeau et le compresser option supfile.

-v Normalement, souper n'imprimera les messages qu'en cas de problème. Ce drapeau provoque souper
pour imprimer également des messages pendant la progression normale montrant ce que souper fait.

RÉGLAGE UP MISES À JOUR

Chaque collection de fichiers à mettre à niveau doit avoir un base annuaire qui contient un
sous-répertoire appelé souper qui sera utilisé par le souper programme; il sera créé
automatiquement si vous ne le créez pas. Souper mettra des sous-répertoires et des fichiers dans ce
répertoire au besoin.

Souper recherchera un sous-répertoire portant le même nom que la collection dans le souper
sous-répertoire du base répertoire. S'il existe, il peut contenir l'un des éléments suivants
fichiers:

lorsque.
Ce fichier est mis à jour automatiquement par souper lorsqu'une collecte est réussie
mis à jour et contient l'heure à laquelle le serveur de fichiers, ou éventuellement scruter, créé
la liste des fichiers dans la liste de mise à niveau. Souper enverra cette fois au serveur de fichiers
pour générer la liste des fichiers qui ont été modifiés sur la machine du référentiel.

refuser Ce fichier contient une liste de fichiers et de répertoires, un par ligne, que le client
n'est pas intéressé par cela ne devrait pas être mis à niveau.

bloquer Ce fichier est utilisé par souper pour verrouiller une collection pendant sa mise à niveau. Souper sera
obtenir un accès exclusif au fichier de verrouillage en utilisant troupeau(2), empêchant plus d'un souper
de mettre à jour la même collection en même temps.

dernier.
Ce fichier contient une liste de fichiers et de répertoires, un par ligne, qui ont été
amélioré par souper autrefois. Ces informations sont utilisées lorsque le effacer option, ou
le -d flag est utilisé pour localiser les fichiers précédemment mis à niveau qui ne sont plus dans le
collection qui doit être supprimée.

Chaque collection de fichiers doit également être décrite dans un ou plusieurs supfiles. Lorsque souper is
exécuté, il lit le supfile spécifié pour déterminer les collections et les versions de fichiers
mettre à niveau. Chaque ensemble de version de collection est décrit par une seule ligne de texte dans le
supfile; cette ligne doit contenir le nom de la collection, et éventuellement un ou plusieurs
options séparées par des espaces. Les options sont :

libération=nom de la version
Si une collection contient plusieurs versions, vous devez spécifier quelle version vous
vouloir. Vous ne pouvez spécifier qu'une seule version par ligne, donc si vous voulez plusieurs versions
des mêmes collections, vous devrez spécifier la collection plus d'une fois.
Dans ce cas, vous devez utiliser le utiliser-rel-suffixe option dans le fichier supfile pour garder le
dernier et quand les fichiers des deux versions se séparent.

fond=annuaire
Le nom par défaut habituel du répertoire de base d'une collection est décrit ci-dessous
(voir FICHIERS) ; si vous souhaitez spécifier un autre nom de répertoire, utilisez cette option
en précisant le répertoire souhaité.

préfixe=annuaire
Chaque collection peut également avoir un préfixe annuaire qui est utilisé à la place
du répertoire de base pour spécifier dans quel répertoire les fichiers de la collection seront
être placé.

hôte =nom d'hôte
base d'hôte=annuaire
Système les collections sont prises en charge par les mainteneurs du système, et souper sera
trouver automatiquement le nom de la machine hôte et le répertoire de base sur celui-ci
machine. Cependant, vous pouvez également mettre à niveau Privé collectes ; vous précisez simplement
avec ces options le nom d'hôte de la machine contenant les fichiers et les
annuaire utilisé comme répertoire de base pour le serveur de fichiers sur cette machine. Les détails de
la configuration d'une collection de fichiers est donnée dans la section ci-dessous.

connexion=identifiant de compte
password =Mot de passe
crypte=clé
Les fichiers sur le serveur de fichiers peuvent être protégés et les transmissions réseau peuvent être
crypté. Cela empêche l'accès non autorisé aux fichiers via souper. Lorsque les fichiers ne sont pas
accessible au compte par défaut (par exemple le anon compte anonyme), vous pouvez
spécifier une alternative identifiant de compte et Mot de passe pour le serveur de fichiers à utiliser sur le
hôte du référentiel. La transmission réseau du mot de passe sera toujours cryptée.
Vous pouvez également faire crypter les données du fichier réel en spécifiant un clé; le fichier
collection sur le référentiel doit spécifier la même clé sinon souper ne sera pas capable
pour mettre à niveau les fichiers de cette collection. Dans ce cas, le compte par défaut utilisé par
le serveur de fichiers sur la machine du référentiel sera le propriétaire de la clé de cryptage
(voir FICHIERS) plutôt que le anon compte anonyme.

notifier=propos
Si vous utilisez le -m option pour recevoir les messages de journal par courrier, vous pouvez avoir le courrier
envoyé à un utilisateur différent, éventuellement sur un autre hôte, que l'utilisateur exécutant le sup
programme. Les messages seront envoyés au destinataire spécifié propos, ce qui peut être tout légal
adresse netmail. En particulier, un mainteneur de projet peut être désigné pour recevoir
courrier pour la collection de fichiers de ce projet de tous les utilisateurs en cours d'exécution souper pour améliorer cela
collecte.

sauvegarde Comme décrit ci-dessus sous le -b drapeau.

effacer Comme décrit ci-dessus sous le -d drapeau.

exécuter
Comme décrit ci-dessus sous le -e drapeau.

garder Comme décrit ci-dessus sous le -k drapeau.

et les sites anciens Comme décrit ci-dessus sous le -o drapeau.

utiliser-rel-suffixe
Le nom de la version est utilisé comme suffixe pour le dernier et quand des dossiers. C'est
nécessaire chaque fois que vous consommez plus d'une version dans la même collection.

EN TRAIN DE PRÉPARER A DOSSIER COLLECTION DÉPÔT

Un ensemble de fichiers résidant sur un référentiel doit être préparé avant souper les processus clients peuvent
mettre à niveau ces fichiers. La collection doit recevoir un prénom et base répertoire. Si c'est
une collection privée, les utilisateurs clients doivent être informés du nom de la collection, du référentiel
hôte et répertoire de base ; ceux-ci seront précisés dans le supfile via le hôte et base d'hôte
option. Pour une collection de fichiers gérée par le système, les entrées doivent être placées dans l'hôte
fichier de liste et fichier de liste de répertoires comme décrit dans surveillants (8).

Dans le répertoire de base, un sous-répertoire doit être créé appelé souper . Dans ce
répertoire, il doit y avoir un sous-répertoire pour chaque collection utilisant ce répertoire de base,
dont le nom est le nom de la collection ; dans chacun de ces répertoires se trouvera une liste
fichier et éventuellement un fichier de préfixe, un fichier hôte, un fichier de clé de chiffrement, un fichier journal et un
fichier de numérisation. Les noms de fichiers sont répertoriés sous FICHIERS ci-dessous.

préfixe Normalement, tous les fichiers de la collection sont relatifs au répertoire de base. Cette
fichier contient une seule ligne qui est le nom d'un répertoire à utiliser à la place de
le répertoire de base pour les références de fichiers.

hôte Normalement, toutes les machines hôtes distantes sont autorisées à accéder à une collection de fichiers. Si tu
souhaitez restreindre l'accès à des hôtes distants spécifiques pour cette collection, mettez chaque
nom d'hôte autorisé sur une ligne de texte distincte dans ce fichier. Si un hôte a plus de
un nom, un seul de ses noms doit être répertorié. Le nom L'APPROVISIONNEMENT peut être utilisé pour
accorder l'accès à tous les hôtes sur le réseau local. Le nom d'hôte peut être un nombre
adresse réseau ou un nom de réseau. Si une crypte apparaît sur la même ligne que l'hôte
nom, cette crypte sera utilisée pour cet hôte. Sinon, la crypte figurant dans le
crypte fichier, le cas échéant sera utilisé.

crypte Si vous souhaitez utiliser le souper mécanisme de cryptage des données, créer un fichier de cryptage
contenant, sur une seule ligne de texte, la clé de chiffrement souhaitée. Processus clients
doit alors spécifier la même clé avec le crypte option dans le supfile ou ils seront
refusé l'accès aux fichiers. De plus, la transmission réelle du fichier sur le réseau
le contenu et les noms de fichiers seront cryptés.

liste Ce fichier décrit la liste réelle des fichiers à inclure dans ce fichier
collection, dans un format décrit ci-dessous.

de presse
Ce fichier décrit toutes les versions de la collection. Chaque ligne commence
avec le nom de la version, puis peut spécifier l'un des fichiers suivants :
préfixe= pour utiliser un répertoire parent différent pour les fichiers de cette version.
liste= pour spécifier la liste des fichiers dans la version. scanner= doit
être utilisé dans les collections multi-versions qui sont analysées pour conserver les fichiers d'analyse pour
les différentes versions se séparent. hôte = pour autoriser un hôte différent
restrictions pour cette version. suivant= utilisé pour enchaîner les sorties ensemble.
Cela a pour effet de faire d'une version une combinaison de plusieurs autres
libère. Si le même fichier apparaît dans plus d'une version chaînée, la première
trouvé sera utilisé. Si ces fichiers ne sont pas spécifiés pour une version, la valeur par défaut
noms : préfixe, liste, analyse et hôte seront utilisés.

balayage Ce fichier, créé par scruter, est la liste des noms de fichiers qui correspondent au
instructions dans le fichier liste. Le fichier d'analyse n'est utilisé que pour les mises à jour fréquemment
collections de fichiers ; cela accélère l'exécution du serveur de fichiers. Voir surveillants(8) pour
pour en savoir davantage.

bloquer Comme mentionné précédemment, ce fichier est utilisé pour indiquer que la collection doit
être verrouillé pendant que les mises à niveau sont en cours. Tous les serveurs de fichiers essaieront d'être partagés
accès au fichier de verrouillage avec troupeau (2).

fichier journal
Si un fichier journal existe dans le répertoire de collecte, le serveur de fichiers ajoutera le
la dernière fois qu'une mise à niveau a été effectuée avec succès, l'heure à laquelle la dernière mise à niveau a commencé
et terminé, et le nom de l'hôte demandant la mise à niveau.

En tant que professionnels, souper permet à plusieurs collections nommées différentes d'utiliser le même
répertoire de base. Un cryptage, un accès distant à l'hôte et des listes de fichiers séparés sont utilisés pour chaque
collection, puisque ces fichiers résident dans des sous-répertoires /souper/ .

Le fichier liste est un fichier texte avec une commande sur chaque ligne. Chaque commande contient un
mot-clé et un certain nombre d'opérandes séparés par des espaces. Tous les noms de fichiers dans le fichier de liste sont
évalué sur la machine du référentiel par rapport au répertoire de base de l'hôte, ou préfixe
répertoire s'il est spécifié, et sur votre machine par rapport à la base, ou préfixe,
répertoire pour le client. Les noms de fichiers ci-dessous (sauf commande-exe) peuvent tous inclure wild-
cartes et méta-caractères utilisés par csh(1) y compris *, ?, [...] et {...}. Les
les commandes sont :

améliorer nom de fichier
Le ou les fichiers (ou répertoires) spécifiés seront inclus dans la liste des fichiers à
mis à niveau. Si un nom de répertoire est donné, il inclut récursivement tous les sous-répertoires
et les fichiers dans ce répertoire.

toujours nom de fichier
La commande always est identique à upgrade, sauf que les commandes omit et omitany
n'affectent pas les noms de fichiers spécifiés avec la commande always.

omettre nom de fichier
Le ou les fichiers (ou répertoires) spécifiés seront exclus de la liste des fichiers à
être mis à niveau. Par exemple, en spécifiant améliorer /usr/vision et omettre
/usr/vision/exp, la liste de fichiers générée inclurait tous les sous-répertoires et
fichiers de /usr/vision à l'exception de /usr/vision/exp (et ses sous-répertoires et fichiers).

omission modèle
Les modèles spécifiés sont comparés aux fichiers de la liste de mise à niveau. Si un
le modèle correspond, le fichier est omis. La commande omitany prend actuellement en charge tous les
modèles de caractères génériques sauf {...}. De plus, le modèle doit correspondre au nom de fichier entier,
donc un */ de début, ou un /* de fin, peut être nécessaire dans le motif.

sauvegarde nom de fichier
Le ou les fichiers spécifiés sont marqués pour la sauvegarde ; s'ils sont mis à niveau et que le client
a spécifié le sauvegarde option dans la ligne correspondante du supfile, puis
des copies de sauvegarde seront créées comme décrit ci-dessus. Les répertoires peuvent ne pas être
spécifié, et aucune construction récursive de nom de fichier n'est effectuée ; vous devez préciser
les noms des fichiers spécifiques à sauvegarder avant la mise à niveau.

Pas de compte nom de fichier
Les informations comptables du ou des fichiers spécifiés ne seront pas conservées par souper.
Les informations comptables comprennent le propriétaire, le groupe, le mode et l'heure de modification d'un
fichier.

lien symbolique nom de fichier
Le ou les fichiers spécifiés doivent être traités comme des liens symboliques et seront transférés
en tant que tel et non suivi. Par défaut, souper suivra des liens symboliques.

lien symbolique dis-moi
Tous les liens symboliques du répertoire spécifié et de ses sous-répertoires doivent être
traités comme des liens symboliques. Ce sont les liens qui seront transférés et non les fichiers
vers lesquels ils pointent.

exécuter commande-exe (nom de fichier ...)
La commande-exe que vous avez spécifié sera exécuté sur le processus client chaque fois qu'un
des fichiers répertoriés entre parenthèses sont mis à niveau. Un jeton spécial, %s, peut être
spécifié dans le commande-exe et sera remplacé par le nom du fichier qui a été
mis à niveau. Par exemple, si vous dites exécuter ranlib %s (libc.a), puis chaque fois que libc.a
est mis à niveau, la machine cliente exécutera ranlib libc.a. Comme décrit ci-dessus,
le client doit invoquer souper couplé à -e flag pour permettre l'exécution automatique de
fichiers de commandes.

de Swanson comprennent fichier de liste
Le spécifié fichiers de liste sera lu à ce stade. C'est utile quand on
la collection englobe d'autres collections ; la plus grande collection peut simplement spécifier le
listfiles pour les plus petites collections qu'il contient.

L'ordre dans lequel les lignes de commande apparaissent dans le fichier liste n'a pas d'importance. Lignes vides
peut apparaître librement dans le fichier liste.

Utilisez sup en ligne en utilisant les services onworks.net