TOTVSTEC

Árvore de páginas

Versões comparadas

Versão antiga 2

changes.mady.by.user Julio Wittwer

Gravado em

comparado com

Nova versão 3

changes.mady.by.user Julio Wittwer

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Portuguese

Pagetitle
CHMOD
CHMOD

Função: CHMOD

Altera as permissões de um arquivo por outro.
Sintaxe

CHMOD ( [ cFileName], [ nFileMode] < cFileName> ,<nFileMode> ) --> lRet

Parâmetros/Elementos

 

NomeTipoDescriçãoObrigatórioReferência
cFileNameCaracterIndica o nome do arquivo no qual se deseja alterar suas propriedades (atributos) do sistema. X 
nFileModeNuméricoIndica a permissão que será atribuída ao proprietário, grupo ou representante do arquivo indicado no parâmetro cFileName<cFileName>. X 

 

Retorno
lRet
    (logico)
  • Retorna verdadeiro (.T.), se a alteração da restrição for realizada com sucesso; caso contrário, falso (.F.).
Observações
  • Essa função era executada apenas em ambiente Linux/Unix. No entanto, para builds superiores a 7.00.101202A, está função também poderá ser utilizada em ambiente Windows, porém com parametrização diferenciada. Veja maiores detalhes no tópico de informações adicionaisem Informações Adicionais.
  • O parâmetro <nFileMode>, consiste em três números, em octal, que especifica as restrições de acesso para o proprietário, grupo de usuário do proprietário e finalmente qualquer outro, nessa ordem.
    Cada número pode ser calculado pela adição das permissões necessárias para o alvo. Observe:

 

NúmeroDescrição
 1 Direito de execução
 2 Direito de escrita
 4 Direito de leitura

 

  • Para obter mais informações sobre os modos no sistema Linux/Unix, consulte man chmod(1) e man chmod(2).

Em ambiente Windows, a função CHMOD() apenas permite alterar a propriedade "somente leitura" ( read-only ) de um arquivo. Para remover o flag "somente leitura", dando direitos de escrita no arquivo, devemos informar o número 2 no parâmetro <nFileMode>, e para setar o flag "somente leitura", impedindo a escrita no arquivo, deve-se informar o número 4 em <nFileMode>.

Exemplos
CHMOD( cFileName , 777666 ) // Resultado: .T. Em linux, direitos de escrita e leitura. 
CHMOD( cFileName, 42 )  // Somente leitura Em windows, direito de escrita ( Remove flag de "somente leitura" caso esteja setado )
Abrangência
Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server